# 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 . ############################ 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