mobilink user en v1.12

MobiLink.exe

OAM Program for MobiLink GSM,

Software Version 1.2

OPERATING MANUAL

OAM Program „Mobilink” Manual for version 1.2

1

TOPEX is a group of Romanian companies, founded in 1990, by ten enthusiastic engineers experienced in telecommunications. Its activity is directed to the research, development and production of telecom equipment as well as service. Very quickly, TOPEX become the most important manufacturer of communications solutions for small to large companies as well as for telecommunications operators and providers in Romania. Our company designs equipment for all existing mobile systems (GSM, CDMA), including 3G technology. TOPEX is represented all over Romania by a wide network of local distributors through which the promotion, administration and product maintenance are running. Due to our innovation power, authentic flexibility, real respect for our partners and the secure solutions that we provide TOPEX extended its business worldwide. Currently TOPEX delivers its products through its distributors to: Spain, France, Russia, UK, Turkey, Netherlands, Greece, Republic of Moldova, Bulgaria, Nigeria, etc.In order to achieve effective and flawless manufacturing for its products, TOPEX has carefully organized its Research and Development Department along with its production facility. This allows TOPEX to have maximum control of all the processes involved in the complex operations related to high-technology electronic manufacturing. Right now, 25 percent of Topex personnel are part of R&D Department and their number is increasing. TOPEX also considered the training and the service as an integral part of the solutions it provides. Therefore, comprehensive training sessions are held at the Topex factory, complimentary for the company’s clients. Service is also provided via Internet, as all Topex solutions are designed especially to allow this, at the lowest cost. TOPEX has implemented the quality management system according ISO9001 standard certified by SRAC since 1997, respectively by IQNET since 2002. In 2001 TOPEX become a sector member of I.T.U. (International Telecommunication Union). The main lines of products of our company are:

- GSM interfaces (analog, ISDN BRI and PRI, GSM VoIP gateway)

- CDMA2000 interfaces (voice/data, LAN, EV-DO gateway, GPS, miniature)

- VoIP gateways (basic, GSM, advanced) - Custom systems for special applications (air traffic control,

railway dispatching center) - Phone exchanges (analog, digital, private/rural, IP PBX,

protocol converters) For more details please visit our website at http://www.topex.ro

http://www.topex.ro/

http://www.topex.ro/


CONTENTS: 1. General description..................................................................... 3

1.1.Usage................................................................................... 3 1.2. Installing the program.......................................................... 3

2. Structure of the graphic interface................................................ 5 2.1 . Menu description for MobiLink application ......................... 6 2.1. Icons description ................................................................. 6 2.2. Tree options ........................................................................ 8 2.3. Option „Language selection” ............................................. 10 2.4. Status bar.......................................................................... 10 2.5. Display issues ................................................................... 11 2.6. Files .................................................................................. 12 2.7. Password protected mode ................................................ 13 2.8 Login file............................................................................. 16 2.9 . Details about installing the MobiLink application.............. 17

3. CONNECTING.......................................................................... 18 3.1. Connecting methods ......................................................... 18 3.2 "Connect to Modify" and "Connect to View" options (case a) and case b)) ............................................................................. 18 3.3 "Modify Configuration" and "View Configuration” windows. 20

3.4. Programming Area ....................................................... 21 3.5. Loading a New Image .................................................. 27

4. MENU ....................................................................................... 30 4.1 Systems ............................................................................. 30

4.1.1 Add............................................................................. 30 4.1.2 Remove...................................................................... 31

4.2 Facilities ............................................................................. 32 4.3. Print options ................................................................. 35 4.4 About............................................................................. 35 4.5. HELP............................................................................ 36 4.6 Exit ................................................................................ 38

5. OTHER COMMANDS OF THE TREE STRUCTURE ............... 38 5. 1. Disconnect................................................................... 38 5.2. Modify parameters........................................................ 39 5.3. Last Configuration ........................................................ 40 5.4. Log Files....................................................................... 40

5.5. Changes files................................................................ 40

6. Glossary.................................................................................... 41

This manual is Revision B, january 2009.

2


3

1. General description 1.1.Usage The OAM (Operation, Administration and Maintenance) program is intended for the configuration and administration of the MobiLink GSM voice and data interface via its serial port. The installation CD-ROM supplied in the Topex package includes the OAM program called "MobiLink.EXE". This is a self-content Win32 application that runs on Windows 98/2000/XP operating systems. On the CD you will also find the the documentation (installation and operation manuals, help file) By means of the OAM application you may administrate (configure) up to 20 different MobiLink devices. The OAM program will connect to one or another of the Topex MobiLink equipments, allowing you to see or to change the settings for each one. Each Topex MobiLink system connected to the OAM program uses a different directory for its configuration files. 1.2. Installing the program Topex MobiLink.exe may run on any desktop PC or notebook that does fulfill the following minimal requirements: - Operating system: Windows 95 or later versions - Minimum processor 486 - Recommended minimum 500 MB free space on HDD - Minimum 32 MB of RAM - One serial port free (available) - Graphics resolution 1024 by 768 pixels - colors High Color (16bit) or True Color (32bit) The relatively large space on the hard disk is not for the program itself but rather for the configuration, working and log files that will be created during the operation of the MobiLink GSM equipment. To install the program on a desktop PC or a laptop, insert the installation CD-ROM into the CD drive unit and copy the structure of folders and files to your hard disk drive. Then run the file MobiLink.EXE from the directory on your hard disk. The program includes an on-line help (in English).


The names of the windows, menus and icons and the system messages can be displayed in several languages: English, Romanian or French. The OAM application makes use of a tree-like (branching) structure, since it allows configuring and maintenance of a maximum of 20 different MobiLink GSM units. Each of these Topex MobiLink systems uses a different directory „branch” for its configuration (settings) and working files. In order to connect the Topex MobiLink system to the computer where the OAM software is running, you should use a special serial cable, which is found in the MobiLink GSM package from Topex.

This cable features a RJ45 connector at one end, which will be inserted into the female RJ45 connector of the Topex MobiLink unit labeled “RS232”. The opposite end of the cable has a connector type DB9. The DB-9 connector must be inserted into the serial (COM) port of the computer that you use for configuring and managing the Topex MobiLink equipment, as shown in the image below:

The same cable is used to ensure wireless connection of your PC to the Internet via GSM network.

4


2. Structure of the graphic interface

The screen of the OAM program includes several elements:

- Menu Bar on top - Toolbar (a set of buttons with icons) - Yellow area with Tree commands (Connect to, Loading,

Parameters) - The main screed (blue background) showing

“Programming Area” or „Info” screens (for GSM module, for FXS interface)

- Status Bar at the bottom. All these elements of the MobiLink program will be described in the paragraphs that follow. Then, concluding this chapter, you will see a paragraph detailing issues of the program’s installation.

5


2.1. Menu description for MobiLink application The menu bar of the OAM program, located on top, includes these items: Systems, Facilities, About, Help and Exit. Systems

- Add Adds a new Topex MobiLink system to the tree-like structure

- Remove Removes from the structure the selected MobiLink system

Facilities

- Font

Selects the font type, style and size for the text in the windows that display configurations: "Modify Configuration" "View Configuration" "Last Configuration" Each of these windows has a correspondent into a selection performed over a tree command: - - "Connect to Modify...", - "Connect to View...", - "Last Configuration";

- Color signification

Shows the significance of colors used in windows that display configurations. Colors are used in the representation of the GSM module, FXS interface. You can change these colors according to your preferences.

- View print files

Opens a window in which you may see the text files in which other text files or data information have been printed using the button "Print" (or icon "Print")

About Shows the software version, such as 1.xy

Help Opens up the window with the help files for the OAM program

Exit Exit from the OAM program „ MobiLink.exe”

2.2. Icons description

The toolbar with button icons is located below the Menu. Some buttons are equivalent to options from the Menu or from Systems.

The icons toolbar is dynamic, its aspect differs according to the state of connection of the Topex MobiLink systems.

6

OAM Program „Mobilink” Manual for version 1.2 Definition of the icon buttons:

Icon Name/Equivalent to Significance

Systems > Add Adds a new Topex MobiLink system in the arborescent structure

Systems > Eliminate

Removes a Topex MobiLink system from the structure;

Print Prints the files, either to the printer or in a text file

Find Defines text to search for

Find next Finds next occurrence of the searched string

Configuration list Lists the configuration of the system

Save current configuration

Saves the configuration; works only in connected state – (option "Connect To Modify...")

Loading configuration

Loads a saved configuration; works only in connected state - option "Connect To Modify..."

Password mode Starts / stops operation in password protected mode

Users Allows definition of users for OAM software "Topex MobiLink.exe" (for password protected mode of operation)

Login

Allows access to the commands of the OAM program (connect, modify, loading software image) based upon the user’s settings. Active in the Password protected mode of work.

About from the menu Shows info about program

About from the menu Shows Help file

Exit from the menu Exits the OAM program

The toolbar with button icons is dynamic, its aspect changes according to actions performed by the user. Depending upon the connection state, the OAM toolbar software can look like this:

7


One Topex MobiLink system connected.

Viewing files for a system None of the above (no Topex system connected)

In different states of connection, some icon options may be available or not: when you are connected to a Topex MobiLink system, you can see and modify its configuration. When you use a „Connect to View” link, you are not allowed to perform changes, so the „Modify” icons are not available. Finally, if no MobiLink GSM is connected, the „Password” and „Login” icons are visible – when you are already connected to a system, you no longer need those two icon options. 2.3. Tree options The OAM application for Topex MobiLink makes use of a tree-like (branching) structure to launch actions over the selected MobiLink GSM system. As you see in the image below, the „tree” for each MobiLink system has several „branches”, which are the commands: Connect to …, Loading, Disconnect, Parameters and so on.

Through the OAM program you can configure and manage maximum 20 different MobiLink GSM devices. Each of the systems has an associated directory folder (in the same location with the application executable "MobiLink.exe " and a subdirectory for log and authentication files.

8


9

All systems can be sequentially accessed via serial cable in order to be configured and maintained (of course, you may connect only to one Topex MobiLink equipment at a time). OAM program sees the Topex MobiLink systems in a tree-like structure, where each MobiLink GSM has its own „branches”. You can perform settings upon the first (default) configuration or create a new one, then copy it for usage (after adequate editing) with the next Topex MobiLink system, etc. Description of the tree structure commands: cfg_ Significance

Connect To Modify...

Initiates a connection to the selected Topex MobiLink system in order to download system configuration and perform changes over it;.

Connect To View...

Connects to the selected GSM system in order to download the system configuration and view it; You can only see the configuration files, you are not allowed to change them!

Loading Image File

Initiates a connection with the equipment and loads a new software image (another image of the application software) into that system;

Disconnect...

Breaks the connection to the system if this connection was on; it is used to terminate the connection in each of the cases shown above

Parameters Displays the parameters of the connection to the GSM system; Allows you to change these communication parameters;

Last configuration Displays the latest (most recent) configuration received at the time of last status inquiry to the system;

Log Displays the log and lch (changes) files for the Topex MobiLink system;

Note. The OAM program can be connected to only Topex MobiLink system at any given moment. The command "Disconnect..." allows breaking the existing connection to a Topex MobiLink system; if the user selects another connecting option for the same Topex MobiLink system, then OAM application will break the previous connection and make a new connection, of the type you specified.


2.4. Option „Language selection” You may select the language used for information display. On the bar with the icon buttons, in the upper right corner of the

screen, there is also a listbox ( ) that allows you to change the language that is used in all menus, dialog boxes, windows and messages of the program. The default language is English, shown by the corresponding flag. You may select the language English, French or Romanian:

- English - French - Romanian 2.5. Status bar The status bar of the OAM program (displayed at the bottom of the screen) is divided into seven columns. See below illustration of the first and last part of the status bar.

… ... The first three columns (starting from the left side) display indicators for supervising a connection. These three fields are filled only in a state of connection between the "Topex MobiLink" software and a MobiLink GSM equipment. A state of connection (between the OAM software and the GSM system) can occur if one of the following options is selected: -"Connect To Modify..." or "Connect To View..."- "Loading Image File"..

The first column " " indicates the number of commands that will be sent to the Topex MobiLink system. Every modification (changes of system configuration) or data request that is performed on the system is translated into commands. Those commands are sent to the Topex MobiLink equipment; The second and the third columns of the Status bar show protocol messages. The protocol is implemented between "Topex MobiLink" software running on the PC and the Topex MobiLink system that connected to that PC. The second column contains messages which begin with character ">" and corresponds to the messages sent from the OAM software to the MobiLink GSM system. The third column contains messages that begin with character "<" and correspond to the messages received by the OAM software from the MobiLink GSM system. The fourth column displays the date and time of the computer system where the Topex MobiLink program is running. Date format is dd-mm-yyyy and hour format is hh-mm-ss (example:

" ");

10


The fifth and sixth columns are not currently used Finally, the seventh and rightmost column is a color indicator for the connection: light blue when the OAM program is connected to a MobiLink GSM unit (" ") or red if the program is NOT connected to a system (" ") 2.6. Display issues Please note that the panel located to right side of the tree structure window is used by two different types of windows. The first type of window is for displaying the configuration of the Topex MobiLink system, as a result of one of the following commands: - "Connect to Modify...", - "Connect to View...", - "Last Configuration". In those windows the right mouse button is used as follows: - for the windows "Modify Configuration” and ” Viewing Configuration", the serial port is opened. If you click the right mouse button over the status bar, a message ("Do you wish to disconnect?") will be displayed, asking you if you want to disconnect the connection to Topex MobiLink interface. - for the second case, when "Last Configuration" window is displayed, the right mouse button is used to hide the window. The confirmation message asks you: "Do you wish to hide last configuration?". All those windows include in the title bar the name of the connected/viewed Topex MobiLink system. For windows "Modify Configuration” and “Viewing Configuration", " only a click upon the tree command called "Disconnect" for the TOPEX system that is connected or viewed will caused the disconnection of the link between OAM and the connected system for the windows. In second case, the same "Disconnect" command will cause the display of the "Do you wish to hide configuration?" message. The second kind of window is the one used to display the log files, as a result of an action over the "Log" tree option. In this situation the title of the window includes the words "Local Viewer" and the name of the respective system. A right-click with the mouse will cause the message "Do you wish to hide?" to be displayed. The content of that second window can be updated with other data simply by selecting another option from the tree structure.

11


12

Note 1): if any of the following commands: "Connect To Modify...", "Connect To View...", and "Last configuration" is used while "Local Viewer" window is displayed, then the "Local Viewer" window will be hidden. Note 2): if "Local Viewer" command is used while any kind of window from the first type presented is displayed, then the "Local Viewer" window will be displayed over the other window. So the user must hide (using the right mouse button) the "Local Viewer" window in order to see again the window that was displayed before (and which is now hidden below, under the current window). 2.7. Files Like any OAM program, Topex MobiLink.exe uses several types of files: for events, for saving current configuration (your settings), system software image file (application software to be sent to a Topex MobiLink unit), etc. The log files are saved in the "Log" subdirectory for each MobiLink GSM system: they contain the moments of time for the connections to the system, the configuration read from the system and any modification performed on that configuration.

The configuration of a MobiLink GSM system can be downloaded and saved in a file named by the user. The file will have extension "cfg" and will be located in the "CONFIG" directory, in the same place where the program "Topex MobiLink.exe" is located. After you save the configuration of one Topex MobiLink system you can load it into several other Topex systems. The software image file has "hex" extension. It is a downloadable image of the software application that runs on the MobiLink GSM equipment. Such kind of file can be located anywhere on the HDD. The user will open the file from a dialog window and then the software image will be send into the respective Topex MobiLink system.

Login files are used to record information about which user was logged in or logged out of the system. It is a text file, it contains listings of the moments of time, the name of the user and the action performed (Connect / Disconnect).


2.8. Password protected mode The "Topex MobiLink" software includes a multiple (hierarchical) password protection implementation. This Password protected mode is useful when several users are working together with "Topex MobiLink" software and certain actions on Topex MobiLink system(s) must be performed carefully. According to the hierarchy, different users may have different access rights. The implementation assumes that one user is the administrator of the "Topex MobiLink" software and the first step is to create such a privileged user. The icons that refer to the password mode of operation are the

following: By default, the OAM application displays the first and second icon as being inhibited (not active). Only after you define the administrator you will be allowed access to the first icon (" "). In order to create an administrator you must choose the option "User definition" (" "). You enter the default password "topex" in the access password window, then the next image will appear to tells you that you must enter the identification data for the administrator:

Pess the button "OK" to confirm, then you may enter the settings for the users of the OAM program:

13


In the beginning the list is empty, so you must first add a user to the list by selecting the "Add" button to the right. Afterwards, you may delete or edit the already existing users:

For the administrator, the two boxes for allowed „Rights” are already selected. Of course, the administrator of the Topex system must have all the rights! The right "Changes allowed" ensures full access to all of the tree structure commands (meaning permission to change the configuration of the of the Topex system). The right "Views allowed" ensures access to the View Configuration command and also to the Disconnect command. For each new user, two fields must be always filled: "Name" and associated "Password". An additional window is used to confirm name and password.

Only the administrator can perform actions over definition of users. He can add, edit and delete other users. There is a restriction that specifies that the administrator cannot be deleted. Once the definition of an administrator is done, the subsequent access to the icon "Users definition" (" ") will require administrator name and password:

14


Also, when you selected the icon option "Password mode" (icon "")) the administrator name and password is required. Operation in Protected mode is indicated on the title bar of the "Topex MobiLink" software by the words "protected mode" showing up to the right (at the end). From this moment on the protected mode is started. Each launching of the MobiLink application is protected by the login window.

If name or password are not accepted - then the "MobiLink" application will exit (will not be launched). When an user is logged to a Topex system, this is shown by the word "user" followed by his name, which are added to the title bar. Note that users with the right "Changes allowed" has access to all of the tree-like commands. However, the users with the right "Views allowed" have access only to the command for viewing the configuration, "GSM Info" and "SMS Info" commands and to the "Disconnect" command.

Thus this user won’t be able to see the whole tree-like structure, he will see just these four options:

15


To log out of a Topex system, you should use the same " " icon. The word "user" will disappear from the title bar of the application. The user logout from the system is performed when the application is stopped. 2.8 Login file All log-ins and log-outs operations are saved into a file called "login.txt". Further on you have an example of content for the file "login.txt". As you see, there are saved the moments of time, the information about the users and the operation performed (connect / Disconnect). 11-05-2005 11:14:42 User 2 has connected to the Topex MobiLink system 11-05-2005 11:14:51 User 2 disconnected from the Topex MobiLink system 11-05-2005 11:14:53 User 1 has connected to the Topex MobiLink system 11-05-2005 11:15:00 User 1 disconnected from the Topex MobiLink system

After starting the password-protected mode of work, all subsequent accesses (connections) to Topex MobiLink systems will be protected by authorizing the access (the user must identify himself), as follows:

- for the command "Connect to Modify ..." - the user name and password are requested. User must have the right to perform changes over the configuration of the Topex MobiLink system ("Changes Allowed"). If the name or password entered are not the correct ones, the program will display the message: "Incorrect identification". If the respective user does not have the right to modify the configuration, then the warning "Operation not allowed" will be shown.

- - for the command "Connect to View..." - the user name and password are requested. There is no need for the user to have special rights. But if the name or password entered are not the correct ones, the program will display the message: " Incorrect identification ".

- - for the command "Loading image file" - the user name and password are requested. The respective must have the right to load a new image file on the Topex MobiLink system. If the name or password entered are not the correct ones, the program will display the message :"Incorrect identification". If the respective user does not have the right to load a new image, then the warning "Operation not allowed".

16


17

2.9 . Details about installing the MobiLink application

Take note of the number of the COM port where the serial cable to MobiLink is connected, so you can set the communication parameters. To begin, you must add an GSM interface to the tree-like structure of connections (see corresponding paragraph). For this, select option Systems->Add. For “Parameters” select the number of the COM port where MobiLink was connected, to be able to achieve communication with the MobiLink GSM interface. Before achieving the first connection to a Topex MobiLink system you may decide to use the password-protected mode of operation (with several levels of protection). If you decide NOT to use the password mode, then you can go directly to achieving a connection to the Topex system. You have several options for connecting, described in the next chapter. There are three basic types of connecting options, that is: - connect for changing (modify) or simply viewing of the

configuration (chapter 3.2) - connect to load a new software image (chapter 4) If you decide to use the password mode of operation, you must first perform the procedure described in chapter 2.7 (about Password mode), that is: – define an administrator, then add one or more users – go to Password mode of operation – quit the Topex MobiLink OAM application – from now on, when you restart the OAM application, the

password mode is enabled and you can go further, to connecting performing a connection with the MobiLink interface.


3. CONNECTING 3.1. Connecting methods Please note that there are three kinds of possible connections to a Topex MobiLink system: (a)- "Connect To Modify..." (b)- "Connect To View..." (c)- "Loading new image" Both option (a) and option (b) allow the user to connect to an GSM-MobiLink system and download the configuration. For option (a) the downloading of the configuration data is protected by a password. If the password is recognize by the equipment, the downloading process is started. Then the user will be able to perform changes over the configuration. With Option (b) you can only view the configuration, you can’t modify it. Finally, Option (c) allows the user to load a new image file (a new application software) into the MobiLink GSM system. See later on details about loading a new image file. Once the password is recognized by the GSM interface - as a result of a connection started by the a) or c) options - the password will no longer be requested from the user anymore - it will be automatically filled by Topex MobiLink OAM application. 3.2 "Connect to Modify" and "Connect to View" options (case a) and case b)) To achieve this kind of connection, first click on the "Connect" action you want to perform. In case of a connection to make changes over the system configuration (command "Connect To Modify..."), when the serial connection is successfully established with the Topex MobiLink system, a authentication window will show up: The login procedure on the remote equipment will ask you for the password. By pressing <ENTER> you will validate the password and close the "Login Window". Last window is displayed for the first connection made to the GSM system or after several authentication errors. The user can abort the login procedure by typing the <ESC> key in the "Login Window".

18

OAM Program „Mobilink” Manual for version 1.2 In case of unsuccessfully login (password mismatch), the password will be asked one more time. The message, which shows the unsuccessful login, is "Authentication failed".

The total number of attempts to login into the Topex MobiLink system is four. If the total number of attempts is exceeded, you will see an error message indication "Passing Authentication Retry Error

In the case of a connection successfully established, a dialog box will show up while the OAM program tries to download the configuration information. These are the settings for the GSM module (including info about PIN code), for the FxS interface, and the version of the application that runs on the system MobiLink GSM The OAM application will download the GSM, FXS/FXO settings and the GSM image version. Note1: the OAM program communicates with the connected Topex MobiLink system by sending and receiving messages. Each message send from the OAM software must be confirmed by the system. If the confirmation message is not received, then the OAM software resends the last sent message. There is a total number of four retries that can occur, after which an error message will be displayed: "Passing Connection Retry Error". Note2: If you are already connected to one Topex MobiLink system, you cannot connect to a different system; you must first disconnect from the first one. See more about the "Disconnect…" command.

19


3.3 "Modify Configuration" and "View Configuration” windows Once the configuration is downloaded, it will be displayed in the right pane of the "Modify Configuration" window (case (a) or the "Viewing Configuration" window (case (b). The user can view and respectively change the current configuration (settings) of the Topex MobiLink equipment that is connected to the OAM program.

The next screen shows up. You will notice: - on top, the Menu bar with names such as "Systems", "Facilities", "About", "Help" and "Exit"; - underneath it, a toolbar with different buttons marked with icons; - to the left, on yellow background, the tree-like structure of installed Topex MobiLink interfaces; - the right panel, on blue background, which is the main window; - the upper right corner of the OAM screen displays the flag corresponding to the language selected for display of menus, titles of windows, messages, etc. - at the bottom, the status bar, with its seven columns. Their meaning has already been described.

The blue configuration zone - "Programming Area" allows you to program (establish the settings) the Topex MobiLink unit. In the Programming Area the GSM port and the FXS interface are shown. Also in this area you may select the "Password" option.

20


The "Password" option is used to change the password used to connect to a MobiLink GSM system for modifications.

“Programming Area” shows a graphic representation of the GSM module and of the telephony interface type FXS.

The bottom right corner of the programming zone shows in white on a blue background the version of the application software running on the MobiLink GSM device (not to be confused with the version of the OAM program that runs on your PC). The format is " MobiLink 3G x.xx", in the above example the version is 1.01.

3.4. Programming Area

On five seconds intervals the OAM application MobiLink queries the state of the GSM module and of the FXS port. The status is shown on the representation of the device, besides the type („REGISTERED”, „IN CALL”, „STANDBY” etc.). Depending upon the state that the module is in, the color of the rectangle will change accordingly.

The GSM module can go through one of the following states: - STANDBY - the background is colored in dark blue - INITIALISING - background is colored in white - MISSING SIM - background is colored in red - PIN CODE - background is colored in red - PUK CODE - background is colored in red

21


- OP. FORBIDDEN (forbidden operator) - background is colored in red - UNREGISTERED - background is colored in red - TRYING - background is colored in red - REGISTERED - background is colored in dark blue

The FXS/FXO module can go through one of the following states: - STANDBY - the background is colored in dark blue - INCOMING CALL - background is colored in white - FORMARE CIFRE- background is colored in white - OUTGOING CALL - background is colored in white - SPEAKING - the background is colored in dark blue - BRELEASE (side B closed, is expecting that A side to close)- background is colored in white

The GSM module as well as the FXS or FXO interface can be configured by clicking the left mouse button over the respective rectangles.

3.4.1. Configuring the GSM module To configure a mobile module (GSM) click with the left mouse button over the rectangle showing the GSM module. The “GSM Port Settings” window shows up, allowing you to specify the operating parameters for the respective mobile module:

CLIR - Caller ID restriction. If this option is checked then the identity of the caller will not be sent (identity restricted). The identification number corresponding to the SIM used in the GSM module will NOT be sent out to the called party;

22


23

Changing PIN - Topex MobiLink changes the PIN code of the SIM. If the SIM has activated the option "PIN code request" and the value of PIN different from the value stored by Topex MobiLink, then the equipment will generate a random value of PIN code. This will become the new PIN code of the SIM. This setting is for „anti-efraction” purpose, it prevents the usage of the SIM on another mobile phone or GSM module; IN – input, port used for incoming calls; if this option is disabled then no incoming call will be accepted from the GSM network on this module; If you do NOT want to allow incoming calls on the GSM module, the best method is to disable the "IN" checkbox; OUT - output, the port will be used for outgoing calls; if this box is not checked, you won’t be able to make outgoing calls through the GSM port. In order to be able to initiate a call to the mobile network via the GSM module of Topex MobiLink, the box OUT must be checked; PIN Code - the PIN Code used by the system as PIN code of the GSM module. This value is used in the situation when the PIN code is requested by the SIM card. The length of the field "Pin Code" must be 4 …8 digits, with individual values between '0' and '9'. Section with settings "Prefix" and "Number of digits". Here you may fill in up to four different recordings, specifying the number of digits expected in order to send the call in the GSM network, depending upon the dialed prefix format (up to four digits). You may use the character 'x' instead of a figure, to signify that on that position any figure may exist. The fields "PIN Code" (digits from 0 to 9), the prefix fields (digits from 0 to 9 and the character 'x') and also the field that specifies the number of digits (maximum value is 20) will be checked for validating the values entered. In case of other values than the allowed ones, the field in error will be shown in red. Upon saving the changes performed, the OAM program will order the records. The MobiLink features a analog telephonic port - an FXS interface, or as a FXO interface. The configuring of these interfaces is shown next.


3.4.2. Configuring the FXS interface To configure the FxS interface, click on the FXS representation in the "Programming Area" and the window “FXS Settings” will appear, as shown below:

The window has three main zones: Category, Polarity and Timers. Line Voltage for Network Off – if you check this box, when the GSM module is not registered into the mobile network no line voltage is generated. This way the PBX where Topex MobiLink is connected may „see” that the respective outgoing trunk is not available. The PBX will know that no calls can get out using the Topex MobiLink interface;

24


25

Loop Break – upon ending a call, when the mobile subscriber (party 'B') hangs up, the line loop will be closed for a duration specified in "Loop Break Time". This way the ending of the call is signaled unambiguously, to ensure a correct billing; Hotline - this option allows activation of the Hotline service. If during the time specified by the value "Hotline Time" no digit is received, then MobiLink interface will automatically send the number specified in the field "Hotline Number" (up to 20 digits) Minute Minder - this option is used to access the audio warning on the voice call. The user will hear a sound indicating the taxation pulse. You specify the time period when a billing pulse could be generated - "Minute Minder Period" and also the time interval "Warning Time". This is the time period used as interval that should precede the generation by the operator of the billing pulse. Since the audio warning is generated earlier, the called party is allowed to hang up a moment before a new billing pulse is issued. So the user will pay less. Polarity This option refers to the polarity (positive or negative) of the voltage on the subscriber line, depending upon the different phases of a call: - "During ringing" - during the ring back tone - "During dialing" – while digits are dialed - "During a call from A" – during the conversation, when the call was initiated from the A side (from PSTNx) - " During a call from B" - during the conversation, when the call was initiated from the B side (GSM mobile network) - "After release from A" – after the side A (PSTN) has released the call - " After release from B" – after the side B (mobile network) has released the call.


3.4.3. Password This window allows you to change the password that is used as protection by the Topex MobiLink unit whenever you require the option to modify the configuration.

You must fill the password first in "New Password" then type it again in "Confirm Password" field. If the two fields contain the same strings then the new password will be sent to the program.

Note 1: The maximum length for both fields is 8 characters. Note 2: The default password is "topex"; you should change it to a password of your own choice. Note 3: This password is available just for the option "Connect to Modify...".

3.4.4. Saving and loading configurations

There are two icons (" "," ” for saving and respectively loading configurations for the Topex MobiLink system. Those icons are active only in the situation when the connection is established by the tree command "Connect To Modify...". To save a configuration click the icon :

Enter the name you want. The configuration will be saved in the "CONFIG" directory (located in the same directory as "Topex MobiLink" software). The "cfg" extension will be added to the name you have filled in the box above.

26


The configuration contains the settings of the GSM module, the FXS interface, the PIN code, and the password. Loading a configuration: to load a saved configuration click the icon. The window „Viewing CONFIGURATIONS directory” lists all the existing ".cfg" files, as shown:

You must select from the list the configuration you want to load, then click „Load”. Note1: when the user disconnects the connection (in case a) or b) then automatically the configuration will be saved in the directory "CONFIG" with the name "lastcfgx", where the last character 'x' indicates the Topex system for which the configuration is used. Note2: It is strongly recommended that before loading a new image file you save the current configuration, then load it again. This way you are sure that your settings will be kept (they won’t get lost).

3.5. Loading a New Image As explained previously this facility allows the user to load a new version of the software application running on the MobiLink GSM system. The image files have the extension "hex". Click the icon and the window „Loading image” swows up:

27


28

. The user selects the new software image to be loaded (with "hex" extension), then the OAM program will ask you for system access password:

The user can follow the progress of the upload process in the window called "Loading new image".

The user can also follow the progress of the upload on the status bar, in the boxes 2 and 3 (from left to right). The new software image is divided in packets which are sent to the MobiLink system. The second box will display the text ">Loading Packet xxx From yyy", where "xxx" is the current loaded packet and 'yyy' is the total number of packets to be sent. The third box displays "<Packet xxx received", where 'xxx' is the current confirmed packet.


When the loading process is succesfully finished the user will see the confirmation message:

Important notices related to the loading of a new version of application software into Topex MobiLink device:

• Caution! Before loading of the image file (menu "Loading Image File") it is strongly recommended that you save the current configuration of your Topex MobiLink unit. Click the icon "Save current configuration". Then, after you performed the loading of image file, reload the saved configuration by clicking the icon "Load configuration".

If you don’t do this your settings may be lost upon loading a new image file.

• Resuming after an interruption: If the loading of the image file is interrupted (the mains power fails, the operating system on the PC stops, the Serial cable is diconnected etc.) before reaching its normal ending, the new software may not be fully installed. To correct this, you should first reset Topex MobiLink (by taking off the supply jack for 10 seconds) and try again to load the image file. If this is not successful, you must change a jumper setting to perform forced loading of the application. The respective jumper on the PCB forces the bootloader to start. Then it can load the application and download a new (correct) image file for Topex MobiLink. Remember to take the jumper off pins (restore the normal positiom) before resuming normal operation of the MobiLink GSM equipment!

29


4. MENU 4.1 Systems 4.1.1 Add If you select "System > Add" the following window will appear, asking you to add another Topex MobiLink system to the arborescent structure.

Directory - enter a name for the folder in where the files downloaded from the Topex MobiLink system will be stored. A directory will be created on the hard disk drive, with the format "cfg_xxxxxxx" where xxxxxxy is the nameyou typed in the "Directory" field. The folder will be created on HDD in the directory where the OAM executable “Topex MobiLink.exe” is located.

Name - enter a name for the connection to the system. This names is concatenated at "cfg_" and this it will be the text used in tree structure for identifying the respective Topex MobiLink system. Serial Port num - enter the serial port used in case of serial communication with the system. The default value is COM1. This value must be in range COM1-COM12.

There is a text limit of 19 characters for the "Directory" and "Name" fields and 2 characters for the "Serial Port num". A value check is performed for the serial port value. If the value is not in the range 1 - 12, an error message will be displayed and the incorrect field will be colored in red.

30


Also, value checks are performed for the "Directory" and "Name" fields. If one of this values is not filled or is the same as an already existent "Directory" or "Name" (are used for another system), an error message will be displayed and the incorrect field will be colored in red.

Save - saves the setting and adds in the tree structure a system with the modified settings Cancel - closes the window without saving the settings.

4.1.2 Remove To remove a TOPEX GSM system from the tree-like structure, select it and then click on 'Save' button: the selected system will be deleted from the tree structure; the folder (directory) on your hard disk drive won't be deleted, you must erase it manually. If you select Cancel the window will be closed.

Note: if you want to change the parameters for a connection to a Topex MobiLink system, use the command „Parameters”. This command of the tree structure allows changing systems parameters: Name, and serial port number.

31


4.2 Facilities This group of command allows you to change the aspect of the graphic interface of the OAM program (fonts, colors), to view or print configuration files.

4.2.1. Font If you select "Facilities > Font" the following window will be shown:

In this window you can select according to your preferences the font, the style and size of characters. The changes will only affect the windows that are displaying the system configuration.

32


4.2.2 Colors signification This window shows the significance of the colors used to display the ports FXS or GSM for the windows: "Modify Configuration" and "Viewing Configuration" - colors which are changing depending of the state on which the SIM and the GSM module are currently in.

The only color which is currently used is "dark blue". The other colors will be used in further developments. The window also showns the colors used for "TextColor", "BackColor" (backgrund) and "TreeColor" (for the tree-like structure). All those colors can be modified according to users preferences by clicking on it.

33


You select the color you want, either from the predefined "Basic" colors, or from the detailed zone of custom colors.

The "Default" button is used to restore to the original color set.

4.2.3 View print file This is a facility for viewing text files located in the "FORMAT" folder. Those files are generated by printing data into files from different locations of the OAM program.

The files in this directory are the result of printing data into files from different locations from program. To see a file, select its name form the list and click the button 'View'. A window for viewing/editing the file now appears. You can also perform searches by using the buttons marked 'FIND' and 'NEXT'. Finally, you may use the button PRINT to can send to the printer a listing of the selected file.

34


4.3. Print options In all situations involving a print command a dialog box will appear. It features two options: - print to printer (a printer must be installed into the system of the PC where you run the OAM program) - print to file (in this case a file name is given, for saving data into that file).

NOTE Please remember that the OAM program uses two different types of windows. There is a window for viewing content of the files and another window for viewing or modifying system configuration and for analyzing of GSM module or sending/receiving SMS. This means that the action required to hide the current window may differ, depending upon what kind of window you are in:

• When you are working with files content you can operate upon the tree commands for the selected Topex MobiLink system and when you have finished you click the right mouse button to hide the window.

• If you are viewing a configuration, you can hide the window by pressing right button of the mouse. If you are connected to a Topex MobiLink system and the configuration window is above (on top), when clicking the right button you will be asked if you want to disconnect.

4.4 About

When selecting the option "About" this window is shown. “ About” indicates the software version of the OAM application MobiLink, in format such as 1.xy. It is important to know the exact version, because the newest program version include additional features. To close down the window "About" click the "OK" button.

35


4.5. HELP This is the command for showing the help (assistance) files, that is a simplified User Manual in electronic format.

The left pane of the help window shows an index of pre-defined keywords where you can search for the item (Icon command, menu command, Tree command, General considerations) you want to learn about.

The right pane offers detailed pages structured as "Menu description" (Systems, Facilities and so on) and respectively the "Tree Commands" (Connect to, Loading, etc).

The left pane of the help screen also includes the search facilities. You click on the "Search" tab and enter the word or the expression you want to look for, for example <tree structure>, then click "List Topics" to start the search: The help program will display all the occurrences it has found, together with the name of the help page where they are located and the rank (1, 2, 3 etc). Please note that, according to the general rules for text search, if you enter several words in the "Search field", the help program will look for occurences of EITHER word. This is like telling the help program <<search for 'GSM" OR for 'module">>.

36


If you want to be more specific, you should select the boolean operator AND instead of OR. For instance, if you want to know about the GSM module, you must search for "GSM module", using quotes. In this case, the help program will display only the occurences where ALL the words inside the quotes are found together. You select one of the occurences and click "Display" to show the respective help page in the right pane. The words or expressions you look for will be highlighted (marked with reverse video). If you want to search further inside the help page, press Ctrl F and a "Find" window will show up. You type the expression to search in the field "Find what", You may select additional options: "Match whole word only" and "Match case" if you want to narrow the search. You must specify the direction of the search inside the page, Up or Down. "Find Next" shows the following occurence of the word you want to search. The Search function of the help program remembers the words you entered, even if you close down the help. When you run "Help" next time the same word or expression will be displayed. Specific help

The window of each command now has a "Help" button of its own. This means that you no longer need to issue the "Help" command and then search or the item of interest. When you run a command, for instance "GSM settings", you just click its "Help" button and the respective help window will be displayed, showing you information about that particular command.

37


4.6 Exit Command for abandonning the OAM program OAM If you select "Exit" the following window will be displayed, asking you if you want or not to leave the program.

Select "OK" if you really want to exit the OAM program or select "Cancel" if you want to continue with the program.

5. OTHER COMMANDS OF THE TREE STRUCTURE Besides the commands explained previously, the tree-like structure of the OAM program also provides you the following commands:

5. 1. Disconnect Disconnect, breaks the connection to a connected Topex MobiLink system. You cannot disconnect a different system other that the connected system. A connection with a Topex GSM interface can occur due to an action over one of the following tree options: - "Connect to Modify..."; - "Connect to View..."; If you select another connection option (such as "Connect to Modify...", "Connect to View...", or "Loading New Image") on the same system, then OAM - MobiLink application will disconnect the previous connection and will perform a new connection with the specified type.

38


5.2. Modify parameters If you want to change the parameters for a connection, select from the tree-like structure "Parameters" and the following window pops up:

You may change the System name and the number of the serial port (in range COM1-COM12). The directory name cannot be changed, so it shows up in gray color. There is a text limit of 19 characters for the "Name" field and 2 characters for the "Serial Port num". A value check is performed for the serial port value. If the value is not in the range 1 - 12, an error message will be displayed and the incorrect field will be colored in red. Also, a value check is performed for the"Name" field. If this field is not filled or is the same as an already existent "Name" (is used for another system), an error message will be displayed and the incorrect field will be colored in red.

39


40

5.3. Last Configuration With this option you can see last downloaded (and eventually modified) configuration for the selected Topex MobiLink system. If you select this option the "LAST configuration" window will be displayed. You will be able to view offline last configuration: settings for GSM and FXS. You can see off-lin the last downloaded configuration even if the connection is no more on. Note: in this case the buttons "Ok" or „Save” from all windows will be hidden, because you cannot modifiy the system’s parameters. You can only look at the already existing settings – this helds true for all of the windows in the mode of operation „Last Configuration”.

5.4. Log Files The log files of the Topex MobiLink program are named <current date>.log and contain information about the events that took place: date and time for the making and respectively breaking of connections concerning the selected TOPEX MobiLInk system, file transfer and so on. See below th structure of a log file for Topex MobiLink OAM: Field Description Date dd-mm-yy Hour xx:xx:xx Event Description of the event that was performed

5.5. Changes files The lch files are named <current date>.lch , the extension signifies „chamges”.They include information about the changes (modifications) made to the TOPEX GSM system. Their structure is shown below: Field Description Date of change dd-mm-yy

Time of change xx:xx:xx

Modification Description of the change that was performed

Status OK - the change was successfully ERROR - the change was not successfully


41

6. Glossary Here you have the explanation of some terms and acronyms used in the operating manual for OAM program Topex MobiLink.exe: Bootloader – bootstrap loader, small program that launches first upon power up and helps loading the operating system. Any computer system can execut only code that is stored in DRAM memory, but the operating system is stored on hard disk drives or Flash memory. In the case of MobiLink GSM, the bootloader starts first when you power up the equipment and allows loading of the main application that controls the Topex interface. CLIP - Acronym for Calling Line Identity Presentation. This feature allows the ID (phone number) of the caller to be displayed during the call. It is a service of the phone network. For end-users, this service is handy in order to screen incoming calls, prepare the speciffic response, greeting the caller by name or looking up for missed or unanswered phone calls. The CLIP facility may be used to identify the subscribers who called and route the incoming calls according to their Caller ID. CLIR - Acronym for Calling Line Identification Restriction. Feature that restrict the identification of your caller ID to the other party. This hides your identity from callers with Caller ID feature. Topex MobiLink can activate this function, thus disabling the sending out of Caller ID. DISA – Acronym for Direct Inward System Access. This function allows an outside caller to directly access a local subscriber of the phone exchange by using DTMF codes. The typical application is when you call directly a local subscriber without need for a human operator at the phone exchange. Topex MobiLink ISDN makes use of DISA-like routing to manage both incoming and outgoing calls without need for a human operator. For example a local subscriber may dial (using DTMF codes) a mobile number via Topex MobiLink.

DTMF - Acronym for Dual Tone Multi Frequency, also known as "touch tone". Advanced method for dialing a number, instead of the older Pulse mode. When you press a key on the keypad a combination of two audio frequencies is sent on the line. DTMF capability is important because it allows access to a wide range of interactive voice applications. Topex MobiLink uses DTMF dialing to transmit the numbering from local subscribers to the mobile networks.Topex MobiLink uses dialing in DTMF mode to ensure phone connections without need for an operator at the PBX.


42

FXS - Acronym for Foreign Exchange Station. The FXS phone interface supplies ring, voltage, and dial tone for a “Station”, then may be an analog phone, a modem, a fax machine, or any analog device of the final user. The FxS interface of Topex MobiLink is ude for connection either to an analog trunk of the PBX or directly to a standard fixed phone. ITU-T - Acronym for International Telecommunication Union Standardization, Section Telecommunications. International standardiyation body in the field of telecomms.

PBX - Acronym for Private Branch eXchange. The PBX is a small, private version of the larger central switching office of the phone company. A PBX is a private telephone switch. It is connected to groups of lines (junctions) from one or more central offices and to all of the telephones at the location (subscribers, extensions) served by the PBX. Current exchanges are in fact PABX, automated PBX, which don’t require a human operator to route the calls. Topex MobiLink was designed to work together with an phone exchange (PABX) to route the calls. Topex MobiLink may be connected to the PBX n a trunk.

PSTN - Acronym for Public Switched Telephone Network (s). It is the classic international fixed telephony system based on copper wires that carry voice and data. Analog (mostly) or digital technology is used to provide voice grade services for the users that access that network via an analog interface. Topex MobiLink connects to a PBX that has trunks going to the PSTN, so Topex MobiLink performs as an interface between the mobile network and PSTN.


43

The manufacturer reserves the right to modify the product

and manual for the purpose of technical improvement without prior

notice. The manufacturer guarantees the good functioning of the

product provided that it has been correctly installed and the

directives for storage and usage have been respected. The

warranty implies exclusively repairing or replacing the defective

unit. The warranty does not include any indirect losses or loss of

profit. The manufacturer is not liable for any damage, whether

direct, indirect, special, incidental, or consequential, as a result of

using MobiLink.

No part of this manual may be reproduced, stored in a

retrieval system, or transmitted, in any form or by any means,

electronic, mechanical, recording, or otherwise, without the prior

written permission of the company TOPEX.

We certify hereby that the MobiLink GSM unit is

manufactured in concordance with the legal provisions concerning

responsibility towards the quality of delivered products, fulfills the

quality parameters specified in its “User’s manual” and is fit for the

purpose for which it has been designed. We also warrant that the

equipment will perform substantially in accordance with the

accompanying documentation.

Any comments, suggestions and proposals of yours

concerning our products are welcome and we are gladly waiting for

your feedback at the following address.

TOPEX S.A.

Feleacu nr. 10, sector 1 Bucharest 014186, ROMANIA

Tel: +4 021.408.39.00 Fax: +4 021408.39.09

E-mail: topex @ topex.ro Web: www.topex.ro

mobilink user en v1.12

Documents