foxesscloud 2.9.4__tar.gz → 2.9.6__tar.gz

{foxesscloud-2.9.4 → foxesscloud-2.9.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.4
+Version: 2.9.6
 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
@@ -139,6 +139,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -496,7 +497,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -506,6 +507,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -830,6 +832,17 @@ This setting can be:
 
 # Version Info
 
+2.9.6 - 2026/03/10<br>
+Fix problem setting fdsoc and fdpwr from segment for set_period().
+Correctly identify H1-G2 model inverter.
+Add maxChargeCurrent and maxDischargeCurrent to f.battery.
+Update battery charge derating with temperature so charge current is not 0.
+
+
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.

foxesscloud-2.9.4/src/foxesscloud.egg-info/PKG-INFO → foxesscloud-2.9.6/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.1
-Name: foxesscloud
-Version: 2.9.4
-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
-Project-URL: Bug Tracker, https://github.com/TonyM1958/FoxESS-Cloud/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENCE
-
 # FoxESS-Cloud
 
 <a href="https://www.buymeacoffee.com/tonym1958" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174" align="right"></a>
@@ -139,6 +125,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -496,7 +483,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -506,6 +493,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -830,6 +818,17 @@ This setting can be:
 
 # Version Info
 
+2.9.6 - 2026/03/10<br>
+Fix problem setting fdsoc and fdpwr from segment for set_period().
+Correctly identify H1-G2 model inverter.
+Add maxChargeCurrent and maxDischargeCurrent to f.battery.
+Update battery charge derating with temperature so charge current is not 0.
+
+
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.

{foxesscloud-2.9.4 → foxesscloud-2.9.6}/pyproject.toml

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

{foxesscloud-2.9.4 → foxesscloud-2.9.6}/src/foxesscloud/foxesscloud.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  18 January 2026
+Updated:  05 March 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2023
 ##################################################################################################
 
-version = "1.11.0"
+version = "1.11.2"
 print(f"FoxESS-Cloud version {version}")
 
 debug_setting = 1
@@ -502,6 +502,9 @@ def get_device(sn=None, device_type=None):
         model_code = 'EVO-' + model_code[4:]
     parts = model_code.split('-')
     model = parts[0]
+    if parts[-1] == 'G2':
+        parts[0] += 'G2'
+        del parts[-1]
     device['eps'] = ('E' in parts[-1]) or (model == 'EVO' and 'H' in parts[-1])
     if model not in ['F1', 'G1', 'R3', 'S1', 'T3', 'KH', 'H1', 'AC1', 'H3', 'AC3', 'AIOH1', 'AIOH3', 'EVO']:
         output(f"** device model not recognised for deviceType: {device['deviceType']}")
@@ -3821,7 +3824,7 @@ def battery_monitor(interval=30, run=48, log=1, count=None, save=None, overwrite
 # span: 'week', 'month' or 'year' generated dates that span a week, month or year
 # quiet: do not print results if True
 
-def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True):
+def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True, step=1):
     global debug_setting
     latest_date = datetime.date(datetime.now())
     today = 0 if today == False else 1 if today == True else today
@@ -3830,7 +3833,6 @@ def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet =
     first = datetime.date(datetime.strptime(s, '%Y-%m-%d')) if type(s) is str else s.date() if s is not None else None
     last = datetime.date(datetime.strptime(e, '%Y-%m-%d')) if type(e) is str else e.date() if e is not None else None
     last = latest_date if last is not None and last > latest_date and today != 2 else last
-    step = 1
     if first is None and last is None:
         last = latest_date
     if span is not None:

{foxesscloud-2.9.4 → foxesscloud-2.9.6}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  19 January 2025
+Updated:  10 March 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2024
 ##################################################################################################
 
-version = "2.9.4"
+version = "2.9.6"
 print(f"FoxESS-Cloud Open API version {version}")
 
 debug_setting = 1
@@ -515,6 +515,9 @@ def get_device(sn=None, device_type=None):
         model_code = 'EVO-' + model_code[4:]
     parts = model_code.split('-')
     model = parts[0]
+    if parts[-1] == 'G2':
+        parts[0] += 'G2'
+        del parts[-1]
     device['eps'] = ('E' in parts[-1]) or (model == 'EVO' and 'H' in parts[-1])
     if model not in ['F1', 'G1', 'R3', 'S1', 'T3', 'KH', 'H1', 'AC1', 'H3', 'AC3', 'AIOH1', 'AIOH3', 'EVO']:
         output(f"** device model not recognised for deviceType: {device['deviceType']}")
@@ -574,8 +577,8 @@ def get_generation(update=1):
 battery = None
 batteries = None
 battery_settings = None
-battery_vars = ['SoC', 'invBatVolt', 'invBatCurrent', 'invBatPower', 'batTemperature', 'ResidualEnergy','SOH','energyThroughput' ]
-battery_data = ['soc', 'volt', 'current', 'power', 'temperature', 'residual', 'soh', 'throughput']
+battery_vars = ['SoC', 'invBatVolt', 'invBatCurrent', 'invBatPower', 'batTemperature', 'ResidualEnergy','SOH','energyThroughput', 'maxChargeCurrent', 'maxDischargeCurrent' ]
+battery_data = ['soc', 'volt', 'current', 'power', 'temperature', 'residual', 'soh', 'throughput', 'maxChargeCurrent', 'maxDischargeCurrent']
 
 # 1 = Residual Energy, 2 = Residual Capacity (HV), 3 = Residual Capacity per battery (Mira)
 residual_handling = 0
@@ -584,7 +587,7 @@ residual_handling = 0
 battery_params = {
 #    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],
+    1: {'table': [ 1, 5, 10, 15, 25, 50, 50, 50, 50, 50, 30, 20, 1],
         'step': 5,
         'offset': 5,
         'charge_loss': 0.974,
@@ -592,7 +595,7 @@ battery_params = {
 # 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],
+    2: {'table': [ 1, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  1],
         'step': 5,
         'offset': 11,
         'charge_loss': 1.08,
@@ -600,7 +603,7 @@ battery_params = {
 # 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],
+    3: {'table': [ 1, 5, 10, 15, 25, 50, 50, 50, 50, 25, 20,  3,  1],
         'step': 5,
         'offset': 11,
         'charge_loss': 0.974,
@@ -1151,7 +1154,7 @@ max_periods = 8
 
 # get the current switch status
 def get_flag():
-    global device_sn, schedule, debug_setting
+    global device_sn, schedule, debug_setting, max_periods
     if get_device() is None:
         return None
     output(f"getting flag", 2)
@@ -1169,6 +1172,17 @@ def get_flag():
     schedule['support'] = result.get('support')
     if device.get('function') is not None and device['function'].get('scheduler') is not None:
         device['function']['scheduler'] = schedule['support']
+    if schedule.get('maxGroupCount') is None:
+        output(f"getting maxGroupCount", 2)
+        body = {'deviceSN': device_sn}
+        response = signed_post(path="/op/v3/device/scheduler/get", body=body)
+        if response.status_code != 200:
+            output(f"** get_flag() got response code getting maxGroupCount {response.status_code}: {response.reason}")
+            return None
+        result = response.json().get('result')
+        if result is not None:
+            schedule['maxGroupCount'] = result.get('maxGroupCount')
+            max_periods = schedule['maxGroupCount']
     return schedule
 
 ##################################################################################################
@@ -1242,8 +1256,8 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
         mode = segment.get('mode')
         min_soc = segment.get('min_soc')
         max_soc = segment.get('max_soc')
-        fdsoc = segment.get('fdSoc')
-        fdpwr = segment.get('fdPwr')
+        fdsoc = segment.get('fdsoc')
+        fdpwr = segment.get('fdpwr')
         import_limit = segment.get('import_limit')
         export_limit = segment.get('export_limit')
         price = segment.get('price')
@@ -2944,7 +2958,7 @@ def charge_needed(forecast=None, consumption=None, update_settings=0, timed_mode
     reserve = capacity * min_soc / 100
     # charge current may be derated based on temperature
     charge_current = device_current if charge_config['charge_current'] is None else charge_config['charge_current']
-    if bms_charge_current is not None and charge_current > bms_charge_current:
+    if bms_charge_current is not None and bms_charge_current < charge_current:
         charge_current = bms_charge_current
     volt_curve = charge_config['volt_curve']
     nominal_soc = charge_config['nominal_soc']
@@ -2965,10 +2979,6 @@ def charge_needed(forecast=None, consumption=None, update_settings=0, timed_mode
     output(f"  Resistance:  {bat_resistance:.2f} ohms")
     output(f"  Nominal OCV: {bat_ocv:.1f}V at {nominal_soc}% SoC")
     output(f"  Losses:      {charge_loss * 100:.1f}% charge / {discharge_loss * 100:.1f}% discharge", 2)
-    # charge current may be derated based on temperature
-    charge_current = device_current if charge_config['charge_current'] is None else charge_config['charge_current']
-    if charge_current > bms_charge_current:
-        charge_current = bms_charge_current
     # inverter losses
     inverter_power = charge_config['inverter_power'] if charge_config['inverter_power'] is not None else round(device_power, 0) * 25
     operating_loss = inverter_power / 1000
@@ -3620,7 +3630,7 @@ def battery_monitor(interval=30, run=48, log=1, count=None, save=None, overwrite
 # span: 'week', 'month' or 'year' generated dates that span a week, month or year
 # quiet: do not print results if True
 
-def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True):
+def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True, step=1):
     global debug_setting
     latest_date = datetime.date(datetime.now())
     today = 0 if today == False else 1 if today == True else today
@@ -3629,7 +3639,6 @@ def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet =
     first = datetime.date(datetime.strptime(s, '%Y-%m-%d')) if type(s) is str else s.date() if s is not None else None
     last = datetime.date(datetime.strptime(e, '%Y-%m-%d')) if type(e) is str else e.date() if e is not None else None
     last = latest_date if last is not None and last > latest_date and today != 2 else last
-    step = 1
     if first is None and last is None:
         last = latest_date
     if span is not None:

foxesscloud-2.9.4/README.md → foxesscloud-2.9.6/src/foxesscloud.egg-info/PKG-INFO

@@ -1,3 +1,17 @@
+Metadata-Version: 2.1
+Name: foxesscloud
+Version: 2.9.6
+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
+Project-URL: Bug Tracker, https://github.com/TonyM1958/FoxESS-Cloud/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENCE
+
 # FoxESS-Cloud
 
 <a href="https://www.buymeacoffee.com/tonym1958" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174" align="right"></a>
@@ -125,6 +139,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -482,7 +497,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -492,6 +507,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -816,6 +832,17 @@ This setting can be:
 
 # Version Info
 
+2.9.6 - 2026/03/10<br>
+Fix problem setting fdsoc and fdpwr from segment for set_period().
+Correctly identify H1-G2 model inverter.
+Add maxChargeCurrent and maxDischargeCurrent to f.battery.
+Update battery charge derating with temperature so charge current is not 0.
+
+
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.