How chipsi/esphome-jk-bms works
This ESPHome external component monitors JK-BMS devices over RS485 or BLE and exposes readings as ESPHome entities; BLE also provides configurable controls. The RS485 path parses Modbus frames and dispatches them to the BMS decoder, while the BLE implementation decodes protocol frames. The excerpts show these parsing and dispatch responsibilities, but do not expose all entity wiring or the BLE runtime call chain, so those connections are omitted or marked unverified.
Main entry points: jk_bms_ble.cpp BLE client and decoder · jk_bms.cpp RS485 BMS decoder · jk_modbus.cpp Modbus frame handler · __init__.py RS485 component setup
Components 19
RS485 monitoring
- Modbus frame handler
components/jk_modbus/jk_modbus.cpp - Modbus device registration
components/jk_modbus/__init__.py - RS485 component setup
components/jk_bms/__init__.py - RS485 BMS decoder
components/jk_bms/jk_bms.cpp
BLE monitoring
- BLE component setup
components/jk_bms_ble/__init__.py - BLE client and decoder
components/jk_bms_ble/jk_bms_ble.cpp
ESPHome entities
- RS485 entity setup
components/jk_bms/sensor.py - RS485 binary sensors
components/jk_bms/binary_sensor.py - RS485 text sensors
components/jk_bms/text_sensor.py - BLE sensor setup
components/jk_bms_ble/sensor.py - BLE binary sensors
components/jk_bms_ble/binary_sensor.py - BLE text sensors
components/jk_bms_ble/text_sensor.py - BLE buttons
components/jk_bms_ble/button/jk_button.cpp - BLE number controls
components/jk_bms_ble/number/jk_number.cpp - BLE switches
components/jk_bms_ble/switch/jk_switch.cpp
Other components
- ESPHome user
- JK-BMS
- UART interface
- BLE device
Connections 18
- ESPHome user → RS485 component setup: configures
README.md - ESPHome user → BLE component setup: configures
README.md - JK-BMS → UART interface: sends frames
README.md - UART interface → Modbus frame handler: supplies bytes
components/jk_modbus/jk_modbus.cpp - RS485 component setup → Modbus device registration: registers device
components/jk_bms/__init__.py - Modbus frame handler → RS485 BMS decoder: dispatches data
components/jk_modbus/jk_modbus.cpp - RS485 BMS decoder → RS485 entity setup: publishes readings
components/jk_bms/jk_bms.cpp - RS485 BMS decoder → RS485 binary sensors: publishes states
- RS485 BMS decoder → RS485 text sensors: publishes text
- JK-BMS → BLE device: communicates via BLE
README.md - BLE device → BLE client and decoder: provides frames
- BLE component setup → BLE client and decoder: configures client
components/jk_bms_ble/__init__.py - BLE client and decoder → BLE sensor setup: publishes readings
- BLE client and decoder → BLE binary sensors: publishes states
- BLE client and decoder → BLE text sensors: publishes text
- BLE buttons → BLE client and decoder: requests actions
- BLE number controls → BLE client and decoder: writes settings
- BLE switches → BLE client and decoder: writes settings