Event message
| Common header | Data | Data |
|---|---|---|
| Byte 0-4 | Byte 5 | Byte 6-12 |
| Header with Type=0x0A | Event Value | Additional data |
It notifies generic events.
Event Value
- 0x00: geolocation start message: If activated (bit 6 of config_flags set), the event message is sent when the tracker begins a geolocation.
- 0x01: motion_start message: If activated (bit 8 of config_flags set), the event message is sent when the tracker begins a motion.
- 0x02: motion_end message: If activated (bit 9 of config_flags set), the event message is sent when the end. of a motion is detected.
- 0x03: BLE connected: Sent when a tracker is bonded and BLE connected to a mobile or a tablet
- 0x04: BLE disconnected: Sent when a tracker is bonded and BLE disconnected to a mobile or a tablet
- 0x05: Temperature information message: if the temperature monitoring is activated (the parameter temperature_high or temperature_low is set), this event message is sent when there is a state change in the temperature (normal to alert or alert to normal) or it can be sent instead of a geolocation message if the geolocation is cancelled due to temperature_action parameter. (Refer to the section Temperature monitoring for more details)
- 0x06: BLE bond deleted: Sent when the bond is deleted on the tracker (it is sent even if the tracker was not bonded before the command)
- 0x07: SOS start message: The tracker enters in SOS
- 0x08: SOS stop message: The tracker leaves the SOS
- 0x09: Angle detection event
- 0x0A: BLE geozoning event
Additional data
- motion_end messages:
Provide the gravity vector, which can be used for the device orientation. Vector components can be negative.
Refer to the section Two's complement Encoding for the encoding.
Additional data with Event value=0x02
| Byte 6-7 | Byte 8-9 | Byte 10-11 |
|---|---|---|
| X axis | Y axis | Z axis |
X axis: X axis accelerometer value in mG Y axis: Y axis accelerometer value in mG Z axis: Z axis accelerometer value in mG
- Temperature alert messages:
Provides data about the measured temperature.
Additional data with Event value=0x05
| Byte 6 | Byte 7 | Byte 8 | Byte 9-10 | Byte 11-12 |
|---|---|---|---|---|
| State ≠ 3 | Max temperature | Min Temperature | High counter | Low counter |
| State = 3 | reserved | reserved | reserved | reserved |
State:
- 0: Normal temperature
- 1: High temperature
- 2: Low temperature
- 3: Feature not activated
Max Temperature: Maximum temperature measured by the device.
Min Temperature: Minimum temperature measured by the device.
High counter: From the time a high temperature event is sent, this counter is incremented every 10 minutes (can be used to calculate the over temperature time).
Low counter: From the time a low temperature event is sent, this counter is incremented every 10 minutes (can be used to calculate the under temperature time).
- If the feature is not activated, values in the additional data part are not valid.
- The counters never reset.
- Angle detection:
Provide states and gravity vectors Additional data with Event value=0x09 Additional data with Event value=0x09
| Byte 6 | Byte 7-8 | Byte 9-10 | Byte 11-12 | Byte 13-14 | Byte 15-16 | Byte 17-18 | Byte 19-20 | Byte 21 |
|---|---|---|---|---|---|---|---|---|
| Flags | Age | Ref Vector: X | Ref Vector: Y | Ref Vector: Z | Critical Vector: X | Critical Vector: Y | Critical Vector: Z | angle |
Flags: provides a status and report reason, coded as:
| Bit | Type | Explanation |
|---|---|---|
| Bit 7-5 | Transition between states | 0: learning to normal |
| 1: normal to learning | ||
| 2: normal to critical | ||
| 3: critical to normal | ||
| 4: critical to learning | ||
| Bit 4-3 | Trigger type | 0: Critical angle reporting |
| 1: Angle deviation reporting | ||
| 2: Shock trigger | ||
| 3: RFU | ||
| Bit 2-0 | Repetition Counter | Range [0..7]. A new transition report cycle resets this counter |
Age: Age of the measure, expressed in seconds. The value is in big endian (MSB first).
-
Ref Vector X: X axis accelerometer value in mG, used for the reference vector
-
Ref Vector Y: Y axis accelerometer value in mG, used for the reference vector
-
Ref Vector Z: Z axis accelerometer value in mG, used for the reference vector
-
Critical Vector X: X axis accelerometer value in mG, it is the last measurement value
-
Critical Vector Y: Y axis accelerometer value in mG, it is the last measurement value
-
Critical Vector Z: Z axis accelerometer value in mG, it is the last measurement value
Angle: Angle in degree between the reference vector and the last measurement
- Signed 16 bit value on each axis, refer to the section Two's complement Encoding for information for the encoding
- G is the terrestrial gravity, mG means milli G.
- For more details refer to the application note AN_010 _Angle Detection.
- BLE geozoning messages: Additional data with Event value=0x0A
| Byte 6 | Byte 7-9 |
|---|---|
| Status | Beacon Id |
Status
| Bit | Type | |
|---|---|---|
| Bit 7-4 | Beacon type | 0: short Id |
| Bit 3-0 | Notification type | 0: Safe |
| 1: Entry | ||
| 2: Exit | ||
| 3: Hazard |
Beacon Id: beacon identifier of the detected beacon
Please refer to the dedicated application note AN-011_BLE geozoning for more details.