foxesscloud 2.7.7__tar.gz → 2.8.0__tar.gz

{foxesscloud-2.7.7/src/foxesscloud.egg-info → foxesscloud-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.7.7
+Version: 2.8.0
 Summary: library for accessing Fox ESS cloud data using Open API
 Author-email: Tony Matthews <tony@quasair.co.uk>
 Project-URL: Homepage, https://github.com/TonyM1958/FoxESS-Cloud
@@ -358,7 +358,9 @@ All the parameters are optional:
 
 charge_needed() uses a number of models to better estimate the state of the battery.
 
-**Manual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
+**Manual Consumption:** You can provide your expected 'consumption' in kWh e.g. 15. This figure is used directly.
+
+**Annual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
 
 **Historic Consumption:** If annual_consumption is not provided, your consumption history is used. By default, this looks at your average consumption for the last 3 days using the load power reported by your inverter. For systems with multiple inverters where CT2 is not connected, the load power may not be correct. For this and other cases where you want to set your consumption, provide your annual_consumption.
 
@@ -807,6 +809,18 @@ This setting can be:
 
 # Version Info
 
+2.8.0<br>
+Update from v0 to v1 for scheduler API.
+PVEnergyTotal added to report variables.
+Fix residual if capacity is specified for charge_needed().
+
+2.7.9<br>
+Add 'consumption' input for charge_needed().
+Avoid throwing exception in battery_info() if there is no capacity info.
+
+2.7.8<br>
+Update the battery_params charge rate table to 2025 values.
+
 2.7.7<br>
 Updates to get_pvoutput() to support solar inverters that don't provide grid energy by setting tou=2.
 Default tariff changed to None.

{foxesscloud-2.7.7 → foxesscloud-2.8.0}/README.md

@@ -344,7 +344,9 @@ All the parameters are optional:
 
 charge_needed() uses a number of models to better estimate the state of the battery.
 
-**Manual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
+**Manual Consumption:** You can provide your expected 'consumption' in kWh e.g. 15. This figure is used directly.
+
+**Annual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
 
 **Historic Consumption:** If annual_consumption is not provided, your consumption history is used. By default, this looks at your average consumption for the last 3 days using the load power reported by your inverter. For systems with multiple inverters where CT2 is not connected, the load power may not be correct. For this and other cases where you want to set your consumption, provide your annual_consumption.
 
@@ -793,6 +795,18 @@ This setting can be:
 
 # Version Info
 
+2.8.0<br>
+Update from v0 to v1 for scheduler API.
+PVEnergyTotal added to report variables.
+Fix residual if capacity is specified for charge_needed().
+
+2.7.9<br>
+Add 'consumption' input for charge_needed().
+Avoid throwing exception in battery_info() if there is no capacity info.
+
+2.7.8<br>
+Update the battery_params charge rate table to 2025 values.
+
 2.7.7<br>
 Updates to get_pvoutput() to support solar inverters that don't provide grid energy by setting tou=2.
 Default tariff changed to None.

{foxesscloud-2.7.7 → foxesscloud-2.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "foxesscloud"
-version = "2.7.7"
+version = "2.8.0"
 authors = [
   {name="Tony Matthews", email="tony@quasair.co.uk"},
 ]

{foxesscloud-2.7.7 → foxesscloud-2.8.0}/src/foxesscloud/foxesscloud.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  11 January 2025
+Updated:  12 March 2025
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2023
 ##################################################################################################
 
-version = "1.8.8"
+version = "1.9.2"
 print(f"FoxESS-Cloud version {version}")
 
 debug_setting = 1
@@ -590,32 +590,37 @@ battery_settings = None
 
 # 1 = Residual Energy, 2 = Residual Capacity (HV), 3 = Residual Capacity per battery (Mira)
 residual_handling = 1
+residual_scale = 0.01
 
-# charge rates based on residual_handling
+# charge rates based on residual_handling. Index is bms temperature
 battery_params = {
-#    cell temp    -5  0   5  10  15  20  25  30  35  40  45  50 55
 #    bms temp      5 10  15  20  25  30  35  40  45  50  55  60 65 
+#    cell temp    -5  0   5  10  15  20  25  30  35  40  45  50 55
     1: {'table': [ 0, 2, 10, 15, 25, 50, 50, 50, 50, 50, 30, 20, 0],
         'step': 5,
         'offset': 5,
         'charge_loss': 0.974,
         'discharge_loss': 0.974},
-    # HV BMS v2 with firmware 1.014 or later
-    2: {'table': [ 0, 2, 10, 10, 15, 15, 25, 50, 50, 50, 30, 20, 0],
+# HV BMS v2 with firmware 1.014 or later
+#    bms temp     10 15  20  25  30  35  40  45  50  55  60  65  70 
+#    cell temp     0  5  10  15  20  25  30  35  40  45  50  55  60
+    2: {'table': [ 0, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  0],
         'step': 5,
-        'offset': 5,
+        'offset': 11,
         'charge_loss': 1.08,
         'discharge_loss': 0.95},
-    # Mira BMS with firmware 1.014 or later
-    3: {'table': [ 0, 2, 10, 10, 15, 15, 25, 50, 50, 50, 30, 20, 0],
+# Mira BMS with firmware 1.014 or later
+#    bms temp     10 15  20  25  30  35  40  45  50  55  60  65  70 
+#    cell temp     0  5  10  15  20  25  30  35  40  45  50  55  60
+    3: {'table': [ 0, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  0],
         'step': 5,
-        'offset': 5,
+        'offset': 11,
         'charge_loss': 0.974,
         'discharge_loss': 0.974},
 }
 
 def get_battery(info=1, rated=None, count=None):
-    global device_id, battery, debug_setting, messages, residual_handling, battery_params
+    global device_id, battery, debug_setting, messages, residual_handling, battery_params, residual_scale
     if get_device() is None:
         return None
     output(f"getting battery", 2)
@@ -655,7 +660,7 @@ def get_battery(info=1, rated=None, count=None):
         output(f"** get_battery(): battery status not available")
         return None
     if battery.get('residual') is not None:
-        battery['residual'] /= 1000
+        battery['residual'] *= residual_scale / 10
     if battery['residual_handling'] == 2:
         capacity = battery.get('residual')
         soc = battery.get('soc')
@@ -1822,7 +1827,7 @@ def rescale_history(data, steps):
 # station = 0: use device_id, 1 = use station_id
 ##################################################################################################
 
-report_vars = ['yield', 'input','generation', 'feedin', 'loads', 'gridConsumption', 'chargeEnergyToTal', 'dischargeEnergyToTal']
+report_vars = ['PVEnergyTotal', 'input','generation', 'feedin', 'loads', 'gridConsumption', 'chargeEnergyToTal', 'dischargeEnergyToTal']
 report_names = ['PV Yield', 'Input', 'Generation', 'Grid Export', 'Consumption', 'Grid Import', 'Battery Charge', 'Battery Discharge']
 
 # fix power values after fox corrupts high word of 32-bit energy total
@@ -2953,6 +2958,7 @@ charge_needed_app_key = "awcr5gro2v13oher3v1qu6hwnovp28"
 
 # work out the charge times to set using the parameters:
 #  forecast: the kWh expected tomorrow. If none, forecast data is loaded from solcast etc
+#  consumption: the kWh consumed. If none, consumption is loaded from history
 #  update_settings: 0 no updates, 1 update charge settings. The default is 0
 #  show_data: 1 shows battery SoC, 2 shows battery residual. Default = 0
 #  show_plot: 1 plots battery SoC, 2 plots battery residual. Default = 1
@@ -2960,7 +2966,7 @@ charge_needed_app_key = "awcr5gro2v13oher3v1qu6hwnovp28"
 #  forecast_times: list of hours when forecast can be fetched (UTC)
 #  force_charge: 1 = hold battery, 2 = charge for whole period
 
-def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=None, show_plot=None, run_after=None, reload=2,
+def charge_needed(forecast=None, consumption=None, update_settings=0, timed_mode=None, show_data=None, show_plot=None, run_after=None, reload=2,
         forecast_times=None, force_charge=0, test_time=None, test_soc=None, test_charge=None, **settings):
     global device, seasonality, solcast_api_key, debug_setting, tariff, solar_arrays, legend_location, time_shift, charge_needed_app_key
     global timed_strategy, steps_per_hour, base_time, storage, battery, battery_params
@@ -3088,7 +3094,10 @@ def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=N
         bat_current = battery['current']
         temperature = battery['temperature']
         residual = battery['residual']
-        capacity = charge_config['capacity'] if charge_config.get('capacity') is not None else battery.get('capacity')
+        capacity = battery.get('capacity')
+        if charge_config.get('capacity') is not None:
+            capacity = charge_config['capacity']
+            residual = (capacity * current_soc / 100) if capacity is not None and current_soc is not None else None
         if capacity is None:
             output(f"Battery capacity could not be estimated. Please add the parameter 'capacity=xx' in kWh")
             return None
@@ -3172,6 +3181,9 @@ def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=N
         consumption = annual_consumption / 365 * seasonality[now.month - 1] / sum(seasonality) * 12
         consumption_by_hour = daily_consumption
         output(f"\nEstimated consumption: {consumption:.1f}kWh")
+    elif consumption is not None:
+        consumption_by_hour = daily_consumption
+        output(f"\nConsumption: {consumption:.1f}kWh")
     else:
         consumption_days = charge_config['consumption_days']
         consumption_days = 3 if consumption_days > 7 or consumption_days < 1 else consumption_days
@@ -3633,7 +3645,7 @@ def battery_info(log=0, plot=1, rated=None, count=None, info=1, bat=None):
     bat_current = bat['current']
     bat_power = bat['power']
     bms_temperature = bat['temperature']
-    capacity = bat['capacity']
+    capacity = bat.get('capacity')
     cell_volts = get_cell_volts()
     if cell_volts is None:
         output_close()
@@ -3678,7 +3690,8 @@ def battery_info(log=0, plot=1, rated=None, count=None, info=1, bat=None):
                     s +=f",{v:.0f}"
         return s
     output(f"Current SoC:         {current_soc}%")
-    output(f"Capacity:            {capacity:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [1,3] else ""))
+    if capacity is not None:
+        output(f"Capacity:            {capacity:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [1,3] else ""))
     output(f"Residual:            {residual:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [2,3] else ""))
     if rated_capacity is not None and bat_soh is not None:
         output(f"Rated Capacity:      {rated_capacity / 1000:.2f}kWh")

{foxesscloud-2.7.7 → foxesscloud-2.8.0}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  11 January 2025
+Updated:  12 March 2025
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2024
 ##################################################################################################
 
-version = "2.7.7"
+version = "2.8.0"
 print(f"FoxESS-Cloud Open API version {version}")
 
 debug_setting = 1
@@ -555,25 +555,29 @@ battery_data = ['soc', 'volt', 'current', 'power', 'temperature', 'residual']
 # 1 = Residual Energy, 2 = Residual Capacity (HV), 3 = Residual Capacity per battery (Mira)
 residual_handling = 1
 
-# charge rates based on residual_handling
+# charge rates based on residual_handling. Index is bms temperature
 battery_params = {
-#    cell temp    -5  0   5  10  15  20  25  30  35  40  45  50 55
 #    bms temp      5 10  15  20  25  30  35  40  45  50  55  60 65 
+#    cell temp    -5  0   5  10  15  20  25  30  35  40  45  50 55
     1: {'table': [ 0, 2, 10, 15, 25, 50, 50, 50, 50, 50, 30, 20, 0],
         'step': 5,
         'offset': 5,
         'charge_loss': 0.974,
         'discharge_loss': 0.974},
-    # HV BMS v2 with firmware 1.014 or later
-    2: {'table': [ 0, 2, 10, 10, 15, 15, 25, 50, 50, 50, 30, 20, 0],
+# HV BMS v2 with firmware 1.014 or later
+#    bms temp     10 15  20  25  30  35  40  45  50  55  60  65  70 
+#    cell temp     0  5  10  15  20  25  30  35  40  45  50  55  60
+    2: {'table': [ 0, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  0],
         'step': 5,
-        'offset': 5,
+        'offset': 11,
         'charge_loss': 1.08,
         'discharge_loss': 0.95},
-    # Mira BMS with firmware 1.014 or later
-    3: {'table': [ 0, 2, 10, 10, 15, 15, 25, 50, 50, 50, 30, 20, 0],
+# Mira BMS with firmware 1.014 or later
+#    bms temp     10 15  20  25  30  35  40  45  50  55  60  65  70 
+#    cell temp     0  5  10  15  20  25  30  35  40  45  50  55  60
+    3: {'table': [ 0, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  0],
         'step': 5,
-        'offset': 5,
+        'offset': 11,
         'charge_loss': 0.974,
         'discharge_loss': 0.974},
 }
@@ -1006,7 +1010,7 @@ def get_flag():
         return None
     output(f"getting flag", 2)
     body = {'deviceSN': device_sn}
-    response = signed_post(path="/op/v0/device/scheduler/get/flag", body=body)
+    response = signed_post(path="/op/v1/device/scheduler/get/flag", body=body)
     if response.status_code != 200:
         output(f"** get_flag() got response code {response.status_code}: {response.reason}")
         return None
@@ -1036,7 +1040,7 @@ def get_schedule():
         return None
     output(f"getting schedule", 2)
     body = {'deviceSN': device_sn}
-    response = signed_post(path="/op/v0/device/scheduler/get", body=body)
+    response = signed_post(path="/op/v1/device/scheduler/get", body=body)
     if response.status_code != 200:
         output(f"** get_schedule() got response code {response.status_code}: {response.reason}")
         return None
@@ -1129,7 +1133,7 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
     period = {'enable': enable, 'startHour': start_hour, 'startMinute': start_minute, 'endHour': end_hour, 'endMinute': end_minute, 'workMode': mode,
         'minSocOnGrid': int(min_soc), 'fdSoc': int(fdsoc), 'fdPwr': int(fdpwr)}
     if max_soc is not None:
-        period['maxsoc'] = int(max_soc)
+        period['maxSoc'] = int(max_soc)
     return period
 
 # set a schedule from a period or list of time segment periods
@@ -1156,7 +1160,7 @@ def set_schedule(periods=None, enable=True):
             output(f"** set_schedule(): maximum of 8 periods allowed, {len(periods)} provided")
         body = {'deviceSN': device_sn, 'groups': periods[-8:]}
         setting_delay()
-        response = signed_post(path="/op/v0/device/scheduler/enable", body=body)
+        response = signed_post(path="/op/v1/device/scheduler/enable", body=body)
         if response.status_code != 200:
             output(f"** set_schedule() periods response code {response.status_code}: {response.reason}")
             return None
@@ -1167,7 +1171,7 @@ def set_schedule(periods=None, enable=True):
         schedule['periods'] = periods
     body = {'deviceSN': device_sn, 'enable': 1 if enable else 0}
     setting_delay()
-    response = signed_post(path="/op/v0/device/scheduler/set/flag", body=body)
+    response = signed_post(path="/op/v1/device/scheduler/set/flag", body=body)
     if response.status_code != 200:
         output(f"** set_schedule() flag response code {response.status_code}: {response.reason}")
         return None
@@ -1526,8 +1530,8 @@ def rescale_history(data, steps):
 # plot = 0: no plot, 1 = plot variables separately, 2 = combine variables
 ##################################################################################################
 
-report_vars = ['generation', 'feedin', 'loads', 'gridConsumption', 'chargeEnergyToTal', 'dischargeEnergyToTal']
-report_names = ['Generation', 'Grid Export', 'Consumption', 'Grid Import', 'Battery Charge', 'Battery Discharge']
+report_vars = ['generation', 'feedin', 'loads', 'gridConsumption', 'chargeEnergyToTal', 'dischargeEnergyToTal', 'PVEnergyTotal']
+report_names = ['Generation', 'Grid Export', 'Consumption', 'Grid Import', 'Battery Charge', 'Battery Discharge', 'PV Yield']
 
 # fix power values after corruption of high word of 32-bit energy total
 fix_values = 1
@@ -2624,6 +2628,7 @@ charge_needed_app_key = "awcr5gro2v13oher3v1qu6hwnovp28"
 
 # work out the charge times to set using the parameters:
 #  forecast: the kWh expected tomorrow. If none, forecast data is loaded from solcast etc
+#  consumption: the kWh consumed. If none, consumption is loaded from history
 #  update_settings: 0 no updates, 1 update charge settings. The default is 0
 #  show_data: 1 shows battery SoC, 2 shows battery residual. Default = 0
 #  show_plot: 1 plots battery SoC, 2 plots battery residual. Default = 1
@@ -2631,7 +2636,7 @@ charge_needed_app_key = "awcr5gro2v13oher3v1qu6hwnovp28"
 #  forecast_times: list of hours when forecast can be fetched (UTC)
 #  force_charge: 1 = hold battery, 2 = charge for whole period
 
-def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=None, show_plot=None, run_after=None, reload=2,
+def charge_needed(forecast=None, consumption=None, update_settings=0, timed_mode=None, show_data=None, show_plot=None, run_after=None, reload=2,
         forecast_times=None, force_charge=0, test_time=None, test_soc=None, test_charge=None, **settings):
     global device, seasonality, solcast_api_key, debug_setting, tariff, solar_arrays, legend_location, time_shift, charge_needed_app_key
     global timed_strategy, steps_per_hour, base_time, storage, battery, battery_params
@@ -2759,7 +2764,10 @@ def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=N
         bat_current = battery['current']
         temperature = battery['temperature']
         residual = battery['residual']
-        capacity = charge_config['capacity'] if charge_config.get('capacity') is not None else battery.get('capacity')
+        capacity = battery.get('capacity')
+        if charge_config.get('capacity') is not None:
+            capacity = charge_config['capacity']
+            residual = (capacity * current_soc / 100) if capacity is not None and current_soc is not None else None
         if capacity is None:
             output(f"Battery capacity could not be estimated. Please add the parameter 'capacity=xx' in kWh")
             return None
@@ -2847,6 +2855,9 @@ def charge_needed(forecast=None, update_settings=0, timed_mode=None, show_data=N
         consumption = annual_consumption / 365 * seasonality[now.month - 1] / sum(seasonality) * 12
         consumption_by_hour = daily_consumption
         output(f"\nEstimated consumption: {consumption:.1f}kWh")
+    elif consumption is not None:
+        consumption_by_hour = daily_consumption
+        output(f"\nConsumption: {consumption:.1f}kWh")
     else:
         consumption_days = charge_config['consumption_days']
         consumption_days = 3 if consumption_days > 7 or consumption_days < 1 else consumption_days
@@ -3305,7 +3316,7 @@ def battery_info(log=0, plot=1, rated=None, count=None, info=1, bat=None):
     bat_current = bat['current']
     bat_power = bat['power']
     bms_temperature = bat['temperature']
-    capacity = bat['capacity']
+    capacity = bat.get('capacity')
     cell_volts = get_cell_volts()
     if cell_volts is None:
         output_close()
@@ -3350,7 +3361,8 @@ def battery_info(log=0, plot=1, rated=None, count=None, info=1, bat=None):
                     s +=f",{v:.0f}"
         return s
     output(f"Current SoC:         {current_soc}%")
-    output(f"Capacity:            {capacity:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [1,3] else ""))
+    if capacity is not None:
+        output(f"Capacity:            {capacity:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [1,3] else ""))
     output(f"Residual:            {residual:.2f}kWh" + (" (calculated)" if bat['residual_handling'] in [2,3] else ""))
     if rated_capacity is not None and bat_soh is not None:
         output(f"Rated Capacity:      {rated_capacity / 1000:.2f}kWh")

{foxesscloud-2.7.7 → foxesscloud-2.8.0/src/foxesscloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.7.7
+Version: 2.8.0
 Summary: library for accessing Fox ESS cloud data using Open API
 Author-email: Tony Matthews <tony@quasair.co.uk>
 Project-URL: Homepage, https://github.com/TonyM1958/FoxESS-Cloud
@@ -358,7 +358,9 @@ All the parameters are optional:
 
 charge_needed() uses a number of models to better estimate the state of the battery.
 
-**Manual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
+**Manual Consumption:** You can provide your expected 'consumption' in kWh e.g. 15. This figure is used directly.
+
+**Annual Consumption:** You can provide your 'annual_consumption' in kWh e.g. 5500. This figure is factored down to a daily consumption by dividing by 365 and applying **f.seasonality**. This normally decreases consumption in the summer and increases it in winter. Seasonality is a list of weightings by month for Jan, Feb, Mar, Apr etc. Preset lists are 'f.high_seasonality' (recommend where electric heating is ued), 'f.medium_seasonality' (default) amd 'f.no_seasonality' (all months the same). The daily consumption is profiled by hour using **f.daily_consumption**. This maps your consumption for a day to the hours when more or less energy is consumed. It is a list of 24 values for the times 00, 01, 02, 03 .. 23. Preset lists are 'f.high_profile' (larger peaks at 8am and 6pm), 'f.medium_profile' (default, more balanced) and 'f.no_profile' (flat).
 
 **Historic Consumption:** If annual_consumption is not provided, your consumption history is used. By default, this looks at your average consumption for the last 3 days using the load power reported by your inverter. For systems with multiple inverters where CT2 is not connected, the load power may not be correct. For this and other cases where you want to set your consumption, provide your annual_consumption.
 
@@ -807,6 +809,18 @@ This setting can be:
 
 # Version Info
 
+2.8.0<br>
+Update from v0 to v1 for scheduler API.
+PVEnergyTotal added to report variables.
+Fix residual if capacity is specified for charge_needed().
+
+2.7.9<br>
+Add 'consumption' input for charge_needed().
+Avoid throwing exception in battery_info() if there is no capacity info.
+
+2.7.8<br>
+Update the battery_params charge rate table to 2025 values.
+
 2.7.7<br>
 Updates to get_pvoutput() to support solar inverters that don't provide grid energy by setting tou=2.
 Default tariff changed to None.