github syssi/esphome-jbd-bms 2.6.0

one hour ago

⚠️ Important changes

  • ESPHome 2026.6.0 or higher is required now (#244)
  • jbd_bms: Invalid UART settings (baud rate other than 9600 8N1, missing tx_pin or rx_pin) are a validation error now instead of a runtime warning (#248)
  • The battery_strings sensor was renamed to cell_count. The old name still works but logs a deprecation warning (#237)
  • The balancer status bitmask and the balancing_cells text sensor report different (correct) values now (#257)

⚠️ Safety notice

  • Do not connect the UART-TTL ports of multiple BMS units to one ESP without galvanic isolation. See the README for details (#255)

Features

  • New jbd_bms_up and jbd_bms_up_pack components for the JBD-UP16S010/UP16S020 BMS via RS485 (#223, #236)
  • Add ECO-WORTHY 100Ah 48V rack batteries as supported (#225)
  • New heating binary sensor (#272)
  • New auto_retrieve_hardware_version option to populate the device_model text sensor automatically (#263)
  • Respect the 10x current and capacity scaling flag (#262)
  • jbd_bms_ble: Configurable GATT service and characteristic UUIDs and JBD-DH04SC02 example (#233, #235)
  • jbd_bms_ble: Warn if the BMS requires a password (#275)
  • Invalidate telemetry and protection binary sensors when the BMS is offline (#276)

Fixes

  • Correct the 32-bit balancer status bitmask word order and cell indexing (#257, #265)
  • Mask the upper status bits when writing the MOSFET control register (#258)
  • Accept error counts responses of older firmware versions (#259)
  • Validate stop byte, status code and basic info bounds (#261)
  • jbd_bms: Add an inter-frame delay between chained commands (#264)
  • jbd_bms_ble: Fix premature end-of-frame detection (#246)
  • jbd_bms: Fix state_class and entity_category of the bitmask sensors (#224)
  • Fix BLE scanner example for ESPHome 2026.9+ (#266)

Changes

  • password of jbd_bms_ble is marked as sensitive (#244)
  • Switch and button entities no longer register as separate components (#286)
  • Sub-devices of the multiple-devices example use relation: via (requires ESPHome 2026.11.0) (#268)
  • Maintenance: adopt ESPHome helpers (ESPHOME_LOG_TAG, format_hex_pretty_to, final_validate_device_schema, unit and icon constants), code cleanups (#227, #241, #243, #249, #250, #251, #252, #253, #254, #277, #278, #279, #283, #284)

Pull requests

  • Fix state_class and entity_category in jbd_bms sensors by @syssi in #224
  • Add jbd_bms_up and jbd_bms_up_pack components for UP16S010 BMS via RS485 by @syssi in #223
  • Add ECO-WORTHY 100Ah 48v as supported by @syssi in #225
  • Remove unused locally defined unit constants by @syssi in #227
  • CI: Remove pio warmup step for esp32-idf-tidy by @syssi in #228
  • Add PDUs of two JDB-UP16S020 devices on the same bus by @syssi in #230
  • Replace synthetic frames with real JBD-UP16S020 captures (jbd_bms_up) by @syssi in #231
  • Make GATT service and characteristic UUIDs configurable (jbd_bms_ble) by @syssi in #233
  • Add JBD-DH04SC02 example config with different characteristic UUIDs by @syssi in #235
  • Decode all remaining pack status fields in jbd_bms_up_pack by @syssi in #236
  • Rename sensor battery_strings to cell_count (#51) by @syssi in #237
  • Drop Python 3.11 support by @syssi in #239
  • Rename command 0x03 handling from "hardware info" to "basic info" by @syssi in #241
  • Align remaining command 0x03 comments with basic info terminology by @katrinagui in #243
  • Fix premature end-of-frame detection in BLE frame assembly by @hattzdotcom in #246
  • Migrate deprecated check_uart_settings to final_validate_device_schema by @syssi in #248
  • Declare log tags with ESPHOME_LOG_TAG by @syssi in #249
  • Add DOMAIN constant to components by @syssi in #250
  • Use DOMAIN in uart final validate schema by @syssi in #251
  • Remove ADDR_STR compatibility shim for ESPHome < 2025.12.0 by @syssi in #253
  • Migrate format_hex_pretty to format_hex_pretty_to by @syssi in #252
  • Use icon constants from ESPHome core by @syssi in #254
  • docs: warn about shared ground when multiple BMS share one ESP by @Fstarnb in #255
  • Fix two warnings of recent ESPHome releases and newer compiler toolchains by @ur77se in #244
  • fix(balancer): correct 32-bit balancer status bitmask word order and cell indexing by @gongloo in #257
  • fix(mosfet): mask upper status bits when writing mosfet control register by @gongloo in #258
  • fix(error_counts): accept >=22-byte error counts responses for older firmware compatibility by @gongloo in #259
  • fix(parser): validate stop byte, check status code, and guard basic info bounds by @gongloo in #261
  • feat(telemetry): respect 10x current and capacity scaling flag (Bit 7 of byte 20) by @gongloo in #262
  • fix(balancer): clamp cell count to 32 when decoding balancing cells by @syssi in #265
  • fix(model): automatically populate device model text sensor when configured by @gongloo in #263
  • Fix BLE scanner example for ESPHome 2026.9 StringRef device names by @syssi in #266
  • Replace flake8 with ruff docstring rules by @syssi in #267
  • Add relation to sub-devices and require ESPHome 2026.11.0 by @syssi in #268
  • Align pre-commit config with other projects by @syssi in #269
  • fix(uart): add inter-frame turnaround delay between chained commands by @gongloo in #264
  • Install yq in restore-python fallback by @syssi in #273
  • Add heating binary sensor by @syssi in #272
  • Invalidate telemetry and protection binary sensors when BMS is offline by @gongloo in #276
  • Use this-> consistently in publish_device_unavailable_() by @syssi in #277
  • Warn if a BLE BMS requires a password by @syssi in #275
  • Move duplicated constants into const.py by @syssi in #278
  • Move remaining duplicated constants into const.py by @syssi in #279
  • Do not reject constants shared between sibling components in CI by @syssi in #280
  • Update pre-commit hooks and pin the minimum ESPHome version by @syssi in #282
  • Remove unused includes by @syssi in #283
  • Remove empty loop() overrides by @syssi in #284
  • Update the minimum ESPHome version in the README to 2026.6.0 by @syssi in #285
  • Drop the Component base from the switch and button entities by @syssi in #286

New Contributors

Full Changelog: 2.5.0...2.6.0

Don't miss a new esphome-jbd-bms release

NewReleases is sending notifications on new releases.