--- title: "Controlling a BLE Battery with an ESP32 and Home Assistant" date: 2026-11-17 tldr: "How I connected a JBD BMS lithium battery over Bluetooth Low Energy using an ESP32 as a BLE proxy, and how I control charging and discharging safely in Home Assistant." tags: - Home Assistant - ESP32 - ESPHome - Bluetooth - Battery - Smart Home layout: post.njk lang: en translationKey: controlling-ble-battery-esp32-home-assistant --- I have a lithium battery with a **JBD BMS** (Battery Management System) sitting in my office. Out of the box, it only talks over Bluetooth Low Energy (BLE)—which is fine if you want to stand next to it with a phone app, but completely useless if you want to automate it in Home Assistant. Instead of running a USB-to-RS485 cable across the room, I used a cheap **ESP32** running ESPHome as a BLE bridge (`ble-exporter`). That gives me full visibility into the battery's state and—more importantly—control over its charging switch directly from Home Assistant. ## The ESP32 BLE Bridge ![Controlling a BLE Battery via ESP32 & Home Assistant](/img/ble-battery-esp32-ha.svg) The ESP32 sits near the battery and acts as a Bluetooth proxy/exporter. Once it's connected to the JBD BMS over BLE, Home Assistant gets a whole set of entities: - **State of Charge (SoC):** `sensor.jbd_bms_ble_jbd_bms_ble_state_of_charge` - **Cell Voltages:** `sensor.jbd_bms_ble_jbd_bms_ble_cell_voltage_*`, plus min, max, average, and `delta_cell_voltage` - **Current & Remaining Capacity:** `sensor.jbd_bms_ble_*_current` and `sensor.jbd_bms_ble_*_capacity_remaining` - **Charging Control:** `switch.jbd_bms_ble_jbd_bms_ble_charging` One thing I learned quickly: JBD BMS units only allow one active BLE connection at a time. If your phone app is connected, the ESP32 won't be able to read or control anything until you close the app. ## Controlling Charging in Scripts Having `switch.jbd_bms_ble_jbd_bms_ble_charging` in Home Assistant means I can cleanly disable charging at the BMS level whenever I switch my office into island (battery) mode. In my `scripts.yaml`, the switch-over sequence turns off the charger smart plug and the BMS charging switch first, waits a few seconds for the load to stabilize, and then switches the inverter and load: ```yaml office_stromquelle_auf_batterie: alias: "Office-Stromquelle: Umschalten auf Batterie (Inselbetrieb)" mode: single sequence: - action: switch.turn_off target: entity_id: - switch.jbd_bms_ble_jbd_bms_ble_charging - action: light.turn_off target: entity_id: light.shelly_office_charger - delay: seconds: 5 # ... disconnect load, wait, switch inverter, reconnect load ``` ## Safety Automations Leaving a battery to discharge unattended without a fallback is asking for trouble. I have two layers of protection in `automations.yaml` that watch `sensor.jbd_bms_ble_jbd_bms_ble_state_of_charge`: 1. **Normal discharge limit (≤ 10% SoC):** Switches the office back to grid power, puts the battery controller into `standby`, and sends me a Telegram message. 2. **Emergency fallback (≤ 5% SoC):** Regardless of what mode anything is in, it forces the grid power plugs back on and sends a critical alert. ```yaml - id: buro_office_batterie_notstrom_fallback alias: 'Büro: Notstrom-Fallback bei schwacher Office-Batterie' trigger: - trigger: numeric_state entity_id: sensor.jbd_bms_ble_jbd_bms_ble_state_of_charge below: 6 action: - action: switch.turn_on target: entity_id: - switch.plug_office_no_ups - switch.plug_office_river - action: telegram_bot.send_message data: chat_id: !secret telegram_chat_id message: '🪫 Office-Batterie: Ladestand kritisch ({{ states("sensor.jbd_bms_ble_jbd_bms_ble_state_of_charge") }}%), reguläre Stromversorgung wiederhergestellt.' ``` ## What to Watch Out For - **Recorder bloat:** Cell voltages and current update frequently. I excluded `sensor.jbd_bms_ble_jbd_bms_ble_cell_voltage_*` and a few other noisy sensors from Home Assistant's recorder in `configuration.yaml` so my database doesn't grow unnecessarily. - **BLE range:** Keep the ESP32 close to the battery. Metal battery cases or nearby inverters can kill the BLE signal fast. Overall, using an ESP32 as a BLE bridge is a cheap, reliable way to bring a "dumb" Bluetooth-only battery into Home Assistant without opening up the case or soldering anything.