From 978c634eb9e26414dd7181d4bf52162ef41e20b6 Mon Sep 17 00:00:00 2001 From: Sleeper85 Date: Sat, 11 Jul 2026 16:49:06 +0200 Subject: [PATCH] Improved YamBMS 1.7.1 Cut-Off charging logic --- .../YamBMS_HA_Dashboard_DEMO.yaml | 5 +- .../YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml | 5 +- .../YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml | 5 +- ...MS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml | 5 +- .../YamBMS_HA_Dashboard_without_BMS.yaml | 5 +- YamBMS_LP_DEMO.yaml | 6 +- YamBMS_LP_PVbrain2.yaml | 34 ++++-- YamBMS_Local_Packages_example.yaml | 6 +- YamBMS_RP_BMS_BASEN_RS485.yaml | 6 +- YamBMS_RP_BMS_DEYE_CAN.yaml | 6 +- YamBMS_RP_BMS_EG4_RS485.yaml | 6 +- YamBMS_RP_BMS_Ecoworthy_RS485.yaml | 6 +- YamBMS_RP_BMS_JBD.yaml | 6 +- YamBMS_RP_BMS_JK-B_RS485_Modbus.yaml | 6 +- YamBMS_RP_BMS_JK-PB_RS485_Modbus.yaml | 6 +- YamBMS_RP_BMS_JK_BLE.yaml | 6 +- YamBMS_RP_BMS_JK_UART_4G-GPS.yaml | 6 +- YamBMS_RP_BMS_PACE_RS485_Modbus.yaml | 6 +- YamBMS_RP_BMS_SEPLOS_V1_V2_RS485_Modbus.yaml | 6 +- ...RP_BMS_SEPLOS_V3_RS485_Modbus_sniffer.yaml | 6 +- YamBMS_RP_Balancer.yaml | 6 +- YamBMS_RP_DEMO.yaml | 6 +- YamBMS_RP_Ethernet_board.yaml | 6 +- YamBMS_RP_PVbrain2.yaml | 32 ++++-- YamBMS_Remote_Packages_example.yaml | 6 +- ...MS_Remote_Packages_example_dev_branch.yaml | 6 +- documents/README/Charging_logic.md | 56 ++++++++- ...ote_YamBMS_1.7.1_Cut-Off_charging_logic.md | 98 ++++++++++++++++ documents/README/YamBMS_functions.md | 8 ++ ...Charging_Settings_Cut-Off_Cell_Voltage.png | Bin 0 -> 38344 bytes packages/yambms/yambms_core.yaml | 108 +++++++++++++++--- 31 files changed, 378 insertions(+), 97 deletions(-) create mode 100644 documents/README/Release_note_YamBMS_1.7.1_Cut-Off_charging_logic.md create mode 100644 images/YamBMS_Charging_Settings_Cut-Off_Cell_Voltage.png diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml index d5bddba..790b72f 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.08 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -273,6 +273,9 @@ views: - entity: number.yambms_demo_charger_offset_v name: type: entity + - entity: select.yambms_demo_cut_off_cell_voltage + name: + type: entity - type: weblink url: >- https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_functions.md#charging-settings diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml index 0774646..cd54555 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.08 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -338,6 +338,9 @@ views: - entity: number.yambms_1_charger_offset_v name: type: entity + - entity: select.yambms_1_cut_off_cell_voltage + name: + type: entity - type: weblink url: >- https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_functions.md#charging-settings diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml index 36537e7..2682655 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.08 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -338,6 +338,9 @@ views: - entity: number.yambms_1_charger_offset_v name: type: entity + - entity: select.yambms_1_cut_off_cell_voltage + name: + type: entity - type: weblink url: >- https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_functions.md#charging-settings diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml index 72a03f3..b8d86ab 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.08 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -338,6 +338,9 @@ views: - entity: number.yambms_1_charger_offset_v name: type: entity + - entity: select.yambms_1_cut_off_cell_voltage + name: + type: entity - type: weblink url: >- https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_functions.md#charging-settings diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml index 1f8a61f..a8a252d 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.08 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -338,6 +338,9 @@ views: - entity: number.yambms_1_charger_offset_v name: type: entity + - entity: select.yambms_1_cut_off_cell_voltage + name: + type: entity - type: weblink url: >- https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_functions.md#charging-settings diff --git a/YamBMS_LP_DEMO.yaml b/YamBMS_LP_DEMO.yaml index 0b9302e..1412596 100644 --- a/YamBMS_LP_DEMO.yaml +++ b/YamBMS_LP_DEMO.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_LP_PVbrain2.yaml b/YamBMS_LP_PVbrain2.yaml index e81d053..b891776 100644 --- a/YamBMS_LP_PVbrain2.yaml +++ b/YamBMS_LP_PVbrain2.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 @@ -187,10 +187,26 @@ packages: # uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml # BUS - # spi_bus: !include packages/board/board_options_itf_bus_spi.yaml # SPI bus for MCP2515 + # 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 + # Modbus 1 + # modbus_1: !include + # file: 'packages/board/board_options_itf_modbus_expander.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_${uart_hub_bus}_1' + + # Modbus 2 + # modbus_2: !include + # file: 'packages/board/board_options_itf_modbus_expander.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_${uart_hub_bus}_2' + # WK2168 UART/IO Expander wk2168_spi: !include packages/board/board_options_itf_pvbrain2_wk2168_spi.yaml # wk2168_i2c: !include packages/board/board_options_itf_pvbrain2_wk2168_i2c.yaml @@ -206,7 +222,7 @@ packages: # to inverter = canbus_inverter_1 canbus_node_id: 'canbus_inverter_1' - # CAN transceiver - MCP2515 + # CAN transceiver - SPI bus and MCP2515 # canbus_node_2: !include # file: packages/board/board_options_itf_canbus_mcp2515.yaml # vars: @@ -215,7 +231,7 @@ packages: # canbus_node_id: 'canbus_inverter_1' # PSRAM octal 80Mhz - # psram_octal_80Mhz: !include packages/board/board_options_PSRAM_octal_80Mhz.yaml + psram_octal_80Mhz: !include packages/board/board_options_PSRAM_octal_80Mhz.yaml # Web Server # web_server: !include packages/yambms/yambms_web_server.yaml @@ -276,7 +292,7 @@ packages: # 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_id: 'uart_${uart_hub_bus}_3' # UART interface to which your inverter is connected # rs485_uart_baud_rate: '9600' # rs485_update_timeout: '10s' # rs485_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable @@ -287,8 +303,8 @@ packages: # +------------------------------------------------------------------------------+ device_debug: !include - file: packages/base/device_debug_ESP32.yaml - # file: packages/base/device_debug_ESP32_PSRAM.yaml + # file: packages/base/device_debug_ESP32.yaml + file: packages/base/device_debug_ESP32_PSRAM.yaml vars: debug_name: 'Debug' debug_update_interval: '5s' diff --git a/YamBMS_Local_Packages_example.yaml b/YamBMS_Local_Packages_example.yaml index c241893..a27fe12 100644 --- a/YamBMS_Local_Packages_example.yaml +++ b/YamBMS_Local_Packages_example.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_BASEN_RS485.yaml b/YamBMS_RP_BMS_BASEN_RS485.yaml index 7d31500..689a25a 100644 --- a/YamBMS_RP_BMS_BASEN_RS485.yaml +++ b/YamBMS_RP_BMS_BASEN_RS485.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_DEYE_CAN.yaml b/YamBMS_RP_BMS_DEYE_CAN.yaml index b638f34..48b140f 100644 --- a/YamBMS_RP_BMS_DEYE_CAN.yaml +++ b/YamBMS_RP_BMS_DEYE_CAN.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_EG4_RS485.yaml b/YamBMS_RP_BMS_EG4_RS485.yaml index b763075..717c3bb 100644 --- a/YamBMS_RP_BMS_EG4_RS485.yaml +++ b/YamBMS_RP_BMS_EG4_RS485.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_Ecoworthy_RS485.yaml b/YamBMS_RP_BMS_Ecoworthy_RS485.yaml index 5183896..bd2252d 100644 --- a/YamBMS_RP_BMS_Ecoworthy_RS485.yaml +++ b/YamBMS_RP_BMS_Ecoworthy_RS485.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_JBD.yaml b/YamBMS_RP_BMS_JBD.yaml index f391f1e..3c179d3 100644 --- a/YamBMS_RP_BMS_JBD.yaml +++ b/YamBMS_RP_BMS_JBD.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_JK-B_RS485_Modbus.yaml b/YamBMS_RP_BMS_JK-B_RS485_Modbus.yaml index 1303302..4db34e1 100644 --- a/YamBMS_RP_BMS_JK-B_RS485_Modbus.yaml +++ b/YamBMS_RP_BMS_JK-B_RS485_Modbus.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_JK-PB_RS485_Modbus.yaml b/YamBMS_RP_BMS_JK-PB_RS485_Modbus.yaml index a692820..4b9fe04 100644 --- a/YamBMS_RP_BMS_JK-PB_RS485_Modbus.yaml +++ b/YamBMS_RP_BMS_JK-PB_RS485_Modbus.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_JK_BLE.yaml b/YamBMS_RP_BMS_JK_BLE.yaml index 0aa0267..6420643 100644 --- a/YamBMS_RP_BMS_JK_BLE.yaml +++ b/YamBMS_RP_BMS_JK_BLE.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_JK_UART_4G-GPS.yaml b/YamBMS_RP_BMS_JK_UART_4G-GPS.yaml index d18ce55..9dba197 100644 --- a/YamBMS_RP_BMS_JK_UART_4G-GPS.yaml +++ b/YamBMS_RP_BMS_JK_UART_4G-GPS.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_PACE_RS485_Modbus.yaml b/YamBMS_RP_BMS_PACE_RS485_Modbus.yaml index 67bc7e7..f425b90 100644 --- a/YamBMS_RP_BMS_PACE_RS485_Modbus.yaml +++ b/YamBMS_RP_BMS_PACE_RS485_Modbus.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_SEPLOS_V1_V2_RS485_Modbus.yaml b/YamBMS_RP_BMS_SEPLOS_V1_V2_RS485_Modbus.yaml index 5d67045..ac9188f 100644 --- a/YamBMS_RP_BMS_SEPLOS_V1_V2_RS485_Modbus.yaml +++ b/YamBMS_RP_BMS_SEPLOS_V1_V2_RS485_Modbus.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_BMS_SEPLOS_V3_RS485_Modbus_sniffer.yaml b/YamBMS_RP_BMS_SEPLOS_V3_RS485_Modbus_sniffer.yaml index 8668fce..65951f2 100644 --- a/YamBMS_RP_BMS_SEPLOS_V3_RS485_Modbus_sniffer.yaml +++ b/YamBMS_RP_BMS_SEPLOS_V3_RS485_Modbus_sniffer.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_Balancer.yaml b/YamBMS_RP_Balancer.yaml index 433ab0d..518dcc0 100644 --- a/YamBMS_RP_Balancer.yaml +++ b/YamBMS_RP_Balancer.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_DEMO.yaml b/YamBMS_RP_DEMO.yaml index e9b8618..adab2d2 100644 --- a/YamBMS_RP_DEMO.yaml +++ b/YamBMS_RP_DEMO.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_Ethernet_board.yaml b/YamBMS_RP_Ethernet_board.yaml index f20d1d3..a56677b 100644 --- a/YamBMS_RP_Ethernet_board.yaml +++ b/YamBMS_RP_Ethernet_board.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_RP_PVbrain2.yaml b/YamBMS_RP_PVbrain2.yaml index 70cad49..ae91c46 100644 --- a/YamBMS_RP_PVbrain2.yaml +++ b/YamBMS_RP_PVbrain2.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 @@ -192,10 +192,24 @@ packages: # - path: 'packages/board/board_options_itf_uart_esp_3.yaml' # BUS - # - path: 'packages/board/board_options_itf_bus_spi.yaml' # SPI bus for MCP2515 + # - path: 'packages/board/board_options_itf_bus_spi.yaml' # SPI bus # - path: 'packages/board/board_options_itf_bus_i2c.yaml' # I2C bus for SX1509 and BME280/BMP280 # - path: 'packages/board/board_options_itf_bus_one_wire.yaml' # One wire bus for Dallas Temperature Sensor + # Modbus 1 + # - path: 'packages/board/board_options_itf_modbus_expander.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_${uart_hub_bus}_1' + + # Modbus 2 + # - path: 'packages/board/board_options_itf_modbus_expander.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_${uart_hub_bus}_2' + # WK2168 UART/IO Expander - path: 'packages/board/board_options_itf_pvbrain2_wk2168_spi.yaml' # - path: 'packages/board/board_options_itf_pvbrain2_wk2168_i2c.yaml' @@ -210,7 +224,7 @@ packages: # to inverter = canbus_inverter_1 canbus_node_id: 'canbus_inverter_1' - # CAN transceiver - MCP2515 + # CAN transceiver - SPI bus and MCP2515 # - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml' # vars: # # to bms = canbus_bms_1 @@ -218,7 +232,7 @@ packages: # canbus_node_id: 'canbus_inverter_1' # PSRAM octal 80Mhz - # - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml' + - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml' # Web Server # - path: 'packages/yambms/yambms_web_server.yaml' @@ -279,7 +293,7 @@ packages: # 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_id: 'uart_${uart_hub_bus}_3' # UART interface to which your inverter is connected # rs485_uart_baud_rate: '9600' # rs485_update_timeout: '10s' # rs485_status_led_id: 'esp_light' # LED used to show status; default = esp_light, comment out to disable @@ -290,8 +304,8 @@ packages: # | >>> DEBUG ( logger level must be DEBUG ) # +------------------------------------------------------------------------------+ - - path: packages/base/device_debug_ESP32.yaml - # - path: packages/base/device_debug_ESP32_PSRAM.yaml + # - path: packages/base/device_debug_ESP32.yaml + - path: packages/base/device_debug_ESP32_PSRAM.yaml vars: debug_name: 'Debug' debug_update_interval: '5s' diff --git a/YamBMS_Remote_Packages_example.yaml b/YamBMS_Remote_Packages_example.yaml index 4212d5a..316c907 100644 --- a/YamBMS_Remote_Packages_example.yaml +++ b/YamBMS_Remote_Packages_example.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/YamBMS_Remote_Packages_example_dev_branch.yaml b/YamBMS_Remote_Packages_example_dev_branch.yaml index 600534d..184f9e9 100644 --- a/YamBMS_Remote_Packages_example_dev_branch.yaml +++ b/YamBMS_Remote_Packages_example_dev_branch.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.06.29 -# Version : 1.7.0 +# Updated : 2026.07.15 +# Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -90,7 +90,7 @@ substitutions: # 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' + 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 diff --git a/documents/README/Charging_logic.md b/documents/README/Charging_logic.md index 3a01fb0..a9e18f4 100644 --- a/documents/README/Charging_logic.md +++ b/documents/README/Charging_logic.md @@ -9,6 +9,9 @@ > [!NOTE] > Please read the documentation regarding the [charging settings](YamBMS_functions.md#charging-settings). +> [!NOTE] +> Please read the [YamBMS 1.7.1 Cut-Off charging logic release note](Release_note_YamBMS_1.7.1_Cut-Off_charging_logic.md). + ## Charging Logic Diagram The charging voltage and current correspond to the default values in the YAML script and can be modified. @@ -25,29 +28,74 @@ Note: The equations below can be adopted for other chemistries like Li-ion and L +The physical anchor of the equation is **CVmin**, the resting voltage of a fully charged cell (~3.37 V for LFP): a cell above `cv_min` at zero current is full, and a cell cannot become full while staying below `cv_min + R·I` under current. The current taper therefore inevitably crosses the criterion when the battery is genuinely full, even if the requested charge voltage is never reached (e.g. low PV production days). + +## Cut-Off Cell Voltage source + +The `Cut-Off Cell Voltage` select defines which cell voltage feeds the whole Cut-Off logic below (`cell_v` in this document): + +- `Max Cell Voltage` (default): `cell_v = max_cell_v`. Conservative, the end of charge depends on the highest cell. +- `Average Cell Voltage`: `cell_v = battery_voltage / cell_count`. The end of charge reflects the state of the whole pack, giving a consistent charge termination voltage from one day to the next. Recommended for packs built from unmatched cells (different internal resistances), packs with a runner cell, or a BMS that does not report its equalizing status. + +> [!WARNING] +> With `Average Cell Voltage`, the highest cell no longer stops the charge. Cell-level protection **must** be ensured by `Auto CVL` and/or `Auto CCL`, the BMS `OVP` remaining the last resort. If your inverter does not respect the requested charge voltage, only the `Auto CCL` is effective. + ## Cut-Off Charging Logic Diagram (what's happening in the yellow diamond) -Note: The diagram below is valid for other chemistries like Li-ion and LTO but with other CVmin and CVmax values. +> [!NOTE] +> The diagram below is valid for other chemistries like Li-ion and LTO but with other CVmin and CVmax values. + +> [!WARNING] +> This diagram no longer reflects reality and needs to be updated. ![Image](../../images/YamBMS_Cut-Off_Charging_Logic_Diagram.png "YamBMS Cut-Off Charging Logic Diagram") +The logic evaluates the battery current first, in three zones: + +**1. Current deadband** (`current < 0.005C`, ≈1.4 A on a 280 Ah pack) — the current is within sensor noise or PV starvation, the compensated equation is not meaningful. Three outcomes: + +- `cell_v ≥ cv_min` and `SoC ≥ 95 %` → **Cut-Off conditions valid**. This is the *fully charged at rest* signature: `cv_min` is by definition the resting voltage of a full cell, so a battery that stops accepting current with `cell_v` above it has completed its charge — without ever needing to reach the bulk voltage. +- `cell_v < cv_min` → **Bulk conditions valid**: the battery cannot be full, any running timer is stopped. +- otherwise → **grey zone**: no conclusion is drawn, the charge status is left unchanged. + +**2. Charging** (`current > deadband`) — the **Cut-Off conditions are valid** when both: + +- `cutoff_voltage ≥ cv_min` where `cutoff_voltage = cell_v − cutoff_resistance × current` (the compensated criterion, see the equation above); +- `SoC ≥ 95 %` (`yambms_eoc_min_soc`, configurable, max 98 %) — a safety net against premature Cut-Off caused by a runner cell or a transient voltage reading. + +Otherwise the **Bulk conditions are valid**. + +**3. Discharging** — the **Bulk conditions are valid** when `cell_v < cell_bulk_v − cell_hysteresis_v` (20 mV/cell by default). Otherwise nothing changes (grey zone). + +The Bulk or Cut-Off **conditions must hold continuously for 10s** before the corresponding phase is entered. Transient states (cloud passages, load spikes) that flip the conditions back and forth never change the phase. + +Once the **Cut-Off phase** is entered: + +- if the BMS reports that cells are **equalizing**, the cut-off timer is stopped: the charge is held so the balancer can work; +- otherwise the **cut-off timer** starts (`180s` default): if the Cut-Off conditions still hold when it expires, the **EOC** (End Of Charge) is declared; +- in parallel, if the `EOC timer` switch is enabled, the **EOC timer** (`30min` default) guarantees that the Cut-Off phase ends at the latest when it expires, even if cells are still equalizing. + +Returning to the Bulk phase stops both timers. + ## LFP Cut-Off Values - Nominal : 3.20 V - CV min : 3.37 V - CV max : 3.65 V -To enter the **Cut-Off phase** the only condition is that **cutoff_voltage > cv_min**. +To enter the **Cut-Off phase** while charging, **cutoff_voltage ≥ cv_min** and **SoC ≥ 95 %** must hold for 10s. ![Image](../../images/YamBMS_LFP_Cut-Off_Values.png "LFP Cut-Off Values") +Reading example at 5A: the Cut-Off conditions become valid when `cell_v` reaches **3.47 V** (the row where `Cut-Off A.` equals the instantaneous current). The `Cut-Off V.` column shows the compensated voltage for each `cell_v`, which must exceed `cv_min`. + ## Li-ion Cut-Off Values - Nominal : 3.60 V - CV min : 3.90 V - CV max : 4.20 V -To enter the **Cut-Off phase** the only condition is that **cutoff_voltage > cv_min**. +To enter the **Cut-Off phase** while charging, **cutoff_voltage ≥ cv_min** and **SoC ≥ 95 %** must hold for 10s. ![Image](../../images/YamBMS_Li-ion_Cut-Off_Values.png "Li-ion Cut-Off Values") @@ -57,6 +105,6 @@ To enter the **Cut-Off phase** the only condition is that **cutoff_voltage > cv_ - CV min : 2.55 V - CV max : 2.85 V -To enter the **Cut-Off phase** the only condition is that **cutoff_voltage > cv_min**. +To enter the **Cut-Off phase** while charging, **cutoff_voltage ≥ cv_min** and **SoC ≥ 95 %** must hold for 10s. ![Image](../../images/YamBMS_LTO_Cut-Off_Values.png "LTO Cut-Off Value") diff --git a/documents/README/Release_note_YamBMS_1.7.1_Cut-Off_charging_logic.md b/documents/README/Release_note_YamBMS_1.7.1_Cut-Off_charging_logic.md new file mode 100644 index 0000000..da673b2 --- /dev/null +++ b/documents/README/Release_note_YamBMS_1.7.1_Cut-Off_charging_logic.md @@ -0,0 +1,98 @@ +# YamBMS - Release note about new YamBMS 1.7.1 Cut-Off charging logic + +[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0) +[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest) +![GitHub stars](https://img.shields.io/github/stars/Sleeper85/esphome-yambms) +![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms) +![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms) + +## Fix: false End-Of-Charge (EOC) detection on low PV production days + +### The problem + +The Cut-Off detection uses a current-compensated voltage criterion (`cell_v ≥ cv_min + R·I`). This criterion is physically sound in steady state: at low charge current a cell voltage above `cv_min` (3.37 V/cell on LFP, the resting voltage of a full cell) genuinely indicates a full battery, and a cell cannot get full while avoiding this threshold. Its weakness lies in **transient readings**: + +- **Post-burst cell relaxation.** On grey days, a short sun burst pushes cell voltages up, then a cloud passage drops the current to 1–2 A while polarization keeps the cell voltage elevated for 30–120 s. The 10 s validation plus the 60 s cut-off timer (~70 s total) fit inside that relaxation window — the transient voltage was treated as a resting voltage. +- **Runner cell.** On an imbalanced pack, a single high cell can satisfy the criterion while the pack SoC is only 85–92 %. + +The result was a false EOC: the battery was parked in Float/EOC (charging effectively stopped), the `rebulk_days` counter was wrongly reset, and recovery only occurred once SoC dropped back below the rebulk threshold — often losing the rest of the charging day. + +### What changed + +The compensated voltage criterion itself is **unchanged** — it needed guarding against transients, not replacing. + +**1. Minimum SoC gate** Cut-Off/EOC now additionally requires `SoC ≥ 95 %` (configurable). This blocks any false EOC at mid SoC, whether caused by a runner cell or by a transient voltage reading. + +**2. Longer cut-off timer** The default `yambms_cutoff_timer` is raised from 60 s to 180 s. The decision window now exceeds the post-burst relaxation time: a transient voltage falls back below the compensated threshold before the timer expires, and the timer is stopped when the Bulk conditions return. The value remains a substitution and can be tuned. + +**3. Current deadband around 0 A** Previously, `current >= 0` treated exactly 0 A and sensor noise as "charging". Currents with `I` below 0.005C (configurable, ≈1.4 A on a 280 Ah pack) are no longer fed into the compensated formula. Within the deadband, three outcomes: + +- `cell_v ≥ cv_min` and the SoC gate is satisfied → **Cut-Off conditions valid**. This is the "fully charged at rest" signature: a battery that becomes full at very low charge current (poor solar conditions) and stops accepting current still completes its charge cycle, without ever needing to reach the bulk voltage. +- `cell_v < cv_min` → **Bulk conditions valid**: the battery cannot be full, any running timers are stopped (same behavior as the original logic at ~0 A). +- Otherwise → **grey zone**: no conclusion is drawn, the charge status is left unchanged. + +**4. Discharge cell hysteresis voltage** The discharge branch now uses an explicit `cell_hysteresis_v` independent of the capacity (20 mV/cell by default, corresponding to the previous behavior of a 280 Ah pack). + +**5. Selectable Cut-Off Cell Voltage source** A new **"Cut-Off Cell Voltage"** select allows choosing which cell voltage feeds the whole Cut-Off logic (compensated criterion, "fully charged at rest" signature and discharge hysteresis): + +![RS485_bus](../../images/YamBMS_Charging_Settings_Cut-Off_Cell_Voltage.png) + +- **Max Cell Voltage** (default) — conservative, unchanged behavior: the EOC depends on the highest cell. It protects imbalanced packs, but the charge termination voltage varies with the imbalance of the day. +- **Average Cell Voltage** — the EOC reflects the state of the whole pack (`total_voltage / cell_count`), giving a **consistent charge termination voltage** from one day to the next. This is the recommended option for packs built from unmatched cells (different internal resistances), packs with a runner cell, and BMS that do not report their equalizing status — in that last case YamBMS cannot hold the Cut-Off open during balancing, and with `Max Cell Voltage` the runner would end the charge prematurely, depriving the balancer of its working window. In `Average Cell Voltage` mode the highest cell stays longer in the upper voltage region where the balancer is active. Note: the inconsistency only shows when the charge ends by current taper below the CVL (PV-limited days, or an inverter that does not respect the CVL); when the charger holds the pack at the CVL, the pack voltage at EOC equals the CVL regardless of the selected source. + +⚠️ In **Average Cell Voltage** mode, the runner cell no longer stops the charge: cell-level protection **must** be ensured by **Auto CVL and/or Auto CCL** (in order to avoid triggering an OVP alarm), with the BMS OVP as last resort. Note that if your inverter does not respect the CVL — the very situation where `Average Cell Voltage` mode is most useful — Auto CVL has no effect and **Auto CCL is the effective protection**. This setting only affects the Cut-Off logic — all other YamBMS mechanisms (Auto CVL, Auto CCL, rebulk) keep using the max cell voltage. + +### New substitutions + +| Substitution | Default | Purpose | +|---|---|---| +| `yambms_eoc_min_soc` | `95` | Minimum SoC (Max 98%) required to allow Cut-Off/EOC | +| `yambms_current_deadband_crate` | `0.005` | C-Rate below which the current is treated as noise / PV starvation | +| `yambms_cell_hysteresis_v` | `0.020` | Discharge hysteresis margin (V/cell) | + +Changed default: `yambms_cutoff_timer` 60 s → 180 s. + +### New entities + +| Entity | Type | Default | Purpose | +|---|---|---|---| +| `Cut-Off cell voltage` | select | `Max Cell Voltage` | Cell voltage source used by the Cut-Off logic (`Max Cell Voltage` / `Average Cell Voltage`) | + +### Expected behavior after the fix + +- Grey day, transient voltages after sun bursts → the SoC gate and the 180 s window reject them. No false EOC. +- Normal sunny end of charge → unchanged behavior: pack reaches CVL, current tapers, Cut-Off → EOC as before. +- Full charge at very low current (battery full without ever reaching the bulk voltage) → handled by the compensated criterion above the deadband, and by the "fully charged at rest" signature below it. The charge cycle always completes. +- Inconsistent charge termination voltage on imbalanced packs (e.g. 54.7 V one day, 55.2 V the next) → select **Average Cell Voltage** for a reproducible pack voltage at EOC, e.g. for a reliable SoC resync point. +- Extended balancing of an imbalanced pack → unchanged: the EOC timer switch can still be disabled to hold the battery in charge while the BMS is equalizing. + +### Note for advanced users + +#### Variables that can be modified + +```YAML + - path: 'packages/yambms/yambms.yaml' + vars: + yambms_cutoff_crate: '0.05' # (C-Rate) matches the standard charge termination of most LFP, Li-ion and LTO datasheets and is the right value for the vast majority of installations. Check your cell datasheet before changing it. + yambms_eoc_min_soc: '95' # (%) minimum SoC (Max 98%) required to allow Cut-Off/EOC + yambms_current_deadband_crate: '0.005' # (C-Rate) `current` below this = grey zone (sensor noise / PV starvation) + yambms_cell_hysteresis_v: '0.020' # (V/cell) discharge hysteresis margin +``` + +#### The `cv_min` setting + +The `cv_min` anchor (3.37 V/cell on LFP) is a conservative lower bound of the fully-charged resting voltage documented in the literature (3.37–3.43 V band, OCV hysteresis included). It is intentionally **not** exposed as a setting: raising it would distort the physical meaning of the compensated criterion. Experienced users can still override the `yambms${yambms_id}_var_cell_min_charge_v` global from their own YAML using an `on_boot` block with a priority **below 600** (the YamBMS chemistry block runs at 600) — see the documentation example. + +```YAML +# Example : override the chemistry "fully charged at rest" voltage +# For experienced users only — this shifts the anchor of the whole +# Cut-Off compensated criterion. Values outside the documented +# 3.37-3.43V band (LFP) will distort the charge termination logic. +esphome: + on_boot: + - priority: 550 # MUST be < 600 : runs after the YamBMS chemistry block + then: + - lambda: |- + // Override cv_min (example : 3.40V instead of 3.37V) + id(yambms${yambms_id}_var_cell_min_charge_v) = 3.40; +``` diff --git a/documents/README/YamBMS_functions.md b/documents/README/YamBMS_functions.md index 27f33d3..275524d 100644 --- a/documents/README/YamBMS_functions.md +++ b/documents/README/YamBMS_functions.md @@ -52,6 +52,14 @@ The `Float voltage` slider allows you to set the voltage used after charging is The `Charger Offset V.` slider allows you to correct the inverter charge voltage, either because it does not respect the requested value or because your inverter is far from your batteries and there is a voltage drop. This allows you to reach the target `Bulk` or `Float` charge voltage by adding an offset. +The `Cut-Off Cell Voltage` select defines which cell voltage is used by the `Cut-Off` detection, see the [Charging logic](Charging_logic.md). + +- `Max Cell Voltage` (default): the end of charge depends on the **highest cell**. This is the conservative option, recommended for most installations. +- `Average Cell Voltage`: the end of charge reflects the state of the **whole pack** (`battery voltage / cell count`), giving a more consistent charge termination voltage from one day to the next. This option can help with batteries built from unmatched cells (different internal resistances), batteries with a runner cell, or a BMS that does not report its equalizing status. + +> [!WARNING] +> With `Average Cell Voltage`, the highest cell **no longer stops the charge** and can be pushed above its maximum voltage. Only use this option with the `Auto CVL` and/or `Auto CCL` enabled, the BMS OVP protection remaining the last resort. If your inverter does not respect the requested charge voltage, only the current derating is effective. + ### Max Requested Current ![Image](../../images/YamBMS_Max_Requested_Current.png "Max Requested Current") diff --git a/images/YamBMS_Charging_Settings_Cut-Off_Cell_Voltage.png b/images/YamBMS_Charging_Settings_Cut-Off_Cell_Voltage.png new file mode 100644 index 0000000000000000000000000000000000000000..c95a1f44fcfd5d0bca2188ba67557904a40b86d8 GIT binary patch literal 38344 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 A`2YX_ literal 0 HcmV?d00001 diff --git a/packages/yambms/yambms_core.yaml b/packages/yambms/yambms_core.yaml index 2377cb9..c5663a2 100644 --- a/packages/yambms/yambms_core.yaml +++ b/packages/yambms/yambms_core.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.07.11 +# Updated : 2026.07.15 # Version : 1.7.1 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -19,8 +19,14 @@ substitutions: yambms_version: "1.7.1" - custom_ccl_derating_reason: 'Custom CCL Derating' - custom_dcl_derating_reason: 'Custom DCL Derating' + # Cut-Off Charging Logic + yambms_cutoff_crate: '0.05' # (C-Rate) matches the standard charge termination of most LFP, Li-ion and LTO datasheets and is the right value for the vast majority of installations. Check your cell datasheet before changing it. + yambms_eoc_min_soc: '95' # (%) minimum SoC (Max 98%) required to allow Cut-Off/EOC + yambms_current_deadband_crate: '0.005' # (C-Rate) `current` below this = grey zone (sensor noise / PV starvation) + yambms_cell_hysteresis_v: '0.020' # (V/cell) discharge hysteresis margin + # Custom CCL/DCL Derating Reason + custom_ccl_derating_reason: 'Custom CCL Derating' + custom_dcl_derating_reason: 'Custom DCL Derating' globals: # BMS @@ -456,7 +462,7 @@ interval: soc = round(id(yambms${yambms_id}_var_total_battery_capacity_remaining) / id(yambms${yambms_id}_var_total_battery_capacity) * 100); // SOC manipulation - if (id(yambms${yambms_id}_var_to_combine_bms_counter) == 0) soc = 0; // no BMS combined => sending 0% + if (id(yambms${yambms_id}_var_to_combine_bms_counter) == 0) soc = 0; // no BMS combined => sending 0% else if ((soc > 98) && (id(yambms${yambms_id}_var_eoc) == false)) soc = 98; // Useful for some inverters stopping charging when SoC reaches 100% // MEAN Battery SOH @@ -810,7 +816,8 @@ interval: float cv_min = id(yambms${yambms_id}_var_cell_min_charge_v); float cv_max = id(yambms${yambms_id}_var_cell_max_charge_v); float current = id(yambms${yambms_id}_current).state; - float cutoff_resistance = ((cv_max - cv_min) / id(yambms${yambms_id}_battery_capacity).state / 0.05); + float cutoff_resistance = ((cv_max - cv_min) / id(yambms${yambms_id}_battery_capacity).state / ${yambms_cutoff_crate}); + float current_deadband = (id(yambms${yambms_id}_battery_capacity).state * ${yambms_current_deadband_crate}); uint32_t ms_now = millis(); static uint32_t ms_cutoff = ms_now; @@ -820,18 +827,69 @@ interval: // | Cut-Off Charging Logic | // +-----------------------------------------------+ - // Charging - if (current >= 0) - { - float cutoff_voltage = (max_cell_v - cutoff_resistance * current); + // Cut-Off Cell Voltage source : + // "Max Cell Voltage" (default) : conservative, the EOC depends on the highest cell. + // Protects imbalanced packs but the charge termination voltage varies + // with the imbalance of the day. + // "Average Cell Voltage" : the EOC reflects the state of the whole pack, giving a + // consistent charge termination voltage. The runner cell no longer stops + // the charge : cell protection MUST be ensured by Auto CVL and/or Auto CCL + // with BMS OVP as last resort. + // Note : if the inverter does not respect the CVL, only Auto CCL is effective. - if (cutoff_voltage >= cv_min) // The Cut-Off conditions are valid + float cutoff_cell_v = max_cell_v; + if (id(yambms${yambms_id}_select_cutoff_cell_voltage).current_option() == "Average Cell Voltage") + cutoff_cell_v = (id(yambms${yambms_id}_total_voltage).state / id(yambms${yambms_id}_cell_count).state); + + // Current deadband + // Current within sensor noise / PV starvation + if (fabs(current) < current_deadband) + { + // "Fully charged at rest" signature + // cv_min is by definition the resting voltage of a full cell. + // A near-zero current with cutoff_cell_v above cv_min indicates + // a full battery, the Cut-Off conditions are considered valid. + if ((cutoff_cell_v >= cv_min) && + (id(yambms${yambms_id}_battery_soc).state >= ${yambms_eoc_min_soc})) // Min. SoC gate + { ms_bulk = ms_now; // Reset millis to not enter the Bulk phase - else + } + + // cutoff_cell_v below cv_min at near-zero current. + // The battery cannot be full, the Bulk conditions are valid. + else if (cutoff_cell_v < cv_min) + { ms_cutoff = ms_now; // Reset millis to not enter the Cut-Off phase + } + // Grey zone : cutoff_cell_v >= cv_min but SoC below the gate + // No conclusion can be drawn + else + { + ms_bulk = ms_now; // Reset millis to not enter the Bulk phase + ms_cutoff = ms_now; // Reset millis to not enter the Cut-Off phase + } } + + // Charging + else if (current > 0) + { + float cutoff_voltage = (cutoff_cell_v - cutoff_resistance * current); + + if ((cutoff_voltage >= cv_min) && // Compensated voltage criterion + (id(yambms${yambms_id}_battery_soc).state >= ${yambms_eoc_min_soc})) // Min. SoC gate + { + // Cut-Off phase + ms_bulk = ms_now; // Reset millis to not enter the Bulk phase + } + else + { + // Bulk phase + ms_cutoff = ms_now; // Reset millis to not enter the Cut-Off phase + } + } + // Discharging - else if (max_cell_v < cell_bulk_v - cutoff_resistance) + else if (cutoff_cell_v < (cell_bulk_v - ${yambms_cell_hysteresis_v})) { ms_cutoff = ms_now; // Reset millis to not enter the Cut-Off phase } @@ -857,6 +915,7 @@ interval: // Bulk else id(yambms${yambms_id}_var_charge_status) = "Bulk"; } + // Cut-Off phase else if (ms_now - ms_cutoff >= 10000) // 10s { @@ -882,7 +941,8 @@ interval: id(yambms${yambms_id}_script_cutoff_timer).stop(); } // Not Equalizing => Start cut-off timer - // If the conditions continue to be respected the charging process will stop in 60s (default value) + // If the conditions continue to be respected the charging process will stop in 180s (default value) + // This duration must exceed the post-burst cell relaxation time (30-120s) to reject transient voltage readings else if (!id(yambms${yambms_id}_script_cutoff_timer).is_running()) id(yambms${yambms_id}_script_cutoff_timer).execute(); } @@ -1107,6 +1167,28 @@ script: +# +--------------------------------------+ +# | select | +# +--------------------------------------+ +select: + # Cut-Off cell voltage source + # "Max cell" (default) : conservative, the EOC depends on the highest cell. + # "Average cell" : consistent charge termination voltage. Recommended for packs + # with unmatched cells (different IRs), a runner cell, or a BMS that does not + # report its equalizing status. Requires Auto CVL and/or Auto CCL enabled + # (the runner cell no longer stops the charge). + - platform: template + name: "Cut-Off Cell Voltage" + id: yambms${yambms_id}_select_cutoff_cell_voltage + device_id: yambms_yambms${yambms_id} + options: + - "Max Cell Voltage" + - "Average Cell Voltage" + initial_option: "Max Cell Voltage" + restore_value: true + optimistic: true + icon: mdi:vector-difference + entity_category: config # +--------------------------------------+ # | switch |