Payload Format
Codec
The miro TrackIt codec is integrated with Semtech LoRaCould
Data Encoding
Signed integers use two’s complement for encoding.
Important
Unless otherwise noted, payloads will use big endian data encoding.
Device Settings Format
Downlink
The device settings downlink payload shall be in an TLV format which is defined as:
| Tag | Length | Number of Commands | Data |
|---|---|---|---|
| 0x4C | Variable number | Variable number | Device Settings |
The device setting result downlink messages are sent to port 151.
Uplink
The device settings uplink payload shall be in an TLV format which is defined as:
| Tag | Length | Number of Commands | Data |
|---|---|---|---|
| 0x4C | Variable number | Variable number | Device Settings |
The device setting result uplink messages are sent to port 199.
Device Settings
Set Accelerometer
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x24 | 0x01 | [0,1] | Enable or disable accelerometer | uint8 | [1] |
Set Scan Interval
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x26 | 0x02 | [10,1800] [sec] | Steady state interval for localization | uint16 | 60 [sec] |
Set Keep Alive Frame Interval
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x28 | 0x02 | [10,1440] [sec] | Heartbeat message interval | uint16 | 86400 [sec] |
Set ADR Profile
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x3E | 0x01 | [0,3] | 0 = Network controlled 1 = Mobile long range 2 = Mobile low power 3 = Custom |
uint16 | [0] |
Get Accelerometer
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x25 | 0x00 | - | Requests the accelerometer enabled flag | - | - |
Get Scan Interval
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x27 | 0x00 | - | Requests the steady state interval | - | - |
Get Keep Alive Frame Interval
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x29 | 0x00 | - | Requests heartbeat message interval | - | - |
Get ADR Profile
| Tag | Size | Range | Description | Format | Default Value |
|---|---|---|---|---|---|
| 0x3F | 0x00 | - | Requests ADR format | - | - |
Example
Example Downlink Message
| Message | Byte sequence | Port |
|---|---|---|
| Downlink: "Set New Value" request form backend | 4C 13 06 24 01 01 26 02 03 E8 28 02 03 E8 3E 01 00 01 00 45 00 | Port: 151 |
| Uplink: "Device Settings Answer" form TrackIt | 4C 0E 06 24 01 01 26 02 03 E8 28 02 03 E8 3E 01 00 | Port: 199 |
Example Uplink Message
| Message | Byte sequence | Port |
|---|---|---|
| Downlink: "Get Current Value" request form backend | 4C 0D 06 25 00 27 00 29 00 3F 00 01 00 45 00 | Port: 151 |
| Uplink: "Device Settings Answer" form TrackIt | 4C 0E 06 25 01 01 27 02 03 E8 29 02 03 E8 3F 01 00 | Port: 199 |
Localization
The navigation result uplink messages are sent to port 199. The GNSS and Wi-Fi results are merged into the same message. The payload length depends on the number of results.
Wi-Fi Results
| Byte | Size | value | Range | Description | Format |
|---|---|---|---|---|---|
| 1 | 1 | 0x08 | fixed | Message type | uint8 |
| 2 | 1 | 0xXX | [1..255] | Message length | uint8 |
| 3-8 | 6 | MAC:1 | [1..255] | MAC-address | uint8 * 6 |
| 9 | 1 | RSSI:1 | [1..255] | RSSI-value | uint8 |
| 10-15 | 6 | MAC:2 | [1..255] | MAC-address | uint8 * 6 |
| 16 | 1 | RSSI:2 | [1..255] | RSSI-value | uint8 |
| ... | |||||
| (N-6)-(N-5) | 6 | MAC:N | [1..255] | MAC-address | uint8 * 6 |
| N | 1 | RSSI:N | [1..255] | RSSI-value | uint8 |
GNSS Results
| Byte | Size | value | Range | Description | Format |
|---|---|---|---|---|---|
| 1 | 1 | 0x07 | fixed | Message type | uint8 |
| 2 | 1 | 0xXX | [1..255] | Message length | uint8 |
| 3 - N | (N-3) | NAV | dynamic | result value | uint8 |
Localization Example
Please reference to the Semtech web page for GNSS and Wi-Fi payload examples.