PySaxPower 1.0.1__tar.gz → 2.0.1__tar.gz

pysaxpower-2.0.1/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: PySaxPower
+Version: 2.0.1
+Summary: Python package to read and write data from/to SAX Power Home Plus batteries.
+Author: Hannes
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Hans-4/pysaxpower
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymodbus==3.15.0
+Dynamic: license-file
+
+# PySaxPower
+
+**Python package to read and write data from/to SAX Power Home Plus batteries.**
+
+---
+
+## Overview
+
+Here’s a more polished and concise version of your text with improved clarity, flow, and grammar:
+
+---
+
+With **PySaxPower**, you can read Modbus registers from **SAX Power Home Plus** batteries. 
+The package is divided into two protocol implementations: **SunSpec** and **Basic**. 
+The **Basic** protocol supports read-only operations. 
+View the [manual](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) for more informations.
+
+> **Note:**
+> Due to a firmware error in SAX devices, only the SunSpec protocol supports writing to registers.
+> To use this function, please ensure that at least firmware versions `Master V61` and `Gateway V54`, are installed on your battery. If this is not the case, you will need to update your firmware.
+> You have to contact the customer support for this.
+
+---
+
+## Supported Devices
+
+
+| **Device**                        | **Documentation**                                                                |
+| --------------------------------- |----------------------------------------------------------------------------------|
+| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/en/products/sax-power-home-plus-7-7-kwh/) |
+
+
+---
+
+## Installation
+
+```bash
+pip install PySaxPower
+```
+
+---
+
+## Usage
+
+### Sunspec
+
+#### Read register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+read_values = {
+    "Soc": register.CurrentSoC,
+    "Battery Power": register.ActivePower_Storage_Sum,
+    "Grid Power": register.ActiveGridPower,
+}
+
+values = device.get_formatted_values(read_values)
+```
+
+#### Write register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+write_values = {
+    register.ControlMode: 1
+}
+
+device.write_registers(write_values)
+```
+
+---
+
+### Basic
+```python
+from pysaxpower import PowerHomePlusBasic
+from pysaxpower import BasicRegister
+
+device = PowerHomePlusBasic("192.168.178.60")
+
+register = BasicRegister
+
+read_values = {
+    "Operating Mode": register.OperatingMode,
+    "Soc": register.SOC,
+    "Battery Power": register.ActivePower,
+    "Grid Power": register.GridPower,
+}
+
+values = device.get_values(read_values)
+print(values)
+
+device.close()
+```

pysaxpower-2.0.1/PySaxPower.egg-info/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: PySaxPower
+Version: 2.0.1
+Summary: Python package to read and write data from/to SAX Power Home Plus batteries.
+Author: Hannes
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Hans-4/pysaxpower
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymodbus==3.15.0
+Dynamic: license-file
+
+# PySaxPower
+
+**Python package to read and write data from/to SAX Power Home Plus batteries.**
+
+---
+
+## Overview
+
+Here’s a more polished and concise version of your text with improved clarity, flow, and grammar:
+
+---
+
+With **PySaxPower**, you can read Modbus registers from **SAX Power Home Plus** batteries. 
+The package is divided into two protocol implementations: **SunSpec** and **Basic**. 
+The **Basic** protocol supports read-only operations. 
+View the [manual](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) for more informations.
+
+> **Note:**
+> Due to a firmware error in SAX devices, only the SunSpec protocol supports writing to registers.
+> To use this function, please ensure that at least firmware versions `Master V61` and `Gateway V54`, are installed on your battery. If this is not the case, you will need to update your firmware.
+> You have to contact the customer support for this.
+
+---
+
+## Supported Devices
+
+
+| **Device**                        | **Documentation**                                                                |
+| --------------------------------- |----------------------------------------------------------------------------------|
+| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/en/products/sax-power-home-plus-7-7-kwh/) |
+
+
+---
+
+## Installation
+
+```bash
+pip install PySaxPower
+```
+
+---
+
+## Usage
+
+### Sunspec
+
+#### Read register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+read_values = {
+    "Soc": register.CurrentSoC,
+    "Battery Power": register.ActivePower_Storage_Sum,
+    "Grid Power": register.ActiveGridPower,
+}
+
+values = device.get_formatted_values(read_values)
+```
+
+#### Write register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+write_values = {
+    register.ControlMode: 1
+}
+
+device.write_registers(write_values)
+```
+
+---
+
+### Basic
+```python
+from pysaxpower import PowerHomePlusBasic
+from pysaxpower import BasicRegister
+
+device = PowerHomePlusBasic("192.168.178.60")
+
+register = BasicRegister
+
+read_values = {
+    "Operating Mode": register.OperatingMode,
+    "Soc": register.SOC,
+    "Battery Power": register.ActivePower,
+    "Grid Power": register.GridPower,
+}
+
+values = device.get_values(read_values)
+print(values)
+
+device.close()
+```

pysaxpower-2.0.1/PySaxPower.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+PySaxPower.egg-info/PKG-INFO
+PySaxPower.egg-info/SOURCES.txt
+PySaxPower.egg-info/dependency_links.txt
+PySaxPower.egg-info/requires.txt
+PySaxPower.egg-info/top_level.txt
+pysaxpower/__init__.py
+pysaxpower/basic_protocol/__init__.py
+pysaxpower/basic_protocol/basic_register.py
+pysaxpower/basic_protocol/power_home_plus_basic.py
+pysaxpower/sunspec/__init__.py
+pysaxpower/sunspec/power_home_plus_sunspec.py
+pysaxpower/sunspec/register.py
+pysaxpower/sunspec/scalefactors.py

pysaxpower-2.0.1/README.md

@@ -0,0 +1,103 @@
+# PySaxPower
+
+**Python package to read and write data from/to SAX Power Home Plus batteries.**
+
+---
+
+## Overview
+
+Here’s a more polished and concise version of your text with improved clarity, flow, and grammar:
+
+---
+
+With **PySaxPower**, you can read Modbus registers from **SAX Power Home Plus** batteries. 
+The package is divided into two protocol implementations: **SunSpec** and **Basic**. 
+The **Basic** protocol supports read-only operations. 
+View the [manual](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) for more informations.
+
+> **Note:**
+> Due to a firmware error in SAX devices, only the SunSpec protocol supports writing to registers.
+> To use this function, please ensure that at least firmware versions `Master V61` and `Gateway V54`, are installed on your battery. If this is not the case, you will need to update your firmware.
+> You have to contact the customer support for this.
+
+---
+
+## Supported Devices
+
+
+| **Device**                        | **Documentation**                                                                |
+| --------------------------------- |----------------------------------------------------------------------------------|
+| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/en/products/sax-power-home-plus-7-7-kwh/) |
+
+
+---
+
+## Installation
+
+```bash
+pip install PySaxPower
+```
+
+---
+
+## Usage
+
+### Sunspec
+
+#### Read register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+read_values = {
+    "Soc": register.CurrentSoC,
+    "Battery Power": register.ActivePower_Storage_Sum,
+    "Grid Power": register.ActiveGridPower,
+}
+
+values = device.get_formatted_values(read_values)
+```
+
+#### Write register
+```python
+from pysaxpower import PowerHomePlusSunspec
+from pysaxpower import SunSpecRegister
+
+device = PowerHomePlusSunspec("192.168.178.60")
+
+register = SunSpecRegister()
+
+write_values = {
+    register.ControlMode: 1
+}
+
+device.write_registers(write_values)
+```
+
+---
+
+### Basic
+```python
+from pysaxpower import PowerHomePlusBasic
+from pysaxpower import BasicRegister
+
+device = PowerHomePlusBasic("192.168.178.60")
+
+register = BasicRegister
+
+read_values = {
+    "Operating Mode": register.OperatingMode,
+    "Soc": register.SOC,
+    "Battery Power": register.ActivePower,
+    "Grid Power": register.GridPower,
+}
+
+values = device.get_values(read_values)
+print(values)
+
+device.close()
+```

{pysaxpower-1.0.1 → pysaxpower-2.0.1}/pyproject.toml

@@ -4,17 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PySaxPower"
-version = "1.0.1"
-description = "Package for reading Sax devices via modbus"
+version = "2.0.1"
+description = "Python package to read and write data from/to SAX Power Home Plus batteries."
 readme = "README.md"
 requires-python = ">=3.7"
 license = "MIT"
 authors = [
-    {name = "Hannes", email = "hannes.210@gmx.de"}
+    {name = "Hannes"}
 ]
 dependencies = [
     "pymodbus==3.15.0"
 ]
 
 [project.urls]
-Homepage = "https://github.com/Hans-4/pysaxpower"
+Homepage = "https://github.com/Hans-4/pysaxpower"

pysaxpower-2.0.1/pysaxpower/__init__.py

@@ -0,0 +1,5 @@
+from pysaxpower.sunspec.power_home_plus_sunspec import PowerHomePlusSunspec
+from pysaxpower.sunspec.register import SunSpecRegister
+
+from pysaxpower.basic_protocol.power_home_plus_basic import PowerHomePlusBasic
+from pysaxpower.basic_protocol.basic_register import BasicRegister

pysaxpower-2.0.1/pysaxpower/basic_protocol/basic_register.py

@@ -0,0 +1,5 @@
+class BasicRegister(object):
+    OperatingMode = 45
+    SOC = 46
+    ActivePower = 47
+    GridPower = 48

pysaxpower-2.0.1/pysaxpower/basic_protocol/power_home_plus_basic.py

@@ -0,0 +1,62 @@
+from pymodbus.client import ModbusTcpClient
+
+class PowerHomePlusBasic:
+    def __init__(
+        self,
+        ip: str,
+        port: int =502,
+        timeout: int =10
+    ):
+        self.client = ModbusTcpClient(
+            host=ip,
+            port=port,
+            timeout=timeout
+        )
+
+        self.connect()
+
+    @staticmethod
+    def apply_offset(value: int):
+        offset = 16384
+        return value - offset
+
+    def get_values(self, addresses: dict[str, int]) -> dict[str, int]:
+
+        results = {}
+
+        for name, value in addresses.items():
+            raw_value = self.client.read_holding_registers(address=value, count=1, device_id=64)
+
+            if not raw_value.isError():
+                if value != 45 and value != 46:
+                    decoded_value = self.apply_offset(raw_value.registers[0])
+                    results[name] = decoded_value
+                else:
+                    results[name] = raw_value.registers[0]
+            else:
+                print(f"Error reading {name}: {value} from Sax Power Home Plus Battery")
+                results[name] = None
+
+        return results
+
+
+    def get_raw_values(self, addresses: dict[str, int]) -> dict[str, int]:
+        results = {}
+
+        for name, value in addresses.items():
+            raw_value = self.client.read_holding_registers(address=value, count=1, device_id=64)
+
+            if not raw_value.isError():
+                results[name] = raw_value.registers[0]
+            else:
+                print(f"Error reading {name}: {value} from Sax Power Home Plus Battery")
+                results[name] = None
+
+        return results
+
+
+    def connect(self):
+        self.client.connect()
+
+    def close(self):
+        self.client.close()

pysaxpower-2.0.1/pysaxpower/sunspec/power_home_plus_sunspec.py

@@ -0,0 +1,106 @@
+from pymodbus.client import ModbusTcpClient
+from pysaxpower.sunspec.register import SunSpecRegister
+from pysaxpower.sunspec.scalefactors import SunSpecScaleFactors
+
+class PowerHomePlusSunspec:
+    def __init__(
+        self,
+        ip: str,
+        port: int =502,
+        timeout: int =10
+    ):
+        self.client = ModbusTcpClient(
+            host=ip,
+            port=port,
+            timeout=timeout
+        )
+
+        self.registers = SunSpecRegister()
+        self.scalefactor = SunSpecScaleFactors()
+
+        self.connect()
+
+
+    def write_registers(self, values: dict[int, int | float]):
+
+        for address, value in values.items():
+            write_value = self.check_for_specific_datatype(address, value)
+
+            self.client.write_register(address=address, value=write_value, device_id=100)
+
+
+    def check_for_specific_datatype(self, address: int, value: int | float) -> int:
+        if address == 40049:
+            return self.apply_power_setpoint_offset(value)
+
+        else:
+            return int(value)
+
+
+    @staticmethod
+    def apply_power_setpoint_offset(raw: int | float) -> int:
+        value = int(raw * 100)
+        return 65536 + value if value < 0 else value
+
+
+    @staticmethod
+    def encode_int16(raw: int) -> int:
+        return raw - 65536 if raw > 32767 else raw
+
+
+    def get_raw_values(self, registers: dict[str, int]) -> dict[str, int] | None:
+        """
+        Enter a dictionary of register values and names and get the raw int16 values
+        """
+        values = {}
+        for name, register in registers.items():
+            raw_values = self.client.read_holding_registers(register, count=1, device_id=100)
+
+            if raw_values.isError():
+                pass
+            else:
+                values[name] = raw_values.registers[0]
+
+        return values
+
+
+    def get_formatted_values(self, registers: dict[str, int]) -> dict[str, int]:
+
+        formatted_values = {}
+        for name, register in registers.items():
+
+            int16_register_value = self.client.read_holding_registers(
+                register, count=1, device_id=100
+            )
+            int_16_value = int16_register_value.registers[0]
+
+            scale_factor_register = self.scalefactor.search_scale_factor(
+                register
+            )
+
+            if scale_factor_register is not None:
+                scale_factor = self.client.read_holding_registers(
+                    scale_factor_register, count=1, device_id=100
+                )
+
+                formatted_scale_factor = self.encode_int16(scale_factor.registers[0])
+
+                formatted_value = (int_16_value * 10 ** (formatted_scale_factor))
+
+            else:
+                formatted_value = int_16_value
+
+            value = self.encode_int16(
+                formatted_value
+            )
+
+            formatted_values[name] = value
+
+        return formatted_values
+
+
+    def connect(self):
+        self.client.connect()
+
+    def close(self):
+        self.client.close()

pysaxpower-2.0.1/pysaxpower/sunspec/register.py

@@ -0,0 +1,217 @@
+class SunSpecRegister(object):
+
+    #-----------------------
+    # SunSpec / Device info
+    #-----------------------
+    SunSpecID_1      = 40000
+    SunSpecID_2      = 40001
+    SunSpecModelID   = 40002
+    Length           = 40003
+    Manufacturer_1   = 40004
+    Manufacturer_2   = 40005
+    Manufacturer_3   = 40006
+    Manufacturer_4   = 40007
+    DeviceModel_1    = 40008
+    DeviceModel_2    = 40009
+    DeviceModel_3    = 40010
+    VersionMaster    = 40011
+    VersionGateway   = 40012
+    SerialNumber_High= 40013
+    SerialNumber_Low = 40014
+
+
+    # Sunspec 103
+    Model_Identifier_103    = 40015
+    Model_Length_32         = 40016
+
+    # AC Current (Storage)
+    AC_Current_Sum_Storage   = 40017
+    AC_Current_Storage_A     = 40018
+    AC_Current_Storage_B     = 40019
+    AC_Current_Storage_C     = 40020
+    AC_Current_Scalefactor   = 40021
+
+    # Voltage (Storage)
+    Voltage_Storage_L1_L2    = 40022
+    Voltage_Storage_L2_L3    = 40023
+    Voltage_Storage_L3_L1    = 40024
+    Voltage_Storage_A        = 40025
+    Voltage_Storage_B        = 40026
+    Voltage_Storage_C        = 40027
+    Voltage_Scalefactor      = 40028
+
+    # Power (Storage)
+    ActivePower_Storage_Sum  = 40029
+    ActivePower_Scalefactor  = 40030
+
+    #------------------------------
+    # Frequency
+    #------------------------------
+    GridFrequency           = 40031
+    Frequency_Scalefactor   = 40032
+
+    #--------------------------------
+    # Apparent Power (Storage)
+    #--------------------------------
+    ApparentPower_Storage_Sum = 40033
+    ApparentPower_Scalefactor = 40034
+
+    #--------------------------------
+    # Reactive Power (Storage)
+    #--------------------------------
+    ReactivePower_Storage_Sum = 40035
+    ReactivePower_Scalefactor = 40036
+
+    #-------------------------------
+    # Power Factor (Storage)
+    #-------------------------------
+    PowerFactor_Storage_Sum  = 40037
+    PowerFactor_Scalefactor  = 40038
+
+    #------------------------------
+    # Temperature
+    #-------------------------------
+    MaxCellTemperature       = 40041
+    Temperature_Scalefactor  = 40042
+
+    #--------------
+    # Status
+    #--------------
+    State   = 40043
+    Event   = 40044
+
+    #------------------------------
+    # PV Power (ADW200 only)
+    #------------------------------
+    PV_Power                = 40045
+    PV_Power_Scalefactor    = 40046
+
+    #------------------------------
+    # Sunspec
+    #------------------------------
+    Sunspec_Model_ID_123    = 40047
+    Sunspec_Lenght_7        = 40048
+
+    #------------------------------
+    # Control
+    #------------------------------
+    PowerTarget             = 40049
+    PowerTargetTimeout      = 40050
+    ControlMode             = 40051
+    PowerTargetScalefactor  = 40052
+    MaxPowerReference       = 40053
+
+    #--------------------------
+    # Sunspec
+    #--------------------------
+    Sunspec_Model_ID    = 40054
+    Sunspec_Lenght      = 40055
+
+    #--------------------------------------
+    # AC Current (Grid)
+    #--------------------------------------
+    AC_Current_Sum_Grid             = 40056
+    AC_Current_Grid_L1              = 40057
+    AC_Current_Grid_L2              = 40058
+    AC_Current_Grid_L3              = 40059
+    AC_Current_Scalefactor_Grid     = 40060
+
+    #----------------------------------
+    # Voltage (Grid)
+    #----------------------------------
+    AverageVoltage_Grid_L_N     = 40061
+    GridVoltage_L1              = 40062
+    GridVoltage_L2              = 40063
+    GridVoltage_L3              = 40064
+    AverageVoltage_Grid_L_L     = 40065
+    GridVoltage_L1_L2           = 40066
+    GridVoltage_L2_L3           = 40067
+    GridVoltage_L1_L3           = 40068
+    Voltage_Scalefactor_Grid    = 40069
+
+    #----------------------------------
+    # Frequency (Grid)
+    #----------------------------------
+    GridFrequency_203           = 40070
+    Frequency_Scalefactor_Grid  = 40071
+
+    #--------------------------------------
+    # Active Power (Grid)
+    #--------------------------------------
+    ActiveGridPower             = 40072
+    ActiveGridPower_L1          = 40073
+    ActiveGridPower_L2          = 40074
+    ActiveGridPower_L3          = 40075
+    ActiveGridPower_Scalefactor = 40076
+
+    #--------------------------------------
+    # Apparent Power (Grid)
+    #--------------------------------------
+    ApparentPower_Sum_Grid          = 40077
+    ApparentPower_Grid_L1           = 40078
+    ApparentPower_Grid_L2           = 40079
+    ApparentPower_Grid_L3           = 40080
+    ApparentPower_Scalefactor_Grid  = 40081
+
+    #--------------------------------------
+    # Reactive Power (Grid)
+    #--------------------------------------
+    ReactivePower_Sum_Grid          = 40082
+    ReactivePower_Grid_L1           = 40083
+    ReactivePower_Grid_L2           = 40084
+    ReactivePower_Grid_L3           = 40085
+    ReactivePower_Scalefactor_Grid  = 40086
+
+    #--------------------------------------
+    # Power Factor (Grid)
+    #--------------------------------------
+    PowerFactor_Sum_Grid            = 40087
+    PowerFactor_Grid_L1             = 40088
+    PowerFactor_Grid_L2             = 40089
+    PowerFactor_Grid_L3             = 40090
+    PowerFactor_Scalefactor_Grid    = 40091
+
+    #--------------------------------------
+    # Sunspec
+    #--------------------------------------
+    Sunspec_ModelId_Base_Model      = 40095
+    Sunspec_Length                  = 40096
+
+    #----------------------------------
+    # Battery System
+    #----------------------------------
+    BatterySystemCapacity       = 40097
+    AvailableChargePower        = 40098
+    AvailableDischargePower     = 40099
+    MaxSoC                      = 40100
+    MinSoC                      = 40101
+    CurrentSoC                  = 40102
+    DepthOfDischarge            = 40103
+
+    #------------------------------
+    # Battery Status
+    #------------------------------
+    BatteryChargingStatus   = 40106
+    BatteryEvent            = 40108
+    AverageCellVoltage      = 40109
+
+    #------------------------------------------
+    # Scalefactors (Battery)
+    #------------------------------------------
+    Capacity_Scalefactor                = 40110
+    ChargeDischargePower_Scalefactor    = 40111
+    SoC_Scalefactor                     = 40112
+    CellVoltage_Scalefactor             = 40114
+
+    #--------------------
+    # Reserve Registers
+    #--------------------
+    Reserve_40039 = 40039
+    Reserve_40040 = 40040
+    Reserve_40092 = 40092
+    Reserve_40093 = 40093
+    Reserve_40094 = 40094
+    Reserve_40104 = 40104
+    Reserve_40105 = 40105
+    Reserve_40107 = 40107
+    Reserve_40113 = 40113

pysaxpower-2.0.1/pysaxpower/sunspec/scalefactors.py

@@ -0,0 +1,86 @@
+from pysaxpower.sunspec.register import SunSpecRegister
+
+
+class SunSpecScaleFactors(object):
+    """Ordnet einer Registeradresse die Adresse des zugehoerigen sunsf-Registers zu.
+
+    Rueckgabe ist die ADRESSE des Scalefaktor-Registers, nicht dessen Wert.
+    None bedeutet: fuer dieses Register existiert laut Dokumentation kein
+    Scalefaktor (Well-Known-Werte, Enums, Timeouts, sunsf-Register selbst).
+    """
+
+    def __init__(self):
+        self.register = SunSpecRegister()
+
+    def search_scale_factor(self, address: int) -> int | None:
+        r = self.register
+
+        # ------------------------------------------------------------------
+        # Modell 103 - Speicherelektronik (40015 - 40046)
+        # ------------------------------------------------------------------
+        if 40017 <= address <= 40020:                  # AC Strom Speicher Summe/A/B/C
+            return r.AC_Current_Scalefactor            # 40021, SF = -2
+        elif 40022 <= address <= 40027:                # Spannung Speicher L-L und A/B/C
+            return r.Voltage_Scalefactor               # 40028, SF = -1
+        elif address == 40029:                         # Wirkleistung Speicher Summe
+            return r.ActivePower_Scalefactor           # 40030, SF = 0
+        elif address == 40031:                         # Netzfrequenz (Speicher)
+            return r.Frequency_Scalefactor             # 40032, SF = -2
+        elif address == 40033:                         # Scheinleistung Speicher Summe
+            return r.ApparentPower_Scalefactor         # 40034, SF = 0
+        elif address == 40035:                         # Blindleistung Speicher Summe
+            return r.ReactivePower_Scalefactor         # 40036, SF = 0
+        elif address == 40037:                         # Leistungsfaktor Speicher Summe
+            return r.PowerFactor_Scalefactor           # 40038, SF = -3
+        elif address == 40041:                         # Maximale Zelltemperatur
+            return r.Temperature_Scalefactor           # 40042, SF = 0
+        elif address == 40045:                         # PV-Leistung (nur mit ADW200)
+            return r.PV_Power_Scalefactor              # 40046, SF = 1
+
+        # ------------------------------------------------------------------
+        # Modell 123 - Immediate Controls (40047 - 40053)
+        # ------------------------------------------------------------------
+        elif address == 40049:                         # Leistungsvorgabe prozentual
+            return r.PowerTargetScalefactor            # 40052, SF = -2
+        # 40050 Timeout (s), 40051 Steuermodus (Enum),
+        # 40053 Referenzwert Maximalleistung (W, Well-Known) -> kein SF
+
+        # ------------------------------------------------------------------
+        # Modell 203 - WYE Connect 3Ph Meter ABC / ADW200 (40054 - 40094)
+        # ------------------------------------------------------------------
+        elif 40056 <= address <= 40059:                # AC Strom Netz Summe/L1/L2/L3
+            return r.AC_Current_Scalefactor_Grid       # 40060, SF = -1
+        elif 40061 <= address <= 40068:                # Netzspannungen L-N und L-L
+            return r.Voltage_Scalefactor_Grid          # 40069, SF = -1
+        elif address == 40070:                         # Netzfrequenz
+            return r.Frequency_Scalefactor_Grid        # 40071, SF = -2
+        elif 40072 <= address <= 40075:                # Wirkleistung Netz Summe/L1/L2/L3
+            return r.ActiveGridPower_Scalefactor       # 40076, SF = 1
+        elif 40077 <= address <= 40080:                # Scheinleistung Netz Summe/L1/L2/L3
+            return r.ApparentPower_Scalefactor_Grid    # 40081, SF = 1
+        elif 40082 <= address <= 40085:                # Blindleistung Netz Summe/L1/L2/L3
+            return r.ReactivePower_Scalefactor_Grid    # 40086, SF = 1
+        elif 40087 <= address <= 40090:                # Leistungsfaktor Netz Summe/L1/L2/L3
+            return r.PowerFactor_Scalefactor_Grid      # 40091, SF = -3
+
+        # ------------------------------------------------------------------
+        # Modell 802 - Battery Base Model (40095 - 40114)
+        # ------------------------------------------------------------------
+        elif address == 40097:                         # Kapazitaet Speichersystem (Wh)
+            return r.Capacity_Scalefactor              # 40110, SF = 0
+        elif 40098 <= address <= 40099:                # Verf. Lade-/Entladeleistung (W)
+            return r.ChargeDischargePower_Scalefactor  # 40111, SF = 0
+        elif 40100 <= address <= 40102:                # Max/Min/Aktueller SoC (%)
+            return r.SoC_Scalefactor                   # 40112, SF = 0
+        elif address == 40109:                         # Durchschnittliche Zellspannung (mV)
+            return r.CellVoltage_Scalefactor           # 40114, SF = 0
+
+        # 40103 Entladetiefe (%): in der Dokumentation ist KEIN Scalefaktor
+        # zugeordnet. Kandidat waere 40113 (Reserve, int16 sunsf, Wert 0),
+        # das an der Position von DoD_SF im SunSpec-Modell 802 steht.
+        # Bewusst nicht geraten -> None.
+
+        # 40000-40016, 40039/40040, 40043/40044, 40092-40094, 40104-40108,
+        # sowie alle sunsf-Register selbst haben keinen Scalefaktor.
+        else:
+            return None

pysaxpower-1.0.1/PKG-INFO

@@ -1,56 +0,0 @@
-Metadata-Version: 2.4
-Name: PySaxPower
-Version: 1.0.1
-Summary: Package for reading Sax devices via modbus
-Author-email: Hannes <hannes.210@gmx.de>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/Hans-4/pysaxpower
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pymodbus==3.15.0
-Dynamic: license-file
-
-# PySaxPower
-
-**A Python package for reading data from SAX Power Home Plus batteries.**
-
----
-
-## Overview
-
-With `PySaxPower` you can read the modbus register from the SAX Power Home Plus batteries.
-
-> **Note:** Due to a firmware bug in SAX devices, **writing data to the battery is currently unsupported**. This limitation will be addressed in a future update once SAX resolves the issue. For more details, see the [EVCC GitHub discussion](https://github.com/evcc-io/evcc/discussions/22155).
-
----
-
-## Supported Devices
-
-
-| **Device**                        | **Documentation**                                                                |
-| --------------------------------- |----------------------------------------------------------------------------------|
-| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) |
-
-
----
-
-## Installation
-
-```bash
-pip install PySaxPower
-```
-
----
-
-## Usage
-
-```python
-from pysaxpower import PowerHomePlus
-
-device = PowerHomePlus("192.168.178.60")
-
-level, power, grid_power = device.read_register()
-
-print(f"Battery Level: {level}% | Power: {power}W | Grid Power: {grid_power}W")
-```

pysaxpower-1.0.1/PySaxPower.egg-info/PKG-INFO

@@ -1,56 +0,0 @@
-Metadata-Version: 2.4
-Name: PySaxPower
-Version: 1.0.1
-Summary: Package for reading Sax devices via modbus
-Author-email: Hannes <hannes.210@gmx.de>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/Hans-4/pysaxpower
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pymodbus==3.15.0
-Dynamic: license-file
-
-# PySaxPower
-
-**A Python package for reading data from SAX Power Home Plus batteries.**
-
----
-
-## Overview
-
-With `PySaxPower` you can read the modbus register from the SAX Power Home Plus batteries.
-
-> **Note:** Due to a firmware bug in SAX devices, **writing data to the battery is currently unsupported**. This limitation will be addressed in a future update once SAX resolves the issue. For more details, see the [EVCC GitHub discussion](https://github.com/evcc-io/evcc/discussions/22155).
-
----
-
-## Supported Devices
-
-
-| **Device**                        | **Documentation**                                                                |
-| --------------------------------- |----------------------------------------------------------------------------------|
-| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) |
-
-
----
-
-## Installation
-
-```bash
-pip install PySaxPower
-```
-
----
-
-## Usage
-
-```python
-from pysaxpower import PowerHomePlus
-
-device = PowerHomePlus("192.168.178.60")
-
-level, power, grid_power = device.read_register()
-
-print(f"Battery Level: {level}% | Power: {power}W | Grid Power: {grid_power}W")
-```

pysaxpower-1.0.1/PySaxPower.egg-info/SOURCES.txt

@@ -1,10 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-PySaxPower.egg-info/PKG-INFO
-PySaxPower.egg-info/SOURCES.txt
-PySaxPower.egg-info/dependency_links.txt
-PySaxPower.egg-info/requires.txt
-PySaxPower.egg-info/top_level.txt
-pysaxpower/__init__.py
-pysaxpower/power_home_plus.py

pysaxpower-1.0.1/README.md

@@ -1,43 +0,0 @@
-# PySaxPower
-
-**A Python package for reading data from SAX Power Home Plus batteries.**
-
----
-
-## Overview
-
-With `PySaxPower` you can read the modbus register from the SAX Power Home Plus batteries.
-
-> **Note:** Due to a firmware bug in SAX devices, **writing data to the battery is currently unsupported**. This limitation will be addressed in a future update once SAX resolves the issue. For more details, see the [EVCC GitHub discussion](https://github.com/evcc-io/evcc/discussions/22155).
-
----
-
-## Supported Devices
-
-
-| **Device**                        | **Documentation**                                                                |
-| --------------------------------- |----------------------------------------------------------------------------------|
-| Power Home Plus 5.8 kWh / 7.7 kWh | [Product page](https://sax-power.net/download/Handbuch_SAX_Home_Plus_7,7_EN.pdf) |
-
-
----
-
-## Installation
-
-```bash
-pip install PySaxPower
-```
-
----
-
-## Usage
-
-```python
-from pysaxpower import PowerHomePlus
-
-device = PowerHomePlus("192.168.178.60")
-
-level, power, grid_power = device.read_register()
-
-print(f"Battery Level: {level}% | Power: {power}W | Grid Power: {grid_power}W")
-```

pysaxpower-1.0.1/pysaxpower/__init__.py

@@ -1 +0,0 @@
-from pysaxpower.power_home_plus import PowerHomePlus

pysaxpower-1.0.1/pysaxpower/power_home_plus.py

@@ -1,52 +0,0 @@
-from pymodbus.client import ModbusTcpClient
-
-class PowerHomePlus:
-    def __init__(
-        self,
-        ip: str,
-        port: int =502,
-        timeout: int =10
-    ):
-        self.client = ModbusTcpClient(
-            host=ip,
-            port=port,
-            timeout=timeout
-        )
-
-        self.connect()
-
-    @staticmethod
-    def apply_offset(value: int):
-        offset = 16384
-        return value - offset
-
-    def read_register(self):
-        """
-        46: battery charge level
-        47: battery power
-        48: battery grid power
-        """
-        addresses = [46, 47, 48]
-
-        results = []
-
-        for i in range(len(addresses)):
-            value = self.client.read_holding_registers(address=addresses[i], count=1, device_id=64)
-
-            if not value.isError():
-                if i > 0:
-                    decoded_value = self.apply_offset(value.registers[0])
-                    results.append(decoded_value)
-                else:
-                    results.append(value.registers[0])
-            else:
-                print(f"Error reading register {addresses[i]} from Sax Power Home Plus Battery")
-                results.append(None)
-
-        return results
-
-    def connect(self):
-        self.client.connect()
-
-    def close(self):
-        self.client.close()