Repolode
francescopace

francescopace/espectre

把 ESP32 变成本地运行的 Wi-Fi 动态感应器,通过无线信号变化检测移动,无需摄像头或麦克风。

Star
9,665
Fork
733
未关闭 Issue
14
最近提交
前天

这是什么?

ESPectre 运行在受支持的 ESP32 开发板上,读取房间内现有 Wi-Fi 信号的信道状态信息(CSI)。有人移动时,信号传播路径随之改变,设备会实时上报移动状态和运动分数。所有处理都在设备端完成,不依赖云服务,也不需要摄像头、麦克风、可穿戴设备或雷达硬件。

项目提供多种固件方案:支持 MQTT 和 Home Assistant MQTT Discovery 的 Native 版本、ESPHome 版本、作为 Matter 占用传感器的版本,以及基于 MicroPython 的 Micro-ESPectre。此外还包括可嵌入的 C++ SDK、本地 HTTP API、浏览器端烧录和监控工具,以及用于管理设备的命令行工具。

仓库公开了 CSI 数据集、训练好的模型权重、记录已测试与被否决实验的特征清单,以及性能报告。ESPectre 只检测无线电环境的变化,不识别或统计人数。代码采用 GPLv3 协议,符合条件的部分另提供商业授权。

核心功能

  • 01在 ESP32-C6、C5、C3、S3、S2 及经典 ESP32 上基于 Wi-Fi CSI 检测移动。
  • 02所有运算在设备端完成,无需连接云端。
  • 03通过 ESPHome 或 MQTT 接入 Home Assistant,也可作为 Matter 占用传感器使用。
  • 04提供本地 HTTP API 和可嵌入的 C++ SDK,便于开发自定义固件。
  • 05内置浏览器烧录、设备设置和实时监控工具。

适用场景

  • 有人进入房间时自动开启灯光或显示屏。
  • 根据房间是否有人使用来调节供暖。
  • 在本应无人的区域检测到移动时发送提醒。
  • 在 Home Assistant 中加入不依赖摄像头的人员活动感知。

快速上手

  1. 1

    在桌面版 Chrome 或 Edge 中打开 Flash 工具

  2. 2

    通过 USB 连接受支持的 ESP32,选择固件并完成 Wi-Fi 配置

  3. 3

    打开 Monitor 查看运动并调整检测参数

使用前须知

  • 需要受支持的 ESP32 开发板和 2.4 GHz Wi-Fi 4 网络;每个房间需要一块开发板。
  • Matter 控制器兼容性仍然有限,尚未全面测试。
  • 适用 GPLv3 copyleft 协议,闭源固件需要单独的商业许可。

标签

常见问题

espectre 是什么?
把 ESP32 变成本地运行的 Wi-Fi 动态感应器,通过无线信号变化检测移动,无需摄像头或麦克风。 ESPectre 运行在受支持的 ESP32 开发板上,读取房间内现有 Wi-Fi 信号的信道状态信息(CSI)。有人移动时,信号传播路径随之改变,设备会实时上报移动状态和运动分数。所有处理都在设备端完成,不依赖云服务,也不需要摄像头、麦克风、可穿戴设备或雷达硬件。
espectre 可以免费使用吗?用的什么许可证?
espectre 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
espectre 还在维护吗?
活跃维护中。espectre 最近一次提交是在 2026年10月19日。
espectre 适合用来做什么?
有人进入房间时自动开启灯光或显示屏。 根据房间是否有人使用来调节供暖。 在本应无人的区域检测到移动时发送提醒。 在 Home Assistant 中加入不依赖摄像头的人员活动感知。
espectre 怎么安装和运行?
在桌面版 Chrome 或 Edge 中打开 Flash 工具 通过 USB 连接受支持的 ESP32,选择固件并完成 Wi-Fi 配置 打开 Monitor 查看运动并调整检测参数
在哪里获取 espectre?
源代码和安装说明在 GitHub 上:https://github.com/francescopace/espectre

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目