133 Commits
Author SHA1 Message Date
Sleeper85 75c0a97659 ESPHome 2025.11 Warning 2025-11-23 10:57:37 +01:00
5hortCircuit 810f109592 Adding FLIP_C3 board (#112)
* Adding FLIP_C3 board

The FLIP_C3 is a simple ESP32-C3 board that has an integrated power supply that has a 60V input.  This board can be connected directly to a 48V battery and then be used with the M5Stack Isolated RS485 Unit (U094) to get a RS485 connection back to the master unit.  I successfully used 4 of these units to communicate with the JK-BMS B-Series BMS's.  The FLIP_C3 has an onboard 5V regulator that can power the RS485 module, 2 UART exposed on connectors that can be used for TTL to the BMS and TTL to the RS485 module. In the US it is available on Amazon, product page: https://wiki.vdbx.io/product/flip_c3

* Added missing GPIOs to FLIP_C3 board
2025-11-22 10:24:36 +01:00
Sleeper85 5329ea6696 JK-PB Erase History Data function 2025-11-19 23:06:29 +01:00
Sleeper85 bcf7f3f9fa Added Waveshare ESP32-S3-RS485-CAN 2025-11-19 21:26:17 +01:00
Sleeper85 f2415bda61 Hardware highlighted and changelog moved 2025-11-19 21:25:10 +01:00
Sleeper85 0edda3cd66 Fixed link to Downgrading to 19.10 2025-11-16 15:23:54 +01:00
Sleeper85 5dc31f29c5 Updated JK-PB readme with V19 warning and SoC 100% reset solution 1 and 2 2025-11-16 15:13:14 +01:00
Sleeper85 66cbb93397 Added Shunt Modbus FAKE 2025-10-25 13:12:18 +02:00
Sleeper85 19b4d22ea1 Added ${sniffer_id} to Broadcasting JK-PB settings to all BMS switch 2025-10-22 19:11:16 +02:00
Sleeper85 072453e70c Merge pull request #99 from GHswitt/BasenUpdate
Basen: Use new binary sensors for charging/discharging
2025-10-20 15:04:10 +02:00
Sebastian ee28444a88 Basen: Use new binary sensors for charging/discharging allowed from Basen component 2025-10-14 23:23:26 +02:00
Sleeper85 b6f0515ec1 Merge pull request #97 from GHswitt/PR_Basen_Talk_Pin
Add Basen controller version with talk/flow control pin
2025-10-06 20:45:28 +02:00
Sebastian ae959c057e Add Basen controller version with talk/flow control pin 2025-10-06 20:05:05 +02:00
Sleeper85 a519338422 Create board_ESP32-S3_WS-ETH.yaml 2025-09-12 16:04:24 +02:00
Sleeper85 e105dc0dad Set MCP2515 SPI interface to spi3 2025-09-12 16:04:04 +02:00
Sleeper85 5e5b86dece Update board_ESP32-S3_WS-RS485-CAN.yaml 2025-09-09 21:59:33 +02:00
Sleeper85 0e3fdb5043 Create board_ESP32-S3_WS-RS485-CAN.yaml 2025-09-09 17:18:45 +02:00
Andrew Rankin 8a1262e426 Adding EG4 LLV2 BMS (#85) 2025-09-09 16:08:32 +02:00
Sleeper85 64e5a4b177 ETH01-EVO - Comment version: latest 2025-09-04 23:17:28 +02:00
Sleeper85 3984ccea0e JK BLE V14 - Fixed missing ${bms_name} 2025-08-21 10:59:18 +02:00
Sleeper85 468c61a9dd Fixed JK RS485 dashboards status_online 2025-08-14 10:12:43 +02:00
Sleeper85 81bd0e7ab9 WT32-ETH01 added doc links 2025-08-13 18:50:01 +02:00
Sleeper85 737cacdf09 WT32-EH01 binary LED 2025-08-13 00:08:18 +02:00
Sleeper85 7290a24946 YamBMS 1.5.8 - Added WiFi AP 2025-08-12 23:01:05 +02:00
Sleeper85 aa5dd3ec50 YamBMS 1.5.8 - Updated changelog 2025-08-12 22:59:32 +02:00
Sleeper85 4e06577eb0 WiFi and Web Server credentials 2025-08-12 22:11:58 +02:00
Sleeper85 df967ca5e9 Web server 1.1.3 2025-08-12 22:09:06 +02:00
Sleeper85 872abfcd97 WiFi AP 1.1.2 2025-08-12 22:07:05 +02:00
Sleeper85 c2cc9d2be0 Captive portal 1.1.2 2025-08-12 22:06:46 +02:00
Sleeper85 bc12a8e1a0 Updated YAML version 2025-08-12 21:31:00 +02:00
Sleeper85 b3f203bd58 Added Factory Reset button 2025-08-12 21:29:07 +02:00
Sleeper85 2eaf17633d ESP32_EVB replace clk_mode by clk 2025-08-12 19:02:32 +02:00
Sleeper85 e70819054c Create board_ESP32_WT32-ETH01.yaml 2025-08-12 19:01:45 +02:00
Sleeper85 d2eee689ee Create board_options_wifi_ap.yaml 2025-08-11 17:59:12 +02:00
Sleeper85 a851511d09 Allowing web_server to work without internet access 2025-08-11 17:58:49 +02:00
Sleeper85 b4e6262793 YamBMS 1.5.8 - Web Server v3 2025-08-11 16:18:29 +02:00
Sleeper85 99c92f17dc Auto Float - Fixed missing yambms_id 2025-08-11 15:38:23 +02:00
Sleeper85 a1b8572f3d Merge pull request #80 from GHswitt
BMS Modbus client: Return 0 when not online
2025-08-08 19:43:23 +02:00
Sleeper85 11e0e34ab9 Merge pull request #81 from GHswitt
Fix balance trigger voltage for Basen and Deye
2025-08-08 19:38:25 +02:00
Sleeper85 1506b02943 Merge pull request #77 from Fahmula
Prevent stale data on BMS disconnect
2025-08-08 19:33:38 +02:00
Sebastian e43bb74e52 Fix balance trigger voltage for Basen and Deye 2025-08-08 18:11:52 +02:00
Sebastian 2b9f92a5eb BMS Modbus client: Return 0 when not online
If main node comes up but the BMS Modbus server is not available, it may use invalid values (for example 65535 % SoC).
Add a check if Modbus server is online.
2025-08-07 22:04:20 +02:00
Fahmula a3ea2a2189 chore(yambms_rs485_pylon.yaml): Update version to 1.3.1 2025-08-06 22:53:30 +00:00
Fahmula db555b91b1 fix(yambms_rs485_pylon.yaml): Ensure inverter status updates when offline
Moves the update logic for the inverter_com_status sensor outside of the
conditional BMS check.

This ensures the status display is always kept in sync with the component's
state, even after the BMS has disconnected.
2025-08-06 22:51:12 +00:00
Fahmula b2dbaa3f4d fix(yambms_rs485_pylon.yaml): Prevent stale data on BMS disconnect
Previously, the data-forwarding logic would only execute if a BMS was
connected. When the BMS disconnected, the logic would halt, leaving
the proxy sensors with their last known values. This caused stale data
to be sent to the inverter.

This change refactors the YAML logic to explicitly handle the BMS
offline state.

When a BMS is no longer available, all numeric proxy sensors are now
invalidated by publishing `NAN`, and all binary alarm/protection
sensors are reset to `false`. This ensures the C++ component receives
a clear signal that the data is no longer valid, allowing its
fail-safe mechanisms to engage and stop communication.

This fix improves overall system robustness by preventing stale state
and ensuring a predictable response to a BMS disconnect.
2025-08-05 23:31:53 +00:00
Sleeper85 27c94803c9 Make itf canbus more configurable 2025-08-03 02:10:18 +02:00
Sleeper85 f2bcf8644b Merge branch 'main' of https://github.com/Sleeper85/esphome-yambms 2025-08-02 22:36:07 +02:00
Sleeper85 7d9c31e3e0 Updated YamBMS 1.5.8 changelog - PR #74 2025-08-02 22:35:55 +02:00
Sleeper85 f4b54c4acd Merge PR #74 from Fahmula
RS485 link status, Heartbeat and Requested Force Charge.

Successfully tested with Deye and Battery Lithium `12`.
2025-08-02 22:32:17 +02:00
fahmula e228d14d76 chore: Update version to 1.3.0 in YAML file 2025-08-02 16:07:56 -04:00
fahmula ea62827a93 feat: Add requested_force_charge to Pylontech RS485
Introduces a new configuration option requested_force_charge to the
Pylontech RS485 integration, allowing for external control of the
force charge request.
2025-08-02 15:56:06 -04:00
fahmula 76cab805a7 chore: Update version and date in YAML file to reflect latest changes 2025-08-02 13:22:38 -04:00
fahmula 36199a6ecb refactor: Update sensor IDs to use dynamic rs485_id for improved configuration 2025-08-02 13:22:38 -04:00
fahmula 31e138bf0d feat: Add inverter communication status sensor
Implement a new binary sensor to monitor the inverter communication status.
This sensor's state is dependent on the `rs485_switch_inverter_heartbeat_monitoring`
switch, only reporting the actual inverter communication status when
heartbeat monitoring is enabled.
2025-08-02 13:22:38 -04:00
fahmula 7909210390 fix: Remove redundant inverter communication status sensor 2025-08-02 13:22:38 -04:00
fahmula 3314d57a7d fix: Improve inverter communication status accuracy
Refactor inverter heartbeat and communication status handling to be
managed directly by the `pylontech_rs485` component. This provides a
more reliable and accurate indication of the inverter's communication
state, ensuring the true status is reflected.
2025-08-02 13:22:38 -04:00
fahmula 4b05008e78 Add some comments 2025-08-02 13:22:38 -04:00
fahmula 444c2fbf33 fix(rs485): hardcode inverter online timeout to 5s to avoid substitution errors 2025-08-02 13:22:38 -04:00
fahmula 941fcbf9f2 feat(rs485): add inverter heartbeat monitoring logic with status sensor 2025-08-02 13:22:38 -04:00
Sleeper85 03e91d2ed8 Create bms_modbus_JBD_BLE_full.yaml 2025-08-02 11:02:55 +02:00
Sleeper85 5ddf954d0f Updated YamBMS multi-node modbus YAMLs 2025-08-02 11:02:28 +02:00
Sleeper85 0829fc64b9 Update MCU_default_GPIOs.png 2025-07-31 20:54:55 +02:00
Sleeper85 0012b9ad78 Updated XIAO board name 2025-07-31 20:45:23 +02:00
Sleeper85 f6f564de01 MCU default GPIOs 2025-07-31 20:44:53 +02:00
Sleeper85 96eb7b5b7d Merge pull request #75 from GHswitt/PR_Round_CCL
Round auto_ccl/auto_dcl value
2025-07-30 21:41:10 +02:00
Sebastian e5491609b8 Round auto_ccl/auto_dcl value
Requested charge current had 0,1A steps before with Auto CCL/DCL enabled,
round to nearest full integral value.
2025-07-30 20:12:15 +02:00
Sleeper85 200e90461e YamBMS 1.5.8 - Ethernet board 2025-07-30 15:57:36 +02:00
Sleeper85 ee003598cd Improved JK-PB SoC 100% reset readme 2025-07-30 12:34:22 +02:00
Sleeper85 2d0a602e70 Improved Auto functions readme 2025-07-30 12:08:28 +02:00
Sleeper85 4c89aeef61 Dashboards 1.5.8 compatible with CANBUS / RS485 inverter communication protocol 2025-07-30 11:32:09 +02:00
Sleeper85 2a661fc667 Dashboard 1.5.8 - Fixed DEBUG title 2025-07-30 09:35:41 +02:00
Sleeper85 9c7c22444b Updated JK-PB doc about SoC 100% reset 2025-07-30 09:15:49 +02:00
Sleeper85 f4e9811805 YamBMS 1.5.8 - New YamBMS LP and RP documentation 2025-07-29 17:02:29 +02:00
Sleeper85 58a83bef64 YamBMS 1.5.8 - Demo Shunt + BMS 2025-07-28 20:34:30 +02:00
Sleeper85 2fdfd7aa91 YamBMS 1.5.8 - demo hostname 2025-07-28 20:22:46 +02:00
Sleeper85 7584426532 Example URL to the single-node folder 2025-07-28 18:22:37 +02:00
Sleeper85 48ffc4f15a Updated TIP message 2025-07-28 18:18:55 +02:00
Sleeper85 c55a17d306 Updated multi-node YAML examples 2025-07-28 18:02:44 +02:00
Sleeper85 e45184cc27 YamBMS 1.5.8 - reorganized YAML 2025-07-28 17:44:18 +02:00
Sleeper85 e44fc40eb5 Create board_options_itf_wk2168_spi.yaml 2025-07-28 17:41:44 +02:00
Sleeper85 c5c7540c85 Create board_options_itf_wk2168_i2c.yaml 2025-07-28 17:41:41 +02:00
Sleeper85 19f8c0b4f7 Added GPIOs substitutions 2025-07-28 17:41:33 +02:00
Sleeper85 25b286c4e8 New YAML regarding PSRAM 2025-07-28 17:40:25 +02:00
Sleeper85 8dc572cdba Updated PVbrain2 YAML 2025-07-28 17:34:18 +02:00
Sleeper85 964462ab5f Added new LP and RP example YAMLs 2025-07-28 17:32:50 +02:00
Sleeper85 cd7cb4c246 Remove configurations_examples folder 2025-07-28 17:30:59 +02:00
Sleeper85 c755dcce83 Create RP_BMS_example_DEMO_Shunt_and_BMS.yaml 2025-07-26 16:44:12 +02:00
Sleeper85 aa523ec148 Fixed online status for BMS SEPLOS V1 V2 2025-07-25 19:23:27 +02:00
Sleeper85 9d3996a4ea Update YamBMS 1.5.8 changelog 2025-07-25 09:38:19 +02:00
Sleeper85 73a43ea036 Added BMS SEPLOS V3 2025-07-24 22:30:11 +02:00
Sleeper85 ca43d7a310 Update README 2025-07-24 21:18:54 +02:00
Sleeper85 ed4dc7f522 Update JK-PB doc - 120 Ohm bus resistor and SoC 100% reset 2025-07-24 21:00:00 +02:00
Sleeper85 a3fa519f41 YamBMS DEMO fixed hostname 2025-07-24 20:17:37 +02:00
Sleeper85 e3ef26056e Davicom DM9051 SPI Ethernet Controller integrated in esphome 2025.7 2025-07-24 20:15:06 +02:00
Sleeper85 3cb9e1d60c JK RS485 dev component 2025-07-23 23:33:36 +02:00
Sleeper85 e93b68699d Dashboards 1.5.8 2025-07-14 00:00:19 +02:00
Sleeper85 c25d3eed21 YamBMS 1.5.8 2025-07-13 23:59:41 +02:00
Sleeper85 f2e6b57e75 YamBMS 1.5.8 - PR #72 from Fahmula/yambms-rs485
Added Pylontech RS485 inverter protocol
2025-07-13 23:42:25 +02:00
Sleeper85 2f1a82c3ad YamBMS 1.5.8 - PR #67 from GHswitt/PR/MaxCharge
Add options to restrict max. charge and discharge current.
2025-07-13 23:39:00 +02:00
Sleeper85 5da5cce67c YamBMS 1.5.7 updated changelog 2025-07-13 23:35:43 +02:00
Sebastian 77f657415a Add options to restrict max. charge and discharge current
This adds 'yambms_max_inverter_charge_current' and 'yambms_max_inverter_discharge_current' substitutions. They are used to restrict the range of the charge/discharge current for easier control when the battery currents are much higher than the inverter currents.
2025-07-12 21:00:14 +02:00
Fahmula 1597d99fcc refactor: Refactor RS485 Pylontech integration
Delete generic `board_options_itf_esp32_rs485.yaml` and replace its
usage with `board_options_itf_uart_4.yaml` in the main configuration.
Rename `yambms_rs485.yaml` to `yambms_rs485_pylon.yaml` to better
reflect its specific use for Pylontech. Update the `rs485` package
reference to `rs485_pylon` and introduce new variables
(`rs485_name`, `rs485_uart_id`, `rs485_uart_baud_rate`) for more
explicit configuration. Modify `yambms_rs485_pylon.yaml` to extend
the UART configuration and use the new `rs485_uart_id` for the
Pylontech component. This improves clarity and modularity.
2025-07-12 07:51:46 -04:00
Fahmula c3a80b9f8c feat: Add Pylontech RS485 inverter protocol
This commit introduces a new output driver for YamBMS, enabling communication with inverters that use the Pylontech RS485 protocol. This provides a robust alternative to the existing CANbus interface.

The implementation is architecturally identical to the proven CANbus pattern.

Key changes include:

*   **New Core Logic Package:** [`packages/yambms/yambms_rs485.yaml`](packages/yambms/yambms_rs485.yaml) contains the interval engine, proxy sensor definitions, and links core YamBMS data to the `esphome-pylontech-rs485` external component.

*   **New Reusable Board Option:** [`packages/board/board_options_itf_esp32_rs485.yaml`](packages/board/board_options_itf_esp32_rs485.yaml) defines a standard 9600 baud UART interface for connecting to the inverter.

*   **New Example Configuration:** [`YamBMS_RP_JK-BLE_to_Pylontech-RS485.yaml`](YamBMS_RP_JK-BLE_to_Pylontech-RS485.yaml) demonstrates a complete, working setup using the new packages.
2025-07-12 07:24:45 -04:00
Sleeper85 17b7500f0c YamBMS 1.5.7 updated changelog 2025-07-11 14:33:48 +02:00
Sleeper85 b9632e0eb5 Dashboards 1.5.7 - Replaced % with percent in entity names 2025-07-11 14:33:01 +02:00
Sleeper85 53d8a189b2 Replaced % with percent in entity names. 2025-07-11 14:31:24 +02:00
Sleeper85 53e754c753 FAKE Shunt 1.1.3 2025-07-11 14:28:15 +02:00
Sleeper85 5ba0a5cf26 Dashboards 1.5.7 - Max/Min cell voltage in color using macro 2025-07-10 14:46:07 +02:00
Sleeper85 34fda6c92a YamBMS 1.5.7 - Removed special characters in entity name 2025-07-10 13:13:02 +02:00
Sleeper85 5ffffb74b6 Merge pull request #71
Considerably shortens the file by 3x16 repetitions of same code to 3x2 repeats of same macro definition. If only there was a central key/tag to store macros in yaml, we only need to store the macro one time instead of six!

Things tested working on my end:
- configurable high and low cell voltage colours
- adjustable voltage spacing number
2025-07-10 10:15:45 +02:00
Shivam Maurya ef90c2de0d Update YamBMS_HA_Dashboards
DO NOT merge before Copy paste and testing the YAML works in HA dashboard editor.

Considerably shortens the file by 3x16 repetitions of same code to 3x2 repeats of same macro definition.
If only there was a central key/tag to store macros in yaml, we only need to store the macro one time instead of six!
2025-07-09 23:32:49 +05:30
Sleeper85 cdc86cc298 Added max requested charge/discharge current substitutions 2025-07-09 16:53:23 +02:00
Sleeper85 c18b9c8d55 YamBMS 1.5.7 - Added yambms_version substitution 2025-07-09 16:26:38 +02:00
Sleeper85 62b5844ec2 Delete yambms_custom.yaml 2025-07-09 16:25:04 +02:00
Sleeper85 4c6dba8add Dashboards 1.5.7 - Max/Min cell voltage in color with HA 2025.7 compatibility 2025-07-08 16:58:32 +02:00
Sleeper85 da0acaa3c5 Merge PR#70
Dashboards 1.5.7 - With rounded values and max/min cell voltage in color compatible HA `2025.7`
2025-07-08 14:10:32 +02:00
Sleeper85 2fa5b4d4f3 Dashboards 1.5.7 - With max/min cell voltage in color compatible HA 2025.7 2025-07-08 14:07:33 +02:00
Sleeper85 b143d9bd60 Dashboards 1.5.7 compatible HA core 2025.7 2025-07-08 13:37:57 +02:00
Shivam Maurya 1bacb100d1 Update YamBMS_HA_Dashboard_JK_UART-GPS_BLE_3xBMS.yaml
Copy paste and test  the YAML in HA dashboard editor before merging.

Add , rounded=True
and optimized cell voltage display formatting to ensure high/low cell indication works with newest HA 2025.7.1.
2025-07-08 13:15:53 +05:30
Sleeper85 d0e42a27a4 Create bms_options_auto_balance_switch.yaml 2025-07-07 20:53:18 +02:00
Sleeper85 965ad74127 Added JK balance switch ID 2025-07-07 20:28:06 +02:00
Sleeper85 85e3c90043 FAKE BMS charging and discharging power 2025-06-28 12:34:57 +02:00
Sleeper85 32b2dfc450 Merge branch 'main' of https://github.com/Sleeper85/esphome-yambms 2025-06-26 14:28:08 +02:00
Sleeper85 348f7f2e0c YamBMS 1.5.7 - Improved comments regarding entity id and display name 2025-06-26 14:28:03 +02:00
Sleeper85 a6e4f24df5 Update YamBMS_functions.md 2025-06-23 13:11:09 +02:00
Sleeper85 02dec09cfd Update YamBMS 1.5.7 changelog 2025-06-22 18:01:42 +02:00
Sleeper85 750cfd11a5 YamBMS 1.5.7 - Fixed: change Charge Status to Bulk when Force Charge is requested 2025-06-22 16:54:44 +02:00
Sleeper85 b5c05bf350 Update YamBMS 1.5.7 changelog 2025-06-22 14:32:32 +02:00
Sleeper85 b3333e4949 Defining state_class for all YamBMS sensors 2025-06-22 14:05:26 +02:00
Sleeper85 c00aa954f5 esphome min_version changed to 2025.6.0 2025-06-22 14:04:16 +02:00
Sleeper85 a0cfea8b5d YamBMS 1.5.7 2025-06-19 22:12:34 +02:00
Sleeper85 345181c185 YamBMS 1.5.7 - Auto Float function 2025-06-19 22:11:27 +02:00
Sleeper85 7c97912913 Dashboards 1.5.7 2025-06-19 22:08:45 +02:00
163 changed files with 10427 additions and 7139 deletions

No files matched your search

@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.07.30
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,6 +24,8 @@ views:
sections:
- type: grid
cards:
- type: heading
heading: YamBMS - Battery
- graph: line
type: sensor
entity: sensor.yambms_demo_yambms_1_total_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_demo_canbus_1_status
name: CANBUS Status
entity: binary_sensor.yambms_demo_inverter_communication_status
name: Inverter comm. status
- type: tile
entity: binary_sensor.yambms_demo_esp32_online_status
name: ESP32 Status
name: ESP32 status
- type: tile
entity: sensor.yambms_demo_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_demo_esp32_uptime
name: ESP32 Uptime
- type: entities
entities:
- entity: sensor.yambms_demo_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_demo_esp32_uptime
name: ESP32 Uptime
- type: tile
entity: sensor.yambms_demo_esp32_esphome_version
name: ESPHome version
- type: entities
entities:
- entity: sensor.yambms_demo_yambms_1_requested_charge_voltage
@@ -192,17 +198,48 @@ views:
- type: tile
entity: sensor.yambms_demo_yambms_1_last_version
name: Last version
title: YamBMS - Status
column_span: 1
- type: grid
cards:
- type: heading
heading_style: title
heading: BMS control
- type: entities
entities:
- entity: switch.yambms_demo_bms_1_online_status
- entity: switch.yambms_demo_bms_1_charge_switch
- entity: switch.yambms_demo_bms_1_discharge_switch
- entity: switch.yambms_demo_bms_1_balance_switch
title: BMS 1
- type: entities
entities:
- entity: switch.yambms_demo_bms_2_online_status
- entity: switch.yambms_demo_bms_2_charge_switch
- entity: switch.yambms_demo_bms_2_discharge_switch
- entity: switch.yambms_demo_bms_2_balance_switch
title: BMS 2
- type: entities
entities:
- entity: switch.yambms_demo_bms_3_online_status
- entity: switch.yambms_demo_bms_3_charge_switch
- entity: switch.yambms_demo_bms_3_discharge_switch
- entity: switch.yambms_demo_bms_3_balance_switch
title: BMS 3
- title: Control
cards:
- type: entities
- type: entity-filter
entities:
- entity: select.yambms_demo_canbus_1_bms_name
name: CANBUS 1 BMS Name
- entity: select.yambms_demo_canbus_1_protocol
name: CANBUS 1 Protocol
title: YamBMS - CANBUS Protocol
- entity: select.yambms_demo_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_demo_yambms_1_charge_enabled
@@ -245,6 +282,17 @@ views:
- entity: switch.yambms_demo_yambms_1_automatic_discharge_current
name: Automatic Discharge Current
title: YamBMS - Auto CCL / DCL
- type: entities
entities:
- entity: select.yambms_demo_yambms_1_automatic_float_voltage
name: Automatic Float Voltage
- entity: sensor.yambms_demo_yambms_1_auto_float_voltage
name: Auto Float Voltage
- entity: number.yambms_demo_yambms_1_auto_float_update_interval
name: Update Interval
- entity: number.yambms_demo_yambms_1_auto_float_voltage_step
name: Voltage Step
title: YamBMS - Auto Float
- type: entities
entities:
- entity: number.yambms_demo_yambms_1_rebulk_soc
@@ -256,9 +304,9 @@ views:
title: YamBMS - ReBulk
- type: entities
entities:
- entity: number.yambms_demo_yambms_1_max_charge_current
- entity: number.yambms_demo_yambms_1_max_charge_current_percent
name: Max charge current (%)
- entity: number.yambms_demo_yambms_1_max_discharge_current
- entity: number.yambms_demo_yambms_1_max_discharge_current_percent
name: Max discharge current (%)
title: YamBMS - Max current (%)
- type: entities
@@ -296,7 +344,7 @@ views:
- entity: button.yambms_demo_esp32_restart
name: ESP32 Restart
title: YamBMS - Diagnostic
- type: entities
- type: entity-filter
entities:
- entity: binary_sensor.yambms_demo_canbus_1_status
name: CANBUS 1 Status
@@ -304,37 +352,75 @@ views:
name: CANBUS 1 Inverter Heartbeat Monitoring
- entity: sensor.yambms_demo_canbus_1_inverter_heartbeat
name: CANBUS 1 Inverter Heartbeat
title: YamBMS - Inverter Heartbeat
- type: entities
- entity: binary_sensor.yambms_demo_rs485_1_status
name: RS485 1 Status
- entity: switch.yambms_demo_rs485_1_inverter_heartbeat_monitoring
name: RS485 1 Inverter Heartbeat Monitoring
- entity: sensor.yambms_demo_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_demo_debug_heap_free
- entity: sensor.yambms_demo_debug_free_psram_percent
name: Debug Free PSRAM (%)
- entity: sensor.yambms_demo_debug_free_psram
name: Debug Free PSRAM
- entity: sensor.yambms_demo_debug_heap_free_percent
name: Debug Heap free (%)
- entity: sensor.yambms_demo_debug_heap_free_2
- entity: sensor.yambms_demo_debug_heap_free
name: Debug Heap free
- entity: sensor.yambms_demo_debug_heap_max_block
- entity: sensor.yambms_demo_debug_heap_max_block_percent
name: Debug Heap max block (%)
- entity: sensor.yambms_demo_debug_heap_max_block_2
- entity: sensor.yambms_demo_debug_heap_max_block
name: Debug Heap max block
- entity: sensor.yambms_demo_debug_loop_time
name: Debug Loop time
- entity: sensor.yambms_demo_esp32_uptime
name: ESP32 Uptime
- entity: sensor.yambms_demo_esp32_esphome_version
name: ESPHome version
- entity: sensor.yambms_demo_debug_reset_reason
name: Debug Reset reason
title: YamBMS - DEBUG
conditions:
- condition: state
state_not: unavailable
card:
title: YamBMS - DEBUG
- title: BMS
type: sections
max_columns: 3
sections:
- type: grid
title: BMS 1
column_span: 1
cards:
- type: heading
heading: BMS 1
heading_style: title
badges:
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_1_online_status
color: state
name: Online
state_content: name
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_1_can_be_combined
color: state
name: Combined
state_content: name
- type: grid
square: false
columns: 1
cards:
- type: markdown
content: >-
<center>Time : <b><font color=red>1Y 48D 22H</font>
content: '<center>Time : <b><font color=red>1Y 48D 22H</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -343,8 +429,7 @@ views:
columns: 1
cards:
- type: markdown
content: >-
<center>Error : <b><font color=red>DEMO</font>
content: '<center>Error : <b><font color=red>DEMO</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -355,43 +440,47 @@ views:
- type: markdown
content: >-
<center>Charge : <b>{% if
states('switch.yambms_demo_bms_1_charge_switch') == 'on'
%} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_charge_switch') | upper
}}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_1_charge_switch') | upper
}}</font> {% endif %}
states('switch.yambms_demo_bms_1_charge_switch', rounded=True)
== 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_charge_switch', rounded=True)
| upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_1_charge_switch', rounded=True)
| upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Discharge : <b> {% if
states('switch.yambms_demo_bms_1_discharge_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_discharge_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_1_discharge_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_1_discharge_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_discharge_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_1_discharge_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Balance : <b> {% if
states('switch.yambms_demo_bms_1_balance_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_balance_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_1_balance_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_1_balance_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_1_balance_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_1_balance_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_1_total_voltage') }}
V</font></b>
states('sensor.yambms_demo_bms_1_total_voltage', rounded=True)
}} V</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_1_current') }} A</font></b>
states('sensor.yambms_demo_bms_1_current', rounded=True) }}
A</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_1_power') }} W</font>
states('sensor.yambms_demo_bms_1_power', rounded=True) }}
W</font>
- type: grid
square: false
columns: 2
@@ -399,99 +488,95 @@ views:
- type: markdown
content: >-
<center><b><font size=4>SoC :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_1_battery_soc')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_1_battery_soc',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center><b><font size=4>SoH :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_1_battery_soh')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_1_battery_soh',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center> Battery Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_1_battery_capacity') }} Ah</font><br>
Cycle Capacity :&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br>
Ave. Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00 A</font><br>
Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_1_max_temperature') }} °C</font>
states('sensor.yambms_demo_bms_1_battery_capacity',
rounded=True) }} Ah</font><br> Cycle Capacity
:&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br> Ave. Cell
Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00
A</font><br> Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_1_max_temperature',
rounded=True) }} °C</font>
- type: markdown
content: >-
<center> Remain Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_1_capacity_remaining') }} Ah</font><br>
Cycle Count :&nbsp;&nbsp;<font color=#41CD52>
{{ states('sensor.yambms_demo_bms_1_charging_cycles') }}</font><br>
Delta Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>0.007 V</font><br>
MOS temp. :&nbsp;&nbsp;<font color=#41CD52>25.6 °C</font><br>
Min temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_1_min_temperature') }} °C</font>
states('sensor.yambms_demo_bms_1_capacity_remaining',
rounded=True) }} Ah</font><br> Cycle Count :&nbsp;&nbsp;<font
color=#41CD52> {{
states('sensor.yambms_demo_bms_1_charging_cycles',
rounded=True) }}</font><br> Delta Cell Vol. :&nbsp;&nbsp;<font
color=#41CD52>0.007 V</font><br> MOS temp. :&nbsp;&nbsp;<font
color=#41CD52>25.6 °C</font><br> Min temp. :&nbsp;&nbsp;<font
color=#41CD52>{{
states('sensor.yambms_demo_bms_1_min_temperature',
rounded=True) }} °C</font>
- type: grid
square: false
columns: 2
cards:
- type: markdown
content: >-
<center>
01. 3.301 V / 0.050 Ω<br>
02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br>
04. 3.304 V / 0.050 Ω<br>
05. 3.305 V / 0.050 Ω<br>
06. 3.306 V / 0.050 Ω<br>
07. 3.307 V / 0.050 Ω<br>
08. 3.308 V / 0.050 Ω<br>
</center>
<center> 01. 3.301 V / 0.050 Ω<br> 02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br> 04. 3.304 V / 0.050 Ω<br> 05. 3.305
V / 0.050 Ω<br> 06. 3.306 V / 0.050 Ω<br> 07. 3.307 V / 0.050
Ω<br> 08. 3.308 V / 0.050 Ω<br> </center>
- type: markdown
content: >-
<center>
09. 3.309 V / 0.050 Ω<br>
10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br>
12. 3.312 V / 0.050 Ω<br>
13. 3.313 V / 0.050 Ω<br>
14. 3.314 V / 0.050 Ω<br>
15. 3.315 V / 0.050 Ω<br>
16. 3.316 V / 0.050 Ω<br>
</center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_1_enable_bluetooth_connection
name: Bluetooth
- entity: switch.yambms_demo_bms_1_online_status
name: Online ?
- entity: binary_sensor.yambms_demo_bms_1_can_be_combined
name: Can be combined
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
<center> 09. 3.309 V / 0.050 Ω<br> 10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br> 12. 3.312 V / 0.050 Ω<br> 13. 3.313
V / 0.050 Ω<br> 14. 3.314 V / 0.050 Ω<br> 15. 3.315 V / 0.050
Ω<br> 16. 3.316 V / 0.050 Ω<br> </center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_1_charge_switch
name: Charge
name: Charge switch
- entity: switch.yambms_demo_bms_1_discharge_switch
name: Discharge
name: Discharge switch
- entity: switch.yambms_demo_bms_1_balance_switch
name: Balance
name: Balance switch
- entity: switch.yambms_demo_bms_1_enable_bluetooth_connection
name: Bluetooth
- entity: number.yambms_demo_bms_1_charging_cycles_offset
name: Charging Cycles Offset
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
- type: grid
title: BMS 2
column_span: 1
cards:
- type: heading
heading: BMS 2
heading_style: title
badges:
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_2_online_status
color: state
name: Online
state_content: name
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_2_can_be_combined
color: state
name: Combined
state_content: name
- type: grid
square: false
columns: 1
cards:
- type: markdown
content: >-
<center>Time : <b><font color=red>1Y 37D 18H</font>
content: '<center>Time : <b><font color=red>1Y 37D 18H</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -500,8 +585,7 @@ views:
columns: 1
cards:
- type: markdown
content: >-
<center>Error : <b><font color=red>DEMO</font>
content: '<center>Error : <b><font color=red>DEMO</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -512,43 +596,47 @@ views:
- type: markdown
content: >-
<center>Charge : <b>{% if
states('switch.yambms_demo_bms_2_charge_switch') == 'on'
%} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_charge_switch') | upper
}}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_2_charge_switch') | upper
}}</font> {% endif %}
states('switch.yambms_demo_bms_2_charge_switch', rounded=True)
== 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_charge_switch', rounded=True)
| upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_2_charge_switch', rounded=True)
| upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Discharge : <b> {% if
states('switch.yambms_demo_bms_2_discharge_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_discharge_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_2_discharge_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_2_discharge_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_discharge_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_2_discharge_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Balance : <b> {% if
states('switch.yambms_demo_bms_2_balance_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_balance_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_2_balance_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_2_balance_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_2_balance_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_2_balance_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_2_total_voltage') }}
V</font></b>
states('sensor.yambms_demo_bms_2_total_voltage', rounded=True)
}} V</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_2_current') }} A</font></b>
states('sensor.yambms_demo_bms_2_current', rounded=True) }}
A</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_2_power') }} W</font>
states('sensor.yambms_demo_bms_2_power', rounded=True) }}
W</font>
- type: grid
square: false
columns: 2
@@ -556,99 +644,95 @@ views:
- type: markdown
content: >-
<center><b><font size=4>SoC :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_2_battery_soc')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_2_battery_soc',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center><b><font size=4>SoH :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_2_battery_soh')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_2_battery_soh',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center> Battery Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_2_battery_capacity') }} Ah</font><br>
Cycle Capacity :&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br>
Ave. Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00 A</font><br>
Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_2_max_temperature') }} °C</font>
states('sensor.yambms_demo_bms_2_battery_capacity',
rounded=True) }} Ah</font><br> Cycle Capacity
:&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br> Ave. Cell
Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00
A</font><br> Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_2_max_temperature',
rounded=True) }} °C</font>
- type: markdown
content: >-
<center> Remain Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_2_capacity_remaining') }} Ah</font><br>
Cycle Count :&nbsp;&nbsp;<font color=#41CD52>
{{ states('sensor.yambms_demo_bms_2_charging_cycles') }}</font><br>
Delta Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>0.007 V</font><br>
MOS temp. :&nbsp;&nbsp;<font color=#41CD52>25.6 °C</font><br>
Min temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_2_min_temperature') }} °C</font>
states('sensor.yambms_demo_bms_2_capacity_remaining',
rounded=True) }} Ah</font><br> Cycle Count :&nbsp;&nbsp;<font
color=#41CD52> {{
states('sensor.yambms_demo_bms_2_charging_cycles',
rounded=True) }}</font><br> Delta Cell Vol. :&nbsp;&nbsp;<font
color=#41CD52>0.007 V</font><br> MOS temp. :&nbsp;&nbsp;<font
color=#41CD52>25.6 °C</font><br> Min temp. :&nbsp;&nbsp;<font
color=#41CD52>{{
states('sensor.yambms_demo_bms_2_min_temperature',
rounded=True) }} °C</font>
- type: grid
square: false
columns: 2
cards:
- type: markdown
content: >-
<center>
01. 3.301 V / 0.050 Ω<br>
02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br>
04. 3.304 V / 0.050 Ω<br>
05. 3.305 V / 0.050 Ω<br>
06. 3.306 V / 0.050 Ω<br>
07. 3.307 V / 0.050 Ω<br>
08. 3.308 V / 0.050 Ω<br>
</center>
<center> 01. 3.301 V / 0.050 Ω<br> 02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br> 04. 3.304 V / 0.050 Ω<br> 05. 3.305
V / 0.050 Ω<br> 06. 3.306 V / 0.050 Ω<br> 07. 3.307 V / 0.050
Ω<br> 08. 3.308 V / 0.050 Ω<br> </center>
- type: markdown
content: >-
<center>
09. 3.309 V / 0.050 Ω<br>
10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br>
12. 3.312 V / 0.050 Ω<br>
13. 3.313 V / 0.050 Ω<br>
14. 3.314 V / 0.050 Ω<br>
15. 3.315 V / 0.050 Ω<br>
16. 3.316 V / 0.050 Ω<br>
</center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_2_enable_bluetooth_connection
name: Bluetooth
- entity: switch.yambms_demo_bms_2_online_status
name: Online ?
- entity: binary_sensor.yambms_demo_bms_2_can_be_combined
name: Can be combined
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
<center> 09. 3.309 V / 0.050 Ω<br> 10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br> 12. 3.312 V / 0.050 Ω<br> 13. 3.313
V / 0.050 Ω<br> 14. 3.314 V / 0.050 Ω<br> 15. 3.315 V / 0.050
Ω<br> 16. 3.316 V / 0.050 Ω<br> </center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_2_charge_switch
name: Charge
name: Charge switch
- entity: switch.yambms_demo_bms_2_discharge_switch
name: Discharge
name: Discharge switch
- entity: switch.yambms_demo_bms_2_balance_switch
name: Balance
name: Balance switch
- entity: switch.yambms_demo_bms_2_enable_bluetooth_connection
name: Bluetooth
- entity: number.yambms_demo_bms_2_charging_cycles_offset
name: Charging Cycles Offset
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
- type: grid
title: BMS 3
column_span: 1
cards:
- type: heading
heading: BMS 3
heading_style: title
badges:
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_3_online_status
color: state
name: Online
state_content: name
- type: entity
show_state: true
show_icon: true
entity: binary_sensor.yambms_demo_bms_3_can_be_combined
color: state
name: Combined
state_content: name
- type: grid
square: false
columns: 1
cards:
- type: markdown
content: >-
<center>Time : <b><font color=red>1Y 3D 15H</font>
content: '<center>Time : <b><font color=red>1Y 3D 15H</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -657,8 +741,7 @@ views:
columns: 1
cards:
- type: markdown
content: >-
<center>Error : <b><font color=red>DEMO</font>
content: '<center>Error : <b><font color=red>DEMO</font>'
layout_options:
grid_columns: 2
grid_rows: 1
@@ -669,43 +752,47 @@ views:
- type: markdown
content: >-
<center>Charge : <b>{% if
states('switch.yambms_demo_bms_3_charge_switch') == 'on'
%} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_charge_switch') | upper
}}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_3_charge_switch') | upper
}}</font> {% endif %}
states('switch.yambms_demo_bms_3_charge_switch', rounded=True)
== 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_charge_switch', rounded=True)
| upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_3_charge_switch', rounded=True)
| upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Discharge : <b> {% if
states('switch.yambms_demo_bms_3_discharge_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_discharge_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_3_discharge_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_3_discharge_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_discharge_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_3_discharge_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center>Balance : <b> {% if
states('switch.yambms_demo_bms_3_balance_switch') ==
'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_balance_switch') |
upper }}</font> {% else %} <font color=#3090C7>{{
states('switch.yambms_demo_bms_3_balance_switch') |
upper }}</font> {% endif %}
states('switch.yambms_demo_bms_3_balance_switch',
rounded=True) == 'on' %} <font color=#41CD52>{{
states('switch.yambms_demo_bms_3_balance_switch',
rounded=True) | upper }}</font> {% else %} <font
color=#3090C7>{{
states('switch.yambms_demo_bms_3_balance_switch',
rounded=True) | upper }}</font> {% endif %}
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_3_total_voltage') }}
V</font></b>
states('sensor.yambms_demo_bms_3_total_voltage', rounded=True)
}} V</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_3_current') }} A</font></b>
states('sensor.yambms_demo_bms_3_current', rounded=True) }}
A</font></b>
- type: markdown
content: >-
<center><b><font color=#41CD52 size=4>{{
states('sensor.yambms_demo_bms_3_power') }} W</font>
states('sensor.yambms_demo_bms_3_power', rounded=True) }}
W</font>
- type: grid
square: false
columns: 2
@@ -713,94 +800,76 @@ views:
- type: markdown
content: >-
<center><b><font size=4>SoC :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_3_battery_soc')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_3_battery_soc',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center><b><font size=4>SoH :&nbsp;&nbsp;<font color=#41CD52
size=4>{{ states('sensor.yambms_demo_bms_3_battery_soh')
}} %</font></font>
size=4>{{ states('sensor.yambms_demo_bms_3_battery_soh',
rounded=True) }} %</font></font>
- type: markdown
content: >-
<center> Battery Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_3_battery_capacity') }} Ah</font><br>
Cycle Capacity :&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br>
Ave. Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00 A</font><br>
Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_3_max_temperature') }} °C</font>
states('sensor.yambms_demo_bms_3_battery_capacity',
rounded=True) }} Ah</font><br> Cycle Capacity
:&nbsp;&nbsp;<font color=#41CD52>12532 Ah</font><br> Ave. Cell
Vol. :&nbsp;&nbsp;<font color=#41CD52>3.329 V</font><br>
Balance Cur. :&nbsp;&nbsp;<font color=#41CD52>0.00
A</font><br> Max temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_3_max_temperature',
rounded=True) }} °C</font>
- type: markdown
content: >-
<center> Remain Capacity :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_3_capacity_remaining') }} Ah</font><br>
Cycle Count :&nbsp;&nbsp;<font color=#41CD52>
{{ states('sensor.yambms_demo_bms_3_charging_cycles') }}</font><br>
Delta Cell Vol. :&nbsp;&nbsp;<font color=#41CD52>0.007 V</font><br>
MOS temp. :&nbsp;&nbsp;<font color=#41CD52>25.6 °C</font><br>
Min temp. :&nbsp;&nbsp;<font color=#41CD52>{{
states('sensor.yambms_demo_bms_3_min_temperature') }} °C</font>
states('sensor.yambms_demo_bms_3_capacity_remaining',
rounded=True) }} Ah</font><br> Cycle Count :&nbsp;&nbsp;<font
color=#41CD52> {{
states('sensor.yambms_demo_bms_3_charging_cycles',
rounded=True) }}</font><br> Delta Cell Vol. :&nbsp;&nbsp;<font
color=#41CD52>0.007 V</font><br> MOS temp. :&nbsp;&nbsp;<font
color=#41CD52>25.6 °C</font><br> Min temp. :&nbsp;&nbsp;<font
color=#41CD52>{{
states('sensor.yambms_demo_bms_3_min_temperature',
rounded=True) }} °C</font>
- type: grid
square: false
columns: 2
cards:
- type: markdown
content: >-
<center>
01. 3.301 V / 0.050 Ω<br>
02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br>
04. 3.304 V / 0.050 Ω<br>
05. 3.305 V / 0.050 Ω<br>
06. 3.306 V / 0.050 Ω<br>
07. 3.307 V / 0.050 Ω<br>
08. 3.308 V / 0.050 Ω<br>
</center>
<center> 01. 3.301 V / 0.050 Ω<br> 02. 3.302 V / 0.050 Ω<br>
03. 3.303 V / 0.050 Ω<br> 04. 3.304 V / 0.050 Ω<br> 05. 3.305
V / 0.050 Ω<br> 06. 3.306 V / 0.050 Ω<br> 07. 3.307 V / 0.050
Ω<br> 08. 3.308 V / 0.050 Ω<br> </center>
- type: markdown
content: >-
<center>
09. 3.309 V / 0.050 Ω<br>
10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br>
12. 3.312 V / 0.050 Ω<br>
13. 3.313 V / 0.050 Ω<br>
14. 3.314 V / 0.050 Ω<br>
15. 3.315 V / 0.050 Ω<br>
16. 3.316 V / 0.050 Ω<br>
</center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_3_enable_bluetooth_connection
name: Bluetooth
- entity: switch.yambms_demo_bms_3_online_status
name: Online ?
- entity: binary_sensor.yambms_demo_bms_3_can_be_combined
name: Can be combined
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
<center> 09. 3.309 V / 0.050 Ω<br> 10. 3.310 V / 0.050 Ω<br>
11. 3.311 V / 0.050 Ω<br> 12. 3.312 V / 0.050 Ω<br> 13. 3.313
V / 0.050 Ω<br> 14. 3.314 V / 0.050 Ω<br> 15. 3.315 V / 0.050
Ω<br> 16. 3.316 V / 0.050 Ω<br> </center>
- type: entity-filter
entities:
- entity: switch.yambms_demo_bms_3_charge_switch
name: Charge
name: Charge switch
- entity: switch.yambms_demo_bms_3_discharge_switch
name: Discharge
name: Discharge switch
- entity: switch.yambms_demo_bms_3_balance_switch
name: Balance
name: Balance switch
- entity: switch.yambms_demo_bms_3_enable_bluetooth_connection
name: Bluetooth
- entity: number.yambms_demo_bms_3_charging_cycles_offset
name: Charging Cycles Offset
conditions:
- condition: state
state_not: unavailable
layout_options:
grid_columns: 2
grid_rows: 3
- title: Shunt
type: sections
max_columns: 3
sections:
- type: grid
cards:
- type: heading
heading: Shunt 1
- graph: line
type: sensor
entity: sensor.yambms_demo_shunt_1_voltage
@@ -812,7 +881,7 @@ views:
hours_to_show: 8
- graph: line
type: sensor
entity: sensor.yambms_demo_shunt_1_soc
entity: sensor.yambms_demo_shunt_1_state_of_charge
detail: 2
name: SoC
hours_to_show: 8
@@ -850,7 +919,7 @@ views:
name: Shunt 1 Current
- entity: sensor.yambms_demo_shunt_1_power
name: Shunt 1 Power
- entity: sensor.yambms_demo_shunt_1_soc
- entity: sensor.yambms_demo_shunt_1_state_of_charge
name: Shunt 1 SoC
- entity: sensor.yambms_demo_shunt_1_temperature
name: Shunt 1 Temperature
@@ -869,5 +938,4 @@ views:
name: Shunt 1 Combine enabled
- entity: binary_sensor.yambms_demo_shunt_1_can_be_combined
name: Shunt 1 Can be combined
title: Shunt 1
column_span: 1
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.07.30
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,6 +24,8 @@ views:
sections:
- type: grid
cards:
- type: heading
heading: YamBMS - Battery
- graph: line
type: sensor
entity: sensor.yambms_yambms_1_total_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
+28 -92
View File
@@ -7,15 +7,22 @@
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
[!["Buy Me A Coffee"](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg)](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]
> Not sure which YAML to choose ? ... `YamBMS_Remote_Packages_example.yaml` is a good basis for creating your custom YAML.
> Examples of BMS and Shunt imports can be found in the [configuration_examples](configuration_examples/) folder.
> You can mix different BMS models, the only condition is that they are numbered in order starting from `1`.
> 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.
> 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> |
@@ -50,14 +57,23 @@
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)
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
## YamBMS ( Yet another multi-BMS Merging Solution )
![Image](images/YamBMS_packaged_version.png "YamBMS packaged version")
![Image](images/YamBMS_Overview.png "YamBMS Overview")
## 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
@@ -113,7 +129,7 @@ rx_pin: 22 # to CAN board CRX (with 4.7K resistor except for SN65HVD230)
## Requirements
* [ESPHome 2025.5.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)
@@ -140,86 +156,6 @@ for statistics collection. Only [@Sleeper85](https://github.com/Sleeper85) have
- Uptime
- Current date and time
## Changelog
* 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`
## References
* Thanks to [@syssi](https://github.com/syssi/esphome-jk-bms) for help and making many BMS components (JK, JBD, Seplos, Pace, etc.)
-221
View File
@@ -1,221 +0,0 @@
# Updated : 2025.06.17
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '30'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '60'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# This list is incomplete, other board.yaml are available in the board folder
# device_board: !include 'packages/board/board_ESP32_Generic.yaml'
# device_board: !include 'packages/board/board_ESP32_DevKit-V1.yaml'
# device_board: !include 'packages/board/board_ESP32_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'
# vars:
# display_auto_next_page_interval: '5s'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
# device_board: !include
# file: '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
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
# MCP2515
# canbus_node_2: !include
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
# vars:
# canbus_node_id: 'canbus_inverter_1'
# captive_portal: !include packages/board/board_options_captive_portal.yaml
############################################################
# 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'
yambms: !include packages/yambms/yambms.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
-300
View File
@@ -1,300 +0,0 @@
# Updated : 2025.06.12
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS Demo' # Prefix added in front of all entity names and also to classify them.
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '30'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '60'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> 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'
# vars:
# display_auto_next_page_interval: '5s'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
# device_board: !include
# file: '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
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
captive_portal: !include packages/board/board_options_captive_portal.yaml
# uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
# MCP2515
# canbus_node_2: !include
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
# vars:
# canbus_node_id: 'canbus_inverter_1'
############################################################
shunt1: !include
file: packages/shunt/shunt_combine_FAKE.yaml
vars:
shunt_id: '1' # must be a number
shunt_name: 'Shunt 1'
# Shunt sensors values
shunt_voltage: '53.41' # V
shunt_current: '37.5' # A
shunt_power: '2003' # W
shunt_soc: '86' # %
bms1: !include
file: packages/bms/bms_combine_FAKE.yaml
vars:
bms_id: '1' # must be a number
bms_name: 'BMS 1'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_battery_capacity_remaining: '243' # Ah
bms_voltage: '53.45' # V
bms_current: '9.2' # A
bms_power: '492' # W
bms_soc: '87' # %
bms_soh: '99' # %
bms_min_cell_voltage: '3.339' # V
bms_min_voltage_cell: '2' # cell number 1~16
bms_max_cell_voltage: '3.341' # V
bms_max_voltage_cell: '11' # cell number 1~16
bms_temperature_sensor_1: '21.1' # °C
bms_temperature_sensor_2: '21.3' # °C
bms_temperature_sensor_3: '21.5' # °C
bms_temperature_sensor_4: '21.7' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
bms_charging_cycles: '178' # charging cycles number Used to calculate the SoH
bms2: !include
file: packages/bms/bms_combine_FAKE.yaml
vars:
bms_id: '2' # must be a number
bms_name: 'BMS 2'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_battery_capacity_remaining: '238' # Ah
bms_voltage: '53.41' # V
bms_current: '11.3' # A
bms_power: '604' # W
bms_soc: '85' # %
bms_soh: '89' # %
bms_min_cell_voltage: '3.337' # V
bms_min_voltage_cell: '14' # cell number 1~16
bms_max_cell_voltage: '3.339' # V
bms_max_voltage_cell: '3' # cell number 1~16
bms_temperature_sensor_1: '21.8' # °C
bms_temperature_sensor_2: '21.6' # °C
bms_temperature_sensor_3: '21.4' # °C
bms_temperature_sensor_4: '21.2' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
bms_charging_cycles: '226' # charging cycles number Used to calculate the SoH
bms3: !include
file: packages/bms/bms_combine_FAKE.yaml
vars:
bms_id: '3' # must be a number
bms_name: 'BMS 3'
# BMS sensors values
bms_battery_capacity: '280' # Ah
bms_battery_capacity_remaining: '232' # Ah
bms_voltage: '53.37' # V
bms_current: '15.7' # A
bms_power: '838' # W
bms_soc: '83' # %
bms_soh: '79' # %
bms_min_cell_voltage: '3.334' # V
bms_min_voltage_cell: '7' # cell number 1~16
bms_max_cell_voltage: '3.336' # V
bms_max_voltage_cell: '9' # cell number 1~16
bms_temperature_sensor_1: '21.9' # °C
bms_temperature_sensor_2: '22.0' # °C
bms_temperature_sensor_3: '22.1' # °C
bms_temperature_sensor_4: '22.2' # °C
bms_max_charge_current: '100' # A
bms_max_discharge_current: '100' # A
bms_cell_ovp: '3.650' # V Used by 'Auto CCL' functions
bms_cell_uvp: '2.800' # V Used by 'Auto DCL' functions and to calculate maximum discharge voltage
bms_balance_trigger_voltage: '0.010' # V Used by 'Auto CVL' functions
bms_charging_cycles: '194' # charging cycles number Used to calculate the SoH
yambms: !include packages/yambms/yambms.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
-236
View File
@@ -1,236 +0,0 @@
# Updated : 2025.06.12
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '30'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '60'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# This list is incomplete, other board.yaml are available in the board folder
# device_board: !include 'packages/board/board_ESP32_Generic.yaml'
# device_board: !include 'packages/board/board_ESP32_DevKit-V1.yaml'
# device_board: !include 'packages/board/board_ESP32_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'
# vars:
# display_auto_next_page_interval: '5s'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
# device_board: !include
# file: '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
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# RS485
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
# MCP2515
canbus_node_2: !include
file: packages/board/board_options_itf_canbus_mcp2515.yaml
vars:
canbus_node_id: 'canbus_bms_1'
# If you do not want to use the default settings, uncomment the options below :
# canbus_can_id: '4'
# canbus_bitrate: '500kbps'
# spi_mosi_pin: '12'
# spi_miso_pin: '5'
# spi_clk_pin: '18'
# mcp2515_cs_pin: '32'
############################################################
# 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' # Second module
yambms: !include packages/yambms/yambms.yaml
# yambms_custom: !include yambms_custom.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
-257
View File
@@ -1,257 +0,0 @@
# Updated : 2025.06.16
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '30'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '60'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> 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'
# vars:
# display_auto_next_page_interval: '5s'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
# device_board: !include
# file: '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
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
# MCP2515
# canbus_node_2: !include
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
# vars:
# canbus_node_id: 'canbus_inverter_1'
############################################################
# 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.yaml # shunt_combine_Junctek_KHF_UART.yaml
# vars:
# shunt_id: '1' # must be a number
# shunt_name: 'Shunt 1'
# shunt_uart_id: 'uart_esp_3'
# 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
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'
yambms: !include packages/yambms/yambms.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
-319
View File
@@ -1,319 +0,0 @@
# Updated : 2025.06.12
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '30'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '60'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> 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'
# vars:
# display_auto_next_page_interval: '5s'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
# device_board: !include
# file: '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
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# uart_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
# uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
# MCP2515
# canbus_node_2: !include
# file: packages/board/board_options_itf_canbus_mcp2515.yaml
# vars:
# canbus_node_id: 'canbus_inverter_1'
############################################################
# 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.yaml # shunt_combine_Junctek_KHF_UART.yaml
# vars:
# shunt_id: '1' # must be a number
# shunt_name: 'Shunt 1'
# shunt_uart_id: 'uart_esp_3'
# 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
# The sniffer represents the ESP node connected to the JK-BMS PB RS485 bus
# If address 0x00 is not detected on the RS485 bus, the sniffer will act directly as a master BMS (mode 2, max 15 BMS)
# sniffer1: !include
# file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer_talk_pin.yaml
# vars:
# sniffer_id: 'sniffer1'
# sniffer_protocol: 'JK02_32S'
# sniffer_uart_id: 'uart_esp_1'
# sniffer_talk_pin: 8 # ESP32: 4, ESP32-S3: 8, ESP32-C3: 10
sniffer1: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_sniffer.yaml
vars:
sniffer_id: 'sniffer1'
sniffer_protocol: 'JK02_32S'
sniffer_uart_id: 'uart_esp_1'
# Mode2 : configure the DIP switches of your BMS from 0x01 to 0x0F (don't use the 0x00 address, maximum 15 BMS)
bms1: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '1' # must be a number
bms_name: 'JK-BMS 1'
bms_address: '0x01' # BMS 1 DIP switch
bms2: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '2' # must be a number
bms_name: 'JK-BMS 2'
bms_address: '0x02' # BMS 2 DIP switch
bms3: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '3' # must be a number
bms_name: 'JK-BMS 3'
bms_address: '0x03' # BMS 3 DIP switch
bms4: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '4' # must be a number
bms_name: 'JK-BMS 4'
bms_address: '0x04' # BMS 4 DIP switch
bms5: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '5' # must be a number
bms_name: 'JK-BMS 5'
bms_address: '0x05' # BMS 5 DIP switch
bms6: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '6' # must be a number
bms_name: 'JK-BMS 6'
bms_address: '0x06' # BMS 6 DIP switch
bms7: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '7' # must be a number
bms_name: 'JK-BMS 7'
bms_address: '0x07' # BMS 7 DIP switch
bms8: !include
file: packages/bms/bms_combine_JK_RS485_Modbus_bms_standard.yaml
vars:
# Sniffer ID
sniffer_id: 'sniffer1'
# BMS vars
bms_id: '8' # must be a number
bms_name: 'JK-BMS 8'
bms_address: '0x08' # BMS 8 DIP switch
yambms: !include packages/yambms/yambms.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
+151 -96
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -17,15 +17,14 @@
# 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 #########################
######################## YamBMS Remote Packages Version ########################
# You need to copy the `packages` folder into the same folder as this YAML in order to compile it.
# 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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
@@ -39,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -56,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'pvbrain2' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -98,8 +90,14 @@ substitutions:
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 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
@@ -110,99 +108,156 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | WK2168 UART expander |
# | UART expander 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}
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}
# +--------------------------------------+
# | PVbrain2 packages |
# | 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
# 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
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
# Devices
# device_uart_esp: !include pvbrain2/base/device_uart_esp.yaml
device_wk2168_spi: !include pvbrain2/base/device_wk2168_spi.yaml
# device_wk2168_i2c: !include pvbrain2/base/device_wk2168_i2c.yaml
# device_sx1509: !include pvbrain2/base/device_sx1509.yaml
device_canbus_node1: !include pvbrain2/base/device_canbus_esp32can.yaml # canbus_node1
device_canbus_node2: !include pvbrain2/base/device_canbus_mcp2515.yaml # canbus_node2
# 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
# +--------------------------------------+
# | YamBMS packages |
# +--------------------------------------+
# 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
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# 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'
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
# You don't have to import a shunt but you must import at least one BMS.
# shunt1: !include
# file: packages/shunt/shunt_combine_Victron_SmartShunt_UART_expander.yaml # shunt_combine_Junctek_KHF_UART.yaml
# vars:
# shunt_id: '1' # must be a number
# shunt_name: 'Shunt 1'
# shunt_uart_id: 'uart_${uart_hub_bus}_2'
bms1: !include
file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
vars:
bms_id: '1' # must be a number
bms_name: 'JK-BMS 1'
bms_uart_id: 'uart_${uart_hub_bus}_4'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
bms2: !include
file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
vars:
bms_id: '2' # must be a number
bms_name: 'JK-BMS 2'
bms_uart_id: 'uart_${uart_hub_bus}_5'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
yambms: !include packages/yambms/yambms.yaml
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,5 +1,5 @@
# Updated : 2025.06.19
# Version : 1.5.6
# Updated : 2025.07.29
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -32,9 +32,9 @@ logger:
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -52,19 +52,10 @@ substitutions:
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_LP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############################################################
device_board: !include packages/board/board_RP2040_RPi_Pico.yaml
uart_1: !include packages/board/board_options_itf_uart_1.yaml
-205
View File
@@ -1,205 +0,0 @@
# Updated : 2025.06.12
# Version : 1.5.6
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
# This YAML is free software: you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation, either version 3
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
# static_ip: 192.168.0.85
# gateway: 192.168.0.1
# subnet: 255.255.255.0
# dns1: 8.8.8.8
# dns2: 8.8.4.4
logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
# If there is no HA server connected to this API, the ESP32 reboots every 15 minutes to try to resolve the problem.
# The "reboot_timeout: 0s" option will keep your ESP32 up and running even if you lose connection to your HA server.
api:
reboot_timeout: 0s
# If you don't want to use ESPHome's native API you can use MQTT instead.
# In this case don't forget to remove the 'api:' section.
# mqtt:
# broker: !secret mqtt_host
# username: !secret mqtt_username
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
#web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# ESP32 name / hostname
name: ''
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS'
# +--------------------------------------+
# | YamBMS Settings |
# +--------------------------------------+
# Please read the cut-off charging logic README to understand how the YamBMS works
yambms_id: 'yambms1'
yambms_name: 'YamBMS 1'
yambms_update_interval: '1s'
# Input numbers can be displayed as a slider or an input box, options are 'slider' or 'box'.
yambms_input_number_mode: 'slider'
# Please check and fill in the options below correctly according to your battery chemistry and number of cells in series.
# These parameters are important and used for charging logic.
# Battery Chemistry
yambms_battery_chemistry: '1' # 1-LFP | 2-Li-ion | 3-LTO
# Number of cells in series
yambms_cell_count: '16'
# Bulk / Absorption Voltage : corresponds to the Bulk voltage that will be used to charge the battery. (LFP : 55.2V = 3.45V/Cell for 16S battery)
yambms_bulk_v: '55.2'
# Float Voltage : corresponds to the voltage at which the battery would be maintained at the end of charge. (LFP : 53.6V = 3.35V/Cell for 16S battery)
yambms_float_v: '53.6'
# Rebulk voltage, voltage from which a new Bulk charge can start. (LFP : 52.8V = 3.3V/Cell for 16S battery)
yambms_rebulk_v: '52.8'
# Maximum time in minutes that the cut-off step can last before charging is complete
# If your cells are properly balanced this step ends at the fastest after the `cut-off timer`
# This timer can be deactivated with a switch
yambms_eoc_timer: '60'
# Time in seconds during which the end of charge conditions must be respected (cut-off + cells not equalizing)
yambms_cutoff_timer: '300'
# +--------------------------------------+
# | Shunt Settings |
# +--------------------------------------+
shunt_update_interval: '3s' # frequency at which Shunt data is refreshed
shunt_combine_interval: '1s' # frequency at which Shunt data is combined in YamBMS
# +--------------------------------------+
# | BMS Settings |
# +--------------------------------------+
bms_update_interval: '3s' # frequency at which BMS data is refreshed, going below '3s' can cause problems
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
device_board: !include packages/board/board_ESP32-S3_YBoard.yaml
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
uart_esp_1: !include packages/board/board_options_itf_uart_esp_1.yaml
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
canbus_node_1: !include
file: packages/board/board_options_itf_canbus_esp32_can.yaml
vars:
canbus_node_id: 'canbus_inverter_1'
############################################################
# 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_BLE.yaml
vars:
shunt_id: '1' # must be a number
shunt_name: 'Shunt'
shunt_mac_address: 'c0960b5d8cba'
shunt_encryption_key: '1e196f635d4e5b0777afa79b47904937'
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
yambms: !include packages/yambms/yambms.yaml
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
canbus_node_id: 'canbus_inverter_1'
canbus_light_id: 'esp_light'
# The CANBUS link will be considered down if no response from the inverter (ID 0x305) for 5s
# The Deye inverter sends the ACK (can_id 0x305) only when it receives the can_id 0x356
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
device_debug: !include
file: packages/base/device_debug_ESP32.yaml
vars:
debug_name: 'Debug'
debug_update_interval: '5s'
+114 -75
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -17,15 +17,14 @@
# 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 #########################
######################## YamBMS Remote Packages Version ########################
# You need to copy the `packages` folder into the same folder as this YAML in order to compile it.
# 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
################################################################################
# Don't forget to configure your WiFi credentials in the secrets.yaml
#
# If needed, configure a static IP here
# wifi:
# manual_ip:
@@ -39,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -56,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -98,8 +90,14 @@ substitutions:
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 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
@@ -110,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_LP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
# This list is incomplete, other board.yaml are available in the board folder
@@ -148,93 +142,138 @@ packages:
# device_board: !include 'packages/board/board_ESP32-S3_YBoard.yaml'
# device_board: !include
# file: 'packages/board/board_ESP32-S3_AtomS3.yaml'
# 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
# device_board: !include
# file: 'packages/board/board_ESP32-S3_AtomS3R.yaml'
# # 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'
# display_rotation: '0' # 0/90/180/270 rotation angle in degrees
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> 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_esp_2: !include packages/board/board_options_itf_uart_esp_2.yaml
uart_esp_3: !include packages/board/board_options_itf_uart_esp_3.yaml
# 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
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# 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_3'
# >>> 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/
# 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
bms1: !include
file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
vars:
bms_id: '1' # must be a number
bms_name: 'JK-BMS 1'
bms_uart_id: 'uart_esp_1'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
bms2: !include
file: packages/bms/bms_combine_JK_UART_4G-GPS_full.yaml
vars:
bms_id: '2' # must be a number
bms_name: 'JK-BMS 2'
bms_uart_id: 'uart_esp_2'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
# +------------------------------------------------------------------------------+
# | >>> YamBMS
# +------------------------------------------------------------------------------+
yambms: !include packages/yambms/yambms.yaml
# +------------------------------------------------------------------------------+
# | >>> CAN bus to Inverter
# +------------------------------------------------------------------------------+
canbus1: !include
file: packages/yambms/yambms_canbus.yaml
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'
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'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
+115 -77
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.17
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,35 +108,31 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> 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_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_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'
@@ -149,81 +144,75 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# BLE Shunt
# 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
# >>> 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
@@ -249,6 +238,12 @@ packages:
bms_name: 'BASEN-BMS 2'
bms_address: '0x02'
# +------------------------------------------------------------------------------+
# | >>> YamBMS
# +------------------------------------------------------------------------------+
yambms:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
@@ -256,12 +251,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -271,9 +272,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -281,6 +303,22 @@ packages:
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
+110 -52
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.14
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS Demo' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
board:
url: https://github.com/Sleeper85/esphome-yambms
@@ -149,54 +144,68 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# Captive Portal
- path: 'packages/board/board_options_captive_portal.yaml'
# UART 1
# UART 1 (uart_id: uart_esp_1)
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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
@@ -212,7 +221,7 @@ packages:
shunt_voltage: '53.41' # V
shunt_current: '37.5' # A
shunt_power: '2003' # W
shunt_soc: '86' # %
shunt_soc: '86' # %e/
bms:
url: https://github.com/Sleeper85/esphome-yambms
@@ -301,6 +310,12 @@ packages:
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
@@ -308,12 +323,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -323,9 +344,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -333,6 +375,22 @@ packages:
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
+333
View File
@@ -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
+274
View File
@@ -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
+113 -75
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.16
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
board:
url: https://github.com/Sleeper85/esphome-yambms
@@ -149,81 +144,75 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# BLE Shunt
# 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
# >>> 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
@@ -266,6 +255,12 @@ packages:
# 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
@@ -273,12 +268,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -288,9 +289,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -298,6 +320,22 @@ packages:
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
+115 -77
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.14
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,31 +108,27 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> 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_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'
@@ -143,87 +138,81 @@ packages:
# - 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_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'
# - 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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# BLE Shunt
# 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
# >>> 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
@@ -309,6 +298,12 @@ packages:
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
@@ -316,12 +311,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -331,9 +332,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -341,6 +363,22 @@ packages:
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
+115 -77
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.14
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,31 +108,27 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> 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_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'
@@ -143,87 +138,81 @@ packages:
# - 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_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'
# - 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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# BLE Shunt
# 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
# >>> 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
@@ -309,6 +298,12 @@ packages:
bms_name: 'JK-BMS 8'
bms_address: '0x08' # BMS 8 DIP switch
# +------------------------------------------------------------------------------+
# | >>> YamBMS
# +------------------------------------------------------------------------------+
yambms:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
@@ -316,12 +311,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -331,9 +332,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -341,6 +363,22 @@ packages:
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
+112 -88
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.14
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
board:
url: https://github.com/Sleeper85/esphome-yambms
@@ -149,81 +144,75 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
# - path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_1'
# BLE Shunt
# 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
# >>> 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
@@ -251,19 +240,11 @@ packages:
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
# bms_options:
# 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
# +------------------------------------------------------------------------------+
# | >>> YamBMS
# +------------------------------------------------------------------------------+
yambms:
url: https://github.com/Sleeper85/esphome-yambms
@@ -272,12 +253,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -287,9 +274,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -297,6 +305,22 @@ packages:
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
+324
View File
@@ -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
+144 -86
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'pvbrain2' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,93 +108,109 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | WK2168 UART expander |
# | UART expander 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}
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}
# +--------------------------------------+
# | PVbrain2 packages |
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
pvbrain2:
board:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
- path: 'packages/board/board_ESP32-S3_DevKitC-1_PVbrain2.yaml'
# BUS
# - path: 'pvbrain2/base/device_bus_i2c0.yaml' # SX1509 and BME280/BMP280
- path: 'pvbrain2/base/device_bus_spi1.yaml' # MCP2515
- path: 'pvbrain2/base/device_bus_one_wire.yaml' # Dallas
# Devices
# - path: 'pvbrain2/base/device_uart_esp.yaml'
- path: 'pvbrain2/base/device_wk2168_spi.yaml'
# - path: 'pvbrain2/base/device_wk2168_i2c.yaml'
# - path: 'pvbrain2/base/device_sx1509.yaml'
- path: 'pvbrain2/base/device_canbus_esp32can.yaml' # canbus_node1
- path: 'pvbrain2/base/device_canbus_mcp2515.yaml' # canbus_node2
# +--------------------------------------+
# | YamBMS packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
################ >>> CONFIG & CUSTOM LP <<< ################
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
# 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
############################################################
# You don't have to import a shunt but you must import at least one BMS.
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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'
bms:
board_options:
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'
# 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:
bms_id: '1' # must be a number
bms_name: 'JK-BMS 1'
bms_uart_id: 'uart_${uart_hub_bus}_4'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
# 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_${uart_hub_bus}_5'
# Maximum cell charging cycles is used to calculate the battey SoH.
# MB31=8000.0, LF280K v3=8000.0, LF280K v2=6000.0, LF280=3000.0 (decimal is required)
bms_cell_max_cycles: '6000.0'
# 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
@@ -204,24 +219,51 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
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 (0x305 frame) for 5s
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -229,6 +271,22 @@ packages:
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,5 +1,5 @@
# Updated : 2025.06.16
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
board:
url: https://github.com/Sleeper85/esphome-yambms
@@ -149,81 +144,75 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
# UART 2 (uart_id: uart_esp_2)
# - path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
# UART 3 (uart_id: uart_esp_3)
# - path: 'packages/board/board_options_itf_uart_esp_3.yaml'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# BLE Shunt
# 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
# >>> 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
@@ -275,6 +264,12 @@ packages:
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
@@ -282,12 +277,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -297,9 +298,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -307,6 +329,22 @@ packages:
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
+326
View File
@@ -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
+112 -112
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.14
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -38,7 +38,7 @@ logger:
level: INFO # VERBOSE / DEBUG / INFO / WARN
ota:
platform: esphome
- platform: esphome
# Please use the native `api` component instead of the `mqtt` section.
# If you use Home Assistant, the native API is more lightweight.
@@ -55,21 +55,14 @@ api:
# password: !secret mqtt_password
# id: mqtt_client
# Please note that enabling this component will take up a lot of memory and may decrease
# stability and be the cause of reboot depending on the capabilities of the board used.
# web_server:
# port: 80
# log: false
# ota: false
# +--------------------------------------+
# | Global Settings |
# +--------------------------------------+
substitutions:
# Name
name: '' # Name that can be added as a second prefix after the friendly name, you can leave it blank.
hostname: 'yambms' # This is the name of the node. It should always be unique in your ESPHome network.
friendly_name : 'YamBMS' # Prefix added in front of all entity names and also to classify them.
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 |
# +--------------------------------------+
@@ -97,8 +90,14 @@ substitutions:
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 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
@@ -109,24 +108,20 @@ substitutions:
bms_combine_interval: '1s' # frequency at which BMS data is combined in YamBMS
bms_cutoff_timer: '50s' # time during which the end of charge conditions must be respected (cut-off + cells not equalizing)
# +--------------------------------------+
# | Packages |
# +--------------------------------------+
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_main_YAML_HowTo.md
# PLEASE READ : https://github.com/Sleeper85/esphome-yambms/blob/main/documents/README/YamBMS_RP_YAML.md
packages:
################ >>> CONFIG & CUSTOM LP <<< ################
# 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
############### >>> UNCOMMENT YOUR BOARD <<< ###############
############### >>> ONLY ONE BOARD ! <<< ###############
# +------------------------------------------------------------------------------+
# | >>> UNCOMMENT YOUR BOARD
# | >>> ONLY ONE BOARD !
# +------------------------------------------------------------------------------+
board:
url: https://github.com/Sleeper85/esphome-yambms
@@ -149,119 +144,81 @@ packages:
# - path: 'packages/board/board_ESP32-S3_XIAO.yaml'
# - path: 'packages/board/board_ESP32-S3_YBoard.yaml'
# - path: 'packages/board/board_ESP32-S3_AtomS3.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
# - 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
# LilyGo T-Connect Pro
# Importing the display also activates PSRAM.
# Also note that the display update takes about 120 ms, as indicated in the logs:
# "Component display took a long time for an operation (124 ms)."
# Board
# # LilyGo T-Connect Pro - Board
# - path: 'packages/board/board_ESP32-S3_LilyGo-T-Connect-Pro.yaml'
# Display
# # 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'
########### >>> UNCOMMENT YOUR BOARD OPTIONS <<< ###########
# +------------------------------------------------------------------------------+
# | >>> Board Options
# | >>> Uncomment your interfaces and options
# +------------------------------------------------------------------------------+
board_options:
url: https://github.com/Sleeper85/esphome-yambms
ref: main
refresh: 0s
files:
# UART 1
# UART 1 (uart_id: uart_esp_1)
- path: 'packages/board/board_options_itf_uart_esp_1.yaml'
# UART 2
- path: 'packages/board/board_options_itf_uart_esp_2.yaml'
# UART 3
- path: 'packages/board/board_options_itf_uart_esp_3.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'
# ESP32_CAN (TJA105x, SN65HVD230, M5Stack CAN base/unit)
# 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'
# MCP2515
# 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 !
# UART Shunt
# shunt:
# url: https://github.com/Sleeper85/esphome-yambms
# ref: main
# refresh: 0s
# files:
# # Shunt 1
# - path: '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_3'
# >>> 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/
# BLE Shunt
# 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
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'
# bms_options:
# 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
# +------------------------------------------------------------------------------+
# | >>> YamBMS
# +------------------------------------------------------------------------------+
yambms:
url: https://github.com/Sleeper85/esphome-yambms
@@ -270,12 +227,18 @@ packages:
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'
- path: 'packages/yambms/yambms_canbus.yaml' # yambms_canbus_web_server.yaml
vars:
canbus_id: 'canbus1'
canbus_name: 'CANBUS 1'
@@ -285,9 +248,30 @@ packages:
# The Deye inverter sends the ACK 0x305 only when it receives the 0x356 frame.
canbus_link_timer: '5s'
# +--------------------------------------+
# | DEBUG ( logger level must be DEBUG ) |
# +--------------------------------------+
# +------------------------------------------------------------------------------+
# | >>> 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
@@ -295,6 +279,22 @@ packages:
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
+73 -6
View File
@@ -6,6 +6,17 @@
![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms)
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
> [!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.
@@ -20,7 +31,7 @@
## JK-PB BMS protocol
The datas from this BMS can be retrieved from the `RS485-2 (UART2)` network using the component [JK_RS485](https://github.com/txubelaxu/esphome-jk-bms/blob/main/components/jk_rs485_bms/README.md) of [@txubelaxu](https://github.com/txubelaxu).
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.
@@ -85,11 +96,11 @@ The following CAN protocols are supported on the CAN port:
> [!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 :
You are free to choose the hardware you want, the list below are 3 easy to use examples of **ESP32-S3 with PSRAM** :
- `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)
- [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).
@@ -105,6 +116,11 @@ The example below uses an `AtomS3` (display) with the `Atomic CAN base` and `RS4
> 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
@@ -142,13 +158,20 @@ The example below uses an `AtomS3` (display) with the `Atomic CAN base` and `RS4
## 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).
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
@@ -156,3 +179,47 @@ With mode 2, the sniffer (ESP32) will automatically take the address 0x00 and ac
![Image](../../images/YamBMS_JK-PB_RS485_Sniffer_Broadcast.png "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.
![Image](../../images/BMS_JK-PB_Charging_Float_Mode.png "BMS JK-PB Charging Float Mode")
### 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%`.
![Image](../../images/BMS_JK-PB_SoC_100pct_Logic.png "Broadcasting JK-PB settings to all BMS")
## 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"> |
+112
View File
@@ -0,0 +1,112 @@
# YamBMS - Changelog
[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest)
![GitHub stars](https://img.shields.io/github/stars/Sleeper85/esphome-yambms)
![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms)
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
* 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`
@@ -1,4 +1,4 @@
# YamBMS - Schematic and setup instructions
# YamBMS - Hardware and schematic instructions
[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest)
@@ -6,6 +6,10 @@
![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms)
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
## MCU default GPIOs
![Image](../../images/MCU_default_GPIOs.png "MCU default GPIOs")
## Contents
1) [Galvanic isolation](Galvanic_isolation.md)
+54 -12
View File
@@ -6,11 +6,57 @@
![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms)
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
## 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.
![Image](../../images/ESPHome_Builder_Overview.png "ESPHome Builder")
### 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 2025.3.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]
@@ -25,15 +71,15 @@ pip3 install esphome
### 2. Download all YAML files to your computer
> [!TIP]
> This step is not necessary if you are compiling the `Remote Packages` version of the YAML.
> 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
@@ -41,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
@@ -49,11 +95,7 @@ wifi_password: YourPassword
domain : .local
```
### 4. Install the YamBMS application into your ESP32
Create a copy of `YamBMS_Remote_Packages_example.yaml` and modify it to match your configuration.
Examples of BMS imports can be found in the [configuration_examples](configuration_examples/) folder.
You can mix different BMS models, the only condition is that they are numbered in order starting from `1`.
### 4. Install the `YamBMS.yaml` into your ESP32
```bash
# install your YamBMS.yaml
@@ -64,7 +106,7 @@ esphome run YamBMS.yaml
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.
+13 -11
View File
@@ -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,17 +36,18 @@
| --- | --- | --- |
| <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"> |
| [Olimex ESP32-EVB](https://github.com/OLIMEX/ESP32-EVB) |
| --- |
| <img src="../../images/MCU_ESP32-EVB.jpg" width="300">|
## Supported CAN bus transceiver
**Note: some inverters only accept a CAN bus at 3.3V in this case please choose the SN65HVD230 chip.**
@@ -1,4 +1,4 @@
# YamBMS - How to create your YamBMS YAML (Local Packages examples)
# YamBMS - How to create your YamBMS Local Packages YAML
[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest)
@@ -7,9 +7,11 @@
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
> [!TIP]
> Not sure which YAML to choose ? ... `YamBMS_Remote_Packages_example.yaml` is a good basis for creating your custom YAML.
> Examples of BMS imports can be found in the [configuration_examples](configuration_examples/) folder.
> You can mix different BMS models, the only condition is that they are numbered in order starting from `1`.
> 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.
@@ -72,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:
@@ -289,219 +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-BMS (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_BLE_standard.yaml # bms_modbus_JK_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
# 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'
```
### [JK-BMS (UART 4G-GPS)](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_UART_4G-GPS_full.yaml # bms_modbus_JK_UART_4G-GPS_full.yaml
vars:
bms_id: '1' # must be a number
bms_name: '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'
```
### [JK-BMS (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_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
# 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'
```
### [JK-BMS (RS485 Modbus)](https://github.com/txubelaxu/esphome-jk-bms/)
> [!TIP]
> Compatible with JK-PB, JK-B HW. >= 11A
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 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_RS485_Modbus_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_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
```
#### JK-BMS (JK-PB, JK-B HW. >= 11A)
```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_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: '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
# 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'
```
### [JBD (BLE)](https://github.com/syssi/esphome-jbd-bms)
```YAML
bms1: !include
file: packages/bms/bms_combine_JBD_BLE_full.yaml # bms_modbus_JBD_UART_full.yaml
vars:
bms_id: '1' # must be a number
bms_name: 'BMS 1'
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'
```
### [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
@@ -513,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
@@ -572,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'
@@ -593,15 +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'
# 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.
@@ -619,25 +375,35 @@ You can keep the default configuration.
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'
+421
View File
@@ -0,0 +1,421 @@
# YamBMS - How to create your YamBMS Remote Packages YAML
[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest)
![GitHub stars](https://img.shields.io/github/stars/Sleeper85/esphome-yambms)
![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms)
![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms)
> [!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'
```
+24 -4
View File
@@ -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.
![Image](../../images/YamBMS_Auto_CVL_CCL_DCL.png "YamBMS_Auto_CVL_CCL_DCL")
Thanks to [@GHswitt](https://github.com/GHswitt) for developing `Auto Float` function.
## Auto CVL
![Image](../../images/YamBMS_Auto_CVL.png "YamBMS 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
![Image](../../images/YamBMS_Auto_CCL_DCL.png "YamBMS 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.
@@ -115,6 +119,22 @@ You can compare `Auto CCL` to a max speed limiter in a car.
Current control should work with any inverter that uses `CAN` control.
## Auto Float Voltage
![Image](../../images/YamBMS_Auto_Float.png "YamBMS Auto Float")
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
![Image](../../images/YamBMS_Requested_Values.png "YamBMS_Requested_Values")
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -23,16 +23,10 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
packages:
modbus: !include
file: packages/base/device_modbus.yaml
file: packages/board/board_options_itf_modbus.yaml
vars:
modbus_role: 'client' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,15 +24,13 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
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/base/device_modbus.yaml
file: packages/board/board_options_itf_modbus.yaml
vars:
modbus_role: 'server' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,15 +24,13 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
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/base/device_modbus.yaml
file: packages/board/board_options_itf_modbus.yaml
vars:
modbus_role: 'server' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -23,12 +23,6 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
packages:
yambms_modbus_client:
@@ -37,7 +31,7 @@ packages:
refresh: 0s
files:
# Modbus client
- path: 'packages/base/device_modbus.yaml'
- path: 'packages/board/board_options_itf_modbus.yaml'
vars:
modbus_role: 'client' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,10 +24,8 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
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:
@@ -37,7 +35,7 @@ packages:
refresh: 0s
files:
# Modbus server
- path: 'packages/base/device_modbus.yaml'
- path: 'packages/board/board_options_itf_modbus.yaml'
vars:
modbus_role: 'server' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.02
# Version : 1.1.2
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -24,10 +24,8 @@
################################################################################
substitutions:
modbus_update_interval: '5s' # frequency with which BMS/Shunt modbus servers are queried
modbus_baud_rate: '19200' # 9600 / 19200 / 115200
modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
modbus_send_wait_time: '250ms' # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
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:
@@ -37,7 +35,7 @@ packages:
refresh: 0s
files:
# Modbus server
- path: 'packages/base/device_modbus.yaml'
- path: 'packages/board/board_options_itf_modbus.yaml'
vars:
modbus_role: 'server' # client / server
modbus_uart_id: 'uart_esp_1' # RS485 board
@@ -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
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -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
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -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
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -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 )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -1,5 +1,5 @@
# Updated : 2025.04.01
# Version : 1.5.5
# Updated : 2025.07.27
# Version : 1.1.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -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
Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 370 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 304 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 180 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 265 KiB

+9 -2
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.2.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -30,6 +30,12 @@ button:
# https://esphome.io/components/button/restart
- platform: restart
name: ${name} ESP32 Restart
id: esp32_restart_button
entity_category: config
# https://esphome.io/components/button/factory_reset
- platform: factory_reset
name: ${name} ESP32 Factory Reset
id: esp32_factory_reset_button
entity_category: config
binary_sensor:
@@ -40,6 +46,7 @@ binary_sensor:
entity_category: diagnostic
# Inverter communication status (CANBUS / RS485)
- platform: template
name: ${name} Inverter communication status
id: inverter_com_status
entity_category: diagnostic
+4 -4
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.12
# Version : 1.5.6
# Updated : 2025.07.10
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -18,7 +18,7 @@
# along with this program. If not, see <http://www.gnu.org/licenses/gpl.html>.
substitutions:
yambms_version: "1.5.6"
yambms_version: "1.5.8"
esphome:
name: ${hostname}
@@ -28,4 +28,4 @@ esphome:
project:
name: Sleeper85.YamBMS
version: ${yambms_version}
min_version: 2025.5.0
min_version: 2025.6.0
+2 -2
View File
@@ -1,5 +1,5 @@
# Updated : 2025.01.20
# Version : 1.5.3
# Updated : 2025.08.12
# Version : 1.2.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
+2 -2
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.08.12
# Version : 1.2.1
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
+4 -4
View File
@@ -1,5 +1,5 @@
# Updated : 2024.08.28
# Version : 1.1.3
# Updated : 2025.07.11
# Version : 1.1.4
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -42,7 +42,7 @@ sensor:
id: esp32_loop_time
- platform: template
name: ${name} ${debug_name} Heap free (%)
name: ${name} ${debug_name} Heap free percent
id: esp32_heap_free_percent
unit_of_measurement: '%'
accuracy_decimals: 2
@@ -54,7 +54,7 @@ sensor:
lambda: return ( id(esp32_heap_free).state * 100 / 327680 );
- platform: template
name: ${name} ${debug_name} Heap max block (%)
name: ${name} ${debug_name} Heap max block percent
id: esp32_heap_max_block_percent
unit_of_measurement: '%'
accuracy_decimals: 2
@@ -1,5 +1,5 @@
# Updated : 2024.08.28
# Version : 1.1.3
# Updated : 2025.07.11
# Version : 1.1.4
# GitHub : https://github.com/Sleeper85/esphome-yambms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -45,7 +45,7 @@ sensor:
id: esp32_loop_time
- platform: template
name: ${name} ${debug_name} Heap free (%)
name: ${name} ${debug_name} Heap free percent
id: esp32_heap_free_percent
unit_of_measurement: '%'
accuracy_decimals: 2
@@ -57,7 +57,7 @@ sensor:
lambda: return ( id(esp32_heap_free).state * 100 / 327680 );
- platform: template
name: ${name} ${debug_name} Heap max block (%)
name: ${name} ${debug_name} Heap max block percent
id: esp32_heap_max_block_percent
unit_of_measurement: '%'
accuracy_decimals: 2
@@ -69,7 +69,7 @@ sensor:
lambda: return ( id(esp32_heap_max_block).state * 100 / 327680 );
- platform: template
name: ${name} ${debug_name} Free PSRAM (%)
name: ${name} ${debug_name} Free PSRAM percent
id: esp32_free_psram_percent
unit_of_measurement: '%'
accuracy_decimals: 2
+12 -3
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.5.6
# Updated : 2025.07.10
# Version : 1.5.8
# GitHub : https://github.com/Sleeper85/esphome-yambms
# This YAML is free software: you can redistribute it and/or
@@ -90,7 +90,11 @@ interval:
id(${yambms_id}_var_charging_allowed_counter) += 1;
// TOTAL max_charge_current
id(${yambms_id}_var_total_max_charge_current) += id(bms${bms_id}_max_charge_current).state;
// Limit to max. charge current
if(id(${yambms_id}_var_total_max_charge_current) > ${yambms_max_requested_charge_current})
{
id(${yambms_id}_var_total_max_charge_current) = ${yambms_max_requested_charge_current};
}
}
// TOTAL bms_blocking_charge_counter
else id(${yambms_id}_var_bms_blocking_charge_counter) += 1;
@@ -101,6 +105,11 @@ interval:
id(${yambms_id}_var_discharging_allowed_counter) += 1;
// TOTAL max_discharge_current
id(${yambms_id}_var_total_max_discharge_current) += id(bms${bms_id}_max_discharge_current).state;
// Limit to max. discharge current
if(id(${yambms_id}_var_total_max_discharge_current) > ${yambms_max_requested_discharge_current})
{
id(${yambms_id}_var_total_max_discharge_current) = ${yambms_max_requested_discharge_current};
}
}
// TOTAL bms_blocking_discharge_counter
else id(${yambms_id}_var_bms_blocking_discharge_counter) += 1;
@@ -0,0 +1,40 @@
# Updated : 2025.10.6
# Version : 1.1.1
# GitHub : https://github.com/GHswitt/esphome-basen
# 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:
bms_model: "BASEN"
bms_protocol: "RS485"
basen_controller_flow_control_pin: null
# +--------------------------------------+
# | Component settings |
# +--------------------------------------+
external_components:
- source: github://GHswitt/esphome-basen@main
refresh: 0s
uart:
- id: !extend ${basen_uart_id}
baud_rate: ${basen_uart_baud_rate}
basen_controller:
- uart_id: ${basen_uart_id}
flow_control_pin: ${basen_controller_flow_control_pin}
id: ${basen_controller_id}
@@ -1,28 +1,26 @@
# Updated : 2025.03.21
# 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>.
uart:
- id: !extend ${modbus_uart_id}
baud_rate: ${modbus_baud_rate}
modbus:
- uart_id: ${modbus_uart_id}
id: modbus_${modbus_role}
role: ${modbus_role}
send_wait_time: ${modbus_send_wait_time}
# Updated : 2025.07.24
# Version : 1.1.1
# GitHub : https://github.com/syssi/esphome-seplos-bms
# 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:
bms_model: "EG4 LLV2"
bms_protocol: "RS485"
packages:
bms_combine: !include bms_combine.yaml
bms_sensors: !include bms_sensors_EG4_LLV2_RS485_bms_full.yaml
@@ -0,0 +1,39 @@
# Updated : 2025.07.24
# 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>.
substitutions:
# BMS
bms_model: "EG4 LLV2"
bms_protocol: "RS485"
# Modbus
eg4_modbus_id: modbus_eg4
eg4_modbus_send_wait_time: 250ms # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
# Modbus Controller
eg4_modbus_update_interval: '5s' # frequency with which BMS modbus servers are queried
eg4_modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
uart:
- id: !extend ${eg4_modbus_uart_id}
baud_rate: ${eg4_modbus_baud_rate}
modbus:
- uart_id: ${eg4_modbus_uart_id}
id: ${eg4_modbus_id}
role: client
send_wait_time: ${eg4_modbus_send_wait_time}
@@ -1,5 +1,5 @@
# Updated : 2025.06.11
# Version : 1.2.8
# Updated : 2025.08.21
# Version : 1.3.0
# GitHub : https://github.com/syssi/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -101,6 +101,7 @@ switch:
id: bms${bms_id}_discharge_switch
name: "${name} ${bms_name} Discharge switch"
balancer:
id: bms${bms_id}_balance_switch
name: "${name} ${bms_name} Balance switch"
# Commits 2024.01.20 : Add new switch entities of firmware version 14 (from V11)
heating:
@@ -318,7 +319,7 @@ sensor:
name: "${name} ${bms_name} temperature sensor 5"
# Commits 2024.01.21 : Expose emergency time countdown and add feedback to the switch (from V11)
emergency_time_countdown:
name: "${name} emergency time countdown"
name: "${name} ${bms_name} emergency time countdown"
# Commits 2024.01.27 : Expose heating status/current (ALL)
heating_current:
name: "${name} ${bms_name} heating current"
@@ -418,9 +419,9 @@ number:
name: "${name} ${bms_name} power tube overtemperature protection recovery"
# Commits 2024.07.29 : Make "RCV Time" and "RFV Time" controllable (from V14)
cell_request_charge_voltage_time:
name: "${name} cell request charge voltage time"
name: "${name} ${bms_name} cell request charge voltage time"
cell_request_float_voltage_time:
name: "${name} cell request float voltage time"
name: "${name} ${bms_name} cell request float voltage time"
button:
- platform: jk_bms_ble
+3 -2
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.11
# Version : 1.2.8
# Updated : 2025.07.07
# Version : 1.2.9
# GitHub : https://github.com/syssi/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -98,6 +98,7 @@ switch:
id: bms${bms_id}_discharge_switch
name: "${name} ${bms_name} Discharge switch"
balancer:
id: bms${bms_id}_balance_switch
name: "${name} ${bms_name} Balance switch"
# +--------------------------------------+
- platform: ble_client
+3 -2
View File
@@ -1,5 +1,5 @@
# Updated : 2025.06.11
# Version : 1.2.8
# Updated : 2025.07.07
# Version : 1.2.9
# GitHub : https://github.com/syssi/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -98,6 +98,7 @@ switch:
id: bms${bms_id}_discharge_switch
name: "${name} ${bms_name} Discharge switch"
balancer:
id: bms${bms_id}_balance_switch
name: "${name} ${bms_name} Balance switch"
# +--------------------------------------+
- platform: ble_client
@@ -1,5 +1,5 @@
# Updated : 2025.06.11
# Version : 1.2.6
# Updated : 2025.07.07
# Version : 1.2.7
# GitHub : https://github.com/txubelaxu/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -49,6 +49,7 @@ switch:
id: bms${bms_id}_discharge_switch
name: "${name} ${bms_name} discharging"
balancing:
id: bms${bms_id}_balance_switch
name: "${name} ${bms_name} balancing"
emergency:
name: "${name} ${bms_name} emergency"
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.2.9
# Updated : 2025.10.22
# Version : 1.3.0
# GitHub : https://github.com/txubelaxu/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -48,7 +48,7 @@ jk_rs485_sniffer:
switch:
- platform: template
name: ${name} Broadcasting JK-PB settings to all BMS
name: ${name} ${sniffer_id} Broadcasting JK-PB settings to all BMS
icon: "mdi:cast"
restore_mode: RESTORE_DEFAULT_OFF
optimistic: true
@@ -0,0 +1,59 @@
# Updated : 2025.10.22
# Version : 1.3.0
# GitHub : https://github.com/txubelaxu/esphome-jk-bms
# 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:
bms_model: "JK"
bms_protocol: "RS485"
logger:
tx_buffer_size: 1024
# +--------------------------------------+
# | Component settings |
# +--------------------------------------+
external_components:
- source: github://Sleeper85/esphome-components@dev
refresh: 0s
components: [ jk_rs485_sniffer , jk_rs485_bms ]
# - source:
# type: local
# path: ../esphome-components/components
jk_rs485_sniffer:
- id: ${sniffer_id}
protocol_version: ${sniffer_protocol}
rx_timeout: 500ms
uart_id: ${sniffer_uart_id}
# +--------------------------------------+
# | Component entities |
# +--------------------------------------+
switch:
- platform: template
name: ${name} ${sniffer_id} Broadcasting JK-PB settings to all BMS
icon: "mdi:cast"
restore_mode: RESTORE_DEFAULT_OFF
optimistic: true
entity_category: config
turn_on_action:
- lambda: id(${sniffer_id}).set_broadcast_changes_to_all_bms(true);
turn_off_action:
- lambda: id(${sniffer_id}).set_broadcast_changes_to_all_bms(false);
@@ -1,5 +1,5 @@
# Updated : 2025.06.10
# Version : 1.2.9
# Updated : 2025.10.22
# Version : 1.3.0
# GitHub : https://github.com/txubelaxu/esphome-jk-bms
# YamBMS ( Yet another multi-BMS Merging Solution )
@@ -49,7 +49,7 @@ jk_rs485_sniffer:
switch:
- platform: template
name: ${name} Broadcasting JK-PB settings to all BMS
name: ${name} ${sniffer_id} Broadcasting JK-PB settings to all BMS
icon: "mdi:cast"
restore_mode: RESTORE_DEFAULT_OFF
optimistic: true
@@ -0,0 +1,22 @@
# Updated : 2025.07.24
# Version : 1.1.1
# GitHub : https://github.com/syssi/esphome-seplos-bms
# 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>.
packages:
bms_combine: !include bms_combine.yaml
bms_sensors: !include bms_sensors_SEPLOS_V3_RS485_bms_full.yaml
@@ -0,0 +1,39 @@
# Updated : 2025.07.24
# 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>.
substitutions:
# BMS
bms_model: "Seplos V3"
bms_protocol: "RS485"
# Modbus
seplos_modbus_id: modbus_seplos_v3
seplos_modbus_send_wait_time: 250ms # time in milliseconds before the next ModBUS command is sent if an answer from a previous command is pending
# Modbus Controller
seplos_modbus_update_interval: '5s' # frequency with which BMS modbus servers are queried
seplos_modbus_command_throttle: '0ms' # minimum time in between 2 requests to the device
uart:
- id: !extend ${seplos_modbus_uart_id}
baud_rate: ${seplos_modbus_baud_rate}
modbus:
- uart_id: ${seplos_modbus_uart_id}
id: ${seplos_modbus_id}
role: client
send_wait_time: ${seplos_modbus_send_wait_time}
Loaded 100 of 163 files, more files were not shown because too many files have changed in this diff. Show more