/home-assistant-bms-tools-integration

Integrates JBD / Overkill Solar Battery Management Systems connected via USB into Home Assistant

Primary LanguagePythonMIT LicenseMIT

Home Assistant BMS Tools Integration

This integration is based on the BMS Tools project by Eric Poulsen: https://gitlab.com/bms-tools/bms-tools

A config flow is available that allows selecting the serial port of the connected BMS and assigning a serial number to connect multiple BMS.
Bluetooth is not supported (yet) by the underlying library.

Installation

Installable via HACS as custom repository (guide).

Currently supported BMS

  • JBD / Overkill Solar

Features

Sensors:

  • Battery voltage
  • Battery current
  • Battery power
  • Battery state of charge (%)
  • Cell voltages
  • Cell balancing status
  • Cycle count
  • Temperature

Controls:

  • Charging switch
  • Discharging switch

Support for Home Assistant Energy Management

Since this feature needs two separate sensors for charge and discharge, two additional sensors are available:

  • Battery charge power
  • Battery discharge power

Steps:

  1. Add two Riemann sum integral sensors by adding this to your configuration.yaml: 
    sensor:
  - platform: integration
    source: sensor.charge_power
    name: Battery Charged Energy
    unit_prefix: k
    round: 2
  - platform: integration
    source: sensor.discharge_power
    name: Battery Discharged Energy
    unit_prefix: k
    round: 2
    See https://www.home-assistant.io/integrations/integration/ for more information.
  2. Restart Home Assistant
  3. Now you can add the two new sensors to the energy dashboard

Note that you have to charge and discharge your battery a little to have the sensors show values, otherwise they will only show Unknown.