Repolode
francescopace

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. 1

    デスクトップ版のChromeまたはEdgeでFlashツールを開きます

  2. 2

    対応するESP32をUSBで接続し、ファームウェアを選択してWi-Fiのセットアップを完了します

  3. 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 の数値は毎日更新されます。

関連プロジェクト