System Manual

EkoTek System Installation and Configuration Manual
9261-8173 issue: 8 Page 81
© 2012 Multitone Electronics Plc
Appendix 5: Remote logging protocol
1. Overview of logging
The remote logging facility can be used for real time recording and remote storage of
system events. Third parties are able to make use of the hub’s remote logging
output and external system input as a low level RS232 paging interface with higher
level application software creating more sophisticated functions. For example, an
application could be created to page staff members closest to the location where a
request for assistance is made from, or to display the location of an individual on a
graphical site plan, or to send an SMS message when a location alarm is raised.
The logging output from the hub supports output of the following message types:
Paging messages
Output each time a paging message is sent or responded to.
Location report
Output each time a device with location reporting enabled changes location.
Personal security alarm
Output when PS alarms are raised/cleared.
Maintenance message
Output when maintenance messages are raised e.g. low battery alarms from
repeaters.
Remote logging information is sent within a payload of SysLog formatted
messages. It is sent to UDP port 514 of the IP address specified on the system
configuration page. No check is made to ensure that the machine is present.
Remote debug logging
The hub also supports low-level message debug logging. This can be used by
Multitone for the diagnosis of network problems, but in a standard running
system should be set to ‘Off’. In order to differentiate between debug and
event logging different SysLog levels are used. Event logging is priority ‘info’
and debug logging is priority ‘debug’.
2. General formatting
Remote logging messages can be set to numeric only, text only or a combination of
numeric and text. These combinations allow the output to be easily human or
machine readable as required.
Tabs delimit the fields.
All fields are present in all messages, even if empty, unless no more fields are to be
filled in, where the line is then newline terminated.
Message always terminated by newline. Output can be off, numeric, text or numeric
and text.