Add files via upload

main 0.8.9
Nero 2026-03-19 10:22:57 +01:00 committed by GitHub
parent 67be2ae88a
commit a8b69d2487
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 17 additions and 111 deletions

View File

@ -1,5 +1,11 @@
# Changelog # Changelog
## 0.8.9
- opraven HACS release balík pro `content_in_root: true`
- release asset `xt211_han.zip` už obsahuje přímo soubory integrace v rootu ZIPu
- doplněno `content_in_root` do `hacs.json`
- sjednocena verze balíku na 0.8.9
## 0.8.7 ## 0.8.7
- zvýšena verze balíku na 0.8.7 - zvýšena verze balíku na 0.8.7
- sjednocena verze v kořenovém i integračním `manifest.json` - sjednocena verze v kořenovém i integračním `manifest.json`

115
README.md
View File

@ -5,7 +5,7 @@
> Čtení dat z elektroměru Sagemcom XT211 / Relay box (ČEZ Distribuce) přes RS485-to-Ethernet převodník do Home Assistantu. > Čtení dat z elektroměru Sagemcom XT211 / Relay box (ČEZ Distribuce) přes RS485-to-Ethernet převodník do Home Assistantu.
Tahle integrace čte push data z HAN / RS485 rozhraní elektroměru přes TCP server na převodníku. Tahle integrace čte push data z HAN / RS485 rozhraní elektroměru přes TCP server na převodníku.
## Jak to funguje ## Jak to funguje
@ -17,115 +17,23 @@ XT211 / Relay box
└── Home Assistant └── Home Assistant
``` ```
- Elektroměr posílá jednosměrná DLMS/COSEM data z elektroměru k zákazníkovi rychlostí 9600 Bd a podle dokumentace ČEZ se push zprávy předávají 1× za 60 s. - Elektroměr posílá jednosměrná DLMS/COSEM data z elektroměru k zákazníkovi rychlostí 9600 Bd a podle dokumentace ČEZ se push zprávy předávají 1× za 60 s.
- Rozhraní je vyvedené na konektoru RJ12, kde je Data A na pinu 3, Data B na pinu 4 a GND na pinu 6. - Rozhraní je vyvedené na konektoru RJ12, kde je Data A na pinu 3, Data B na pinu 4 a GND na pinu 6.
- Dokumentace také uvádí sadu OBIS kódů pro HAN rozhraní. - Dokumentace také uvádí sadu OBIS kódů pro HAN rozhraní.
## Ověřený hardware ## Ověřený hardware
- PUSR USR-USR-DR134 (https://www.pusr.com/products/Lipstick-Size-Serial-Device-Server.html) - PUSR USR-USR-DR134
- Předpokládám, že bude fungovat každý RS485-TCP převodník - Předpoklad je, že bude fungovat každý RS485-TCP převodník
## Instalace přes HACS ## Instalace přes HACS
1. Otevři HACS → **Integrace****Vlastní repozitáře**. 1. Otevři HACS → **Integrace****Vlastní repozitáře**.
2. Přidej URL tohoto repozitáře jako typ **Integration** (https://github.com/nero150/CEZ_rele_box). 2. Přidej URL tohoto repozitáře jako typ **Integration**.
3. Nainstaluj integraci **XT211 HAN**. 3. Nainstaluj integraci **XT211 HAN**.
4. Restartuj Home Assistant. 4. Restartuj Home Assistant.
5. V **Nastavení → Zařízení a služby** přidej integraci **XT211 HAN**. 5. V **Nastavení → Zařízení a služby** přidej integraci **XT211 HAN**.
## Nastavení převodníku
### 1. Síťové nastavení
Použité nastavení na funkční sestavě:
- IP Type: `Static IP`
- Native IP: `192.168.0.152`
- Submask: `255.255.255.0`
- Gateway: `192.168.0.1`
- DNS Server: `192.168.0.1`
![Síťové nastavení převodníku](docs/images/converter_network_settings.png)
### 2. Sériové / TCP nastavení
Použité nastavení na funkční sestavě:
- Baud Rate: `9600`
- Data Size: `8`
- Parity: `NONE`
- Stop Bits: `1`
- Local Port Number: `8899`
- Work Mode: `TCP Server`
- Client Overrun Mechanism: `KICK`
- Client Access Quantity: `4`
![Sériové a TCP nastavení převodníku](docs/images/converter_serial_settings.png)
### 3. Kontrola, že převodník opravdu posílá data
Na stavové stránce převodníku je vidět aktivní klient a počitadlo `TX/RX Count`. Pokud **roste TX počet bajtů**, převodník normálně odesílá data z elektroměru do sítě. Na ukázce níže je vidět připojený klient `192.168.0.190` a narůstající `TX Count`, zatímco `RX` zůstává nulové. To odpovídá jednosměrnému provozu elektroměr → zákazník, který je uvedený i v dokumentaci ČEZ. fileciteturn6file0
![Status převodníku a TX počitadlo](docs/images/converter_status_tx.png)
## Zapojení RJ12 / RS485
Podle dokumentace ČEZ je konektor RJ12 zapojen takto:
- pin 3 = `Data A`
- pin 4 = `Data B`
- pin 6 = `Shield / GND` nebo `Data GND`
![Home Assistant funkční entity](docs/images/home_assistant_entities.png)
## Co integrace reálně čte
Na reálně otestované sestavě se z XT211 / Relay boxu četou tyto hodnoty:
- dodávka energie celkem
- spotřeba energie celkem
- spotřeba energie T1
- spotřeba energie T2
- okamžitý příkon odběru celkem
- okamžitý příkon odběru L1, L2, L3
- okamžitý výkon dodávky celkem
- okamžitý výkon dodávky L1, L2, L3
- limiter
- stav odpojovače
- stav relé R1 až R4
- aktuální tarif
- výrobní číslo elektroměru
## Dostupné entity
### Výkon (W)
- Limiter — `0-0:17.0.0.255`
- Okamžitý příkon odběru celkem — `1-0:1.7.0.255`
- Okamžitý příkon odběru L1 — `1-0:21.7.0.255`
- Okamžitý příkon odběru L2 — `1-0:41.7.0.255`
- Okamžitý příkon odběru L3 — `1-0:61.7.0.255`
- Okamžitý výkon dodávky celkem — `1-0:2.7.0.255`
- Okamžitý výkon dodávky L1 — `1-0:22.7.0.255`
- Okamžitý výkon dodávky L2 — `1-0:42.7.0.255`
- Okamžitý výkon dodávky L3 — `1-0:62.7.0.255`
### Energie (kWh)
- Spotřeba energie celkem — `1-0:1.8.0.255`
- Spotřeba energie T1 — `1-0:1.8.1.255`
- Spotřeba energie T2 — `1-0:1.8.2.255`
- Spotřeba energie T3 — `1-0:1.8.3.255` pokud ji elektroměr posílá
- Spotřeba energie T4 — `1-0:1.8.4.255` pokud ji elektroměr posílá
- Dodávka energie celkem — `1-0:2.8.0.255` pokud ji elektroměr posílá
### Binární senzory
- Stav odpojovače — `0-0:96.3.10.255`
- Stav relé R1 — `0-1:96.3.10.255`
- Stav relé R2 — `0-2:96.3.10.255`
- Stav relé R3 — `0-3:96.3.10.255`
- Stav relé R4 — `0-4:96.3.10.255`
### Diagnostika
- Aktuální tarif — `0-0:96.14.0.255`
- Výrobní číslo — `0-0:96.1.1.255`
## Debug logování ## Debug logování
Do `configuration.yaml`: Do `configuration.yaml`:
@ -137,20 +45,11 @@ logger:
custom_components.xt211_han: debug custom_components.xt211_han: debug
``` ```
V logu pak uvidíš:
- příjem TCP dat
- složení rámců ze streamu
- parsed OBIS objekty
- aktualizaci coordinatoru
## Podklady v repozitáři ## Podklady v repozitáři
- `docs/pdfs/cez_rs485_han_interface.pdf` - `docs/pdfs/cez_rs485_han_interface.pdf`
- `docs/pdfs/cez_obis_codes_han_2025-02-01.pdf` - `docs/pdfs/cez_obis_codes_han_2025-02-01.pdf`
## Poděkování
- Děkuji za inspiraci: https://github.com/Tomer27cz/xt211
## Licence ## Licence
MIT MIT

View File

@ -1,7 +1,7 @@
{ {
"domain": "xt211_han", "domain": "xt211_han",
"name": "XT211 HAN (RS485 via Ethernet)", "name": "XT211 HAN (RS485 via Ethernet)",
"version": "0.8.8", "version": "0.8.9",
"documentation": "https://github.com/nero150/CEZ_rele_box", "documentation": "https://github.com/nero150/CEZ_rele_box",
"issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues", "issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues",
"dependencies": [], "dependencies": [],

View File

@ -6,5 +6,6 @@
"iot_class": "local_push", "iot_class": "local_push",
"render_readme": true, "render_readme": true,
"zip_release": true, "zip_release": true,
"filename": "xt211_han.zip" "filename": "xt211_han.zip",
"content_in_root": true
} }

View File

@ -1,7 +1,7 @@
{ {
"domain": "xt211_han", "domain": "xt211_han",
"name": "XT211 HAN (RS485 via Ethernet)", "name": "XT211 HAN (RS485 via Ethernet)",
"version": "0.8.8", "version": "0.8.9",
"documentation": "https://github.com/nero150/CEZ_rele_box", "documentation": "https://github.com/nero150/CEZ_rele_box",
"issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues", "issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues",
"dependencies": [], "dependencies": [],

Binary file not shown.