Je eerste apparaat toevoegen

Home Assistant is geïnstalleerd en we hebben bekeken hoe integraties, apparaten, entiteiten en ruimtes met elkaar samenhangen.

Nu gaan we die kennis in de praktijk gebruiken.

We voegen één echt apparaat toe en volgen bewust wat Home Assistant tijdens het koppelen aanmaakt.

Daarbij letten we niet alleen op de vraag of we het apparaat kunnen bedienen. We controleren ook:

via welke integratie de verbinding loopt;
of de koppeling lokaal of via de cloud werkt;
welk apparaat Home Assistant aanmaakt;
welke entiteiten beschikbaar komen;
of de waarden en eenheden kloppen;
wat er gebeurt wanneer de verbinding wordt onderbroken;
of de oorspronkelijke handmatige bediening behouden blijft.

Voor ons eerste voorbeeld gebruiken we een slimme stekker.

Een slimme stekker is overzichtelijk, omdat je direct kunt zien en horen of hij schakelt. Sommige modellen meten daarnaast vermogen, spanning, stroom en energieverbruik.

Daardoor kunnen we met één apparaat leren bedienen, meten en foutzoeken.

Wat we gaan toevoegen

In dit hoofdstuk gaan we uit van een slimme stekker die door Home Assistant wordt ondersteund.

We sluiten tijdens het testen een eenvoudige tafellamp op de stekker aan.

Daarmee kunnen we veilig en zichtbaar controleren of:

de fysieke knop werkt;
Home Assistant de stekker kan inschakelen;
Home Assistant de stekker kan uitschakelen;
de weergegeven toestand overeenkomt met de werkelijkheid;
een handmatige verandering door Home Assistant wordt gezien;
eventuele vermogensmetingen reageren.

De precieze koppelmethode hangt af van het gebruikte model.

Een slimme stekker kan bijvoorbeeld werken via:

WiFi;
Zigbee;
Z-Wave;
Matter;
Bluetooth;
een bridge van de fabrikant;
een clouddienst.

Gebruik daarom niet automatisch de eerste stappen die je online tegenkomt.

Controleer eerst welke route bij jouw exacte apparaat hoort.

Dit heb je nodig

Voor dit hoofdstuk gebruiken we:

een werkende Home Assistant-installatie;
een computer of telefoon waarop je Home Assistant kunt openen;
één ondersteunde slimme stekker;
de handleiding of verpakking van de stekker;
eventueel de oorspronkelijke app van de fabrikant;
eventueel een account bij de fabrikant;
eventueel een geschikte bridge of radioadapter;
een eenvoudige tafellamp;
toegang tot je thuisnetwerk;
tijd om de werking rustig te testen.

Gebruik geen verwarming, kookapparaat, pomp of andere zware belasting als eerste test.

Controleer het maximale vermogen en de toegestane belasting van de slimme stekker voordat je iets aansluit.

Eerst het exacte model bepalen

De merknaam alleen is niet voldoende.

Eén fabrikant kan verschillende slimme stekkers verkopen die aan de buitenkant sterk op elkaar lijken, maar intern anders werken.

Een nieuwere uitvoering kan bijvoorbeeld Matter gebruiken, terwijl een ouder model alleen via WiFi en een clouddienst werkt.

Zoek daarom het exacte typenummer op.

Dat staat meestal:

op de verpakking;
op de achterkant of onderkant van het apparaat;
bij de QR-code;
in de oorspronkelijke app;
op het typeplaatje;
in de aankoopgegevens.

Noteer:

Merk:

Model:

Hardwareversie:

Firmwareversie:

Protocol:

Niet ieder apparaat vermeldt al deze gegevens. Schrijf op wat je kunt vinden.

Deze informatie is belangrijk wanneer de koppeling niet lukt of wanneer je later ondersteuning zoekt.

Compatibiliteit vooraf controleren

Open de officiële integratielijst van Home Assistant en zoek naar de fabrikant, productfamilie of gebruikte standaard.

Controleer op de integratiepagina:

of jouw model wordt ondersteund;
welke functies beschikbaar zijn;
hoe de integratie wordt toegevoegd;
of automatische ontdekking mogelijk is;
of een account nodig is;
of de verbinding lokaal of via de cloud werkt;
of een bridge of adapter nodig is;
welke bekende beperkingen bestaan;
of extra instellingen in de fabrikantapp nodig zijn.

Let daarbij op het verschil tussen:

Het merk wordt ondersteund.

en:

Mijn exacte model en gewenste functies worden ondersteund.

Een integratie kan bijvoorbeeld wel de schakelaar ondersteunen, maar niet de vermogensmeting.

Ook kan de ondersteuning afhankelijk zijn van een bepaalde firmwareversie.

Kies bewust één koppelroute

Sommige apparaten kunnen op meerdere manieren aan Home Assistant worden toegevoegd.

Een slimme stekker kan bijvoorbeeld beschikbaar zijn via:

de fabrikantintegratie;
Matter;
HomeKit Device;
MQTT;
een Zigbee-integratie;
een bridge.

Meer mogelijkheden betekent niet dat je ze allemaal moet gebruiken.

Wanneer hetzelfde apparaat via twee routes wordt toegevoegd, kunnen dubbele apparaten en entiteiten ontstaan.

Je krijgt dan bijvoorbeeld:

switch.stekker_werkplaats

switch.stekker_werkplaats_2

Beide schakelaars kunnen hetzelfde fysieke apparaat bedienen. Later is dan niet meer duidelijk welke entiteit in een dashboard of automatisering moet worden gebruikt.

Vergelijk de beschikbare routes op:

lokale of cloudgebaseerde werking;
ondersteunde functies;
reactiesnelheid;
betrouwbaarheid;
benodigde accounts;
benodigde aanvullende hardware;
kwaliteit van de documentatie;
mogelijkheid om het apparaat ook elders te blijven bedienen.

Een algemene standaard zoals Matter is niet automatisch de beste keuze wanneer een lokale fabrikantintegratie meer functies biedt.

Kies voor dit hoofdstuk één route en noteer waarom je die kiest.

Lokaal of via de cloud

Controleer vóór het koppelen hoe Home Assistant met de stekker communiceert.

Bij een lokale koppeling verloopt de route bijvoorbeeld zo:

Home Assistant → thuisnetwerk → slimme stekker

Bij een cloudkoppeling kan de route zijn:

Home Assistant → internet → fabrikant → internet → slimme stekker

Bij een bridge:

Home Assistant → bridge → slimme stekker

En bij Zigbee:

Home Assistant → Zigbee-coördinator → slimme stekker

Deze route bepaalt later waar een storing kan ontstaan.

Een lokale verbinding kan vaak blijven werken zonder internet. Een cloudkoppeling is afhankelijk van de internetverbinding en de dienst van de fabrikant.

Dat betekent niet dat een cloudintegratie onbruikbaar is. Je moet alleen weten waarvan de werking afhankelijk is.

Het apparaat eerst voorbereiden

Niet ieder apparaat kan rechtstreeks vanuit de verpakking door Home Assistant worden toegevoegd.

Sommige slimme stekkers moeten eerst met de app van de fabrikant worden ingesteld. Daarbij krijgt het apparaat bijvoorbeeld:

toegang tot je WiFi-netwerk;
een firmware-update;
een lokaal wachtwoord;
toestemming voor koppelingen van andere systemen.

Andere apparaten hoeven juist niet eerst aan een fabrikantapp gekoppeld te worden.

Een Zigbee-apparaat kan meestal rechtstreeks in koppelmodus worden gezet en door de gekozen Zigbee-integratie worden toegevoegd.

Een Matter-apparaat gebruikt doorgaans een QR-code of numerieke koppelcode.

Volg daarom de voorbereiding van jouw specifieke integratie.

Voer niet zonder reden zowel de fabrikantinstallatie als een afzonderlijke fabrieksreset uit. Een reset kan eerder ingestelde gegevens weer verwijderen.

Bewaar QR-codes en koppelcodes

Matter-apparaten en sommige andere producten worden geleverd met:

een QR-code;
een numerieke installatiecode;
een pincode;
een configuratiekaart.

Bewaar deze informatie.

Plak bijvoorbeeld een kopie in een map met apparaatdocumentatie of maak een foto die je op een veilige plek bewaart.

Zet een QR-code of koppelcode niet openbaar op een website, forum of video.

Wanneer je het apparaat later moet resetten, vervangen of opnieuw koppelen, kan de code opnieuw nodig zijn.

Een apparaat terugzetten naar fabrieksinstellingen

Een eerder gebruikte slimme stekker is mogelijk nog gekoppeld aan:

de app van de vorige eigenaar;
een ander WiFi-netwerk;
een andere Zigbee-coördinator;
een Matter-controller;
een eerdere Home Assistant-installatie.

In dat geval kan een fabrieksreset nodig zijn.

De resetprocedure verschilt per model. Vaak moet je:

een knop meerdere seconden ingedrukt houden;
meerdere keren snel drukken;
de voeding in een bepaald patroon onderbreken;
een resetopening gebruiken.

Neem geen resetprocedure van een vergelijkbaar apparaat over zonder het typenummer te controleren.

Een verkeerd aantal handelingen kan een andere functie uitvoeren dan je verwacht.

Na een succesvolle reset gaat een statuslampje meestal op een herkenbare manier knipperen. Controleer in de handleiding wat het patroon betekent.

Eerst zonder belasting koppelen

Plaats de slimme stekker in een goed bereikbaar stopcontact.

Sluit nog geen apparaat aan.

Zo kun je:

de fysieke knop gemakkelijk bereiken;
het statuslampje bekijken;
veilig opnieuw koppelen;
de stekker verwijderen wanneer hij vreemd reageert;
controleren of hij onverwacht warm wordt.

Wanneer de slimme stekker bij normaal gebruik zonder belasting snel warm wordt, vreemd ruikt of geluid maakt, verwijder hem dan uit het stopcontact en gebruik hem niet verder.

Software lost een mogelijk elektrisch defect niet op.

De fysieke knop controleren

Veel slimme stekkers hebben een handmatige knop.

Druk eenmaal op de knop en kijk of:

het relais hoorbaar schakelt;
het statuslampje verandert;
de uitgang in- of uitschakelt.

Zonder aangesloten belasting kunnen we de uitgang niet altijd direct zien, maar het relais en statuslampje geven vaak al informatie.

Deze test is belangrijk omdat hij Home Assistant nog niet gebruikt.

Wanneer de fysieke knop niet werkt, hoeft het probleem niet bij Home Assistant of de integratie te liggen.

Controleer dan eerst:

voeding;
handleiding;
resetstatus;
mogelijke vergrendeling;
apparaatconditie.

Automatisch ontdekken

Veel netwerkapparaten en bridges worden door Home Assistant automatisch ontdekt.

Ga naar:

Instellingen → Apparaten en diensten

Bekijk het gedeelte met ontdekte integraties.

Zoek naar:

de merknaam;
het model;
het IP-adres;
de naam die je in de fabrikantapp hebt gegeven;
de bridge waarop het apparaat is aangesloten.

Wanneer de juiste integratie wordt voorgesteld, kies je Toevoegen of Configureren.

Controleer voordat je doorgaat:

herken ik dit apparaat;
komt het adres overeen;
is dit de integratie die ik vooraf heb gekozen;
voeg ik niet per ongeluk een apparaat van iemand anders of een dubbel exemplaar toe?

Home Assistant kan ook andere apparaten op het netwerk ontdekken. Voeg niet alles tegelijk toe.

Handmatig een integratie toevoegen

Wanneer Home Assistant het apparaat niet automatisch vindt, kunnen we de integratie handmatig toevoegen.

Ga naar:

Instellingen → Apparaten en diensten

Kies vervolgens:

Integratie toevoegen

Zoek naar de naam van de fabrikant, het protocol of de gekozen integratie.

Selecteer de juiste integratie en volg de stappen op het scherm.

Er kan worden gevraagd om:

IP-adres;
hostnaam;
gebruikersnaam;
wachtwoord;
toegangstoken;
pincode;
QR-code;
toestemming in de fabrikantapp;
keuze van een bridge;
keuze van een radioadapter.

Vul alleen gegevens in waarvan je begrijpt waarvoor ze worden gebruikt.

Wanneer Home Assistant om een IP-adres vraagt, gebruik dan het lokale adres van het apparaat of de bridge. Gebruik niet automatisch het openbare internetadres van je router.

Wanneer moet het apparaat in koppelmodus?

Bij protocollen zoals Zigbee, Z-Wave, Bluetooth en Matter moet een apparaat vaak actief in koppelmodus worden gezet.

Doe dit pas wanneer Home Assistant eveneens zoekt naar een nieuw apparaat.

Veel apparaten blijven maar korte tijd in koppelmodus.

Een goede volgorde is daarom:

Open in Home Assistant het scherm voor het toevoegen van een apparaat.
Start de zoek- of koppelprocedure.
Zet daarna de stekker in koppelmodus.
Houd de stekker tijdens het koppelen in de buurt van de benodigde radio of bridge.
Wacht tot Home Assistant het apparaat toont.
Rond de configuratie af voordat je de stekker verplaatst.

Bij een batterijapparaat moet je soms tussendoor op een knop drukken om het wakker te houden. Een slimme stekker op netspanning blijft meestal actief.

Toevoegen via een fabrikantintegratie

Bij een fabrikantintegratie kan Home Assistant vragen om:

lokale apparaatgegevens;
een lokaal wachtwoord;
accountgegevens;
toestemming via een externe webpagina;
bevestiging op het apparaat.

Controleer of je je werkelijk bij de fabrikant aanmeldt en niet op een nagemaakte pagina.

Gebruik een uniek wachtwoord en sla het veilig op.

Wanneer de integratie cloudgebaseerd is, geef je Home Assistant mogelijk toestemming om apparaten binnen jouw account te bekijken en bedienen.

Lees welke toegang wordt gevraagd.

Na een succesvolle aanmelding kan de integratie meerdere apparaten uit het account toevoegen. Controleer daarom achteraf welke apparaten zijn verschenen.

Toevoegen via een bridge

Sommige apparaten communiceren niet rechtstreeks met Home Assistant maar via een bridge.

Voorbeelden zijn systemen voor:

slimme verlichting;
Zigbee-apparaten;
verwarmingsregelingen;
beveiligingssensoren.

Home Assistant koppelt in dat geval eerst met de bridge.

De bridge levert vervolgens de aangesloten apparaten en entiteiten.

Tijdens het koppelen kan het nodig zijn om een knop op de bridge in te drukken. Daarmee bevestig je fysiek dat Home Assistant verbinding mag maken.

De structuur wordt:

Home Assistant

└── Integratie

└── Bridge

└── Slimme stekker

Wanneer de stekker later niet reageert, controleren we dus niet alleen de stekker, maar ook de bridge en de verbinding tussen Home Assistant en de bridge.

Toevoegen via Zigbee

Voor een rechtstreekse Zigbee-koppeling moet Home Assistant beschikken over:

een geschikte Zigbee-coördinator;
een ingestelde Zigbee-integratie;
een werkend Zigbee-netwerk.

De slimme stekker moet meestal worden teruggezet of in koppelmodus worden geplaatst.

Een slimme stekker op netspanning kan binnen een Zigbee-netwerk vaak als router werken en berichten van andere apparaten doorgeven.

Dat gebeurt pas nadat de stekker correct is toegevoegd en op zijn uiteindelijke plaats is aangesloten.

Koppel het eerste apparaat bij voorkeur dicht bij de coördinator.

Verplaats het pas nadat de configuratie volledig is afgerond.

Toevoegen via Matter

Voor een Matter-apparaat gebruik je meestal de officiële Home Assistant-app op een telefoon.

Je scant de Matter-QR-code of voert de numerieke koppelcode in.

Matter gebruikt Bluetooth vaak alleen tijdens de eerste ingebruikname. De dagelijkse communicatie verloopt daarna bijvoorbeeld via WiFi of Thread.

Controleer op de verpakking of het apparaat Matter gebruikt via:

WiFi;
Thread.

Voor Matter via Thread is een geschikt Thread-netwerk met border router nodig.

Wanneer het Matter-apparaat al aan Apple Home, Google Home of een andere controller is gekoppeld, moet het mogelijk vanuit die omgeving met Home Assistant worden gedeeld. Een gewone fabrieksnieuwe toevoeging kan dan mislukken.

Bewaar de koppelcode ook nadat de installatie is geslaagd.

De koppeling afronden

Wanneer Home Assistant het apparaat heeft gevonden, verschijnt doorgaans een scherm waarin je:

het apparaat een naam kunt geven;
een ruimte kunt kiezen;
aanvullende instellingen kunt controleren;
de configuratie kunt afronden.

Geef de stekker direct een herkenbare naam.

Gebruik bijvoorbeeld:

Stekker werkbank

en niet:

Smart Plug 1

Kies daarna de ruimte:

Werkplaats

Wanneer de juiste ruimte nog niet bestaat, kun je die aanmaken.

Controleer voordat je bevestigt:

is dit werkelijk de juiste stekker;
is de naam begrijpelijk;
klopt de ruimte;
zie ik geen waarschuwing;
wordt de verwachte integratie genoemd?

De integratie controleren

Ga na het toevoegen naar:

Instellingen → Apparaten en diensten → Integraties

Open de integratie waarmee je de slimme stekker hebt toegevoegd.

Controleer:

staat de integratie zonder foutmelding vermeld;
hoeveel apparaten zijn toegevoegd;
hoeveel entiteiten zijn toegevoegd;
is een account of bridge zichtbaar;
wordt lokale of cloudcommunicatie vermeld;
zijn er opties die je nog moet instellen?

Noteer de gebruikte integratie.

Wanneer later een probleem ontstaat, is “de slimme stekker werkt niet” onvoldoende informatie.

Een betere beschrijving is:

De slimme stekker is via de lokale TP-Link-integratie toegevoegd. De integratie blijft geladen, maar alle entiteiten van dit apparaat tonen sinds 14:20 Niet beschikbaar.

De apparaatpagina bekijken

Open vervolgens het apparaat.

Controleer:

naam;
fabrikant;
model;
firmwareversie;
serienummer indien zichtbaar;
toegewezen ruimte;
verbonden integratie;
aanwezige entiteiten;
diagnostische informatie;
eventuele configuratieknoppen.

Vergelijk fabrikant en model met het fysieke typeplaatje.

Wanneer een onverwacht model wordt weergegeven, hoeft dat niet direct fout te zijn. Fabrikanten verkopen soms hetzelfde interne product onder meerdere namen.

Noteer het verschil wel en controleer de documentatie voordat je conclusies trekt.

De entiteiten controleren

Bekijk alle entiteiten die bij de slimme stekker horen.

Je ziet mogelijk:

schakelaar;
vermogen;
energieverbruik;
stroom;
spanning;
interne temperatuur;
signaalsterkte;
firmware-update;
statuslampje;
herstartknop.

Niet ieder model biedt dezelfde entiteiten.

Maak onderscheid tussen:

Dagelijks nuttig

Bijvoorbeeld:

schakelaar;
vermogen;
energieverbruik.

Configuratie

Bijvoorbeeld:

gedrag na stroomuitval;
statuslampje;
automatische uitschakeltijd.

Diagnose

Bijvoorbeeld:

signaalsterkte;
interne temperatuur;
firmwareversie;
verbindingsstatus.

Schakel niet automatisch alle uitgeschakelde entiteiten in.

Bekijk eerst wat iedere entiteit betekent en of je de informatie nodig hebt.

Namen en entiteits-ID’s controleren

Controleer de zichtbare naam en entiteits-ID van de belangrijkste entiteiten.

Bijvoorbeeld:

Naam: Stekker werkbank

Entiteits-ID: switch.stekker_werkbank

en:

Naam: Vermogen werkbank

Entiteits-ID: sensor.stekker_werkbank_vermogen

Dit is het beste moment om onduidelijke namen te verbeteren.

We hebben nog geen dashboards en automatiseringen gemaakt die afhankelijk zijn van deze ID’s.

Gebruik een consequent naamgevingssysteem en verander niet meer dan nodig.

Controleer na het wijzigen of de entiteiten nog steeds een actuele toestand tonen.

Eenheden controleren

Kijk bij meetentiteiten naar de gebruikte eenheden.

Voorbeelden zijn:

kWh

°C

dBm

Deze grootheden betekenen niet hetzelfde.

Vermogen

Vermogen vertelt hoeveel elektrische energie op dat moment wordt gebruikt.

Energie

kWh

Energie vertelt hoeveel verbruik in de tijd is opgeteld.

Een apparaat dat op dit moment 100 watt gebruikt, heeft niet automatisch 100 kilowattuur verbruikt.

Spanning

Spanning is het gemeten elektrische potentiaalverschil.

Stroom

Stroom is de hoeveelheid elektrische lading die op dat moment door de belasting loopt.

Controleer of de waarden fysiek aannemelijk zijn.

Een vermogenswaarde van nul is logisch zolang nog niets op de stekker is aangesloten.

De eerste bedieningstest

We testen eerst de schakelentiteit zonder aangesloten belasting.

Open de apparaatpagina en gebruik de schakelaar in Home Assistant.

Voorspel vooraf:

Wanneer ik de entiteit inschakel, verandert de toestand in Home Assistant naar Aan, hoor ik mogelijk het relais en verandert het statuslampje.

Schakel de stekker in.

Controleer:

verandert de toestand in Home Assistant;
hoor je het relais;
verandert het statuslampje;
gebeurt dit zonder opvallende vertraging;
verschijnt er geen foutmelding?

Schakel daarna weer uit.

Voer iedere handeling één keer uit en wacht op het resultaat.

Snel herhaaldelijk klikken maakt het moeilijker om te bepalen welke opdracht bij welke reactie hoort.

De fysieke knop testen

Bedien de stekker nu met de fysieke knop.

Voorspel:

Wanneer ik de fysieke knop indruk, schakelt het relais en ziet Home Assistant de nieuwe toestand binnen korte tijd.

Controleer:

verandert de fysieke uitgang;
verandert het statuslampje;
wordt de toestand in Home Assistant bijgewerkt;
hoe lang duurt de terugmelding?

Wanneer de stekker fysiek schakelt maar Home Assistant de toestand niet bijwerkt, werkt de bediening mogelijk wel terwijl de terugmelding ontbreekt of vertraagd is.

Dat is belangrijke informatie.

Een goed geïntegreerd apparaat geeft niet alleen opdrachten door, maar meldt ook de werkelijke toestand terug.

Een veilige testbelasting aansluiten

Schakel de slimme stekker uit.

Verwijder hem indien nodig uit het stopcontact en sluit een eenvoudige tafellamp aan.

Controleer dat:

de lamp zelf is ingeschakeld;
het vermogen ruim binnen de specificaties van de stekker valt;
kabels onbeschadigd zijn;
de opstelling droog en vrij ligt;
de stekker niet wordt afgedekt.

Plaats de slimme stekker weer in het stopcontact.

Bedien hem eerst met de fysieke knop.

Werkt de lamp daarmee goed, test dan vanuit Home Assistant.

We hebben nu een zichtbare bevestiging van de werkelijke uitgang.

De toestand vergelijken met de werkelijkheid

Voer vier tests uit:

Schakel de lamp in via Home Assistant.
Schakel de lamp uit via Home Assistant.
Schakel de lamp in met de fysieke knop.
Schakel de lamp uit met de fysieke knop.

Noteer per test:

wat je deed;
wat je verwachtte;
wat fysiek gebeurde;
wat Home Assistant toonde;
hoeveel vertraging je zag.

Een voorbeeld:

Actie	Fysieke lamp	Home Assistant
Inschakelen via Home Assistant	Aan	Aan
Uitschakelen via Home Assistant	Uit	Uit
Inschakelen met knop	Aan	Aan na 1 seconde
Uitschakelen met knop	Uit	Uit na 1 seconde

Wanneer alle vier situaties kloppen, weten we dat bediening én terugmelding werken.

De vermogensmeting testen

Wanneer de stekker een vermogensentiteit heeft, vergelijken we de waarde met de toestand van de lamp.

Met de lamp uit verwachten we een waarde rond:

0 W

Een kleine afwijking kan mogelijk door de stekker zelf of meetonnauwkeurigheid ontstaan.

Schakel de lamp aan en kijk of de vermogenswaarde stijgt.

Noteer:

waarde met lamp uit;
waarde met lamp aan;
tijd tot de waarde verandert;
opgegeven vermogen van de lamp.

De waarden hoeven niet exact gelijk te zijn.

Een lamp waarop 8 watt staat, kan bijvoorbeeld iets meer of minder gebruiken. We willen vooral zien dat de meting logisch reageert.

Wanneer de schakelaar werkt maar de vermogenswaarde niet verandert, onderzoeken we alleen de meetentiteit. We verwijderen niet direct het hele apparaat.

Geschiedenis bekijken

Laat de lamp een paar keer aan- en uitgaan en open daarna de geschiedenis van de schakelentiteit.

Controleer of de veranderingen zijn geregistreerd.

Bekijk ook de vermogenssensor.

Je verwacht:

hogere vermogenswaarden wanneer de lamp aanstond;
lage of nulwaarden wanneer de lamp uitstond;
tijdstippen die overeenkomen met je test.

Geschiedenis maakt zichtbaar wat eerder gebeurde.

Dat is later nuttig wanneer iemand zegt:

De lamp ging vannacht vanzelf aan.

We kunnen dan controleren wanneer de toestand veranderde en vervolgens in het logboek onderzoeken welk onderdeel daarbij betrokken was.

Het logboek bekijken

Open het logboek en filter indien mogelijk op de slimme stekker.

Zoek de gebeurtenissen die bij onze tests horen.

Controleer of het logboek verschil toont tussen:

bediening via Home Assistant;
fysieke bediening;
een statusverandering;
een opdracht vanuit een gebruiker.

Niet iedere integratie levert dezelfde hoeveelheid context.

Wanneer het logboek weinig informatie toont, betekent dat niet automatisch dat de koppeling slecht werkt. Noteer wel welke informatie later bij foutzoeken beschikbaar is.

Testen zonder internet

Deze test voeren we alleen uit wanneer je weet hoe je internet tijdelijk kunt onderbreken zonder andere belangrijke systemen te verstoren.

Schakel niet de volledige router uit. Dan verdwijnt mogelijk ook het lokale netwerk en bewijst de test niet wat we willen weten.

Het doel is:

Blijft de lokale netwerkverbinding tussen Home Assistant en de stekker werken wanneer alleen internet ontbreekt?

Een praktische test kan bijvoorbeeld worden uitgevoerd door de internetverbinding van de router tijdelijk te verbreken terwijl het lokale netwerk actief blijft.

Controleer daarna:

blijft Home Assistant lokaal bereikbaar;
kan de stekker nog worden bediend;
verandert de toestand;
blijven metingen binnenkomen;
toont de integratie een foutmelding?

Mogelijke uitkomst: alles blijft werken

De koppeling werkt waarschijnlijk lokaal voor de geteste functies.

Mogelijke uitkomst: Home Assistant werkt, maar de stekker niet

De integratie of het apparaat kan afhankelijk zijn van een clouddienst.

Mogelijke uitkomst: Home Assistant is eveneens onbereikbaar

Waarschijnlijk is meer dan alleen internet onderbroken of gebruik je een extern adres in plaats van het lokale Home Assistant-adres.

Herstel de internetverbinding na de test en controleer of alles vanzelf terugkomt.

Testen wanneer het apparaat onbereikbaar wordt

Schakel de slimme stekker uit en verwijder hem daarna uit het stopcontact.

De lamp valt vanzelfsprekend uit.

Bekijk Home Assistant.

Let op:

hoelang de oude toestand zichtbaar blijft;
wanneer de entiteiten Niet beschikbaar worden;
of alle entiteiten tegelijk veranderen;
of de integratie een waarschuwing toont;
wat in het logboek verschijnt.

Plaats de stekker daarna terug.

Controleer:

komt het apparaat vanzelf online;
worden de entiteiten opnieuw beschikbaar;
welke schakeltoestand kiest de stekker;
blijft de lamp uit of gaat hij aan;
hoe lang duurt het herstel?

Het gedrag na stroomuitval kan bij sommige stekkers worden ingesteld.

Mogelijke keuzes zijn:

altijd uit;
altijd aan;
vorige toestand herstellen.

Kies bewust welke optie veilig is voor het aangesloten apparaat.

Voor een verwarming of machine kan automatisch inschakelen na stroomherstel ongewenst of gevaarlijk zijn.

Handmatige bediening behouden

Home Assistant moet nuttige bediening toevoegen, maar niet zonder reden de bestaande bediening onmogelijk maken.

Controleer daarom:

werkt de fysieke knop zonder Home Assistant;
blijft de lamp veilig bedienbaar wanneer de server herstart;
wat gebeurt er zonder internet;
wat gebeurt er wanneer de bridge uitvalt;
wat gebeurt er na stroomherstel?

Een slimme stekker die alleen nog via een app kan worden bediend, kan onhandig zijn wanneer de app of het netwerk niet beschikbaar is.

Voor belangrijke functies moet je vooraf bepalen welke bediening als terugvalmogelijkheid beschikbaar blijft.

Wanneer het apparaat niet automatisch wordt gevonden

Controleer eerst:

staat Home Assistant op hetzelfde lokale netwerk;
is het apparaat volledig ingesteld;
is de stekker ingeschakeld;
gebruikt het apparaat 2,4GHz-WiFi wanneer dat vereist is;
staat netwerkisolatie of een gastnetwerk communicatie in de weg;
is lokale toegang in de fabrikantapp ingeschakeld;
gebruikt Home Assistant de juiste integratie;
is het exacte model ondersteund?

Voeg niet willekeurig meerdere vergelijkbare integraties toe.

Controleer de documentatie van het exacte model.

Wanneer de integratie niet kan verbinden

Noteer de volledige foutmelding.

Mogelijke oorzaken zijn:

verkeerd IP-adres;
verkeerde gebruikersnaam of wachtwoord;
lokaal protocol uitgeschakeld;
apparaat nog niet volledig ingesteld;
vereiste bridge niet bereikbaar;
account met meervoudige verificatie;
verouderde firmware;
niet-ondersteund model;
Home Assistant en apparaat in gescheiden netwerken.

Controleer één oorzaak tegelijk.

Wanneer het apparaat wordt toegevoegd maar geen entiteiten heeft

Mogelijke verklaringen zijn:

de integratie ondersteunt alleen beperkte apparaatfuncties;
de entiteiten zijn standaard uitgeschakeld;
de initialisatie is nog niet afgerond;
de firmware wordt niet ondersteund;
het apparaat houdt zich niet volledig aan de gebruikte standaard;
de integratie heeft aanvullende configuratie nodig.

Bekijk:

de apparaatpagina;
uitgeschakelde entiteiten;
integratiedocumentatie;
systeemlogboeken;
bekende beperkingen.

Verwijder het apparaat niet direct. Leg eerst vast wat wel en niet is aangemaakt.

Wanneer de schakelaar werkt maar meetwaarden ontbreken

Dit vertelt ons dat de communicatie niet volledig verbroken is.

De schakelopdracht werkt immers.

Onderzoek specifiek:

ondersteunt dit model vermogensmeting;
ondersteunt de integratie deze meetfunctie;
staat de meetentiteit uitgeschakeld;
verandert de waarde pas bij voldoende belasting;
is een firmware-update nodig;
wordt de waarde slechts periodiek bijgewerkt?

Sluit niet direct een zwaarder apparaat aan om een meetwaarde af te dwingen. Gebruik alleen een veilige belasting binnen de specificaties.

Wanneer Home Assistant een dubbele stekker toont

Controleer:

zijn twee integraties toegevoegd;
is het apparaat via Matter én de fabrikantintegratie gekoppeld;
is een oude configuratie blijven bestaan;
zijn twee fysieke apparaten met dezelfde naam aanwezig;
is het apparaat na een reset als nieuw exemplaar toegevoegd?

Bepaal welke koppeling je wilt behouden.

Verwijder niet willekeurig één exemplaar wanneer het al in automatiseringen wordt gebruikt.

Controleer eerst:

de integratie;
entiteits-ID’s;
apparaatidentificatie;
geschiedenis;
dashboards en automatiseringen.

Wanneer de toestand achterloopt

Bedien de stekker fysiek en meet hoe lang Home Assistant nodig heeft om de verandering te tonen.

Sommige integraties ontvangen veranderingen direct. Andere vragen periodiek de toestand op.

Een vertraging van enkele seconden kan bij de gekozen communicatiemethode horen.

Een toestand die helemaal niet wordt bijgewerkt is een ander probleem.

Controleer:

verandert de toestand na vernieuwen;
blijft de bediening vanuit Home Assistant werken;
werkt lokale communicatie;
toont het systeemlogboek time-outs;
beschrijft de integratiedocumentatie een update-interval?

Noteer de gemeten vertraging in plaats van alleen te zeggen dat het “langzaam” is.

Het apparaat documenteren

Leg voor ieder toegevoegd apparaat minimaal vast:

Naam:

Merk:

Model:

Hardwareversie:

Firmwareversie:

Protocol:

Integratie:

Lokale of cloudverbinding:

IP-adres of bridge:

Ruimte:

Belangrijkste entiteiten:

Datum toegevoegd:

Bewaar ook:

handleiding;
QR-code of koppelcode;
aankoopinformatie;
resetprocedure;
bijzonderheden na stroomuitval.

Deel geen wachtwoorden, tokens of koppelcodes in openbare documentatie.

Deze gegevens lijken bij één stekker misschien overdreven. Na enkele jaren en tientallen apparaten zijn ze bijzonder waardevol.

Een kleine oefening

Pas de test alleen toe op een veilige slimme stekker en een eenvoudige lamp.

Test 1 — Bediening vanuit Home Assistant

Schakel de stekker in.
Controleer de fysieke lamp.
Controleer de toestand in Home Assistant.
Schakel de stekker uit.
Controleer opnieuw.

Test 2 — Fysieke bediening

Bedien de stekker met de knop.
Controleer of Home Assistant de verandering ziet.
Meet de vertraging.

Test 3 — Meetwaarden

Noteer het vermogen met de lamp uit.
Schakel de lamp in.
Noteer het vermogen opnieuw.
Vergelijk de waarden met je verwachting.

Test 4 — Tijdelijk onbereikbaar

Schakel de stekker uit en verwijder hem uit het stopcontact.
Bekijk wanneer de entiteiten niet beschikbaar worden.
Plaats de stekker terug.
Controleer of hij zelfstandig herstelt.

Test 5 — Stroomherstel

Noteer de toestand vóór de onderbreking.
Verwijder de stekker kort uit het stopcontact.
Plaats hem terug.
Controleer welke uitgangstoestand wordt gekozen.

Test 6 — Geschiedenis en logboek

Zoek de uitgevoerde schakelingen in de geschiedenis.
Bekijk dezelfde periode in het logboek.
Vergelijk welke informatie beide schermen geven.

Wat hebben we aangetoond?

Wanneer alle controles zijn geslaagd, hebben we meer gedaan dan een slimme stekker toevoegen.

We hebben aangetoond dat:

de gekozen integratie verbinding kan maken;
Home Assistant het juiste apparaat heeft aangemaakt;
de belangrijkste entiteiten beschikbaar zijn;
de stekker vanuit Home Assistant kan worden bediend;
fysieke veranderingen worden teruggemeld;
eventuele meetwaarden logisch reageren;
de ruimte en namen begrijpelijk zijn;
de geschiedenis veranderingen registreert;
het apparaat na een tijdelijke onderbreking herstelt;
we weten of internet voor de geteste functies nodig is.

Dat vormt een betrouwbare basis voor dashboards en automatiseringen.

Videobegeleiding

De bijbehorende video kan de modelspecifieke handelingen laten zien die in tekst moeilijk volledig algemeen te beschrijven zijn.

Een logische video-opbouw is:

Het exacte merk en typenummer tonen.
De officiële integratiepagina openen.
De gekozen koppelroute uitleggen.
De reset- of koppelknop fysiek aanwijzen.
Het apparaat in koppelmodus zetten.
De integratie in Home Assistant toevoegen.
Het apparaat benoemen en aan een ruimte koppelen.
De apparaatpagina en entiteiten bekijken.
Bediening via Home Assistant testen.
Bediening via de fysieke knop testen.
De vermogensmeting vergelijken.
De stekker tijdelijk onbereikbaar maken.
Geschiedenis en logboek bekijken.
Afsluiten met de controlelijst.

Laat in de video geen van de volgende gegevens zichtbaar staan:

wachtwoorden;
toegangstokens;
persoonlijke e-mailadressen;
Matter-koppelcodes;
volledige QR-codes;
openbaar IP-adres;
persoonlijke locatiegegevens.

Maak testgegevens onleesbaar of knip deze gedeelten uit de opname.

Wat je uit dit hoofdstuk kunt meenemen

Een apparaat toevoegen begint niet bij de knop Integratie toevoegen.

Het begint bij het controleren van het exacte model, de ondersteunde functies en de beschikbare koppelroutes.

Kies bewust één integratie. Hetzelfde apparaat via meerdere routes toevoegen kan dubbele apparaten en entiteiten veroorzaken.

De algemene volgorde is:

Controleer het exacte model.
Lees de actuele integratiedocumentatie.
Kies één koppelroute.
Bereid het apparaat voor.
Voeg de integratie toe.
Benoem het apparaat.
Koppel het aan een ruimte.
Controleer alle entiteiten.
Test bediening en terugmelding.
Test meetwaarden.
Onderbreek de verbinding gecontroleerd.
Controleer herstel, geschiedenis en logboek.
Documenteer de configuratie.

Een succesvolle koppeling bewijst alleen dat Home Assistant een verbinding heeft kunnen maken.

Pas nadat de fysieke bediening, terugmelding, meetwaarden en het herstel na een storing zijn gecontroleerd, weten we hoe betrouwbaar en bruikbaar de koppeling werkelijk is.

In het volgende hoofdstuk gebruiken we de toegevoegde stekker om ons eerste eigen dashboard te maken. We tonen alleen de informatie die bij dagelijks gebruik werkelijk nuttig is.