# Updated : 2025.12.22 # Version : 1.1.5 # 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 RS485 Modbus Errors Bitmask (24bit) | # +----------------------------------------+ # Bit 0 Wire resistance 0000 0000 0000 0001 0x0001 # Bit 1 MOS OTP 0000 0000 0000 0010 0x0002 # Bit 2 Cell quantity 0000 0000 0000 0100 0x0004 # Bit 3 Current sensor error 0000 0000 0000 1000 0x0008 # Bit 4 Cell OVP 0000 0000 0001 0000 0x0010 # Bit 5 Battery OVP 0000 0000 0010 0000 0x0020 # Bit 6 Charge OCP 0000 0000 0100 0000 0x0040 # Bit 7 Charge SCP 0000 0000 1000 0000 0x0080 # Bit 8 Charge OTP 0000 0001 0000 0000 0x0100 # Bit 9 Charge UTP 0000 0010 0000 0000 0x0200 # Bit 10 CPU aux comm error 0000 0100 0000 0000 0x0400 # Bit 11 Cell UVP 0000 1000 0000 0000 0x0800 # Bit 12 Battery UVP 0001 0000 0000 0000 0x1000 # Bit 13 Discharge OCP 0010 0000 0000 0000 0x2000 # Bit 14 Discharge SCP 0100 0000 0000 0000 0x4000 # Bit 15 Discharge OTP 1000 0000 0000 0000 0x8000 # Bit 16 Charge MOS 0001 0000 0000 0000 0000 0x10000 # Bit 17 Discharge MOS 0010 0000 0000 0000 0000 0x20000 # Bit 18 GPS disconneted 0100 0000 0000 0000 0000 0x40000 # Bit 19 Modify PWD. in time 1000 0000 0000 0000 0000 0x80000 # Bit 20 Discharge On Failed 0001 0000 0000 0000 0000 0000 0x100000 # Bit 21 Battery Over Temp Alarm 0010 0000 0000 0000 0000 0000 0x200000 # Bit 22 Temperature sensor anomaly 0100 0000 0000 0000 0000 0000 0x400000 # Bit 23 PLCModule anomaly 1000 0000 0000 0000 0000 0000 0x800000 # +--------------------------------------+ # | 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 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 = 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 |= 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 |= 0x0800; if (bms_errors_bitmask & 0x0010) yambms_errors_bitmask |= 0x0002; 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 |= 0x0010; 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 |= 0x0800; if (bms_errors_bitmask & 0x20000) yambms_errors_bitmask |= 0x0800; if (bms_errors_bitmask & 0x200000) yambms_errors_bitmask |= 0x0008; if (bms_errors_bitmask & 0x400000) yambms_errors_bitmask |= 0x0800; } return yambms_errors_bitmask;