# Updated : 2026.02.03 # Version : 1.1.3 # 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 . ############################ Remote Packages Example ########################### # This is not a working YAML but just code ready to copy into your main YAML. ################################################################################ substitutions: friendly_name : 'YamBMS Modbus Server 2' # Prefix added in front of the `entity display name`, also used to classify them. hostname: 'yambms-modbus-server-2' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`. packages: yambms_modbus_server: url: https://github.com/Sleeper85/esphome-yambms ref: main refresh: 0s files: # Modbus server - path: 'packages/board/board_options_itf_modbus.yaml' vars: modbus_role: 'server' # client / server modbus_uart_id: 'uart_esp_1' # RS485 board # BMS 2 - path: 'packages/bms/bms_modbus_JK_BLE_standard.yaml' vars: bms_id: '2' # must be a number, also represents the modbus server number ! bms_name: 'JK-BMS 2' bms_ble_protocol_version: JK02_32S # JK02_24S < hardware version 11.0 >= JK02_32S bms_ble_mac_address: C8:47:8C:10:7E:AA # Maximum cell charging cycles is used to calculate the battey SoH. # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) bms_cell_max_cycles: '6000.0' bms_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable # BMS 3 - path: 'packages/bms/bms_modbus_JK_BLE_standard.yaml' vars: bms_id: '3' # must be a number, also represents the modbus server number ! bms_name: 'JK-BMS 3' bms_ble_protocol_version: JK02_32S # JK02_24S < hardware version 11.0 >= JK02_32S bms_ble_mac_address: C8:47:8C:EE:16:EA # Maximum cell charging cycles is used to calculate the battey SoH. # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) bms_cell_max_cycles: '6000.0' bms_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable