Files
esphome-yambms/documents/README/Supported_devices.md
T
Sleeper85 281d39ac18 New inverter brand select drives the CAN and RS485 protocol
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
2026-11-08 23:08:33 +01:00

9.3 KiB

YamBMS - Supported devices

Badge License: GPLv3 Badge Version GitHub stars GitHub forks GitHub watchers

Supported BMS

  • JK BMS (BLE / UART / RS485)
  • JBD BMS (BLE / UART)
  • Seplos V1 V2 V3 BMS (RS485)
  • PACE BMS (RS485)
  • BASEN BMS (RS485)
  • DEYE BMS (CAN)
  • Ecoworthy BMS (RS485)
  • KS BMS (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 --- --- --- ---