vierling - teles

ECOTEL ® message 

ECOTEL ® SMbaSic 

User Manual 

Edition 2.2 

VIERLING Communications GmbH 

70444.204/20 - 2.2 – 20050908

VIERLING Communications GmbH 

Pretzfelder Strasse 21, D-91320 Ebermannstadt 

Postfach 11 65, D-91316 Ebermannstadt 

E-Mail: info@vierling.de 

Internet: http://www.vierling.de 

© 2005 VIERLING Communications GmbH, Ebermannstadt 

All rights reserved. Any dissemination, reproduction or processing 

of this document or its contents or excerpts from it, regardless of 

the procedure used, is prohibited without prior written permission 

of VIERLING Communications GmbH. 

We reserve the right to make changes without prior notice. 

Although this text was conscientiously prepared, VIERLING 

Communications GmbH assumes no liability should it 

nevertheless contain errors.

Contents 

VIERLING 

1. INTRODUCTION .........................................................................3 

1.1 General Remarks ....................................................................... 3 

1.1.1 System Requirements..................................................... 3 

1.1.2 Installation....................................................................... 3 

2. SMBASIC CONFIGURATION .....................................................5 

2.1 Basic Settings............................................................................ 5 

2.2 Register Interface ...................................................................... 7 

2.3 POP3/SMTP Register................................................................. 9 

2.4 SMS Parameter Register ......................................................... 13 

2.5 User Register ........................................................................... 15 

2.5.1 User List........................................................................ 16 

2.5.2 Processing User Data ................................................... 18 

2.5.3 Edit Group Data ........................................................... 20 

2.5.4 Edit Group Members ..................................................... 22 

2.6 Register Rules.......................................................................... 23 

2.6.1 List of Rules .................................................................. 24 

2.6.2 Editing Rules................................................................. 25 

2.7 Register About......................................................................... 29 

ECOTEL ® SMbaSic 70444.204/20 - 2.2 Page i

VIERLING 

3. STARTING OPERATIONS........................................................31 

3.1 Serial Interface......................................................................... 31 

3.1.1 Configuring the Serial Interface..................................... 36 

3.1.2 Testing the Serial Interface ........................................... 38 

3.1.3 Dispatching and Receiving Test- SMSs ........................ 39 

3.2 Testing the E-Mail Interface .................................................... 41 

3.3 Inputting Users and Groups ................................................... 45 

3.4 License Validity........................................................................ 45 

4. PROGRAM OPERATIONS .......................................................50 

4.1 Message Construction ............................................................ 50 

4.2 Entering Recipient Addresses................................................ 51 

4.2.1 Recipient Address in Excess of 5 Characters................ 51 

4.2.2 Recipient Address Less Than 5 Characters .................. 51 

4.2.3 Recipient Address Contains an "@" .............................. 52 

4.2.4 Recipient Address Contains "0" or "+"........................... 53 

4.3 Sending an E-Mail as SMS ...................................................... 54 

4.4 Sending an SMS as E-Mail ...................................................... 54 

5. INDEX OF ABBREVIATIONS ...................................................55 

6. INDEX........................................................................................57 

Page ii ECOTEL ® SMbaSic 70444.204/20 – 2.2

1. Introduction 

1.1 General Remarks 

VIERLING 

ECOTEL ® SMbaSic converts e-mails that are being sent to a given 

address into SMS messages and dispatches them over the 

attached GSM module. 

SMS messages that have been sent to the attached GSM module 

are converted by SMbaSic into e-mails and then sent to their 

respective e-mail addresses. 

E-mails and SMSs can be sent to individual persons and to groups. 

1.1.1 System Requirements 

The following system requirements are necessary in order to install 

ECOTEL ® SMbaSic: 

� Microsoft Windows NT4/2000/XP 

� Hard disk with 20 MB minimum available storage capacity 

� One serial interface 

� Mail account with access to POP3 and SMTP 

1.1.2 Installation 

In order to install ECOTEL ® SMbaSic, the installation-CD that is 

included in the product package must be inserted into the CD drive. 

After that, the installation routine runs automatically. If the routine 

fails to start automatically, then it can be manually started by using 

the "run" command in Windows start menu. "LW:\SETUP.EXE" 

must be entered on the command line ("LW:" stands for the CD- 

ROM drive of the computer, for example "E"). The installation 

routine then starts after confirming with the "OK" key. If the 

ECOTEL ® SMbaSic software is already installed on the PC, then it 

ECOTEL ® SMbaSic 70444.204/20 - 2.2 Page 3

VIERLING 

must be de-installed before the new installation. If the existing 

database is to be used with the new installation, then the 

"mailmngusers.mdb" database file must first be secured from the 

ECOTEL ® SMbaSic software and saved before de-installation. 

After the new installation, this file can then be copied into the 

installation index of the ECOTEL ® SMbaSic software over the 

newly created database. 

At the end of the installation routine, the user will be requested to 

enter the required configuration data. After installation, this data can 

also be processed in the configuration software. The 

ECOTEL_SMbaSic entry can be found in Windows start-menu 

under "Program". 

Page 4 ECOTEL ® SMbaSic 70444.204/20 – 2.2

2. SMbaSic Configuration 

2.1 Basic Settings 

VIERLING 

The configuration software can be started over the Windows startmenu 

"Programme – ECOTEL_SMbaSic –ECOTEL SMbaSic 

configuration". 

Illustration 2-1: Main Formula, Common User Items 


VIERLING 

Description of Items in Illustration 2-1. 

Field Description 

Service 

Start 

Stop 

Poll now 

Interface 

Open 

Close 

Interface 

Protocol 

Logfile 

Mail/SMS 

Debug 

Apply 

Cancel 

OK 

Table 2-1: Common User Items 

Keys to start and to terminate service. 

A regular service is instructed to immediately call the 

e-mail account. 

Both service and interface status are shown by two 

indicators with the following meanings: 

Red: Deactivates and closes 

Green: Activates or opens and initializes 

Blinking: Initializing 

Keys to start and terminate the interface. After opening, 

the attached device will be initialized. 

Opens and closes a protocol window that shows data 

traffic which can be viewed with the attached device. 

Enables/disables the logging of SMS- and email-traffic 

Opens the protocol file 

Deletes the protocol file 

This key must be activated when settings have been 

changed. Pressing this key accepts all changes, and if 

the service is active, it will be requested to read-in the 

new data. 

This key terminates the program without assuming the 

data. 

The program is terminated and all changes are accepted. 


2.2 Register Interface 

Illustration 2-2: Register Interface 

VIERLING 


VIERLING 

Description of Items in Illustration 2-2. 


Port 

Show available 

ports only 

Baud 

Databits 

Parity 

Stopbits 

Protocol 

Table 2-2: Interface Register Items 

List-box for selecting the serial interface (COM1, COM2 

etc.) 

The software checks the hardware of the PC and offers 

only free COM ports 

Setting for the Baud-rate of the selected serial interface. 

No default. 

Setting for data bits. 

Range: 7 or 8 bits. 

Default is 8 Bits 

Setting for the parity. 

Range: Regular, Irregular or None. 

No default 

Setting for stop bits. 

Range: 7 or 8 bits. 

Default is 8 Bits 

Setting for the protocol. 

Range: None, Hardware, Xon/Xoff or Both. 

Default is Hardware 


2.3 POP3/SMTP Register 

Illustration 2-3: SMTP / POP3 Register 

VIERLING 


VIERLING 

Settings are made in this register for POP3 and SMTP parameters. 

The following table describes the "POP3/SMTP" register elements 

in more detail. 


POP3 

Server 

POP3 

Port 

POP3 

User 

POP3 

Password 

POP3 

Email 

POP3 

Polling rate 

SMTP 

Server 

SMTP 

Port 

SMTP 

Auth 

Mail-server of the account provider. The server may 

either be ones own internal server or else an external 

server (for example, from provider GMX). In such a case, 

the addresses would then be "mail.gmx.net" for SMTP 

(sending) and "pop.gmx.net" for POP3 (receiving). 

This port is also determined by the provider and is usually 

left at standard settings (110 for POP3 and 25 for 

SMTP). Some providers have a so-called proxy mailserver 

which has different port addresses. An internet 

connection always requires an address (for example 

"www.vierling.de"), which actually masks many numbers - 

the so-called IP address (for example "192.162.45.54") 

and a port (a number between 1000 and 9999). 

This is the user-name or the ID (identification control) for 

access to the POP3 mail account. 

The password for access to the POP3 mail account must 

be entered here. 

Enter the e-mail address of the ECOTEL POP3 mail 

account. The user will enter this address in the e-mail as 

recipient, while the system will enter it in the e-mail as the 

sender. 

Interval in seconds when the mail account is being 

checked for incoming messages. 

This requires the name of the SMTP mail-server that is 

used for sending e-mails. 

The port number for access to the SMTP mail-server 

when sending E-mails should be entered here 

(standard is 25). 

A setting that determines whether or not SMTP 

authorization is required. If yes, then the two fields 

"SMTP User" and "SMTP Password" must be filled out. 



SMTP 

User 

SMTP 

Password 

Admin-EMail 

POP3 Test 

SMTP Test 

VIERLING 

User name or ID (identification control) for access to the 

SMTP mail account. 

The password for access to the SMTP mail account must 

be entered here. 

All system error messages are sent to this e-mail 

address. 

Test to determine if a connection can be established to 

the POP3-server and account. 

The results are shown as follows: 

Test to determine if a connection can be established to 

the SMTP-server and account. 



VIERLING 


Test Mail 

Test Admin 

Table 2-3: POP3/SMTP Register Items 

Sends an e-mail to the recipient specified. 


Sending and receiving an e-mail with POP3/SMTP 

account entries. 


2.4 SMS Parameter Register 

SMS parameter settings are recorded in this register. 

Illustration 2-4: SMS Register 

VIERLING 


VIERLING 

SMS Register Items 


PIN 

Service center 

address 

Service center 

address change 

Validity period 

Direct display 

Number 

Text 

Send SMS 

Table 2-4: SMS Parameter Items 

If PIN request is activated on the used SIM card,the 

PIN of the SIM card must be entered here. 

The network operator Service Center address (SCA) 

for sending SMSs. This address can be taken from 

the documents of the SIM card being used. 

By pressing this key, a service center address can 

be written on the SIM card in the hardware being 

used (refer to Illustration 2-5). 

This is the setting for the period of validity of the 

dispatched SMS. The provider will attempt to send 

an SMS message to the recipient until this time 

period has expired. 

If this feature has been selected, then SMS 

messages will be displayed directly on the mobilephone 

display of the recipient. 

SMS number of a recipient. 

Text for an SMS test 

Illustration 2-5: Changing Service Center Addresses 

Sending the test SMS. 

The number of characters being input are displayed 

in the small field below. A maximum of 160 

characters can be entered. 


2.5 User Register 

VIERLING 

User data are administered in the User Register (Illustration 2-6). 

Illustration 2-6: User Register 

The items contained in the register for user administration are 

described in more detail in sections 2.5.2 through 2.5.4. 


VIERLING 

2.5.1 User List 

Changes to user or group data are symbolized and marked as 

follows: 

Symbol/ Marking Description 

Data have been changed. 

Data have been deleted. 

New data were added. 

All data remain unchanged. 

Table 2-5: User List/ Data Modification Symbols 

User Register Items 


Database 

The path of all database files used by ECOTEL ® 

SMbaSic appears here. This is automatically created 

during installation. 

List 

Text 

Shows all users and groups entered in the database. 

When selecting a user or a group, all data that have 

been entered in this regard are shown here. If a 

category is selected, this field then displays all 

information identifying the category and the available 

options for selections. 


Standard Recipient 

New... 

Edit... 

Delete 

Default recipient 

Table 2-6: User Register 

VIERLING 

Any person in the user list can be designated as a 

standard recipient by activating this check box. All 

incoming messages that are unaddressed or have 

faulty forwarding addresses will be automatically 

routed to the standard recipient. 

Only one user can be designated as standard 

recipient. If a second user is designated as standard 

recipient, then the check mark pertaining to the 

former standard recipient is deleted. Designating a 

standard recipient is optional. If a standard recipient 

has not been designated, then unaddressed or 

improperly addressed messages will be forwarded to 

the administrator. 

These buttons open additional entry masks that allow 

administration and modification of users and groups. 

This is described in more detail in the following 

sections. 

Only one user can be default recipient. The default 

recipient gets all emails, where no recipient data 

available. 


VIERLING 

2.5.2 Processing User Data 

User data are administered and modified in the "Edit User Data" 

window (Illustration 2-7). 

Illustration 2-7: " Processing User Data" Dialogue Window 

Pressing the "New" key opens an option window that permits 

creating either a new user or a new group. If "User" is selected, 

then the "Edit User Data" window opens (refer to Illustration 2-7). 

New users are recorded here. 


VIERLING 

User data that have already been created can be seen by pressing 

the "Edit" key. Data that must be entered are explained in Table 2-7 

which follows. 


Username 

ID 

Email 

SMS 

number 

Validity 

period 

Direct 

display 

User name which appears in the list and which can be entered 

as the recipient of a message. Attention must be given to the 

exact spelling, including spacing. 

User identification which can be entered as the recipient of a 

message. Up to a maximum of 4 numbers and letters are 

permitted. Attention must be given to the exact spelling, 

including spacing. 

User's e-mail address which can be entered as the recipient of 

a message. 

User's SMS number which can be entered as the recipient of a 

message. 

Refer to SMS register. 

By using the "standard" setting (gray check-box), all settings of 

the SMS register are accepted. Otherwise, user settings are 

applied. 


By using the "standard" setting (gray check-box), all settings of 

the SMS register are accepted. Otherwise, user settings are 

applied. 

Table 2-7: "Edit User Data" Dialogue Window 

ATTENTION: 

By operating ECOTEL ® SMbaSic with ECOTEL ® ISDN 

there may not be any users with the same electronic 

mail address! 


VIERLING 

2.5.3 Edit Group Data 

Group data is modified and administered in the "Edit Group Data" 

dialogue window (Illustration 2-8). 

Illustration 2-8: "Edit Group Data" Dialogue Window 

Pressing the "New" key opens an option window that permits 

creating either a new user or a new group. If "Group" is selected, 

then the "Edit Group Data" window opens (refer toIllustration 2-8). 

New groups are recorded here. 

Group data that have already been created can be seen by 

pressing the "Edit" key. 


VIERLING 

All "Group Data" items are explained in Table 2-8 which follows. 


Group 

name 

ID 

Validity 

period 

Direct 

display 

Group name which is displayed in the listing. It can be entered 

as the recipient of a message. Attention must be given to the 

exact spelling, including spacing. 

Group identification which can be entered as the recipient of a 

message. Up to a maximum of 4 numbers and letters are 

permitted. Attention must be given to the exact spelling, 

including spacing. 


If the "standard" setting is not used (gray checkbox), then 

user settings for the group are applied. 


If the "standard" setting is not used (gray checkbox), then 

user settings for the group are applied. 

Memberlist Shows the members (users) of the group. 

Members 

… 

This key accesses the dialogue window for member 

administration. 

Table 2-8: " Edit Group Data " Dialogue Window 


VIERLING 

2.5.4 Edit Group Members 

Members can be allocated to their respective groups by using this 

dialogue window. 

Illustration 2-9: "Edit Group members" Dialogue Window 

The corresponding items which occur in this dialogue are explained 

in Table 2-9 which follows. 


Userlist 

List of available users. 

Memberlist List of members in the group. 

These keys are used to move selected users from one list to 

another. 

Table 2-9: " Edit Group Members " Dialogue Window 


2.6 Register Rules 

VIERLING 

In "Register Rules" (Illustration 2-10), rules can be defined that 

determine how the system is to react when predefined keywords 

are recognized in incoming messages (SMSs and eMails). Thus, for 

example, SMSs with a predefined text can be routed to one or more 

users when a specific keyword has been recognized in an incoming 

eMail. 

Illustration 2-10: Register Rules 

The register for rule administration contains elements that are 

described in detail in sections 2.6.1 and 2.6.2. 


VIERLING 

2.6.1 List of Rules 

Changes that have been made to rules in the list are identified as 

follows: 

Symbol Meaning 

Table 2-10: Symbols in the list of rules 

ATTENTION: 

Data has been modified 

Data has been deleted 

Data has been added 

Data remains unchanged 

Modified data only become effective after the "assume" 

button has been clicked! 

Elements within the "Rules" Register 

Field Meaning 

List of Rules Displays all existing rules that have been 

entered in the database 

Rule Data When a given rule is selected, this field 

displays all data entries that have been made. 

Ignore Address When this field is activated by a check, 

incoming messages that correspond to a given 

rule are rerouted to a person specified in this 

ruling instead of being forwarded to the user 

addressed in the message. If no rulings apply 

to the incoming message, then it will be 

forwarded to the original address, despite the 

activated checkmark. The checkmark applies 

to all rules. 


New... 

Edit 

Delete 

Table 2-11: Elements of the rules register 

2.6.2 Editing Rules 

VIERLING 

Data input for all rules is done by using these 

buttons which open additional data entry 

forms. This procedure will be described in 

detail in the sections that follow. 

The "New" button does not function until a 

user name has been entered in the database. 

Data administration is possible in the "Edit Rules" dialog window 

(Illustration 2-11). Here entries can be made determining the 

characteristics of individual rules and the actions to be executed. 

Every ruling that has been activated is applied to every incoming 

message. If more than one ruling applies to an incoming message, 

then multiple SMSs or eMails will be routed accordingly to the 

persons who have been pre-specified. 

Illustration 2-11: “Edit rule data” dialogue window 


VIERLING 

The 'New...' button opens the 'Edit Rules' dialog window (see 

Illustration 2-11). Newly formulated rules can be entered in this 

window. 

Data for rules that has already been entered can be displayed over 

the 'Edit...' button. Data which must be entered is described in 

Table 2-12: 

Field Meaning 

Rule Name The rule name is displayed in the rule list. 

Certain characters are not allowed in a rule 

name and are automatically suppressed during 

input. 

Mail/SMS Here the determination is made whether or not 

to check an incoming eMail or SMS for rule 

conformity. 

Filter eMail or SMS are searched based on the 

character string entered in the "Filter" field. If 

the character string is contained in the text, 

then the text defined in the Text Field is sent. 

The filter definition can consist of several 

words, or of one word or a portion of a word. 

Messages are completely searched for the 

character string that has been defined under 

"Filter" even if a string should be longer than 

160 characters. 

The "Filter" field must contain at least one 

character. The default setting is “*“. The star 

does not function as a "joker" for an arbitrary 

character! 


VIERLING 

Mail If the “Mail” check box is activated, then an 

eMail will be dispatched to the designated 

person or group. All persons and groups that 

have been entered in the user register are 

contained in the selection field. 

Should the rule be applied to an incoming SMS 

message, then an eMail is automatically 

suggested as an outgoing message. In 

addition to this, or as an alternative, an 

outgoing SMS can also be configured. In any 

case, an outgoing message must always be 

defined! 

SMS If an "SMS" check box is activated, then an 

SMS message will be dispatched to a 

designated person or group. All persons and 

groups that have been entered in the user 

register are displayed in the selection field. 

If this rule is to be applied to an incoming 

eMail, then an SMS message is automatically 

suggested as an outgoing message. In 

addition to this, or as an alternative, an 

outgoing eMail can also be configured. In any 

case, an outgoing message must always be 

defined! 

Text If the rule applied to an incoming message is 

evaluated as true, then the text entered here 

will be dispatched as an SMS or eMail. 

The "Text" field must contain at least one 

character. The default setting is “*“. The star 

does not function as a "joker" for an arbitrary 

character or for the original message! If the 

default setting is not changed, then the "*" 

character will be dispatched! 

Activate Rule This setting determines whether or not a given 

rule is to be applied to incoming messages. 

Table 2-12: Elements of the “edit rules” window 


VIERLING 

If an incoming message is to be screened for several keywords or 

string characters, then multiple rules must be defined. However, 

this also means that several messages may be dispatched 

accordingly (possibly to the same person or group) when multiple 

rules are evaluated as true! 


2.7 Register About 

VIERLING 

The register includes information regarding the program and the 

license data. 

Illustration 2-12: Main Form, "About" Register 

The software version that is currently installed as well as the validity 

of the license are displayed here. 

Information Regarding the Licensing Procedure 

The connected GSM module is required for ECOTEL ® SMbaSic 

software to send and receive SMS messages. In this regard, 

ECOTEL ® SMbaSic software can only address that GSM module 

which is authorized and released in the software. 


VIERLING 

The IMEI number of the GSM module is used for this purpose. 

Each GSM module, worldwide, has been allocated a unique IMEI 

number (International Mobile Equipment Identifier) by which it can 

be identified. 

For this reason, after installing ECOTEL ® SMbaSic software, 

customers are required to register the IMEI number of their GSM 

module with their dealer. The customer then receives, without 

delay, the licensing files "SMbaSic.lic" and "SMbaSic.sgn". These 

files are then copied into the installation directory of the SMbaSic 

software. 

This software is indexed under 

c:\programme\vierling\ECOTEL_SMbaSic. When ECOTEL ® 

SMbaSic software is re-started, the licensing data is then read-in 

and the software is released. 


3. Starting Operations 

VIERLING 

Several parameters must be entered over the ECOTEL ® SMbaSic 

software in order to start operations with ECOTEL ® SMbaSic. This 

software also offers numerous testing options in order to checkout, 

step by step, the interaction between hardware and e-mail system 

connections. 

The steps that must be executed after installation are described 

individually in the text that follows. Only those items in the register 

pages are described that must be modified in order to start 

operations. Section 2 contains a detailed description of the software 

user-menu interface. 

The system can be configured during software installation. If this 

step is skipped during installation, then the Windows start-menu 

"Programme – ECOTEL_SMbaSic – ECOTEL SMbaSic 

configuration" of the configuration software can be started in order 

to enter this data at a later time. 

3.1 Serial Interface 

ECOTEL ® SMbaSic requires a GSM module (ECOTEL ® ISDN, 

ECOTEL ® GSM or TC35-Terminal) in order to send and receive 

SMS messages. Communication between ECOTEL ® SMbaSic 

software and its hardware takes place over the PC serial interface. 

Operations with ECOTEL ® GSM or TC35-Terminal 

Both ECOTEL ® GSM and TC35-Terminal are equipped with a serial 

interface which must be coupled with a serial cable to the COM-port 

selected on the PC. No additional settings are required by any of 

the devices. 


VIERLING 

Operations with ECOTEL ® ISDN 

ATTENTION: 

By operating ECOTEL ® SMbaSic with ECOTEL ® ISDN 

no settings have to be done within the ECOTEL ® . 

ECOTEL ISDN is equipped with two serial interfaces: "V.24 Data" 

and "V.24 configuration". When operating with ECOTEL ® 

SMbaSic, the "V.24 configuration" interface must be coupled with 

the COM-port selected on the PC. The following changes are 

required for the device configuration: 

Register Card " Mobile Adapter" 

Incoming and outgoing data traffic for radio module 2 must be 

cleared over the V.24 data interface. 

Generally, the "Timeout" option must be checked in the Data/Fax 

field. 

Illustration 3-1: Settings on the "Mobile Adapter" Register Card 


VIERLING 

"SMS" Register Card 

Settings for forwarding messages to the serial interface are made 

on the "SMS" register card. 

Illustration 3-2: "SMS" Register Card Settings 

The "New Basic Settings" button opens the input window for "Basic 

Settings". Transmit SMS short messages must be activated here. 


VIERLING 

Illustration 3-3: Settings on the "Basic Settings" Card 

“Messages” Register Card 

On this register card all report messages must be disabled. 


Illustration 3-4: Settings on the "Messages" Card 

“Configuration” Register Card 

VIERLING 

On this register card, the setting ‘Call Back Request via SMS’ must 

be disabled. 


VIERLING 

Illustration 3-5: Settings on the "Configuration" Card 

The "SMbaSic.eco" file contained in the installation CD already 

contains all necessary settings. If this configuration file is loaded 

into ECOTEL ® ISDN, then no other entries over the configuration 

interface are required. 

3.1.1 Configuring the Serial Interface 

As a rule, the user must enter only the number of the interface 

being used (in the "port" field), and the Baud rate (in the "Baud" 

field) in the configuration software. The Baud-rate setting depends 

upon the GSM module being used and must be set in accord with 

the entries in the table that follows. 


GSM Module Baud Rate 

ECOTEL ISDN 57600 

ECOTEL ISDN2-1 19200 

ECOTEL GSM 19200 

TC35 Terminal 57600 

VIERLING 

All entries are effective only after clicking on the "Apply" button! 

Illustration 3-6: Configuration of the Serial Interface 


VIERLING 

3.1.2 Testing the Serial Interface 

Functioning of the interface and of the connected GSM module can 

be tested after entering the data required for the serial interface. 

Place a check-mark in the "Protocol..." checkbox and then click on 

the "Open" button. 

Illustration 3-7: SMS Register Card 

While the interface is being opened, the red field under the "Open" 

button will blink. The "Open" button is then re-named to "Close". 

The address of the SMS Service Center and the IMEI number (refer 

to "About" register) are selected and displayed. If the interface has 

initialized properly, then the signal display field changes from 

blinking red to continually green. 


VIERLING 

If PIN request is activated on the used SIM card,the PIN of the SIM 

card must be entered here. 

Illustration 3-8: Initializing the Serial Interface 

3.1.3 Dispatching and Receiving Test- SMSs 

The next step is to check whether sending and receiving SMS 

messages function properly over the connected GSM module. This 

requires that the serial interface be initialized and that the correct 

Service Center Address (SCA) is entered on the SIM card in the 

GSM module. 


VIERLING 

Illustration 3-9: Dispatching a Test-SMS 

The phone number of the mobile phone to which the SMS message 

is to be sent should be entered in the "Number" field. In the "Text" 

field, up to a maximum of 160 characters can be entered. The SMS 

test message can then be dispatched by clicking on the "Send 

SMS" button. 

In order to test the reception of SMS messages, an SMS message 

must be sent from any mobile phone to the telephone number of 

the SIM card being used in the GSM module. After receiving an 

SMS, the user software interface immediately opens a window 

which displays the SMS message. 


Illustration 3-10: Receiving a Test-SMS 

VIERLING 

If an SMS can not be successfully sent or received, then a check 

should be made to determine whether the telephone number was 

correctly dialed and whether the Service Center Address (SCA) 

shown is valid. A valid SCA can be verified by the respective 

provider. The SCA can be written to the SIM card by clicking on the 

button to the right of the "Service Center Address" field. 

Proper functioning of the GSM module and the SMS interface of the 

ECOTEL ® SMbaSic software are assured when all tests have been 

successfully executed. 

3.2 Testing the E-Mail Interface 

ECOTEL ® SMbaSic software converts incoming SMS messages 

into e-mails and then forwards them to the addresses specified. In 

the reverse case, e-mails that have been received are converted 

into SMS messages and then sent to the specified telephone 

numbers. This requires that an e-mail account be identified to which 

all e-mails are sent that are to be forwarded as SMS messages. 


VIERLING 

Data for the POP3 server and the SMTP server must be entered on 

the SMTP/POP3 register card. 

Through the POP3 server, the SMbaSic e-mail account can be 

queried (refer to "E-mail" field) for e-mails that are to be forwarded 

as SMSs. This monitoring is done at regular time intervals which 

can be set as required (refer to the "Polling rate" field). 

The SMTP-Server dispatches all e-mails which have been created 

from the SMS messages that were received. 

The data can be retrieved from the system administrator if 

necessary. 

Illustration 3-11: Configuring the SMTP and POP3 Servers 


VIERLING 

The e-mail address to which all system fault messages are to be 

sent should be entered in the "Admin-Email" field. 

The data which are entered can be reconfirmed using the test 

buttons underneath the Admin-Email field. 

After clicking the "Test POP3" button, the message window 

appears (as illustrated below) when the POP3 access data have 

been correctly entered. If POP3 Connect or POP3 Login data are 

not "OK", then the corresponding access data should be reconfirmed. 

Illustration 3-12: Test POP3-Server 

The message window illustrated below appears after correctly 

entering SMTP access data and then clicking on the "Test SMTP" 

button. If SMTP Connect or SMTP Login are not "OK" then the 

access data should be reconfirmed. 

Illustration 3-13: SMTP-Server Test 


VIERLING 


entering SMTP access data and then clicking on the "Test Admin" 

button. If SMTP Connect, SMTP Login or Send Mail are not "OK", 

then the respective access data should be reconfirmed. 

Illustration 3-14: Test E-mail to Admin address 


entering the POP3-e-mail address and then clicking on the " E-mail 

-Test" button. If one or more results are not "OK" after several 

attempts, then the respective access data should be reconfirmed. 


Illustration 3-15: E-mail Interface Test 

3.3 Inputting Users and Groups 

VIERLING 

Entering users or groups is not required in order to start ECOTEL ® 

SMbaSic operations. System functions can also be tested without 

such data. 

3.4 License Validity 

In order for the SMbaSic software to send and receive SMS 

messages, the GSM module must be connected. The SMbaSic 

software can only access the GSM module when it has been 

released in the ECOTEL ® SMbaSic software license key. 

This procedure makes use of the IMEI number of the GSM module. 

Each GSM module, worldwide, has been allocated a unique IMEI 

number (International Mobile Equipment Identifier) by which it can 

be identified. 

For this reason, after installing ECOTEL ® SMbaSic software, 

customers are required to register the IMEI number of their GSM 

module with their dealer. The customer then receives without delay 


VIERLING 

the licensing files "SMbaSic.lic" and "SMbaSic.sgn". These files are 

then copied into the installation directoty of the SMbaSic software. 

This software is indexed under 

c:\programme\vierling\ECOTEL_SMbaSic. When ECOTEL ® 

SMbaSic software is re-started, the licensing data is read-in and 

the software is released. 

When initializing the serial interface (refer to section 3.1.2), the IMEI 

number of the connected GSM module is automatically read and 

displayed in the "Local IMEI" field of the register card “About”. This 

IMEI number must be made available to the dealer so that he can 

generate the licensing files. 

Illustration 3-16: Register Card About 


VIERLING 

When you have received the "SMbaSic.lic" and "SMbaSic.sgn" 

license files, they must be copied into the installation index of the 

ECOTEL ® SMbaSic software. 

Illustration 3-17: Storage Location of the Licensing Files 

When clicking on the "Check" button, the system will determine 

whether the licensed IMEI number is identical with the IMEI number 

of the connected GSM module. Only if the two numbers are 

identical can the connected GSM module send e-mails as SMS 

messages and forward incoming SMS messages as e-mails. 


VIERLING 

Illustration 3-18: License Validity 

ECOTEL ® SMbaSic is ready for operations when all necessary 

steps have been executed for starting-up ECOTEL ® SMbaSic 

software and when a valid license exists for the GSM module being 

used. 

In order to start active operations with ECOTEL ® SMbaSic, the 

serial interface must be closed ("Close" button) and ECOTEL ® 

SMbaSic Service ("Start" button) must be started. During active 

operations, the configuration software can be terminated with the 

"OK" button. 


Illustration 3-19: Active Operations with ECOTEL ® SMbaSic Service 

VIERLING 


VIERLING 

4. Program Operations 

A Email program is required to send a message (e.g. MS Outlook). 

If MS Outlook is being used, then an Outlook Add-In can be 

installed (refer to Manual_SMbaSic-OutlAddIn). 

4.1 Message Construction 

The syntax for sending messages with ECOTEL ® SMbaSic is 

always as follows: 

 

Item Description 

Recipient 

Separator 

Message 

First of all, name, ID, SMS number or E-mail address 

of the recipient are entered in the same way as they 

appear in the user list. 

The "#" symbol has been chosen as a separator. It 

separates the SMS into the recipient address and the 

message text. This symbol is mandatory because it 

permits evaluation of the recipient address. 

Finally, the message text destined for the recipient is 

entered. The message text can be placed in the 

subject line of the e-mail, immediately after the "#" or in 

the text field of the e-mail. 

ATTENTION: 

For the operation of ECOTEL ® SMbaSic with ECOTEL ® 

ISDN e-mails only may be sent by users who were listed 

in the database via the SMbaSic configuration surface 

(register card “Users”). 


4.2 Entering Recipient Addresses 

VIERLING 

The text entered before the separator symbol "#" is automatically 

recognized by ECOTEL ® SMbaSic as a recipient address. Criteria 

for recipient addresses are described in more detail in sections 

4.2.2 to 4.2.4. 

4.2.1 Recipient Address in Excess of 5 Characters 

Recipient addresses are interpreted as "names". In essence, a 

corresponding name will be sought in the user or group list 

(database). If a user or group is found with the name in question, 

then the e-mail will be sent as SMS to the telephone number of the 

user or to all users of the group. 

Example: 

Illustration 4-1: Name as Recipient Address 

4.2.2 Recipient Address Less Than 5 Characters 

The recipient address is interpreted as an "ID" . In essence, a 

corresponding ID will be sought in the user or group list (database). 

If a user or group is found with the ID in question, then the e-mail 

will be sent as SMS to the telephone number of the user or to all 

users of the group. 


VIERLING 

Example: 

Illustration 4-2: ID as Recipient Address 

4.2.3 Recipient Address Contains an "@" 

When the "@" symbol is recognized, this entry will be interpreted as 

an e-mail address. A corresponding entry will be sought in the user 

list and the e-mail will be dispatched as an SMS to the telephone 

number of this user. 

Example: 

Illustration 4-3: E-mail Address as Recipient Address 


4.2.4 Recipient Address Contains "0" or "+" 

VIERLING 

When the characters "0" or "+" are recognized as the first character 

in the recipient address, then this e-mail is immediately dispatched 

as an SMS without further checking of the user list. 

Example: 

NOTE: 

It is recommended that all phone numbers be entered in 

the international format (+49xxxxxxxx). This applies to 

both user data and to address entries in the subject line 

of e-mails that are to be sent. 

Illustration 4-4: Telephone Number as Recipient Address 


VIERLING 

4.3 Sending an E-Mail as SMS 

In order to dispatch an SMS, an e-mail must be sent to the 

registered Email account of ECOTEL ® SMbaSic. The administrator 

provides the required data to the user. The recipient is entered in 

the "Subject" field followed by the separator symbol '#'. The text that 

follows can then be placed either in the "Subject" field or in the 

message text, or in both. Before evaluation, these two fields are 

joined together beginning with the "Subject" field and followed by 

the message text. 

4.4 Sending an SMS as E-Mail 

In order to send an e-mail over ECOTEL ® SMbaSic, an SMS must 

first be dispatched to the telephone number of the SIM card of 

ECOTEL ® SMbaSic. Both the recipient address and the message 

must be entered according to the prescribed syntax and then 

dispatched. 

Examples: 

Illustration 4-5: Sending an SMS as E-Mail 


5. Index of Abbreviations 

VIERLING 

The Abbreviations used in the foregoing text are summarized and 

explained in Table 5-1 which follows. 

Abbreviation Description 

GSM 

IMEI 

SME 

SC 

SCA 

Global System for Mobile Communications 

International Mobile Equipment Identifier 

A unique number, worldwide, that is etched in the GSM 

module and unequivocally identifies it. 

Short Message Entity 

Service Center 

This function is responsible for transmitting and forwarding 

SMSs between SME and MS. However, SC is not part of 

GSM PLMN. Tentative plans exist for integrating MSC and 

SC. 

Service Center Address 

In order to use the SMS service, the number of the SMSC 

(Short Message Service Center, SCA) must be 

communicated to the MS (Mobile Station), assuming that 

MS supports the SMS-MO (Short Message Service-Mobile 

Originated). 


VIERLING 

Abbreviation Description 

SMS 

SMTP 

POP3 

Table 5-1: List of Abbreviations Used 

Short Message Service 

SMS is a medium for transferring short text messages 

between a "GSM Mobile Station" (MS) and the "Short- 

Message-Entity" (SME) through the use of a Service-Center 

(SC). SC functions as an "interworking" and transmitting 

agent of the message-transfer between MS and SME. 

"Short-Message-Point-to-Point Service" incorporates two 

basic services: 

SM MT (Short Message Mobile Terminated Point-to-Point) 

SM MO (Short Message Mobile Originated Point-to-Point) 

The message text is transmitted via SM MT or SM MO 

sending up to 140 octets (maximum 160 characters). 

Simple Mail Transfer Protocol 

Post Office Protocol - Version 3 


6. Index 

C 

configuration file 29 

D 

Data Bits 8 

I 

IMEI number 23, 31 

Installation 3 

M 

Message Construction 43 

P 

Parity 8 

POP3 9 

Protocol 8 

VIERLING 

ECOTEL ® SMbaSic 70444.204/20 - 2.2 Page 57 

R 

Recipient addresses 44 

S 

serial interface 24 

Service Center Address 14 

SMTP 9 

Stop Bits 8 

System Requirements 3 

U 

User data 15 

User List 16 

V 

validity of the license 22

vierling - teles

Create successful ePaper yourself

Delete template?

Save as template?