Files
esphome-yambms/examples/single-node/LP_BMS_example_DEMO_Shunt_and_BMS.yaml
T
Sleeper85 7d347ae626 Examples - Add bms_fake_equalizing_enabled
Every example including a BMS that ships Fake Equalizing (EG4 LL V2,
Seplos V1/V2, Seplos V3, Demo BMS) now declares
bms_fake_equalizing_enabled on each BMS, with a comment explaining what
enabling it does and warning that a BMS without a balancer can stay in
Cut-Off for a long time before reaching EOC.

The EG4 and Seplos examples set it to 'false', the package default. The
DEMO examples set it to 'true'.
2026-11-19 04:18:57 +01:00

121 lines
5.9 KiB
YAML

# Updated : 2026.02.16
# Version : 1.1.4
# GitHub : https://github.com/Sleeper85/esphome-yambms
# 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>.
############################ Local Packages Example ############################
# This is not a working YAML but just code ready to copy into
# your main YAML below the `packages:` section.
################################################################################
packages:
shunt1: !include
file: packages/shunt/shunt_combine_FAKE.yaml
vars:
shunt_id: '1' # must be a number
shunt_name: 'Shunt 1'
# Shunt sensors values
shunt_voltage: '52.81' # V
shunt_current: '17.5' # A
shunt_power: '924' # W
shunt_soc: '50' # %
shunt_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
bms1: !include
file: packages/bms/bms_combine_DEMO.yaml
vars:
bms_id: '1' # must be a number
bms_name: 'BMS 1'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_current: '9.2' # A
bms_soc: '87' # %
bms_soh: '98' # %
bms_min_cell_voltage: '3.339' # V
bms_max_cell_voltage: '3.341' # V
bms_min_temperature: '9.1' # °C
bms_max_temperature: '9.3' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
# Fake Equalizing: this BMS does not report its balancing state. When enabled, YamBMS infers it
# from the cell spread and holds the Cut-Off timer while the pack balances, instead of ending the charge.
# Warning: a BMS without a balancer (or with balancing disabled) never closes its cell spread, so it can
# stay in Cut-Off a long time, until the EOC timer (30min default) ends the charge, or forever if disabled.
bms_fake_equalizing_enabled: 'true' # true/false, false by default
bms_charging_cycles: '178' # charging cycles number Used to calculate the SoH
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
bms2: !include
file: packages/bms/bms_combine_DEMO.yaml
vars:
bms_id: '2' # must be a number
bms_name: 'BMS 2'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_current: '11.3' # A
bms_soc: '85' # %
bms_soh: '89' # %
bms_min_cell_voltage: '3.337' # V
bms_max_cell_voltage: '3.339' # V
bms_min_temperature: '15.1' # °C
bms_max_temperature: '15.3' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
# Fake Equalizing: this BMS does not report its balancing state. When enabled, YamBMS infers it
# from the cell spread and holds the Cut-Off timer while the pack balances, instead of ending the charge.
# Warning: a BMS without a balancer (or with balancing disabled) never closes its cell spread, so it can
# stay in Cut-Off a long time, until the EOC timer (30min default) ends the charge, or forever if disabled.
bms_fake_equalizing_enabled: 'true' # true/false, false by default
bms_charging_cycles: '226' # charging cycles number Used to calculate the SoH
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
bms3: !include
file: packages/bms/bms_combine_DEMO.yaml
vars:
bms_id: '3' # must be a number
bms_name: 'BMS 3'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_current: '15.7' # A
bms_soc: '83' # %
bms_soh: '79' # %
bms_min_cell_voltage: '3.334' # V
bms_max_cell_voltage: '3.336' # V
bms_min_temperature: '20.1' # °C
bms_max_temperature: '20.3' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
# Fake Equalizing: this BMS does not report its balancing state. When enabled, YamBMS infers it
# from the cell spread and holds the Cut-Off timer while the pack balances, instead of ending the charge.
# Warning: a BMS without a balancer (or with balancing disabled) never closes its cell spread, so it can
# stay in Cut-Off a long time, until the EOC timer (30min default) ends the charge, or forever if disabled.
bms_fake_equalizing_enabled: 'true' # true/false, false by default
bms_charging_cycles: '194' # charging cycles number Used to calculate the SoH
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable