Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
75c0a97659 | ||
|
|
810f109592 | ||
|
|
5329ea6696 | ||
|
|
bcf7f3f9fa | ||
|
|
f2415bda61 | ||
|
|
0edda3cd66 | ||
|
|
5dc31f29c5 | ||
|
|
66cbb93397 | ||
|
|
19b4d22ea1 | ||
|
|
072453e70c | ||
|
|
ee28444a88 | ||
|
|
b6f0515ec1 | ||
|
|
ae959c057e | ||
|
|
a519338422 | ||
|
|
e105dc0dad | ||
|
|
5e5b86dece | ||
|
|
0e3fdb5043 | ||
|
|
8a1262e426 | ||
|
|
64e5a4b177 | ||
|
|
3984ccea0e | ||
|
|
468c61a9dd | ||
|
|
81bd0e7ab9 | ||
|
|
737cacdf09 | ||
|
|
7290a24946 | ||
|
|
aa5dd3ec50 | ||
|
|
4e06577eb0 | ||
|
|
df967ca5e9 | ||
|
|
872abfcd97 | ||
|
|
c2cc9d2be0 | ||
|
|
bc12a8e1a0 | ||
|
|
b3f203bd58 | ||
|
|
2eaf17633d | ||
|
|
e70819054c | ||
|
|
d2eee689ee | ||
|
|
a851511d09 | ||
|
|
b4e6262793 | ||
|
|
99c92f17dc | ||
|
|
a1b8572f3d | ||
|
|
11e0e34ab9 | ||
|
|
1506b02943 | ||
|
|
e43bb74e52 | ||
|
|
2b9f92a5eb | ||
|
|
a3ea2a2189 | ||
|
|
db555b91b1 | ||
|
|
b2dbaa3f4d | ||
|
|
27c94803c9 | ||
|
|
f2bcf8644b | ||
|
|
7d9c31e3e0 | ||
|
|
f4b54c4acd | ||
|
|
e228d14d76 | ||
|
|
ea62827a93 | ||
|
|
76cab805a7 | ||
|
|
36199a6ecb | ||
|
|
31e138bf0d | ||
|
|
7909210390 | ||
|
|
3314d57a7d | ||
|
|
4b05008e78 | ||
|
|
444c2fbf33 | ||
|
|
941fcbf9f2 | ||
|
|
03e91d2ed8 | ||
|
|
5ddf954d0f | ||
|
|
0829fc64b9 | ||
|
|
0012b9ad78 | ||
|
|
f6f564de01 | ||
|
|
96eb7b5b7d | ||
|
|
e5491609b8 | ||
|
|
200e90461e | ||
|
|
ee003598cd | ||
|
|
2d0a602e70 | ||
|
|
4c89aeef61 | ||
|
|
2a661fc667 | ||
|
|
9c7c22444b | ||
|
|
f4e9811805 | ||
|
|
58a83bef64 | ||
|
|
2fdfd7aa91 | ||
|
|
7584426532 | ||
|
|
48ffc4f15a | ||
|
|
c55a17d306 | ||
|
|
e45184cc27 | ||
|
|
e44fc40eb5 | ||
|
|
c5c7540c85 | ||
|
|
19f8c0b4f7 | ||
|
|
25b286c4e8 | ||
|
|
8dc572cdba | ||
|
|
964462ab5f | ||
|
|
cd7cb4c246 | ||
|
|
c755dcce83 | ||
|
|
aa523ec148 | ||
|
|
9d3996a4ea | ||
|
|
73a43ea036 | ||
|
|
ca43d7a310 | ||
|
|
ed4dc7f522 | ||
|
|
a3fa519f41 | ||
|
|
e3ef26056e | ||
|
|
3cb9e1d60c | ||
|
|
e93b68699d | ||
|
|
c25d3eed21 | ||
|
|
f2e6b57e75 | ||
|
|
2f1a82c3ad | ||
|
|
5da5cce67c | ||
|
|
77f657415a | ||
|
|
1597d99fcc | ||
|
|
c3a80b9f8c | ||
|
|
17b7500f0c | ||
|
|
b9632e0eb5 | ||
|
|
53d8a189b2 | ||
|
|
53e754c753 | ||
|
|
5ba0a5cf26 | ||
|
|
34fda6c92a | ||
|
|
5ffffb74b6 | ||
|
|
ef90c2de0d | ||
|
|
cdc86cc298 | ||
|
|
c18b9c8d55 | ||
|
|
62b5844ec2 | ||
|
|
4c6dba8add | ||
|
|
da0acaa3c5 | ||
|
|
2fa5b4d4f3 | ||
|
|
b143d9bd60 | ||
|
|
1bacb100d1 | ||
|
|
d0e42a27a4 | ||
|
|
965ad74127 | ||
|
|
85e3c90043 | ||
|
|
32b2dfc450 | ||
|
|
348f7f2e0c | ||
|
|
a6e4f24df5 | ||
|
|
02dec09cfd | ||
|
|
750cfd11a5 | ||
|
|
b5c05bf350 | ||
|
|
b3333e4949 | ||
|
|
c00aa954f5 | ||
|
|
a0cfea8b5d | ||
|
|
345181c185 | ||
|
|
7c97912913 | ||
|
|
06d2b0fda0 | ||
|
|
74e36b5a4f | ||
|
|
fa0f1960cc | ||
|
|
e6e31c165c | ||
|
|
b7c3eddee4 | ||
|
|
92ce28c041 | ||
|
|
9d9769a205 | ||
|
|
60c875df23 | ||
|
|
a10e0085d8 | ||
|
|
d487b756bf | ||
|
|
9b4596bc43 | ||
|
|
7a447450cc | ||
|
|
0ecc1df3e0 | ||
|
|
e9fee50967 | ||
|
|
39543e8b9f | ||
|
|
88c64f6ba4 | ||
|
|
27649631fb | ||
|
|
e5fc628957 | ||
|
|
e6896837de | ||
|
|
a353a63ade | ||
|
|
9c5a87fbe7 | ||
|
|
9ccbeb6b94 | ||
|
|
1d3a195d9a | ||
|
|
d9cddd2461 | ||
|
|
3f50bc224b | ||
|
|
777aa40339 | ||
|
|
37e65b3036 | ||
|
|
660ff99b5c | ||
|
|
214568c6ff | ||
|
|
665c25619c | ||
|
|
7547ddb780 | ||
|
|
6c4e710f45 | ||
|
|
a14452eb8e | ||
|
|
60291dee68 | ||
|
|
4a2f6aace1 | ||
|
|
dec2f7e4f8 | ||
|
|
4a8f60817d | ||
|
|
d727463717 | ||
|
|
d7ed15c557 | ||
|
|
1bc7bdfd67 | ||
|
|
5159e75d62 | ||
|
|
8afc7d1eb4 | ||
|
|
ee919ad1f0 | ||
|
|
95e0b240ca | ||
|
|
a4ccbde14a | ||
|
|
297eb96363 | ||
|
|
82fbdd29f2 | ||
|
|
0b9eb99e33 | ||
|
|
b312d3eb3e | ||
|
|
3209ec910b | ||
|
|
9da27a5a8b | ||
|
|
31260f3ace | ||
|
|
0c731d52fc | ||
|
|
afec9413dd | ||
|
|
a2da3ac19c | ||
|
|
afc259c62c | ||
|
|
c2943bac36 | ||
|
|
76ed9e0d48 | ||
|
|
f3e35028b8 | ||
|
|
e1dd4202ae | ||
|
|
1ea2e7d66f | ||
|
|
15179db113 | ||
|
|
83e74563b6 | ||
|
|
f858597a2b | ||
|
|
5c20e87f50 | ||
|
|
a67202a70f | ||
|
|
bdd8e234d9 | ||
|
|
6d56f796a1 | ||
|
|
76f6046961 | ||
|
|
7c7097fa0b | ||
|
|
86f39195e8 | ||
|
|
42973d9c9d | ||
|
|
592274bc59 | ||
|
|
ab04cc92db | ||
|
|
33056b2437 | ||
|
|
c1597bd502 | ||
|
|
d65226a1f9 | ||
|
|
558f1bfa47 | ||
|
|
1d71cf895e | ||
|
|
506e019d6f | ||
|
|
2284b7db51 | ||
|
|
cf874f0a0f | ||
|
|
e76a7b4695 | ||
|
|
844a74887e | ||
|
|
623c66839a | ||
|
|
726fafd79f | ||
|
|
e60f802a68 | ||
|
|
60ed5c132c | ||
|
|
cd9bd987df | ||
|
|
f7a39d6b55 | ||
|
|
cea0d98e62 | ||
|
|
ada25f475b | ||
|
|
d0f252265e | ||
|
|
308ec5f032 | ||
|
|
e9d1239c01 | ||
|
|
58c6429d9c | ||
|
|
9c747934a4 | ||
|
|
58c50ffe8b | ||
|
|
43d70f647f | ||
|
|
30d428c4fc | ||
|
|
b4887912af | ||
|
|
c9b12fbe87 | ||
|
|
060e44c07d | ||
|
|
c3b5f5f88a | ||
|
|
0272cea3ca | ||
|
|
64e4c7f0e0 | ||
|
|
7a1d68a3f3 | ||
|
|
1939298992 | ||
|
|
71a7643ca2 | ||
|
|
2a26d7822d | ||
|
|
492c81b9a3 | ||
|
|
45c9cd2efc | ||
|
|
124688e83f | ||
|
|
309b43b565 | ||
|
|
7a78cf5672 | ||
|
|
a11f2b75c8 | ||
|
|
c83d93874b | ||
|
|
c426efa321 | ||
|
|
0cabeeced8 | ||
|
|
75e2ac8155 | ||
|
|
7ca041c8c6 | ||
|
|
0834b934d7 | ||
|
|
679baa2068 | ||
|
|
197ecd0957 | ||
|
|
37d2b3b320 | ||
|
|
ce351bf7e8 | ||
|
|
2f53ed1eb2 | ||
|
|
9e9024225d | ||
|
|
a74a69a740 | ||
|
|
358a87ca2f | ||
|
|
2139aee6d8 | ||
|
|
f0b79ad78c | ||
|
|
a5ae54f8ad | ||
|
|
933003c4a9 | ||
|
|
c51e694197 | ||
|
|
802511f4d6 | ||
|
|
c83eddecd0 | ||
|
|
cf95333a36 | ||
|
|
5bb5eb99ad | ||
|
|
f5592a005e | ||
|
|
b1e6af7a57 | ||
|
|
5e8ac7f3b1 | ||
|
|
34722c13ce | ||
|
|
b3445c5e3c | ||
|
|
9859d4b0be | ||
|
|
6926f9ef9b | ||
|
|
fca0b6848d | ||
|
|
9b22639405 | ||
|
|
692eb525ca | ||
|
|
d56c2f1457 | ||
|
|
884d4219a6 | ||
|
|
9c4897d87e | ||
|
|
6b7c178093 | ||
|
|
557721f7f7 | ||
|
|
be71ac9340 | ||
|
|
74587aa5f7 | ||
|
|
ec10e09c18 | ||
|
|
0b5773c9c9 | ||
|
|
82493b0a6a | ||
|
|
e0ccd7d07d | ||
|
|
525436db44 | ||
|
|
5aed8e6267 | ||
|
|
5fe8583799 | ||
|
|
01462622d5 | ||
|
|
d0601905e6 | ||
|
|
3775c108ee | ||
|
|
b3bcfdef7e | ||
|
|
3c716fd085 | ||
|
|
7815119183 | ||
|
|
3b490821fe | ||
|
|
1b6c28e954 | ||
|
|
2046f44507 | ||
|
|
098546b65d | ||
|
|
eeee80faa7 | ||
|
|
c0240d44ed | ||
|
|
822b3394f6 | ||
|
|
a538ba3e6e | ||
|
|
95b69225ea | ||
|
|
eb9663b840 | ||
|
|
d5df679b9a | ||
|
|
669dee91d4 | ||
|
|
0424392349 | ||
|
|
c78bb0c465 | ||
|
|
1f3231df5f | ||
|
|
264b83ea8b | ||
|
|
529334683b | ||
|
|
1c4634c820 | ||
|
|
06ed27e8f0 | ||
|
|
de8927ce36 | ||
|
|
3c846ea24a | ||
|
|
a5e6423d03 | ||
|
|
44cb8504d3 | ||
|
|
63bce3f027 | ||
|
|
84c90c11d3 | ||
|
|
3dde676dd8 | ||
|
|
42151934bf | ||
|
|
a8233ea8c6 | ||
|
|
01c443e321 | ||
|
|
9977cc5963 | ||
|
|
f357d23751 | ||
|
|
ae276bb0eb | ||
|
|
f8b677a2b8 | ||
|
|
17d5edb2f0 | ||
|
|
3de5f0e080 | ||
|
|
c4313cc577 | ||
|
|
ea1859068d | ||
|
|
4115a33d87 | ||
|
|
4d52c3bbf8 | ||
|
|
3f9956f4d5 | ||
|
|
3127c7b3d7 | ||
|
|
da658defd8 | ||
|
|
4a0f3c6090 | ||
|
|
d889d091f7 | ||
|
|
bb764ceb01 | ||
|
|
7ec5fc02ac | ||
|
|
df3d9353b6 | ||
|
|
8777dc8688 | ||
|
|
c47b768573 | ||
|
|
e336ac315c | ||
|
|
56fd51e5d4 | ||
|
|
edd3beb0de | ||
|
|
5e1d7ac48e | ||
|
|
c552360fe0 | ||
|
|
088caecd47 | ||
|
|
af59e4307c | ||
|
|
b303244b77 | ||
|
|
91f961fcd6 | ||
|
|
f22ab83e19 | ||
|
|
97f9e38031 | ||
|
|
b4cd402337 | ||
|
|
25a2a88366 | ||
|
|
bdda35a837 | ||
|
|
7af47f5b2e |
No files matched your search
@@ -1,5 +1,5 @@
|
||||
# Updated : 2024.11.11
|
||||
# Version : 1.5.1
|
||||
# Updated : 2025.07.30
|
||||
# Version : 1.5.8
|
||||
# GitHub : https://github.com/Sleeper85/esphome-yambms
|
||||
|
||||
# YamBMS ( Yet another multi-BMS Merging Solution )
|
||||
@@ -24,9 +24,11 @@ views:
|
||||
sections:
|
||||
- type: grid
|
||||
cards:
|
||||
- type: heading
|
||||
heading: YamBMS - Battery
|
||||
- graph: line
|
||||
type: sensor
|
||||
entity: sensor.yambms_yambms_1_total_voltage_o
|
||||
entity: sensor.yambms_yambms_1_total_voltage
|
||||
detail: 2
|
||||
layout_options:
|
||||
grid_columns: 2
|
||||
@@ -40,7 +42,7 @@ views:
|
||||
name: SoC
|
||||
hours_to_show: 8
|
||||
- type: gauge
|
||||
entity: sensor.yambms_yambms_1_current_s
|
||||
entity: sensor.yambms_yambms_1_current
|
||||
needle: true
|
||||
severity:
|
||||
green: 0
|
||||
@@ -53,7 +55,7 @@ views:
|
||||
grid_columns: 2
|
||||
grid_rows: 3
|
||||
- type: gauge
|
||||
entity: sensor.yambms_yambms_1_power_s
|
||||
entity: sensor.yambms_yambms_1_power
|
||||
needle: true
|
||||
severity:
|
||||
green: 0
|
||||
@@ -66,16 +68,16 @@ views:
|
||||
grid_columns: 2
|
||||
grid_rows: 3
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_installed_battery_capacity_s
|
||||
entity: sensor.yambms_yambms_1_installed_battery_capacity
|
||||
name: Installed Battery Capacity
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_battery_soh
|
||||
name: Battery SoH
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_battery_capacity_s
|
||||
entity: sensor.yambms_yambms_1_battery_capacity
|
||||
name: Battery Capacity
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_capacity_remaining_s
|
||||
entity: sensor.yambms_yambms_1_capacity_remaining
|
||||
name: Capacity Remaining
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_delta_cell_voltage
|
||||
@@ -119,16 +121,17 @@ views:
|
||||
layout_options:
|
||||
grid_columns: 2
|
||||
grid_rows: 2
|
||||
title: YamBMS - Battery
|
||||
column_span: 1
|
||||
- type: grid
|
||||
cards:
|
||||
- type: heading
|
||||
heading: YamBMS - Status
|
||||
- type: tile
|
||||
entity: binary_sensor.yambms_canbus_1_status
|
||||
name: CANBUS Status
|
||||
entity: binary_sensor.yambms_inverter_communication_status
|
||||
name: Inverter comm. status
|
||||
- type: tile
|
||||
entity: binary_sensor.yambms_esp32_online_status
|
||||
name: ESP32 Status
|
||||
name: ESP32 status
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_charging_status
|
||||
name: Charging Status
|
||||
@@ -162,9 +165,6 @@ views:
|
||||
layout_options:
|
||||
grid_columns: 2
|
||||
grid_rows: 4
|
||||
- type: tile
|
||||
entity: sensor.yambms_esp32_uptime
|
||||
name: ESP32 Uptime
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: sensor.yambms_yambms_1_shunt_count
|
||||
@@ -173,7 +173,13 @@ views:
|
||||
name: Shunt combined
|
||||
layout_options:
|
||||
grid_columns: 2
|
||||
grid_rows: 3
|
||||
grid_rows: 2
|
||||
- type: tile
|
||||
entity: sensor.yambms_esp32_uptime
|
||||
name: ESP32 Uptime
|
||||
- type: tile
|
||||
entity: sensor.yambms_esp32_esphome_version
|
||||
name: ESPHome version
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: sensor.yambms_yambms_1_requested_charge_voltage
|
||||
@@ -192,17 +198,22 @@ views:
|
||||
- type: tile
|
||||
entity: sensor.yambms_yambms_1_last_version
|
||||
name: Last version
|
||||
title: YamBMS - Status
|
||||
column_span: 1
|
||||
- title: Control
|
||||
cards:
|
||||
- type: entities
|
||||
- type: entity-filter
|
||||
entities:
|
||||
- entity: select.yambms_canbus_1_bms_name
|
||||
name: CANBUS 1 BMS Name
|
||||
- entity: select.yambms_canbus_1_protocol
|
||||
name: CANBUS 1 Protocol
|
||||
title: YamBMS - CANBUS Protocol
|
||||
- entity: select.yambms_rs485_1_protocol
|
||||
name: RS485 1 Protocol
|
||||
conditions:
|
||||
- condition: state
|
||||
state_not: unavailable
|
||||
card:
|
||||
title: YamBMS - Inverter Comm. Protocol
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: switch.yambms_yambms_1_charge_enabled
|
||||
@@ -245,6 +256,17 @@ views:
|
||||
- entity: switch.yambms_yambms_1_automatic_discharge_current
|
||||
name: Automatic Discharge Current
|
||||
title: YamBMS - Auto CCL / DCL
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: select.yambms_yambms_1_automatic_float_voltage
|
||||
name: Automatic Float Voltage
|
||||
- entity: sensor.yambms_yambms_1_auto_float_voltage
|
||||
name: Auto Float Voltage
|
||||
- entity: number.yambms_yambms_1_auto_float_update_interval
|
||||
name: Update Interval
|
||||
- entity: number.yambms_yambms_1_auto_float_voltage_step
|
||||
name: Voltage Step
|
||||
title: YamBMS - Auto Float
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: number.yambms_yambms_1_rebulk_soc
|
||||
@@ -256,9 +278,9 @@ views:
|
||||
title: YamBMS - ReBulk
|
||||
- type: entities
|
||||
entities:
|
||||
- entity: number.yambms_yambms_1_max_charge_current
|
||||
- entity: number.yambms_yambms_1_max_charge_current_percent
|
||||
name: Max charge current (%)
|
||||
- entity: number.yambms_yambms_1_max_discharge_current
|
||||
- entity: number.yambms_yambms_1_max_discharge_current_percent
|
||||
name: Max discharge current (%)
|
||||
title: YamBMS - Max current (%)
|
||||
- type: entities
|
||||
@@ -296,7 +318,7 @@ views:
|
||||
- entity: button.yambms_esp32_restart
|
||||
name: ESP32 Restart
|
||||
title: YamBMS - Diagnostic
|
||||
- type: entities
|
||||
- type: entity-filter
|
||||
entities:
|
||||
- entity: binary_sensor.yambms_canbus_1_status
|
||||
name: CANBUS 1 Status
|
||||
@@ -304,19 +326,41 @@ views:
|
||||
name: CANBUS 1 Inverter Heartbeat Monitoring
|
||||
- entity: sensor.yambms_canbus_1_inverter_heartbeat
|
||||
name: CANBUS 1 Inverter Heartbeat
|
||||
title: YamBMS - Inverter Heartbeat
|
||||
- type: entities
|
||||
- entity: binary_sensor.yambms_rs485_1_status
|
||||
name: RS485 1 Status
|
||||
- entity: switch.yambms_rs485_1_inverter_heartbeat_monitoring
|
||||
name: RS485 1 Inverter Heartbeat Monitoring
|
||||
- entity: sensor.yambms_rs485_1_inverter_heartbeat
|
||||
name: RS485 1 Inverter Heartbeat
|
||||
conditions:
|
||||
- condition: state
|
||||
state_not: unavailable
|
||||
card:
|
||||
title: YamBMS - Inverter Status & Heartbeat
|
||||
- type: entity-filter
|
||||
entities:
|
||||
- entity: sensor.yambms_debug_heap_free
|
||||
- entity: sensor.yambms_debug_free_psram_percent
|
||||
name: Debug Free PSRAM (%)
|
||||
- entity: sensor.yambms_debug_free_psram
|
||||
name: Debug Free PSRAM
|
||||
- entity: sensor.yambms_debug_heap_free_percent
|
||||
name: Debug Heap free (%)
|
||||
- entity: sensor.yambms_debug_heap_free_2
|
||||
- entity: sensor.yambms_debug_heap_free
|
||||
name: Debug Heap free
|
||||
- entity: sensor.yambms_debug_heap_max_block
|
||||
- entity: sensor.yambms_debug_heap_max_block_percent
|
||||
name: Debug Heap max block (%)
|
||||
- entity: sensor.yambms_debug_heap_max_block_2
|
||||
- entity: sensor.yambms_debug_heap_max_block
|
||||
name: Debug Heap max block
|
||||
- entity: sensor.yambms_debug_loop_time
|
||||
name: Debug Loop time
|
||||
- entity: sensor.yambms_esp32_uptime
|
||||
name: ESP32 Uptime
|
||||
- entity: sensor.yambms_esp32_esphome_version
|
||||
name: ESPHome version
|
||||
- entity: sensor.yambms_debug_reset_reason
|
||||
name: Debug Reset reason
|
||||
title: YamBMS - DEBUG
|
||||
conditions:
|
||||
- condition: state
|
||||
state_not: unavailable
|
||||
card:
|
||||
title: YamBMS - DEBUG
|
||||
@@ -7,8 +7,23 @@
|
||||

|
||||
[](https://www.buymeacoffee.com/sleeper85)
|
||||
|
||||
> [!WARNING]
|
||||
> I'm currently working on releasing **YamBMS 1.6.0**, which will be compatible with **ESPHome >= 2025.11**.
|
||||
> **ESPHome 2025.11.0** introduces many changes and still contains many bugs.
|
||||
> For the time being, I advise you to stay with **ESPHome 2025.10.5**.
|
||||
|
||||
> [!TIP]
|
||||
> If compiling the source code is too difficult for you, I can provide you a `custom firmware` that is easy to install from a web page. You can [contact me privately](https://diysolarforum.com/direct-messages/add?to=Sleeper85) on the DIY solar forum.
|
||||
> Not sure which YAML to choose ? ... [YamBMS_Remote_Packages_example.yaml](YamBMS_Remote_Packages_example.yaml)
|
||||
> is a good basis for creating your custom YAML.
|
||||
> Examples of `BMS` and `Shunt` packages can be found in the [examples](examples/single-node/) folder.
|
||||
> You don't have to import a shunt but you must import at least `one BMS`.
|
||||
> You can mix different `BMS` models, the only condition is that the `bms_id` are numbered in order starting from `1` !
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The most important thing for proper functioning of YamBMS is that **the voltage of your BMS is well calibrated**.
|
||||
> YamBMS logic is based on the `min_cell_voltage` and `max_cell_voltage` voltages of your `BMS`.
|
||||
> If you use `YamBMS`, the internal charging logic of the `JK-PB BMS` will not be used.
|
||||
> Please read the [documentation](README.md#contents) and the [setup instructions](documents/README/Schematic_and_setup_instructions.md).
|
||||
|
||||
| ESPHome application to monitor BMS and communicate with inverters<br>supporting CAN bus protocol compatible with Pylontech, GoodWe, SMA,<br>Victron or Luxpower (EG4). | <a href="https://www.buymeacoffee.com/Sleeper85" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a> |
|
||||
| :--- | --- |
|
||||
@@ -35,16 +50,37 @@
|
||||
|
||||
[Dedicated topic on DIY Solar Forum](https://diysolarforum.com/threads/yambms-jk-bms-can-with-new-cut-off-charging-logic-open-source.79325/)
|
||||
|
||||
## YamBMS
|
||||
## Contents
|
||||
|
||||

|
||||
1) [Supported devices](documents/README/Supported_devices.md)
|
||||
2) [YamBMS behavior](documents/README/YamBMS_behavior.md)
|
||||
3) [YamBMS functions](documents/README/YamBMS_functions.md)
|
||||
4) [Charging logic](documents/README/Charging_logic.md)
|
||||
5) [CAN bus protocol](documents/README/CANBUS_protocol.md)
|
||||
6) [Hardware and schematic instructions](documents/README/Hardware_and_schematic_instructions.md)
|
||||
7) [Installation procedure](documents/README/Installation_procedure.md)
|
||||
8) [Troubleshooting](documents/README/Troubleshooting.md)
|
||||
|
||||
## YamBMS ( Yet another multi-BMS Merging Solution )
|
||||
|
||||

|
||||
|
||||
## Hardware highlighted
|
||||
|
||||
This project works with various `ESP32` variants and also with the `Raspberry Pi Pico (RP2040)`.
|
||||
Note that merging data from multiple BMS, balancers and shunts is resource-intensive, so I highly recommend a board based on the `ESP32-S3` with `PSRAM`.
|
||||
|
||||
| [LilyGo T-Connect](https://github.com/Xinyuan-LilyGO/T-Connect) | [Waveshare ESP32-S3-RS485-CAN](https://www.waveshare.com/esp32-s3-rs485-can.htm) | [M5Stack AtomS3R](https://docs.m5stack.com/en/core/AtomS3R) |
|
||||
| --- | --- | --- |
|
||||
| - ESP32-S3<br>- 8MB PSRAM<br>- 3x RS485 port<br>- 1x CAN port<br>- 15x GPIOs | - ESP32-S3<br>- 8MB PSRAM<br>- 1x RS485 port<br>- 1x CAN port<br>- 1x SH1.0 connector<br>- 16x GPIOs | - ESP32-S3<br>- 8MB PSRAM<br>- 1x BASE port (**for adding RS485/CAN base**)<br>- 1x UNIT HY2.0 port (**for adding RS485/CAN unit**)<br>- 6x GPIOs |
|
||||
| <img src="images/MCU_ESP32-S3_LilyGo-T-Connect.jpg" width="300"> | <img src="images/MCU_ESP32-S3_WS-RS485-CAN.png" width="300"> | <img src="images/MCU_AtomS3R.png" width="300"> |
|
||||
|
||||
### Single-node
|
||||
|
||||
You install `YamBMS` on a single ESP32 connected to your BMS and your inverter.
|
||||
|
||||
* Max 3x BMS BLE
|
||||
* Max 3X BMS UART
|
||||
* Max 3x BMS UART
|
||||
* several RS485 BMS on the same bus
|
||||
|
||||
### Multi-node
|
||||
@@ -73,18 +109,6 @@ The theoretical limit is `256` modbus server (BMS/Shunt) per `RS485 bus` but in
|
||||
|
||||

|
||||
|
||||
## Contents
|
||||
|
||||
1) [Supported devices](documents/README/Supported_devices.md)
|
||||
2) [YamBMS behavior](documents/README/YamBMS_behavior.md)
|
||||
3) [YamBMS functions](documents/README/YamBMS_functions.md)
|
||||
4) [Charging logic](documents/README/Charging_logic.md)
|
||||
5) [CAN bus protocol](documents/README/CANBUS_protocol.md)
|
||||
6) [Schematic and setup instructions](documents/README/Schematic_and_setup_instructions.md)
|
||||
7) [How to create your YamBMS YAML](documents/README/YamBMS_main_YAML_HowTo.md)
|
||||
8) [Installation procedure](documents/README/Installation_procedure.md)
|
||||
9) [Troubleshooting](documents/README/Troubleshooting.md)
|
||||
|
||||
## Try YamBMS with the DEMO firmware
|
||||
|
||||
You can simply test the application with a `generic ESP32` without compiling and connecting anything on your ESP32.
|
||||
@@ -92,7 +116,7 @@ The DEMO firmware is composed of `3x BMS` and `1x Shunt` (fake) for a `48V LFP`
|
||||
|
||||
> [!IMPORTANT]
|
||||
> `YamBMS_DEMO_ESP32.factory.bin` is intended for a generic ESP32, does not work with ESP32-S3.
|
||||
> If you want to test `YamBMS DEMO` with another board you need to compile the firmware with the `multi-bms_DEMO.yaml`.
|
||||
> If you want to test `YamBMS DEMO` with another board you need to compile the firmware with the `YamBMS_RP_DEMO.yaml`.
|
||||
|
||||
1) Download [YamBMS_DEMO_ESP32.factory.bin](firmware/YamBMS_DEMO_ESP32.factory.bin)
|
||||
2) Follow the [procedure explained in this document](https://docs.google.com/document/d/12pOpaG4Iyw3DjC_kB1q0jjBeSKJHK2FvXI1swebL2RI/edit?usp=sharing).
|
||||
@@ -105,7 +129,7 @@ rx_pin: 22 # to CAN board CRX (with 4.7K resistor except for SN65HVD230)
|
||||
|
||||
## Requirements
|
||||
|
||||
* [ESPHome 2024.6.0 or higher](https://github.com/esphome/esphome/releases)
|
||||
* [ESPHome 2025.6.0 or higher](https://github.com/esphome/esphome/releases)
|
||||
* ESP32 MCU (buying a board with ≥8MB flash is advised if you intend to monitor multiple BMS)
|
||||
* CAN transceiver (only with TJA1050/TJA1051 => 4.7K resistor for 5V to 3V3 level shifing)
|
||||
* BMS JK, JBD, Seplos (other BMS brands already integrated with ESPhome can be added easily)
|
||||
@@ -113,60 +137,24 @@ rx_pin: 22 # to CAN board CRX (with 4.7K resistor except for SN65HVD230)
|
||||
* Optional: 48V to 5V DC-DC converter to power the ESP32 from the JK-BMS VBAT pin (URB4805YMD-10WR3 or VRB4805S-6WR3)
|
||||
* Optional: JK RS485 adaptor and RS485 to TTL 3V3 adaptor (see schematic section)
|
||||
|
||||
## Changelog
|
||||
## Data collection
|
||||
|
||||
* YamBMS 1.5.3 :
|
||||
* Broadcasting JK-PB settings to all BMS set to OFF by default
|
||||
* Reorganizing the `board` folder and YAMLs (device_base.yaml moved to board.yaml)
|
||||
* `device_base.yaml` should no longer be part of `YamBMS_main.yaml`
|
||||
* New `RGB LED status` light effects (red, green, blue, cyan) as an `options` packages for `board.yaml`
|
||||
* Increased CPU frequency to `240Mhz` as an `options` packages for `board.yaml`
|
||||
* Added `ESP32 Generic`, `LilyGo T-CAN485`, `LilyGo T-Connect` and `XIAO` boards
|
||||
* Fixed SoC logic (low SoC will be detected at BMS level and no longer at YamBMS level)
|
||||
* Simplified combination logic (removal of the combine switch) + dashboard update
|
||||
* Check `Battery Capacity` is `> 0` before combining info (see [issue #14](https://github.com/Sleeper85/esphome-yambms/issues/14))
|
||||
* Improved alarm logic with a common `YamBMS errors bitmask` for all BMS models (see OTP vs UTP bug reported by @ChrisG)
|
||||
* Added [PR #7547](https://github.com/esphome/esphome/pull/7547) regarding publishing entities via the API
|
||||
* Removed `captive_portal` because it increases the `loop time` too much
|
||||
* `PSRAM` will no longer be enabled by default as this has a bad impact on `BLE BMS`
|
||||
* YamBMS 1.5.2 :
|
||||
* Added shunt `Online Status` binary_sensor
|
||||
* Shunt combine condition based on the new binary_sensor `Online Status`
|
||||
* Logger `baud_rate: 0` by default (frees the 3rd UART and avoids some bugs like "WK2168 with canbus" or "BLE client with RS485 modbus")
|
||||
* Changed names of `bms` and `shunt` YAMLs for modbus `multi-node` solution
|
||||
* Added shared configuration file to simplify main YAML (centralization of parameters)
|
||||
* Simplification (fewer options) when importing `BMS / Shunt` YAMLs
|
||||
* New `multi-node` solution using `RS485 modbus` to communicate information to YamBMS
|
||||
* New board `espBerry` with `2-CH-CAN HAT`
|
||||
* YamBMS 1.5.1 :
|
||||
* The conditions for `combining` BMS and the `charging` and `discharging` instructions no longer have any relation with the `errors_bitmask` sensor, the new system relies on the three **binary_sensor** `online status`, `charging allowed` and `discharging allowed` being linked to the status of alarms and switches.
|
||||
* The BMS combination procedure has been completely rewritten.
|
||||
* Improved structure and ID names of `bms.yaml`.
|
||||
* The `yambms.yaml` and `yambms_combine.yaml` global variable names have been changed for better code reading.
|
||||
* Improved code regarding the CAN bus `esp_light` status for boards without integrated LED.
|
||||
* New `Atom S3R` board and `Smartshunt BLE` shunt.
|
||||
* New `JBD`, `Seplos V1 V2`, `JK-B RS485` (display port) and `FAKE` BMS.
|
||||
* New `YamBMS DEMO` YAML and firmware offered to test and discover how `YamBMS` works.
|
||||
* New management of temperature sensors (no longer limited to two sensors).
|
||||
* **@Der_Hannes** fixed the AtomS3 `black screen` issue (with **esphome > 2024.7.3**) and developed new code for display management based on the [ili9xxx](https://esphome.io/components/display/ili9xxx.html) platform.
|
||||
* `Auto CCL/DCL` functions have been fixed to work with `JK-PB` and `new JK-B` BMS, [see this issue](https://github.com/Sleeper85/esphome-yambms/issues/11).
|
||||
* The `UVPR` and `OVPR` sensors are no longer used and replaced by `UVP` and `OVP` to ensure operation with all BMS.
|
||||
* **@txubelaxu** fixed a bug in the `JK-PB RS485` component that could cause a false battery voltage value to be sent, [see this issue](https://github.com/Sleeper85/esphome-yambms/issues/10).
|
||||
* Improved documentation, added a `HowTo` to create its main YAML, warning about galvanic isolation.
|
||||
* CANBUS 2.3.7 : If there is no response from the inverter, the time before a new communication test has been reduced from `120s` to `60s`, added Victron `0x372` nbr. of modules `blocking charge/discharge`.
|
||||
* YamBMS 1.4.5 : Changed the way to configure WiFi/Ethernet network, added `ESP32-C3 ETH01-EVO` ethernet board, reduction of the number of YAML bms files, UART `rx_buffer_size` is set to `512` by default for JK-B and JK-PB, new JK-BMS BLE sensors (last commits of @syssi) and new BLE `standard` version
|
||||
* CANBUS 2.3.6 : Sending CAN frames stops immediately if there are no combined BMS
|
||||
* YamBMS 1.4.4 : Multi-shunt support, Simplified and new YamBMS option `battery chemistry`, slider `min/max` values are automatically configured based on the battery chemistry and cell count, added `YamBMS Fallback Hotspot`, added YamBMS `Update service`, added PVbrain2 and Atom Matrix board, added PSRAM settings YAML (not enabled by default), new MIN/MAX temperature sensor, added DC current icon, fixed dual sensor `Cell UVPR (MAX)` bug, Improved `combine` code, Breaking change : Atom S3 `GPIOs 1 and 2` reversed
|
||||
* CANBUS 2.3.5 : New MIN/MAX temperature / sensor ID, Improved Victron protocol (online/offline battery modules, installed/available battery capacity)
|
||||
* CANBUS 2.3.4 : Fixed bug of canbus link validation without inverter connected
|
||||
* YamBMS 1.4.3 : Added Victron and Junctek KH-F `Shunt` support and `Requested Force Charge` function based on `SoC start/stop`, new `Total Daily Energy` sensors
|
||||
* CANBUS 2.3.3 : Added `Automatic` BMS name selection and `Requested Force Charge` Bit 3/4/5 (PYLON 0x35C)
|
||||
* CANBUS 2.3.2 : Added `LuxPower` protocol with updated `can_id` 0x355, 0x356, 0x359 and 0x35C
|
||||
* CANBUS 2.3.1 : Improved the procedure for sending canbus frames with reduced loop time, rewritten of the canbus link validation code and added `Inverter Heartbeat Monitoring` function
|
||||
* YamBMS 1.4.2 : Added new `Auto CVL Boost V.` and `Rebulk SoC` functions, new debug.yaml for ESP32 and ESP32-S3, improved code and comments
|
||||
* YamBMS 1.4.1 : Rewriting of the alarm system, bug fixes and improvement of the charging logic (new status `Cut-Off`), icon allocation for each sensor, UART and CANBUS `!extend ${vars}`, New sensor `YamBMS Delta Cell V.`, Improved `Battery SOC` logic
|
||||
* YamBMS 1.3.2 : New var `yambms_cell_count`, the BMS charge or discharge switches can be activated separately without causing the decombination of the BMS, new `minimal` version of the BMS YAML in order to reduce the loop time
|
||||
* YamBMS 1.3.1 : First multi-BMS version named `YamBMS`
|
||||
> [!NOTE]
|
||||
> For your information, in June 2025 there were `100` YamBMS users.
|
||||
|
||||
If the ESP32 has an internet connection, the following data is sent to [this script](http://script.opentel.be/yambms.post.php)
|
||||
for statistics collection. Only [@Sleeper85](https://github.com/Sleeper85) have access to this information for the production of statistics, the support and the update service.
|
||||
|
||||
- ESP32 MAC address
|
||||
- YamBMS version
|
||||
- Board chip
|
||||
- Board name
|
||||
- BMS model
|
||||
- BMS count
|
||||
- CAN bus name
|
||||
- CAN bus protocol
|
||||
- Uptime
|
||||
- Current date and time
|
||||
|
||||
## References
|
||||
|
||||
|
||||
@@ -0,0 +1,263 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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)
|
||||
# +--------------------------------------+
|
||||
# | UART expander WK2168 |
|
||||
# +--------------------------------------+
|
||||
uart0_baudrate: '2400' # uart_id : uart_${uart_hub_bus}_0 WKS {RJ45-UART0}
|
||||
uart1_baudrate: '38400' # uart_id : uart_${uart_hub_bus}_1 JSY193
|
||||
uart2_baudrate: '19200' # uart_id : uart_${uart_hub_bus}_2 SmartShunt
|
||||
uart3_baudrate: '9600' # uart_id : uart_${uart_hub_bus}_3 SRNE {RJ45-UART3}
|
||||
uart4_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_4 JK-BMS 1
|
||||
uart5_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_5 JK-BMS 2
|
||||
uart6_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_6 Pylontech
|
||||
uart7_baudrate: '9600' # uart_id : uart_${uart_hub_bus}_7 EPEVER {RJ45-UART7}
|
||||
|
||||
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_LP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
device_board: !include packages/board/board_ESP32-S3_DevKitC-1_PVbrain2.yaml
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
# uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
|
||||
|
||||
# UART expander WK2168
|
||||
wk2168_spi: !include packages/board/board_options_itf_wk2168_spi.yaml
|
||||
# wk2168_i2c: !include packages/board/board_options_itf_wk2168_i2c.yaml
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
canbus_node_1: !include
|
||||
file: packages/board/board_options_itf_canbus_esp32_can.yaml
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# canbus_node_2: !include
|
||||
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# psram_octal_80Mhz: !include packages/board/board_options_PSRAM_octal_80Mhz.yaml
|
||||
|
||||
# Web Server
|
||||
# web_server: !include packages/yambms/yambms_web_server.yaml
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# wifi_ap: !include packages/board/board_options_wifi_ap.yaml
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# captive_portal: !include packages/board/board_options_captive_portal.yaml
|
||||
|
||||
# PVbrain2 Options
|
||||
# bus_i2c0: !include pvbrain2/base/device_bus_i2c0.yaml # I2C bus for SX1509 and BME280/BMP280
|
||||
# bus_spi1: !include pvbrain2/base/device_bus_spi1.yaml # SPI bus for MCP2515
|
||||
# bus_one_wire: !include pvbrain2/base/device_bus_one_wire.yaml # One wire bus for Dallas sensor
|
||||
# device_sx1509: !include pvbrain2/base/device_sx1509.yaml # SX1509 16 channel I/O Expander
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms: !include packages/yambms/yambms.yaml
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus1: !include
|
||||
file: packages/yambms/yambms_canbus.yaml # yambms_canbus_web_server.yaml
|
||||
vars:
|
||||
canbus_id: 'canbus1'
|
||||
canbus_name: 'CANBUS 1'
|
||||
canbus_node_id: 'canbus_inverter_1' # CAN bus node to which your inverter is connected
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon: !include
|
||||
# file: packages/yambms/yambms_rs485_pylon.yaml # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
device_debug: !include
|
||||
file: packages/base/device_debug_ESP32.yaml
|
||||
# file: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,107 @@
|
||||
# Updated : 2025.07.29
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## 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
|
||||
|
||||
################################################################################
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | Shunt Settings |
|
||||
# +--------------------------------------+
|
||||
shunt_update_interval: '5s' # frequency at which Shunt data is refreshed
|
||||
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
|
||||
# +--------------------------------------+
|
||||
# | Modbus Settings |
|
||||
# +--------------------------------------+
|
||||
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 |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_LP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
device_board: !include packages/board/board_RP2040_RPi_Pico.yaml
|
||||
|
||||
uart_1: !include packages/board/board_options_itf_uart_1.yaml
|
||||
uart_2: !include packages/board/board_options_itf_uart_2.yaml
|
||||
uart_3: !include packages/board/board_options_itf_uart_3.yaml
|
||||
uart_4: !include packages/board/board_options_itf_uart_4.yaml
|
||||
uart_5: !include packages/board/board_options_itf_uart_5.yaml
|
||||
uart_6: !include packages/board/board_options_itf_uart_6.yaml
|
||||
|
||||
modbus: !include
|
||||
file: packages/base/device_modbus.yaml
|
||||
vars:
|
||||
modbus_role: 'server' # client / server
|
||||
modbus_uart_id: 'uart_1' # RS485 board
|
||||
|
||||
shunt1: !include
|
||||
file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART_minimal.yaml
|
||||
vars:
|
||||
shunt_id: '1'
|
||||
shunt_name: 'Shunt 1'
|
||||
shunt_uart_id: 'uart_2'
|
||||
|
||||
shunt2: !include
|
||||
file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART_minimal.yaml
|
||||
vars:
|
||||
shunt_id: '2'
|
||||
shunt_name: 'Shunt 2'
|
||||
shunt_uart_id: 'uart_3'
|
||||
|
||||
shunt3: !include
|
||||
file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART_minimal.yaml
|
||||
vars:
|
||||
shunt_id: '3'
|
||||
shunt_name: 'Shunt 3'
|
||||
shunt_uart_id: 'uart_4'
|
||||
|
||||
shunt4: !include
|
||||
file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART_minimal.yaml
|
||||
vars:
|
||||
shunt_id: '4'
|
||||
shunt_name: 'Shunt 4'
|
||||
shunt_uart_id: 'uart_5'
|
||||
|
||||
shunt5: !include
|
||||
file: packages/shunt/shunt_modbus_Victron_SmartShunt_UART_minimal.yaml
|
||||
vars:
|
||||
shunt_id: '5'
|
||||
shunt_name: 'Shunt 5'
|
||||
shunt_uart_id: 'uart_6'
|
||||
@@ -0,0 +1,279 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_LP_YAML.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_Atom-Lite.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32_EVB.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# device_board: !include
|
||||
# file: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# device_board: !include 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# device_dispay: !include
|
||||
# file: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
canbus_node_1: !include
|
||||
file: packages/board/board_options_itf_canbus_esp32_can.yaml
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# canbus_node_2: !include
|
||||
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# psram_octal_80Mhz: !include packages/board/board_options_PSRAM_octal_80Mhz.yaml
|
||||
|
||||
# Web Server
|
||||
# web_server: !include packages/yambms/yambms_web_server.yaml
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# wifi_ap: !include packages/board/board_options_wifi_ap.yaml
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# captive_portal: !include packages/board/board_options_captive_portal.yaml
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms: !include packages/yambms/yambms.yaml
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus1: !include
|
||||
file: packages/yambms/yambms_canbus.yaml # yambms_canbus_web_server.yaml
|
||||
vars:
|
||||
canbus_id: 'canbus1'
|
||||
canbus_name: 'CANBUS 1'
|
||||
canbus_node_id: 'canbus_inverter_1' # CAN bus node to which your inverter is connected
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon: !include
|
||||
# file: packages/yambms/yambms_rs485_pylon.yaml # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
device_debug: !include
|
||||
file: packages/base/device_debug_ESP32.yaml
|
||||
# file: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,324 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,396 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS Demo' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms-demo' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
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' # %e/
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,333 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
- path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_bms_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,274 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# ethernet:
|
||||
# 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/h
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,341 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,384 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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 )
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,384 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,326 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,324 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,292 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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)
|
||||
# +--------------------------------------+
|
||||
# | UART expander WK2168 |
|
||||
# +--------------------------------------+
|
||||
uart0_baudrate: '2400' # uart_id : uart_${uart_hub_bus}_0 WKS {RJ45-UART0}
|
||||
uart1_baudrate: '38400' # uart_id : uart_${uart_hub_bus}_1 JSY193
|
||||
uart2_baudrate: '19200' # uart_id : uart_${uart_hub_bus}_2 SmartShunt
|
||||
uart3_baudrate: '9600' # uart_id : uart_${uart_hub_bus}_3 SRNE {RJ45-UART3}
|
||||
uart4_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_4 JK-BMS 1
|
||||
uart5_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_5 JK-BMS 2
|
||||
uart6_baudrate: '115200' # uart_id : uart_${uart_hub_bus}_6 Pylontech
|
||||
uart7_baudrate: '9600' # uart_id : uart_${uart_hub_bus}_7 EPEVER {RJ45-UART7}
|
||||
|
||||
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32-S3_DevKitC-1_PVbrain2.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# UART expander WK2168
|
||||
- path: 'packages/board/board_options_itf_wk2168_spi.yaml'
|
||||
# - path: 'packages/board/board_options_itf_wk2168_i2c.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
# PVbrain2 Options
|
||||
# - path: 'pvbrain2/base/device_bus_i2c0.yaml' # I2C bus for SX1509 and BME280/BMP280
|
||||
# - path: 'pvbrain2/base/device_bus_spi1.yaml' # SPI bus for MCP2515
|
||||
# - path: 'pvbrain2/base/device_bus_one_wire.yaml' # One wire bus for Dallas sensor
|
||||
# - path: 'pvbrain2/base/device_sx1509.yaml' # SX1509 16 channel I/O Expander
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,350 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,326 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
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'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -0,0 +1,300 @@
|
||||
# Updated : 2025.08.12
|
||||
# Version : 1.5.8
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
######################## YamBMS Remote Packages Version ########################
|
||||
|
||||
# You can compile this YAML directly without the `packages` folder.
|
||||
# The packages will be automatically downloaded from GitHub.
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml
|
||||
|
||||
################################################################################
|
||||
|
||||
# If needed, configure a static IP here
|
||||
# wifi:
|
||||
# manual_ip:
|
||||
# static_ip: 192.168.0.85
|
||||
# gateway: 192.168.0.1
|
||||
# subnet: 255.255.255.0
|
||||
# dns1: 8.8.8.8
|
||||
# dns2: 8.8.4.4
|
||||
|
||||
logger:
|
||||
level: INFO # VERBOSE / DEBUG / INFO / WARN
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Global Settings |
|
||||
# +--------------------------------------+
|
||||
substitutions:
|
||||
# Name
|
||||
friendly_name : 'YamBMS' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
name: '' # This name can be added as a second prefix, both for the `entity display name` and the `entity id`, you can leave it blank.
|
||||
# +--------------------------------------+
|
||||
# | YamBMS Settings |
|
||||
# +--------------------------------------+
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
# +--------------------------------------+
|
||||
# | 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_RP_YAML.md
|
||||
|
||||
packages:
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> UNCOMMENT YOUR BOARD
|
||||
# | >>> ONLY ONE BOARD !
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
# - path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
# - path: 'packages/board/board_ESP32_Atom-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32_EVB.yaml'
|
||||
# - path: 'packages/board/board_ESP32_LilyGo-T-CAN485.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_DevKitM-1.yaml'
|
||||
# - path: 'packages/board/board_ESP32-C3_ETH01-EVO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-4.3.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_Touch-LCD-7.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
|
||||
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
|
||||
|
||||
# - path: 'packages/board/board_ESP32-S3_AtomS3.yaml' # 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
|
||||
# # LilyGo T-Connect Pro - Board
|
||||
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
|
||||
# # LilyGo T-Connect Pro - Display - Importing the display also activates PSRAM
|
||||
# - path: 'packages/board/board_options_display_480x222.yaml'
|
||||
# vars:
|
||||
# display_auto_next_page_interval: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Board Options
|
||||
# | >>> Uncomment your interfaces and options
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
board_options:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# UART 1 (uart_id: uart_esp_1)
|
||||
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
|
||||
# UART 2 (uart_id: uart_esp_2)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
|
||||
# UART 3 (uart_id: uart_esp_3)
|
||||
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
|
||||
|
||||
# CAN transceiver - ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
|
||||
- path: 'packages/board/board_options_itf_canbus_esp32_can.yaml'
|
||||
vars:
|
||||
# to bms = canbus_bms_1
|
||||
# to inverter = canbus_inverter_1
|
||||
canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# CAN transceiver - MCP2515
|
||||
# - path: 'packages/board/board_options_itf_canbus_mcp2515.yaml'
|
||||
# vars:
|
||||
# # to bms = canbus_bms_1
|
||||
# # to inverter = canbus_inverter_1
|
||||
# canbus_node_id: 'canbus_inverter_1'
|
||||
|
||||
# PSRAM octal 80Mhz
|
||||
# - path: 'packages/board/board_options_PSRAM_octal_80Mhz.yaml'
|
||||
|
||||
# Web Server
|
||||
# - path: 'packages/yambms/yambms_web_server.yaml'
|
||||
|
||||
# WiFi AP @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_wifi_ap.yaml'
|
||||
|
||||
# Captive Portal @ 192.168.4.1
|
||||
# - path: 'packages/board/board_options_captive_portal.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> BMS and Shunt
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# You don't have to import a shunt but you must import at least one BMS.
|
||||
# You can mix different BMS models, the only condition is that the `bms_id` are numbered in order starting from 1 !
|
||||
|
||||
# >>> Copy your BMS and Shunt packages here
|
||||
# >>> You can find examples at this address :
|
||||
# >>> https://github.com/Sleeper85/esphome-yambms/tree/main/examples/single-node/
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> YamBMS
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> CAN bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> RS485 bus to Inverter
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# rs485_pylon:
|
||||
# url: https://github.com/Sleeper85/esphome-yambms
|
||||
# ref: main
|
||||
# refresh: 0s
|
||||
# files:
|
||||
# - path: 'packages/yambms/yambms_rs485_pylon.yaml' # yambms_rs485_pylon_web_server.yaml
|
||||
# vars:
|
||||
# rs485_id: 'rs485_1'
|
||||
# rs485_name: 'RS485 1'
|
||||
# rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
# rs485_uart_baud_rate: '9600'
|
||||
# rs485_update_timeout: '5s'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> DEBUG ( logger level must be DEBUG )
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
|
||||
|
||||
|
||||
# +------------------------------------------------------------------------------+
|
||||
# | >>> Config and Custom Local Packages
|
||||
# +------------------------------------------------------------------------------+
|
||||
|
||||
# Local Packages intended for creating custom codes
|
||||
# or sharing settings between several main.yaml
|
||||
|
||||
# yambms_config: !include yambms_config.yaml
|
||||
# yambms_custom: !include yambms_custom.yaml
|
||||
@@ -1,4 +1,4 @@
|
||||
# YamBMS - JK-B BMS UART Solution
|
||||
# YamBMS - JK-B BMS
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||
@@ -6,9 +6,46 @@
|
||||

|
||||

|
||||
|
||||
## External component
|
||||
> [!IMPORTANT]
|
||||
> The most important thing for proper functioning of YamBMS is that **the voltage of your BMS is well calibrated**.
|
||||
> YamBMS logic is based on the `min_cell_voltage` and `max_cell_voltage` voltages of your BMS.
|
||||
|
||||
[esphome-jk-bms](https://github.com/syssi/esphome-jk-bms) by [@syssi](https://github.com/syssi)
|
||||
## JK-B BMS overview
|
||||
|
||||
### UART1 (GPS) port
|
||||
|
||||
The `GPS` port sometimes called `RS485` is not an `RS485` port but `3V3 UART-TTL` port.
|
||||
|
||||
```
|
||||
# UART-TTL GPS port on JK-BMS (4 pin, JST 1.25mm pitch)
|
||||
┌─── ─────── ────┐
|
||||
│ │
|
||||
│ O O O O │
|
||||
│GND RX TX VBAT│
|
||||
└────────────────┘
|
||||
│ │ │ └ VBAT is full battery voltage eg. 56V (possible to use it via an isolated DC-DC converter)
|
||||
│ │ └──── TX to TTL-isolator AI (input)
|
||||
│ └──────── RX to TTL-isolator AO (output)
|
||||
└──────────── GND to TTL-isolator GND
|
||||
```
|
||||
|
||||
The `UART1` (labeled as `GPS`) socket of the BMS can be attached to any UART pins of the ESP32.<br>
|
||||
A hardware UART should be preferred because of the high baudrate (115200 baud).<br>
|
||||
The connector is called 4 pin JST with 1.25mm pitch.
|
||||
|
||||

|
||||
|
||||
## JK-B BMS protocol
|
||||
|
||||
Historically it was not possible to change the protocol of the `UART1 (GPS)` port and the protocol used was `4G-GPS Remote module Common protocol V4.2` with the component [esphome-jk-bms](https://github.com/syssi/esphome-jk-bms) of [@syssi](https://github.com/syssi).
|
||||
|
||||
If you cannot change the protocol of the `UART1 (GPS)` port you can only monitor one BMS per UART port of the ESP32, so a maximum of `3x BMS` without adding a UART expander.
|
||||
|
||||
If you have a recent BMS, it is now possible to change the protocol of the `UART1 (GPS)` port and with the `JK BMS RS485 Modbus V1.0` protocol you can assign an address (via JK app) to your BMS and monitor several of them from a single `UART-RS485` connection in the same way as the [JK-PB](BMS_JK-PB.md). To use this protocol and monitor all your BMS on a single `RS485 bus` you will need to add the `UART to RS485 adapter` sold by JK or another RS485 board of your choice.
|
||||
|
||||
<img src="../../images/BMS_JK_RS485_Modbus_protocol.png" width="600">
|
||||
|
||||

|
||||
|
||||
## Schematic and setup instructions
|
||||
|
||||
@@ -32,8 +69,8 @@ You need to import this YAML into the main YAML.
|
||||
```
|
||||
UART-TTL RS232-TTL CAN BUS
|
||||
┌──────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐
|
||||
│ │<TX------RX>│2 5│<TX-------TX>| | | |
|
||||
│ JK-BMS │<RX------TX>│1 6│<RX-------RX>| CA-IS3050G |<---CAN H --->| Inverter |
|
||||
│ │<TX------RX>│1 5│<TX-------TX>| | | |
|
||||
│ JK-BMS │<RX------TX>│2 6│<RX-------RX>| CA-IS3050G |<---CAN H --->| Inverter |
|
||||
│ │<----GND--->│ ESP32 │ | CAN |<---CAN L --->| |
|
||||
│ │ 5V---->│5V 3V3| | | | |
|
||||
└──────────┘ └──────────┘ └────────────┘ └──────────┘
|
||||
@@ -51,8 +88,8 @@ You need to import this YAML into the main YAML.
|
||||
```
|
||||
UART-TTL RS232-TTL CAN BUS
|
||||
┌──────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐
|
||||
│ │<TX------RX>│26 22│<TX-------TX>| | | |
|
||||
│ JK-BMS │<RX------TX>│32 19│<RX-------RX>| CA-IS3050G |<---CAN H --->| Inverter |
|
||||
│ │<TX------RX>│32 22│<TX-------TX>| | | |
|
||||
│ JK-BMS │<RX------TX>│26 19│<RX-------RX>| CA-IS3050G |<---CAN H --->| Inverter |
|
||||
│ │<----GND--->│ ESP32 │ | CAN |<---CAN L --->| |
|
||||
│ │ 5V---->│5V 3V3| | | | |
|
||||
└──────────┘ └──────────┘ └────────────┘ └──────────┘
|
||||
@@ -105,25 +142,3 @@ You need to import this YAML into the main YAML.
|
||||
|
||||
```
|
||||
|
||||
### JK-B BMS UART-TTL GPS port
|
||||
|
||||
The `GPS` port sometimes called `RS485` is not an `RS485` port but `3V3 UART-TTL`.
|
||||
|
||||
```
|
||||
# UART-TTL GPS port on JK-BMS (4 pin, JST 1.25mm pitch)
|
||||
┌─── ─────── ────┐
|
||||
│ │
|
||||
│ O O O O │
|
||||
│GND RX TX VBAT│
|
||||
└────────────────┘
|
||||
│ │ │ └ VBAT is full battery volatge eg 51.2V (possible to use it via an isolated DC-DC converter)
|
||||
│ │ └──── TX to TTL-isolator AI (input)
|
||||
│ └──────── RX to TTL-isolator AO (output)
|
||||
└──────────── GND to TTL-isolator GND
|
||||
```
|
||||
|
||||
The UART-TTL (labeled as `GPS`) socket of the BMS can be attached to any UART pins of the ESP.<br>
|
||||
A hardware UART should be preferred because of the high baudrate (115200 baud).<br>
|
||||
The connector is called 4 pin JST with 1.25mm pitch.
|
||||
|
||||

|
||||
@@ -0,0 +1,225 @@
|
||||
# YamBMS - JK-PB Inverter BMS
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||

|
||||

|
||||

|
||||
|
||||
> [!WARNING]
|
||||
> There is a known bug with the latest version of **JK firmware >= V19.10**.
|
||||
> Using **DIP switch addresses 1 to 15** does not reliably guarantee that the **UART2 (RS485-2)** port protocol will be automatically configured to **001 - JK BMS RS485 Modbus V1.0**, which allows **YamBMS** to access BMS informations.
|
||||
> YamBMS users have confirmed that it is possible to resolve this issue by performing an [Erase History Data](BMS_JK-PB.md#erase-history-data) from the JK app on a smartphone.
|
||||
|
||||
|
||||
> The alternative solution is to use the **UART1 (RS485-1)** port configured with the **001 - JK BMS RS485 Modbus V1.0** protocol from the JK application.
|
||||
> Downgrading to **V19.10** does not guarantee to correct this problem, [please read this information before downgrading](BMS_JK-PB.md#downgrading-to-1910).
|
||||
|
||||
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The most important thing for proper functioning of YamBMS is that **the voltage of your BMS is well calibrated**.
|
||||
> YamBMS logic is based on the `min_cell_voltage` and `max_cell_voltage` voltages of your BMS.
|
||||
> If you use YamBMS, the internal charging logic of the `JK-PB BMS` will not be used.
|
||||
|
||||
## JK-PB BMS overview
|
||||
|
||||
||
|
||||
|-|
|
||||
||
|
||||
||
|
||||
|
||||
## JK-PB BMS protocol
|
||||
|
||||
The datas from this BMS can be retrieved from the `RS485-1 (UART1)` or `RS485-2 (UART2)` network using the component [JK_RS485](https://github.com/Sleeper85/esphome-components/tree/main/components) originally developed by [@txubelaxu](https://github.com/txubelaxu).
|
||||
|
||||
The BMS DIP switches must be set from `1` to `15` (server mode) and connected to each other using the `RS485-2` network available on the **two ports at the right ends**. `YamBMS` also connects to one of these two ports.
|
||||
|
||||
### **UART2 configuration**
|
||||
|
||||
> [!NOTE]
|
||||
> The protocol of the `UART2` port is not selectable from the JK application.
|
||||
> It is automatically set based on the address (DIP switch) of the BMS.
|
||||
|
||||
In the last software version only two protocols are available on the **RS485-2 (UART2)** ports:
|
||||
|
||||
- **001** - JK BMS RS485 Modbus V1.0 **(DIP switch 1 to 15)**
|
||||
- **015** - UART Protocol 015 **(DIP switch 0)**
|
||||
|
||||
### **UART1 configuration**
|
||||
|
||||
The following protocols are supported on the **RS485-1 (UART1)** port:
|
||||
|
||||
(*italic options ane not settable*)
|
||||
|
||||
- **000** - 4G-GPS Remote module Common protocol V4.2
|
||||
- **001** - **JK BMS RS485 Modbus V1.0**
|
||||
- **002** - NIU U SERIES
|
||||
- **003** - China tower shared battery cabinet V1.1
|
||||
- **004** - PACE_RS485_Modbus_V1.3
|
||||
- **005** - PYLON_low_voltage_Protocol_RS485_V3.5
|
||||
- **006** - Growatt_BMS_RS485_Protocol_1xSxxP_ESS_Rev2.01
|
||||
- **007** - Voltronic_Inverter_and_BMS_485_communication_protocol_20200...
|
||||
- **008** - China tower shared battery cabinet V2.0
|
||||
- **009** - WOW_RS485_Modbus_V1.3
|
||||
- **010** - JK BMS LCD Protocol V2.0
|
||||
- **011** - *UART1 User customization*
|
||||
- **012** - *UART2 User customization*
|
||||
- **013** - (9600)JK BMS RS485 Modbus V1.0
|
||||
- **014** - (9600)PYLON_low_voltage_Protocol_RS485_V3.5
|
||||
- **015** - *UART Protocol 015*
|
||||
|
||||
### **CAN port configuration**
|
||||
|
||||
The following CAN protocols are supported on the CAN port:
|
||||
|
||||
(*italic options ane not settable*)
|
||||
|
||||
- **000** - JK BMS CAN Protocol (250K) V2.0
|
||||
- **001** - Deye Low-voltage hybrid inverter CAN communication protocol V1.0
|
||||
- **002** - PYLON-Low-voltage-V1.2
|
||||
- **003** - Growatt BMS CAN-Bus-protocol-low-voltage_Rev_05
|
||||
- **004** - Victron_CANbus_BMS_protocol_20170717
|
||||
- **005** - MEGAREVO_Hybird_BMSCAN_Protocol_V1.0
|
||||
- **006** - JK BMS CAN Protocol (500K) V2.0
|
||||
- **007** - INVT BMS CAN Bus protocol V1.02
|
||||
- **008** - GoodWe LV BMS Protocol (EX/EM/S-BP/BP)
|
||||
- **009** - FSS-ConnectingBat-Tl-en-10 | Version 1.0
|
||||
- **010** - MUST PV1800F-CAN communication Protocol1.04.04
|
||||
- **011** - LuxpowerTek Battery CAN protocol V01
|
||||
- **012** - *CAN BUS User customization*
|
||||
- **013** - *CAN BUS Protocol 013*
|
||||
- **014** - *CAN BUS Protocol 014*
|
||||
|
||||
## YamBMS hardware
|
||||
|
||||
> [!TIP]
|
||||
> This solution only requires an ESP32 with a CAN transceiver and a RS485 transceiver.
|
||||
|
||||
You are free to choose the hardware you want, the list below are 3 easy to use examples of **ESP32-S3 with PSRAM** :
|
||||
|
||||
- [Waveshare ESP32-S3-RS485-CAN](https://www.waveshare.com/esp32-s3-rs485-can.htm), ESP32-S3 with 1x RS485 and 1x CAN
|
||||
- [LilyGo T-Connect](https://github.com/Xinyuan-LilyGO/T-Connect), ESP32-S3 with 3x RS485 and 1x CAN
|
||||
- [M5Stack AtomS3R](https://docs.m5stack.com/en/core/AtomS3R), ESP32-S3 with the isolated [Atomic CAN base](https://docs.m5stack.com/en/atom/Atomic%20CAN%20Base) and [RS485 unit](https://docs.m5stack.com/en/unit/iso485)
|
||||
|
||||
See the [documentation about supported hardware](Supported_devices.md).
|
||||
|
||||
### M5Stack AtomS3 example (no welding)
|
||||
|
||||
The example below uses an `AtomS3` (display) with the `Atomic CAN base` and `RS485 unit`.
|
||||
|
||||

|
||||
|
||||
## Schematic and setup instructions
|
||||
|
||||
> [!CAUTION]
|
||||
> Galvanic isolation of the `RS485` connection is strongly recommended.
|
||||
> The diagrams below does not show the galvanic isolation of the `RS485` connection !
|
||||
|
||||
> [!IMPORTANT]
|
||||
> If you are unable to read your BMS from the `RS485` bus, add a `120 Ohm`
|
||||
> resistor between the `A` and `B` wires connected to your `RS485` board.
|
||||
> This must be done with the `M5Stack RS485 unit`, some boards have a switch to enable the bus termination resistor.
|
||||
|
||||
**Note:** the choice of RS485 board is not related to the chosen ESP32.
|
||||
|
||||
### AtomS3 with unisolated RS485 board
|
||||
|
||||
```
|
||||
┌──────────┐ ┌───────────┐ ┌──────────┐
|
||||
│ │ │ UART │<-VCC--------------5V--│ │<---5V
|
||||
│ BMS │ │ TO │ │ ESP32 │
|
||||
│ JK-PB │<-RJ45-P1-----B->│ RS485 │<-DI-----------TX--G1--│ Atom S3 │
|
||||
│ │<-RJ45-P2-----A->│ │--RO-----------RX--G2->│ │ ┌────────────┐ ┌────────────┐
|
||||
│ RS485 │ │ CONVERTER │<-DE--+ │ │--G5--TX-----CTX->| | | |
|
||||
│ NETWORK │ │ │<-RE--└--TALK PIN--G8--│ │<-G6--RX-----CRX--| Atomic |<---CAN H--->| Inverter |
|
||||
│ │ │ │ │ │<-------5V------->| CAN Base |<---CAN L--->| |
|
||||
| |<-RJ45-P3---GND->| |<-GND-------------GND->| |<-------GND------>| | | |
|
||||
└──────────┘ └───────────┘ └──────────┘ └────────────┘ └────────────┘
|
||||
```
|
||||
|
||||
### ESP32-S3 with isolated RS485 board
|
||||
|
||||
```
|
||||
┌──────────┐ ┌───────────┐ ┌──────────┐
|
||||
│ │ │ UART │<-V1--------3V3 or 5V--│ │<---5V
|
||||
│ BMS │ │ TO │ │ │
|
||||
│ JK-PB │<-RJ45-P1-----B->│ RS485 │<-RX-----------TX--17--│ ESP32-S3 │
|
||||
│ │<-RJ45-P2 ----A->│ │--TX-----------RX--18->│ │ ┌────────────┐ ┌────────────┐
|
||||
│ RS485 │ │ CONVERTER │ │ │--38--TX-----CTX->| | | |
|
||||
│ NETWORK │ │ │ No TALK PIN (8)--│ │<-39--RX-----CRX--| CAN |<---CAN H--->| Inverter |
|
||||
│ │ │ │ │ │<-------3V3------>| SN65HVD230 |<---CAN L--->| |
|
||||
| |<-RJ45-P3----G2->| |<-G1--------------GND->| |<-------GND------>| | | |
|
||||
└──────────┘ └───────────┘ └──────────┘ └────────────┘ └────────────┘
|
||||
```
|
||||
|
||||
- [RJ45 568A pinout](../../images/RJ45-Pinout-T568A.jpg)
|
||||
- [RJ45 568B pinout](../../images/RJ45-Pinout-T568B.jpg)
|
||||
|
||||
## BMS DIP switch config (mode 2)
|
||||
|
||||
With `mode 2`, the sniffer (ESP32) will automatically take the address `0x00` and act as master BMS (max 15 BMS).
|
||||
This is the preferred mode with YamBMS.
|
||||
|
||||
- BMS 1 RS485 address : 0x01
|
||||
- BMS 2 RS485 address : 0x02
|
||||
- BMS 3 RS485 address : 0x03
|
||||
- etc.
|
||||
|
||||
## MODE 1 vs MODE 2
|
||||
|
||||
`MODE 1`. If there is a JK-BMS acting as REAL MASTER (i.e. it has set 0x00 address), the code will be sniffing all the traffic in the network. The problem is that there is some information that is NEVER in the sniffed traffic information (device info frame type 03): device-name, hw version, sw version, password, RCV Time, RFV Time... So, periodically, ESP code will act as a PSEUDO-MASTER to try to get this information. It works for every slave device, but not for master device. At this moment, master device does NOT broadcast by itself the "frame type 03" info. And it does not answer to a "frame type 03" request sent by PSEUDO MASTER.
|
||||
|
||||
`MODE 2`. If every JK-BMS are set as SLAVES (all of them), the ESP code will act as MASTER. So, if ESP code does not detect any REAL MASTER in the network, it will act as a MASTER. Remember to adapt DIP switches and the YAML (addresses) as well. Changing the addreses of the devices does not affect to the historic data gathered from that device, because the config is based on the NAME of the device and not on the address of the device. So, change the address, but not the name. In this mode, ESP will gather all the information (cell info, device settings and device info). If anytime, a REAL MASTER arrives to the network, ESP will detect it and will stop acting as MASTER.
|
||||
|
||||
## JK-PB RS485 functions
|
||||
|
||||
### Broadcasting JK-PB settings to all BMS
|
||||
|
||||

|
||||
|
||||
When enabled, this function synchronizes the settings of all your BMS connected to the same RS485 network as soon as you make parameter changes.
|
||||
|
||||
## JK-PB SoC 100% reset
|
||||
|
||||
> [!NOTE]
|
||||
> During the `Bulk` phase the YamBMS `SoC` cannot be more than `98%`.
|
||||
> When the battery is fully charged, the average `SoC` of your BMS will be sent.
|
||||
|
||||
### Solution 1
|
||||
|
||||
The simplest solution is to disable the **Charging Float Mode** switch to disable the new **SoC 100% reset logic** described below in **Solution 2**. Your BMS will simply use the **SOC 100% V.** value, and the SoC will be reset to 100% as soon as a cell reaches this value.
|
||||
|
||||

|
||||
|
||||
### Solution 2
|
||||
|
||||
The new `JK-PB` parameters `RCV` and `RCV timer` are not used by `YamBMS`, but you can adjust them to reach the `100%` faster, a little before `YamBMS` completes charging.
|
||||
|
||||
If you are instructing `YamBMS` to Bulk charge at `3.5V/cell`, configure the `JK-PB` parameters like this:
|
||||
|
||||
* JK RCV V. : `3.45V/cell`
|
||||
* JK RCV timer to `0.1` hour
|
||||
* JK SOC 100% V. : `3.449V`
|
||||
|
||||
This will reset the `SoC` to `100%` faster.
|
||||
|
||||
The `SoC` at the end of charge is easy to understand, it's the average `SoC` of your BMS, but it won't go higher than `98%` until charging is complete.
|
||||
|
||||
Then, when charging is complete before switching to `Float`, `YamBMS` will again send the average `SoC` of your BMS, which is assumed to have reached `100%`. It's up to you to ensure this is the case by configuring your BMS.
|
||||
|
||||
On the `YamBMS` side, disabling the `EOC Timer` (which will end charging after max `30min` in the `Cut-Off` phase without waiting for all `cells` to be `equalized`) will prolong charging until all your `cells` are `equalized` and the active balancer is no longer working for `60s`. This can give more time to the `JK-PB` to reset to `100%`.
|
||||
|
||||

|
||||
|
||||
|
||||
## Erase History Data
|
||||
|
||||
The procedure below allows you to unblock the **UART2 (RS485-2)** port to restore normal behavior, depending on the DIP switch value :
|
||||
* DIP switch **0** = protocol **015 - dedicated to the master BMS**
|
||||
* DIP switches **1 to 15** = protocol **001 - JK BMS RS485 Modbus V1.0**
|
||||
|
||||
| 1. Generate a JK code | 2. Erase History Data | 3. Enter the code |
|
||||
| --- | --- | --- |
|
||||
| Go to [this page](https://mirofromdiro.github.io/JK-firmware-code/) to generate a new code valid for one hour. | In the JK smartphone app, click on the **Erase History Data** function. | Enter the **generated code** and then click **Verify**. |
|
||||
| <img src="../../images/BMS_JK-PB_Erase_History_Data_1.jpg" width="300"> | <img src="../../images/BMS_JK-PB_Erase_History_Data_2.png" width="300"> | <img src="../../images/BMS_JK-PB_Erase_History_Data_3.png" width="300"> |
|
||||
@@ -1,88 +0,0 @@
|
||||
# YamBMS - JK-PB BMS RS485 Solution
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||

|
||||

|
||||

|
||||
|
||||
## External component
|
||||
|
||||
[JK_RS485](https://github.com/txubelaxu/esphome-jk-bms/blob/main/components/jk_rs485_bms/README.md) by [@txubelaxu](https://github.com/txubelaxu)
|
||||
|
||||
## Hardware
|
||||
|
||||
> [!TIP]
|
||||
> This solution only requires an ESP32 with a CAN transceiver and a RS485 transceiver.
|
||||
|
||||
You are free to choose the hardware you want, the list below are 3 easy to use examples :
|
||||
|
||||
- `AtomS3` with the isolated `Atomic CAN base` and `RS485 unit`
|
||||
- [`LilyGo T-Connect`, ESP32-S3 with 3x RS485 and 1x CAN](https://github.com/Xinyuan-LilyGO/T-Connect)
|
||||
- [`LilyGo T-CAN485`, ESP32 with 1x RS485 and 1x CAN](https://github.com/Xinyuan-LilyGO/T-CAN485)
|
||||
|
||||
See the [documentation about supported hardware](Supported_devices.md).
|
||||
|
||||
### M5Stack AtomS3 example (no welding)
|
||||
|
||||
The example below uses an `AtomS3` (display) with the `Atomic CAN base` and `RS485 unit`.
|
||||
|
||||

|
||||
|
||||
## Schematic and setup instructions
|
||||
|
||||
> [!CAUTION]
|
||||
> Galvanic isolation of the `RS485` connection is strongly recommended.
|
||||
> The diagrams below does not show the galvanic isolation of the `RS485` connection !
|
||||
|
||||
**Note:** the choice of RS485 board is not related to the chosen ESP32.
|
||||
|
||||
### AtomS3 with unisolated RS485 board
|
||||
|
||||
```
|
||||
┌──────────┐ ┌───────────┐ ┌──────────┐
|
||||
│ │ │ UART │<-VCC--------------5V--│ │<---5V
|
||||
│ BMS │ │ TO │ │ ESP32 │
|
||||
│ JK-PB │<-RJ45-P1-----B->│ RS485 │<-DI-----------TX--G1--│ Atom S3 │
|
||||
│ │<-RJ45-P2-----A->│ │--RO-----------RX--G2->│ │ ┌────────────┐ ┌────────────┐
|
||||
│ RS485 │ │ CONVERTER │<-DE--+ │ │--G5--TX-----CTX->| | | |
|
||||
│ NETWORK │ │ │<-RE--└--TALK PIN--G8--│ │<-G6--RX-----CRX--| Atomic |<---CAN H--->| Inverter |
|
||||
│ │ │ │ │ │<-------5V------->| CAN Base |<---CAN L--->| |
|
||||
| |<-RJ45-P3---GND->| |<-GND-------------GND->| |<-------GND------>| | | |
|
||||
└──────────┘ └───────────┘ └──────────┘ └────────────┘ └────────────┘
|
||||
```
|
||||
|
||||
### ESP32-S3 with isolated RS485 board
|
||||
|
||||
```
|
||||
┌──────────┐ ┌───────────┐ ┌──────────┐
|
||||
│ │ │ UART │<-V1--------3V3 or 5V--│ │<---5V
|
||||
│ BMS │ │ TO │ │ │
|
||||
│ JK-PB │<-RJ45-P1-----B->│ RS485 │<-RX-----------TX--17--│ ESP32-S3 │
|
||||
│ │<-RJ45-P2 ----A->│ │--TX-----------RX--18->│ │ ┌────────────┐ ┌────────────┐
|
||||
│ RS485 │ │ CONVERTER │ │ │--38--TX-----CTX->| | | |
|
||||
│ NETWORK │ │ │ No TALK PIN (8)--│ │<-39--RX-----CRX--| CAN |<---CAN H--->| Inverter |
|
||||
│ │ │ │ │ │<-------3V3------>| SN65HVD230 |<---CAN L--->| |
|
||||
| |<-RJ45-P3----G2->| |<-G1--------------GND->| |<-------GND------>| | | |
|
||||
└──────────┘ └───────────┘ └──────────┘ └────────────┘ └────────────┘
|
||||
```
|
||||
|
||||
- [RJ45 568A pinout](../../images/RJ45-Pinout-T568A.jpg)
|
||||
- [RJ45 568B pinout](../../images/RJ45-Pinout-T568B.jpg)
|
||||
|
||||
## BMS DIP switch config (mode 2)
|
||||
|
||||
With mode 2, the sniffer (ESP32) will automatically take the address 0x00 and act as master BMS (max 15 BMS).
|
||||
|
||||
- BMS 1 RS485 address : 0x01
|
||||
- BMS 2 RS485 address : 0x02
|
||||
- BMS 3 RS485 address : 0x03
|
||||
- etc.
|
||||
|
||||
## JK-PB RS485 functions
|
||||
|
||||
### Broadcasting JK-PB settings to all BMS
|
||||
|
||||

|
||||
|
||||
When enabled, this function synchronizes the settings of all your BMS connected to the same RS485 network as soon as you make parameter changes.
|
||||
@@ -1,4 +1,4 @@
|
||||
# YamBMS - JK-B BMS RS485 DISPLAY Solution
|
||||
# YamBMS - JK RS485 DISPLAY
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||
@@ -6,6 +6,10 @@
|
||||

|
||||

|
||||
|
||||
> [!IMPORTANT]
|
||||
> The most important thing for proper functioning of YamBMS is that **the voltage of your BMS is well calibrated**.
|
||||
> YamBMS logic is based on the `min_cell_voltage` and `max_cell_voltage` voltages of your BMS.
|
||||
|
||||
## External component
|
||||
|
||||
[esphome-jk-bms](https://github.com/syssi/esphome-jk-bms) by [@syssi](https://github.com/syssi)
|
||||
@@ -0,0 +1,112 @@
|
||||
# YamBMS - Changelog
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||

|
||||

|
||||

|
||||
|
||||
* YamBMS 1.5.8 :
|
||||
* New Dashboards `1.5.8` compatible with `CANBUS` and `RS485` inverter communication protocol
|
||||
* Added BMS `SEPLOS V3` (beta)
|
||||
* Added YamBMS `Web Server v3`
|
||||
* Added `WiFi AP`
|
||||
* `WiFi AP` and `Web Server` credentials centralized in `secrets.yaml`
|
||||
* Added `WT32-ETH01` board
|
||||
* Fixed [issue 8](https://github.com/Sleeper85/esphome-yambms/issues/8) ETH01-EVO board - Davicom DM9051 SPI Ethernet Controller is now integrated in esphome `2025.7`
|
||||
* Fixed [issue 24](https://github.com/Sleeper85/esphome-yambms/issues/24) [JK-PB] SoC never reaches 100%
|
||||
* Fixed [issue 63](https://github.com/Sleeper85/esphome-yambms/issues/63) [JK RS485 component] Fix *.*_SCHEMA deprecations
|
||||
* Merged [PR 67](https://github.com/Sleeper85/esphome-yambms/pull/67) Add options to restrict max. charge and discharge current
|
||||
* Merged [PR 72](https://github.com/Sleeper85/esphome-yambms/pull/72) Add Pylontech RS485 inverter protocol
|
||||
* Merged [PR 74](https://github.com/Sleeper85/esphome-yambms/pull/74) `PYLON RS485` link status, Heartbeat and Requested Force Charge
|
||||
* Merged [PR 75](https://github.com/Sleeper85/esphome-yambms/pull/75) Round `Auto CCL` / `Auto DCL` values
|
||||
* Merged [PR 77](https://github.com/Sleeper85/esphome-yambms/pull/77) `PYLON RS485` prevent stale data on BMS disconnect
|
||||
* Merged [PR 80](https://github.com/Sleeper85/esphome-yambms/pull/80) BMS Modbus client: Return 0 when not online
|
||||
* Merged [PR 81](https://github.com/Sleeper85/esphome-yambms/pull/81) Fix balance trigger voltage for Basen and Deye
|
||||
* YamBMS 1.5.7 :
|
||||
* Adapted the default `min/max` values for the `Float` slider
|
||||
* Merged [PR 53](https://github.com/Sleeper85/esphome-yambms/pull/53) Add feature `Auto Float Voltage`
|
||||
* New dashboard for `Auto Float Voltage` function
|
||||
* Defining `state_class` for all YamBMS sensors
|
||||
* Set esphome `min_version` to `2025.6.0`
|
||||
* Fixed: change `Charge Status` to `Bulk` when `Force Charge` is requested
|
||||
* Merged [PR 70](https://github.com/Sleeper85/esphome-yambms/pull/70) Dashboards compatible with `HA 2025.7`
|
||||
* Merged [PR 70](https://github.com/Sleeper85/esphome-yambms/pull/71) Dashboard `max/min` cell voltage in color using macro
|
||||
* Removed all special characters in entities name + dashboards correction
|
||||
* YamBMS 1.5.6 :
|
||||
* Fixed [issue 58](https://github.com/Sleeper85/esphome-yambms/issues/58) Compilation problem with `esphome 2025.5.0`
|
||||
* Fixed [issue 55](https://github.com/Sleeper85/esphome-yambms/issues/55) New CPU frequency option
|
||||
* Fixed [issue 65](https://github.com/Sleeper85/esphome-yambms/issues/65) JBD Circular dependency error
|
||||
* Fixed [issue 35](https://github.com/Sleeper85/esphome-yambms/issues/35) BMS Charging Cycles Offset
|
||||
* Merged [PR 51](https://github.com/Sleeper85/esphome-yambms/pull/51) Support for RP2040 RPi Pico
|
||||
* Merged [PR 56](https://github.com/Sleeper85/esphome-yambms/pull/56) Add support for Basengreen BMS
|
||||
* Merged [PR 60](https://github.com/Sleeper85/esphome-yambms/pull/60) Fixes for new ESPHome and add of BMS Cycle Count offset
|
||||
* Merged [PR 61](https://github.com/Sleeper85/esphome-yambms/pull/61) Set Modbus BMS values to 0 when BMS goes offline
|
||||
* New `board_ESP32-S3_Touch-LCD-4.3.yaml` board
|
||||
* New `board_ESP32-S3_Touch-LCD-7.yaml` board
|
||||
* New `board_ESP32-S3_YBoard_DJK.yaml` board
|
||||
* New `board_RP2040_RPi_Pico.yaml` board
|
||||
* YamBMS 1.5.5 :
|
||||
* New `main.yaml` with LP (local packages) and RP (remote packages) versions
|
||||
* New `board.yaml` with modular UART/CAN interfaces
|
||||
* The name of the JK `bms.yaml` is no longer linked to a specific model
|
||||
* SoC calculation is now based on remaining capacity for more accuracy (BMS only) [issues #39](https://github.com/Sleeper85/esphome-yambms/issues/39)
|
||||
* SoH calculation is moved to BMS level (for those who do not provide this information)
|
||||
* Improvement of the Victron SmartShunt doc [issues #38](https://github.com/Sleeper85/esphome-yambms/issues/38)
|
||||
* YamBMS 1.5.4 :
|
||||
* New low SoC corrected at each BMS level (the corrected SoC is the one transmitted to YamBMS)
|
||||
* New BMS dashboard
|
||||
* New end of charge logic at each BMS level, the charge switch turns off when the cells are equalized (disabled by default)
|
||||
* Fixed `errors_bitamsk` for JK-PB RS485, test OK with YamBMS (forked component)
|
||||
* YamBMS 1.5.3 :
|
||||
* Broadcasting JK-PB settings to all BMS set to OFF by default
|
||||
* Reorganizing the `board` folder and YAMLs (device_base.yaml moved to board.yaml)
|
||||
* `device_base.yaml` should no longer be part of `YamBMS_main.yaml`
|
||||
* New `RGB LED status` light effects (red, green, blue, cyan) as an `options` packages for `board.yaml`
|
||||
* Increased CPU frequency to `240Mhz` as an `options` packages for `board.yaml`
|
||||
* Added `ESP32 Generic`, `LilyGo T-CAN485`, `LilyGo T-Connect` and `XIAO` boards
|
||||
* Fixed SoC logic (low SoC will be detected at BMS level and no longer at YamBMS level)
|
||||
* Simplified combination logic (removal of the combine switch) + dashboard update
|
||||
* Check `Battery Capacity` is `> 0` before combining info (see [issue #14](https://github.com/Sleeper85/esphome-yambms/issues/14))
|
||||
* Improved alarm logic with a common `YamBMS errors bitmask` for all BMS models (see OTP vs UTP bug reported by @ChrisG)
|
||||
* Added [PR #7547](https://github.com/esphome/esphome/pull/7547) regarding publishing entities via the API
|
||||
* Removed `captive_portal` because it increases the `loop time` too much
|
||||
* `PSRAM` will no longer be enabled by default as this has a bad impact on `BLE BMS`
|
||||
* YamBMS 1.5.2 :
|
||||
* Added shunt `Online Status` binary_sensor
|
||||
* Shunt combine condition based on the new binary_sensor `Online Status`
|
||||
* Logger `baud_rate: 0` by default (frees the 3rd UART and avoids some bugs like "WK2168 with canbus" or "BLE client with RS485 modbus")
|
||||
* Changed names of `bms` and `shunt` YAMLs for modbus `multi-node` solution
|
||||
* Added shared configuration file to simplify main YAML (centralization of parameters)
|
||||
* Simplification (fewer options) when importing `BMS / Shunt` YAMLs
|
||||
* New `multi-node` solution using `RS485 modbus` to communicate information to YamBMS
|
||||
* New board `espBerry` with `2-CH-CAN HAT`
|
||||
* YamBMS 1.5.1 :
|
||||
* The conditions for `combining` BMS and the `charging` and `discharging` instructions no longer have any relation with the `errors_bitmask` sensor, the new system relies on the three **binary_sensor** `online status`, `charging allowed` and `discharging allowed` being linked to the status of alarms and switches.
|
||||
* The BMS combination procedure has been completely rewritten.
|
||||
* Improved structure and ID names of `bms.yaml`.
|
||||
* The `yambms.yaml` and `yambms_combine.yaml` global variable names have been changed for better code reading.
|
||||
* Improved code regarding the CAN bus `esp_light` status for boards without integrated LED.
|
||||
* New `Atom S3R` board and `Smartshunt BLE` shunt.
|
||||
* New `JBD`, `Seplos V1 V2`, `JK-B RS485` (display port) and `FAKE` BMS.
|
||||
* New `YamBMS DEMO` YAML and firmware offered to test and discover how `YamBMS` works.
|
||||
* New management of temperature sensors (no longer limited to two sensors).
|
||||
* **@Der_Hannes** fixed the AtomS3 `black screen` issue (with **esphome > 2024.7.3**) and developed new code for display management based on the [ili9xxx](https://esphome.io/components/display/ili9xxx.html) platform.
|
||||
* `Auto CCL/DCL` functions have been fixed to work with `JK-PB` and `new JK-B` BMS, [see this issue](https://github.com/Sleeper85/esphome-yambms/issues/11).
|
||||
* The `UVPR` and `OVPR` sensors are no longer used and replaced by `UVP` and `OVP` to ensure operation with all BMS.
|
||||
* **@txubelaxu** fixed a bug in the `JK-PB RS485` component that could cause a false battery voltage value to be sent, [see this issue](https://github.com/Sleeper85/esphome-yambms/issues/10).
|
||||
* Improved documentation, added a `HowTo` to create its main YAML, warning about galvanic isolation.
|
||||
* CANBUS 2.3.7 : If there is no response from the inverter, the time before a new communication test has been reduced from `120s` to `60s`, added Victron `0x372` nbr. of modules `blocking charge/discharge`.
|
||||
* YamBMS 1.4.5 : Changed the way to configure WiFi/Ethernet network, added `ESP32-C3 ETH01-EVO` ethernet board, reduction of the number of YAML bms files, UART `rx_buffer_size` is set to `512` by default for JK-B and JK-PB, new JK-BMS BLE sensors (last commits of @syssi) and new BLE `standard` version
|
||||
* CANBUS 2.3.6 : Sending CAN frames stops immediately if there are no combined BMS
|
||||
* YamBMS 1.4.4 : Multi-shunt support, Simplified and new YamBMS option `battery chemistry`, slider `min/max` values are automatically configured based on the battery chemistry and cell count, added `YamBMS Fallback Hotspot`, added YamBMS `Update service`, added PVbrain2 and Atom Matrix board, added PSRAM settings YAML (not enabled by default), new MIN/MAX temperature sensor, added DC current icon, fixed dual sensor `Cell UVPR (MAX)` bug, Improved `combine` code, Breaking change : Atom S3 `GPIOs 1 and 2` reversed
|
||||
* CANBUS 2.3.5 : New MIN/MAX temperature / sensor ID, Improved Victron protocol (online/offline battery modules, installed/available battery capacity)
|
||||
* CANBUS 2.3.4 : Fixed bug of canbus link validation without inverter connected
|
||||
* YamBMS 1.4.3 : Added Victron and Junctek KH-F `Shunt` support and `Requested Force Charge` function based on `SoC start/stop`, new `Total Daily Energy` sensors
|
||||
* CANBUS 2.3.3 : Added `Automatic` BMS name selection and `Requested Force Charge` Bit 3/4/5 (PYLON 0x35C)
|
||||
* CANBUS 2.3.2 : Added `LuxPower` protocol with updated `can_id` 0x355, 0x356, 0x359 and 0x35C
|
||||
* CANBUS 2.3.1 : Improved the procedure for sending canbus frames with reduced loop time, rewritten of the canbus link validation code and added `Inverter Heartbeat Monitoring` function
|
||||
* YamBMS 1.4.2 : Added new `Auto CVL Boost V.` and `Rebulk SoC` functions, new debug.yaml for ESP32 and ESP32-S3, improved code and comments
|
||||
* YamBMS 1.4.1 : Rewriting of the alarm system, bug fixes and improvement of the charging logic (new status `Cut-Off`), icon allocation for each sensor, UART and CANBUS `!extend ${vars}`, New sensor `YamBMS Delta Cell V.`, Improved `Battery SOC` logic
|
||||
* YamBMS 1.3.2 : New var `yambms_cell_count`, the BMS charge or discharge switches can be activated separately without causing the decombination of the BMS, new `minimal` version of the BMS YAML in order to reduce the loop time
|
||||
* YamBMS 1.3.1 : First multi-BMS version named `YamBMS`
|
||||
@@ -6,6 +6,9 @@
|
||||

|
||||

|
||||
|
||||
> [!NOTE]
|
||||
> Please read the documentation regarding the [charging settings](YamBMS_functions.md#charging-settings).
|
||||
|
||||
## Charging Logic Diagram
|
||||
|
||||
The charging voltage and current correspond to the default values in the YAML script and can be modified.
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# YamBMS - Schematic and setup instructions
|
||||
# YamBMS - Hardware and schematic instructions
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||
@@ -6,10 +6,14 @@
|
||||

|
||||

|
||||
|
||||
## MCU default GPIOs
|
||||
|
||||

|
||||
|
||||
## Contents
|
||||
|
||||
1) [Galvanic isolation](Galvanic_isolation.md)
|
||||
2) [JK-B BMS UART (GPS port) solution](BMS_JK-B_UART_solution.md)
|
||||
3) [JK-B BMS RS485 (Display port) solution](BMS_JK-B_RS485_DISPLAY_solution.md)
|
||||
4) [JK-PB BMS RS485 solution](BMS_JK-PB_RS485_solution.md)
|
||||
5) [Victron SmartShunt How To](Shunt_Victron_SmartShunt_HowTo.md)
|
||||
2) [JK-B BMS](BMS_JK-B.md)
|
||||
3) [JK-PB BMS](BMS_JK-PB.md)
|
||||
4) [JK RS485 DISPLAY](BMS_JK_RS485_DISPLAY.md)
|
||||
5) [Victron SmartShunt](Shunt_Victron_SmartShunt.md)
|
||||
@@ -6,11 +6,57 @@
|
||||

|
||||

|
||||
|
||||
## Installation procedure
|
||||
## Make your YAML
|
||||
|
||||
> [!TIP]
|
||||
> Not sure which YAML to choose ? ... [YamBMS_Remote_Packages_example.yaml](../../YamBMS_Remote_Packages_example.yaml)
|
||||
> is a good basis for creating your custom YAML.
|
||||
> Examples of `BMS` and `Shunt` packages can be found in the [examples](../../examples/single-node/) folder.
|
||||
> You don't have to import a shunt but you must import at least `one BMS`.
|
||||
> You can mix different `BMS` models, the only condition is that the `bms_id` are numbered in order starting from `1` !
|
||||
|
||||
* [YamBMS LP (Local Packages) HowTo](YamBMS_LP_YAML.md)
|
||||
* [YamBMS RP (Remote Packages) HowTo](YamBMS_RP_YAML.md)
|
||||
|
||||
## Installation from the `ESPHome Builder` add-on of your `Home Assistant` server
|
||||
|
||||
> [!TIP]
|
||||
> This method is the easiest for beginners.
|
||||
|
||||
**Prerequisites:** install the `ESPHome Builder` add-on in your `Home Assistant` server.
|
||||
|
||||

|
||||
|
||||
### 1. Enter your WiFi credentials in the `SECRETS` YAML in the top right corner
|
||||
|
||||
```YAML
|
||||
wifi_ssid: YourSSID
|
||||
wifi_password: YourPassword
|
||||
domain : .local
|
||||
```
|
||||
|
||||
### 2. Add your `ESP32` by clicking on `+ NEW DEVICE` at the bottom right
|
||||
|
||||
Follow the procedure displayed on the screen.
|
||||
|
||||
### 3. `EDIT` your newly added ESP32 and copy your `YamBMS RP` YAML
|
||||
|
||||
> [!IMPORTANT]
|
||||
> If your ESP32 already contains `API` or `OTA` keys, don't forget to add them to your YAML.
|
||||
|
||||
### 4. Install your YAML `Wirelessly` or via `USB` port
|
||||
|
||||
Follow the procedure displayed on the screen.
|
||||
|
||||
### 5. Optional but recommended, add the ESP32 in your `Home Assistant` server
|
||||
|
||||
In Home Assistant under **" Settings > Devices and services > Add Intergration "** select ESPHome add device `yambms` if found or supply ip address of ESP32.
|
||||
|
||||
## Installation from a Windows, Mac or Linux computer
|
||||
|
||||
### 1. Install ESPHome on your computer
|
||||
|
||||
Before you can flash your ESP32 you need to install the [ESPHome 2024.6.0 or higher](https://github.com/esphome/esphome/releases) command line application.<br>
|
||||
Before you can flash your ESP32 you need to install the [ESPHome 2025.6.0 or higher](https://github.com/esphome/esphome/releases) command line application.<br>
|
||||
[Follow these instructions for installation on Windows, Mac or Linux.](https://esphome.io/guides/installing_esphome)
|
||||
|
||||
> [!TIP]
|
||||
@@ -24,13 +70,16 @@ pip3 install esphome
|
||||
|
||||
### 2. Download all YAML files to your computer
|
||||
|
||||
> [!TIP]
|
||||
> The `packages` folder is not necessary if you are compiling the `Remote Packages` version of the YAML.
|
||||
|
||||
You can do this from the command line or in your preferred method.
|
||||
|
||||
You need to gather the following three points in the same folder. If you are compiling from your HA server use the `Samba Share` add-on so that you can copy the `packages` folder to the `esphome` folder on the HA server.
|
||||
|
||||
1) the `packages` folder
|
||||
1) the `packages` folder (not necessary with `RP` YAMLs)
|
||||
2) your `secrets.yaml`
|
||||
3) your [custom](YamBMS_main_YAML_HowTo.md) `main.yaml`
|
||||
3) your custom `main.yaml`
|
||||
|
||||
```bash
|
||||
# Clone this external component
|
||||
@@ -38,7 +87,7 @@ git clone https://github.com/Sleeper85/esphome-yambms.git
|
||||
cd esphome-yambms
|
||||
```
|
||||
|
||||
### 3. Enter your WiFi credentials in the secrets.yaml files
|
||||
### 3. Enter your WiFi credentials in the `secrets.yaml` files
|
||||
|
||||
```yaml
|
||||
wifi_ssid: YourSSID
|
||||
@@ -46,28 +95,18 @@ wifi_password: YourPassword
|
||||
domain : .local
|
||||
```
|
||||
|
||||
### 4. Install the YamBMS application into your ESP32
|
||||
|
||||
Choose the main YAML that best suits your needs like for example `multi-bms_JK-ALL_BLE.yaml`.<br>
|
||||
Validate the configuration, create a binary, upload it, and start logs.<br>
|
||||
**The only YAML that needs to be checked and configured is the main one like for example `multi-bms_JK-ALL_BLE.yaml` but you can modify other YAMLs if you want.<br>
|
||||
The goal is that the main YAML which contains all your specific parameters can be preserved and reused each time the other YAMLs classified in the `packaged` folder are updated.**
|
||||
### 4. Install the `YamBMS.yaml` into your ESP32
|
||||
|
||||
```bash
|
||||
# To install the multi-bms JK-ALL Bluetooth version
|
||||
esphome run multi-bms_JK-ALL_BLE.yaml
|
||||
|
||||
# To install the multi-bms JK-B UART version
|
||||
esphome run multi-bms_JK-B_UART.yaml
|
||||
|
||||
# To install the multi-bms JK-PB RS485 version
|
||||
esphome run multi-bms_JK-PB_RS485_mode2.yaml
|
||||
# install your YamBMS.yaml
|
||||
# validate the configuration, create a binary, upload it, and start logs.
|
||||
esphome run YamBMS.yaml
|
||||
|
||||
# upgrade via OTA by specifying the IP address of the ESP32
|
||||
esphome run multi-bms_JK-ALL_BLE.yaml --device 192.168.x.x
|
||||
esphome run YamBMS.yaml --device 192.168.x.x
|
||||
```
|
||||
|
||||
### 5. Optional but recommended, add the ESP32 in your Home Assistant server
|
||||
### 5. Optional but recommended, add the ESP32 in your `Home Assistant` server
|
||||
|
||||
In Home Assistant under **" Settings > Devices and services > Add Intergration "** select ESPHome add device `yambms` if found or supply ip address of ESP32.
|
||||
|
||||
@@ -75,35 +114,26 @@ In Home Assistant under **" Settings > Devices and services > Add Intergration "
|
||||
|
||||
```bash
|
||||
# clean files before compiling again
|
||||
esphome clean multi-bms_JK-ALL_BLE.yaml
|
||||
esphome clean YamBMS.yaml
|
||||
|
||||
# test the config
|
||||
esphome config multi-bms_JK-ALL_BLE.yaml
|
||||
esphome config YamBMS.yaml
|
||||
|
||||
# install the config in ESP32
|
||||
esphome run multi-bms_JK-ALL_BLE.yaml
|
||||
esphome run YamBMS.yaml
|
||||
|
||||
# compile the firmware.bin
|
||||
esphome compile multi-bms_JK-ALL_BLE.yaml
|
||||
esphome compile YamBMS.yaml
|
||||
|
||||
# check the logs (the --device option is not required)
|
||||
esphome logs multi-bms_JK-ALL_BLE.yaml --device 192.168.x.x
|
||||
esphome logs YamBMS.yaml --device 192.168.x.x
|
||||
```
|
||||
|
||||
## Debugging
|
||||
|
||||
If this component doesn't work out of the box for your device please update your configuration to enable the debug output of the UART component and increase the log level to the see outgoing and incoming serial traffic:
|
||||
If this component doesn't work out of the box for your device please update your configuration to increase the log level to `DEBUG`.
|
||||
|
||||
```
|
||||
```YAML
|
||||
logger:
|
||||
level: DEBUG
|
||||
|
||||
uart:
|
||||
id: uart_0
|
||||
baud_rate: 115200
|
||||
rx_buffer_size: 384
|
||||
tx_pin: ${tx_pin}
|
||||
rx_pin: ${rx_pin}
|
||||
debug:
|
||||
direction: BOTH
|
||||
```
|
||||
@@ -1,4 +1,4 @@
|
||||
# Victron SmartShunt How To
|
||||
# Victron SmartShunt
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||
@@ -44,6 +44,9 @@ To connect to your Victron device with BLE component you must have two informati
|
||||
|
||||
Use [VictronConnect App v5.93](https://www.victronenergy.com/live/victronconnect:beta) (or later) released on 2023-08-25.
|
||||
|
||||
Connect to the SmartShunt via Bluetooth under the `Local` tab.
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||
@@ -8,10 +8,11 @@
|
||||
|
||||
## Supported BMS
|
||||
|
||||
* All `JK-B` BMS models with software version `>=6.0`, see [esphome-jk-bms](https://github.com/syssi/esphome-jk-bms)
|
||||
* `JK-PB` BMS, see [esphome-jk-bms](https://github.com/txubelaxu/esphome-jk-bms/)
|
||||
* `JBD` BMS, see [esphome-jbd-bms](https://github.com/syssi/esphome-jbd-bms)
|
||||
* `Seplos V1 V2` BMS, see [esphome-seplos-bms](https://github.com/syssi/esphome-seplos-bms)
|
||||
* `JK` BMS (BLE / UART / RS485)
|
||||
* `JBD` BMS (BLE / UART)
|
||||
* `Seplos V1 V2 V3` BMS (RS485)
|
||||
* `BASEN` BMS (RS485)
|
||||
* `DEYE` BMS (CAN)
|
||||
|
||||
**Note: other BMS brands already integrated with ESPhome can be added easily.**
|
||||
|
||||
@@ -19,7 +20,7 @@
|
||||
|
||||
* `Victron Smartshunt` (UART)
|
||||
* `Victron Smartshunt` (BLE)
|
||||
* `Junctek KH-F` (UART/RS485)
|
||||
* `Junctek KH-F` (UART / RS485)
|
||||
|
||||
**Note: other Shunt brands already integrated with ESPhome can be added easily.**
|
||||
|
||||
@@ -35,13 +36,17 @@
|
||||
| --- | --- | --- |
|
||||
| <img src="../../images/MCU_AtomS3_Lite.png" width="300"> | <img src="../../images/MCU_AtomS3.png" width="300"> | <img src="../../images/MCU_AtomS3R.png" width="300"> |
|
||||
|
||||
| [LilyGo T-CAN485 (ESP32)](https://github.com/Xinyuan-LilyGO/T-CAN485) | [LilyGo T-Connect (ESP32-S3)](https://github.com/Xinyuan-LilyGO/T-Connect) | [Waveshare ESP32-S3-RS485-CAN](https://www.waveshare.com/esp32-s3-rs485-can.htm) |
|
||||
| --- | --- | --- |
|
||||
| <img src="../../images/MCU_ESP32_LilyGo-T-CAN485.jpg" width="300"> | <img src="../../images/MCU_ESP32-S3_LilyGo-T-Connect.jpg" width="300"> | <img src="../../images/MCU_ESP32-S3_WS-RS485-CAN.png" width="300"> |
|
||||
|
||||
| [ESP32 DevKit-V1](https://a.aliexpress.com/_EG12CJ2) | [ESP32-S3 DevKitC-1](https://a.aliexpress.com/_EzFdrw3) | [ESP32-C3 ETH01-EVO](https://a.aliexpress.com/_Ey29fog) |
|
||||
| --- | --- | --- |
|
||||
| <img src="../../images/MCU_ESP32-DevKit-V1.jpg" width="300"> | <img src="../../images/MCU_ESP32-S3-DevKitC-1.png" width="300"> | <img src="../../images/MCU_ESP32-C3_ETH01-EVO.png" width="300"> |
|
||||
|
||||
| [espBerry + Waveshare 2-CH CAN HAT](https://copperhilltech.com/esp32-development-board-with-dual-isolated-can-bus-hat/) | [LilyGo T-CAN485 (ESP32)](https://github.com/Xinyuan-LilyGO/T-CAN485) | [LilyGo T-Connect (ESP32-S3)](https://github.com/Xinyuan-LilyGO/T-Connect) |
|
||||
| --- | --- | --- |
|
||||
| <img src="../../images/MCU_ESP32-DevKitC_espBerry_2-CH-CAN.png" width="300"> | <img src="../../images/MCU_ESP32_LilyGo-T-CAN485.jpg" width="300"> | <img src="../../images/MCU_ESP32-S3_LilyGo-T-Connect.jpg" width="300"> |
|
||||
| [Olimex ESP32-EVB](https://github.com/OLIMEX/ESP32-EVB) | [espBerry + Waveshare 2-CH CAN HAT](https://copperhilltech.com/esp32-development-board-with-dual-isolated-can-bus-hat/) |
|
||||
| --- | --- |
|
||||
| <img src="../../images/MCU_ESP32-EVB.jpg" width="300">| <img src="../../images/MCU_ESP32-DevKitC_espBerry_2-CH-CAN.png" width="300"> |
|
||||
|
||||
## Supported CAN bus transceiver
|
||||
|
||||
@@ -100,9 +105,12 @@ The following are confirmed and known to work:
|
||||
| LuxPower | LXP-LB-US 10K | Working | [@Henny101](https://diysolarforum.com/members/henny101.67026/) | Lithium 6 | JK-PB (2) | RS485 | ESP32-S3 DevKitC-1 | Automatic | LuxPower | SN65HVD230 | [Isolated RS485 (high speed dual)](https://a.aliexpress.com/_EueIZT5) | yes | --- |
|
||||
| EG4 | 6000XP | Working | [@ChrisG](https://diysolarforum.com/members/chrisg.483/) | Lithium 2 | JK-B (2) | BLE | ESP32 DevKit V1 / ESP32-S3 DevKitC-1 | PYLON | PYLON 1.2 | MCP2515 | --- | yes | --- |
|
||||
| EG4 | 6000XP (2) | Working | [@SGB](https://diysolarforum.com/members/scrotpusgobblebottom.100804/) | Lithium 6 | JK-B (1) JK-PB (1) | BLE | Atom S3 (display) | Automatic | LuxPower | [Atomic CAN base (SKU:A103)](https://docs.m5stack.com/en/atom/Atomic%20CAN%20Base) | --- | yes | --- |
|
||||
| EG4 | 12000XP | Working | [@andrewfraley](https://github.com/andrewfraley) | Lithium 6 | JBD | RS485 | LilyGo T-CAN485 | Automatic | LuxPower | T-CAN485 (SN65HVD231DR) | T-CAN485 (MAX13487E) | no | set UART baud to 9600 |
|
||||
| EG4 | 18kPV | Working | [@Maintman](https://diysolarforum.com/members/maintman.19007/) | Lithium 6 | JK-B | BLE | ESP32 DevKit V1 | Automatic | LuxPower | MCP2515 | --- | yes | Connected via Bluetooth to Victron SmartShunt. |
|
||||
| Victron | MultiPlus-II 48/10000/140 | Working | [@cali-clim](https://diysolarforum.com/members/cali-clim.54284/) | CAN-bus BMS LV (500 kbit/s) | JK-PB (2) | RS485 | Atom S3 (display) | Automatic | Victron | [Atomic CAN base (SKU:A103)](https://docs.m5stack.com/en/atom/Atomic%20CAN%20Base) | [Isolated RS485 Unit (SKU:U094)](https://docs.m5stack.com/en/unit/iso485) | yes | --- |
|
||||
| Victron | MultiPlus-II 48/10000/140 | Working | [@20after4](https://github.com/20after4) | CAN-bus BMS LV (500 kbit/s) | JBD-BMS (2) | BLE | Olimex ESP32-EVB | Automatic | Victron | SIT1050T (Integrated) | --- | yes | Works well with the integrated Ethernet and CANBus hardware |
|
||||
| Victron | Multiplus 24/1200/25-16 | Working | [@dmsims](https://diysolarforum.com/members/dmsims.23417/) | CAN-bus BMS LV (500 kbit/s) | JK-B (1) | BLE | Atom S3 Lite | Automatic | Victron | [Atomic CAN base (SKU:A103)](https://docs.m5stack.com/en/atom/Atomic%20CAN%20Base) | --- | no | Plugged into Cerbo Can port (must use supplied Victron terminator in the other port) |
|
||||
| MidNite Solar | MN15-12KW-AIO | Working | [@goldserve](https://diysolarforum.com/members/goldserve.52541/) | PYLON | JK-B | BLE | ESP32-S3 | Automatic | PYLON 1.2 | MCP2515 | --- | no | Stable with Victron Smartshunt, MQTT, BLE, Neopixel LED, Display also working. |
|
||||
| MidNite Solar | MN15-12KW-AIO | Working | [@jahyde](https://diysolarforum.com/members/jahyde.7475/) | PYLON | JK-PB | BLE | ESP32-S3 | Automatic | PYLON 1.2 | MCP2515 | --- | yes | --- |
|
||||
| SMA | Sunny Island | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| SRNE | HESP48120U200-H | Working | [@ogremustcrush](https://diysolarforum.com/members/ogremustcrush.116979/) | UZE | JK-PB | RS485 | Atom S3 Lite | Automtic | PYLON V2 | [Atomic CAN Base (SKU:A103)](https://docs.m5stack.com/en/atom/Atomic%20CAN%20Base) | [Isolated RS485 Unit (SKU:U094)](https://docs.m5stack.com/en/unit/iso485) | Yes | Most of the YamBMS PYLON based protocols show same results on inverter. Inverter itself does not work when it is set to PYLON protocol, but UZE works. Incorrect temp reported on inverter |
|
||||
@@ -1,4 +1,4 @@
|
||||
# YamBMS - How to create your YamBMS YAML
|
||||
# YamBMS - How to create your YamBMS Local Packages YAML
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||
@@ -6,6 +6,13 @@
|
||||

|
||||

|
||||
|
||||
> [!TIP]
|
||||
> Not sure which YAML to choose ? ... [YamBMS_Remote_Packages_example.yaml](../../YamBMS_Remote_Packages_example.yaml)
|
||||
> is a good basis for creating your custom YAML.
|
||||
> Examples of `BMS` and `Shunt` packages can be found in the [examples](../../examples/single-node/) folder.
|
||||
> You don't have to import a shunt but you must import at least `one BMS`.
|
||||
> You can mix different `BMS` models, the only condition is that the `bms_id` are numbered in order starting from `1` !
|
||||
|
||||
> [!IMPORTANT]
|
||||
> BMS monitoring with `Bluetooth` as well as the `Web server` are RAM-intensive components.
|
||||
> Please note that enabling these components will take up a lot of memory and may decrease the stability of your ESP32.
|
||||
@@ -67,7 +74,7 @@ If you don't use `Home Assistant`, you can activate the `Web Server` and have ac
|
||||
|
||||
[ESPHome Web Server Component](https://esphome.io/components/web_server.html)
|
||||
|
||||
## Importing YamBMS packages
|
||||
## Importing YamBMS Local Packages
|
||||
|
||||
Package imports are done below this line:
|
||||
|
||||
@@ -154,9 +161,6 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
## YamBMS single-node example
|
||||
|
||||
```YAML
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
|
||||
shunt1: !include
|
||||
file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml
|
||||
vars:
|
||||
@@ -166,7 +170,7 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
# ...
|
||||
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-B_UART_full.yaml
|
||||
file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
@@ -190,10 +194,6 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
### YamBMS modbus client `node1`
|
||||
|
||||
```YAML
|
||||
# Config : this YAMLs contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
config_multinode_modbus: !include packages/config/config_multi-node_modbus.yaml
|
||||
|
||||
modbus: !include
|
||||
file: packages/base/device_modbus.yaml
|
||||
vars:
|
||||
@@ -228,10 +228,6 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
### ESP32 modbus server `node2`
|
||||
|
||||
```YAML
|
||||
# Config : this YAMLs contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
config_multinode_modbus: !include packages/config/config_multi-node_modbus.yaml
|
||||
|
||||
modbus: !include
|
||||
file: packages/base/device_modbus.yaml
|
||||
vars:
|
||||
@@ -247,7 +243,7 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
# ...
|
||||
|
||||
bms1: !include
|
||||
file: packages/bms/bms_modbus_JK-B_UART_full.yaml
|
||||
file: packages/bms/bms_modbus_JK_UART_4G-GPS_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number, also represents the modbus server number !
|
||||
bms_name: 'BMS 1'
|
||||
@@ -258,10 +254,6 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
### ESP32 modbus server `node3`
|
||||
|
||||
```YAML
|
||||
# Config : this YAMLs contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
config_multinode_modbus: !include packages/config/config_multi-node_modbus.yaml
|
||||
|
||||
modbus: !include
|
||||
file: packages/base/device_modbus.yaml
|
||||
vars:
|
||||
@@ -269,7 +261,7 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
modbus_uart_id: 'uart_esp_1' # RS485 board
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_modbus_JK-ALL_BLE_standard.yaml
|
||||
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: 'BMS 2'
|
||||
@@ -277,7 +269,7 @@ This board has an `Ethernet` port and can be powered from `POE` (optional).
|
||||
# ...
|
||||
|
||||
bms3: !include
|
||||
file: packages/bms/bms_modbus_JK-ALL_BLE_standard.yaml
|
||||
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: 'BMS 3'
|
||||
@@ -299,182 +291,7 @@ There are other `bms.yaml` not mentioned here, see in the [bms](../../packages/b
|
||||
|
||||
The `full` / `standard` versions contain all available sensors while the `minimal` version contains the basic sensors without the voltages of each cell and other superfluous sensors.
|
||||
|
||||
### [JK-ALL (BLE)](https://github.com/syssi/esphome-jk-bms)
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The BLE software stack on the ESP32 consumes a significant amount of RAM on the device.
|
||||
> Crashes are likely to occur if you include too many additional components in your device’s configuration.
|
||||
> I recommend using `UART` or `RS485` if possible.
|
||||
|
||||
```YAML
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-ALL_BLE_standard.yaml # bms_modbus_JK-ALL_BLE_standard.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: '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' # Your MAC address
|
||||
```
|
||||
|
||||
### [JK-B (UART)](https://github.com/syssi/esphome-jk-bms)
|
||||
|
||||
[How to make the UART connection with the ESP32.](BMS_JK-B_UART_solution.md)
|
||||
|
||||
```YAML
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-B_UART_full.yaml # bms_modbus_JK-B_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
bms_uart_id: 'uart_esp_1'
|
||||
```
|
||||
|
||||
### [JK-B (RS485 DISPLAY)](https://github.com/syssi/esphome-jk-bms)
|
||||
|
||||
> [!CAUTION]
|
||||
> The `jk_bms_display` component does not provide all the information needed for an optimal operation of `YamBMS`.
|
||||
> The missing information has been added in the code by fixed values.
|
||||
> e.g. it's not possible to know if the BMS is `online` or if the BMS is `equalizing` the cells.
|
||||
|
||||
[How to make the RS485 connection with the ESP32.](BMS_JK-B_RS485_DISPLAY_solution.md)
|
||||
|
||||
```YAML
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-B_RS485_DISPLAY_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
bms_uart_id: 'uart_esp_1'
|
||||
# Required settings cannot be retrieved from BMS
|
||||
# These values must match your BMS settings
|
||||
# LFP values example
|
||||
bms_battery_capacity: '280' # Ah
|
||||
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
|
||||
```
|
||||
|
||||
### [JK-PB (RS485)](https://github.com/txubelaxu/esphome-jk-bms/)
|
||||
|
||||
A single `RS485 bus` allows you to monitor up to `16` BMS.
|
||||
|
||||
[How to make the RS485 connection with the ESP32.](BMS_JK-PB_RS485_solution.md)
|
||||
|
||||
#### JK-PB sniffer
|
||||
|
||||
> [!IMPORTANT]
|
||||
> You need to import only one `sniffer` package of your choice.
|
||||
> Depending on which `RS485` board you have, you should use the version of the `sniffer` with or without `talk_pin`.
|
||||
|
||||
The sniffer represents the ESP node connected to the JK-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).
|
||||
|
||||
Sniffer without `talk_pin` :
|
||||
|
||||
```YAML
|
||||
sniffer1: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_sniffer.yaml
|
||||
vars:
|
||||
sniffer_id: 'sniffer1'
|
||||
sniffer_protocol: 'JK02_32S'
|
||||
sniffer_uart_id: 'uart_esp_1'
|
||||
```
|
||||
|
||||
If your `RS485` board requires a `talk_pin` you must specify which `GPIO` will be used :
|
||||
|
||||
```YAML
|
||||
sniffer1: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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
|
||||
```
|
||||
|
||||
#### JK-PB BMS
|
||||
|
||||
```YAML
|
||||
# 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-PB_RS485_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: '0x01' # BMS 1 DIP switch
|
||||
```
|
||||
|
||||
### [JBD (UART)](https://github.com/syssi/esphome-jbd-bms)
|
||||
|
||||
```YAML
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JBD_UART_full.yaml # bms_modbus_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
|
||||
```
|
||||
|
||||
### [Seplos V1/V2 (RS485)](https://github.com/syssi/esphome-seplos-bms)
|
||||
|
||||
A single `RS485 bus` allows you to monitor up to `16` BMS.
|
||||
|
||||
> [!CAUTION]
|
||||
> The `seplos_bms` component does not provide all the information needed for an optimal operation of `YamBMS`.
|
||||
> The missing information has been added in the code by fixed values.
|
||||
> e.g. it's not possible to know if the BMS **blocks** the `charge` or the `discharge` or if the BMS is `equalizing` the cells.
|
||||
> The `online` status has not been tested.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> You need to import only one `seplos_modbus`.
|
||||
|
||||
#### Seplos modbus
|
||||
|
||||
```YAML
|
||||
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'
|
||||
```
|
||||
|
||||
#### Seplos V1/V2 BMS
|
||||
|
||||
```YAML
|
||||
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
|
||||
```
|
||||
You can find `BMS` import `LP` examples in the [examples/single-node](../../examples/single-node/) folder.
|
||||
|
||||
## Shunt
|
||||
|
||||
@@ -486,49 +303,7 @@ A single `RS485 bus` allows you to monitor up to `16` BMS.
|
||||
|
||||
As soon as you import a `Shunt` and it can be combined ([see condition](YamBMS_behavior.md#shunt)) the values `Voltage`, `Current`, `Power` and `SoC` of the shunt(s) will take precedence over the BMS values.
|
||||
|
||||
|
||||
### [Victron Smartshunt (UART)](https://github.com/KinDR007/VictronMPPT-ESPHOME)
|
||||
|
||||
[How to make the UART connection with the ESP32.](Shunt_Victron_SmartShunt_HowTo.md)
|
||||
|
||||
```YAML
|
||||
shunt1: !include
|
||||
file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml # shunt_modbus_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)](https://github.com/Fabian-Schmidt/esphome-victron_ble)
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The BLE software stack on the ESP32 consumes a significant amount of RAM on the device.
|
||||
> Crashes are likely to occur if you include too many additional components in your device’s configuration.
|
||||
> I recommend using `UART` or `RS485` if possible.
|
||||
|
||||
[How to make the BLE connection with the ESP32.](Shunt_Victron_SmartShunt_HowTo.md)
|
||||
|
||||
```YAML
|
||||
shunt1: !include
|
||||
file: packages/shunt/shunt_combine_Victron_SmartShunt_BLE.yaml # shunt_modbus_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
|
||||
```
|
||||
|
||||
### [Junctek KH-F (UART/RS485)](https://github.com/Sleeper85/esphome-junctek_khf)
|
||||
|
||||
```YAML
|
||||
shunt1: !include
|
||||
file: packages/shunt/shunt_combine_Junctek_KHF_UART.yaml # shunt_modbus_Junctek_KHF_UART.yaml
|
||||
vars:
|
||||
shunt_id: '1' # must be a number
|
||||
shunt_name: 'Shunt 1'
|
||||
shunt_uart_id: 'uart_esp_1'
|
||||
```
|
||||
You can find `Shunt` import `LP` examples in the [examples/single-node](../../examples/single-node/) folder.
|
||||
|
||||
## YamBMS
|
||||
|
||||
@@ -545,6 +320,8 @@ Take the time to configure `YamBMS` correctly according to your battery chemistr
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# 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'
|
||||
@@ -566,17 +343,21 @@ Take the time to configure `YamBMS` correctly according to your battery chemistr
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
```
|
||||
|
||||
## CAN bus
|
||||
## CAN bus to Inverter
|
||||
|
||||
> [!TIP]
|
||||
> This package is only used with the `YamBMS` main node.
|
||||
> It's possible to use this package multiple times in order to send information on two different CAN bus.
|
||||
> It's possible to use this package multiple times in order to send information on two different `CAN` bus.
|
||||
|
||||
The CAN bus connected to your inverter via the CAN transceiver `canbus_node1`.
|
||||
You can keep the default configuration and adapt the `canbus` node on which the component must connect.
|
||||
|
||||
You can keep the default configuration.
|
||||
|
||||
@@ -587,32 +368,42 @@ You can keep the default configuration.
|
||||
# CANBUS vars
|
||||
canbus_id: 'canbus1'
|
||||
canbus_name: 'CANBUS 1'
|
||||
canbus_node_id: 'canbus_node1'
|
||||
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'
|
||||
```
|
||||
|
||||
# RS485 bus to Inverter
|
||||
|
||||
> [!TIP]
|
||||
> This package is only used with the `YamBMS` main node.
|
||||
> It's possible to use this package multiple times in order to send information on two different `RS485` bus.
|
||||
|
||||
The RS485 bus connected to your inverter via the RS485 transceiver `uart_esp_3`.
|
||||
|
||||
You can keep the default configuration and adapt the `uart` port on which the component must connect.
|
||||
|
||||
```YAML
|
||||
rs485_pylon: !include
|
||||
file: packages/yambms/yambms_rs485_pylon.yaml
|
||||
vars:
|
||||
rs485_id: 'rs485_1'
|
||||
rs485_name: 'RS485 1'
|
||||
rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
rs485_uart_baud_rate: '9600'
|
||||
rs485_update_timeout: '5s'
|
||||
```
|
||||
|
||||
## Debug
|
||||
|
||||
The `debug` package will add useful information to refer to if problems occur.
|
||||
|
||||
### ESP32 and AtomS3
|
||||
|
||||
```YAML
|
||||
device_debug: !include
|
||||
file: packages/base/device_debug_ESP32.yaml
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
```
|
||||
|
||||
### ESP32 with PSRAM memory like ESP32-S3 / AtomS3R
|
||||
|
||||
```YAML
|
||||
device_debug: !include
|
||||
file: packages/base/device_debug_ESP32-S3.yaml
|
||||
# file: packages/base/device_debug_ESP32_PSRAM.yaml # for ESP32 with PSRAM
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
@@ -0,0 +1,421 @@
|
||||
# YamBMS - How to create your YamBMS Remote Packages YAML
|
||||
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
[](https://github.com/Sleeper85/esphome-yambms/releases/latest)
|
||||

|
||||

|
||||

|
||||
|
||||
> [!TIP]
|
||||
> Not sure which YAML to choose ? ... [YamBMS_Remote_Packages_example.yaml](../../YamBMS_Remote_Packages_example.yaml)
|
||||
> is a good basis for creating your custom YAML.
|
||||
> Examples of `BMS` and `Shunt` packages can be found in the [examples](../../examples/single-node/) folder.
|
||||
> You don't have to import a shunt but you must import at least `one BMS`.
|
||||
> You can mix different `BMS` models, the only condition is that the `bms_id` are numbered in order starting from `1` !
|
||||
|
||||
> [!IMPORTANT]
|
||||
> BMS monitoring with `Bluetooth` as well as the `Web server` are RAM-intensive components.
|
||||
> Please note that enabling these components will take up a lot of memory and may decrease the stability of your ESP32.
|
||||
|
||||
## WiFi & Ethernet
|
||||
|
||||
> [!IMPORTANT]
|
||||
> By default, if the ESP32 is disconnected from the WiFi network it will reboot `every 15 minutes` to try to resolve the problem.
|
||||
> The `wifi` or `ethernet` components are found in the [YAML corresponding to the board](../../packages/board/).
|
||||
|
||||
Configuring a fixed IP address can be done in the main YAML like this:
|
||||
|
||||
### WiFi
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Don't forget to configure your WiFi credentials in the `secrets.yaml` file.
|
||||
|
||||
```YAML
|
||||
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
|
||||
```
|
||||
|
||||
### Ethernet
|
||||
|
||||
```YAML
|
||||
ethernet:
|
||||
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
|
||||
```
|
||||
|
||||
## Home Assistant API
|
||||
|
||||
> [!IMPORTANT]
|
||||
> If your ESP32 is not connected with Home Assistant it will reboot every 15 minutes.
|
||||
> This is the normal behavior of ESPHome, this is not a bug to be resolved but a mechanism put in place by the ESPHome team to correct a possible problem with the API connection.
|
||||
|
||||
The **"api:"** section is therefore configured by default not to reboot every 15 minutes if `Home Assistant` is not connected.
|
||||
|
||||
```YAML
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
```
|
||||
|
||||
## Web Server
|
||||
|
||||
> [!IMPORTANT]
|
||||
> 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.
|
||||
|
||||
If you don't use `Home Assistant`, you can activate the `Web Server` and have access to YamBMS information and also interact with the application.
|
||||
|
||||
[ESPHome Web Server Component](https://esphome.io/components/web_server.html)
|
||||
|
||||
## Importing YamBMS Remote Packages
|
||||
|
||||
Package imports are done below this line:
|
||||
|
||||
```YAML
|
||||
packages:
|
||||
```
|
||||
|
||||
Each remote package starts with the 5 first lines below.
|
||||
These lines will not be shown in the examples.
|
||||
You can import multiple remote packages (3 in this example) without having to repeat the first 5 lines.
|
||||
|
||||
```YAML
|
||||
remote_packages:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'your_remote_packages_1.yaml'
|
||||
- path: 'your_remote_packages_2.yaml'
|
||||
- path: 'your_remote_packages_3.yaml'
|
||||
```
|
||||
|
||||
## Board
|
||||
|
||||
First you need to import the package that corresponds to the `board` you are going to use.
|
||||
|
||||
There are other `board.yaml` not mentioned here, see in the [board](../../packages/board/) folder.
|
||||
|
||||
So just one of the packages below :
|
||||
|
||||
### ESP32 Generic
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32_Generic.yaml'
|
||||
```
|
||||
|
||||
### ESP32 DevKit-V1
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32_DevKit-V1.yaml'
|
||||
```
|
||||
|
||||
### ESP32-S3 DevKitC-1
|
||||
|
||||
```YAML
|
||||
# RGB LED to GPIO 38
|
||||
- path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-38.yaml'
|
||||
```
|
||||
|
||||
```YAML
|
||||
# RGB LED to GPIO 48
|
||||
- path: 'packages/board/board_ESP32-S3_DevKitC-1_LED-48.yaml'
|
||||
```
|
||||
|
||||
### ESP32-S3 LilyGo T-Connect
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect.yaml'
|
||||
```
|
||||
|
||||
### Atom S3 Lite
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32-S3_AtomS3-Lite.yaml'
|
||||
```
|
||||
|
||||
### Atom S3 / S3R (display)
|
||||
|
||||
In this case you need to specify the `yambms` and `canbus` IDs to display the information on the screen.
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32-S3_AtomS3.yaml'
|
||||
vars:
|
||||
display_auto_next_page_interval: '5s'
|
||||
display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
```
|
||||
|
||||
```YAML
|
||||
- path: 'packages/board/board_ESP32-S3_AtomS3R.yaml'
|
||||
vars:
|
||||
display_auto_next_page_interval: '5s'
|
||||
display_rotation: '0' # 0/90/180/270 rotation angle in degrees
|
||||
```
|
||||
|
||||
## YamBMS [single-node](../../examples/single-node/) example
|
||||
|
||||
```YAML
|
||||
# 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'
|
||||
|
||||
# BMS 1
|
||||
- path: 'packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml'
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
- # other settings
|
||||
# ...
|
||||
|
||||
# BMS 2
|
||||
- path: 'packages/bms/bms_combine_JBD_BLE_full.yaml'
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'BMS 2'
|
||||
# other settings
|
||||
# ...
|
||||
```
|
||||
|
||||
## YamBMS [multi-node](../../examples/multi-node/) RS485 modbus example
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The BMS/Shunt IDs of the `modbus client` must match exactly with the BMS/Shunt IDs of the `modbus server` as in the example below.
|
||||
|
||||
### YamBMS modbus client `node1`
|
||||
|
||||
```YAML
|
||||
# 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'
|
||||
```
|
||||
|
||||
### ESP32 modbus server `node2`
|
||||
|
||||
```YAML
|
||||
# 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'
|
||||
# other settings
|
||||
# ..
|
||||
# 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'
|
||||
# other settings
|
||||
# ..
|
||||
```
|
||||
|
||||
### ESP32 modbus server `node3`
|
||||
|
||||
```YAML
|
||||
# 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'
|
||||
# other settings
|
||||
# ..
|
||||
# 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'
|
||||
# other settings
|
||||
# ..
|
||||
```
|
||||
|
||||
## BMS
|
||||
|
||||
> [!IMPORTANT]
|
||||
> You must number your `BMS` in order starting with the number `1`.
|
||||
|
||||
> [!TIP]
|
||||
> YAML files whose name starts with `bms_combine` are to be used on the main `YamBMS` node connected to your inverter, those whose name starts with `bms_modbus` are to be used on the other nodes connected to the `RS485` bus.
|
||||
|
||||
The example YAMLs are just examples, you can mix different BMS models without problems.
|
||||
|
||||
There are other `bms.yaml` not mentioned here, see in the [bms](../../packages/bms/) folder.
|
||||
|
||||
The `full` / `standard` versions contain all available sensors while the `minimal` version contains the basic sensors without the voltages of each cell and other superfluous sensors.
|
||||
|
||||
You can find `BMS` import `RP` examples in the [examples/single-node](../../examples/single-node/) folder.
|
||||
|
||||
## Shunt
|
||||
|
||||
> [!IMPORTANT]
|
||||
> You must number your `Shunt` in order starting with the number `1`.
|
||||
|
||||
> [!TIP]
|
||||
> YAML files whose name starts with `shunt_combine` are to be used on the main `YamBMS` node connected to your inverter, those whose name starts with `shunt_modbus` are to be used on the other nodes connected to the `RS485` bus.
|
||||
|
||||
As soon as you import a `Shunt` and it can be combined ([see condition](YamBMS_behavior.md#shunt)) the values `Voltage`, `Current`, `Power` and `SoC` of the shunt(s) will take precedence over the BMS values.
|
||||
|
||||
You can find `Shunt` import `RP` examples in the [examples/single-node](../../examples/single-node/) folder.
|
||||
|
||||
|
||||
## YamBMS
|
||||
|
||||
> [!TIP]
|
||||
> This package is only used with the `YamBMS` main node.
|
||||
|
||||
> [!CAUTION]
|
||||
> By default, `YamBMS` is configured with the values for a 16S LFP battery !
|
||||
|
||||
Take the time to configure `YamBMS` correctly according to your battery chemistry type `LFP/Li-ion/LTO` and `cell count`. Charging voltages can be changed in the app.
|
||||
|
||||
```YAML
|
||||
yambms:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms.yaml'
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
yambms_id: 'yambms1'
|
||||
yambms_name: 'YamBMS 1'
|
||||
yambms_update_interval: '1s'
|
||||
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
|
||||
yambms_input_number_mode: 'slider'
|
||||
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
|
||||
# These parameters are important and used for charging logic.
|
||||
# Battery Chemistry
|
||||
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
|
||||
# Number of cells in series
|
||||
yambms_cell_count: '16'
|
||||
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
|
||||
yambms_bulk_v: '55.2'
|
||||
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
|
||||
yambms_float_v: '53.6'
|
||||
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
|
||||
yambms_rebulk_v: '52.8'
|
||||
# Maximum time in minutes that the cut-off step can last before charging is complete
|
||||
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
|
||||
# This timer can be deactivated with a switch
|
||||
yambms_eoc_timer: '30'
|
||||
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
|
||||
yambms_cutoff_timer: '60'
|
||||
# Max. charge current : corresponds to the maximum charge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_charge_current: '300' # in Ampere
|
||||
# Max. discharge current : corresponds to the maximum discharge current which may be requested by YamBMS.
|
||||
# The current requested will be proportional to the BMS count without ever exceeding this value.
|
||||
yambms_max_requested_discharge_current: '300' # in Ampere
|
||||
```
|
||||
|
||||
## CAN bus to Inverter
|
||||
|
||||
> [!TIP]
|
||||
> This package is only used with the `YamBMS` main node.
|
||||
> It's possible to use this package multiple times in order to send information on two different `CAN` bus.
|
||||
|
||||
The CAN bus connected to your inverter via the CAN transceiver `canbus_inverter_1`.
|
||||
|
||||
You can keep the default configuration and adapt the `canbus` node on which the component must connect.
|
||||
|
||||
```YAML
|
||||
canbus:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: '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 (0x305 frame) for 5s
|
||||
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
|
||||
canbus_link_timer: '5s'
|
||||
```
|
||||
|
||||
# RS485 bus to Inverter
|
||||
|
||||
> [!TIP]
|
||||
> This package is only used with the `YamBMS` main node.
|
||||
> It's possible to use this package multiple times in order to send information on two different `RS485` bus.
|
||||
|
||||
The RS485 bus connected to your inverter via the RS485 transceiver `uart_esp_3`.
|
||||
|
||||
You can keep the default configuration and adapt the `uart` port on which the component must connect.
|
||||
|
||||
```YAML
|
||||
rs485_pylon:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: 'packages/yambms/yambms_rs485_pylon.yaml'
|
||||
vars:
|
||||
rs485_id: 'rs485_1'
|
||||
rs485_name: 'RS485 1'
|
||||
rs485_uart_id: 'uart_esp_3' # UART interface to which your inverter is connected
|
||||
rs485_uart_baud_rate: '9600'
|
||||
rs485_update_timeout: '5s'
|
||||
```
|
||||
|
||||
## Debug
|
||||
|
||||
The `debug` package will add useful information to refer to if problems occur.
|
||||
|
||||
```YAML
|
||||
debug:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
- path: packages/base/device_debug_ESP32.yaml
|
||||
# - path: packages/base/device_debug_ESP32_PSRAM.yaml # for ESP32 with PSRAM
|
||||
vars:
|
||||
debug_name: 'Debug'
|
||||
debug_update_interval: '5s'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
```
|
||||
@@ -41,7 +41,7 @@ Combine condition :
|
||||
1) BMS `Online Status` is `ON / Connected` (to detect a loss of connection with the BMS e.g. cable, BMS OFF or dead)
|
||||
2) The BMS `Battery Capacity` is `> 0` (to ensure that the data received is correct)
|
||||
|
||||
If one of these three conditions is not met, the BMS is automatically uncombined.
|
||||
If one of these two conditions is not met, the BMS is automatically uncombined.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> In RS485 modbus `multi-node`, if a server does not respond (cable or hardware failure) the `Online Status` of the BMS will be set to `OFF` and it will be uncombined.
|
||||
|
||||
@@ -21,7 +21,7 @@ Other configurations are possible, don't hesitate to communicate what works well
|
||||
| Inverter | Battery mode | CAN protocol |
|
||||
| --- | --- | --- |
|
||||
| Deye | Lithium 00 | PYLON 1.2 |
|
||||
| GoodWe | LX U5.4-L | PYLON + |
|
||||
| GoodWe | LX U5.4-L | PYLON V2 |
|
||||
| Sofar | Automatic | PYLON 1.2 |
|
||||
| Growatt | CAN L52 | PYLON 1.2 |
|
||||
| Solis | AoBo | SMA |
|
||||
@@ -78,14 +78,16 @@ Works only with `PYLON`, `LuxPower` and `Victron` protocols.
|
||||
|
||||
## Auto functions
|
||||
|
||||
Thanks to [@MrPabloUK](https://github.com/MrPabloUK) for developing these features.
|
||||
Thanks to [@MrPabloUK](https://github.com/MrPabloUK) for developing `Auto CVL`, `Auto CCL` and `Auto DCL` functions.
|
||||
|
||||
A [reference spreadsheet](https://docs.google.com/spreadsheets/d/1UwZ94Qca-DBP5gppzKmAjbMJYZGjR4lMwZtwwQR9wWY/edit?usp=sharing) has been created that shows how the `Auto functions` works.
|
||||
A [reference spreadsheet](https://docs.google.com/spreadsheets/d/1UwZ94Qca-DBP5gppzKmAjbMJYZGjR4lMwZtwwQR9wWY/edit?usp=sharing) has been created that shows how the `Auto CVL, CCL & DCL` works.
|
||||
|
||||

|
||||
Thanks to [@GHswitt](https://github.com/GHswitt) for developing `Auto Float` function.
|
||||
|
||||
## Auto CVL
|
||||
|
||||

|
||||
|
||||
> [!IMPORTANT]
|
||||
> The `Auto CVL` function uses the `Balance Trig. Volt.` value of your BMS. `e.g. for LFP` : BTG=0.010V
|
||||
|
||||
@@ -100,6 +102,8 @@ You can compare `Auto CVL` to cruise control in a car.
|
||||
|
||||
## Auto CCL & DCL
|
||||
|
||||

|
||||
|
||||
> [!IMPORTANT]
|
||||
> The `Auto CCL` function uses the `OVP` value of your BMS.
|
||||
> The `Auto DCL` function uses the `UVP` value of your BMS.
|
||||
@@ -111,10 +115,26 @@ This should prevent the runner cell from exceeding the max voltage cutoff, but d
|
||||
|
||||
You can compare `Auto CCL` to a max speed limiter in a car.
|
||||
|
||||
`Auto DCL` works the same way when a cell approaching `UVP + 0.02`.
|
||||
`Auto DCL` works the same way when a cell approaching `UVP + 0.2`.
|
||||
|
||||
Current control should work with any inverter that uses `CAN` control.
|
||||
|
||||
## Auto Float Voltage
|
||||
|
||||

|
||||
|
||||
When switching from `Bulk` to `Float`, therefore lowering the `Requested Charge Voltage (CVL)`, some inverters (e.g. Deye SUN-12K) will start to discharge the battery (into the grid) with up to max. discharge current until the
|
||||
`Requested Charge Voltage (CVL)` is reached. The reason behind this is that the inverter sees this as battery overvoltage and wants to counter it.
|
||||
As workaround, by enabling `Automatic Float Voltage`, it will lower the `Requested Charge Voltage (CVL)` gradually in small steps until the float voltage is reached, allowing the battery more time to settle down.
|
||||
There are two modes available: `Follow` and `Immediately`.
|
||||
|
||||
- `Follow`: Waits until the battery voltage itself is below the current `Requested Charge Voltage (CVL)` before lowering `Requested Charge Voltage (CVL)` further. It follows the battery voltage until the target float voltage is reached.
|
||||
- `Immediately`: Immediately start lowering the `Requested Charge Voltage (CVL)`, independent of the current battery voltage. That means it can go below the current battery voltage.
|
||||
|
||||
This feature might not work with all inverters as good or is not required if these do not discharge the battery.
|
||||
|
||||
The voltage steps can be configured (default `0.1V`) with `Auto Float Voltage Step`. The update interval can be configured (default `3 minutes`) with `Auto Float Update Interval`.
|
||||
|
||||
## Requested Values
|
||||
|
||||

|
||||
@@ -123,7 +143,7 @@ These 4 sensors allow you to see what is being requested of your inverter.
|
||||
|
||||
In the example below, we are in the `Float` phase at a voltage of `53.6V` and an `Inverter Offset V.` of `0.1V`. The `Requested Charge Voltage` is therefore `53.7V`.
|
||||
|
||||
The `Requested Discharge Voltage` is the `UVP + 0.02` value of your BMS multiplied by the number of cells, in this example (3V * 16).
|
||||
The `Requested Discharge Voltage` is the `UVP + 0.2` value of your BMS multiplied by the number of cells, in this example (3V * 16).
|
||||
|
||||
The `Requested Charge/Discharge Current` is the `OCP` value of your BMS multiplied by the `Max current` percentage, in this example (150A * 80%).
|
||||
|
||||
|
||||
@@ -0,0 +1,98 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Local Packages Example ############################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
packages:
|
||||
|
||||
modbus: !include
|
||||
file: packages/board/board_options_itf_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'
|
||||
@@ -0,0 +1,53 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Local Packages Example ############################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
substitutions:
|
||||
friendly_name : 'YamBMS Modbus Server 1' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms-modbus-server-1' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
|
||||
packages:
|
||||
|
||||
modbus: !include
|
||||
file: packages/board/board_options_itf_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'
|
||||
@@ -0,0 +1,58 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Local Packages Example ############################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
substitutions:
|
||||
friendly_name : 'YamBMS Modbus Server 2' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms-modbus-server-2' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
|
||||
packages:
|
||||
|
||||
modbus: !include
|
||||
file: packages/board/board_options_itf_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'
|
||||
@@ -0,0 +1,92 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Remote Packages Example ###########################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
packages:
|
||||
|
||||
yambms_modbus_client:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# Modbus client
|
||||
- path: 'packages/board/board_options_itf_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'
|
||||
@@ -0,0 +1,56 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Remote Packages Example ###########################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
substitutions:
|
||||
friendly_name : 'YamBMS Modbus Server 1' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms-modbus-server-1' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
|
||||
packages:
|
||||
|
||||
yambms_modbus_server:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# Modbus server
|
||||
- path: 'packages/board/board_options_itf_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'
|
||||
@@ -0,0 +1,61 @@
|
||||
# Updated : 2025.08.02
|
||||
# Version : 1.1.2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Remote Packages Example ###########################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
substitutions:
|
||||
friendly_name : 'YamBMS Modbus Server 2' # Prefix added in front of the `entity display name`, also used to classify them.
|
||||
hostname: 'yambms-modbus-server-2' # Name of your ESPHome node registered on the IP network (DNS name, must be unique) and prefix added in front of the `entity id`.
|
||||
|
||||
packages:
|
||||
|
||||
yambms_modbus_server:
|
||||
url: https://github.com/Sleeper85/esphome-yambms
|
||||
ref: main
|
||||
refresh: 0s
|
||||
files:
|
||||
# Modbus server
|
||||
- path: 'packages/board/board_options_itf_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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -0,0 +1,54 @@
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ Local Packages Example ############################
|
||||
|
||||
# This is not a working YAML but just code ready to copy into your main YAML.
|
||||
|
||||
################################################################################
|
||||
|
||||
packages:
|
||||
|
||||
eg4_modbus: !include
|
||||
file: packages/bms/bms_combine_EG4_RS485_modbus.yaml
|
||||
vars:
|
||||
eg4_modbus_uart_id: 'uart_esp_1'
|
||||
eg4_modbus_baud_rate: '9600'
|
||||
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
## BMS address must start at 2 with EG4 LLV2, ID 1 is a special case and has different output.
|
||||
bms_address: 2 # BMS 1 DIP switch
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'BMS 2'
|
||||
bms_address: 3 # BMS 2 DIP switch
|
||||
|
||||
bms3: !include
|
||||
file: packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml
|
||||
vars:
|
||||
bms_id: '3' # must be a number
|
||||
bms_name: 'BMS 3'
|
||||
bms_address: 4 # BMS 3 DIP switch
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -0,0 +1,56 @@
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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:
|
||||
# EG4 Modbus
|
||||
- path: 'packages/bms/bms_combine_EG4_RS485_modbus.yaml'
|
||||
vars:
|
||||
eg4_modbus_uart_id: 'uart_esp_1'
|
||||
eg4_modbus_baud_rate: '9600'
|
||||
# BMS 1
|
||||
- path: 'packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml'
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'BMS 1'
|
||||
## BMS address must start at 2 with EG4 LLV2, ID 1 is a special case and has different output.
|
||||
bms_address: 2 # BMS 1 DIP switch
|
||||
# BMS 2
|
||||
- path: 'packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml'
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'BMS 2'
|
||||
bms_address: 3 # BMS 2 DIP switch
|
||||
# BMS 3
|
||||
- path: 'packages/bms/bms_combine_EG4_LLV2_RS485_bms_full.yaml'
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'BMS 3'
|
||||
bms_address: 4 # BMS 3 DIP switch
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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 )
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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'
|
||||
@@ -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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
############################ 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
|
||||
|
After Width: | Height: | Size: 64 KiB |
|
After Width: | Height: | Size: 370 KiB |
|
After Width: | Height: | Size: 193 KiB |
|
After Width: | Height: | Size: 304 KiB |
|
After Width: | Height: | Size: 587 KiB |
|
After Width: | Height: | Size: 180 KiB |
|
After Width: | Height: | Size: 106 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 176 KiB |
|
After Width: | Height: | Size: 527 KiB |
|
After Width: | Height: | Size: 33 KiB |
|
After Width: | Height: | Size: 90 KiB |
|
After Width: | Height: | Size: 120 KiB |
|
After Width: | Height: | Size: 3.9 MiB |
|
After Width: | Height: | Size: 82 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
Before Width: | Height: | Size: 31 KiB |
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 265 KiB |
@@ -1,231 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: yambms-demo
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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: DEBUG # 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
||||
|
||||
packages:
|
||||
############### >>> UNCOMMENT YOUR 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-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'
|
||||
|
||||
############################################################
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
config_captive_portal: !include packages/config/config_captive_portal.yaml
|
||||
|
||||
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_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_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_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
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
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'
|
||||
@@ -1,177 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: yambms
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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 # 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
||||
|
||||
packages:
|
||||
############### >>> UNCOMMENT YOUR 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-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'
|
||||
|
||||
############################################################
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
|
||||
# shunt1: !include
|
||||
# file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml # shunt_combine_Junctek_KHF_UART.yaml
|
||||
# vars:
|
||||
# shunt_id: '1' # must be a number
|
||||
# shunt_name: 'Shunt 1'
|
||||
# shunt_uart_id: uart_esp_0
|
||||
|
||||
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
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_JBD_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'BMS 2'
|
||||
bms_uart_id: 'uart_esp_2'
|
||||
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
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
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'
|
||||
@@ -1,169 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: yambms
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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: DEBUG # DEBUG / INFO / WARN
|
||||
logs:
|
||||
esp32_ble_tracker: INFO
|
||||
esp32_ble_client: INFO
|
||||
|
||||
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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
||||
|
||||
# Max 3 BLE connections.
|
||||
# The BLE software stack (Bluedroid) on the ESP32 consumes a significant amount of RAM on the device.
|
||||
# Crashes are likely to occur if you include too many additional components in your device’s configuration.
|
||||
# https://esphome.io/components/ble_client.html
|
||||
|
||||
packages:
|
||||
############### >>> UNCOMMENT YOUR 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-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'
|
||||
|
||||
############################################################
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
|
||||
# shunt1: !include
|
||||
# file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml # shunt_combine_Junctek_KHF_UART.yaml
|
||||
# vars:
|
||||
# shunt_id: '1' # must be a number
|
||||
# shunt_name: 'Shunt 1'
|
||||
# shunt_uart_id: uart_esp_0
|
||||
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-ALL_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'
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_JK-ALL_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'
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
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'
|
||||
@@ -1,159 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: yambms
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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 # 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
||||
|
||||
packages:
|
||||
############### >>> UNCOMMENT YOUR 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-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'
|
||||
|
||||
############################################################
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
|
||||
# shunt1: !include
|
||||
# file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml # shunt_combine_Junctek_KHF_UART.yaml
|
||||
# vars:
|
||||
# shunt_id: '1' # must be a number
|
||||
# shunt_name: 'Shunt 1'
|
||||
# shunt_uart_id: uart_esp_0
|
||||
|
||||
bms1: !include
|
||||
file: packages/bms/bms_combine_JK-B_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'JK-BMS 1'
|
||||
bms_uart_id: 'uart_esp_1'
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_JK-B_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'JK-BMS 2'
|
||||
bms_uart_id: 'uart_esp_2'
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
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'
|
||||
@@ -1,177 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# GitHub : https://github.com/SeByDocKy/pvbrain2
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: 'pvbrain2'
|
||||
|
||||
###### For extended UART ports with the 2 WK2168 ######
|
||||
|
||||
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}
|
||||
|
||||
#######################################################
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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 # 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | PVbrain2 packages |
|
||||
# +--------------------------------------+
|
||||
packages:
|
||||
device_board: !include packages/board/board_ESP32-S3_DevKitC-1_PVbrain2.yaml
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.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
|
||||
device_canbus_node2: !include pvbrain2/base/device_canbus_mcp2515.yaml
|
||||
|
||||
# +--------------------------------------+
|
||||
# | 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-B_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '1' # must be a number
|
||||
bms_name: 'JK-BMS 1'
|
||||
bms_uart_id: 'uart_${uart_hub_bus}_4'
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_JK-B_UART_full.yaml
|
||||
vars:
|
||||
bms_id: '2' # must be a number
|
||||
bms_name: 'JK-BMS 2'
|
||||
bms_uart_id: 'uart_${uart_hub_bus}_5'
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
canbus1: !include
|
||||
file: packages/yambms/yambms_canbus.yaml
|
||||
vars:
|
||||
canbus_id: 'canbus1'
|
||||
canbus_name: 'CANBUS 1'
|
||||
canbus_node_id: 'canbus_node1'
|
||||
canbus_light_id: 'led_light_1' # on_board_light_io48
|
||||
# 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'
|
||||
# Size of your PSRAM in bits
|
||||
# 8Mb='8388608' | 6Mb='6291456' | 4Mb='4194304' | 2Mb='2097152' | NoPSRAM='0'
|
||||
debug_psram_size: '8388608'
|
||||
@@ -1,234 +0,0 @@
|
||||
# Updated : 2025.01.16
|
||||
# Version : 1.5.3
|
||||
# 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 <http://www.gnu.org/licenses/gpl.html>.
|
||||
|
||||
substitutions:
|
||||
name: yambms
|
||||
|
||||
# Don't forget to configure your WiFi credentials in the secrets.yaml file
|
||||
#
|
||||
# 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 # 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
|
||||
|
||||
# +--------------------------------------+
|
||||
# | Packages |
|
||||
# +--------------------------------------+
|
||||
|
||||
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
|
||||
|
||||
packages:
|
||||
############### >>> UNCOMMENT YOUR 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-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'
|
||||
|
||||
############################################################
|
||||
|
||||
# Config : this YAML contains the settings shared between all ESP32s
|
||||
config_yambms: !include packages/config/config_yambms.yaml
|
||||
|
||||
# shunt1: !include
|
||||
# file: packages/shunt/shunt_combine_Victron_SmartShunt_UART.yaml # shunt_combine_Junctek_KHF_UART.yaml
|
||||
# vars:
|
||||
# shunt_id: '1' # must be a number
|
||||
# shunt_name: 'Shunt 1'
|
||||
# shunt_uart_id: uart_esp_0
|
||||
|
||||
# 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-PB_RS485_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-PB_RS485_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-PB_RS485_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: '0x01' # BMS 1 DIP switch
|
||||
|
||||
bms2: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x02' # BMS 2 DIP switch
|
||||
|
||||
bms3: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x03' # BMS 3 DIP switch
|
||||
|
||||
bms4: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x04' # BMS 4 DIP switch
|
||||
|
||||
bms5: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x05' # BMS 5 DIP switch
|
||||
|
||||
bms6: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x06' # BMS 6 DIP switch
|
||||
|
||||
bms7: !include
|
||||
file: packages/bms/bms_combine_JK-PB_RS485_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: '0x07' # BMS 7 DIP switch
|
||||
|
||||
yambms1: !include
|
||||
file: packages/yambms/yambms.yaml
|
||||
vars:
|
||||
# Please read the cut-off charging logic README to understand how the YamBMS works
|
||||
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'
|
||||
# Maximum charging cycles is used to calculate the battey SOH, LF280K v3 =8000.0, LF280K v2 =6000.0, LF280=3000.0 (decimal is required)
|
||||
yambms_max_cycles: '6000.0'
|
||||
|
||||
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'
|
||||