Hoe koppel je Tuya apparaten aan Home Assistant via Local Tuya?
Stel je voor: je hebt een stapel Tuya slimme stopcontacten, een paar slimme thermostaten voor je zonnepanelen en een energiezuinige laadpaal. Je wilt ze allemaal in Home Assistant zien, zonder dat je via de cloud moet pingen.
Dat kan, en het heet Local Tuya. Je bent dan even wat tijd kwijt met opzetten, maar daarna loopt het als een trein.
Je data blijft lokaal, je reactietijd is sneller en je energiebeheer voelt een stuk strakker. In deze handleiding leg ik je stap voor stap uit hoe je Tuya apparaten koppelt aan Home Assistant via Local Tuya. We houden het concreet en praktisch.
Je krijgt getallen, timing en veelgemaakte fouten. Zo ben je in een uur of twee klaar en weet je zeker dat je slimme energieopstelling stabiel draait.
Wat je nodig hebt
Je begint met de basics. Een werkende Home Assistant installatie op een Raspberry Pi 4 of 5, een Intel NUC of een vergelijkbare server.
Zorg dat je Home Assistant bijgewerkt bent naar de nieuwste stabiele versie. Local Tuya werkt het best met Home Assistant 2024.x en de HACS add‑on.
Verder heb je Tuya apparaten nodig die werken met Local Tuya. Denk aan een Tuya slim stopcontact van 16A voor je wasmachine, een slimme thermostaat voor je vloerverwarming of cv‑ketel, en een Tuya‑compatible laadpaal of laadkabel. Check of je apparaat in de Tuya Smart of Smart Life app draait. Dat is je startpunt.
Je hebt een laptop of telefoon nodig voor de Tuya IoT Platform.
Maak een gratis account aan op de Tuya IoT Development Platform. Je krijgt een API key en secret. Die heb je nodig om de juiste device ID’s en local keys te vinden.
Verder een netwerk waarop je Home Assistant en Tuya apparaten hetzelfde subnet delen. Meestal is dat 192.168.1.x.
Zorg dat multicast en UDP verkeer niet geblokkeerd worden. Een stabiele wifi of bedraadde verbinding is cruciaal voor je energiebeheer.
Reken op ongeveer 60 tot 90 minuten. Kosten: Local Tuya is gratis via HACS. Een Tuya slim stopcontact kost €15 tot €25.
Een Tuya slimme thermostaat rond €30 tot €60. Een Tuya compatible laadpaal van 3,7 kW of 7,4 kW zit tussen €250 en €500.
Stap 1: Tuya IoT Platform account en API key
Open de Tuya IoT Development Platform en maak een account. Kies het gratis developer account. Na inloggen ga je naar Cloud > API en klik je op “Create Project”.
Kies “Smart Home” als type. Vul je projectnaam in, bijvoorbeeld “Home Assistant Local Tuya”. Kies je land.
Je krijgt nu een API key en secret. Kopieer deze direct naar een veilige plek, bijvoorbeeld een password manager.
Zonder deze gegevens kun je device keys niet uitlezen. Activeer je API. Ga naar “Devices” en klik op “Link App”.
Log in met je Tuya Smart of Smart Life account. Dit koppelt je appsfeer aan het developer platform.
Zonder deze stap zie je geen devices. Veelgemaakte fout: je kiest verkeerd projecttype. Kies altijd “Smart Home”. Een fout type geeft geen device keys. Timing: 5 tot 10 minuten.
Tip: bewaar je API key en secret alsof het wachtwoorden zijn. Local Tuya heeft ze nodig om de lokale sleutels van je apparaten op te halen.
Stap 2: Local Tuya installeren in Home Assistant
Open Home Assistant en ga naar Settings > Add‑ons. Voeg de HACS add‑on toe als je die nog niet hebt.
HACS is de Home Assistant Community Store. Local Tuya is een custom component dat via HACS geïnstalleerd wordt. Installeer HACS als add‑on en start deze.
Ga daarna in Home Assistant naar HACS > Integrations. Zoek “Local Tuya” en klik “Download”.
Kies de juiste versie voor je Home Assistant versie. Herstart Home Assistant na de installatie. Ga naar Settings > Devices & Services > Add Integration. Zoek “Local Tuya”. De integratie vraagt om je API key en secret uit stap 1.
Veelgemaakte fout: je vergeet te herstarten. Local Tuya laadt niet zonder reboot.
Timing: 10 tot 15 minuten. Check of de integratie verschijnt. Als je een fout krijgt over de API, controleer dan of je projecttype klopt en of je app account gelinkt is. Pas je firewall niet aan voordat je deze stappen doorloopt.
Stap 3: Device keys en local keys ophalen
In de Tuya IoT Platform ga je naar je project en dan naar “Devices”. Je ziet nu een lijst met ID’s van je Tuya apparaten.
Elk apparaat heeft een device ID. Noteer deze ID’s per apparaat. Klik op een device en ga naar “Details”.
Zoek het veld “Local Key”. Dit is de lokale sleutel die nodig is voor directe communicatie.
Kopieer deze voor elk apparaat dat je wilt toevoegen. Je kunt ook de device ID’s vinden in de Tuya Smart of Smart Life app. Ga naar apparaatinstellingen en kijk naar “Device ID” of vergelijkbare info.
Soms staat het onder “Over” of “Informatie”. Veelgemaakte fout: je gebruikt de verkeerde local key.
Soms verandert deze na een reset of firmware update. Check altijd in het IoT platform.
Timing: 10 tot 20 minuten. Maak een lijstje met device ID en local key per apparaat. Voorbeeld: slim stopcontact, ID abc123, key xyz789. Voor je thermostaat: ID def456, key uvw123. Dit maakt de volgende stap soepel.
Stap 4: Apparaten toevoegen en configureren
Open Home Assistant en ga naar Settings > Devices & Services > Local Tuya. Klik “Add Device”. Vul het device ID en de local key in.
Kies het juiste IP adres van je apparaat. Je vindt het IP in je router of via de Tuya app. Geef elk apparaat een logische naam.
Bijvoorbeeld “Slim stopcontact wasmachine”, “Thermostaat woonkamer”, “Laadpaal garage”. Dit helpt bij energiebeheer en dashboards.
Local Tuya vraagt soms om een “protocol version”. Kies 3.3 of 3.4, afhankelijk van je apparaat. Als je twijfelt, start met 3.3. Dit werkt voor de meeste Tuya stopcontacten en thermostaten.
Veelgemaakte fout: verkeerd IP. Tuya apparaten kunnen een ander subnet krijgen na router restart.
Check altijd het IP. Timing: 10 tot 15 minuten per apparaat. Test elk apparaat direct.
Schakel een stopcontact aan en uit. Check de thermostaat temperatuur.
Controleer of de laadpaal status correct wordt weergegeven.
Stap 5: Integratie met energiebeheer en zonnepanelen
Voeg je energiemeter toe in Home Assistant. Gebruik een Shelly EM of een andere energiemeter die je zonnepanelen en verbruik meet.
Koppel deze aan je dashboard. Local Tuya apparaten voeg je toe als entities voor schakelen en meten.
Maak een energie dashboard met je zonnepanelen, slimme stopcontacten, thermostaat en laadpaal. Gebruik de Energy tab in Home Assistant. Voeg je Tuya apparaten toe aan energiegrafieken voor inzicht.
Koppel de laadpaal aan je zonnepanelen. Gebruik een automatisering die laadvermogen aanpast op basis van overschot. Stel een drempel in, bijvoorbeeld 1000 watt overschot, voordat de laadpaal vol vermogen start. Veelgemaakte fout: je vergeet de energiebron te configureren.
Zonder energiemeter zie je geen grafieken. Timing: 15 tot 20 minuten.
Test je energiebeheer. Laad je auto bij zonnepanelen overschot.
Check of de thermostaat niet onnodig verwarmt tijdens piekuren. Pas drempels en timings aan voor maximaal rendement.
Stap 6: Automatiseringen voor energiebesparing
Maak een eenvoudige energiebesparende automatisering. Voorbeeld: schakel het slimme stopcontact uit na 30 minuten stilstand.
Koppel dit aan een timer of aan een energie threshold. Thermostaat automatisering: verlaag de temperatuur met 1 graad tijdens piekuren. Koppel aan je zonnepanelen status.
Gebruik een tijdvenster van 18:00 tot 21:00 voor piekuren. Laadpaal automatisering: start laden bij meer dan 1000 watt overschot.
Beperk laadvermogen tot 3,7 kW bij minder overschot. Dit voorkomt netbelasting en bespaart kosten.
Veelgemaakte fout: te agressieve automatiseringen die je comfort aantasten. Test eerst met kleine aanpassingen. Timing: 10 tot 20 minuten. Gebruik energie‑tarieven in je automatiseringen.
Koppel een dynamisch tarief aan je laadpaal en thermostaat. Zo bespaar je extra tijdens dure uren.