A battery monitor D-Bus service that aggregates the data for multiple batteries (currently, only parallel supported).
Install SetupHelper.
Select the Battery Aggregator as the Battery monitor
under System setup
.
Optionally create the file /data/setupOptions/BatteryAggregator/config.json
.
To exclude, for instance, a shunt from being aggregated, first run dbus-spy
from the command line to obtain its service name.
It will likely be of the form com.victronenergy.battery.ttyS9
.
Then add:
"excludedServices": ["com.victronenergy.battery.ttyS9"]
To post-merge information from other services (e.g. a shunt), add:
"primaryServices": {"com.victronenergy.battery.ttyS5": ["/Soc"], "com.victronenergy.battery.leastPrecedence": ["/Dc/0/Current"]}
(use SoC from the shunt, and current from the BMS with service name com.victronenergy.battery.leastPrecedence
).
To pre-merge information from other services, add:
"auxiliaryServices": ["com.victronenergy.battery.defaultMetadata", "com.victronenergy.battery.leastPrecedence"]
(or use the more advanced syntax if interested in specific D-Bus paths:
"auxiliaryServices": {"com.victronenergy.battery.dev1": ["/Info/Location"]}
)
To set the installed capacity (if it is not available via aggregation), add:
"capacity": 200
To create a virtual battery by merging two (or more) other batteries, add:
"virtualBatteries": {
"com.victronenergy.battery.virtual1": ["com.victronenergy.battery.ttyS2", "com.victronenergy.battery.leastPrecedence"]
}
}
(or use the more advanced syntax if interested in specific DBus paths:
"virtualBatteries": {
"com.victronenergy.battery.virtual1": {"com.victronenergy.battery.ttyS6": ["/Soc"], "com.victronenergy.battery.ttyUSB0": []},
"com.victronenergy.battery.virtual2": {"com.victronenergy.battery.ttyS7": ["/Soc"], "com.victronenergy.battery.ttyUSB1": []}
}
}
note, empty array []
means include all paths)
There are three ways to calculate the CCL:
"ir" - sample V and I during discharge to determine the individual internal resistances. Best with a good shunt to give good measurements, useful with batteries of different capacities and ages. Note: until enough samples have been built up, the second method below is used.
"capacity" - generally, battery capacity is inversely proportional to internal resistance. Useful with batteries of different capacities.
"count" - batteries are assumed to have the same capacity and performance.
For example, to use "capacity", add the following:
"currentRatioMethod": "capacity"
There are four ways to calculate the CVL:
"max_when_balancing" (default) - use the min value of all the batteries, but when balancing use the max.
"min_when_balancing" - always use the min value of all the batteries.
"max_always" - always use the max value of all the batteries.
"dvcc" - track the DVCC value (com.victronenergy.settings/Settings/SystemSetup/MaxChargeVoltage
).
For example, to use "min_when_balancing", add the following:
"cvlMode": "min_when_balancing"
To change the log level to debug, add:
"logLevel": "DEBUG"
{
"excludedServices": ["com.victronenergy.battery.ttyS1"]
}
{
"primaryServices": {"com.victronenergy.battery.ttyS5": ["/Soc"]}
}
{
"virtualBatteries": {
"com.victronenergy.battery.virtual1": ["com.victronenergy.battery.ttyS6", "com.victronenergy.battery.ttyUSB0"],
"com.victronenergy.battery.virtual2": ["com.victronenergy.battery.ttyS7", "com.victronenergy.battery.ttyUSB1"]
}
}
In order to make it easier to generate the config file, a small simple html has been created. This should help you to generate the JSON for your Configuration.
You can find the Generator here: Config Generator
Alternatively, you can also run the generator locally:
Download the index.html
file from docs/config_generator
and open it in your browser.
After you have filled in the form, you can copy the generated JSON and paste it into your config file /data/setupOptions/BatteryAggregator/config.json
This project contains a small script which allows you to validate the config. It will also try to show you the issue(s) ( if any ). To use it, run the following command:
bash /data/BatteryAggregator/check_config.sh
In case of errors, adjust the config.json and run the command again until no errors are shown.
The Config Checker requires the following packages:
The command above will automatically check for the packages and will ask you if you want to install them if they are not present.
In case of permission errors, make sure that the check_config.sh
is executable. If not, run the following command:
chmod +x /data/BatteryAggregator/check_config.sh
Check the log:
cat /var/log/BatteryAggregator/current
Debug logging can be enable by setting the D-Bus path /LogLevel
to INFO
.
Restart the service:
svc -d /service/BatteryAggregator
svc -u /service/BatteryAggregator