Ubuntu 20.04下GNURadio 3.8 + UHD驱动完整安装避坑指南（含U盘还原技巧）-开发者社区

Ubuntu 20.04下GNURadio 3.8 + UHD驱动完整安装避坑指南（含U盘还原技巧）

在软件无线电（SDR）开发领域，GNURadio配合USRP硬件堪称黄金组合。但让这套系统在Ubuntu 20.04上完美运行，往往需要跨越依赖冲突、环境变量配置、驱动兼容性等多重障碍。本文将带你用最稳妥的方式完成整套环境搭建，并附赠U盘还原等实用技巧，确保即使安装失败也能快速恢复战场。

1. 环境准备：打造纯净的安装基础

安装前的系统状态直接影响成功率。建议使用刚安装好的Ubuntu 20.04 LTS系统，避免已有软件包造成依赖冲突。如果系统中已经安装过GNURadio或UHD驱动，建议先执行彻底清理：

# 移除可能存在的旧版本 sudo apt remove --purge gnuradio uhd-host sudo apt autoremove sudo rm -rf /usr/local/lib/uhd /usr/local/share/uhd

关键准备项：

确保系统已更新：sudo apt update && sudo apt upgrade -y
预留至少20GB磁盘空间（编译过程会产生大量中间文件）
准备稳定的网络连接（部分仓库需要从国外服务器克隆）

提示：如果使用虚拟机环境，建议分配至少4核CPU和8GB内存，否则编译过程可能耗时数小时。

2. 分阶段安装：从依赖到核心组件

2.1 基础依赖安装

先安装构建工具和基础库：

sudo apt install -y git cmake g++ libboost-all-dev libgmp-dev \ libfftw3-dev libsdl1.2-dev libgsl-dev libqwt-qt5-dev \ libqt5opengl5-dev python3-numpy python3-mako \ python3-sphinx python3-lxml doxygen libxml2-dev \ libusb-1.0-0-dev libcomedi-dev libzmq3-dev

2.2 UHD驱动安装

UHD（USRP Hardware Driver）是连接GNURadio与USRP设备的桥梁。推荐从源码安装最新稳定版：

git clone https://github.com/EttusResearch/uhd.git cd uhd/host mkdir build cd build cmake -DCMAKE_BUILD_TYPE=Release .. make -j$(nproc) sudo make install sudo ldconfig

验证安装：

uhd_find_devices # 连接设备后应能看到设备信息

2.3 GNURadio 3.8源码编译

获取特定版本源码并切换分支：

git clone --recursive https://github.com/gnuradio/gnuradio.git cd gnuradio git checkout maint-3.8 # 切换到3.8维护分支

编译安装VOLK（Vector Optimized Library of Kernels）：

git clone https://github.com/gnuradio/volk.git cd volk git checkout v2.2.1 mkdir build cd build cmake -DCMAKE_BUILD_TYPE=Release .. make -j$(nproc) sudo make install

主程序编译：

cd ../../ # 返回gnuradio目录 mkdir build cd build cmake -DCMAKE_BUILD_TYPE=Release -DPYTHON_EXECUTABLE=/usr/bin/python3 .. make -j$(nproc) make test # 可选，验证编译结果 sudo make install sudo ldconfig

3. 环境配置：那些容易忽略的关键步骤

3.1 Python路径配置

编辑~/.bashrc文件，添加以下内容：

export PYTHONPATH=/usr/local/lib/python3/dist-packages:$PYTHONPATH export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

使配置立即生效：

source ~/.bashrc

3.2 解决GUI启动问题

如果从Ubuntu应用菜单启动GNURadio Companion失败，可创建自定义启动器：

cat <<EOF > ~/.local/share/applications/gnuradio-companion.desktop [Desktop Entry] Name=GNURadio Companion Exec=env PYTHONPATH=/usr/local/lib/python3/dist-packages gnuradio-companion Icon=/usr/local/share/gnuradio/pixmaps/gnuradio-logo.svg Terminal=false Type=Application Categories=Development; EOF

4. 常见问题排查手册

4.1 网络克隆失败处理

当git clone因网络问题失败时，可改用国内镜像：

# UHD镜像 git clone https://mirrors.tuna.tsinghua.edu.cn/git/ettusresearch/uhd.git # GNURadio镜像 git clone https://mirrors.tuna.tsinghua.edu.cn/git/gnuradio/gnuradio.git

4.2 编译错误解决方案

问题1：Could NOT find Doxygen
解决：sudo apt install doxygen

问题2：Boost version mismatch
解决：指定正确Boost路径：

cmake -DBOOST_ROOT=/usr/include/boost ...

4.3 设备识别问题

如果uhd_find_devices找不到设备：

检查USB连接和供电
添加USB设备规则：

sudo cp /usr/local/lib/uhd/utils/uhd-usrp.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules

5. 系统恢复与U盘还原技巧

5.1 彻底卸载GNURadio/UHD

当需要重新安装时，确保完全清除旧版本：

# 查找所有相关文件 sudo find / -name "*gnuradio*" -exec rm -rf {} + sudo find / -name "*uhd*" -exec rm -rf {} + # 清理残留配置 sudo apt purge $(dpkg -l | grep gnuradio | awk '{print $2}')

5.2 U盘还原终极方案

使用Ubuntu内置工具恢复U盘到原始状态：

# 1. 查看U盘设备标识（如/dev/sdb） lsblk # 2. 清除分区表（谨慎操作！确认设备名正确） sudo dd if=/dev/zero of=/dev/sdb bs=1M count=1 # 3. 创建新分区 sudo fdisk /dev/sdb # 在fdisk交互界面中依次输入：n→p→1→回车→回车→w # 4. 格式化 sudo mkfs.vfat /dev/sdb1