Tak: Mange tak til den oprindelige udvikler og forfatter af projektet dbus-serialbattery. Dette bidrag bygger på den officielle projektstruktur og den tekniske dokumentation.

Originalprojekt (GitHub): mr-manuel/venus-os_dbus-serialbattery

I autocampere, på både samt i off-grid-systemer ønsker stadig flere brugere at integrere Bluetooth-kompatible LiFePO₄-batterier direkte i Victron Venus OS for centralt at kunne overvåge alle systemdata på en GX-enhed og i VRM-portalen.

Denne vejledning viser trin for trin, hvordan driveren dbus-serialbattery installeres på en Victron GX-enhed, og hvordan batteridata via Bluetooth derefter vises i Venus OS. De beskrevne trin tager udgangspunkt i virkelige anvendelsesscenarier med Lithink Bluetooth-LiFePO₄-batterier.

Vigtig bemærkning: Bluetooth-forbindelser kan variere afhængigt af omgivelserne (afstand, metalskærmning, elektromagnetiske forstyrrelser eller BLE-implementering). Korte udfald i enkelte værdier skyldes som regel radiolinket og er ikke et tegn på en fejl i batteriet eller BMS'et.

1) Hvad er Venus OS, og hvad gør dbus-serialbattery?

Venus OS er operativsystemet til Victron GX-enheder som Cerbo GX, Ekrano GX eller en Raspberry Pi med installeret Venus OS. Det indsamler måle- og statusdata fra hele energisystemet (batteri, inverter, ladere, PV-regulator) og viser dem centralt i Remote Console samt i VRM-portalen.

dbus-serialbattery er en ekstra batteridriver, der gør det muligt at integrere BMS-data fra batterier fra tredjepart i Venus OS. Det omfatter blandt andet batterispænding, lade- og afladningsstrøm, ladetilstand (SoC) samt – afhængigt af det pågældende BMS – cellespenninger og temperaturværdier.

For Bluetooth-kompatible batterier sker denne tilkobling trådløst via BLE. Derfor er denne løsning særligt velegnet til eftermonteringer i autocampere, både og off-grid-systemer, hvor der ikke er planlagt en direkte seriel forbindelse.

2) Forudsætninger

  1. Victron GX-enhed: Cerbo GX, Ekrano GX eller en Raspberry Pi med installeret Venus OS.
  2. Netværksforbindelse: GX-enheden og computeren befinder sig i det samme lokale netværk (LAN eller WLAN).
  3. SSH- / Root-adgang: Root Access skal være aktiveret i henhold til Victrons dokumentation.
  4. Bluetooth-understøttelse: GX-enheden har indbygget eller kompatibel Bluetooth.
  5. Forberedt batteri: Batteriet er tændt, Bluetooth er aktivt, og batteriet er inden for GX-enhedens rækkevidde.

Praktisk tip: Ved den første konfiguration anbefales det at placere batteriet og GX-enheden så tæt på hinanden som muligt. Det gør Bluetooth-detektionen lettere og reducerer fejlfinding.

3) Trin 1: Aktivér SSH og find IP-adressen

  1. Aktivér SSH: Åbn Remote Console på GX-enheden, og aktivér SSH-adgangen. Afhængigt af versionen finder du denne mulighed under Settings → Services → SSH on LAN.
  2. Find IP-adressen: Under Settings → Ethernet / Wi-Fi vises den aktuelle IP-adresse (f.eks. 192.168.1.55).
  3. Tjek Root-adgang: Sørg for, at Root Access er opsat i henhold til Victrons vejledning.

4) Trin 2: Opret forbindelse til GX-enheden via SSH

Windows

  1. Værktøj: Installer PuTTY eller brug Windows Terminal.
  2. Forbindelse: Indtast GX-enhedens IP-adresse som værtsnavn, port 22, protokol SSH.
  3. Log ind: Log ind med root-brugerkontoen.

macOS / Linux

  1. Åbn Terminal.
  2. Kør SSH-kommando:
ssh root@192.168.1.55

Erstat IP-adressen med IP-adressen til din GX-enhed.

5) Trin 3: Installer dbus-serialbattery

  1. Download installationsscript:
wget -O /tmp/install.sh https://raw.githubusercontent.com/mr-manuel/venus-os_dbus-serialbattery/master/dbus-serialbattery/install.sh
  1. Kør installationsscript:
bash /tmp/install.sh
  1. Vælg version: I de fleste tilfælde er Latest release den anbefalede mulighed.
  2. Genstart GX-enheden:
reboot

Bemærkning: Efter genstart kan det tage 1–3 minutter, før alle services er startet helt op.

6) Trin 4: Læs batteriets Bluetooth-MAC-adresse

Til Bluetooth-tilkoblingen skal batteriets MAC-adresse bruges. Den angives i næste trin i konfigurationsfilen.

  1. Start Bluetooth-værktøj:
bluetoothctl
  1. Aktivér scanning:
scan on
  1. Vis fundne enheder:
devices

Eksempeloutput:

Device AA:BB:CC:11:22:33 Battery-BLE
  1. Notér MAC-adressen: f.eks. AA:BB:CC:11:22:33.
  2. Stop scanning:
scan off
quit

Vigtigt: Hvis batteriet samtidig er forbundet til en smartphone-app, kan registreringen på GX-enheden blive påvirket. Ved opsætning anbefales det midlertidigt at afbryde telefonforbindelsen.

7) Trin 5: Opret config.ini og konfigurer Bluetooth

Driveren bruger filen config.ini. Den første linje skal være præcis [DEFAULT] ellers indlæses konfigurationen ikke korrekt.

7.1 Åbn config.ini

nano /data/apps/dbus-serialbattery/config.ini

7.2 Minimal Bluetooth-konfiguration

[DEFAULT]
BLUETOOTH_BMS =  AA:BB:CC:11:22:33

Det korrekte drivernavn kan slås op i følgende fil:

/data/apps/dbus-serialbattery/config.default.ini

7.3 Gem og luk

  1. Gem: Ctrl + O, derefter Enter.
  2. Afslut: Ctrl + X.

Typisk fejl: Mangler afsnittet [DEFAULT] eller er det stavet forkert, starter driveren ikke korrekt.

8) Trin 6: Aktivér services og genstart driveren

  1. Kør enable-script:
bash /data/apps/dbus-serialbattery/enable.sh
  1. Genstart driveren:
bash /data/apps/dbus-serialbattery/restart.sh
  1. Valgfrit: Ved ændringer i BLUETOOTH_BMS anbefales en genstart:
reboot

9) Trin 7: Vis batteriet i Venus OS

  1. Åbn Remote Console.
  2. Vælg Battery Monitor under Settings → System setup.
  3. Efter vellykket opsætning vises en post fra dbus-serialbattery med de aktuelle batteriværdier.

Hvilke værdier der vises, afhænger af de data, som BMS'et leverer.

10) Fejlfinding

Problem A: Batteriet vises ikke

  1. Tjek MAC-adressen.
  2. Sammenlign drivernavnet med config.default.ini.
  3. Reducer afstanden mellem batteriet og GX.
  4. Kør enable.sh, restart.sh og reboot igen.

Problem B: Bluetooth-scanning finder ingen enheder

  1. Er batteriet tændt, og er Bluetooth aktivt?
  2. Afbryd smartphone-Bluetooth.
  3. Start scanning igen.

Problem C: Værdierne falder sporadisk ud

  1. Tjek Bluetooth-miljøet.
  2. Undgå parallelle forbindelser.
  3. Genstart GX-enheden eller driveren.

11) Bemærkninger til Lithink Bluetooth-batterier

I praksis viser det sig, at en stabil integration ikke kun afhænger af softwaren, men også af batteriets BMS-opsætning.

Lithink Bluetooth-LiFePO₄-batterier er designet til at arbejde med klare datastrukturer og stabile fabriksindstillinger. I Victron Venus OS kan de som regel integreres uden omfattende tilpasninger.

  • Fabriksindstillede BMS-parametre til autocamper- og off-grid-anvendelser
  • Bluetooth-datastruktur kompatibel med dbus-serialbattery
  • Ingen gentagne manuelle BMS-tilpasninger nødvendige
  • Stabil dataopdatering ved enkeltforbindelse

Ved første ibrugtagning anbefales det udelukkende at forbinde GX-enheden med batteriet og først bruge smartphone-apps, når integrationen er gennemført.

Tak

Mange tak til den oprindelige udvikler af dbus-serialbattery for at stille dette åbne og udvidelige projekt til rådighed.

GitHub-projekt: mr-manuel/venus-os_dbus-serialbattery

1 kommentar

1 kommentar

  • Christian
    • Christian
    • 10. februar 2026 kl. 00.45

    Hallo
    hat das jemand zum laufebin bekommen?

Efterlad en kommentar

'

Denne side er beskyttet af hCaptcha, og hCaptchas Politik om beskyttelse af persondata og Servicevilkår er gældende.

Seneste historier

Dette afsnit indeholder intet indhold