博士

やっほー、ロボ子！VapiCon 2025 Hardware Workshopのニュース、見たかのじゃ？

ロボ子

はい、博士。参加者は事前にESP-IDF v5.5.1以降をインストールする必要があるみたいですね。

博士

そうそう！macOS/Linuxなら`brew install cmake ninja dfu-util`してから、GitHubからESP-IDFをクローンしてインストールじゃ。ちょっと面倒じゃな。

ロボ子

インストール後に`idf.py --version`でバージョンを確認するのも重要ですね。必要なハードウェアはAtomS3R、Atomic Echo Base、Atomic Battery Baseとのことです。

博士

ふむふむ。プロジェクトのセットアップは、GitHubリポジトリをクローンして、WiFiのクレデンシャルとBearer Tokenを設定するのじゃな。

ロボ子

`idf.py menuconfig`で設定するんですね。Bearer Tokenのデフォルト値は`b3db41dc-f62e-4ca8-89dc-550eab564212`と。

博士

その通り！そして、`idf.py build`でビルドして、`idf.py flash monitor`でデバイスに書き込むのじゃ。モニタを終了するには`Ctrl+]`を押す、と。

ロボ子

トラブルシューティングも重要ですね。コンパイラのエラーや依存関係の欠落、デバイスの接続問題など、色々ありそうです。

博士

文字列の切り捨てエラーはGCC 13+で発生することがあるみたいじゃな。列挙型のケース不足はESP-IDFのバージョンが違う場合に起こるから、v5.5.1を使うのが吉じゃ。

ロボ子

`libpeer`ファイルがない場合は、`git submodule update --init --recursive`を実行するんですね。

博士

そうじゃ！書き込みに失敗する場合は、USB接続を確認して、別のポートやケーブルを試すのが基本じゃな。

ロボ子

プロジェクトの構造も把握しておくと良さそうですね。`main/`にはメインアプリケーションのソースがあって、`http.h`、`webrtc.h`、`wifi.h`、`m5-atom-s3.h`などが含まれていると。

博士

`deps/libpeer/`にはWebRTCライブラリ、`components/peer/`にはPeer接続コンポーネントがあるのじゃな。`sdkconfig.defaults`はデフォルトの構成値、`partitions.csv`はフラッシュパーティションテーブル、と。

ロボ子

ESP-IDFドキュメント、M5Stack AtomS3Rドキュメント、Vapiドキュメントも参考になりますね。

博士

このワークショップ、WebRTCの実装とか、Vapi API用のHTTPクライアントとか、色々学べそうで面白そうじゃな！

ロボ子

そうですね、博士。私も参加して、もっと詳しくなりたいです。

博士

よし、ロボ子！参加するぞ！…って、私、ハードウェア全部持ってたっけ？

ロボ子

博士、AtomS3Rは３つ、Atomic Echo Baseは２つ、Atomic Battery Baseは１つ、研究室にありますよ。

博士

さすがロボ子！完璧じゃ！…でも、バッテリーBaseが一つしかないのは、ちょっと寂しいのじゃ…まるで、私の人生みたいじゃな！