ID.nl logo
Integreer Zigbee-apparaten in je smarthome
© rh2010 - stock.adobe.com
Huis

Integreer Zigbee-apparaten in je smarthome

Het grote voordeel van Home Assistant is dat het een breed gamma aan apparaten en diensten ondersteunt voor smarthomes. In dit artikel leggen we uit wat je nodig hebt om Zigbee-apparaten aan te sturen en 433MHz-sensors uit te lezen. We kijken ook kort naar Thread en Matter, smarthomeprotocollen die in opkomst zijn en waarvoor Home Assistant experimentele ondersteuning biedt.

Na het lezen van dit artikel weet je hoe je je Zigbee-apparaten en apparaten die via het 433MHz-protocol uitzenden kunt toevoegen aan Home Assistant. Zodat jij vanaf één apparaat je hele huis kunt aansturen. Daar heb je voor nodig:

  • Een transceiver voor Zigbee-apparaten
  • Een microcontroller met ingebouwde ontvanger en antenne voor senors die op 433MHz uitzenden
  • OpenMQTTGateway die de signalen van de sensors decodeert en naar Home Assistant stuurt

Ook interessant: Welke typen beveiligingssensoren zijn er om mijn huis te beveiligen?

Zonder enige speciale hardware herkent Home Assistant al allerlei apparaten, zoals bluetooth-sensors of de printer in je lokale netwerk. Extra ondersteuning voor apparaten voeg je toe via een integratie. In dit artikel brengen we dat in de praktijk voor Zigbee en voor apparaten die op een frequentie van 433,92 MHz radiosignalen uitsturen. Tot slot kijken we ook naar de ondersteuning voor Matter, het protocol waar zowat alle grote namen in de smarthomewereld zich achter hebben geschaard.

Home Assistant als Zigbee-hub

Zigbee is een populair draadloos protocol voor smarthomes. Honderden fabrikanten hebben Zigbee-apparaten op de markt gebracht, van schakelaars en lampen (bijvoorbeeld Philips Hue) tot diverse soorten sensors. In principe zijn ze ook allemaal compatibel met elkaar. Je hebt wel een Zigbee-coördinator nodig, vaak een hub genoemd, omdat de apparaten geen gebruikmaken van wifi, maar van een eigen draadloos protocol.

Van Home Assistant kun je ook een Zigbee-hub maken, zodat al je Zigbee-apparaten ermee te bedienen zijn. Daarvoor heb je een Zigbee-transceiver nodig. Dit is een apparaatje, doorgaans in de vorm van een usb-dongel, die een radiochip voor Zigbee bevat en het protocol via usb naar je Raspberry Pi of computer overdraagt. Zie het kader ‘Compatibele Zigbee-transceivers’ voor wat modellen die door Home Assistant worden ondersteund.

Home Assistant maakt zelf ook een Zigbee-transceiver in de vorm van de SkyConnect.

Home Assistant SkyConnect

Een van die compatibele Zigbee-transceivers is Home Assistant SkyConnect, ontwikkeld door de makers van Home Assistant. Sluit de dongel via de meegeleverde usb-verlengkabel aan op een usb-poort van je Raspberry Pi. Zorg dat de dongel niet in de buurt zit van een usb3-apparaat, zeker geen externe harde schijf of ssd, en ook niet in de buurt van een wifi-apparaat. Dat veroorzaakt immers storingen in de 2,4GHz-frequentieband van Zigbee.

Als alles goed is, zou je nu al een notificatie van Home Assistant moeten zien dat er een nieuw apparaat is ontdekt: SkyConnect v1.0 van het type Zigbee Home Automation. Klik op Configureer. Bevestig dat je SkyConnect wilt instellen en kies dan Create a network. Home Assistant maakt nu een apparaat voor je Zigbee-coördinator aan. Ken dit toe aan een ruimte en klik op Voltooien.

Home Assistant maakt een apparaat aan voor je Zigbee-coördinator.

Zigbee-apparaten toevoegen

Als je nu een Zigbee-apparaat aan je netwerk wilt toevoegen, moet je het eerst aan je coördinator koppelen. De manier om dat te doen, hangt van het apparaat af. Vaak dien je enkele seconden een knopje op het apparaat ingedrukt te houden, waarna er een ledje van kleur verandert. Volg dus de instructies uit de handleiding van je apparaat voor pairing, tot je apparaat wacht om te koppelen met de coördinator.

Open dan in Home Assistant bij je integraties de apparaatpagina van de Zigbee Coordinator. Klik bij Apparaat info op Voeg apparaten toe via dit apparaat. De coördinator zoekt nu naar apparaten die in pairingmodus staan en voegt ze toe aan het netwerk. Als dat is gelukt, zie je de melding Het apparaat is klaar voor gebruik en kun je de apparaatnaam wijzigen en een ruimte instellen. Koppel nog andere apparaten of verlaat de pagina.

Koppel je Zigbee-apparaten met je coördinator om ze aan je netwerk toe te voegen.

Apparaatinformatie

Vanaf nu zijn je gekoppelde Zigbee-apparaten ook aan het dashboard van Home Assistant toegevoegd en vind je ze op de pagina met integraties bij SkyConnect. Klik je op een van de apparaten in de integratie, dan krijg je de vertrouwde kaders te zien zoals bij andere apparaten. Bij Apparaat info staat een link naar de Zigbee-coördinator waarmee het apparaat is verbonden. En als je op Zigbee info klikt, krijg je informatie te zien zoals het type apparaat, de stroombron en het netwerkadres.

Van sommige Zigbee-apparaten kun je hun gedrag nog instellen. Zo kan een slimme stekker bijvoorbeeld een kinderslot hebben. Wanneer dit slot is ingeschakeld, kan de toestand van de stekker niet worden aangepast. Diezelfde stekker laat je ook het gedrag instellen na een stroomonderbreking: geeft de stekker dan stroom, geen stroom, of onthoudt hij zijn laatste toestand?

Van veel Zigbee-apparaten is het gedrag eenvoudig in Home Assistant aan te passen.

Compatibele Zigbee-transceivers Home Assistant SkyConnect is niet de enige transceiver waarmee je Zigbee-ondersteuning aan Home Assistant kunt toevoegen. De ConBee II en RaspBee II zijn populaire adapters. De eerste is een usb-dongel, terwijl de tweede een printplaatje is dat op de GPIO-header van een Raspberry Pi past.

Er bestaan ook allerlei goedkope usb-dongels gebaseerd op de Texas Instruments CC2652- of CC1352-chip. Ook iTead, de fabrikant van de bekende Sonoff-producten, heeft een ondersteunde dongel: de Zigbee 3.0 USB Dongle Plus–ZBDongle-E.

Heb je al een van die Zigbee-transceivers, dan kun je ze gerust in Home Assistant blijven gebruiken. Moet je er nog een aanschaffen, kies dan bij voorkeur de Home Assistant SkyConnect, want hier komt binnenkort met een firmware-upgrade ook ondersteuning voor Thread bij.

Sensors op 433 MHz

Er bestaat een uitgebreid gamma aan Zigbee-apparaten, maar als je een groot aantal sensors nodig hebt, kan dit wat duur worden. Een goede oplossing zijn dan sensors die hun waardes op de 433MHz-frequentieband uitzenden. Heel wat weerstations of goedkope temperatuursensors werken op deze manier.

Er bestaat geen standaard om deze sensordata te decoderen: elke fabrikant implementeert zijn eigen protocol. Maar gelukkig zijn de protocollen van veel populaire apparaten door hobbyisten uitgezocht en zijn er decoders voor geïmplementeerd. Dat kan omdat de meeste van deze sensors geen encryptie toepassen. Uiteraard is dat wel een aandachtspunt als je deze sensors wilt gebruiken: je moet beseffen dat iedereen in de buurt de sensordata eenvoudig kan uitlezen.

Veel goedkope temperatuursensors sturen hun metingen uit op een frequentie van 433 MHz.

OpenMQTTGateway

De Raspberry Pi beschikt niet over een ontvanger voor signalen op 433 MHz, maar er bestaan microcontrollerbordjes met een ingebouwde ontvanger en antenne. De Lilygo LoRa32 V2.1_1.6.1 433MHz is een handig exemplaar, gebaseerd op een ESP32-microcontroller. Dan hoef je alleen nog maar firmware op de ESP32 te installeren om de signalen van de sensors te ontvangen, te decoderen en naar Home Assistant door te sturen.

Een handige oplossing hiervoor is OpenMQTTGateway, een project dat allerlei sensors ondersteunt, hun signalen decodeert en die via wifi naar een MQTT-broker doorstuurt (MQTT staat voor Message Queuing Telemetry Transport). Als je je Home Assistant-installatie dan met diezelfde MQTT-broker laat verbinden, pikt hij de sensordata op, herkent hij automatisch de apparaten en maakt hij de juiste entiteiten aan die je dan in je dashboard kan tonen. De lijst met ondersteunde sensors vind je hier .

De Lilygo LoRa32 V2.1_1.6.1 433MHz is een handig microcontrollerbordje met ingebouwde ontvanger en antenne voor 433 MHz, plus een schermpje.

MQTT-broker installeren

Voordat je met OpenMQTTGateway op je microcontrollerbordje aan de slag kunt, moet je dus een MQTT-broker installeren. Dat kan eenvoudig in de vorm van een add-on voor Home Assistant. Klik op Instellingen / Add-ons en dan rechts onderaan op Add-on winkel. Kies dan bij de officiële add-ons Mosquitto broker. Klik op Installeer en wacht even tot de installatie is voltooid.

Open daarna het tabblad Configuratie. Vul bij Logins een gebruiker en wachtwoord in waarmee je de microcontroller op de MQTT-broker kan aanmelden. Dat moet in de volgende vorm:

- username: gebruiker

 

    password: wachtwoord

Klik daarna op Opslaan en klik in het tabblad Informatie op Starten. In het tabblad Logboek kun je de add-on zien opstarten.

Definieer een gebruiker en bijbehorend wachtwoord voor de MQTT-broker.

MQTT-integratie

Je hebt nu een MQTT-broker draaien, maar die draait los van Home Assistant. Om Home Assistant met de broker te laten spreken, moet je nog een integratie toevoegen. Ga daarvoor naar Instellingen / Apparaten & Diensten, klik rechts onderaan op Integratie toevoegen en kies dan MQTT. Je ziet nu zes beschikbare integraties, maar eentje ervan staat afzonderlijk onder Ontdekt met de naam MQTT. Klik hierop en bevestig met Opslaan dat je verbinding wilt maken met de MQTT-broker van de add-on die je eerder hebt geïnstalleerd.

Daarna zie je in je lijst met integraties Mosquitto broker staan van het type MQTT. Klik op Configureer. Test nu of de verbinding correct werkt. Vul daarvoor onderaan bij Luisteren naar ‘onderwerp’ in het tekstveld voor het onderwerp test in en klik ernaast op Begin met luisteren. Vul dan bovenaan bij Publiceer een bericht bij het onderwerp eveneens test in, en bij het bericht testbericht. Klik op Publiceer. Als onderaan je testbericht verschijnt, weet je dat de verbinding met de MQTT-broker werkt.

Een succesvolle test van de verbinding met de MQTT-broker.

OpenMQTTGateway installeren

De eenvoudigste manier om OpenMQTTGateway te installeren is via de webinstaller. Open deze pagina in Chrome (andere browsers worden niet ondersteund), sluit je microcontrollerbordje via usb op je computer aan, selecteer je bordje uit de lijst (lilygo-rtl_433 voor de Lilygo LoRa32 V2.1_1.6.1 433MHz) en klik op Install. Kies de seriële poort die verschijnt uit de lijst van je browser en maak verbinding. Wanneer je All done! ziet staan, is de firmware naar je bordje geschreven.

OpenMQTTGateway maakt nu tijdelijk een wifi-accesspoint met een naam die begint met OpenMQTTGateway. Je krijgt dit ook op het kleine schermpje te zien. Verbind dus op je telefoon of tablet met dit accesspoint en vul als wachtwoord your_password in. Je wordt daarna doorverbonden met de webinterface van OpenMQTTGateway. zo niet, surf dan zelf naar 192.168.4.1. Tik nu op Configure WiFi, kies het wifi-netwerk waarmee je wilt verbinden en vul het wachtwoord in. Vul voor de MQTT-server het ip-adres van je Raspberry Pi met Home Assistant in, evenals de gebruikersnaam en het wachtwoord die je in de Mosquitto-add-on hebt ingesteld. Vul ook een OTA-wachtwoord (Over The Air) in om OpenMQTTGateway op afstand te kunnen updaten.

Configureer wifi en MQTT op je microcontrollerbordje met OpenMQTTGateway.

Ontdekte apparaten

Als alles goed gaat, toont het schermpje van je microcontrollerbordje je nu de sensordata elke keer dat het een signaal van een sensor kan decoderen. Ontvangt het bordje een tijdje niets, dan wordt het logo van OpenMQTTGateway getoond. De sensordata worden naar je MQTT-broker gestuurd. OpenMQTTGateway maakt bovendien gebruik van MQTT Discovery: het stuurt ook de configuratie van de gedetecteerde apparaten door, in een formaat dat Home Assistant begrijpt.

Daarom zal Home Assistant automatisch de door OpenMQTTGateway opgepikte apparaten herkennen. Open je Instellingen / Apparaten & Diensten, dan zie je dat er bij de integratie Mosquitto broker al apparaten en entiteiten vermeld zijn. Klik op het aantal apparaten om de lijst te zien en klik op een apparaat om de erbij horende entiteiten te zien, zoals de temperatuur, luchtvochtigheid en batterijstatus.

Dankzij MQTT Discovery ontdekt Home Assistant automatisch de apparaten waarvan OpenMQTTGateway signalen opvangt.

OpenMQTTGateway aansturen

OpenMQTTGateway staat zelf ook bij de door Home Assistant ontdekte apparaten. Als je erop klikt, krijg je sensors te zien met het ip-adres, de uptime en de interne processortemperatuur. Je krijgt ook toegang tot bedieningselementen om de helderheid van het schermpje in te stellen, om de gateway te herstarten en zelfs om de firmware via het netwerk te updaten.

Voor de rest kun je zowel de entiteiten van OpenMQTTGateway als van de sensors die het oppikt gebruiken, net als willekeurige andere entiteiten in Home Assistant. Dat betekent onder meer dat je ze aan je dashboard kunt toevoegen en dat je automatiseringen kunt maken die op sensorwaardes reageren.

OpenMQTTGateway kun je ook vanuit Home Assistant aansturen via MQTT. 

Meerdere ontvangers De Lilygo LoRa32 V2.1_1.6.1 433MHz heeft niet zo’n gevoelige ontvanger, waardoor sensors op een wat grotere afstand niet meer worden gedetecteerd. Maar op AliExpress zijn deze bordjes voor minder dan 20 euro te vinden. Merk je dat het bereik niet voldoende is om al je sensors te bereiken, dan kun je er dus altijd eentje extra kopen en aan de andere kant van je huis plaatsen. Als je ze hun sensordata naar dezelfde MQTT-broker laat sturen, pikt Home Assistant alle sensors op.

Thread

Thread is een ander protocol dat in opkomst is. Het is eigenlijk geen smarthomeprotocol, maar een netwerkprotocol, te vergelijken met wifi. Alleen is Thread een mesh-netwerk waardoor apparaten die te ver uit elkaar liggen toch met elkaar kunnen communiceren via tussenliggende apparaten. Thread is bovendien energiezuinig, waardoor batterijgevoede apparaten lang op één batterijlading kunnen meegaan.

Elk apparaat in een Thread-netwerk heeft een IPv6-adres. Een Thread Border Router maakt de verbinding tussen je lokale thuisnetwerk (met ethernet en wifi) en het Thread-netwerk. Dit laatste werkt via een eigen radioprotocol en heeft dan ook een speciale ontvanger nodig.

De Home Assistant SkyConnect is uitgerust met zo’n Thread-radio en ondersteunt binnenkort zelfs gelijktijdig gebruik van Zigbee en Thread. Alleen al hierom is het aan te raden om de SkyConnect aan te schaffen als je momenteel nog Zigbee gebruikt. Met SkyConnect haal je nu al een Thread Border Router binnen.

Je kunt overigens ook prima een afzonderlijk apparaat als Thread Border Router gebruiken. Onder andere de Google Nest Hub Gen 2 en de Apple HomePod Mini hebben die functionaliteit. Het gebruik van meerdere border-routers maakt je opstelling ook robuuster.

Matter

Naast het ip-netwerk dat Thread biedt, kun je allerlei smarthomeprotocollen draaien. Home Assistant ondersteunt naast Thread zowel HomeKit (van Apple) als Matter. De ondersteuning van Matter, het protocol waar vele fabrikanten momenteel naar aan het opschuiven zijn, is echter nog experimenteel.

Matter-apparaten hoeven geen Thread te gebruiken: ze kunnen ook bovenop wifi werken. Het maakt niet uit wat het onderliggend netwerk is, zolang de apparaten maar een IPv6-adres hebben. Momenteel zijn er nog amper Matter-apparaten op de markt, maar de verwachting is dat dit in de toekomst zal verbeteren. De ontwikkelaars van Home Assistant volgen de situatie op de voet en de Matter-integratie zal zich dan ook tegelijk met de groei in de markt ontwikkelen.

De ondersteuning voor Matter is nog in bèta.

▼ Volgende artikel
Van prompt naar programma: leer programmeren met AI
© monsitj - stock.adobe.com
Huis

Van prompt naar programma: leer programmeren met AI

Niet alleen het saaie en repetitieve werk wordt vervangen door AI. Je bent óók als kenniswerker niet meer zeker van een baan. Software wordt al grotendeels door AI geschreven. Gelukkig kun je daar als hobbyprogrammeur ook enorm van profiteren. Het brengt naast tijdwinst ook veel gemak. We helpen je op weg met drie praktische tools: ChatGPT, Aider en de Windsurf Editor. We maken enkele eenvoudige voorbeelden, zodat je een helder beeld hebt van je potentiële workflow.

In dit artikel laten we zien hoe je met hulp van AI razendsnel leert programmeren en zelfs complete programma’s bouwt:

  • Gebruik ChatGPT als programmeerpartner en laat het een volledig werkend spelletje bouwen met HTML, CSS en JavaScript
  • Installeer Aider en gebruik het in combinatie met Git om projecten via de terminal te ontwikkelen
  • Ontdek Windsurf Editor als grafisch alternatief met AI-assistent Cascade

Lees ook: Leren programmeren? Met deze tools is coderen geen geheimcode meer

Grote taalmodellen zijn al zo goed dat je comfortabel complete programma’s door AI kunt laten maken, zelfs zonder enige programmeerkennis. Afhankelijk van de tools die je gebruikt, voelt dat toch alsof je samen aan code werkt, ook wel pair-programmeren genoemd. Je houdt dus enige controle en kunt er, als je oplet, veel van leren. Ook al wordt het harde werk door AI gedaan.

Een bijkomend voordeel is dat je heel gericht aanpassingen kunt laten doen of vragen kunt stellen over de code, zonder dat je de documentatie of websites als Stack Overflow hoeft door te spitten. Het is geen verrassing dat laatstgenoemde website met fors dalende bezoekersaantallen te maken heeft. Ook andere taken, zoals het schrijven van de documentatie, zijn snel geregeld.

In dit artikel gaan we een eenvoudig programma maken met AI, zodat je een goed beeld hebt van de workflow. We gebruiken drie verschillende tools. We starten met het vertrouwde ChatGPT, al kun je ook bijvoorbeeld voor Claude of Gemini kiezen. Daarna gaan we met Aider in combinatie met Git aan de slag. Daarmee werk je ‘samen’ aan programmacode via de opdrachtprompt, in ons voorbeeld binnen het vertrouwde Visual Studio Code. Tot slot gaan we met de Windsurf Editor aan de slag, een completere grafische ontwikkelomgeving met geïntegreerde AI-features, die je van begin tot eind ondersteunt bij het maken van je programma. 

Basisbeginselen van het programmeren

Het is handig als je de basisbeginselen van een programmeertaal kent. Ook daar kan AI van nut zijn. Je kunt veel leren van de voorbeelden die worden gegenereerd. Je kunt elk detail uit laten leggen, of om meer voorbeelden vragen. Dat is heel effectief!

Ook om de basisbeginselen te leren is AI nuttig. Pas bijvoorbeeld de Pareto-methode toe. Die methode stelt dat 80 procent van de resultaten voortkomt uit 20 procent van de inspanningen. Vraag de chatbot om een plan te maken dat deze regel toepast op het leren programmeren van bijvoorbeeld Python, door te focussen op 20 procent van de concepten, tools en technieken die 80 procent van de praktische toepassingen en problemen oplossen voor een beginnende programmeur. Vraag om een gestructureerd plan dat in korte tijd resultaat oplevert, inclusief voorbeelden en kleine projecten om vaardigheden direct toe te passen.

Vraag aan ChatGPT om een leerplan op te stellen om je te helpen bij het programmeren.

ChatGPT

Chatbot

Grote taalmodellen (LLM’s) vormen de basis voor chatbots als OpenAI’s ChatGPT en Anthropics Claude, maar óók voor de tools die we hierna behandelen. Feitelijk benaderen we de chatbots in dit eerste deel van het artikel rechtstreeks, via een browser of app. De andere tools gebruiken de API van deze bedrijven. Raadpleeg eventueel voor het starten met ChatGPT deze basiscursus.

De nieuwere modellen (we gebruiken overwegend ChatGPT 4o en Claude 3.5 Sonnet) laten heel goede resultaten zien voor programmeertaken. Ze helpen uiteraard niet alleen om programmacode te schrijven maar kunnen code ook uitleggen, fouten oplossen en de documentatie schrijven. Ook kun je uitstekend brainstormen over een project of ideeën. Het is daarom, óók als je andere tools voor programmeren gebruikt, enorm praktisch om erbij te hebben! Toegang tot ChatGPT is gratis met beperkingen. Een abonnement is minder gelimiteerd en geeft vaak toegang tot nieuwere modellen (zoals o1 of o3-mini). Zo’n abonnement is niet bruikbaar voor de andere tools, die gebruiken namelijk de API waarvoor je aparte credits moet aanschaffen.

Een chatbot biedt goede ondersteuning bij al je programmeervragen.

Eerste stappen

We beginnen met een eenvoudig voorbeeld en vragen aan ChatGPT om een spelletje boter-kaas-en-eieren te maken, ook wel bekend als tic-tac-toe. Hoewel het Engels soms betere resultaten kan geven, werken we voor dit artikel volledig in het Nederlands. We starten met deze prompt: “Maak een volledig functionele boter-kaas-en-eieren voor in een browser. Maak de HTML-structuur, voeg CSS-stijlen toe en implementeer de JavaScript-logica. Maak een scheiding tussen HTML, CSS en JavaScript. Zorg dat het programma responsief is zodat het bij elke schermgrootte werkt.”

ChatGPT genereert de gevraagde code. Je kunt individueel de HTML, CSS en JavaScript kopiëren. Om het te proberen, kun je alles plakken op websites als www.jsfiddle.net en www.codepen.io. Voor dit voorbeeld hebben we bij JSFiddle een projectpagina aangemaakt. We gaan dit voorbeeld in de volgende stappen verder verbeteren, steeds met links naar de verbeterde versie.

De eerste versies van het spel boter-kaas-en-eieren.

Geluiden toevoegen

We vragen ChatGPT om het programma aan te passen, zodat er een geluid wordt afgespeeld bij elke zet. ChatGPT voegt daarop een audio-element toe aan de HTML-code. Het past ook het script aan om dit aan te roepen bij elke zet. Je moet nog wel zelf het mp3-bestand plaatsen in de uiteindelijke programmamap of een volledige link naar het mp3-bestand invullen in de HTML-code:

<audio id="move-sound" src="muisklik.mp3"></audio>

Er zijn overigens veel websites waar je leuke geluidseffecten kunt vinden die je vrij kunt gebruiken, waaronder Pixabay. Op deze pagina zie je onze aangepaste versie.

De aangepaste HTML-code bevat een verwijzing naar een mp3-bestand.

Computertegenstander

We vragen ChatGPT vervolgens om een slimme computertegenstander toe te voegen, waarbij aan het begin van het spel wordt gekozen wie er mag beginnen. Via deze webpagina kun je deze versie zien. De computertegenstander blijkt in eerste instantie overigens helemaal niet zo slim, waardoor je makkelijk je potjes wint. Maar dat is snel opgelost. Na ons verzoek om de computertegenstander slimmer te maken, controleert het programma voortaan eerst op mogelijke winnende zetten en blokkeert het de tegenstander indien nodig. Als er geen direct winnende of blokkerende zetten zijn, kiest het een willekeurige lege cel. Deze slimmere versie kun je hier bekijken.

Het aangepaste script op een canvas in ChatGPT.

Uiterlijk verfraaien

Als laatste hebben we gevraagd het uiterlijk wat mooier te maken. Hierbij wordt voornamelijk de CSS-code aangepast om de visuele stijl van het spel te verbeteren. Het resultaat is geslaagd: ChatGPT geeft de achtergrond een mooi kleurverloop. Ook zijn de stijlen van de knoppen en speelvelden aangepast. Het levert een veel moderner en aantrekkelijker uiterlijk op.

Je kunt ChatGPT uiteraard steeds vragen om het script of een deel daarvan uit te leggen. Ben je het overzicht over de wijzigingen kwijt, dan kun je uiteraard ook vragen om de laatste HTML-code in te zien, of de laatste versie van het script. Eventueel op een canvas. Toch misten wij in ChatGPT soms wat overzicht en is het bovendien lastig om een stapje terug te doen als een aanpassing niet het gewenste resultaat oplevert. Dit zijn zaken die we in het volgende deel gaan aanpakken met Aider.

De gemoderniseerde versie van boter-kaas-en-eieren.

Contextvenster bij een taalmodel

Bij het werken met een groot taalmodel ofwel een Large Language Model (LLM) zijn er enkele technische beperkingen. Een daarvan is het contextvenster. Dat kun je zien als de hoeveelheid tekst die het model kan onthouden, gemeten in tokens. Een token is een deel van een woord en kan ook spaties en leestekens bevatten. Gemiddeld is een token ongeveer 3 tot 4 tekens groot.

Eerdere versies van ChatGPT hadden een relatief klein contextvenster van 4096 tokens. Het kan dan niet altijd alle details onthouden van de gebruikte teksten. Tegenwoordig is het contextvenster veel groter, en onthouden de modellen gemakkelijk 128.000 tokens of meer. Dat is ongeveer een heel boek! Dat is niet alleen nuttig bij het werken met hele lange teksten of artikelen, maar ook bij programmeerwerk, waar je vaak met grote bibliotheken te maken hebt.

Aider

Opdrachtprompt

Voor grotere programmeerprojecten is het werken met een chatbot al snel vervelend en verwarrend. Veel praktischer is een tool die met jouw eigen projectbestanden werkt en zelf of samen de gewenste aanpassingen maakt. Als je geen moeite hebt met het werken met een opdrachtprompt, is Aider een uitstekende optie. Die tool helpt met het schrijven en aanpassen van code.

Aider is opensource en werkt met heel veel LLM’s samen. Hier gebruiken we de API voor Claude 3.5 Sonnet, maar je kunt ook de API van OpenAI gebruiken of een LLM die je zelf lokaal draait of elders, zoals via OpenRouter. De integratie met Git is enorm praktisch. Voor elke aangebrachte wijziging voert het een ‘commit’ uit, voorzien van een duidelijke omschrijving, zodat je achteraf een goed overzicht met alle veranderingen hebt en ook stapjes terug kunt doen. Niet alle alternatieven bieden dit en dat is vooral een gemis als er iets fout gaat en je geen idee meer hebt hoe je dat moet oplossen.

Aider werkt samen met alle gangbare LLM’s.

Voorbereiding

We willen weer laten zien hoe je het spelletje boter-kaas-en-eieren met Aider zou kunnen maken. We gebruiken het voor velen vertrouwde programma Visual Studio Code onder Windows en installeren Aider via een opdrachtprompt binnen die ontwikkelomgeving. Binnen de editor kun je uiteraard alle gegenereerde bestanden bekijken en handmatig aanpassen. Voor de installatie van Aider heb je Python nodig. Zet tijdens de installatie van Python een vinkje bij Add python.exe to PATH, zodat je Python vanuit elke map kunt aanroepen.

Installeer ook Visual Studio Code als je dat nog niet eerder hebt gedaan. Visual Studio Code biedt een mogelijkheid om Copilot als assistent te gebruiken, maar dat slaan we hier over.

Installeer ook Git, zodat versiebeheer mogelijk is. Kies tijdens de installatie van Git voor het gebruik van Visual Studio Code als standaardeditor. Verder kun je alle standaardinstellingen accepteren. Als je Python, Visual Studio Code en Git hebt geïnstalleerd, kun je door met de installatie van Aider.

Installeer Python onder Windows voordat je met Aider aan de slag gaat.

Installatie Aider

We kunnen nu Aider installeren. Open daarvoor Visual Studio Code en kies in het menu de optie Terminal / New Terminal. Verander de terminal, via de optie rechtsboven in het venster, naar Git Bash. Installeer daarna Aider met de volgende twee opdrachten:

python -m pip install aider-install
aider-install

Sluit de terminalvenster via het kruisje rechtsboven. Open dan een nieuwe terminal en wissel weer naar Git Bash. Als je Aider niet kunt aanroepen met aider zul je het PATH moeten uitbreiden met de aangegeven opdracht, zoals in het voorbeeld hieronder:

export PATH="C:\\Users\\gertj\\.local\\bin:$PATH"

Zorg dat je in dit voorbeeld voor Claude 3.5 Sonnet een API-sleutel hebt en voldoende credits om mee te beginnen (zie het kader ‘API-sleutel maken voor Claude’). Exporteer deze API-sleutel zodat Aider deze direct kan gebruiken:

export ANTHROPIC_API_KEY=sk-ant…

Maak nu een nieuwe map voor je toepassing, blader naar die map en maak een Git-repository:

mkdir tictactoe
cd tictactoe
git init .

Je kunt nu beginnen met programmeren, met de ondersteuning van Aider!

We installeren Aider om het binnen Visual Studio Code te gebruiken.

API-sleutel maken voor Claude

Bij Aider werken we zoals aangegeven met Claude 3.5 Sonnet, een populaire optie onder programmeurs. Voor toegang is een API-sleutel nodig. Ga daarvoor naar de console van Anthropic. Vul je e-mailadres in. Via e-mail ontvang je een beveiligde link waarmee je kunt inloggen. Ga dan naar Settings / API keys en klik op Create Key. Vul een naam in, bijvoorbeeld Aider, en klik op Add. Noteer de API-sleutel, deze is later niet meer zichtbaar!

Je hebt ook wat credits nodig. Ga daarvoor naar Billing en voeg credits toe met een creditcard via de optie Add Funds. Begin met een klein bedrag, zoals 10 dollar. Heb je over? Je kunt het altijd nog opmaken door een chatbot als Jan met de API te verbinden.

Via de console van Anthropic kun je een API-sleutel maken.

Programma maken

We gaan ons eerste programma maken. Zorg dat je een terminalvenster hebt geopend en bent gewisseld naar Git Bash. De assistent start je dan met de volgende opdracht:

aider --sonnet

Er wordt de eerste keer gevraagd om .aider* en .env toe te voegen aan .gitignore. Dat raden we aan! Hiermee voorkom je dat deze bestanden, vaak met wachtwoorden en dergelijke, per ongeluk in je Git-repository worden opgenomen en daardoor in potentie online komen, als je de repository via GitHub beschikbaar maakt.

Via de prompt kun je nu je opdrachten afvuren. We vragen zoals eerder om een volledig functionele en responsieve boter-kaas-en-eieren voor in een browser met de vereiste HTML-structuur, CSS-stijlen en JavaScript-logica in aparte bestanden.

Aider gaat direct aan de slag en laat heel overzichtelijk alle aanpassingen zien, met een beschrijving van de uiteindelijke functionaliteit. Het vraagt netjes of het de nieuwe bestanden mag maken (index.html, styles.css en script.js) en daarna of het deze mag openen in een browser. Het spel is in deze eerste versie volledig responsief met een duidelijke gebruikersinterface, houdt de speelstatus bij, detecteert wanneer iemand wint of als het een gelijkspel is, heeft een knop om het spel opnieuw te starten en is helemaal in het Nederlands. Een goed begin!

Aider heeft het programma voor ons uitgewerkt.

Aanpassingen maken

We vragen opnieuw in natuurlijke taal om wijzigingen te maken. De workflow is erg prettig. Aider geeft eerst aan welke bestanden waarschijnlijk moeten worden gewijzigd. Voor het geluid stelt het bijvoorbeeld wijzigingen in index.html en script.js voor. Dan vraagt Aider of het deze bestanden mag toevoegen aan de chat.

Als de radartjes zijn uitgedraaid, na interactie met Claude, geeft Aider heel nauwkeurig aan welke regels in welke bestanden moeten worden gewijzigd. Ook geeft Aider aan dat je een mp3-bestand genaamd move.mp3 in dezelfde map moet plaatsen.

We vragen Aider daarna ook om een slimme computertegenstander toe te voegen. Die is meteen heel slim en probeert direct te winnen als dat kan, blokkeert winnende zetten van de tegenstander, probeert het centrum te veroveren en kiest anders voor hoeken of willekeurige zetten.

Tot slot vragen we Aider om het programma te verfraaien met een moderner uiterlijk. Dat levert een flinke metamorfose op. Bekijk hier het resultaat.

Via een comfortabel proces maakt het alle gewenste aanpassingen.

Kosten voor werken met Aider

We hebben tijdens het werken met Aider continu de credits in de gaten gehouden. We controleerden dit via de console bij Anthropic, maar Aider zelf toont ook bij elke actie welke kosten het heeft gemaakt. Voor de meeste aanpassingen gaat het om zo’n 5 tot 11 dollarcent. In totaal heeft het programma ongeveer 0,23 dollar (circa 0,22 euro) gekost. Het hangt er voornamelijk vanaf hoeveel tokens er nodig zijn, wat weer samenhangt met de omvang van de bestanden die aan de chat worden toegevoegd.

Integratie met Git

De standaard integratie met Git biedt veel voordelen. Als Aider aanpassingen maakt aan een bepaald bestand zal het in Git een heldere beschrijving toevoegen aan de zogeheten commit. In Visual Studio Code kun je deze historische aanpassingen eenvoudig terugzien. Klik daarvoor op een bestand en open in de balk aan de linkerkant Timeline. Zorg dat de filterinstelling is ingesteld op Git History.

Nu zie je de commit-geschiedenis van het geselecteerde bestand. Door op een specifieke commit te klikken, kun je de aangebrachte wijzigingen bekijken. Binnen Aider zijn er ook nog wat trucjes. Zo kun je met /diff zien wat de laatste veranderingen zijn. Met /undo kun je die eenvoudig ongedaan maken.

We hebben de repository op GitHub gezet. Ook hier kun je alle veranderingen bekijken. Open daarvoor een bestand, zoals script.js, en ga dan rechtsboven naar History. Hier zie je de verschillende wijzigingen. Als je op een van de aanpassingen klikt, zie je netjes welke veranderingen in de code zijn gemaakt.

Je kunt handig zien welke historische wijzigingen zijn aangebracht in bestanden.

Git en GitHub

Aider gebruikt een git-repository. Sommige mensen verwarren dit met GitHub. Je kunt met Git prima alleen een lokale repository maken, op het systeem waarop je met Aider werkt. Optioneel kun je deze repository met GitHub verbinden, zodat je in feite een kopie in de cloud hebt. Dat is voor jezelf wel heel praktisch, omdat je veel makkelijker de wijzigingen kunt bijhouden en bestuderen. En je kunt ook met anderen samenwerken aan code.

Ook interessant om te lezen: GitHub Codespaces: altijd de juiste tools bij de hand

We hebben de repository gedeeld met GitHub, zodat je alle veranderingen kunt inzien.

Windsurf Editor

 Complete ontwikkelomgeving

Zoek je een completere ontwikkelomgeving met geïntegreerde AI, dan zijn Cursor AI en Windsurf Editor twee populaire opties. Cursor AI is een gevestigde speler, maar krijgt steeds meer concurrentie van het nieuwere Windsurf Editor. Beide ontwikkelteams blijven verbeteringen doorvoeren om niet voor elkaar onder te doen.

Beide programma’s zijn bovendien klonen van Visual Studio Code, de bekende editor van Microsoft die we ook voor Aider hebben gebruikt. Daarom lijken ze in veel opzichten op elkaar. Het kan handig zijn om verschillende thema’s te gebruiken als je ze naast elkaar gebruikt, zodat je ze uit elkaar kunt houden.

Windsurf Editor werkt met een ingebouwde assistent genaamd Cascade.

Cascade

We hebben ook in Windsurf geprobeerd om het spelletje boter-kaas-en-eieren uit dit artikel te maken. De assistent in Windsurf Editor heet Cascade; via het Cascade-deelvenster kun je hem direct aan het werk zetten. Een leuk detail is dat niet alleen code wordt gegenereerd, maar dat er ook veel aanvullende acties voor je worden uitgevoerd, zoals het aanmaken van een map voor je project en voor de geluiden, en het maken van een mp3-bestand.

Bij elke stap kun je zien welke bestanden worden aangepast en de voorgestelde wijzigingen controleren en bevestigen. Je hoeft niet, zoals bij Aider, zelf een API-sleutel te regelen voor toegang. Je gebruikt steeds het model van Cascade en de administratieve kant wordt via je account geregeld, op basis van credits (zie volgende paragraaf). Zo’n diepere integratie is heel praktisch. Toch heeft de workflow veel overeenkomsten met Aider.

Via een deelvenster kun je een conversatie met Cascade voeren.

Werken met credits

Windsurf werkt met credits voor verschillende taken. Zo worden User Prompt-credits voor elke interactie met de assistent gebruikt en Flow Action-credits voor alle acties die worden uitgevoerd. Als je de limiet bereikt voor het premiummodel, wordt overgeschakeld naar het basismodel. De proefperiode van 14 dagen geeft je ruim voldoende credits om het voorbeeldprogramma uit dit artikel te maken. Sterker nog, je hebt ongeveer vijftien keer meer credits dan nodig, dus je kunt ook grotere en complexere programma’s proberen te maken.

Buiten die proefperiode is, om het premiummodel te gebruiken, een upgrade naar de Pro-versie bijna onvermijdelijk (ca. 18 euro per maand). Je hebt dan wel elke maand een ruime hoeveelheid credits en kunt vrij voordelig credits bijkopen.

Windsurf Editor werkt met een systeem van credits.

Beste optie voor hobbyprogrammeur?

Over het algemeen werkt het programmeren met een chatbot zoals ChatGPT goed. Voor losse functies of snippets werkt het zelfs uitstekend. Maar het is lastig om het overzicht te behouden over de gegenereerde code en eventuele aanpassingen, zeker als het om wijzigingen in meerdere bestanden gaat.

Aider en Windsurf Editor hebben een fijnere workflow, omdat ze de lokale bestanden direct voor je wijzigen, eventueel meerdere tegelijkertijd. Wat kosten betreft is Aider waarschijnlijk interessanter voor de hobbyprogrammeur die af en toe een project oppakt. Je kunt ad-hoc wat credits bijkopen of eens een ander model proberen, lokaal of via bijvoorbeeld OpenRouter. Het opensource DeepSeek R1 bijvoorbeeld. Je kunt bovendien elke ontwikkelomgeving kiezen, terwijl Windsurf Editor volledig op Visual Studio leunt. De integratie met Git ook een praktisch voordeel van Aider.

▼ Volgende artikel
Zo deel je je keuken handig en logisch in
© Andy Dean Photography
Huis

Zo deel je je keuken handig en logisch in

Of je nu graag uitgebreid kookt of elke avond snel klaar wilt zijn: een slimme keukenindeling maakt het verschil. Alles moet logisch op zijn plek staan, zodat je moeiteloos overal bij kunt en na afloop ook weinig tijd kwijt bent aan opruimen.

Je keuken slim indelen? Wij hebben tips voor:
  • Vaatwasser, gootsteen en vuilnisbak
  • Werkblad en kookplaat
  • Koelkast
  • Neem de keuken-driehoek als uitgangspunt
  • Kies de optimale werkhoogte
  • Opbergruimte

Lees ook: Fornuis op maat: kies het aantal pitten dat bij je past

Vaatwasser, gootsteen en vuilnisbak

Heb je plannen voor een nieuwe keuken? Denk dan nu al na over welke slimme keuzes je kunt maken met de indeling. Plaats bijvoorbeeld de vaatwasser, de spoelbak en de afvalemmer dicht bij elkaar. Je hoeft dan nooit ver te lopen met vieze borden en je kunt ze makkelijk leegschrapen, eventueel afspoelen en direct inruimen. Staat de afvalbak in een kastje direct naast de vaatwasser? Let er dan op dat je het deurtje nog goed kunt openen als de deur van de vaatwasser omlaag staat. Dat werkt makkelijker bij het inruimen. Plaats verder de vaatwasser niet direct tegen een zijmuur. Tijdens het inruimen loop je dan sneller kans op spetters tegen de muur.

Werkblad en kookplaat

Het werkblad is meer dan alleen een plek om iets op te zetten. Je gebruikt het om te snijden, te mixen, spullen neer te leggen en borden op te scheppen. Zorg daarom dat je voldoende vrije werkruimte overhoudt – dus niet alles volbouwen met apparatuur. Plaats de spoelbak of kookplaat liever niet op een hoek. Je hebt aan beide kanten plek nodig, zodat je je handen vrij kunt houden en spetters opvangt. Reken aan weerszijden minimaal veertig centimeter. Dat oogt niet alleen rustiger, het werkt ook prettiger. Handig om te weten: bij je keukenspecialist wordt hiervoor vaak de term aflegruimte gebruikt. En nog even over de kookplaat: plaats die bij voorkeur niet pal naast de koelkast of een hoge kast; dat geeft weinig bewegingsvrijheid en maakt het lastig om met meerdere mensen tegelijk in de keuken te staan.

©Olga Yastremska and Leonid Yastremskiy

Koelkast

Een koelkast gebruik je vaker dan je denkt – gemiddeld zo'n 35 keer per dag. Zet 'm daarom op een plek waar je er makkelijk bij kunt, ook als je vanuit de woonkamer even snel iets wilt pakken. Zet de koelkast liever niet helemaal achterin of op een plek waar je niet vanzelf langsloopt; dat is al snel onhandig in het dagelijks gebruik. Let ook op de temperatuur rondom de koelkast. Zet hem niet naast een oven, radiator of op een plek waar veel zonlicht komt. Kan het echt niet anders, zorg dan voor een isolerende tussenplaat en houd minstens drie centimeter ruimte vrij tussen warmtebron en koelkast.

Gebruik de keuken-driehoek

In de basis draait een keuken om drie functies: koken, spoelen en koelen. Je fornuis, gootsteen en koelkast vormen samen een denkbeeldige driehoek. Als de afstanden tussen deze drie goed gekozen zijn, werk je prettiger. Staan ze te ver van elkaar, dan loop je onnodig veel. Staan ze te dicht bij elkaar, dan dan wordt het al snel krap en onhandig. Een keukenspecialist kan helpen bij het vinden van een goede verhouding, maar je merkt het zelf vaak ook al als iets net niet lekker werkt.

Optimale werkhoogte

Ook de hoogte van je werkplekken telt mee. Een oven op armhoogte is een stuk prettiger dan op kniehoogte, zeker als je vaak bakt. Het voorkomt bukken. Heb je een kleine keuken? Kies dan voor een compacte oven of voor een fornuis met geïntegreerde oven. Datzelfde geldt voor de vaatwasser: als je die wat hoger plaatst, spaar je je rug en knieën. Voor de kookplaat geldt een andere regel: meet de afstand van je onderarm tot het werkblad. Is die ongeveer twaalf centimeter, dan zit je goed qua houding en belast je je schouders niet onnodig.

Apparatuur wat hoger plaatsen (als dat kan) heeft nog een voordeel. Wanneer je kleine kinderen hebt rondlopen, kunnen die er minder makkelijk bij. Wel zo veilig!

©lev dolgachov

Opbergruimte

Tot slot: denk na over hoe je spullen opbergt. Onderkastjes bieden veel ruimte, maar vragen vaak veel van je rug. Bovenkastjes kunnen juist weer te hoog zijn. Een buffetkast biedt uitkomst: wat je dagelijks gebruikt zet je op ooghoogte, wat minder vaak nodig is kan best wat lager of juist hoger.

Slim indelen = een fijnere keuken!

Een goede keuken draait niet alleen om de juiste apparatuur, maar vooral ook om slimme keuzes die het koken makkelijker maken. Denk na over looproutes, werkhoogtes en voldoende bewegingsruimte. Positioneer alles op logische plekken, zorg voor een werkblad met voldoende vrije ruimte en let op kleine details zoals de draairichting van kastdeurtjes. Daarmee wordt de keuken (nog meer) het hart van je huis!