ESP32-S3 CSIガイド

ESP32-S3 CSI対応ガイド:設定・取得・検証方法

ESP32-S3はESP-IDFのWiFi CSI APIでChannel State Informationを取得できます。このガイドではコールバック設定、パケット文脈の保存、2.4 GHz取得の再現性検証に焦点を当てます。

ノートPCに接続したESP32-S3と動きに反応するCSI波形
フィルターや分類の前に生CSIとパケット文脈を保存します。

ESP32-S3のCSI機能はESP-IDF WiFiドライバーに含まれます。WiFi初期化後に受信コールバックを登録し、CSI設定を適用して取得を有効にします。

基板だけで完成した人体検知器になるわけではありません。安定した送信元、固定した配置、ファームウェア記録、欠損や干渉を動きと区別する検証が必要です。

ESP32-S3 CSIのESP-IDF設定フロー

動作するWiFiプロジェクトを起点に、esp_wifi_set_csi_rx_cb、esp_wifi_set_csi_config、esp_wifi_set_csi(true)を順に設定します。

コールバックは短く保ち、CSI、時刻、RSSI、チャネル、レート、送信元、シーケンスをコピーまたはキューへ入れ、保存や送信は別タスクで行います。

  • ESP32-S3は2.4 GHz WiFi用で、5/6 GHz CSIは取得できません。
  • 基板、ESP-IDF版、アンテナ、チャネル、送信元、配置を記録します。
  • フィルター前の生データを保存します。
ノートPCに接続したESP32-S3と動きに反応するCSI波形
フィルターや分類の前に生CSIとパケット文脈を保存します。

ESP32-S3はWiFi CSIに対応している?

ESP32-S3は対応するESP-IDF、WiFiモード、CSIコールバックでChannel State Informationを取得できます。チップ、フレームワーク、サンプル、受信モードを確認してください。

公式サンプルから始め、ファームウェアとチャネルを記録し、安定したパケットを確認します。

RuViewに向いたテスト手順

良い実験は空室の記録から始まります。受信機を置き、空室ベースラインを取り、入室、退室、リンクを横切る、座る、ドアを開ける、近くで呼吸するといった単純な場面を繰り返します。距離、アンテナ向き、家具、人の数、WiFiチャネルを必ずメモします。

取得後は壊れた行を除外し、時刻をそろえ、振幅と位相関連特徴を分け、ベースラインとの差を見ます。RuView型の画面では、生CSI、フィルタ後の特徴、信頼度、限界を一緒に見せることで、実験信号を医療や安全の確定判断として誤読しにくくできます。

得意なことと苦手なこと

ESP32 CSIは、空室か在室か、動きか静止か、固定部屋での反復ジェスチャーなど、狭いタスクで力を発揮します。一方、環境が頻繁に変わる、複数人が同時に動く、パケットが不規則、少ないノードで高精度な姿勢や生体信号を主張する、といった条件では信頼しにくくなります。

CSIは動画を撮らず低コストで試せる点が強みですが、マルチパスの解釈は難しく、校正と正解データが必要です。RuViewはこの前提を隠さず、デモ、GitHub、ハードウェア説明、検証上の注意を同じ文脈で示すべきです。

再現性のある RuView テスト向け ESP32 CSI チェックリスト

ESP32 CSI 実験は、取得条件が再現できないと失敗しやすくなります。モデル比較の前に、ボード、firmware、Wi-Fi チャンネル、アンテナ位置、packet rate、部屋、ラベル手順を固定します。

最初の記録には、空室、入室、静止、リンクを横切る動き、人がいないドアの動き、通常のルーター通信を含めます。

参考資料とリポジトリ

ESP32-S3 CSI よくある質問

ESP32 CSI を RuView と使う前に何を記録すべきですか?

ボード、firmware、Wi-Fi チャンネル、アンテナ位置、packet rate、部屋、シナリオラベル、空室 baseline を記録してから比較します。

最初に ESP32-CSI-Tool と Espressif ESP-CSI のどちらを使うべきですか?

手元のボードとドキュメントの読みやすさに合う方を選びます。ESP32-CSI-Tool はシリアル取得と短い実験に向き、Espressif ESP-CSI は公式ソリューションに近い経路です。どちらでも、モデル化前に時刻、チャネル、ベースライン試行を検証してください。

ESP32-S3はWiFiセンシング用CSIに対応していますか?

対応設定では取得できます。フレームワーク、WiFiモード、コールバック、チャネル、リポジトリを確認してください。