O.A.M - Topex

Transcription

O.A.M - Topex
VOXELL
OPERATING MANUAL
2008
OAM Program „voxell.exe”
Operating Manual
TOPEX is a group of Romanian companies, founded in 1990, by 10
enthusiastic engineers experienced in telecommunications. Its
activity is directed to the research, development and production of
telecom equipment as well as service for them.
TOPEX becomes very quick the most important supplier of IT&C
solutions for small to large companies as well as for
telecommunications operators and providers in Romania. The
company designs equipment for all existing mobile systems (GSM,
CDMA), including 3G+ technologies.
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 secure solutions that we provide TOPEX
extended its business worldwide. Currently TOPEX delivers its
products through its distributors to: Italy, France, Spain, Greece,
Spain, Holland, Republic of Moldova, Bulgaria, Nigeria, Russia, UK,
Turkey, 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. At the present time, the Research and
Development Department counts 30 specialists and the trend is
ascending.
TOPEX also considered the training and the service as part of the
solutions it provides. Therefore, comprehensive trainings are
organized at 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. TOPEX become a sector
member of I.T.U. (International Telecommunication Union) since
2001.
For more details please visit www.topex.ro
1
OAM Program „voxell.exe”
Operating Manual
CONTENTS:
1. GENERAL DESCRIPTION ...................................... 4
1.1. Usage .................................................................. 4
1.2. Installing the program ....................................... 4
1.3. Menu description for OAM application................ 7
1.4. Icons description................................................ 8
1.5. Tree structure options ..................................... 10
1.6. Option „Language selection”.......................... 12
1.7. Status bar.......................................................... 12
1.8 Display Windows .............................................. 14
1.9. Files ................................................................... 16
1.10 Password protected mode ............................ 18
1.11 Details about installing the OAM application .. 21
2. CONNECTING Commands ................................... 25
2.1. Steps for Connecting........................................... 25
2.2. “Connect to Modify” and “Connect to View” 26
2.3 Programming Area................................................ 31
2.4. "UMTS Info"...................................................... 44
2.5. SMS Info ........................................................... 47
3. MENU DESCRIPTION .......................................... 67
3.1 Systems ............................................................. 67
3.2. Facilities ............................................................ 70
3.3 About .................................................................. 76
3.4 HELP .................................................................. 76
3.5. Exit ..................................................................... 78
4. OTHER COMMANDS OF THE TREE STRUCTURE
................................................................................... 78
4.1. Disconnect ........................................................ 78
4.2 Modify parameters............................................ 79
4.3. Last Configuration ........................................... 81
4.4 Log Files............................................................. 82
5. Glossary ................................................................ 85
Revision E, edition 2008.
2
OAM Program „voxell.exe”
Operating Manual
IMPORTANT NOTES:
There are several configuration parameters that are country
and provider speciffic. They are found as default settings of
the OAM program and also on the installation CD.
These paramaters are used for the Dial-up GPRS or UMTS
connection: the phone number of the operator for yours
voice/data mobile network (data provider), the user name
and the password for log-in, and additional AT commands.
The default values for the fist three parameters are:
*99***1#
internet.vodafone.ro
vodafone
The default initialization AT command string is:
"at+cgdcont=1,""ip"",""internet.vodafone.ro"""
Remember, you must replace the above values of the
parameters for data connection with the actual values issued
by the local carrier you are using!
3
OAM Program „voxell.exe”
Operating Manual
1. GENERAL DESCRIPTION
1.1. Usage
The OAM (Operation, Administration and Maintenance) program is
intended for the configuration and administration of the Topex
equipment “Voxell” via its USB port.
In addition, the program allows you to send and receive SMS
messages from the computer that is connected to the equipment or
to perform SMS to e-mail and e-mail to SMS automated
conversions.
The CD installation, supplied in the Voxell package, includes the
OAM program called "Voxell.exe". This self-content Win32
application runs on Windows 98/ 2000 /XP operating systems.
On the CD, you will also find the documentation (installation and
operation manuals, help file)
By means of the OAM application you may administrate (configure)
up to 20 different Voxell 3G devices.
The OAM program will connect to one or another of the Voxell
equipments, allowing you to see or to change the settings for each
one, and also to send or receive SMS messages to/from the mobile
network.
Each Voxell system connected to the OAM program uses a
different directory for its configuration files.
1.2. Installing the program
The OAM program Voxell.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 USB 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 Voxell equipment.
4
OAM Program „voxell.exe”
Operating Manual
Warning!
In order for the communication between PC and equipment to
operate, it is required that the PC has installed the USB driver
specific for the equipment. The installation procedure (automated
or manually) is described in the User Manual of the equipment. The
USB cable, which in case of Internet connection is used for data
transfer, is now employed for communication between the OAM
program running on your computer and the Voxell equipment.
If you have correctly performed the operations described in the
chapter „Achieving an Internet Connection” from the User Manual,
the communication link from PC to equipment is ensured, so you
can use the OAM program.
To install the OAM 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 Voxell.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 Topex VOXELL units. Each of these
Topex VOXELL systems uses a different directory „branch” for its
configuration (settings) and working files.
In order to connect the Topex VOXELL system to the computer
where the OAM software is running, you should use a standard
USB (A-B) cable (also found in the package of the equipment).
This cable features an
USB B connector at
one end, which will be
inserted
into
the
female
USB
B
connector of the Topex
VOXELL unit. The
opposite end of the
cable has a connector
type USB-A.
5
OAM Program „voxell.exe”
Operating Manual
This is for connecting to the USB (
) port of the computer that
you use for configuring and managing the Topex VOXELL
equipment, as shown in the image below:
The same USB cable is used to ensure wireless connection of your
PC to the Internet via GSM/GPRS/UMTS network.
Should your PC or
notebook have all
USB ports already in
use, you may need
an USB hub to
“multiply”
the
number of USB slots
available.
Structure of the graphic interface
The screen of the OAM program includes several elements:
- Menu Bar
- Toolbar (a set of buttons with icons)
- tree commands (Connect, Lading, Parameters)
- different „Programming Area” or „Info” screens (for SMS, for
UMTS module, for FXS or FXO telephony interface).
All these elements of the Voxell.exe program will be described in
the paragraphs that follow.
Then, concluding the first chapter, you will see a paragraph
detailing issues of the program’s installation.
6
OAM Program „voxell.exe”
Operating Manual
1.3. Menu description for OAM 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 Voxell equipment (system) to the treelike structure
- Remove
Removes (eliminates) from the structure the
selected Voxell system
Facilities
Selects the font type, style and size for the text in
the windows that display configurations:
"Modify Configuration"
"View Configuration"
"Analyzing UMTS module"
"Analyzing SMS Info"
"Last Configuration"
- Font
Each of these windows has a correspondent into a
selection performed over a tree command:
- "Connect to Modify...",
- "Connect to View...",
- "UMTS Info"
- "SMS Info"
- "Last Configuration";
- Color
signification
Shows the significance of colors used in windows
that display configurations. Colors are used in the
representation of the UMTS module, FXO/FXS
interfaces. 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 "Voxell.exe”
7
OAM Program „voxell.exe”
Operating Manual
1.4. Icons description
The toolbar with button
icons is located below
the Menu.
Some of the 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 VOXELL systems.
Definition of the icon buttons:
Icon
Name/Equivalent
Significance
to
Systems > Add
Adds a new Topex VOXELL system in the
arborescent structure
Systems >
Eliminate
Removes a 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
Save current
configuration
Saves the configuration; works only in
connected state – (option "Connect To
Modify...")
Loading
configuration
Loads a saved configuration; also 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
(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
8
OAM Program „voxell.exe”
Operating Manual
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:
One Topex VOXELL system
connected, all icons with options are
available.
Viewing files for a system, only
these icons are available
None of the above situations (no
Topex VOXELL system is
connected)
In different states of connection, some icon options may be
available or not: when you are connected to a Topex VOXELL
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 Topex VOXELL
equipment 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.
9
OAM Program „voxell.exe”
Operating Manual
1.5. Tree structure options
The OAM application for Topex VOXELL makes use of a tree-like
(branching) structure to launch actions over the selected Voxell
interface (Voxell system).
As you see in the image to the
left, the „tree” for each Voxell
system has several „branches”,
which are the commands:
Connect To, UMTS Info, SMS
Info,
Loading,
Disconnect,
Parameters and so on.
Through the OAM program, you
can configure and manage
maximum 20 different Voxell
equipments. Each of these
systems has an associated
directory folder (in the same
location with the application
executable "Voxell.exe" and a
subdirectory for the log and
authentication files.
All systems can be sequentially
accessed via USB cable in
order to be configured and
maintained (of course, you may
connect only to one equipment
at a time).
The OAM program sees the Voxell systems in a tree-like structure,
where each equipment has its own „branches”.
You can perform settings upon the first (default) configuration or save
a configuration and then load it on the next Voxell, etc.
The commands of this tree-like structure are explained in the next
paragraph.
10
OAM Program „voxell.exe”
Operating Manual
Description of the tree structure commands:
cfg_
Significance
Connect To
Modify...
Initiates a connection to the selected system
in order to download system configuration
and perform changes over it;
Connect To
View...
Connects to the selected Voxell 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!
UMTS Info
Initiates a connection to the selected Topex
Topex VOXELL system and allows the
analysis of GSM/UMTS module.
SMS Info
Initiates a connection to the selected Topex
Topex VOXELL system and allows you to
send and receive SMS messages from the
computer;
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 UMTS 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;
Log
Displays the log and lch (changes) files for
the Topex VOXELL system;
Note. The OAM program can be connected to only ONE Voxell
system at any given moment. The command "Disconnect..." allows
breaking the existing connection to a system; if the user selects
another connecting option for the same Voxell system, then OAM
application will break the previous connection and make a new
connection, of the type you specified.
11
OAM Program „voxell.exe”
Operating Manual
1.6. 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
The default is for English; if you change this, all titles and dialogs
will be shown in the other language, for instace Romanian:
1.7. 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 OAM software "Voxell.exe" and a Voxell equipment, else they
are empty. A state of connection (between the OAM software and
the UMTS system) can occur if you have selected one of the
following options: -"Connect To Modify..." or "Connect To View...","UMTS Info" or "SMS Info"- "Loading Image File"..
" or “
“
The first column "
indicates the number of commands that will be sent to the Topex
VOXELL 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
Topex VOXELL equipment;
12
OAM Program „voxell.exe”
Operating Manual
The second the third columns show protocol messages. The
protocol is implemented between the OAM software running on
your PC and the Topex VOXELL 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 3G equipment.
The third column contains messages that begin with character "<"
and correspond to the messages received by the OAM software
from the system. In the above image of the status bar you may see
in this column “<Read Category”, meaning that the category of the
Voxell voice and data UMTS interface is read.
The fourth column displays the date and time of the computer
system where the OAM program is running. Date format is dd-mmyyyy
and
hour
format
is
hh-mm-ss
(example:
");
"
The fifth column is used to indicate the length of the SMS2MAIL
queue (converts SMS into e-mail messages).
The queue accepts maximum 1.000 (one thousand) messages.
Likewise, the sixth column is used to indicate the length of the
MAIL2SMS queue (conversion from e-mail messages to SMS).
This queue also accepts maximum 1.000 messages.
Finally, the seventh and rightmost column is a color indicator for
the connection:
-
light blue ("
") when the OAM program Voxell.exe is
connected to a UMTS unit;
and respectively red ("
") if the program is NOT
connected to a system.
13
OAM Program „voxell.exe”
Operating Manual
1.8 Display Windows
Please note that the panel located to right side of the tree-like
structure is used by two different types of windows.
i)
The first type of window is used for displaying the
configuration of the Topex VOXELL system:
it is a result of one of the following commands:
- "Connect to Modify...",
- "Connect to View...",
- "UMTS Info",
- "SMS Info" or
- "Last Configuration".
In those windows, the right mouse button is used as follows:
- for the windows "Modify Configuration”,” Viewing
Configuration", "Analyzing UMTS module" and "Analyzing
SMS Info" the USB 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 the VOXELL equipment.
- 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?”
14
OAM Program „voxell.exe”
Operating Manual
All those windows include in the title bar the name of the Topex
VOXELL system to which you connected to modify or to
view/viewed, as shown in the three examples below:
For the windows "Modify Configuration”, “Viewing Configuration",
"Analyzing UMTS modules" and "Analyzing SMS Info", only a click
upon the tree command called "Disconnect" for the Voxell system
that is connected or viewed will caused the disconnection of the link
between OAM and the connected system for the windows. In the
second case, the same "Disconnect" command will cause the
display of the "Do you wish to hide configuration?" message.
ii) 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. As shown in the examples
below:
15
OAM Program „voxell.exe”
Operating Manual
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.
Note 1): if any of the following commands: "Connect To Modify...",
"Connect To View...", "UMTS Info", "SMS Info" 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).
1.9. Files
Like any OAM program, Voxell.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 Voxell unit),
etc.
16
OAM Program „voxell.exe”
Operating Manual
The log files are saved in the "Log" subdirectory for each Voxell
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 Voxell 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 " Voxell.exe" is located. After you save the
configuration of one equipment, you can load it into several other
devices.
As you see in the listing above, there are two kind of configuration
files: the ones created automatically by the OAM program when
you shut it down to save the ”last configuration”: lastcfg1, lastcfg2
… and the ones created by the customor with specific names:
TOPR1, DOBRE2, ORG3+ … etc.
The software image file has "hex" extension. It is a downloadable
image of the software application that runs on the Voxell
equipment. Such kind of file can be located anywhere on the HDD
of your computer. The user will open the file from a dialog window
and then the software image will be send into the respective Voxell
equipment.
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).
17
OAM Program „voxell.exe”
Operating Manual
1.10 Password protected mode
The OAM software includes a multiple (hierarchical) password
protection implementation. This Password-protected mode of
operation is useful when several users are working together with
the "Voxell.exe" software and certain actions over the Topex
VOXELL 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 OAM software and the first step must be 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).
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 "umts" in
the access password window, then the next image will appear to
tell you that you must enter the identification data for the
administrator:
Press the button "OK" to confirm, then you may enter the settings
for the users of the OAM program:
18
OAM Program „voxell.exe”
Operating Manual
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 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.
19
OAM Program „voxell.exe”
Operating Manual
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:
Also, when you selected the option "Password mode" (icon
showing a lock " ”) the administrator name and password is
required. Operation in Protected mode is indicated on the title bar
of the OAM software by the words "protected mode" showing up to
the rightmost position (at the end).
From this moment on the protected mode is started. Each
launching of the Voxell.exe application is protected by the login
window.
If the name or password you entered are not accepted - then the
"Voxell.exe" application will exit (will not be launched).When an
user is logged to a Voxell syst
em, 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, so they see on the screen all the
branches of the tree-like structure. However, the users with the
right "Views allowed" have access only to the command for
viewing the configuration, "UMTS Info" and "SMS Info" commands
and to the "Disconnect" command.
20
OAM Program „voxell.exe”
Operating Manual
Thus this user won’t be
able to see the whole treelike structure, he will see
just these four options:
To log out of an equipment, you should click 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 OAM
application is stopped.
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 system
11-05-2005 11:14:51 User 2 disconnected from system
11-05-2005 11:14:53 User 1 has connected to the system
11-05-2005 11:15:00 User 1 disconnected from system
1.11 Details about installing the OAM application
Before establishing a first connection to an Voxell interface, you
must first perform all the steps shown in chapter “Achieving an
Internet Connection” of the User’s Manual for this product.
Most important, you must be sure that the USB driver has been
installed on the PC or notebook that you use. This is required
because the USB connection of the equipment is used both for
high-speed data transfer over the UMTS network and for
administration of the equipment by means of the OAM program.
0 When you install the Internet connection, note the COM port (for
example COM5) where the Topex VOXELL interface is installed,
since the respective port will be used by the OAM application to
communicate with the equipment.
21
OAM Program „voxell.exe”
Operating Manual
If you don’t remember the port, use the command Start>Control
Panel>System
>Hardware>Dev ice Manager>Ports:
Among the COM and LPT ports listed, you should see the “Prolific
USB-to-Serial Comm Port” where Voxell is connected:
22
OAM Program „voxell.exe”
Operating Manual
In the above example, the port COM3 is used, so this is the number
of the COM port you must specify for the connection between
OAMprogram and Voxell device.
To begin, you must add a Voxell interface to the tree-like structure
of connections (see paragraph 6.11).
Select the options Systems->Add.
To ensure communication with the respective Voxell interface, in
the field “Serial Parameters” you must select the number of the
serial port where the USB driver was installed.
You should remember this COM port number form the chapter
„Achievement of an Internet connection” of the User’s Manual.
If you don’t specify the
correct COM port, you will
get an error message like
this:
23
OAM Program „voxell.exe”
Operating Manual
Before you achieve the first connection to a Topex VOXELL
system, you should decide whether to use or not the password
protected (hierarchical) mode of operation, which is shown in
chapter 2.8.
If you decide NOT to use the password mode, then you can go
directly to the achievement of a connection to the respective Topex
VOXELL system.
Options for connection:
There are three basic types of options for connection, respectively:
Connecting for making changes over the configuration or just
viewing the configuration (chapter 2.2)
Loading a new software image (chapter 5)
Settings related to the “analysis” of the UMTS module and of
the SIM card (IMSI, IMEI codes and the operator where the
SIM is registered - chapter 3), or sending / receiving SMS
messages. All these options are valid only if the Voxell
equipment has inserted a SIM card that is registered to the
mobile network.
If you decide to use the password-protected mode, then you must
follow the procedure described in chapter 1.10, that is:
–
Define an administrator, then add one or several users
–
Go to the password-protected mode of operation
–
Quit (exit from) the OAM application
– From now on, when you start again the OAM application, the
password-protected mode of work is active, so you may go on
to connect to a Topex VOXELL interface.
24
OAM Program „voxell.exe”
Operating Manual
2. CONNECTING Commands
2.1. Steps for Connecting
Please note that there are five kinds of possible connections to a
Topex VOXELL system:
(a)- "Connect To Modify..."
(b)- "Connect To View..."
(c)- "UMTS Info"
(d)- "SMS Info"
(e)- "Loading new image"
Both option (a) and option (b) allow the user to connect to a Voxell
equipment 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.
Options (c) and (d) are used without a password request and imply
only actions that can be done over the UMTS module. Information
about the SIM card and the GSM/GPRS/UMTS module can de
shown, SMS may be sent or received, the SMS to email and mail to
SMS functions can be used.
Finally, Option (d) allows the user to load a new image file (a new
application software) into the Voxell 3G system. See later on details
about loading a new image file.
Once the password is recognized by the Voxell voice and data
UMTS interface - as a result of a connection started by the a) or e)
options - the password is not required to the user anymore - it is
automatically filled by vxell OAM application.
25
OAM Program „voxell.exe”
Operating Manual
2.2. “Connect to Modify” and “Connect to View”
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 USB
connection is successfully
established with the Topex
VOXELL 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". This window is displayed only for
the first connection made to the Voxell system or after several
authentication errors.
The user can abort the login procedure by typing the <ESC> key in
the "Login Window".
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 VOXELL
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/GPRS/UMTS module (including info about PIN code), for the
FxS/FxO telephony interface, and the version of the application that
runs on the respective system Topex VOXELL.
The OAM application will download the UMTS, FXS/FXO settings
and the version of the firmware image.
26
OAM Program „voxell.exe”
Operating Manual
Note1: the OAM program communicates with the connected Topex
VOXELL 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 VOXELL
system, you cannot connect to a different system; you must first
disconnect from the first one. See more about the "Disconnect…"
command.
Note 3: You can be connected only to ONE Voxell system at a
time! If you are already connected to one Voxell system, you
cannot connect directly to a different device; you must first break
the connection to the first system, by using the Disconnect
command.
Note 4: The „Password” window mentioned above is displayed only
the FIRST time you connect to the system or in case of successive
authentication errors. Such errors can occur, for instance, when
you switch the devices. Suppose you have at least two connections
with two different Voxell devices that may be connected to the
same PC, and each Voxell has its own password.
Normally, you use connection 1 for the equipment 1, and
connection If by mistake you physically switch the two devices (you
place equipment 2 on connection1, but this equipment needs a
different password from the one stored by the OAM application for
the respective position) an error will occur. This is what happens:
i) first, the authentication error is signaled, you will see the
message "Authentication failed".
ii) then the OAM program attempts up to four times to connect, then
gives up and displays the message "Passing Authentication Retry
Error".
iii) finally, the Password window shows up, allowing you to enter
the correct password for the new system (no 2).
iv) further on, if you keep the correct connections, the Password
window doesn’t show up anymore, you are no longer required to
enter the password, because it is stored by the OAM program.
27
OAM Program „voxell.exe”
2.2.1.
"Modify
Operating Manual
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
Voxell equipment that is connected to the OAM program.
The next screen shows up:
In the previous image 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;
28
OAM Program „voxell.exe”
Operating Manual
- to the left, on yellow background, the
tree-like structure of installed Topex
VOXELL interfaces
- the right panel, blue, 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.
29
OAM Program „voxell.exe”
Operating Manual
The blue configuration zone - "Programming Area" allows you to
program the Voxell unit (establish the settings for it). In the
Programming Area there are shwn two rectangles, representing the
UMTS port and respectively the FxO/FxS interface. Also in this
area you can see the signal level and you may select the
"Password" option. The "Password" option is used to change the
password used to connect to a Voxell system for modifications.
“Programming Area” shows a graphic representation of the
GSM/GPRS/UMTS/HSDPA module and of the telephony interface
type FXS or FXO.
Firmware version
The bottom right corner of the programming zone shows in dark
blue on the light blue background the version of the application
software running on the Voxell device (not to be confused with the
version of the OAM program that runs on your PC).
The format is "Voxell 3G x.xx.x", where
x.xx.x is the version, such as 1.18.1. or
respectively 3.20.cnx in the examples to
the right.
30
OAM Program „voxell.exe”
Operating Manual
2.3 Programming Area
The window “Programming Area” looks like this:
On five seconds intervals the OAM application Voxell.exe queries
the state of the GSM/GPRS/UMTS module and of the FXS/FXO
port. The status is shown on the representation of the device, such
as
„REGISTERED-2G”,
„REGISTERED-3G”,
„SPEAKING”,
„STANDBY” etc.
Depending upon the state that the module is in, the color of the
rectangle will change accordingly.
Level of the mobile signal
Between the rectangle representing the "UMTS" module and the
rectangle showing the FXS/FXO interface, the level of the
GSM/GPRS/UMTS/HSDPA signal is displayed as a bar graph. The
signal level is expressed on a scale from 0 to 31. The reading of
the RF level is updated also every five seconds.
31
OAM Program „voxell.exe”
Operating Manual
UMTS module
The UMTS 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
- OP. FORBIDDEN (forbidden operator) - background is colored in
red
- UNREGISTERED - background is colored in red
- TRYING - background is colored in red
- REGISTERED – either to a 2G mobile network or to the 3G
network, the background is colored in dark blue
32
OAM Program „voxell.exe”
Operating Manual
FXO/FXS Interface
The FXS/FXO telephony interface can go through one of the
following states:
- STANDBY - the background is colored in dark blue
- INCOMING CALL - background is colored in white
- MAKING DIGITS - 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 UMTS module as well as the FXS or FXO interface can be
configured by clicking the left mouse button over the respective
rectangles.
33
OAM Program „voxell.exe”
Operating Manual
2.3.1. Configuring the UMTS module
To configure the mobile module (GSM/GPRS/UMTS) click with the
left mouse button over the rectangle showing the UMTS module.
The “UMTS Port Settings” window shows up, allowing you to
specify the operating parameters for the respective mobile module:
Category
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 UMTS
module will NOT be sent out to the called party;
Changing PIN –Topex VOXELL changes the PIN code of the SIM
card. If the SIM has activated the option "PIN code request" and the
value of PIN different from the value stored by Topex VOXELL,
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 „antiefraction” purpose, it prevents the usage of the SIM card on
another mobile phone or GSM/GPRS/UMTS module;
IN – input, port used for incoming calls; if this option is disabled
then no incoming call will be accepted from the GSM/UMTS
network on this module;
If you do NOT want to allow incoming calls on the UMTS module,
the best method is to disable the "IN" checkbox;
34
OAM Program „voxell.exe”
Operating Manual
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
UMTS port. In order to be able to initiate a call to the mobile
network via the GSM/GPRS/UMTS module of the Voxell
equipment, the box OUT must be checked;
PIN Code - the PIN Code used by the system as PIN code of the
GSM/UMTS module. This value is used in the situation when the
PIN code is required 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/UMTS 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 Voxell equipment features a analog telephonic port that you
may configure either as a FXS interface, or as a FXO interface. The
configuring of these interfaces is shown next.
Note: Since only one of the interfaces may be active at any given
moment, in the „Program Zone” of the OAM screen you will allways
see a single rectangle representing the telephony interface, which
can be either FXS or FXO.
or
35
OAM Program „voxell.exe”
Operating Manual
2.3.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 show
up as in the drawing below:
The window has five main zones: Category, Polarity, Timers, CLIP
and Teletax (metering).
¾
Category
Line Voltage for Network Off – if you check this box, when the
GSM/UMTS module is not registered into the mobile network no
line voltage is generated. This way the PBX where Voxell is
connected may „see” that the respective outgoing trunk is not
available. The PBX will “know” that no calls can get out using the
Voxell interface;
36
OAM Program „voxell.exe”
Operating Manual
Loop Break – upon ending a call, when the mobile subscriber
(party 'B') hangs up, the line loop will be closed for 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 the Voxell equipment 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 must specify the respective time periods.
"Asymmetrical ring voltage" - this option is used for choosing the
type of ring voltage, symmetrical or asymmetrical. A symmetric or
balanced ring signal (option "Asymmetrical ring voltage" disabled)
includes no continuous (DC) component, the average value is zero.
An asymmetric ring type (option "Asymmetrical ring voltage"
enabled) means that the ring signal contains a DC component; its
mean value is no longer zero.
37
OAM Program „voxell.exe”
¾
Operating Manual
Timers
Loop Break Time – the duration, in milliseconds, of the breaking of
the line loop, used for signaling.
Hotline Time – duration (in seconds) of the delay following which
the Holtline service will be called. Hotline Number – phone number
(up to 20 digits long) of the Hotline service.
Minute Minder Period - the time period (in seconds) after which a
billing pulse will be generated. If you set it at 60 seconds, a billing
pulse will be generated every minute.
Warning Time - the time period (also in seconds) used as interval
when the warning should precede the generation by the operator of
the billing pulse. For instance if you set “5”, the warning beep will
be issued 5 seconds before the end of the billing period. Since the
warning is issued earlier, the called party is allowed to hang up a
moment before a new billing pulse is issued. Thus, the user will
end the call and pay less.
Note: The value established by the timer „Minute Minder Period” (of
65 seconds in the above image) is also used for the „Teletax” area.
Therefore, even if you do NOT use the audio warning facility for the
end of the billing period, you may fill-in this value, to be used for
generation of Teletax (metering) signals.
¾
Polarity
This option refers to the polarity (forward/reverse, 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 PSTN)
- " During a call from B" - during the conversation, when the call
was initiated from the B side (GSM/UMTS 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.
38
OAM Program „voxell.exe”
Operating Manual
¾ CLIP
CLIP section - allows the „presentation” (sending out) of the identity
of the calling party.
If you want to transmit CLIP, you must choose to send it either
before the first ring signal, or after the ring. Then you select the
standard to be used for CLIP transmission; the options are ETSI
FSK or Bellcore FSK and ETSI DTMF respectively. In both cases,
the ID of the caller will be sent out according to the respective
standard.
ETSI FSK – uses European FSK (Frequency Shift Keying) method
for sending out the caller ID. There is also an Amarican standard
for FSK (ETSI). The ETSI-FSK method is used by ountries such as
Spain and Austria.
ETSI DTMF - generates Caller ID by Dual Tone Multi-Frequency
method (in-band audio tones).
You must choose the variant which fits the best the specifications
of the PBX that you use.
If you select one of the options, the caller ID will be sent out by
Voxell before or respecively following the first ring. This way the
analog phone connected to Voxell will receive the caller ID and
may display it if it has this capability. Likewise, if Voxell is
connected on a trunk of the PBX and the exchange is set to Target,
the local extension that is called will get the ID of the caller, relayed
by Voxell.
¾ Teletax
Teletax section - allows Voxell to send metering or billing pulses
(teletax) to the terminal equipment. These billing pulses are used
by some phone exchanges for accurate billing of the calls.
Without Teletax - Options for sending teletax are with 12 or 16
kHz.
Section Teletax - the default option means no billing pulses are
transmitted.
You may select the frequency of the billing pulses, either 12 KHz or
16 kHz, according to the specifications of the PBX. These highfrequency pulses will not be heard by the users.
The Period for billing (period of metering pulses) is established by
the „Minute Minder timer”.
The button "Change to FXO" from the bottom right of the window
allows reconfiguration of the interface as type FXO.
39
OAM Program „voxell.exe”
Operating Manual
2.3.3. Configuring the FXO Interface
The window „FXO Settings” allows you to configure the telephony
interface as type FxO.
Action (DISA - disabled, TARGET - enabled) – specifies how the
incoming calls should be treated. You have either the option to
supply the caller with DISA tone, allowing him to dial numbers in
DTMF mode, or the option to specify a target – the field "Target".
(up to 20 digits). In this case the DISA feature is not used, instead
the incoming call is routed directly to the local extension
established in the Target field. The extension may be the attendant
console, so the operator will route the call accordingly.
Warning, unauthorized voice access is possible! If there are no
restrictions regarding the access rights of the extension where Voxell
is connected, anyone who calls the mobile number of the Voxell
UMTS from a public network will get access to the outgoing lines of
the PBX. He will be able to make long distance calls that will be
charged to the owner of the phone exchange.
40
OAM Program „voxell.exe”
Operating Manual
To avoid this risk you have two possibilities:
1. Either configure the PBX to reject the outgoing calls that are
initiated from the extension where the Voxell interface is
connected.
2. Or, if the exchange cannot be configured in that way, then you
must set the Voxell equipment not to offer a DISA tone when a
mobile phone call coming in. Instead, specify a “FXO Target
Number” instead of providing DISA tone. The PBX will route the
call to the operator. Instead of leaving the “FXO Target Number”
on the default “off” value, type the number of the operator desk.
Generate Dial Tone (for outgoing calls) – generates or not audio
dial tone for the caller. If this option is inhibited, when connecting to
the Voxell interface, an audible dialing tone is generated – but one
can still dial digits DTMF mode. In case the option is enabled, the
equipment generates audible tone for dialing digits in DTMF mode,
tone that the caller can hear.
Hotline – this option allows activation of the Hotline service. If
during the time specified by the value "Hotline Time" no digit is
received, then the Voxell interface used for Topex VOXELL 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.
„ Busy Tone Monitor - this setting, together with the button "Busy
Monitor" refer to the requirement that the FXO interface correctly
remembers the busy tonality. In order to monitor the busy tone, the
following working method is used, that implies the „teaching” of the
interface how to identify busy tone:
- at first, the category " Busy tone Monitor " is inhibited;
- go to the PBX where the Voxell equipment is connected; the
Voxell device will answer the call
- then you should up the extension from where you made the call.
41
OAM Program „voxell.exe”
Operating Manual
This way a busy tone will be generated towards the extension
where the Voxell device is connected;
- now you can start the procedure for „teaching” of the busy tone to
the Voxell unit: select the option "Busy Monitor". User must
approve the message "Do you wish to start the busy tone
monitoring?".
The interface (junction) is released, following a time interval, by the
Voxell equipment. The user can follow in the status bar the
confirmation message - "Detection Succeeded" or an error
indication "Detection Failed".
- go to the checking of the correct operation of the monitoring of
busy tone. For this, validate in „CATEGORY” the option " busy tone
Monitor ". Repeat the above procedure (of making a test call to the
number of the local extension where the Topex VOXELL interface
is connected). The Voxell interface answer, the call is released, and
you check if FXO interface is released after a few seconds. If yes,
this means that Voxell equipment has learned correctly the busy
tone. If not, you must un-check the box “busy tone Monitor” and
then start over again the learning process.
Warning! The option Busy Monitor may be disabled (Off), but it is
strongly recommended that you use it.
If you leave it disabled, the Voxell equipment cannot sense when
the subscriber that called has hang up, and the PBX has send
“busy” tone. If the called party is a human being using a cell phone,
he will hear the busy tone and should hang up. But if the
correspondent is another equipment such as Bytton, Voxell or
multiACCESS, it won’t realize that the call has been ended, and the
link will remain on. Consequently, the phone bill will be huge!
To prevent this from happening, you should use the “Busy Tone
Detection” option.
The button "Change to FXS" from the bottom right of the window
allow reconfiguration of the interface as type FXS.
42
OAM Program „voxell.exe”
Operating Manual
2.3.4. Password
This window allows you to change the password that is used as
protection by the Voxell 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.
Note1: The maximum length for both fields is 8 characters.
Note2: The default password is "umts"; you should change it to a
password of your own choice.
Note3: This password is available just for the option "Connect to
Modify...".
2.3.5. Saving and loading configurations
"," ” for saving and respectively loading
There are two icons ("
configurations for the Topex VOXELL 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 the OAM
software). The "cfg" extension will be added to the name you have
filled in the box above.
43
OAM Program „voxell.exe”
Operating Manual
The configuration contains the settings of the GSM/GPRS/UMTS
module, the FXS or FXO 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 Voxell 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).
2.4. "UMTS Info"
With this option you can obtain information about the wireless
module GSM/GPRS/UMTS. In the “Programming Area” you can
see the zone called "UMTS Info".
Click the left mouse button over the representation of the UMTS
module and the „Analysis” window is displayed:
44
OAM Program „voxell.exe”
Operating Manual
The status of the UMTS module is automatically read every five
seconds. The following information are displayed:
- IMSI (International Mobile Subscriber Identity), identity of the
subscriber (of the SIM card)
- IMEI (International Mobile Equipment Identity), identity of the Voxell
equipment (of UMTS module)
- Operator, the name of the 3G carrier.
- Band, frequency band information, if information is available;
- Radio Access technolgy, if this information is available;
These fields are indicators, you cannot change (modify) their values.
- Audio Level, the signal level in a range from 0 to 4 (the "0" level
means quiet). To increase the level click the "+" button to the right,
while for decreasing the level you should click the "-" button located to
the left.
The actual audio level settings depends of the type of UMTS modem
module used by your Voxell equipment.
Some types of modules have a
singe “Audio level” control
available, like this:
45
OAM Program „voxell.exe”
Operating Manual
While other (Sierra) modules feature two distinct Audio level controls
will show up, one for reception (Rx) and the other for transmission
(Tx):
The "..."
button located to the right of the “Operator” field
allows an additional window, “Network Registering Options” to be
displayed. In this window you may select the GSM or UMTS
network on which the SIM is to be registered, the order of network
selection and you can enable/disable the roaming option.
Network Selection Options: choose Automatic Search, or go only
for a specific mobile network (either GSM/GPRS or UMTS)
Network Order Options: you may leave it on Automatic, or force
either GSN first, then UMTS, or the reverse order (it will look first
for UTMS networks, then for GSM/GPRS)
Roaming Option: access to the Roaming service may be allowed
or not allowed.
46
OAM Program „voxell.exe”
Operating Manual
Press OK to confirm the settings and close the window, or Cancel
to abort.
2.5. SMS Info
Using the "SMS Info" option, you can to send or to receive SMS
messages through the UMTS module.
The "SMS Info" zone displays to the left a representation of a PC
(computer), which contains information regarding the number of
SMS sent ("OUT") and read ("IN"). This info is saved in files on the
PC.
47
OAM Program „voxell.exe”
Operating Manual
To the right of the PC representation, there is a second
representation that features the text "DEVICE". If the option "not to
delete the received SMS and to automatically move them into PC
files" is present, then after the text "DEVICE" will be shown the
number of SMS existing on the Voxell voice and data UMTS
interface.
To the bottom left side of the above image the current status of
services is displayed in dark blue letters on light blue background:
- sending received SMS as email - "SMS2MAIL started"
- retrieving emails to be sent as SMS - "MAIL2SMS started"
48
OAM Program „voxell.exe”
Operating Manual
- deleting SMS from UMTS module - "Delete SMS on device - yes"
or "Delete SMS on device - no"
- warning about new SMS received on the UMTS module “Alert
SMS on device” yes of no”.
All this parameters are established in "smsinfo.txt" file - the
content of this configuration file will be explained in detail in the
next paragaphs.
If you click the left mouse button on the
"DEVICE" representation, a menu
containing two optionses:
"SMS Settings" and "SMS Received" will
be shown:
The second option is available only when the parameter not to
delete the SMS is enabled. Otherwise the received messages will
be deleted after reading them, so they won’t be available for
viewing afterwards.
2.5.1. DEVICE SMS Settings
The option "SMS Settings" displays a window containing
information regarding the SMS center and the memory location in
which new SMS are stored. You may change these settings, as you
need:
49
OAM Program „voxell.exe”
Operating Manual
SMS Center is the center for SMS messages of the of the GSM
operator (the phone number of the center for SMS of the respective
GSM operator). You may edit (change) this number.
To make effective the changes, press the button "Set" located on
the same line as "SMS Center" and "Type". The confirmation
message is "SMS Center has been updated".
SMS memory - the location of the memory where the SMS messages
will be stored. From the list you can choose either "MT" for the
memory of the UMTS module or "SM" for the memory of the SIM
card. The button "Set" located on the same line as "SMS Memory"
must be pressed to make the changes. The confirmation message is
"The memory location has been changed".
The previous messages also shows a group of figures related to
stored SMS (storage capacity, how many messages are currently
saved into memory, how many positions are still available for SMS,
how many SMS have been sent by the module, etc).
The number of available SMS Positions depends on the selected
memory location.
the location for storing
In the previous exemple,
SMS has been changed from SIM card to UMTS module. The
memory of the mobile module is empty, so you have zero (0)
messages stored and the full capacity (255 messages) is availble
for SMS.
50
OAM Program „voxell.exe”
Operating Manual
If you click the left button of
the mouse on the PC
representation - then a menu
will be displayed, allowing you
to send and receive SMS
directly or via e-mail, as
shown in the image to the left.
These
options
will
be
explained
in
the
next
paragraphs.
2.5.2 PC SMS Parameters
SMS monitoring process is based on a configuration file named
"smsinfo.txt". This text file must be created or edited In the same
folder in which the OAM application is located, in order to define the
necessary parameters for sending and receiving SMS and E-mails.
To configure the simsinfo file,
you must select option “SMS
Parameters” from the list that
shows up when you click over
the “PC SMS” rectangle.
The window named
parameters” shows up:
“MAIL2SMS,
51
SMS2MAIL
and
SMS
OAM Program „voxell.exe”
Operating Manual
There are three sections, corresponding with the sections found in
the smsinfo configuration file:
- Sending parameters
For the section of the smsinfo file where the lines begin with the 's'
(sent) character; these parameters are related to the SMS to E-mail
application;
- Receiving parameters
For the section of the smsinfo file where the lines begin with the 'r'
(received) character, parameters that are related to the EMAIL to
SMS application. Depending of the email subject and email type,
the email content will be sent as SMS;
- message center
For the section of the smsinfo file where the lines are starting with
the 'c' (center) character; these parameters are linked with the
setting of the operator SMS center and with the location where
SMS messages are saved;
1. Sending a SMS message as MAIL:
Check the box “Enabled” to validate the facility to send all received
SMS to an email address;
- "Server" - this field contains the IP address of the mail server;
- "SourceAddress" - the source email address
- "DestinationAddress" - the destination email address. This
address is the default destination address. The OAM software can
also check for an email address in the beginning of a SMS
message. If "MailCharacter" (in our example the character used is
'#') or '@' is found before the first space character, then the SMS
content will be sent to the e-mail address found there. If no mail
character is found, the SMS message will be sent to the default email address.
- "Subject" - this field, followed by the number from where the SMS
was received will be displayed in the "Subject" column of the mail
client.
- "FromName" - this field will be displayed in the mail client in the
"From" column;
- "DestinationName" - this field will be displayed in the mail client
in the "To" column;
52
OAM Program „voxell.exe”
Operating Manual
2. MAIL2SMS settings:
The options for receiving e-mail messages in order to be sent as
SMS messages are:
Check the box “Enabled” to validate the facility to to connect and
retrieve mail messages;
- "Server" - this filed contains the IP address of the mail server.
- "Name" - the name to be used to connect to the mail server
- "Password" - the password to be used to connect to the mail
server
- "Send Confirmation" - if this option box is checked, then a
confirmation of sending the SMS message (from the e-mail
message) will be sent to the email address from which the email
was sent.
The OAM program can send out as SMS the e-mails which have
the next characteristics: "Content-Type: text/plain" and the subject
a mobile phone number or a preconfigured text name.
For example if you are using "Outlook Express" as email client you must set the option "Format" - "Plain Text" (option "Rich Text
(HTML) must be disabled).
3. Options concerning the SMS center and the SMS memory:
- "Center" -(the phone number of the center for SMS of the
respective GSM operator;
- "Memory"- SMS memory location: a '0' value is used to indicate
the module memory - "MT", and a '1' value for to indicate the SIM
memory- "SM";
53
OAM Program „voxell.exe”
Operating Manual
Note: these settings are displyed in gray color, because they
cannot be changed in this window. If you want to modifythe
parameters for the call center and memory for storage of SMS, use
the window “DEVICE SMS Settings”. Here yu can only see the
paramters.
The “smsinfo” file contains additional entries, about the erasing of
received messages and about alerting (notification) for new
messages:
- "Delete" - this parameter is used to control the deleting of
received SMS. A SMS message is not deleted from the UMTS
module when "Delete" parameter takes the "no" value and is
removed is the same parameter is 'yes';
- "Alert" - this parameter is used to set a visual and an audio
indication in case of receiving a new SMS.
Example of content of the "smsinfo.txt" file:
#send MAIL parameters
s Allow,yes
s Server,...
s SourceAddress,...
s DestinationAddress,...
s Subject,...
s FromName,...
s DestinationName,...
s MailCharacter,#
# receive MAIL parameters
r Allow,yes
r Server,...
r Name,...
r Password,...
r Confirmation,yes
r DeleteMail,yes
# SMS parameters
c Center,+40722004000,145
c Memory,1
c Delete,1
c Alert,yes
Note: the "smsinfo.txt" file is read by the OAM Topex VOXELL
program only when the software is launced in execution (starting
up).
The OAM “Voxell.exe" program interrogates recurrently the UMTS
module to check upon new SMS received. New SMS reception
indication depends of the setting which allows the new SMS to be
deleted from the module and of the parameter of visual and audio
warning.
54
OAM Program „voxell.exe”
Operating Manual
2.5.3. Indication of SMS activity
The sent and received SMS can bee seen either on the „PC”
rectangle, or on the „DEVICE” rectangle.
If the option to delete the received
SMS is enabled, then the rectangle
that represents the PC will show
newly received SMS messages:
The "IN" indication is related to the received SMS, and the "OUT"
indication to the sent SMS.
Beneath the PC rectangle, yu will see
an indication of the operation
performed, such as “Send Email”:
Citire SMS (reading SMS), Trimitere
SMS (sending SMS) and so on
When new SMS are received, then the
background of the image above
changes color, from dark blue it turns
into light blue-gray. After you have
read the new messages, the color will
be restored to the original dark blue
color.
Two numbers are displayed: - the first one indicates the number of
received SMS (after the "<" character), and the second one the
number of sent SMS (after ">" character).
Alerting for messages
If the option of warning for new SMS received is enabled (in case of
the file "smsinfo.txt" the "c Alert,yes" line is present) then an audio
and visual warning will be played for each new received SMS. The
audio warning is based on "sunet.wav" file.
At the same time the visual alert
is also shown - which is
represented by a window which
pops up from the taskbar of the
PC
55
OAM Program „voxell.exe”
Operating Manual
This window displays the message
"New SMS received!!!" in white
letters over a dark blue balckground,
then it disappears after few seconds:
If the option to delete the received SMS is disabled, then the
representation of the newly received SMS is done on the "DEVICE"
rectangle, not on “PC” as shown previously.
The receiving indication is shown by
the number of received SMS,
displayed after the text "DEVICE:".
The color indication is the same as in the "PC" case: the color is
changed from dark blue into gray (light) blue. The audio and visual
warnings are also present in this case.
2.5.4. Viewing Received SMS
To view all received SMS on the UMTS module the user must
select the option "SMS Received". A new window (called
"VIEWING RECEIVED SMS") with all received SMS will be
displayed.
56
OAM Program „voxell.exe”
Operating Manual
The window contains several columns:
- "SIM0" - indicates the SIM position on which the SMS was
received. This version of Voxell software has only one SIM, so this
field will be always SIM0;
- "Number" - the phone number from which the SMS was sent;
- "Time" - the time when the SMS was received;
- "Text" - the text received from the SMS. The text is separated on
several lines if <CR> or <LF> characters are found inside the text;
The incoming SMS are stored for each Topex VOXELL system into
a file called "readsms.bin", file located in the system directory.
The user can use the filter "Filter records on period" for displaying
records on a selected period of time. The button to activate the filter
is "Filter".
The user can extract records from the current file ("readsms.bin")
with the filter "Extract records on period". The user must fill the
time periods and the destination file (this file must have "rcv"
extension and will be located in the "ARCHIVES" subdirectory of
the system directory). The button to activate the command is
"Extract".
All files with "rcv" extension from the "ARCHIVES" directory are
displayed in the "Archives" list. The user can select a file from this
list and view the content with "View" button.
57
OAM Program „voxell.exe”
Operating Manual
2.5.5. Viewing Sent SMS
To view all sent SMS the user must select the option "SMS Sent". A
new window (called "VIEWING SENT SMS") with all SMS
messages sent will be displayed.
The window is similar to the one for received SMS. The five
columns are:
- "From" - the source of the SMS message which can be "MAIL" or
"PC".
- "SIM" - indicate the SIM0 - the position from which the SIM was
sent ;
- "Number" - the phone number to which the SMS was sent;
- "Time" - the time when the SMS was sent; if the time is displayed
together with the "ER" letters it means an error occurred when
sending the SMS. In case of successful transmission, it receives an
OK from the GSM module. The Voxell interface tries to transmit the
text messages up to three times, then gives up. The unsuccessful
message is deleted from the queue and the "ER" letters are shown
to indicate the error ;
58
OAM Program „voxell.exe”
Operating Manual
- "Text" - the text of the SMS. The text is separated on several lines
if <CR> or <LF> characters are found inside the text;
The sent SMS messages are stored for each Topex VOXELL
system into a file called "sendsms.bin", file located in the system
directory.
The user can use the filter "Filter records on period" for displaying
records on a selected period. The button to activate the filter is
"Filter".
The user can extract records from the current file ("sendsms.bin")
with the filter "Extract records on period". The user must fill the
periods and the destination file (this file must have "snd" extension
and will be located in the "ARCHIVES" subdirectory of the system
directory). The button to activate the command is "Extract".
All files with "snd" extension from the "ARCHIVES" directory are
displayed in the "Archives" list. The user can select a file from this
list and view the content with "View" button.
2.5.6 Sending a SMS from the PC
The option "Send a SMS" from the menu allows the user to send
out a SMS message from the computer. If you click the "Send a
SMS" option, the “SMS Editor” window will be displayed
59
OAM Program „voxell.exe”
Operating Manual
The destination of the SMS must be typed in the "SMS destination
phone number" field and the text to be transmitted by SMS must
be written in the area "SMS content". Then press OK to send the
message!
Group
The OAM program Voxell.exe allows you to send messages to a
group of destinations. Instead of a mobile phone number, the "SMS
destination phone number" field can be filled with a name (text) that
defines a group of mobile phones. The same SMS will be sent to all
mobile phones in the group.
The definition of these groups is performed in the file called
"sms_groups.cfg". This file is placed on HDD in the same directory
as "voxell.exe" application.
Here is shown an example of content for a "sms_groups.cfg" file:
grup field
0724000000
grup test
0724000000
0724000001
0724000002
In this example, two SMS groups are defined: "field" and "test".
Both groups are defined starting with a line beginning with the text
"grup" . After a space character, the name of that group follows.
The phone numbers belonging to the same group are typed each
on one line.
The ending of a group definition is when another r line containing
the text "grup" appears or a line without any characters is present.
Therefore, the last group structure in the file must be always ended
with an empty line - press <ENTER> when you want to end the file
"sms_groups.cfg". You can edit or modify this file with any text
editor.
Notes:
- if the "SMS destination phone number" field is not defined then
the warning message "No number was defined!" is displayed;
- if the field used for phone number contains at least a non-digit
character, then the application will verify the "number" value into
the "sms_groups.cfg" file. If this file does not exist, the user will be
warned with the "File 'sms_groups.cfg' does not exist" message. If
the "number" value is not found among the existing group names,
the used will be warned with the message "The specified group
name does not exist". If there are no mobile phone numbers
defined in the group, then the "No numbers in <number value>
group" message is shown.
60
OAM Program „voxell.exe”
Operating Manual
If mobile phone numbers definition is found then the user will be
informed about the number of destinations ("Sent to xxx
numbers!").
The same rule concerning the mobile phone destination applies
also to the "mail2sms" section. This means you can specify instead
of a phone number the name of a group where the SMS will be
sent. If a confirmation is assigned in "smsinfo.txt" then the
originating party will get the same error messages as the ones
described before.
2.5.7. SMS Received on DEVICE
This facility is enabled only in case of the presence of the line "c
Delete,no" in the "smsinfo.txt" file. This facility supposes that the
received SMS are not deleted. Those messages can be read and
sent on SMS2MAIL relation without to be deleted.
The total number of SMS which can be received depends upon the
SIM or the module memory.
The "Viewing SMSINFO Report" window allows the viewing of the
SMS stored in the memory location. The "Pozition" field is filled with
the SMS position in the memory. The "Tip" field can take one of the
following values: "READ", "SENT" or "UNSENT". For the "READ"
type, the user can see also the number which was sent the
message, the time moment and the text message.
The operator can delete a SMS message or he can save the
message content on the PC. From the list shown in the above
image the user double clicks with the mouse on the respective line.
The „Device SMS”
window allows you
either to delete (Sterge)
the message, or to save
it (Salvare) on the PC.
The selection is
confirmed with the "OK"
button.
The selected SMS will be displayed from that moment onwards with
type "DELETED". This indication will disappear after next module
interrogation.
61
OAM Program „voxell.exe”
Operating Manual
2.5.8. SMS2MAIL and MAIL2SMS
Besides sending SMS from the computer connected to the Voxell
equipment, you may perform automated conversion between SMS
and e-mail. The two options above are about the facility to send the
received SMS to an email address and respective the possibility to
retrieve the emails from a mail server and to send the text content
as SMS message to the number specified in the "Subject" field of
the email. If the subject of a retrieved e-mail is not a number or if
the mail includes attachments, then the e-mail is deleted from the
mail server (when the line "r DeleteMail,yes" in written in the
"smsinfo.txt" file). Thus, it is better to use an email account
specially dedicated for this application (email to SMS via Topex
VOXELL).
The option "SMS2MAIL" will display a list of the SMS received on
the GSM/UMTS module and sent to the email address specified in
the "smsinfo.txt". There is a queue which can store up to 1000
messages to be sent to an email address in absence of a
connection to the mail server.
62
OAM Program „voxell.exe”
Operating Manual
The window called "VIEWING SMS2MAIL REPORT" will contain all
emails sent to the mail server. The displayed columns are:
- "Subject" - the subject of the mail;
- "Time" - the time when the SMS was received;
- "SIM" - the indication of the module GSM/UMTS from where the
SMS was received;
- "Status" - the status of the mail: "Sent" when the mail was sent or
"Unsent" when the mail was not send yet;
- "Send Time" - the time when the mail was send; this field is filled
only when the "Status" field is indicating a send mail;
- "Text" - the text of the mail. Each character <CR> or <LF> is
replaced with a space character (" ");
The user can delete records from the queue by filling the "Delete"
filter and by choosing the "Delete" button.
The option "MAIL2SMS" will display a list of the mail messages
retrieved from a mail server.
There is a queue which can store up to 1000 messages to be sent
through the UMTS module of the equipment.
The window called "VIEWING MAIL2SMS REPORT" will contain all
emails received from the mail server and send out through the
GSM/UMTS module as SMS messages. The displayed columns
are:
- "Number" - the destination mobile number;
- "Address" - the mail address from where the mail was received;
- "Receive Time" - the time when the mail was received;
- "Status" - the status of the SMS: "Send" when the SMS was send
or "Unsent" when the SMS was not send yet;
- "SIM" - the indication of the module through which the SMS was
send;
- "Send Time" - the time when the SMS was send; this field is filled
only when the "Status" field is indicating a send SMS;
- "Text" - the text of the SMS. Each character <CR> or <LF> is
replaced with a space character (" ");
The user can delete records from the queue by filling the "Delete"
filter and by choosing the "Delete" button.
Note: the Voxell.exe application connects to the mail server and
retrieves all mails. As SMS messages will be sent only the e-mails
which contain as "Subject" the destination phone number. If the
"Subject" contains non-digit characters then the message will be
deleted. The messages are deleted also if they contain
attachments.
63
OAM Program „voxell.exe”
Operating Manual
In case of the read messages (where "Type” is "READ”) you can
see the phone number from where the SMS has come, the time
stamp and the text of the respective message.
The window called "VIEWING SMS2MAIL REPORT" will show all
emails sent to the mail server. The displayed columns are:
- "Subject" - the subject of the mail;
- "Time" - the time when the SMS was received;
- "SIM" - the indication of the module GSM/UMTS from where the
SMS was received;
- "Status" - the status of the mail: "Sent" when the mail was sent or
"Unsent" when the mail was not send yet;
- "Send Time" - the time when the mail was sent; this field is filled
only when the "Status" field is indicating a sent mail;
- "Text" - the text of the mail. Each character <CR> or <LF> is
replaced with a space character (" ");
You may delete records from the queue by filling the "Delete" filter
and the selecting the "Delete" button.
64
OAM Program „voxell.exe”
Operating Manual
2.6. Loading a New Image
As explained previously this facility allows the user to load a new
version of the software application running on the Voxell system. The
image files have the extension "hex". Click the icon and the window
„Loading image” shows up:
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 Voxell 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.
65
OAM Program „voxell.exe”
Operating Manual
When the loading process is successfully finished the user will see
the confirmation message.
Important notices related to the loading of a new version of
application software into Voxell device:
•
Caution!
Before loading of the image file (menu "Loading Image File") it is
strongly recommended that you save the current configuration of
your Voxell 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 USB cable is
disconnected etc.) before reaching its normal ending, the new
software may not be fully installed.
To correct this, you should first reset the Voxell equipment (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 boot loader to start.
Then it can load the application and download a new (correct)
image file for Voxell.
Remember to take the jumper off pins (restore the normal position)
before resuming normal operation of the Voxell equipment!
66
OAM Program „voxell.exe”
Operating Manual
3. MENU DESCRIPTION
The Menu features the following items: Systems (Add/Remove),
Facilities (Font, Color, etc) , About, Help, Exit.
3.1 Systems
3.1.1 Add
When you start the program for the fist time, the tree-like structure
of the OAM program includes no Voxell systems. In order to begin
operation, you must first add a system. In the beginning
Select "System > Add" or
click the “+” icon under
“Systems”, the following
window
will
appear,
asking you to add
another Voxell system to
the tree-like structure.
The number of the first
pozition is “zero” (0).
In the example below, there are already two Voxell systems in the
tree-like structure, so when you want to add another one, it will be
the third, thus on position 2:
67
OAM Program „voxell.exe”
Operating Manual
Directory - enter a name for the folder in where the files
downloaded from the respective Voxell system will be stored. A
directory will be created on the hard disk drive, with the format
"cfg_xxxxxxx" where xxxxxxy is the name you typed in the
"Directory" field. The folder will be created on HDD in the directory
where the OAM executable “Voxell.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 Voxell system.
Serial Port num - enter the serial port used for the USB
communication between the OAM program and the Voxell
equipment. The default value is COM1. This value must be in range
COM1-COM12. The OAM program Voxell.exe uses communication
via USB cable, but the USB driver has a COM port where it is
connected, such as COM 5 in the example below:.
Module type – select either Sierra or Huawei:
The OAM program works with Voxell interfaces equipped with
different UMTS engines (modem modules). The the type of the
module must be selected accordingly. Normaly, the OAM program
shipped to you should be customized for the right UMTS module.
But if you have several Voxell equipments with different mobile
engines connected to your computer, you must choose for each the
correct type. If the default option does not work, you should select
the other one and save the new settings.
The recent versions of the OAM program feature an auto-detect
function: the program scans all serial port, identifies the devices
and automatically fills the correct values for Serial port num and
respectively Module type.
For more details, see description of the “Check” button in pragraph
4.2 about Parameters option.
68
OAM Program „voxell.exe”
Operating Manual
Validation of settings
The OAM program perfoms checkings upon the values you have
entered.
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 also 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, 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.
3.1.2. Remove
To remove a Voxell system from the tree-like structure, select it
from the list, as shown below, and then click on 'Save' button: the
selected system will be deleted from the tree structure!
If you select Cancel the window will be closed without changes.
69
OAM Program „voxell.exe”
Operating Manual
Warnings:
the OAM program does not ask for confirmation “Are you
shure?”, when you click Save, the selected system is deleted
from the structure ;
the corresponding folder (directory) on your hard disk drive
won't be deleted, you must erase it manually.
Note: if you want to change the parameters for a connection to a
Voxell system, use the command „Parameters”. This command of
the tree structure allows changing systems parameters: Name,
serial port number and type of the module.
3.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.
3.2.1. Font
If you select "Facilities > Font" the following window will be shown:
70
OAM Program „voxell.exe”
Operating Manual
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.
3.2.2 Colors signification
This window perfoms several functions:
it shows the significance of the colors used to display the ports
FXS/FXO or UMTS for the windows: "Modify Configuration"
and "Viewing Configuration" - colors which are changing
depending of the state on which the SIM and the UMTS
module are currently in;
it explains these colors;
it allows youto CHANGE these colors according to your
preferences.
The OAM application program interrogates the state of UMTS
module and FXS/FXO port on 5 second time intervals. On each
module representation you see a text indicating the module state,
and the color is also changed according to the state of the module.
The UMTS module can be in one of these 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
71
OAM Program „voxell.exe”
Operating Manual
- 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 text also shows if the
module is registered to a 2G
network or to the 3G network:
The FXS/FXO module can be in one of the following states:
- STANDBY - the background is
colored in dark blue
- INCOMING CALL background is colored in white
- DIALLING - 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 window also shows the colors used for "TextColor",
"BackColor" and "TreeColor". All those colors can be modified
according to users preferences by clicking on it.
You select the
color you want,
either from the
predefined
"Basic" colors, or
from the detailed
zone of custom
colors.
72
OAM Program „voxell.exe”
Operating Manual
See next an example of OAM program with the colors modified:
The "Default" button is used to restore to the original color set.
73
OAM Program „voxell.exe”
Operating Manual
3.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 the OAM 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.
74
OAM Program „voxell.exe”
Operating Manual
3.2.4. Print options
In all situations involving a print command a dialog box will appear.
It features two options:
- print to printer (for this, a printer must be installed into 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 note 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 UMTS 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 VOXELL 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 Voxell system and the configuration
window is above (on top), when clicking the right button you will
be asked if you want to disconnect.
75
OAM Program „voxell.exe”
Operating Manual
3.3 About
When selecting the option
"About" this window is shown. “
About” indicates the software
version of the OAM application
Voxell.exe, in format such as
x.xx, for example 1.8 or 3.19. 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.
3.4 HELP
This is the command for showing the help (assistance) files, which
is a simplified OAM 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" (Connecting to …, UMTS Info, 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).
76
OAM Program „voxell.exe”
Operating Manual
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 occurrences of EITHER word. This is like telling the help
program <<search for 'UMTS" OR for 'module">>.
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 UMTS module, you must search for "UMTS module",
using quotes. In this case, the help program will display only the
occurrences where ALL the words inside the quotes are found
together.
You select one of the occurrences 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 occurrence 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
"UMTS settings", you
just click its "Help"
button and the
respective help window
will be displayed,
showing you
information about that
particular command.
77
OAM Program „voxell.exe”
Operating Manual
3.5. Exit
Command for quitting the OAM program. If you clikt "Exit" or the
outgoing arrow in the menu above, the following window will be
displayed, asking you if you want or not to leave the OAM program.
Select "OK" if you really want to exit the OAM program or select
"Cancel" if you want to continue with the program.
4. 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:
4.1. Disconnect
Disconnect, breaks the connection to a
connected Voxell system
You cannot disconnect a different system other that the currently
connected system.
A connection with a Voxell voice and data UMTS interface can
occur due to an action over one of the following tree options:
- "Connect to Modify...";
- "Connect to View...";
- "UMTS Info";
- "SMS Info"
If you select another connection option (such as "Connect to
Modify...", "Connect to View...", "UMTS Info", "SMS Info" or
"Loading New Image") on the same system, then OAM - Topex
VOXELL application will disconnect previous connection and will
perform a new connection with the specified type.
78
OAM Program „voxell.exe”
Operating Manual
4.2 Modify parameters
This command is used to change the parameters for a Voxell
equipment that is in the tree-like stucture of the OAM program.
Also, here you have the “Check” button thay helps you identify the
number of the serial port and the type of module used.
When you select from the tree-like
structure the option "Parameters", the
following window pops up:
Fist of all, remember that the name of the Directory cannot be
modified.
The name to be used for the Directory has already been defined by
the “Add system” command, so you are not allowed to change its
name now.
You may change here:
the name of the Voxell device (TOPRAISAR in this example)
the number of the USB serial port (in range COM1-COM12)
and the Module Type (type of UMTS modem used).
The OAM program perfoms checkings upon the values you have
entered. There is a text limit of 19 characters for the "Name" field
and two characters for the "Serial Port num". A value check is also
performed for the serial port value, if is not in the range 1 - 12, an
error message will be displayed and the incorrect field will be
colored in red.
79
OAM Program „voxell.exe”
Operating Manual
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.
“Check” button
A very useful feature
present in the recent
versions of the OAM
program is the button
“Check”, located to
theright of the field
Module Type.
When you press it, the program scans all the COM ports and tries
to detect the port number and the type of the modem module.
First, it looks for devices on all USB
serial ports (COM1, 2, 3 and so on) and
identifies the type of module used:
Finally, the program shows you what
type of device it has found (in the
example a Sierra Wireless modem).
Clik OK to continue, and the name is
autoimatically entered in the field
“Module Type”.
The second phase of the “Check” function is the search for the
USB port number.
The program scans again all
connected ports:
But this time it does not look for the type
of devices, it finds out where it is
connected. Finally, a message is
displyed showing you the number of the
COM port used by USB connection
between the OAM program and the
Voxell equipment
(COM 5 in this
example).
When you click “OK” the number found is inserted automatically in
the field “Serial port num.
80
OAM Program „voxell.exe”
Operating Manual
Thus, using the feature “Check”, you must no longer other with the
type of modem module and port number, they are filled-in
automatically with the correct values!
Note:
The “Check” feature is available only when you
are NOT connected to a Voxell equipment for
modifications or viewing: the rightmost column of
the statur bar is colored in red, indicating no
connection:
When you are actually connected to Voxell, the
Check button of Parameters is inactive, because
the Module type and port number are already
completed.
4.3. Last Configuration
With this option you can see last downloaded (and eventually
modified) configuration for the selected Voxell equipment. If you select
this option the "LAST configuration" window will be displayed. You will
be able to view offline last configuration: GSM/UMTS and FXS/FXO
modules settings.
You will be able to see off-line the last downloaded configuration even
if the connection is no longer online.
81
OAM Program „voxell.exe”
Operating Manual
As you see in the above image, the “last configuration” of the Voxell
interface is displayed, although the program is not connected to the
Voxell equipment (the seventh column, at the bottom right, has the
color red, indicating “no connection.
Note: in this case the
buttons "Ok" or „Save”
from all windows will be
hidden, because you
cannot
modify
the
system’s parameters,
you can only see them.
You can only look at the already existing settings – this holds true
for all of the windows in the mode of operation „Last Configuration”.
4.4 Log Files
The option “Log” displays a ”Local Viewer” window that shows you
the recording files for the respective system. For each connection
period, the OAM program generates log and lch files that recrd the
events and the changes which have occurred during that period.
82
OAM Program „voxell.exe”
Operating Manual
There are two types of log files:
The log files of the Voxell.exe OAM 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 Voxell system, file transfer
and so on.
See below the structure of a log file for Voxell.exe:
Field
Description
Date
dd-mm-yy
Hour
xx:xx:xx
Event
Description of the event that was performed
Click on a log file to view its contents - below is shown a sample
from a Voxell log file:
Changes files
The lch files are named <current date>.lch , the extension signifies
„changes”.
They include information about the changes (modifications) made
to the TOPEX UMTS system.
Their structure is shown below:
83
OAM Program „voxell.exe”
Field
Description
Date of
change
dd-mm-yy
Time of
change
xx:xx:xx
Operating Manual
Modification Description of the change that was performed
Status
OK - the change was successfully
ERROR - the change was not successfully
Click on an lch file to view its contents - below is shown a sample
from a Voxell file with changes:
84
OAM Program „voxell.exe”
Operating Manual
5. Glossary
Here you have the explanation of some terms and acronyms used
in the operating manual for OAM program voxell.exe:
Bootloader – bootstrap loader, small program that launches first
upon power up and helps loading the operating system. Any
computer system can execute 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 Voxell equipment, the bootloader starts
first when you power up the equipment and allows loading of the main
firmware application that controls the UMTS 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 specific
response, greeting the caller by name or looking up for missed or
unanswered phone calls. Some interfaces or phone exchange can
use the CLIP facility to identify the subscribers who called and route
the incoming calls according to their Caller ID.
Voxell lets you select the mode of sending out the identity (by means
of Bellcore FSK or by DTMF< beore or after the first ring).
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. You may
activate this function on the Voxell equipment , 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.
The Voxell equipment 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 the UMTS interface Voxell.
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. The equipment uses DTMF dialing to
transmit the numbering from local subscribers to the mobile networks.
Also, Voxell dialing in DTMF mode to ensure phone connections
without need for an operator at the PBX.
85
OAM Program „voxell.exe”
Operating Manual
FXS - Acronym for Foreign Exchange Station. The FXS phone
interface supplies ring, voltage, and dial tone for a “Station”, which
may be an analog phone, a modem, a fax machine, or any analog
device of the final user. The FxS interface of the Voxell equipment
may be used for connection either to an analog trunk of the PBX or
directly to a standard fixed phone.
FXO - Acronym for Foreign Exchange Office. The Office phone
interface connects to the public phone exchange (central office CO), or a FxS board of the PBX. network (PSTN) central. The FXO
device gets power supply from the central battery and disk tone
services. The FxO interface of the Voxell equipment is used to
connect the device to a local extension line (local subscriber) of the
PBX. Both FxS and FxO interfaces use two wires.
IMEI - Acronym for International Mobile Equipment Identifier. 15digit number that uniquely identifies an individual mobile terminal
wireless device. The device may be a phone, a data terminal, a
modem module (like the one inside Voxell) etc. The IMEI code
consists of TAC (Type Approval Code) that describes the type of
the mobile device, FAC (Final Assembly Code) related to final
assembly, i, SNR (Serial Number) which is unique, and a spare
digit.
Note that while IMSI is subscriber-related, the IMEI is equipmentrelated. IMEI is world-wide specific for a certain mobile terminal
(phone or modem).
IMSI – Acronym for International Mobile Subscriber Identity.
Unique code number (for all the world) that identifies a mobile
subscriber (its SIM card) to the network. 15 digit code, contains
information about the module code for the country, the network,
identification number for the mobile station (subscriber). Linked to
the user account information at the network operator. IMSI resides
in the SIM card. While IMEI is related to the mobile phone
GSM/UMTS module, the IMSI code is related to the SIM, if you
change the SIM card used by Voxell you will have another IMSI
code. If the UMTS module of Voxell detects an active SIM card, it
will query (and display) the IMSI code.
connected to the PBX either on a trunk line or on a subscriber line
(local extension).
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. The Voxell device
connects to a PBX that has trunks going to the PSTN, so the
equipment performs as an interface between the mobile network
(GSM/GPRS/UMTS) and the PSTN.
86
OAM Program „voxell.exe”
Operating Manual
SMS - Acronym for Short Message Service; means the transmission
of short text messages to and from cellular phones. The messages
must be text only (no images or graphics) and not longer than 160
alpha-numeric characters. Operators of Mobile Phone Networks use a
spare data channel to send SMS messages. You may send SMS’s to
another mobile subscriber, the mobile operator can send you phone
settings over-the-air or commercial companies may send dedicated
content to your mobile terminal.
The OAM program Voxell.exe allows Voxell equipment to send and
receive SMS (via mobile network) from the computer connected to it.
Also, the SMS2MAIL and MAIL2SMS functions of the OAM program
perform automatic conversion between e-mail and SMS messages.
87
OAM Program „voxell.exe”
Operating Manual
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 VOXELL.
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 S.A.
We certify hereby that the VOXELL 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 10, district 1
014186, Bucharest, ROMANIA
Tel: +4 021.408.39.00
Fax: +4 021.408.39.09
E-mail: [email protected]
Web: www.topex.ro
88