9.1) HTTP Based Device Communication Servers (using the "gprmc" servlet)
[Skills required: Java, Servlets, HTTP based protocols]
HTTP-based communication is typically the easiest to implement. If your remote tracking device sends messages to the
server using an HTTP-base communication protocol, then the example server 'gprmc' can be modified to parse
received data and insert it into the SQL database. The sources for the 'gprmc' server (named after the $GPRMC record
in the NMEA-0183 protocol) can be found in the OpenGTS source directory "src/org/opengts/war/gprmc" and
runs as a Servlet in a servlet container such as Apache Tomcat (and uses the same access ports configured for
Tomcat).
9.1.1) Configuring the "gprmc" Servlet:
This module has many built-in configurable options and may only need special customization properties which can be
specified in the "webapp.conf" file. The following is a list of configurable properties available for the "gprmc" http-
based device communication server:
Data format/value Property Keys:
– gprmc.logName
Logging output name.
Default value: gprmc
– gprmc.uniquePrefix
UniqueID prefix, used when lookup up Device.
Defaults value: (same as "gprmc.logName" property value)
– gprmc.defaultAccountID
Default account ID.
Default value: gprmc
– gprmc.minimumSpeedKPH
Minimum acceptable speed (speeds less than this value will be set to '0')
Default value: 0.0
– gprmc.estimateOdometer
If true, a GPS based odometer will be calculated.
Default value: false
– gprmc.simulateGeozones
If true, a geozone arrival/departures will be detected, and the appropriate additional events will be created.
Default value: false
– gprmc.dateFormat
Date format for 'date' parameter.
Valid values: NONE, EPOCH, YMD, DMY, MDY
Default value: YMD
– gprmc.response.ok
Response returned to device on on successful data receipt.
Default value: (nothing returned)
– gprmc.response.error
Response on returned to device on on unsuccessful (error) data receipt.
Default value: (nothing returned)
OpenGTS Configuration and Installation Manual Page 32 of 60
Kommentare zu diesen Handbüchern