156 lines
9.6 KiB
YAML
156 lines
9.6 KiB
YAML
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
|
|
|
# +----------------------------------------+
|
|
# | 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;
|