ネットワーク設定説明
このページでは、小智デバイスをネットワークに接続する方法、Wi-Fi の設定方法、ネットワークを変更したいときの対処を説明します。初回の電源投入から有効化コードの入力・紐づけまでの全体の流れは、初回起動：Wi-Fi 設定、アクティベーション、バインドを参照してください。
接続方式
利用できる方式は開発ボードのハードウェアによって異なります。
- Wi-Fi：最も一般的な方式です。
- 有線イーサネットと USB RNDIS。
- Cat.1 4G モジュール：ML307、EC801E、または NT26。一部のハードウェアは Wi-Fi と 4G を切り替えられ、切り替え方法はボードごとに異なります。例えば
yunliao-s3は、起動中または設定画面で 1 秒以内にボタンをダブルクリックします。
Wi-Fi 設定方式
| 方式 | 説明 | 有効化の方法 |
|---|---|---|
| ホットスポット（既定） | デバイスが Xiaozhi-XXXX というホットスポットを開き、スマートフォンから接続して Web ページでルーターを選択します | menuconfig の WiFi Configuration Method → Hotspot（既定で有効） |
| BluFi（BLE） | デバイスの Bluetooth 名は Xiaozhi-Blufi で、EspBlufi などのクライアントから Wi-Fi 情報を送ります | ESP-BluFi を有効にして Hotspot を無効にします。詳細は BluFi 設定ガイドを参照 |
同じファームウェアで両方式を同時に有効にすることはできません。ホットスポット設定の手順は初回起動にあります。
ネットワークの要件
- 周波数帯：多くのチップは 2.4 GHz のみです。5 GHz に対応するチップ（ESP32-C5 など）は帯域を自動で選びます。
- 保存数：デバイスは最大 10 件の Wi-Fi を保存します。同じ名前のルーターが複数ある場合（メッシュネットワークなど）は、信号が最も強いものに接続します。
- 接続タイムアウト：保存済みのネットワークに 60 秒以内に接続できない場合、デバイスは設定モードに戻ります。
- ホットスポットの安全性：設定用ホットスポットはパスワードのないオープンなネットワークで、最大 4 台まで接続できます。信頼できる環境で設定してください。
再設定
Wi-Fi がすでに保存されている場合、デバイスは自動では設定モードに入りません。ネットワークを変更するには次の方法があります。
- 起動中にボードの設定ボタンを押します。ボタンはボードごとに異なります。
bread-compact-wifiは BOOT ボタンのシングルクリックです。ほかのボードはmain/boards/配下の該当ディレクトリの README を確認してください。 - 一部のボードは、
self.disp.network（「ネットワーク再設定」）という MCP ツールを提供しています。 - 古いネットワークがなくなった、またはパスワードが変わった場合は、60 秒間接続に失敗すると自動で設定モードに入ります。
詳細設定
設定ページの「詳細」タブでは、OTA の URL、Wi-Fi の送信電力、Wi-Fi のスリープモードを設定できます（OTA の URL とスリープの欄を表示するかはファームウェアが決めます）。OTA の URL は、デバイスがバージョン情報と有効化情報を問い合わせるサーバーを決めるため、信頼できるサーバーだけを指定してください。
ネットワークのトラブルシューティング
まず初回起動のトラブルシューティングを確認してください。それでも接続できない場合は次を試します。
- ルーターが 2.4 GHz を使っていること、名前とパスワードが正しいことを確認する。
- デバイスをルーターに近づけて、電波や遮蔽物の影響を切り分ける。
- デバイスのシリアルログで接続に失敗した理由を確認する。
- その他はよくある質問を参照してください。
出典：78/xiaozhi-esp32 v2.5.2 の README_ja.md、wifi_board.cc、docs/blufi.md、および設定用コンポーネント 78/esp-wifi-connect。