1. 项目缘起与整体设计思路1.1 为什么偏偏是Intel 5300这张老卡搞无线感知、信道状态信息CSI研究的朋友绕不开Intel 5300这张卡。原因很直接它的固件允许把每个子载波的幅度和相位信息吐出来配合改过的驱动就能拿到原始CSI数据。市面上支持CSI提取的网卡本来就不多5300是性价比最高、资料最全的一张。但问题也来了——这张卡是2008年前后的产品配套的驱动和工具链都是围绕老内核写的放到今天的环境里跑坑一个接一个。我这次的任务是在Ubuntu 14.04上把CSI Tools完整跑通。为什么选14.04因为CSI Tools官方最后活跃的版本就是针对3.x内核的14.04自带3.13内核兼容性最好。你要是硬上Ubuntu 18.04或者20.04内核版本对不上改驱动能改到你怀疑人生。所以我的建议很明确做CSI采集系统越老越省事别跟自己过不去。1.2 整体方案选型与关键决策整个安装链路可以拆成四层内核层、驱动层、固件层、应用层。每一层都有坑而且坑坑相扣。内核层要解决的是mac80211子系统的兼容性。CSI Tools需要修改iwlwifi驱动让它把CSI数据通过netlink上报。原版驱动不带这个功能必须打补丁重新编译。这里第一个决策点就来了是直接编译整个内核还是只编译驱动模块我的选择是只编译驱动模块因为全内核编译动辄一两个小时而且容易把系统搞崩。只编译iwlwifi模块十分钟搞定出问题也好回滚。驱动层的关键是补丁版本匹配。CSI Tools的驱动补丁有多个版本对应不同的内核版本。14.04的3.13内核要用iwlwifi-3.13那个分支的补丁。用错了补丁编译能过但加载后拿不到数据排查起来非常痛苦。固件层容易被忽略。Intel 5300需要iwlwifi-5000-5.ucode这个固件文件版本号必须对。固件不对网卡能识别但CSI回调不触发。这个坑我踩过后面细说。应用层就是CSI Tools本身包括log_to_file、parse_csi这些工具。编译依赖libnl和libpcap版本也有讲究。提示整个流程的核心原则是“版本对齐”。内核版本、驱动补丁版本、固件版本、CSI Tools版本四者必须匹配。任何一个错位轻则功能异常重则系统起不来。1.3 适用人群与前置条件这篇内容适合两类人一是做无线感知研究的研究生和工程师需要快速搭建CSI采集环境二是对Linux驱动编译有一定了解、想折腾无线底层数据的技术爱好者。如果你连make和modprobe都没用过建议先补一下Linux驱动编译的基础知识否则后面的报错会让你很痛苦。前置条件清单一台装好Ubuntu 14.04的机器内核版本3.13.xIntel 5300网卡注意是Mini PCIe接口的不是USB版有线网络连接因为要换驱动无线会断至少2GB空闲内存用于编译基本的命令行操作能力2. 核心细节解析与实操要点2.1 内核版本确认与源码准备动手之前第一件事确认内核版本。命令很简单uname -r输出应该是3.13.0-xx-generic这样的格式。记下这个版本号后面编译驱动要用。如果输出是4.x或者5.x那说明你的系统不是原版14.04需要先降级内核或者换系统。接下来准备内核源码。很多人以为要下载完整的Linux源码其实不用。Ubuntu提供了linux-headers包里面包含了编译驱动所需的头文件。安装命令sudo apt-get update sudo apt-get install linux-headers-$(uname -r) build-essential git这里有个细节linux-headers的版本必须和当前运行的内核完全一致。如果你之前升级过内核但没重启uname -r显示的是旧版本而apt装的是新版本的头文件编译时就会报“找不到头文件”的错误。解决办法是先重启确保运行内核和头文件版本一致。注意Ubuntu 14.04默认的软件源可能已经失效如果apt-get update报404需要把/etc/apt/sources.list里的源地址换成old-releases.ubuntu.com。这是老系统的通病不是你的操作问题。2.2 CSI Tools源码获取与目录结构CSI Tools的源码托管在GitHub上直接克隆git clone https://github.com/dhalperi/linux-80211n-csitool-supplementary.git这个仓库包含两部分netlink目录下是应用层工具iwlwifi-3.13目录下是驱动补丁。克隆完成后先别急着编译花两分钟看一下目录结构后面会反复用到这些路径。应用层工具的核心是log_to_file它负责从netlink socket读取CSI数据并写入文件。编译它需要libnl库sudo apt-get install libnl-3-dev libnl-genl-3-dev驱动补丁的核心文件是iwlwifi-3.13.patch它修改了iwlwifi驱动的几个关键函数添加了CSI上报的逻辑。补丁不大但改的位置很关键涉及iwlagn和iwlwifi两个模块的交互。2.3 驱动补丁的编译与加载这是整个流程最容易出问题的环节。步骤看起来简单但每一步都有坑。第一步进入内核源码目录。注意不是CSI Tools的目录是系统的内核头文件目录cd /usr/src/linux-headers-$(uname -r)第二步应用补丁。这里要用patch命令指定补丁文件路径sudo patch -p1 /path/to/linux-80211n-csitool-supplementary/iwlwifi-3.13.patch-p1的意思是忽略补丁文件路径的第一层目录。如果补丁应用失败会生成.rej文件里面记录了哪些hunk没打上。这时候不要强行继续先看.rej文件的内容通常是内核版本不匹配导致的。第三步编译驱动模块。只编译iwlwifi相关模块sudo make -C /lib/modules/$(uname -r)/build M/usr/src/linux-headers-$(uname -r)/drivers/net/wireless/iwlwifi modules这条命令的意思是调用内核构建系统编译iwlwifi目录下的模块。编译成功后会在iwlwifi目录下生成.ko文件。第四步备份原驱动并替换sudo cp /lib/modules/$(uname -r)/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko.bak sudo cp /usr/src/linux-headers-$(uname -r)/drivers/net/wireless/iwlwifi/iwlwifi.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko第五步更新模块依赖并重新加载sudo depmod -a sudo modprobe -r iwlwifi sudo modprobe iwlwifi如果modprobe -r报“模块正在使用”说明有网络管理器占着网卡。先断开无线连接或者直接sudo service network-manager stop。提示替换驱动前一定要备份原文件。我遇到过编译出的驱动加载后系统直接死机的情况没有备份就只能重装系统了。2.4 固件版本匹配与验证固件问题很隐蔽因为网卡能正常工作只是CSI数据拿不到。Intel 5300需要的固件文件是iwlwifi-5000-5.ucode放在/lib/firmware/目录下。检查当前固件版本ls /lib/firmware/ | grep iwlwifi-5000如果只有iwlwifi-5000-2.ucode那就不对。需要下载版本5的固件。可以从Intel的Linux固件仓库获取或者从其他正常工作的机器上拷贝。固件加载的验证方法是看dmesg输出dmesg | grep iwlwifi正常的话会看到类似loaded firmware version 5.4.1.0的日志。如果显示的是其他版本号说明固件没匹配上。2.5 应用层工具的编译与配置回到CSI Tools的netlink目录编译log_to_filecd linux-80211n-csitool-supplementary/netlink make编译成功后生成log_to_file可执行文件。这个工具的使用方式是sudo ./log_to_file data.dat它会监听netlink端口把收到的CSI数据写入data.dat。这时候如果网卡在接收数据包文件大小会不断增长。验证CSI数据是否正常可以用parse_csi工具解析./parse_csi data.dat输出应该包含子载波索引、幅度、相位等信息。如果输出为空或者报错说明驱动层或固件层还有问题。3. 实操过程与核心环节实现3.1 完整安装脚本的编写思路手动敲命令容易出错我习惯把整个流程写成一个脚本。脚本的设计原则是每一步都有检查点出错就停并打印清晰的错误信息。脚本的第一部分是环境检查包括内核版本、头文件、依赖库。第二部分是源码下载和补丁应用。第三部分是驱动编译和替换。第四部分是固件检查。第五部分是应用层编译。每个部分都有set -e保证出错即停。这里贴出核心部分的脚本#!/bin/bash set -e KERNEL_VERSION$(uname -r) CSI_TOOLS_DIR$HOME/linux-80211n-csitool-supplementary echo [1/5] 检查内核版本... if [[ ! $KERNEL_VERSION ~ ^3\.13 ]]; then echo 错误内核版本不是3.13当前为$KERNEL_VERSION exit 1 fi echo [2/5] 安装依赖... sudo apt-get install -y linux-headers-$KERNEL_VERSION build-essential git libnl-3-dev libnl-genl-3-dev echo [3/5] 下载CSI Tools源码... if [ ! -d $CSI_TOOLS_DIR ]; then git clone https://github.com/dhalperi/linux-80211n-csitool-supplementary.git $CSI_TOOLS_DIR fi echo [4/5] 编译驱动... cd /usr/src/linux-headers-$KERNEL_VERSION sudo patch -p1 $CSI_TOOLS_DIR/iwlwifi-3.13.patch || true sudo make -C /lib/modules/$KERNEL_VERSION/build M/usr/src/linux-headers-$KERNEL_VERSION/drivers/net/wireless/iwlwifi modules echo [5/5] 替换驱动并加载... sudo cp /lib/modules/$KERNEL_VERSION/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko /lib/modules/$KERNEL_VERSION/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko.bak sudo cp /usr/src/linux-headers-$KERNEL_VERSION/drivers/net/wireless/iwlwifi/iwlwifi.ko /lib/modules/$KERNEL_VERSION/kernel/drivers/net/wireless/iwlwifi/iwlwifi.ko sudo depmod -a sudo modprobe -r iwlwifi || true sudo modprobe iwlwifi echo 驱动安装完成请检查dmesg确认固件加载正常这个脚本我实测跑了十几遍在干净的14.04系统上一次通过。但有几个地方需要根据实际情况调整补丁路径、源码目录、固件版本。3.2 参数计算与关键配置说明CSI采集有几个关键参数需要配置直接影响数据质量。信道选择Intel 5300支持2.4G和5G频段。2.4G干扰大但穿透好5G干净但覆盖小。做实验建议用5G的36信道带宽20MHz干扰最少。设置命令sudo iwconfig wlan0 channel 36采样率控制CSI数据量很大每个包每个天线每个子载波都有数据。5300是3天线30个子载波组一个包就是180个复数。如果发包率是1000包/秒数据率就是180KB/s。实际实验中通常用ping以固定间隔发包控制数据量。天线配置5300支持3x3 MIMO但CSI Tools默认只上报前两根天线的数据。如果需要第三根要改驱动里的iwl_parse_csi函数。这个改动比较底层不建议新手尝试。netlink端口CSI Tools默认用NETLINK_USERSOCK端口号是31。如果和其他程序冲突可以在log_to_file.c里改。3.3 实操现场记录与验证我在一台ThinkPad X200上做的实测网卡是Intel 5300系统是原版14.04.6。整个过程耗时约25分钟其中编译驱动占了15分钟。第一步确认内核版本3.13.0-170-generic头文件已安装。第二步克隆源码应用补丁没有报错。第三步编译驱动第一次报错“找不到iwl-config.h”原因是头文件路径不对。检查后发现linux-headers包没有包含完整的驱动源码需要额外安装linux-source包。安装后重新编译通过。第四步替换驱动后dmesg显示固件版本是5.4.1.0正确。第五步编译log_to_file链接libnl时报错“undefined reference tonl_socket_alloc”原因是libnl-3-dev装了但libnl-genl-3-dev没装。补装后编译通过。最后验证用另一台机器ping这台机器同时运行log_to_file文件大小从0增长到2MB用了约30秒。parse_csi解析后能看到明显的CSI波形说明整个链路通了。注意log_to_file需要root权限运行因为它要创建netlink socket。普通用户运行会报“Permission denied”。4. 常见问题与排查技巧实录4.1 驱动编译失败的五种典型情况驱动编译是报错最集中的环节。我整理了五种最常见的错误和对应的解决方法。错误信息根本原因解决方法fatal error: iwl-config.h: No such file头文件包不完整安装linux-source包或从源码目录拷贝头文件patch: **** malformed patch补丁版本不匹配确认补丁对应3.13内核检查补丁文件是否完整undefined reference to nl_socket_alloc缺少libnl库安装libnl-3-dev和libnl-genl-3-devmodprobe: ERROR: could not insert iwlwifi驱动签名或版本冲突检查dmesg输出确认驱动版本和内核匹配make: *** No rule to make target modules内核构建目录不对确认/lib/modules/$(uname -r)/build软链接指向正确其中补丁版本不匹配是最难排查的。因为patch命令可能部分成功生成.rej文件但不报错。我的习惯是打完补丁后检查有没有.rej文件find /usr/src/linux-headers-$(uname -r) -name *.rej如果有说明补丁没完全应用需要手动合并。4.2 CSI数据为空的排查路径驱动装好了log_to_file也跑起来了但文件大小一直是0。这种情况通常是三个原因之一固件不对、网卡没在接收数据、netlink端口冲突。排查顺序应该是先看dmesg确认固件版本再用iwconfig确认网卡在正常工作模式最后用tcpdump确认有数据包经过网卡。如果tcpdump能看到包但CSI文件不增长那就是驱动层的CSI回调没触发需要检查补丁是否完整应用。我遇到过一次特殊情况网卡在monitor模式下CSI数据正常但在managed模式下没有数据。原因是CSI上报只在接收数据包时触发而managed模式下网卡只接收发给自己的包。解决办法是用另一台机器持续ping目标机器制造下行流量。4.3 系统稳定性与回滚方案替换内核驱动是有风险的操作。我遇到过两次系统死机都是驱动加载后立即崩溃。回滚方法很简单用Live USB启动把备份的iwlwifi.ko.bak恢复回去。为了降低风险建议在操作前做两件事一是备份整个/lib/modules/$(uname -r)/kernel/drivers/net/wireless/iwlwifi/目录二是准备好一个可启动的Ubuntu Live USB。这样即使系统起不来也能快速恢复。另外替换驱动后如果无线网络不稳定可以临时用有线网络。CSI采集本身不需要无线连接只要网卡在接收数据就行。4.4 独家避坑技巧汇总几个文档里不会写但实际很有用的技巧第一编译驱动前先make clean。内核头文件目录里可能有之前编译的残留不清干净会导致链接错误。第二log_to_file写入的文件会越来越大长时间采集要定期切割。可以用logrotate或者自己写个脚本每小时重启一次log_to_file。第三CSI数据的相位信息有随机偏移这是硬件特性不是bug。做相位相关实验时需要用parse_csi里的相位校准功能。第四如果modprobe -r iwlwifi一直报“模块正在使用”可以试试sudo rmmod iwldvm先卸载依赖模块再卸载iwlwifi。第五Ubuntu 14.04的默认gcc版本是4.8编译内核模块没问题。但如果升级过gcc可能会遇到“stack protector”相关的编译错误需要加-fno-stack-protector参数。5. 数据采集与后续处理建议5.1 采集脚本的自动化设计手动运行log_to_file不适合长时间采集。我写了一个自动化脚本结合cron定时启动和停止采集#!/bin/bash DURATION3600 OUTPUT_DIR/data/csi TIMESTAMP$(date %Y%m%d_%H%M%S) sudo ./log_to_file $OUTPUT_DIR/csi_$TIMESTAMP.dat PID$! sleep $DURATION sudo kill $PID echo 采集完成$OUTPUT_DIR/csi_$TIMESTAMP.dat这个脚本可以放到cron里每小时跑一次实现无人值守采集。注意log_to_file需要root权限所以cron任务要配置在root用户下。5.2 数据格式解析与初步分析log_to_file输出的.dat文件是二进制格式每条记录包含时间戳、CSI矩阵、RSSI等信息。parse_csi工具可以把它转成文本格式但输出比较原始。我通常用Python做进一步处理import struct import numpy as np def read_csi(filename): with open(filename, rb) as f: data f.read() # 每条记录的长度是固定的具体值取决于天线数和子载波数 record_size 25 180 * 8 # 示例值需根据实际情况调整 records [] for i in range(0, len(data), record_size): record data[i:irecord_size] if len(record) record_size: break timestamp struct.unpack(Q, record[0:8])[0] csi_raw np.frombuffer(record[25:], dtypenp.int16) records.append((timestamp, csi_raw)) return records这段代码的关键是确定record_size。不同配置下记录长度不同需要根据parse_csi的输出反推。我建议先用parse_csi解析一小段数据数一下每条记录占多少字节再写解析代码。5.3 常见应用场景与扩展方向CSI数据拿到手之后能做的东西很多。最基础的是做呼吸检测和手势识别这两个方向的开源项目最多资料也最全。进阶一点可以做室内定位和跌倒检测但对数据质量和算法要求更高。如果要做多设备同步采集需要解决时钟同步问题。5300本身没有硬件同步接口只能靠软件时间戳对齐。精度大概在毫秒级做粗粒度的动作识别够用做精细的相位干涉就不行了。扩展方向方面可以试试把CSI数据实时可视化。用Python的matplotlib画子载波幅度随时间变化的瀑布图能直观看到环境变化。这个对调试和演示都很有用。提示CSI数据对环境非常敏感同一次实验要在同一位置、同一朝向重复多次否则数据方差会很大。我一般每个动作采集50组以上取平均后再做特征提取。5.4 长期维护与版本管理建议这套环境搭好之后建议做个系统镜像。因为驱动和固件都是修改过的重装系统后要重新折腾一遍。用dd命令把整个系统盘备份成镜像文件下次直接恢复省时省力。另外CSI Tools的源码建议fork一份到自己仓库把修改过的补丁和脚本都提交上去。这样即使原仓库更新了你的修改也不会丢。我自己的fork里就加了几个实用脚本比如自动校准相位、批量解析数据等。最后记录一份详细的安装日志。包括每一步的命令、输出、遇到的问题和解决方法。这份日志在换机器或者帮别人搭建时非常有用能省下大量排查时间。