Panduan · 11 mnt baca

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.

Board pengembangan ESP32
Board ESP32 DevKit: Wi-Fi-nya bisa bekerja sebagai station dan access point secara bersamaan.

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:

ModeFungsiKapan digunakan
WIFI_STA (station)Terhubung ke router sebagai klien dan mendapat IP darinyaProyek 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 klienTempat tanpa router, halaman pengaturan, kendali dari ponsel di lapangan
WIFI_AP_STAMelakukan keduanya bersamaan, dengan dua alamat IP terpisahPortal WiFiManager, tetap terhubung ke jaringan rumah ketika jaringan layanan terbuka
WIFI_OFFMematikan radio sepenuhnyaMenghemat baterai, ketika Wi-Fi tidak diperlukan

Menginstal library WiFiManager

  1. Pastikan paket board ESP32 sudah terinstal di Arduino IDE. Jika belum, ikuti langkah-langkah dalam Apa Itu ESP32?.
  2. Buka Tools › Manage Libraries dan ketik WiFiManager di kotak pencarian.
  3. Cari library WiFiManager yang ditulis oleh tzapu dan instal versi terbaru (2.0.17 atau lebih baru).
  4. Pilih board-mu di Tools › Board (ESP32 Dev Module untuk kebanyakan DevKit) dan atur port-nya.
  5. Library ini tidak memerlukan paket tambahan: WebServer, DNSServer, dan Preferences sudah disertakan dalam core ESP32.
Library Manager menampilkan beberapa library dengan nama mirip WiFiManager. Sketch dalam artikel ini ditulis untuk library dari tzapu; jika kamu menginstal ESPAsyncWiFiManager atau WiFiManager lainnya, nama fungsinya tidak akan cocok dan kode tidak bisa dikompilasi. Jika kamu memakai core ESP32 versi 3.x, instal juga versi library terbaru; versi lama mungkin gagal dikompilasi pada core baru.

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.

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

  1. Cari jaringan BlueGrays-Kurulum dalam daftar Wi-Fi ponselmu dan hubungkan dengan kata sandi kurulum123.
  2. Dalam beberapa detik, halaman login terbuka secara otomatis. Jika tidak, ketik 192.168.4.1 di browser.
  3. Ketuk Configure WiFi. Jaringan yang terdeteksi oleh ESP32 ditampilkan bersama kekuatan sinyalnya.
  4. Pilih jaringanmu, ketik kata sandinya, lalu tekan Save.
  5. ESP32 terhubung ke jaringan baru, menutup access point, dan mencetak alamat IP yang didapat ke Serial Monitor. Ponselmu juga kembali ke jaringannya sendiri.
  6. 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:

FungsiKegunaan
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
Ketika ponselmu terhubung ke jaringan portal, mungkin muncul peringatan bahwa “jaringan ini tidak memiliki akses internet”, dan setelah beberapa waktu ponsel mencoba beralih ke data seluler atau jaringan Wi-Fi lain. Jika peringatan muncul, pilih tetap terhubung; jika halaman tidak terbuka, matikan data seluler sementara. Pada iPhone, jika jendela login tertutup, kamu bisa membuka kembali halaman dengan mengetuk ikon info di sebelah jaringan BlueGrays-Kurulum dalam pengaturan Wi-Fi.

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.

C++ (Arduino IDE)
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}
GPIO 0 adalah pin strapping: jika nilainya LOW ketika board dinyalakan atau di-reset, ESP32 tidak menjalankan kodemu dan justru masuk ke mode upload. Jadi, tekan tombol BOOT hanya setelah board mulai berjalan. Jika kamu menghubungkan tombol ke pin lain sebagai pengganti GPIO 0, hindari pin strapping seperti GPIO 0, 2, 5, 12, dan 15; kamu bisa melihat pin yang aman pada alat Pinout.

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.

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

ItemKegunaanCatatan
WiFiManagerParameter(id, label, default, length) (konstruktor yang menambahkan kolom input ke portal)Menambahkan kolom input ke portalid harus unik, tanpa spasi atau karakter khusus
getValue()Mengembalikan teks yang diketik penggunaSelalu berupa teks; gunakan atoi() atau atof() untuk angka
setValue(value, length)Mengisi kolomDigunakan untuk menampilkan nilai tersimpan dalam formulir
setSaveParamsCallback()Memanggil fungsimu ketika penyimpanan dilakukanLakukan penulisan ke NVS di sini
setParamsPage(true)Memindahkan parameter ke halaman Setup terpisahUntuk 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:

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

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

MicroPython
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 request

Jika 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

GejalaKemungkinan penyebabSolusi
Jaringan portal tidak muncul di ponselBoard terhubung ke jaringan tersimpan, sehingga portal tidak terbukaPeriksa Serial Monitor; jalankan resetSettings() sekali untuk pengujian atau buka portal dengan tombol
Ponsel terhubung ke jaringan tetapi halaman tidak terbukaPonsel beralih ke data seluler karena tidak ada internetMatikan data seluler dan ketik 192.168.4.1 di browser
Portal tidak terbuka dan Serial Monitor menampilkan peringatan kata sandiKata sandi portal lebih pendek dari 8 karakterGunakan kata sandi minimal 8 karakter atau jangan sertakan parameter kata sandi
wm.process() atau setParamsPage tidak dikenaliLibrary WiFiManager salah atau sangat lamaInstal WiFiManager dari tzapu versi terkini dan hapus library dengan nama serupa
Setelah Save, board membuka portal lagiKata sandi yang dimasukkan salah atau jaringannya 5 GHzPeriksa kata sandi dan pilih jaringan 2,4 GHz; lihat panduan Wi-Fi tidak mau terhubung untuk detailnya
Parameter kustom hilang setelah memulai ulangNilai tidak ditulis ke NVSSimpan dengan Preferences dalam setSaveParamsCallback, baca ketika mulai berjalan, lalu masukkan ke formulir dengan setValue()
Board terus masuk ke mode uploadTombol terhubung ke GPIO 0 dan ditekan ketika daya dinyalakanTekan tombol setelah board mulai berjalan atau gunakan pin yang bukan strapping
Ponsel terputus dalam mode AP+STAAccess point berpindah ke kanal routerIni normal; hubungkan kembali setelah beberapa detik atau gunakan softAPdisconnect(true) setelah selesai
Untuk masalah koneksi, baca dahulu baris *wm: di Serial Monitor; WiFiManager mencetak dengan jelas jaringan yang dicoba, hasil koneksi, dan alasan portal ditutup. Jika board tetap tidak bisa terhubung ke jaringan setelah portal ditutup, masalahnya kemungkinan besar ada pada router atau catu daya; kami menjelaskan cara membaca kode status dan alasan langkah demi langkah dalam ESP32 tidak mau terhubung ke Wi-Fi.

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().

Lihat semua proyek
Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)
ES-25Mahir

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.

4.4(21)
38
Web Server Asinkron ESP32 (dengan Tampilan IP di LCD)
ES-27Mahir

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.

4.8(16)
26
mDNS ESP32: Mengakses Perangkat lewat bluegrays-esp.local (dengan Layar LCD)
ES-29Mahir
Premium

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.

4.8(14)
23
Penghitung WebSocket ESP32 (2 Tombol + LCD + Web Real-Time)
ES-28Mahir
Premium

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().

4.5(14)
23
Pembaruan OTA ESP32: Instal Firmware Tanpa Kabel (dengan Layar LCD)
ES-30Mahir
Premium

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.

4.6(14)
22
Jam Real-Time dari Internet lewat NTP ESP32
ES-26Mahir
Premium

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.

4.5(13)
22
HTTPClient + API Cuaca ESP32 (dengan Layar LCD)
ES-31Mahir
Premium

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.

4.7(13)
20
Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)
ES-41Mahir
Premium

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.

9