foxesscloud 2.9.5__tar.gz → 2.9.7__tar.gz

{foxesscloud-2.9.5/src/foxesscloud.egg-info → foxesscloud-2.9.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.5
+Version: 2.9.7
 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
@@ -182,8 +182,9 @@ set_period() returns a period structure that can be used to build a list for set
 + max_soc: optional, default is 100
 + fdsoc: optional, default is 10. Used when setting a period with ForceDischarge mode
 + fdpwr: optional, default is 0. Used when setting a period with ForceDischarge mode
-+ import_limit: optional, default is None (not set). Used when setting a period with ForceCharge mode
-+ export_limit: optional, default is None (not set). Used when setting a period with ForceDischarge mode
++ import_limit: optional, default is None (not set) but set to 0 if the mode is force discharge
++ export_limit: optional, default is None (not set).
++ pv_limit: optional, default is 1.5 x inverter rating.
 + price: optional, default None. Used to display plunge pricing for time period.
 + enable: sets whether this time segment is enable (1) or disabled (0). The default is enabled.
 + segment: optional, allows the parameters for the period to be passed as a dictionary instead of individual values.
@@ -832,6 +833,16 @@ This setting can be:
 
 # Version Info
 
+2.9.7 - 2026/03/18<br>
+Add pv_limit to set_period().
+Default import_linit to 0 for force discharge in set_period()
+
+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.

{foxesscloud-2.9.5 → foxesscloud-2.9.7}/README.md

@@ -168,8 +168,9 @@ set_period() returns a period structure that can be used to build a list for set
 + max_soc: optional, default is 100
 + fdsoc: optional, default is 10. Used when setting a period with ForceDischarge mode
 + fdpwr: optional, default is 0. Used when setting a period with ForceDischarge mode
-+ import_limit: optional, default is None (not set). Used when setting a period with ForceCharge mode
-+ export_limit: optional, default is None (not set). Used when setting a period with ForceDischarge mode
++ import_limit: optional, default is None (not set) but set to 0 if the mode is force discharge
++ export_limit: optional, default is None (not set).
++ pv_limit: optional, default is 1.5 x inverter rating.
 + price: optional, default None. Used to display plunge pricing for time period.
 + enable: sets whether this time segment is enable (1) or disabled (0). The default is enabled.
 + segment: optional, allows the parameters for the period to be passed as a dictionary instead of individual values.
@@ -818,6 +819,16 @@ This setting can be:
 
 # Version Info
 
+2.9.7 - 2026/03/18<br>
+Add pv_limit to set_period().
+Default import_linit to 0 for force discharge in set_period()
+
+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.

{foxesscloud-2.9.5 → foxesscloud-2.9.7}/pyproject.toml

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

{foxesscloud-2.9.5 → foxesscloud-2.9.7}/src/foxesscloud/foxesscloud.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  11 February 2026
+Updated:  18 March 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2023
 ##################################################################################################
 
-version = "1.11.1"
+version = "1.11.3"
 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']}")
@@ -1475,7 +1478,7 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
     if quiet == 0:
         s = f"   {hours_time(start)}-{hours_time(end)} {mode}, minsoc {min_soc}%"
         s += f", maxsoc {max_soc}%" if max_soc is not None and 'ForceCharge' in mode else ""
-        s += f", fdPwr {fdpwr}W, fdSoC {fdsoc}%" if ('ForceCharge' in mod or 'ForceDischarge' in mode) else ""
+        s += f", fdPwr {fdpwr}W, fdSoC {fdsoc}%" if ('ForceCharge' in mode or 'ForceDischarge' in mode) else ""
         s += f", {price:.2f}p/kWh" if price is not None else ""
         output(s, 1)
     start_h, start_m = split_hours(start)

{foxesscloud-2.9.5 → foxesscloud-2.9.7}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  27 February 2026
+Updated:  18 March 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2024
 ##################################################################################################
 
-version = "2.9.5"
+version = "2.9.7"
 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,
@@ -1243,7 +1246,7 @@ def build_strategy_from_schedule():
 ##################################################################################################
 
 # create time segment structure. Note: end time is exclusive.
-def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdsoc=None, fdpwr=None, import_limit=None, export_limit=None, price=None, segment=None, enable=1, quiet=1):
+def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdsoc=None, fdpwr=None, import_limit=None, export_limit=None, pv_limit=None, price=None, segment=None, enable=1, quiet=1):
     global schedule, device
     if schedule is None or schedule.get('maxsoc') is None:
         get_schedule()
@@ -1253,10 +1256,11 @@ 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')
+        pv_limit = segment.get('pv_limit')
         price = segment.get('price')
     start = time_hours(start)
     # adjust exclusive time to inclusive
@@ -1276,6 +1280,8 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
     fdsoc = min_soc if fdsoc is None else fdsoc
     power = (device['power'] * 1000) if device.get('power') is not None else None
     fdpwr = power if fdpwr is None and device.get('power') is not None and ('ForceCharge' in mode or 'ForceDischarge' in mode) else fdpwr
+    pv_limit = int(1.5 * power) if pv_limit is None and device.get('power') is not None and ('ForceCharge' in mode or 'ForceDischarge' in mode) else pv_limit
+    import_limit = 0 if import_limit is None and 'ForceDischarge' in mode else import_limit
     fdpwr = 0 if fdpwr is None else fdpwr
     if min_soc < 0 or min_soc > 100:
         output(f"set_period(): ** min_soc must be between 0 and 100")
@@ -1292,14 +1298,17 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
     if quiet == 0:
         s = f"   {hours_time(start)}-{hours_time(end)} {mode}, minsoc {min_soc}%"
         s += f", maxsoc {max_soc}%" if max_soc is not None and 'ForceCharge' in mode else ""
-        s += f", fdPwr {fdpwr}W, fdSoC {fdsoc}%" if ('ForceCharge' in mode or 'ForceDischarge' in mode) else ""
+        s += f", fdPwr {int(fdpwr)}W, fdSoC {fdsoc}%" if ('ForceCharge' in mode or 'ForceDischarge' in mode) else ""
+        s += f", exportLimit {int(export_limit)}W" if export_limit is not None else ""
+        s += f", importLimit {int(import_limit)}W" if import_limit is not None else ""
+        s += f", pvLimit {int(pv_limit)}W" if pv_limit is not None else ""
         s += f", {price:.2f}p/kWh" if price is not None else ""
         output(s, 1)
     start_hour, start_minute = split_hours(start)
     end_hour, end_minute = split_hours(end)
     period = {'enable': enable, 'startHour': start_hour, 'startMinute': start_minute, 'endHour': end_hour, 'endMinute': end_minute, 'workMode': mode,
         'extraParam': {'minSocOnGrid': int(min_soc), 'fdSoc': int(fdsoc), 'fdPwr': int(fdpwr), 'maxSoc': max_soc, 'importLimit': import_limit,
-        'exportLimit': export_limit }}
+        'exportLimit': export_limit, 'pvLimit': pv_limit}}
     return period
 
 # set a schedule from a period or list of time segment periods
@@ -2955,7 +2964,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']
@@ -2976,10 +2985,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

{foxesscloud-2.9.5 → foxesscloud-2.9.7/src/foxesscloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.5
+Version: 2.9.7
 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
@@ -182,8 +182,9 @@ set_period() returns a period structure that can be used to build a list for set
 + max_soc: optional, default is 100
 + fdsoc: optional, default is 10. Used when setting a period with ForceDischarge mode
 + fdpwr: optional, default is 0. Used when setting a period with ForceDischarge mode
-+ import_limit: optional, default is None (not set). Used when setting a period with ForceCharge mode
-+ export_limit: optional, default is None (not set). Used when setting a period with ForceDischarge mode
++ import_limit: optional, default is None (not set) but set to 0 if the mode is force discharge
++ export_limit: optional, default is None (not set).
++ pv_limit: optional, default is 1.5 x inverter rating.
 + price: optional, default None. Used to display plunge pricing for time period.
 + enable: sets whether this time segment is enable (1) or disabled (0). The default is enabled.
 + segment: optional, allows the parameters for the period to be passed as a dictionary instead of individual values.
@@ -832,6 +833,16 @@ This setting can be:
 
 # Version Info
 
+2.9.7 - 2026/03/18<br>
+Add pv_limit to set_period().
+Default import_linit to 0 for force discharge in set_period()
+
+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.