LoroBot pro Home Assistant

Integrace chytré klece LoroBot do Home Assistantu. Přihlásíte se stejným účtem jako v aplikaci a všechny vaše klece se přidají samy.

Co se objeví

Jedno zařízení na klec a u něj:

Entita	Jednotka
Teplota	°C
Vlhkost	%
Světlo	lx
CO2	ppm
VOC index	— (1–500, 100 = běžný vzduch)
Hluk	dB
Hmotnost	g
Wellness skóre	%
Poslední data	čas
Klec se ozývá	ano / ne

Entity mají standardní device_class, takže rovnou fungují dlouhodobé statistiky i karty v přehledu.

Instalace

Budete potřebovat účet LoroBot — ten samý, kterým se přihlašujete do aplikace.

Přes HACS (doporučeno)

Předpokládá, že už v Home Assistantu máte HACS. Není součástí Home Assistantu — je to samostatné rozšíření, které se doinstalovává zvlášť. Pokud ho nemáte, nainstalujte ho podle jejich návodu, nebo použijte ruční postup níže (ten HACS nepotřebuje vůbec).

1. V Home Assistantu otevřete HACS — najdete ho vlevo v hlavním menu, ne v Nastavení.
2. Vpravo nahoře ⋮ → Vlastní repozitáře (Custom repositories).
3. Vložte https://github.com/lorosystems/lorobot-homeassistant, typ Integration, a dejte Přidat.
4. Ve vyhledávání HACS najděte LoroBot a dejte Stáhnout.
5. Restartujte Home Assistant — Nastavení → Systém → ⋮ → Restartovat. Bez restartu se integrace nenačte.
6. Nastavení → Zařízení a služby → + Přidat integraci, napište LoroBot.
7. Přihlaste se e-mailem a heslem od LoroBota.

Hotovo. Všechny klece na účtu se přidají samy, každá jako vlastní zařízení.

Ručně (bez HACS)

1. Nahoře na této stránce Code → Download ZIP a rozbalte ho.
2. Z rozbaleného archivu zkopírujte složku custom_components/lorobot do konfiguračního adresáře Home Assistantu — tam, kde leží configuration.yaml. Výsledkem má být cesta config/custom_components/lorobot/manifest.json.
3. Restartujte Home Assistant.
4. Dál stejně jako výše: Nastavení → Zařízení a služby → + Přidat integraci → LoroBot.

Když se LoroBot v seznamu integrací neobjeví

Skoro vždy je to jedním ze dvou: Home Assistant se nerestartoval, nebo složka skončila jinde. Zkontrolujte, že existuje soubor config/custom_components/lorobot/manifest.json, a restartujte znovu.

Jak to funguje

Integrace se ptá cloudu LoroBota po dvou minutách — stejně často, jak klec posílá data, takže častější dotazování by jen vracelo tatáž čísla.

Přihlašovací token platí 30 dní a integrace si o nový řekne sama, jakmile vyprší. Kdybyste si mezitím změnil heslo, Home Assistant se zeptá na nové.

Klec, která se přes půl hodiny neozvala, se přepne na nedostupná — aby se stará čísla netvářila jako aktuální. Entity Poslední data a Klec se ozývá zůstávají čitelné i tehdy, protože právě podle nich se to má poznat.

Co integrace zatím neumí

• Běží přes cloud, ne lokálně. Klec posílá data na server LoroBota a integrace si je odtud bere. Bez internetu tedy entity zamrznou — klec ale měří dál a data se po obnovení spojení dosbírají. Lokální režim je v plánu.
• Nemá ovládací prvky. Klec je zatím čistě měřicí, není co přepínat.

Ikona

Obrázky značky si integrace nese sama ve složce custom_components/lorobot/brand/. Home Assistant je od verze 2026.3 u neoficiálních integrací bere odtud a mají přednost před obrázky ze CDN — žádná registrace ani pull request nikam nejsou potřeba. (Dřív se posílaly do repozitáře home-assistant/brands; ten je pro neoficiální integrace už nepřijímá.)

Home Assistant si složky všimne jen při načtení integrace, takže po přidání obrázků je potřeba ho restartovat.

Soubor	Rozměr	Co to je
icon.png / icon@2x.png	256×256 / 512×512	zaoblená dlaždice v barvě aplikace, bílý pták
logo.png / logo@2x.png	430×256 / 861×512	široká podoba, černý pták — světlý motiv
dark_logo.png / dark_logo@2x.png	430×256 / 861×512	bílý pták — tmavý motiv

Ikona je schválně plná dlaždice, ne průhledný obrázek: původní logo je černý pták na průhledném pozadí a v tmavém motivu by se ztratil.

Testy

V test/ jsou dva, oba se spouští proti něčemu skutečnému, ne proti maketě:

• api-test.py — 16 scénářů nad klientem API proti falešnému serveru: vypršelý token, mezitím změněné heslo, nedostupný server, únik tajného klíče zařízení. Home Assistant k tomu potřeba není.
• ha-test.mjs + falesny-lorobot.mjs — 17 scénářů proti živému Home Assistantu v Dockeru. Projde onboarding, přidá integraci přes její vlastní config flow (včetně toho, že špatné heslo musí odmítnout) a zkontroluje, že vzniklo správné množství entit se správnými hodnotami, jednotkami a device_class. Postup spuštění je v hlavičce souboru.

Soukromí

Integrace posílá na server jen přihlášení a dotazy na vaše vlastní klece. Tajný klíč zařízení (device_token) se zahazuje hned, jak dorazí, a nikdy se nedostane do stavů entit ani do diagnostiky.