Home Assistant-plug-in: complete handleiding voor belangrijke add-ons en integraties

Informatic Digital » Middelen » Home Assistant-plug-in: complete handleiding voor belangrijke add-ons en integraties

Als je je bezighoudt met domotica, kom je vroeg of laat Home Assistant tegen en het enorme ecosysteem aan plug-ins, add-ons en integraties . Het probleem is dat wanneer je zoekt naar iets specifieks als "Home Assistant plug-in", je een wirwar aan informatie tegenkomt: add-ons, integraties, HACS, Matter, Zigbee, Z-Wave… en uiteindelijk weet je niet waar je moet beginnen.

In deze handleiding verduidelijken we dat allemaal. We bekijken wat een Home Assistant-plug-in precies is, welke typen er beschikbaar zijn en welke het belangrijkst zijn voor het opzetten van een stabiel, veilig en gemakkelijk te onderhouden smart home. We bespreken ook de belangrijkste concepten van Zigbee, Z-Wave, MQTT, Matter en de beste werkwijzen om te voorkomen dat uw netwerk een nachtmerrie wordt telkens wanneer u een update uitvoert of een nieuw apparaat toevoegt.

Wat betekent "plug-in" nu precies in Home Assistant?

Wanneer we het in Home Assistant over "plug-ins" hebben, bedoelen we eigenlijk verschillende dingen: add-ons, integraties en community-extensies (HACS) . Het is essentieel om het verschil te begrijpen om problemen tijdens de installatie of updates te voorkomen.

Enerzijds zijn er add-ons : kleine applicaties of services die draaien binnen Home Assistant OS of Home Assistant Supervised. Dit zijn geen simpele configuraties; het zijn complete services (MQTT-servers, code-editors, proxies, VPN's, enz.) die Supervisor beheert als containers, met hun eigen configuratie en logboeken.

Vervolgens hebben we integraties . Deze stellen Home Assistant in staat om rechtstreeks te communiceren met uw apparaten of services: Zigbee, Z-Wave, Philips Hue, camera's, cloudservices, enzovoort. Ze worden beheerd vanuit het gedeelte Integraties in de interface en zijn de "officiële" manier om apparaten met het systeem te verbinden.

En tot slot is er HACS (Home Assistant Community Store) , een communitywinkel voor plug-ins: Lovelace-kaarten, onofficiële integraties, thema's en tools die niet standaard meegeleverd worden, maar de mogelijkheden aanzienlijk uitbreiden.

Een belangrijk detail: add-ons zijn alleen beschikbaar in Home Assistant OS en Home Assistant Supervised , omdat deze versies Supervisor bevatten. Als je Home Assistant Container of Core rechtstreeks op Linux installeert, kun je wel integraties gebruiken, maar moet je add-ons zelf als aparte services instellen.

Essentiële add-ons voor een soepele werking van Home Assistant

Er zijn tientallen add-ons, maar een paar zijn praktisch onmisbaar voor een modern smart home . Ze zijn misschien niet de meest opvallende, maar zonder hen stort de rest als een kaartenhuis in elkaar.

Z-Wave JS (voorheen Zwavejs2mqtt)

Als je Z-Wave-apparaten gebruikt, is de Z-Wave JS-add-on het hart van het systeem. Het vormt de brug tussen je Z-Wave-netwerk en Home Assistant , beheert de USB-dongle (zoals de Aeotec Z-Stick 7 Plus) en maakt sensoren, lampen, stekkers, sloten en andere apparaten zichtbaar als entiteiten in Home Assistant.

In veel huizen zijn de meeste essentiële domoticasystemen (verlichting, schakelaars, bewegingssensoren, garagedeuropeners, zelfs sommige alarmsystemen ) afhankelijk van tientallen Z-Wave-apparaten . Zonder deze add-on zouden die apparaten simpelweg niet compatibel zijn met Home Assistant.

Zigbee: Zigbee2MQTT en ZHA

In de Zigbee-wereld heb je twee belangrijke mogelijkheden: Zigbee2MQTT als add-on of ZHA (Zigbee Home Automation) als native integratie . Beide transformeren je Zigbee USB-coördinator in het centrum van een mesh-netwerk van sensoren, stekkers, lampen en afstandsbedieningen.

ZHA is daarentegen de officiële Zigbee-integratie in Home Assistant . Het maakt gebruik van de zigpy-bibliotheek om te communiceren met verschillende soorten coördinatoren (Silicon Labs, Texas Instruments, ConBee/RaspBee, ZiGate, XBee, enz.) en zet het netwerk rechtstreeks op vanuit de HA-interface, zonder dat een tussenliggende service nodig is.

In beide gevallen streven ze naar hetzelfde: een stabiel Zigbee-netwerk opzetten met een coördinator, meerdere routers en veel eindapparaten , waarbij ze gebruikmaken van het mesh-netwerk voor voldoende bereik en capaciteit.

Zigbee in detail met ZHA: concepten die u moet begrijpen

De ZHA-integratie is uitgegroeid tot een van de meest robuuste en eenvoudige manieren om Zigbee met Home Assistant te integreren . Hiermee kunt u typische, propriëtaire hubs (zoals Hue, Aqara, enz.) vervangen en alles centraliseren in één lokaal systeem.

Zigbee-basisprincipes

Voordat je aan de slag gaat met apparaten en koppelingen, is het handig om te begrijpen hoe Zigbee werkt. Het netwerk bestaat uit drie soorten elementen: een coördinator, routers en eindapparaten.

• Zigbee-coördinatorDit is de hoofdadapter (meestal een USB-apparaat dat is aangesloten op dezelfde computer waarop Home Assistant draait). Elk Zigbee-netwerk kan er maar één hebben.
• Zigbee-routersApparaten die op het elektriciteitsnet zijn aangesloten (stekkers, lampen, ventilatoren, enz.) en die het signaal herhalen, waardoor het bereik en het aantal knooppunten kan worden uitgebreid.
• EindapparatenZe werken meestal op batterijen (bewegingssensoren, temperatuursensoren, afstandsbedieningen, enz.) en zijn verbonden met de coördinator of een router in de buurt.

Het belangrijkste van Zigbee is dat het een mesh-netwerk vormt : routers geven berichten aan elkaar door, waardoor je delen van het huis die ver van de coördinator verwijderd zijn kunt bereiken zonder het zendvermogen te hoeven verhogen.

Selectie van de coördinator en compatibiliteit

ZHA werkt met veel verschillende coördinatoren, zolang ze maar compatibel zijn met de Zigpy-bibliotheek . Aanbevolen coördinatoren maken gebruik van Silicon Labs EmberZNet (EZSP) of Texas Instruments (Z-Stack) chips, en het ondersteunt ook ConBee/RaspBee van Dresden Elektronik.

Er wordt meer hardware ondersteund (ZiGate, XBee, oudere Silabs- of TI-modellen), maar de documentatie zelf maakt duidelijk dat niet alle adapters dezelfde mate van stabiliteit en ondersteuning bieden . Als u een grote installatie opzet, kunt u het beste kiezen voor een moderne en beproefde coordinator.

Zigbee-kanalen en co-existentie met Wi-Fi

De 2,4 GHz Zigbee-band gebruikt 16 kanalen, van 11 tot en met 26. Het probleem is de co-existentie met wifi : ze kunnen elkaar gemakkelijk overlappen. Over het algemeen wordt aangeraden om met kanaal 15, 20 of 25 te werken, omdat dit meestal de ergste overlapping met typische wifi-kanalen thuis voorkomt.

Via de ZHA-netwerkpagina kunt u het Zigbee-kanaal wijzigen . Er is een 'Smart'-optie die scant en het meest geschikte kanaal kiest, met prioriteit voor kanaal 15, 20 en 25. Het is een eenmalige wijziging: apparaten kunnen tot een uur nodig hebben om opnieuw verbinding te maken, dus u kunt dit het beste doen wanneer het rustig is.

Zigbee-netwerkbeheer en -migratie

ZHA gaat verder dan alleen het koppelen van apparaten. Het bevat gedetailleerde netwerkinformatie (kanaal, PAN-ID, IEEE-adres van de coördinator, radiotype, seriële poort, baudrate, enz.) en, belangrijker nog, een zeer krachtig back-up- en migratiesysteem voor de coördinator.

Wanneer u een kopie maakt vanuit ZHA, kunt u uw volledige netwerk migreren naar een andere adapter (bijvoorbeeld van een oudere dongle naar een nieuwere) zonder dat u alle apparaten opnieuw hoeft te koppelen. Het proces kan zelfs het IEEE-adres van de coördinator klonen, zodat de knooppunten het netwerk als hetzelfde blijven herkennen.

Hoe koppel je, organiseer je en onderhoud je een stabiel Zigbee-netwerk?

Het is één ding dat ZHA je coördinator detecteert, en iets heel anders dat het netwerk soepel draait. Een groot deel van het succes hangt af van hoe je de apparaten positioneert, welke routers je gebruikt en hoe je interferentie voorkomt.

Koppel apparaten met ZHA

Om een ​​nieuw apparaat met ZHA toe te voegen, ga je naar Instellingen > Zigbee > Apparaat toevoegen , open je het netwerk om nieuwe apparaten toe te staan ​​en zet je het apparaat in de koppelingsmodus of voer je een fabrieksreset uit (volgens de instructies van de fabrikant).

Het is aan te raden de apparaten direct op de plek waar ze komen te staan ​​te koppelen , niet naast de coördinator en ze vervolgens te verplaatsen. Als u ze direct naast de coördinator koppelt en ze daarna naar de achterkant van het huis verplaatst, kunnen ze uiteindelijk een minder optimale of instabiele route krijgen.

Als er problemen zijn, controleer dan drie dingen: interferentie, het aantal en de kwaliteit van de routers en de batterijstatus . Veel Zigbee-apparaten met een bijna lege batterij kunnen simpelweg niet betrouwbaar in de koppelingsmodus komen.

Gebruiks- en apparaatlimieten voor Zigbee-routers

Alle coördinatoren hebben een limiet op het aantal directe onderliggende apparaten (eindapparaten die rechtstreeks op hen zijn aangesloten). Zigpy werkt doorgaans met maximaal 32 directe onderliggende apparaten, maar dat betekent niet dat het netwerk beperkt is tot 32 apparaten: met routers kun je er gemakkelijk honderden bereiken.

Het idee is om het huis te vullen met altijd actieve Zigbee-routers : stekkers, lampen die nooit uitgeschakeld hoeven te worden, ingebouwde modules, enzovoort. Elke router kan op zijn beurt meerdere apparaten aansluiten, en zo schaal je het systeem op.

In een eenvoudig voorbeeld zou een coördinator met een limiet van 32 apparaten en drie routers die elk 16 apparaten ondersteunen, in totaal 77 apparaten kunnen aansluiten. In de praktijk is het echter, als betrouwbaarheid belangrijk is, altijd verstandiger om prioriteit te geven aan meer routers en een betere plaatsing, in plaats van de theoretische apparaatlimiet op te zoeken.

Visualisatie van linktopologie en -kwaliteit

ZHA bevat een netwerkkaart waarmee je kunt zien hoe knooppunten met elkaar verbonden zijn . Deze toont relaties tussen meerdere hops en, indien door het apparaat gerapporteerd, ook de RSSI- en LQI-waarden.

Deze cijfers moeten met een korreltje zout worden genomen: elke fabrikant berekent RSSI en LQI op zijn eigen manier , waardoor ze niet exact vergelijkbaar zijn. Ze zijn vooral nuttig voor het opsporen van grote problemen: een apparaat dat is verbonden met een enkele, verre router, consistent zeer lage waarden, onverwachte gaten in het mesh-netwerk, enzovoort.

Interferentie en plaatsing van de coördinator

Een van de grootste vijanden van Zigbee is de ruis van USB 3.x-poorten en -kabels, wifi-routers en metalen behuizingen . Een Zigbee-adapter die is aangesloten op een NAS met harde schijven, een wifi-router en een wirwar aan kabels zal vrijwel zeker problemen veroorzaken.

De basisrichtlijnen voor het verbeteren van het netwerk zijn duidelijk: gebruik een goed afgeschermde USB 2.0-verlengkabel, plaats de coördinator in het midden van het huis, houd hem uit de buurt van wifi-routers en andere apparaten die veel ruis produceren , en gebruik indien mogelijk een dongle met een externe antenne.

MQTT, Mosquitto en waarom ze zo belangrijk zijn

Veel belangrijke Home Assistant-plug-ins maken gebruik van MQTT als een lichtgewicht en flexibele communicatielaag . Dit is het geval bij Zigbee2MQTT, sommige oudere Z-Wave-bridges en talloze doe-het-zelfprojecten.

De Mosquitto-add-on implementeert een complete MQTT-broker binnen Home Assistant.

Als je een client zoals MQTT Explorer opent, zie je een wirwar aan onderwerpen en berichten die constant circuleren: sensorwaarden, apparaatstatussen, aan- en uitschakelcommando's . Wanneer je Zigbee- en Z-Wave-netwerk via MQTT zijn geïntegreerd, wordt de broker een letterlijk cruciaal onderdeel.

Geavanceerde automatisering met Node-RED en native automatisering.

Home Assistant heeft zijn visuele automatiseringseditor aanzienlijk verbeterd . Je hoeft niet langer te worstelen met YAML voor simpele dingen... maar wanneer de logica complexer wordt, blijft Node-RED een zeer krachtig hulpmiddel.

Node-RED wordt geïnstalleerd als een add-on en biedt een webinterface waar je knooppunten kunt slepen en neerzetten om flows te creëren die voorwaarden, timers, serviceaanroepen en gegevensverwerking aan elkaar koppelen. Het is vooral handig voor automatiseringen waarbij het visualiseren van de flow als een diagram helpt om te begrijpen wat er gebeurt.

Veel mensen combineren beide werelden: eenvoudige automatiseringen in de native Home Assistant-editor en complexere workflows (complexe planningslogica, integratie van meerdere gegevensbronnen, enz.) in Node-RED. Het is niet verplicht, maar het biedt wel veel flexibiliteit.

Add-ons voor ontwikkeling, beheer en toegang op afstand

Naast de pure domotica-functionaliteit zijn er diverse plug-ins die het dagelijkse beheer en de uitbreiding van Home Assistant aanzienlijk vereenvoudigen.

Studio Code Server

Studio Code Server integreert een versie van Visual Studio Code rechtstreeks in de browser als een Home Assistant-add-on. Hiermee kunt u configuratiebestanden (configuration.yaml), automatiseringen, scripts en elk ander bestand bewerken zonder de interface te verlaten.

Het bevat syntaxmarkering, automatische aanvulling voor YAML- en Home Assistant-schema's , en je kunt de editor aanpassen, extensies installeren en bestanden uploaden. Voor iedereen die nog veel handmatig configureert, is het een onmisbaar hulpmiddel.

Geavanceerde SSH- en webterminal

Deze add-on biedt een via de browser toegankelijke SSH-terminal met ondersteuning voor sleutels en geavanceerde opties. Het is de handigste manier om commando's op de host uit te voeren, logboeken te bekijken, HACS te installeren of kleine aanpassingen te maken zonder afhankelijk te zijn van een externe SSH-client.

Het is ook erg handig bij diagnose: als iets niet opstart, bespaart een systeemlogboek of een goed uitgevoerde "docker ps" je een hoop problemen.

Tailscale en Cloudflare voor veilige toegang op afstand

Als je Home Assistant van buiten je huis wilt gebruiken, heb je verschillende opties, maar twee add-ons vallen op door hun beveiliging: Tailscale en Cloudflared.

Tailscale zet een mesh VPN op tussen je apparaten , gebaseerd op WireGuard maar met een veel gebruiksvriendelijkere configuratie.

Cloudflare daarentegen creëert versleutelde tunnels van uw Home Assistant-instantie naar het Cloudflare-netwerk . Hierdoor kunt u Home Assistant via internet toegankelijk maken zonder poorten te openen, met behulp van uw eigen domein en certificaten die door Cloudflare worden beheerd. Het is een van de veiligste en meest overzichtelijke manieren om altijd op afstand toegang te hebben, al vereist het wel een domein en enige initiële configuratie.

Monitoring, privacy en extra diensten die het verschil maken.

Zodra de basis is gelegd (Zigbee/Z-Wave, MQTT, automatisering en toegang op afstand), is het tijd om de ervaring te verfijnen met add-ons die de zichtbaarheid, beveiliging en het gebruiksgemak verbeteren.

Uptime Kuma

Uptime Kuma is een beschikbaarheidsmonitoringstool die u als add-on kunt gebruiken om uw Home Assistant, andere netwerkservices, kritieke apparaten, camera's en meer te bewaken. U kunt er HTTP-controles, ping-, poort- en certificaatcontroles mee definiëren en meldingen ontvangen als er iets uitvalt.

Met de dashboards en grafieken is het eenvoudig om patronen in storingen, reactietijden en kleine, intermitterende problemen te herkennen die normaal gesproken onopgemerkt zouden blijven.

AdGuard-startpagina

Door het als add-on in Home Assistant te integreren, kunt u browsestatistieken centraliseren, de privacy verbeteren en de laadsnelheid in uw thuisnetwerk verhogen. Daarnaast biedt het ouderlijk toezicht en aangepaste zwarte lijsten.

Grocy, Jellyfin, Music Assistant en andere handige diensten.

Home Assistant is niet alleen voor lampen en stopcontacten. Dankzij add-ons kun je er een centrale hub van maken voor huisbeheer en entertainment.

• Kruidenier: voorraadbeheer (voorraadkast), huishoudelijke taken en planning die integreert met Home Assistant om herinneringen en automatiseringen te creëren op basis van vervaldatums of voorraad.
• JellyfinEen open-source mediaserver die je films, muziek en series organiseert en aanbiedt zonder kosten of externe cloudopslag.
• Muziek Assistent: Een multiroom-audiomanagementlaag die lokale bronnen, online radio's en streamingdiensten integreert en centraal aanstuurt vanuit Home Assistant.

ESPHome, Frigate en Matter: de toekomst van plug-ins in HA

Een van de grootste sterke punten van Home Assistant is dat het je gemakkelijk maakt om helemaal los te gaan met doe-het-zelfprojecten, vooral als je meer wilt dan wat er in de winkels te koop is . Hier komen ESPHome, Frigate en Matter Bridge om de hoek kijken.

ESPHome voor op ESP gebaseerde doe-het-zelf-apparaten

ESPHome is praktisch onmisbaar als je graag knutselt. Het stelt je in staat om ESP8266/ESP32-gebaseerde apparaten (sensoren, relais, displays, enz.) te configureren en te onderhouden met behulp van YAML en met ingebouwde OTA-updates.

Vanuit Home Assistant kun je de firmware compileren, flashen en al je apparaten up-to-date houden. Hierdoor gedragen je zelfgemaakte apparaten zich als officiële integraties , met volledig zichtbare entiteiten en zonder afhankelijk te zijn van Chinese clouddiensten.

Frigate als slimme NVR

Frigate is een NVR (Network Video Recorder) met realtime AI-objectdetectie . Het apparaat integreert met Home Assistant en kan automatiseringen activeren wanneer het personen, voertuigen, dieren, enzovoort detecteert op uw IP-camera's.

Dit maakt het mogelijk om met grote precisie scenario's te creëren zoals "als er iemand in de tuin is en het alarm is ingeschakeld, stuur dan een melding en schakel de verlichting in" , waardoor valse alarmen door beweging van bomen, regen, enz. worden voorkomen.

Materiebrug en externe ecosystemen

Matter Bridge fungeert als een brug tussen Matter-apparaten en Home Assistant zonder dat opnieuw koppelen nodig is. Bovendien kan het je Home Assistant-entiteiten als Matter-apparaten beschikbaar maken voor andere controllers (zoals Google Home, Apple HomeKit, enz.).

Met een eenvoudige interface die schaalbaar is, wordt dit onderdeel essentieel naarmate er meer Matter-apparaten op de markt komen en je ze allemaal wilt bedienen met Home Assistant zonder je gebruikelijke spraakassistenten op te geven.

Backups: de plug-in die niet urgent lijkt... totdat het dat wel is.

Tot slot: als je geen goed back-upsysteem hebt, speel je met vuur . Home Assistant wordt regelmatig bijgewerkt, add-ons veranderen voortdurend en hardwarefouten of -storingen zijn niet ongebruikelijk.

Add-ons zoals Samba Backup of Home Assistant Google Drive Backup stellen u in staat om volledige back-ups van uw installatie te automatiseren en deze extern op te slaan (op een NAS via Samba, Google Drive, enz.). Het idee is dat u uw volledige installatie of een specifieke add-on kunt herstellen zonder weken werk te verliezen.

Uit de ervaringen van veel gebruikers blijkt dat een grote systeemreset vroeg of laat onvermijdelijk is . Het beschikken over recente, geteste en toegankelijke snapshots maakt het verschil tussen een kleine schrik en het volledig opnieuw moeten opbouwen van je smart home.

Met al deze plug-ins en concepten duidelijk uitgelegd – van ZHA en MQTT tot add-ons voor ontwikkeling, monitoring, toegang op afstand en back-ups – wordt het al snel duidelijk dat Home Assistant veel meer is dan "een app voor verlichting": het is een compleet platform waar de juiste plug-ins een standaardinstallatie transformeren in een robuust, flexibel en volledig beheersbaar domoticasysteem , mits je de tijd neemt om de juiste onderdelen te kiezen en te begrijpen hoe ze op elkaar aansluiten.