Kamu mengunggah program ke ESP32, membuka serial monitor, dan yang muncul hanya titik-titik tanpa akhir atau pesan gagal menghubungkan. ESP32 gagal connect WiFi adalah masalah paling umum pada project IoT pemula, dan hampir selalu penyebabnya sederhana. Artikel ini membahas delapan penyebab yang paling sering terjadi, diurutkan dari yang paling mudah diperiksa, lengkap dengan kode untuk menguji tiap kemungkinan.
Mulai dari kode uji yang minimal
Sebelum menebak penyebab, pakai program kecil yang hanya menghubungkan ke WiFi dan mencetak alasan kegagalan. Dengan itu kamu tahu persis apa yang terjadi, bukan menduga-duga.
#include <WiFi.h>
const char* ssid = "NamaWiFi";
const char* password = "KataSandiWiFi";
void setup() {
Serial.begin(115200);
delay(500);
WiFi.mode(WIFI_STA);
WiFi.begin(ssid, password);
Serial.print("Menghubungkan");
int percobaan = 0;
while (WiFi.status() != WL_CONNECTED && percobaan < 30) {
delay(500);
Serial.print(".");
percobaan++;
}
if (WiFi.status() == WL_CONNECTED) {
Serial.println("\nTerhubung. IP: " + WiFi.localIP().toString());
} else {
Serial.println("\nGagal. Kode status: " + String(WiFi.status()));
}
}
void loop() {}Kode status yang tercetak membantu diagnosis. Nilai 1 berarti WL_NO_SSID_AVAIL (SSID tidak ditemukan), 4 berarti WL_CONNECT_FAILED (otentikasi gagal), dan 6 berarti WL_DISCONNECTED. Gunakan angka ini sebagai petunjuk ke penyebab di bawah.
1. SSID atau kata sandi salah
Penyebab paling umum adalah salah ketik. SSID bersifat peka huruf besar dan kecil, dan spasi di akhir ikut dihitung. Kata sandi yang terlihat benar sering mengandung huruf yang mirip, seperti angka nol dan huruf O. Salin langsung dari pengaturan router bila memungkinkan, dan periksa tanda kutip di kode tidak berubah menjadi tanda kutip miring bila kamu menyalin dari dokumen.
2. Router hanya memancarkan 5 GHz
ESP32 klasik hanya mendukung WiFi 2.4 GHz. Bila router atau hotspot ponselmu hanya memancarkan 5 GHz, atau menggabungkan keduanya dengan satu nama dan memaksa 5 GHz, ESP32 tidak akan pernah menemukannya dan kodenya akan menunjukkan SSID tidak tersedia. Aktifkan pita 2.4 GHz di router, atau pisahkan nama jaringannya. Di hotspot ponsel Android, ada pilihan pita yang bisa diubah ke 2.4 GHz.
3. Sinyal terlalu lemah atau jarak terlalu jauh
Antena ESP32 kecil, dan dinding tebal melemahkan sinyal. Untuk memeriksa, pindai jaringan di sekitar dan lihat kekuatan sinyalnya:
int n = WiFi.scanNetworks();
for (int i = 0; i < n; i++) {
Serial.println(WiFi.SSID(i) + " | RSSI: " + String(WiFi.RSSI(i)));
}Nilai RSSI yang lebih kecil dari sekitar minus 80 menandakan sinyal lemah dan koneksi tidak stabil. Dekatkan perangkat ke router, atau gunakan papan dengan antena eksternal bila perangkat harus berada jauh.
4. Daya tidak cukup atau tidak stabil
Saat mengirim lewat WiFi, ESP32 menarik arus besar dalam waktu singkat. Kabel USB yang tipis, port laptop yang lemah, atau adaptor murah membuat tegangan turun sehingga ESP32 restart tiba-tiba. Gejalanya: di serial monitor muncul pesan Brownout detector was triggered lalu perangkat mengulang dari awal. Gunakan kabel USB yang pendek dan berkualitas, adaptor yang menyediakan minimal 1 ampere, dan bila perlu tambahkan kapasitor sekitar 100 mikrofarad antara pin daya dan ground.
5. Keamanan jaringan tidak didukung
Beberapa jaringan memakai mode keamanan yang sulit bagi ESP32, misalnya WPA3 saja, atau jaringan kampus dan kantor dengan otentikasi tambahan (WPA2 Enterprise) atau halaman login (captive portal). ESP32 biasa tidak bisa melewati halaman login lewat peramban. Coba hubungkan ke hotspot ponsel dengan WPA2 sebagai uji. Bila berhasil, masalahnya ada di jaringan yang kamu pakai, bukan di kodemu.
6. Router membatasi jumlah perangkat atau memakai filter MAC
Router rumah kadang membatasi jumlah perangkat yang terhubung, atau hanya mengizinkan alamat MAC tertentu. Cetak alamat MAC ESP32 dan daftarkan bila router memakai filter:
Serial.println(WiFi.macAddress());Periksa juga apakah DHCP router sudah kehabisan alamat IP. Memutus perangkat yang tidak dipakai atau memulai ulang router sering menyelesaikannya.
7. Kode salah urutan atau memblokir terlalu lama
Beberapa kesalahan di sisi program membuat koneksi gagal atau tampak gagal. Contohnya memanggil WiFi.begin() berulang kali di dalam loop() sehingga proses koneksi terus diulang dari awal, atau lupa mengatur mode STA. Pola yang lebih sehat adalah menghubungkan sekali, lalu hanya menyambung ulang bila koneksi terputus:
void pastikanWiFi() {
if (WiFi.status() == WL_CONNECTED) return;
Serial.println("Menyambung ulang...");
WiFi.disconnect();
WiFi.begin(ssid, password);
unsigned long mulai = millis();
while (WiFi.status() != WL_CONNECTED && millis() - mulai < 10000) {
delay(250);
}
}Perhatikan bahwa batas waktu dipakai agar program tidak tertahan selamanya. Untuk project yang butuh melakukan hal lain sambil menyambung, hindari delay() panjang dan gunakan pencatat waktu berbasis millis().
8. Pustaka atau papan tidak sesuai
Bila semuanya sudah benar tetapi tetap gagal, periksa versi paket papan ESP32 di Arduino IDE. Versi tertentu pernah memiliki masalah pada koneksi WiFi, dan memperbarui atau menurunkan versi paket kadang menyelesaikannya. Pastikan juga papan yang dipilih di menu Tools sesuai dengan perangkatmu, dan hapus memori flash bila ada sisa pengaturan lama:
esptool.py --chip esp32 erase_flashSetelah itu unggah ulang programmu. Langkah ini menghapus data WiFi tersimpan yang bisa bentrok dengan kode barumu.
Daftar periksa singkat
- Jalankan kode uji minimal dan catat kode status.
- Periksa SSID dan kata sandi dengan teliti.
- Pastikan jaringan memancarkan 2.4 GHz.
- Cek kekuatan sinyal dengan pemindaian.
- Ganti kabel dan sumber daya, lihat pesan brownout.
- Coba hubungkan ke hotspot ponsel untuk mengisolasi masalah jaringan.
- Periksa filter MAC dan batas perangkat di router.
- Perbarui paket papan dan hapus flash bila perlu.
Setelah terhubung: langkah berikutnya
Koneksi WiFi hanyalah gerbang. Untuk project IoT yang utuh, kamu masih perlu membaca sensor, mengirim data ke server atau layanan awan, dan menampilkannya di dashboard, lengkap dengan penanganan koneksi yang terputus. Bila kamu butuh dibantu dari rangkaian sampai dashboard, lihat jasa project IoT Arduino dan ESP32. Untuk project yang butuh komputer mini ada jasa project Raspberry Pi. Siap melanjutkan? Ajukan pesanan dan ruang lingkupnya ditulis dulu di SOW.