课程导入：学习目标、适用人群、课程结构、软硬件环境准备
软件定义无线电（SDR）技术正在深刻改变无线通信的教学、科研与产业验证方式。GNU Radio 作为开源生态中最具影响力的信号处理框架，配合 Ettus Research 推出的 USRP（Universal Software Radio Peripheral）硬件平台，构成了从算法仿真到实时空口验证的标准工程链路。本章作为整个课程的第一节，核心任务不是讲解某个具体信号处理模块，而是帮助学习者建立对“GNU Radio + USRP 联动测试”这一工程体系的整体认知框架，并完成从零开始的软硬件环境搭建。我们将依次讨论课程的学习目标与适用人群、整体章节结构、以及 Ubuntu 系统下 GNU Radio、UHD 驱动和 USRP 设备的完整准备流程。只有环境可靠、路径清晰，后续章节中的频谱监测、OFDM 传输、MIMO 同步等实验才能具备可复现的基础。
上图展示了本课程所涉及的核心工程链路：主机软件层（Ubuntu + GNU Radio + UHD 库）通过传输接口（USB 3.0 或千兆以太网）与 USRP 硬件平台连接，硬件完成射频收发与高速转换，软件完成信号处理与协议实现。图中同时标注了四个关键测试点，这些测试点将贯穿整个课程，用于验证环境是否正常、参数配置是否正确、信号链路是否畅通。下面我们分模块展开详细说明。
1.1 学习目标与适用人群
本课程面向已经具备基础通信原理知识、希望掌握实际 SDR 操作技能的工程师、研究人员和高年级学生。课程的学习目标分为三个层次：认知层要求理解 GNU Radio 的流图编程模型、UHD 驱动架构以及 USRP 的硬件组成；操作层要求能够独立完成环境搭建、设备调试、参数配置和基本收发实验；应用层要求能够针对实际无线通信场景（如频谱感知、协议验证、信号识别）设计并执行完整的联动测试方案。
具体而言，完成本课程后，学习者应具备以下能力：
- 能够在 Ubuntu 系统上从源码或二进制包安装 GNU Radio 3.10 及以上版本，并正确配置 UHD 驱动。
- 能够使用
uhd_find_devices和uhd_usrp_probe工具完成 USRP 设备的识别与参数查询。 - 能够使用 GNU Radio Companion（GRC）构建包含 USRP 信源/信宿的流图，并理解采样率、增益、频率等核心参数的含义。
- 能够通过实际频谱测量验证 USRP 收发链路的正确性，并掌握常见故障的排查方法。
- 能够将 GNU Radio 的仿真模块与 USRP 硬件输入输出结合，完成从仿真到实物的平滑过渡。
适用人群方面，本课程主要面向以下三类学习者：第一类是无线通信领域的科研人员，需要快速验证算法在真实信道环境下的性能；第二类是通信工程专业的本科生或研究生，希望通过动手实验加深对软件无线电架构的理解；第三类是从事射频测试、频谱管理或无线产品开发的工程师，需要掌握一种灵活、可扩展的测试工具。对于完全没有通信背景的初学者，建议先补充信号与系统、数字通信的基础知识。
1.2 课程结构总览
本课程共分为 30 个章节，按照“基础准备 → 核心原理 → 单项实验 → 综合应用”四个阶段组织。每个章节都包含理论讲解、操作步骤、案例分析和常见误区四个模块，确保学习者既能理解“为什么”，也能掌握“怎么做”。
课程结构如下表所示：
| 阶段 | 章节范围 | 核心内容 | 关键产出 |
|---|---|---|---|
| 基础准备 | 第 1-4 章 | 环境搭建、GNU Radio 基础、UHD 驱动架构、USRP 硬件认知 | 可运行的 GNU Radio + USRP 测试平台 |
| 核心原理 | 第 5-12 章 | 信号源与信宿、滤波器设计、调制解调、同步技术、频谱分析 | 关键 DSP 模块的流图实现 |
| 单项实验 | 第 13-22 章 | USRP 收发实验、FSK/PSK/QAM 实测、信道编码、多通道同步 | 可重复的硬件在环实验流程 |
| 综合应用 | 第 23-30 章 | 频谱监测系统、OFDM 传输、MIMO 测试、认知无线电原型 | 完整的 SDR 应用原型 |
这种结构设计遵循“螺旋式上升”的教学理念：每个阶段都会复用前一阶段的知识，同时引入新的复杂度。例如，第 6 章讲解的 FIR 滤波器设计，会在第 15 章的 USRP 发射实验中再次出现，用于脉冲成型；而第 10 章的同步技术，则会在第 25 章的 OFDM 系统中发挥关键作用。学习者可以根据自身基础选择跳跃式学习，但建议至少完成第 1-4 章后再进入硬件实验。
1.3 软硬件环境准备
环境准备是联动测试的第一步，也是后续所有实验的基础。本节将详细讲解 Ubuntu 系统下 GNU Radio、UHD 驱动和 USRP 设备的安装与验证流程。我们以 Ubuntu 22.04 LTS 和 USRP B210 为例进行说明，但大部分步骤同样适用于其他型号（如 N210、X310）和其他 Ubuntu 版本。
1.3.1 操作系统与基础依赖
推荐使用 Ubuntu 22.04 LTS 或 20.04 LTS，这两个版本对 GNU Radio 和 UHD 的支持最为成熟。系统安装完成后，首先更新软件源并安装基础编译工具：
sudo apt update
sudo apt upgrade -y
sudo apt install -y git cmake g++ python3-dev swig \
libboost-all-dev libfftw3-dev libgmp-dev libcppunit-dev \
liblog4cpp5-dev libgsl-dev libqwt-qt5-dev libqt5opengl5-dev \
python3-numpy python3-scipy python3-matplotlib python3-lxml \
python3-pyqt5 python3-pyqt5.qtsvg python3-qwt这些依赖包涵盖了 GNU Radio 编译运行所需的绝大多数库。如果使用二进制安装方式，则不需要全部安装，但建议保留 git、cmake 和 python3-dev，因为后续可能需要从源码编译额外的 OOT（Out-Of-Tree）模块。
1.3.2 GNU Radio 安装
GNU Radio 的安装有两种主流方式：二进制包安装和源码编译安装。对于大多数学习者，推荐使用二进制包安装，因为其速度快、依赖管理自动完成。在 Ubuntu 22.04 上，可以直接使用 apt 安装：
sudo apt install -y gnuradio gnuradio-dev安装完成后，可以通过以下命令验证版本：
gnuradio-config-info --version
gnuradio-config-info --prefix如果输出显示 3.10.x 版本，说明安装成功。对于需要最新特性或自定义模块的学习者，可以选择源码编译。源码编译的典型步骤如下：
git clone --recursive https://github.com/gnuradio/gnuradio.git
cd gnuradio
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DPYTHON_EXECUTABLE=$(which python3) ..
make -j$(nproc)
sudo make install
sudo ldconfig源码编译通常需要 30-60 分钟，取决于机器性能。编译过程中如果遇到缺少依赖的错误，可以根据 cmake 输出的提示信息逐一安装缺失的包。
sudo apt remove gnuradio gnuradio-dev，再进行源码编译。
1.3.3 UHD 驱动安装
UHD（USRP Hardware Driver）是 Ettus Research 提供的官方驱动，负责主机与 USRP 设备之间的通信。UHD 的安装同样支持 apt 和源码两种方式。apt 安装命令如下：
sudo apt install -y uhd-host libuhd-dev安装完成后，需要下载 FPGA 镜像文件。UHD 驱动在首次连接设备时会自动下载，也可以手动执行：
sudo uhd_images_downloader该命令会从 Ettus 服务器下载对应设备型号的 FPGA 镜像和固件，默认存储在 /usr/share/uhd/images 目录下。如果网络受限，可以手动下载镜像包并解压到该目录。
验证 UHD 安装是否成功，可以使用以下命令：
uhd_find_devices如果系统提示“No UHD Devices Found”，说明驱动安装正常但尚未连接设备。此时可以连接 USRP 设备，再次执行该命令，应能看到设备信息。
1.3.4 USRP 设备连接与验证
以 USRP B210 为例，设备通过 USB 3.0 接口与主机连接。连接前请确保 USB 线缆支持 USB 3.0 规范（蓝色接口），并建议使用独立供电的 USB Hub 以保证电流稳定。连接后，执行以下命令验证设备识别：
uhd_find_devices正常输出应包含类似以下内容：
-- UHD Device 0
Device Address:
serial: 30E4A4C
name: B210
product: B210
type: b200接下来，使用 uhd_usrp_probe 查询设备的详细参数：
uhd_usrp_probe该命令会输出设备的主时钟频率范围、ADC/DAC 分辨率、可用增益范围、天线端口等信息。这些参数是后续配置 GNU Radio 流图的重要依据。例如，B210 的 ADC 分辨率为 12 位，DAC 分辨率为 14 位，主时钟频率范围为 10 MHz 至 61.44 MHz。
1.3.5 GNU Radio 与 USRP 联动验证
环境准备的最后一步是验证 GNU Radio 能够正常调用 UHD 驱动并控制 USRP 设备。最简单的方法是使用 GRC 构建一个“信号源 → USRP 信宿”的流图，发射一个单音信号，然后用另一台 USRP 或频谱仪接收验证。
在 GRC 中新建流图，添加以下模块：
- Signal Source：频率设为 1 kHz，波形选择 Cosine，幅度设为 0.5。
- USRP Sink：中心频率设为 2.4 GHz，采样率设为 1 MHz，增益设为 30 dB。
- QT GUI Frequency Sink：用于可视化发射信号的频谱（可选）。
连接信号源输出到 USRP Sink 的输入，运行流图。如果环境配置正确，USRP 的 TX/RX 端口应有射频信号输出。使用另一台 USRP 或频谱仪在 2.4 GHz 附近应能观察到明显的单音信号。
uhd_usrp_probe 输出发现，设备报告的主时钟频率为 0 MHz，说明 FPGA 镜像未正确加载。排查过程如下：首先检查 /usr/share/uhd/images 目录是否存在对应镜像文件；其次确认 UHD 版本与设备固件版本是否匹配；最后重新执行 sudo uhd_images_downloader 并重启设备。问题解决后，主时钟频率恢复正常。此案例说明，环境问题往往不是单一原因，需要按照“驱动 → 镜像 → 硬件”的顺序逐层排查。
1.4 常见误区与总结复盘
在环境准备阶段，学习者容易陷入以下几个误区，需要特别留意：
| 误区 | 表现 | 正确做法 |
|---|---|---|
| 版本混用 | GNU Radio 3.8 与 UHD 4.x 混用，导致 API 不兼容 | 使用 gnuradio-config-info --version 和 uhd_config_info --version 确认版本，尽量使用 GNU Radio 3.10 + UHD 4.x 组合 |
| USB 接口错误 | 将 B210 插入 USB 2.0 接口，导致采样率受限或设备不稳定 | 确认使用 USB 3.0 接口，并检查线缆质量 |
| 镜像文件缺失 | 设备连接后提示 FPGA 加载失败 | 手动执行 sudo uhd_images_downloader，并检查镜像目录权限 |
| Python 路径冲突 | GRC 启动后提示找不到 gnuradio 模块 | 检查 PYTHONPATH 环境变量，确保指向正确的安装路径 |