Event Reporting; Events; Store And Forward - red lion BT-6821-AT-AC User Manual

10

Event Reporting

Event Reporting is covered in its own document, the I/O Management & Event Reporting Guide. This section is meant to
provide a general overview of what can be accomplished with the modem's BlueTree Event Protocol engine.
Event Reporting is used to program the modem to automatically perform an action (such as sending a report) whenever
a user-defined event occurs. An event occurs, or is triggered, when the conditions that define it have been met.
Event Reporting has the same "Store and forward" feature used by the GPS reporting engine, as described in the
section. This ensures that no reports are lost if the modem loses its connection to the cellular network: everything is
saved to memory and forwarded when the connection is reestablished.
10.1

Events

The event that triggers an action 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

WAN status
The BT-5600v2 and BT-5800v2 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

The ignition (IGN) signal state
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. This provides a great amount of control and allows defining
events that meet most if not all potential requirements.
10.2

Store and forward

The modems have a 512 Kbytes memory area dedicated to storing BlueTree Event Protocol reports. It can store
approximately 5000 events (exact amount depends on the configuration). The event is either composed of raw GPS data
(BT-5600v2 and BT-5800v2 only) or structured in a BEP message payload.
This feature will activate automatically when the modem cannot reach its reporting destination. The report destination
has to be configured with TCP/IP (with or without BEP ACK) or with UDP/IP (with BEP ACK only). Events are not stored
when the reporting destination is UDP/IP without BEP ACK. The modem will save the reports in its memory buffer until it
is able to send them or when they are acknowledged ensuring that no event has been lost.
GPS