miro TrackIt
Payload

Unless otherwise noted, payloads will use big endian data encoding.

1. Device Settings Format

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.

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.

1.3. 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

-

-

1.4. Example

Static

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
Static

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

2. Localization

The navigation result uplink messages are sent to port 199. The GNSS and Wi-Fi resutls are merged into the same message. The payload length depends on the number of results.

2.1. 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

2.2. 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

2.3. Localization Example

Please consider the Semtech web page for GNSS and Wi-Fi payload examples.