# Updated : 2026.08.26 # Version : 1.1.6 # GitHub : https://github.com/syssi/esphome-jk-bms # YamBMS ( Yet another multi-BMS Merging Solution ) # This YAML is free software: you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation, either version 3 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. # See the GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . # +----------------------------------------+ # | JK BLE Errors Bitmask (32bit) | # +----------------------------------------+ # The jk_bms_ble component no longer exposes a numeric errors_bitmask sensor : a # 32bit mask does not fit in the 24bit mantissa of an ESPHome float, so the raw # value is published as the errors_bitmask_hex text sensor ("0x%08X") instead. # The bitmask is decoded from that string below. # The same commit also fixed the frame decoding : the mask is little-endian and # used to be read big-endian, which rotated the low 16 bits by one byte. The bit # layout is now identical to bms_errors_bitmask_JK_RS485_Modbus.yaml, which is # expected since both interfaces carry the same JK register. # Bits 16 to 28 are only reported by the JK02_32S protocol version. JK02_24S # reports a 16bit mask, and JK04 does not report this register at all. # Bit 0 Wire resistance 0000 0000 0000 0001 0x0001 # Bit 1 MOSFET overtemperature 0000 0000 0000 0010 0x0002 # Bit 2 Cell count is not equal to settings 0000 0000 0000 0100 0x0004 # Bit 3 Unused 0000 0000 0000 1000 0x0008 # Bit 4 Battery is fully charged 0000 0000 0001 0000 0x0010 # Bit 5 Battery pack overvoltage 0000 0000 0010 0000 0x0020 # Bit 6 Charge overcurrent 0000 0000 0100 0000 0x0040 # Bit 7 Charge short circuit 0000 0000 1000 0000 0x0080 # Bit 8 Charge overtemperature 0000 0001 0000 0000 0x0100 # Bit 9 Charge undertemperature 0000 0010 0000 0000 0x0200 # Bit 10 Coprocessor communication error 0000 0100 0000 0000 0x0400 # Bit 11 Cell undervoltage 0000 1000 0000 0000 0x0800 # Bit 12 Battery pack undervoltage 0001 0000 0000 0000 0x1000 # Bit 13 Discharge overcurrent 0010 0000 0000 0000 0x2000 # Bit 14 Discharge short circuit 0100 0000 0000 0000 0x4000 # Bit 15 Discharge overtemperature 1000 0000 0000 0000 0x8000 # Bit 16 Charging MOSFET abnormal 0001 0000 0000 0000 0000 0x10000 # Bit 17 Discharging MOSFET abnormal 0010 0000 0000 0000 0000 0x20000 # Bit 18 GPS disconnected 0100 0000 0000 0000 0000 0x40000 # Bit 19 Modify password in time 1000 0000 0000 0000 0000 0x80000 # Bit 20 Discharge on failed 0001 0000 0000 0000 0000 0000 0x100000 # Bit 21 Battery overtemperature 0010 0000 0000 0000 0000 0000 0x200000 # Bit 22 Temperature sensor anomaly 0100 0000 0000 0000 0000 0000 0x400000 # Bit 23 PL module anomaly 1000 0000 0000 0000 0000 0000 0x800000 # Bit 24 SCP release failed 0x1000000 # Bit 25 Discharge OCP II 0x2000000 # Bit 26 Discharge OCP III 0x4000000 # Bit 27 Discharge undertemperature alarm 0x8000000 # Bit 28 GPS remote lock 0x10000000 # +--------------------------------------+ # | YamBMS Errors Bitmask (16bit) | # +--------------------------------------+ # Bit 0 General alarm 0000 0000 0000 0001 0x0001 # Bit 1 Battery high voltage alarm 0000 0000 0000 0010 0x0002 # Bit 2 Battery low voltage alarm 0000 0000 0000 0100 0x0004 # Bit 3 Battery high temperature alarm 0000 0000 0000 1000 0x0008 # Bit 4 Battery low temperature alarm 0000 0000 0001 0000 0x0010 # Bit 5 Battery high temperature charge alarm 0000 0000 0010 0000 0x0020 # Bit 6 Battery low temperature charge alarm 0000 0000 0100 0000 0x0040 # Bit 7 Battery high discharge current alarm 0000 0000 1000 0000 0x0080 # Bit 8 Battery high charge current alarm 0000 0001 0000 0000 0x0100 # Bit 9 Contactor alarm 0000 0010 0000 0000 0x0200 # Bit 10 Short circuit alarm 0000 0100 0000 0000 0x0400 # Bit 11 BMS internal alarm 0000 1000 0000 0000 0x0800 # Bit 12 Cell imbalance alarm 0001 0000 0000 0000 0x1000 # Bit 13 Reserved 0010 0000 0000 0000 0x2000 # Bit 14 Reserved 0100 0000 0000 0000 0x4000 # Bit 15 Reserved 1000 0000 0000 0000 0x8000 # JK bit 4 is deliberately not mapped. Its meaning depends on the BMS firmware # generation : older firmwares report a cell overvoltage there, newer ones report # a fully charged battery. Mapping it would raise a high voltage alarm at the end # of every charge on a recent firmware, and a real overvoltage is already covered # by bit 5. Set error_overrides on the jk_bms_ble component to relabel it. sensor: - platform: template id: bms${bms_id}_yambms_errors_bitmask device_id: bms_${bms_id} name: "YamBMS Errors Bitmask" update_interval: ${bms_update_interval} accuracy_decimals: 0 icon: mdi:alert-circle-outline filters: - or: - throttle: 10s - delta: 1 lambda: |- uint32_t bms_errors_bitmask = 0; // Not published yet on the first frames, and never published by JK04. // bms_combine.yaml requires this sensor to always hold a state, so an // undecodable value has to be reported as "no error" rather than skipped. if (id(bms${bms_id}_errors_bitmask_hex).has_state()) { const std::string &hex = id(bms${bms_id}_errors_bitmask_hex).state; // Format is "0x" followed by 8 hexadecimal digits. if (hex.size() > 2) bms_errors_bitmask = (uint32_t) strtoul(hex.c_str() + 2, nullptr, 16); } uint16_t yambms_errors_bitmask = 0; if (bms_errors_bitmask > 0) { if (bms_errors_bitmask & 0x0001) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x0002) yambms_errors_bitmask |= 0x0008; if (bms_errors_bitmask & 0x0004) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x0008) yambms_errors_bitmask |= 0x0000; if (bms_errors_bitmask & 0x0010) yambms_errors_bitmask |= 0x0000; // Battery is fully charged if (bms_errors_bitmask & 0x0020) yambms_errors_bitmask |= 0x0002; if (bms_errors_bitmask & 0x0040) yambms_errors_bitmask |= 0x0100; if (bms_errors_bitmask & 0x0080) yambms_errors_bitmask |= 0x0400; if (bms_errors_bitmask & 0x0100) yambms_errors_bitmask |= 0x0020; if (bms_errors_bitmask & 0x0200) yambms_errors_bitmask |= 0x0040; if (bms_errors_bitmask & 0x0400) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x0800) yambms_errors_bitmask |= 0x0004; if (bms_errors_bitmask & 0x1000) yambms_errors_bitmask |= 0x0004; if (bms_errors_bitmask & 0x2000) yambms_errors_bitmask |= 0x0080; if (bms_errors_bitmask & 0x4000) yambms_errors_bitmask |= 0x0400; if (bms_errors_bitmask & 0x8000) yambms_errors_bitmask |= 0x0008; if (bms_errors_bitmask & 0x10000) yambms_errors_bitmask |= 0x0200; if (bms_errors_bitmask & 0x20000) yambms_errors_bitmask |= 0x0200; if (bms_errors_bitmask & 0x40000) yambms_errors_bitmask |= 0x0000; // GPS disconnected if (bms_errors_bitmask & 0x80000) yambms_errors_bitmask |= 0x0000; // Modify password in time if (bms_errors_bitmask & 0x100000) yambms_errors_bitmask |= 0x0200; if (bms_errors_bitmask & 0x200000) yambms_errors_bitmask |= 0x0008; if (bms_errors_bitmask & 0x400000) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x800000) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x1000000) yambms_errors_bitmask |= 0x0400; if (bms_errors_bitmask & 0x2000000) yambms_errors_bitmask |= 0x0080; if (bms_errors_bitmask & 0x4000000) yambms_errors_bitmask |= 0x0080; if (bms_errors_bitmask & 0x8000000) yambms_errors_bitmask |= 0x0010; if (bms_errors_bitmask & 0x10000000) yambms_errors_bitmask |= 0x0000; // GPS remote lock } return yambms_errors_bitmask;