foxesscloud 2.9.6__tar.gz → 2.9.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.6
+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,13 +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.6 → 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,13 +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.6 → foxesscloud-2.9.7}/pyproject.toml

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

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

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  05 March 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.2"
+version = "1.11.3"
 print(f"FoxESS-Cloud version {version}")
 
 debug_setting = 1
@@ -1478,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.6 → foxesscloud-2.9.7}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  10 March 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.6"
+version = "2.9.7"
 print(f"FoxESS-Cloud Open API version {version}")
 
 debug_setting = 1
@@ -1246,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()
@@ -1260,6 +1260,7 @@ def set_period(start=None, end=None, mode=None, min_soc=None, max_soc=None, fdso
         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
@@ -1279,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")
@@ -1295,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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.6
+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,13 +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.