在树莓派上编译安装支持RTL-SDR Blog V4的Gqrx SDR接收机

本文将详细介绍如何在树莓派4B上从源码编译安装Gqrx软件定义无线电接收机，并使其支持RTL-SDR Blog V4设备。整个过程涉及多个组件的编译和配置，包括RTL-SDR驱动、gr-osmosdr中间件和Gqrx主程序。

系统准备

首先需要准备一个全新的64位Debian Bookworm系统（Raspberry Pi OS）。确保系统已更新至最新版本：

sudo apt update && sudo apt upgrade -y

RTL-SDR驱动编译安装

RTL-SDR Blog V4设备需要最新版本的驱动支持。我们使用Osmocom项目维护的RTL-SDR驱动源码：

sudo apt install -y libusb-1.0-0-dev cmake pkg-config
git clone https://gitea.osmocom.org/sdr/rtl-sdr.git
cd rtl-sdr
mkdir build && cd build
cmake ../ -DINSTALL_UDEV_RULES=ON -DDETACH_KERNEL_DRIVER=ON
make
sudo make install
sudo ldconfig

关键参数说明：

• INSTALL_UDEV_RULES=ON：自动安装设备访问权限规则
• DETACH_KERNEL_DRIVER=ON：运行时自动卸载内核驱动，无需手动黑名单

gr-osmosdr编译安装

gr-osmosdr是GNU Radio的硬件抽象层，为Gqrx提供设备支持。安装时需要特别注意避免自动安装系统版本的RTL-SDR驱动：

sudo apt install -y gnuradio-dev --no-install-recommends
git clone https://gitea.osmocom.org/sdr/gr-osmosdr.git 
cd gr-osmosdr
mkdir build && cd build
cmake -DCMAKE_CXX_FLAGS=-Wno-register ..
make
sudo make install
sudo ldconfig

使用--no-install-recommends参数可以防止自动安装系统版本的librtlsdr0包，确保使用我们自行编译的驱动版本。

Gqrx编译安装

安装Gqrx的依赖项和主程序：

sudo apt install -y qt6-base-dev qt6-svg-dev qt6-wayland libasound2-dev libjack-jackd2-dev portaudio19-dev libpulse-dev
git clone https://github.com/gqrx-sdr/gqrx.git
cd gqrx
mkdir build && cd build
cmake ..
make
sudo make install

性能优化

最后执行VOLK性能分析，优化信号处理例程：

volk_profile

常见问题解决

1. 设备权限问题：如果遇到设备访问错误，请确保已重启系统使udev规则生效。

2. PLL锁定失败：RTL-SDR Blog V4设备可能出现"PLL not locked"警告，这通常不影响基本功能使用。

3. 驱动冲突：如果之前手动添加过内核模块黑名单，在使用了DETACH_KERNEL_DRIVER=ON参数后可以移除。

总结

通过从源码编译安装的方式，我们成功在树莓派4B上构建了支持RTL-SDR Blog V4设备的Gqrx接收机。这种方法虽然步骤较多，但能够确保使用最新的驱动和功能支持。未来随着Debian/Raspberry Pi OS的版本更新，这些功能可能会被纳入官方软件源，简化安装过程。

整个过程中最关键的是确保驱动链的一致性，避免系统自动安装的驱动与自行编译的驱动产生冲突。通过控制依赖项的安装方式和正确的编译参数，可以构建出稳定可靠的SDR接收系统。