📚 课程目录第4章 USRP采样率设置方法

4、USRP采样率设置方法：通过UHD API、GNU Radio、MATLAB等工具设置采样率，理解采样率参数（samp_rate）的配置流程

USRP（Universal Software Radio Peripheral）设备的采样率（samp_rate）是决定信号采集带宽、数据吞吐量以及系统实时性能的核心参数。无论是进行频谱监测、通信原型验证，还是雷达信号处理，采样率的配置都直接关系到信号链路的有效性与稳定性。本章将深入剖析采样率在UHD（USRP Hardware Driver）软件栈中的传递路径，并分别演示通过UHD API、GNU Radio Companion（GRC）以及MATLAB三种主流工具进行采样率设置的具体方法。我们将从底层寄存器配置到上层应用接口，系统梳理采样率参数的完整配置流程，并结合实际案例讨论采样率与丢包、吞吐量之间的内在联系。

上图展示了采样率参数从应用层到底层硬件的完整传递链路。在实际工程中，用户设置的采样率并非总是被硬件精确采纳，USRP会根据母板时钟频率和FPGA处理能力，自动计算一个最接近的可行值。因此，理解这一配置流程对于后续的丢包分析和吞吐量优化至关重要。

4.1 核心原理：采样率与USRP信号链的关系

USRP的采样率设置并非一个孤立的参数，它直接决定了ADC/DAC的工作时钟、FPGA内部的数据率以及主机接口（如PCIe、千兆以太网）的传输负载。从信号处理角度看，采样率 \( f_s \) 决定了可无失真采集的最大信号带宽，根据奈奎斯特采样定理，基带信号带宽必须小于 \( f_s/2 \)。然而，在实际USRP系统中，由于抗混叠滤波器的非理想特性，通常建议用户将信号带宽控制在 \( 0.8 \times f_s/2 \) 以内。

从硬件架构来看，USRP母板上的ADC以固定速率（如X310为200 Msps）进行采样，然后通过FPGA中的数字下变频器（DDC）进行抽取，最终将数据率降低到用户设定的 samp_rate。因此，采样率设置的本质是配置FPGA中的抽取/插值因子。例如，当ADC速率为200 Msps，用户设置采样率为10 Msps时，DDC的抽取因子为20。这一过程会引入量化误差和时钟抖动，但现代USRP设备通过高精度时钟管理和多级滤波器设计，能够保证在合理采样率范围内信号质量满足要求。

  关键概念：采样率（samp_rate）在UHD中是一个双精度浮点数，单位是Sps（Samples per Second）。UHD内部会将其转换为FPGA可执行的整数分频比，因此用户设置的值与实际生效值可能存在微小差异（通常小于1%）。在编写应用时，应始终通过 get_rx_rate() 获取实际生效的采样率，而不是使用用户设定的理论值。

4.2 判断方法与操作流程：三种工具配置详解

下面分别介绍通过UHD API、GNU Radio和MATLAB设置采样率的具体操作流程，并对比它们在不同应用场景下的适用性。

4.2.1 通过UHD API（C++/Python）设置采样率

UHD API提供了最底层的控制接口，适合需要精细控制或集成到自定义应用中的场景。以下是一个典型的Python配置流程：

import uhd
# 创建USRP设备对象
usrp = uhd.usrp.MultiUSRP("addr=192.168.10.2")
# 设置采样率（以接收为例）
usrp.set_rx_rate(10e6, 0)  # 10 Msps, 子通道0
# 获取实际生效的采样率
actual_rate = usrp.get_rx_rate(0)
print(f"请求采样率: 10 Msps, 实际采样率: {actual_rate/1e6:.3f} Msps")
# 设置其他相关参数
usrp.set_rx_freq(uhd.types.TuneRequest(2.4e9), 0)  # 中心频率2.4 GHz
usrp.set_rx_gain(30, 0)  # 增益30 dB
# 创建流式传输
st_args = uhd.usrp.StreamArgs("fc32", "sc16")
streamer = usrp.get_rx_stream(st_args)
# 启动采集...

在C++中，流程类似，但需要手动管理内存和错误处理。UHD API的优势在于其跨平台性和丰富的参数控制能力，但要求开发者对USRP架构有较深理解。

4.2.2 通过GNU Radio Companion（GRC）设置采样率

GNU Radio是无线通信领域最流行的开源开发框架，GRC提供了图形化编程界面。在GRC中设置采样率非常简单：

在流图中添加 UHD: USRP Source 模块（或USRP Sink用于发射）。
双击模块，在 Sampling Rate (Hz) 字段中填入期望值，如 10e6。
通常建议在流图中定义一个 Variable 块（ID为 samp_rate），并将该变量引用到USRP模块的采样率参数中，以便其他模块（如滤波器、FFT）同步使用。
点击 Generate 生成Python代码，然后运行流图。

GRC生成的Python代码底层仍然调用UHD API，但通过封装简化了配置过程。值得注意的是，GRC中的采样率参数是全局的，修改后需要重新生成并运行流图才能生效。

4.2.3 通过MATLAB设置采样率

MATLAB的Communications Toolbox提供了对USRP的硬件支持包，通过 comm.SDRuReceiver 和 comm.SDRuTransmitter 对象进行控制。配置示例如下：

% 创建接收端对象
rx = comm.SDRuReceiver('Platform', 'X310', 'IPAddress', '192.168.10.2');
% 设置采样率
rx.SampleRate = 10e6;
% 设置其他参数
rx.CenterFrequency = 2.4e9;
rx.Gain = 30;
% 调用setup使配置生效
setup(rx);
% 获取实际采样率
actual_rate = rx.SampleRate; % 注意：此属性返回的是配置值，实际值需通过info方法获取
info(rx)
% 执行数据接收
data = rx();

MATLAB的优势在于其强大的信号处理和分析能力，适合快速原型验证。但需要注意的是，MATLAB的SDRu对象在每次设置参数后需要调用 setup 或 release 才能生效，且在高采样率下可能因数据拷贝导致性能下降。

对比维度	UHD API	GNU Radio	MATLAB
配置粒度	最细（可控制每个子通道）	中等（模块级配置）	中等（对象属性配置）
实时性	高（直接调用底层驱动）	高（生成C++/Python代码）	中（受MATLAB解释执行影响）
适用场景	生产系统、嵌入式集成	原型验证、教学实验	算法仿真、快速测试
采样率范围查询	支持 `get_rx_rates()`	通过模块属性查看	通过 `info()` 查看
学习曲线	较陡	平缓	中等

4.3 案例拆解：高采样率下的吞吐量验证与参数调优

本案例基于USRP X310 + UBX-160子板，通过PCIe接口连接主机，目标是实现持续稳定的 100 Msps 采样率数据采集，并验证吞吐量是否满足要求。该场景常见于宽带频谱感知和5G NR信号采集。

背景与约束：X310母板ADC最大速率200 Msps，UBX-160子板支持10 MHz-6 GHz频率范围，最大带宽160 MHz。主机配置为Intel i7-9700K，32 GB内存，PCIe Gen3 x4接口。系统要求数据无丢失地写入SSD阵列。

初始现象：直接设置采样率为100 Msps后，运行UHD示例程序 rx_samples_to_file，发现数据写入速率仅为约 350 MB/s（理论应为 100e6 × 4 bytes × 2通道 = 800 MB/s），且系统提示丢包计数持续增长。

分析判断过程：首先检查UHD返回的实际采样率，发现为 100 Msps 无误。然后通过 uhd_usrp_probe 确认PCIe链路协商为Gen3 x4（理论带宽约3.2 GB/s），排除接口瓶颈。进一步使用 perf 工具监测CPU占用，发现单个核心占用率接近100%，而其他核心利用率较低。判断问题出在单线程处理能力不足，导致数据从内核缓冲区到用户空间的拷贝速度跟不上采样率。

实际操作步骤：

将UHD接收示例程序改为多线程模式，使用 rx_streamer 的异步接收API，并启用 OTW 格式为 sc16（16位复数），将数据量减半。
在UHD中启用 enable_cpu_throttle 和 enable_fpga_throttle 选项，避免CPU过载导致的数据积压。
将数据写入操作改为独立线程，使用内存映射文件（mmap）减少系统调用开销。
调整UHD的 recv_buff_size 参数，从默认的1 MB增加到8 MB，以吸收瞬时流量波动。

结果对比：优化后，数据写入速率稳定在 780 MB/s 左右，丢包率降至0。CPU占用率分布均匀（4个核心各约60%），系统运行稳定。

风险与代价：多线程编程增加了代码复杂度，且内存映射文件在异常退出时可能导致数据损坏。此外，增大缓冲区会占用更多内存，在长时间采集中需注意内存上限。

复盘经验：高采样率设置不仅仅是参数配置问题，更是一个系统级的性能工程。采样率越高，对主机处理能力、总线带宽和存储速度的要求呈线性增长。在设置采样率前，应通过 get_rx_rates() 查询硬件支持范围，并结合实际应用场景进行压力测试。

常见误区：许多初学者认为采样率设置越高越好，忽略了信号带宽的实际需求。过高的采样率不仅浪费存储空间和计算资源，还可能因主机处理能力不足导致数据丢失。建议根据信号带宽选择采样率，一般取信号带宽的2.5~4倍即可满足工程需求。

4.4 常见误区与总结复盘

在采样率配置过程中，以下问题值得特别关注：

忽略实际采样率与请求值的差异：UHD返回的实际采样率可能与设定值有微小偏差，在需要精确时间戳或频率同步的应用中，必须使用实际值进行计算。
未考虑子板带宽限制：某些子板（如WBX）最大带宽仅为40 MHz，即使母板支持更高采样率，实际可用带宽也受限于子板。应查阅子板规格书确认最大模拟带宽。
采样率与主机接口速率不匹配：例如通过千兆以太网连接USRP时，最大可持续采样率受限于网络吞吐量（约 125 MB/s），对于 16-bit 复数数据，最高采样率约为 15.6 Msps。超过此值将必然导致丢包。
动态改变采样率未停止流：在流传输过程中调用 set_rx_rate() 会导致未定义行为，必须先停止流（stop()），修改参数后再重新启动。