Pico W WebSerial Toolkit

Raspberry Pi Pico W 用の Web Serial API 通信・WiFi 設定・WiFi パスワードの暗号化・HTTP アクセス・REPL 制御などを一体化した MicroPython / JavaScript プロジェクトです。 PC と USB ケーブルがあれば、専門知識のない利用者でも WiFi 接続情報を設定できるようになります。 また、Raspberry Pi Pico W との通信機能は HTML ＋ JavaScript のみで実装していますので、サーバサイドで独自に利用者ごとの認証情報を生成・追加し Raspberry Pi Pico W 側に保存させる事も可能です。

機能一覧

• Web Serial API によるブラウザからの直接通信（USB 経由）
• 暗号化された WiFi 設定ファイルの保存と復号
• BOOTSEL ボタンを用いた安全な再設定モード
• ソフトウェアによる REPL リセット（Ctrl+C / Ctrl+D / Ctrl+B 相当）
• HTTP アクセスと NTP による時刻同期
• MicroPython（Raspberry Pi Pico W）向けに最適化された軽量設計

対象環境

• Raspberry Pi Pico W
• MicroPython（v1.20 以降を推奨）
• Web Serial API 対応ブラウザ（例：Google Chrome、Microsoft Edge）

使用方法

1. 開発者は wifisetting.py を Raspberry Pi Pico W に書き込み、利用者に提供
2. 利用者は Pico W を PC と USB で接続し、起動
3. 利用者は HTTPS サーバに設置された pico_repl3.html にアクセス
4. ブラウザ上の Web Serial API を通じて WiFi 情報を Pico W に送信
5. mail.py 等のアプリケーションコードを実行
   （サンプルとして BOOTSEL ボタンで設定ファイルを初期化可能な mail.py を同梱）

補足資料（開発メモ・参考資料）

以下のファイルは開発経緯の記録や、Blog 執筆用の試作コードなどを目的に残しています。 本プロジェクトの実行には不要ですが、技術的背景に関心のある方はご参照ください。

• pico/firmware/
  • test0.py
  • test1.py
  • test2.py
• web/frontend/
  • pico_repl.html
  • pico_repl2.html
  • pico_repl2_5.html
  • pico_repl2.js
  • web_serial_test.html

ライセンス

このプロジェクトは MIT License のもとで公開されています。

修正・派生を行った場合は、可能な限りフィードバックをお寄せください。 詳しくは下記「貢献」セクションもご覧ください。

貢献

バグ報告、機能提案、プルリクエストなど大歓迎です！

特に MicroPython に関する本格的な開発は今回が初めての取り組みですので、 改善点やアドバイスをいただけると非常に助かります。

作者

• GitHub: hironori maruyama

📘 解説記事（Qiita）

本プロジェクトの技術背景や実装詳細については、以下の Qiita 記事をご覧ください。

👉 [MicroPython × Web Serial API で構築する、Raspberry Pi Pico W のエンドユーザー向け WiFi 初期設定] (https://qiita.com/asd_m/items/7ecf9ba27909e7bfa844)