HACS - komunitní integrace a UI
HACS je neocenitelným zdrojem pro všechny nadšence Home Assistant, kteří chtějí rozšířit možnosti své chytré domácnosti. Jde o rozsáhlou knihovnu, kde najdete širokou paletu integrací a UI prvků vyvinutých komunitou.
Než se pustíte do objevování HACS, je důležité si uvědomit, že Home Assistant Community Store (HACS) je doplněk třetí strany, který není integrován přímo do Home Assistant. Aby bylo možné využívat jeho bohaté zdroje, je nutné jej nainstalovat zvlášť. Tento projekt je navíc udržován nezávislým vývojářským týmem, a proto pro něj mohou platit jiné podmínky a standardy podpory.
Instalace
Nejjednodušším způsobem instalace je použití HACS instalačního skriptu. Konkrétní kroky instalace se pak liší v závislosti na tom jaký typ instalace Home Assistanta používáme.
- HassOS / Supervised
- Container
- Core
-
Přejděte do [Obchodu s doplňky]../addon_store/)
-
Nainstaluje si jeden z SSH add-onů (budete potřebovat zapnout advanced mode ve svém profilu HA)
-
Nastavte zvolený SSH add-on
-
Nastartujte SSH add-on
-
Připojte se do SSH add-onu
-
Spusťte the HACS instalační skript
wget -O - https://get.hacs.xyz | bash -
Alternativně můžete pro spuštění skriptu použít add-on Visual Studio Code, který má také terminál a zároveň je to skvělý editor konfiguračních YAML souborů.
-
Otevřete terminál
-
Připojte se do kontejneru a jeho bashe -
docker exec -it homeassistant bash
-
Spusťte the HACS instalační skript
wget -O - https://get.hacs.xyz | bash -
-
Otevřete terminál
-
Spusťte the HACS instalační skript
wget -O - https://get.hacs.xyz | bash -
Nyní bychom měli mít integraci HACS v HA nainstalovanou, ale než se vrhneme na její konfiguraci tak bude potřeba ještě restartovat HA.
Restart HA můžeme udělat rovnou z terminálu pomocí příkazu ha code restart
.
Konfigurace
Než budeme pokračovat v konfiguraci bude potřeba refreshnout cache prohlížeče. To můžeme udělat například pomocí kombinace kláves Ctrl(Command)+Shift+R
.
-
V menu nastavení zvolíme Integrace a klikneme vpravo dole na tlačítko Přidat integraci.
-
Do pole vyplníme HACS a klikneme na něj
-
Zatrhneme všechny volby kromě poslední.
-
Klikneme na odkaz a přihlásíme se do GitHubu. Pokud na GitHubu ještě nemáte účet pak bude potřeba si ho založit.
-
Vyplníme kód z předešlého kroku.
-
Potvrdíme autorizaci HACS pro čtení z Githubu pod naším účtem.
-
A máme hotovo - v levém menu HA budeme mít automaticky novou položku HACS.
Debugování
Debugování je klíčovým aspektem při řešení problémů s integracemi v Home Assistant. Zde jsou užitečné tipy, jak efektivně ladit a diagnostikovat potíže.
-
Základní logy: Pro základní přehled o chodu systému a případných problémech navštivte logovací soubor
home-assistant.log
. Tento soubor obsahuje důležité informace o běhu a chybách vašich integrací. -
Aktivace debug módu: Pokud se potýkáte s konkrétními problémy a potřebujete detailnější informace, můžete aktivovat debug mód. To se provádí přidáním následujícího kódu do vašeho
configuration.yaml
. Tento krok zvýší úroveň logování pro specifické komponenty a umožní vám lépe diagnostikovat problém.configuration.yamllogger:
default: info
logs:
custom_components.hacs: debug
aiogithubapi: debug
Pamatujte, že po vyřešení problémů je doporučeno vrátit logovací nastavení zpět na normální úroveň, aby se zabránilo zbytečnému zatížení systému.
Doporučené HACS integrace
Zatím pouze seznam a budu postupně doplňovat popisky.
Adaptive Lighting
tbd.
Sonoff LAN
tbd.
Tuya Local
tbd.
Hik-Connect
tbd.
Spook 👻 Not your homie
tbd.
MeasureIt
tbd.
Auto Backup
tbd.
Doporučené HACS UI prvky
Zatím pouze seznam a budu postupně doplňovat popisky.
Lovelace Mini Graph Card
tbd.
Mini Media Player
tbd.
Příklad konfigurace pro reproduktor Bose a reproduktor Sonos
Lovelace Horizon Card
tbd.
🍄 Mushroom
tbd.
Vertical Stack In Card
tbd.
Pokud znáte nějaké další zajímavý HACS doplněk, který v seznamu nemám, dejte vědět prosím v komentářích a nebo emailem.