Sie sind auf Seite 1von 44

MobiLink.

exe

OAM Program for


MobiLink GSM,
Software Version 1.2

OPERATING MANUAL
OAM Program „Mobilink” Manual for version 1.2

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


1
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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).

3
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
Adds a new Topex MobiLink system to the tree-
- Add
like structure
Removes from the structure the selected
- Remove
MobiLink system
Facilities
Selects the font type, style and size for the text
in the windows that display configurations:
"Modify Configuration"
"View Configuration"
"Last Configuration"
- Font
Each of these windows has a correspondent into
a selection performed over a tree command:
- - "Connect to Modify...",
- "Connect to View...",
- "Last Configuration";
Shows the significance of colors used in
windows that display configurations. Colors are
- Color
used in the representation of the GSM module,
signification
FXS interface. You can change these colors
according to your preferences.
Opens a window in which you may see the text
- View print files in which other text files or data information
files have been printed using the button "Print" (or
icon "Print")
About Shows the software version, such as 1.xy
Opens up the window with the help files for the
Help
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:


Name/Equivale
Icon Significance
nt to
Adds a new Topex MobiLink system in
Systems > Add
the arborescent structure
Systems > Removes a Topex MobiLink system
Eliminate from the structure;
Prints the files, either to the printer or in
Print
a text file
Find Defines text to search for
Finds next occurrence of the searched
Find next
string
Configuration list Lists the configuration of the system
Saves the configuration; works only in
Save current
connected state – (option "Connect To
configuration
Modify...")
Loads a saved configuration; works
Loading
only in connected state - option
configuration
"Connect To Modify..."
Starts / stops operation in password
Password mode
protected mode
Allows definition of users for OAM
Users software "Topex MobiLink.exe" (for
password protected mode of operation)
Allows access to the commands of the
OAM program (connect, modify,
Login loading software image) based upon
the user’s settings. Active in the
Password protected mode of work.
About from the
Shows info about program
menu
About from the
Shows Help file
menu
Exit from the
Exits the OAM program
menu

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
Initiates a connection to the selected Topex
Connect To MobiLink system in order to download
Modify... system configuration and perform changes
over it;.
Connects to the selected GSM system in
order to download the system configuration
Connect To View... and view it; You can only see the
configuration files, you are not allowed to
change them!
Initiates a connection with the equipment
and loads a new software image (another
Loading Image File
image of the application software) into that
system;

Breaks the connection to the system if this


connection was on; it is used to terminate
Disconnect...
the connection in each of the cases shown
above

Displays the parameters of the connection


Parameters to the GSM system; Allows you to change
these communication parameters;
Displays the latest (most recent)
Last configuration configuration received at the time of last
status inquiry to the system;
Displays the log and lch (changes) files for
Log
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.

9
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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).

12
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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.

17
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2
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
OAM Program „Mobilink” Manual for version 1.2
- 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
OAM Program „Mobilink” Manual for version 1.2

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.

23
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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.

25
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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.

28
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2
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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
OAM Program „Mobilink” Manual for version 1.2

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
dd-mm-yy
change
Time of
xx:xx:xx
change
Modification Description of the change that was performed
OK - the change was successfully
Status
ERROR - the change was not successfully

40
OAM Program „Mobilink” Manual for version 1.2

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.

41
OAM Program „Mobilink” Manual for version 1.2

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.

42
OAM Program „Mobilink” Manual for version 1.2

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 E-mail: topex @ topex.ro


Fax: +4 021408.39.09 Web: www.topex.ro

43

Das könnte Ihnen auch gefallen