安装RTL-SDR/AirSpy的SoapySDR模块后无法识别设备求助

问题核心分析 #

从SoapySDRUtil --info的输出可知：

• 你的SoapySDR是源码编译安装的（安装根目录为/usr/local，版本带git哈希值）
• 模块搜索路径/usr/local/lib/SoapySDR/modules0.8-3缺失，且未找到任何设备模块
• 通过apt安装的soapysdr-module-rtlsdr模块默认存放在系统库路径（如/usr/lib/x86_64-linux-gnu/SoapySDR/modules0.8），和SoapySDR的搜索路径不匹配，导致无法加载

解决方案步骤 #

1. 确认RTL-SDR模块的实际安装位置 #

执行命令查看soapysdr-module-rtlsdr的文件路径：

dpkg -L soapysdr-module-rtlsdr

输出中会包含类似这样的模块文件路径：

/usr/lib/x86_64-linux-gnu/SoapySDR/modules0.8/librtlsdrSupport.so

2. 让SoapySDR加载到RTL-SDR模块 #

选择以下两种方法之一即可：

方法一：临时设置环境变量

在终端中执行（替换为你实际的模块目录）：

export SOAPY_SDR_MODULE_PATH=/usr/lib/x86_64-linux-gnu/SoapySDR/modules0.8

重新运行SoapySDRUtil --info，应该能在Available factories中看到rtlsdr。

永久生效：将上述命令添加到~/.bashrc或~/.zshrc文件末尾，重启终端后自动生效。

方法二：创建软链接匹配搜索路径

先创建SoapySDR期望的模块目录：

sudo mkdir -p /usr/local/lib/SoapySDR/modules0.8-3

再将RTL-SDR模块链接到该目录：

sudo ln -s /usr/lib/x86_64-linux-gnu/SoapySDR/modules0.8/librtlsdrSupport.so /usr/local/lib/SoapySDR/modules0.8-3/

3. 验证模块加载与设备识别 #

执行命令确认模块加载成功：

SoapySDRUtil --info

如果看到Available factories... rtlsdr，说明模块加载正常。

接着扫描设备：

SoapySDRUtil --find

能列出你的RTL-SDR设备，说明问题解决。

4. 运行C API示例 #

模块加载正常后，重新编译运行示例：

gcc -std=c99 example.c -lSoapySDR && ./a.out

此时应该能正确识别设备并获取时间序列流。

额外排查点 #

• 若设备仍未被识别，检查USB权限：将当前用户加入plugdev组（sudo usermod -aG plugdev $USER），重新插拔设备后重试。
• 用rtl_test命令测试RTL-SDR硬件的基础功能，确认硬件本身无故障。

内容的提问来源于stack exchange，提问作者Doug