ES-25Gevorderd

ESP32 Wi-Fi-verbinding in STA-modus (met lcd-scherm)

In dit project verbinden we de ESP32 in Station-modus (STA) veilig en foutbestendig met het wifinetwerk thuis. We zetten de SSID en het wachtwoord in een apart bestand secrets.h zodat ze niet in Git lekken, bouwen een automatisch herverbindingsmechanisme en tonen het RSSI-signaalniveau en het IP-adres op een I2C-lcd-scherm. De ingebouwde led werkt als statusindicator. Het is een verbindingsmanager van productieniveau.

4.4(21)
38 voltooid
ESP32 Wi-Fi-verbinding in STA-modus (met lcd-scherm)
De ESP32 verbinden met je draadloze netwerk thuis is de eerste stap van elk project dat online gaat. Zodra de verbinding er is, blijft het lampje op het board branden en toont het kleine scherm om de drie seconden afwisselend het adres van het board op het netwerk en de sterkte van het signaal, in woorden van uitstekend tot zeer zwak. Valt de verbinding weg, dan knippert het lampje en probeert het board elke 30 seconden opnieuw te verbinden.

Video

Schakelschema

ESP32 Wi-Fi-verbinding in STA-modus (met lcd-scherm) - Schakelschema

Broncode

C++ (Arduino IDE)
1// ─────────────────────────────────────────
2//   BlueGrays · bluegrays.com
3//   ESP32 Wi-Fi-verbinding in STA-modus (met lcd-scherm)
4// ─────────────────────────────────────────
5// De ESP32 maakt als station (STA) verbinding met een wifinetwerk; het
6// IP-adres en de RSSI-signaalsterkte wisselen elke 3 s af op de 16x2
7// I2C-LCD. Valt de verbinding weg, dan probeert hij het elke 30 s opnieuw.
8// De ingebouwde led toont de verbindingsstatus.
9//
10// Pinnen:
11//   GPIO 2  -> Ingebouwde led (verbindingsstatus)
12//   GPIO 21 -> LCD SDA, GPIO 22 -> LCD SCL
13//   LCD VCC -> 5V (VIN), GND -> GND
14
15#include <Wire.h>
16#include <LiquidCrystal_I2C.h>
17#include <WiFi.h>
18
19// Wifigegevens. Als secrets.h in de sketchmap staat (met WIFI_SSID en WIFI_PASS) wordt die
20// gebruikt; houd dit bestand buiten Git. Anders geldt de Wokwi-standaard; zet op echte hardware je
21// eigen SSID en wachtwoord!
22#if __has_include("secrets.h")
23#include "secrets.h"
24#else
25const char* WIFI_SSID = "Wokwi-GUEST";
26const char* WIFI_PASS = "";   // Wokwi-GUEST heeft geen wachtwoord
27#endif
28
29// Instellingen voor pins en timing
30#define LED_PIN              2          // Ingebouwde led
31#define WIFI_TIMEOUT_MS      15000      // Time-out voor eerste verbinding
32#define WIFI_RECOVER_MS      30000      // Interval voor opnieuw verbinden
33#define SCREEN_SWITCH_MS     3000       // Wisselperiode van scherm
34
35LiquidCrystal_I2C lcd(0x27, 16, 2);
36
37unsigned long lastReconnect = 0;      // Laatste nieuwe poging (ms)
38unsigned long lastScreenSwitch = 0;   // Laatste schermwissel (ms)
39bool showIpScreen = true;             // IP- of RSSI-scherm
40
41// RSSI -> signaalkwaliteit
42const char* rssiQuality(int rssi) {
43  if (rssi >= -55) return "Excellent";
44  if (rssi >= -65) return "Good";
45  if (rssi >= -75) return "Fair";
46  if (rssi >= -85) return "Weak";
47  return "Very weak";
48}
49
50// Scherm: verbinden
51void showConnecting() {
52  lcd.clear();
53  lcd.setCursor(0, 0);
54  lcd.print("Connecting...");
55  lcd.setCursor(0, 1);
56  lcd.print("Please wait");
57}
58
59// Scherm: verbinding verbroken
60void showDisconnected() {
61  lcd.clear();
62  lcd.setCursor(0, 0);
63  lcd.print("No connection");
64  lcd.setCursor(0, 1);
65  lcd.print("Retrying soon");
66}
67
68// Scherm: IP-adres
69void showIpInfo() {
70  lcd.clear();
71  lcd.setCursor(0, 0);
72  lcd.print("IP:");
73  lcd.setCursor(0, 1);
74  lcd.print(WiFi.localIP());
75}
76
77// Scherm: RSSI (dBm) en signaalkwaliteit
78void showRssiInfo() {
79  int rssi = WiFi.RSSI();
80  lcd.clear();
81  lcd.setCursor(0, 0);
82  lcd.print("RSSI:");
83  lcd.print(rssi);
84  lcd.print(" dBm");
85  lcd.setCursor(0, 1);
86  lcd.print(rssiQuality(rssi));
87}
88
89// Verbindt in STA-modus, wacht maximaal WIFI_TIMEOUT_MS; geeft true terug bij verbinding
90bool connectWiFi() {
91  WiFi.mode(WIFI_STA);
92  WiFi.setAutoReconnect(true);
93  WiFi.setSleep(false);   // Energiebesparing uit
94  WiFi.setHostname("bluegrays-esp32");
95  WiFi.begin(WIFI_SSID, WIFI_PASS);
96
97  unsigned long start = millis();
98  while (WiFi.status() != WL_CONNECTED && millis() - start < WIFI_TIMEOUT_MS) {
99    delay(500);
100  }
101  return WiFi.status() == WL_CONNECTED;
102}
103
104void setup() {
105  pinMode(LED_PIN, OUTPUT);
106  digitalWrite(LED_PIN, LOW);
107
108  // Standaard I2C-pinnen van de DevKit V1
109  Wire.begin(21, 22);
110  lcd.init();
111  lcd.backlight();
112
113  // Startscherm 3 s
114  lcd.setCursor(3, 0);
115  lcd.print("BlueGrays");
116  lcd.setCursor(2, 1);
117  lcd.print("Wi-Fi STA v1");
118  delay(3000);
119
120  // Bij verbinding gaat de led aan en wordt het IP getoond
121  showConnecting();
122  if (connectWiFi()) {
123    digitalWrite(LED_PIN, HIGH);
124    showIpInfo();
125    lastScreenSwitch = millis();
126  } else {
127    showDisconnected();
128  }
129}
130
131void loop() {
132  // Zonder verbinding knippert de led en wordt elke 30 s opnieuw verbonden
133  if (WiFi.status() != WL_CONNECTED) {
134    digitalWrite(LED_PIN, (millis() / 500) % 2);
135    if (millis() - lastReconnect > WIFI_RECOVER_MS) {
136      showConnecting();
137      WiFi.disconnect();
138      WiFi.reconnect();
139      lastReconnect = millis();
140      delay(3000);
141      if (WiFi.status() == WL_CONNECTED) {
142        digitalWrite(LED_PIN, HIGH);
143        showIpInfo();
144        lastScreenSwitch = millis();
145      } else {
146        showDisconnected();
147      }
148    }
149    return;
150  }
151
152  // Verbonden: de led blijft aan (setAutoReconnect kan de verbinding ook zelf herstellen)
153  digitalWrite(LED_PIN, HIGH);
154
155  // Wissel tijdens de verbinding tussen IP- en RSSI-scherm
156  if (millis() - lastScreenSwitch > SCREEN_SWITCH_MS) {
157    lastScreenSwitch = millis();
158    showIpScreen = !showIpScreen;
159    if (showIpScreen) showIpInfo();
160    else showRssiInfo();
161  }
162
163  delay(50);
164}
165

Veelgestelde vragen

Waarom bewaren we het wifiwachtwoord in een apart bestand?

Voeg je het bestand secrets.h niet toe aan Git (.gitignore), dan lekt je wachtwoord niet uit als je je code deelt. Dit is een veilige gewoonte uit echte projecten.

Kan de ESP32 verbinden met 5GHz-wifi?

Nee, de ESP32 ondersteunt alleen netwerken van 2,4 GHz. Zorg dat de 2,4GHz-band van je modem aanstaat; heb je problemen met dualbandnetwerken, geef de 2,4GHz-band dan een aparte naam (SSID).

Wat betekent de RSSI-waarde?

Dit is de signaalsterkte, gemeten in dBm. −50 dBm is heel goed, −70 dBm is acceptabel en alles onder −80 dBm is zwak en de verbinding kan wegvallen.

Wat gebeurt er als de verbinding wegvalt?

De code controleert regelmatig de verbindingsstatus en probeert opnieuw te verbinden als de verbinding wegvalt. Door die automatische herverbinding komt het apparaat zelf terug op het netwerk, ook als de modem opnieuw opstart.