🏠 Agent v Home Assistantu

Pokud už máte v dílně Home Assistant, který běží ve dne v noci, máte i kam agenta umístit: je pořád zapnutý, je ve vaší síti a má vlastní obchod s aplikacemi. Tato stránka popisuje, jak ho tam nainstalovat, propojit s vaší dílnou a udržovat aktuální.

Pokud máte jiné zařízení (NAS, počítač, server s Dockerem), vyberte to své v článku Místní agent, kde najdete i to, co agent dělá, ať běží na čemkoli.

---

Co potřebujete

• Home Assistant OS, tedy instalaci, která má obchod s aplikacemi. Instalace „Supervised“ ho mají také, ale Home Assistant je už neudržuje. Pokud váš Home Assistant běží v Dockeru („Container“), aplikace nemá: nainstalujte agenta přes Docker, jak popisuje Agent v Dockeru.
• 64bitové zařízení: mini-PC nebo počítač s procesorem Intel či AMD, Raspberry Pi 4 nebo 5, případně Home Assistant Green nebo Yellow. Na Raspberry Pi 3 ani na 32bitovém systému aplikaci nainstalovat nejde.
• Home Assistant musí být ve stejné síti jako vaše tiskárny. Pokud běží ve virtuálním počítači, jeho síť musí být v režimu most (bridge), ne v NAT.
• Volný port 8257 na tomto zařízení. Pokud ho používá něco jiného, změníte ho za chvilku (viz níže).
• Musíte být vlastníkem dílny v BolloPrint: agenta lze propojit jen s vaší dílnou.

---

Instalace

1. Na počítači nebo telefonu připojeném k vaší síti otevřete tento odkaz: Přidat BolloPrint do mého Home Assistantu. Je to stránka Home Assistantu: napoprvé se zeptá na adresu vašeho Home Assistantu, například http://homeassistant.local:8123.
2. Klikněte na Open link. Váš Home Assistant se zeptá, jestli chcete přidat úložiště aplikací BolloPrint: klikněte na Přidat.
3. Otevře se stránka aplikace BolloPrint Agent se psem BolloPrint. Klikněte na Nainstalovat. Home Assistant si aplikaci připraví sám; trvá to minutu nebo dvě.
4. Klikněte na Spustit. Nechte zapnuté Spustit při spuštění, aby se agent sám vrátil pokaždé, když se Home Assistant restartuje.

---

Propojení s vaší dílnou

1. Na stránce aplikace klikněte na Otevřít webové rozhraní. Stránka agenta se otevře na nové kartě: uvádí, že zatím nepatří k žádné dílně, a zobrazuje kód, například 8054-627E.
2. Klikněte na Propojit s BolloPrint. Dostanete se do BolloPrint; pokud o to požádá, přihlaste se ke svému účtu.
3. Vyberte dílnu, zkontrolujte, že je kód stejný jako na stránce agenta, projděte navržený název (název vašeho Home Assistantu; můžete ho změnit) a potvrďte.
4. Vrátíte se na stránku agenta, kde už stojí „Propojeno s …“. Do minuty ho uvidíte jako Online v Nastavení → Tiskárny → Místní agent, s logem Home Assistantu, a začne hledat vaše tiskárny.

V BolloPrint není potřeba nic předem vytvářet. Karta Home Assistant v Nový agent vám jen připomene tyto kroky.

---

Port stránky

Stránka agenta používá port 8257 na zařízení s Home Assistantem. Pokud ho už používá něco jiného, aplikace se hned po spuštění zastaví a na její kartě Protokol stojí address already in use. Jak ho změnit:

1. Na stránce aplikace otevřete kartu Nastavení.
2. V části Síť zadejte jiné číslo (například 8364) a klikněte na Uložit.
3. Home Assistant se zeptá, jestli má aplikaci restartovat: potvrďte. Otevřít webové rozhraní vás už zavede na nový port.

Změna portu agenta neodpojí od dílny: je to stále tentýž agent se svými tiskárnami.

---

Aktualizace

Aktualizují se tu dvě věci a téměř nikdy nemusíte nic dělat:

Co	Jak se aktualizuje
Agent, tedy to, co komunikuje s vašimi tiskárnami	Sám. Když BolloPrint vydá novou verzi, agent si ji sám stáhne a nainstaluje.
Aplikace v Home Assistantu, tedy to, co agenta spouští	Když vás Home Assistant upozorní na aktualizaci BolloPrint Agent, klikněte na její stránce na Aktualizovat. Pokud tam zapnete Automatická aktualizace, udělá to sám.

Aktualizace aplikace agenta neodpojí od dílny. Jeho identita se ukládá v datech aplikace, která jsou také součástí záloh Home Assistantu.

---

Přesun na jiné zařízení nebo přeinstalace

• Pokud aplikaci přeinstalujete nebo ji dáte na jiný Home Assistant, propojte ji znovu: bude to nový agent. Přidejte přes něj své tiskárny (najde je sám, pokud jsou v jeho síti, nebo podle IP) a přejdou i se svým číslem a celou historií. Potom smažte starého agenta, který zůstane bez tiskáren.
• Pokud na stejném Home Assistantu obnovíte zálohu, která aplikaci obsahuje, agent se vrátí přesně tak, jak byl, už propojený.

---

Odinstalace

1. V BolloPrint přejděte do Nastavení → Tiskárny → Místní agent, otevřete nabídku ⋮ agenta a klikněte na Smazat. Tiskárny, které vedly jen přes něj, zmizí ze seznamu; pokud je někdy znovu přidáte, vrátí se se svou historií.
2. Během několika sekund stránka agenta znovu nabídne Propojit s BolloPrint. Pokud ho už nechcete, otevřete na stránce aplikace v Home Assistantu nabídku ⋮ a klikněte na Odinstalovat.
3. Pokud chcete, odeberte i úložiště: Obchod s aplikacemi → ⋮ → Úložiště a ikona koše vedle BolloPrint.

Pokud aplikaci odinstalujete, aniž byste předtím smazali agenta, zůstane v BolloPrint jako Odpojeno. Smažte ho z jeho nabídky ⋮.

---

Když něco nefunguje

Nejdřív se podívejte na kartu Protokol aplikace v Home Assistantu: uvidíte tam, co agent dělá, a pokud se zastaví, proč.

Příznak	Co dělat
BolloPrint Agent se v obchodě nezobrazuje	V Obchodě s aplikacemi otevřete nabídku ⋮ → Zkontrolovat aktualizace a obnovte stránku. Pokud v Nastavení nemáte Aplikace, váš Home Assistant aplikace nemá: nainstalujte agenta přes Docker.
Aplikaci nejde nainstalovat	Vaše zařízení je 32bitové, například Raspberry Pi 3. Aplikace potřebuje 64 bitů.
Instalace selže v půlce	Home Assistant agenta při instalaci stahuje: zkontrolujte, že má přístup k internetu, a zkuste to znovu.
Aplikace se hned po spuštění zastaví	Podívejte se do karty Protokol. Pokud tam stojí address already in use, port je obsazený: změňte ho, jak je popsáno výše.
Otevřít webové rozhraní se nenačte	Jste mimo síť dílny (vzdálený přístup, VPN, mobilní data). Otevřete ji z místní sítě.
Při propojování se vaše dílna nezobrazí	Agenta můžete propojit jen s dílnami, jejichž jste vlastníkem. Požádejte vlastníka, aby ho propojil sám.
Nenachází žádnou tiskárnu	Je Home Assistant ve stejné síti jako tiskárny? Ve virtuálním počítači musí být jeho síť v režimu most. Pokud jsou v oddělených sítích, přidejte je podle IP: fungují úplně stejně.
Smazali jste ho v BolloPrint a stránka pořád ukazuje „Propojeno“	Počkejte minutu a obnovte stránku: agent se sám restartuje, už bez propojení.