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).
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.
Field |
Type |
Offset |
Description |
---|---|---|---|
length |
32u |
0 |
Command size including this field, in bytes. |
id |
16u |
4 |
Command identifier (0x4010) |
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. |
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. |
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. |