Wi-Fi CSI キャリブレーションは、受信機固有の信号を文書化された基準値に変え、別セッションとの比較を可能にします。空室での平均とばらつき、位相オフセット、パケットレート、アンテナの組み合わせ、鮮度や信頼性の状態などを記録します。これは魔法のフィルターではなく、新しい部屋でも人・ジェスチャー・バイタルサインの推定が通用する保証でもありません。
このページは、取得と特徴量抽出の間にある実務を扱います。ESP32 ガイドでは CSI の取得方法を、特徴量抽出ガイドでは整えた窓の要約方法を説明しています。ここで問うのは、実験前に何を測り、何を保存し、古い基準値をどう見つけ、モデルが信号を使う前にどんな証拠を求めるかです。
安全な流れは、状態を定義した空室または静穏期間から始まり、生データと整形済みデータを分けて保持し、不確かさを表示します。部屋、無線チェーン、Wi-Fi チャネル、ファームウェア、パケットレート、家具、アンテナ位置が変わったら、古いキャリブレーションを黙って再利用せず、仮説として確認します。
Wi-Fi CSI キャリブレーション:一つの流れで答える
実用的な Wi-Fi CSI キャリブレーションの出力は五つあります。取得契約、静穏期間の基準値、サニタイズ済みの振幅・位相配列、版管理されたキャリブレーション状態、そして検証レポートです。まずメタデータを記録します。次に十分な静穏サンプルで通常の変動を推定し、既知の受信機アーティファクトを除き、管理したイベントを静穏状態と比較し、後段の処理に使える成熟度かを記録します。
静かという言葉は完全な無音を意味しません。対象の状態が定義され、繰り返せる期間という意味です。運用中も回るファンなら、ファンがある部屋を基準にして構いません。キャリブレーションの途中で家具が変わる部屋は安定した基準になりません。基準値は検出器が動く状態を表す必要があります。
- すべてのファイルにボード、ファームウェア、Wi-Fi チャネル、帯域幅、アンテナ対、パケットレート、サブキャリア配置、時刻規則を添えます。
- 陽性例を取る前に静穏期間を記録し、後で確認できるようサンプルを残します。
- 生 CSI、サニタイズ済み CSI、パラメータ、成熟度または信頼性フラグを別フィールドに保存します。
- 信号が基準値と一致しなくなったら、unknown または再キャリブレーション要求を表示します。
キャリブレーションの基準値に必要な情報
基準値は振幅の平均一つではありません。リンクまたはアンテナ対、チャネルと帯域幅、サブキャリアのインデックス、サンプルレート、取得時間、部屋の状態、各統計値を作った変換を識別できなければなりません。どの受信機で作った記録か分からない数値は、ボード交換やファームウェア更新後に解釈しにくくなります。
選んだ各サブキャリアでは、頑健な中心とばらつきが分かりやすい出発点になります。中央値と中央値絶対偏差は、短いスパイクの影響を平均と標準偏差より受けにくいことがあります。重要なのは手法の名前より、生サンプル、パラメータ、欠損値の扱いを残し、後から計算を再現できることです。
基準値の成熟度は明示します。開始直後のストリームは変動を推定する静穏サンプルが少ないかもしれません。成熟したストリームでも、パケット欠損、サンプル周波数、分布が変われば古くなります。成熟度はノートに隠すコメントではなく、後段のコードが読む状態にします。
| 記録 | 最低限のフィールド | 意味 | 欠けた場合の失敗 |
|---|---|---|---|
| 取得契約 | ボード、ファームウェア、チャネル、帯域幅、アンテナ、レート | 比較できる範囲を決める | 無線やリンクの変更が動きに見える |
| 静穏基準値 | 窓、中心、ばらつき、サンプル数、部屋の状態 | 通常の変動を決める | しきい値が恣意的になる |
| キャリブレーション状態 | 版、パラメータ、時刻、成熟度、信頼性 | 再開と監査ができる | 古い状態を黙って再利用する |
| 検証記録 | 管理イベント、陰性対照、別セッション | 基準値以外への転移を確認する | 成功したグラフを汎化と誤解する |
セッションを比較する前に振幅を整える
振幅は、後で問題になりやすい位相ラップを一部避けられるため、最初に扱いやすい信号です。それでも受信機ゲイン、自動ゲイン制御、外れ値、パケット欠損、周波数依存の挙動を含みます。CSI サニタイズは特徴量コード内の隠れた呼び出しではなく、名前の付いた段階にします。元の複素サンプルとフィルターやスケーリングの選択をすべて残します。
すぐにテンソル全体を平滑化せず、複数のサブキャリアを観察するプロットから始めます。短いスパイクは壊れたパケット、実際の過渡現象、ゲイン状態の変化のどれかです。中央値フィルターや Hampel 型の処理は孤立した外れ値を減らせますが、広い窓は短いジェスチャーを消します。ローパスはサンプルレートと目的からカットオフを説明できる場合だけ使い、イベントの遅延や欠損の見かけ上の緩慢化にも注意します。
二つのセッションを比べるときは、整形後の分布を調べます。平均が似ていても、ばらつきが違えば z スコアは変わります。パケットレートや帯域幅が違う受信機は、古い状態に押し込まず別のキャリブレーションを持たせます。
- 少なくとも静穏区間、管理した動き、陰性対照それぞれで、生の振幅と整形後の振幅を描きます。
- 外れ値規則、フィルター窓、カットオフ、補間方針、破棄パケット数を記録します。
- チャネル全体の平均だけでなく、サブキャリアごとのばらつきを比べます。
- 正規化器を検証・テストセッションで学習せず、学習またはキャリブレーションの境界内に置きます。
位相キャリブレーション:アンラップ、オフセット、参照
CSI の位相は周期的です。負から正の境界をまたぐ値は、経路が滑らかに変わっていても大きなジャンプに見えます。位相アンラップは人工的なラップを除きますが、搬送波周波数オフセット、タイミングオフセット、無線チェーン差、サブキャリア順序の誤りまでは除きません。位相特徴を動きとして扱う前に確認が必要です。
位相キャリブレーションの記録には、参照サブキャリアまたはアンテナ対、アンラップ規則、捨てた端のキャリア、オフセットや傾きを除くためのフィットを明記します。静穏区間と管理した動きで整形済みの軌跡を比べます。位相が安定しても振幅がドリフトするなら、二つの品質信号を分けて保ちます。一つのスコアでは受信機のどこが失敗したか隠れてしまいます。
位相が振幅より自動的に優れているわけではありません。経路の情報を加え特定の課題を改善することはありますが、仮定とハードウェア依存性も増えます。透明な基準として振幅を使い、整形済み位相を管理した比較として加え、追加の前処理コストを報告します。
| 確認 | 問い | 保存する証拠 |
|---|---|---|
| サブキャリア順 | インデックスは並び、同じ帯域幅に対応しているか | インデックス一覧とチャネル設定 |
| アンラップ | 実際のイベントを平らにせず境界ジャンプが消えたか | 同じ窓の生位相とアンラップ後の位相 |
| オフセットまたは傾き | 静穏軌跡に受信機固有の傾向があるか | フィット係数、参照、破棄キャリア |
| 転移 | 別セッションや別ボードでも規則が成立するか | 保留した軌跡と失敗メモ |
再現可能なキャリブレーション取得を作る
再現可能な取得は、開始と終了の条件を決めた小さな実験です。ボードと送信機を置き、チャネルとパケット設定を固定し、部屋の状態をラベル付けして、受信機が落ち着くまで待ちます。静穏ブロック、管理した対象イベント、ドアやファンなどの陰性対照、イベント後の短い再取得を記録します。大量のデータを作ることではなく、他の人が確認できる判断を作ることが目的です。
後段の検出器と同じ時刻規則と窓規則を使います。実運用が特定のレートの 2 秒窓を使うなら、別レートでのキャリブレーションは隠れたドメインシフトになります。ノード位置、部屋の配置、在室者、家具の変更、期待する出力をファイルの横にマニフェストとして保存し、ルーターやボード、ファームウェア更新後に再実行できるようにします。
出力には整形済みストリームと品質レポートを含めます。受理パケット数、欠損、頑健なばらつき、位相の連続性、基準値の年齢、管理イベントが静穏区間から識別できたかを記載します。レポートが信号不足と結論しても構いません。
- 静穏ブロックの前にハードウェア位置、チャネル、帯域幅、パケットレート、ファームウェアを固定します。
- 空室、在室、動き、環境変化の区間を、ファイル名だけに頼らずラベル付けします。
- 管理イベント後に短い静穏ブロックをもう一度取り、直後のドリフトを調べます。
- キャリブレーションの版を保存し、生データを削除せず状態だけ無効化できるようにします。
ドリフトを検出し、再キャリブレーションの時期を決める
ドリフトは、初期のキャリブレーションで説明できなかった信号分布の変化です。アンテナ移動、別チャネル、家具、ファン、部屋に残った人、ファームウェア、クロック、パケット欠損などが原因になります。検出器は現在の静穏に近いサンプルを基準値と比べ、警告の理由を報告します。一つのしきい値を全ての部屋に使うのは難しいため、分布、パケット品質、鮮度タイマーを組み合わせます。
状態モデルには少なくとも、ウォームアップ、キャリブレーション済み、劣化、再キャリブレーション要求の四状態を置きます。ウォームアップはサンプル不足、キャリブレーション済みは基準値が成熟し品質検査を通った状態です。劣化では慎重な結果を示し警告を出します。再キャリブレーション要求では、以前のしきい値が信頼できるふりを止めます。
低信頼状態を、画面を単純にするためだけに人の陽性・陰性ラベルへ変換してはいけません。unknown は静かな誤警報から評価を守り、部屋の確認、リンクの確認、新しい静穏期間の取得という具体的な行動を示します。
| 信号状態 | 典型的な証拠 | 推奨する行動 |
|---|---|---|
| ウォームアップ | 静穏サンプル不足またはメタデータ不完全 | 基準値を追加取得する |
| キャリブレーション済み | ばらつきが安定、予定レート、状態が新しい | 計画した実験を許可する |
| 劣化 | 欠損増加、ドリフト警告、位相連続性低下 | 不確かさを表示しリンクを調べる |
| 再キャリブレーション要求 | チャネル、位置、ファームウェア、分布が持続的に変化 | 状態を無効にし静穏取得をやり直す |
RuView 型実験の検証表
キャリブレーションは前提条件であり、最終的な主張ではありません。学習やモデル比較の前に、固定録音を再生し、同じ入力が文書化した数値許容差内で同じ状態になるか確認します。次に、主張に応じて完全なセッション、日、部屋、ノード位置を丸ごと保留します。ほぼ同じパケットを共有する隣接ランダム窓は強いテストではありません。
検証表には静穏区間、対象イベント、環境ノイズ、パケット欠損の挙動、状態を変えた実行を含めます。誤警報、見逃し、検出遅延、基準値の年齢、回復に要した時間を記録します。位相キャリブレーションが任意なら、振幅のみと振幅+位相を分けて報告します。ボード交換後に特徴が壊れた場合、それはキャリブレーション境界の証拠であり、隠す理由ではありません。
RuView 型の作業では、取得契約、キャリブレーション状態、特徴量スキーマ、モデル評価の受け渡しを明確にします。生の軌跡を保持し、ハードウェア資料を引用し、出力が探索的である部分を説明します。見栄えのよいヒートマップは、保護されたテスト条件の代わりにはなりません。
- 決定的なリプレイでキャリブレーションのパラメータまたは状態ハッシュを比較します。
- パケット欠損、時刻の穴、サンプル数、ばらつき、位相連続性をモデル指標の横に報告します。
- ファン、ドア、家具変更などの陰性対照を入れ、誤警報を見積もります。
- 結果が研究信号、オートメーション入力、検証済み製品計測のどれかを明記します。
キャリブレーションの参考資料
Wi-Fi CSI キャリブレーション FAQ
Wi-Fi CSI キャリブレーションとは何ですか?
定義した基準状態を記録し、振幅と位相の通常の変動を推定し、パラメータを保存し、その後のサンプルが基準に合うか確認する工程です。比較の再現性は高まりますが、どの部屋でもモデルが動く保証にはなりません。
CSI のキャリブレーションに静かな部屋は必要ですか?
完全な無音ではなく、定義できて繰り返せる基準状態が必要です。運用中も存在するファンや通常のネットワーク通信は基準に含められます。部屋の状態を記録し、大きな変更後は取得をやり直します。
振幅と位相はどちらを先にキャリブレーションすべきですか?
まず透明な振幅基準値を作り、次に位相を管理した比較として加えます。位相にはアンラップとオフセット確認が必要で、受信機やアンテナの違いに敏感です。
Wi-Fi CSI の基準値はいつ無効にすべきですか?
チャネル、帯域幅、ファームウェア、ボード、アンテナ位置、部屋の配置、パケットレートが変わった後、または品質や静穏サンプルの分布が記録範囲を外れ続けたときです。黙って再利用せず、再キャリブレーション状態を表示します。
ESP32 の CSI キャリブレーションを別のボードへ移せますか?
移せると決めつけないでください。ボードの改版、ファームウェア、無線チェーン、サンプルレート、アンテナ経路で分布が変わります。交換を明示的に試し、互換性のある取得契約ごとに状態を保存します。
キャリブレーションで Wi-Fi センシングは医療や安全用途に十分正確になりますか?
なりません。追跡可能性を高めドリフトを示せますが、医療、安全、セキュリティ、個人識別の用途には、用途固有のデータ、参照系、リスク管理、プライバシー審査、独立検証が必要です。