Section 10: Event Reporting
Event Reporting is covered in its own document, the
I/O Management & Event Reporting
Guide
, available at
www.bluetreewireless.com
. This section is meant to provide a general
overview of what can be accomplished with Event Reporting.
Event Reporting is used to program the modem to automatically transmit a report whenever a
user-defined event occurs to as many as 10 local or remote destinations. An event occurs
when its defined conditions have been met.
Events
The event that triggers an automatic report can be any of the following:
•
A timer has finished counting down
•
An analog input signal has reached a certain value
•
A digital input signal has changed state (this includes vehicle ignition monitoring)
The 5200 and 5600/A modems are equipped with a GPS receiver and can react upon these
additional GPS-based event triggers:
•
The modem is in motion at a particular speed
•
The modem is in motion in a particular direction (heading)
•
The modem is unable to acquire a GPS fix
•
The modem has traveled for a set distance
Events can also be combined using logical statements to create more complex events. For
example, a combination of the timer and speed event triggers could define an event that
would trigger when a vehicle has been speeding, by defining speeding as moving at 60+ mph
for more than 10 seconds.
Reports
Once an event occurs, the modem sends a report to a set destination. All reports, with the
exception of one (unformatted GPS reports), are custom-formatted by the BlueTree Event
Protocol (BEP) as defined in the
I/O Management & Event Reporting
document, so they require
some manipulation on the destination end in order to be parsed.
A report can contain one or more of the following information:
•
The modem's name and ESN
•
The modem's RSSI (signal strength)
•
The value of a specific analog signal
•
The state of a specific digital signal
•
The modem's odometer value (total distance traveled)
•
A BEP-formatted GPS report containing NMEA or TAIP data
•
An unformatted GPS report containing NMEA or TAIP data
The modem can be configured to wait for confirmation (“ACK”) from the remote server that it
has received the report. If this confirmation does not come, the modem will assume the report
has not been received and will continue sending the same report at a configured interval until
it receives confirmation of receipt.
To ease the parsing of the packets on the server, the modem can sync flags in the beginning
and end of each packet it sends.