diff --git a/LP_BMS_example_JBD_UART_BLE.yaml b/LP_BMS_example_JBD_UART_BLE.yaml new file mode 100644 index 0000000..6894f25 --- /dev/null +++ b/LP_BMS_example_JBD_UART_BLE.yaml @@ -0,0 +1,63 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +packages: + + bms1: !include + file: packages/bms/bms_combine_JBD_UART_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'BMS 1' + bms_uart_id: 'uart_esp_1' + bms_rx_timeout: '150ms' + # Required settings cannot be retrieved from BMS + # These values ​​must match your BMS settings + # LFP values example + bms_max_charge_current: '100' # A. Used to calculate maximum charge current + bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current + bms_cell_ovp: '3.650' # V. Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V. Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V. Used by 'Auto CVL' functions + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms2: !include + file: packages/bms/bms_combine_JBD_BLE_full.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'BMS 2' + bms_ble_mac_address: 'C8:47:8C:10:7E:AA' # Your MAC address + # Required settings cannot be retrieved from BMS + # These values ​​must match your BMS settings + # LFP values example + bms_max_charge_current: '100' # A. Used to calculate maximum charge current + bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current + bms_cell_ovp: '3.650' # V. Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V. Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V. Used by 'Auto CVL' functions + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' diff --git a/LP_BMS_example_JK_BLE.yaml b/LP_BMS_example_JK_BLE.yaml new file mode 100644 index 0000000..2054469 --- /dev/null +++ b/LP_BMS_example_JK_BLE.yaml @@ -0,0 +1,48 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +packages: + + bms1: !include + file: packages/bms/bms_combine_JK_BLE_standard.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_ble_protocol_version: 'JK02_32S' # JK02_24S < hardware version 11.0 >= JK02_32S + bms_ble_mac_address: 'C8:47:8C:10:7E:AA' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms2: !include + file: packages/bms/bms_combine_JK_BLE_standard.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_ble_protocol_version: 'JK02_32S' # JK02_24S < hardware version 11.0 >= JK02_32S + bms_ble_mac_address: 'C8:47:8C:EE:16:EA' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' diff --git a/LP_BMS_example_JK_RS485_Modbus_mode2.yaml b/LP_BMS_example_JK_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..a7e7ef0 --- /dev/null +++ b/LP_BMS_example_JK_RS485_Modbus_mode2.yaml @@ -0,0 +1,125 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +packages: + + # The sniffer represents the ESP node connected to the JK-BMS PB RS485 bus + # If address 0x00 is not detected on the RS485 bus, the sniffer will act directly as a master BMS (mode 2, max 15 BMS) + + # sniffer1: !include + # file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer_talk_pin.yaml + # vars: + # sniffer_id: 'sniffer1' + # sniffer_protocol: 'JK02_32S' + # sniffer_uart_id: 'uart_esp_1' + # sniffer_talk_pin: 8 # ESP32: 4, ESP32-S3: 8, ESP32-C3: 10 + + sniffer1: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer.yaml + vars: + sniffer_id: 'sniffer1' + sniffer_protocol: 'JK02_32S' + sniffer_uart_id: 'uart_esp_1' + + # Mode2 : configure the DIP switches of your BMS from 0x01 to 0x0F (don't use the 0x00 address, maximum 15 BMS) + bms1: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_address: '0x01' # BMS 1 DIP switch + + bms2: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_address: '0x02' # BMS 2 DIP switch + + bms3: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '3' # must be a number + bms_name: 'JK-BMS 3' + bms_address: '0x03' # BMS 3 DIP switch + + bms4: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '4' # must be a number + bms_name: 'JK-BMS 4' + bms_address: '0x04' # BMS 4 DIP switch + + bms5: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '5' # must be a number + bms_name: 'JK-BMS 5' + bms_address: '0x05' # BMS 5 DIP switch + + bms6: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '6' # must be a number + bms_name: 'JK-BMS 6' + bms_address: '0x06' # BMS 6 DIP switch + + bms7: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '7' # must be a number + bms_name: 'JK-BMS 7' + bms_address: '0x07' # BMS 7 DIP switch + + bms8: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '8' # must be a number + bms_name: 'JK-BMS 8' + bms_address: '0x08' # BMS 8 DIP switch diff --git a/LP_BMS_example_JK_UART_4G-GPS.yaml b/LP_BMS_example_JK_UART_4G-GPS.yaml new file mode 100644 index 0000000..e2635c8 --- /dev/null +++ b/LP_BMS_example_JK_UART_4G-GPS.yaml @@ -0,0 +1,46 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +packages: + + bms1: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_uart_id: 'uart_esp_1' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms2: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_uart_id: 'uart_esp_2' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' diff --git a/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml b/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml new file mode 100644 index 0000000..c4e8179 --- /dev/null +++ b/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml @@ -0,0 +1,73 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +packages: + + seplos_modbus1: !include + file: packages/bms/bms_combine_SEPLOS_V1_V2_RS485_modbus.yaml + vars: + seplos_modbus_id: 'seplos_modbus1' + seplos_modbus_uart_id: 'uart_esp_1' + seplos_modbus_baud_rate: '9600' # 9600 / 19200 ; please set the baudrate of your Seplos BMS model here + seplos_modbus_rx_timeout: '150ms' + + bms1: !include + file: packages/bms/bms_combine_SEPLOS_V1_V2_RS485_bms_full.yaml + vars: + # Seplos modbus ID + seplos_modbus_id: 'seplos_modbus1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'BMS 1' + bms_address: '0x01' # BMS 1 DIP switch + bms_protocol_version: '0x20' # Known protocol versions: 0x20 (Seplos), 0x26 (Boqiang) + # Required settings cannot be retrieved from BMS + # These values ​​must match your BMS settings + # LFP values example + bms_max_charge_current: '100' # A. Used to calculate maximum charge current + bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current + bms_cell_ovp: '3.650' # V. Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V. Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V. Used by 'Auto CVL' functions + + bms2: !include + file: packages/bms/bms_combine_SEPLOS_V1_V2_RS485_bms_full.yaml + vars: + # Seplos modbus ID + seplos_modbus_id: 'seplos_modbus1' + # BMS vars + bms_id: '2' # must be a number + bms_name: 'BMS 2' + bms_address: '0x02' # BMS 2 DIP switch + bms_protocol_version: '0x20' # Known protocol versions: 0x20 (Seplos), 0x26 (Boqiang) + bms_uart_id: uart_esp_2 + # Required settings cannot be retrieved from BMS + # These values ​​must match your BMS settings + # LFP values example + bms_max_charge_current: '100' # A. Used to calculate maximum charge current + bms_max_discharge_current: '100' # A. Used to calculate maximum discharge current + bms_cell_ovp: '3.650' # V. Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V. Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V. Used by 'Auto CVL' functions diff --git a/LP_example_multi-node_YamBMS_modbus_client.yaml b/LP_example_multi-node_YamBMS_modbus_client.yaml new file mode 100644 index 0000000..41e22ff --- /dev/null +++ b/LP_example_multi-node_YamBMS_modbus_client.yaml @@ -0,0 +1,104 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 11520 + modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device + modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending + +packages: + + modbus: !include + file: packages/base/device_modbus.yaml + vars: + modbus_role: 'client' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + + shunt1: !include + file: packages/shunt/shunt_combine_modbus_client.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + + bms1: !include + file: packages/bms/bms_combine_modbus_client.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'BMS 1' + + bms2: !include + file: packages/bms/bms_combine_modbus_client.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'BMS 2' + + bms3: !include + file: packages/bms/bms_combine_modbus_client.yaml + vars: + bms_id: '3' # must be a number + bms_name: 'BMS 3' + + # bms4: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '4' # must be a number + # bms_name: 'BMS 4' + + # bms5: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '5' # must be a number + # bms_name: 'BMS 5' + + # bms6: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '6' # must be a number + # bms_name: 'BMS 6' + + # bms7: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '7' # must be a number + # bms_name: 'BMS 7' + + # bms8: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '8' # must be a number + # bms_name: 'BMS 8' + + # bms9: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '9' # must be a number + # bms_name: 'BMS 9' + + # bms10: !include + # file: packages/bms/bms_combine_modbus_client.yaml + # vars: + # bms_id: '10' # must be a number + # bms_name: 'BMS 10' diff --git a/LP_example_multi-node_YamBMS_modbus_server_1.yaml b/LP_example_multi-node_YamBMS_modbus_server_1.yaml new file mode 100644 index 0000000..a3256af --- /dev/null +++ b/LP_example_multi-node_YamBMS_modbus_server_1.yaml @@ -0,0 +1,55 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 11520 + modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device + modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending + +packages: + + modbus: !include + file: packages/base/device_modbus.yaml + vars: + modbus_role: 'server' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + + shunt1: !include + file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_uart_id: 'uart_esp_2' + + bms1: !include + file: packages/bms/bms_modbus_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_uart_id: 'uart_esp_3' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' \ No newline at end of file diff --git a/LP_example_multi-node_YamBMS_modbus_server_2.yaml b/LP_example_multi-node_YamBMS_modbus_server_2.yaml new file mode 100644 index 0000000..57f350d --- /dev/null +++ b/LP_example_multi-node_YamBMS_modbus_server_2.yaml @@ -0,0 +1,60 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 11520 + modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device + modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending + +packages: + + modbus: !include + file: packages/base/device_modbus.yaml + vars: + modbus_role: 'server' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + + bms2: !include + file: packages/bms/bms_modbus_JK_BLE_standard.yaml + vars: + bms_id: '2' # must be a number, also represents the modbus server number ! + bms_name: 'JK-BMS 2' + bms_ble_protocol_version: JK02_32S # JK02_24S < hardware version 11.0 >= JK02_32S + bms_ble_mac_address: C8:47:8C:10:7E:AA + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms3: !include + file: packages/bms/bms_modbus_JK_BLE_standard.yaml + vars: + bms_id: '3' # must be a number, also represents the modbus server number ! + bms_name: 'JK-BMS 3' + bms_ble_protocol_version: JK02_32S # JK02_24S < hardware version 11.0 >= JK02_32S + bms_ble_mac_address: C8:47:8C:EE:16:EA + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' diff --git a/YamBMS_LP_DEMO.yaml b/YamBMS_LP_DEMO.yaml new file mode 100644 index 0000000..463a8c2 --- /dev/null +++ b/YamBMS_LP_DEMO.yaml @@ -0,0 +1,279 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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 Local Packages Version ######################### + +# You need to copy the `packages` folder into the same folder as this YAML in order to compile it. +# Don't forget to configure your WiFi credentials in the secrets.yaml + +################################################################################ + +# Don't forget to configure your WiFi credentials in the secrets.yaml +# +# If needed, configure a static IP here +# wifi: +# manual_ip: +# static_ip: 192.168.0.85 +# gateway: 192.168.0.1 +# subnet: 255.255.255.0 +# dns1: 8.8.8.8 +# dns2: 8.8.4.4 + +logger: + level: INFO # VERBOSE / DEBUG / INFO / WARN + +ota: + platform: esphome + +# Please use the native `api` component instead of the `mqtt` section. +# If you use Home Assistant, the native API is more lightweight. +# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem. +# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server. +api: + reboot_timeout: 0s + +# If you don't want to use ESPHome's native API you can use MQTT instead. +# In this case don't forget to remove the 'api:' section. +# mqtt: +# broker: !secret mqtt_host +# username: !secret mqtt_username +# password: !secret mqtt_password +# id: mqtt_client + +# Please note that enabling this component will take up a lot of memory and may decrease +# stability and be the cause of reboot depending on the capabilities of the board used. +# web_server: +# port: 80 +# log: false +# ota: false + +# +--------------------------------------+ +# | Global Settings | +# +--------------------------------------+ +substitutions: + # ESP32 name / hostname + name: yambms-demo + # +--------------------------------------+ + # | YamBMS Settings | + # +--------------------------------------+ + # Please read the cut-off charging logic README to understand how the YamBMS works + yambms_id: 'yambms1' + yambms_name: 'YamBMS 1' + yambms_update_interval: '1s' + # Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'. + yambms_input_number_mode: 'slider' + # Please check and fill in the options below correctly according to your battery chemistry and number of cells in series. + # These parameters are important and used for charging logic. + # Battery Chemistry + yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO + # Number of cells in series + yambms_cell_count: '16' + # Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery) + yambms_bulk_v: '55.2' + # Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery) + yambms_float_v: '53.6' + # Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery) + yambms_rebulk_v: '52.8' + # Maximum time in minutes that the cut-off step can last before charging is complete + # If your cells are properly balanced this step ends at the fastest after the `cut-off timer` + # This timer can be deactivated with a switch + yambms_eoc_timer: '30' + # Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing) + yambms_cutoff_timer: '60' + # +--------------------------------------+ + # | Shunt Settings | + # +--------------------------------------+ + shunt_update_interval: '3s' # frequency at which Shunt data is refreshed + shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS + # +--------------------------------------+ + # | BMS Settings | + # +--------------------------------------+ + bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems + bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS + bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing) + +# +--------------------------------------+ +# | Packages | +# +--------------------------------------+ + +# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md + +packages: + + ############### >>> UNCOMMENT YOUR BOARD <<< ############### + ############### >>> ONLY ONE BOARD ! <<< ############### + + # This list is incomplete, other board.yaml are available in the board folder + + device_board: !include packages/board/board_ESP32_Generic.yaml + # device_board: !include packages/board/board_ESP32_DevKit-V1.yaml + # device_board: !include packages/board/board_ESP32_LilyGo-T-CAN485.yaml + # device_board: !include packages/board/board_ESP32_EVB.yaml + # device_board: !include packages/board/board_ESP32_Atom-Lite.yaml + # device_board: !include packages/board/board_ESP32-C3_ETH01-EVO.yaml + # device_board: !include packages/board/board_ESP32-S3_DevKitC-1.yaml + # device_board: !include packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml + # device_board: !include packages/board/board_ESP32-S3_AtomS3-Lite.yaml + + # device_board: !include + # file: packages/board/board_ESP32-S3_AtomS3.yaml # board_ESP32-S3_AtomS3R.yaml + # vars: + # display_auto_next_page_interval: '5s' + + ########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ########### + + captive_portal: !include packages/board/board_options_captive_portal.yaml + + # uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml + # uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml + # uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml + + # ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit) + canbus_node_1: !include + file: packages/board/board_options_itf_canbus_esp32_can.yaml + vars: + canbus_node_id: 'canbus_inverter_1' + + # MCP2515 + # canbus_node_2: !include + # file: packages/board/board_options_itf_canbus_mcp2515.yaml + # vars: + # canbus_node_id: 'canbus_bms_1' + + ############################################################ + + shunt1: !include + file: packages/shunt/shunt_combine_FAKE.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + # Shunt sensors values + shunt_voltage: '53.41' # V + shunt_current: '37.5' # A + shunt_power: '2003' # W + shunt_soc: '86' # % + + bms1: !include + file: packages/bms/bms_combine_FAKE.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'BMS 1' + # BMS sensors values + bms_battery_capacity: '280' # Ah + bms_battery_capacity_remaining: '243' # Ah + bms_voltage: '53.45' # V + bms_current: '9.2' # A + bms_power: '492' # W + bms_soc: '87' # % + bms_soh: '99' # % + bms_min_cell_voltage: '3.339' # V + bms_min_voltage_cell: '2' # cell number 1~16 + bms_max_cell_voltage: '3.341' # V + bms_max_voltage_cell: '11' # cell number 1~16 + bms_temperature_sensor_1: '21.1' # °C + bms_temperature_sensor_2: '21.3' # °C + bms_temperature_sensor_3: '21.5' # °C + bms_temperature_sensor_4: '21.7' # °C + bms_max_charge_current: '100' # A + bms_max_discharge_current: '100' # A + bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions + bms_charging_cycles: '178' # charging cycles number Used to calculate the SoH + + bms2: !include + file: packages/bms/bms_combine_FAKE.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'BMS 2' + # BMS sensors values + bms_battery_capacity: '280' # Ah + bms_battery_capacity_remaining: '238' # Ah + bms_voltage: '53.41' # V + bms_current: '11.3' # A + bms_power: '604' # W + bms_soc: '85' # % + bms_soh: '89' # % + bms_min_cell_voltage: '3.337' # V + bms_min_voltage_cell: '14' # cell number 1~16 + bms_max_cell_voltage: '3.339' # V + bms_max_voltage_cell: '3' # cell number 1~16 + bms_temperature_sensor_1: '21.8' # °C + bms_temperature_sensor_2: '21.6' # °C + bms_temperature_sensor_3: '21.4' # °C + bms_temperature_sensor_4: '21.2' # °C + bms_max_charge_current: '100' # A + bms_max_discharge_current: '100' # A + bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions + bms_charging_cycles: '226' # charging cycles number Used to calculate the SoH + + bms3: !include + file: packages/bms/bms_combine_FAKE.yaml + vars: + bms_id: '3' # must be a number + bms_name: 'BMS 3' + # BMS sensors values + bms_battery_capacity: '280' # Ah + bms_battery_capacity_remaining: '232' # Ah + bms_voltage: '53.37' # V + bms_current: '15.7' # A + bms_power: '838' # W + bms_soc: '83' # % + bms_soh: '79' # % + bms_min_cell_voltage: '3.334' # V + bms_min_voltage_cell: '7' # cell number 1~16 + bms_max_cell_voltage: '3.336' # V + bms_max_voltage_cell: '9' # cell number 1~16 + bms_temperature_sensor_1: '21.9' # °C + bms_temperature_sensor_2: '22.0' # °C + bms_temperature_sensor_3: '22.1' # °C + bms_temperature_sensor_4: '22.2' # °C + bms_max_charge_current: '100' # A + bms_max_discharge_current: '100' # A + bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions + bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage + bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions + bms_charging_cycles: '194' # charging cycles number Used to calculate the SoH + + yambms: !include packages/yambms/yambms.yaml + + # yambms_custom: !include yambms_custom.yaml + + canbus1: !include + file: packages/yambms/yambms_canbus.yaml + vars: + canbus_id: 'canbus1' + canbus_name: 'CANBUS 1' + canbus_node_id: 'canbus_inverter_1' + canbus_light_id: 'esp_light' + # The CANBUS link will be considered down if no response from the inverter (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' + +# +--------------------------------------+ +# | DEBUG ( logger level must be DEBUG ) | +# +--------------------------------------+ + + device_debug: !include + file: packages/base/device_debug_ESP32.yaml + vars: + debug_name: 'Debug' + debug_update_interval: '5s' diff --git a/YamBMS_LP_JK-BMS_RS485_Modbus_mode2.yaml b/YamBMS_LP_JK-BMS_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..d0d77e5 --- /dev/null +++ b/YamBMS_LP_JK-BMS_RS485_Modbus_mode2.yaml @@ -0,0 +1,281 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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 Local Packages Version ######################### + +# You need to copy the `packages` folder into the same folder as this YAML in order to compile it. +# Don't forget to configure your WiFi credentials in the secrets.yaml + +################################################################################ + +# Don't forget to configure your WiFi credentials in the secrets.yaml +# +# If needed, configure a static IP here +# wifi: +# manual_ip: +# static_ip: 192.168.0.85 +# gateway: 192.168.0.1 +# subnet: 255.255.255.0 +# dns1: 8.8.8.8 +# dns2: 8.8.4.4 + +logger: + level: INFO # VERBOSE / DEBUG / INFO / WARN + +ota: + platform: esphome + +# Please use the native `api` component instead of the `mqtt` section. +# If you use Home Assistant, the native API is more lightweight. +# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem. +# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server. +api: + reboot_timeout: 0s + +# If you don't want to use ESPHome's native API you can use MQTT instead. +# In this case don't forget to remove the 'api:' section. +# mqtt: +# broker: !secret mqtt_host +# username: !secret mqtt_username +# password: !secret mqtt_password +# id: mqtt_client + +# Please note that enabling this component will take up a lot of memory and may decrease +# stability and be the cause of reboot depending on the capabilities of the board used. +# web_server: +# port: 80 +# log: false +# ota: false + +# +--------------------------------------+ +# | Global Settings | +# +--------------------------------------+ +substitutions: + # ESP32 name / hostname + name: yambms + # +--------------------------------------+ + # | YamBMS Settings | + # +--------------------------------------+ + # Please read the cut-off charging logic README to understand how the YamBMS works + yambms_id: 'yambms1' + yambms_name: 'YamBMS 1' + yambms_update_interval: '1s' + # Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'. + yambms_input_number_mode: 'slider' + # Please check and fill in the options below correctly according to your battery chemistry and number of cells in series. + # These parameters are important and used for charging logic. + # Battery Chemistry + yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO + # Number of cells in series + yambms_cell_count: '16' + # Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery) + yambms_bulk_v: '55.2' + # Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery) + yambms_float_v: '53.6' + # Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery) + yambms_rebulk_v: '52.8' + # Maximum time in minutes that the cut-off step can last before charging is complete + # If your cells are properly balanced this step ends at the fastest after the `cut-off timer` + # This timer can be deactivated with a switch + yambms_eoc_timer: '30' + # Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing) + yambms_cutoff_timer: '60' + # +--------------------------------------+ + # | Shunt Settings | + # +--------------------------------------+ + shunt_update_interval: '3s' # frequency at which Shunt data is refreshed + shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS + # +--------------------------------------+ + # | BMS Settings | + # +--------------------------------------+ + bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems + bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS + bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing) + +# +--------------------------------------+ +# | Packages | +# +--------------------------------------+ + +# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md + +packages: + + ############### >>> UNCOMMENT YOUR BOARD <<< ############### + ############### >>> ONLY ONE BOARD ! <<< ############### + + # This list is incomplete, other board.yaml are available in the board folder + + device_board: !include packages/board/board_ESP32_Generic.yaml + # device_board: !include packages/board/board_ESP32_DevKit-V1.yaml + # device_board: !include packages/board/board_ESP32_LilyGo-T-CAN485.yaml + # device_board: !include packages/board/board_ESP32_EVB.yaml + # device_board: !include packages/board/board_ESP32_Atom-Lite.yaml + # device_board: !include packages/board/board_ESP32-C3_ETH01-EVO.yaml + # device_board: !include packages/board/board_ESP32-S3_DevKitC-1.yaml + # device_board: !include packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml + # device_board: !include packages/board/board_ESP32-S3_AtomS3-Lite.yaml + + # device_board: !include + # file: packages/board/board_ESP32-S3_AtomS3.yaml # board_ESP32-S3_AtomS3R.yaml + # vars: + # display_auto_next_page_interval: '5s' + + ########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ########### + + uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml + uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml + uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml + + # ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit) + canbus_node_1: !include + file: packages/board/board_options_itf_canbus_esp32_can.yaml + vars: + canbus_node_id: 'canbus_inverter_1' + + # MCP2515 + # canbus_node_2: !include + # file: packages/board/board_options_itf_canbus_mcp2515.yaml + # vars: + # canbus_node_id: 'canbus_bms_1' + + ############################################################ + + # The sniffer represents the ESP node connected to the JK-BMS PB RS485 bus + # If address 0x00 is not detected on the RS485 bus, the sniffer will act directly as a master BMS (mode 2, max 15 BMS) + + # sniffer1: !include + # file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer_talk_pin.yaml + # vars: + # sniffer_id: 'sniffer1' + # sniffer_protocol: 'JK02_32S' + # sniffer_uart_id: 'uart_esp_1' + # sniffer_talk_pin: 8 # ESP32: 4, ESP32-S3: 8, ESP32-C3: 10 + + sniffer1: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer.yaml + vars: + sniffer_id: 'sniffer1' + sniffer_protocol: 'JK02_32S' + sniffer_uart_id: 'uart_esp_1' + + # Mode2 : configure the DIP switches of your BMS from 0x01 to 0x0F (don't use the 0x00 address, maximum 15 BMS) + bms1: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_address: '0x01' # BMS 1 DIP switch + + bms2: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_address: '0x02' # BMS 2 DIP switch + + bms3: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '3' # must be a number + bms_name: 'JK-BMS 3' + bms_address: '0x03' # BMS 3 DIP switch + + bms4: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '4' # must be a number + bms_name: 'JK-BMS 4' + bms_address: '0x04' # BMS 4 DIP switch + + bms5: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '5' # must be a number + bms_name: 'JK-BMS 5' + bms_address: '0x05' # BMS 5 DIP switch + + bms6: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '6' # must be a number + bms_name: 'JK-BMS 6' + bms_address: '0x06' # BMS 6 DIP switch + + bms7: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '7' # must be a number + bms_name: 'JK-BMS 7' + bms_address: '0x07' # BMS 7 DIP switch + + bms8: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '8' # must be a number + bms_name: 'JK-BMS 8' + bms_address: '0x08' # BMS 8 DIP switch + + yambms: !include packages/yambms/yambms.yaml + + # yambms_custom: !include yambms_custom.yaml + + canbus1: !include + file: packages/yambms/yambms_canbus.yaml + vars: + canbus_id: 'canbus1' + canbus_name: 'CANBUS 1' + canbus_node_id: 'canbus_inverter_1' + canbus_light_id: 'esp_light' + # The CANBUS link will be considered down if no response from the inverter (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' + +# +--------------------------------------+ +# | DEBUG ( logger level must be DEBUG ) | +# +--------------------------------------+ + + device_debug: !include + file: packages/base/device_debug_ESP32.yaml + vars: + debug_name: 'Debug' + debug_update_interval: '5s' diff --git a/YamBMS_LP_PVbrain2.yaml b/YamBMS_LP_PVbrain2.yaml new file mode 100644 index 0000000..d9c7c14 --- /dev/null +++ b/YamBMS_LP_PVbrain2.yaml @@ -0,0 +1,200 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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 Local Packages Version ######################### + +# You need to copy the `packages` folder into the same folder as this YAML in order to compile it. +# Don't forget to configure your WiFi credentials in the secrets.yaml + +################################################################################ + +# Don't forget to configure your WiFi credentials in the secrets.yaml +# +# If needed, configure a static IP here +# wifi: +# manual_ip: +# static_ip: 192.168.0.85 +# gateway: 192.168.0.1 +# subnet: 255.255.255.0 +# dns1: 8.8.8.8 +# dns2: 8.8.4.4 + +logger: + level: INFO # VERBOSE / DEBUG / INFO / WARN + +ota: + platform: esphome + +# Please use the native `api` component instead of the `mqtt` section. +# If you use Home Assistant, the native API is more lightweight. +# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem. +# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server. +api: + reboot_timeout: 0s + +# If you don't want to use ESPHome's native API you can use MQTT instead. +# In this case don't forget to remove the 'api:' section. +# mqtt: +# broker: !secret mqtt_host +# username: !secret mqtt_username +# password: !secret mqtt_password +# id: mqtt_client + +# Please note that enabling this component will take up a lot of memory and may decrease +# stability and be the cause of reboot depending on the capabilities of the board used. +# web_server: +# port: 80 +# log: false +# ota: false + +# +--------------------------------------+ +# | Global Settings | +# +--------------------------------------+ +substitutions: + # ESP32 name / hostname + name: pvbrain2 + # +--------------------------------------+ + # | YamBMS Settings | + # +--------------------------------------+ + # Please read the cut-off charging logic README to understand how the YamBMS works + yambms_id: 'yambms1' + yambms_name: 'YamBMS 1' + yambms_update_interval: '1s' + # Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'. + yambms_input_number_mode: 'slider' + # Please check and fill in the options below correctly according to your battery chemistry and number of cells in series. + # These parameters are important and used for charging logic. + # Battery Chemistry + yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO + # Number of cells in series + yambms_cell_count: '16' + # Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery) + yambms_bulk_v: '55.2' + # Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery) + yambms_float_v: '53.6' + # Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery) + yambms_rebulk_v: '52.8' + # Maximum time in minutes that the cut-off step can last before charging is complete + # If your cells are properly balanced this step ends at the fastest after the `cut-off timer` + # This timer can be deactivated with a switch + yambms_eoc_timer: '30' + # Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing) + yambms_cutoff_timer: '60' + # +--------------------------------------+ + # | Shunt Settings | + # +--------------------------------------+ + shunt_update_interval: '3s' # frequency at which Shunt data is refreshed + shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS + # +--------------------------------------+ + # | BMS Settings | + # +--------------------------------------+ + bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems + bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS + bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing) + # +--------------------------------------+ + # | WK2168 UART expander | + # +--------------------------------------+ + uart0_baudrate: '2400' #WKS {RJ45-UART0} + uart1_baudrate: '38400' #JSY193 + uart2_baudrate: '19200' #SmartShunt + uart3_baudrate: '9600' #SRNE {RJ45-UART3} + uart4_baudrate: '115200' #JK-BMS 1 + uart5_baudrate: '115200' #JK-BMS 2 + uart6_baudrate: '115200' #Pylontech + uart7_baudrate: '9600' #EPEVER {RJ45-UART7} + +# +--------------------------------------+ +# | PVbrain2 packages | +# +--------------------------------------+ +packages: + + device_board: !include packages/board/board_ESP32-S3_DevKitC-1_PVbrain2.yaml + + # BUS + # bus_i2c0: !include pvbrain2/base/device_bus_i2c0.yaml # SX1509 and BME280/BMP280 + bus_spi1: !include pvbrain2/base/device_bus_spi1.yaml # MCP2515 + # bus_one_wire: !include pvbrain2/base/device_bus_one_wire.yaml # Dallas + + # Devices + # device_uart_esp: !include pvbrain2/base/device_uart_esp.yaml + device_wk2168_spi: !include pvbrain2/base/device_wk2168_spi.yaml + # device_wk2168_i2c: !include pvbrain2/base/device_wk2168_i2c.yaml + # device_sx1509: !include pvbrain2/base/device_sx1509.yaml + device_canbus_node1: !include pvbrain2/base/device_canbus_esp32can.yaml # canbus_node1 + device_canbus_node2: !include pvbrain2/base/device_canbus_mcp2515.yaml # canbus_node2 + +# +--------------------------------------+ +# | YamBMS packages | +# +--------------------------------------+ + +# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md + + # You don't have to import a shunt but you must import at least one BMS. + + shunt1: !include + file: packages/shunt/shunt_combine_Victron_SmartShunt_UART_expander.yaml # shunt_combine_Junctek_KHF_UART.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_uart_id: 'uart_${uart_hub_bus}_2' + + bms1: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_uart_id: 'uart_${uart_hub_bus}_4' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms2: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_uart_id: 'uart_${uart_hub_bus}_5' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + yambms: !include packages/yambms/yambms.yaml + + # yambms_custom: !include yambms_custom.yaml + + canbus1: !include + file: packages/yambms/yambms_canbus.yaml + vars: + canbus_id: 'canbus1' + canbus_name: 'CANBUS 1' + canbus_node_id: 'canbus_node1' + canbus_light_id: 'esp_light' + # 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' + +# +--------------------------------------+ +# | DEBUG ( logger level must be DEBUG ) | +# +--------------------------------------+ + + device_debug: !include + file: packages/base/device_debug_ESP32.yaml + vars: + debug_name: 'Debug' + debug_update_interval: '5s' diff --git a/YamBMS_Local_Packages_example.yaml b/YamBMS_Local_Packages_example.yaml new file mode 100644 index 0000000..43a0860 --- /dev/null +++ b/YamBMS_Local_Packages_example.yaml @@ -0,0 +1,210 @@ +# Updated : 2025.04.01 +# Version : 1.5.5 +# 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 Local Packages Version ######################### + +# You need to copy the `packages` folder into the same folder as this YAML in order to compile it. +# Don't forget to configure your WiFi credentials in the secrets.yaml + +################################################################################ + +# Don't forget to configure your WiFi credentials in the secrets.yaml +# +# If needed, configure a static IP here +# wifi: +# manual_ip: +# static_ip: 192.168.0.85 +# gateway: 192.168.0.1 +# subnet: 255.255.255.0 +# dns1: 8.8.8.8 +# dns2: 8.8.4.4 + +logger: + level: INFO # VERBOSE / DEBUG / INFO / WARN + +ota: + platform: esphome + +# Please use the native `api` component instead of the `mqtt` section. +# If you use Home Assistant, the native API is more lightweight. +# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem. +# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server. +api: + reboot_timeout: 0s + +# If you don't want to use ESPHome's native API you can use MQTT instead. +# In this case don't forget to remove the 'api:' section. +# mqtt: +# broker: !secret mqtt_host +# username: !secret mqtt_username +# password: !secret mqtt_password +# id: mqtt_client + +# Please note that enabling this component will take up a lot of memory and may decrease +# stability and be the cause of reboot depending on the capabilities of the board used. +# web_server: +# port: 80 +# log: false +# ota: false + +# +--------------------------------------+ +# | Global Settings | +# +--------------------------------------+ +substitutions: + # ESP32 name / hostname + name: yambms + # +--------------------------------------+ + # | YamBMS Settings | + # +--------------------------------------+ + # Please read the cut-off charging logic README to understand how the YamBMS works + yambms_id: 'yambms1' + yambms_name: 'YamBMS 1' + yambms_update_interval: '1s' + # Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'. + yambms_input_number_mode: 'slider' + # Please check and fill in the options below correctly according to your battery chemistry and number of cells in series. + # These parameters are important and used for charging logic. + # Battery Chemistry + yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO + # Number of cells in series + yambms_cell_count: '16' + # Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery) + yambms_bulk_v: '55.2' + # Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery) + yambms_float_v: '53.6' + # Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery) + yambms_rebulk_v: '52.8' + # Maximum time in minutes that the cut-off step can last before charging is complete + # If your cells are properly balanced this step ends at the fastest after the `cut-off timer` + # This timer can be deactivated with a switch + yambms_eoc_timer: '30' + # Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing) + yambms_cutoff_timer: '60' + # +--------------------------------------+ + # | Shunt Settings | + # +--------------------------------------+ + shunt_update_interval: '3s' # frequency at which Shunt data is refreshed + shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS + # +--------------------------------------+ + # | BMS Settings | + # +--------------------------------------+ + bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems + bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS + bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing) + +# +--------------------------------------+ +# | Packages | +# +--------------------------------------+ + +# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md + +packages: + + ############### >>> UNCOMMENT YOUR BOARD <<< ############### + ############### >>> ONLY ONE BOARD ! <<< ############### + + # This list is incomplete, other board.yaml are available in the board folder + + device_board: !include packages/board/board_ESP32_Generic.yaml + # device_board: !include packages/board/board_ESP32_DevKit-V1.yaml + # device_board: !include packages/board/board_ESP32_LilyGo-T-CAN485.yaml + # device_board: !include packages/board/board_ESP32_EVB.yaml + # device_board: !include packages/board/board_ESP32_Atom-Lite.yaml + # device_board: !include packages/board/board_ESP32-C3_ETH01-EVO.yaml + # device_board: !include packages/board/board_ESP32-S3_DevKitC-1.yaml + # device_board: !include packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml + # device_board: !include packages/board/board_ESP32-S3_AtomS3-Lite.yaml + + # device_board: !include + # file: packages/board/board_ESP32-S3_AtomS3.yaml # board_ESP32-S3_AtomS3R.yaml + # vars: + # display_auto_next_page_interval: '5s' + + ########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ########### + + uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml + uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml + uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml + + # ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit) + canbus_node_1: !include + file: packages/board/board_options_itf_canbus_esp32_can.yaml + vars: + canbus_node_id: 'canbus_inverter_1' + + # MCP2515 + # canbus_node_2: !include + # file: packages/board/board_options_itf_canbus_mcp2515.yaml + # vars: + # canbus_node_id: 'canbus_bms_1' + + ############################################################ + + shunt1: !include + # file: packages/shunt/shunt_combine_Junctek_KHF_UART.yaml + file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_uart_id: 'uart_esp_3' + + bms1: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_uart_id: 'uart_esp_1' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + bms2: !include + file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_uart_id: 'uart_esp_2' + # Maximum cell charging cycles is used to calculate the battey SoH. + # MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required) + bms_cell_max_cycles: '6000.0' + + yambms: !include packages/yambms/yambms.yaml + + # yambms_custom: !include yambms_custom.yaml + + canbus1: !include + file: packages/yambms/yambms_canbus.yaml + vars: + canbus_id: 'canbus1' + canbus_name: 'CANBUS 1' + canbus_node_id: 'canbus_inverter_1' + canbus_light_id: 'esp_light' + # The CANBUS link will be considered down if no response from the inverter (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' + +# +--------------------------------------+ +# | DEBUG ( logger level must be DEBUG ) | +# +--------------------------------------+ + + device_debug: !include + file: packages/base/device_debug_ESP32.yaml + vars: + debug_name: 'Debug' + debug_update_interval: '5s'