UHD - 构建指导

目录

  1. 1 依存性 - Build Dependencies
    1. 1.1 Git
    2. 1.2 C++
    3. 1.3 CMake
    4. 1.4 Boost
    5. 1.5 LibUSB
    6. 1.6 Python
    7. 1.7 Cheetah
    8. 1.8 Doxygen
    9. 1.9 Docutils
  2. 2 创建指导 (Unix)
    1. 2.1 生成带 cmake 的 Makefiles
    2. 2.2 构建和安装
    3. 2.3 配置库的路径 (Linux)
    4. 2.4 配置库的路径 (Mac OS X)
  3. 3 创建指导  (Windows)
    1. 3.1 生成带 cmake 的项目（ project）
    2. 3.2 LibUSB cmake 的注解
    3. 3.3 在 MSVC 中构建项目（project）
    4. 3.4 在 MSVC 中构建项目 (command line)
    5. 3.5 配置环境变量的路径（PATH）


依存性 - Build Dependencies

Linux Notes: 其依存性可以通过包管理来处理。

Mac OS X Notes: 安装 "Xcode Developer Tools" 便可获得构建用的工具（gcc 和 make）。使用 MacPorts 处理 Boost 和 Cheetah 的依赖关系。其它依存性可从站点下载 dmg 安装管理来实现。

Windows Notes: 其依存性可以通过可安装的 exe 文件来获得。通常 Windows 的安装文件可在站点获得。有些站点也许没有 Windows 的安装程序。如若如此，只有沿循用于 Windows 安装程序的附件下载 url (如下)。

Git

需要查看库（repository）。对于 Windows 而言，需要安装带有 Git 的 Cygwin 来查看库（repository）；或者也可以到如下站点获得并安装 Msysgit：

http://code.google.com/p/msysgit/downloads/list

C++

对 Unix 而言，使用 GCC 4.0 或更高版本。对 Windows 而言，使用 MSVC 2008。其它的编译器还没有被测试并确认其可用性。

CMake

Boost

LibUSB

Python

  • 目的: 用于 Cheetah 和功用脚本（utility scripts）
  • 版本: 最低 2.6
  • 用法：构建时 (build-time) + 运行时的功用脚本必选（run time utility scripts - required）
  • 下载 URL： http://www.python.org/download/

Cheetah

Doxygen

Docutils

创建指导 (Unix)

生成带 cmake 的 Makefiles

cd <uhd-repo-path>/host
mkdir build
cd build
cmake ../

进而，配置参数可以通过命令行传输到 cmake。下面便是一些常见的配置参数：

  • 用于定制安装的前缀： -DCMAKE_INSTALL_PREFIX=<prefix>
  • 将 libs 装入 lib64: cmake -DLIB_SUFFIX=64

用法示例:

cmake -DCMAKE_INSTALL_PREFIX=/opt/uhd ../

构建和安装

make
make test
sudo make install

配置库的路径 (Linux)

明确 libuhd.so 处于 LD_LIBRARY_PATH 中，或者将其添加进 /etc/ld.so.conf 中并运行 sudo ldconfig

配置库的路径 (Mac OS X)

确保 libuhd.dylib 处于 DYLD_LIBRARY_PATH 之中。

创建指导  (Windows)

生成带 cmake 的项目（ project）

  • 打开 cmake gui 程序.
  • 配置源代码的路径： <uhd-repo-path>/host
  • 配置构建目录的路径： <uhd-repo-path>/host/build
  • 确保路径（paths ）不能包含空格。
  • 点击进入 configure 并选择 MSVC 编译器。
  • 配置构建参数然后再点击 configure 一次。
  • 点击 generate 这样项目文档（project file）便在构建目录（build directory）下被生成。

LibUSB cmake 的注解

在 Windows 环境下，cmake 不具备 pkg-config 的优势，这样便须手动告知 cmake 如何定位 LibUSB 的头和库 （header 和 lib）。

在 cmake gui 中，选择 "Advanded View"：

  • Set LIBUSB_INCLUDE_DIR to the directory with "libusb.h".
  • Set LIBUSB_LIBRARIES to the full path for "libusb-1.0.lib".

然后选择 enable USRP1 support 点击 configure 和 generate。

在 MSVC 中构建项目（project）

  • 打开 MSVC 中生成的项目文档。
  • 将构建类型从 "Debug" 变为 "Release"。
  • 选择构建所有的目标（build all target），右击鼠标并选择构建（build）。
  • 选择安装目标，右击、并选择构建（build）。

注: 或许没有权限来构建安装目标。如若如此以管理员或以管理员身份运行 MSVC。

在 MSVC 中构建项目 (command line)

打开 Visual Studio 命令提示符（Command Prompt Shorcut）：

cd <uhd-repo-path>\host\build
DevEnv ALL_BUILD.vcproj /Build Release
DevEnv INSTALL.vcproj /Build Release

配置环境变量的路径（PATH）

  • 添加 boost library path 到 %PATH% (usually c:\program files\boost\<version>\lib)
  • 添加 uhd library path 到 %PATH% (usually c:\program files\uhd\lib)
  • 添加 libusb library 到 %PATH% (if using usb support)
注: Windows 环境下的编辑环境变量的路径的接口十分不好用。建议通过 "Rapid Environment Editor" (http://www.rapidee.com) 缺省编辑。












注：UHD - Build Guide （英文原文出处，以上翻译整理仅供参考 Email: support@microembedded.com !）