ESP32のCSI信号で人の在室、呼吸、心拍、動きを検知するオープンソースWiFiセンシング基盤。
francescopace/espectre
ESP32を、Wi-Fi信号の変化から動きを検知するプライベートなローカルWi-Fiモーションセンサーにします。カメラやマイクは不要です。
- スター
- 9,665
- フォーク
- 733
- 未解決の Issue
- 14
- 最終コミット
- 一昨日
これは何?
ESPectreは対応するESP32ボードで動作し、室内にすでに存在するWi-Fi信号からチャネル状態情報(CSI)を読み取ります。人が動くと信号経路が変化し、デバイスは動きと動きのスコアをリアルタイムで報告します。処理はデバイス上で行われるため、クラウドサービスは不要です。また、カメラ、マイク、ウェアラブル機器、レーダー機器も必要ありません。
プロジェクトには複数のファームウェア実装が用意されています。MQTTとHome Assistant MQTT Discoveryに対応するNativeフロントエンド、ESPHomeフロントエンド、Matter占有センサーフロントエンド、そしてMicro-ESPectreというMicroPython実装です。さらに、組み込み可能なC++ SDK、ローカルHTTP API、ブラウザーからの書き込み・監視ツール、デバイス管理用のホストCLIも含まれています。
リポジトリでは、CSIデータセット、学習済みモデルの重み、検証・不採用となった実験を記録した機能台帳、性能レポートを公開しています。ESPectreが検知するのは電波環境の変化のみで、人の識別や人数のカウントは行いません。コードはGPLv3で提供され、条件を満たす部分には商用ライセンスも用意されています。
主な機能
- 01ESP32-C6、C5、C3、S3、S2、および従来型ESP32ボードで、Wi-Fi CSIから動きを検知します。
- 02クラウド接続なしで、すべての処理をデバイス上で実行します。
- 03ESPHomeまたはMQTT経由でHome Assistantと連携し、Matter占有センサーとして認識されます。
- 04ローカルHTTP APIと、カスタムファームウェアに組み込めるC++ SDKを提供します。
- 05ブラウザーからのファームウェア書き込み、デバイス設定、リアルタイムモニターを利用できます。
ユースケース
- 人が部屋に入ったときに照明やディスプレイを点灯する。
- 部屋が使われているかどうかに応じて暖房を調整する。
- 無人であるべきエリアで動きを検知した際にアラートを送信する。
- カメラを使わずに、Home Assistant環境へ在室検知機能を追加する。
クイックスタート
- 1
デスクトップ版のChromeまたはEdgeでFlashツールを開きます
- 2
対応するESP32をUSBで接続し、ファームウェアを選択してWi-Fiのセットアップを完了します
- 3
Monitorを開いて動きを確認し、検知を調整します
使う前に知っておきたいこと
- 対応するESP32ボードと2.4 GHzのWi-Fi 4ネットワークが必要です。部屋ごとに1台のボードを用意してください。
- Matterコントローラーとの互換性はまだ限定的で、十分なテストが行われていません。
- GPLv3のコピーレフトが適用されるため、クローズドソースのファームウェアには別途商用ライセンスが必要です。
トピック
よくある質問
- espectre とは?
- ESP32を、Wi-Fi信号の変化から動きを検知するプライベートなローカルWi-Fiモーションセンサーにします。カメラやマイクは不要です。 ESPectreは対応するESP32ボードで動作し、室内にすでに存在するWi-Fi信号からチャネル状態情報(CSI)を読み取ります。人が動くと信号経路が変化し、デバイスは動きと動きのスコアをリアルタイムで報告します。処理はデバイス上で行われるため、クラウドサービスは不要です。また、カメラ、マイク、ウェアラブル機器、レーダー機器も必要ありません。
- espectre は無料で使えますか?ライセンスは?
- espectre は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- espectre は今もメンテナンスされていますか?
- 活発にメンテナンス中。espectre の最終コミットは 2026年10月19日 です。
- espectre は何に使えますか?
- 人が部屋に入ったときに照明やディスプレイを点灯する。 部屋が使われているかどうかに応じて暖房を調整する。 無人であるべきエリアで動きを検知した際にアラートを送信する。 カメラを使わずに、Home Assistant環境へ在室検知機能を追加する。
- espectre のインストール方法は?
- デスクトップ版のChromeまたはEdgeでFlashツールを開きます 対応するESP32をUSBで接続し、ファームウェアを選択してWi-Fiのセットアップを完了します Monitorを開いて動きを確認し、検知を調整します
- espectre はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/francescopace/espectre
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
ESP32を搭載し、OLEDの顔とサーボ駆動の歩行機能を備えた、オープンソースの3Dプリント対応ミニ四足歩行ロボット。
ESP32ボードやRaspberry PiなどのLinuxデバイスでMuseガジェットを作るためのオープンソースSDKとファームウェア。
Claude Codeの使用量制限を表示し、プロンプトに反応するアニメーションマスコットや、セッションで入力が必要なときの通知機能を備えたESP32デスクトップディスプレイ。
マイクロコントローラーなどのリソースが限られたデバイスで動作し、ハードウェアアクセス用モジュールを備えた軽量なPython 3実装。