De Tuya-dierentuin temmen en afscheid nemen van Chinese clouds

Laten we zeggen dat je een slimme verwarming, een gloeilamp of een waterleksensor hebt gekocht. De doos toont trots het Tuya- of SmartLife-logo. Je verbindt het apparaat, installeert de app, en alles lijkt goed te werken. Maar zodra het internet haperert of China's servers het zwaar hebben, verandert je "slimme" huis in een pompoen. Bekend verhaal?

Veel van ons komen bij Home Assistant precies om de controle over onze huizen te ontwringen aan de greep van cloudservices. Maar Tuya had altijd een addertje onder het gras: de officiële integratie werkt via hun API, die ofwel betaald is, een beperkte proefperiode heeft, of gewoon traag is. Het tuya-local-project lost dit probleem radicaal op — het zorgt ervoor dat apparaten rechtstreeks met je server communiceren via het lokale netwerk.

Wat is het Doel van Dit Project

Om het kort te zeggen: het is een aangepaste component voor Home Assistant waarmee je Tuya-apparaten via Wi-Fi kunt aansturen zonder tussenpersonen.

Het belangrijkste hoogtepunt hier is niet alleen snelheid (hoewel de respons inderdaad vrijwel instant wordt). De kernwaarde is dat de integratie functies kan "opdiepen" die de officiële cloud helemaal niet toont. Bijvoorbeeld specifieke bedrijfsmodi van klimaatapparatuur of gedetailleerde energieverbruiksstatistieken die de Chinezen in de app hebben verborgen maar niet via de API beschikbaar hebben gesteld.

Overigens ondersteunt het project meer dan alleen Wi-Fi-apparaten. Als je een Tuya-gateway hebt, kun je Zigbee-randapparaten via deze aansluiten, hoewel de auteur eerlijk waarschuwt: hub-mogelijkheden voor gelijktijdige lokale verbindingen zijn ernstig beperkt.

Wat tuya-local Kan Doen

De repository claimt ondersteuning voor meer dan duizend apparaten. Het gaat niet alleen om "aan/uit" — het is volwaardige bediening met complexe entiteiten.

1. Klimaat en verwarming. Slimme convectoren, airconditioners en luchtbevochtigers werken met al hun sensoren en voorkeuren.
2. Verlichting. Ondersteuning voor verschillende protocollen (van 3.1 tot 3.5) zorgt ervoor dat zelfs kieskeurige lampen lokaal werken die voorheen weigerden mee te werken.
3. Beveiliging. Er is ondersteuning voor sommige slotmodellen. Het implementeert een slim schema voor het onderscheppen van ontgrendelingssleutels, wat over het algemeen zeldzaam is voor open-source integraties.
4. Huishoudelijke apparaten. Van voederautomaten voor huisdieren (met ondersteuning voor voedingsschema's) tot IR-blasters die commando's direct vanuit de Home Assistant-interface kunnen leren.

Hoe Dit Aan de Gang Te Krijgen Zonder Je Rug Te Breken

Vroeger leek het instellen van lokaal Tuya op een demonenbezweringsritueel: je moest een developer-account aanmaken, local_key via de console extraheren, en lijden. Bij tuya-local is het proces aanzienlijk vereenvoudigd.

De integratie heeft twee installatiepaden. De eerste is de "cloud assistant." Je logt één keer in met je SmartLife-account, de integratie haalt automatisch de apparaatlijst en hun geheime sleutels op, en werkt daarna alleen lokaal met ze. Dit bespaart je het elke zes maanden vernieuwen van de proefperiode op het Tuya IoT-portaal.

Het tweede pad is handmatig. Als je een hardcore paranoïder bent die alle ID's en sleutels al zelf heeft verkregen, typ je ze gewoon in de apparaatkaart.

Valkuilen en Obstakels

Er zijn natuurlijk nuances. Tuya is geen enkele standaard — het is meer een lappendeken van verschillende firmwareversies.

Ten eerste: veel apparaten houden slechts één actieve lokale verbinding aan. Als je de app open hebt staan op je telefoon of een andere integratie actief is (bijvoorbeeld de oude localtuya), kan de nieuwe simpelweg de hardware niet bereiken.

Ten tweede: apparaten op batterij (deur- of rookmelders) werken lokaal niet zonder hub. Ze gaan in slaapstand om energie te besparen en worden alleen wakker om gegevens naar de cloud te "pingen". Je kunt de fysica hier niet voor de gek houden — voor deze is het beter om Zigbee-versies met een geschikte stick te gebruiken.

Ten derde: sommige hardware begint zich vreemd te gedragen als je de internettoegang volledig blokkeert op de router. Ze kunnen in een oneindige herstartlus terechtkomen. De auteur raadt aan om in zulke gevallen niet alleen TCP maar ook DNS-verzoeken van het apparaat te blokkeren.

Waarom Dit Beter Is Dan Alternatieven

Er is een populair alternatief — localtuya. Ik heb beide geprobeerd. localtuya is flexibeler als het gaat om het handmatig configureren van elk specifiek datapunt (DP), maar dat is ook zijn ondergang: het configureren van één complexe thermostaat verandert in een uur pielen met tabellen.

tuya-local neemt de route van kant-en-klare configuraties. Als je apparaat op de ondersteuningslijst staat, selecteer je gewoon het type, en verschijnen alle sensoren/knoppen vanzelf. Dit bespaart een hoop tijd. Als je apparaat niet wordt ondersteund, kun je het project helpen door logs met een data-dump te sturen — de community daar is zeer actief.

Als je huis langzaam maar zeker overspoeld raakt met Tuya-apparaten, is het installeren van deze integratie een must. Alleen al om het feit dat lampen instant aanschakelen, in plaats van een seconde nadat het signaal een rondje heeft gemaakt naar Frankfurt of Shanghai en terug.

Het project is volwassen, met een solide apparaatdatabase en gezonde configuratielogica. Ja, Tuya is nog steeds een "dierentuin," maar met dit gereedschap in je handen heb je tenminste een goede zweep en een zak met trainingstraktaties.

Het is de moeite waard om te proberen als:

• Je moe bent van cloud API-vertragingen.
• Je een specifiek Tuya-apparaat hebt dat niet goed werkt in HA met standaardmethoden.
• Je wilt dat automatiseringen werken, zelfs wanneer je ISP uitvalt.

Je kunt het project vinden in HACS onder naam of rechtstreeks op GitHub: make-all/tuya-local.