# Updated : 2026.11.05 # Version : 1.8.1 # 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 . ######################## 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-demo' # Name of your ESPHome node registered on the IP network (DNS name must be unique) friendly_name : 'YamBMS Demo' # 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 Demo' # 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 # +------------------------------------------------------------------------------+ # Shunt 1 - path: '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' # % # BMS 1 - path: '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 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 # BMS 2 - path: '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 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 # BMS 3 - path: '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 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 # +------------------------------------------------------------------------------+ # | >>> 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