树莓派做 Wi-Fi CSI：采集机、分析主机、Pi 5 兼容与容量规划

作者 Wu Jun · 更新于 2026-10-29 · 约 6 分钟

“树莓派能做 CSI 吗？”没有一个统一答案。它可以是：

1. Nexmon CSI 采集机：树莓派自己的 Broadcom Wi-Fi 芯片被固件补丁接管，直接输出 CSI；
2. 路由器 CSI 的分析主机：MT6000 等路由器采集，树莓派只接收 UDP、存储、分析和提供 API。

两条路线的硬件要求、风险和容量完全不同。先选角色，再买卡、装系统。

0. 一分钟选型

1. 角色 A：树莓派就是 CSI 采集设备

官方支持矩阵把 bcm43455c0 的典型设备列为 Raspberry Pi 3B+、4B 和 5 ^[1]；这是逐帧 CSI 提取平台，并已有同行评审论文说明其方法 ^[2]。

但“型号在支持表里”只是第一步。实际风险包括：

• 固件与内核组合错误，编译或联网失败；
• 采集时 NetworkManager 会释放 wlan0，无线 SSH 随之中断；
• Pi 5 必须使用非 16K 页内核；
• 现代化 Makefile.rpi 要求 nexutil 使用 USE_VENDOR_CMD=1 编译；
• 回退失败时，需要备用 SD 卡或读卡器恢复。

这些步骤和精确检查表已集中写在 Nexmon CSI 实战指南，这里不重复复制易过期命令。

1.1 采集前必须准备的六件东西

2. 角色 A 的数据质量

Nexmon 的 80MHz 包不是“256 个都可用于算法的子载波”，而是包含保护带与空子载波的槽位。官方 README 列出 了不同模式下的无效索引；分析前必须移除或屏蔽。

另外，80MHz 接收机可能收到只占 20MHz 的帧。看到大量接近零的子载波时，应先检查发送端实际带宽和帧类型， 不要先怀疑接收板坏了。

推荐验收顺序：

# 先抓 10 秒；包数为 0 或内容不可解析时不要直接录 10 分钟
sudo tcpdump -i wlan0 dst port 5500 -w csi-10s.pcap
sudo tcpdump -r csi-10s.pcap | wc -l

# 再用 CSIKit 或 csiread 解码并统计有效子载波、包间隔和芯片格式

解析工具可参考 CSIKit ^[3] 与 csiread ^[4]。至少记录：抓包时长、UDP 包数、 CSI 槽位数、有效子载波比例、p95/最大包间隔、发送端带宽和 MAC 过滤条件。

3. 角色 B：树莓派做路由器 CSI 的分析主机

这通常比把树莓派改造成采集机稳得多：

MT6000 / 路由器                        树莓派
CSI daemon  -- UDP/LAN -->  csi_capture.py / tcpdump
                                  |
                                  +-- 原始 bin/pcap
                                  +-- Python 特征
                                  +-- MQTT / REST
                                  +-- 热图 / Home Assistant

树莓派不接触路由器 Wi-Fi 固件，只负责网络服务。即使分析程序崩溃，家庭网络与 CSI 采集端仍可独立恢复。

3.1 真实数据量先算清楚

不要用“Wi-Fi 是千兆”来估算存储。应统计实际 record 或 UDP 包：

bytes/s ≈ records/s × bytes/record + IP/UDP/pcap overhead

本站公开的 MT6000 10 分钟文件给出可核验量级：57,293 条链记录，整包 60,612,922 字节 ^[5]，约等于：

60,612,922 / 599.924 ≈ 101KB/s
60,612,922 / 10min  ≈ 347MB/hour

本站实际 10 分钟文件约 58MB，与上面的整包字节数按十进制/二进制展示方式一致。若把 record 率换成更高值：

最后一行要求同时存在 8 个独立 core/stream 流，不能把普通 Wi-Fi 帧率直接乘八。采集前应根据实际记录长度、 包数和文件增长测一次，别相信标称网口速度。

3.2 硬件与网络预算

USB SSD 比长期高频写 SD 卡更适合连续录制。任何存储介质都应做定期健康检查，并保留 manifest/SHA-256 ^[6]。

4. 推荐部署顺序

1. 在树莓派上使用 64 位 Raspberry Pi OS Lite，接有线网络；
2. 固定局域网 IP，不把 UDP 5500 或管理 API 暴露到公网；
3. 安装 Python、NumPy、抓包工具和项目 toolkit ^[6]；
4. 用本站在线样例或 10 秒数据验证解析器，而不是直接等路由器串流；
5. 接收 10 秒 UDP，检查文件增长与记录数；
6. 扩大到 10 分钟，检查最大空档、磁盘剩余、CPU 与温度；
7. 加上 systemd 守护、日志轮转和磁盘低水位告警；
8. 最后才接 MQTT/REST/Home Assistant。

最小验证命令：

# 1) 看 UDP 是否到达
sudo tcpdump -ni eth0 udp port 5500 -c 20

# 2) 录制 10 秒并观察文件增长
sudo tcpdump -ni eth0 udp port 5500 -w csi-10s.pcap

# 3) 用项目脚本/解析器统计记录数、时长和空档
python3 scripts/analyze_csi_capture.py csi-10m.bin --outdir analysis

实际接口名、record 文件格式和 daemon 端口应以你的路由器配置为准。

5. 角色 B 的可靠性与隐私

• 单向接收：树莓派只接收局域网 UDP，不主动从公网访问路由器；
• 系统隔离：分析服务使用独立用户，禁止 root 运行；
• 数据最小化：只保留目标设备 MAC，公开前脱敏；
• API 鉴权：REST/MQTT 若跨网段，至少加认证与防火墙；
• 保留策略：原始文件、中间特征和图表分开保留，避免磁盘被日志打满；
• 恢复演练：重启树莓派后，采集端应能继续发送，接收端自动恢复；
• 合规：CSI 能反映人的活动，部署前必须让同住者知情，不得用于隐蔽监控。

CSI 感知的能力与限制可参考领域综述 ^[7]。它不是摄像头，也不能仅凭一条树莓派记录推断身份、 医疗状态或穿墙图像。

6. 上线验收清单

7. 什么时候不要用树莓派

• 只是想验证本站数据集：普通电脑更快；
• 只想跑一个单房间存在检测：ESP32 + ESPHome 成本更低；
• 已有 MT6000 并且只想采集：直接在路由器上运行已验证的 mt76 daemon；
• 目标是医疗、安防或无人值守报警：目前的数据率与单一传感器证据不足，应该增加独立传感器和人工复核。

继续阅读：Nexmon 采集机完整步骤 · MT6000 路由器复现 · 10 分钟数据集 · 工具与脚本