Router CSI Lab
ZH EN

工具、脚本与数据集

2026-10-11 · 约 2 分钟

这里汇总本项目实际使用与产出的工具。全部脚本都在真机跑过，配套 10 分钟长稳数据。

1. 采集与分析脚本

脚本 用途 关键点
scripts/csi_capture_session.sh <秒> 一键定时抓包 + 自动分析 macOS/Linux 通用，自动计算帧率与断流
scripts/analyze_csi_capture.py 生成幅度热图 + 1 秒滚动运动指标 只用 numpy/matplotlib，无需 GPU
scripts/csi-watchdog.sh 路由器端守护 每分钟检查 daemon / 接口 / CSI enable，并重放性能调优
scripts/wifi-htmode.sh HE80|HE40 带宽模式切换 同步 CSI daemon 的 bandwidth 元数据
scripts/mt76-wifi-tune 开机自动调优 关闭拖垮速率恢复的固件 ATF

以上脚本与解析工具以 MIT 许可开源，可直接在真机运行 [11]。

# 典型流程：10 秒快测
scripts/csi_capture_session.sh 10

# 10 分钟长稳（会生成原始 bin + 分析图 + 摘要 txt）
scripts/csi_capture_session.sh 600

2. 实测数据（本次公开）

文件 内容 规模
csi_udp_*_60s.bin 60 秒原始 UDP 流 2,777 帧
csi_udp_*_10m.bin 10 分钟原始 UDP 流 57,293 帧，约 58MB [12]
analysis/csi_amplitude_heatmap.png 幅度热图（256 子载波 × 时间） —
analysis/csi_mean_amplitude_motion.png 1 秒滚动运动指标 —

数据格式见复现教程第 6 节（24 字节头 + int16 I/Q 交错）。

CSI 幅度热图

3. 实时可视化平台（开源骨架）

配套的 platform/ 目录提供一套可自建的实时观测台：

目标机器要求很低：一台 2011 年的 i5-2430M + 8GB 内存即可跑 1000+ 记录/秒。

4. 可直接复用的开源项目

项目 用途
espressif/esp-csi [1] ESP32 官方 CSI 应用，入门首选
StevenMHernandez/ESP32-CSI-Tool [2] ESP32 采集工具
Gi-z/CSIKit [3] Python CSI 解析/可视化（多平台）
citysu/csiread [4] 高速 Cython 解析
xyanchen/WiFi-CSI-Sensing-Benchmark（SenseFi）[5] 深度学习模型库
francescopace/espectre [6] ESP32 + ESPHome 运动感知
seemoo-lab/nexmon_csi [7] Broadcom 固件补丁，树莓派 80MHz CSI
ruvnet/RuView [10] Wi-Fi 空间智能（社区项目，宣传语未经同行评审，仅作线索）
NTUMARS/Awesome-WiFi-CSI-Sensing [8] 论文与资源清单
清华 WST 教程 [9] 高校发布的 Wi-Fi 感知动手讲义

5. 硬件（联盟链接）

用途 推荐 说明
入门 CSI ESP32 开发板 ￥20 起，20MHz/30–64 子载波
路由器形态 GL-MT6000（MT7986） 本站实测平台，80MHz/256 子载波
高带宽科研 Nexmon CSI + 树莓派 / PicoScenes 灵活但成本更高

以上为联盟链接位：上线后替换为带推广参数的链接，并保留 rel="sponsored" 标注。

参考与数据来源

本文的每条外部结论都标注来源与证据等级（分级标准）；标注 E 级的是本项目可复现的实测数据。

  1. C 级 · 官方资料 espressif/esp-csi — Applications based on Wi-Fi CSI
    Espressif Systems
    github.com/espressif/esp-csi · 核实: GitHub API 2026-10-11 (stars 1,679) · 官方 README 原文：“All ESP32 series support CSI, including ESP32 / ESP32-S2 / ESP32-C3 / ESP32-S3 / ESP32-C5 / ESP32-C6 / ESP32-C61.”
  2. C 级 · 官方资料 StevenMHernandez/ESP32-CSI-Tool — active/passive CSI extraction for ESP32
    S. M. Hernandez
    github.com/StevenMHernandez/ESP32-CSI-Tool · 核实: GitHub API 2026-10-11 (stars 571, MIT, last push 2024-07-16)
  3. C 级 · 官方资料 Gi-z/CSIKit — Python CSI parsing and visualisation
    G. Zhang
    github.com/Gi-z/CSIKit · 核实: GitHub API 2026-10-11 (stars 307, MIT, last push 2025-02-19) · 支持 Atheros / Intel / Nexmon / ESP32 / FeitCSI / PicoScenes 多种格式。
  4. C 级 · 官方资料 citysu/csiread — fast Cython CSI parser
    S. Zhu
    github.com/citysu/csiread · 核实: GitHub API 2026-10-11 (stars 142, MIT, last push 2024-10-12)
  5. C 级 · 官方资料 xyanchen/WiFi-CSI-Sensing-Benchmark (SenseFi) — deep-learning benchmark
    X. Chen, et al.
    github.com/xyanchen/WiFi-CSI-Sensing-Benchmark · 核实: GitHub API 2026-10-11 (stars 638, MIT, last push 2023-11-06)
  6. C 级 · 官方资料 francescopace/espectre — Wi-Fi CSI motion sensing for ESP32 (ESPHome)
    F. Pace
    github.com/francescopace/espectre · 核实: GitHub API 2026-10-11 (stars 9,505)
  7. C 级 · 官方资料 seemoo-lab/nexmon_csi — CSI extraction on various Broadcom Wi-Fi chips
    SEEMOO Lab, TU Darmstadt
    github.com/seemoo-lab/nexmon_csi · 核实: GitHub API 2026-10-11 (stars 475, last push 2026-09-30)
  8. C 级 · 官方资料 NTUMARS/Awesome-WiFi-CSI-Sensing — curated papers and resources
    NTU MARS Lab
    github.com/NTUMARS/Awesome-WiFi-CSI-Sensing · 核实: GitHub API 2026-10-11 (stars 1129, MIT, last push 2025-07-19)
  9. C 级 · 官方资料 WST — Hands-on Wireless Sensing with Wi-Fi (Tsinghua tutorial)
    Tsinghua University TNS group
    tns.thss.tsinghua.edu.cn/wst/ · 核实: tns.thss.tsinghua.edu.cn HTTP 200, 2026-10-11 · 高校发布的 Wi-Fi 感知动手教程（含讲义与数据集），非同行评审论文。
  10. D 级 · 预印本/百科 ruvnet/RuView — community Wi-Fi spatial-intelligence project
    r. u. v. (community maintainer) · 2026
    github.com/ruvnet/RuView · 核实: GitHub API 2026-10-11 (stars 97,237; created 2025-06-07) · 社区项目，非同行评审：宣传语（实时“空间智能/体征监测”）未见于独立复现，仅作线索、不作结论。
  11. E 级 · 本项目实测 Router CSI Toolkit — 采集/分析/守护脚本（MIT）
    Router CSI Lab · 2026
    csi.okwujun.pw/zh/tools/ · 核实: 仓库打包含 SHA-256，脚本在真机运行
  12. E 级 · 本项目实测 本项目 10 分钟实测抓包（57,293 条 / 600.0 s，SHA-256 00373f83…95e2）
    Router CSI Lab · 2026
    csi.okwujun.pw/zh/datasets/ · 核实: 分片重组逐字节校验通过（2026-10-11）
  13. E 级 · 本项目实测 Router CSI Lab — GL-MT6000 (MT7986) Wi-Fi CSI dataset, 10 s sample + 10 min capture
    Router CSI Lab · 2026
    csi.okwujun.pw/zh/datasets/ · 核实: CC BY 4.0, SHA-256 published; DOI (Zenodo) pending

本页含联盟链接（rel="sponsored"），你通过链接购买不会增加成本，本站可获得少量佣金。