Omni Instruments Omnitext-240 User manual

OMNITEXT-240 User Manual P a g e | 1
Omni Instruments
Omnitext-240
Remote
Monitoring System
User Manual

OMNITEXT-240 User Manual P a g e | 2
1SHORT DESCRIPTION
OMNITEXT-240 is a battery powered pulse input data logger with GSM-GPRS interface.
It has 4 digital inputs. The digital inputs can work in OPEN/CLOSE or COUNTER mode.
The status of the device can be periodically saved in the embedded data logger. Any alarm condition can
initiate a record in the logger.
OMNITEXT-240 may periodically send data to a remote server, which makes it suitable for client-
server monitoring and control systems.
2FEATURES
•Quad-bands connectivity
•Autonomy battery operation
•Sleep mode for extended battery life
•Setup via USB, SMS, and HTTP API
•digital inputs with OPEN/CLOSE and counter modes
•32-bit counters
•Data logger with up to 70000 records
•Periodical HTTP post with current status in XML or JSON file to remote server
•Periodical HTTP post with the last logger data in CSV file to remote server
•HTTP API commands
•Firmware update over USB or GPRS.
3APPLICATIONS
•Smart totalizing
•Remote totalizing of flow and energy meters with pulse outputs.
•Status reporter
•SMS and HTTP Post alerts can be sent to the authorized recipients. The alerts can be triggered in any
alarm state.
4SPECIFICATIONS
•Physical characteristics
oDimensions: 122 x 120 x 55 mm
oWeight: 410 g (with battery)
oMounting: wall
•Environmental limits
oOperating Temperature: -20 to 50°C
oStorage Temperature: -25 to 60°C
•Protection
oIngress protection: IP65

OMNITEXT-240 User Manual P a g e | 3
•Standards and Certifications
oSafety: EN 60950-1:2006+A11:2009+A1:2010+A12:2011+A2:2013; EN 61010-1:2010
oEMC: EN 55022:2010, EN 55024:2010, EN 61000-3-2:2014, EN 61000-3-3:2013 EN
301489-1 V1.9.2, EN 301489-7 V1.3.1
oRFSU: EN 301511 V9.0.2
oGreen: RoHS compliant
•Battery
oBattery type: non-rechargeable (Li-SOCl2)
oVoltage: 3.6V
oMaximum recommended continuous current: >1500 mA
oMaximum pulse capability: >2500mA
•Cellular interface
oStandards: GSM/GPRS
oBands: 850/900/1800/1900 MHz
oGPRS multi-slot class: 12, 1~12 configurable
oGPRS terminal device class: Class B
oCompliant to GSM Phase 2/2+: Class 4 (2W@850/ 900MHz), Class 1
(1W@1800/1900MHz)
oSIM card size: Micro
oAntenna connector: SMA-F
•Digital inputs
oIsolation: Non isolated
oType: Dry contact
oMaximum input voltage for digital inputs: +5.5VDC
oSampling rate: 0.0625, 0.25, 0.5, 1, 2, 3, 4, 5, 6, 10, 15, 20, and 30 seconds
oDigital filtering time interval (Delay): (0 to 255) x Sampling rate
•Data logger
oCapacity: Up to 70000 records
•Internal FLASH memory
oSettings segment endurance: 100 000 cycles (Every setting change is a memory
cycle). Data logger segment endurance: 100 000 cycles of 70000 records.
oUpdate segment endurance: 100 000 cycles (updates).

OMNITEXT-240 User Manual P a g e | 4
5INSTALLATION
This device must be installed by qualified personnel. The installation consists of mounting the
device, connecting to the GSM network, connecting inputs and outputs, providing power, and
configuring via a web browser.
ATTENTION! BEFORE INSTALLING THE SIM CARD IN THE CARD SLOT, PLEASE ENSURE THAT THE PIN
CODE IS DISABLED AND THE BATTERY IS DISCONNECTED.
5.1 MOUNTING
OMNITEXT-240 should be mounted in a clean and dry location on a non-flammable surface.
Ventilation is recommended for installations where the ambient air temperature is expected to be
high.
Mount the device to a wall by using a minimum of two plastic wall plugs 8x60mm and two
screws 6x70mm. See Appendix C, fig. 1 for mechanical details.
Maintain spacing between adjacent equipment. Allow 50 mm of space on all sides, as shown in fig.2
in Appendix C, this provides ventilation and electrical isolation.
5.2 CONNECTORS
ATTENTION! DISCONNECT POWER SUPPLY BEFORE WIRING.
The correct wiring procedure is as follows:
•Make sure battery is disconnected
•Make wiring connections to the terminals
•Insert the SIM card
•Connect the battery
It is recommended to test and configure OMNITEXT-240 without any sensors connected.
Make sure that wires are properly attached to the terminals and that the terminals are tightened.
Incorrect wiring and configuration can cause permanent damage of OMNITEXT-240 or the equipment
to which it is connected or both. Inputs and outputs locations are shown below:
•1 - Connector 1
oPin 1 - Digital input 1 (DI1)
o Pin 2 - Ground (GND)
o Pin 3 –Digital input 2 (DI2)
o Pin 4 - Digital input 3 (DI3)
o Pin 5 - Ground (GND)
o Pin 6 - Digital input 4 (DI4)
•2 - Mini USB Connector
•3 - Reset button
•4 - SIM card holder (insert direction shown)
•5 - Antenna Connector (female SMA)
•6 - Battery Power Terminal - the positive wire (Red) may be
disconnected when you first receive the equipment.
Please connect the power before you use the device.
2
1
3
4
5
6

OMNITEXT-240 User Manual P a g e | 5
5.2.1 Digital inputs connection
ATTENTION! DIGITAL INPUTS ARE NOT GALVANICALY ISOLATED.
The OMNITEXT-240 digital inputs can be used in two modes –OPEN/CLOSE and COUNTER.
In OPEN/CLOSE mode digital inputs can be used to monitor the state of a discrete device –door
contact switch, push button, PIR detector etc.
In the COUNTER mode the digital inputs can be used to monitor and totalizing of smart meters.
The maximum cable length for a digital input should be up to 30 meters.
6LED INDICATORS
LED indicators on the main board show the status of the controller while the USB cable is connected to
the PC:
•SIG (red) –indicates the status of the device together with STA
•STA (yellow) –indicates the status of the device together with SIG.
The following states are displayed:
•Controller initialization –after power-on and firmware update SIG and STA turn ON for a second,
after this turn OFF for another second.

OMNITEXT-240 User Manual P a g e | 6
•Searching for GSM network –after initialization, SIG is OFF, STA flashes (flash length –
200ms)
•Connected to GSM network –after successful connection to a mobile network, STA shows the
type of connection, while SIG shows the signal strength.
STA flashes once for 200mS in period of 2S –there is GSM connection only.
STA flashes twice for 200mS in a period of 2S –there is GSM and GPRS connection.
At the same time SIG has 5 states:
SIG flashes 1 time in period of 2S - signal strength is between 0 and 20%
SIG flashes 2 times in period of 2S - signal strength is between 21 and 40%
SIG flashes 3 times in period of 2S - signal strength is between 41 and 60%
SIG flashes 4 times in period of 2S - signal strength is between 61 and 80%
SIG is solid ON - signal strength is between 81 and 100%

OMNITEXT-240 User Manual P a g e | 7
•Error message –in case of error after initialization, SIG will stay solid OFF, STA will flash showing
the type of error.
STA flashes ones for 1S –master phone number is not set.
STA flashes permanently for 1S in a period of 2S –permanent hardware error.
7INITIAL SETUP VIA USB
The initial setup of OMNITEXT-240 controller is done with a computer running Windows 7 or newer
Microsoft Windows operating system. After power-up, the controller should be connected to the
computer with USB cable. Once the USB cable is connected, the operating system automatically
starts to install the drivers for the communication with the device. The following message appears:

OMNITEXT-240 User Manual P a g e | 8
The following drivers will be installed:
•Microchip composite device
•USB serial port driver
If for some reason the USB serial port driver cannot be installed automatically, it must be
installed manually. PleasecontactOmniInstrumentsforthe driver. After successful driver installation, the
device will be recognized as Mass storage, the following window appears on the screen:
The only file stored on the mass storage is a tool called “TConfig”. This tool enables the communication
between the OMNITEXT-240 and PC. After starting the TConfig tool, the following program will appear:
Pressing the “Start” button will start your web browser and display the Monitoring page of
your OMNITEXT-240 controller.
The other menu functions are as follows:
•Action tab
oStart –will start the web browser
oCheck Device –refreshes the display of the device settings

OMNITEXT-240 User Manual P a g e | 9
•Settings Tab
oCom Port –manually select the com port for the logger to use (use port 10 or less)
oPort –manually set the web port to use for the monitor page
oSend Delay –manually set the send delay
•Information –displays settings log and available com ports to use
•About –displays software information such as version and copyright.

OMNITEXT-240 User Manual P a g e | 10
7.1 MONITORING PAGE
Monitoring page displays the current state of OMNITEXT-240.
The Monitoring page is automatically refreshed every second.
Digital inputs can be used in discrete mode for monitoring the state of dry contact outputs devices –
motion sensor, door contact, relay contact, alarm output etc.
Digital inputs can be used in counter mode for smart metering totalization.
NOTE: CONFIGURATION CHANGES MUST BE SAVED BEFORE LEAVING THE WEB PAGE. UNSAVED
CHANGES WILL BE LOST.
7.2 SETUP
7.2.1 SMS
SMS Alarm recipients can be set in this section.
The “Master” has special rights to change the device settings using SMS commands.
The remaining 4 recipients can receive SMS messages if any of the parameters is in alarm state. To
receive SMS messages, the number should be enabled in the checkbox “Alarm Notification”. These 4
recipients can also ask by SMS for parameter state/value.
By pressing “send test SMS” button all SMS recipients will receive a test SMS. All commands, their
syntax, and answers are described in “Setup via SMS”.
7.2.2 Periodic check for SMS
To save the power, incoming SMS are checked on “Check interval” if this functionality is enabled.

OMNITEXT-240 User Manual P a g e | 11
7.2.3 Input
For every digital input, a description, up to 20 symbols can be set. These descriptions will appear on
the monitoring page, alarms page and XML/JSON data.
Every digital input can be set OPEN/CLOSE or COUNTER mode.
There are delays in samples for digital input change. By default, delays are zero. The delay is
calculated in the sample/wake-up interval. The delay can be used for filtering.
For the Counter mode, there is a possibility for setting up of the counter initial value. There are
settings for periodically resetting the digital counters to allow hourly or daily totals.
7.2.4 Alarms
7.2.4.1 Alarms

OMNITEXT-240 User Manual P a g e | 12
For every alarm, a description of up to 20 symbols can be set. Digital inputs in COUNTER mode only
can be set.
There are four types of alarms –Warning, Minor, Major and Critical.
When the alarm is activated 2 independent alert actions are possible –SMS andPost (HTTP post with
XML/JSON file). Each alarm notification method is activated by a checkbox.
In the time when the input is in an alarm state, the appropriate input will be coloured in red on the
Monitoring page.
7.2.4.2 Discrete alarms
To assign a digital input to this alarm, it must be pre-set in Discrete (OPEN/CLOSE) mode in the Setup
/ Input page.
The alarm state can be set for every alarm.
There are four types of alarms –Warning, Minor, Major and Critical. For every discrete alarm, a
description of up to 20 symbols can be set.
When the discrete alarm is activated, 2 independent alert actions are possible –SMS and Post (HTTP
post with XML/JSON file). Each alarm notification method is activated by a checkbox.
The “On Return” check box can be used in conjunction with the other check boxes to send the
notification when the alarm returns to normal.
7.2.5 System
The page for some general settings.
7.2.5.1 System status
There is information about the general status of the logger here.
The only possible setting here is “Data in roaming” checkbox. By default, it is disabled to avoid extra
charges for data transfer in roaming.
Some operator's SIM cards require you to activate “Data in roaming”. Otherwise, you will not be able
to use all GPRS services –emails, HTTP Post, NTP, etc.

OMNITEXT-240 User Manual P a g e | 13
7.2.5.2 GPRS setup
To set the GPRS connection it is necessary to enter the APN (Access Point Name). This setting can be
different for each GSM service provider. By default, it is set to “internet”. Some providers may also
require username and password.
7.2.5.3 General setup
The section for some general settings.
Writing mode change the alignment in the WEB interface and SMS.
Hostname, System name, System location, and System contact are sent in XML/JSON files and can be
used for flexible identification of the device.
7.2.5.4 Power saving setup
In this section the wake-up (sample) period can be enabled and set. This is required to allow the
OMNITEXT-240 to counter pulses and record digital states Possible options are 0.0625, 0.25, 0.5, 1, 2, 3,
4, 5, 6, 10, 15, 20, and 30 seconds.
A higher setting on this parameter (i.e. 30 Seconds) will allow a longer battery life. Of course, the
reaction of the device gets slower.
7.2.5.5 Device restart
In this section there are tools for full device restart and reset to factory default settings.
7.2.6 Time
For automatic clock synchronization, the controller supports NTP (Network Time Protocol) and
all necessary parameters for automatic synchronization are available in this section.
The clock synchronization is made on “Interval” time. If the attempt was not successful, the
next synchronization will be on “If not found” time.

OMNITEXT-240 User Manual P a g e | 14
Pressing the “Save and synchronize” button initiates time synchronization. The information for
“Status” in the blue box is very useful for the availability of time server and Internet at all.
The current system time is sent in XML/JSON file when HTTP Post is enabled
By default, the settings are: NTP server, time.google.com:123, Time zone +00:00 and interval of
12 hours.
Note: The time synchronisation uses data and frequent time checks will affect the data usage
on the SIM card contract.
7.3 SERVICES
7.3.1 Logger
The logger works in three modes –Time, Alarm and Time&Alarm. The mode specifies what
initiates a record in the logger’s memory.

OMNITEXT-240 User Manual P a g e | 15
In Time mode, records are made periodically on “Log interval” time. In Alarm mode, records
are made on every alarm condition. In Time & Alarm mode, a mix of both conditions for records
is used.
The log interval determines the time between two log entries. It is good to remember that
by reducing the log interval, we increase the resolution, but we also reduce the past period for
which we have records. The internal memory holds 70,000 total readings so hourly records
would provide a history of almost 8 years using one channel, whereas a 1-minute logging
interval would provide a history of 48 days using one channel or 12 days using 4 channels
There are 3 ways to reach the logger records:
1. Periodically upload the last unsent records to the dedicated HTTP server.
The records are uploaded in CSV file format. The period of the upload can be chosen from
the menu between 1 and 24 hours. If you enable this service, take care of the real-time
clock (NTP service).
The HTTP server for upload can be domain or IP address but take care about DNS settings.
“Sync time” is a moment in the day when a period of upload is synchronized.
Example:
Current time is 19:31, Upload period is 3 hours and Sync time is 9:00.
To synchronize the logger to 9:00 it means that time for uploads will be: 09:00, 12:00, 15:00,
18:00, 21:00, 24:00, 03:00 and 06:00. The first upload, after enabling the logger in 19:31, will
be in 21:00.
2. Force upload
This button initiates an upload of the recorded information between previous periodical upload
and now.
3. Download full log
Clicking the Download full log button will initiate a download of the log in csv format.
By default, the logger is disabled.
More about the logger can be found in the Data logger section.
7.3.2 HTTP Post
HTTP Post is used to periodically upload an XML/JSON file to HTTP server by HTTP requests
(POST method). The XML/JSON file contains the current status of all monitored parameters and
extra system information. The file format is chosen from the drop-down menu.
The HTTP server can be addressed either by domain name or IP address.
The period of the upload can be chosen from the menu between 1 and 24 hours. This
parameter can be changed remotely also by HTTP API. The "Period" determines at what
time the control software receives up-to-date information from OMNITEXT-240 and can,
therefore, make changes to some of the parameters. The shorter the "Period", the closer
to the real-time operation is the system. On the other hand, a shorter "Period" is higher
in the data traffic through the mobile network and the power consumption.

OMNITEXT-240 User Manual P a g e | 16
“Sync time” is a moment in the day when a period of upload is synchronized (as described
earlier in this document).
The “Key” field is user defined. Its value is sent in XML/JSON file and can be used for
device identification.
If “Process Answer” option is enabled, OMNITEXT-240 will execute the commands, sent by
the remote server as an answer to HTTP Post.
Step 1 - HTTP POST request with XML data is sent to the remote server

OMNITEXT-240 User Manual P a g e | 17
Step 2 - the server responds with HTTP response message, which contains “set dc1=100”
command as a brief text in the message body
Step 3 - new HTTP POST request is sent to the server to confirm the reception of the
“set dc1=100”command.
Step 4 - the server sends new HTTP response, which includes “set FIN” in the message body.
This indicates that there are no pending commands and the session can be closed.
Step 5 - when the Push period timer expires, OMNITEXT-240 sends new HTTP POST request to
the server
Step 6 –the server answers with “set FIN” –there is no pending commands and the session
can be closed.
HTTP Post command format: set yyy=xxx
Where:
yyy is the command; xxx is the parameter.
TCG240 supports following HTTP commands, they are case sensitive:
Command
Description
mn=x
Digital inputs mode
n is 1-:-4,
x is 0-:-3, where
0 for Discrete (Open/Closed) mode 1 for Counter(Rising edge)
2 for Counter(Falling edge) 3 for Counter(Both edges)
dsamn=xxxx
Delay in samples for digital inputs
where n is 1-:-4 , xxxx is between 0 and 255
dcn=xxxx
Set initial value for counter,
n is 1-:-4, xxxx is between 0 and 1 999 999
psseconds=x
Set wakeup and polling interval, where x is
0 for 0.0625s
1 1 for 0.25s
2 2 for 0.5s
3 3 for 1s
4 4 for 2s
5 5 for 3s
6 6 for 4s
7 7 for 5s
8 8 for 6s
9 9 for 10s
10 10 for 15s
11 11 for 20s
12 12 for 30s
Logen=x
Enable/disable logger –0 disable, 1 enable
Logmode=x
Logger mode –0 Time, 1 Alarm, 2 Time&Alarm

OMNITEXT-240 User Manual P a g e | 18
logint=x
Logger interval in minutes, where x is
1 for 1 min
2 2 for 2 min
3 3 for 3 min
4 4 for 4 min
5 5 for 5 min
6 6 for 6 min
10 for 10 min
15 for 15 min
20 for 20 min
30 for 30 min
60 for 60 min
httpen=x
Logger HTTP upload –0 disable, 1 enable
httpserver=yyy
URL for HTTP Upload to Server , where yyy is a full path to php file. Example:
httpserver=www.m-2-m.com/loggers/Omnitext-240.php
httpint_h=x
HTTP Upload interval in hours, where x is
1 for 1 hour
2 2 for 2 hours
3 3 for 3 hours
6 for 6 hours
8 for 8 hours
12 for 12 hours
24 for 24 hours
httpint_m=xx
HTTP Upload sync to the minute, where xx is between 0 and 59
pmet=x
Enable/disable HTTP Post - 0 disable, 1 enable
dataf=x
Data format XML/JSON for HHTP Post –0 XML, 1 JSON
purl=yyy
URL for HTTP Post to Server 1, where yyy is a full path to php file. Example:
purl=www.m-2-m.com/loggers/Omnitext-240.php
purl2=yyy
URL for HTTP Post to Server 2, where yyy is a full path to php file Example:
purl= www.m-2-m.com/loggers/Omnitext-240.php
postint_h=x
HTTP Post period in hours, where x is
1 for 1 hour
2 for 2 hours
3 for 3 hours
6 for 6 hours
8 for 8 hours
12 for 12 hours
24 for 24 hours
postint_m=xx
HTTP Post sync to the minute, where xx is between 0 and 59
dk=xxx
HTTP Post key –xxx is up to 17 characters
pans=x
HTTP Post process answer –0 No, 1 Yes
FIN
Terminate session
(it makes sense only for HTTP Post)

OMNITEXT-240 User Manual P a g e | 19
The typical monitoring application is shown in the picture below:
The structure of Status.xml is shown in Appendix A, while Status.json is shown in Appendix B.
7.4 ADMINISTRATION
7.4.1 Backup/Restore
OMNITEXT-240 supports backup and restore of all user setting. All settings are saved in XML backup file.
This file can be used after this for restore on many devices. This is very useful for applying similar
settings to a batch of loggers.
7.4.2 Firmwareupdate
OMNITEXT-240 supports firmware update over the WEB interface.
It is very simple. Get the latest firmware file from Omni Instruments, choose the file and
press “upload” button.
ATTENTION! DON’T TURN OFF THE POWER SUPPLY DURING THE UPDATE. TURNING OFF THE
POWER SUPPLY DURING THE UPDATE WILL DAMAGE THE DEVICE.
Only click the upload button once. The web page will eventually update and display a
countdown timer. After the countdown is completed a link will be displayed that will return to
the logger configuration.

OMNITEXT-240 User Manual P a g e | 20
8SETUP VIA SMS
OMNITEXT-240 supports SMS commands for parameters change and status reports. The
commands will be executed if they are sent from the 5 phone numbers entered in the logger
configuration. Some of the commands require Master user rights.
Below is a list of the supported SMS commands.
Note that the underscore character “˽”must be replaced by one space character.
•Set new master number
Rights: Master
Syntax: set˽master˽<number>
Where <number> is a mobile number in the international format
Example
Command: set˽master˽[phone]
Answer: You are the new master!
•Set SMS users numbers - add/delete SMS users
Rights: Master
Syntax: set˽sms˽user˽<user>:<number>
Where <number> is a mobile number in the international format
<user> can be u1, u2, u3 or u4
Example
Command: set˽sms˽user u1:[phone]
Answer: u1:[phone],u2,u3,u4
Command: set˽sms˽user u2:[phone]
Answer: u1:[phone],u2:[phone],u3,u4
Command: set˽sms˽user u1:
Answer: u1, u2:[phone],u3,u4
•Display SMS users’numbers
Rights: Master, Users
Syntax: display˽sms˽users
Example
Command: display˽sms˽users
Answer: m:[phone],u1:[phone],u2:[phone],u3,u4