BREAKING CHANGE: both inverter link selects are renamed, so their stored value is
reset. The link stays inactive until an inverter brand is selected. See
documents/README/changelog/Changelog_Inverter_brand_and_protocol.md
New `Inverter brand` select (16 brands) and reworked `Protocol` select, now
defaulting to `Automatic`. Selecting the brand is enough, the protocol follows;
an explicit protocol still takes priority over the brand.
The protocol is resolved once, at boot and on every select change, into
`canbus${canbus_id}_active_protocol` / `rs485${rs485_id}_active_protocol`.
Everything else reads that integer instead of dispatching on `active_index()`,
where `== 5` meant LuxPower purely by convention of the option order.
New shared `yambms_inverter_registry.yaml`: protocol dictionary (`YB_PROTO_*`),
brand to protocol mapping, and the battery mode and note of each couple.
Removed the `YamBMS name` select: the manufacturer name sent on CAN frame 0x35E
now derives from the protocol in use, which is what `Automatic` already did.
Removed the `canbus_extended_ack` substitution: both the 11-bit and the 29-bit
ACK triggers are registered, so the Schneider XW Pro needs no configuration.
Renamed CAN `PYLON 1.2` to `PYLON V1` and RS485 `Pylontech` to `PYLON`.
New per-link diagnostics `Inverter link protocol`, `Inverter battery mode` and
`Note`, with a markdown card in the dashboards, alongside a system fault card.
Telemetry: `comm_bus` / `comm_protocol` replaced by `inverter_brand`,
`inverter_bus`, `inverter_protocol` and `inverter_protocol_source`, one slot per
declared link instead of a single value overwritten by the last one.
RS485 packages split: `yambms_rs485.yaml` is the entry point carrying the selects,
`yambms_rs485_pylon.yaml` the protocol implementation. The baud rate is applied
with `set_baud_rate()` + `load_settings()` instead of extending the uart
component, so boards using a UART expander no longer need their own include.
Fixes:
- the CAN bus kept re-emitting the last frame every 100 ms when the protocol was
set to `Disabled` at runtime
- the RS485 link kept answering the inverter with stale data on `Disabled`, the
proxy sensors it reads are now invalidated
- a `Disabled` link no longer lights the fault LED, it is unregistered from the
fault registry instead of being reported as failing
- the reported bus and protocol were overwritten when a node declares several
inverter links
- changing the protocol restarts the CAN frames immediately instead of waiting up
to 30 s for the next retry tick
9.3 KiB
9.3 KiB
YamBMS - Supported devices
Supported BMS
JKBMS (BLE / UART / RS485)JBDBMS (BLE / UART)Seplos V1 V2 V3BMS (RS485)PACEBMS (RS485)BASENBMS (RS485)DEYEBMS (CAN)EcoworthyBMS (RS485)KSBMS (BLE)
Note: other BMS brands already integrated with ESPhome can be added easily.
Supported shunt
Victron Smartshunt(UART)Victron Smartshunt(BLE)Junctek KH-F(UART / RS485)
Note: other Shunt brands already integrated with ESPhome can be added easily.
Supported balancers
GW-24S4EB: NEEY/Heltec 4A Smart Active Balancer)(BLE)GW-24S4EB: NEEY 4A Smart Active Balancer 4th generation)(BLE)EK-24S15EB: (NEEY 15A Smart Active Balancer)(BLE)EK-24S10EB: (NEEY 10A Smart Active Balancer)(BLE)
Note: other Balancer brands already integrated with ESPhome can be added easily.
Supported MCU
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.
| AtomS3 Lite | AtomS3 | AtomS3R (8MB PSRAM) |
|---|---|---|
![]() |
![]() |
![]() |
| LilyGo T-CAN485 (ESP32) | LilyGo T-Connect (ESP32-S3) | Waveshare ESP32-S3-RS485-CAN |
|---|---|---|
![]() |
![]() |
![]() |
| ESP32 DevKit-V1 | ESP32-S3 DevKitC-1 | ESP32-C3 ETH01-EVO |
|---|---|---|
![]() |
![]() |
![]() |
| Olimex ESP32-EVB | espBerry + Waveshare 2-CH CAN HAT |
|---|---|
![]() |
![]() |
Supported CAN bus transceiver
Note: some inverters only accept a CAN bus at 3.3V in this case please choose the SN65HVD230 chip.
| TJA1050 (5V) | TJA1051T (5V) | SN65HVD230 (3V3) |
|---|---|---|
![]() |
![]() |
![]() |
| M5Stack Atomic CAN Base (isolated) | M5Stack CAN Unit (isolated) | MCP2515 (5V) |
|---|---|---|
![]() |
![]() |
![]() |
Supported RS485 transceiver
| M5Stack RS485 Unit (isolated) | RS485 isolated board (high speed dual) | RS485 Two-way Converter |
|---|---|---|
![]() |
![]() |
![]() |
Supported inverters
Inverters supporting CAN PYLON/Goodwe/SMA/Victron Low Voltage protocol should work, check your inverter manual to confirm.
The following are confirmed and known to work:
| Brand | Model | Inverter bat. mode | CAN/RS485 protocol | Remarks | Reported by |
|---|---|---|---|---|---|
| Deye | SUN-3.6K-SG03LP1-EU | Lithium 00 | CAN : PYLON V1 | --- | @Der_Hannes |
| Deye | SUN-5K-SG03LP1-EU | Lithium 00 | CAN : PYLON V1 | --- | @vdiex, @arzaman, @widget4145 |
| Deye | SUN-6K-SG03LP1-EU | Lithium 00 | CAN : PYLON V1 | --- | @Sleeper85, @Imanol82 |
| Deye | SUN-12K-SG04LP3-EU | Lithium 00 | CAN : PYLON V1 | --- | @lucize, @luckylinux, @virus100b, @b1ggi |
| Goodwe | GW5048-ES | --- | CAN : PYLON V2 | --- | @jirdol |
| Goodwe | GW5000S-BP | Goodwe LX U5.4-L | CAN : PYLON V2 | --- | @Uksa007, @OselDusan7 |
| Goodwe | GW3600S-BP | --- | CAN : PYLON V2 | --- | @OselDusan7 |
| Sofar | ME 3000-SP | --- | --- | --- | @starman |
| Sofar | HYD 3600-ES | Automatic | CAN : PYLON V1 | A 120 Ohm resistor had to be added on the Sofar side. | @chaosnature |
| Sofar | HYD 5000-ES | --- | --- | --- | @Paulfrench35 |
| Sofar | HYD 5000-EP | --- | --- | --- | @tonystrullu |
| Growatt | SPF 5000ES | CAN L52 | CAN : PYLON V1 | --- | @Paulfrench35, @cjdell, @cinusik |
| Solis | RHI-3.6K-48ES-5G | Pylon LV / AoBo | CAN : PYLON V2 / SMA | CAN transceiver 3V3 required (SN65HVD230) for Pylon LV mode. | @cjdell, @MrPabloUK |
| Solis | S5-EH1P4.6K-L | Pylon LV | CAN : PYLON V2 | CAN transceiver 3V3 required (SN65HVD230). | @Baker0052 |
| Solis | S5-EH1P6K-L | AoBo | CAN : SMA | --- | @MrPabloUK |
| Solis | RHI-3K-48ES | AoBo | CAN : SMA | --- | @chaosnature |
| LuxPower | LXP SNA 5K | Lithium 6 | CAN : LuxPower | --- | @shvmm, @yur43 |
| LuxPower | LXP-LB-US 10K | Lithium 6 | CAN : LuxPower | --- | @Henny101 |
| EG4 | 6000XP | Lithium 2 / Lithium 6 | CAN : PYLON V1 / LuxPower | --- | @ChrisG, @SGB |
| EG4 | 12000XP | Lithium 6 | CAN : LuxPower | --- | @andrewfraley |
| EG4 | 18kPV | Lithium 6 | CAN : LuxPower | --- | @Maintman |
| Victron | Multiplus 24/1200/25-16 | CAN-bus BMS LV (500 kbit/s) | CAN : Victron | Plugged into Cerbo CAN port (must use supplied Victron terminator in the other port). | @dmsims |
| Victron | MultiPlus-II 48/10000/140 | CAN-bus BMS LV (500 kbit/s) | CAN : Victron | --- | @cali-clim, @20after4 |
| MidNite Solar | MN15-12KW-AIO | PYLON | CAN : PYLON V1 | --- | @goldserve, @jahyde |
| SRNE | HESP48120U200-H | UZE | CAN : PYLON V2 | Most PYLON-based protocols show same results. Inverter does not work in PYLON mode, UZE works. Incorrect temp reported. | @ogremustcrush |
| Studer | XTM-4000 | Pylontech | CAN : PYLON V2 | DIP Switch in Xcom-CAN: 11000110 (1 to 8, ON==1). | @kolins-cz |
| Schneider | XW Pro 6848 NA | Voltage Control Li-Ion | CAN : PYLON V2 | The extended 29-bit ACK is handled automatically since YamBMS 1.8.1, no option to set. | @AGDorsum, @ngustas |
| SMA | Sunny Island | --- | --- | --- | --- |



















