| @@ -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> | |||