# Updated : 2026.08.26 # Version : 1.1.0 # GitHub : https://github.com/syssi/esphome-ks-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 . # +--------------------------------------+ # | KS BLE Errors Bitmask (16bit) | # +--------------------------------------+ # Bit 0 Over current protection 0000 0000 0000 0001 0x0001 # Bit 1 Under current protection 0000 0000 0000 0010 0x0002 # Bit 2 Over voltage protection 0000 0000 0000 0100 0x0004 # Bit 3 Under voltage protection 0000 0000 0000 1000 0x0008 # Bit 4 Over temperature charge protection 0000 0000 0001 0000 0x0010 # Bit 5 Under temperature charge protection 0000 0000 0010 0000 0x0020 # Bit 6 Over temperature discharge protection 0000 0000 0100 0000 0x0040 # Bit 7 Under temperature discharge protection 0000 0000 1000 0000 0x0080 # Bit 8 Over current charge protection 0000 0001 0000 0000 0x0100 # Bit 9 Over current discharge protection 0000 0010 0000 0000 0x0200 # Bit 10 Short circuit protection 0000 0100 0000 0000 0x0400 # Bit 11 Analog front-end error 0000 1000 0000 0000 0x0800 # Bit 12 Soft lock MOS 0001 0000 0000 0000 0x1000 # Bit 13 Charge MOSFET error 0010 0000 0000 0000 0x2000 # Bit 14 Discharge MOSFET error 0100 0000 0000 0000 0x4000 # Bit 15 Reserved 1000 0000 0000 0000 0x8000 # +--------------------------------------+ # | 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 # KS bits 0 and 1 are the generic over/under current protections, they carry no # charge/discharge direction, so they are reported as a general alarm. The # directional overcurrents are bits 8 and 9. 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: |- uint16_t bms_errors_bitmask = id(bms${bms_id}_errors_bitmask).state; uint16_t yambms_errors_bitmask = 0; if (bms_errors_bitmask > 0) { if (bms_errors_bitmask & 0x0001) yambms_errors_bitmask |= 0x0001; if (bms_errors_bitmask & 0x0002) yambms_errors_bitmask |= 0x0001; if (bms_errors_bitmask & 0x0004) yambms_errors_bitmask |= 0x0002; if (bms_errors_bitmask & 0x0008) yambms_errors_bitmask |= 0x0004; if (bms_errors_bitmask & 0x0010) yambms_errors_bitmask |= 0x0020; if (bms_errors_bitmask & 0x0020) yambms_errors_bitmask |= 0x0040; if (bms_errors_bitmask & 0x0040) yambms_errors_bitmask |= 0x0008; if (bms_errors_bitmask & 0x0080) yambms_errors_bitmask |= 0x0010; if (bms_errors_bitmask & 0x0100) yambms_errors_bitmask |= 0x0100; if (bms_errors_bitmask & 0x0200) yambms_errors_bitmask |= 0x0080; if (bms_errors_bitmask & 0x0400) yambms_errors_bitmask |= 0x0400; if (bms_errors_bitmask & 0x0800) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x1000) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x2000) yambms_errors_bitmask |= 0x0200; if (bms_errors_bitmask & 0x4000) yambms_errors_bitmask |= 0x0200; if (bms_errors_bitmask & 0x8000) yambms_errors_bitmask |= 0x0000; } return yambms_errors_bitmask;