Skip to content

Victron Setup

Joel Goudswaard edited this page Aug 13, 2026 · 1 revision

SCCS can show battery and solar data on the UI from Victron devices using the Raspberry Pi Bluetooth. VE.Bus probably works too but is untested.

1. Power Bluetooth on

sudo systemctl enable --now bluetooth
sudo rfkill unblock bluetooth
sudo hciconfig hci0 up
bluetoothctl show

The expected result is Powered: yes. If rfkill list says soft-blocked, rfkill unblock bluetooth fixes it.

2. Make sure Bluetooth is enabled in config.txt

grep -E 'disable-bt|GPIO 14' /boot/firmware/config.txt

There must be no active dtoverlay=disable-bt.

Configure each Victron device

  1. In the VictronConnect app, add the shunt and MPPT, update firmware and mesh them together.
  2. For each device: gear → Product info → Instant readout via Bluetooth → Show.
  3. Copy the MAC address and the 32-character key.

Edit config/sccs.conf:

[victron]
shunt_address = aa:bb:cc:dd:ee:ff
shunt_key     = 0123456789abcdef0123456789abcdef

mppt_address  = 11:22:33:44:55:66
mppt_key      = fedcba9876543210fedcba9876543210

Use the actual values from the app.

Test the connection

From the project virtualenv:

cd "$SCCS_HOME"
chmod +x venv/bin/victron
source venv/bin/activate
victron discover
victron read aa:bb:cc:dd:ee:ff@0123456789abcdef0123456789abcdef
  • discover — lists nearby Instant Readout broadcasters
  • read — prints live values for one MAC@key (Ctrl+C to stop)

If victron is missing or not executable, the chmod line above usually fixes venv quirks with --system-site-packages.

Confirm while SCCS is running

journalctl -u sccs.service -f | grep -i victron

Look for something like Victron scanner active. If values stay stale: re-check MAC/key, Instant Readout enabled, range to the Raspberry Pi, and that Bluetooth is not blocked by rfkill.


← Previous: Software Configuration    |    Next: HomeKit →

Clone this wiki locally