Ubuntu16.04系统下UHD+GNU Radio的安装

安装环境：Ubuntu16.04
安装版本：UHD3.9.7+GNU Radio3.7.9

一、准备工作

由于系统默认的Ubuntu软件源的服务器在国外，下载可能比较慢，可以根据Ubuntu的版本更换软件源为国内服务器。此外，针对版本比较老的Ubuntu系统，系统默认软件源可能已经不提供更新，一定要对软件源进行更新。

1. 备份系统默认的软件源文件

	cd /etc/apt        # 进入到apt目录下 	
	sudo cp sources.list sources.list.bak   # 备份 	
	sudo gedit sources.list        # 打开sources.list 

2. 用新的软件源覆盖sources.list中的内容
   以下给出的软件源镜像适用于Ubuntu16.04

	# 默认注释了源码镜像以提高apt update速度，如有需要可自行取消注释   
	deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial main restricted universe multiverse   
	# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial main restricted universe multiverse   
	deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-updates main restricted universe multiverse   
	# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-updates main restricted universe multiverse   
	deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-backports main restricted universe multiverse   
	# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-backports main restricted universe multiverse   
	deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-security main restricted universe multiverse   
	# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-security main restricted universe multiverse      
	# 预发布软件源，不建议启用   
	# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-proposed main restricted universe multiverse   
	# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ xenial-proposed main restricted universe multiverse  

3. 更新软件源
   替换完成后，一定要运行以下命令，更新软件源

	sudo apt-get update

二、软件安装流程

在安装GNU Radio之前建议优先安装UHD驱动，避免出现不兼容问题。
UHD驱动下载方式如下：

1. UHD驱动官网下载地址（需要科学上网）：http://files.ettus.com/binaries/uhd_stable/
2. GitHub上下载UHD源码：https://github.com/EttusResearch/uhd/

GNU Radio所有发行版本下载地址：https://www.gnuradio.org/releases/gnuradio/

1 安装UHD+GNU Radio依赖包

使用apt-get安装必备的依赖包，Ubuntu版本不同，所需要的依赖包也不同，所以需要去官网查看不同版本系统需要安装的依赖包。
官网查看依赖包网址：https://wiki.gnuradio.org/index.php/UbuntuInstall
下面给出Ubuntu16.04系统下安装GNU Radio3.7.x所需要的依赖包：

	sudo apt-get -y install git-core cmake g++ python-dev swig pkg-config libfftw3-dev \
	libboost-all-dev libcppunit-dev libgsl0-dev libusb-dev libsdl1.2-dev python-wxgtk3.0 \
	python-numpy python-cheetah python-lxml doxygen libxi-dev python-sip libqt4-opengl-dev \
	libqwt-dev libfontconfig1-dev libxrender-dev python-sip python-sip-dev python-qt4 \
	python-sphinx libusb-1.0-0-dev libcomedi-dev libzmq-dev 

2 安装UHD驱动

（1）若使用uhd驱动安装包进行安装，提取.zip文件

	unzip <filename>

（2）解压后，运行终端至该文件夹目录下，依次执行下述步骤

	cd host
	mkdir build    # 创建build文件夹
	cd build
	cmake ../      # 

（3）编译源码（时间比较长）

	make
	或者make-j4   # 使用多线程加速
	make test

（4）安装编译完成的库

	sudo make install

（5）更新环境变量和共享库

	sudo ldconfig    # 更新系统的library cache
	export LD_LIBRARY_PATH=/usr/local/lib    # 添加共享库到系统路径中

（6）查找USRP外设测试（针对usb版本的USRP外设）
使用USRP外设测试uhd是否成功，即是否能够识别到USRP

	sudo uhd_find_devices   # 查找设备

如果出现下述情况，则需要另外手动添加UHD镜像文件，相关安装详见第3部分-更新firware/FPGA images

3 更新firware/FPGA images

UHD的images镜像文件下载地址（需要科学上网）：https://files.ettus.com/binaries/images/
（1）在/usr/local/share/目录下创建一个uhd文件夹

	cd /usr/local/share/  
	mkdir uhd

（2）将下载解压缩后的UHD镜像文件下的images目录拷贝到刚创建的uhd文件夹下

	cp -r images /usr/local/share/uhd 

（3）查找USRP外设测试（针对usb版本的USRP外设）

	sudo uhd_find_devices    # 查找设备

UHD成功识别到USRP外设并能够显示相关信息，安装成功。

进一步可以查看USRP设备的详细信息，包括母板和子板的设备参数：

	sudo uhd_usrp_probe   # 查看USRP的设备信息（包括母板和子板的设备参数）

4 安装GNU Radio

成功安装UHD驱动后，下面开始安装GNU Radio
GNU Radio的安装可以选择下载源码安装或直接用apt-get安装
（1）检查可供安装版本

	sudo apt-cache madison gnuradio

（2）执行安装命令

	sudo apt-get install gnuradio=3.7.9.1-2ubuntu1 

（3）启动软件

	gnuradio-companion

运行后出现以下界面，表面GNU Radio安装成功。

参考：
1.（UHD官网安装教程）https://kb.ettus.com/Building_and_Installing_the_USRP_Open-Source_Toolchain_(UHD_and_GNU_Radio)_on_Linux
2.（GNU Radio官网安装教程）https://wiki.gnuradio.org/index.php/InstallingGR#Linux