diff --git a/CHANGELOG.md b/CHANGELOG.md index 52ce193..c33c33a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,11 @@ # 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 - zvýšena verze balíku na 0.8.7 - sjednocena verze v kořenovém i integračním `manifest.json` diff --git a/README.md b/README.md index 20ea90f..3d078c0 100644 --- a/README.md +++ b/README.md @@ -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. -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 @@ -17,115 +17,23 @@ XT211 / Relay box └── 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. -- 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í. +- 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. +- Dokumentace také uvádí sadu OBIS kódů pro HAN rozhraní. ## Ověřený hardware -- PUSR USR-USR-DR134 (https://www.pusr.com/products/Lipstick-Size-Serial-Device-Server.html) -- Předpokládám, že bude fungovat každý RS485-TCP převodník +- PUSR USR-USR-DR134 +- Předpoklad je, že bude fungovat každý RS485-TCP převodník ## Instalace přes HACS 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**. 4. Restartuj Home Assistant. 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í Do `configuration.yaml`: @@ -137,20 +45,11 @@ logger: 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 - `docs/pdfs/cez_rs485_han_interface.pdf` - `docs/pdfs/cez_obis_codes_han_2025-02-01.pdf` -## Poděkování -- Děkuji za inspiraci: https://github.com/Tomer27cz/xt211 - ## Licence MIT diff --git a/custom_components/xt211_han/manifest.json b/custom_components/xt211_han/manifest.json index fe4f54c..135a2da 100644 --- a/custom_components/xt211_han/manifest.json +++ b/custom_components/xt211_han/manifest.json @@ -1,7 +1,7 @@ { "domain": "xt211_han", "name": "XT211 HAN (RS485 via Ethernet)", - "version": "0.8.8", + "version": "0.8.9", "documentation": "https://github.com/nero150/CEZ_rele_box", "issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues", "dependencies": [], diff --git a/hacs.json b/hacs.json index 9e5297e..21bb53b 100644 --- a/hacs.json +++ b/hacs.json @@ -6,5 +6,6 @@ "iot_class": "local_push", "render_readme": true, "zip_release": true, - "filename": "xt211_han.zip" + "filename": "xt211_han.zip", + "content_in_root": true } diff --git a/manifest.json b/manifest.json index fe4f54c..135a2da 100644 --- a/manifest.json +++ b/manifest.json @@ -1,7 +1,7 @@ { "domain": "xt211_han", "name": "XT211 HAN (RS485 via Ethernet)", - "version": "0.8.8", + "version": "0.8.9", "documentation": "https://github.com/nero150/CEZ_rele_box", "issue_tracker": "https://github.com/nero150/CEZ_rele_box/issues", "dependencies": [], diff --git a/xt211_han.zip b/xt211_han.zip index c5726b2..2970fdf 100644 Binary files a/xt211_han.zip and b/xt211_han.zip differ