Met een Shelly 2.5 in Home Assistant kun je een daarvoor ingerichte zonnescherminstallatie bedienen en de stand bekijken. Controleer eerst de koppeling en wat de knoppen bij jouw scherm doen. Een schuifregelaar op je dashboard heeft pas nut als de weergegeven stand overeenkomt met de werkelijke opening.
Wij gebruiken een Shelly 2.5 voor ons zonnescherm sinds juni 2022. Hieronder scheiden we onze gebruikservaring van de huidige documentatiestappen. Voor deze gids hebben we geen nieuwe installatie- of veiligheidstest uitgevoerd.
Voor wie is deze gids?
Deze uitleg begint bij een al correct aangesloten Shelly 2.5 en een geschikte motorinstallatie. We behandelen de officiële Home Assistant-koppeling met originele Shelly-firmware. Gebruik je aangepaste firmware, dan kan een andere route gelden. Instructies voor een Shelly Plus 2PM of 2PM Gen3 zijn geen vervanging voor de documentatie van dit model.
Open geen inbouwdoos om het model te controleren. Zoek de apparaatnaam in je bestaande beheeromgeving of aankoopgegevens. Laat twijfel over aansluiting, motorgeschiktheid of beveiliging door een deskundige beoordelen voordat je bediening of instellingen verandert.
Home Assistant: de lokale koppeling
Shelly 2.5 in Home Assistant toevoegen
Open Instellingen → Apparaten & diensten. Verschijnt de Shelly als ontdekt apparaat, rond dan die configuratie af. Anders kies je Integratie toevoegen → Shelly en volg je de stappen. Bij handmatige invoer gebruik je de hostnaam of het IP-adres van jouw apparaat; dat kun je in je router opzoeken.
De officiële Shelly-integratie communiceert rechtstreeks met het apparaat. Een cloudverbinding is daarvoor niet nodig. Dat zegt niets over het offlinegedrag van alle andere onderdelen van je opstelling.
Let bij de 2.5 op Gen1-communicatie
Voor Gen1 beschrijft Home Assistant CoIoT voor statusupdates. Controleer in de lokale Shelly-interface onder Internet & Security → Advanced – Developer Settings of CoIoT aanstaat. Bij ontbrekende updates kan een Home Assistant-reparatiemelding naar deze instelling verwijzen. Volg dan het Gen1-deel van de integratiedocumentatie, inclusief de passende peer-instelling indien nodig.
Verander geen werkende netwerkconfiguratie zonder concrete reden. Open geen routerpoorten naar internet om deze lokale koppeling werkend te krijgen.
Controleer de bedieningsmodus vóór je een dashboard bouwt
De Shelly 2.5 kent Relay en Roller Shutter als verschillende modi. In Relay-modus bedien je afzonderlijke relais. Roller-modus biedt een logische bediening voor een motor met twee bewegingsrichtingen, met opdrachten voor openen, sluiten, stoppen en positie. De Gen1-modeldocumentatie beschrijft dat onderscheid.
Zie je twee losse schakelaars waar je een zonneschermbediening verwacht, ga die dan niet beurtelings uitproberen. Controleer eerst de bestaande apparaatconfiguratie en de geschikte inrichting van de installatie. Een moduswijziging is geen vervanging voor controle van de elektrische aansluiting.
Home Assistant gebruikt voor dit soort bediening een cover-entiteit. Die krijg je via de apparaatkoppeling; je hoeft geen afzonderlijke Cover-integratie toe te voegen. In de Cover-documentatie vind je de algemene toestanden en bedieningsacties.
Checklist: richting, stop en stand begrijpen
Controleer de bediening alleen als de installatie daarvoor geschikt is, de omstandigheden het toelaten en je zicht op het scherm hebt. Houd mensen en voorwerpen buiten het bewegingsbereik. Bij twijfel over veilig testen: laat de installateur helpen.
- Noteer wat de labels betekenen. Bij een zonnescherm bedoelt de ene gebruiker met ‘open’ uitgeschoven en de andere juist ingetrokken. Leg vast welke beweging jouw inrichting bij elk commando maakt voordat je een regel toevoegt.
- Controleer de normale bediening en stopfunctie. Kijk of de bedoelde cover reageert en of de getoonde toestand past bij de beweging. Een mooi pictogram is geen controle van de installatie.
- Vergelijk de getoonde stand met de opening. Positiebediening vraagt volgens Shelly een kalibratie. Daarbij bepaalt het apparaat de bewegingstijden. Een percentage is dus geen onafhankelijke meting van hoe ver het doek fysiek uitstaat.
- Bewaar je bevinding. Noteer welke bediening je gebruikte en wat je zag. Zo kun je een afwijkende kaartweergave later vergelijken zonder meerdere instellingen tegelijk te veranderen.
De Shelly 2.5-webinterfacegids beschrijft positie-instellingen en kalibratie. Start geen kalibratie als proef om een ontbrekende schuifregelaar op te lossen: het scherm gaat daarbij bewegen. Controleer eerst de modelhandleiding en de voorwaarden van je eigen installatie.
Een lezersvoorbeeld: bij een zonnescherm voor de woonkamer wil je schaduw, terwijl je in de app een percentage ziet. Noteer naast dat percentage of het doek ingetrokken, deels uitgeschoven of verder uitgeschoven staat. Klopt de richting niet met je verwachting, stop dan met het voorbereiden van een automatische actie. Eerst moet duidelijk zijn welke opdracht het scherm naar binnen haalt. Dit is een controlevoorbeeld, geen beschrijving van onze kamer of een uitgevoerde meting.
Onze praktijk sinds juni 2022
Bij Huisslimmer gebruiken we de Shelly 2.5 voor het zonnescherm sinds juni 2022. Naar onze herinnering werkte het koppelen en gebruiken meteen goed; we hebben geen concreet probleem met bewegingsrichting of stand hoeven oplossen. Daarmee zeggen we niet dat iedere installatie zonder voorbereiding werkt.
Op ons Home Assistant-startdashboard gebruiken we een Mushroom-kaart met een schuifregelaar voor hoe ver het scherm openstaat. De weergegeven stand komt in ons gebruik overeen met de werkelijke opening. Dat is onze waarneming, geen test van de procentuele nauwkeurigheid.
Daarnaast gebruiken we automatisch sluiten, bijvoorbeeld rond zonsondergang. Fysieke bediening is ook beschikbaar. We hebben voor dit artikel niet gecontroleerd welke exacte trigger of vertraging daarvoor is ingesteld, of wat die bediening tijdens een storing doet. De gemelde gebruiksstart is evenmin bewijs dat alle huidige functies al sinds juni 2022 zo werken.
Pas daarna een kaart of comfortregel toevoegen
Mushroom is optioneel. De Mushroom Cover card kan een positieschuifregelaar tonen. Daarmee voeg je geen positieondersteuning toe aan een apparaat dat die nog niet goed aanbiedt.
Voor de kaartindeling kun je verder met een Home Assistant-dashboard maken. Deze gids gaat over de Shelly en de bediening; daar vind je de stappen voor je eigen startscherm.
Een zonsondergangregel is een comfortkeuze. Lees vóór verdere uitbreiding zonwering automatiseren met aandacht voor veiligheid. Controleer welke windbeveiliging en sensor de fabrikant voor jouw installatie voorschrijft; een tijdstip vervangt die niet.
Werkt de bediening wel, maar voert een regel niet uit wat je verwacht? Gebruik dan Home Assistant-automatisering werkt niet om start, voorwaarden en actie afzonderlijk te onderzoeken.
Een afwijking gericht onderzoeken
- Geen verbinding: controleer of Home Assistant het apparaat op het lokale netwerk kan bereiken en gebruik de foutmelding uit de Shelly-integratie.
- Bediening werkt, status loopt achter: controleer de Gen1-statusupdates voordat je een andere dashboardkaart installeert.
- Twee losse schakelaars: controleer de inrichting en modus; probeer geen motor met twee onafhankelijke schakelopdrachten aan te sturen.
- Stand ontbreekt of klopt niet: vergelijk de lokale Shelly-weergave met Home Assistant. Controleer de gedocumenteerde positievoorwaarden voordat je instellingen of kalibratie wijzigt.
Verander één onderdeel per keer en controleer opnieuw. Geen van deze mogelijke afwijkingen is een storing die we zelf voor deze gids hebben opgelost.
Huisslimmer advies
Maak eerst begrijpelijk wat jouw bestaande scherm doet bij de normale bediening. Kies daarna pas de kaart waarmee je die bediening wilt gebruiken. Ons eigen voordeel zit in de bereikbare positiebediening op het startdashboard; daarvoor hoef je niet meteen een verzameling zon-, temperatuur- en tijdregels te bouwen.
Beslisregel: voeg pas een comfortautomatisering toe als richting, stop en getoonde stand begrijpelijk zijn en je weet hoe je de bediening terugneemt. Bij afwijkende bewegingen onderzoek je de installatie voordat je extra regels toevoegt.
Veelgestelde vragen
Heb ik de Shelly-cloud nodig voor Home Assistant?
De officiële koppeling werkt lokaal met het apparaat. Dat is geen garantie dat iedere appfunctie, andere automatisering of vorm van bediening bij internetuitval blijft werken.
Waarom is een Shelly 2.5 niet hetzelfde als een 2PM?
Het zijn verschillende modellen en generaties. Deze gids gebruikt de 2.5-documentatie en de Gen1-route; neem instellingen van nieuwere modellen niet zonder controle over.
Bewijst een kloppend percentage dat de zonwering veilig is?
Nee. De positie-indicatie zegt niets over correcte montage of bescherming tegen wind. Controle van de installatie en fabrikantvoorwaarden blijft een afzonderlijke verantwoordelijkheid.