Get System Info V2

The Get System Info command reports information about the local node, remote nodes and assigned buddies.

Firmware version refers to the version of the sensor's firmware installed on each individual sensor. The client can upgrade the sensor's firmware by sending the Start Upgrade command (see Start Upgrade). Firmware upgrade files are available from the downloads section under the support tab on the LMI web site. For more information on getting the latest firmware, see Firmware Upgrade.

Every sensor contains factory backup firmware. If a firmware upgrade command fails (e.g., power is interrupted), the factory backup firmware will be loaded when the sensor is reset or power cycled. In this case, the sensors will fall back to the factory default IP address. To avoid IP address conflicts in a multi-sensor system, connect to one sensor at a time and re-attempt the firmware upgrade.

Command

Field

Type

Offset

Description

length

32u

0

Command size including this field, in bytes.

id

16u

4

Command identifier (0x4010)

Reply

Field

Type

Offset

Description

length

32u

0

Reply size including this field, in bytes.

id

16u

4

Reply identifier (0x4010).

status

32s

6

Reply status. For a list of status codes, see Status Codes.

localInfoSize 16u 10 Size of localInfo structure. Current: 116.
localInfo Local Info 12 Info for this device.
remoteCount 32u - Number of discovered sensors.
remoteInfoSize 16u - Size of remoteInfo structure. Current 124.
remoteInfo[remoteCount] Remote Info - List of info for discovered sensors.
buddyInfoCount 32u - Number of buddies assigned (can be 0).
buddyInfoSize 16u - Size of buddyInfo structure. Current: 8.
Buddies[buddyCount] Buddy Info - List of info for the assigned buddies.
Local Info

Field

Type

Offset

Description

deviceId 32u 0 Serial number of the device.
address[4] byte 4 IP address (most significant byte first).
modelName[32] char 8

Model name; "part number" starting with GoSdk 5.3.17.23. Should not be parsed.

firmwareVersion[4] byte 40 Firmware version (most significant byte first).
state 32s 44

Sensor state

-1 – Conflict

0 – Ready

1 – Running

For more information on states, see States.

role 32s 48

Sensor role

0 – Main

1 – Buddy

modelNumber[32]

char

52

Model number that can be parsed.

modelDisplayName[32]

char

56

User-friendly model display name that can be used to rename sensors more appropriately for custom-branding naming.

Remote Info

Field

Type

Offset

Description

deviceId 32u 0

Serial number of the remote device.

address[4] byte 4 IP address (most significant byte first).
modelName[32] char 8

Remote model name; "remote part number" starting with GoSdk 5.3.17.23.

firmwareVersion[4] byte 40 Remote firmware version (most significant byte first).
state 32s 44

Remote sensor state

-1 – Conflict

0 – Ready

1 – Running

For more information on states, see States.

role 32s 48

Sensor role

0 – Main

1 – Buddy

mainId 32u 52 Serial number of the main device, or zero.
buddyableStatus 32s 56

Whether or not the device can be buddied:

1 – Can be buddied

 

Errors:

0 – Unbuddiable (General Error)

-100 – Already buddied

-99 – Invalid State (e.g. running)

-98 – Version Mismatch

-97 – Model Mismatch

modelNumber[32]

char

60

Model number that can be parsed.

modelDisplayName[32]

char

92

Remote user-friendly model display name that can be used to rename sensors more appropriately for custom-branding naming.

Buddy Info

Field

Type

Offset

Description

deviceId 32u 2 Serial number of the device.
state k32s 6

Buddy state

2 - Connecting

1 – Connected

 

Errors:

0 – Unbuddiable (General Error)

-100 – Already buddied

-99 – Invalid State (e.g. running)

-98 – Version Mismatch

-97 – Model Mismatch

-95 – Device Missing

-92 – Standalone Sensor

-91 – Restricted Sensor Mismatch