139 lines
3.9 KiB
Markdown
139 lines
3.9 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é senzory
|
||
|
||
| Název | OBIS kód | Jednotka |
|
||
|-------|----------|----------|
|
||
| Active Power Consumption | `1-0:1.7.0.255` | W |
|
||
| Active Power Delivery | `1-0:2.7.0.255` | W |
|
||
| Active Power L1 | `1-0:21.7.0.255` | W |
|
||
| Active Power L2 | `1-0:41.7.0.255` | W |
|
||
| Active Power L3 | `1-0:61.7.0.255` | W |
|
||
| Energy Consumed | `1-0:1.8.0.255` | kWh |
|
||
| Energy Consumed T1 | `1-0:1.8.1.255` | kWh |
|
||
| Energy Consumed T2 | `1-0:1.8.2.255` | kWh |
|
||
| Energy Delivered | `1-0:2.8.0.255` | kWh |
|
||
| Serial Number | `0-0:96.1.1.255` | – |
|
||
| Current Tariff | `0-0:96.14.0.255` | – |
|
||
| Disconnector Status | `0-0:96.3.10.255` | – |
|
||
|
||
---
|
||
|
||
## 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
|