Rainforest Automation RFA-Z109 EAGLE, Manual

Rainforest Automation, Inc.  

EAGLE™

Uploader API Manual 

19 

HANDLING THE NUMBERS 

Summation and Demand Readings 

Summation  and  Demand  readings  from  the  meter  are  reported  as  hexadecimal  integers  with 
formatting instructions to calculate the decimal value.   

Here is a typical 

InstantaneousDemand

 notification: 

<InstantaneousDemand> 
<DeviceMacId>0x00158d0000000004</DeviceMacId> 
<MeterMacId>0x00178d0000000004</MeterMacId> 
<TimeStamp>0x185adc1d</TimeStamp> 
<Demand>0x001738</Demand> 
<Multiplier>0x00000001</Multiplier> 
<Divisor>0x000003e8</Divisor> 
<DigitsRight>0x03</DigitsRight> 
<DigitsLeft>0x00</DigitsLeft> 
<SuppressLeadingZero>Y</SuppressLeadingZero> 
</InstantaneousDemand> 

The values from this notification are: 



  Demand reading = 1738 (hex) = 5944 (decimal) 



  Multiplier = 1 



  Divisor = 3E8 (hex) = 1000 (decimal) 

The actual Demand value is calculated by using the multiplier and divisor: 



  5944 x 1 / 1000 = 5.944 kWh 

If the multiplier or divisor is zero then use a value of one instead. 

For Summation, the same process is used, and the multiplier and divisor are used by both the 
SummationDelivered and SummationReceived readings in the 

CurrentSummation

 notification. 

The other formatting values (DigitsRight, DigitsLeft, SupressLeadingZeros) are the preferred 
display settings set by the utility and can be ignored for the purposes of calculating values.