ES-25Nâng cao

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ế.

4.4(21)
38 đã hoàn thành
Kết nối Wi-Fi STA với ESP32 (có màn hình LCD)
Kết nối ESP32 vào mạng không dây ở nhà là bước đầu tiên của mọi dự án lên mạng. Khi đã kết nối, đèn trên bo sáng liên tục và màn hình nhỏ cứ ba giây lại luân phiên hiện địa chỉ của bo trên mạng và độ mạnh của tín hiệu, mô tả bằng lời từ rất tốt đến rất yếu. Nếu mất kết nối, đèn nhấp nháy và bo thử kết nối lại sau mỗi 30 giây.

Video

Sơ đồ mạch

Kết nối Wi-Fi STA với ESP32 (có màn hình LCD) - Sơ đồ mạch

Mã nguồn

C++ (Arduino IDE)
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}
165

FAQ

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.