GitHub repository: mr-manuel/venus-os_dbus-mqtt-solar-charger
- 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 Solar Charger in Venus OS. It gets the MQTT data from a subscribed topic and publishes the information on the dbus as the service com.victronenergy.solarcharger.mqtt_solar_charger with the VRM instance 51.
Copy or rename the config.sample.ini to config.ini in the dbus-mqtt-solar-charger folder and change it as you need it.
Minimum required
Single MTTP tracker
{
"Pv": {
"V": 60.0
},
"Yield": {
"Power": 120.0
},
"Dc": {
"0": {
"Current": 10.0,
"Voltage": 12.0
}
}
}OR
Multiple MPPT tracker (min 2, max 4)
{
"Pv": {
"0": {
"V": 60.0,
"P": 10.0
},
"1": {
"V": 60.0,
"P": 20.0
},
"2": {
"V": 60.0,
"P": 30.0
},
"3": {
"V": 60.0,
"P": 40.0
}
},
"Dc": {
"0": {
"Voltage": 12.0,
"Current": 8.33
}
}
}Full
See dbus documentation for value description.
{
"Pv": {
"0": {
"V": 60.0, --> Float - Voltage of 1. MPPT tracker
"P": 10.0 --> Float - Power of 1. MPPT tracker
},
"1": {
"V": 60.0, --> Float - Voltage of 2. MPPT tracker
"P": 20.0 --> Float - Power of 2. MPPT tracker
},
"2": {
"V": 60.0, --> Float - Voltage of 3. MPPT tracker
"P": 30.0 --> Float - Power of 3. MPPT tracker
},
"3": {
"V": 60.0, --> Float - Voltage of 4. MPPT tracker
"P": 40.0 --> Float - Power of 4. MPPT tracker
}
},
"Yield": {
"Power": 180, --> Float - Power of single MTTP tracker or sum of all trackers. Calculated in multiple MTTP tracker mode, if not set
"User": 30, --> Int - kWh produced until reset
"System": 30 --> Int - kWh produced until now (lifetime)
},
"Dc": {
"0": {
"Current": 15, --> Float - Battery current
"Voltage": 12 --> Float - Battery voltage
}
},
"Link": {
"NetworkMode": "0x1", --> See dbus documentation
"BatteryCurrent": 0.0, --> See dbus documentation
"ChargeCurrent": 0.0, --> See dbus documentation
"ChargeVoltage": 0.0, --> See dbus documentation
"NetworkStatus": "0x04", --> See dbus documentation
"TemperatureSense": 20.0, --> See dbus documentation
"TemperatureSenseActive": 0, --> See dbus documentation
"VoltageSense": 80.0, --> See dbus documentation
"VoltageSenseActive": 0 --> See dbus documentation
},
"Settings": {
"BmsPresent": 0, --> See dbus documentation
"ChargeCurrentLimit": 120.0 --> Float - Maximum charge current
},
"Load": {
"State": 0, --> Int - Whether the load is on or of
"I": 0.0 --> Float - Current from the load output
},
"ErrorCode": 0, --> See dbus documentation
"State": 3, --> See dbus documentation
"Mode": 4, --> 0 = On; 4 = Off
"MppOperationMode": 2, --> 0 = Off; 1 = Voltage or Current limited; 2 = MPPT Tracker active
"DeviceOffReason": "", --> See dbus documentation
"Relay": {
"0": {
"State": 0 --> See dbus documentation
}
},
"History": {
"Daily": { --> Daily history
"0": { --> String - Today
"Yield": 11, --> Float - kWh of today
"Consumption": 22, --> Int - kWh of today
"MaxPower": 33, --> Float - Watt peak of today
"MaxPvVoltage": 44, --> Float - Volt peak of today
"MinBatteryVoltage": 55, --> Float - Min battery voltage of today
"MaxBatteryVoltage": 66, --> Float - Max battery voltage of today
"MaxBatteryCurrent": 77, --> Float - Max battery current of today
"TimeInBulk": 3600, --> Int - Seconds in bulk mode of today
"TimeInAbsorption": 1800, --> Int - Seconds in absorption mode of today
"TimeInFloat": 900, --> Int - Seconds in float mode of today
"LastError1": 1, --> Int - Last error of today - See dbus documentation /ErrorCode
"LastError2": 2, --> Int - Second last error of today - See dbus documentation /ErrorCode
"LastError3": 3, --> Int - Thrid last error of today - See dbus documentation /ErrorCode
"LastError4": 4, --> Int - Fourth last error of today - See dbus documentation /ErrorCode
"Pv": {
"0": { --> MPPT tracker number 1
"Yield": 1, --> Float - kWh of today for MPPT tracker 1
"MaxPower": 11, --> Float - Watt peak of today for MPPT tracker 1
"MaxVoltage": 111 --> Float - Volt peak of today for MPPT tracker 1
},
"1": { --> MPPT tracker number 2
"Yield": 2, --> Float - kWh of today for MPPT tracker 2
"MaxPower": 22, --> Float - Watt peak of today for MPPT tracker 2
"MaxVoltage": 222 --> Float - Volt peak of today for MPPT tracker 2
},
"2": { --> MPPT tracker number 3
"Yield": 3, --> Float - kWh of today for MPPT tracker 3
"MaxPower": 33, --> Float - Watt peak of today for MPPT tracker 3
"MaxVoltage": 333 --> Float - Volt peak of today for MPPT tracker 3
},
"3": { --> MPPT tracker number 4
"Yield": 4, --> Float - kWh of today for MPPT tracker 4
"MaxPower": 44, --> Float - Watt peak of today for MPPT tracker 4
"MaxVoltage": 444 --> Float - Volt peak of today for MPPT tracker 4
}
}
},
"1": { --> String - Yesterday
"Yield": 11, --> Float - kWh of yesterday
"Consumption": 22, --> Int - kWh of yesterday
"MaxPower": 33, --> Float - Watt peak of yesterday
"MaxPvVoltage": 44, --> Float - Volt peak of yesterday
"MinBatteryVoltage": 55, --> Float - Min battery voltage of yesterday
"MaxBatteryVoltage": 66, --> Float - Max battery voltage of yesterday
"MaxBatteryCurrent": 77, --> Float - Max battery current of yesterday
"TimeInBulk": 3600, --> Int - Seconds in bulk mode of yesterday
"TimeInAbsorption": 1800, --> Int - Seconds in absorption mode of yesterday
"TimeInFloat": 900, --> Int - Seconds in float mode of yesterday
"LastError1": 1, --> Int - Last error of yesterday - See dbus documentation /ErrorCode
"LastError2": 2, --> Int - Second last error of yesterday - See dbus documentation /ErrorCode
"LastError3": 3, --> Int - Thrid last error of yesterday - See dbus documentation /ErrorCode
"LastError4": 4, --> Int - Fourth last error of yesterday - See dbus documentation /ErrorCode
"Pv": {
"0": { --> MPPT tracker number 1
"Yield": 1, --> Float - kWh of yesterday for MPPT tracker 1
"MaxPower": 11, --> Float - Watt peak of yesterday for MPPT tracker 1
"MaxVoltage": 111 --> Float - Volt peak of yesterday for MPPT tracker 1
},
"1": { --> MPPT tracker number 2
"Yield": 2, --> Float - kWh of yesterday for MPPT tracker 2
"MaxPower": 22, --> Float - Watt peak of yesterday for MPPT tracker 2
"MaxVoltage": 222 --> Float - Volt peak of yesterday for MPPT tracker 2
},
"2": { --> MPPT tracker number 3
"Yield": 3, --> Float - kWh of yesterday for MPPT tracker 3
"MaxPower": 33, --> Float - Watt peak of yesterday for MPPT tracker 3
"MaxVoltage": 333 --> Float - Volt peak of yesterday for MPPT tracker 3
},
"3": { --> MPPT tracker number 4
"Yield": 4, --> Float - kWh of yesterday for MPPT tracker 4
"MaxPower": 44, --> Float - Watt peak of yesterday for MPPT tracker 4
"MaxVoltage": 444 --> Float - Volt peak of yesterday for MPPT tracker 4
}
}
},
"2": { --> String - 2 days ago (I do not recommend more than 30 days)
"Yield": 11, --> Float - kWh of 2 days ago
"Consumption": 22, --> Int - kWh of 2 days ago
"MaxPower": 33, --> Float - Watt peak of 2 days ago
"MaxPvVoltage": 44, --> Float - Volt peak of 2 days ago
"MinBatteryVoltage": 55, --> Float - Min battery voltage of 2 days ago
"MaxBatteryVoltage": 66, --> Float - Max battery voltage of 2 days ago
"MaxBatteryCurrent": 77, --> Float - Max battery current of 2 days ago
"TimeInBulk": 3600, --> Int - Seconds in bulk mode of 2 days ago
"TimeInAbsorption": 1800, --> Int - Seconds in absorption mode of 2 days ago
"TimeInFloat": 900, --> Int - Seconds in float mode of 2 days ago
"LastError1": 1, --> Int - Last error of 2 days ago - See dbus documentation /ErrorCode
"LastError2": 2, --> Int - Second last error of 2 days ago - See dbus documentation /ErrorCode
"LastError3": 3, --> Int - Thrid last error of 2 days ago - See dbus documentation /ErrorCode
"LastError4": 4, --> Int - Fourth last error of 2 days ago - See dbus documentation /ErrorCode
"Pv": {
"0": { --> MPPT tracker number 1
"Yield": 1, --> Float - kWh of 2 days ago for MPPT tracker 1
"MaxPower": 11, --> Float - Watt peak of 2 days ago for MPPT tracker 1
"MaxVoltage": 111 --> Float - Volt peak of 2 days ago for MPPT tracker 1
},
"1": { --> MPPT tracker number 2
"Yield": 2, --> Float - kWh of 2 days ago for MPPT tracker 2
"MaxPower": 22, --> Float - Watt peak of 2 days ago for MPPT tracker 2
"MaxVoltage": 222 --> Float - Volt peak of 2 days ago for MPPT tracker 2
},
"2": { --> MPPT tracker number 3
"Yield": 3, --> Float - kWh of 2 days ago for MPPT tracker 3
"MaxPower": 33, --> Float - Watt peak of 2 days ago for MPPT tracker 3
"MaxVoltage": 333 --> Float - Volt peak of 2 days ago for MPPT tracker 3
},
"3": { --> MPPT tracker number 4
"Yield": 4, --> Float - kWh of 2 days ago for MPPT tracker 4
"MaxPower": 44, --> Float - Watt peak of 2 days ago for MPPT tracker 4
"MaxVoltage": 444 --> Float - Volt peak of 2 days ago for MPPT tracker 4
}
}
}
},
"Overall": { --> Lifetime history
"DaysAvailable": 3, --> Fetched from config.ini from "history_days"
"MaxPvVoltage": 44, --> Float - Max PV voltage in lifetime
"MaxBatteryVoltage": 14, --> Float - Max PV voltage in lifetime
"MinBatteryVoltage": 11, --> Float - Max PV voltage in lifetime
"LastError1": 1, --> Int - Last error - See dbus documentation /ErrorCode
"LastError2": 2, --> Int - Second last error - See dbus documentation /ErrorCode
"LastError3": 3, --> Int - Thrid last error - See dbus documentation /ErrorCode
"LastError4": 4 --> Int - Fourth last error - See dbus documentation /ErrorCode
}
}
}-
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-solar-charger.sh https://raw.githubusercontent.com/mr-manuel/venus-os_dbus-mqtt-solar-charger/master/download.sh bash /tmp/download_dbus-mqtt-solar-charger.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-solar-charger. - Entering
2will install the driver to/data/etc/dbus-mqtt-solar-charger-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-solar-charger/config.ini
- If you entered
2during installation:
nano /data/etc/dbus-mqtt-solar-charger-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-solar-charger/install.sh
- If you entered
2during installation:
bash /data/etc/dbus-mqtt-solar-charger-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-solar-charger/uninstall.sh
-
To uninstall the second instance:
bash /data/etc/dbus-mqtt-solar-charger-2/uninstall.sh
-
To restart the default instance:
bash /data/etc/dbus-mqtt-solar-charger/restart.sh
-
To restart the second instance:
bash /data/etc/dbus-mqtt-solar-charger-2/restart.sh
The logs can be checked with tail -n 100 -F /data/log/dbus-mqtt-solar-charger/current | tai64nlocal
The service status can be checked with svstat svstat /service/dbus-mqtt-solar-charger
This will output somethink like /service/dbus-mqtt-solar-charger: 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-solar-charger/dbus-mqtt-solar-charger.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.solarcharger.mqtt_solar_charger" 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 Solar Charger
