background image

Rainforest Automation, Inc.  

EAGLE™

 

Uploader API Manual 

 

 

10 

Demand

 

6 hex digits 

The raw instantaneous demand value.  This is 
a 24-bit signed integer. 

Multiplier

 

Up to 8 hex digits 

The multiplier; if zero, use 1 

Divisor

 

Up to 8 hex digits 

The divisor; if zero, use 1 

DigitsRight

 

Up to 2 hex digits 

Number of digits to the right of the decimal 
point to display 

DigitsLeft

 

Up to 2 hex digits 

Number of digits to the left of the decimal point 
to display 

Suppress 
LeadingZero

 

Y | N 

Y: Do not display leading zeros 
N: Display leading zeros 

 
 

4.  PriceCluster 

PriceCluster

 fragments provide the current price in effect on the meter, or the user-defined price 

set on the 

EAGLE

™. If the user-defined price is not set and the meter price is not set, then the 

price returned is zero.  

<PriceCluster> 
 

<DeviceMacId>0xFFFFFFFFFFFFFFFF</DeviceMacId> 

 

<MeterMacId>0xFFFFFFFFFFFFFFFF</MeterMacId> 

 

<TimeStamp>0xFFFFFFFF</TimeStamp> 

 

<Price>0xFFFFFFFF</Price> 
<Currency>0xFFFF</Currency> 

 

<TrailingDigits>0xFF</TrailingDigits> 

 

<Tier>00</Tier> 

 

[<TierLabel>{string}</TierLabel> | 
<RateLabel>{string}</RateLabel>] 

</PriceCluster> 

 

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 (offset in seconds from 00:00:00 
01Jan2000) when price data was received 
from meter or set by user 

Price

 

Up to 8 hex digits 

Price from meter or set by user; will be zero if 
no price is set 

Currency 

Up to 4 hex digits 

Currency being used; value of this field 
matches the values defined by ISO 4217 

TrailingDigits

 

Up to 2 hex digits 

The number of implicit decimal places in the 
price. (e.g. 2 means divide Price by 100). 

Tier

 

1 - 5 

The price Tier in effect. 

RateLabel 

Text 

Rate label for the current price tier

; will be “Set 

by User” if a user-defined price is set 

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: