GitHub repository: mr-manuel/venus-os_dbus-mqtt-battery
- Disclaimer
- Supporting/Sponsoring this project
- Purpose
- Config
- JSON structure
- Install / Update
- Uninstall
- Restart
- Debugging
- Compatibility
- Screenshots
I wrote this script for myself. I'm not responsible, if you damage something using my script.
You like the project and you want to support me?
The script emulates a battery in Venus OS. It gets the MQTT data from a subscribed topic and publishes the information on the dbus as the service com.victronenergy.battery.mqtt_battery with the VRM instance 41.
It also can be used to aggregate multiple batteries. In this case you can use Node-RED to read the data from multiple batteries and then feed the calculated data to this driver, which then is selected as battery monitor.
Copy or rename the config.sample.ini to config.ini in the dbus-mqtt-battery folder and change it as you need it.
Minimum required to start the driver
{
"Dc": {
"Power": 321.6,
"Voltage": 52.7
},
"Soc": 63
}Minimum required that the MTTP is controlled by BMS
{
"Dc": {
"Power": 321.6,
"Voltage": 52.7
},
"Soc": 63,
"Info": {
"MaxChargeVoltage": 55.2,
"MaxChargeCurrent": 80,
"MaxDischargeCurrent": 120
}
}Full (with descriptions)
Please remove the --> * comments to get a valid JSON. Comments are not allowed in JSON structure, but for simplicity I added them.
{
"Dc": {
"Power": 321.6, --> Watt
"Voltage": 52.7, --> Volt
"Current": 6.10, --> Ampere - if missing in the JSON, than gets calculated from "power" and "voltage"
"Temperature": 23 --> Celsius
},
"InstalledCapacity": 200.0, --> Ampere hours - total battery capacity
"ConsumedAmphours": 74.5, --> Ampere hours - consumed (only positive values) - if missing in the JSON, than gets calculated when "InstalledCapacity" and "Capacity" are set OR only "InstalledCapacity" is set
"Capacity": 125.5, --> Ampere hours - remaining (only positive values) - if missing in the JSON, than gets calculated when "InstalledCapacity" and "ConsumedAmphours" are set OR only "InstalledCapacity" is set
"Soc": 63, --> Percent (0-100) - state of charge
"TimeToGo": 43967, --> Seconds - time until the battery is empty - if missing in the JSON, than gets calculated when "Capacity" is set or calculated
"Balancing": 0, --> Int - 0 = inactive; 1 = active
"SystemSwitch": 0, --> Int - 0 = disabled; 1 = enabled
"Alarms": {
"LowVoltage": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighVoltage": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"LowSoc": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighChargeCurrent": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighDischargeCurrent": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighCurrent": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"CellImbalance": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighChargeTemperature": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"LowChargeTemperature": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"LowCellVoltage": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"LowTemperature": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"HighTemperature": 0, --> Int - 0 = ok; 1 = warning; 2 = alarm
"FuseBlown": 0 --> Int - 0 = ok; 1 = warning; 2 = alarm
},
"Info": {
"ChargeRequest": 0, --> Int - 0 = inactive; 1 = active
"MaxChargeVoltage": 55.2, --> Volt - Maximum loading voltage that the MultiPlus/Quattro should use
"MaxChargeCurrent": 80.0, --> Ampere - Maximum charge current that the MultiPlus/Quattro should use
"MaxDischargeCurrent": 120.0 --> Ampere - Maximum discharge current that the MultiPlus/Quattro should use
},
"History": {
"ChargeCycles": 5, --> Number - cycles for complete battery lifetime
"MinimumVoltage": 40.8, --> Battery voltage minimum over time
"MaximumVoltage": 58.4, --> Battery voltage maximum over time
"TotalAhDrawn": 1057.3 --> Ampere hours - drawn ampere hours for complete battery lifetime
},
"System": {
"MinVoltageCellId": "C3", --> String - ID of the cell with the lowest voltage - if missing in the JSON, than gets calculated when elements in "Voltages" are present
"MinCellVoltage": 3.392, --> Volt - Of the cell with the lowest voltage - if missing in the JSON, than gets calculated when elements in "Voltages" are present
"MaxVoltageCellId": "C15", --> String - ID of the cell with the highest voltage - if missing in the JSON, than gets calculated when elements in "Voltages" are present
"MaxCellVoltage": 3.417, --> Volt - Of the cell with the highest voltage - if missing in the JSON, than gets calculated when elements in "Voltages" are present
"MinTemperatureCellId": "C2", --> String - ID of the cell with the lowest temperature
"MinCellTemperature": 22.5, --> Celsius - Of the cell with the lowest temperature
"MaxTemperatureCellId": "C9", --> String - ID of the cell with the highest temperature
"MaxCellTemperature": 23.5, --> Celsius - Of the cell with the highest temperature
"MOSTemperature": 23.5, --> Celsius - Temperature of the Mosfets
"NrOfModulesOnline": 0, --> Number - How many modules are online
"NrOfModulesOffline": 0, --> Number - How many modules are offline
"NrOfModulesBlockingCharge": 0, --> Number - How many modules are blocking charge
"NrOfModulesBlockingDischarge": 0 --> Number - How many modules are blocking discharge
},
"Voltages": {
"Cell1": 3.201, --> Volt - voltage of this cell
"Cell2": 3.202, --> Volt - voltage of this cell
"Cell3": 3.203, --> Volt - voltage of this cell
"Cell4": 3.204, --> Volt - voltage of this cell
"Cell5": 3.205, --> Volt - voltage of this cell
"Cell6": 3.206, --> Volt - voltage of this cell
"Cell7": 3.207, --> Volt - voltage of this cell
"Cell8": 3.208, --> Volt - voltage of this cell
"Cell9": 3.209, --> Volt - voltage of this cell
"Cell10": 3.210, --> Volt - voltage of this cell
"Cell11": 3.211, --> Volt - voltage of this cell
"Cell12": 3.212, --> Volt - voltage of this cell
"Cell13": 3.213, --> Volt - voltage of this cell
"Cell14": 3.214, --> Volt - voltage of this cell
"Cell15": 3.215, --> Volt - voltage of this cell
"Cell16": 3.216, --> Volt - voltage of this cell
"Cell17": 3.217, --> Volt - voltage of this cell
"Cell18": 3.218, --> Volt - voltage of this cell
"Cell19": 3.219, --> Volt - voltage of this cell
"Cell20": 3.220, --> Volt - voltage of this cell
"Cell21": 3.221, --> Volt - voltage of this cell
"Cell22": 3.222, --> Volt - voltage of this cell
"Cell23": 3.223, --> Volt - voltage of this cell
"Cell24": 3.224 --> Volt - voltage of this cell
},
"Balances": {
"Cell1": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell2": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell3": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell4": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell5": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell6": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell7": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell8": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell9": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell10": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell11": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell12": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell13": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell14": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell15": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell16": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell17": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell18": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell19": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell20": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell21": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell22": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell23": 0, --> Int - 0 = inactive; 1 = cell is beeing balanced
"Cell24": 0 --> Int - 0 = inactive; 1 = cell is beeing balanced
},
"Io": {
"AllowToCharge": 0, --> Int - 0 = disabled; 1 = enabled
"AllowToDischarge": 0, --> Int - 0 = disabled; 1 = enabled
"AllowToBalance": 0, --> Int - 0 = disabled; 1 = enabled
"ExternalRelay": 0 --> Int - 0 = disabled; 1 = enabled
}
}-
Login to your Venus OS device via SSH. See Venus OS:Root Access for more details.
-
Execute this commands to download and copy the files:
wget -O /tmp/download_dbus-mqtt-battery.sh https://raw.githubusercontent.com/mr-manuel/venus-os_dbus-mqtt-battery/master/download.sh bash /tmp/download_dbus-mqtt-battery.sh
-
Select the version you want to install.
-
Press enter for a single instance. For multiple instances, enter a number and press enter.
Example:
- Pressing enter or entering
1will install the driver to/data/etc/dbus-mqtt-battery. - Entering
2will install the driver to/data/etc/dbus-mqtt-battery-2.
- Pressing enter or entering
-
Edit the config file to fit your needs. The correct command for your installation is shown after the installation.
- If you pressed enter or entered
1during installation:
nano /data/etc/dbus-mqtt-battery/config.ini
- If you entered
2during installation:
nano /data/etc/dbus-mqtt-battery-2/config.ini
- If you pressed enter or entered
-
Install the driver as a service. The correct command for your installation is shown after the installation.
- If you pressed enter or entered
1during installation:
bash /data/etc/dbus-mqtt-battery/install.sh
- If you entered
2during installation:
bash /data/etc/dbus-mqtt-battery-2/install.sh
The daemon-tools should start this service automatically within seconds.
- If you pressed enter or entered
-
To uninstall the default instance:
bash /data/etc/dbus-mqtt-battery/uninstall.sh
-
To uninstall the second instance:
bash /data/etc/dbus-mqtt-battery-2/uninstall.sh
-
To restart the default instance:
bash /data/etc/dbus-mqtt-battery/restart.sh
-
To restart the second instance:
bash /data/etc/dbus-mqtt-battery-2/restart.sh
The logs can be checked with tail -n 100 -f /data/log/dbus-mqtt-battery/current | tai64nlocal
The service status can be checked with svstat svstat /service/dbus-mqtt-battery
This will output somethink like /service/dbus-mqtt-battery: up (pid 5845) 185 seconds
If the seconds are under 5 then the service crashes and gets restarted all the time. If you do not see anything in the logs you can increase the log level in /data/etc/dbus-mqtt-battery/dbus-mqtt-battery.py by changing level=logging.WARNING to level=logging.INFO or level=logging.DEBUG
If the script stops with the message dbus.exceptions.NameExistsException: Bus name already exists: com.victronenergy.battery.mqtt_battery" it means that the service is still running or another service is using that bus name.
This software supports the latest three stable versions of Venus OS. It may also work on older versions, but this is not guaranteed.
MQTT Battery
