UHD - 构建指导



依存性 - 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 !)