Rainforest Automation
,
Inc
.
RAVEn™
XML API Manual
10
4. Command: GET_CONNECTION_STATUS
Send the GET_CONNECTION_STATUS command to get the
RAVEn
™ connection information.
The
RAVEn
™ will send a
ConnectionStatus
notification in response.
<Command>
<Name>get_connection_status</Name>
</Command>
5. Notify:
ConnectionStatus
The
RAVEn
™ will send notifications during the start-up sequence and during the join/re-join
sequence. These notifications are useful for diagnostic purposes.
<ConnectionStatus>
<DeviceMacId>0xFFFFFFFFFFFFFFFF</DeviceMacId>
<MeterMacId>0xFFFFFFFFFFFFFFFF</MeterMacId>
<Status>{enumeration}</Status>
[<Description>{string}</Description>]
[<StatusCode>0xFF</StatusCode>]
[<ExtPanId>0xFFFFFFFFFFFFFFFF</ExtPanId>]
[<Channel>00</Channel>]
[<ShortAddr>0xFFFF</ShortAddr>]
<LinkStrength>0xFF</LinkStrength>
</ConnectionStatus>
Element
Range
Description
DeviceMacId
0xFFFFFFFFFFFFFFFF
Unique MAC Address of the
RAVEn
™
MeterMacId
0xFFFFFFFFFFFFFFFF
Unique MAC Address of meter
Status
Initializing | Network
Discovery | Joining | Join:
Fail | Join: Success |
Authenticating |
Authenticating: Success |
Authenticating: Fail |
Connected | Disconnected |
Rejoining
Indicates the current state of the device
Description
Text; Optional
Gives a description of the device state
StatusCode
0x00 – 0xFF; Optional
If available, provides a status code for the
current state
ExtPanId
0x0 -
0xFFFFFFFFFFFFFFFF;
Optional
Provides the extended PAN ID of the
network the device is trying to join or has
joined
Channel
11 – 26; Optional
Indicates the channel on which the device is
operating
ShortAddr
0x0000 – 0xFFFF; Optional
The short address assigned to the
RAVEn
™ by the network coordinator
LinkStrength
0x00 – 0x64
Indicates the strength of the link