XT211 HAN – Home Assistant Integration

Čtení dat z elektroměru Sagemcom XT211 (ČEZ Distribuce) přes RS485-to-Ethernet adaptér – bez ESP32.

Tato integrace nahrazuje ESPHome řešení s ESP32 + RS485→TTL převodníkem. Místo toho používá průmyslový RS485-to-Ethernet adaptér (doporučen PUSR USR-DR134), který posílá syrová RS485 data přes TCP přímo do Home Assistantu.

---

Jak to funguje

XT211 / WM-RelayBox
   └── RJ12 HAN port (RS485, 9600 baud)
          └── USR-DR134 (RS485 → Ethernet)
                 └── TCP socket (LAN)
                        └── Home Assistant (tato integrace)

Elektroměr posílá DLMS/COSEM PUSH zprávy každých 60 sekund. Integrace udržuje persistentní TCP spojení k adaptéru a dekóduje příchozí HDLC rámce.

---

Požadavky

• Home Assistant 2024.1+
• RS485-to-Ethernet adaptér s TCP server módem:
  • PUSR USR-DR134 (doporučeno) – RS485, DIN rail, 5–24V
  • Nebo jiný kompatibilní adaptér (USR-TCP232-410S, Waveshare, apod.)

---

Instalace přes HACS

1. Otevři HACS → Integrace → tři tečky vpravo nahoře → Vlastní repozitáře
2. Přidej URL tohoto repozitáře, kategorie: Integration
3. Najdi „XT211 HAN" a nainstaluj
4. Restartuj Home Assistant
5. Nastavení → Zařízení a služby → Přidat integraci → XT211 HAN

---

Nastavení adaptéru USR-DR134

Nastavení přes webové rozhraní adaptéru (výchozí IP 192.168.0.7):

Parametr	Hodnota
Work Mode	TCP Server
Local Port	8899 (nebo libovolný)
Baud Rate	9600
Data Bits	8
Stop Bits	1
Parity	None
Flow Control	None

⚠️ Použij model USR-DR134 (RS485), ne DR132 (RS232)!

---

Zapojení

WM-RelayBox HAN port (RJ12):
  Pin 3 (Data A+)  →  USR-DR134 terminal A+
  Pin 4 (Data B-)  →  USR-DR134 terminal B-
  Pin 6 (GND)      →  USR-DR134 GND (volitelné)

Napájení USR-DR134: 5–24V DC (např. z USB adaptéru přes step-up, nebo 12V zdroj).

---

Dostupné entity (27 celkem)

📊 Výkon (W) – okamžité hodnoty

#	Název entity	OBIS kód
5	Power Limiter Value	0-0:17.0.0.255
13	Active Power Import	1-0:1.7.0.255
14	Active Power Import L1	1-0:21.7.0.255
15	Active Power Import L2	1-0:41.7.0.255
16	Active Power Import L3	1-0:61.7.0.255
17	Active Power Export	1-0:2.7.0.255
18	Active Power Export L1	1-0:22.7.0.255
19	Active Power Export L2	1-0:42.7.0.255
20	Active Power Export L3	1-0:62.7.0.255

⚡ Energie (kWh) – kumulativní

#	Název entity	OBIS kód
21	Energy Import	1-0:1.8.0.255
22	Energy Import T1	1-0:1.8.1.255
23	Energy Import T2	1-0:1.8.2.255
24	Energy Import T3	1-0:1.8.3.255
25	Energy Import T4	1-0:1.8.4.255
26	Energy Export	1-0:2.8.0.255

🔀 Binární senzory (zapnuto/vypnuto)

#	Název entity	OBIS kód
4	Disconnector Status	0-0:96.3.10.255
6	Relay R1 Status	0-1:96.3.10.255
7	Relay R2 Status	0-2:96.3.10.255
8	Relay R3 Status	0-3:96.3.10.255
9	Relay R4 Status	0-4:96.3.10.255
10	Relay R5 Status	0-5:96.3.10.255
11	Relay R6 Status	0-6:96.3.10.255

📋 Diagnostika (text)

#	Název entity	OBIS kód
1	COSEM Logical Device Name	0-0:42.0.0.255
3	Serial Number	0-0:96.1.0.255
12	Current Tariff	0-0:96.14.0.255
27	Consumer Message	0-0:96.13.0.255

ℹ️ Idx 2 (0-2:25.9.0.255 – Push setup) je interní konfigurační objekt elektroměru, neobsahuje měřená data.

---

Ladění (debug)

Přidej do configuration.yaml:

logger:
  default: warning
  logs:
    custom_components.xt211_han: debug

V logu uvidíš surová hex data každého HDLC rámce a dekódované OBIS hodnoty.

---

Struktura repozitáře

custom_components/xt211_han/
├── __init__.py          # Inicializace integrace
├── manifest.json        # Metadata pro HA / HACS
├── const.py             # Konstanty
├── config_flow.py       # UI průvodce nastavením
├── coordinator.py       # TCP listener + DataUpdateCoordinator
├── sensor.py            # Senzorová platforma
├── dlms_parser.py       # HDLC / DLMS / COSEM parser
├── strings.json         # Texty UI
└── translations/
    ├── cs.json          # Čeština
    └── en.json          # Angličtina

---

Poděkování / Credits

• Tomer27cz/xt211 – původní ESPHome komponenta a dokumentace protokolu
• ČEZ Distribuce – dokumentace OBIS kódů a RS485 rozhraní

---

Licence

MIT