📚 课程目录第4章 GNU Radio核心概念

4、GNU Radio核心概念：流图（Flowgraph）、块（Block）、端口（Port）、数据类型（complex, float, int等）以及采样率与带宽的关系

GNU Radio 是一个开源软件定义无线电（SDR）开发框架，其核心抽象模型由流图（Flowgraph）、块（Block）和端口（Port）构成。理解这三者之间的关系，以及数据类型与采样率/带宽的映射规则，是进行 USRP 联合开发的基础。本章将从工程配置的角度，系统拆解这些核心概念，并给出可操作的判断方法和实战案例。

4.1 流图（Flowgraph）：信号处理的编排引擎

核心原理：流图是 GNU Radio 中所有信号处理模块的容器和调度器。它定义了一个有向无环图（DAG），其中节点是块（Block），边是端口（Port）之间的连接。流图负责管理数据流的启动、停止、执行顺序以及缓冲区分配。在 USRP 联合开发中，流图通常包含一个 UHD Source 块（从 USRP 硬件接收数据）、若干信号处理块（滤波、解调、解码等）以及一个或多个 Sink 块（文件写入、网络发送、GUI 显示）。

工程操作要点：在 GNU Radio Companion（GRC）中构建流图时，需要关注以下配置：

采样率属性：流图的顶层变量 samp_rate 决定了整个流图的时间基准。所有块的参数（如滤波器带宽、重采样因子）都基于该采样率计算。
流图执行模式：默认使用多线程调度器（thread_per_block 或 default），每个块在独立线程中运行，通过缓冲区连接。对于实时性要求高的 USRP 应用，建议使用 scheduler 的默认配置，避免手动设置线程亲和性。
流图生命周期：start() 启动流图，wait() 阻塞直到流图停止，stop() 强制停止。在 Python 脚本中，通常使用 tb.start() 和 tb.wait() 控制。

经验提醒：在 USRP 联合开发中，流图的启动顺序很重要。建议先实例化所有块并完成连接，再调用 start()。如果 USRP 设备初始化失败，流图会抛出异常，需要在代码中捕获并处理。

4.2 块（Block）与端口（Port）：数据流的基本单元

核心原理：块是 GNU Radio 中最小的处理单元，每个块可以有一个或多个输入/输出端口。端口定义了数据的类型和方向（输入/输出）。块根据其处理逻辑分为三类：

同步块（Sync Block）：输入和输出的样本数相同，如加法器、乘法器。
抽取块（Decimator）：输出样本数少于输入，如 FIR 滤波器（抽取因子 N）。
插值块（Interpolator）：输出样本数多于输入，如内插器（插值因子 M）。

端口类型与匹配规则：端口的数据类型必须严格匹配，否则流图无法运行。GNU Radio 支持以下原生数据类型：

数据类型	C++ 类型	字节数	典型用途
complex	gr_complex	8 (2×float32)	I/Q 基带信号、调制解调
float	float	4	实信号、功率谱、控制信号
int32	int32_t	4	计数、索引、控制字
short	int16_t	2	音频、低精度数据
byte	uint8_t	1	二进制流、控制字节

判断方法：在 GRC 中，端口颜色和标签会显示数据类型。例如，complex 端口通常为蓝色，float 为绿色。如果连接时出现红色警告，说明类型不匹配。此时需要插入类型转换块（如 complex_to_float、float_to_complex）或调整块参数。

风险提示：在 USRP 源块中，输出数据类型通常为 complex（I/Q 数据）。如果后续处理需要 float（如 AM 解调），必须显式转换。切勿直接连接 complex 到 float 端口，否则流图会报错或产生未定义行为。

4.3 采样率与带宽的关系：USRP 工程配置的核心约束

核心原理：采样率（samp_rate）决定了数字信号的时间分辨率，而带宽（Bandwidth）是信号占用的频率范围。根据奈奎斯特采样定理，对于实信号，采样率必须大于等于信号最高频率的两倍（fs ≥ 2×BW）；对于复信号（I/Q），采样率只需大于等于信号带宽（fs ≥ BW），因为 I/Q 采样利用了正交特性，频谱不再对称。

USRP 硬件约束：USRP 设备（如 X310、B210）的 ADC/DAC 采样率是固定的（如 200 Msps），但通过 FPGA 的抽取/内插，主机端可配置的采样率范围有限。例如，B210 的 master clock 为 56 MHz，主机端采样率可配置为 56 MHz / 抽取因子，抽取因子必须是整数（通常为 1, 2, 4, 8...）。

工程配置流程：

确定信号带宽 BW（如 LTE 信号 20 MHz）。
选择采样率：对于复信号，fs ≥ BW，通常取 fs = 1.2 × BW 至 2 × BW 之间，留出过渡带。
检查 USRP 是否支持该采样率：计算抽取因子 = master_clock / fs，必须为整数。
在 GRC 中设置 samp_rate 变量，并配置 UHD Source 块的 samp_rate 参数。

  案例拆解：假设使用 USRP B210 接收一个 5 MHz 带宽的 QPSK 信号。B210 的 master clock 为 56 MHz。选择 fs = 10 Msps（复信号），抽取因子 = 56 / 10 = 5.6，不是整数，因此不可用。调整 fs = 8 Msps，抽取因子 = 7，可行。实际可用带宽 = 8 MHz（复信号），满足 5 MHz 信号需求。如果使用实信号采样，则 fs 需 ≥ 10 MHz，但 USRP 通常输出复信号，因此推荐使用复信号模式。

常见误区：

误区一：认为采样率越高越好。实际上，过高的采样率会增加 USB/以太网传输压力，导致丢包或溢出（Overflow）。
误区二：忽略 USRP 的采样率步进限制。并非所有采样率都可用，必须检查抽取/内插因子是否为整数。
误区三：混淆实信号和复信号的带宽关系。对于复信号，采样率等于带宽即可，但实际工程中建议留出 20% 余量。

4.4 实战场景：构建一个 USRP 接收流图

场景描述：使用 USRP B210 接收 2.4 GHz 频段的 ZigBee 信号（带宽 2 MHz），并实时显示频谱。要求采样率尽可能低以减少 USB 负载，同时保证信号完整。

关键参数计算：

信号带宽：2 MHz（复信号）
选择采样率：fs = 4 Msps（2 倍过采样，留出过渡带）
检查 USRP 支持：master clock = 56 MHz，抽取因子 = 56 / 4 = 14（整数，可行）
数据类型：complex（I/Q）

GRC 流图配置步骤：

添加 UHD: USRP Source 块，设置 samp_rate = 4e6，center_freq = 2.4e9，gain = 30 dB。
添加 QT GUI Frequency Sink 块，设置 bandwidth = 4e6，fft_size = 1024。
连接 USRP Source 的 output 端口（complex）到 Frequency Sink 的 input 端口（complex）。
设置流图变量 samp_rate = 4e6。
运行流图，观察频谱。

结果与复盘：运行后，频谱显示 ZigBee 信号位于 2.4 GHz 中心频率附近，带宽约 2 MHz。由于采样率 4 Msps 大于信号带宽 2 MHz，信号无混叠。USB 传输负载约为 4e6 × 8 字节/s = 32 MB/s，B210 的 USB 3.0 接口可轻松承载。若将采样率提高到 8 Msps，负载翻倍，但频谱过渡带更宽，便于观察相邻信道。实际工程中，应根据信号带宽和传输链路能力平衡采样率。

经验总结：在 USRP 联合开发中，采样率的选择应遵循“够用就好”原则。优先计算所需最小采样率，再检查 USRP 硬件支持，最后留出 10%-20% 余量。同时，使用 gr::block 的 set_min_output_buffer 方法可以调整缓冲区大小，避免数据溢出。

4.5 常见误区与总结复盘

误区清单：

误区	后果	正确做法
端口类型不匹配	流图启动失败或数据错误	使用类型转换块，或统一数据类型
采样率设置过高	USB 溢出、CPU 过载	根据带宽计算最小采样率
忽略 USRP 抽取因子限制	采样率不可用，报错	检查 master_clock / fs 是否为整数
实信号与复信号混淆	带宽计算错误，信号混叠	明确信号类型，复信号 fs ≥ BW

总结：流图、块、端口是 GNU Radio 的三大核心抽象，理解它们之间的关系是进行 USRP 联合开发的前提。数据类型决定了端口连接的合法性，采样率与带宽的关系则直接影响系统性能和信号质量。在实际工程中，建议遵循以下流程：确定信号参数 → 计算采样率 → 检查硬件约束 → 设计流图 → 验证运行。通过本章的学习，读者应能独立完成一个简单的 USRP 接收流图设计，并具备排查常见配置错误的能力。