← Alle gidsen

ESP32 verbinden met wifi en een eenvoudige webserver maken

Een ESP32 kan niet alleen sensoren uitlezen, maar ook zelf een kleine webserver aanbieden. Daarmee kun je in je browser een statuspagina openen of eenvoudige instellingen bekijken. Deze gids gebruikt de Arduino-omgeving als voorbeeld; de exacte bibliotheken en API kunnen per ESP32-coreversie verschillen.

Wat heb je nodig?

  • Een ESP32-ontwikkelbord.
  • Een USB-kabel die data ondersteunt.
  • Arduino IDE met ESP32-boardondersteuning of een vergelijkbare ontwikkelomgeving.
  • Een 2,4GHz-wifinetwerk: veel ESP32-modellen ondersteunen geen 5GHz-wifi.
  • Een computer of telefoon op hetzelfde lokale netwerk.

Stap 1: wifi verbinden

Gebruik de WiFi-bibliotheek van de ESP32-core. Vul je netwerknaam en wachtwoord lokaal in. Zet echte wifi-inloggegevens niet in een openbaar GitHub-project. Voor gedeelde projecten kun je een apart configuratiebestand gebruiken dat niet wordt gepubliceerd.

#include <WiFi.h>

const char* ssid = "JOUW_WIFI";
const char* password = "JOUW_WACHTWOORD";

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println();
  Serial.println(WiFi.localIP());
}

void loop() {}

Open de seriële monitor op 115200 baud. Wanneer de verbinding lukt, toont de ESP32 zijn lokale IP-adres. Als hij blijft wachten, controleer dan de netwerknaam, het wachtwoord, de 2,4GHz-instelling en eventuele netwerkisolatie.

Stap 2: een eenvoudige webserver starten

#include <WiFi.h>
#include <WebServer.h>

WebServer server(80);

void handleRoot() {
  server.send(200, "text/html; charset=utf-8",
    "<h1>ESP32 werkt</h1><p>Lokale webserver actief.</p>");
}

void setup() {
  Serial.begin(115200);
  WiFi.begin("JOUW_WIFI", "JOUW_WACHTWOORD");
  while (WiFi.status() != WL_CONNECTED) delay(500);
  server.on("/", handleRoot);
  server.begin();
  Serial.println(WiFi.localIP());
}

void loop() {
  server.handleClient();
}

Dit is een minimale demonstratie: hij toont één HTML-pagina en verwerkt verzoeken in de hoofdloop. Open op een apparaat in hetzelfde netwerk http://IP-ADRES-VAN-ESP32/.

Stap 3: IP-adres stabiel houden

Het adres kan veranderen wanneer de router opnieuw adressen uitdeelt. De eenvoudigste oplossing is meestal een DHCP-reservering in de router: koppel het MAC-adres van de ESP32 aan een vast lokaal adres. Dat voorkomt dat je het adres in je browser steeds opnieuw moet zoeken.

Problemen oplossen

ProbleemControle
ESP32 vindt wifi nietControleer 2,4GHz, wachtwoord en signaalsterkte.
IP-adres verschijnt nietControleer router-DHCP en of het netwerk nieuwe apparaten toestaat.
Browser kan pagina niet openenControleer IP-adres, hetzelfde netwerk, poort 80 en client-isolatie.
Pagina reageert soms nietControleer of de loop snel genoeg terugkeert naar handleClient() en geen lange blokkerende delays bevat.

Veiligheidsgrenzen

Een eenvoudige ESP32-webserver heeft geen gebruikersbeheer of versleuteling. Gebruik hem alleen op een vertrouwd lokaal netwerk voor onschuldige statusinformatie. Zet hem niet rechtstreeks op internet en gebruik hem niet om gevoelige gegevens of wachtwoorden te tonen. Voor bediening op afstand is een beveiligde tussenlaag of VPN verstandiger.

Uitbreidingen

Als de basis werkt, kun je een JSON-statusendpoint toevoegen, sensormetingen tonen of een eenvoudige instellingenpagina maken. Valideer invoer altijd en beperk welke waarden aangepast mogen worden. Voor grotere projecten zijn ESPHome of een uitgebreider framework soms eenvoudiger te onderhouden dan een zelfgeschreven webserver.

Test de webserver stap voor stap

Controleer eerst of de ESP32 daadwerkelijk met het juiste wifi-netwerk is verbonden en een lokaal IP-adres heeft gekregen. Open dat adres vanaf een telefoon of computer die op hetzelfde netwerk zit. Werkt het op één apparaat wel en op een ander niet, controleer dan of je wifi-netwerk apparaten onderling toestaat. Een gastnetwerk kan communicatie tussen clients blokkeren.

Als het IP-adres na een herstart verandert, kun je in de router een DHCP-reservering instellen. De ESP32 blijft dan via hetzelfde lokale adres bereikbaar, zonder dat je een willekeurig vast IP-adres kiest dat mogelijk al door een ander apparaat wordt gebruikt.

Een eenvoudige webserver op een ESP32 is bedoeld voor een vertrouwd lokaal netwerk. Stel de webserver niet zomaar rechtstreeks beschikbaar vanaf internet. Als je instellingen via de webpagina kunt wijzigen, valideer dan iedere invoer en beperk welke acties een bezoeker kan uitvoeren. Voeg authenticatie toe als andere mensen op hetzelfde netwerk toegang kunnen krijgen.

Officiële documentatie

Verder lezen

← Terug naar alle gidsen