
ESPectre - Wi-Fiスペクトル解析(CSI)に基づく動体検知システム、Home Assistant統合付き。
ESP32をプライベートでローカルなWi-Fiモーションセンサーに変える。
誰かが部屋の中を移動すると、その部屋を伝わるWi-Fi信号の進み方が変化します。ESPectreはその変化を読み取り、リアルタイムで動きを報告します。カメラもマイクもウェアラブルも、専用のレーダーハードウェアも不要です。必要なのは対応するESP32と、その部屋にすでにあるWi-Fiネットワークだけです。
ESPectreは、すぐに書き込めるファームウェア、組み込み可能なC++ SDK、Arduinoライブラリ、MicroPython実装、ブラウザツール、ホストCLI、オープンデータセット、オープンモデルの重み、そして検出器の構築と検証に用いた研究ワークフローを一つにまとめたオープンソースプラットフォームです。
ブラウザから書き込む · ライブツールを見る · ドキュメントを読む · SDKを探る
ESPectreを使えば、誰かが入室したときに照明やディスプレイを点けたり、部屋が使用中のときに暖房を調整したり、誰もいるはずのない場所で動きがあったときにアラートを送ったりできます。Home Assistant(ESPHomeまたはMQTT経由)と連携し、標準的なMatter在室センサーとして認識され、ローカルHTTP APIを提供し、C++ SDKやArduino-ESP32スケッチを使って独自のESP32ファームウェアに組み込むこともできます。
すべてはデバイス上で動作します。Wi-Fiチャネル(チャネル状態情報、すなわちCSI)を測定し、動きとモーションスコアを報告します。クラウドに送る必要はありません。1枚のボードが1つのエリアをカバーするため、部屋ごとに1枚のボードを用意する計画を立ててください。
ESPectreは電波環境の変化を検出します。人物を識別したり、人数を数えたり、部屋が空であることを証明したり、安全認証済みのセキュリティ、医療、緊急システムの代わりになるものではありません。
| パス | 最適な用途 | ここから始める |
|---|---|---|
| Native | スタンドアロンセンサー、Home Assistant MQTT Discoveryを含むMQTT統合、カスタムアプリケーション | Nativeフロントエンド |
| ESPHome | ネイティブエンティティ、ESPHomeプロビジョニング、Device Builderによる更新を求めるHome Assistantユーザー | ESPHomeフロントエンド |
| Matter | 在室センサーをサポートするMatterコントローラー。Google Home、Apple Home、Home Assistantでテスト済み | Matterフロントエンド |
| Micro-ESPectre | ローカルの読み取り専用Direct HTTPモニタリングを備えたMicroPythonでの軽量センシング | Micro-ESPectre README |
最も手軽な方法はブラウザだけで完結します。デスクトップ版Chrome 151以降を使用してください。Edgeでも書き込みは可能ですが、Device settingsとMonitorは動作しない場合があります。
ネットワーク上のデバイスを見つけるには、ブラウザツールの Find devices または ./espectre devices を使用します。要件と制限については discovery reference を参照してください。

Matter のステータス: ペアリング、在室更新、自動化は Google Home、Apple Home、Home Assistant でテスト済みです。Amazon Alexa と Samsung SmartThings はまだテストされていません。Google Home では一度だけ Developer Console setup が必要です。 現在のマトリクスについては Matter controller compatibility を参照してください。
このリポジトリからビルドとフラッシュを行うには、まず setup guide から始めてください。利用可能なすべてのコマンドを確認するには、次を実行します:
./espectre --help
| トピック | 内容 | ガイド |
|---|---|---|
| インストールと運用 | デバイスのセットアップ、CLI ワークフロー、トラブルシューティング | セットアップガイド、CLI リファレンス、トラブルシューティングガイド |
| 理解と統合 | ランタイムアーキテクチャ、CSI 取得、API、ディスカバリ、アルゴリズム、C++ SDK | アーキテクチャ概要、CSI ガイド、API リファレンス、ディスカバリリファレンス、アルゴリズムリファレンス、SDK ガイド |
| 研究と方向性 | ロードマップ、アーキテクチャ決定、リリース履歴 | ロードマップ、ADR インデックス、変更履歴 |
| フロントエンドリファレンス | 各ファームウェア、Micro-ESPectre、Arduino ライブラリのガイド | ESPHome、Native、Matter、Micro、Arduino |
| コントリビューション | コントリビューション、リリース手順、プロジェクトの議論 | コントリビューションガイド、リリースガイド、GitHub Discussions |
ESPectre は、検出器の基盤となる研究資産と検証エビデンスを公開しています:
| 資産 | 得られるもの | ここから始める |
|---|---|---|
| CSI データセット | 空室、静的プレゼンス、モーションの実録音。カタログと来歴は dataset_info.json に記載 | データ収集ガイド、Data/ |
| モデル重み | C++ と Python の学習済み重み、および学習・エクスポート・検証のワークフロー | ML 学習ガイド |
| 特徴量分析 | テストされ、採用または却下された特徴量(失敗した実験を含む) | 特徴量分析 |
| レポート | 生成された検出器メトリクスとデータセット品質チェック | パフォーマンスレポート、データセット品質レポート |
| 文献 | 外部の Wi-Fi センシング研究と、ESPectre に応用できる知見 | 文献レビュー |