DOCSEARCHbyAlgolia
Submit Docs

dbus-serialbattery for Venus OS

website·Indexed 30 days ago

https://mr-manuel.github.io/venus-os_dbus-serialbattery_docs

Driver for Venus OS that enables communication with various Battery Management Systems (BMS) via UART/TTL, RS485/Modbus, CAN, and Bluetooth. The documentation covers installation via USB/SD card or SSH, supported BMS models, hardware connection requirements including galvanic isolation, and operational modes for SoC calculation and cell data monitoring. Includes version-specific guides for v1.3, v1.4, v1.6, and development builds.

Tokens
46.7K
Snippets
166
Records
366
Agent score
25%

What's inside dbus-serialbattery

  1. Overview of dbus-serialbattery driver

    v1.6.20250131
    The dbus-serialbattery driver allows Venus OS devices (Victron GX devices or Raspberry Pi running Venus OS) to interface with a Battery Management System (BMS). It acts as a 'Battery monitor' and 'Controlling BMS' within the GX device, publishing battery data to the system dbus to enable monitoring and control of battery charge and discharge.

  2. Overview of dbus-serialbattery driver capabilities

    v1.4.20240928
    The dbus-serialbattery driver supports batteries with 3 to 32 cells and acts as a Battery Monitor within Venus OS. It provides real-time updates for voltage, current, power, SoC, temperatures (battery and mosfet), consumed Ah, time-to-go, and detailed cell data (min/max/diff). It also handles BMS alarms, charge cycle history, and DVCC parameters including Charge Voltage Limit (CVL), Charge Current Limit (CCL), and Discharge Current Limit (DCL). Note that CVL (battery max) is automatically calculated as cell count * 3.45V and battery min as cell count * 3.1V.

  3. Overview of dbus-serialbattery driver

    v1.4.20240928
    The dbus-serialbattery driver allows Venus OS devices to interface with a Battery Management System (BMS). It acts as a 'Battery monitor' and 'Controlling BMS' within the GX device, publishing battery data to the system dbus to enable monitoring of key values and control of battery charge/discharge. It supports the following communication protocols: RS232, RS485, TTL UART, Bluetooth, and CAN.

  4. Overview of dbus-serialbattery driver

    The dbus-serialbattery driver is designed for Venus OS devices, including any Victron GX device or a Raspberry Pi running the Venus OS image. It interfaces with a Battery Management System (BMS) to serve as a Battery monitor and Controlling BMS within the GX device, allowing for the monitoring of key battery values and control of charge/discharge cycles. The driver publishes data to the Venus OS system via dbus.

  5. Overview of data provided by the dbus-serialbattery driver

    v1.6.20250131

    The driver supports batteries with 3 to 32 cells and provides the following data (depending on BMS capabilities):

    • Basic Data: Voltage, Current, Power, SoC, Battery/MOSFET temperatures, Capacity, Min/Max cell voltage/temp, Balancing state, and Charge/Discharge/Balance permissions.
    • Cell Data: Individual cell voltages (1-32), balancing status (1-32), and Min/Max/Diff values.
    • Alarms: Voltage (Low/High), Cell Voltage (Low/High), Low SoC, Cell imbalance, Current (High charge/discharge), Temperature (Low/High/Internal), and BMS cable faults.
    • Driver-Specific Features: DVCC parameter setting (CVL, CCL, DCL), 5-minute current averaging, Time-to-go, and support for external current sensors (e.g., SmartShunt).

  6. Overview of dbus-serialbattery driver

    The dbus-serialbattery driver is designed for Venus OS devices (including Victron GX devices and Raspberry Pis running the Venus OS image). It interfaces with a Battery Management System (BMS) to serve as a 'Battery monitor' and 'Controlling BMS' within the GX device, publishing data to the system dbus to enable monitoring and control of battery charge and discharge. It supports the following communication protocols: RS232, RS485, TTL UART, Bluetooth, and CAN.

  7. Overview of dbus-serialbattery driver

    v1.3.20240705-or-older
    The dbus-serialbattery driver allows Venus OS devices (Victron GX devices or Raspberry Pi running Venus OS) to interface with a Battery Management System (BMS). It supports communication via serial (RS232, RS485, or TTL UART), Bluetooth, and CAN. The driver publishes data to the Venus OS system (dbus), acting as a Battery monitor and Controlling BMS to enable monitoring of key values and control of battery charge/discharge.

  8. Overview of dbus-serialbattery driver features

    v1.3.20240705-or-older
    The dbus-serialbattery driver allows Venus OS to interface with batteries containing 3 to 32 cells. It acts as a Battery Monitor, providing real-time updates for voltage, current, power, SoC, temperatures (battery and mosfet), consumed Ah, time-to-go, and detailed cell metrics (min/max/diff). It also handles BMS alarms, charge cycle history, and DVCC parameters including Charge Voltage Limit (CVL), Charge Current Limit (CCL), and Discharge Current Limit (DCL). CVL and battery minimums are automatically adjusted based on cell count (3.45V and 3.1V per cell respectively).

  9. Understand the dbus-serialbattery driver service architecture

    v1.3.20240705-or-older

    The driver uses a service-based architecture managed by the serial starter:

    • Configuration: During installation, a config file is created at /data/conf/serial-starter.d/dbus-serialbattery.conf.
    • Serial Services: The serial starter service (/service/serial-starter) creates a service for each detected serial port (e.g., /service/dbus-serialbattery.ttyUSB0), which executes /opt/victronenergy/dbus-serialbattery/start-serialbattery.sh [port].
    • Bluetooth Services: Services are created as /service/dbus-blebattery.[number], executing the python driver with the BMS type and MAC address (e.g., dbus-serialbattery.py Jkbms_Ble C8:47:8C:00:00:00).
    • CAN Services: Services are created as /service/dbus-canbattery.[port] (e.g., /service/dbus-canbattery.can0), executing /opt/victronenergy/dbus-serialbattery/start-serialbattery.sh [port].

  10. Configure Battery Monitor and Controlling BMS in Venus OS

    v1.6.20250131

    The driver allows two primary operational modes in Venus OS, which can be used independently or together:

    1. Battery Monitor: Used to display battery settings on the brief and overview pages. Enable this by selecting the connected battery/BMS under Settings -> System setup.
    2. Controlling BMS: Used to regulate charger and inverter parameters based on battery values for smooth regulation. Enable this by selecting the connected battery/BMS under Settings -> DVCC.

  11. Configure dbus-serialbattery operational modes in Venus OS

    The dbus-serialbattery driver supports batteries with 3 to 32 cells and can be used in two primary modes in Venus OS (either or both can be enabled):

    1. Battery Monitor: Used to display battery settings on the brief and overview pages. Enable by selecting the connected battery/BMS under Settings -> System setup.
    2. Controlling BMS: Used to regulate charger and inverter parameters based on battery values for smooth regulation. Enable by selecting the connected battery/BMS under Settings -> DVCC.

  12. Configure Venus OS Battery Monitor and BMS Control

    The dbus-serialbattery driver allows for two primary operational roles in Venus OS, which can be used independently or together:

    1. Battery Monitor: Used to display battery settings on the brief and overview pages. Configuration is found under Settings -> System setup.
    2. Controlling BMS: Used to regulate charger and inverter parameters based on battery values for smooth regulation. Configuration is found under Settings -> DVCC.