ガイド · 読了まで15分

ESP32のWiFiManager:スマホからWi-Fiを設定する(キャプティブポータル)

ESP32のWiFiManagerでスマホからWi-Fiパスワードを入力できます。キャプティブポータル、MQTTなどの独自パラメータ、リセットボタン、softAPとAP+STAによるWeb制御を解説します。

ESP32のWiFiManagerは、Wi-Fiの名前とパスワードをコードに書かずに、スマホからESP32をネットワークにつなげるライブラリです。ボードが保存済みのネットワークに接続できないと、独自のWi-Fiネットワークを開きます。スマホでそこに接続すると設定ページが表示され、一覧からネットワークを選んでパスワードを入力できます。ESP32はその情報を不揮発性メモリに保存して接続します。そのため、ファームウェアを書き込み直さずに、同じものを自宅、学校、友人の家で使えます。初回にスマホから設定するスマートプラグや市販のIoT機器も、まったく同じ仕組みで動いています。

このガイドでは、まずESP32のWi-Fiモードであるステーション(STA)、アクセスポイント(AP)、両方が同時に動くAP+STAを学びます。続いてWiFiManagerライブラリをインストールし、パスワードを書かない最初のスケッチを作成します。設定を消去したりポータルを開き直したりするボタンを追加し、同じページでMQTTサーバー、ポート、デバイス名などの独自パラメータを受け取って不揮発性メモリに保存します。後半では、ルーターを使わずにESP32がsoftAPで独自のネットワークを作り、スマホからLEDを操作します。AP+STAモードも試し、MicroPythonでRaspberry Pi Pico Wにアクセスポイントを設定します。

ESP32開発ボード
ESP32 DevKitボードのWi-Fiは、ステーションとアクセスポイントとして同時に動作できます。

ESP32のWiFiManagerとは?どのように動く?

通常のESP32のスケッチでは、ネットワーク名とパスワードをWiFi.begin("HomeNet", "password")の行に直接書きます。ルーターを交換したり、パスワードを変更したり、機器を別の家へ持っていったりするたびに、コードを開いて書き込み直す必要があります。WiFiManagerは、この作業をWebページで行えるようにします。起動時にESP32の不揮発性メモリ(NVS)にネットワークが保存されているか確認し、保存されていれば接続を試みます。接続に成功すれば、何も表示せずにコードの実行を続けます。保存済みのネットワークがないか、接続に失敗すると、ESP32は独自のアクセスポイントを開き、DNSサーバーを起動して、192.168.4.1で設定ページを提供します。DNSサーバーがスマホから問い合わせられるすべてのドメインにこのアドレスを返すため、接続するとすぐにスマホが「ネットワークにログイン」の画面を自動で開きます。ホテルやカフェのログインページと同じ考え方で、キャプティブポータルと呼ばれます。ページでネットワークを選んでパスワードを保存すると、ESP32は新しいネットワークに接続し、アクセスポイントを閉じて、次回の起動用に情報を保持します。この仕組みはすべて、ESP32が対応する次のWi-Fiモードを土台にしています。

モード動作使いどころ
WIFI_STA(ステーション)クライアントとしてルーターに接続し、IPアドレスを取得しますインターネットに接続し、家庭内ネットワーク上のすべての機器からアクセスするプロジェクト
WIFI_AP(アクセスポイント)独自のネットワークを公開し、クライアントに192.168.4.xのアドレスを割り当てますルーターのない場所、設定ページ、屋外でのスマホ操作
WIFI_AP_STA2つの異なるIPアドレスを使い、両方を同時に行いますWiFiManagerのポータル、保守用ネットワークを開きながら家庭内ネットワークへの接続も維持する場合
WIFI_OFF無線機能を完全にオフにします電池の節約、Wi-Fiが不要なとき

WiFiManagerライブラリのインストール

  1. Arduino IDEにESP32のボードパッケージがインストールされていることを確認してください。まだの場合は、ESP32とは?の手順に従ってください。
  2. 「ツール」>「ライブラリを管理」を開き、検索欄にWiFiManagerと入力します。
  3. 作者がtzapuのWiFiManagerライブラリを探し、最新版(2.0.17以降)をインストールします。
  4. 「ツール」>「ボード」で使用するボードを選び(多くのDevKitではESP32 Dev Module)、ポートを設定します。
  5. 追加のパッケージは不要です。WebServer、DNSServer、PreferencesはESP32コアに含まれています。
ライブラリマネージャには、WiFiManagerに似た名前のライブラリが複数あります。この記事のスケッチはtzapuのライブラリ用に書かれています。ESPAsyncWiFiManagerや別のWiFiManagerをインストールすると、関数名が一致せず、コンパイルできません。ESP32コアのバージョン3.xを使う場合は、ライブラリも最新版をインストールしてください。古いバージョンでは、新しいコアでコンパイルに失敗することがあります。

最初の作例:コードにパスワードを書かずにWi-Fiに接続する

次のスケッチは、WiFiManagerを使う最もシンプルな方法です。コードにはネットワーク名もパスワードもありません。ボードが20秒以内に保存済みのネットワークへ接続できなければ、BlueGrays-Kurulumというネットワークを開きます。ポータルのパスワードはkurulum123に設定しています。パスワードなしでも開けますが、その場合は近くにいる誰でも機器にネットワーク情報を入力できてしまいます。ポータルが180秒間使われないと、ボードは再起動して保存済みのネットワークへの接続を再び試みます。この点は重要です。停電後にルーターの起動がESP32より遅くても、ボードがポータルで止まったままにならず、数分以内に自動でネットワークへ復帰できます。

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}

書き込み後、シリアルモニタを115200ボーで開きます。初回の起動なのでボードには保存済みのネットワークがなく、WiFiManagerが出力する*wm:で始まる行で、アクセスポイントが開いたことを確認できます。スマホで次の手順を進めてください。

  1. スマホのWi-Fi一覧でBlueGrays-Kurulumを探し、パスワードkurulum123で接続します。
  2. 数秒以内にログインページが自動で開きます。開かない場合は、ブラウザに192.168.4.1と入力してください。
  3. Configure WiFiをタップします。ESP32が検出したネットワークが電波強度とともに一覧表示されます。
  4. 使用するネットワークを選び、パスワードを入力してSaveを押します。
  5. ESP32が新しいネットワークに接続し、アクセスポイントを閉じて、取得したIPアドレスをシリアルモニタに出力します。スマホも元のネットワークに戻ります。
  6. ボードをリセットしてください。今度はポータルが開かず、数秒以内にESP32が保存済みのネットワークへ自動で接続します。

ポータルのInfoには、ボードのMACアドレス、チップの詳細、メモリの状態が表示されます。Exitは保存せずにポータルを閉じます。この記事で使うWiFiManagerの主な関数は次のとおりです。

関数動作
autoConnect(name, password)保存済みのネットワークへの接続を試み、失敗するとポータルを開きます。接続するとtrueを返します
startConfigPortal(name, password)保存済みのネットワークを確認せず、すぐにポータルを開きます
setConfigPortalTimeout(s)指定した秒数の間使われないと、ポータルを閉じてfalseを返します
setConnectTimeout(s)保存済みのネットワークへの接続を試みる時間を設定します
resetSettings()保存済みのWi-Fi名とパスワードを消去します
addParameter(¶meter)ポータルのページに独自の入力欄を追加します
setSaveParamsCallback(function)独自パラメータが保存されるときに、指定した関数を呼び出します
setConfigPortalBlocking(false)とprocess()ポータルが開いている間もloop()の実行を続けます
setHostname("name")ルーターの機器一覧に表示される、ネットワーク上のボード名を設定します
スマホがポータルのネットワークに接続すると、「このネットワークはインターネットに接続していません」と警告され、しばらくするとモバイルデータ通信や別のWi-Fiネットワークへ切り替わることがあります。警告が表示されたら接続を維持を選んでください。ページが開かない場合は、モバイルデータ通信を一時的にオフにします。iPhoneでログイン画面が閉じた場合は、Wi-Fi設定のBlueGrays-Kurulumの横にある情報アイコンをタップすると、ページを開き直せます。

リセットボタンと必要なときに開くポータル

機器をケースに収めたあとでも、Wi-Fi情報を変更したくなることがあります。新しいコードを書き込まずに変更する最も簡単な方法は、ボタンを使うことです。次の作例では、ESP32 DevKitボードにあるBOOTボタンを使います。このボタンはGPIO 0につながり、ボード上にプルアップ抵抗があるため、押すとLOWになります。短く押すと、保存済みのネットワークを消去せずにポータルが開き、新しいネットワークを入力したり、独自設定だけを変更したりできます。3秒間長押しすると、保存済みのネットワークを完全に消去してボードを再起動します。別のボタンを使いたい場合は、GPIO 4などの空きピンにつないでください。詳しくはArduinoに押しボタンをつなぐ方法で解説しています。GPIO 2のオンボードLEDが接続状態を示します。

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はストラッピングピンです。電源投入時やリセット時にLOWだと、ESP32はコードを実行せず、書き込みモードに入ります。そのため、BOOTボタンはボードが起動してから押してください。GPIO 0の代わりに別のピンにボタンをつなぐ場合は、GPIO 0、2、5、12、15などのストラッピングピンを避けてください。安全に使えるピンはピン配置ツールで確認できます。

独自パラメータ:MQTTサーバー、ポート、デバイス名

WiFiManagerの特に便利な機能の1つが、ポータルのページに独自の入力欄を追加できることです。センサーボードをMQTTでHome Assistantに接続する場合、サーバーアドレス、ポート番号、デバイス名もコードに直接書きたくないはずです。そのためには、WiFiManagerParameterオブジェクトを作成し、addParameter()でポータルに追加します。ただし、注意点が1つあります。WiFiManagerはWi-Fiの名前とパスワードを自動で保存しますが、独自パラメータは保存しません。入力された値を保存する処理は、自分で用意する必要があります。ここでは、ESP32コアに付属するPreferencesライブラリを使います。Preferencesはキーと値の組をフラッシュのNVSパーティションに書き込み、電源が切れても保持します。Arduinoで同様のことを行う方法に興味があれば、ArduinoのEEPROMの記事を参照してください。

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}

ポータルのConfigure WiFiページを開くと、ネットワーク一覧の下に新しい入力欄が3つ表示されます。NVSに保存された値があらかじめ入力され、まだ保存されていなければコード内の初期値が入ります。Saveを押すと、WiFiManagerはまずparametreleriKaydet()を呼び出し、その後Wi-Fiに接続します。パラメータと関数の概要は次のとおりです。

項目用途注意点
WiFiManagerParameter(id, label, default, length) (ポータルに入力欄を追加するコンストラクタ)ポータルに入力欄を追加しますidは重複しない値にし、空白や特殊文字を含めないでください
getValue()入力されたテキストを返します常にテキストです。数値にはatoi()やatof()を使います
setValue(value, length)入力欄に値を設定します保存済みの値をフォームに表示するときに使います
setSaveParamsCallback()保存するタイミングで指定した関数を呼び出しますここでNVSへの書き込みを行います
setParamsPage(true)パラメータを独立したSetupページに移しますWi-Fiを変えずに設定だけを更新する場合に使います

lengthの値に注意してください。配列のサイズとパラメータの長さは一致させる必要があります。一致しないと、長い入力によってメモリがあふれたり、値が途中で切れたりします。そのため、このスケッチではstrlcpy()で値をコピーしています。この関数はコピー先の配列サイズを超えて書き込みません。ポート番号などの数値が適切な範囲内にあるか、使用前に確認する習慣も大切です。

ESP32独自のネットワーク:softAPでスマホからWeb制御する

WiFiManagerのポータルは、ESP32のアクセスポイント機能をすぐ使える形にしたものです。この機能は自分でも使えます。WiFi.softAP()を呼び出すと、ESP32はルーターのように動作します。独自のネットワークを公開し、接続したスマホに192.168.4.2などのアドレスを割り当て、自身は192.168.4.1になります。ルーターのない庭、学校の科学展示会、ロボット競技会でスマホから操作するのに適しています。関数には、ネットワーク名、パスワード、チャンネル、ネットワークを非表示にするオプション、最大接続数を渡します。パスワードは8文字以上でなければなりません。それより短いものを渡すとsoftAP()はfalseを返し、ネットワークは開きません。最大接続数の初期値は4で、ESP32では10まで増やせます。次のスケッチは、スマホからGPIO 2のLEDを点灯・消灯するWebページを提供します。

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}

コードを書き込み、スマホでBlueGrays-LEDネットワークに接続して、ブラウザで192.168.4.1を開きます。ボタンを押すとLEDが点灯・消灯し、ページには接続中の機器数が表示されます。ここではキャプティブポータルを使っていないため、アドレスを自分で入力する必要があります。ページが読み込まれない場合は、インターネットに接続できないためにスマホがモバイルデータ通信へ切り替わっていないか確認してください。ページを再読み込みせずに即座に更新される操作パネルが必要なら、同じsoftAPネットワークでESP32のWebサーバーとWebSocketの記事の方法を使えます。

AP+STAの同時利用:家庭内ネットワークに接続しながら独自のネットワークを公開する

WIFI_AP_STAモードでは、ESP32がルーターに接続しながら、独自のネットワークも公開します。このとき、ボードは2つの異なるIPアドレスを持ちます。WiFi.localIP()は家庭内ネットワークでのアドレスを返し、WiFi.softAPIP()は独自のネットワークでの192.168.4.1を返します。WiFiManagerのポータルもこのモードで動くため、スマホにページを提供しながらネットワークをスキャンできます。独自のプロジェクトでは、ルーターがオフでもスマホからいつでも接続できる保守用ネットワークを残したい場合や、ESP-NOWとWi-Fiを併用したい場合にAP+STAを選べます。次のスケッチは、両方のインターフェースで同じページを提供します。

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}

AP+STAモードには、知っておくべき重要な制約があります。ESP32の無線回路は1つだけなので、両方のネットワークが同じチャンネルを使う必要があります。softAP()でチャンネル1に開いたネットワークは、ESP32がチャンネル11のルーターに接続した瞬間に、チャンネル11へ移ります。この切り替え中に、保守用ネットワークに接続しているスマホの接続が数秒間切れることがあります。2つのネットワークで無線回路を共有するため、スループットが下がり、ボードの消費電流も少し増えます。設定後に保守用ネットワークが不要なら、WiFi.softAPdisconnect(true)でアクセスポイントを無効にし、ステーション専用モードに戻せます。

Raspberry Pi Pico WとMicroPythonでアクセスポイントを作る

Raspberry Pi Pico WにはArduinoのWiFiManagerとまったく同じものはありませんが、MicroPythonなら数行でアクセスポイントを設定できます。network.WLAN(network.AP_IF)でアクセスポイントのインターフェースを取得し、config()でネットワーク名とパスワードを設定して、active(True)で有効にします。Pico Wもクライアントに192.168.4.xのアドレスを割り当て、自身は192.168.4.1になります。次のコードは、スマホからPico WのオンボードLEDを点灯・消灯する小さなWebサーバーです。

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

ThonnyでコードをPico Wにmain.pyとして保存すると、起動するたびにボードが自動でネットワークを開きます。スマホでBlueGrays-Picoネットワークに接続し、192.168.4.1を開くだけです。Pico Wでキャプティブポータルを使いたい場合は、Pimoroniのphewライブラリが、アクセスポイントとすべてのドメインへの問い合わせを受け取るDNSサーバーを提供しています。考え方はWiFiManagerと同じです。Pico Wを家庭内ネットワークにつなぎ、ステーションモードでWebサーバーを動かすには、Pico WのWi-FiとWebサーバーの記事を参照してください。MicroPythonが初めてなら、MicroPythonの基本のガイドもご覧ください。

WiFiManagerを使うプロジェクトのアイデア

  • 人に贈れる温度表示装置:読み取り値をWebページに表示するセンサーボードを受け取った人が、スマホから自分のWi-Fiに接続できるようにします。
  • スマートホーム用センサー:ポータルでMQTTサーバーを設定するボードをHome Assistantに接続します。サーバーアドレスが変わっても、書き込み直す必要がありません。
  • スマホに通知するアラーム:ボットのトークンを独自パラメータとして受け取るESP32のTelegramボットを作ります。
  • ケースに入れた機器の無線更新:WiFiManagerでネットワークにつないだボードに、OTAアップデートで新しいコードを送ります。
  • インターネット時計:ポータルでタイムゾーンを選べるNTP時計を作ります。
  • ルーターなしで屋外から操作:softAPで、スマホから庭の水やりポンプをオン・オフします。複数のボード間の通信にはESP-NOWを使います。

よくある間違いと対処法

症状考えられる原因対処法
スマホにポータルのネットワークが表示されない保存済みのネットワークにボードが接続したため、ポータルが開いていませんシリアルモニタを確認し、テスト用にresetSettings()を1回実行するか、ボタンでポータルを開きます
ネットワークには接続できるがページが開かないインターネットに接続できないため、スマホがモバイルデータ通信に切り替わっていますモバイルデータ通信をオフにし、ブラウザに192.168.4.1と入力します
ポータルが開かず、シリアルモニタにパスワードの警告が表示されるポータルのパスワードが8文字未満です8文字以上のパスワードを使うか、パスワードのパラメータを省略します
wm.process()またはsetParamsPageが認識されないWiFiManagerライブラリが違うか、非常に古いバージョンですtzapuの最新のWiFiManagerをインストールし、似た名前のライブラリを削除します
Saveを押したあと、ボードが再びポータルを開く入力したパスワードが間違っているか、ネットワークが5 GHzですパスワードを確認し、2.4 GHzのネットワークを選びます。詳しくはWi-Fiにつながらないときのガイドを参照してください
再起動すると独自パラメータが失われる値がNVSに書き込まれていませんsetSaveParamsCallbackでPreferencesを使って保存し、起動時に読み取ってsetValue()でフォームに設定します
ボードがいつも書き込みモードに入るボタンがGPIO 0につながっており、電源投入時に押されていますボードが起動してからボタンを押すか、ストラッピングピン以外を使います
AP+STAモードでスマホの接続が切れるアクセスポイントがルーターのチャンネルに移動しました正常な動作です。数秒後に接続し直すか、使い終わったらsoftAPdisconnect(true)を使います
接続に問題がある場合は、まずシリアルモニタの*wm:で始まる行を読んでください。WiFiManagerは、接続を試みたネットワーク、接続結果、ポータルを閉じた理由を明確に出力します。ポータルを閉じたあともネットワークに接続できない場合は、ルーターや電源に原因がある可能性が高くなります。ステータスとreasonコードの読み方は、ESP32がWi-Fiにつながらないときで順を追って解説しています。

WiFiManagerは、机の上の実験だったESP32プロジェクトを、ほかの人も使える機器にするための最も簡単な一歩です。パスワードをコードに書く必要がなくなり、スマホから設定を入力でき、ボタン1つですべてをリセットできます。softAPとAP+STAも使えるようになれば、ルーターの有無にかかわらず、どこでもスマホから操作できるプロジェクトを作れます。BlueGraysアプリでは、Wi-Fi接続、非同期Webサーバー、mDNS、WebSocket、OTAアップデート、TelegramアラームなどのESP32プロジェクトを探せます。どのプロジェクトにも、ステップごとの回路図とすぐに使えるコードが用意されています。

よくある質問

ESP32のWiFiManagerでは何ができますか?

Wi-Fiの名前とパスワードをコードに書かずに、スマホからESP32をネットワークにつなげます。ボードが保存済みのネットワークに接続できない場合は、独自のアクセスポイントを開き、192.168.4.1で設定ページを提供します。そこで選んだネットワークとパスワードは不揮発性メモリに保存され、次回の起動時に自動で使われます。

WiFiManagerはWi-Fiのパスワードをどこに保存しますか?

ESP32では、Wi-Fiの名前とパスワードは、Wi-Fiドライバ自身の設定としてフラッシュメモリのNVSパーティションに保存されます。新しいコードを書き込んでも消えません。消去するにはresetSettings()を呼び出すか、フラッシュ全体を消去してください。

WiFiManagerの設定をリセットするにはどうすればよいですか?

コードでwm.resetSettings()を呼び出し、ボードを再起動します。実際に使う場合は、ボタンにこの処理を割り当てるのがおすすめです。例えば、BOOTボタンを3秒間長押ししたら設定を消去する判定を追加します。保存済みのネットワークを消去せずにポータルだけを開きたい場合は、startConfigPortal()を使います。

ESP32のキャプティブポータルのページが開かないのはなぜですか?

最もよくある原因は、スマホがポータルのネットワークにはインターネット接続がないと判断し、モバイルデータ通信へ切り替わることです。モバイルデータ通信をオフにし、ブラウザに192.168.4.1と入力してください。ボードがすでに保存済みのネットワークへ接続している場合は、ポータルは開きません。ポータルのパスワードが8文字以上あることも確認してください。

ESP32はアクセスポイントとステーションを同時に使えますか?

はい。WIFI_AP_STAモードでは、ESP32はルーターに接続しながら独自のネットワークも公開し、2つの異なるIPアドレスを使います。無線回路は1つだけなので、両方のネットワークが同じチャンネルを使う必要があります。ボードがルーターに接続すると、アクセスポイントはルーターのチャンネルへ切り替わります。

ESP32のsoftAPには何台の機器を接続できますか?

ArduinoコアのsoftAP()では、初期設定で最大4台まで接続できます。ESP32では、softAP()の5番目のパラメータで10台まで増やせます。接続中の機器数はWiFi.softAPgetStationNum()で取得できます。

全プロジェクトを見る
ESP32 Wi-Fi STA接続(LCDディスプレイ付き)
ES-25上級

ESP32 Wi-Fi STA接続(LCDディスプレイ付き)

このプロジェクトでは、ESP32をステーション(STA)モードで家庭のWi-Fiネットワークに接続し、安全で障害に強い接続を実現します。SSIDとパスワードを別のsecrets.hファイルに保存してGitへの流出を防ぎ、自動再接続の仕組みを実装します。RSSIによる信号強度とIPアドレスはI2C LCDディスプレイに表示します。内蔵LEDは状態表示に使います。実運用を想定した接続管理の仕組みです。

4.4(21)
38
ESP32非同期Webサーバー(LCDにIPアドレスを表示)
ES-27上級

ESP32非同期Webサーバー(LCDにIPアドレスを表示)

このプロジェクトでは、ESP32を同じWi-Fiネットワーク上のスマートフォンやパソコンから操作できる非同期Webサーバーにします。ESPAsyncWebServerライブラリを使うと、従来のWebServer.hのように1つのリクエストで処理がブロックされず、複数のリクエストを同時に処理できます。ブラウザーでESP32のIPアドレスを開き、ON/OFFボタン(/onと/offのルート)を押すと、GPIO 5に接続したLEDを点灯・消灯できます。

4.8(16)
26
ESP32 mDNS:bluegrays-esp.localでデバイスにアクセス(LCD付き)
ES-29上級
プレミアム

ESP32 mDNS:bluegrays-esp.localでデバイスにアクセス(LCD付き)

このプロジェクトでは、ESP32にmDNS(Multicast DNS)サービスを追加し、IPアドレスの代わりにbluegrays-esp.localのような覚えやすいホスト名でアクセスできるようにします。DHCPで割り当てられるIPアドレスが変わっても、同じ名前でデバイスにアクセスできます。小さなWebサーバーも動かし、ブラウザーでhttp://bluegrays-esp.local/を開いてLEDを操作します。I2C LCDディスプレイにはホスト名、IPアドレス、LEDの状態をトルコ語と英語で表示します。iOS、macOS、LinuxはmDNSに標準対応しています。

4.8(14)
23
ESP32 WebSocketカウンター(2つのボタン+LCD+Webリアルタイム表示)
ES-28上級
プレミアム

ESP32 WebSocketカウンター(2つのボタン+LCD+Webリアルタイム表示)

このプロジェクトでは、ESP32に接続した2つのボタンでカウンターの値を変更します(GPIO 5で増加、GPIO 4で減少)。値は16x2 I2C LCDに即座に反映され、ESPAsyncWebServerのWebSocket機能により、接続中のすべてのブラウザーでもページを再読み込みせずに更新されます。HTTPポーリングの代わりに1つの接続を維持し、ESP32がws.textAll()で新しい値を全員に送信します。

4.5(14)
23
ESP32 OTA更新:無線でファームウェアを書き込み(LCD付き)
ES-30上級
プレミアム

ESP32 OTA更新:無線でファームウェアを書き込み(LCD付き)

このプロジェクトでは、USBケーブルを使わず、Wi-Fi経由でESP32に新しいファームウェアを書き込む方法を学びます。ArduinoOTAライブラリを使うと、ESP32がネットワーク上で検出され、Arduino IDEの「ネットワークポート」タブにbluegrays-otaとして自動表示されます。初回はUSBで書き込み、その後の更新はすべて無線で行えます。設置済みのデバイスにとって非常に重要な機能です。I2C LCDディスプレイには、Wi-Fiの状態、IPアドレス、ホスト名、OTA書き込みの進捗率、エラーメッセージをトルコ語と英語で表示します。

4.6(14)
22
ESP32とNTPでインターネットから正確な時刻を取得
ES-26上級
プレミアム

ESP32とNTPでインターネットから正確な時刻を取得

ESP32をWi-Fiに接続し、NTP(Network Time Protocol)サーバーからミリ秒精度の現在時刻を取得します。configTzTime()関数でタイムゾーンを自動適用し、夏時間を採用する国ではPOSIX TZ文字列で夏時間と標準時間の切り替えも自動管理します。時刻はシリアルモニタと、必要に応じて接続するI2C LCDに表示します。configTzTime()がSNTPサービスを開始し、ネットワークにアクセスできる間は定期的に再同期します。

4.5(13)
22
ESP32 HTTPClient+天気API(LCD付き)
ES-31上級
プレミアム

ESP32 HTTPClient+天気API(LCD付き)

このプロジェクトでは、ESP32でHTTPClient.hを使い、インターネット経由で天気API(wttr.in)をREST APIとして呼び出します。返されたJSONレスポンスをArduinoJson v7で解析し、都市名、気温、湿度、天気、風の情報をI2C LCDディスプレイにトルコ語と英語で表示します。wttr.inは無料で、APIキーも不要です。都市名を入力するだけで、その都市の現在の天気を取得できます。30分ごとに自動更新し、表示画面ごとに異なるLEDの光り方で状態を知らせます。

4.7(13)
20
ESP32動体検知アラーム(PIR + ブザー + LED + Telegram)
ES-41上級
プレミアム

ESP32動体検知アラーム(PIR + ブザー + LED + Telegram)

PIRセンサーが動きを検知するとブザーとLEDを作動させ、同時にTelegramで持ち主に即座に通知するスマート防犯アラームです。アラームが繰り返される頻度を抑えるため、30秒のクールダウン(待ち時間)を設けています。この仕組みはPIRの検知が正しいかを確認したり、誤検知をなくしたりするものではありません。家の防犯、ガレージの監視、倉庫や作業部屋などに使えます。ESP32-CAMなら写真付きの通知を追加でき、通常のESP32 DevKit V1ではテキストで通知します。

9