はじめに

前回（#3 RGB LED編）でハードウェア側の動作確認がすべて完了しました。

今回から通信系に入ります。まずは Wi-Fi 接続です。

やることは単純で、Wi-Fi に繋いで IP アドレスをシリアルモニタに表示するだけ。

……のはずが、シリアルモニタに何も表示されないという問題にぶつかりました。

環境

項目	内容
ボード	ESP32-S3-DevKitC-1-N8R8
IDE	Arduino IDE 2.x
ライブラリ	WiFi.h（ESP32標準）

パスワードは secrets.h に分ける

Wi-Fi の SSID とパスワードをコードに直接書くのは危険です。GitHub に上げた瞬間に流出します。

別ファイル secrets.h に分離します。スケッチと同じフォルダに作成してください。

// secrets.h
#define SECRET_SSID "自分のWi-Fi名"
#define SECRET_PASSWORD "自分のWi-Fiパスワード"

そして .gitignore に必ず追加します。

secrets.h
.DS_Store

注意：.gitignore は先頭にドットが必要です。

私は以前これを gitignore と書いてしまい、機能せずに secrets.h を GitHub に上げてしまいました。ファイル名は正確に。

また、.gitignore は secrets.h を作る前に用意するのが鉄則です。Git は一度追跡を始めたファイルを、後から .gitignore に書いても無視してくれません。

コード

#include <WiFi.h>
#include "secrets.h"

const char* ssid = SECRET_SSID;
const char* password = SECRET_PASSWORD;

void setup() {
  Serial.begin(115200);
  delay(1000);

  WiFi.begin(ssid, password);
  Serial.print("接続中");

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println();
  Serial.println("Wi-Fi接続成功!");
  Serial.print("IPアドレス: ");
  Serial.println(WiFi.localIP());
}

void loop() {
}

while ループで、接続が完了するまで 0.5 秒ごとにドットを表示しながら待ちます。

つまずき① ライブラリ名のタイポ

書き込もうとしたらエラーが出ました。

fatal error: Wi-Fi.h: No such file or directory
    1 | #include <Wi-Fi.h>

原因は単純で、ハイフンを入れてしまっていたことです。

#include <Wi-Fi.h>   // ❌
#include <WiFi.h>    // ⭕️

日本語だと「Wi-Fi」とハイフン付きで書くので、つい癖で入れてしまいました。プログラム上は WiFi（ハイフンなし、F は大文字）です。

フォルダ名は 05_Wi-Fi_Test のようにハイフンありでも問題ありませんが、#include の中身は正確でなければいけません。

つまずき② シリアルモニタに何も表示されない

タイポを直して書き込みは成功。シリアルモニタを開きました。

しかし、何も表示されません。

真っ白のまま、ドットの1つも出てきません。

コード自体はシンプルなので、間違っているようには見えませんでした。「これは設定の問題だろうな」とは思ったのですが、何をどう直せばいいのか分からず、結局 AI に聞いて解決しました。

原因：setup() の出力は一瞬で流れる

ESP32 は電源が入った瞬間、あるいは書き込み直後に setup() を実行します。

今回のコードは、出力がすべて setup() の中にあります。

void setup() {
  Serial.println("Wi-Fi接続成功!");   // ここで出力
  Serial.println(WiFi.localIP());
}

void loop() {
  // 空っぽ
}

つまり 起動直後の数秒間しか出力されません。

シリアルモニタを開くのが少しでも遅れると、その出力は流れ去ってしまいます。loop() が空なので、二度と表示されることはありません。

解決：リセットボタンを押す

シリアルモニタを開いた状態で、ボード上の RST（リセット）ボタンを押す。

これだけです。

リセットすると setup() が最初から実行され、今度はシリアルモニタが開いているので出力が見えます。

接続中.....
Wi-Fi接続成功!
IPアドレス: 192.168.1.42

表示された瞬間は素直に嬉しかったです。

他に確認すべきこと

リセットで解決しない場合は、以下も確認してください。

① ボーレートが 115200 か

シリアルモニタ右下のドロップダウンを確認します。コード側の Serial.begin(115200) と一致していないと、文字化けするか何も出ません。

② USB CDC On Boot の設定

ツール メニューにある項目です。ESP32-S3 は USB 端子が2つあり、どちらに挿しているかで適切な設定が変わります。

挿している端子	推奨設定
UART側	Disabled
USB側	Enabled

私は UART 側を使っているので Disabled のままで動きました。

③ delay を入れる

void setup() {
  Serial.begin(115200);
  delay(1000);   // シリアルの準備を待つ
  ...
}

Serial.begin() の直後は通信が安定していないことがあります。1秒待つと確実です。

根本的な対策：loop() でも出力する

毎回リセットを押すのが面倒なら、loop() の中で定期的に状態を出力する手もあります。

void loop() {
  Serial.print("IPアドレス: ");
  Serial.println(WiFi.localIP());
  delay(5000);
}

デバッグ中はこうしておくと、いつシリアルモニタを開いても状況が分かります。

まとめ

症状	原因	対処
`Wi-Fi.h: No such file`	ハイフンを入れた	`WiFi.h` に修正
シリアルモニタが真っ白	setup()の出力を見逃した	RSTボタンを押す

学んだこと

① タイポは日本語の癖から生まれる

「Wi-Fi」という日本語表記が染み付いていると、WiFi と書くべき場面でハイフンを入れてしまいます。エラーメッセージをよく読めば Wi-Fi.h と書かれているので、すぐ気づけるはずでした。

② 「動かない」には表示されていないだけの場合がある

プログラムは正しく動いていて、Wi-Fi にも繋がっていました。ただそれを見る手段の問題だった、というオチです。

「動いていない」と「見えていない」は別物だと学びました。

③ 分からないときは聞く

設定の問題だろうと当たりはついていましたが、具体的な原因までは辿り着けませんでした。1人で30分悩むより、聞いて5分で解決して次に進む方が結果的に学べます。

これで ESP32-S3 がネットワークに繋がりました。

次回はこの Wi-Fi を使って、ブラウザから CO2 データを見られる Web サーバーを立てます。