From 78aff4670261a80c98caefc73a3e0c0f441f992a Mon Sep 17 00:00:00 2001 From: Sebastian Date: Wed, 11 Mar 2026 23:17:22 +0100 Subject: [PATCH] Add support for Auto SoC Limit (#255) --- .../YamBMS_HA_Dashboard_DEMO.yaml | 15 +- .../YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml | 15 +- .../YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml | 15 +- ...MS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml | 15 +- .../YamBMS_HA_Dashboard_without_BMS.yaml | 15 +- documents/README/YamBMS_functions.md | 39 +++ images/YamBMS_Auto_SoC_Limit.png | Bin 0 -> 41241 bytes packages/yambms/yambms.yaml | 5 +- packages/yambms/yambms_auto_soc_limit.yaml | 233 ++++++++++++++++++ packages/yambms/yambms_core.yaml | 13 +- 10 files changed, 355 insertions(+), 10 deletions(-) create mode 100644 images/YamBMS_Auto_SoC_Limit.png create mode 100644 packages/yambms/yambms_auto_soc_limit.yaml diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml index 79f0b3c..e07fcea 100644 --- a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml +++ b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_DEMO.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.02.12 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -326,6 +326,19 @@ views: - entity: number.yambms_demo_yambms_1_auto_eoc_increase_stop_soc name: Stop SoC title: YamBMS - Auto EOC + - type: entities + entities: + - entity: switch.yambms_demo_yambms_1_automatic_soc_limit + name: Automatic SoC Limit + - entity: number.yambms_demo_yambms_1_auto_soc_limit + name: SoC Limit + - entity: number.yambms_demo_yambms_1_auto_soc_limit_hysteresis + name: SoC Limit Hysteresis + - entity: select.yambms_demo_yambms_1_auto_soc_limit_mode + name: Auto SoC Limit Mode + - entity: sensor.yambms_demo_yambms_1_auto_soc_limit_status + name: Auto SoC Limit Status + title: YamBMS - Auto SoC Limit - type: entities entities: - entity: number.yambms_demo_yambms_1_rebulk_soc diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_3xBMS.yaml index 9d51d9e..d6d55a6 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.02.11 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -288,6 +288,19 @@ views: - entity: number.yambms_yambms_1_auto_eoc_increase_stop_soc name: Stop SoC title: YamBMS - Auto EOC + - type: entities + entities: + - entity: switch.yambms_yambms_1_automatic_soc_limit + name: Automatic SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit + name: SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit_hysteresis + name: SoC Limit Hysteresis + - entity: select.yambms_yambms_1_auto_soc_limit_mode + name: Auto SoC Limit Mode + - entity: sensor.yambms_yambms_1_auto_soc_limit_status + name: Auto SoC Limit Status + title: YamBMS - Auto SoC Limit - type: entities entities: - entity: number.yambms_yambms_1_rebulk_soc diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_JK_RS485_7xBMS.yaml index 9033ce9..1a1860b 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.02.11 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -288,6 +288,19 @@ views: - entity: number.yambms_yambms_1_auto_eoc_increase_stop_soc name: Stop SoC title: YamBMS - Auto EOC + - type: entities + entities: + - entity: switch.yambms_yambms_1_automatic_soc_limit + name: Automatic SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit + name: SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit_hysteresis + name: SoC Limit Hysteresis + - entity: select.yambms_yambms_1_auto_soc_limit_mode + name: Auto SoC Limit Mode + - entity: sensor.yambms_yambms_1_auto_soc_limit_status + name: Auto SoC Limit Status + title: YamBMS - Auto SoC Limit - type: entities entities: - entity: number.yambms_yambms_1_rebulk_soc 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 9e325e1..ed8621b 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.02.11 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -288,6 +288,19 @@ views: - entity: number.yambms_yambms_1_auto_eoc_increase_stop_soc name: Stop SoC title: YamBMS - Auto EOC + - type: entities + entities: + - entity: switch.yambms_yambms_1_automatic_soc_limit + name: Automatic SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit + name: SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit_hysteresis + name: SoC Limit Hysteresis + - entity: select.yambms_yambms_1_auto_soc_limit_mode + name: Auto SoC Limit Mode + - entity: sensor.yambms_yambms_1_auto_soc_limit_status + name: Auto SoC Limit Status + title: YamBMS - Auto SoC Limit - type: entities entities: - entity: number.yambms_yambms_1_rebulk_soc diff --git a/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml b/HomeAssistant_Dashboards/YamBMS_HA_Dashboard_without_BMS.yaml index a776a39..2e108b7 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.02.11 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -288,6 +288,19 @@ views: - entity: number.yambms_yambms_1_auto_eoc_increase_stop_soc name: Stop SoC title: YamBMS - Auto EOC + - type: entities + entities: + - entity: switch.yambms_yambms_1_automatic_soc_limit + name: Automatic SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit + name: SoC Limit + - entity: number.yambms_yambms_1_auto_soc_limit_hysteresis + name: SoC Limit Hysteresis + - entity: select.yambms_yambms_1_auto_soc_limit_mode + name: Auto SoC Limit Mode + - entity: sensor.yambms_yambms_1_auto_soc_limit_status + name: Auto SoC Limit Status + title: YamBMS - Auto SoC Limit - type: entities entities: - entity: number.yambms_yambms_1_rebulk_soc diff --git a/documents/README/YamBMS_functions.md b/documents/README/YamBMS_functions.md index f86f3cb..eb05df1 100644 --- a/documents/README/YamBMS_functions.md +++ b/documents/README/YamBMS_functions.md @@ -195,6 +195,45 @@ At about 18:08 the battery is 100% after a short balancing period. ![Image](../../images/YamBMS_Auto_EOC_Graph.png "YamBMS Auto EOC Graph") +## Auto SoC Limit + +![Image](../../images/YamBMS_Auto_SoC_Limit.png "YamBMS Auto SoC Limit") + +When to use: You want to charge your battery up to a specific SoC value. + +This function allows to set a target SoC when charging. Upon reaching this limit, it can either switch to `Float`, limit the `Requested Charge Current (CCL)` or both. + +There are some configuration options to adjust the behaviour: + +- `Automatic SoC Limit`: This switch enables or disables the function. +- `Auto SoC Limit`: The SoC limit value. +- `Auto SoC Limit Mode`: The mode to use when the limit is reached. +- `Auto SoC Hysteresis`: Configurable hysteresis value when to stop limiting `Requested Charge Current (CCL)`. +- `Auto SoC Limit CCL`: The value that will be used for `Requested Charge Current (CCL)` when the limit is reached and `Auto SoC Limit` is set to `CCL` or `Float + CCL`. + +The text sensor `Auto SoC Limit Status` will show the current status of the function: +- `Stop: Disabled`: Function is disabled. +- `Stop: SoC limit reached`: The configured SoC limit was reached. +- `Run`: Function enabled, SoC limit not reached. + +Modes: +- `Float`: Will set the charging mode from `Bulk` to `Float`. If already at `Float`, nothing will happen. +- `CCL`: Limits the `Requested Charge Current (CCL)` to the value set by `Auto SoC Limit CCL`. The limit will be removed once the `SoC` is below `Auto SoC Limit` - `Auto SoC Hysteresis`. +- `Float + CCL`: Will use both previously described methods. However while the `Requested Charge Current (CCL)` will be removed, the charging mode will not be reset to `Bulk`. For this, `Rebulk SoC` is available. + +Note: Some inverters may not like `0A` for `Requested Charge Current (CCL)`. `Auto SoC Limit CCL` allows to set a small value to effectively limit the charging process. + +Example: +- `Auto SoC Limit` is set to `80%` +- `Auto SoC Limit Mode` is set to `CCL` +- `Auto SoC Hysteresis` is set to `5%` + +The current `SoC` is `70%`. When it reaches `80%` during charging, `Requested Charge Current (CCL)` is set to `Auto SoC Limit CCL`. +Afterwards the battery is then discharged, however `Requested Charge Current (CCL)` will stay at `Auto SoC Limit CCL` until `SoC` reaches +`Auto SoC Limit` - `Auto SoC Hysteresis` = `80%` - `5%` = `75%`. Without this, the `SoC` would oscillate between +`79%` and `80%`, stressing components unnecessary. + + ## Inverter Heartbeat Monitoring ![Image](../../images/YamBMS_Inverter_Heartbeat.png "YamBMS_Inverter_Heartbeat") diff --git a/images/YamBMS_Auto_SoC_Limit.png b/images/YamBMS_Auto_SoC_Limit.png new file mode 100644 index 0000000000000000000000000000000000000000..ebe6cc0255ed3a21cd26d4769e8c52c0d4c151fc GIT binary patch literal 41241 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 literal 0 HcmV?d00001 diff --git a/packages/yambms/yambms.yaml b/packages/yambms/yambms.yaml index 0b032d5..b0cd7fa 100644 --- a/packages/yambms/yambms.yaml +++ b/packages/yambms/yambms.yaml @@ -1,5 +1,5 @@ -# Updated : 2026.01.30 -# Version : 1.1.3 +# Updated : 2026.03.11 +# Version : 1.1.4 # GitHub : https://github.com/Sleeper85/esphome-yambms # YamBMS ( Yet another multi-BMS Merging Solution ) @@ -27,5 +27,6 @@ packages: yambms_auto_float: !include yambms_auto_float.yaml yambms_auto_eoc: !include yambms_auto_eoc.yaml yambms_auto_temp-based_current: !include yambms_auto_temp_ccl_dcl.yaml + yambms_auto_soc: !include yambms_auto_soc_limit.yaml # Update service yambms_service: !include yambms_service.yaml diff --git a/packages/yambms/yambms_auto_soc_limit.yaml b/packages/yambms/yambms_auto_soc_limit.yaml new file mode 100644 index 0000000..26454eb --- /dev/null +++ b/packages/yambms/yambms_auto_soc_limit.yaml @@ -0,0 +1,233 @@ +# Updated : 2026.03.11 +# 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 . + +esphome: + on_boot: + - priority: -100.0 + then: + - lambda: |- + id(${yambms_id}_var_auto_ccl_functions_count)++; + +globals: + # Last SoC value + - id: ${yambms_id}_var_auto_soc_last_value + type: int + restore_value: no + initial_value: '0' + - id: ${yambms_id}_var_auto_soc_target_reached + type: bool + restore_value: no + initial_value: 'false' + +switch: + - platform: template + name: ${name} ${yambms_name} Automatic SoC Limit + id: ${yambms_id}_switch_auto_soc_limit + restore_mode: RESTORE_DEFAULT_OFF + optimistic: true + entity_category: config + +number: + - platform: template + name: "${name} ${yambms_name} Auto SoC Limit" + id: "${yambms_id}_auto_soc_limit" + step: 5 + min_value: 40 + max_value: 95 + restore_value: true + mode: "${yambms_input_number_mode}" + initial_value: 80 + unit_of_measurement: '%' + icon: mdi:battery-charging-80 + optimistic: true + entity_category: config + on_value: + then: + - lambda: |- + // Reset last SoC value and target reached flag + id(${yambms_id}_var_auto_soc_last_value) = 0; + id(${yambms_id}_var_auto_soc_target_reached) = false; + - platform: template + name: "${name} ${yambms_name} Auto SoC Limit Hysteresis" + id: "${yambms_id}_auto_soc_hysteresis" + step: 5 + min_value: 5 + max_value: 40 + restore_value: true + mode: "${yambms_input_number_mode}" + initial_value: 5 + unit_of_measurement: '%' + icon: mdi:battery-minus + optimistic: true + entity_category: config + on_value: + then: + - lambda: |- + // Reset last SoC value and target reached flag + id(${yambms_id}_var_auto_soc_last_value) = 0; + id(${yambms_id}_var_auto_soc_target_reached) = false; + - platform: template + name: "${name} ${yambms_name} Auto SoC Limit CCL" + id: "${yambms_id}_auto_soc_ccl" + step: 1 + min_value: 0 + max_value: 10 + restore_value: true + mode: "${yambms_input_number_mode}" + initial_value: 1 + unit_of_measurement: 'A' + icon: mdi:current-dc + optimistic: true + entity_category: config + on_value: + then: + - lambda: |- + // Reset last SoC value and target reached flag + id(${yambms_id}_var_auto_soc_last_value) = 0; + id(${yambms_id}_var_auto_soc_target_reached) = false; + +select: + - platform: template + name: "${name} ${yambms_name} Auto SoC Limit Mode" + id: ${yambms_id}_auto_soc_limit_mode + options: + - "Float" + - "CCL" + - "Float + CCL" + restore_value: true + initial_option: "Float" + optimistic: true + entity_category: config + set_action: + then: + - lambda: |- + // Reset last SoC value and target reached flag + id(${yambms_id}_var_auto_soc_last_value) = 0; + id(${yambms_id}_var_auto_soc_target_reached) = false; + +text_sensor: + # +--------------------------------------+ + # | Auto SoC Status | + # +--------------------------------------+ + - platform: template + name: "${name} ${yambms_name} Auto SoC Limit Status" + id: ${yambms_id}_auto_soc_limit_status + update_interval: never + icon: mdi:information-outline + entity_category: diagnostic + +interval: + - interval: ${yambms_update_interval} + then: + # +------------------------------------------+ + # | Auto SoC Charge Current Limit | + # +------------------------------------------+ + - lambda: |- + // Check if we are in the correct step + int cc_step = id(${yambms_id}_var_charge_current_step); + if ((cc_step < 1) || (cc_step >= (id(${yambms_id}_var_auto_ccl_functions_count) + 1))) { + return; + } + + ESP_LOGD("yambms_debug", "Entering Auto SoC Limit..."); + + // Check if enabled + if (!id(${yambms_id}_switch_auto_soc_limit).state || + !id(${yambms_id}_battery_soc).has_state() || + !id(${yambms_id}_max_charge_current).has_state()) { + // Auto SoC Charging disabled + id(${yambms_id}_var_auto_soc_limit) = 0; + id(${yambms_id}_auto_soc_limit_status).publish_state("Stop: Disabled"); + id(${yambms_id}_var_auto_soc_last_value) = 0; + id(${yambms_id}_var_auto_soc_target_reached) = false; + id(${yambms_id}_var_charge_current_step)++; + return; + } + + // Update in 60s intervals only + static uint32_t last_execution_ms = 0; + uint32_t current_ms = millis(); + + if ((current_ms - last_execution_ms) < 60000) { + id(${yambms_id}_var_charge_current_step)++; + return; + } + + last_execution_ms = current_ms; + + // Check if SoC has changed since last execution, if not, skip calculations + int soc = id(${yambms_id}_battery_soc).state; + + if (soc == id(${yambms_id}_var_auto_soc_last_value)) { + id(${yambms_id}_var_charge_current_step)++; + return; + } + + id(${yambms_id}_var_auto_soc_last_value) = soc; + + // Check if target SoC was already reached + int target_soc = id(${yambms_id}_auto_soc_limit).state; + + if (id(${yambms_id}_var_auto_soc_target_reached)) { + // If target was reached but SoC has dropped below target - hysteresis, allow increasing charge current again + float soc_hysteresis = target_soc - id(${yambms_id}_auto_soc_hysteresis).state; + if (soc <= soc_hysteresis) { + ESP_LOGD("yambms_debug", "Auto SoC Limit: Activating again, SoC dropped below target - hysteresis"); + id(${yambms_id}_var_auto_soc_target_reached) = false; + id(${yambms_id}_var_auto_soc_limit) = 0; + id(${yambms_id}_auto_soc_limit_status).publish_state("Run"); + } + + id(${yambms_id}_var_charge_current_step)++; + return; + } + + // Check if target SoC is reached or exceeded + if (soc >= target_soc) { + id(${yambms_id}_var_auto_soc_target_reached) = true; + id(${yambms_id}_auto_soc_limit_status).publish_state("Stop: SoC limit reached"); + ESP_LOGD("yambms_debug", "Auto SoC Limit: Target SoC reached"); + + // Get mode + const auto mode = id(${yambms_id}_auto_soc_limit_mode).active_index(); + + if (mode == 0) { + // Float mode + ESP_LOGD("yambms_debug", "Auto SoC Limit: Applying Float mode"); + id(${yambms_id}_var_charge_status) = "Float"; + id(${yambms_id}_var_auto_soc_limit) = 0; + } else if (mode == 1) { + // CCL mode + ESP_LOGD("yambms_debug", "Auto SoC Limit: Applying CCL mode"); + id(${yambms_id}_var_auto_soc_limit) = -(id(${yambms_id}_max_charge_current).state - id(${yambms_id}_auto_soc_ccl).state); + } else if (mode == 2) { + // Float + CCL mode + ESP_LOGD("yambms_debug", "Auto SoC Limit: Applying Float + CCL mode"); + id(${yambms_id}_var_charge_status) = "Float"; + id(${yambms_id}_var_auto_soc_limit) = -(id(${yambms_id}_max_charge_current).state - id(${yambms_id}_auto_soc_ccl).state); + } else { + // Default case (should not happen) + ESP_LOGD("yambms_debug", "Auto SoC Limit: Unknown mode"); + } + } else { + id(${yambms_id}_auto_soc_limit_status).publish_state("Run"); + id(${yambms_id}_var_auto_soc_limit) = 0; + } + + id(${yambms_id}_var_charge_current_step)++; diff --git a/packages/yambms/yambms_core.yaml b/packages/yambms/yambms_core.yaml index 19056c6..936eebb 100644 --- a/packages/yambms/yambms_core.yaml +++ b/packages/yambms/yambms_core.yaml @@ -1,4 +1,4 @@ -# Updated : 2026.03.10 +# Updated : 2026.03.11 # Version : 1.7.0 # GitHub : https://github.com/Sleeper85/esphome-yambms @@ -290,6 +290,10 @@ globals: type: float restore_value: no initial_value: '0.0' + - id: ${yambms_id}_var_auto_soc_limit + type: float + restore_value: no + initial_value: '0.0' - id: ${yambms_id}_var_eoc type: bool restore_value: no @@ -915,7 +919,8 @@ interval: id(${yambms_id}_var_auto_ccl), id(${yambms_id}_var_auto_eoc), id(${yambms_id}_var_auto_temperature_ccl), - id(${yambms_id}_var_auto_ccl_soft_landing) + id(${yambms_id}_var_auto_ccl_soft_landing), + id(${yambms_id}_var_auto_soc_limit), }); requested_charge_current = round(id(${yambms_id}_max_charge_current).state + auto_limit); @@ -1961,14 +1966,16 @@ text_sensor: float limit_2 = id(${yambms_id}_var_auto_eoc); float limit_3 = id(${yambms_id}_var_auto_ccl); float limit_4 = id(${yambms_id}_var_auto_ccl_soft_landing); + float limit_5 = id(${yambms_id}_var_auto_soc_limit); - float min_val = std::min({limit_1, limit_2, limit_3, limit_4}); + float min_val = std::min({limit_1, limit_2, limit_3, limit_4, limit_5}); if (min_val == 0.0f) return {"No Derating"}; if (min_val == limit_1) return {"Temperature Derating"}; if (min_val == limit_2) return {"EOC Derating"}; if (min_val == limit_3) return {"AutoCCL Derating"}; if (min_val == limit_4) return {"Soft Landing Derating"}; + if (min_val == limit_5) return {"SoC Limit Derating"}; return {"Unknown"}; # +----------------------------------------+