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'.
121 lines
5.9 KiB
YAML
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
|