⚠️ Important changes
- ESPHome 2026.6.0 or higher is required now (#244)
jbd_bms: Invalid UART settings (baud rate other than 9600 8N1, missingtx_pinorrx_pin) are a validation error now instead of a runtime warning (#248)- The
battery_stringssensor was renamed tocell_count. The old name still works but logs a deprecation warning (#237) - The balancer status bitmask and the
balancing_cellstext 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_upandjbd_bms_up_packcomponents for the JBD-UP16S010/UP16S020 BMS via RS485 (#223, #236) - Add ECO-WORTHY 100Ah 48V rack batteries as supported (#225)
- New
heatingbinary sensor (#272) - New
auto_retrieve_hardware_versionoption to populate thedevice_modeltext 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: Fixstate_classandentity_categoryof the bitmask sensors (#224)- Fix BLE scanner example for ESPHome 2026.9+ (#266)
Changes
passwordofjbd_bms_bleis 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
- @katrinagui made their first contribution in #243
- @hattzdotcom made their first contribution in #246
- @Fstarnb made their first contribution in #255
- @ur77se made their first contribution in #244
- @gongloo made their first contribution in #257
Full Changelog: 2.5.0...2.6.0