做了两年的无线感知方向实验我至今仍然觉得WiFi CSI信道状态信息这套东西是整个领域最让人又爱又恨的入门门槛。爱的是它比RSSI强太多能捕捉到人体呼吸、手势、走动在物理层留下的痕迹恨的是Intel 5300 CSI Tool这套经典工具从买硬件到编译驱动每一步都藏着老旧的坑。这篇文章我把从零开始安装、部署到成功采集第一条CSI数据的过程完整记录下来包括所有踩过的报错和排查思路。文章面向刚接触CSI、被论文里的图搞得心动但复现不出来的人也面向那些卡在编译阶段反复折腾的老哥。这是一篇纯实操向的记录尽量让每一个命令、每一处报错都能对着操作。1. 为什么是CSI从RSSI到信道状态信息的质变1.1 RSSI到底丢了什么信息先用一个直观的例子说明问题。你拿着手机在房间里走一圈很多工具能测到WiFi信号强度RSSI的变化但这个变化的颗粒度太粗了。一个房间里有反射、绕射、散射无线信号从发送端到接收端走了好多条不同的路径这些路径叠加在一起最后在接收端体现为一个总功率值。RSSI就是把这个复杂的物理过程压缩成了一个数字而且这个数字通常只有整数级别单位是dBm波动几个dB完全看不出东西。我最早做呼吸检测实验时用RSSI测量胸腔起伏带来的信号变化折腾了好几天发现信号变化幅度大约只有0.5dB和室内噪声、温度漂移混在一起完全没法区分。这就是为什么后来几乎所有做无线感知的人都会转向CSI——它不再是一个总功率值而是把OFDM系统里不同子载波上各自的幅度和相位都给出来。每个子载波对多径环境里不同路径的敏感程度不一样所以当空间中某个物体移动时不同子载波的变化模式完全不同这就像是用几十个独立的传感器同时盯着同一个目标。1.2 Intel 5300 CSI Tool到底是什么Intel 5300 CSI Tool本质上是华盛顿大学的研究人员维护的一套修改版Linux无线驱动和配套工具。它基于Intel 5300网卡的iwlwifi驱动在网卡收到无线帧的时候主动从物理层的信道估计模块里把CSI数据提取出来再通过netlink通道传给用户态程序。很多人不理解CSI数据到底是怎么算出来的。这里解释一下802.11n标准里数据帧的物理层前导码包含HT-LTFHigh Throughput Long Training Field也就是训练序列。接收端收到这个已知的训练序列后会用它与本地保存的理想序列做对比估算出当前信道对每个子载波的幅度和相位影响。这个估算结果本质上就是CSI。Intel 5300 CSI Tool做的事情并不神奇它只是把这个网卡本来就要计算的中间量拿了出来并且对外开放了一个读取接口。1.3 这套工具的地位与适用场景CSITool从2011年开源到现在十几年过去了你在任何一篇WiFi感知方向的论文里几乎都能看到它的身影。手势识别、呼吸检测、入侵检测、室内定位、人数统计、人体行为识别大量的工作都是在这套工具输出的CSI数据上做的。选择Intel 5300而不是其他方案最主要的原因是生态。这套工具配套的MATLAB脚本、数据格式解析库、通信协议说明都很齐全社区积累的踩坑记录也最多。后出现的Atheros CSI Tool、Nexmon、ESP32 CSI等方案各有优势但无论是数据粒度还是社区成熟度在入门阶段Intel 5300都是最稳妥的选择。它的局限也很明显只能在20MHz带宽下输出30个子载波的信息最多支持3条接收天线硬件是老式的Mini-PCIe接口系统也得用老内核。但你换个角度想正因为约束明确做实验时才容易保持一致性对复现论文里的结果非常有利。2. 动手前的准备硬件、系统与固件缺一不可2.1 硬件选型别在这上面省事Intel 5300无线网卡本身是一张802.11a/b/g/n的Mini-PCIe半高卡支持2条发射天线和3条接收天线也就是2x3 MIMO这是它能输出3路接收CSI的根本原因。买东西的时候我建议买拆机原装卡不要买那种号称全新的工包卡很多工包卡的天线接口有虚焊或者被刷过奇怪的固件会导致CSI幅度异常。主机的选择上老笔记本是首选ThinkPad X200/X220这代机器都有Mini-PCIe插槽拆机方便。台式机也可以但需要一块PCIe转Mini-PCIe的转接板并且把天线引出来注意天线接口要选IPEX座子能对上的。这里有一个非常重要的提醒UEFI和Secure Boot会在加载自定义驱动时设置障碍老笔记本的BIOS引导方式更省心。如果没有老机器就找一个支持关闭Secure Boot的笔记本进BIOS关掉。2.2 系统版本与内核匹配最小折腾方案CSI Tool官方README里推荐的Linux发行版是Ubuntu 10.04 LTS和Ubuntu 11.04对应的内核版本是2.6.32和2.6.38。它没有直接支持新内核因为CSI Tool修改的iwlwifi驱动代码接口和近代内核差异很大。我在实际部署中用的方案是Ubuntu 10.04 x86系统搭配2.6.32内核这个组合最接近官方测试环境。如果你没有Ubuntu 10.04的安装镜像Ubuntu 14.04内核3.13版本也有人成功过编译的时候需要手动打一些补丁处理起来麻烦不少。我实测下来最开始直接在Ubuntu 18.04上尝试编译报错报得怀疑人生后来干脆换回老系统才顺利编译通过。搞实验用的机器推荐准备一块专用硬盘装老系统不要和日常系统混在一起CSI Tool整套环境比较脆弱驱动一升级就可能把系统搞崩。2.3 固件很多人忽略的关键一步无线网卡除了驱动之外还需要固件firmware也就是跑在网卡内部微控制器上的微码。原版Intel 5300的固件只会做常规的无线收发不会向驱动上报CSI数据。CSI Tool配套的固件经过修改支持把物理层信道估计结果发出来。所以除了编译驱动还要把配套的iwlwifi-5000-2.uc.sf固件文件拷贝到系统的固件目录/lib/firmware/下覆盖掉原本的Intel固件。这一步如果漏掉即使驱动编译成功网卡也能正常工作但recvCSI永远收不到数据。这也是很多人编译一切顺利却采集不到数据的头号原因。在动手安装之前把整个环境准备流程理顺可以帮我省掉大量后面排查的时间。我在每次部署时都会先列一个核对表检查项要求验证命令硬件Intel 5300网卡能被系统识别lspci | grep 5300系统Ubuntu 10.04/11.04或兼容老系统lsb_release -a内核2.6.32~3.2.xuname -r编译工具build-essential、git、linux-headersdpkg -l | grep build-essential固件替换为CSI Tool专用固件ls -l /lib/firmware/iwlwifi-5000-2.uc.sf3. 编译与部署让Intel 5300输出CSI的完整过程3.1 获取源码和认识目录结构CSI Tool的源码分为两个部分主仓库是linux-80211n-csitool包含了修改后的iwlwifi驱动和内核模块编译所需的所有代码配套仓库是linux-80211n-csitool-supplementary包含了用户态工具、固件、MATLAB解析脚本和示例数据。两个仓库都要下载。git clone https://github.com/dhalperi/linux-80211n-csitool.git git clone https://github.com/dhalperi/linux-80211n-csitool-supplementary.git打开主仓库目录核心内容在drivers/net/wireless/iwlwifi/下面这就是被修改过的无线网卡驱动源码。配套仓库里几个关键目录的作用需要提前熟悉firmware/放的是专用固件netlink/是内核态和用户态之间传输CSI数据的通信层相关代码matlab/是数据解析脚本sample_data/里有一个官方示例数据文件可以拿来先练手不用自己采集就能验证工具链是否正常。3.2 编译内核模块核心步骤与原理编译CSI Tool的内核模块本质上是把修改过的iwlwifi驱动编译成.ko内核模块然后替换掉系统自带的内核模块。我采用的编译方式是外部模块编译不重新编译整个内核依赖的是当前运行内核的构建目录。先确认当前内核的构建目录存在ls /lib/modules/$(uname -r)/build如果提示没有这个目录需要先安装内核头文件sudo apt-get install linux-headers-$(uname -r)然后进入主仓库编译iwlwifi模块cd linux-80211n-csitool make -C /lib/modules/$(uname -r)/build M$PWD/drivers/net/wireless/iwlwifi modules这里的-C参数是指定进入内核源码构建目录执行MakefileM参数告诉内核构建系统需要编译的外部模块源码在哪里。编译完成后在drivers/net/wireless/iwlwifi/下会生成iwlwifi.ko这就是最后一个大坑所在。我在第一次编译时以为make一下完事了只盯着有没有报错结果这个目录下生成了多个.ko文件而modules_install安装的是对应内核版本目录下的一份老系统的模块目录路径可能和预期不一致安装前最好记录一下生成的模块文件列表安装后再对比一下目标目录里的文件时间戳。3.3 安装模块与替换固件编译完成后安装模块sudo make -C /lib/modules/$(uname -r)/build M$PWD/drivers/net/wireless/iwlwifi modules_install这个命令会把编译好的iwlwifi.ko复制到/lib/modules/$(uname -r)/updates/或其他内核模块搜索路径下。接下来替换固件sudo cp linux-80211n-csitool-supplementary/firmware/iwlwifi-5000-2.uc.sf /lib/firmware/这里有个小细节/lib/firmware/下可能已经存在同名的原版固件文件直接覆盖没问题但最好先备份原始文件万一后面想切回普通模式还能恢复。替换完成后卸载系统自带的iwlwifi驱动模块再加载新的sudo modprobe -r iwlwifi sudo modprobe iwlwifi加载完之后用dmesg查看内核日志确认网卡正常初始化dmesg | grep iwlwifi如果看到类似Firmware loaded和Detected Intel Wireless WiFi Link 5300这样的信息说明驱动和固件配合正常。如果报Microcode SW error detected多半是固件拷贝出了问题检查固件文件名和路径是否正确。3.4 配置monitor模式并验证CSI数据流出驱动加载成功后需要把无线网卡设置到monitor模式监听模式这样网卡才能接收环境中所有的无线帧。创建monitor接口的命令如下sudo ifconfig wlan0 down sudo iw dev wlan0 interface add mon0 type monitor sudo ifconfig mon0 up接口创建成功后把monitor接口固定到一个信道上。注意一定要固定信道不然网卡会在信道间跳来跳去CSI数据源会变得不稳定sudo iw dev mon0 set channel 36 HT20验证CSI数据能正常流出需要两个节点配合。一个节点作为发送端持续发包另一个节点作为接收端运行recvCSI。如果你手头只有一台装好CSI Tool的机器可以用普通路由器或者另一台电脑作为发送端发送端只需要一个WiFi网卡不需要装CSI Tool但协议上必须也是802.11n模式。发送端可以用ping高频发包sudo ping -i 0.01 -s 100 -c 1000 接收端IP接收端运行cd linux-80211n-csitool-supplementary sudo ./recvCSI /tmp/csi.dat运行几秒后按CtrlC停止然后检查文件大小ls -l /tmp/csi.dat如果文件大小不为零说明已经有CSI数据写入了。接下来就可以进入数据解析阶段。4. 解读数据从recvCSI文件到CSI矩阵4.1 文件格式与数据结构recvCSI写出的文件是一个二进制流每收到一个无线帧就往文件里追加一段数据。每段数据的开头是2字节的field_len表示后面跟的csi_struct结构体的字节数然后是2字节的code表示数据类型如果是CSI数据这个值是固定标识。再往后就是一个完整的csi_struct。csi_struct里面包含时间戳、信道频率、子载波数量、接收天线数、发送天线数、噪声、RSSI以及复数CSI数据。以官方示例数据为例一个典型的数据包CSI数据的维度是接收天线数 × 发送天线数 × 30。这是因为Intel 5300网卡有3条接收链路而你实际能用几条天线取决于硬件连接发送端的发送天线数则取决于发送端网卡和发送模式。在动手写代码解析前我强烈建议先用配套仓库里的官方示例数据练手。示例文件路径是linux-80211n-csitool-supplementary/sample_data/sample_data_2ant_1tx.dat它来自2根接收天线、1根发送天线的配置。直接拿这个文件跑到通就不会怀疑自己的数据格式解析有问题。4.2 用MATLAB读取CSI数据进入MATLAB脚本目录cd(~/linux-80211n-csitool-supplementary/matlab)先读示例文件csi_trace read_bf_file(../sample_data/sample_data_2ant_1tx.dat);read_bf_file返回一个cell数组每个元素对应一个数据包。单独看第一个包csi_entry csi_trace{1}; csi get_scaled_csi(csi_entry); size(csi)你会看到类似2 1 30的输出分别对应2根接收天线、1根发送天线、30个子载波。get_scaled_csi做的事情是把原始CSI数据按照AGC增益、噪声等参数进行缩放得到归一化的信道频率响应方便做幅度和相位分析。如果你采集的数据文件是自己用recvCSI得到的读取方法完全一样唯一要注意的是文件路径换成自己的文件。下面的代码可以把每个包的30个子载波幅度打印成一张时序图直观看到CSI幅值随时间的变化csi_trace read_bf_file(/tmp/csi.dat); csi_amp_pkt zeros(length(csi_trace), 30); for i 1:length(csi_trace) csi_entry csi_trace{i}; if isempty(csi_entry) continue; end csi get_scaled_csi(csi_entry); csi_amp_pkt(i, :) db(abs(squeeze(csi(1,1,:)).)); end imagesc(csi_amp_pkt); xlabel(子载波索引); ylabel(数据包序号); colorbar;运行这段代码你会看到一张颜色条带图。如果人在环境中走动某些子载波的幅度会明显波动这就是后续所有分析的基础素材。4.3 30个子载波是怎么来的CSI Tool输出的子载波数量是30而不是更多这和Intel 5300网卡的硬件实现有关。在802.11n的20MHz带宽下OFDM系统一共有56个数据子载波但CSITool修改的驱动在提取CSI时只取其中30个代表性子载波。这不是随机抽取而是在频域上均匀间隔采样。这30个子载波分布在-28到28之间不包含直流频率不同意味着它们对多径环境中不同长度的路径敏感度不一样。低频子载波波长长对细小物体的移动不太敏感高频子载波波长短对微小的位移更敏感。接收端3根天线位于不同空间位置每根天线看到的30个子载波的相位和幅度都不一样这个空间和频率的双重分辨率是RSSI方案完全无法比拟的。5. 我踩过的坑从编译报错到数据异常排查5.1 编译报错头文件缺失与内核接口不匹配最经典的报错是编译时出现fatal error: net/mac80211.h: No such file or directory这类头文件缺失。原因就是/lib/modules/$(uname -r)/build目录为空或者没有正确指向内核源码。解决方法是安装对应内核版本的linux-headers。另一个高频报错是error: too many arguments to function ieee80211_...这种内核接口不匹配。原因是你用的内核版本太新新版内核把无线子系统的一些函数签名改了而CSI Tool的驱动代码是基于2.6.x时代的内核API写的。遇到这类错误不建议硬改驱动代码换回老内核更划算。5.2 固件没替换网卡初始化失败我遇到过最让人迷惑的情况是驱动编译成功、模块加载成功网卡就是不工作dmesg里出现Microcode SW error detected。排查思路是先确认固件文件在不在、文件名对不对、拷贝路径是不是/lib/firmware/。我一开始图省事直接make install把固件安装到了发行版的固件目录结果系统实际搜索固件的路径是/lib/firmware根本没用到新固件。手动拷贝到/lib/firmware/iwlwifi-5000-2.uc.sf后重新modprobe -r再modprobe问题才解决。5.3 天线数量和子载波的理解误区很多人在读自己的数据时发现size(csi)不是预期的3 1 30就怀疑自己的设备坏了。实际上get_scaled_csi返回的矩阵第一维是实际启用的接收天线数不是硬件的3根这取决于连接的天线接口和驱动初始化状态。第二维是发送端在帧头里声明的发送天线数如果发送端用普通路由器通常只有1根发送天线那么第二维就是1。第三维基本都是30。还有人在分析数据时发现CSI相位看起来像锯齿一样乱跳这不一定是你实验环境出了问题。锚定在WiFi网卡上的晶振和接收端本振之间存在频率偏移导致原始CSI相位里混入了一个线性相位偏差。后续做相位分析前需要做一个线性项校准这部分等下一篇文章详细说。5.4 数据质量自检清单无论刚开始还是做了很久的CSI实验我都会在采集完数据后先问自己几个问题快速判断数据是否可靠检查项合格标准不合理时排查方向静态CSI幅度30个子载波的幅度在多次测量中基本稳定天线松动、周围物体移动、信道跳变RSSI字段接收信号强度在一个合理范围内距离太远或太近、发射功率异常包率每秒收到的CSI包数量稳定ping间隔不稳、monitor接口掉线数据维度满足接收天线数 × 发送天线数 × 30发送端是否启用空间流、天线数配置从编译成功到拿到第一张稳定的CSI幅度图我前后花了将近一周。最难的不是某个具体配置而是整个链条涉及驱动、固件、系统内核、无线信道四个层面任何一个环节出错都会表现为“明明编译过了但就是没数据”。建议新手在搭建时一定先用官方示例文件把MATLAB解析流程跑通再开始真实采集这样可以把问题定位在采集端而不是解析端排查效率高出一大截。Intel 5300这套工具虽然老但作为理解WiFi感知原理的敲门砖依然值得认真走一遍你踩过的每一步坑都在为后面做更复杂的CSI信号处理打基础。下一篇文章我会重点写CSI相位校准和幅度滤波的细节以及如何用CSI做一个最简单的呼吸检测Demo到时候见。