339 lines
14 KiB
YAML
339 lines
14 KiB
YAML
# Updated : 2025.06.26
|
|
# Version : 1.5.7
|
|
# 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
|
|
|
|
ota:
|
|
platform: esphome
|
|
|
|
# Please use the native `api` component instead of the `mqtt` section.
|
|
# If you use Home Assistant, the native API is more lightweight.
|
|
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
|
|
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
|
|
api:
|
|
reboot_timeout: 0s
|
|
|
|
# If you don't want to use ESPHome's native API you can use MQTT instead.
|
|
# In this case don't forget to remove the 'api:' section.
|
|
# mqtt:
|
|
# broker: !secret mqtt_host
|
|
# username: !secret mqtt_username
|
|
# password: !secret mqtt_password
|
|
# id: mqtt_client
|
|
|
|
# Please note that enabling this component will take up a lot of memory and may decrease
|
|
# stability and be the cause of reboot depending on the capabilities of the board used.
|
|
# web_server:
|
|
# port: 80
|
|
# log: false
|
|
# ota: false
|
|
|
|
# +--------------------------------------+
|
|
# | Global Settings |
|
|
# +--------------------------------------+
|
|
substitutions:
|
|
# Name
|
|
friendly_name : 'YamBMS Demo' # Prefix added in front of the `entity display name`, also used to classify them.
|
|
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
|
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
|
# +--------------------------------------+
|
|
# | YamBMS Settings |
|
|
# +--------------------------------------+
|
|
# Please read the cut-off charging logic README to understand how the YamBMS works
|
|
yambms_id: 'yambms1'
|
|
yambms_name: 'YamBMS 1'
|
|
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: '60'
|
|
# +--------------------------------------+
|
|
# | Shunt Settings |
|
|
# +--------------------------------------+
|
|
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
|
|
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
|
|
# +--------------------------------------+
|
|
# | BMS Settings |
|
|
# +--------------------------------------+
|
|
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
|
|
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
|
|
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
|
|
|
# +--------------------------------------+
|
|
# | Packages |
|
|
# +--------------------------------------+
|
|
|
|
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
|
|
|
packages:
|
|
|
|
################ >>> CONFIG & CUSTOM LP <<< ################
|
|
|
|
# Local Packages intended for creating custom codes
|
|
# or sharing settings between several main.yaml
|
|
|
|
# yambms_config: !include yambms_config.yaml
|
|
# yambms_custom: !include yambms_custom.yaml
|
|
|
|
############### >>> UNCOMMENT YOUR BOARD <<< ###############
|
|
############### >>> ONLY ONE BOARD ! <<< ###############
|
|
|
|
board:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
- path: 'packages/board/board_ESP32_Generic.yaml'
|
|
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
|
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
|
# - path: 'packages/board/board_ESP32_EVB.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-S3_AtomS3-Lite.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_Touch-LCD-4.3.yaml'
|
|
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
|
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
|
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
|
|
|
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml'
|
|
# vars:
|
|
# display_auto_next_page_interval: '5s'
|
|
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
|
|
|
# - path: 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
|
# vars:
|
|
# display_auto_next_page_interval: '5s'
|
|
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
|
|
|
# LilyGo T-Connect Pro
|
|
# Importing the display also activates PSRAM.
|
|
# Also note that the display update takes about 120 ms, as indicated in the logs:
|
|
# "Component display took a long time for an operation (124 ms)."
|
|
# Board
|
|
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
|
# Display
|
|
# - path: 'packages/board/board_options_display_480x222.yaml'
|
|
# vars:
|
|
# display_auto_next_page_interval: '5s'
|
|
|
|
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
|
|
|
|
board_options:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
# Captive Portal
|
|
- path: 'packages/board/board_options_captive_portal.yaml'
|
|
# UART 1
|
|
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
|
# UART 2
|
|
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
|
# UART 3
|
|
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
|
|
|
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
|
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
|
vars:
|
|
canbus_node_id: 'canbus_inverter_1'
|
|
|
|
# MCP2515
|
|
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
|
# vars:
|
|
# canbus_node_id: 'canbus_inverter_1'
|
|
|
|
############################################################
|
|
|
|
shunt:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
# 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: '53.41' # V
|
|
shunt_current: '37.5' # A
|
|
shunt_power: '2003' # W
|
|
shunt_soc: '86' # %
|
|
|
|
bms:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
# BMS 1
|
|
- path: 'packages/bms/bms_combine_FAKE.yaml'
|
|
vars:
|
|
bms_id: '1' # must be a number
|
|
bms_name: 'BMS 1'
|
|
# BMS sensors values
|
|
bms_battery_capacity: '280' # Ah
|
|
bms_battery_capacity_remaining: '243' # Ah
|
|
bms_voltage: '53.45' # V
|
|
bms_current: '9.2' # A
|
|
bms_power: '492' # W
|
|
bms_soc: '87' # %
|
|
bms_soh: '98' # %
|
|
bms_min_cell_voltage: '3.339' # V
|
|
bms_min_voltage_cell: '2' # cell number 1~16
|
|
bms_max_cell_voltage: '3.341' # V
|
|
bms_max_voltage_cell: '11' # cell number 1~16
|
|
bms_temperature_sensor_1: '21.1' # °C
|
|
bms_temperature_sensor_2: '21.3' # °C
|
|
bms_temperature_sensor_3: '21.5' # °C
|
|
bms_temperature_sensor_4: '21.7' # °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 2
|
|
- path: 'packages/bms/bms_combine_FAKE.yaml'
|
|
vars:
|
|
bms_id: '2' # must be a number
|
|
bms_name: 'BMS 2'
|
|
# BMS sensors values
|
|
bms_battery_capacity: '280' # Ah
|
|
bms_battery_capacity_remaining: '238' # Ah
|
|
bms_voltage: '53.41' # V
|
|
bms_current: '11.3' # A
|
|
bms_power: '604' # W
|
|
bms_soc: '85' # %
|
|
bms_soh: '89' # %
|
|
bms_min_cell_voltage: '3.337' # V
|
|
bms_min_voltage_cell: '14' # cell number 1~16
|
|
bms_max_cell_voltage: '3.339' # V
|
|
bms_max_voltage_cell: '3' # cell number 1~16
|
|
bms_temperature_sensor_1: '21.8' # °C
|
|
bms_temperature_sensor_2: '21.6' # °C
|
|
bms_temperature_sensor_3: '21.4' # °C
|
|
bms_temperature_sensor_4: '21.2' # °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 3
|
|
- path: 'packages/bms/bms_combine_FAKE.yaml'
|
|
vars:
|
|
bms_id: '3' # must be a number
|
|
bms_name: 'BMS 3'
|
|
# BMS sensors values
|
|
bms_battery_capacity: '280' # Ah
|
|
bms_battery_capacity_remaining: '232' # Ah
|
|
bms_voltage: '53.37' # V
|
|
bms_current: '15.7' # A
|
|
bms_power: '838' # W
|
|
bms_soc: '83' # %
|
|
bms_soh: '79' # %
|
|
bms_min_cell_voltage: '3.334' # V
|
|
bms_min_voltage_cell: '7' # cell number 1~16
|
|
bms_max_cell_voltage: '3.336' # V
|
|
bms_max_voltage_cell: '9' # cell number 1~16
|
|
bms_temperature_sensor_1: '21.9' # °C
|
|
bms_temperature_sensor_2: '22.0' # °C
|
|
bms_temperature_sensor_3: '22.1' # °C
|
|
bms_temperature_sensor_4: '22.2' # °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
|
|
|
|
yambms:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
- path: 'packages/yambms/yambms.yaml'
|
|
|
|
canbus:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
- path: 'packages/yambms/yambms_canbus.yaml'
|
|
vars:
|
|
canbus_id: 'canbus1'
|
|
canbus_name: 'CANBUS 1'
|
|
canbus_node_id: 'canbus_inverter_1'
|
|
canbus_light_id: 'esp_light'
|
|
# The CANBUS link will be considered down if no response from the inverter (0x305 frame) for 5s
|
|
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
|
canbus_link_timer: '5s'
|
|
|
|
# +--------------------------------------+
|
|
# | DEBUG ( logger level must be DEBUG ) |
|
|
# +--------------------------------------+
|
|
|
|
debug:
|
|
url: https://github.com/Sleeper85/esphome-yambms
|
|
ref: main
|
|
refresh: 0s
|
|
files:
|
|
- path: packages/base/device_debug_ESP32.yaml
|
|
vars:
|
|
debug_name: 'Debug'
|
|
debug_update_interval: '5s'
|