Nếu ESP32 không kết nối được Wi-Fi sau khi gọi WiFi.begin(), hãy dùng Serial Monitor để xem nó dừng ở đâu. Không thấy tên mạng thì kiểm tra SSID và băng tần. Thấy mạng nhưng kết nối thất bại thì đọc mã lỗi để kiểm tra mật khẩu, bảo mật hoặc tín hiệu. Đã kết nối với bộ phát nhưng chưa có địa chỉ IP thì kiểm tra DHCP.
Bài này dùng Arduino IDE và thư viện WiFi.h của Arduino-ESP32. Mẫu bên dưới dùng API của Arduino-ESP32 3.3.10 và dành cho mạng gia đình hoặc điểm phát cá nhân dùng mật khẩu chung. Nếu cần thiết lập môi trường trước, xem hướng dẫn cài đặt Arduino-ESP32 của Espressif.
| Dòng cuối hoặc dấu hiệu lặp lại | Kiểm tra trước |
|---|---|
SCAN_NOT_FOUND, sau đó không kết nối được |
Tên mạng, băng tần, SSID ẩn và vị trí board. |
STA_DISCONNECTED reason=... trước khi có IP |
Đọc mã lỗi và xem log có từng hiện STA_CONNECTED hay chưa. |
Có STA_CONNECTED, chờ khoảng 30 giây vẫn chưa có STA_GOT_IP và chưa thấy mất kết nối |
Kiểm tra DHCP và thiết lập địa chỉ IPv4. |
Có STA_GOT_IP ổn định, ứng dụng vẫn báo lỗi |
Kiểm tra gateway, DNS và kết nối đến máy chủ MQTT, Firebase hoặc HTTP. |
1. Nạp mã chẩn đoán và xem Serial Monitor
Tạo một sketch trống, thay TEN_WIFI và MAT_KHAU_WIFI bằng thông tin mạng bạn đang kiểm tra rồi nạp cho đúng mẫu board. Mở Serial Monitor ở 115200 baud và nhấn EN/RESET nếu đã bỏ lỡ log khởi động. Mã quét tên mạng cần thử trước, sau đó gọi WiFi.begin() và in các sự kiện nhận được.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 |
#include <Arduino.h> #include <WiFi.h> const char *ssid = "TEN_WIFI"; const char *password = "MAT_KHAU_WIFI"; void logWiFiEvent(WiFiEvent_t event, WiFiEventInfo_t info) { switch (event) { case ARDUINO_EVENT_WIFI_STA_CONNECTED: Serial.println("STA_CONNECTED"); break; case ARDUINO_EVENT_WIFI_STA_GOT_IP: { IPAddress ip(info.got_ip.ip_info.ip.addr); Serial.print("STA_GOT_IP "); Serial.println(ip); break; } case ARDUINO_EVENT_WIFI_STA_DISCONNECTED: Serial.printf("STA_DISCONNECTED reason=%u\n", static_cast<unsigned>(info.wifi_sta_disconnected.reason)); break; case ARDUINO_EVENT_WIFI_STA_LOST_IP: Serial.println("STA_LOST_IP"); break; default: break; } } void setup() { Serial.begin(115200); delay(1000); if (!WiFi.mode(WIFI_STA)) { Serial.println("STA_MODE_ERROR"); return; } // Scan for this SSID on the supported channels. int16_t matches = WiFi.scanNetworks(false, false, false, 300, 0, ssid); if (matches > 0) { Serial.printf("SCAN_FOUND channel=%ld RSSI=%ld dBm\n", static_cast<long>(WiFi.channel(0)), static_cast<long>(WiFi.RSSI(0))); } else if (matches == 0) { Serial.println("SCAN_NOT_FOUND"); } else { Serial.printf("SCAN_ERROR result=%d\n", static_cast<int>(matches)); } WiFi.scanDelete(); WiFi.onEvent(logWiFiEvent); WiFi.setAutoReconnect(false); Serial.println("START_CONNECT"); WiFi.begin(ssid, password); } void loop() { delay(100); } |
Log dưới đây minh họa một lần kết nối thành công. Kênh, RSSI và địa chỉ IP sẽ thay đổi theo mạng.
|
1 2 3 4 5 |
SCAN_FOUND channel=6 RSSI=-48 dBm START_CONNECT STA_CONNECTED STA_GOT_IP 192.168.1.37 |
Mỗi lần đổi thông số, hãy reset board để bắt đầu phép thử mới. Sketch chỉ dùng callback để in sự kiện. Khi đưa phần theo dõi này vào ứng dụng, hãy nhớ rằng callback Wi-Fi chạy trên một tác vụ riêng. Ví dụ Wi-Fi Events trong Arduino-ESP32 3.3.10.
2. ESP32 không tìm thấy tên mạng Wi-Fi
Nếu thấy SCAN_NOT_FOUND và kết nối cũng thất bại, kiểm tra theo thứ tự sau.
- So lại tên mạng. SSID cần khớp cả chữ hoa, chữ thường và khoảng trắng. Nếu bộ phát ẩn SSID, phép quét trong mẫu có thể bỏ qua mạng đó. Hãy đọc thêm các sự kiện sau
START_CONNECT. - Đối chiếu băng tần với mẫu chip. ESP32 đời đầu, ESP32-C3 và ESP32-S3 dùng Wi-Fi 2,4 GHz. ESP32-C5 hỗ trợ cả 2,4 GHz và 5 GHz. Kiểm tra tên chip trên board trước khi kết luận, đặc biệt khi router dùng chung tên mạng cho hai băng tần. Bảng thông số các dòng chip của Espressif.
- Đặt board gần bộ phát rồi thử lại. Nếu thấy
SCAN_FOUND, ghi lạiRSSIvàchannel. Khi so trên cùng thiết bị,-50 dBmlà tín hiệu mạnh hơn-80 dBm. Nếu nhiều điểm phát dùng cùng tên, thông tin từ phép quét có thể thuộc điểm phát khác với điểm ESP32 sẽ kết nối.
SCAN_ERROR báo rằng lần quét không trả về kết quả hợp lệ. Thử lại với sketch trống và xác nhận đã chọn đúng mẫu board. Nếu thấy STA_MODE_ERROR, kiểm tra cấu hình board và phiên bản gói Arduino-ESP32 trước khi chẩn đoán router. Cách nhận biết các board ESP32-S3 trên TAPIT.
3. ESP32 thấy mạng nhưng kết nối thất bại
Đọc số sau STA_DISCONNECTED reason=. Dùng số đó để chọn phép kiểm tra tiếp theo. Một mã lỗi có thể xuất hiện trong nhiều tình huống, vì vậy hãy so lại với dòng quét và vị trí board.
| Mã | Điều log cho biết | Thử tiếp |
|---|---|---|
201 (NO_AP_FOUND) |
Trong lần kết nối, driver không tìm được điểm phát đáp ứng điều kiện. | So lại SSID, băng tần và kết quả quét. Thử lại gần bộ phát. |
202 (AUTH_FAIL) |
Bước xác thực thất bại. | Kiểm tra kiểu bảo mật và đối chiếu thông tin kết nối với một thiết bị hoạt động trên cùng mạng. |
15 hoặc 204 |
Quá trình bắt tay bảo mật hết thời gian hoặc thất bại. | Nhập lại mật khẩu, thử gần bộ phát và đối chiếu với một mạng WPA2-Personal đã biết đang hoạt động. |
210 (NO_AP_FOUND_W_COMPATIBLE_SECURITY) |
Điểm phát phù hợp về tên mạng nhưng cấu hình bảo mật không tương thích. | Kiểm tra mạng dùng mật khẩu chung hay yêu cầu cấu hình Enterprise. |
200 (BEACON_TIMEOUT) |
ESP32 mất tín hiệu beacon từ điểm phát trong một khoảng thời gian. | Xem lỗi có xảy ra sau khi đã kết nối không. Thử gần bộ phát và kiểm tra bộ phát có khởi động lại hay không. |
Ví dụ, reason=204 là cơ sở để kiểm tra lại mật khẩu, đồng thời Espressif cũng liệt kê mã này trong các tình huống tín hiệu yếu. Hãy thay từng yếu tố để biết thay đổi nào có tác dụng. Bảng mã nguyên nhân Wi-Fi của Espressif.
4. ESP32 đã kết nối nhưng chưa nhận được địa chỉ IP
STA_CONNECTED cho biết ESP32 đã kết nối ở lớp Wi-Fi. Với cấu hình DHCP mặc định của sketch, tiếp theo board cần nhận địa chỉ IPv4 từ mạng. Nếu đã chờ khoảng 30 giây từ STA_CONNECTED và chưa thấy STA_GOT_IP, đọc lại log theo hai tình huống.
- Kết nối vẫn giữ được. Dùng điện thoại hoặc máy tính kết nối đúng mạng đó và kiểm tra nó có nhận IPv4 tự động không. Nếu bạn quản lý router, kiểm tra DHCP có bật và còn địa chỉ để cấp không. Nếu sketch chẩn đoán có IP còn ứng dụng thật không có, xem ứng dụng có đặt IP tĩnh bằng
WiFi.config()hoặc dùng cấu hình mạng khác không. - Có
STA_DISCONNECTEDtrước khi nhận IP. Xử lý lỗi kết nối theo mãreasonở phần trên. Khi nhận đượcSTA_GOT_IPổn định, bạn có thể kiểm tra riêng gateway, DNS, địa chỉ máy chủ và thông báo lỗi của MQTT hoặc Firebase.
Tài liệu ESP-IDF về sự kiện kết nối và cấp phát IP.
5. Thử đối chứng bằng điểm phát Wi-Fi 2,4 GHz
Bật điểm phát cá nhân trên điện thoại. Nếu điện thoại cho chọn, dùng 2,4 GHz và WPA2-Personal, đặt một tên mạng riêng dễ nhận biết. Giữ nguyên board, vị trí và sketch. Chỉ thay tên mạng và mật khẩu trong mã, rồi so sánh log với lần thử trên router.
- Hotspot có
STA_GOT_IP, router thì không. Kết nối cơ bản của board hoạt động trong điều kiện đối chứng. Dùng mốc mà router bị kẹt để kiểm tra tiếp băng tần, bảo mật hoặc DHCP của mạng đó. - Cả hai dừng ở cùng một mốc. Kiểm tra lại hai bộ thông tin kết nối, mẫu board, phiên bản Arduino-ESP32 và log khởi động. Nếu board liên tục reset khi bật Wi-Fi, kiểm tra nguồn cấp trước khi tiếp tục chẩn đoán từ mã
reason.
Khi cần nhờ hỗ trợ, gửi mẫu board, phiên bản Arduino-ESP32, kiểu bảo mật, các dòng từ SCAN_ đến STA_ và kết quả thử hotspot. Hãy che tên mạng nếu cần và bỏ mật khẩu khỏi đoạn mã chia sẻ.
