Browse Source

updated

main
Peter Shipley 10 years ago
parent
commit
813757c483
1 changed files with 85 additions and 39 deletions
  1. +85
    -39
      doc.txt

+ 85
- 39
doc.txt View File

@@ -7,9 +7,7 @@ FILE
RainEagle/EagleClass.py

CLASSES
__builtin__.object
Eagle
exceptions.RuntimeError(exceptions.StandardError)
RainEagleResponseError
class Eagle(__builtin__.object)
@@ -20,6 +18,7 @@ CLASSES
| addr address of device
| port port on device (default 5002)
| getmac connect to device at start up and get macid (default true)
| timeout TCP socket timeout
|
| Currently there is very little error handling ( if any at all )
|
@@ -54,6 +53,10 @@ CLASSES
| get_device_data(self, macid=None)
| Send the GET_DEVICE_DATA command to get a data dump
|
| get_device_list(self)
| Send the LIST_DEVICES command
| returns information about the EAGLE device
|
| get_fast_poll_status(self, macid=None)
| Send the GET_FAST_POLL_STATUS command
| get the current status of fast poll mode.
@@ -78,35 +81,35 @@ CLASSES
| period day|week|month|year
|
| On Success returns dict with the values (example):
| 'data_period' 'day',
| 'data_size' '14',
| 'timestamp[0]' '1394422200',
| 'timestamp[1]' '1394425800',
| 'timestamp[2]' '1394429400',
| 'timestamp[3]' '1394433000',
| 'timestamp[4]' '1394436600',
| 'timestamp[5]' '1394440200',
| 'timestamp[6]' '1394443800',
| 'timestamp[7]' '1394447400',
| 'timestamp[8]' '1394451000',
| 'timestamp[9]' '1394454600',
| 'timestamp[10]' '1394458200',
| 'timestamp[11]' '1394461800',
| 'timestamp[12]' '1394465400',
| 'timestamp[13]' '1394469000',
| 'value[0]' '0.429',
| 'value[1]' '0.426',
| 'value[2]' '0.422',
| 'value[3]' '0.627',
| 'value[4]' '0.735',
| 'value[5]' '0.193',
| 'value[6]' '0.026',
| 'value[7]' '-0.985',
| 'value[8]' '-1.491',
| 'value[9]' '-2.196'}
| 'value[11]' '-1.868',
| 'value[12]' '-1.330',
| 'value[13]' '-0.870',
| 'data_period' 'day'
| 'data_size' '14'
| 'timestamp[0]' '1394422200'
| 'timestamp[1]' '1394425800'
| 'timestamp[2]' '1394429400'
| 'timestamp[3]' '1394433000'
| 'timestamp[4]' '1394436600'
| 'timestamp[5]' '1394440200'
| 'timestamp[6]' '1394443800'
| 'timestamp[7]' '1394447400'
| 'timestamp[8]' '1394451000'
| 'timestamp[9]' '1394454600'
| 'timestamp[10]' '1394458200'
| 'timestamp[11]' '1394461800'
| 'timestamp[12]' '1394465400'
| 'timestamp[13]' '1394469000'
| 'value[0]' '0.429'
| 'value[1]' '0.426'
| 'value[2]' '0.422'
| 'value[3]' '0.627'
| 'value[4]' '0.735'
| 'value[5]' '0.193'
| 'value[6]' '0.026'
| 'value[7]' '-0.985'
| 'value[8]' '-1.491'
| 'value[9]' '-2.196'
| 'value[11]' '-1.868'
| 'value[12]' '-1.330'
| 'value[13]' '-0.870'
|
| get_history_data(self, macid=None, starttime='0x00000000', endtime=None, frequency=None)
| Send the GET_HISTORY_DATA command
@@ -142,10 +145,10 @@ CLASSES
| get price for kWh
|
| On Success returns (example):
| price': '0.1300',
| price': '0.1300'
| price_label': 'Set by User' or '--'
| price_timestamp': '1394524458',
| price_units': '$'}
| price_timestamp': '1394524458'
| price_units': '$'
|
| returns empty dict on Error
|
@@ -154,7 +157,8 @@ CLASSES
| get_setting_data(self)
| get settings data
|
| returns empty dict on Error
| On Success returns dict with value containing setting
| relating to price, uploader, network & device
|
| get_summation_values(self, macid=None, interval='day')
| Send the GET_SUMMATION_VALUES command
@@ -168,20 +172,20 @@ CLASSES
| get time source for device
|
| On Success returns dict with value 'internet' or 'meter' :
| 'time_source': 'internet'}
| 'time_source': 'internet'
|
| get_timezone(self)
| get current timezone configuration
|
| On Success returns dict with the value :
| 'timezone_localTime': '1394527011'
| 'timezone_olsonName': 'UTC/GMT',
| 'timezone_olsonName': 'UTC/GMT'
| 'timezone_status': '2'
| 'timezone_utcOffset': 'UTC'
| 'timezone_utcTime': '1394527011'
| 'timezone_status': 'success'
|
| get_uploader()
| get_uploader(self)
| gets current uploaders config
|
| On Success returns dict with the values (example):
@@ -209,8 +213,32 @@ CLASSES
| 'uploader_name[1]': 'Bidgely Inc.'
|
| get_usage_data(self)
| Get current demand usage summation
|
| On Success returns dict with the values (example):
| 'demand' : '0.4980'
| 'demand_timestamp' : '1394505386'
| 'demand_units' : 'kW'
| 'message_confirm_required' : 'N'
| 'message_confirmed' : 'N'
| 'message_id' : '0'
| 'message_priority' : ''
| 'message_queue' : active'
| 'message_read' : 'Y'
| 'message_text' : ''
| 'message_timestamp' : '946684800'
| 'meter_status' : 'Connected'
| 'price' : '0.1400'
| 'price_label' : 'Set by User'
| 'price_units' : '$'
| 'summation_delivered' : '2667.867'
| 'summation_received' : '37.283'
| 'summation_units' : 'kWh'
| 'usage_timestamp' : '1394505386'
|
| list_devices(self)
| Send the LIST_DEVICES command
| returns information about the EAGLE device
|
| set_cloud(self, url, authcode='', email='')
| set cloud Url
@@ -273,18 +301,36 @@ CLASSES
| On Error returns dict with value :
| 'set_time_source_status': 'invalid source name'
|
| ----------------------------------------------------------------------
| Data descriptors defined here:
|
| __dict__
| dictionary for instance variables (if defined)
|
| __weakref__
| list of weak references to the object (if defined)
class RainEagleResponseError(exceptions.RuntimeError)
| General exception for responce errors
| from Rainforest Automation EAGLE (RFA-Z109)
|
| Method resolution order:
| RainEagleResponseError
| exceptions.RuntimeError
| exceptions.StandardError
| exceptions.Exception
| exceptions.BaseException
| __builtin__.object
|

DATA
__all__ = ['Eagle', 'RainEagleResponseError', 'to_epoch_1970, to_epoch...
__author__ = 'Peter Shipley <peter.shipley@gmail.com>'
__copyright__ = 'Copyright (C) 2014 Peter Shipley'
__license__ = 'BSD'
__version__ = '0.1.7'

VERSION
0.1.7

AUTHOR
Peter Shipley <peter.shipley@gmail.com>


Loading…
Cancel
Save