HackRF One软件无线电入门：SDRSharp收音与GNU Radio开发

简介《HackRF One软件无线电平台用户手册》面向软件无线电初学者、嵌入式开发者与无线电爱好者围绕高灵活性SDR平台的入门与开发展开帮助读者理解射频信号捕获、解调和分析的基本方法并搭建Windows与Linux实验环境。包内为1个PDF文件压缩包约2.49MB内容集中、便于检索适合作为随查随用的平台手册。正文从平台简介与硬件分析讲起覆盖Windows下运行库、USB驱动、SDRSharp及libhackrf编译Linux下GNU Radio、gqrx与虚拟机环境搭建并延伸到常用模块、工程示例以及FM音频发射和广播接收实例。已有1515人学习读者可据此掌握驱动安装、环境配置、库编译与基础收发实验的完整思路也能按Windows/Linux两条主线查漏补缺。1. 先搞清楚它是什么一块能被代码改写的收音机主板第一次见到 HackRF One 的人多半会问同一个问题这不就是块巴掌大的电路板吗插上天线能干嘛有人说它能听广播有人说它能看频谱还有人说它能自己发信号——三个说法都对但都没说到点子上。它是软件无线电Software Defined Radio简称 SDR平台。传统收音机把滤波、混频、解调这些活儿用电容电感焊死在电路里出厂就把频段定死了HackRF One 只负责把空中的射频信号搬下来、变成电脑能读的数字流剩下的解调、滤波、显示全在电脑上用软件算。换一个软件、改一行参数它就变成另一台设备。射频范围 10MHz 到 6GHz瞬时带宽 20MHzADC/DAC 是 8bit、20Msps——这三个数字决定了它能干什么、干不了什么。适合谁想动手做无线实验、又不想为一个想法买一堆专用仪器的人。零基础也能上手前提是愿意装驱动、敲命令。2. 为什么值得学从「买一台设备」到「改一行参数」很多新手对这块板子的第一印象是「好像很专业」第二反应就是「我大概用不上」。这种犹豫通常来自一个误解以为无线电实验必须有一屋子仪器。实际上软件无线电最有价值的地方恰恰是把门槛往下压——你手里的电脑就是那台仪器板子只负责把空中的信号原样搬进来。2.1 传统无线电和软件无线电差的到底是什么老式对讲机里决定它能收哪个频段的是里面那堆电感、电容和滤波器焊上去就定了。想听另一个频段最直接的办法是再买一台机器。SDR 把这个关系翻过来前面那段射频电路只负责「把信号搬下来」搬下来之后的所有判断——这是调频还是调幅、带宽留多宽、要不要滤掉隔壁的强台——统统变成电脑里的运算。打个比方传统收音机像一台出厂就烧死了程序的游戏机只能玩卡带上那一个游戏HackRF One 像一台通用电脑装上什么软件就是什么设备。这个差别带来的直接好处是你想验证一个想法不用等买硬件改几行参数重跑一次就行。对新手来说这个特性还有一个隐藏价值——它容错。参数设错了不会烧东西最多是屏幕上什么都看不到改回来再跑一次。学习成本主要花在环境和思路上而不是花在钱上。2.2 把参数表读懂10MHz 到 6GHz、20MHz 带宽、8bit 各限制了什么拿到一块板子最该先看的不是软件界面是那几行技术参数。它们不是给专家看的装饰而是你后面每一次「为什么我听不到」的答案来源。参数手册标称值对新手意味着什么射频范围10MHz – 6GHz覆盖调频广播、对讲、航空波段、部分蜂窝频段和 2.4G 频段低于 10MHz 的信号收不到信号带宽20MHz一屏最多同时看 20MHz 宽的频谱再宽就得拼接采样精度8bit理论动态范围约 48dB强弱信号差太多时弱信号容易被淹没采样速率20Msps决定你能看多宽的瞬时频谱也决定 USB 口和 CPU 的压力发射功率14dBm很小的功率桌面实验够用别指望它覆盖多远接口USB 2.0数据吞吐的天花板就在这里后面算一次你就明白射频范围这一行最好理解10MHz 到 6GHz 是一段很宽的范围但「能覆盖」不等于「能同时看」。这就是第二行带宽的意义——你一次只能盯住 20MHz 宽的一小段想看别的频段得把中心频率挪过去。很多人第一次用的时候以为打开软件就能看到整条频谱结果发现只有一小条原因就在这里。8bit 这一行最容易被忽略也最容易让人踩坑。8 位量化意味着理论动态范围只有 6.02 乘以 8大约 48dB。现实里的场景往往是这样的旁边有个特别强的调频台你想听的那个弱信号就在它隔壁几百千赫。这时候不是软件不行是前端已经被强信号占满了量程。解决办法是调增益、加衰减而不是反复重装驱动。2.3 动手算一次20Msps 到底是个什么概念参数表上的数字看着抽象算一遍就具体了。软件无线电采的是 I、Q 两路成对的信号每一路都是 8bit所以每秒的数据量是采样率乘以 2。这段小脚本把账算清楚# 估算 HackRF One 满速采样时每秒要从 USB 口搬走多少数据 sample_rate 20_000_000 # 采样率 20 Msps手册标称上限 bits_per_sample 8 # ADC/DAC 位宽 8bit channels 2 # I 路 Q 路成对采样 bytes_per_second sample_rate * (bits_per_sample / 8) * channels print(f每秒原始数据量{bytes_per_second / 1e6:.0f} MB/s) # 换算一下16GB 空间能录多久 minutes 16 * 1024**3 / bytes_per_second / 60 print(f16GB 大约能录{minutes:.1f} 分钟) # 8bit 量化的理论动态范围 print(f理论动态范围约{6.02 * bits_per_sample:.0f} dB)跑出来的结果大概是每秒 40MB、16GB 能录七分钟左右、动态范围 48dB。这三个数字直接对应三个新手常见的困惑为什么采样率拉满之后画面开始一顿一顿USB 2.0 撑得吃力为什么录了几分钟硬盘就满了原始 IQ 数据不做压缩为什么隔壁强台一开我想要的弱信号就没了动态范围不够。第一次算完这个账我对「采样率不是越高越好」这句话才算真信了。入门阶段把采样率设在 2Msps 到 8Msps画面流畅、CPU 也不叫比硬拉到 20Msps 舒服得多。2.4 三种最典型的玩法听、看、发第一种是听。装个图形软件把中心频率调到本地调频广播的位置选宽带调频解调就能从电脑音箱里听到声音。这条路最短成功率最高也是手册里花最多篇幅讲的部分。第二种是看。用 GNU Radio 搭一条数据流把信号从板子取出来画成频谱图和瀑布图看看某个频段里到底有几个信号、它们间隔多远、哪个强哪个弱。这一步开始接触「流图」的概念是从使用者转向搭建者的分水岭。第三种是发。手册里给了完整的例子用板子发射一段调频音频以及接收调频广播。发射这条路的门槛不在于代码而在于你得先想清楚发什么、发到哪个频率上。练习时请在允许的范围内做别盖掉别人的正常通信——这不是技术问题是常识问题。2.5 给自己定第一个目标听到一段调频广播新手最容易犯的错是把目标定得太大。一上来就想解一个复杂协议、做一台频谱分析仪链路一长中间任何一个环节卡住都会让人放弃。我建议第一个目标就定成「听到一段调频广播」。理由很实在成功判据明确耳朵能听见声音不用猜、链路短装驱动、开软件、设三个参数、失败点少无非是驱动、增益、频率这三处。等这一步跑通了你对整条链路的信心会完全不一样后面再看 GNU Radio 那些模块至少知道信号是从哪来的。3. Windows 上先听到声音驱动、SDRSharp 和五步配置Windows 起步的好处是熟悉鼠标点几下就能装软件。坏处是这套环境离「自己写代码」还有一段距离。这一章先把听声音这件事做完把成功体验拿到手下一章再换环境。3.1 插电之前先认脸指示灯和接口各管什么板子上一圈小灯和接口第一次看确实容易懵。按手册的标注它们大概是这么分工的位置名称作用按键复位按键硬件复位程序卡死时用指示灯3.3V 电源指示亮说明主供电正常按键固件更新按键更新固件时配合使用新手先别碰指示灯1.8V 电源指示亮说明内核供电正常指示灯RF 模块供电指示亮说明射频部分通电了指示灯USB 状态指示亮说明电脑认到了板子指示灯RF 接收指示只在接收时亮指示灯RF 发送指示只在发射时亮接口射频输入输出接天线的地方接口时钟输入、时钟输出多块板子同步或级联时才用接口USB 接口连电脑插上 USB 之后正常情况下你会看到几个电源灯和 USB 灯常亮收发指示灯是灭的——它们要等软件真正开始收或发才会亮。时钟那两个口单板入门阶段完全用不上看到它们空着不用慌。3.2 两步把驱动装上运行库和 Zadig第一步是装运行库。手册里明确要求先装 VS2012 的运行库运行安装包里那个 vcredist_x86.exe 就行。这一步很多人会跳过结果后面打开 SDR 软件直接报缺少 DLL回头再找问题反而更费时间。第二步是换驱动。把板子插上电脑Windows 通常会自己认一个通用 USB 驱动但 SDR 软件要的不是它。打开 Zadig 这个工具在下拉菜单里找到 HackRF One 设备然后点「Install WCID Driver」。装完之后设备应该能被正常识别不再带黄色感叹号。提示装驱动的时候板子要保持插着中途别拔。装完最好拔插一次让系统重新枚举设备。3.3 SDRSharp 五步配置从解压到听到声音SDRSharp 是绿色软件解压完直接运行不用安装。下面这五步照着做一般十分钟内能听到声音。第一步在 Source 栏里把信号源选成 HackRF。这一步决定了软件去哪里拿数据选错了后面所有配置都是白搭。第二步点 Start 按钮再点 Configure 打开参数窗口。这里有个坑要提前说必须先点 Start否则配置窗口里的增益滑块是灰色的拖不动。滑块分两个LNA Gain 是低噪放增益VGA Gain 是可变增益放大器增益都往中间调一点先试。第三步展开 Radio 选项卡把解调类型选成 WFM也就是宽带调频。滤波器类型选 Blackman-Harris 4带宽填 250000步进频率设成 50kHz然后把 Snap to grid 勾上。这几个参数的作用我列在下面这张表里配置项建议值作用解调类型WFM调频广播用的就是宽带调频滤波器类型Blackman-Harris 4抑制邻近频道的强信号减少串音滤波器带宽250000调频广播信道本身不宽留一点余量即可步进频率50kHz广播频点间隔多为 100kHz步进小一点不会漏台Snap to grid勾选拖动频率时自动吸附到整数频点好对齐第四步展开 Audio 选项卡把输出设备选成电脑的声卡。如果你的电脑接了耳机或者外置声卡记得在这里选对否则会出现「频谱在动但没声音」的情况。第五步回到主界面点 Run然后在频谱上拖动或者直接在频率框里输入一个本地的广播频点。听到声音就说明整条链路通了。3.4 换解调方式AM、航空波段、LSB 和 USB 都在同一个下拉框里很多人以为 SDRSharp 只能听调频广播其实换一下解调类型能听的东西还不少。调幅广播用 AM 解调带宽要调窄一些航空波段的话音也是调幅同样在 AM 里找短波上常见的下边带和上边带对应 LSB 和 USB 两个选项。这里没法给你一套放之四海皆准的参数因为不同信号的带宽差别很大。我自己的做法是先把带宽设窄一点听到声音之后慢慢放宽直到声音清晰但背景噪声不再变大为止。这个「由窄到宽」的手法比记住某个具体数字有用得多。3.5 Windows 的天花板在哪什么时候该换环境用 SDRSharp 听声音很舒服但它只能「听」。想保存原始 IQ 数据、想自己写一段处理逻辑、想搭一条完整的收发链就得动代码了。在 Windows 下写代码手册给的路线是用 VS2010 编译 libhackrf 这个库。流程大概是先装 pthread-win32 并把它的 DLL 拷到系统目录再准备 libusbx 的库文件然后建一个 Win32 工程把包含目录、库目录、附加依赖项一条条配好最后编译出静态库再写一个测试工程去调用。这一套走下来配置的时间远超写代码的时间而且任何一个路径写错都会编译失败。所以我的建议是Windows 用来「听」真正开始写代码就换到 Linux。这不是什么阵营之争纯粹是因为在 Linux 上这些库一条命令就装好了。4. 换到 Linux 做正经开发三条命令装好 GNU Radio再写第一个 C 程序切换环境这件事听着吓人实际动手比想象中简单。手册推荐的路线是装一个 Ubuntu然后在上面装 GNU Radio 和 gqrx。如果不想装双系统用虚拟机就够了。4.1 为什么进阶要换 Linux不是信仰是省时间GNU Radio、gqrx 这些工具本身就是长在 Linux 上的软件源里直接有包。HackRF 的驱动也早就并进了系统插上就能认。你在 Windows 上要花半天配的路径和依赖在这里是一条 apt 命令的事。更实际的一点是网上能找到的 SDR 教程、流图示例、脚本绝大多数默认你在 Linux 下。跟着别人的步骤走环境一致能省掉大量「为什么他行我不行」的排查。4.2 装系统一台虚拟机就够了如果你手上只有一台日常用的电脑最省事的做法是装个虚拟机软件在里面装 Ubuntu。手册推荐的是 Ubuntu 14.04 LTS 这个长期支持版本理由是工具链成熟、资料多。装完之后记得装虚拟机增强工具否则分辨率和剪贴板会很难受。这里有个必须提前知道的操作虚拟机默认不会接管宿主机的 USB 设备。板子插在电脑上Linux 里是看不见的得手动去虚拟机的菜单里点那个 USB 图标选择「连接断开与主机的连接」把设备从宿主机「抢」到虚拟机里。这一步不做后面所有命令都会告诉你找不到设备。4.3 三条命令装好工具链打开终端按顺序敲下面这几条。每一行后面我都标了它在干什么# 1. 添加 gqrx 的软件源官方源里的版本往往偏旧 sudo add-apt-repository ppa:gqrx/releases # 2. 刷新本机的软件列表让系统知道有哪些新包 sudo apt-get update # 3. 升级已装的软件避免依赖版本对不上 sudo apt-get upgrade # 4. 一次装齐图形界面、流图工具、设备驱动支持、命令行工具 sudo apt-get install gqrx gnuradio gr-osmosdr hackrf如果安装过程中出现 Held packages 这类提示通常不是出错而是有些包被系统暂时按住没升级。手册给的处理办法是先跑一次sudo apt-get dist-upgrade把依赖关系理顺再重新装。注意这一整套装下来体积不小虚拟机硬盘别只分 20GB留够空间否则装到一半提示磁盘不足会很难受。4.4 验证三连三条命令确认板子和工具都活着装完别急着往下走先用三条命令确认环境是通的。这三条命令分别验证三个层面出问题时能立刻定位到是哪一层。# 第一层USB 驱动和板子本身能打印出序列号就说明通了 sudo hackrf_info # 第二层GNU Radio 的流图界面能不能起来 gnuradio-companion # 第三层gqrx 这个图形收音机能不能起来 gqrx第一条如果提示找不到设备八成是虚拟机的 USB 没连进去回到上一节那个 USB 图标。第二条如果弹不出界面说明 GNU Radio 没装全回去重跑安装命令。第三条同理。三条都能起来环境就算搭好了后面写的代码和画的流图才有地方跑。4.5 第一个 C 程序把板子的 ID、固件版本读出来为什么第一个程序选「读设备信息」因为它的成功判据特别清晰——屏幕上打印出几行字就是成功打印不出来就是失败中间没有模糊地带。这比一上来就收信号要好排查得多。下面这段程序用的就是手册里那套接口依次做了初始化、打开设备、读板卡 ID、读固件版本、读序列号、关闭设备这几件事/* hackrf_info_demo.c —— 读一块 HackRF One 的板卡 ID、固件版本和序列号 */ #include hackrf.h #include stdio.h #include stdlib.h /* 把返回码翻译成人话出错时能直接看出是哪一步挂的 */ static void die(const char *step, int result) { fprintf(stderr, %s failed: %s (%d)\n, step, hackrf_error_name((hackrf_error)result), result); exit(EXIT_FAILURE); } int main(void) { hackrf_device *device NULL; uint8_t board_id BOARD_ID_INVALID; char version[256]; read_partid_serialno_t info; int result; result hackrf_init(); /* 初始化库任何调用之前先做这一步 */ if (result ! HACKRF_SUCCESS) die(hackrf_init, result); result hackrf_open(device); /* 打开第一块插着的板子 */ if (result ! HACKRF_SUCCESS) die(hackrf_open, result); result hackrf_board_id_read(device, board_id); if (result ! HACKRF_SUCCESS) die(hackrf_board_id_read, result); printf(Board ID: %d (%s)\n, board_id, hackrf_board_id_name((hackrf_board_id)board_id)); result hackrf_version_string_read(device, version, sizeof(version) - 1); if (result ! HACKRF_SUCCESS) die(hackrf_version_string_read, result); printf(Firmware: %s\n, version); result hackrf_board_partid_serialno_read(device, info); if (result ! HACKRF_SUCCESS) die(hackrf_board_partid_serialno_read, result); printf(Part ID: 0x%08x 0x%08x\n, info.part_id[0], info.part_id[1]); printf(Serial : 0x%08x 0x%08x 0x%08x 0x%08x\n, info.serial_no[0], info.serial_no[1], info.serial_no[2], info.serial_no[3]); hackrf_close(device); /* 关设备别让下次打开失败 */ hackrf_exit(); /* 释放库占用的资源 */ return 0; }编译和运行只要两行# 编译-lhackrf 表示链接 libhackrf 这个库 gcc hackrf_info_demo.c -o hackrf_info_demo -lhackrf # 运行前面加 sudo 是因为访问 USB 设备需要权限 sudo ./hackrf_info_demo跑通之后屏幕上会出现三类信息板卡型号那一行会告诉你识别到的是哪块板子固件版本那一行是当前板子里烧的固件序列号是四个 32 位整数每块板子都不一样打印的时候用0x%08x保证前导零不丢。这段代码里有几个地方值得多说两句。hackrf_init必须在所有调用之前执行它负责把内部状态准备好hackrf_open默认打开系统里找到的第一块板子所以你只插一块就不会有歧义。每一次调用后面都判断了返回值这是新手最容易省掉、也最该保留的习惯——当某一步失败时hackrf_error_name会直接把它翻译成能看懂的英文描述比对着一个数字猜半天高效得多。最后的hackrf_close和hackrf_exit也别省否则下次再运行可能提示设备被占用。4.6 第一个 GNU Radio 流图把一段频谱画出来代码跑通了接下来换成图形化的方式搭一条数据流。GNU Radio 的界面分成几块顶部是菜单中间是画布底部是日志窗口右侧是模块列表。所有操作都围绕「拖模块、连线、设参数」这三件事。具体步骤是这样的打开 gnuradio-companion 新建一个工程在右侧模块列表里用 CtrlF 搜索把信号源模块拖到画布上双击它把采样率设成 2e6 左右中心频率设到本地调频广播所在的频段再拖一个频谱显示模块进来把两个模块的端口连起来最后点运行。参数怎么改是这一步唯一需要动脑的地方。采样率决定你一次能看多宽的频谱2e6 就是看 2MHz 宽对入门足够也不会给 CPU 太大压力。中心频率决定你看的是哪一段选择一个本地有明显电台的频点屏幕上就会有明显的尖峰冒出来。如果什么都看不到先检查中心频率有没有设对再检查增益是不是太低。手册后面还给了完整的调频收发工程示例包含发射音频和接收广播两条链。建议的顺序是先把这个简单流图跑通看懂信号是怎么从板子流到显示模块的再去看那些完整工程否则容易被一堆连线和参数淹没。4.7 装不动就用现成虚拟机这不是偷懒自己从零装 GNU Radio 有时候确实会卡住尤其是依赖冲突和软件源的问题可能耗掉一整天。手册里给了一个很实用的备选方案直接用打包好的虚拟机文件解压、导入、开机按手册给的默认密码登录环境直接就是好的。有人觉得这样学不到东西。我的看法正相反——入门阶段最宝贵的是注意力把它花在修环境上远不如花在看懂一个流图上。等你能跑通几个例子、知道每个模块大概在干什么了再回头折腾自己装环境那时候遇到问题也知道该往哪查。5. 新手最容易翻车的五个地方驱动、增益、库、USB 和带宽前面几章讲的都是顺利情况下的路径。真实上手时绝大多数时间其实花在排查上。下面这五个坑是我见过出现频率最高的每个都按「看到什么现象、为什么会这样、怎么解决」说清楚。5.1 软件里找不到板子驱动被系统自带的抢走了现象是打开 SDR 软件信号源里选了设备却连不上或者 Zadig 的下拉列表里压根看不到 HackRF One 这一项。原因通常是 Windows 在插上板子的瞬间自动装了一个通用 USB 驱动占住了这个设备。Zadig 默认只显示它认为「需要换驱动」的设备有些情况下就不在列表里露面。解决办法是在 Zadig 的选项里打开「列出所有设备」让完整列表显示出来再从中找到 HackRF One点安装驱动。装完拔插一次让系统重新枚举。如果还是不认换一个 USB 口试试尽量别用前面板或者经过扩展坞的口。5.2 增益滑块拖不动Start 没点现象很典型打开配置窗口两个增益滑块是灰色的怎么拖都没反应一度怀疑是软件坏了。原因手册里其实写了只是容易被略过——必须先点主界面上的 Start设备开始工作之后配置窗口里的滑块才是可拖动的状态。解决就是关掉配置窗口回去点 Start再重新打开 Configure。这个顺序不能反。顺带说一句如果点了 Start 之后软件直接报错退出多半还是驱动的问题回到上一条排查。5.3 编译时报找不到库路径、位数、DLL 三件事现象分两种编译阶段报找不到 pthreadVC2.lib 或 libusb-1.0.lib或者编译通过了一运行就弹窗说找不到 pthreadVC2.dll。原因基本是三件事之一。库目录没加进工程编译器不知道去哪里找或者 32 位和 64 位混用了工程是 32 位却引了 64 位的库再或者运行的时候 DLL 不在可执行文件旁边系统搜不到。解决办法按顺序试先把 libusb-1.0.lib 和 pthreadVC2.lib 这两个文件直接添加进工程绕开路径配置确认工程的位数和库的位数一致最后把 pthreadVC2.dll 复制到工程的 Debug 目录下让它在运行时能被找到。5.4 Linux 里说找不到设备USB 没连进虚拟机现象是在终端敲sudo hackrf_info返回找不到任何板子但板子明明插着灯也亮着。原因是虚拟机不会自动接管宿主机的 USB 设备它现在还在 Windows 那边。Linux 这一侧根本不知道有这么个东西存在。解决办法是在虚拟机的菜单栏找到 USB 图标点开选择「连接断开与主机的连接」。连接成功之后虚拟机通常会有一声提示音设备列表里也会多出一项。这一步每次重启虚拟机都要重新做一次别忘了。5.5 采样率拉满就卡USB 和 CPU 都顶不住现象是把采样率调到最高之后频谱开始一顿一顿地刷新声音断断续续有时候软件直接无响应。原因在第二章算过20Msps、8bit、I/Q 两路每秒就是 40MB 的原始数据。USB 2.0 的理论带宽本来就有限实际还要打折扣本文还有配套的精品资源点击获取