uhd/host/CMakeLists.txt
Abhishek Verma e24b1cb8bb host/mpm: replace mpRPC with gRPC transport
host:
Replace the msgpack-RPC (rpclib) client with a gRPC-based
implementation. Add auto-generated C++ client and Python bindings
from protobuf definitions. Remove rpclib dependency and integrate
FindgRPC into CMake.

mpm:
Replace the msgpack-RPC server with a gRPC server generated from
protobuf definitions. Add pb_utils.py for type conversion between
Python and protobuf. Update rpc_server.py to dispatch calls via
gRPC stubs. Update mpm_shell to use gRPC. Replace pyudev with sysfs
scan in uio device discovery.

Bump MPM compatibility number to 7.0 and RPC version to 2.

This change requires new depedencies. E.g. for Ubuntu 24.04 or 25.10:
libgrpc++-dev, libprotobuf-dev, protobuf-compiler-grpc, python3-grpcio
2026-07-09 12:12:04 +02:00

751 lines
28 KiB
CMake

#
# Copyright 2010-2018 Ettus Research, a National Instruments Company
# Copyright 2019 Ettus Research, a National Instruments Brand
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# NOTE! If you change the version in the following line, also change
# UHD_CMAKE_MIN_VERSION in UHDMinDepVersions. (This won't take a variable).
cmake_minimum_required(VERSION 3.12)
if(POLICY CMP0048)
cmake_policy(SET CMP0048 NEW) # Suppress Version warnings
endif(POLICY CMP0048)
########################################################################
# Select cmake build type
# Use release build type by default to get optimization flags
# Do this before project setup to ensure dependend libraries use
# the correct build type for library search.
########################################################################
if(NOT CMAKE_BUILD_TYPE)
set(CMAKE_BUILD_TYPE "Release")
message(STATUS "Build type not specified: defaulting to release.")
endif(NOT CMAKE_BUILD_TYPE)
set(CMAKE_BUILD_TYPE "${CMAKE_BUILD_TYPE}" CACHE STRING "")
# Force UHD_RELEASE_MODE to be a string for cmake-gui
set(UHD_RELEASE_MODE "${UHD_RELEASE_MODE}" CACHE STRING "UHD Release Mode")
########################################################################
# Project setup
########################################################################
# Backup custom UHD_VERSION if defined by using option -DUHD_VERSION=...,
# because project() will reset it to an empty string.
if(UHD_VERSION)
set(CUSTOM_UHD_VERSION "${UHD_VERSION}")
endif(UHD_VERSION)
# Note: if UHD_VERSION is not defined, project() will leave it undefined
# for cmake version < 4.1.0, but set it to an empty string for cmake
# version >= 4.1.0.
project(UHD CXX C)
# Restore the custom UHD_VERSION if it was defined before project()
if(DEFINED CUSTOM_UHD_VERSION)
set(UHD_VERSION "${CUSTOM_UHD_VERSION}" CACHE STRING "" FORCE)
endif(DEFINED CUSTOM_UHD_VERSION)
enable_testing()
# Make sure our local CMake Modules path comes first
list(INSERT CMAKE_MODULE_PATH 0 ${UHD_SOURCE_DIR}/cmake/Modules)
########################################################################
# UHD Dependency Minimum Versions are stored in a separate file
########################################################################
include(UHDMinDepVersions)
########################################################################
# Check Compiler Version
########################################################################
if(${CMAKE_CXX_COMPILER_ID} STREQUAL "GNU")
if(DEFINED CMAKE_CXX_COMPILER_VERSION)
if(${CMAKE_CXX_COMPILER_VERSION} VERSION_LESS ${UHD_GCC_MIN_VERSION})
message(WARNING
"\nThe compiler selected to build UHD "
"(GCC version ${CMAKE_CXX_COMPILER_VERSION} : ${CMAKE_CXX_COMPILER}) "
"is older than that officially supported (${UHD_GCC_MIN_VERSION} minimum). "
"This build may or not work. "
"We highly recommend using a more recent GCC version.")
endif()
else()
message(WARNING
"\nCannot determine the version of the compiler selected to build UHD "
"(GCC : ${CMAKE_CXX_COMPILER}). This build may or not work. We highly "
"recommend using GCC version ${UHD_GCC_MIN_VERSION} or more recent.")
endif()
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -Og")
elseif(${CMAKE_CXX_COMPILER_ID} MATCHES "Clang")
execute_process(COMMAND
${CMAKE_CXX_COMPILER} -v
RESULT_VARIABLE res ERROR_VARIABLE err
ERROR_STRIP_TRAILING_WHITESPACE)
if(${res} STREQUAL "0")
# Version output is in error stream
string(REGEX MATCH "^Apple.*" IS_APPLE ${err})
# Retrieve the compiler's version
if("${IS_APPLE}" STREQUAL "")
set(MIN_VERSION ${UHD_CLANG_MIN_VERSION})
set(APPLE_STR "")
string(REGEX MATCH "clang version [0-9.]+" CLANG_OTHER_VERSION ${err})
string(REGEX MATCH "[0-9.]+" CLANG_VERSION ${CLANG_OTHER_VERSION})
else()
set(MIN_VERSION ${UHD_APPLECLANG_MIN_VERSION})
set(APPLE_STR "Apple ")
string(REGEX MATCH "(clang-[0-9.]+)" CLANG_APPLE_VERSION ${err})
string(REGEX MATCH "[0-9.]+" CLANG_VERSION ${CLANG_APPLE_VERSION})
endif()
if(${CLANG_VERSION} VERSION_LESS "${MIN_VERSION}")
message(WARNING
"\nThe compiler selected to build UHD "
"(${APPLE_STR}Clang version ${CLANG_VERSION} : ${CMAKE_CXX_COMPILER}) "
"is older than that officially supported (${MIN_VERSION} minimum). "
"This build may or not work. We highly recommend using Apple Clang "
"version ${UHD_APPLECLANG_MIN_VERSION} or more recent, "
"or Clang version ${UHD_CLANG_MIN_VERSION} or more recent.")
endif()
else()
message(WARNING
"\nCannot determine the version of the compiler selected to build UHD "
"(${APPLE_STR}Clang : ${CMAKE_CXX_COMPILER}). This build may or not work. "
"We highly recommend using Apple Clang version ${UHD_APPLECLANG_MIN_VERSION} "
"or more recent, or Clang version ${UHD_CLANG_MIN_VERSION} or more recent.")
endif()
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -Og")
elseif(MSVC)
if(${MSVC_VERSION} VERSION_LESS ${UHD_MSVC_MIN_VERSION})
message(FATAL_ERROR
"\nMSVC version is less than the required minimum. "
"Required: ${UHD_MSVC_MIN_VERSION_READABLE}")
endif(${MSVC_VERSION} VERSION_LESS ${UHD_MSVC_MIN_VERSION})
endif()
set(CMAKE_CXX_STANDARD 20)
if(CMAKE_SYSTEM_NAME STREQUAL "FreeBSD" AND ${CMAKE_CXX_COMPILER_ID} STREQUAL "Clang")
set(CMAKE_EXE_LINKER_FLAGS "-lthr ${CMAKE_EXE_LINKER_FLAGS}")
set(CMAKE_CXX_FLAGS "-stdlib=libc++ ${CMAKE_CXX_FLAGS}")
endif()
########################################################################
# Packaging Variables
########################################################################
option(UNDERSCORE_UHD_VERSION "Replace dashes in uhd version with underscores" OFF)
set(LIBUHD_PKG ${LIBUHD_PKG} CACHE BOOL "Build Debian libuhd003 package")
set(LIBUHDDEV_PKG ${LIBUHDDEV_PKG} CACHE BOOL "Build Debian libuhd-dev package")
set(UHDHOST_PKG ${UHDPOST_PKG} CACHE BOOL "Build Debian uhd-host package")
include(UHDComponent) #enable components
include(UHDPackage) #setup cpack
########################################################################
# Install Dirs
########################################################################
include(GNUInstallDirs)
set(PKG_DATA_DIR ${CMAKE_INSTALL_DATAROOTDIR}/uhd)
if(NOT DEFINED PKG_LIB_DIR)
set(PKG_LIB_DIR ${CMAKE_INSTALL_LIBDIR}/uhd)
endif()
if(NOT DEFINED PKG_DOC_DIR)
# Note: CMAKE_INSTALL_DOCDIR would go to share/doc/UHD (capitalized) because
# that's what the project name is, but we want to keep it lowercase.
string(TOLOWER "${CMAKE_INSTALL_DOCDIR}" PKG_DOC_DIR)
endif()
set(PKG_MAN_DIR ${CMAKE_INSTALL_MANDIR}/man1)
########################################################################
# UHD config files
########################################################################
set(UHD_USER_CONF_FILE
"uhd.conf"
CACHE STRING
"Location of the user-specific UHD configuration file, relative to APPDATA (or XDG_CONFIG_HOME)"
)
if(UNIX)
set(UHD_SYS_CONF_FILE
"/etc/uhd/uhd.conf"
CACHE STRING
"Location of the system-wide UHD configuration file"
)
elseif(WIN32)
set(UHD_SYS_CONF_FILE
"%programdata%/uhd/uhd.conf"
CACHE STRING
"Location of the system-wide UHD configuration file"
)
else()
message(WARNING "Not setting UHD_SYS_CONF_FILE!")
endif()
########################################################################
# UHD Image Directories
########################################################################
if(NOT DEFINED UHD_IMAGES_DIR)
if(DEFINED FPGA_IMAGES_DIR)
set(UHD_IMAGES_DIR ${FPGA_IMAGES_DIR})
else(DEFINED FPGA_IMAGES_DIR)
file(TO_NATIVE_PATH ${CMAKE_INSTALL_PREFIX}/share/uhd/images using_images_dir)
set(UHD_IMAGES_DIR ${using_images_dir})
endif(DEFINED FPGA_IMAGES_DIR)
endif(NOT DEFINED UHD_IMAGES_DIR)
message( STATUS "Using UHD Images Directory: ${UHD_IMAGES_DIR}" )
if(DEFINED UHD_IMAGES_DIR_WINREG_KEY)
add_definitions(-DUHD_IMAGES_DIR_WINREG_KEY=${UHD_IMAGES_DIR_WINREG_KEY})
endif(DEFINED UHD_IMAGES_DIR_WINREG_KEY)
########################################################################
# Local Include Dir
########################################################################
include_directories(${UHD_BINARY_DIR}/include)
include_directories(${UHD_SOURCE_DIR}/include)
########################################################################
# Static Lib Configuration
########################################################################
option(ENABLE_STATIC_LIBS "Enable building of static libraries" OFF)
if(ENABLE_STATIC_LIBS)
message(STATUS "Building Static Libraries: ${ENABLE_STATIC_LIBS}")
endif(ENABLE_STATIC_LIBS)
########################################################################
# On Apple only, set install name and rpath correctly if not already set
########################################################################
if(APPLE)
if(NOT CMAKE_INSTALL_NAME_DIR)
set(CMAKE_INSTALL_NAME_DIR ${CMAKE_INSTALL_FULL_LIBDIR} CACHE
PATH "Library Install Name Destination Directory" FORCE)
endif(NOT CMAKE_INSTALL_NAME_DIR)
if(NOT CMAKE_INSTALL_RPATH)
set(CMAKE_INSTALL_RPATH ${CMAKE_INSTALL_FULL_LIBDIR} CACHE
PATH "Library Install RPath" FORCE)
endif(NOT CMAKE_INSTALL_RPATH)
if(NOT CMAKE_BUILD_WITH_INSTALL_RPATH)
set(CMAKE_BUILD_WITH_INSTALL_RPATH ON CACHE
BOOL "Do Build Using Library Install RPath" FORCE)
set(CMAKE_BUILD_WITH_INSTALL_NAME_DIR ON CACHE
BOOL "Set install name to install name dir during build" FORCE)
endif(NOT CMAKE_BUILD_WITH_INSTALL_RPATH)
endif(APPLE)
########################################################################
# Optional Compiler Flags
########################################################################
include(CheckCXXCompilerFlag)
macro(UHD_ADD_OPTIONAL_CXX_COMPILER_FLAG flag have)
CHECK_CXX_COMPILER_FLAG(${flag} ${have})
if(${have})
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${flag}")
endif(${have})
endmacro(UHD_ADD_OPTIONAL_CXX_COMPILER_FLAG)
if(${CMAKE_CXX_COMPILER_ID} STREQUAL "GNU" OR
${CMAKE_CXX_COMPILER_ID} MATCHES "Clang")
if(STRIP_BINARIES)
if(NOT CMAKE_BUILD_TYPE STREQUAL "Debug")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -s")
endif(NOT CMAKE_BUILD_TYPE STREQUAL "Debug")
endif(STRIP_BINARIES)
add_definitions(-Wall)
add_definitions(-Wextra)
add_definitions(-Wsign-compare)
#add_definitions(-Wconversion)
#add_definitions(-pedantic)
#add_definitions(-ansi)
if(NOT WIN32)
# Only export symbols that are declared to be part of the uhd api (non dll platforms)
UHD_ADD_OPTIONAL_CXX_COMPILER_FLAG(-fvisibility=hidden HAVE_VISIBILITY_HIDDEN)
UHD_ADD_OPTIONAL_CXX_COMPILER_FLAG(-fvisibility-inlines-hidden HAVE_VISIBILITY_INLINES_HIDDEN)
endif(NOT WIN32)
if(${CMAKE_BUILD_TYPE} STREQUAL "Coverage")
include(CodeCoverage)
# Never fail ctest, always generate coverage report
setup_target_for_coverage(coverage "ctest || return 0" coverage)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -pedantic -pthread -g -O0 -fprofile-arcs -ftest-coverage" CACHE STRING "Flags used by the C++ compiler during Coverage builds." FORCE)
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -pedantic -pthread -g -O0 -fprofile-arcs -ftest-coverage" CACHE STRING "Flags used by the C compiler during Coverage builds." FORCE)
endif()
endif()
if(MSVC)
# Stop all kinds of compatibility warnings
add_definitions(
-DWIN32_LEAN_AND_MEAN
-DVC_EXTRALEAN
-D_SCL_SECURE_NO_WARNINGS
-D_SCL_SECURE_NO_DEPRECATE
-D_CRT_SECURE_NO_WARNINGS
-D_CRT_SECURE_NO_DEPRECATE
-D_CRT_NONSTDC_NO_WARNINGS
-D_CRT_NONSTDC_NO_DEPRECATE
-D_WINSOCK_DEPRECATED_NO_WARNINGS
)
# Enable multi-threaded build and increase the number of addressable sections in an .obj file.
add_compile_options(/MP /bigobj)
endif(MSVC)
if(CYGWIN)
add_definitions(-D__USE_W32_SOCKETS) # boost asio says we need this
endif(CYGWIN)
if(WIN32)
add_definitions(-D_WIN32_WINNT=0x0600) # minimum version required is windows vista (required by gRPC)
add_definitions(-DNOMINMAX) # disables stupidity and enables std::min and std::max
endif(WIN32)
########################################################################
# Setup Boost
########################################################################
message(STATUS "")
message(STATUS "Configuring Boost C++ Libraries...")
# NO optional Boost components!
# ALL required Boost components!
set(UHD_BOOST_REQUIRED_COMPONENTS
filesystem
# Only used by utils and examples, not libuhd:
program_options
# Only used by nirio driver inside libuhd:
serialization
#system Boost.System is used, but explicitly listing it causes errors on some systems.
#unit_test_framework Boost.Test is used, but listing it here causes problems when
# using static linking (the Windows default).
# Package detection for 'Boost::unit_test_framework' is handled
# separately in UHDBoost.cmake to work around this issue.
)
if(MSVC)
# Appending Boost::regex, required on Windows.
# (variablee also used in lib/CMakeLists.txt)
set(UHD_BOOST_REQUIRED_ADDITIONAL_WINDOWS_COMPONENTS regex)
endif(MSVC)
list(APPEND UHD_BOOST_REQUIRED_COMPONENTS ${UHD_BOOST_REQUIRED_ADDITIONAL_WINDOWS_COMPONENTS})
include(UHDBoost)
# Include boost headers as system headers to avoid compiler warnings from them.
include_directories(SYSTEM ${Boost_INCLUDE_DIRS})
########################################################################
# Additional settings for build environment
########################################################################
include(UHDGlobalDefs)
include(UHDLog)
########################################################################
# Check Python Modules
########################################################################
include(UHDPython)
UHD_PYTHON_CHECK_MODULE_VERSION(
"compatible Python version"
"platform"
"platform.python_version()"
${UHD_PYTHON_MIN_VERSION}
HAVE_PYTHON_PLAT_MIN_VERSION
)
UHD_PYTHON_CHECK_MODULE_VERSION(
"Mako templates module"
"mako"
"mako.__version__"
${UHD_PY_MAKO_MIN_VERSION}
HAVE_PYTHON_MODULE_MAKO
)
UHD_PYTHON_CHECK_MODULE_VERSION(
"requests module"
"requests"
"requests.__version__"
${UHD_PY_REQUESTS_MIN_VERSION}
HAVE_PYTHON_MODULE_REQUESTS
)
UHD_PYTHON_CHECK_MODULE_VERSION(
"numpy module"
"numpy"
"numpy.__version__"
${UHD_NUMPY_MIN_VERSION}
HAVE_PYTHON_MODULE_NUMPY
)
UHD_PYTHON_CHECK_MODULE_VERSION(
"ruamel.yaml module"
"ruamel.yaml"
"ruamel.yaml.__version__"
${UHD_RUAMEL_YAML_MIN_VERSION}
HAVE_PYTHON_MODULE_YAML
)
########################################################################
# Option to use QEMU for running unittests
#
# This is useful when cross-compiling UHD for other architectures like arm or
# aarch64
#
# QEMU_EXECUTABLE must be set to the name of the QEMU executable. When using
# openembedded build environment, this should be set to "qemu-${TUNE_ARCH}"
# or "${WORKDIR}/recipe-sysroot-native/usr/bin/qemu-${TUNE_ARCH}"
#
# QEMU_SYSROOT must be set to the same sysroot of the target architecture that
# was used when compiling UHD. When using openembedded build environment, this
# should be set to "${WORKDIR}/recipe-sysroot".
#
# QEMU_PYTHON_EXECUTABLE must be set to the path of the python executable
# compiled for the target architecture. If it is included in the target sysroot,
# this is typically ${QEMU_SYSROOT}${PYTHON_RUNTIME_EXECUTABLE}. The variable
# is automatically set to this path if the executable is available.
########################################################################
option(ENABLE_QEMU_UNITTESTS "Use QEMU for running unittests" OFF)
mark_as_advanced(ENABLE_QEMU_UNITTESTS)
if(ENABLE_QEMU_UNITTESTS)
message(STATUS "")
message(STATUS "Use QEMU for running unittests: ${ENABLE_QEMU_UNITTESTS}")
if("${QEMU_EXECUTABLE}" STREQUAL "")
if(NOT "$ENV{OECORE_NATIVE_SYSROOT}" STREQUAL "" AND
NOT "$ENV{OECORE_TARGET_ARCH}" STREQUAL "" AND
EXISTS "$ENV{OECORE_NATIVE_SYSROOT}/usr/bin/qemu-$ENV{OECORE_TARGET_ARCH}")
set(QEMU_EXECUTABLE "$ENV{OECORE_NATIVE_SYSROOT}/usr/bin/qemu-$ENV{OECORE_TARGET_ARCH}")
else()
message(FATAL_ERROR "The variable QEMU_EXECUTABLE is not set")
endif()
endif()
if("${QEMU_SYSROOT}" STREQUAL "")
if(NOT "$ENV{OECORE_TARGET_SYSROOT}" STREQUAL "" AND
EXISTS "$ENV{OECORE_TARGET_SYSROOT}")
set(QEMU_SYSROOT, "$ENV{OECORE_TARGET_SYSROOT}")
else()
message(FATAL_ERROR "The variable QEMU_SYSROOT is not set")
endif()
endif()
if("${QEMU_PYTHON_EXECUTABLE}" STREQUAL "")
if (EXISTS ${QEMU_SYSROOT}${RUNTIME_PYTHON_EXECUTABLE})
set(QEMU_PYTHON_EXECUTABLE ${QEMU_SYSROOT}${RUNTIME_PYTHON_EXECUTABLE})
else()
message(FATAL_ERROR "The variable QEMU_PYTHON_EXECUTABLE is not set")
endif()
endif()
message(STATUS " QEMU executable: ${QEMU_EXECUTABLE}")
message(STATUS " QEMU Python executable: ${QEMU_PYTHON_EXECUTABLE}")
message(STATUS " QEMU sysroot: ${QEMU_SYSROOT}")
endif(ENABLE_QEMU_UNITTESTS)
########################################################################
# Create Uninstall Target
########################################################################
configure_file(
${UHD_SOURCE_DIR}/cmake/cmake_uninstall.cmake.in
${CMAKE_CURRENT_BINARY_DIR}/cmake_uninstall.cmake
@ONLY)
add_custom_target(uninstall
${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/cmake_uninstall.cmake
)
########################################################################
# Install Package Docs
########################################################################
UHD_INSTALL(FILES
${CMAKE_CURRENT_SOURCE_DIR}/README.md
${CMAKE_CURRENT_SOURCE_DIR}/LICENSE
DESTINATION ${PKG_DOC_DIR}
COMPONENT readme
)
########################################################################
# Register top level components
########################################################################
LIBUHD_REGISTER_COMPONENT("LibUHD" ENABLE_LIBUHD ON "Boost_FOUND;HAVE_PYTHON_MODULE_MAKO" OFF ON)
LIBUHD_REGISTER_COMPONENT("LibUHD - C API" ENABLE_C_API ON "ENABLE_LIBUHD" OFF OFF)
if(WIN32)
LIBUHD_REGISTER_COMPONENT(
"LibUHD - Python API"
ENABLE_PYTHON_API
OFF
"ENABLE_LIBUHD;HAVE_PYTHON_MODULE_NUMPY;HAVE_PYTHON_LIBS;HAVE_PYTHON_PLAT_MIN_VERSION"
OFF
OFF)
else()
LIBUHD_REGISTER_COMPONENT(
"LibUHD - Python API"
ENABLE_PYTHON_API
ON
"ENABLE_LIBUHD;HAVE_PYTHON_MODULE_NUMPY;HAVE_PYTHON_LIBS;HAVE_PYTHON_PLAT_MIN_VERSION"
OFF
OFF)
endif(WIN32)
LIBUHD_REGISTER_COMPONENT("Examples" ENABLE_EXAMPLES ON "ENABLE_LIBUHD" OFF OFF)
LIBUHD_REGISTER_COMPONENT("Utils" ENABLE_UTILS ON "ENABLE_LIBUHD" OFF OFF)
LIBUHD_REGISTER_COMPONENT("Tests" ENABLE_TESTS ON "ENABLE_LIBUHD" OFF OFF)
LIBUHD_REGISTER_COMPONENT(
"Python Module (Utils only)"
ENABLE_PYMOD_UTILS ON
"HAVE_PYTHON_MODULE_NUMPY;HAVE_PYTHON_MODULE_MAKO;HAVE_PYTHON_MODULE_YAML"
OFF OFF)
if(WIN32)
LIBUHD_REGISTER_COMPONENT(
"UHD Extended Packaging for Windows"
ENABLE_EXTEND_WIN_PACKAGING
OFF
"ENABLE_LIBUHD"
OFF
OFF)
else()
unset(ENABLE_EXTEND_WIN_PACKAGING CACHE)
endif(WIN32)
LIBUHD_REGISTER_COMPONENT("RFNoC/FPGA Development Files" ENABLE_RFNOC_DEV OFF "ENABLE_LIBUHD" OFF OFF)
########################################################################
# Add the subdirectories
########################################################################
if(ENABLE_LIBUHD)
add_subdirectory(lib)
endif(ENABLE_LIBUHD)
add_subdirectory(include)
if(ENABLE_EXAMPLES)
add_subdirectory(examples)
endif(ENABLE_EXAMPLES)
if(ENABLE_TESTS)
add_subdirectory(tests)
endif(ENABLE_TESTS)
if(ENABLE_UTILS OR ENABLE_PYMOD_UTILS)
add_subdirectory(utils)
endif(ENABLE_UTILS OR ENABLE_PYMOD_UTILS)
add_subdirectory(docs)
if(ENABLE_PYTHON_API OR ENABLE_PYMOD_UTILS)
add_subdirectory(python)
endif()
########################################################################
# Create Pkg Config File
########################################################################
foreach(inc ${Boost_INCLUDE_DIRS})
list(APPEND UHD_PC_CFLAGS "-I${inc}")
endforeach(inc)
foreach(lib ${Boost_LIBRARY_DIRS})
list(APPEND UHD_PC_LIBS "-L${lib}")
endforeach(lib)
# Use space-separation format for the pc file
string(REPLACE ";" " " UHD_PC_REQUIRES "${UHD_PC_REQUIRES}")
string(REPLACE ";" " " UHD_PC_CFLAGS "${UHD_PC_CFLAGS}")
string(REPLACE ";" " " UHD_PC_LIBS "${UHD_PC_LIBS}")
# Unset these vars to avoid hard-coded paths to cross environment
if(CMAKE_CROSSCOMPILING)
set(UHD_PC_CFLAGS)
set(UHD_PC_LIBS)
endif(CMAKE_CROSSCOMPILING)
# Support absolute paths for LIBDIR and INCLUDEDIR
if(IS_ABSOLUTE "${CMAKE_INSTALL_LIBDIR}")
set(UHD_PC_LIBDIR "${CMAKE_INSTALL_LIBDIR}")
else()
set(UHD_PC_LIBDIR "\${exec_prefix}/${CMAKE_INSTALL_LIBDIR}")
endif()
if(IS_ABSOLUTE "${CMAKE_INSTALL_INCLUDEDIR}")
set(UHD_PC_INCLUDEDIR "${CMAKE_INSTALL_INCLUDEDIR}")
else()
set(UHD_PC_INCLUDEDIR "\${prefix}/${CMAKE_INSTALL_INCLUDEDIR}")
endif()
configure_file(
${CMAKE_CURRENT_SOURCE_DIR}/uhd.pc.in
${CMAKE_CURRENT_BINARY_DIR}/uhd.pc
@ONLY)
UHD_INSTALL(
FILES ${CMAKE_CURRENT_BINARY_DIR}/uhd.pc
DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig
COMPONENT "devel"
)
########################################################################
# Create and Install UHD cmake files
########################################################################
if(NOT CMAKE_MODULES_DIR)
set(CMAKE_MODULES_DIR ${CMAKE_INSTALL_LIBDIR}/cmake)
endif(NOT CMAKE_MODULES_DIR)
# UHDConfig.cmake needs UHD_LINK_LIST_STATIC set:
list(APPEND UHD_LINK_LIST_STATIC "dl")
list(APPEND UHD_LINK_LIST_STATIC "pthread")
foreach(Boost_Comp ${UHD_BOOST_REQUIRED_COMPONENTS})
if(NOT ${Boost_Comp} STREQUAL "unit_test_framework" AND NOT ${Boost_Comp} STREQUAL "system")
list(APPEND UHD_LINK_LIST_STATIC "boost_${Boost_Comp}")
endif()
endforeach(Boost_Comp)
if(ENABLE_USB)
list(APPEND UHD_LINK_LIST_STATIC "usb-1.0")
endif(ENABLE_USB)
configure_file(
${UHD_SOURCE_DIR}/cmake/Modules/UHDConfigVersion.cmake.in
${UHD_BINARY_DIR}/cmake/Modules/UHDConfigVersion.cmake
@ONLY
)
configure_file(
${UHD_SOURCE_DIR}/cmake/Modules/UHDConfig.cmake.in
${UHD_BINARY_DIR}/cmake/Modules/UHDConfig.cmake
@ONLY
)
include(CMakePackageConfigHelpers)
if(TARGET uhd)
export(
EXPORT uhdTargets
FILE ${UHD_BINARY_DIR}/cmake/Modules/UHDTargets.cmake
NAMESPACE UHD::
)
endif()
set(uhd_cmake_scripts
${UHD_BINARY_DIR}/cmake/Modules/UHDConfig.cmake
${UHD_BINARY_DIR}/cmake/Modules/UHDConfigVersion.cmake
${UHD_SOURCE_DIR}/cmake/Modules/UHDBoost.cmake
${UHD_SOURCE_DIR}/cmake/Modules/UHDPython.cmake
${UHD_SOURCE_DIR}/cmake/Modules/UHDMinDepVersions.cmake
${UHD_SOURCE_DIR}/cmake/Modules/UHDUnitTest.cmake
)
UHD_INSTALL(
FILES ${uhd_cmake_scripts}
DESTINATION ${CMAKE_MODULES_DIR}/uhd
COMPONENT "devel"
)
if(TARGET uhd)
install(
EXPORT uhdTargets
FILE UHDTargets.cmake
NAMESPACE UHD::
DESTINATION ${CMAKE_MODULES_DIR}/uhd
COMPONENT "devel"
)
endif()
########################################################################
# Handle pre-built UHD Images for packaging
########################################################################
if(DEFINED UHD_IMAGES_SRC_DIR AND EXISTS "${UHD_IMAGES_SRC_DIR}")
message(STATUS "Reading images from directory `${UHD_IMAGES_SRC_DIR}'")
file(GLOB_RECURSE _image_files RELATIVE "${UHD_SOURCE_DIR}" "${UHD_IMAGES_SRC_DIR}/*")
message(STATUS "These images files will be installed/packaged:")
foreach(_img ${_image_files})
message(STATUS " ${_img}")
endforeach(_img)
UHD_INSTALL(FILES ${_image_files} DESTINATION ${PKG_DATA_DIR}/images COMPONENT images)
endif(DEFINED UHD_IMAGES_SRC_DIR AND EXISTS "${UHD_IMAGES_SRC_DIR}")
########################################################################
# Install RFNoC/HDL sources for installation
########################################################################
if(ENABLE_RFNOC_DEV)
# Note: This only depends on stage_rfnoc_dev_sources.py, because we want to
# avoid staging the sources every time we build UHD. However, that means if
# we modify HDL sources and expect `make install` to install the new sources,
# we need to force this target to be rebuilt by CMake, e.g., by removing the
# timestamp file.
if(CMAKE_VERSION VERSION_LESS "3.17")
set(_rm_dir_cmd "remove_directory")
set(_rm_dir_args "")
else()
set(_rm_dir_cmd "rm")
set(_rm_dir_args "-rf")
endif()
add_custom_command(
OUTPUT ${CMAKE_BINARY_DIR}/fpga/usrp3.stamp
DEPENDS ${UHD_SOURCE_DIR}/cmake/Modules/stage_rfnoc_dev_sources.py
COMMAND ${CMAKE_COMMAND} -E ${_rm_dir_cmd} ${_rm_dir_args} ${CMAKE_BINARY_DIR}/fpga
COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_BINARY_DIR}/fpga
COMMAND
${PYTHON_EXECUTABLE} ${UHD_SOURCE_DIR}/cmake/Modules/stage_rfnoc_dev_sources.py --src ${UHD_SOURCE_DIR}/../fpga/usrp3 --dest ${CMAKE_BINARY_DIR}/fpga/usrp3
COMMAND ${CMAKE_COMMAND} -E touch ${CMAKE_BINARY_DIR}/fpga/usrp3.stamp
COMMENT "Copying RFNoC sources to build directory"
)
add_custom_target(rfnoc_dev_sources ALL DEPENDS ${CMAKE_BINARY_DIR}/fpga/usrp3.stamp)
UHD_INSTALL(
DIRECTORY ${CMAKE_BINARY_DIR}/fpga/usrp3
DESTINATION ${PKG_DATA_DIR}/rfnoc/fpga/
COMPONENT rfnoc
)
endif()
########################################################################
# Handle pre-built UHD functional dependencies specific to Windows for
# packaging
#
# 1. WinUSB driver installer (required for B-Series devices)
########################################################################
if(ENABLE_EXTEND_WIN_PACKAGING)
file(GLOB_RECURSE _usbinstaller_files RELATIVE "${UHD_SOURCE_DIR}" "${UHD_SOURCE_DIR}/cmake/msvc/*")
message(STATUS "Reading Windows USB Installer sources from directory `${UHD_SOURCE_DIR}/cmake/msvc'.")
message(STATUS " These files will be installed/packaged at ${PKG_DATA_DIR}/usbdriver.")
UHD_INSTALL(
DIRECTORY ${UHD_SOURCE_DIR}/cmake/msvc/
DESTINATION ${PKG_DATA_DIR}/usbdriver
COMPONENT winusbsupport
PATTERN ".gitattributes" EXCLUDE
PATTERN "*makecat.cdf" EXCLUDE
)
endif(ENABLE_EXTEND_WIN_PACKAGING)
########################################################################
# Print Summary
########################################################################
if(LIBUHD_PKG)
message(STATUS "")
set(PRINT_APPEND " (Debian libuhd003 package configuration)")
elseif(LIBUHDDEV_PKG)
message(STATUS "")
set(PRINT_APPEND " (Debian libuhd-dev package configuration)")
elseif(UHDHOST_PKG)
message(STATUS "")
set(PRINT_APPEND " (Debian uhd-host package configuration)")
endif(LIBUHD_PKG)
UHD_PRINT_COMPONENT_SUMMARY()
if(UHD_VERSION_DEVEL AND NOT UHD_GIT_BRANCH MATCHES "^UHD-")
message(STATUS "******************************************************")
if(UHD_GIT_BRANCH STREQUAL "master")
message(STATUS "* You are building the UHD development master branch.")
message(STATUS "* For production code, we recommend our stable,")
message(STATUS "* releases or using the release branch (maint).")
else()
message(STATUS "* You are building a development branch of UHD.")
message(STATUS "* These branches are designed to provide early access")
message(STATUS "* to UHD and USRP features, but should be considered")
message(STATUS "* unstable and/or experimental!")
endif(UHD_GIT_BRANCH STREQUAL "master")
message(STATUS "******************************************************")
endif(UHD_VERSION_DEVEL AND NOT UHD_GIT_BRANCH MATCHES "^UHD-")
message(STATUS "Building version: ${UHD_VERSION}${PRINT_APPEND}")
message(STATUS "Using install prefix: ${CMAKE_INSTALL_PREFIX}")