uhd/host/cmake/debian
Virendra Kakade eb785ff23b ci: Build UHD DEBs with B310 support
Add nib310rio-dev to the Debian build dependencies so the UHD package
build fails if the B310 userspace header is unavailable instead of
silently disabling B300 support.

The Ubuntu installer pipeline downloads the nib310rio Debian package
artifact and exposes it to pbuilder as a local apt repository. This lets
pbuilder satisfy the new dependency inside the clean build root where
CMake checks for nib310rio/nib310rio.h.
2026-09-15 23:44:29 +01:00
..
patches host: debian: Adapt patch to comment format changes 2026-05-08 08:08:28 +02:00
source Added scripts and Debian configuration files for Ubuntu PPA 2015-12-30 11:22:49 -08:00
changelog CHANGELOG: Correct and update UHD 4.11 features 2026-09-08 09:28:31 +01:00
control ci: Build UHD DEBs with B310 support 2026-09-15 23:44:29 +01:00
control.jammy ci: Build UHD DEBs with B310 support 2026-09-15 23:44:29 +01:00
control.noble ci: Build UHD DEBs with B310 support 2026-09-15 23:44:29 +01:00
copyright debian: Add licenses for b310 sources 2026-08-12 18:25:49 +02:00
libuhd4.11.0.install Prepare for 4.11.0.0 RC1 2026-08-12 18:25:49 +02:00
libuhd-dev.install debian: align install files to Debian/Ubuntu official 2025-08-29 15:14:04 +02:00
NetworkManager-USRP Added scripts and Debian configuration files for Ubuntu PPA 2015-12-30 11:22:49 -08:00
not-installed debian: align install files to Debian/Ubuntu official (2) 2025-09-01 15:24:04 +02:00
python3-uhd.install debian: Integrate python3-uhd package changes from community source 2026-03-24 11:37:20 +01:00
README.Debian debian: Enable building of uhd-rfnoc-dev 2025-08-22 15:56:03 +02:00
rules Prepare for 4.11.0.0 RC1 2026-08-12 18:25:49 +02:00
uhd_doc.docs debian: Integrate uhd-doc and uhd-host package changes from community source 2026-03-24 11:37:20 +01:00
uhd-doc.doc-base debian: Update control and package building 2022-04-06 14:30:49 -07:00
uhd-host.dirs debian: Integrate uhd-doc and uhd-host package changes from community source 2026-03-24 11:37:20 +01:00
uhd-host.install debian: align install files to Debian/Ubuntu official (2) 2025-09-01 15:24:04 +02:00
uhd-host.limits Added scripts and Debian configuration files for Ubuntu PPA 2015-12-30 11:22:49 -08:00
uhd-host.postinst debian: Updated postinst such that sysctl failures are non-fatal to installation 2016-05-11 16:54:37 -07:00
uhd-host.sysctl Added scripts and Debian configuration files for Ubuntu PPA 2015-12-30 11:22:49 -08:00
uhd-rfnoc-dev.install debian: align install files to Debian/Ubuntu official 2025-08-29 15:14:04 +02:00
watch debian: Update control and package building 2022-04-06 14:30:49 -07:00

UHD, the "Universal Software Radio Peripheral" hardware driver on Debian:
=========================================================================

usrp group
----------

The Debian uhd-host package installs a usrp group.
This provides two main benefits:
 - Access control:
    The udev rules limit access to members of the group
    (at least for USB attached USRPs).
 - Real Time Priority privilege:
    The pam limits setting allows UHD to boost the
    thread scheduling priority for usrp group members.

To avail yourself of these benefits, add your username
to the usrp group, perhaps by running, as root something like:

    adduser myusername usrp

substituting your user name for myusername.
Settings will not take effect until the user has logged in and out.


Multiple packages
-----------------

libuhd4.x.x:
 Small package just for the library itself.

libuhd-dev:
 Small package just for developing applications
 using the library itself.

uhd-host:
 The uhd-host package contains utilities such as the uhd_find_devices and
 uhd_usrp_probe commands for locating and examining USRP devices,  as well
 as other utilities.

 Also, under /usr/lib/uhd/ are examples, tests and utils
 directories. The utils include tools for managing the
 flash memory or EEPROM configuration of various USRPs.

python3-uhd:
 The python3-uhd package to access the library from Python 3.
 Python examples are included in the uhd-host package.

uhd-rfnoc-dev:
 HDL source files required for building FPGA bitfiles and developing out-of-tree
 RFNoC blocks.


UHD Firmware / FPGA images
--------------------------

 The uhd-images package is not part of the main Debian distribution
 because the FPGA firmware requires non-free vendor tools to compile
 from source.

 For USRP devices with non-volatile configuration having the firmware
 images on the host is optional. But some USRPs are volatile, and
 the UHD library will fetch files from the /usr/share/uhd/images/
 directory at runtime.

 The uhd_images_downloader is a python script to download from
 Ettus.com and install the files.

More Information
----------------

Additional HTML documentation is installed. See
file:///usr/share/doc/uhd-host/doxygen/html/index.html

 -- A. Maitland Bottoms <bottoms@debian.org>, Thu,  9 Oct 2014 23:14:19 -0400