Wi-Fi感知入门3步用ESP32 CSI实现室内定位与人体检测【免费下载链接】esp-csiApplications based on Wi-Fi CSI (Channel state information), such as indoor positioning, human detection项目地址: https://gitcode.com/GitHub_Trending/es/esp-csi先问一个问题关掉摄像头房间还能被看到吗关掉摄像头房间里的动静还能被看到吗可以——而你每天就生活在这张视线里Wi-Fi。esp-csi 项目让 ESP32 这枚几十块钱的芯片变成一台无线感知设备不加摄像头、不加雷达只靠普通信号就能检测人体移动、追踪位置。听起来像科幻继续往下读你很快就能亲手复现。一句话讲透Wi-Fi信号就像湖面的水波想象你站在湖边丢下一颗石子涟漪一圈圈散开碰到岸边的石头、水里的树枝波纹就会扭曲变形。Wi-Fi 信号就是这些涟漪而墙壁、家具、你的身体都是搅动波纹的石头。传统上我们只知道信号强不强——这是 RSSI它只有一个数字。而 CSI信道状态信息能看到每一圈波纹的完整形状幅度多大、相位如何偏移。Wi-Fi 用 OFDM 方式同时在几十个子载波上传输相当于在湖面激起了几十圈波纹。当你从信号路径上走过这些子载波的幅度和相位会发生细微但规律的变化。检测人体本质就是观察这些数字的变化。从装环境到首次出数据你的第一份CSI上手路线 第一步准备硬件你需要两块 ESP32 开发板一块当发送端一块当接收端。项目推荐 ESP32-C5 / ESP32-C6两者的射频性能是系列里目前最好的。还有两个小建议尽量选外置 IPEX 天线PCB 天线方向性差、容易被主板干扰两块板子之间保持 1 米以上距离。第二步搭建软件环境安装 ESP-IDF建议 v5.0 及以上版本然后克隆仓库并进入示例目录git clone https://gitcode.com/GitHub_Trending/es/esp-csi cd esp-csi第三步烧录两块板子的固件打开两个终端分别烧录发送端和接收端# 终端1发送端 cd examples/get-started/csi_send idf.py set-target esp32c3 idf.py flash -b 921600 -p /dev/ttyUSB0 monitor # 终端2接收端 cd examples/get-started/csi_recv idf.py set-target esp32c3 idf.py flash -b 921600 -p /dev/ttyUSB1第四步用Python工具看实时波形先关掉接收端的串口监视器再运行解析脚本cd examples/get-started/tools pip install -r requirements.txt python csi_data_read_parse.py -p /dev/ttyUSB1一个波形窗口会弹出来几十条子载波曲线实时跳动。现在走到两块板子中间挥挥手——你会亲眼看到波形出现明显的起伏。这就是你的第一份看得见的人体检测。看懂一行CSI数据从原始日志到人体检测打开接收端的串口监视器你会看到源源不断的 CSI_DATA 日志像这样截取了一部分CSI_DATA,0,94:d9:b3:80:8c:81,-30,11,1,6,1,0,1,0,1,0,0,-93,0,13,2,2751923,0,67,0,128,1,[67,48,4,0,...]这行天书拆开只有三部分数据头开头的CSI_DATA是类型标志告诉解析程序这是CSI行。元数据逗号分隔的一串数字依次是序号、发送方 MAC 地址、RSSI、速率、信道、时间戳等。比如-30是信号强度13是当前信道2751923是本地时间戳。ESP32-C5/C6 的字段略有精简但思路一致。核心的 data 数组方括号里那串数才是真正的透视眼。它按子载波排列每个子载波占两个数——先虚部、后实部即 [子载波1虚部, 子载波1实部, 子载波2虚部, 子载波2实部, ...]。把每一对虚实部换算成幅度和相位画成曲线就是波形窗口里跳动的线条。当人走动时各子载波的幅度和相位会同步偏移——机器学习模型正是靠这种变化模式区分没人有人走动有人静止等状态。如何选对获取信号的方案三条路线对比 同一个 Wi-Fi 感知获取 CSI 的途径有三条选错会直接影响部署成本和效果。方案工作方式优点短板什么时候选路由器模式ESP32 向路由器发 Ping接收回复里的 CSI一块板子加现成路由器成本最低依赖路由器位置易受其他联网设备干扰入门尝鲜、环境里正好有路由器设备直连两个 ESP32 都连路由器互相收对方的 Ping 包不依赖路由器位置部署灵活需要两块板子需要多设备协同覆盖专用广播发送端切换信道持续广播多个接收端同时采集精度最高多设备下对网络干扰小要专门准备发送设备高精度定位、多设备集群新手最容易踩的5个坑用PCB天线做实验PCB 天线方向性强、紧贴主板感知效果大打折扣。换成外置 IPEX 天线差距立竿见影。两块板子贴太近距离小于 1 米时信号路径太短人体扰动被淹没。拉到 1 米以上再测。信道选得太拥挤日志频繁出现ESP-NOW 发送错误多半是当前信道拥堵导致缓冲区满了。换一个空闲信道即可。串口数据突然错乱绘图工具 CPU 占用高电脑来不及读串口缓冲日志出现element number is not equal。把波特率调高如 921600能明显缓解。在有人走动的环境里校准基线数据混入他人活动后续所有判断都会漂移。校准请在无人环境完成。想象空间当路由器学会看房间也许不久后家里的路由器不再只是发Wi-Fi的盒子它能在夜里察觉老人跌倒能在婴儿房监测呼吸起伏商场能用信号画顾客热力图工厂能用信号看设备是否异常。把连接变成感知是无线技术正在发生的一场静默升级。现在就动手克隆仓库点亮你的第一份数据 ⚡从一块板、一个路由器开始用十分钟跑通你的第一个 Wi-Fi 感知 demo。想深入了解可以阅读官方文档 docs/zh_CN/CSI-Applications.md 了解应用场景或在 examples/esp-radar/ 里体验自带图形界面的 ESP-CSI Tool。Wi-Fi 能看到什么取决于你今天想不想试。【免费下载链接】esp-csiApplications based on Wi-Fi CSI (Channel state information), such as indoor positioning, human detection项目地址: https://gitcode.com/GitHub_Trending/es/esp-csi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考