Update the root YAML and the examples for the UART and CAN declarations, the RS485 block and the Board Options section.
330 lines
14 KiB
YAML
330 lines
14 KiB
YAML
# 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 <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: 'pvbrain2' # Name of your ESPHome node registered on the IP network (DNS name must be unique)
|
|
friendly_name : 'PVbrain2' # Name of your board (prefix for board entities)
|
|
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: '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 / entities
|
|
# 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
|
|
# +--------------------------------------+
|
|
# | UART expander WK2168 |
|
|
# +--------------------------------------+
|
|
# uart_spi_0 : 2400 WKS {RJ45-UART0}
|
|
# uart_spi_1 : 38400 JSY193
|
|
# uart_spi_2 : 19200 SmartShunt
|
|
# uart_spi_3 : 9600 SRNE {RJ45-UART3}
|
|
# uart_spi_4 : 115200 JK-BMS 1
|
|
# uart_spi_5 : 115200 JK-BMS 2
|
|
# uart_spi_6 : 115200 Pylontech
|
|
# uart_spi_7 : 9600 EPEVER {RJ45-UART7}
|
|
|
|
|
|
|
|
# +--------------------------------------+
|
|
# | Packages |
|
|
# +--------------------------------------+
|
|
|
|
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_LP_YAML.md
|
|
|
|
packages:
|
|
|
|
board: !include
|
|
file: packages/board/board_ESP32-S3_DevKitC-1_PVbrain2_LED-48.yaml # DevKitC-1 V1.0
|
|
# file: packages/board/board_ESP32-S3_DevKitC-1_PVbrain2_LED-38.yaml # DevKitC-1 V1.1
|
|
# 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 Options
|
|
# | >>> Uncomment your interfaces and options
|
|
# +------------------------------------------------------------------------------+
|
|
|
|
# BUS
|
|
# spi_bus: !include packages/board/board_options_itf_bus_spi.yaml # SPI bus
|
|
# i2c_bus: !include packages/board/board_options_itf_bus_i2c.yaml # I2C bus for SX1509 and BME280/BMP280
|
|
# one_wire_bus: !include packages/board/board_options_itf_bus_one_wire.yaml # One wire bus for Dallas Temperature Sensor
|
|
|
|
# WK2168 UART/IO Expander
|
|
wk2168_spi: !include packages/board/board_options_itf_wk2168_spi.yaml
|
|
# wk2168_i2c: !include packages/board/board_options_itf_wk2168_i2c.yaml
|
|
|
|
# Modbus 1
|
|
# modbus_1: !include
|
|
# file: 'packages/board/board_options_itf_modbus.yaml'
|
|
# vars:
|
|
# modbus_id: '1' # can be a number or text or a mixture of both, e.g. full id = modbus_client_1
|
|
# modbus_role: 'client' # client / server
|
|
# modbus_uart_id: 'uart_spi_1'
|
|
|
|
# Modbus 2
|
|
# modbus_2: !include
|
|
# file: 'packages/board/board_options_itf_modbus.yaml'
|
|
# vars:
|
|
# modbus_id: '2' # can be a number or text or a mixture of both, e.g. full id = modbus_client_2
|
|
# modbus_role: 'client' # client / server
|
|
# modbus_uart_id: 'uart_spi_2'
|
|
|
|
# SX1509 16 channel I/O Expander
|
|
# sx1509: !include packages/board/board_options_itf_pvbrain2_sx1509.yaml
|
|
|
|
# PSRAM octal 80Mhz
|
|
psram_octal_80Mhz: !include packages/board/board_options_PSRAM_octal_80Mhz.yaml
|
|
|
|
# Web Server
|
|
# web_server: !include packages/yambms/yambms_web_server.yaml
|
|
|
|
# WiFi AP @ 192.168.4.1
|
|
# wifi_ap: !include packages/board/board_options_wifi_ap.yaml
|
|
|
|
# Captive Portal @ 192.168.4.1
|
|
# captive_portal: !include 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/
|
|
|
|
|
|
|
|
# +------------------------------------------------------------------------------+
|
|
# | >>> YamBMS
|
|
# +------------------------------------------------------------------------------+
|
|
|
|
yambms: !include packages/yambms/yambms.yaml
|
|
|
|
|
|
|
|
# +------------------------------------------------------------------------------+
|
|
# | >>> CAN bus to Inverter
|
|
# +------------------------------------------------------------------------------+
|
|
|
|
canbus1: !include
|
|
file: 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
|
|
# +------------------------------------------------------------------------------+
|
|
|
|
# rs485_1: !include
|
|
# file: 'packages/yambms/yambms_rs485.yaml'
|
|
# # file: '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_spi_3' # UART interface to which your inverter is connected
|
|
# rs485_uart_baud_rate: '9600' # Default : 9600 / Epever : 115200
|
|
|
|
|
|
|
|
# +------------------------------------------------------------------------------+
|
|
# | >>> DEBUG ( logger level must be DEBUG )
|
|
# +------------------------------------------------------------------------------+
|
|
|
|
device_debug: !include
|
|
# file: packages/base/device_debug_ESP32.yaml
|
|
file: 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
|