ESPectre

ESP32をプライベートなローカルWi-Fi人感センサーに変えます。

人が部屋の中を移動すると、その部屋を通過するWi-Fi信号の伝わり方が変化します。ESPectreはその変化を読み取り、リアルタイムで動きを報告します。カメラもマイクもウェアラブルも専用レーダーハードウェアも不要です。対応するESP32と、その部屋にすでにあるWi-Fiネットワークだけで動作します。

ESPectreはオープンソースプラットフォームであり、すぐに書き込めるファームウェア、組み込み可能なC++ SDK、MicroPython実装、ブラウザツール、ホストCLI、オープンデータセット、オープンモデル重み、そして検出器の構築と検証に使用された研究ワークフローをまとめて提供します。

ブラウザから書き込む · ライブツールを見る · ドキュメントを読む · SDKを探索する

アプリケーションと統合

ESPectreは、動きを検出するとディスプレイや照明をオンにしたり、部屋の活動に応じて暖房・冷房を調整したり、空であるべき場所で動きが発生した場合にアラームや通知をトリガーしたり、その他の部屋の自動化を駆動できます。ESPHomeまたはMQTTを通じてHome Assistantに接続し、標準のMatter占有センサーとローカルなDirect HTTP APIを公開し、C++ SDKを通じてカスタムESP32ファームウェアに組み込むこともできます。

ESPectreはデバイス上でCSIを処理し、動きの状態と移動スコアを報告します。アプリケーションは生のセンシングデータをクラウドサービスに送信することなく反応できます。1つのボードで1つのセンシングエリアをカバーします。部屋レベルのカバレッジには通常、部屋ごとに1つのボードが必要です。

ESPectreは無線環境の変化を検出します。人を特定したり、人数を数えたり、部屋が空であることを証明したり、安全認証済みのセキュリティ、医療、緊急システムを置き換えるものではありません。

対応ハードウェア

• ESP32-C6、ESP32-C5、ESP32-C3、ESP32-S3、ESP32-S2、および従来のESP32
• 2.4 GHz帯の通常のWi-Fi 4（802.11n）ネットワーク

ファームウェアパスの選択

Native、ESPHome、Matterは、起動時に部屋固有のしきい値を学習し、アプリケーションの残りの部分により多くのリソースを残すlightweight検出器と、リポジトリに含まれるトレーニング済みモデルを実行するhigh_accuracy検出器のいずれかを選択できます。それらの動作と測定されたトレードオフは、SETUP.md、ALGORITHMS.md、およびパフォーマンスレポートに文書化されています。

クイックスタート

最も迅速な方法はブラウザを使用するもので、ローカルのビルド環境は不要です。完全なホスト型ワークフローにはデスクトップ版Chrome 151以降を使用してください。Edgeはブラウザ書き込みをサポートしていますが、Device settingsとMonitorとの互換性は保証されていません：

1. デスクトップ版ChromeまたはEdgeでFlashを開きます。
2. 対応するESP32をUSBで接続し、ファームウェアとリリースチャンネルを選択します。
3. 画面上のWi-Fiプロビジョニングを完了するか、対応するコントローラーでMatterをコミッショニングします。
4. 必要に応じて、Device settingsを開いて優先アクセスポイントを固定したり、MQTTを設定したりします。
5. Monitorを開いて、動きの監視、検出の調整、デバイスの検査を行います。

Matterのステータス： Matterフロントエンドは、コントローラーエコシステム全体での検証がまだ進行中です。コントローラーが標準のMatter占有センサーをサポートしていても、現在のファームウェアでテストされているとは限りません。 現在のマトリックスについては、Matterコントローラー互換性を参照してください。

ローカルセットアップ

ローカルビルド、このリポジトリからの書き込み、およびその他のオペレーターパスについては、SETUP.mdから始めてください。リポジトリラッパーは、利用可能なワークフローを次の方法で公開します：

./espectre --help

ドキュメント

データセット、モデル、検証

ESPectreは、検出器の背後にある研究資産と検証エビデンスを公開しています：

セキュリティ、プライバシー、透明性

存在を明らかにできるセンサーはブラックボックスであってはなりません。Wi-Fiセンシングは画像や音声を回避しますが、動きや占有データは依然として生活リズム、睡眠、在宅・不在を明らかにする可能性があります。ESPectreはそのリスクをエンジニアリング作業の一部として扱います：

• 動きの検出はローカルで行われ、クラウド接続は不要です。
• 生のCSI収集はオプションであり、明確に定義された研究およびデバッグのニーズを目的としています。
• セキュリティと責任ある使用ガイドは、展開の境界、同意、データ最小化、悪用報告、非公開の脆弱性報告を文書化しています。
• ファームウェアリリースには、ビルド固有のSBOM、通知、ライセンスアーカイブが含まれており、その内容を検査できます。
• 公開ウェブサイトとすべてのブラウザツールは、ソース、プライバシールール、アナリティクス契約、固定されたブラウザ依存関係を含め、このリポジトリのdocs/webの一部です。
• プロトコル、アルゴリズム、パフォーマンスエビデンス、制限事項、ロードマップ決定、既知の検証境界は公開文書化されています。

ESPectreは、展開する権利があるスペースとネットワークでのみ使用してください。影響を受ける人々に知らせ、必要な場合は同意を得て、デバイスとそのデータへのアクセスを保護し、適用されるプライバシー法に従ってください。

謝辞

• CSIをESP-IDFで利用可能にし、ESPectreをesp-csiのコミュニティプロジェクトとして認めてくれたEspressifに感謝します。
• メインラインのnetwork.WLANに直接CSIメソッドを追加したESPectreのCSIコントリビューションをレビュー、テスト、マージしてくれたMicroPythonメンテナーに感謝します。

ライセンス

ESPectreのファーストパーティコードはGPLv3で利用可能であり、対象となる部分は別の商用契約でも利用可能です：

• ファームウェアまたはアプリケーションがGPLv3に準拠できる場合（対応するソースコードの公開を含む）は、GPLv3を選択してください。LICENSEを参照してください。
• GPLv3のソース開示義務なしにESPectreをプロプライエタリまたはクローズドソースのファームウェアに組み込みたい場合は、商用ライセンスについてLICENSING.mdを参照してください。商用ライセンスは対象となる素材をカバーし、サードパーティの条件を置き換えるものではありません。ESPHome C++フロントエンドはGPLv3専用のままです。

サードパーティの条件とビルド固有のコンプライアンス成果物は、THIRD_PARTY_NOTICES.mdに記載されています。