diff --git a/YamBMS_RP_BMS_Ecoworthy_RS485.yaml b/YamBMS_RP_BMS_Ecoworthy_RS485.yaml new file mode 100644 index 0000000..0e03d71 --- /dev/null +++ b/YamBMS_RP_BMS_Ecoworthy_RS485.yaml @@ -0,0 +1,360 @@ +# Updated : 2026.02.05 +# Version : 1.7.0 +# 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: + # Name + friendly_name : 'YamBMS' # Prefix added in front of the `entity name`, also used to classify them. + hostname: 'yambms' # Name of your ESP32 registered on the IP network (DNS name, must be unique). + 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' + # 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 } + } + # +--------------------------------------+ + # | 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 + + + +# +--------------------------------------+ +# | 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_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 display + # - path: 'packages/board/board_options_display_480x222.yaml' # LilyGo T-Connect Pro display + + # 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 + # +------------------------------------------------------------------------------+ + + # UART 1 (uart_id: uart_esp_1) + - path: 'packages/board/board_options_itf_uart_esp_1.yaml' + # UART 2 (uart_id: uart_esp_2) + # - path: 'packages/board/board_options_itf_uart_esp_2.yaml' + # UART 3 (uart_id: uart_esp_3) + # - path: 'packages/board/board_options_itf_uart_esp_3.yaml' + + # UART flow control + # - path: 'packages/board/board_options_itf_uart_flow_control.yaml' + # vars: + # uart_id: 'uart_esp_1' + # uart_flow_control_pin: ${talk_pin} + + # CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit) + - path: 'packages/board/board_options_itf_canbus_esp32_can.yaml' + vars: + # to bms = canbus_bms_1 + # to inverter = canbus_inverter_1 + canbus_node_id: 'canbus_inverter_1' + + # CAN transceiver - MCP2515 + # - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml' + # vars: + # # to bms = canbus_bms_1 + # # to inverter = canbus_inverter_1 + # canbus_node_id: 'canbus_inverter_1' + + # 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/ + + + + # Ecoworthy Modbus - Include this ONCE per RS485 bus + - path: 'packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml' + vars: + ecoworthy_modbus_uart_id: 'uart_esp_1' + ecoworthy_modbus_baud_rate: '9600' + # BMS 1 + - path: 'packages/bms/bms_combine_Ecoworthy_RS485.yaml' + vars: + bms_id: '1' # must be a number + bms_name: 'Ecoworthy-BMS 1' + bms_address: '0x01' # BMS 1 modbus address (usually 0x01 for master) + bms_max_charge_current: '100' # A. Max charge current + bms_max_discharge_current: '100' # A. Max discharge current + bms_cell_ovp: '3.650' # V. Cell over-voltage protection + bms_cell_uvp: '2.500' # V. Cell under-voltage protection + bms_balance_trigger_voltage: '0.030' # V. Balance trigger voltage + 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_Ecoworthy_RS485.yaml' + vars: + bms_id: '2' # must be a number + bms_name: 'Ecoworthy-BMS 2' + bms_address: '0x02' # BMS 2 modbus address + bms_max_charge_current: '100' # A. Max charge current + bms_max_discharge_current: '100' # A. Max discharge current + bms_cell_ovp: '3.650' # V. Cell over-voltage protection + bms_cell_uvp: '2.500' # V. Cell under-voltage protection + bms_balance_trigger_voltage: '0.030' # V. Balance trigger voltage + 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_node_id: 'canbus_inverter_1' # CAN bus node to which your inverter is connected + canbus_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable + # The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s + # The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356 + canbus_link_timer: '5s' + + + + # +------------------------------------------------------------------------------+ + # | >>> RS485 bus to Inverter + # +------------------------------------------------------------------------------+ + + # - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml + # vars: + # rs485_id: '1' # Must be a number + # rs485_name: 'RS485 1' + # rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected + # rs485_uart_baud_rate: '9600' + # rs485_update_timeout: '5s' + # rs485_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable + + + # +------------------------------------------------------------------------------+ + # | >>> 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' + + + + # +------------------------------------------------------------------------------+ + # | >>> Config and Custom Local Packages + # +------------------------------------------------------------------------------+ + + # 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 diff --git a/examples/single-node/LP_BMS_example_Ecoworthy_RS485.yaml b/examples/single-node/LP_BMS_example_Ecoworthy_RS485.yaml new file mode 100644 index 0000000..0d8922c --- /dev/null +++ b/examples/single-node/LP_BMS_example_Ecoworthy_RS485.yaml @@ -0,0 +1,114 @@ +# Updated : 2026.02.15 +# Version : 1.1.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 . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into +# your main YAML below the `packages:` section. + +################################################################################ + +# Example A : Primary + secondary batteries (one BMS polls multiple batteries) +# +# The primary BMS component reads data for all batteries on the RS485 bus. +# Secondary batteries are exposed as separate YamBMS BMS entries using +# bms_combine_Ecoworthy_RS485_secondary.yaml. +# +# Set bms_battery_count on the primary to the total number of batteries. + +################################################################################ + +packages: + + # Ecoworthy Modbus - Include this ONCE per RS485 bus + ecoworthy_modbus: !include + file: packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml + vars: + ecoworthy_modbus_uart_id: 'uart_esp_1' + ecoworthy_modbus_baud_rate: '9600' + + # Primary battery (BMS 1) - polls all batteries on the RS485 bus + bms1: !include + file: packages/bms/bms_combine_Ecoworthy_RS485.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'Ecoworthy-BMS 1' + bms_address: '0x01' # BMS 1 modbus address (usually 0x01 for primary) + bms_battery_count: '3' # total batteries polled (1=primary only, 2+=primary+secondaries) + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable + + # Secondary battery 2 (BMS 2) - data polled by primary + bms2: !include + file: packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'Ecoworthy-BMS 2' + parent_ecoworthy_bms_id: 'ecoworthy_bms1' # references the primary component + secondary_battery_number: '2' + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' + + # Secondary battery 3 (BMS 3) - data polled by primary + bms3: !include + file: packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml + vars: + bms_id: '3' # must be a number + bms_name: 'Ecoworthy-BMS 3' + parent_ecoworthy_bms_id: 'ecoworthy_bms1' # references the primary component + secondary_battery_number: '3' + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' + +################################################################################ + +# Example B : Multiple independent primaries (each BMS has its own address) +# +# Use this when each Ecoworthy BMS is independently addressed on the bus +# and you don't need the primary/secondary polling pattern. +# Protection thresholds (cell OVP/UVP) are read from BMS config registers. + +################################################################################ + +# # Ecoworthy Modbus - Include this ONCE per RS485 bus +# ecoworthy_modbus: !include +# file: packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml +# vars: +# ecoworthy_modbus_uart_id: 'uart_esp_1' +# ecoworthy_modbus_baud_rate: '9600' +# +# # Ecoworthy BMS 1 +# bms1: !include +# file: packages/bms/bms_combine_Ecoworthy_RS485.yaml +# vars: +# bms_id: '1' # must be a number +# bms_name: 'Ecoworthy-BMS 1' +# bms_address: '0x01' # BMS 1 modbus address (usually 0x01 for primary) +# bms_cell_max_cycles: '6000.0' +# bms_status_led_id: 'esp_light' +# +# # Ecoworthy BMS 2 +# bms2: !include +# file: packages/bms/bms_combine_Ecoworthy_RS485.yaml +# vars: +# bms_id: '2' # must be a number +# bms_name: 'Ecoworthy-BMS 2' +# bms_address: '0x02' # BMS 2 modbus address +# bms_cell_max_cycles: '6000.0' +# bms_status_led_id: 'esp_light' diff --git a/examples/single-node/RP_BMS_example_Ecoworthy_RS485.yaml b/examples/single-node/RP_BMS_example_Ecoworthy_RS485.yaml new file mode 100644 index 0000000..662efd8 --- /dev/null +++ b/examples/single-node/RP_BMS_example_Ecoworthy_RS485.yaml @@ -0,0 +1,107 @@ +# Updated : 2026.02.15 +# Version : 1.1.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 . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into +# your main YAML below the `packages:` section. + +# packages: +# remote_packages: +# url: https://github.com/Sleeper85/esphome-yambms +# ref: main +# refresh: 60s +# files: + +################################################################################ + +# Example A : Primary + secondary batteries (one BMS polls multiple batteries) +# +# The primary BMS component reads data for all batteries on the RS485 bus. +# Secondary batteries are exposed as separate YamBMS BMS entries using +# bms_combine_Ecoworthy_RS485_secondary.yaml. +# +# Set bms_battery_count on the primary to the total number of batteries. + +################################################################################ + + # Ecoworthy Modbus - Include this ONCE per RS485 bus + - path: 'packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml' + vars: + ecoworthy_modbus_uart_id: 'uart_esp_1' + ecoworthy_modbus_baud_rate: '9600' + # Primary battery (BMS 1) - polls all batteries on the RS485 bus + - path: 'packages/bms/bms_combine_Ecoworthy_RS485.yaml' + vars: + bms_id: '1' # must be a number + bms_name: 'Ecoworthy-BMS 1' + bms_address: '0x01' # BMS 1 modbus address (usually 0x01 for primary) + bms_battery_count: '3' # total batteries polled (1=primary only, 2+=primary+secondaries) + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' # led used to show status. Default = esp_light, comment out to disable + # Secondary battery 2 (BMS 2) - data polled by primary + - path: 'packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml' + vars: + bms_id: '2' # must be a number + bms_name: 'Ecoworthy-BMS 2' + parent_ecoworthy_bms_id: 'ecoworthy_bms1' # references the primary component + secondary_battery_number: '2' + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' + # Secondary battery 3 (BMS 3) - data polled by primary + - path: 'packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml' + vars: + bms_id: '3' # must be a number + bms_name: 'Ecoworthy-BMS 3' + parent_ecoworthy_bms_id: 'ecoworthy_bms1' # references the primary component + secondary_battery_number: '3' + bms_cell_max_cycles: '6000.0' + bms_status_led_id: 'esp_light' + +################################################################################ + +# Example B : Multiple independent primaries (each BMS has its own address) +# +# Use this when each Ecoworthy BMS is independently addressed on the bus +# and you don't need the primary/secondary polling pattern. +# Protection thresholds (cell OVP/UVP) are read from BMS config registers. + +################################################################################ + +# # Ecoworthy Modbus - Include this ONCE per RS485 bus +# - path: 'packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml' +# vars: +# ecoworthy_modbus_uart_id: 'uart_esp_1' +# ecoworthy_modbus_baud_rate: '9600' +# # Ecoworthy BMS 1 +# - path: 'packages/bms/bms_combine_Ecoworthy_RS485.yaml' +# vars: +# bms_id: '1' # must be a number +# bms_name: 'Ecoworthy-BMS 1' +# bms_address: '0x01' # BMS 1 modbus address (usually 0x01 for primary) +# bms_cell_max_cycles: '6000.0' +# bms_status_led_id: 'esp_light' +# # Ecoworthy BMS 2 +# - path: 'packages/bms/bms_combine_Ecoworthy_RS485.yaml' +# vars: +# bms_id: '2' # must be a number +# bms_name: 'Ecoworthy-BMS 2' +# bms_address: '0x02' # BMS 2 modbus address +# bms_cell_max_cycles: '6000.0' +# bms_status_led_id: 'esp_light' diff --git a/packages/bms/bms_combine_Ecoworthy_RS485.yaml b/packages/bms/bms_combine_Ecoworthy_RS485.yaml new file mode 100644 index 0000000..b3a2ad1 --- /dev/null +++ b/packages/bms/bms_combine_Ecoworthy_RS485.yaml @@ -0,0 +1,40 @@ +# Updated : 2026.02.15 +# Version : 1.0.1 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +# +--------------------------------------+ +# | Ecoworthy BMS Combine Package | +# +--------------------------------------+ +# This package is for the YamBMS client (single-node setup). +# It combines BMS data from Ecoworthy BMS via RS485 with YamBMS. +# +# Required substitutions: +# bms_id: The BMS ID number +# bms_name: Display name for the BMS +# bms_address: Modbus address of the BMS (0x01-0x0F) +# +# Optional substitutions (have defaults): +# ecoworthy_modbus_id: The ecoworthy_modbus component ID (default: modbus_ecoworthy) + +substitutions: + bms_model: "Ecoworthy" + bms_protocol: "RS485" + +packages: + bms_combine: !include bms_combine.yaml + bms_sensors: !include bms_sensors_Ecoworthy_RS485_full.yaml diff --git a/packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml b/packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml new file mode 100644 index 0000000..1c1a1c6 --- /dev/null +++ b/packages/bms/bms_combine_Ecoworthy_RS485_modbus.yaml @@ -0,0 +1,45 @@ +# Updated : 2026.02.05 +# Version : 1.0.1 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +# +--------------------------------------+ +# | Ecoworthy Modbus Setup | +# +--------------------------------------+ +# This package sets up the ecoworthy_modbus component for RS485 communication. +# Include this ONCE per RS485 bus, then include the BMS package for each BMS. +# +# Required substitutions: +# ecoworthy_modbus_uart_id: UART ID for RS485 (e.g., 'uart_esp_1') +# ecoworthy_modbus_baud_rate: Baud rate (default: 9600) +# ecoworthy_modbus_id: ID for the modbus component (e.g., 'modbus_ecoworthy') + +substitutions: + ecoworthy_modbus_id: modbus_ecoworthy + ecoworthy_modbus_baud_rate: '9600' + +external_components: + - source: github://RAR/esphome-ecoworthy-bms@v1.0.0 + refresh: 0s + +uart: + - id: !extend ${ecoworthy_modbus_uart_id} + baud_rate: ${ecoworthy_modbus_baud_rate} + +ecoworthy_modbus: + - id: ${ecoworthy_modbus_id} + uart_id: ${ecoworthy_modbus_uart_id} diff --git a/packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml b/packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml new file mode 100644 index 0000000..84565d0 --- /dev/null +++ b/packages/bms/bms_combine_Ecoworthy_RS485_secondary.yaml @@ -0,0 +1,47 @@ +# Updated : 2026.02.08 +# Version : 1.0.0 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +# +--------------------------------------+ +# | Ecoworthy BMS Secondary Combine Pkg | +# +--------------------------------------+ +# This package is for secondary batteries in a single-node setup. +# It combines secondary battery data from an Ecoworthy BMS with YamBMS. +# +# The primary component must be configured with battery_count >= secondary_battery_number +# +# Required substitutions: +# bms_id: The YamBMS BMS ID number for this secondary +# bms_name: Display name for this secondary BMS +# parent_ecoworthy_bms_id: ID of the parent ecoworthy_bms component (e.g., 'ecoworthy_bms1') +# secondary_battery_number: The secondary battery number (2, 3, 4, etc.) +# +# Optional substitutions (have defaults): +# bms_max_charge_current: Max charge current in A (default: 100) +# bms_max_discharge_current: Max discharge current in A (default: 100) +# bms_cell_ovp: Cell over-voltage protection in V (default: 3.650) +# bms_cell_uvp: Cell under-voltage protection in V (default: 2.500) +# bms_balance_trigger_voltage: Balance trigger voltage in V (default: 0.030) + +substitutions: + bms_model: "Ecoworthy Secondary" + bms_protocol: "RS485" + +packages: + bms_combine: !include bms_combine.yaml + bms_sensors: !include bms_sensors_Ecoworthy_RS485_secondary.yaml diff --git a/packages/bms/bms_errors_bitmask_Ecoworthy.yaml b/packages/bms/bms_errors_bitmask_Ecoworthy.yaml new file mode 100644 index 0000000..3bed5df --- /dev/null +++ b/packages/bms/bms_errors_bitmask_Ecoworthy.yaml @@ -0,0 +1,152 @@ +# Updated : 2026.02.02 +# Version : 1.0.0 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + + # +--------------------------------------+ + # | Ecoworthy Errors Bitmask | + # +--------------------------------------+ + # Maps Ecoworthy fault_bitmask (32-bit) and alarm_bitmask (32-bit) to + # +--------------------------------------+ + # | YamBMS Errors Bitmask (16bit) | + # +--------------------------------------+ + + # Ecoworthy Fault Bits (from ecoworthy_bms.cpp): + # Bit 0: Cell OV Bit 12: MOS HT + # Bit 1: Cell UV Bit 13: Ambient HT + # Bit 2: Pack OV Bit 14: Ambient LT + # Bit 3: Pack UV Bit 15: Cell V Diff + # Bit 4: Charge OC Slow Bit 16: Temp Diff + # Bit 5: Charge OC Fast Bit 17: SOC Low + # Bit 6: Discharge OC Slow Bit 18: Short Circuit + # Bit 7: Discharge OC Fast Bit 19: Cell Offline + # Bit 8: Charge HT Bit 20: Temp Sensor Fail + # Bit 9: Charge LT Bit 21: Charge MOS Fault + # Bit 10: Discharge HT Bit 22: Discharge MOS Fault + # Bit 11: Discharge LT Bit 23: AFE Comm Error + + # YamBMS Error Bits: + # Bit 0 General alarm 0x0001 + # Bit 1 Battery high voltage alarm 0x0002 + # Bit 2 Battery low voltage alarm 0x0004 + # Bit 3 Battery high temperature alarm 0x0008 + # Bit 4 Battery low temperature alarm 0x0010 + # Bit 5 Battery high temperature charge alarm 0x0020 + # Bit 6 Battery low temperature charge alarm 0x0040 + # Bit 7 Battery high discharge current alarm 0x0080 + # Bit 8 Battery high charge current alarm 0x0100 + # Bit 9 Contactor alarm 0x0200 + # Bit 10 Short circuit alarm 0x0400 + # Bit 11 BMS internal alarm 0x0800 + # Bit 12 Cell imbalance alarm 0x1000 + # Bit 13 Reserved 0x2000 + # Bit 14 Reserved 0x4000 + # Bit 15 Reserved 0x8000 + +sensor: + - platform: template + id: bms${bms_id}_yambms_errors_bitmask + device_id: bms_${bms_id} + name: "YamBMS Errors Bitmask" + update_interval: ${bms_update_interval} + accuracy_decimals: 0 + icon: mdi:alert-circle-outline + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: |- + uint16_t yambms_errors = 0; + + // Get fault and alarm bitmasks + uint32_t fault = 0; + uint32_t alarm = 0; + + if (!std::isnan(id(bms${bms_id}_fault_bitmask).state)) { + fault = static_cast(id(bms${bms_id}_fault_bitmask).state); + } + if (!std::isnan(id(bms${bms_id}_alarm_bitmask).state)) { + alarm = static_cast(id(bms${bms_id}_alarm_bitmask).state); + } + + // If any fault or alarm, set general alarm (bit 0) + if (fault != 0 || alarm != 0) { + yambms_errors |= 0x0001; + } + + // High voltage alarm (bit 1): Cell OV (bit 0) or Pack OV (bit 2) + if ((fault & 0x05) || (alarm & 0x05)) { + yambms_errors |= 0x0002; + } + + // Low voltage alarm (bit 2): Cell UV (bit 1) or Pack UV (bit 3) + if ((fault & 0x0A) || (alarm & 0x0A)) { + yambms_errors |= 0x0004; + } + + // High temperature alarm (bit 3): Discharge HT (bit 10), MOS HT (bit 12), Ambient HT (bit 13) + if ((fault & 0x3400) || (alarm & 0x0C00)) { + yambms_errors |= 0x0008; + } + + // Low temperature alarm (bit 4): Discharge LT (bit 11), Ambient LT (bit 14) + if ((fault & 0x4800) || (alarm & 0x1000)) { + yambms_errors |= 0x0010; + } + + // High temperature charge alarm (bit 5): Charge HT (bit 8) + if ((fault & 0x100) || (alarm & 0x40)) { + yambms_errors |= 0x0020; + } + + // Low temperature charge alarm (bit 6): Charge LT (bit 9) + if ((fault & 0x200) || (alarm & 0x80)) { + yambms_errors |= 0x0040; + } + + // High discharge current alarm (bit 7): Discharge OC Slow/Fast (bits 6-7) + if ((fault & 0xC0) || (alarm & 0x20)) { + yambms_errors |= 0x0080; + } + + // High charge current alarm (bit 8): Charge OC Slow/Fast (bits 4-5) + if ((fault & 0x30) || (alarm & 0x10)) { + yambms_errors |= 0x0100; + } + + // Contactor/MOS alarm (bit 9): Charge MOS Fault (bit 21), Discharge MOS Fault (bit 22) + if (fault & 0x600000) { + yambms_errors |= 0x0200; + } + + // Short circuit alarm (bit 10): Short Circuit (bit 18) + if (fault & 0x40000) { + yambms_errors |= 0x0400; + } + + // BMS internal alarm (bit 11): AFE Comm Error (bit 23), Cell Offline (bit 19), + // Temp Sensor Fail (bit 20), EEP Fault (alarm bit 16), RTC Abnormal (alarm bit 17) + if ((fault & 0xB80000) || (alarm & 0x30000)) { + yambms_errors |= 0x0800; + } + + // Cell imbalance alarm (bit 12): Cell V Diff (bit 15), Temp Diff (bit 16) + if ((fault & 0x18000) || (alarm & 0x6000)) { + yambms_errors |= 0x1000; + } + + return yambms_errors; diff --git a/packages/bms/bms_errors_bitmask_Ecoworthy_secondary.yaml b/packages/bms/bms_errors_bitmask_Ecoworthy_secondary.yaml new file mode 100644 index 0000000..cfb0f29 --- /dev/null +++ b/packages/bms/bms_errors_bitmask_Ecoworthy_secondary.yaml @@ -0,0 +1,139 @@ +# Updated : 2026.02.03 +# Version : 1.0.0 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + + # +--------------------------------------+ + # | Ecoworthy SECONDARY Errors Bitmask | + # +--------------------------------------+ + # Maps Ecoworthy fault_bitmask (32-bit) and alarm_bitmask (32-bit) to + # YamBMS Errors Bitmask (16bit) + # + # This is identical to the primary version - secondary batteries expose + # the same fault/alarm bitmask format via Pack Status polling. + + # YamBMS Error Bits: + # Bit 0 General alarm 0x0001 + # Bit 1 Battery high voltage alarm 0x0002 + # Bit 2 Battery low voltage alarm 0x0004 + # Bit 3 Battery high temperature alarm 0x0008 + # Bit 4 Battery low temperature alarm 0x0010 + # Bit 5 Battery high temperature charge alarm 0x0020 + # Bit 6 Battery low temperature charge alarm 0x0040 + # Bit 7 Battery high discharge current alarm 0x0080 + # Bit 8 Battery high charge current alarm 0x0100 + # Bit 9 Contactor alarm 0x0200 + # Bit 10 Short circuit alarm 0x0400 + # Bit 11 BMS internal alarm 0x0800 + # Bit 12 Cell imbalance alarm 0x1000 + # Bit 13 Reserved 0x2000 + # Bit 14 Reserved 0x4000 + # Bit 15 Reserved 0x8000 + +sensor: + - platform: template + id: bms${bms_id}_yambms_errors_bitmask + device_id: bms_${bms_id} + name: "YamBMS Errors Bitmask" + update_interval: ${bms_update_interval} + accuracy_decimals: 0 + icon: mdi:alert-circle-outline + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: |- + uint16_t yambms_errors = 0; + + // Get fault and alarm bitmasks + uint32_t fault = 0; + uint32_t alarm = 0; + + if (!std::isnan(id(bms${bms_id}_fault_bitmask).state)) { + fault = static_cast(id(bms${bms_id}_fault_bitmask).state); + } + if (!std::isnan(id(bms${bms_id}_alarm_bitmask).state)) { + alarm = static_cast(id(bms${bms_id}_alarm_bitmask).state); + } + + // If any fault or alarm, set general alarm (bit 0) + if (fault != 0 || alarm != 0) { + yambms_errors |= 0x0001; + } + + // High voltage alarm (bit 1): Cell OV (bit 0) or Pack OV (bit 2) + if ((fault & 0x05) || (alarm & 0x05)) { + yambms_errors |= 0x0002; + } + + // Low voltage alarm (bit 2): Cell UV (bit 1) or Pack UV (bit 3) + if ((fault & 0x0A) || (alarm & 0x0A)) { + yambms_errors |= 0x0004; + } + + // High temperature alarm (bit 3): Discharge HT (bit 10), MOS HT (bit 12), Ambient HT (bit 13) + if ((fault & 0x3400) || (alarm & 0x0C00)) { + yambms_errors |= 0x0008; + } + + // Low temperature alarm (bit 4): Discharge LT (bit 11), Ambient LT (bit 14) + if ((fault & 0x4800) || (alarm & 0x1000)) { + yambms_errors |= 0x0010; + } + + // High temperature charge alarm (bit 5): Charge HT (bit 8) + if ((fault & 0x100) || (alarm & 0x40)) { + yambms_errors |= 0x0020; + } + + // Low temperature charge alarm (bit 6): Charge LT (bit 9) + if ((fault & 0x200) || (alarm & 0x80)) { + yambms_errors |= 0x0040; + } + + // High discharge current alarm (bit 7): Discharge OC Slow/Fast (bits 6-7) + if ((fault & 0xC0) || (alarm & 0x20)) { + yambms_errors |= 0x0080; + } + + // High charge current alarm (bit 8): Charge OC Slow/Fast (bits 4-5) + if ((fault & 0x30) || (alarm & 0x10)) { + yambms_errors |= 0x0100; + } + + // Contactor/MOS alarm (bit 9): Charge MOS Fault (bit 21), Discharge MOS Fault (bit 22) + if (fault & 0x600000) { + yambms_errors |= 0x0200; + } + + // Short circuit alarm (bit 10): Short Circuit (bit 18) + if (fault & 0x40000) { + yambms_errors |= 0x0400; + } + + // BMS internal alarm (bit 11): AFE Comm Error (bit 23), Cell Offline (bit 19), + // Temp Sensor Fail (bit 20), EEP Fault (alarm bit 16), RTC Abnormal (alarm bit 17) + if ((fault & 0xB80000) || (alarm & 0x30000)) { + yambms_errors |= 0x0800; + } + + // Cell imbalance alarm (bit 12): Cell V Diff (bit 15), Temp Diff (bit 16) + if ((fault & 0x18000) || (alarm & 0x6000)) { + yambms_errors |= 0x1000; + } + + return yambms_errors; diff --git a/packages/bms/bms_modbus_Ecoworthy_RS485_full.yaml b/packages/bms/bms_modbus_Ecoworthy_RS485_full.yaml new file mode 100644 index 0000000..fadb6d5 --- /dev/null +++ b/packages/bms/bms_modbus_Ecoworthy_RS485_full.yaml @@ -0,0 +1,26 @@ +# Updated : 2026.02.15 +# Version : 1.0.0 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +substitutions: + bms_model: "Ecoworthy RS485" + bms_protocol: "Multi-node" + +packages: + bms_sensors: !include bms_sensors_Ecoworthy_RS485_full.yaml + bms_combine: !include bms_modbus_server.yaml diff --git a/packages/bms/bms_modbus_Ecoworthy_RS485_secondary.yaml b/packages/bms/bms_modbus_Ecoworthy_RS485_secondary.yaml new file mode 100644 index 0000000..d86641b --- /dev/null +++ b/packages/bms/bms_modbus_Ecoworthy_RS485_secondary.yaml @@ -0,0 +1,26 @@ +# Updated : 2026.02.15 +# Version : 1.0.0 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +substitutions: + bms_model: "Ecoworthy Secondary" + bms_protocol: "Multi-node" + +packages: + bms_sensors: !include bms_sensors_Ecoworthy_RS485_secondary.yaml + bms_combine: !include bms_modbus_server.yaml diff --git a/packages/bms/bms_sensors_Ecoworthy_RS485_full.yaml b/packages/bms/bms_sensors_Ecoworthy_RS485_full.yaml new file mode 100644 index 0000000..5f159f1 --- /dev/null +++ b/packages/bms/bms_sensors_Ecoworthy_RS485_full.yaml @@ -0,0 +1,636 @@ +# Updated : 2026.02.05 +# Version : 1.1.1 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +# +--------------------------------------+ +# | Ecoworthy BMS RS485 Sensor Package | +# +--------------------------------------+ +# This package integrates the Ecoworthy BMS component with YamBMS. +# This is the PRIMARY package - use bms_sensors_Ecoworthy_RS485_secondary.yaml +# for secondary batteries polled through this primary. +# +# Required substitutions: +# bms_id: The BMS ID number +# bms_name: Display name for the BMS +# bms_address: Modbus address of the BMS (0x01-0x0F) +# ecoworthy_modbus_id: The ecoworthy_modbus component ID +# bms_update_interval: Update interval (e.g., '3s') +# +# Optional substitutions: +# bms_battery_count: Number of batteries to poll (1=primary only, 2+=primary+secondaries) +# +# Note: Protection thresholds (cell OVP/UVP, pack OVP/UVP) and balance settings +# are now read directly from BMS config registers + +substitutions: + bms_battery_count: '1' + +packages: + bms_base: !include bms_base.yaml + bms_temperature_sensor: !include bms_temperature_sensor_4.yaml + bms_errors_bitmask: !include bms_errors_bitmask_Ecoworthy.yaml + led_assign: !include bms_base_led_assign.yaml + +# +--------------------------------------+ +# | Component settings | +# +--------------------------------------+ + +external_components: + - source: github://RAR/esphome-ecoworthy-bms@v1.0.0 + refresh: 0s + +ecoworthy_bms: + - id: ecoworthy_bms${bms_id} + address: ${bms_address} + ecoworthy_modbus_id: ${ecoworthy_modbus_id} + update_interval: ${bms_update_interval} + battery_count: ${bms_battery_count} + +# +--------------------------------------+ +# | Component entities | +# +--------------------------------------+ + +binary_sensor: + # online_status + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + online_status: + id: bms${bms_id}_online_status + device_id: bms_${bms_id} + name: "online status" + trigger_on_initial_state: true + on_state: + then: + - lambda: |- + // Pass the current state to the update function + id(global_update_fault)(${CAT_BMS}, ${bms_id}, !x); + balancing: + id: bms${bms_id}_bms_equalizing + device_id: bms_${bms_id} + name: "balancing" + + # MOS status and charging/discharging state from component + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + # charging = actively charging right now (current flowing in) + charging: + device_id: bms_${bms_id} + name: "charging active" + # discharging = actively discharging right now (current flowing out) + discharging: + device_id: bms_${bms_id} + name: "discharging active" + # charging_switch = charging is allowed/permitted (MOS on) + charging_switch: + id: bms${bms_id}_charge_mos_internal + device_id: bms_${bms_id} + internal: true + # discharging_switch = discharging is allowed/permitted (MOS on) + discharging_switch: + id: bms${bms_id}_discharge_mos_internal + device_id: bms_${bms_id} + internal: true + + # bms_switch_charging - YamBMS uses this to check if charging is ALLOWED (MOS on) + - platform: template + id: bms${bms_id}_charging_allowed + device_id: bms_${bms_id} + name: "charging" + lambda: |- + return id(bms${bms_id}_charge_mos_internal).state; + + # bms_switch_discharging - YamBMS uses this to check if discharging is ALLOWED (MOS on) + - platform: template + id: bms${bms_id}_discharging_allowed + device_id: bms_${bms_id} + name: "discharging" + lambda: |- + return id(bms${bms_id}_discharge_mos_internal).state; + +switch: + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + charging: + id: bms${bms_id}_charge_switch + device_id: bms_${bms_id} + name: "Charge switch" + discharging: + id: bms${bms_id}_discharge_switch + device_id: bms_${bms_id} + name: "Discharge switch" + +sensor: + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + total_voltage: + id: bms${bms_id}_total_voltage + device_id: bms_${bms_id} + name: "total voltage" + current: + id: bms${bms_id}_current + device_id: bms_${bms_id} + name: "current" + power: + id: bms${bms_id}_power + device_id: bms_${bms_id} + name: "power" + charging_power: + id: bms${bms_id}_charging_power + device_id: bms_${bms_id} + name: "charging power" + discharging_power: + id: bms${bms_id}_discharging_power + device_id: bms_${bms_id} + name: "discharging power" + remaining_capacity: + id: bms${bms_id}_capacity_remaining_ah + device_id: bms_${bms_id} + name: "remaining capacity" + full_capacity: + id: bms${bms_id}_battery_capacity + device_id: bms_${bms_id} + name: "total capacity" + rated_capacity: + device_id: bms_${bms_id} + name: "rated capacity" + state_of_charge: + id: bms${bms_id}_state_of_charge + device_id: bms_${bms_id} + name: "state of charge" + state_of_health: + id: bms${bms_id}_battery_soh + device_id: bms_${bms_id} + name: "state of health" + cycle_count: + id: bms${bms_id}_charging_cycles_raw + device_id: bms_${bms_id} + name: "cycle" + min_cell_voltage: + id: bms${bms_id}_min_cell_voltage + device_id: bms_${bms_id} + name: "min cell voltage" + max_cell_voltage: + id: bms${bms_id}_max_cell_voltage + device_id: bms_${bms_id} + name: "max cell voltage" + delta_cell_voltage: + id: bms${bms_id}_delta_cell_voltage + device_id: bms_${bms_id} + name: "delta cell voltage" + average_cell_voltage: + id: bms${bms_id}_cell_average_voltage + device_id: bms_${bms_id} + name: "cell average voltage" + min_voltage_cell: + id: bms${bms_id}_min_voltage_cell + device_id: bms_${bms_id} + name: "min voltage cell" + max_voltage_cell: + id: bms${bms_id}_max_voltage_cell + device_id: bms_${bms_id} + name: "max voltage cell" + cell_voltage_1: + id: bms${bms_id}_cell_voltage_1 + device_id: bms_${bms_id} + name: "cell voltage 01" + cell_voltage_2: + id: bms${bms_id}_cell_voltage_2 + device_id: bms_${bms_id} + name: "cell voltage 02" + cell_voltage_3: + id: bms${bms_id}_cell_voltage_3 + device_id: bms_${bms_id} + name: "cell voltage 03" + cell_voltage_4: + id: bms${bms_id}_cell_voltage_4 + device_id: bms_${bms_id} + name: "cell voltage 04" + cell_voltage_5: + id: bms${bms_id}_cell_voltage_5 + device_id: bms_${bms_id} + name: "cell voltage 05" + cell_voltage_6: + id: bms${bms_id}_cell_voltage_6 + device_id: bms_${bms_id} + name: "cell voltage 06" + cell_voltage_7: + id: bms${bms_id}_cell_voltage_7 + device_id: bms_${bms_id} + name: "cell voltage 07" + cell_voltage_8: + id: bms${bms_id}_cell_voltage_8 + device_id: bms_${bms_id} + name: "cell voltage 08" + cell_voltage_9: + id: bms${bms_id}_cell_voltage_9 + device_id: bms_${bms_id} + name: "cell voltage 09" + cell_voltage_10: + id: bms${bms_id}_cell_voltage_10 + device_id: bms_${bms_id} + name: "cell voltage 10" + cell_voltage_11: + id: bms${bms_id}_cell_voltage_11 + device_id: bms_${bms_id} + name: "cell voltage 11" + cell_voltage_12: + id: bms${bms_id}_cell_voltage_12 + device_id: bms_${bms_id} + name: "cell voltage 12" + cell_voltage_13: + id: bms${bms_id}_cell_voltage_13 + device_id: bms_${bms_id} + name: "cell voltage 13" + cell_voltage_14: + id: bms${bms_id}_cell_voltage_14 + device_id: bms_${bms_id} + name: "cell voltage 14" + cell_voltage_15: + id: bms${bms_id}_cell_voltage_15 + device_id: bms_${bms_id} + name: "cell voltage 15" + cell_voltage_16: + id: bms${bms_id}_cell_voltage_16 + device_id: bms_${bms_id} + name: "cell voltage 16" + temperature_sensor_1: + id: bms${bms_id}_temperature_sensor_1 + device_id: bms_${bms_id} + name: "cell temperature 1" + temperature_sensor_2: + id: bms${bms_id}_temperature_sensor_2 + device_id: bms_${bms_id} + name: "cell temperature 2" + temperature_sensor_3: + id: bms${bms_id}_temperature_sensor_3 + device_id: bms_${bms_id} + name: "cell temperature 3" + temperature_sensor_4: + id: bms${bms_id}_temperature_sensor_4 + device_id: bms_${bms_id} + name: "cell temperature 4" + power_tube_temperature: + device_id: bms_${bms_id} + name: "mosfet temperature" + ambient_temperature: + device_id: bms_${bms_id} + name: "ambient temperature" + # min_temperature and max_temperature are provided by bms_temperature_sensor_4.yaml + avg_temperature: + device_id: bms_${bms_id} + name: "average temperature" + charge_voltage_limit: + device_id: bms_${bms_id} + name: "charge voltage limit" + charge_current_limit: + device_id: bms_${bms_id} + name: "total pack max charging current" + discharge_voltage_limit: + device_id: bms_${bms_id} + name: "discharge voltage limit" + discharge_current_limit: + device_id: bms_${bms_id} + name: "total pack max discharge current" + # Individual battery limits from 0x45 (primary only, not aggregated) + individual_charge_current_limit: + device_id: bms_${bms_id} + name: "individual max charging current" + individual_discharge_current_limit: + device_id: bms_${bms_id} + name: "individual max discharge current" + # Configured (static) limits from BMS config - used by YamBMS combine logic + # These never go to 0 when the battery is full, unlike the dynamic limits + configured_ccl: + id: bms${bms_id}_max_charge_current + device_id: bms_${bms_id} + name: "max charging current" + configured_dcl: + id: bms${bms_id}_max_discharge_current + device_id: bms_${bms_id} + name: "max discharge current" + fault_bitmask: + id: bms${bms_id}_fault_bitmask + device_id: bms_${bms_id} + name: "fault bitmask" + internal: true + alarm_bitmask: + id: bms${bms_id}_alarm_bitmask + device_id: bms_${bms_id} + name: "alarm bitmask" + internal: true + mosfet_status_bitmask: + id: bms${bms_id}_mosfet_bitmask + device_id: bms_${bms_id} + name: "mosfet status bitmask" + balancing_bitmask: + id: bms${bms_id}_balancing_bitmask + device_id: bms_${bms_id} + name: "balancing bitmask" + # Balance trigger voltage from BMS config (used by balancer template sensor) + balance_voltage: + id: bms${bms_id}_bms_balance_trigger_voltage + internal: true + # Balance difference threshold from BMS config + balance_difference: + device_id: bms_${bms_id} + name: "balance difference" + filters: + - throttle: 60s + # Cell protection thresholds from BMS config (rarely change) + cell_ovp_trigger: + id: bms${bms_id}_cell_ovp + device_id: bms_${bms_id} + name: "cell ovp" + filters: + - throttle: 60s + cell_ovp_release: + device_id: bms_${bms_id} + name: "cell ovp release" + filters: + - throttle: 60s + cell_uvp_trigger: + id: bms${bms_id}_cell_uvp + device_id: bms_${bms_id} + name: "cell uvp" + filters: + - throttle: 60s + cell_uvp_release: + device_id: bms_${bms_id} + name: "cell uvp release" + filters: + - throttle: 60s + # Pack protection thresholds from BMS config (rarely change) + pack_ovp_trigger: + device_id: bms_${bms_id} + name: "pack ovp" + filters: + - throttle: 60s + pack_ovp_release: + device_id: bms_${bms_id} + name: "pack ovp release" + filters: + - throttle: 60s + pack_uvp_trigger: + device_id: bms_${bms_id} + name: "pack uvp" + filters: + - throttle: 60s + pack_uvp_release: + device_id: bms_${bms_id} + name: "pack uvp release" + filters: + - throttle: 60s + # Temperature protection thresholds from BMS config (rarely change) + charge_ot_trigger: + device_id: bms_${bms_id} + name: "charge ot trigger" + filters: + - throttle: 60s + charge_ot_release: + device_id: bms_${bms_id} + name: "charge ot release" + filters: + - throttle: 60s + charge_ot_delay: + device_id: bms_${bms_id} + name: "charge ot delay" + filters: + - throttle: 60s + charge_ut_trigger: + device_id: bms_${bms_id} + name: "charge ut trigger" + filters: + - throttle: 60s + charge_ut_release: + device_id: bms_${bms_id} + name: "charge ut release" + filters: + - throttle: 60s + charge_ut_delay: + device_id: bms_${bms_id} + name: "charge ut delay" + filters: + - throttle: 60s + discharge_ot_trigger: + device_id: bms_${bms_id} + name: "discharge ot trigger" + filters: + - throttle: 60s + discharge_ot_release: + device_id: bms_${bms_id} + name: "discharge ot release" + filters: + - throttle: 60s + discharge_ot_delay: + device_id: bms_${bms_id} + name: "discharge ot delay" + filters: + - throttle: 60s + discharge_ut_trigger: + device_id: bms_${bms_id} + name: "discharge ut trigger" + filters: + - throttle: 60s + discharge_ut_release: + device_id: bms_${bms_id} + name: "discharge ut release" + filters: + - throttle: 60s + discharge_ut_delay: + device_id: bms_${bms_id} + name: "discharge ut delay" + filters: + - throttle: 60s + # Current protection thresholds from BMS config (rarely change) + charge_oc_alarm: + device_id: bms_${bms_id} + name: "charge oc alarm" + filters: + - throttle: 60s + charge_oc_alarm_delay: + device_id: bms_${bms_id} + name: "charge oc alarm delay" + filters: + - throttle: 60s + charge_oc_trigger: + device_id: bms_${bms_id} + name: "charge oc trigger" + filters: + - throttle: 60s + charge_oc_delay: + device_id: bms_${bms_id} + name: "charge oc delay" + filters: + - throttle: 60s + charge_oc_recover_delay: + device_id: bms_${bms_id} + name: "charge oc recover delay" + filters: + - throttle: 60s + charge_oc2_trigger: + device_id: bms_${bms_id} + name: "charge oc2 trigger" + filters: + - throttle: 60s + charge_oc2_delay: + device_id: bms_${bms_id} + name: "charge oc2 delay" + filters: + - throttle: 60s + discharge_oc_alarm: + device_id: bms_${bms_id} + name: "discharge oc alarm" + filters: + - throttle: 60s + discharge_oc_alarm_delay: + device_id: bms_${bms_id} + name: "discharge oc alarm delay" + filters: + - throttle: 60s + discharge_oc_trigger: + device_id: bms_${bms_id} + name: "discharge oc trigger" + filters: + - throttle: 60s + discharge_oc_delay: + device_id: bms_${bms_id} + name: "discharge oc delay" + filters: + - throttle: 60s + discharge_oc_recover_delay: + device_id: bms_${bms_id} + name: "discharge oc recover delay" + filters: + - throttle: 60s + discharge_oc2_trigger: + device_id: bms_${bms_id} + name: "discharge oc2 trigger" + filters: + - throttle: 60s + discharge_oc2_delay: + device_id: bms_${bms_id} + name: "discharge oc2 delay" + filters: + - throttle: 60s + # Misc config sensors + heater_start_temp: + device_id: bms_${bms_id} + name: "heater start temp" + filters: + - throttle: 60s + heater_stop_temp: + device_id: bms_${bms_id} + name: "heater stop temp" + filters: + - throttle: 60s + full_charge_voltage: + device_id: bms_${bms_id} + name: "full charge voltage" + filters: + - throttle: 60s + full_charge_current: + device_id: bms_${bms_id} + name: "full charge current" + filters: + - throttle: 60s + sleep_voltage: + device_id: bms_${bms_id} + name: "sleep voltage" + filters: + - throttle: 60s + sleep_delay: + device_id: bms_${bms_id} + name: "sleep delay" + filters: + - throttle: 60s + shunt_resistance: + device_id: bms_${bms_id} + name: "shunt resistance" + filters: + - throttle: 60s + + # Charging cycle capacity - Calculated from charging cycles and battery capacity + - platform: template + id: bms${bms_id}_cycle_capacity_raw + device_id: bms_${bms_id} + name: "charging cycle capacity" + update_interval: ${bms_update_interval} + unit_of_measurement: Ah + state_class: total + icon: mdi:car-battery + accuracy_decimals: 0 + internal: true + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: return id(bms${bms_id}_charging_cycles_raw).state * id(bms${bms_id}_battery_capacity).state; + +text_sensor: + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + operation_status: + id: bms${bms_id}_status + device_id: bms_${bms_id} + name: "status" + fault: + id: bms${bms_id}_fault_text + device_id: bms_${bms_id} + name: "fault" + internal: true + alarm: + id: bms${bms_id}_alarm_text + device_id: bms_${bms_id} + name: "alarm" + internal: true + # Product info + manufacturer: + device_id: bms_${bms_id} + name: "manufacturer" + bms_model: + device_id: bms_${bms_id} + name: "bms model" + bms_serial_number: + device_id: bms_${bms_id} + name: "bms serial number" + pack_serial_number: + device_id: bms_${bms_id} + name: "pack serial number" + firmware_version: + device_id: bms_${bms_id} + name: "firmware version" + hardware_version: + device_id: bms_${bms_id} + name: "hardware version" + # Config text sensors + balance_mode: + device_id: bms_${bms_id} + name: "balance mode" + can_protocol: + device_id: bms_${bms_id} + name: "can protocol" + rs485_protocol: + device_id: bms_${bms_id} + name: "rs485 protocol" + +button: + - platform: ecoworthy_bms + ecoworthy_bms_id: ecoworthy_bms${bms_id} + trip: + device_id: bms_${bms_id} + name: "trip breaker" diff --git a/packages/bms/bms_sensors_Ecoworthy_RS485_secondary.yaml b/packages/bms/bms_sensors_Ecoworthy_RS485_secondary.yaml new file mode 100644 index 0000000..990c5a4 --- /dev/null +++ b/packages/bms/bms_sensors_Ecoworthy_RS485_secondary.yaml @@ -0,0 +1,422 @@ +# Updated : 2026.02.15 +# Version : 1.1.1 +# GitHub : https://github.com/RAR/esphome-ecoworthy-bms + +# 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 . + +# +---------------------------------------+ +# | Ecoworthy BMS RS485 SECONDARY Package | +# +---------------------------------------+ +# This package provides YamBMS sensors for a SECONDARY battery polled +# through a primary Ecoworthy BMS component. +# +# The primary component must be configured with battery_count >= secondary_battery_number +# +# Required substitutions: +# bms_id: The YamBMS BMS ID number for this secondary +# bms_name: Display name for this secondary BMS +# parent_ecoworthy_bms_id: ID of the parent ecoworthy_bms component (e.g., 'ecoworthy_bms9') +# secondary_battery_number: The secondary battery number (2, 3, 4, etc.) +# +# Optional substitutions: +# bms_max_charge_current: Max charge current in A (default: 100) +# bms_max_discharge_current: Max discharge current in A (default: 100) +# bms_cell_ovp: Cell over-voltage protection in V (default: 3.650) +# bms_cell_uvp: Cell under-voltage protection in V (default: 2.500) +# bms_balance_trigger_voltage: Balance trigger voltage in V (default: 0.030) +# +# Note: Secondary batteries only have access to Pack Status data (not config blocks). +# balance_trigger_voltage must be set via substitution for secondaries. + +substitutions: + bms_balance_trigger_voltage: '0.030' + bms_cell_ovp: '3.650' + bms_cell_uvp: '2.500' + bms_max_charge_current: '100' + bms_max_discharge_current: '100' + +packages: + bms_base: !include bms_base.yaml + bms_temperature_sensor: !include bms_temperature_sensor_4.yaml + bms_errors_bitmask: !include bms_errors_bitmask_Ecoworthy_secondary.yaml + +# +--------------------------------------+ +# | Component entities | +# +--------------------------------------+ +# Note: No ecoworthy_bms component created here - we reference the parent's secondary sensors + +binary_sensor: + # Secondary battery binary sensors from parent component + - platform: ecoworthy_bms + ecoworthy_bms_id: ${parent_ecoworthy_bms_id} + batteries: + ${secondary_battery_number}: + online_status: + id: bms${bms_id}_online_status + device_id: bms_${bms_id} + name: "online status" + trigger_on_initial_state: true + on_state: + then: + - lambda: |- + // Pass the current state to the update function + id(global_update_fault)(${CAT_BMS}, ${bms_id}, !x); + balancing: + id: bms${bms_id}_bms_equalizing + device_id: bms_${bms_id} + name: "balancing" + charging: + device_id: bms_${bms_id} + name: "charging active" + discharging: + device_id: bms_${bms_id} + name: "discharging active" + charging_switch: + id: bms${bms_id}_charge_mos_internal + device_id: bms_${bms_id} + internal: true + discharging_switch: + id: bms${bms_id}_discharge_mos_internal + device_id: bms_${bms_id} + internal: true + + # bms_switch_charging - YamBMS uses this to check if charging is ALLOWED (MOS on) + - platform: template + id: bms${bms_id}_charging_allowed + device_id: bms_${bms_id} + name: "charging" + lambda: |- + return id(bms${bms_id}_charge_mos_internal).state; + + # bms_switch_discharging - YamBMS uses this to check if discharging is ALLOWED (MOS on) + - platform: template + id: bms${bms_id}_discharging_allowed + device_id: bms_${bms_id} + name: "discharging" + lambda: |- + return id(bms${bms_id}_discharge_mos_internal).state; + +sensor: + # Secondary battery sensors from parent component + - platform: ecoworthy_bms + ecoworthy_bms_id: ${parent_ecoworthy_bms_id} + batteries: + ${secondary_battery_number}: + total_voltage: + id: bms${bms_id}_total_voltage + device_id: bms_${bms_id} + name: "total voltage" + current: + id: bms${bms_id}_current + device_id: bms_${bms_id} + name: "current" + power: + id: bms${bms_id}_power + device_id: bms_${bms_id} + name: "power" + charging_power: + id: bms${bms_id}_charging_power + device_id: bms_${bms_id} + name: "charging power" + discharging_power: + id: bms${bms_id}_discharging_power + device_id: bms_${bms_id} + name: "discharging power" + remaining_capacity: + id: bms${bms_id}_capacity_remaining_ah + device_id: bms_${bms_id} + name: "remaining capacity" + full_capacity: + id: bms${bms_id}_battery_capacity + device_id: bms_${bms_id} + name: "total capacity" + rated_capacity: + device_id: bms_${bms_id} + name: "rated capacity" + state_of_charge: + id: bms${bms_id}_state_of_charge + device_id: bms_${bms_id} + name: "state of charge" + state_of_health: + id: bms${bms_id}_battery_soh + device_id: bms_${bms_id} + name: "state of health" + cycle_count: + id: bms${bms_id}_charging_cycles_raw + device_id: bms_${bms_id} + name: "cycle" + min_cell_voltage: + id: bms${bms_id}_min_cell_voltage + device_id: bms_${bms_id} + name: "min cell voltage" + max_cell_voltage: + id: bms${bms_id}_max_cell_voltage + device_id: bms_${bms_id} + name: "max cell voltage" + delta_cell_voltage: + id: bms${bms_id}_delta_cell_voltage + device_id: bms_${bms_id} + name: "delta cell voltage" + average_cell_voltage: + id: bms${bms_id}_cell_average_voltage + device_id: bms_${bms_id} + name: "cell average voltage" + min_voltage_cell: + id: bms${bms_id}_min_voltage_cell + device_id: bms_${bms_id} + name: "min voltage cell" + max_voltage_cell: + id: bms${bms_id}_max_voltage_cell + device_id: bms_${bms_id} + name: "max voltage cell" + cell_voltage_1: + id: bms${bms_id}_cell_voltage_1 + device_id: bms_${bms_id} + name: "cell voltage 01" + cell_voltage_2: + id: bms${bms_id}_cell_voltage_2 + device_id: bms_${bms_id} + name: "cell voltage 02" + cell_voltage_3: + id: bms${bms_id}_cell_voltage_3 + device_id: bms_${bms_id} + name: "cell voltage 03" + cell_voltage_4: + id: bms${bms_id}_cell_voltage_4 + device_id: bms_${bms_id} + name: "cell voltage 04" + cell_voltage_5: + id: bms${bms_id}_cell_voltage_5 + device_id: bms_${bms_id} + name: "cell voltage 05" + cell_voltage_6: + id: bms${bms_id}_cell_voltage_6 + device_id: bms_${bms_id} + name: "cell voltage 06" + cell_voltage_7: + id: bms${bms_id}_cell_voltage_7 + device_id: bms_${bms_id} + name: "cell voltage 07" + cell_voltage_8: + id: bms${bms_id}_cell_voltage_8 + device_id: bms_${bms_id} + name: "cell voltage 08" + cell_voltage_9: + id: bms${bms_id}_cell_voltage_9 + device_id: bms_${bms_id} + name: "cell voltage 09" + cell_voltage_10: + id: bms${bms_id}_cell_voltage_10 + device_id: bms_${bms_id} + name: "cell voltage 10" + cell_voltage_11: + id: bms${bms_id}_cell_voltage_11 + device_id: bms_${bms_id} + name: "cell voltage 11" + cell_voltage_12: + id: bms${bms_id}_cell_voltage_12 + device_id: bms_${bms_id} + name: "cell voltage 12" + cell_voltage_13: + id: bms${bms_id}_cell_voltage_13 + device_id: bms_${bms_id} + name: "cell voltage 13" + cell_voltage_14: + id: bms${bms_id}_cell_voltage_14 + device_id: bms_${bms_id} + name: "cell voltage 14" + cell_voltage_15: + id: bms${bms_id}_cell_voltage_15 + device_id: bms_${bms_id} + name: "cell voltage 15" + cell_voltage_16: + id: bms${bms_id}_cell_voltage_16 + device_id: bms_${bms_id} + name: "cell voltage 16" + temperature_sensor_1: + id: bms${bms_id}_temperature_sensor_1 + device_id: bms_${bms_id} + name: "cell temperature 1" + temperature_sensor_2: + id: bms${bms_id}_temperature_sensor_2 + device_id: bms_${bms_id} + name: "cell temperature 2" + temperature_sensor_3: + id: bms${bms_id}_temperature_sensor_3 + device_id: bms_${bms_id} + name: "cell temperature 3" + temperature_sensor_4: + id: bms${bms_id}_temperature_sensor_4 + device_id: bms_${bms_id} + name: "cell temperature 4" + power_tube_temperature: + device_id: bms_${bms_id} + name: "mosfet temperature" + ambient_temperature: + device_id: bms_${bms_id} + name: "ambient temperature" + # min_temperature and max_temperature are provided by bms_temperature_sensor_4.yaml + avg_temperature: + device_id: bms_${bms_id} + name: "average temperature" + charge_voltage_limit: + device_id: bms_${bms_id} + name: "charge voltage limit" + charge_current_limit: + device_id: bms_${bms_id} + name: "dynamic max charging current" + discharge_voltage_limit: + device_id: bms_${bms_id} + name: "discharge voltage limit" + discharge_current_limit: + device_id: bms_${bms_id} + name: "dynamic max discharge current" + fault_bitmask: + id: bms${bms_id}_fault_bitmask + device_id: bms_${bms_id} + name: "fault bitmask" + internal: true + alarm_bitmask: + id: bms${bms_id}_alarm_bitmask + device_id: bms_${bms_id} + name: "alarm bitmask" + internal: true + mosfet_status_bitmask: + id: bms${bms_id}_mosfet_bitmask + device_id: bms_${bms_id} + name: "mosfet status bitmask" + balancing_bitmask: + id: bms${bms_id}_balancing_bitmask + device_id: bms_${bms_id} + name: "balancing bitmask" + + # Required sensors - balance trigger voltage (configurable via substitution) + - platform: template + id: bms${bms_id}_bms_balance_trigger_voltage + device_id: bms_${bms_id} + name: "balance trigger voltage" + update_interval: ${bms_update_interval} + accuracy_decimals: 3 + unit_of_measurement: "V" + state_class: measurement + device_class: 'voltage' + filters: + - or: + - throttle: 10s + - delta: 0.001 + lambda: return ${bms_balance_trigger_voltage}; + + # Cell OVP (configurable via substitution) + - platform: template + id: bms${bms_id}_cell_ovp + device_id: bms_${bms_id} + name: "cell ovp" + update_interval: ${bms_update_interval} + accuracy_decimals: 3 + unit_of_measurement: "V" + state_class: measurement + device_class: 'voltage' + filters: + - or: + - throttle: 10s + - delta: 0.001 + lambda: return ${bms_cell_ovp}; + + # Cell UVP (configurable via substitution) + - platform: template + id: bms${bms_id}_cell_uvp + device_id: bms_${bms_id} + name: "cell uvp" + update_interval: ${bms_update_interval} + accuracy_decimals: 3 + unit_of_measurement: "V" + state_class: measurement + device_class: 'voltage' + filters: + - or: + - throttle: 10s + - delta: 0.001 + lambda: return ${bms_cell_uvp}; + + # Max charge current (static, configurable via substitution) + - platform: template + id: bms${bms_id}_max_charge_current + device_id: bms_${bms_id} + name: "max charging current" + update_interval: ${bms_update_interval} + accuracy_decimals: 0 + unit_of_measurement: "A" + state_class: measurement + device_class: 'current' + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: return ${bms_max_charge_current}; + + # Max discharge current (static, configurable via substitution) + - platform: template + id: bms${bms_id}_max_discharge_current + device_id: bms_${bms_id} + name: "max discharge current" + update_interval: ${bms_update_interval} + accuracy_decimals: 0 + unit_of_measurement: "A" + state_class: measurement + device_class: 'current' + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: return ${bms_max_discharge_current}; + + # Charging cycle capacity - Calculated from charging cycles and battery capacity + - platform: template + id: bms${bms_id}_cycle_capacity_raw + device_id: bms_${bms_id} + name: "charging cycle capacity" + update_interval: ${bms_update_interval} + unit_of_measurement: Ah + state_class: total + icon: mdi:car-battery + accuracy_decimals: 0 + internal: true + filters: + - or: + - throttle: 10s + - delta: 1 + lambda: return id(bms${bms_id}_charging_cycles_raw).state * id(bms${bms_id}_battery_capacity).state; + +text_sensor: + # Secondary battery text sensors from parent component + - platform: ecoworthy_bms + ecoworthy_bms_id: ${parent_ecoworthy_bms_id} + batteries: + ${secondary_battery_number}: + operation_status: + id: bms${bms_id}_status + device_id: bms_${bms_id} + name: "status" + fault: + id: bms${bms_id}_fault_text + device_id: bms_${bms_id} + name: "fault" + internal: true + alarm: + id: bms${bms_id}_alarm_text + device_id: bms_${bms_id} + name: "alarm" + internal: true