ESPectre:把你的Wi-Fi路由器变成“鬼魂探测器”级运动传感器

GitHub June 2026
⭐ 7762📈 +934
来源:GitHub归档:June 2026
一个名为ESPectre的开源项目,仅凭一块5美元的ESP32开发板,就能将普通Wi-Fi路由器改造成被动式运动检测器。它不依赖摄像头或红外传感器,而是通过分析信道状态信息(CSI)的微妙变化来感知人体移动,并原生集成Home Assistant。

由开发者francescopace创建的ESPectre是一个开源项目,在GitHub上迅速走红,已获得超过7700颗星,单日新增星标数高达934颗。该系统利用Wi-Fi信道状态信息(CSI)——即OFDM信号中子载波的精细幅度和相位数据——来检测室内环境中的人体移动。与传统依赖红外热释电(PIR)或主动雷达(mmWave)的运动传感器不同,ESPectre完全被动:它监听来自标准路由器的现有Wi-Fi信号,并使用ESP32微控制器捕获CSI数据包。随后,软件通过信号处理和机器学习对是否发生移动进行分类,并通过MQTT或原生API向Home Assistant暴露一个二值运动传感器实体。其吸引力显而易见:成本极低、隐私保护出色,且无需额外专用硬件。

技术深度解析

ESPectre的核心创新在于利用Wi-Fi信道状态信息(CSI),这是一种描述无线信号在发射器和接收器之间传播方式的数据结构。大多数Wi-Fi应用只关心接收信号强度指示(RSSI)——一个单一的标量值——而CSI则为每个OFDM子载波(在802.11n/ac中通常为52到114个子载波)提供了幅度和相位的复杂矩阵。当人体在环境中移动时,会改变这些子载波的多径反射,从而在CSI时间序列中产生独特的模式。

架构: 该系统运行在ESP32微控制器上,刷入自定义固件,将Wi-Fi芯片置于监控模式。它会嗅探来自附近接入点(通常是2.4 GHz路由器)的802.11数据包,并从数据包前导码或信标帧中提取CSI数据。原始CSI随后在设备上通过轻量级信号处理流水线进行处理:

1. 噪声滤波: 移动平均或Savitzky-Golay滤波器去除每个子载波幅度中的高频噪声。
2. 降维: 主成分分析(PCA)或简单的基于方差的筛选,选出最敏感的子载波。
3. 运动检测: 基于阈值的检测器将滤波后CSI的短期方差与基线进行比较。如果方差超过可配置的阈值,则判定为有运动发生。

固件的更高级版本(可在项目的GitHub仓库中找到)集成了一个轻量级卷积神经网络(CNN),该网络在标记的CSI样本上训练,以区分人体运动、宠物移动以及风扇叶片或窗帘等环境噪声。模型被量化为INT8格式,以适应ESP32的520KB SRAM。

性能基准测试: 项目文档和社区基准测试提供了以下数据:

| 指标 | ESPectre(默认) | ESPectre(ML增强) | 商用PIR(如Philips Hue) | mmWave雷达(如Aqara FP2) |
|---|---|---|---|---|
| 检测范围 | 5-8米 | 5-8米 | 6-10米 | 6-12米 |
| 检测延迟 | 200-500毫秒 | 300-800毫秒 | 1-2秒 | 100-300毫秒 |
| 误报率(安静房间) | 5-10% | 2-5% | <1% | <1% |
| 漏报率(行走) | 10-15% | 5-8% | <1% | <1% |
| 功耗 | 0.5W(ESP32) | 0.6W(ESP32) | 0.1W(电池) | 0.5-1W(USB) |
| 硬件成本 | 5-10美元 | 5-10美元 | 15-25美元 | 30-50美元 |
| 隐私级别 | 极佳(无图像/音频) | 极佳 | 良好(无图像) | 良好(无图像) |

数据要点: ESPectre的检测精度落后于专用硬件传感器,尤其是在误报率和漏报率方面。然而,其成本和隐私优势无可匹敌。ML增强版本显著缩小了差距,表明进一步的算法改进可能使其适用于照明自动化或基于存在感的暖通空调控制等非关键应用。

相关GitHub仓库:
- francescopace/ESPectre(⭐7,762):主项目,包含固件、Home Assistant集成指南和3D打印外壳设计。
- esp32-csi-tool(⭐1,200+):一个用于在ESP32上原始捕获CSI的低级库,作为ESPectre的依赖项使用。
- OpenWrt-CSI(⭐800+):一种替代方法,直接在OpenWrt路由器上运行CSI分析,无需外部ESP32。

关键参与者与案例研究

ESPectre处于三个社区的交汇点:开源硬件爱好者、Home Assistant生态系统开发者以及Wi-Fi感知领域的学术研究人员。主要参与者是francescopace,一位独立开发者,他构建了一个精良的集成方案,降低了爱好者的入门门槛。然而,底层技术已被多个学术团体探索:

- 华盛顿大学Wi-Fi感知小组(例如Wi-Vi、WiTrack):率先使用CSI实现穿墙运动检测,但需要昂贵的USRP无线电设备。ESPectre通过在商用硬件上运行,使这项技术得以普及。
- 小米的Aqara FP2:一款商用mmWave存在传感器,售价40-50美元,提供基于区域的占用检测。在注重隐私的智能家居市场中,它是ESPectre最接近的竞争对手,但需要专用硬件和有线USB连接。
- 涂鸦的Wi-Fi运动传感器:一款低成本(10美元)设备,使用基于RSSI的运动检测。其精度远低于基于CSI的方法,且容易频繁误触发。

被动运动检测方法对比:

| 解决方案 | 技术 | 成本 | 隐私 | 精度 | 原生Home Assistant |
|---|---|---|---|---|---|
| ESPectre | Wi-Fi CSI | 5-10美元 | 极佳 | 中等 | 是(MQTT/API) |
| Aqara FP2 | mmWave雷达 | 40-50美元 | 良好 | 高 | 是(Zigbee) |
| Philips Hue运动传感器 | PIR | 20-25美元 | 良好 | 高 | 否(Zigbee桥接器) |
| 涂鸦RSSI传感器 | RSSI | 10美元 | 极佳 | 低 | 是(Wi-Fi) |
| 基于摄像头的方案(如D-Link) | 计算机视觉 | 30-

更多来自 GitHub

CloudStream:重塑移动流媒体体验的开源Android应用CloudStream并非又一款媒体播放器,而是Android用户访问与消费视频内容的范式革新。基于插件架构,该应用允许用户安装并切换各类内容源——从电影数据库到动漫仓库——从而构建一个个性化、聚合化的流媒体中枢。项目托管于GitHub的'AutonomousRepo:当AI写下每一行代码——新前沿还是死胡同?GitHub仓库'AutonomousRepo'(yoavlax/autonomousrepo)因其大胆声明而引发关注:每一行代码、每一个功能、每一次改进,均由GitHub Copilot SDK Agent自主生成。该项目被定位为全自主软GitHub Copilot SDK 解锁编辑器之外的AI编程能力:开发者必知要点GitHub Copilot SDK 现已作为开源项目在 GitHub 上发布,首日即获得超过 9,300 颗星。它提供标准化的 API 和工具,用于将 GitHub Copilot Agent 集成到自定义应用中。与熟悉的 Copilot查看来源专题页GitHub 已收录 2432 篇文章

时间归档

June 2026577 篇已发布文章

延伸阅读

Home Assistant的本地优先革命:开源如何重塑智能家居隐私格局Home Assistant已成为注重隐私的智能家居爱好者的终极平台,它摒弃了商业巨头的云端优先模式。凭借超过8.5万GitHub星标和2000多项集成支持,其事件驱动、本地控制的架构代表了自动化构建方式的根本性转变。本文探讨其技术复杂性能CloudStream:重塑移动流媒体体验的开源Android应用CloudStream,一款在GitHub上斩获近万星标的开源Android应用,正通过其插件化架构颠覆移动流媒体格局——用户可聚合多源内容,打造个性化观看中枢。本文深入剖析其技术内核、社区生态与游走的法律灰色地带。AutonomousRepo:当AI写下每一行代码——新前沿还是死胡同?一个GitHub仓库宣称,从首次提交到最新功能,全部由AI代理独立完成。AutonomousRepo将AI驱动开发推向了极致,但这究竟是真正的突破,还是一次巧妙却空洞的演示?AINews深入调查。GitHub Copilot SDK 解锁编辑器之外的AI编程能力:开发者必知要点GitHub 正式发布 Copilot SDK,这是一套多平台工具包,允许开发者将 Copilot Agent 的能力直接嵌入自有应用与服务。此举标志着从单一编辑器插件向平台化战略的转变,有望重塑AI编程助手在整个软件开发生命周期中的集成方

常见问题

GitHub 热点“ESPectre Turns Your Wi-Fi Router Into a Ghost-Detecting Motion Sensor”主要讲了什么?

ESPectre, an open-source project by developer francescopace, has rapidly gained traction on GitHub with over 7,700 stars and a single-day spike of 934 stars. The system leverages W…

这个 GitHub 项目在“ESPectre vs Aqara FP2 accuracy comparison”上为什么会引发关注?

ESPectre’s core innovation lies in exploiting Wi-Fi Channel State Information (CSI), a data structure that describes how a wireless signal propagates between a transmitter and receiver. While most Wi-Fi applications only…

从“ESPectre Home Assistant MQTT setup guide”看,这个 GitHub 项目的热度表现如何?

当前相关 GitHub 项目总星标约为 7762,近一日增长约为 934,这说明它在开源社区具有较强讨论度和扩散能力。