GNU Radio安裝教程: Ubuntu14.04 + uhd3.10.0 + gnuradio3.7.10.1

1. 更新和安裝依賴項

在編譯安裝uhd和gnuradio以前，確保已安裝所需依賴項。Ubuntu系統運行:

sudo apt-get update

安裝UHD和GNURadio所需依賴項:

On Ubuntu 16.04 systems, run:

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.13-0v5 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-core 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 libqwt5-qt4-dev libqwtplot3d-qt4-dev pyqt4-dev-tools python-qwt5-qt4 cmake git-core wget libxi-dev gtk2-engines-pixbuf r-base-dev python-tk liborc-0.4-0 liborc-0.4-dev libasound2-dev python-gtk2 libzmq-dev libzmq1 python-requests python-sphinx libcomedi-dev python-zmq

On Ubuntu 15.04 and 15.10 systems, run:

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-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 libqwt6 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-1.13-0v5 libboost-all-dev libusb-dev libusb-1.0-0-dev fort77 libsdl1.2-dev python-wxgtk2.8 git-core libqt4-dev python-numpy ccache python-opengl libgsl0-dev python-cheetah python-mako python-lxml doxygen qt4-default qt4-dev-tools libusb-1.0-0-dev libqwt5-qt4-dev libqwtplot3d-qt4-dev pyqt4-dev-tools python-qwt5-qt4 cmake git-core wget libxi-dev gtk2-engines-pixbuf r-base-dev python-tk liborc-0.4-0 liborc-0.4-dev libasound2-dev python-gtk2 libzmq-dev libzmq1 python-requests python-sphinx libcomedi-dev python-zmq

On Ubuntu 14.04 and 14.10 systems, run:

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.13-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 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-wxgtk2.8 git-core libqt4-dev python-numpy ccache python-opengl libgsl0-dev python-cheetah python-mako python-lxml doxygen qt4-default qt4-dev-tools libusb-1.0-0-dev libqwt5-qt4-dev libqwtplot3d-qt4-dev pyqt4-dev-tools python-qwt5-qt4 cmake git-core wget libxi-dev gtk2-engines-pixbuf r-base-dev python-tk liborc-0.4-0 liborc-0.4-dev libasound2-dev python-gtk2 libzmq1 libzmq-dev python-requests python-sphinx libcomedi-dev

其餘操做系統依賴項安裝見文末參考連接

2. 獲取UHD和GNURadio源碼:

方法一: 直接下載安裝包 (UHD和gnuradio都推薦下載最新版)

下載UHD源碼: http://files.ettus.com/binaries/uhd_stable/src/

下載GNURadio源碼: http://gnuradio.org/

方法二: 使用git命令

下載UHD源碼:

git clone https://github.com/EttusResearch/uhd

下載GNURadio源碼:

git clone --recursive https://github.com/gnuradio/gnuradio

3. 安裝UHD和GNURadio:

3.1 安裝UHD

cd進入UHD源碼所在文件夾, 因爲兩種方法得到的源碼目錄結構不一樣，使用方法一下載的輸入如下命令

cd cd uhd-<對應版本號>

使用方法二下載源碼的輸入如下命令:

cd uhd/host

後續操做同樣，依次輸入如下命令便可:

mkdir build
cd build
cmake ../
make
sudo make install
sudo ldconfig

3.2 安裝log4cpp (可選, 若是不須要使用日誌功能跳過此步驟)

3.2.1下載版本：log4cpp-1.1.1.tar.gz,下載地址：http://sourceforge.net/projects/log4cpp/

3.2.2解壓下載的壓縮文件：log4cpp-1.1rc3.tar.gz，可使用命令行，或者右鍵壓縮包，在彈出菜單項中選擇「解壓至此處」

3.2.3解壓後的文件夾名爲log4cpp，在終端（快捷鍵ctrl+alt+t）中，cd到該文件夾下，注意須要root權限。

cd log4cpp
sudo su

3.2.4運行configure

./configure --with-pthreads

3.2.5在終端中依次輸入以下命令,便可完成安裝，安裝完成後，log4cpp so庫在/usr/local/lib下，頭文件在/usr/local/include目錄下

./configure
make
make install

3.2.6添加環境變量

gedit /etc/profile.d/log4cpp.sh

在文件中添加以下文字：

LD_LIBRARY_PATH=:$LD_LIBRARY_PATH:/usr/local/lib
export LD_LIBRARY_PATH

3.2.7保存好文件後，修改該文件可執行權限，在終端中輸入的命令以下：

chmod a+x /etc/profile.d/log4cpp.sh

3.2.8使用命令ldconfig -v後上述配置方可生效，在終端（ctrl+alt+t）中直接輸入ldconfig -v,注意須要root權限（在終端中輸入sudo su，而後回車輸入密碼），

desktop:/usr/local/lib# ldconfig -v

不然在程序運行後會出現以下找不到動態庫的問題：

./test_main: error while loading shared libraries: liblog4cpp.so.5: cannot open shared object file: No such file or directory

這樣咱們的log4cpp就已經成功裝上了。

3.3 安裝gnuradio

cd進入gnuradio源碼所在文件夾, 因爲兩種方法得到的源碼目錄結構不一樣，使用方法一下載的輸入如下命令, <>是對應的版本號:

cd gnuradio-<版本號>

使用方法二下載源碼的輸入如下命令，並切換到最新版本所在的分支:

cd gnuradio
git checkout <對應版本號所在的分支>

後續操做同樣，依次輸入如下命令便可完成安裝:

mkdir build
cd build
cmake ../
make
sudo make install
sudo ldconfig

若是安裝了log4cpp，則在安裝gnuradio時運行完 cmake ../ 之後會有以下顯示:

-- ENABLE_GR_LOG set to ON.
-- HAVE_LOG4CPP set to True.
-- LOG4CPP_LIBRARIES set to /usr/local/lib/liblog4cpp.so.

不然就是log4cpp沒有安裝好或者配置好，請返回log4cpp的安裝過程檢查。

至此, UHD和GNURadio的安裝已經所有完成，在終端輸入如下命令便可打開gnuradio:

sudo gnuradio-companion

4. UHD和GNURadio重裝與更新

對於使用舊版UHD和GNURadio想更新到新版本，須要先卸載GNURadio和UHD

4.1 卸載gnuradio, cd到build文件夾 cd gnuradio-<版本號>/build/ ，運行 sudo make uninstall 便可完成卸載。

4.2 卸載UHD，cd到build文件夾 cd uhd-<uhd版本號>/build/ ，運行 sudo make uninstall 便可完成卸載。

注意：先卸載gnuradio，在卸載uhd，不能先卸載uhd，以避免gnuradio沒法卸載。

5. 疑難解答

5.1 安裝玩uhd後，運行 sudo uhd_usrp_probe 出現以下錯誤:

Error: RuntimeError: Expected firmware compatibility number 7.0, but got 4.0:
The firmware build is not compatible with the host code build.
Please run:

 "/usr/local/lib/uhd/utils/uhd_images_downloader.py" 

按照提示，運行如下命令, 下載image和fw固件便可，須要保持聯網。

sudo /usr/local/lib/uhd/utils/uhd_images_downloader.py

等待更新完成以後，拔下USRP再從新插上，運行 sudo uhd_usrp_probe 便可。

5.2 安裝UHD時，運行 cmake ../ 出現以下錯誤提示:

-- 省略若干行... ...
-- Python checking for Mako templates 0.4 or greater
-- Python checking for Mako templates 0.4 or greater - "import mako" failed -- 
-- Configuring LibUHD support...
--   Dependency Boost_FOUND = 1
--   Dependency HAVE_PYTHON_PLAT_MIN_VERSION = TRUE
--   Dependency HAVE_PYTHON_MODULE_MAKO = FALSE
CMake Error at cmake/Modules/UHDComponent.cmake:51 (MESSAGE):
  Dependencies for required component LibUHD not met.
Call Stack (most recent call first):
  CMakeLists.txt:279 (LIBUHD_REGISTER_COMPONENT)

-- Configuring incomplete, errors occurred!
See also "/home/hao/software/uhd-3.9.0/build/CMakeFiles/CMakeOutput.log".

出現這個提示的主要緣由是沒有安裝Mako，Building and Installing UHD from source 提到須要安裝Mako

Mako

• Purpose: source code generation
• Minimum Version: 0.5.0
• Usage: build time (required)
• Download URL: http://www.makotemplates.org/download.html
• Alternative method: You can use pip or easy_install to install Mako from PyPi.

Mako安裝方法：

1). 下載Mako源碼，最低版本要求0.5.0：https://pypi.python.org/pypi/Mako/?

2). 解壓縮

3). 執行如下命令：

1 $ cd Mako-1.0.4/ 2 $ sudo python setup.py install

Mako安裝成功以後就能夠安裝UHD了。

5.3 安裝過程當中出現以下錯誤:

Traceback (most recent call last):
  File "setup.py", line 1, in <module>
    from setuptools import setup, find_packages
ImportError: No module named setuptools

須要先安裝setuptools，運行如下命令便可

sudo apt-get install python-setuptools

5.4 解決UHD和GNURadio 更新/重裝以後沒法識別設備的問題，以及如何爲USRP N210刷新firmware和FPGA

首先確保更新了image 鏡像，運行 sudo /usr/local/lib/uhd/utils/uhd_images_downloader.py 會自動聯網下載。若是已經下載好就不須要再執行該命令了。

默認刷 r3 版本，可是能夠自定義刷 r4 版本，（r3版與r4版有何不一樣?）

sudo /usr/local/bin/uhd_image_loader --args="type=usrp2,addr=192.168.10.2"

自定義刷r4版

sudo /usr/local/bin/uhd_image_loader --args="type=usrp2,addr=192.168.10.2" --fw-path="/usr/local/share/uhd/images/usrp_n210_fw.bin" --fpga-path="/usr/local/share/uhd/images/usrp_n210_r4_fpga.bin"

5.5 如何修改USRP N210 IP地址

USRP N210默認IP地址爲192.168.10.2，當須要多臺USRP設備時(如MIMO)才須要修改默認IP地址，注意修改IP地址以後，要斷電才能從新識別新的IP地址。

cd /usr/local/lib/uhd/utils
sudo ./usrp2_recovery.py --ifc=eth0 --new-ip=192.168.10.2

5.6 如何修改USRP name

cd /usr/local/lib/uhd/utils
./usrp_burn_mb_eeprom --values="name=#2"

5.7 升級新版本uhd和gnuradio安裝依賴項失敗

低版本升級新版本uhd和gnuradio是須要更新依賴項, 如第一節所述, 出現相似如下錯誤提示:

下列軟件包有未知足的依賴關係:
軟件包aa : 依賴: 軟件包bb 可是它將不會被安裝
          依賴: 軟件包cc 可是它將不會被安裝
          ... ...
          依賴: 軟件包xx 可是它將不會被安裝
E: 沒法修正的錯誤, 由於您要求某些軟件包保持現狀, 就是它們破壞了軟件包間的依賴關係

解決方法是手動將所需的依賴項安裝上, 假設提示aa依賴bb, cc, dd等，運行 sudo apt-get -y install bb 安裝bb，此時可能又會提示軟件包bb依賴軟件包xx, 可是xx不會安裝. 再運行 sudo apt-get -y install xx 安裝xx。依次類推, 直到成功安裝某個包以後, 再回過頭來運行第一節所述的安裝依賴項命令，直到成功安裝全部依賴項爲止。

6. 參考連接

1. Binary Installation

2. Building and Installing UHD from source

3. Building and Installing the USRP Open-Source Toolchain (UHD and GNU Radio) on Linux