Sessy Battery - Domoticz Python plugin

Domoticz plugin for Sessy batteries

Preliminary version, breaking changes to be expected!
reads state and percentage of batteries

planned developments:

• implement al measurements per battery
• implement summary for all batteries (like total power, SoC etc)
• implement data from p1 meter
• implement OpenAPI spec to allow controlling the batteries from Domoticz
• implement auto discovery to get rid of config file

Prerequisites

• Follow the Domoticz guide on Using Python Plugins to enable the plugin framework.

The following Python modules installed

sudo apt-get update
sudo apt-get install python3-requests python3-cryptography

🔐 Passwords are encrypted using Fernet and stored securely in Domoticz configuration (not in plain text). If python3-cryptography is missing, the plugin will fall back to using plaintext passwords.

Installation

1. Clone repository into your domoticz plugins folder

cd domoticz/plugins
git clone https://github.com/JanJaapKo/SessyBattery

to update:

cd domoticz/plugins/SessyBattery
git pull https://github.com/JanJaapKo/SessyBattery

2. Restart domoticz
3. Go to step configuration

Configuration

First fill the config.json file in the plugin directory with the connection details for the batteries and the P1 unit.

⚠️ Security Note: The plugin will encrypt and store your passwords safely in Domoticz configuration after the first successful run. You should remove the pwd field from config.json afterward to avoid storing plaintext passwords. Example:

{
	"p1meter": [
        {
            "name": "P1 meter", # give this your own meaningfull name
            "ip": "192.168.1.1", # read from portal
            "user": "ABCDEFGH", # read from sticker
            "pwd": "ABCDEFGH" # read from sticker
        }
    ],
	"batteries":[
		{
			"name": "Sessy 1",  # give this your own meaningfull name
			"ip": "192.168.1.2", # read from portal
			"user": "ABCDEFGH", # read from sticker
			"pwd": "ABCDEFGH" # read from sticker
		}, # repeat this block for each sessy
		{
			"name": "Sessy 2", # give this your own meaningfull name
			"ip": "192.168.1.3", # read from portal
			"user": "ABCDEFGH", # read from sticker
			"pwd": "ABCDEFGH" # read from sticker
		}
	]
}

4. Make sure the file contains valid JSON syntax by using online validation tooling or Notepad++'s JSON plugin
5. Go to "Hardware" page and add new item with type "SessyBattery"

The default configuration works, but can be altered when desired.