Dodatak za Home Assistant: kompletan vodič za ključne dodatke i integracije

Informatec Digital » Resursi » Dodatak za Home Assistant: kompletan vodič za ključne dodatke i integracije

Ako ste uključeni u svijet kućne automatizacije, prije ili kasnije ćete naići na Home Assistant i njegov ogroman ekosistem dodataka, plug-inova i integracija . Problem je što kada tražite nešto tako specifično kao što je "Home Assistant plug-in", susrećete se s gomilom informacija: dodaci, integracije, HACS, Matter, Zigbee, Z-Wave... i na kraju ne znate odakle početi.

U ovom vodiču ćemo sve to razjasniti. Vidjet ćemo šta je zapravo dodatak za Home Assistant, koje su vrste dostupne i koji su najvažniji za postavljanje stabilnog, sigurnog i jednostavnog za održavanje pametnog doma. Također ćemo pregledati ključne koncepte Zigbee, Z-Wave, MQTT, Matter i najbolje prakse kako biste spriječili da vaša mreža postane noćna mora svaki put kada ažurirate ili dodate novi uređaj.

Šta "plug-in" zaista znači u Home Assistantu?

Kada govorimo o "dodacima" u Home Assistantu, zapravo mislimo na nekoliko različitih stvari: dodatke, integracije i proširenja zajednice (HACS) . Razumijevanje razlike je ključno kako bi se izbjegli problemi tokom instalacije ili ažuriranja.

S jedne strane, postoje dodaci : male aplikacije ili servisi koji se pokreću unutar Home Assistant OS-a ili Home Assistant Supervised-a. To nisu jednostavne konfiguracije; to su kompletni servisi (MQTT serveri, uređivači koda, proxyji, VPN-ovi, itd.) kojima Supervisor upravlja kao kontejnerima, sa vlastitom konfiguracijom i logovima.

Zatim imamo integracije . One omogućavaju Home Assistantu da direktno komunicira s vašim uređajima ili uslugama: Zigbee, Z-Wave, Philips Hue, kamere, usluge u oblaku itd. Njima se upravlja iz odjeljka Integracije na interfejsu i predstavljaju "zvanični" način povezivanja stvari sa sistemom.

I na kraju, tu je HACS (Home Assistant Community Store) , koja funkcionira kao društvena trgovina za dodatke: Lovelace kartice, neslužbene integracije, teme i alate koji nisu standardni, ali uveliko proširuju ono što možete učiniti.

Jedan važan detalj: dodaci su dostupni samo u Home Assistant OS i Home Assistant Supervised , jer su to verzije koje uključuju Supervisor. Ako koristite Home Assistant Container ili Core instaliran direktno na Linuxu, možete koristiti integracije, ali ćete morati sami postaviti dodatke kao zasebne usluge.

Neophodni dodaci za nesmetan rad Kućnog asistenta

Postoje desetine dodataka, ali nekoliko ih je praktično neophodno za funkcionisanje modernog pametnog doma . Nisu baš najblještaviji, ali bez njih se sve ostalo ruši kao kula od karata.

Z-Wave JS (ranije Zwavejs2mqtt)

Ako koristite Z-Wave uređaje, dodatak Z-Wave JS je srce sistema. On premošćuje vašu Z-Wave mrežu i Home Assistant , upravljajući USB adapterom (kao što je Aeotec Z-Stick 7 Plus) i prikazujući senzore, svjetla, utikače, brave i druge uređaje kao entitete u Home Assistantu.

U mnogim domovima, većina kritičnih sistema automatizacije (svjetla, prekidači, senzori pokreta, otvarači garažnih vrata, čak i neki alarmni sistemi ) oslanja se na desetine Z-Wave uređaja . Bez ovog dodatka, ti uređaji jednostavno ne bi postojali za Home Assistant.

Zigbee: Zigbee2MQTT i ZHA

U Zigbee svijetu imate dva glavna puta: Zigbee2MQTT kao dodatak ili ZHA (Zigbee Home Automation) kao izvorna integracija . Oba pretvaraju vaš Zigbee USB koordinator u središte mreže senzora, utikača, svjetala i daljinskih upravljača.

S druge strane, ZHA je službena Zigbee integracija u Home Assistantu . Koristi zigpy biblioteku za komunikaciju s različitim vrstama koordinatora (Silicon Labs, Texas Instruments, ConBee/RaspBee, ZiGate, XBee, itd.) i postavlja mrežu direktno s HA ​​interfejsa, bez potrebe za posredničkom uslugom.

U oba slučaja, ono što traže je isto: uspostaviti stabilnu Zigbee mrežu s koordinatorom, nekoliko rutera i mnogo krajnjih uređaja , koristeći prednosti mesh mreže kako bi se osigurao dovoljan domet i kapacitet.

Zigbee detaljno sa ZHA: koncepti koje morate razumjeti

ZHA integracija je postala jedan od najrobustnijih i najjednostavnijih načina za uvođenje Zigbee-a u Home Assistant . Omogućava vam da zamijenite tipična vlasnička čvorišta (Hue, Aqara, itd.) i centralizirate sve u jednom lokalnom sistemu.

Osnove Zigbee-a

Prije nego što se pozabavite uređajima i njihovim uparivanjem, vrijedi razumjeti kako Zigbee funkcionira. Mreža se sastoji od tri vrste elemenata: koordinatora, rutera i krajnjih uređaja.

• Zigbee koordinatorOvo je glavni adapter (obično USB uređaj priključen na isti računar na kojem radi Home Assistant). Svaka Zigbee mreža može imati samo jedan.
• Zigbee ruteriuređaji napajani električnom mrežom (utikači, sijalice, ventilatori...) koji ponavljaju signal i omogućavaju proširenje dometa i broja čvorova.
• Krajnji uređajiObično se napajaju baterijama (senzori pokreta, senzori temperature, daljinski upravljači itd.) i povezani su s koordinatorom ili obližnjim ruterom.

Ključ Zigbee-a je u tome što formira mrežnu mrežu : ruteri prenose poruke jedan do drugog, tako da možete dosegnuti dijelove kuće daleko od koordinatora bez potrebe za povećanjem snage prijenosa.

Izbor koordinatora i kompatibilnost

ZHA radi s mnogo različitih koordinatora sve dok su kompatibilni sa Zigpy bibliotekom . Preporučeni koordinatori se oslanjaju na Silicon Labs EmberZNet (EZSP) ili Texas Instruments (Z-Stack) čipove, a također podržava i ConBee/RaspBee od Dresden Elektronik.

Podržano je više hardvera (ZiGate, XBee, stariji Silab ili TI modeli), ali sama dokumentacija jasno daje do znanja da ne nude svi adapteri isti nivo stabilnosti i podrške . Ako postavljate veliku instalaciju, najbolje je odabrati moderan i dobro testiran koordinator.

Zigbee kanali i koegzistencija s Wi-Fi-jem

Zigbee od 2,4 GHz koristi 16 kanala, od 11 do 26. Problem je njegova koegzistencija s Wi-Fi-jem : oni se lako mogu preklapati. Opća preporuka je rad s kanalima 15, 20 ili 25, koji obično izbjegavaju najgore preklapanje s tipičnim kućnim Wi-Fi kanalima.

Na stranici ZHA mreže možete promijeniti Zigbee kanal . Postoji opcija "Smart" koja skenira i bira onaj koji se čini najboljim, dajući prioritet kanalima 15, 20 i 25. To je jednokratna promjena: uređajima može trebati i do sat vremena da se ponovo povežu, tako da je najbolje to učiniti kada je sve mirno.

Upravljanje i migracija Zigbee mreže

ZHA ide dalje od pukog uparivanja uređaja. Uključuje detaljne informacije o mreži (kanal, PAN ID, IEEE adresu koordinatora, tip radija, serijski port, brzinu prijenosa podataka itd.) i, što je najvažnije, vrlo moćan sistem za sigurnosno kopiranje i migraciju koordinatora.

Kada kreirate kopiju sa ZHA, možete migrirati cijelu mrežu na drugi adapter (na primjer, sa starijeg dongle-a na noviji) bez potrebe za ponovnim uparivanjem svih uređaja. Proces čak može klonirati IEEE adresu koordinatora tako da čvorovi i dalje prepoznaju mrežu kao istu.

Kako upariti, organizirati i održavati stabilnu Zigbee mrežu

Jedno je da ZHA detektuje vašeg koordinatora, a drugo da mreža radi nesmetano. Veliki dio uspjeha leži u tome kako pozicionirate uređaje, koje rutere koristite i kako izbjegavate smetnje.

Uparite uređaje sa ZHA

Da biste dodali novi uređaj sa ZHA, jednostavno idite na Postavke > Zigbee > Dodaj uređaj , otvorite mrežu da biste dozvolili nove dodatke i stavite uređaj u način rada za uparivanje ili izvršite fabričko vraćanje na tvorničke postavke (prema uputama proizvođača).

Preporučuje se uparivanje uređaja direktno tamo gdje će živjeti , a ne pored koordinatora, a zatim njihovo premještanje. Ako ih uparite odmah pored koordinatora, a zatim ih premjestite u stražnji dio kuće, mogli bi imati manje optimalne ili nestabilne rute.

Ako nešto uzrokuje probleme, provjerite tri stvari: smetnje, broj i kvalitet rutera i status baterije . Mnogi Zigbee uređaji sa slabim baterijama jednostavno neće pouzdano ući u način rada za uparivanje.

Korištenje Zigbee rutera i ograničenja uređaja

Svi koordinatori imaju ograničenje broja direktnih podređenih uređaja (krajnjih uređaja direktno povezanih s njima). Zigpy obično radi s maksimalno 32 direktna podređena uređaja, ali to ne znači da je mreža ograničena na 32 uređaja: s ruterima lako možete dosegnuti stotine.

Ideja je ispuniti kuću uvijek uključenim Zigbee ruterima : utičnicama, sijalicama koje se nikada ne moraju gasiti, ugrađenim modulima itd. Svaki ruter može, zauzvrat, prihvatiti više podređenih uređaja i tako se vrši skaliranje.

U jednostavnom primjeru, koordinator s ograničenjem od 32 uređaja i tri rutera, od kojih svaki podržava 16 uređaja, mogao bi dosegnuti ukupno 77 jedinica. U stvarnim domovima, ako želite pouzdanost, uvijek je mudro dati prioritet većem broju rutera i boljem plasmanu, umjesto da se prekorači teoretski limit uređaja.

Vizualizacija topologije i kvaliteta linka

ZHA uključuje mrežnu mapu koja vam omogućava da vidite kako su čvorovi povezani . Prikazuje odnose s više hopova i, ako ih uređaj prijavi, vrijednosti RSSI i LQI.

Ove brojke treba uzeti s rezervom: svaki proizvođač izračunava RSSI i LQI na svoj način , tako da nisu baš uporedivi. Korisniji su za otkrivanje većih problema: uređaj povezan s jednim, udaljenim ruterom, konstantno vrlo niske vrijednosti, neočekivani prekidi u mesh mreži itd.

Interferencija i postavljanje koordinatora

Jedan od najvećih neprijatelja Zigbee-a je šum koji proizvode USB 3.x portovi i kablovi, Wi-Fi ruteri i metalna kućišta . Zigbee adapter priključen na NAS sa tvrdim diskovima, Wi-Fi ruterom i spletom kablova gotovo sigurno će uzrokovati probleme.

Osnovne smjernice za poboljšanje mreže su jasne: koristite dobro zaštićeni USB 2.0 produžni kabel, postavite koordinator u središte kuće, držite ga dalje od Wi-Fi rutera i drugih uređaja koji proizvode buku i, ako je moguće, koristite adapter s vanjskom antenom.

MQTT, Mosquitto i zašto su toliko važni

Mnogi ključni dodaci za Home Assistant oslanjaju se na MQTT kao lagani i fleksibilni komunikacijski sloj . To je slučaj sa Zigbee2MQTT, nekim starijim Z-Wave mostovima i brojnim DIY projektima.

Dodatak Mosquitto implementira kompletnog MQTT brokera unutar Home Assistanta.

Ako otvorite klijent poput MQTT Explorera, vidjet ćete šumu tema i poruka koje stalno kruže: očitanja senzora, stanja uređaja, naredbe za uključivanje i isključivanje . Kada su vaša Zigbee i Z-Wave mreža integrirane putem MQTT-a, broker postaje doslovno ključna komponenta.

Napredna automatizacija sa Node-RED-om i izvornom automatizacijom

Home Assistant je znatno poboljšao svoj vizualni editor automatizacije . Više se ne morate boriti s YAML-om za jednostavne stvari... ali kada logika postane složena, Node-RED ostaje vrlo moćan alat.

Node-RED se instalira kao dodatak i nudi web interfejs gdje prevlačite i ispuštate čvorove kako biste kreirali tokove koji povezuju uslove, tajmere, pozive usluga i obradu podataka. Posebno je koristan za automatizaciju gdje vizualizacija toka kao dijagrama pomaže da shvatite šta se dešava.

Mnogi ljudi kombiniraju oba svijeta: jednostavne automatizacije u izvornom Home Assistant editoru i složenije tokove rada (složena logika raspoređivanja, integracija više izvora podataka itd.) u Node-RED-u. Nije obavezno, ali pruža mnogo fleksibilnosti.

Dodaci za razvoj, administraciju i udaljeni pristup

Pored čistog sloja automatizacije doma, postoji niz dodataka koji uveliko olakšavaju svakodnevno upravljanje i proširenje Home Assistanta.

Studio kodni server

Studio Code Server integrira verziju Visual Studio Code-a direktno u preglednik kao dodatak Home Assistant-u. Omogućava vam uređivanje configuration.yaml datoteka, automatizacija, skripti i bilo koje druge datoteke bez napuštanja interfejsa.

Uključuje isticanje sintakse, automatsko dovršavanje za YAML i Home Assistant sheme , a možete prilagoditi uređivač, instalirati ekstenzije i otpremati datoteke. Za svakoga ko još uvijek obavlja mnogo ručne konfiguracije, ovo je neophodno.

Napredni SSH i web terminal

Ovaj dodatak pruža SSH terminal dostupan iz preglednika s podrškom za ključeve i napredne opcije. To je najpogodniji način za pokretanje naredbi na hostu, pregled logova, instaliranje HACS-a ili vršenje manjih podešavanja bez oslanjanja na vanjski SSH klijent.

Takođe je veoma koristan u dijagnostici: kada nešto ne radi, sistemski log ili dobro urađen "docker ps" vam štedi mnogo problema.

Tailscale i Cloudflare za siguran udaljeni pristup

Ako želite pristupiti Home Assistantu izvan svog doma, imate nekoliko opcija, ali dva dodatka se ističu po svojoj sigurnosti: Tailscale i Cloudflared.

Tailscale postavlja mrežnu VPN mrežu između vaših uređaja , baziranu na WireGuardu, ali s mnogo jednostavnijom konfiguracijom za korištenje.

S druge strane, Cloudflare kreira šifrirane tunele od vaše instance Home Assistanta do Cloudflare mreže . Omogućava vam da izložite Home Assistant internetu bez otvaranja portova, koristeći vlastitu domenu i certifikate kojima upravlja Cloudflare. To je jedan od najsigurnijih i najčistijih načina da imate uvijek dostupan udaljeni pristup, po cijenu potrebe za domenom i nekom početnom konfiguracijom.

Praćenje, privatnost i dodatne usluge koje čine svu razliku

Nakon što ste postavili temelje (Zigbee/Z-Wave, MQTT, automatizaciju i udaljeni pristup), vrijeme je da usavršite iskustvo dodacima koji poboljšavaju vidljivost, sigurnost i praktičnost.

Uptime Kuma

Uptime Kuma je alat za praćenje dostupnosti koji možete koristiti kao dodatak za praćenje vašeg Home Assistanta, drugih mrežnih usluga, kritičnih uređaja, kamera i još mnogo toga. Omogućava vam definiranje HTTP provjera, pinga, provjera portova, provjera certifikata i primanje upozorenja ako nešto krene po zlu.

Pomoću kontrolnih ploča i grafikona lako je vidjeti obrasce prekida, vremena odziva i male povremene probleme koji bi inače prošli nezapaženo.

AdGuard Home

Integriranjem kao dodatka u Home Assistant možete centralizirati statistiku pregledavanja, poboljšati privatnost i povećati brzinu učitavanja u vašoj kućnoj mreži, kao i ponuditi roditeljski nadzor i prilagođene crne liste.

Grocy, Jellyfin, Muzički asistent i druge korisne usluge

Kućni asistent nije samo za svjetla i utičnice. Zahvaljujući dodacima, možete ga pretvoriti u centralno središte za upravljanje domom i zabavu.

• GrocyUpravitelj zaliha (ostava), kućanski poslovi i planiranje koje se integrira s HA ​​za kreiranje podsjetnika i automatizacije na temelju datuma isteka ili zaliha.
• Jellyfin: medijski server otvorenog koda koji organizira i poslužuje vaše filmove, muziku i serije bez naknada ili vanjskih oblaka.
• Muzički asistentSloj za upravljanje zvukom u više prostorija koji integriše lokalne izvore, online radio i streaming servise pod centralizovanom kontrolom iz Home Assistanta.

ESPHome, Frigate i Matter: budućnost dodataka (plug-inova) u HA

Jedna od najvećih prednosti Home Assistanta je to što olakšava potpuno angažovanje na „uradi sam“ projektima kada želite da idete dalje od onoga što se prodaje u prodavnicama . Tu do izražaja dolaze ESPHome, Frigate i Matter Bridge.

ESPHome za DIY uređaje bazirane na ESP-u

ESPHome je praktično neophodan ako uživate u eksperimentiranju. Omogućava vam konfiguriranje i održavanje uređaja baziranih na ESP8266/ESP32 (senzori, releji, displeji itd.) koristeći YAML i ugrađena OTA ažuriranja.

Iz Home Assistanta možete kompajlirati firmver, flešovati ga i ažurirati sve svoje uređaje. Ovo omogućava da se vaši DIY uređaji ponašaju kao zvanične integracije , sa potpuno izloženim entitetima i bez oslanjanja na kineske cloud usluge.

Fregata kao pametni NVR

Frigate je NVR (mrežni video snimač) sa detekcijom objekata u realnom vremenu pomoću umjetne inteligencije . Integrira se sa Home Assistantom i može pokrenuti automatizaciju kada detektuje ljude, vozila, životinje itd. na vašim IP kamerama.

Ovo omogućava kreiranje scenarija poput "ako je osoba u vrtu i alarm je uključen, pošalji obavještenje i uključi svjetla" s velikom preciznošću, izbjegavajući lažne alarme zbog kretanja drveća, kiše itd.

Most materije i vanjski ekosistemi

Matter Bridge djeluje kao most između Matter uređaja i Home Assistanta bez potrebe za ponovnim uparivanjem. Osim toga, može izložiti vaše HA entitete kao Matter uređaje drugim kontrolerima (kao što su Google Home, Apple HomeKit, itd.).

Sa jednostavnim interfejsom dizajniranim za skaliranje, ovaj dio će postati ključan kako se na tržištu bude pojavljivalo sve više Matter uređaja , a vi ih budete željeli imati pod kontrolom Home Assistanta, a da se pritom ne odreknete svojih uobičajenih glasovnih asistenata.

Sigurnosne kopije: dodatak koji ne djeluje hitno... dok nije

I na kraju, ali ne i najmanje važno: ako nemate dobro postavljen sistem za pravljenje sigurnosnih kopija, igrate se s vatrom . Home Assistant se često ažurira, dodaci se stalno mijenjaju, a hardverske greške ili kvarovi nisu rijetkost.

Dodaci poput Samba Backup ili Home Assistant Google Drive Backup vam omogućavaju da automatizujete potpune sigurnosne kopije vaše instance i sačuvate ih van lokacije (na NAS putem Sambe, Google Drive-a itd.). Ideja je da možete vratiti cijelu instalaciju ili određeni dodatak bez gubitka sedmica rada.

Iskustva mnogih korisnika jasno pokazuju da je prije ili kasnije, veliko vraćanje sistema na prethodno stanje neizbježno . Posjedovanje nedavnih, testiranih i dostupnih snimaka sistema čini veliku razliku između manjeg problema i potrebe za ponovnom izgradnjom cijelog pametnog doma od nule.

Sa svim ovim jasno objašnjenim dodacima i konceptima - od ZHA i MQTT do dodataka za razvoj, praćenje, udaljeni pristup i sigurnosne kopije - postaje sasvim jasno da je Home Assistant mnogo više od "aplikacije za rasvjetu": to je kompletna platforma gdje pravi dodaci transformiraju standardnu ​​instalaciju u robustan, fleksibilan i potpuno kontroliran ekosistem kućne automatizacije , pod uvjetom da posvetite malo vremena odabiru pravih dijelova i razumijevanju kako se oni uklapaju.