Integrace mikroměniče SP-800 do Home Assistant

Pro nejjednodušší monitoring a správu mikroměniče SP-800 využijete aplikaci Smart life, o které jsme již psali a potřebné instrukce najdete třeba v manuálu k mikroměniči. 

Pokud však využíváte pro chytrou domácnost systém Home Assistant, poradíme Vám, jak mikroměnič integrovat pomocí Tuya. Tuya je globální IoT platforma, která umožňuje výrobcům a spotřebitelům snadno připojit, spravovat a ovládat chytrá zařízení a systémy domácí automatizace.

Výsledek může vypadat třeba takto:

Home Assistant + Tuya

Home Assistant nabízí integraci Tuya, která bohužel pro náš případ nebude použitelná. Mikroměnič se přes ni dá integrovat, ale nezískáme tím z něj žádná data, lze ho pouze vypnout nebo zapnout.

Musíme použít tzv. LocalTuya, která pro komunikaci se zařízeními nevyužívá cloud, ale pouze lokální síť, prvotní konfigurace je trochu náročnější, ale stačí postupovat dle našeho návodu. 

Je nutné použít konkrétní fork integrace LocalTuya z tohoto repozitáře. Ten totiž umí nejnovější Tuya 3.5 protokol, na kterém komunikuje náš mikroměnič. 

K instalaci budeme potřebovat HACS. HACS je nástroj, který umožňuje snadnou instalaci a správu komunitou vyvinutých integrací, rozšíření a témat pro Home Assistant.

1. Postup instalace HACS

Existuje několik způsobů instalace HACS. Ukážeme si dva: instalaci pomocí terminálu a instalaci přes uživatelské rozhraní jako doplněk. Vyberte si ten, který je pro vás komfortnější.

A) Instalace HACS pomocí terminálu (skriptu):

1. Otevřete terminál na vašem zařízení s Home Assistant. Můžete použít doplněk SSH & Web Terminal nebo se připojit přes SSH.

2. V terminálu spusťte jedním příkazem oficiální instalační skript HACS:

   
   

   wget -O - https://get.hacs.xyz | bash -

   Tento příkaz stáhne a spustí skript, který automaticky zkopíruje potřebné soubory HACS do vašeho Home Assistant (do adresáře custom_components/hacs). Po dokončení by skript měl hlásit úspěšné nainstalování HACS.

3. Restartujte Home Assistant. Po instalaci je nutné Home Assistant restartovat, aby načetl nový integraci HACS. To uděláte v Nastavení > Systém > Restartovat (případně přes Configurator nebo příkaz v terminálu).

B) Instalace HACS jako doplněk přes rozhraní Home Assistant:

1. V rozhraní Home Assistant jděte do Nastavení > Doplňky, Zálohy a Supervisor (Add-ons, Backups & Supervisor).
2. V pravém horním rohu klikněte na ikonu nabídky (tři tečky) a zvolte Sklad repozitářů (Repositories).
3. Do pole pro URL repozitáře vložte adresu oficiálního repozitáře HACS doplňku:
   
   

   https://github.com/hacs/addon
   a potvrďte přidání. Tím zpřístupníte HACS jako doplněk ve vašem Home Assistant.
4. Nyní v seznamu doplňků vyhledejte HACS (Home Assistant Community Store). Klikněte na něj a zvolte Instalovat.
5. Po nainstalování doplňku HACS jej otevřete a klikněte na Spustit.
6. Otevřete záložku Protokol (Log) tohoto doplňku a sledujte výstup – po úspěšné instalaci by měl log naznačit, že máte HACS připraven (případně vyzve k restartu Home Assistant – proveďte restart, pokud je vyžadován).

První spuštění a konfigurace HACS

Po restartu Home Assistant (po instalaci HACS jedním z výše uvedených způsobů) je potřeba HACS integrovat a ověřit jeho funkčnost:

1. Přidání integrace HACS v Home Assistant: Přejděte do Nastavení > Zařízení a služby (Devices & Services). Vpravo dole klikněte na tlačítko Přidat integraci (+). Otevře se seznam dostupných integrací. Vyhledejte HACS a klikněte na něj​

2. Odsouhlasení podmínek: Po zvolení HACS integrace se zobrazí uvítací okno s informacemi a podmínkami. Zaškrtněte všechny uvedené souhlasy (potvrzení, že rozumíte, že jde o komunitní integrace atd.) a klikněte na Odeslat (Submit).

3. Propojení s GitHub účtem: Nyní budete vyzváni k ověření pomocí GitHubu. Objeví se okno s kódem a odkazem na GitHub (https://github.com/login/device).

   • Zkopírujte zobrazený kód (bude to několik písmen a číslic).
   • Klikněte na odkaz pro přihlášení (otevře se nové okno prohlížeče na GitHubu). Přihlaste se ke svému GitHub účtu (pokud jej ještě nemáte, vytvořte si ho – registrace je zdarma).
   • Po přihlášení GitHub zobrazí stránku „Device Activation“, kam vložte zkopírovaný kód a potvrďte (Continue/Authorize).
   • Udělte oprávnění aplikaci HACS (Authorize HACS). Tím povolíte HACS přístup k vašemu GitHubu pro stahování integrací.
   • Jakmile GitHub potvrdí autorizaci, můžete okno zavřít.

4. Dokončení integrace HACS: Vraťte se do rozhraní Home Assistant. Integrace HACS by měla automaticky pokračovat. Po chvíli by se mělo objevit, že byla úspěšně nastavena. Můžete HACS přiřadit oblast (to není nutné, volitelně lze např. zařadit do oblasti „Systém“) a kliknout na Dokončit.

5. Ověření úspěšné instalace: V postranním panelu Home Assistant by se nyní měla objevit nová položka HACS (s ikonou nákupní tašky). Kliknutím na ni by se mělo otevřít rozhraní HACS. Pokud ji nevidíte hned, zkuste obnovit stránku nebo se odhlásit a přihlásit. Ve výchozím stavu může HACS zobrazit přehled (Dashboard) s informací, že nejsou žádné repozitáře – to je v pořádku, zatím jsme nic neinstalovali. HACS je nyní připraven a můžete přes něj přidávat komunitní integrace.

2. Instalace LocalTuya pomocí HACS (konkrétní Fork)

Použijeme specifický Fork integrace LocalTuya, který podporuje Tuya protokol 3.5:

1. Otevřete záložku HACS a klikněte na tři tečky v pravém horním rohu a vyberte „Custom repositories“.

2. Přidejte URL repozitáře:
   
https://github.com/xZetsubou/hass-localtuya

4. Vyberte typ „Integrace“ a klikněte na Přidat.

5. Po přidání vyhledejte „LocalTuya“ od xZetsubou a klikněte na instalovat.

6. Po instalaci restartujte Home Assistant.

Konfigurace LocalTuya integrace v Home Assistant

Nyní máme LocalTuya k dispozici v Home Assistant a můžeme přes ni přidat naše zařízení. Než to ale uděláme, je potřeba získat určité informace o zařízení (zejména jeho Device ID a Local Key), abychom ho mohli správně připojit. K tomu slouží krok 3 – nastavení vývojářského účtu Tuya a získání údajů z cloudu. Nejprve si ale řekneme, co nás při přidávání LocalTuya integrace čeká:

• LocalTuya integrace může fungovat dvěma způsoby:

  • Offline (zcela lokálně) – v tomto režimu musíte ručně zjistit tzv. Local Key zařízení a vše nastavit manuálně. Integrace nevyužije žádné API. 
  • Online (s pomocí Tuya Cloud API) – volitelně lze LocalTuya poskytnout přístup k Tuya IoT cloudu (přes tzv. Access ID a Access Secret). Integrace pak umí automaticky získat Local Key zařízení z cloudu při konfiguraci, což usnadňuje nastavení. (Po úvodním získání klíčů ale zařízení ovládá dále lokálně – cloud slouží jen pro prvotní data a případnou aktualizaci klíčů při spárování.)

• Co budeme potřebovat pro přidání zařízení: IP adresu zařízení v lokální síti (např. 192.168.x.y), jeho Device ID a Local Key (lokální klíč). IP adresu zjistíte třeba v administraci svého routeru nebo v aplikaci (někdy ji zobrazí), případně nástroji jako Fing. Device ID a Local Key získáme v dalším kroku přes Tuya Cloud. Doporučujeme na routeru nastavit statickou IP adresu pro mikroměnič. 

• Ujistěte se, že zařízení je přidáno v aplikaci Smart Life (nebo Tuya Smart) a funkční. Náš mikroinvertor by tedy měl být spárovaný s aplikací (používáme Smart Life app), připojený k Wi-Fi a na stejném místě/ve stejné síti jako Home Assistant.

V našem případě budeme konfigurovat Online, jelikož Local key mikroměniče neznáme.

3. Registrace v Tuya Cloud a propojení se Smart Life aplikací

Pro úspěšné propojení našeho zařízení ze Smart Life s Home Assistant potřebujeme získat několik údajů z Tuya cloudu. Společnost Tuya umožňuje uživatelům vytvořit tzv. Developer Account (vývojářský účet) a Cloud Project, přes který lze přistupovat k zařízením, jež máte v aplikaci. Tímto způsobem získáme:

• Access ID a Access Secret – přihlašovací údaje k API projektu (ty využijeme, pokud chceme LocalTuya dát přístup k API).
• Device ID zařízení – unikátní identifikátor každého zařízení v Tuya ekosystému.
• Local Key zařízení – lokální klíč, kterým je šifrovaná komunikace mezi Tuya zařízením a cloudem. LocalTuya ho potřebuje k lokálnímu ovládání zařízení.

Nebojte se, postup je srozumitelný a není třeba programovat – vše naklikáme v grafickém rozhraní Tuya IoT platformy a použijeme vestavěný API Explorer. Pojďme krok za krokem:

3.1 Vytvoření vývojářského účtu na Tuya IoT Platform

1. Registrace na Tuya IoT: Otevřete web iot.tuya.com (Tuya IoT Developer Platform). Pokud nemáte účet, klikněte na Sign Up (Registrovat) a vytvořte si nový účet vývojáře. Můžete použít e-mail (doporučeno) a nastavte heslo. Pozor: Tento účet je oddělený od účtu ve Smart Life app – klidně použijte stejný e-mail, ale musíte se zaregistrovat zvlášť, přihlášení účtem Smart Life zde nefunguje.

2. Přihlášení: Po registraci se přihlaste do Tuya IoT platformy svými novými údaji.

3.2 Vytvoření nového Cloud projektu

Jakmile jste přihlášeni na iot.tuya.com, můžete vytvořit projekt, pod který se „zavěsí“ vaše aplikace a zařízení:

1. V levém menu klikněte na sekci Cloud (ikona oblaku) a poté na podsekci Development (Vývoj) nebo Cloud Development. Otevře se stránka My Cloud Projects (Moje cloudové projekty). Pokud je to váš první projekt, bude prázdná.

2. Klikněte na modré tlačítko Create Cloud Project (Vytvořit cloudový projekt). Zobrazí se dialog pro založení projektu.

3. Vyplnění údajů projektu:

   • Project Name (Název projektu): Zadejte libovolný název, například SmartHome nebo HomeAssistant.
   • Description (Popis): Volitelně můžete uvést popis (např. „Propojení Smart Life s Home Assistant“), není to však nutné.
   • Industry (Odvětví): Z rozbalovací nabídky vyberte Smart Home (Chytrá domácnost).
   • Development Method (Způsob vývoje): Vyberte Smart Home. (Tato volba zajistí, že projekt bude mít přístup k běžným funkcím chytré domácnosti. Nezaměňte s „Custom“, chceme opravdu Smart Home PaaS.)
   • Data Center (Datové centrum): Zvolte oblast, kde se nacházejí vaše zařízení. Tuya uvádí mapování zemí na datacentra – pro Evropu jsou relevantní Central Europe (Evropa – centrální) nebo Western Europe. Pro Českou republiku zvolte Central Europe Data Center (případně Western Europe, pokud by Central Europe nefungovala). Je důležité vybrat správné datacentrum, jinak váš projekt neuvidí zařízení z aplikace.
   

   
   Vytvoření nového cloudového projektu na Tuya IoT platformě (vyplnění názvu, výběr odvětví Smart Home, vývojové metody a datového centra).

4. Klikněte na Create (Vytvořit). Platforma projekt založí a zpravidla vás hned navede do Configuration Wizard (Průvodce konfigurací) pro nastavení oprávnění API.

5. API Permissions (Oprávnění API): Nyní musíme projektu přidělit oprávnění k API, která umožní číst informace o zařízeních. V průvodci by měla být možnost přidat Device Status Notification API a další. Ujistěte se, že máte zaškrtnuté všechny potřebné API, zejména Device Status Notification (Notifikace stavu zařízení). Tyto API jsou nutné pro čtení stavů zařízení a jejich změn. Po výběru klikněte na Authorize (Autorizovat) nebo Next a dokončete průvodce.

   – Pozn.: Pokud se průvodce neobjeví, můžete API nastavit ručně. V projektu přejděte na záložku Service API a tam přidejte požadovaná oprávnění.

6. Projekt je nyní vytvořen. V levém menu byste měli vidět jeho název pod sekcí Cloud > Development. Na Overview (Přehled) stránce projektu najdete základní informace, včetně Project ID, Access ID, Access Secret atd. (k těm se za chvíli vrátíme).

3.3 Propojení projektu s účtem Smart Life (Link Tuya App Account)

Nyní je třeba spojit váš cloudový projekt s vaším účtem v aplikaci Smart Life, aby projekt získal přístup ke konkrétním zařízením:

1. Ve vašem projektu na Tuya IoT platformě přejděte na záložku Devices (Zařízení). (Horní menu by mělo obsahovat Overview, Devices, Service API, atd. – klikněte na Devices.)

2. Na stránce Devices klikněte na tlačítko Link Tuya App Account (Propojit Tuya aplikaci). Někdy je potřeba nejprve kliknout na Link Devices nebo Link App – v každém případě hledejte možnost přidat účet aplikace. Měla by se objevit možnost Link Tuya App Account​
   
   

   

3. Zobrazí se QR kód pro propojení. Nyní vezměte svůj chytrý telefon s nainstalovanou aplikací Smart Life (kde už máte přidaný mikroinvertor):

   • Otevřete Smart Life a přejděte do Profil > Nastavení účtu > Připojit účet k třetí straně (nebo někdy přímo možnost Scan QR Code v rohu aplikace). V novějších verzích Smart Life může být přímo v sekci „Home > + > Scan QR code to add device“, ale tady přidáváme spíš účet, nikoli nové zařízení. V aplikaci by měla být volba pro nasnímání QR kódu pro autorizaci.
   • Naskenujte zobrazený QR kód z Tuya IoT stránky. Aplikace se zeptá na potvrzení propojení účtu s platformou Tuya IoT. Potvrďte (Confirm).

4. Jakmile potvrdíte, webová platforma by měla detekovat propojení. Můžete zavřít dialog s QR kódem. Nyní zobrazte seznam zařízení: stále v záložce Devices přepněte na pod-záložku All Devices (Všechna zařízení). Zde by se měla objevit všechna zařízení, která máte ve Smart Life aplikaci, včetně našeho mikroinvertoru. Uvidíte název zařízení, jeho Device ID, typ, online/offline stav apod.

   • Tip: Pokud se žádná zařízení neobjevila, zkontrolujte, zda jste vybrali správné datacentrum při vytváření projektu. Zařízení se nenahrávají mezi regiony – například pokud jsou zařízení v Evropě a vy jste zvolili datacentrum v USA, neuvidíte je. Řešením je založit nový projekt se správným regionem. Také ověřte, že se přihlašujete stejným účtem Smart Life, který je vlastníkem zařízení (pokud jste zařízení sdíleli s jiným účtem, ten je neuvidí).

5. Nyní je účet propojen a projekt vidí vaše zařízení. Můžeme získat potřebné údaje.

3.4 Získání Access ID a Access Secret (API klíče)

Ještě než se vrhneme na Device ID a Local Key, uložíme si Access ID a Access Secret projektu. Ty využijete, pokud chcete LocalTuya nastavit s cloudovým přístupem. I pokud se rozhodnete LocalTuya cloudem nepropojovat, vyplatí se tyto údaje uschovat pro případné budoucí použití.

• V Tuya IoT platformě otevřete svůj projekt (pokud nejste, klikněte v My Cloud Projects na jméno projektu). Měli byste vidět přehled (Overview).
• V sekci Project Overview najdete položky Access ID a Access Secret. (Access ID se někdy nazývá Client ID.) Kliknutím na ikonu oka odhalíte Secret. Tyto dva řetězce si zkopírujte a uložte. Budou potřeba v nastavení LocalTuya, pokud nepoužijete offline režim. (Poznámka: Tyto údaje udržujte v tajnosti, umožňují přístup k vašemu projektu.)

(Access ID a Secret lze případně později znovu dohledat: v projektu přejděte do Settings nebo Project Overview kdykoli, Secret jde zobrazit znovu. Pokud byste Secret zapomněli, můžete vygenerovat nový, ale to by vyžadovalo aktualizovat i nastavení v HA.)

3.5 Získání Device ID a Local Key zařízení

Device ID už vlastně máme – vidíme ho v tabulce All Devices vedle názvu mikroinvertoru. Pro jistotu si ho zkopírujte (je to dlouhý hexadecimální identifikátor).

Teď ta zásadní informace: Local Key. Tuya ji standardně nikde přímo nezobrazuje, ale můžeme ji zjistit přes API volání. Tuya IoT platforma k tomu nabízí užitečný nástroj API Explorer, kde můžeme jednoduše provést požadavek a získat odpověď v JSONu.

Postup pro získání Local Key přes API Explorer:

1. V levém menu Tuya IoT platformy klikněte znovu na Cloud a pod tím na API Explorer (Průzkumník API). Otevře se nové okno nebo panel s nástrojem pro testování API.

2. Vpravo nahoře se ujistěte, že máte vybraný svůj projekt (mělo by tam být jméno projektu, např. SmartHome). Také ověřte, že je zvolen správný datacentrum (např. Central Europe Data Center) – mělo by se to nastavit samo podle projektu.

3. V levém panelu API Exploreru vyhledejte sekci General Device Management (nebo Device Management). Rozbalte ji, pokud není. V ní najděte API nazvané Get Device Information nebo Query Device Details (název se může lišit, ale jde o volání, které vrátí detaily zařízení podle Device ID). Klikněte na něj.

4. Uprostřed uvidíte pole Device ID. Do něj vložte (nebo napište) Device ID vašeho mikroinvertoru, které jste si zkopírovali.

5. Klikněte na tlačítko Submit Request (Odeslat požadavek). Nalevo se možná zobrazí surový HTTP požadavek, ale nás zajímá Response (Odezva) v pravém panelu.

6. V pravé části by se měl objevit JSON výstup s detailními informacemi o zařízení. Vyhledejte v něm položku "local_key": "<nějakýřetězec>". To je právě náš Local Key! Zkopírujte hodnotu Local Key (bez uvozovek). Bývá to 16znakový alfanumerický kód.

   Na následujícím obrázku vidíte, jak vypadá prostředí API Exploreru s odpovědí obsahující local_key (zvýrazněno žlutě):
   

   

   
   Ukázka použití Tuya API Explorer – volání „Get Device Information“ s Device ID. Vpravo ve Response (odpovědi) je vidět local_key zařízení.
   

7. Pokud je Local Key prázdný nebo se nevrátil, ujistěte se, že zařízení je online (ve výpisu by mělo mít "online": true). U nových zařízení je Local Key generován poté, co zařízení poprvé komunikuje. Je možné, že u zcela nově přidaného zařízení chvíli trvá, než se klíč objeví. Zkuste zařízení ovládat v aplikaci a pak požadavek opakovat.

8. Tímto máme získané všechny klíčové údaje: Device ID a Local Key mikroinvertoru, a případně Access ID/Secret projektu.

🛈 Poznámka: Local Key se může změnit, pokud zařízení resetujete a znovu spárujete s aplikací (protože vytváří nové spojení s cloudem). V takovém případě by bylo nutné znovu vygenerovat Local Key stejným postupem. . 

Nyní máme všechny informace pro finální krok – přidání a konfiguraci zařízení (mikroměniče) v Home Assistant.

 

4. Přidání zařízení (mikroměniče) do Home Assistant pomocí souboru microinverter.yaml

V této fázi nainstalovaný LocalTuya použijeme k integraci konkrétního zařízení. Zaměříme se na mikroměnič, jehož údaje (DP ID pro různé hodnoty) máme připravené. Budeme postupovat pomocí YAML konfigurace (souboru microinverter.yaml), kam vypíšeme všechny senzory. Tuto konfiguraci pak načte integrace LocalTuya.

Vytvoření souboru microinverter.yaml a jeho umístění

1. Otevřete správce souborů Home Assistant (např. doplněk File Editor, Visual Studio Code, nebo připojení přes Samba/SSH do adresáře config). Ujistěte se, že vidíte soubory Home Assistant, zejména configuration.yaml. Pokud nemáte File Editor, můžete jej nainstalovat jako doplněk z oficiálních add-onů.

2. Vytvořte nový soubor v adresáři /config/custom_components/localtuya/templates/ a pojmenujte ho třeba microinverter.yaml. (Název může být libovolný, ale pro přehlednost vycházíme z tohoto jména, které odpovídá původnímu článku.)

3. Do souboru microinverter.yaml vložte definice senzorů a případně binárních senzorů pro váš mikroinvertor. Každý senzor odpovídá jedné hodnotě (datapointu) vystavované zařízením. Následuje příklad obsahu souboru:

Soubor lze stáhnout zde: microinverter.yaml

Toto je kompletní obsah souboru microinverter.yaml pro náš příklad mikroinvertoru. Vidíme, že obsahuje definice 12 senzorů (sensor) a 1 binárního senzoru (binary_sensor). Vysvětleme si jednotlivé položky:

• id: Číselný identifikátor datového bodu (DP) v zařízení. Tyto hodnoty (104, 105, ..., 118) odpovídají specifickým údajům mikroinvertoru. Například zde DP 105 představuje solární (PV) napětí, DP 104 teplotu měniče atd. Tyto ID nebyly zvoleny náhodně – obvykle je lze zjistit z dokumentace zařízení nebo metodou pokus-omyl při integraci (případně někdo v komunitě už vypátral, který DP co znamená).
• friendly_name: Uživatelsky přívětivý název entity, jak se bude zobrazovat v Home Assistant (např. PV Napětí).
• unit_of_measurement: Jednotka měření – např. "V" pro volty, "%" pro procenta, "W" pro watty, "°C" pro teplotu atd. To zajistí, že Home Assistant bude vědět, jak jednotku zobrazit a jak formátovat hodnoty.
• scaling: Mnoho zařízení Tuya vrací celé číslo, které je potřeba vydělit nebo jinak škálovat, aby dávalo skutečnou hodnotu. Například pokud zařízení vrací napětí 23500, se scale 0.01 z toho uděláme 235.00 V. V našem souboru vidíte například PV Napětí má scaling 0.01, takže hodnota 23500 se převede na 235.00 V. Teplota má scale 0.1 (např. 250 -> 25.0 °C), atd. Pokud je scale 1, hodnota se nepřepočítává.
• device_class: Třída zařízení – Home Assistant díky ní ví, o jaký typ senzoru jde, a podle toho může přiřadit ikony či jednotky. Např. voltage pro napětí, current pro proud, power pro výkon, temperature pro teplotu, energy pro energii, safety pro bezpečnostní stav apod. (Binary sensor Anti Reflux má device_class: safety, což značí bezpečnostní čidlo.)
• state_class: Určuje charakter hodnoty – measurement pro aktuální měření (které se mění nahoru i dolů), total_increasing pro kumulativní počitadlo, které se jen zvyšuje (např. celková vyrobená energie). Toto je důležité pro energetický dashboard Home Assistant, aby věděl, jak zacházet s hodnotou.
• icon: (Volitelné) Ruční nastavení ikony (pomocí Material Design Icons) pro daný senzor. V našem příkladu některé senzory mají přiřazené ikony (mdi:flash, mdi:counter, mdi:shield-check apod.), jiné ne – pokud je definován device_class, Home Assistant už vhodnou ikonu často zvolí sám.
• restore: true: (Volitelné, pouze u sensor) Pokud je nastaveno, Home Assistant si pamatuje poslední hodnotu i po restartu (než přijde nová). To je užitečné u kumulativních čidel jako počítadlo energie – po restartu nebudou nulové, ale pamatují si poslední stav.

Ujistěte se, že YAML soubor má správné odsazení (dvě mezery na úroveň odsazení) a že každý senzor začíná - sensor: na novém řádku, binární senzor - binary_sensor: podobně.

Přidání integrace

1. V Home Assistant přejděte do Nastavení > Zařízení a služby a otevřete integraci LocalTuya.
   
   

2. Zvolte Add new device.
   
   

3. Vyberte Add Device Manually, vyplňte IP adresu, Local Key, Device Name a Protocol Version 3.5.
   

4. Potvrďte kliknutím na Odeslat.

5. Následně budete vyzváni dialogem Configure device entitities k nastavení entit zařízení, vyberte třetí možnost Use saved template. Poté vyberte soubor Microinverter.yaml, co jste předtím vytvořili a volbu potvrďte. Následně můžete proklikat všechny entity, co se přidávají a libovolně jejich parametry upravit (např. názvy) 
   
   
   

Ověření funkčnosti zařízení v Home Assistant

Po restartu by měl Home Assistant načíst integraci LocalTuya i s naším nově přidaným zařízením.

• Jděte do Nastavení > Zařízení a služby. Měli byste vidět integraci LocalTuya. Klikněte na ni. Pokud vše proběhlo správně, uvnitř by mělo být uvedeno 1 zařízení (Mikroinvertor) a počet entit (13, pokud počítáme všech 12 senzorů + 1 binární senzor). Kliknutím na zařízení Microinverter byste měli vidět seznam všech entit a jejich aktuální stav.

• Porovnání se Smart Life aplikací: Otevřete aplikaci Smart Life a podívejte se na údaje mikroinvertoru (pokud je tam ukazuje). Srovnejte je s hodnotami v Home Assistant. Měly by zhruba odpovídat (mohou se mírně lišit, pokud se data mění a aplikace zrovna neaktualizovala). Například napětí, proud, výkon by měly sedět.

• Kontrola jednotek a grafů: Přejděte v Home Assistant do Přehled a zkuste si vytvořit jednoduchou kartu, kde zobrazíte několik senzorů (např. entita kartu s hodnotami). Měly by se zobrazovat jednotky. Zkuste kliknout na graf historie – díky nastavení state_class a device_class by se měly hodnoty správně zaznamenávat (např. energie kumulativně).

• Řešení problémů: Pokud některý senzor ukazuje Unavailable nebo Unknown, je možné, že:

  • dané ID není podporováno nebo je špatně (zkontrolujte pravopis, u ID musí být v uvozovkách jako řetězec, i když jsou to čísla),
  • zařízení daný údaj neposkytuje (např. nepotvrzený DP),
  • nebo je chyba v odsazení/syntaxi. Projděte konfiguraci znovu.
    Při potížích koukněte do Protokolu (Log) Home Assistant (v Nastavení > Protokol). Chyby integrace LocalTuya by se tam případně objevily.

Pokud vše funguje, gratuluji! Úspěšně jste integrovali svůj Tuya mikroinvertor do Home Assistant. 🎉 Nyní zařízení komunikuje lokálně – Home Assistant čte jeho hodnoty přímo v síti (přes LocalTuya) a nepotřebuje k tomu cloud ani otevřený internet. Můžete jeho údaje využít k vytváření automatizací, monitoringu výroby elektřiny, nebo je přidat do Energy panelu Home Assistant (zejména senzory denní a celkové výroby kWh se k tomu hodí).