Mobile Clocking&Access User's Manual

Mobile Clocking&Access User's Manual

Document: USM-Mobile Clocking&Access-ENG.pdf
Version: 11.20.B
Printed: 18.12.2020
© 2020 Spica International

Spica International
Pot k sejmiscu 33
1231 Ljubljana
Slovenia

Tel: +386 1 568 08 00

Fax: +386 1 568 08 88

E-mail: info@spica.com
www.spica.com
 Contents I

Table of Contents

1 Mobile Clocking&Access 1
1.1 Introduction
................................................................................................................................... 1
1.2 End-User
...................................................................................................................................
Software License Agreement 2
1.3 Technical
...................................................................................................................................
Support 4

2 Configuring the system 5

2.1 System...................................................................................................................................
Hardware Requirements 5
2.2 Mobile...................................................................................................................................
Clocking&Access Service 5
2.2.1 Mobile Clocking&Access
..........................................................................................................................................................
as Stand-alone Program 5
2.2.2 Mobile Clocking&Access
..........................................................................................................................................................
as Stand-alone Service 6
2.3 Mobile...................................................................................................................................
Clocking&Access Manager 6
2.4 Setting...................................................................................................................................
up modem 7
2.4.1 Additional settings
.......................................................................................................................................................... 8
2.5 Communication
...................................................................................................................................
with Event Collector 10

3 Registering events with GSM phone 12

3.1 Registering
...................................................................................................................................
events with phone call 12
3.2 Registering
...................................................................................................................................
events with SMS 12

© 2020 Spica International

 1 Mobile Clocking&Access User's Manual

1 Mobile Clocking&Access

1.1 Introduction
Mobile Clocking&Access is an additional module in the Time&Space system. Its main function is
to transfer clock transactions from GSM phone to a common database accessed
independently by all modules in the system.

The Mobile Clocking&Access module consists of two parts: Mobile Clocking&Access Server
and Mobile Clocking&Access Manager. Mobile Clocking&Access Manager is a stand-alone
program whose main function is the administration of GSM modem(s).

© 2020 Spica International

 Mobile Clocking&Access 2

1.2 End-User Software License Agreement

Terms of License

This program and accompanying documentation (the software) are copyrighted material,
protected by national legislation and international agreements on protection of intellectual
property. Any unauthorized use or copying of this software is punishable by law. Users are
permitted to make copies of the software solely for backup purposes, and as a protection
against accidental loss or damage of the purchased copy.
By purchasing a copy of the software the user is granted the license to use the software
within the user's organization without time limitations. The user is obliged to comply to the
conditions related to the scope of the license as defined in the purchase documentation
(proposal/order/invoice) at the time of purchase. These conditions are including, but are not
limited to maximum number of users, number of clients, servers, number of administrators,
administrative workstations, computers, locations and similar. Any use beyond these
restrictions is not permitted.

Any use outside user's organization or any commercial exploitation of the software involving
third parties such as lending, renting or selling of the software is not permitted.

Special Terms

Users are obliged to actively protect the software against any unauthorized use or copying,
and prevent access to the software by the public or any third party.
SPICA International does not permit any modification of programs or accompanying
documentation including any modification of the program code or accompanying files.

Warranty Disclaimer

SPICA International has written the software and accompanying documentation with utmost
care and best effort to make it error free. Any eventual error, which would prevent or
significantly hamper the use of the software, should be immediately reported to SPICA
International. SPICA International will act upon such error report with priority and make every
effort to correct the error in the shortest possible time.
However, the software is provided by SPICA International »as-is«, and without any warranty,
express or implied, direct or consequential as to the usability or inability to use the software.
SPICA International does not provide any warranty as to the fitness of this software to any
particular purpose, and is not liable for any errors, known or unknown, of this software.
Cumulative liabilities of SPICA International for any damage caused by this software will be
limited to the purchase price of this software.

Data

SPICA International is not in any way responsible for data maintained with this software. The
user is entirely and solely responsible for data safekeeping, protection against loss and
protection of privacy of personal information.

Modifications of Software

SPICA International continually develops and improves its software products, which are
therefore subject to change without prior notice. SPICA International reserves the right to
freely modify its software products at any time without any prior or special notice and cannot
provide any warranty as to the nature and scope of any particular change. SPICA
International also retains the right to stop further development of a particular product, or to
discontinue a product completely.

© 2020 Spica International

3 Mobile Clocking&Access User's Manual

Modifications upon User Request

In order to meet and surpass the expectations of its users, SPICA International constantly
and systematically collects information about user demands and requirements. This
information plays crucial role in decisions on software product development. Upon user
request, SPICA International will provide information on the status of an individual request or
demand in the context of development planning for the standard products. This information
may include the planned time for the completion of a particular task, if any such time has
been established. Information provided in this way does not make SPICA International in any
way liable for the nature and scope of the actual implementation, licensing policy or time of
delivery. All such information is strictly informal and may change without any notice.

© 2020 Spica International

 Mobile Clocking&Access 4

1.3 Technical Support

Technical support and additional information:

Spica International
Pot k sejmiscu 33
1231 Ljubljana
Slovenia

Tel.: +386 1 568 08 00

Email: support@spica.com

Further information is available at http://timeandspace.eu.

© 2020 Spica International

 5 Mobile Clocking&Access User's Manual

2 Configuring the system

The communication between the GSM Modem and software takes place only when Mobile
Clocking&Access Server is active. For collecting events into the common Time&Space
database, Event Collector Server must be active.

2.1 System Hardware Requirements

Mobile Clocking&Access

Mobile Clocking&Access currently supports only Wavecom modems (e.g.):

Wavecom Fastrack Supreme 10,

Wavecom Fastrack M1306B.

Workstations/servers

See document Installation and Upgrade Guide.pdf, chapter System Requirements.

2.2 Mobile Clocking&Access Service

Manually copy the content of Mobile Clocking&Access folder (e.g. D:\Server\GSM Collector)
from your installation media to Time&Space installation directory (e.g. C:\Program Files (x86)
\Spica\TimeSpace).

You can choose between 2 different operation modes:

Stand-alone program where there is no need for a web server,

Stand-alone service working as NT service and does not need a web server.

2.2.1 Mobile Clocking&Access as Stand-alone Program

Go to the target directory (e.g. C:\Program Files (x86)\Spica\TimeSpace) and double click the
GsmPrg.exe file. The window shows the number of active modems and the name of the
database. To shut down the server, click on the Shutdown button. When you close the
window, the Mobile Clocking&Access Server returns to the Taskbar.

© 2020 Spica International

 Configuring the system 6

Event Collector Server

2.2.2 Mobile Clocking&Access as Stand-alone Service

To install Mobile Clocking&Access as stand-alone service use Command Prompt and enter (e.
g. "C:\Program Files\Spica\TimeSpace\GsmSrvc.exe /install"). After successful installation
Mobile Clocking&Access Server appears in Services view.

2.3 Mobile Clocking&Access Manager

To run Mobile Clocking&Access Manager (gsmmngr.exe), double click it. To gain access to
Mobile Clocking&Access Manager you need to log on with a password carrying appropriate
rights (operator or administrator) within the Time&Space system. When you load gsmmngr.
exe, you first have to enter your Username and Password. You will do this in the Login
window.

Entering usernam e and passw ord

After successful login you should see tree view showing number of modems and configuration
form. To configure modem click on tree view item and fill the form.

To enable modem check Enable connection check box. Only enabled modems will be used
by collector.
Select desired port number in Serial port combo box. Be careful with the port number,
because some ports may be unavailable on your computer. Select access point, which will
be used by this modem in Point combo box.
Select which event will be saved with this modem by selecting value in Event combo box. In
case of SMS registration, event specified in the message body (short event name) will be
used. To open the door when registering, check Access check box. Because of quality of
SMS service (unpredictable or unreliable time of message arrival), only registrations made
by phone call can open the door.

© 2020 Spica International

 7 Mobile Clocking&Access User's Manual

Com m on settings form

Note: To enable opening door with Mobile Clocking&Access a connection to Event

Collector server must be established. For further details refer to Communication with Event
Collector.

File menu

Save - This command saves modem parameters. Only properly configured modem parameters
will be saved.
Exit - Exit Mobile Clocking&Access Manager.

Tools menu

Communication log - Communication log may help you to solve some problems with modem.
It writes all data sent from and to modem. Some events, like ring and new SMS indication are
also written into this log.

Help menu

About - This command shows basic information about the product including current database
connection name.

2.4 Setting up modem

Before running Mobile Clocking&Access, modem must be properly configured. Settings
described below apply to WaveCom GSM modems. Other modems may have slightly different
settings. Please refer to modem’s user manual for details. These settings can be sent to
modem by Windows HyperTerminal or other serial port terminal program.

© 2020 Spica International

 Configuring the system 8

Enter the following commands into the terminal. Modem replies with OK if the command is
successful.

Disabling PIN

AT+CLCK=”SC”,0,XXXX

Where XXXX represents SIM card PIN.

Enabling calling line identification presentation

AT+CLIP=1

Enabling modem to respond with RING

AT+CRC=0 (Cellular result codes)

Saving settings

AT&W

Note: Once the modem is configured there is no need for configuring it again because
settings are permanently saved to the modem.

2.4.1 Additional settings

Some additional settings may be changed by editing configuration file gsmmodem.ini.
Description of specific chapters is described in following chapter.

[TRACE SECTION]

If input and output messages of Mobile Clocking&Access needs to be log, set following key:

COMLOGENABLE=1

[GSM1]

Baud rate may be changed but it is not recommended. Modem usually provides auto-bauding
(automatic communication speed detection) function only for speeds 19200 and below. If you
set higher baud rate in the configuration file, please set modem baud rate also to that rate.

Sometimes some extra initialization commands must be sent to the modem. To add
initialization command ATZ to Modem 1, write the following line to [GSM1] section:

ADDINIT = ATZ

To use more than one initialization commands, separate them with character “|”.

ADDINIT = ATZ|ATE0

© 2020 Spica International

9 Mobile Clocking&Access User's Manual

SEND_SMS_DELAY=70

Some modems (e.g. Wavecom SUPREME10) require sending message in two parts. To enable
this we have to set delay in milliseconds between both parts. Default value is 0 (message is
sent in one part.).

SMS_FULL_CARRIAGE_RETURN = 1

Some modems (e.g. Wavecom SUPREME10) require different delimiter than older ones. To
enable new type of delimiter set SMS_FULL_CARRIAGE_RETURN to 1. By default it is 0.

[PHONE NUMBER]

Phone number received when ringing and receiving SMS can be different. Specify all possible
prefixes in comma-separated string in section PHONE NUMBER key REPLACEMENTS (e.g.:
Mobile Clocking&Access can understand number format like 41123456. +38641123456 and
041123456 are both possible +386 and 0 must be discarded for collector to recognize the
number.

Important: User's GSM number must be entered without spacings in the Phone field in
Time&Space Manager .

[CHAR_REPLACE]

Character set supported by GSM phones do not support ANSI characters. Some characters in
SMS may be blank or scrambled. Replacements can be specified in section
CHAR_REPLACEMENTS. Each character in SOURCE_CHAR must have corresponding pair in
DEST_CHAR. All characters in the source char replacements will be changed with dest
characters. For example Slovenian character “š” must be replaced with “s”, because some
phones cannot show local characters. In this case “š” would be placed in source character
string and “s” would be placed on the same place in destination character string.

[SMS]

By default the system returns SMS with registration data in the message body. It also sends
SMS if system malfunction appears. These features can be disabled by adding the next two
lines into the configuration file:

SMS_ACKNOWLEDGE=0

When unknown user tries to register, the system responds with SMS, to report that it is not
recognized by the system. This feature can also be disabled by adding
UNKNOWN_USER_SMS=0.

[SYSTEM]

Set parameters ECSERVERADDR and ECSERVERPORT accordingly to parameters in CNS.INI.

For further details refer to Communication with Event Collector.

ECSERVERADDR

Set an IP address or a name of the workstation where Event Collector service is running. By
default this parameter it is set to "Localhost".

ECSERVERPORT

© 2020 Spica International

 Configuring the system 10

PORT which is used in communication with the Event Collector. By default this parameter is
set to "2222".

Example of gsmmodem.ini:

[TRACE SECTION]
COMLOGENABLE=1

[GSM1]
COMPORT=1
BAUDRATE=115200
Point=9
Event=51
IS_ACCESS=0
ENABLED=1
ADDINIT =ATZ

[PHONE NUMBER]
SEARCH_NUMBERS =8
REPLACEMENTS = +386,0

[CHAR_REPLACE]
SOURCE_CHAR = è,È,š,Š,ž,Ž,ð,Ð,æ,Æ
DEST_CHAR = c,C,s,S,z,Z,d,D,c,C

[SYSTEM]
SMSDELAY = 8000
ECSERVERADDR = 192.168.10.200
ECSERVERPORT = 2222
CNSTIMEOUT = 20000

2.5 Communication with Event Collector

If user wants to open relay of specific door with Mobile Clocking&Access registrations, the
communication between both applications must be established. Create file called CNS.INI in
the directory, where you installed Event Collector Server and restart the service to apply
changes. Accordingly to your situation, change the following parameters:

HOST - Set an IP address or a name of the workstation where Event Collector service is
running. By default this parameter it is set to Localhost.
PORT - Port number which is opened on the Event Collector side for communication with
Mobile Clocking&Access. By default this parameter is set to 2222.

Example of CNS.INI:

[SETTINGS]
ENABLED=1
HOST=192.168.10.200
PORT=2222
RECONNECT=1
INTERVAL=5000
MODE=1
SKIP_EVENTS_NOTIFICATION=0
SKIP_ALARMS_NOTIFICATION=0

© 2020 Spica International

11 Mobile Clocking&Access User's Manual

SKIP_QUITED_ALARMS_NOTIFICATION=0

Note: User can open a specific door only with events registered with a phone call and if
he/she has appropriate access rights.

© 2020 Spica International

 Registering events with GSM phone 12

3 Registering events with GSM phone

3.1 Registering events with phone call

This is the easiest way to register event and requires one modem for one event. To register
an event, dial the number of modem configured for registering the desired event. Modem will
hang up the line after few rings. As indication of successful registration you should receive
SMS with your name, surname and registration info in the message body.

Important: Make sure that users of Mobile Clocking&Access have badge and mobile
phone number assigned in Time&Space system.

3.2 Registering events with SMS

This type of registration is not so common as the first one, because it is not free of charge. To
register with SMS message, write short event name into the message body and send it to
GSM modem attached to Mobile Clocking&Access. SMS registration requires only one modem
for all types of events. As indication of successful registration you should receive SMS with
your first name, surname and registration info in the message body.

Important: Make sure that users of Mobile Clocking&Access have badge and mobile
phone number assigned in Time&Space system.

© 2020 Spica International