Rainforest Automation RFA-Z109 EAGLE Manual Download Page 17

Rainforest Automation, Inc.  

EAGLE™

 

Uploader API Manual 

 

 

17 

3.  Command: get_history_data 

Send the 

get_history_data

 command to get a  series of summation values over  an  interval of 

time.  In  response,  the 

EAGLE

™  will  send  a 

HistoryData

  fragment  containing  a  series  of 

CurrentSummation

 fragments 

– one for each sample over the interval. 

<LocalCommand> 
 

<Name>get_history_data</Name> 

 

<MacId>0xFFFFFFFFFFFFFFFF</MacId> 

 

<StartTime>0xFFFFFFFF</StartTime> 

 

[<EndTime>0xFFFFFFFF</EndTime>] 

 

[<Frequency>0x0000</Frequency>] 

</LocalCommand> 

 

Element 

Range 

Description 

MacId 

16 hex digits 

MAC Address of 

EAGLE

™ ZigBee radio 

StartTime

 

Up to 8 hex digits 

UTC Time (offset in seconds from 
00:00:00 01Jan2000) of the start of the 
history interval.  If StartTime is older than 
the oldest sample, then the interval will 
start from the oldest sample. 

EndTime

 

Up to 8 hex digits 

UTC Time (offset in seconds from 
00:00:00 01Jan2000) of the end of the 
history interval.  If not specified, EndTime 
will be the current time. 

Frequency 

4 hex digits 

Requested number of seconds between 
samples. Availability limited by what has 
been collected by 

EAGLE

™.  Default is 

all of the existing samples in the interval. 

 

 

4.  Command: get_ profile_data 

Send  the 

get_profile_data

  command  to  have  the 

EAGLE

™  retrieve  interval  data  information 

stored in the meter.  The 

EAGLE

™ will send a 

ProfileData

 fragment in response. 

Note that the tag <RavenCommand> is used instead of <LocalCommand>. 

 

<RavenCommand> 
   

<Name>get_profile_data</Name> 

 

<DeviceMacId>0xFFFFFFFFFFFFFFFF</DeviceMacId> 

   

[<MeterMacId>0xFFFFFFFFFFFFFFFF</MeterMacId>] 

  

<NumberOfPeriods>0x00</NumberOfPeriods> 

   

<EndTime>0xFFFFFFFF</EndTime> 

   

<IntervalChannel>{enumeration}</IntervalChannel> 

</RavenCommand> 
 

 

 

Summary of Contents for RFA-Z109 EAGLE

Page 1: ...EAGLE Energy Access Gateway Link to Ethernet Uploader API Manual Version 6 July 2014...

Page 2: ...copies can be sold given or loaned to another person Under the law copying includes translating into another language or format Rainforest Automation may have patents patent applications trademarks c...

Page 3: ...Replies 6 XML FRAGMENTS 8 1 DeviceInfo 8 2 NetworkInfo 8 3 InstantaneousDemand 9 4 PriceCluster 10 5 Message 11 6 CurrentSummation 12 7 MeterInfo 13 8 FastPollStatus 13 9 HistoryData 14 10 ProfileData...

Page 4: ...sts contains the meter data structured as XML Fragments Data Structures 1 Requests The EAGLE sends data in a POST request POST requests have the following structure POST URL HTTP 1 1 headers blank bod...

Page 5: ...ement will have a unique element name indicates the variable number of specific elements Element values can be of various types string indicates an element consisting of Extended ASCII text enumeratio...

Page 6: ...pects to see a valid HTTP response to each POST request These look like HTTP 1 0 code headers blank body Where Every line ends with the newline character 0x0A code is an HTTP status code which consist...

Page 7: ...onent and will simply acknowledge a POST sent by the EAGLE However it is also possible to send a single XML formatted command to the EAGLE in the body of the reply While a command sent in this way is...

Page 8: ...allCode 16 hex digits Install Code for EAGLE ZigBee radio LinkKey 32 hex digits ZigBee radio Link Key FWVersion Text Firmware Version HWVersion Text Hardware Version ImageType 4 hex digits ZigBee code...

Page 9: ...rk coordinator LinkStrength 0x00 0x64 Indicates the strength of the radio link 3 InstantaneousDemand InstantaneousDemand fragments provide the current consumption rate as recorded by the meter Note th...

Page 10: ...FFFFFFFFFFFFF DeviceMacId MeterMacId 0xFFFFFFFFFFFFFFFF MeterMacId TimeStamp 0xFFFFFFFF TimeStamp Price 0xFFFFFFFF Price Currency 0xFFFF Currency TrailingDigits 0xFF TrailingDigits Tier 00 Tier TierLa...

Page 11: ...ation Queue MessageCluster Element Range Description DeviceMacId 16 hex digits MAC Address of EAGLE ZigBee radio MeterMacId 16 hex digits MAC Address of Meter TimeStamp Up to 8 hex digits UTC Time off...

Page 12: ...SuppressLeadingZero CurrentSummationDelivered Element Range Description DeviceMacId 16 hex digits MAC Address of EAGLE ZigBee radio MeterMacId 16 hex digits MAC Address of Meter TimeStamp Up to 8 hex...

Page 13: ...Nickname Text Nickname set for the meter Account Text Account Identification Auth Text Authentication code Host Text Hosting Provider Enabled Y N Y to start transmitting data to host N to stop transm...

Page 14: ...acId 0xFFFFFFFFFFFFFFFF DeviceMacId MeterMacId 0xFFFFFFFFFFFFFFFF MeterMacId TimeStamp 0xFFFFFFFF TimeStamp SummationDelivered 0xFFFFFFFF SummationDelivered SummationReceived 0xFFFFFFFF SummationRecei...

Page 15: ...seconds from 00 00 00 01Jan2000 of the end of the most chronologically recent interval 0x0 indicates the most recent interval block Status 0x0 0x05 Status of returned data 0x00 Success 0x01 Undefined...

Page 16: ...polling will default to a maximum frequency of every 4 seconds for up to 15 minutes If Duration is zero then fast poll mode is turned off Note that the tag RavenCommand is used instead of LocalComman...

Page 17: ...n the oldest sample then the interval will start from the oldest sample EndTime Up to 8 hex digits UTC Time offset in seconds from 00 00 00 01Jan2000 of the end of the history interval If not specifie...

Page 18: ...ser Received Interval data for commodity received by the utility from the user 5 Command set_schedule Send the set_schedule command to change how the EAGLE polls the meter The rate at which each type...

Page 19: ...Right DigitsLeft 0x00 DigitsLeft SuppressLeadingZero Y SuppressLeadingZero InstantaneousDemand The values from this notification are Demand reading 1738 hex 5944 decimal Multiplier 1 Divisor 3E8 hex 1...

Page 20: ...11cf431 MeterMacId TimeStamp 0x1a462b4d TimeStamp Price 0x0000007d Price Currency 0x0348 Currency TrailingDigits 0x03 TrailingDigits Tier 0x01 Tier RateLabel Set by User RateLabel PriceCluster The val...

Reviews: