PySaxPower 1.0.0__tar.gz

pysaxpower-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hannes Sahm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pysaxpower-1.0.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: PySaxPower
+Version: 1.0.0
+Summary: Package for reading Sax devices
+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==2.5
+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 sax_power.power_home_plus 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.0/PySaxPower.egg-info/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: PySaxPower
+Version: 1.0.0
+Summary: Package for reading Sax devices
+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==2.5
+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 sax_power.power_home_plus 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.0/PySaxPower.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+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
+sax_power/__init_.py
+sax_power/power_home_plus.py

pysaxpower-1.0.0/PySaxPower.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pysaxpower-1.0.0/PySaxPower.egg-info/requires.txt

@@ -0,0 +1 @@
+pymodbus==2.5

pysaxpower-1.0.0/PySaxPower.egg-info/top_level.txt

@@ -0,0 +1 @@
+sax_power

pysaxpower-1.0.0/README.md

@@ -0,0 +1,43 @@
+# 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 sax_power.power_home_plus 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.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "PySaxPower"
+version = "1.0.0"
+description = "Package for reading Sax devices"
+readme = "README.md"
+requires-python = ">=3.7"
+license = "MIT"
+authors = [
+    {name = "Hannes", email = "hannes.210@gmx.de"}
+]
+dependencies = [
+    "pymodbus==2.5"
+]
+
+[project.urls]
+Homepage = "https://github.com/Hans-4/pysaxpower"

pysaxpower-1.0.0/sax_power/power_home_plus.py

@@ -0,0 +1,47 @@
+from pymodbus.client.sync import ModbusTcpClient
+
+class PowerHomePlus:
+    def __init__(
+        self,
+        ip: str,
+        port: int =502,
+        timeout: int =10
+    ):
+        self.client = ModbusTcpClient(
+            host=ip,
+            port=port,
+            timeout=timeout
+        )
+
+    @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, unit=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 close(self):
+        self.client.close()

pysaxpower-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+