Kết nối Wi-Fi STA với ESP32 (có màn hình LCD)
Trong dự án này, chúng ta kết nối ESP32 vào mạng Wi-Fi gia đình ở chế độ Station (STA) một cách an toàn và chịu lỗi tốt. Chúng ta lưu SSID và mật khẩu trong một tệp secrets.h riêng để không bị lộ lên Git, thiết lập cơ chế tự kết nối lại, và hiển thị mức tín hiệu RSSI cùng địa chỉ IP trên màn hình LCD I2C. LED tích hợp đóng vai trò đèn báo trạng thái. Đây là một trình quản lý kết nối đạt chuẩn dùng thực tế.

Video
Sơ đồ mạch

Mã nguồn
1// ─────────────────────────────────────────
2// BlueGrays · bluegrays.com
3// ESP32 Wi-Fi STA Connection (with LCD Screen)
4// ─────────────────────────────────────────
5// The ESP32 joins a Wi-Fi network as a station (STA); the IP address and
6// the RSSI signal strength take turns on the 16x2 I2C LCD every 3 s. If
7// the link drops it retries every 30 s. The built-in LED shows the link
8// status.
9//
10// Pins:
11// GPIO 2 -> Built-in LED (connection status)
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// Wi-Fi credentials. If secrets.h exists in the sketch folder (defining WIFI_SSID and WIFI_PASS) it
20// is used, keep it out of Git. Otherwise the Wokwi default applies; for real hardware put your own
21// SSID and password!
22#if __has_include("secrets.h")
23#include "secrets.h"
24#else
25const char* WIFI_SSID = "Wokwi-GUEST";
26const char* WIFI_PASS = ""; // Wokwi-GUEST has no password
27#endif
28
29// Pin and timing settings
30#define LED_PIN 2 // Onboard LED
31#define WIFI_TIMEOUT_MS 15000 // Initial connect timeout
32#define WIFI_RECOVER_MS 30000 // Reconnect interval
33#define SCREEN_SWITCH_MS 3000 // Screen switch period
34
35LiquidCrystal_I2C lcd(0x27, 16, 2);
36
37unsigned long lastReconnect = 0; // Last retry (ms)
38unsigned long lastScreenSwitch = 0; // Last screen switch (ms)
39bool showIpScreen = true; // IP or RSSI screen
40
41// RSSI -> signal quality
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// Screen: connecting
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// Screen: disconnected
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// Screen: IP address
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// Screen: RSSI (dBm) and signal quality
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// Connects in STA mode, waits up to WIFI_TIMEOUT_MS; returns true when connected
90bool connectWiFi() {
91 WiFi.mode(WIFI_STA);
92 WiFi.setAutoReconnect(true);
93 WiFi.setSleep(false); // Power save off
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 // DevKit V1 default I2C pins
109 Wire.begin(21, 22);
110 lcd.init();
111 lcd.backlight();
112
113 // Splash screen 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 // If connected, the LED turns on and the IP is shown
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 // Without a link the LED blinks and a reconnect is tried every 30 s
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 // Connected: the LED stays on (setAutoReconnect may also restore the link by itself)
153 digitalWrite(LED_PIN, HIGH);
154
155 // While connected, alternate IP and RSSI screens
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}
165FAQ
Vì sao chúng ta giữ mật khẩu Wi-Fi trong một tệp riêng?
Nếu bạn không đưa tệp secrets.h lên Git (.gitignore), mật khẩu sẽ không bị lộ khi bạn chia sẻ code. Đây là cách làm tốt được dùng trong các dự án thực tế.
ESP32 có kết nối được Wi-Fi 5 GHz không?
Không, ESP32 chỉ hỗ trợ mạng 2,4 GHz. Hãy chắc chắn băng tần 2,4 GHz của modem đang bật; nếu gặp vấn đề với mạng hai băng tần, hãy đặt một tên riêng (SSID) cho băng tần 2,4 GHz.
Giá trị RSSI có ý nghĩa gì?
Đây là cường độ tín hiệu, đo bằng dBm. −50 dBm là rất tốt, −70 dBm là chấp nhận được, còn dưới −80 dBm là yếu và kết nối có thể bị rớt.
Chuyện gì xảy ra khi mất kết nối?
Code thường xuyên kiểm tra trạng thái kết nối và thử kết nối lại nếu mất kết nối. Cơ chế tự kết nối lại này giúp thiết bị tự vào lại mạng ngay cả khi modem khởi động lại.
