第一个实验：创建简单信号源与频谱显示，理解流图执行流程与QT GUI使用

GNU Radio 的核心设计哲学是“流图”（Flowgraph），它将信号处理任务抽象为节点（Block）与连接（Connection）的有向图。本实验是进入 GNU Radio 世界的第一道门槛：通过创建一个最简单的信号源（Signal Source）并将其连接到频谱显示（QT GUI Frequency Sink），我们不仅会完成第一个可运行的流图，更重要的是建立对“数据流如何流动”、“调度器如何驱动 Block 执行”以及“QT GUI 如何与流图交互”这三个核心概念的直观认知。这个实验看似简单，却是后续所有复杂系统（如调制解调、信道编码、MIMO 处理）的基石。我们将从原理、操作、案例到常见误区，完整拆解这一过程。

上图展示了本实验流图的核心数据链路与执行模型。信号源产生离散复信号样本，经过 Throttle 限速后送入频谱分析模块，最终由 QT GUI 窗口呈现。整个过程中，GNU Radio 的调度器负责协调各 Block 的执行节奏，而 QT 事件循环负责将数字信号转换为可视化图形。理解这条链路，是掌握 GNU Radio 开发的关键。

核心原理：流图、Block 与数据流

GNU Radio 的流图本质上是一个有向无环图（DAG）。每个节点（Block）代表一个信号处理单元，每条边代表一条数据流。数据流的基本单位是“样本”（Sample），对于复信号，一个样本包含 I/Q 两个浮点数。流图执行时，调度器（Scheduler）会为每个 Block 分配一个线程（或使用线程池），并循环调用其 work() 函数。该函数从输入缓冲区读取数据，执行处理，并将结果写入输出缓冲区。

本实验中的 Signal Source 是一个“源 Block”（Source Block），它没有输入，只有输出。其 work() 函数根据设定的波形参数（如余弦、正弦、高斯噪声等）生成样本。而 QT GUI Frequency Sink 是一个“汇 Block”（Sink Block），它只有输入，没有输出。其内部执行 FFT（快速傅里叶变换）运算，将时域样本转换为频域幅度，并通过 QT 信号槽机制将结果发送到 GUI 界面。

这里有一个关键点：流图是“拉式”还是“推式”执行？ GNU Radio 采用“推拉结合”的机制。源 Block 主动产生数据推入缓冲区，而下游 Block 在缓冲区有足够数据时被调度器唤醒。为了控制数据产生速率，避免源 Block 以 CPU 极限速度生成数据（导致内存溢出或 GUI 卡顿），我们必须在源之后插入 Throttle Block。它通过精确的定时器控制数据吞吐量，使流图以接近实时或设定的速率运行。

操作流程：从零构建第一个流图

我们将使用 GNU Radio Companion（GRC）图形化工具完成实验。GRC 允许我们通过拖拽 Block 并连接端口来构建流图，并自动生成 Python 代码。以下是详细步骤：

1. 启动 GRC：在终端输入 gnuradio-companion 或从应用菜单启动。
2. 添加信号源：在右侧 Block 库中搜索 Signal Source，拖入画布。双击打开属性配置：
   • Output Type: 选择 Complex（复信号，便于后续扩展）。
   • Waveform: 选择 Cosine（余弦波）。
   • Frequency: 设为 100k（100 kHz）。
   • Amplitude: 设为 1。
   • Sample Rate: 设为 1M（1 MHz 采样率）。
3. 添加 Throttle：搜索 Throttle 并拖入。设置 Sample Rate 为 1M。注意：Throttle 的采样率必须与信号源一致，否则数据流速率不匹配。
4. 添加频谱显示：搜索 QT GUI Frequency Sink 并拖入。关键参数：
   • FFT Size: 设为 1024（频率分辨率 = 采样率/FFT点数 = 1MHz/1024 ≈ 976.5 Hz）。
   • Center Frequency (Hz): 设为 0（基带显示）。
   • Bandwidth (Hz): 设为 1M（显示范围 -500kHz 到 +500kHz）。
5. 连接 Block：用鼠标从 Signal Source 的输出端口（标有 complex）拖线到 Throttle 的输入端口，再从 Throttle 输出端口拖线到 Frequency Sink 的输入端口。连接线颜色应与数据类型匹配（复数为蓝色）。
6. 运行流图：点击工具栏上的“执行”按钮（绿色三角形）。GRC 会生成 Python 脚本并启动 QT GUI 窗口。

运行后，你应该看到一个频谱窗口，在 +100 kHz 处有一个明显的峰值（余弦波的频谱线）。如果看不到，检查是否设置了正确的频率和带宽。

参数项	推荐值	说明
采样率 (Sample Rate)	1 MHz	决定频谱显示范围，必须全局一致
信号频率	100 kHz	应小于采样率的一半（奈奎斯特频率）
FFT 点数	1024	权衡频率分辨率与更新速度
Throttle 采样率	1 MHz	与信号源一致，防止数据积压

案例拆解：从频谱图验证信号正确性

假设你运行流图后，频谱显示在 0 Hz 处有一个大峰值，而 100 kHz 处没有信号。这是一个常见问题。我们以此为例进行排障分析。

初始现象：频谱图中心（0 Hz）出现直流分量，目标频率无显示。

分析过程：

1. 检查信号源配置：确认 Waveform 是否为 Cosine，Frequency 是否为 100k。如果误设为 0 Hz，则输出直流信号。
2. 检查数据类型：如果信号源输出类型为 Float，而 Frequency Sink 期望 Complex，GRC 会自动插入转换 Block，但可能造成频谱镜像。确保两端都是 Complex。
3. 检查 Throttle 设置：如果 Throttle 采样率远高于信号源，可能导致缓冲区溢出，数据丢失。但通常不会导致频率偏移。
4. 检查 FFT 窗口：在 Frequency Sink 属性中，有一个 Window 参数（如 Blackman-Harris）。如果选择了矩形窗（Rectangular），频谱泄漏可能导致峰值不明显。但 100 kHz 处应有明显谱线。

实际操作步骤：

# 在 GRC 中检查信号源属性
# 双击 Signal Source，确认：
#   Waveform: Cosine
#   Frequency: 100k
#   Output Type: Complex
# 确认 Throttle 的 Sample Rate 为 1M
# 确认 Frequency Sink 的 Center Frequency 为 0，Bandwidth 为 1M
# 重新运行流图

结果对比：修正后，频谱图在 +100 kHz 处出现尖锐峰值，幅度约为 -3 dB（对应幅度 1 的余弦波）。0 Hz 处无直流分量。

复盘经验：本案例表明，频谱显示是验证信号源配置正确性的最直观工具。任何频率偏移、幅度异常或杂散信号，都可以通过频谱图快速定位。建议初学者养成“先看频谱，再分析时域”的习惯。

常见误区与总结复盘

在初次接触 GNU Radio 时，以下几个误区会显著影响学习效率，需要特别留意：

总结复盘：本实验的核心收获有三点。第一，掌握了 GRC 的基本操作流程：添加 Block、配置参数、连接端口、运行调试。第二，理解了流图执行机制：数据以流的形式在 Block 间传递，调度器驱动 work() 函数执行，Throttle 控制流速。第三，学会了使用 QT GUI Frequency Sink 作为信号观测工具，这是后续所有实验的“眼睛”。

为了巩固理解，可以尝试以下变体练习：将信号源改为 Noise（高斯噪声），观察平坦的频谱底噪；或将频率改为 400 kHz，观察频谱线靠近奈奎斯特边界时的表现。这些练习将帮助你建立对频域概念的直觉。