Home Assistant Praktische gids

Apparaat onbeschikbaar in Home Assistant: zo vind je de oorzaak

Onderzoek een onbeschikbaar apparaat in Home Assistant via voeding, bronapp, bridge en integratie. Met onze begrensde Sonoff SNZB-04-ervaring.

Totstandkoming: Praktijkervaring

Slimme apparaten met een bewegingssensor, camera en lamp op een donkere ondergrond
Illustratief stockbeeld van slimme apparaten; geen foto van onze Sonoff-opstelling. Foto: Jakub Zerdzicki / Pexels

Is een apparaat onbeschikbaar in Home Assistant? Noteer eerst waar je geen terugmelding meer krijgt. Vergelijk de gewone bediening, een eventuele bronapp en Home Assistant. Kijk daarna of je hetzelfde probleem bij één entiteit of bij meerdere apparaten op dezelfde bridge ziet, voordat je een koppeling verwijdert.

Wij hebben dit meegemaakt met een Sonoff-deursensor. Een schakelaar op dezelfde bridge werkte nog, terwijl we van de sensor geen deurstatus konden uitlezen. Die ervaring maakt de vergelijking nuttig, maar geeft ons geen algemene diagnose voor iedere onbereikbare sensor.

Apparaat onbeschikbaar in Home Assistant: welk symptoom zie je?

Home Assistant gebruikt unavailable wanneer een entiteit haar toestand niet kan aanleveren. Bij unknown heeft de entiteit geen toestandswaarde. Beide vragen om onderzoek; geen van beide vertelt op zichzelf dat de batterij leeg is. Zie de officiële uitleg over toestanden.

Wat je aantreft Wat je eerst vastlegt Waar je verder kijkt
Een bestaande entiteit toont unavailable. Welke entiteit en welke andere functies van dat apparaat nog reageren. Apparaat, verbinding en bijbehorende integratie.
De entiteit toont unknown. Of je ergens anders al een bruikbare waarde ziet. De gegevensbron en de uitleg van die integratie.
Je vindt het apparaat of de entiteit nergens terug. In welke app of lijst je zoekt en welke naam je eerder gebruikte. De koppeling en registratie, zonder iets nieuws toe te voegen als proef.
Je ziet dat de entiteit uitgeschakeld staat. Welke entiteit het is en of je die functie nodig hebt. De apparaat-/integratiegegevens; schakel geen hele reeks functies in om te zoeken.
Je ziet een waarde die niet verandert. Tijdstip, gebruik en de waarde in de bronapp indien aanwezig. De verwachte rapportage en de actuele verbinding; een gelijkblijvende waarde bewijst geen storing.

Een sensor die een getal toont maar niet in het Energy-dashboard verschijnt, vraagt om een andere controle. Ga daarvoor naar energiesensor ontbreekt in Home Assistant.

Bepaal eerst hoe groot de storing is

Vergelijk één entiteit met de overige entiteiten van hetzelfde apparaat. Je kunt bijvoorbeeld nog een batterijwaarde zien terwijl de deurstatus ontbreekt. Noteer dat verschil; een oude batterijwaarde bewijst niet dat de sensor nu verbinding heeft.

Kijk daarna naar één apparaat naast de betrokken sensor, bij voorkeur op dezelfde bridge of integratie. Werkt die nog? En zie je bij andere apparaten hetzelfde probleem? Je wilt hiermee de volgende controle kiezen, niet op basis van één werkend apparaat de hele bridge gezond verklaren.

Begin voor zo'n vergelijking met een onschuldige functie, zoals de status van een lamp in de hal. Test geen slot, rook- of CO-melder, verwarming of ander veiligheidskritisch apparaat door de voeding te onderbreken. Houd de normale handmatige bediening beschikbaar.

Vergelijk de bronapp met Home Assistant

Gebruik de eigen app van het apparaat of de bridge als jouw opstelling die heeft. Kies een handeling die je mag uitvoeren, zoals een normaal gebruikte deur openen en sluiten. Kijk of je de verandering daar terugziet en vergelijk daarna Home Assistant.

  • Wel een actuele toestand in de bronapp, geen toestand in Home Assistant: bekijk de gebruikte integratie en de verbinding waarmee Home Assistant de gegevens ontvangt. Een werkende cloudapp bewijst niet dat een lokale verbinding ook werkt.
  • Ook geen toestand in de bronapp: onderzoek eerst hoe het apparaat bij die app of bridge terechtkomt. Voeding, apparaatverbinding en bridge kunnen relevant zijn; Home Assistant opnieuw installeren is hiermee nog niet onderbouwd.

Leg ook vast of je het apparaat nog als kaart ziet of het niet meer kunt vinden. Die situaties lijken tijdens een storing op elkaar, maar geven een hulpverlener andere informatie. Niet iedere integratie heeft een bronapp; gebruik dan de fysieke bediening en de controles die de integratiedocumentatie beschrijft.

Onze ervaring met de Sonoff SNZB-04

Wij gebruiken Sonoff SNZB-04-deursensoren via een aparte Sonoff-bridge. Bij een storing konden we geen deurstatus meer uitlezen, ook niet in de bronapp. Een schakelaar op dezelfde bridge werkte op dat moment wel. We hebben de precieze appmelding niet vastgelegd en kunnen niet zeggen of de sensorkaart verdwenen was of een offline-aanduiding toonde.

We herinneren ons twee hersteluitkomsten op verschillende momenten. Een keer hielp batterijvervanging. Een andere keer hielden we het resetknopje ingedrukt en werkte de sensor weer, zonder opnieuw koppelen. We hebben geen knopduur, LED-patroon of logs waarmee we die handeling technisch kunnen reconstrueren. De oorzaak staat dus niet vast.

Neem die knophandeling niet over als reparatierecept. SONOFF beschrijft in de oorspronkelijke SNZB-04-handleiding lang indrukken bij koppelen en verwijderen uit de bridge. Daarom noemen wij onze herinnerde handeling geen bewezen fabrieksreset. Raadpleeg de handleiding van jouw exacte model voordat je iets reset of opnieuw koppelt.

Voor ons laat de casus vooral zien welke informatie achteraf ontbreekt. Met de exacte melding en een tijdstip hadden we gerichter kunnen onderzoeken waarom de deursensor geen toestand doorgaf. Het herstel na een nieuwe batterij bewijst zonder batterijmeting evenmin dat een lege batterij de oorzaak was.

Controleer voeding en verbinding zonder alles opnieuw te koppelen

Controleer bij een batterijapparaat de voeding volgens de apparaathandleiding. Gebruik het voorgeschreven batterijtype en de beschreven plaatsing; noteer wat je aantreft voordat je vervangt. Verwissel een ontbrekende batterijwaarde niet met een gemeten lege batterij. Voor lage-batterijmeldingen hebben we een aparte gids over batterijmeldingen in Home Assistant.

Bij een apparaat met een adapter kun je kijken of de normale voeding en bediening werken. Open geen elektrische behuizing en onderbreek geen apparaat dat stroom moet houden. Zoek bij twijfel hulp voor het apparaat of de installatie.

Volg voor bereik en verbinding de documentatie van jouw integratie en apparaat. Noteer of het probleem begon na een verplaatsing of andere wijziging, maar behandel die samenloop nog niet als bewezen oorzaak. Wis de koppeling niet voordat je weet welke instellingen en verwijzingen je daarmee raakt.

Home Assistant: gebruik één melding en één controlemoment

De Home Assistant-probleemdocumentatie verwijst bij integratieproblemen naar relevante logs en de documentatie van die integratie. Zoek een melding die bij het betrokken apparaat en tijdstip past. Noteer de integratienaam en de fouttekst; maak geen diagnose van een losse waarschuwing zonder die context.

Sommige integraties bieden debuglogging of diagnostiek. Gebruik die mogelijkheid alleen als de documentatie van de betrokken integratie haar beschrijft, en beëindig extra logging na de gerichte controle. Deel geen volledige configuratie, tokens, adressen of onnodige huishoudgegevens. Controleer een logbestand voordat je het aan ondersteuning geeft.

Gebruik deze notitiechecklist om je vergelijking vast te leggen. Dit is een invulhulp, geen log uit onze installatie:

Controle Jouw notitie
Tijdstip en symptoom Wanneer merkte je het, welke melding zag je?
Betrokken onderdeel Welke entiteit, welk apparaat, welke integratie of bridge?
Vergelijking Wat werkte nog bij hetzelfde apparaat of dezelfde bridge?
Eén wijziging Welke gedocumenteerde stap voerde je uit?
Hercontrole Welke oorspronkelijke handeling werkte daarna wel of nog steeds niet?

Een ingevulde voorbeeldnotitie kan er zo uitzien: “Deurcontact: de bronapp toont openen en sluiten, maar Home Assistant blijft onbeschikbaar. Een ander apparaat via dezelfde integratie werkt wel.” Dit is een redactioneel voorbeeld, geen waarneming uit onze installatie. In dit voorbeeld lees je de relevante integratiemelding en controleer je de gedocumenteerde verbinding naar Home Assistant; je hebt nog geen oorzaak vastgesteld en verwijdert het deurcontact niet als eerste proef.

Verander geen entiteitstoestand om alleen de tekst unavailable te laten verdwijnen. Daarmee stel je niet vast dat het apparaat weer gegevens levert.

Huisslimmer advies

Bewaar vóór een wijziging genoeg informatie om dezelfde situatie te kunnen vergelijken. Controleer na een gerichte stap opnieuw de oorspronkelijke functie, zoals de terugmelding bij openen en sluiten. Een verdwenen foutmelding alleen is geen bevestiging dat de hele toepassing werkt.

Beslisregel: kies pas een herstelstap nadat je hebt vastgelegd waar de terugmelding stopt. Doe één gedocumenteerde, omkeerbare wijziging en herhaal dezelfde controle. Reset/verwijder een apparaat niet als algemene eerste proef.

Resetten is geen algemene herstelstap voor deze gids. Bij blijvende twijfel geef je de exacte melding, het apparaatmodel en je vergelijking door aan de ondersteuning van de betreffende integratie of fabrikant. Bewaar fysieke bediening en vertrouw voor veiligheidskritische functies niet alleen op een Home Assistant-status.

Veelgestelde vragen

Betekent onbeschikbaar dat de batterij leeg is?

De toestand alleen bevestigt dat niet. Controleer het apparaat en de gegevensbron. Bij onze deursensor hielp batterijvervanging op één moment, maar we hebben geen meting die een lege batterij als oorzaak bevestigt.

De bronapp werkt wel. Moet ik dan Home Assistant herstarten?

Bekijk eerst de integratiemelding en de gebruikte verbinding. Bronapp en Home Assistant kunnen gegevens langs verschillende routes ontvangen. Herstarten zonder die vergelijking kan de foutinformatie moeilijker terugvindbaar maken en geeft geen verklaring voor het probleem.

Moet ik een Sonoff-deursensor resetten als hij niet reageert?

Volg de handleiding van het exacte model en leg de storing eerst vast. De knop kan een koppel- of verwijderfunctie hebben. Onze herinnering aan herstel zonder opnieuw koppelen is geen gecontroleerde resetinstructie voor jouw opstelling.

Het apparaat werkt los wel, maar mijn automatisering niet. Wat nu?

Controleer of je dezelfde entiteit gebruikt en onderzoek daarna trigger, voorwaarden en actie. De gids Home Assistant-automatisering werkt niet behandelt die volgorde en het gebruik van de trace.

Verder lezen

Bronnen

Foto: Jakub Zerdzicki / Pexels, gebruikt onder de Pexels-licentie. Illustratief contextbeeld, niet onze Sonoff-opstelling.

Jouw volgende stap

Los het volgende knelpunt stap voor stap op.

Controleer trigger, voorwaarde en actie voordat je nieuwe apparaten toevoegt.

Naar automatiseringen