diff --git a/examples/multi-node/LP_example_multi-node_YamBMS_modbus_client.yaml b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_client.yaml new file mode 100644 index 0000000..c9b5f05 --- /dev/null +++ b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_client.yaml @@ -0,0 +1,104 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# 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 / 115200 + 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/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_1.yaml b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_1.yaml new file mode 100644 index 0000000..917c64b --- /dev/null +++ b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_1.yaml @@ -0,0 +1,55 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# 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 / 115200 + 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/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_2.yaml b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_2.yaml new file mode 100644 index 0000000..442535f --- /dev/null +++ b/examples/multi-node/LP_example_multi-node_YamBMS_modbus_server_2.yaml @@ -0,0 +1,60 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# 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 / 115200 + 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/examples/multi-node/RP_example_multi-node_modbus_client.yaml b/examples/multi-node/RP_example_multi-node_modbus_client.yaml new file mode 100644 index 0000000..434e582 --- /dev/null +++ b/examples/multi-node/RP_example_multi-node_modbus_client.yaml @@ -0,0 +1,98 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 115200 + 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: + + yambms_modbus_client: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Modbus client + - path: 'packages/base/device_modbus.yaml' + vars: + modbus_role: 'client' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + # Shunt 1 + - path: 'packages/shunt/shunt_combine_modbus_client.yaml' + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + # BMS 1 + - path: 'packages/bms/bms_combine_modbus_client.yaml' + vars: + bms_id: '1' # must be a number + bms_name: 'BMS 1' + # BMS 2 + - path: 'packages/bms/bms_combine_modbus_client.yaml' + vars: + bms_id: '2' # must be a number + bms_name: 'BMS 2' + # BMS 3 + - path: 'packages/bms/bms_combine_modbus_client.yaml' + vars: + bms_id: '3' # must be a number + bms_name: 'BMS 3' + # # BMS 4 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '4' # must be a number + # bms_name: 'BMS 4' + # # BMS 5 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '5' # must be a number + # bms_name: 'BMS 5' + # # BMS 6 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '6' # must be a number + # bms_name: 'BMS 6' + # # BMS 7 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '7' # must be a number + # bms_name: 'BMS 7' + # # BMS 8 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '8' # must be a number + # bms_name: 'BMS 8' + # # BMS 9 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '9' # must be a number + # bms_name: 'BMS 9' + # # BMS 10 + # - path: 'packages/bms/bms_combine_modbus_client.yaml' + # vars: + # bms_id: '10' # must be a number + # bms_name: 'BMS 10' diff --git a/examples/multi-node/RP_example_multi-node_modbus_server_1.yaml b/examples/multi-node/RP_example_multi-node_modbus_server_1.yaml new file mode 100644 index 0000000..eb7a4c5 --- /dev/null +++ b/examples/multi-node/RP_example_multi-node_modbus_server_1.yaml @@ -0,0 +1,58 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 115200 + 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: + + yambms_modbus_server: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Modbus server + - path: 'packages/base/device_modbus.yaml' + vars: + modbus_role: 'server' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + # Shunt 1 + - path: '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' + # BMS 1 + - path: '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' diff --git a/examples/multi-node/RP_example_multi-node_modbus_server_2.yaml b/examples/multi-node/RP_example_multi-node_modbus_server_2.yaml new file mode 100644 index 0000000..23d2011 --- /dev/null +++ b/examples/multi-node/RP_example_multi-node_modbus_server_2.yaml @@ -0,0 +1,63 @@ +# Updated : 2025.06.10 +# Version : 1.5.6 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +substitutions: + modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried + modbus_baud_rate: '19200' # 9600 / 19200 / 115200 + 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: + + yambms_modbus_server: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Modbus server + - path: 'packages/base/device_modbus.yaml' + vars: + modbus_role: 'server' # client / server + modbus_uart_id: 'uart_esp_1' # RS485 board + # BMS 2 + - path: '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' + # BMS 3 + - path: '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/examples/single-node/LP_BMS_example_BASEN_RS485.yaml b/examples/single-node/LP_BMS_example_BASEN_RS485.yaml new file mode 100644 index 0000000..0d2571a --- /dev/null +++ b/examples/single-node/LP_BMS_example_BASEN_RS485.yaml @@ -0,0 +1,50 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + # Basen controller + controller: !include + file: packages/bms/bms_combine_BASEN_RS485_controller.yaml + vars: + basen_uart_id: 'uart_esp_1' + basen_uart_baud_rate: '9600' + basen_controller_id: "basen_controller_1" + + # Basen module 1 + bms1: !include + file: packages/bms/bms_combine_BASEN_RS485_full.yaml + vars: + bms_id: '1' # must be a number + bms_name: 'BASEN-BMS 1' + bms_address: '0x01' + + # Basen module 2 + bms2: !include + file: packages/bms/bms_combine_BASEN_RS485_full.yaml + vars: + bms_id: '2' # must be a number + bms_name: 'BASEN-BMS 2' + bms_address: '0x02' diff --git a/examples/single-node/LP_BMS_example_DEMO_Shunt_and_BMS.yaml b/examples/single-node/LP_BMS_example_DEMO_Shunt_and_BMS.yaml new file mode 100644 index 0000000..ba4f998 --- /dev/null +++ b/examples/single-node/LP_BMS_example_DEMO_Shunt_and_BMS.yaml @@ -0,0 +1,121 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + 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 diff --git a/examples/single-node/LP_BMS_example_DEYE-PCS_CAN.yaml b/examples/single-node/LP_BMS_example_DEYE-PCS_CAN.yaml new file mode 100644 index 0000000..b5a17a1 --- /dev/null +++ b/examples/single-node/LP_BMS_example_DEYE-PCS_CAN.yaml @@ -0,0 +1,59 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + # Deye BMS top unit (required) + bms_top: !include + file: packages/bms/bms_sensors_DEYE_CAN_top_full.yaml + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + deye_name: 'DEYE-Top 1' + deye_id: '1' + + # Deye module 1 + bms1: !include + file: packages/bms/bms_combine_DEYE_CAN_module_full.yaml + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'DEYE-BMS 1' + deye_id: '1' + deye_module_id: '0' # Modules are numbered with 0-9 + + # Deye module 2 + bms2: !include + file: packages/bms/bms_combine_DEYE_CAN_module_full.yaml + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + # BMS vars + deye_id: '1' + bms_id: '2' # must be a number + bms_name: 'DEYE-BMS 2' + deye_module_id: '1' # Modules are numbered with 0-9 diff --git a/examples/single-node/LP_BMS_example_JBD_UART_BLE.yaml b/examples/single-node/LP_BMS_example_JBD_UART_BLE.yaml new file mode 100644 index 0000000..dccd301 --- /dev/null +++ b/examples/single-node/LP_BMS_example_JBD_UART_BLE.yaml @@ -0,0 +1,63 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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/examples/single-node/LP_BMS_example_JK-B_RS485_Modbus_mode2.yaml b/examples/single-node/LP_BMS_example_JK-B_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..a65d15a --- /dev/null +++ b/examples/single-node/LP_BMS_example_JK-B_RS485_Modbus_mode2.yaml @@ -0,0 +1,125 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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_JK-B_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_JK-B_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_JK-B_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_JK-B_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_JK-B_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_JK-B_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_JK-B_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_JK-B_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/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode1.yaml b/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode1.yaml new file mode 100644 index 0000000..f2e0611 --- /dev/null +++ b/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode1.yaml @@ -0,0 +1,115 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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 1, max 16 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' + + # Mode1 : configure the DIP switches of your BMS from 0x00 to 0x0F (max 16 BMS) + bms1: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'JK-BMS 1' + bms_address: '0x00' # BMS 1 DIP switch + + bms2: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '2' # must be a number + bms_name: 'JK-BMS 2' + bms_address: '0x01' # BMS 2 DIP switch + + bms3: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '3' # must be a number + bms_name: 'JK-BMS 3' + bms_address: '0x02' # BMS 3 DIP switch + + bms4: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '4' # must be a number + bms_name: 'JK-BMS 4' + bms_address: '0x03' # BMS 4 DIP switch + + bms5: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '5' # must be a number + bms_name: 'JK-BMS 5' + bms_address: '0x04' # BMS 5 DIP switch + + bms6: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '6' # must be a number + bms_name: 'JK-BMS 6' + bms_address: '0x05' # BMS 6 DIP switch + + bms7: !include + file: packages/bms/bms_combine_JK_RS485_Modbus_bms_full.yaml + vars: + # Sniffer ID + sniffer_id: 'sniffer1' + # BMS vars + bms_id: '7' # must be a number + bms_name: 'JK-BMS 7' + bms_address: '0x06' # BMS 7 DIP switch diff --git a/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml b/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..d257d49 --- /dev/null +++ b/examples/single-node/LP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml @@ -0,0 +1,125 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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/examples/single-node/LP_BMS_example_JK_BLE.yaml b/examples/single-node/LP_BMS_example_JK_BLE.yaml new file mode 100644 index 0000000..2a40754 --- /dev/null +++ b/examples/single-node/LP_BMS_example_JK_BLE.yaml @@ -0,0 +1,48 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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/examples/single-node/LP_BMS_example_JK_UART_4G-GPS.yaml b/examples/single-node/LP_BMS_example_JK_UART_4G-GPS.yaml new file mode 100644 index 0000000..6e27fee --- /dev/null +++ b/examples/single-node/LP_BMS_example_JK_UART_4G-GPS.yaml @@ -0,0 +1,46 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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/examples/single-node/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml b/examples/single-node/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml new file mode 100644 index 0000000..466d908 --- /dev/null +++ b/examples/single-node/LP_BMS_example_SEPLOS_V1_V2_RS485.yaml @@ -0,0 +1,73 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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/examples/single-node/LP_BMS_example_SEPLOS_V3_RS485.yaml b/examples/single-node/LP_BMS_example_SEPLOS_V3_RS485.yaml new file mode 100644 index 0000000..c91ea66 --- /dev/null +++ b/examples/single-node/LP_BMS_example_SEPLOS_V3_RS485.yaml @@ -0,0 +1,50 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + seplos_modbus: !include + file: packages/bms/bms_combine_SEPLOS_V3_RS485_modbus.yaml + vars: + seplos_modbus_uart_id: 'uart_esp_1' + seplos_modbus_baud_rate: '19200' # 9600 / 19200 ; please set the baudrate of your Seplos BMS model here + + bms1: !include + file: packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml + vars: + bms_id: '1' # BMS id and modbus address + bms_name: 'BMS 1' + + bms2: !include + file: packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml + vars: + bms_id: '2' # BMS id and modbus address + bms_name: 'BMS 2' + + bms3: !include + file: packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml + vars: + bms_id: '3' # BMS id and modbus address + bms_name: 'BMS 3' diff --git a/examples/single-node/LP_Shunt_example.yaml b/examples/single-node/LP_Shunt_example.yaml new file mode 100644 index 0000000..50292e0 --- /dev/null +++ b/examples/single-node/LP_Shunt_example.yaml @@ -0,0 +1,46 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + + shunt1: !include + file: packages/shunt/shunt_combine_Junctek_KHF_UART.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_uart_id: 'uart_esp_1' + + shunt1: !include + 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_1' + + shunt1: !include + file: packages/shunt/shunt_combine_Victron_SmartShunt_BLE.yaml + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_mac_address: '60:A4:23:91:8F:55' # Your MAC address + shunt_encryption_key: '0df4d0395b7d1a876c0c33ecb9e70dcd' # Your encryption key diff --git a/examples/single-node/RP_BMS_example_BASEN_RS485.yaml b/examples/single-node/RP_BMS_example_BASEN_RS485.yaml new file mode 100644 index 0000000..f200e0a --- /dev/null +++ b/examples/single-node/RP_BMS_example_BASEN_RS485.yaml @@ -0,0 +1,50 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Basen controller + - path: 'packages/bms/bms_combine_BASEN_RS485_controller.yaml' + vars: + basen_uart_id: 'uart_esp_1' + basen_uart_baud_rate: '9600' + basen_controller_id: "basen_controller_1" + # Basen module 1 + - path: 'packages/bms/bms_combine_BASEN_RS485_full.yaml' + vars: + bms_id: '1' # must be a number + bms_name: 'BASEN-BMS 1' + bms_address: '0x01' + # Basen module 2 + - path: 'packages/bms/bms_combine_BASEN_RS485_full.yaml' + vars: + bms_id: '2' # must be a number + bms_name: 'BASEN-BMS 2' + bms_address: '0x02' diff --git a/examples/single-node/RP_BMS_example_BMS_Charging_Logic.yaml b/examples/single-node/RP_BMS_example_BMS_Charging_Logic.yaml new file mode 100644 index 0000000..96b870b --- /dev/null +++ b/examples/single-node/RP_BMS_example_BMS_Charging_Logic.yaml @@ -0,0 +1,44 @@ +# Updated : 2025.07.26 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + + # This is additional charging logic executed at the BMS level. + # This logic turns the BMS's charge switch OFF when the battery is fully charged. + # This prevents the battery from being overcharged while the other batteries continue to charge. + # This logic acts directly on the charging MOSFETs; please use it only if necessary and at your own risk. + # The BMS charge switch will be turned ON again during ReBulk. + + bms_charging_logic: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # BMS 1 + - path: 'packages/bms/bms_options_charging_logic.yaml' + vars: + bms_id: '1' # must be a number + # BMS 2 + - path: 'packages/bms/bms_options_charging_logic.yaml' + vars: + bms_id: '2' # must be a number diff --git a/examples/single-node/RP_BMS_example_DEMO_Shunt_and_BMS.yaml b/examples/single-node/RP_BMS_example_DEMO_Shunt_and_BMS.yaml new file mode 100644 index 0000000..8cf432c --- /dev/null +++ b/examples/single-node/RP_BMS_example_DEMO_Shunt_and_BMS.yaml @@ -0,0 +1,127 @@ +# Updated : 2025.07.26 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + + shunt: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Shunt 1 + - path: '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' # % + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # BMS 1 + - path: '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: '98' # % + 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 + # BMS 2 + - path: '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 + # BMS 3 + - path: '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 diff --git a/examples/single-node/RP_BMS_example_DEYE-PCS_CAN.yaml b/examples/single-node/RP_BMS_example_DEYE-PCS_CAN.yaml new file mode 100644 index 0000000..f2c2a4c --- /dev/null +++ b/examples/single-node/RP_BMS_example_DEYE-PCS_CAN.yaml @@ -0,0 +1,59 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Deye BMS top unit (required) + - path: 'packages/bms/bms_sensors_DEYE_CAN_top_full.yaml' + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + deye_name: 'DEYE-Top 1' + deye_id: '1' + # Deye module 1 + - path: 'packages/bms/bms_combine_DEYE_CAN_module_full.yaml' + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + # BMS vars + bms_id: '1' # must be a number + bms_name: 'DEYE-BMS 1' + deye_id: '1' + deye_module_id: '0' # Modules are numbered with 0-9 + # Deye module 2 + - path: 'packages/bms/bms_combine_DEYE_CAN_module_full.yaml' + vars: + # CAN BUS ID + canbus_id: 'canbus_bms_1' + # BMS vars + deye_id: '1' + bms_id: '2' # must be a number + bms_name: 'DEYE-BMS 2' + deye_module_id: '1' # Modules are numbered with 0-9 diff --git a/examples/single-node/RP_BMS_example_JBD_UART_BLE.yaml b/examples/single-node/RP_BMS_example_JBD_UART_BLE.yaml new file mode 100644 index 0000000..2b5da4c --- /dev/null +++ b/examples/single-node/RP_BMS_example_JBD_UART_BLE.yaml @@ -0,0 +1,67 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # BMS 1 + - path: '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' + # BMS 2 + - path: '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/examples/single-node/RP_BMS_example_JK-B_RS485_Modbus_mode2.yaml b/examples/single-node/RP_BMS_example_JK-B_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..63f01bb --- /dev/null +++ b/examples/single-node/RP_BMS_example_JK-B_RS485_Modbus_mode2.yaml @@ -0,0 +1,113 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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) + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # RS485 Sniffer + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_sniffer.yaml' + vars: + sniffer_id: 'sniffer1' + sniffer_protocol: 'JK02_32S' + sniffer_uart_id: 'uart_esp_1' + # BMS 1 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 2 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 3 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 4 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 5 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 6 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 7 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) + # BMS 8 + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_JK-B_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 ( JK app `Device Addr.` setting ) diff --git a/examples/single-node/RP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml b/examples/single-node/RP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml new file mode 100644 index 0000000..5a54aa9 --- /dev/null +++ b/examples/single-node/RP_BMS_example_JK-PB_RS485_Modbus_mode2.yaml @@ -0,0 +1,113 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +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) + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # RS485 Sniffer + - path: 'packages/bms/bms_combine_JK_RS485_Modbus_sniffer.yaml' + vars: + sniffer_id: 'sniffer1' + sniffer_protocol: 'JK02_32S' + sniffer_uart_id: 'uart_esp_1' + # BMS 1 + - path: '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 + # BMS 2 + - path: '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 + # BMS 3 + - path: '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 + # BMS 4 + - path: '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 + # BMS 5 + - path: '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 + # BMS 6 + - path: '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 + # BMS 7 + - path: '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 + # BMS 8 + - path: '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/examples/single-node/RP_BMS_example_JK_BLE.yaml b/examples/single-node/RP_BMS_example_JK_BLE.yaml new file mode 100644 index 0000000..8aee2fb --- /dev/null +++ b/examples/single-node/RP_BMS_example_JK_BLE.yaml @@ -0,0 +1,52 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # BMS 1 + - path: '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' + # BMS 2 + - path: '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/examples/single-node/RP_BMS_example_JK_UART_4G-GPS.yaml b/examples/single-node/RP_BMS_example_JK_UART_4G-GPS.yaml new file mode 100644 index 0000000..33db5b9 --- /dev/null +++ b/examples/single-node/RP_BMS_example_JK_UART_4G-GPS.yaml @@ -0,0 +1,50 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # BMS 1 + - path: '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' + # BMS 2 + - path: '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/examples/single-node/RP_BMS_example_SEPLOS_V1_V2_RS485.yaml b/examples/single-node/RP_BMS_example_SEPLOS_V1_V2_RS485.yaml new file mode 100644 index 0000000..495ec0a --- /dev/null +++ b/examples/single-node/RP_BMS_example_SEPLOS_V1_V2_RS485.yaml @@ -0,0 +1,76 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Seplos Modbus 1 + - path: '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' + # BMS 1 + - path: '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 + # BMS 2 + - path: '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/examples/single-node/RP_BMS_example_SEPLOS_V3_RS485.yaml b/examples/single-node/RP_BMS_example_SEPLOS_V3_RS485.yaml new file mode 100644 index 0000000..9cbc00f --- /dev/null +++ b/examples/single-node/RP_BMS_example_SEPLOS_V3_RS485.yaml @@ -0,0 +1,52 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Remote Packages Example ########################### + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + +packages: + + bms: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Seplos Modbus + - path: 'packages/bms/bms_combine_SEPLOS_V3_RS485_modbus.yaml' + vars: + seplos_modbus_uart_id: 'uart_esp_1' + seplos_modbus_baud_rate: '19200' # 9600 / 19200 ; please set the baudrate of your Seplos BMS model here + # BMS 1 + - path: 'packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml' + vars: + bms_id: '1' # BMS id and modbus address + bms_name: 'BMS 1' + # BMS 2 + - path: 'packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml' + vars: + bms_id: '2' # BMS id and modbus address + bms_name: 'BMS 2' + # BMS 3 + - path: 'packages/bms/bms_combine_SEPLOS_V3_RS485_bms_full.yaml' + vars: + bms_id: '3' # BMS id and modbus address + bms_name: 'BMS 3' diff --git a/examples/single-node/RP_Shunt_example.yaml b/examples/single-node/RP_Shunt_example.yaml new file mode 100644 index 0000000..aaa83c5 --- /dev/null +++ b/examples/single-node/RP_Shunt_example.yaml @@ -0,0 +1,64 @@ +# Updated : 2025.07.27 +# Version : 1.1.1 +# GitHub : https://github.com/Sleeper85/esphome-yambms + +# YamBMS ( Yet another multi-BMS Merging Solution ) + +# This YAML is free software: you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation, either version 3 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +############################ Local Packages Example ############################ + +# This is not a working YAML but just code ready to copy into your main YAML. + +################################################################################ + + # Junctek KHF UART + shunt: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Shunt 1 + - path: 'packages/shunt/shunt_combine_Junctek_KHF_UART.yaml' + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_uart_id: 'uart_esp_1' + + # Victron SmartShunt UART + shunt: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Shunt 1 + - path: '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_1' + + # Victron SmartShunt BLE + shunt: + url: https://github.com/Sleeper85/esphome-yambms + ref: main + refresh: 0s + files: + # Shunt 1 + - path: 'packages/shunt/shunt_combine_Victron_SmartShunt_BLE.yaml' + vars: + shunt_id: '1' # must be a number + shunt_name: 'Shunt 1' + shunt_mac_address: '60:A4:23:91:8F:55' # Your MAC address + shunt_encryption_key: '0df4d0395b7d1a876c0c33ecb9e70dcd' # Your encryption key