ESP32 WiFiManager: Atur Wi-Fi dari Ponselmu (Captive Portal)
ESP32 WiFiManager memungkinkan kamu memasukkan kata sandi Wi-Fi dari ponsel: captive portal, parameter kustom seperti MQTT, tombol reset, softAP, dan kendali web AP+STA.
ESP32 WiFiManager adalah library yang memungkinkan kamu menghubungkan ESP32 ke jaringan dari ponselmu tanpa menuliskan nama dan kata sandi Wi-Fi di kode. Jika board tidak bisa terhubung ke jaringan yang tersimpan, board akan membuka jaringan Wi-Fi sendiri; ketika kamu menghubungkan ponsel ke jaringan itu, halaman pengaturan muncul. Kamu memilih jaringanmu dari daftar, mengetik kata sandi, lalu ESP32 menyimpan informasi ini di memori permanennya dan terhubung. Artinya, kamu bisa memakai firmware yang sama di rumah, di sekolah, atau di rumah teman tanpa meng-upload ulang. Stopkontak pintar dan perangkat IoT komersial yang kamu atur dari ponsel pada penggunaan pertama bekerja dengan cara yang sama persis.
Dalam panduan ini, kamu akan mempelajari mode Wi-Fi ESP32 terlebih dahulu: station (STA), access point (AP), dan AP+STA, yang menjalankan keduanya bersamaan. Lalu kita akan menginstal library WiFiManager, menulis sketch pertama tanpa kata sandi, menambahkan tombol untuk menghapus pengaturan atau membuka kembali portal, serta mengumpulkan parameter kustom seperti server MQTT, port, dan nama perangkat di halaman yang sama lalu menyimpannya secara permanen. Pada bagian terakhir, ESP32 akan membuat jaringan sendiri dengan softAP, tanpa router, agar kamu bisa mengendalikan LED dari ponsel; kita akan mencoba mode AP+STA dan membuat access point di Raspberry Pi Pico W dengan MicroPython.

Apa itu ESP32 WiFiManager dan bagaimana cara kerjanya?
Dalam sketch ESP32 biasa, nama jaringan dan kata sandi dituliskan langsung pada baris WiFi.begin("HomeNet", "password"). Ketika kamu mengganti router, memperbarui kata sandi, atau membawa perangkat ke rumah lain, kamu harus membuka kode dan meng-upload ulang. WiFiManager memindahkan pekerjaan ini ke halaman web. Ketika mulai berjalan, library memeriksa apakah ada jaringan yang tersimpan di memori permanen ESP32 (NVS) dan, jika ada, mencoba menghubungkannya. Jika koneksi berhasil, kodemu berlanjut tanpa menampilkan apa pun. Jika tidak ada jaringan tersimpan atau koneksi gagal, ESP32 membuka access point sendiri, menjalankan server DNS, dan menyajikan halaman pengaturan di 192.168.4.1. Karena server DNS menjawab setiap domain yang diminta ponsel dengan alamat ini, ponsel membuka jendela “masuk ke jaringan” secara otomatis begitu terhubung. Konsepnya sama dengan halaman login di hotel dan kafe, dan disebut captive portal. Ketika kamu memilih jaringanmu di halaman tersebut dan menyimpan kata sandi, ESP32 terhubung ke jaringan baru, menutup access point, dan menyimpan informasinya untuk boot berikutnya. Semua ini dibangun di atas mode Wi-Fi yang didukung ESP32:
| Mode | Fungsi | Kapan digunakan |
|---|---|---|
| WIFI_STA (station) | Terhubung ke router sebagai klien dan mendapat IP darinya | Proyek yang mengakses internet dan bisa dijangkau dari setiap perangkat di jaringan rumah |
| WIFI_AP (access point) | Memancarkan jaringan sendiri dan membagikan alamat 192.168.4.x kepada klien | Tempat tanpa router, halaman pengaturan, kendali dari ponsel di lapangan |
| WIFI_AP_STA | Melakukan keduanya bersamaan, dengan dua alamat IP terpisah | Portal WiFiManager, tetap terhubung ke jaringan rumah ketika jaringan layanan terbuka |
| WIFI_OFF | Mematikan radio sepenuhnya | Menghemat baterai, ketika Wi-Fi tidak diperlukan |
Menginstal library WiFiManager
- Pastikan paket board ESP32 sudah terinstal di Arduino IDE. Jika belum, ikuti langkah-langkah dalam Apa Itu ESP32?.
- Buka Tools › Manage Libraries dan ketik WiFiManager di kotak pencarian.
- Cari library WiFiManager yang ditulis oleh tzapu dan instal versi terbaru (2.0.17 atau lebih baru).
- Pilih board-mu di Tools › Board (ESP32 Dev Module untuk kebanyakan DevKit) dan atur port-nya.
- Library ini tidak memerlukan paket tambahan: WebServer, DNSServer, dan Preferences sudah disertakan dalam core ESP32.
Contoh pertama: terhubung ke Wi-Fi tanpa kata sandi di kode
Sketch di bawah adalah cara paling sederhana untuk memakai WiFiManager. Tidak ada nama jaringan atau kata sandi di kode. Jika board tidak bisa terhubung ke jaringan tersimpan dalam 20 detik, board membuka jaringan bernama BlueGrays-Kurulum. Kata sandi portal diatur menjadi kurulum123; kamu juga bisa membuka portal tanpa kata sandi, tetapi siapa pun di dekatnya akan bisa memasukkan informasi jaringan ke perangkatmu. Jika portal tidak digunakan selama 180 detik, board memulai ulang dan mencoba jaringan tersimpan lagi. Detail ini penting: jika router menyala lebih lambat daripada ESP32 setelah listrik padam, board tidak terjebak di portal dan kembali ke jaringanmu secara otomatis dalam beberapa menit.
1#include <WiFi.h>
2#include <WiFiManager.h> // tzapu WiFiManager
3
4void setup() {
5 Serial.begin(115200);
6 WiFi.mode(WIFI_STA); // önce istasyon modu / start in station mode
7
8 WiFiManager wm;
9 // wm.resetSettings(); // test için kayıtlı ağı sil / erase saved network for testing
10 wm.setConnectTimeout(20); // kayıtlı ağa 20 sn dene / try the saved network for 20 s
11 wm.setConfigPortalTimeout(180); // portal 180 sn sonra kapanır / portal closes after 180 s
12
13 // Bağlanamazsa "BlueGrays-Kurulum" ağını açar / opens "BlueGrays-Kurulum" if it cannot connect
14 bool baglandi = wm.autoConnect("BlueGrays-Kurulum", "kurulum123");
15
16 if (!baglandi) {
17 Serial.println("Baglanamadi, yeniden baslatiliyor / Not connected, restarting");
18 delay(1000);
19 ESP.restart(); // kayıtlı ağı yeniden dene / try the saved network again
20 }
21
22 Serial.print("Baglandi / Connected, IP: ");
23 Serial.println(WiFi.localIP());
24}
25
26void loop() {
27 // projenin asıl kodu buraya / your project code goes here
28}Setelah meng-upload, buka Serial Monitor Arduino pada 115200 baud. Karena board berjalan untuk pertama kali, belum ada jaringan tersimpan, dan kamu akan melihat pada baris WiFiManager yang diawali *wm: bahwa access point sudah dibuka. Sekarang ambil ponselmu dan ikuti langkah-langkah ini:
- Cari jaringan BlueGrays-Kurulum dalam daftar Wi-Fi ponselmu dan hubungkan dengan kata sandi kurulum123.
- Dalam beberapa detik, halaman login terbuka secara otomatis. Jika tidak, ketik 192.168.4.1 di browser.
- Ketuk Configure WiFi. Jaringan yang terdeteksi oleh ESP32 ditampilkan bersama kekuatan sinyalnya.
- Pilih jaringanmu, ketik kata sandinya, lalu tekan Save.
- ESP32 terhubung ke jaringan baru, menutup access point, dan mencetak alamat IP yang didapat ke Serial Monitor. Ponselmu juga kembali ke jaringannya sendiri.
- Reset board: kali ini portal tidak terbuka, dan ESP32 terhubung ke jaringan tersimpan secara otomatis dalam beberapa detik.
Bagian Info pada portal menampilkan alamat MAC board, detail chip, dan status memori; Exit menutup portal tanpa menyimpan. Berikut fungsi utama WiFiManager yang akan kamu gunakan dalam artikel ini:
| Fungsi | Kegunaan |
|---|---|
| autoConnect(name, password) | Mencoba jaringan tersimpan; jika gagal, membuka portal. Mengembalikan true setelah terhubung |
| startConfigPortal(name, password) | Langsung membuka portal tanpa memeriksa jaringan tersimpan |
| setConfigPortalTimeout(s) | Menutup portal dan mengembalikan false jika tidak digunakan selama jumlah detik ini |
| setConnectTimeout(s) | Lama percobaan menghubungkan ke jaringan tersimpan |
| resetSettings() | Menghapus nama dan kata sandi Wi-Fi tersimpan |
| addParameter(¶meter) | Menambahkan kolom input kustom ke halaman portal |
| setSaveParamsCallback(function) | Memanggil fungsimu ketika parameter kustom disimpan |
| setConfigPortalBlocking(false) dan process() | Menjaga loop() tetap berjalan selama portal terbuka |
| setHostname("name") | Mengatur nama board di jaringan, yang ditampilkan pada daftar perangkat router |
Tombol reset dan portal yang dibuka sesuai kebutuhan
Setelah perangkat tertutup di dalam casing, kamu mungkin perlu mengganti informasi Wi-Fi. Cara termudah untuk melakukannya tanpa meng-upload kode baru adalah dengan tombol. Pada contoh di bawah, kita memakai tombol BOOT yang ada di board ESP32 DevKit; tombol ini terhubung ke GPIO 0 dan, karena ada resistor pull-up pada board, nilainya terbaca LOW ketika ditekan. Tekanan singkat membuka portal tanpa menghapus jaringan tersimpan, sehingga kamu bisa memasukkan jaringan baru atau hanya mengubah pengaturan kustom. Menahannya selama 3 detik menghapus jaringan tersimpan sepenuhnya dan memulai ulang board. Jika kamu lebih memilih tombol terpisah, hubungkan ke pin yang kosong seperti GPIO 4; detailnya ada dalam Cara Menghubungkan Push Button ke Arduino. LED bawaan pada GPIO 2 menunjukkan status koneksi.
1#include <WiFi.h>
2#include <WiFiManager.h>
3
4const int BUTON_PIN = 0; // DevKit üzerindeki BOOT butonu / BOOT button on the DevKit
5const int LED_PIN = 2; // dahili LED / onboard LED
6const char* PORTAL_ADI = "BlueGrays-Kurulum";
7const char* PORTAL_SIFRE = "kurulum123";
8
9WiFiManager wm;
10
11void setup() {
12 Serial.begin(115200);
13 pinMode(BUTON_PIN, INPUT_PULLUP);
14 pinMode(LED_PIN, OUTPUT);
15 WiFi.mode(WIFI_STA);
16 wm.setConfigPortalTimeout(180);
17 if (!wm.autoConnect(PORTAL_ADI, PORTAL_SIFRE)) {
18 Serial.println("Agsiz devam / Continuing offline"); // butonla tekrar denenebilir / retry with the button
19 }
20}
21
22void butonuKontrolEt() {
23 if (digitalRead(BUTON_PIN) != LOW) return;
24 delay(50); // ark önleme / debounce
25 if (digitalRead(BUTON_PIN) != LOW) return;
26
27 unsigned long basilma = millis();
28 while (digitalRead(BUTON_PIN) == LOW && millis() - basilma < 3000) {
29 delay(10); // bırakılmasını ya da 3 sn'yi bekle / wait for release or 3 s
30 }
31
32 if (millis() - basilma >= 3000) {
33 Serial.println("Wi-Fi ayarlari siliniyor / Erasing Wi-Fi settings");
34 digitalWrite(LED_PIN, HIGH);
35 wm.resetSettings(); // kayıtlı ağı sil / erase the saved network
36 delay(500);
37 ESP.restart();
38 } else {
39 Serial.println("Portal aciliyor / Opening portal");
40 if (wm.startConfigPortal(PORTAL_ADI, PORTAL_SIFRE)) {
41 Serial.print("Yeni IP / New IP: ");
42 Serial.println(WiFi.localIP());
43 } else {
44 Serial.println("Portal zaman asimi / Portal timeout");
45 }
46 }
47}
48
49void loop() {
50 butonuKontrolEt();
51 // bağlıyken LED yanar / LED is on while connected
52 digitalWrite(LED_PIN, WiFi.status() == WL_CONNECTED ? HIGH : LOW);
53}Parameter kustom: server MQTT, port, dan nama perangkat
Salah satu fitur WiFiManager yang paling berguna adalah kamu bisa menambahkan kolom input sendiri ke halaman portal. Jika kamu menghubungkan board sensor ke Home Assistant melalui MQTT, kamu juga tidak ingin menuliskan alamat server, nomor port, dan nama perangkat langsung di kode. Untuk itu, buat objek WiFiManagerParameter dan tambahkan ke portal dengan addParameter(). Ada satu hal yang harus diperhatikan: WiFiManager menyimpan nama dan kata sandi Wi-Fi sendiri, tetapi tidak menyimpan parameter kustom. Menyimpan nilai yang diketik pengguna adalah tugasmu. Kita akan memakai library Preferences yang disertakan dalam core ESP32; Preferences menulis pasangan kunci-nilai ke partisi NVS di flash, dan data tetap tersimpan meskipun listrik padam. Jika kamu penasaran dengan padanannya di Arduino, baca artikel EEPROM Arduino.
1#include <WiFi.h>
2#include <WiFiManager.h>
3#include <Preferences.h>
4
5Preferences ayarlar; // NVS'te kalıcı ayarlar / persistent settings in NVS
6char mqttSunucu[40] = "192.168.1.10"; // varsayılan değerler / default values
7char mqttPort[6] = "1883";
8char cihazAdi[24] = "bluegrays-sensor";
9
10WiFiManager wm;
11// id, etiket, varsayılan değer, en fazla uzunluk / id, label, default value, max length
12WiFiManagerParameter pSunucu("sunucu", "MQTT sunucusu / server", mqttSunucu, 40);
13WiFiManagerParameter pPort("port", "MQTT port", mqttPort, 6);
14WiFiManagerParameter pAd("ad", "Cihaz adi / Device name", cihazAdi, 24);
15
16void ayarlariOku() {
17 ayarlar.begin("bluegrays", true); // salt okunur aç / open read-only
18 if (ayarlar.isKey("sunucu")) {
19 ayarlar.getString("sunucu", mqttSunucu, sizeof(mqttSunucu));
20 ayarlar.getString("port", mqttPort, sizeof(mqttPort));
21 ayarlar.getString("ad", cihazAdi, sizeof(cihazAdi));
22 }
23 ayarlar.end();
24}
25
26// Portalda Kaydet'e basılınca çağrılır / called when Save is pressed in the portal
27void parametreleriKaydet() {
28 strlcpy(mqttSunucu, pSunucu.getValue(), sizeof(mqttSunucu));
29 strlcpy(mqttPort, pPort.getValue(), sizeof(mqttPort));
30 strlcpy(cihazAdi, pAd.getValue(), sizeof(cihazAdi));
31
32 ayarlar.begin("bluegrays", false); // yazma için aç / open for writing
33 ayarlar.putString("sunucu", mqttSunucu);
34 ayarlar.putString("port", mqttPort);
35 ayarlar.putString("ad", cihazAdi);
36 ayarlar.end();
37 Serial.println("Parametreler kaydedildi / Parameters saved");
38}
39
40void setup() {
41 Serial.begin(115200);
42 WiFi.mode(WIFI_STA);
43 ayarlariOku();
44
45 // Kayıtlı değerleri form kutularına yaz / put saved values into the form fields
46 pSunucu.setValue(mqttSunucu, 40);
47 pPort.setValue(mqttPort, 6);
48 pAd.setValue(cihazAdi, 24);
49
50 wm.addParameter(&pSunucu);
51 wm.addParameter(&pPort);
52 wm.addParameter(&pAd);
53 wm.setSaveParamsCallback(parametreleriKaydet);
54 wm.setHostname(cihazAdi); // modemde görünen ad / name shown in the router
55 wm.setConfigPortalTimeout(180);
56
57 if (!wm.autoConnect("BlueGrays-Kurulum", "kurulum123")) {
58 ESP.restart();
59 }
60
61 uint16_t port = atoi(mqttPort); // metni sayıya çevir / convert text to a number
62 Serial.printf("IP: %s\n", WiFi.localIP().toString().c_str());
63 Serial.printf("MQTT: %s:%u, cihaz / device: %s\n", mqttSunucu, port, cihazAdi);
64}
65
66void loop() {
67 // MQTT bağlantısı burada mqttSunucu ve port ile kurulur / connect to MQTT here with mqttSunucu and port
68}Ketika kamu membuka halaman Configure WiFi di portal, kamu akan melihat tiga kolom baru di bawah daftar jaringan. Kolom ini sudah diisi dengan nilai yang tersimpan di NVS, atau dengan nilai bawaan dari kode jika belum ada yang tersimpan. Ketika kamu menekan Save, WiFiManager terlebih dahulu memanggil fungsi parametreleriKaydet(), lalu terhubung ke Wi-Fi. Berikut ringkasan parameter dan fungsinya:
| Item | Kegunaan | Catatan |
|---|---|---|
| WiFiManagerParameter(id, label, default, length) (konstruktor yang menambahkan kolom input ke portal) | Menambahkan kolom input ke portal | id harus unik, tanpa spasi atau karakter khusus |
| getValue() | Mengembalikan teks yang diketik pengguna | Selalu berupa teks; gunakan atoi() atau atof() untuk angka |
| setValue(value, length) | Mengisi kolom | Digunakan untuk menampilkan nilai tersimpan dalam formulir |
| setSaveParamsCallback() | Memanggil fungsimu ketika penyimpanan dilakukan | Lakukan penulisan ke NVS di sini |
| setParamsPage(true) | Memindahkan parameter ke halaman Setup terpisah | Untuk memperbarui pengaturan saja, tanpa mengubah Wi-Fi |
Perhatikan nilai panjang: ukuran array dan panjang parameter harus cocok, kalau tidak, input yang panjang bisa melampaui batas memori atau terpotong. Karena itulah sketch menyalin nilai dengan strlcpy(); fungsi ini tidak pernah melampaui ukuran array tujuan. Memeriksa apakah nilai numerik seperti nomor port berada dalam rentang yang masuk akal sebelum memakainya juga merupakan kebiasaan yang baik.
Jaringan ESP32 sendiri: kendali web dari ponselmu dengan softAP
Portal WiFiManager sebenarnya adalah penerapan siap pakai dari fitur access point ESP32, dan kamu bisa memakai fitur itu sendiri. Ketika WiFi.softAP() dipanggil, ESP32 berperilaku seperti router: memancarkan jaringan sendiri, memberi ponsel yang terhubung alamat seperti 192.168.4.2, dan memakai alamat 192.168.4.1 untuk dirinya sendiri. Ini ideal untuk kendali dari ponsel di kebun tanpa router, pada pameran sains sekolah, atau di lomba robot. Fungsi ini menerima nama jaringan, kata sandi, kanal, opsi jaringan tersembunyi, dan jumlah koneksi maksimum. Kata sandi harus minimal 8 karakter; jika kamu memberikan kata sandi yang lebih pendek, softAP() mengembalikan false dan jaringan tidak akan muncul. Jumlah koneksi maksimum bawaan adalah 4, dan pada ESP32 bisa dinaikkan menjadi 10. Sketch di bawah menyajikan halaman web untuk menyalakan dan mematikan LED pada GPIO 2 dari ponselmu:
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* AP_ADI = "BlueGrays-LED";
5const char* AP_SIFRE = "bluegrays1"; // en az 8 karakter / at least 8 characters
6const int LED_PIN = 2;
7
8WebServer sunucu(80);
9bool ledAcik = false;
10
11void anaSayfa() {
12 String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>"
13 "<meta name='viewport' content='width=device-width,initial-scale=1'>"
14 "<title>ESP32 LED</title></head><body style='font-family:sans-serif;text-align:center'>"
15 "<h2>ESP32 softAP</h2><p>LED: <b>";
16 html += ledAcik ? "ACIK / ON" : "KAPALI / OFF";
17 html += "</b></p><p><a href='/ac'><button style='font-size:24px'>AC / ON</button></a> "
18 "<a href='/kapat'><button style='font-size:24px'>KAPAT / OFF</button></a></p>";
19 html += "<p>Bagli cihaz / Clients: " + String(WiFi.softAPgetStationNum()) + "</p></body></html>";
20 sunucu.send(200, "text/html", html);
21}
22
23void yonlendir() { // ana sayfaya geri dön / go back to the home page
24 sunucu.sendHeader("Location", "/");
25 sunucu.send(303);
26}
27
28void setup() {
29 Serial.begin(115200);
30 pinMode(LED_PIN, OUTPUT);
31
32 WiFi.mode(WIFI_AP);
33 // ad, şifre, kanal, gizli değil, en fazla 4 cihaz / ssid, password, channel, not hidden, max 4 clients
34 if (!WiFi.softAP(AP_ADI, AP_SIFRE, 6, 0, 4)) {
35 Serial.println("softAP acilamadi / softAP failed");
36 return;
37 }
38 Serial.print("Ag / Network: ");
39 Serial.println(AP_ADI);
40 Serial.print("Adres / Address: http://");
41 Serial.println(WiFi.softAPIP()); // genellikle 192.168.4.1 / usually 192.168.4.1
42
43 sunucu.on("/", anaSayfa);
44 sunucu.on("/ac", []() { ledAcik = true; digitalWrite(LED_PIN, HIGH); yonlendir(); });
45 sunucu.on("/kapat", []() { ledAcik = false; digitalWrite(LED_PIN, LOW); yonlendir(); });
46 sunucu.begin();
47}
48
49void loop() {
50 sunucu.handleClient(); // gelen istekleri işle / handle incoming requests
51}Upload kode, hubungkan ponselmu ke jaringan BlueGrays-LED, dan buka 192.168.4.1 di browser. LED menyala dan mati ketika kamu menekan tombol, dan halaman menampilkan jumlah perangkat yang terhubung. Tidak ada captive portal di sini, jadi kamu harus mengetik alamatnya sendiri. Jika halaman tidak dimuat, ingat bahwa ponsel mungkin sudah beralih ke data seluler karena tidak ada internet. Jika kamu ingin panel kendali yang diperbarui langsung tanpa memuat ulang halaman, kamu bisa memakai metode dari artikel web server dan WebSocket ESP32 pada jaringan softAP yang sama.
AP+STA bersamaan: memancarkan jaringan sendiri sambil terhubung ke jaringan rumah
Dalam mode WIFI_AP_STA, ESP32 terhubung ke router dan memancarkan jaringan sendiri secara bersamaan. Board kemudian memiliki dua alamat IP terpisah: WiFi.localIP() memberikan alamat di jaringan rumah dan WiFi.softAPIP() memberikan 192.168.4.1 di jaringannya sendiri. Portal WiFiManager juga berjalan dalam mode ini, sehingga bisa memindai jaringan sambil menyajikan halaman ke ponselmu. Dalam proyekmu sendiri, kamu bisa memilih AP+STA agar jaringan layanan tetap tersedia dan selalu bisa diakses dari ponsel, bahkan ketika router mati, atau untuk memakai ESP-NOW dan Wi-Fi bersamaan. Sketch di bawah menyajikan halaman yang sama pada kedua antarmuka:
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* WIFI_ADI = "EvAgi_2G"; // ev ağı / home network
5const char* WIFI_SIFRE = "sifre1234";
6const char* AP_ADI = "BlueGrays-Servis";
7const char* AP_SIFRE = "servis1234";
8
9WebServer sunucu(80);
10
11void anaSayfa() {
12 String html = "<h2>ESP32 AP+STA</h2>";
13 html += "<p>Ev agi / Home IP: " + WiFi.localIP().toString() + "</p>";
14 html += "<p>Kendi agi / Own AP IP: " + WiFi.softAPIP().toString() + "</p>";
15 html += "<p>Kanal / Channel: " + String(WiFi.channel()) + ", RSSI: " + String(WiFi.RSSI()) + " dBm</p>";
16 sunucu.send(200, "text/html", html);
17}
18
19void setup() {
20 Serial.begin(115200);
21 WiFi.mode(WIFI_AP_STA); // iki mod birlikte / both modes together
22 WiFi.softAP(AP_ADI, AP_SIFRE); // servis ağı her zaman açık / service network always on
23 WiFi.begin(WIFI_ADI, WIFI_SIFRE);
24
25 unsigned long baslangic = millis();
26 while (WiFi.status() != WL_CONNECTED && millis() - baslangic < 15000) {
27 delay(500);
28 Serial.print('.');
29 }
30 Serial.println();
31 Serial.print("STA IP: ");
32 Serial.println(WiFi.localIP()); // bağlanamadıysa 0.0.0.0 / 0.0.0.0 if not connected
33 Serial.print("AP IP: ");
34 Serial.println(WiFi.softAPIP());
35
36 sunucu.on("/", anaSayfa);
37 sunucu.begin(); // iki arayüzü de dinler / listens on both interfaces
38}
39
40void loop() {
41 sunucu.handleClient();
42}Mode AP+STA memiliki batasan penting yang perlu kamu ketahui: ESP32 hanya memiliki satu radio, jadi kedua jaringan harus berjalan pada kanal yang sama. Jaringan yang kamu buka pada kanal 1 dengan softAP() berpindah ke kanal 11 begitu ESP32 terhubung ke router pada kanal 11. Selama perpindahan itu, ponsel yang terhubung ke jaringan layanan mungkin kehilangan koneksi selama beberapa detik. Karena radio dipakai bersama oleh dua jaringan, laju transfer data menurun dan board menarik arus sedikit lebih besar. Jika kamu tidak lagi memerlukan jaringan layanan setelah pengaturan selesai, kamu bisa mematikan access point dengan WiFi.softAPdisconnect(true) dan mengembalikan board ke mode station saja.
Access point dengan Raspberry Pi Pico W dan MicroPython
Tidak ada padanan yang persis sama dengan WiFiManager Arduino di Raspberry Pi Pico W, tetapi membuat access point hanya memerlukan beberapa baris dalam MicroPython. network.WLAN(network.AP_IF) memberikan antarmuka access point; kamu mengatur nama jaringan dan kata sandi dengan config() lalu mengaktifkannya dengan active(True). Pico W juga membagikan alamat 192.168.4.x kepada klien dan memakai alamat 192.168.4.1 untuk dirinya sendiri. Kode di bawah adalah web server kecil yang menyalakan dan mematikan LED bawaan Pico W dari ponselmu:
1import network, socket, time
2from machine import Pin
3
4led = Pin("LED", Pin.OUT) # Pico W kart üstü LED / Pico W onboard LED
5
6ap = network.WLAN(network.AP_IF)
7ap.config(essid="BlueGrays-Pico", password="bluegrays1") # en az 8 karakter / at least 8 chars
8ap.active(True)
9while not ap.active():
10 time.sleep(0.1)
11print("AP IP:", ap.ifconfig()[0]) # genellikle 192.168.4.1 / usually 192.168.4.1
12
13SAYFA = """<!DOCTYPE html><html><head><meta name="viewport" content="width=device-width">
14<title>Pico W</title></head><body><h2>Pico W LED: DURUM</h2>
15<p><a href="/on">AC / ON</a> | <a href="/off">KAPAT / OFF</a></p></body></html>"""
16
17s = socket.socket()
18s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
19s.bind(("0.0.0.0", 80))
20s.listen(2)
21
22while True:
23 istemci, adres = s.accept()
24 try:
25 istek = istemci.recv(1024).decode()
26 if "GET /on " in istek:
27 led.on()
28 elif "GET /off " in istek:
29 led.off()
30 durum = "ACIK / ON" if led.value() else "KAPALI / OFF"
31 istemci.send("HTTP/1.0 200 OK\r\nContent-Type: text/html\r\n\r\n")
32 istemci.send(SAYFA.replace("DURUM", durum))
33 except OSError as hata:
34 print("Hata / Error:", hata)
35 finally:
36 istemci.close() # bağlantıyı her istekten sonra kapat / close after each requestJika kamu menyimpan kode ke Pico W sebagai main.py dengan Thonny, board membuat jaringannya secara otomatis setiap kali boot. Cukup hubungkan ponselmu ke jaringan BlueGrays-Pico dan buka 192.168.4.1. Jika kamu menginginkan captive portal pada Pico W, library phew dari Pimoroni menyediakan access point dan server DNS yang menangkap setiap domain; konsepnya sama dengan WiFiManager. Untuk menghubungkan Pico W ke jaringan rumah dan menjalankan web server dalam mode station, baca artikel web server Wi-Fi Pico W, dan jika kamu baru mengenal MicroPython, lihat panduan dasar-dasar MicroPython.
Ide proyek dengan WiFiManager
- Layar suhu yang bisa kamu hadiahkan: Biarkan penerima board sensor yang menampilkan pembacaannya di halaman web menghubungkannya ke Wi-Fi sendiri dari ponsel.
- Sensor rumah pintar: Hubungkan board yang memperoleh server MQTT dari portal ke Home Assistant; tidak perlu meng-upload ulang ketika alamat server berubah.
- Alarm yang mengirim notifikasi ke ponselmu: Buat bot Telegram ESP32 yang menerima token bot sebagai parameter kustom.
- Pembaruan tanpa kabel untuk perangkat dalam casing: Kirim kode baru dengan pembaruan OTA ke board yang terhubung ke jaringan melalui WiFiManager.
- Jam internet: Buat jam NTP ESP32 yang zona waktunya dipilih di portal.
- Kendali di lapangan tanpa router: Nyalakan dan matikan pompa irigasi kebun dari ponselmu dengan softAP; gunakan ESP-NOW untuk komunikasi antara beberapa board.
Kesalahan umum dan solusinya
| Gejala | Kemungkinan penyebab | Solusi |
|---|---|---|
| Jaringan portal tidak muncul di ponsel | Board terhubung ke jaringan tersimpan, sehingga portal tidak terbuka | Periksa Serial Monitor; jalankan resetSettings() sekali untuk pengujian atau buka portal dengan tombol |
| Ponsel terhubung ke jaringan tetapi halaman tidak terbuka | Ponsel beralih ke data seluler karena tidak ada internet | Matikan data seluler dan ketik 192.168.4.1 di browser |
| Portal tidak terbuka dan Serial Monitor menampilkan peringatan kata sandi | Kata sandi portal lebih pendek dari 8 karakter | Gunakan kata sandi minimal 8 karakter atau jangan sertakan parameter kata sandi |
| wm.process() atau setParamsPage tidak dikenali | Library WiFiManager salah atau sangat lama | Instal WiFiManager dari tzapu versi terkini dan hapus library dengan nama serupa |
| Setelah Save, board membuka portal lagi | Kata sandi yang dimasukkan salah atau jaringannya 5 GHz | Periksa kata sandi dan pilih jaringan 2,4 GHz; lihat panduan Wi-Fi tidak mau terhubung untuk detailnya |
| Parameter kustom hilang setelah memulai ulang | Nilai tidak ditulis ke NVS | Simpan dengan Preferences dalam setSaveParamsCallback, baca ketika mulai berjalan, lalu masukkan ke formulir dengan setValue() |
| Board terus masuk ke mode upload | Tombol terhubung ke GPIO 0 dan ditekan ketika daya dinyalakan | Tekan tombol setelah board mulai berjalan atau gunakan pin yang bukan strapping |
| Ponsel terputus dalam mode AP+STA | Access point berpindah ke kanal router | Ini normal; hubungkan kembali setelah beberapa detik atau gunakan softAPdisconnect(true) setelah selesai |
WiFiManager adalah langkah termudah untuk mengubah proyek ESP32 dari eksperimen di mejamu menjadi perangkat yang bisa digunakan orang lain: kata sandi dikeluarkan dari kode, pengaturan dimasukkan dari ponsel, dan satu tombol mereset semuanya. Kini setelah kamu juga mengenal softAP dan AP+STA, kamu bisa membuat proyek yang dikendalikan dari ponsel di berbagai tempat, dengan atau tanpa router. Dalam aplikasi BlueGrays, kamu bisa menjelajahi proyek ESP32 seperti koneksi Wi-Fi, web server asinkron, mDNS, WebSocket, pembaruan OTA, dan alarm Telegram, masing-masing dengan skema rangkaian langkah demi langkah dan kode siap pakai.
Pertanyaan umum
Apa fungsi ESP32 WiFiManager?
Library ini memungkinkan kamu menghubungkan ESP32 ke jaringan dari ponselmu tanpa menuliskan nama dan kata sandi Wi-Fi di kode. Jika board tidak bisa terhubung ke jaringan tersimpan, board membuka access point sendiri dan menyajikan halaman pengaturan di 192.168.4.1. Jaringan dan kata sandi yang kamu pilih di sana disimpan dalam memori permanen dan digunakan secara otomatis pada boot berikutnya.
Di mana WiFiManager menyimpan kata sandi Wi-Fi?
Pada ESP32, nama dan kata sandi Wi-Fi disimpan dalam partisi NVS di memori flash sebagai pengaturan milik driver Wi-Fi. Keduanya tidak terhapus ketika kamu meng-upload kode baru. Untuk menghapusnya, panggil resetSettings() atau hapus seluruh isi flash.
Bagaimana cara mereset pengaturan WiFiManager?
Panggil wm.resetSettings() dalam kodemu dan mulai ulang board. Dalam praktiknya, sebaiknya kaitkan tindakan ini dengan tombol: misalnya, tambahkan pemeriksaan yang menghapus pengaturan ketika tombol BOOT ditahan selama 3 detik. Jika kamu hanya ingin membuka portal tanpa menghapus jaringan tersimpan, gunakan startConfigPortal().
Mengapa halaman captive portal ESP32 tidak terbuka?
Penyebab paling umum adalah ponsel mendeteksi bahwa jaringan portal tidak memiliki internet lalu beralih ke data seluler; matikan data seluler dan ketik 192.168.4.1 di browser. Jika board sudah terhubung ke jaringan tersimpan, portal sama sekali tidak terbuka. Pastikan juga kata sandi portal panjangnya minimal 8 karakter.
Bisakah ESP32 menjadi access point dan station secara bersamaan?
Bisa. Dalam mode WIFI_AP_STA, ESP32 memancarkan jaringan sendiri sambil terhubung ke router dan memakai dua alamat IP terpisah. Karena hanya ada satu radio, kedua jaringan harus memakai kanal yang sama; ketika board terhubung ke router, access point beralih ke kanal router.
Berapa perangkat yang bisa terhubung ke softAP ESP32?
Dalam core Arduino, softAP() secara bawaan mengizinkan hingga 4 perangkat. Pada ESP32, kamu bisa menaikkannya menjadi 10 melalui parameter kelima softAP(). Kamu bisa membaca jumlah perangkat yang terhubung dengan WiFi.softAPgetStationNum().
Proyek untuk dibuat setelah membaca ini
Lihat semua proyek
Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)
Di proyek ini, kita menyambungkan ESP32 ke jaringan Wi-Fi rumah dalam mode Station (STA) dengan cara yang aman dan tahan gangguan. Kita menyimpan SSID dan kata sandi di file secrets.h terpisah agar tidak bocor ke Git, menyiapkan mekanisme sambung ulang otomatis, dan menampilkan tingkat sinyal RSSI dan alamat IP di layar LCD I2C. LED bawaan bekerja sebagai indikator status. Ini adalah pengelola koneksi kelas produksi.

Web Server Asinkron ESP32 (dengan Tampilan IP di LCD)
Di proyek ini, kita mengubah ESP32 menjadi web server asinkron yang bisa kamu kendalikan dari ponsel atau komputer di jaringan Wi-Fi yang sama. Berkat library ESPAsyncWebServer, server bisa memproses beberapa permintaan bersamaan (berbeda dengan WebServer.h klasik, yang memblokir pada satu permintaan). Kamu bisa membuka alamat IP ESP32 di browser dan mengklik tombol ON/OFF (rute /on dan /off) untuk menyalakan dan mematikan LED yang tersambung ke GPIO 5.

mDNS ESP32: Mengakses Perangkat lewat bluegrays-esp.local (dengan Layar LCD)
Di proyek ini, kita menambahkan layanan mDNS (Multicast DNS) ke ESP32, sehingga perangkat bisa diakses dengan nama host seperti bluegrays-esp.local, bukan alamat IP. Meskipun IP dari DHCP berubah, perangkat selalu bisa dijangkau dengan nama yang sama. Web server kecil di perangkat menerima perintah kendali LED dari browser lewat alamat http://bluegrays-esp.local/. Layar LCD I2C menampilkan nama host, alamat IP, dan status LED.

Penghitung WebSocket ESP32 (2 Tombol + LCD + Web Real-Time)
Di proyek ini, dua tombol yang tersambung ke ESP32 (GPIO 5 menghitung naik, GPIO 4 menghitung turun) mengubah sebuah penghitung. Nilainya langsung diperbarui di LCD I2C 16x2 sekaligus, lewat dukungan WebSocket ESPAsyncWebServer, di setiap browser yang tersambung tanpa memuat ulang halaman. Alih-alih polling HTTP, dipakai satu koneksi yang tetap terbuka, dan ESP32 mengirim nilai baru ke semua orang dengan ws.textAll().

Pembaruan OTA ESP32: Instal Firmware Tanpa Kabel (dengan Layar LCD)
Di proyek ini, kamu belajar cara meng-upload firmware baru ke ESP32 lewat Wi-Fi tanpa kabel USB. Dengan library ArduinoOTA, ESP32 terlihat di jaringan dan otomatis tercantum sebagai bluegrays-ota di tab "Network port" Arduino IDE. Upload pertama dilakukan lewat USB, dan semua pembaruan berikutnya tanpa kabel; fitur penting untuk perangkat di lapangan. Layar LCD I2C menampilkan status Wi-Fi, alamat IP, nama host, persentase upload OTA, dan pesan error.

Jam Real-Time dari Internet lewat NTP ESP32
ESP32 tersambung ke Wi-Fi dan mengambil waktu nyata dengan presisi milidetik dari server NTP (Network Time Protocol). Berkat fungsi configTzTime(), zona waktu Turki (TRT, UTC+3) otomatis diterapkan, dan pergantian DST di negara yang memakai waktu musim panas otomatis diatur dengan string POSIX TZ. Waktunya ditampilkan di Serial Monitor sekaligus di LCD I2C opsional. configTzTime() memulai layanan SNTP; sinkronisasi ulang berkala terjadi selama koneksi tersedia.

HTTPClient + API Cuaca ESP32 (dengan Layar LCD)
Di proyek ini, kita memakai ESP32 untuk melakukan panggilan REST API ke API cuaca (wttr.in) lewat internet dengan HTTPClient.h. Kita mengurai respons JSON yang diterima dengan ArduinoJson v7 dan menampilkan kota, suhu, kelembapan, cuaca, dan informasi angin di layar LCD I2C dalam bahasa Turki dan Inggris. wttr.in gratis dan tidak butuh kunci API; kamu cukup memasukkan nama kota apa pun untuk mengambil kondisi cuaca terkini kota itu. Data diperbarui otomatis setiap 30 menit.

Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)
Sistem alarm keamanan pintar yang menyalakan buzzer dan LED ketika sensor PIR mendeteksi gerakan, sekaligus mengirim notifikasi instan ke pemilik lewat Telegram. Cooldown 30 detik membatasi seberapa sering alarm berulang; mekanisme ini tidak memvalidasi deteksi PIR atau menghilangkan pemicu palsu. Cocok untuk rumah, garasi, gudang, atau ruang kerja. Dengan ESP32-CAM bisa ditambahkan notifikasi berfoto; dengan ESP32 DevKit V1 klasik, notifikasinya berupa teks.
Artikel lainnya
Aplikasi BlueGrays
Rakit rangkaian ini langkah demi langkah di ponselmu
Skema pengkabelan, kode, dan daftar komponen dalam satu layar. 500+ proyek Arduino, ESP32, dan Pico siap dibuat.
Pindai dengan ponselmu
Arahkan kamera ke kode ini dan toko aplikasi di ponselmu akan terbuka.
atau buka toko aplikasi

