Rainforest Automation RAVEn, Руководство по XML API

Страница: 17 / 29

Rainforest Automation , Inc .
RAVEn™
XML API Manual
17
Time Feature
The Time Feature provides the commands and notifications for getting the time from the smart
meter.
Key commands and notifications include:
•
Notify what the time is on a smart meter
•
Ask for the latest time from a smart meter
1. Command: GET_TIME
Send the GET_TIME command to get the current time. The RAVEn ™ will send a TimeCluster
notification in response.
<Command>
<Name>get_time</Name>
[<MeterMacId>0xFFFFFFFFFFFFFFFF</MeterMacId>]
[<Refresh>{enumeration}</Refresh>]
</Command>
Element Range Description
MeterMacId 0xFFFFFFFFFFFFFFFF;
Optional if only one meter Unique MAC Address of meter
Refresh Y | N; Optional Y: Get current time from meter
N: Get time from
RAVEn ™ cache (default)
2. Notify: TimeCluster
TimeCluster notifications provide the current time reported on the meter in both UTC and Local
time. The time values are the number of seconds since 1-Jan-2000 UTC.
<TimeCluster>
<DeviceMacId>0xFFFFFFFFFFFFFFFF</DeviceMacId>
<MeterMacId>0xFFFFFFFFFFFFFFFF</MeterMacId>
<UTCTime>0xFFFFFFFF</UTCTime>
<LocalTime>0xFFFFFFFF</LocalTime>
</TimeCluster>
Element Range Description
DeviceMacId 0xFFFFFFFFFFFFFFFF Unique MAC Address of the RAVEn ™
MeterMacId 0xFFFFFFFFFFFFFFFF Unique MAC Address of meter
UTCTime 0x0 – 0xFFFFFFFF UTC Time as reported by meter
LocalTime 0x0 – 0xFFFFFFFF Local Time as reported by meter