超详细 ubuntu18.04 安装 UHD 和 GNURadio

1.版本号

系统环境：ubuntu18.04
UHD：v3.14.1.0
GNU radio: v3.9

2.参考链接

在参考本教程之前，建议浏览下列参考链接，对安装过程能初步判断对与错，也能明白其中哪些步骤比较关键
（1）ettus官方教程：Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on Linux
（2）gnuradio官方教程：InstallingGR
（3）参考博客：ubuntu18.04安装启动更新卸载GNU Radio
（4）参考博客：ubuntu20.04安装UHD（USRP Hardware Driver） v3.15 + GNURadio v3.8.1 （20200818）

2.安装注意事项

（1）强烈建议不要使用Binary packages installation，即 Ubuntu PPA Installation，该方法虽然安装简单，但是对软件不可控，个人感觉功能也不全，后续使用很容易出错；建议使用 install GNU Radio from source，即cmake安装方法，安装虽然复杂点，但是便于使用者修改、卸载等操作
（2）先安装UHD再安装GNU radio ;先卸载GNU radio 再卸载 UHD
（3）对于v3.8版本及以上的GNUradio要求python3版本，如果系统默认python版本是2.7，需要切换一下版本
（4）本参考教程中软件都安装在/home/workarea/路径下，不再提示

3.UHD安装步骤

3.1更新和安装依赖项

sudo apt-get update
sudo apt-get -y install git swig cmake doxygen build-essential libboost-all-dev libtool libusb-1.0-0 libusb-1.0-0-dev libudev-dev libncurses5-dev libfftw3-bin libfftw3-dev libfftw3-doc libcppunit-1.14-0 libcppunit-dev libcppunit-doc ncurses-bin cpufrequtils python-numpy python-numpy-doc python-numpy-dbg python-scipy python-docutils qt4-bin-dbg qt4-default qt4-doc libqt4-dev libqt4-dev-bin python-qt4 python-qt4-dbg python-qt4-dev python-qt4-doc python-qt4-doc libqwt6abi1 libfftw3-bin libfftw3-dev libfftw3-doc ncurses-bin libncurses5 libncurses5-dev libncurses5-dbg libfontconfig1-dev libxrender-dev libpulse-dev swig g++ automake autoconf libtool python-dev libfftw3-dev libcppunit-dev libboost-all-dev libusb-dev libusb-1.0-0-dev fort77 libsdl1.2-dev python-wxgtk3.0 git libqt4-dev python-numpy ccache python-opengl libgsl-dev python-cheetah python-mako python-lxml doxygen qt4-default qt4-dev-tools libusb-1.0-0-dev libqwtplot3d-qt5-dev pyqt4-dev-tools python-qwt5-qt4 cmake git wget libxi-dev gtk2-engines-pixbuf r-base-dev python-tk liborc-0.4-0 liborc-0.4-dev libasound2-dev python-gtk2 libzmq3-dev libzmq5 python-requests python-sphinx libcomedi-dev python-zmq libqwt-dev libqwt6abi1 python-six libgps-dev libgps23 gpsd gpsd-clients python-gps python-setuptools

3.2使用源码（from source code）安装UHD详细步骤

首先，在/home目录下创建workarea文件夹

cd $HOME
mkdir workarea #建议将UHD和GNU radio都安装在该目录下
cd workarea

从github克隆uhd，并进入该文件路径

git clone https://github.com/EttusResearch/uhd #可使用 git tag -l 命令查看是否有需要的UHD版本
cd uhd

确定版本号

git checkout v3.14.1.0 #运行该命令后会自动在 /home/workarea/uhd 目录下下载安装文件

开始编译工程

cd host
mkdir build
cd build
cmake ..
make #如果电脑配置比较好，可以打开多线程加速 make -j16
make test
sudo make install #UHD的库文件会被安装在/usr/local/lib下
sudo ldconfig #update system's shared library cache

添加环境变量
确保 LD_LIBRARY_PATH 环境变量包含 /usr/local/lib 路径。

gedit $HOME/.bashrc
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib #将该内容添加在文件最后一行

关闭现有终端，重新打开一个终端，上述修改则生效

查看UHD是否安装成功，可在终端输入以下命令：

uhd_find_devices

终端打印结果如下：

4.GNU radio安装步骤

4.1 更新和安装依赖项

官方提供的依赖项参考链接：UbuntuInstall

sudo apt-get update
sudo apt install git cmake g++ libboost-all-dev libgmp-dev swig python3-numpy \
python3-mako python3-sphinx python3-lxml doxygen libfftw3-dev \
libsdl1.2-dev libgsl-dev libqwt-qt5-dev libqt5opengl5-dev python3-pyqt5 \
liblog4cpp5-dev libzmq3-dev python3-yaml python3-click python3-click-plugins \
python3-zmq python3-scipy python3-gi python3-gi-cairo gobject-introspection gir1.2-gtk-3.0

如果安装版本GNU Radio v3.9及以上，则还需要以下依赖项：

sudo apt install pybind11-dev python3-matplotlib

4.2 修改默认python版本为python3

sudo update-alternatives --install /usr/bin/python python /usr/bin/python2 100
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 150

4.3 安装volk

cd workarea
git clone https://github.com/gnuradio/volk.git
cd volk
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DPYTHON_EXECUTABLE=/usr/bin/python3 ../

如果报错和下图一致，按照报错提示，重新输入：

git submodule update --init
cmake -DCMAKE_BUILD_TYPE=Release -DPYTHON_EXECUTABLE=/usr/bin/python3 ../

cmake成功后，继续执行以下命令完成volk的安装：

make -j16
make test
sudo make install
sudo ldconfig

4.4 使用源码（from source code）安装GNU radio详细步骤

按照顺序执行以下命令：

cd workarea
git clone --recursive https://github.com/gnuradio/gnuradio
cd gnuradio
git checkout v3.8.2.0
git submodule update --init --recursive
mkdir build
cd build
cmake ../
make -j16
make test
sudo make install
sudo ldconfig

打开新的终端输入：gnuradio-config-info –v 查看版本

5.最后统一修改路径

echo 'export PYTHONPATH=/usr/local/lib/python3/dist-packages:usr/local/lib/python2.7/site-packages:$PYTHONPATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH' >> ~/.bashrc
echo 'export PYTHONPATH=/usr/local/lib/python3/dist-packages:usr/local/lib/python2.7/site-packages:$PYTHONPATH' >> ~/.profile
echo 'export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH' >> ~/.profile
sudo ldconfig

最后重启电脑，终端输入 gnuradio-companion 指令可打开软件，也可以也在Ubuntu搜索栏找到软件图标，添加到收藏栏！

6.GNU radio 启动报错 ModuleNotFoundError 解决办法

如果在使用指令或者图标启动GNU radio软件时报错，如下图所示：

参考该链接 ModuleNotFoundError 解决问题！