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'.
403 lines
20 KiB
YAML
403 lines
20 KiB
YAML
# Updated : 2026.11.19
|
||
# Version : 1.8.2
|
||
# 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>.
|
||
|
||
######################## YamBMS Remote Packages Version ########################
|
||
|
||
# You can compile this YAML directly without the `packages` folder.
|
||
# The packages will be automatically downloaded from GitHub.
|
||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||
|
||
################################################################################
|
||
|
||
# If needed, configure a static IP here
|
||
# wifi:
|
||
# manual_ip:
|
||
# static_ip: 192.168.0.85
|
||
# gateway: 192.168.0.1
|
||
# subnet: 255.255.255.0
|
||
# dns1: 8.8.8.8
|
||
# dns2: 8.8.4.4
|
||
|
||
logger:
|
||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||
# baud_rate: 115200 # Send logs to the `hardware_uart` USB output (this consumes a UART interface)
|
||
# hardware_uart: UART0 # UART0 / USB_SERIAL_JTAG
|
||
|
||
ota:
|
||
- platform: esphome
|
||
|
||
# Uncomment:
|
||
# API: to monitor entities via Home Assistant
|
||
# MQTT: to monitor entities via another system
|
||
# Neither: to monitor entities only via `web_server` or nothing
|
||
|
||
api:
|
||
reboot_timeout: 0s
|
||
|
||
# mqtt:
|
||
# broker: !secret mqtt_host
|
||
# username: !secret mqtt_username
|
||
# password: !secret mqtt_password
|
||
# id: mqtt_client
|
||
|
||
# +--------------------------------------+
|
||
# | Global Settings |
|
||
# +--------------------------------------+
|
||
substitutions:
|
||
# This project uses the `sub-device` function of ESPHome to prefix entity names.
|
||
# This allows to group entities into logical devices that appear separately in Home Assistant.
|
||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name must be unique)
|
||
friendly_name : 'YamBMS' # Name of your board (prefix for board entities)
|
||
# +--------------------------------------+
|
||
# | YamBMS Settings |
|
||
# +--------------------------------------+
|
||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||
yambms_id: '1' # Number without spaces
|
||
yambms_name: 'YamBMS 1' # Prefix for YamBMS entities
|
||
yambms_update_interval: '1s'
|
||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||
yambms_input_number_mode: 'slider'
|
||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||
# These parameters are important and used for charging logic.
|
||
# Battery Chemistry
|
||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||
# Number of cells in series
|
||
yambms_cell_count: '16'
|
||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||
yambms_bulk_v: '55.2'
|
||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||
yambms_float_v: '53.6'
|
||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||
yambms_rebulk_v: '52.8'
|
||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||
# This timer can be deactivated with a switch
|
||
yambms_eoc_timer: '30'
|
||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||
yambms_cutoff_timer: '180'
|
||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||
yambms_max_requested_charge_current: '300' # in Ampere
|
||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||
# +-------------------------------------------------------------------------
|
||
# | Temperature-based current limitation
|
||
# | Can be disabled via the switch "Temperature-based current limitation"
|
||
# | This factor is applied to the battery capacity (Ah), not the current
|
||
# | maximum charge/discharge current. For example : 280Ah x 0.5 = 140A
|
||
# +-------------------------------------------------------------------------
|
||
# Temperature °C -> Charge Rate (0.0C to 1.0C)
|
||
yambms_charging_rate_table: |
|
||
{
|
||
{ -0.1, 0.00 },
|
||
{ 0.0, 0.05 },
|
||
{ 5.0, 0.12 },
|
||
{ 10.0, 0.30 },
|
||
{ 20.0, 0.50 },
|
||
{ 25.0, 0.50 },
|
||
{ 45.0, 0.50 },
|
||
{ 50.0, 0.50 },
|
||
{ 55.0, 0.50 },
|
||
{ 60.0, 0.00 }
|
||
}
|
||
# Temperature °C -> Discharge Rate (0.0C to 1.0C)
|
||
yambms_discharging_rate_table: |
|
||
{
|
||
{-30.0, 0.00 },
|
||
{-20.0, 0.50 },
|
||
{-10.0, 0.50 },
|
||
{ -5.0, 0.50 },
|
||
{ 0.0, 0.50 },
|
||
{ 5.0, 0.50 },
|
||
{ 45.0, 0.50 },
|
||
{ 50.0, 0.50 },
|
||
{ 55.0, 0.50 },
|
||
{ 60.0, 0.00 }
|
||
}
|
||
# +--------------------------------------+
|
||
# | YamBMS services |
|
||
# +--------------------------------------+
|
||
# Update service : checks GitHub for a newer YamBMS version.
|
||
# Telemetry service : sends anonymous data about your setup (BMS model, board,
|
||
# inverter protocol, YamBMS version). It is what tells me which hardware is
|
||
# actually in use, so I know where to spend my time. Public stats and details
|
||
# on what is collected : stats.yambms.org
|
||
yambms_update_service: 'true' # Set to false to disable update checks
|
||
yambms_telemetry_service: 'true' # Set to false to disable the sending of telemetry data
|
||
# +--------------------------------------+
|
||
# | Shunt Settings |
|
||
# +--------------------------------------+
|
||
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
|
||
# +--------------------------------------+
|
||
# | BMS Settings |
|
||
# +--------------------------------------+
|
||
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
|
||
# +--------------------------------------+
|
||
# | Health & LED Assignment Logs |
|
||
# +--------------------------------------+
|
||
enable_led_logging: 'false' # Set to true to see if an led is assigned to a component correctly, logged every 60 seconds
|
||
enable_health_logging: 'false' # Set to true to see if component health for all component instances, logged every 60 seconds
|
||
# +--------------------------------------+
|
||
# | Advanced options |
|
||
# +--------------------------------------+
|
||
# Increase the `loop_task_stack_size` value for a large number of BMS
|
||
# See https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/LOOP_TASK_STACK.md before changing
|
||
loop_task_stack_size: "8192" # 8192 / 16384 / 32768 bytes
|
||
|
||
|
||
|
||
# +--------------------------------------+
|
||
# | Packages |
|
||
# +--------------------------------------+
|
||
|
||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
|
||
|
||
packages:
|
||
remote_packages:
|
||
url: https://github.com/Sleeper85/esphome-yambms
|
||
ref: main
|
||
refresh: 60min
|
||
files:
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> UNCOMMENT YOUR BOARD
|
||
# | >>> ONLY ONE BOARD !
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||
# - path: 'packages/board/board_ESP32_iBMS_CAN_RS485_V3.3.yaml'
|
||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||
# - path: 'packages/board/board_ESP32-C3_FlipC3.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_Generic.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_WS-ETH.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_WS-RS485-CAN.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_WS-Touch-LCD-4.3.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_WS-Touch-LCD-7.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||
|
||
# vars:
|
||
# server_status_led_id: 'virtual_status_light' # led used to show status. Default = esp_light, set specific led or set to 'virtual_status_light' to disable
|
||
# network_status_led_id: 'virtual_status_light' # led used to show status. Default = esp_light, set specific led or set to 'virtual_status_light' to disable
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> Board Display
|
||
# | >>> Uncomment the display that corresponds to your board
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
# - path: 'packages/board/board_options_display_128x128.yaml' # AtomS3 / AtomS3R
|
||
# - path: 'packages/board/board_options_display_480x222.yaml' # LilyGo T-Connect Pro
|
||
# - path: 'packages/board/board_options_display_lvgl_package_800x480_blue_navy_esphome.yaml' # WS Touch LCD 4.3" and 7"
|
||
# - path: 'packages/board/board_options_display_lvgl_package_1280x720_Tab5_esphome.yaml' # M5Stack Tab5
|
||
|
||
# vars:
|
||
# display_auto_next_page_interval: '5s'
|
||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> Board Options
|
||
# | >>> Uncomment your interfaces and options
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
# PSRAM octal 80Mhz
|
||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||
|
||
# Web Server
|
||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||
|
||
# WiFi AP @ 192.168.4.1
|
||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||
|
||
# Captive Portal @ 192.168.4.1
|
||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> BMS / Balancer / Shunt
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
# You don't have to import a shunt but you must import at least one BMS.
|
||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||
|
||
# >>> Copy your BMS / Balancer / Shunt packages here
|
||
# >>> You can find examples at this address :
|
||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||
|
||
|
||
|
||
# Seplos Modbus
|
||
- path: 'packages/bms/bms_combine_SEPLOS_V1_V2_RS485_modbus.yaml'
|
||
vars:
|
||
seplos_modbus_uart_id: 'uart_esp_1'
|
||
seplos_modbus_baud_rate: '9600' # 9600 / 19200 ; please set the baudrate of your Seplos BMS model here
|
||
# BMS 1
|
||
- path: 'packages/bms/bms_combine_SEPLOS_V1_V2_RS485_bms_full.yaml'
|
||
vars:
|
||
bms_id: '1' # must be a number
|
||
bms_name: 'SEPLOS-BMS 1'
|
||
bms_address: '0x01' # BMS 1 DIP switch
|
||
bms_protocol_version: '0x20' # Known protocol versions: 0x20 (Seplos), 0x26 (Boqiang)
|
||
# Required settings cannot be retrieved from BMS
|
||
# These values must match your BMS settings
|
||
# LFP values example
|
||
bms_max_charge_current: '100' # A. Used to calculate maximum charge current
|
||
bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current
|
||
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: 'false' # true/false, false by default
|
||
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
|
||
# BMS 2
|
||
- path: 'packages/bms/bms_combine_SEPLOS_V1_V2_RS485_bms_full.yaml'
|
||
vars:
|
||
bms_id: '2' # must be a number
|
||
bms_name: 'SEPLOS-BMS 2'
|
||
bms_address: '0x02' # BMS 2 DIP switch
|
||
bms_protocol_version: '0x20' # Known protocol versions: 0x20 (Seplos), 0x26 (Boqiang)
|
||
# Required settings cannot be retrieved from BMS
|
||
# These values must match your BMS settings
|
||
# LFP values example
|
||
bms_max_charge_current: '100' # A. Used to calculate maximum charge current
|
||
bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current
|
||
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: 'false' # true/false, false by default
|
||
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
|
||
# BMS 3
|
||
- path: 'packages/bms/bms_combine_SEPLOS_V1_V2_RS485_bms_full.yaml'
|
||
vars:
|
||
bms_id: '3' # must be a number
|
||
bms_name: 'SEPLOS-BMS 3'
|
||
bms_address: '0x03' # BMS 2 DIP switch
|
||
bms_protocol_version: '0x20' # Known protocol versions: 0x20 (Seplos), 0x26 (Boqiang)
|
||
# Required settings cannot be retrieved from BMS
|
||
# These values must match your BMS settings
|
||
# LFP values example
|
||
bms_max_charge_current: '100' # A. Used to calculate maximum charge current
|
||
bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current
|
||
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: 'false' # true/false, false by default
|
||
bms_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> YamBMS
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
- path: 'packages/yambms/yambms.yaml'
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> CAN bus to Inverter
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
|
||
vars:
|
||
canbus_id: '1' # must be a number
|
||
canbus_name: 'CANBUS 1'
|
||
canbus_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
|
||
# CAN frames sending will be paused for `30s` if the inverter does not respond with an ACK (can_id 0x305) before the end of the `canbus_link_timer` (5s by default).
|
||
canbus_link_timer_enabled: 'true' # Set it to 'false' if your inverter/charger is not sending ACK (can_id 0x305) every `1s` as specified by the protocol
|
||
canbus_link_timer: '10s' # min 6s with Deye
|
||
# CAN setup
|
||
canbus_platform: 'esp32_can' # esp32_can / mcp2515
|
||
canbus_node_id: 'canbus_inverter_1' # CAN bus node to which your inverter is connected
|
||
canbus_bitrate: '500kbps' # Default : 500kbps
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> RS485 bus to Inverter
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
# - path: 'packages/yambms/yambms_rs485.yaml'
|
||
# # - path: 'packages/yambms/yambms_rs485_web_server.yaml'
|
||
# vars:
|
||
# rs485_id: '1' # Must be a number
|
||
# rs485_name: 'RS485 1'
|
||
# rs485_protocol: 'pylon' # pylon / voltronic
|
||
# rs485_update_timeout: '10s'
|
||
# rs485_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable
|
||
# # UART setup
|
||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||
# rs485_uart_baud_rate: '9600' # Default : 9600 / Epever : 115200
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> DEBUG ( logger level must be DEBUG )
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
- path: packages/base/device_debug_ESP32.yaml
|
||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||
vars:
|
||
debug_name: 'Debug'
|
||
debug_update_interval: '5s'
|
||
# Size of your PSRAM in bits
|
||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||
debug_psram_size: '8388608'
|
||
|
||
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> Add your custom packages below
|
||
# +------------------------------------------------------------------------------+
|
||
|
||
# Custom packages
|
||
# yambms_custom: !include yambms_custom.yaml
|
||
|
||
# +------------------------------------------------------------------------------+
|
||
# | >>> Add your custom YAML below
|
||
# +----- -------------------------------------------------------------------------+
|
||
|
||
# Custom YAML
|