168 lines
5.0 KiB
Markdown
168 lines
5.0 KiB
Markdown
# XT211 HAN – Home Assistant Integration
|
||
|
||
[](https://github.com/hacs/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** (https://github.com/nero150/CEZ_rele_box)
|
||
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`:
|
||
|
||
```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](https://github.com/Tomer27cz/xt211) – původní ESPHome komponenta a dokumentace protokolu
|
||
- ČEZ Distribuce – dokumentace OBIS kódů a RS485 rozhraní
|
||
|
||
---
|
||
|
||
## Licence
|
||
|
||
MIT
|