We provide UHD software installers for Windows users who do not wish to install UHD from source.
All Windows installers are built with LibUSBx to enable USB3 support. LibUSBx binaries are not part of the installer and must be installed manually.
Installer packages are built from release tags of the maint branch.
Please find the latest installer here: http://files.ettus.com/binaries/uhd/latest_release
Older installers of all previous releases can be downloaded from: http://files.ettus.com/binaries/uhd/ (browse to the desired release).
Install the MSVC Redistributable Package:
LibUSBx binaries need to be installed on your system if they aren’t already present. You can download the latest version of libUSB from the LibUSB GitHub releases page. Each release includes binaries built for various platforms and compiler versions. It’s crucial that the LibUSB binary corresponds to the platform and compiler version used for the UHD binaries. This detail is indicated in the name of the installer executable; for example, uhd_4.7.0.0-release_Win64_VS2017.exe indicates it was built for the 64-bit Windows platform using the Visual Studio 2017 compiler suite. Copy all files from the path \VS20XX\MSYY\dll within the archive to the bin folder of the UHD installation location (by default "C:\Program Files\UHD\bin"). VS20XX is the Visual Studio version that you find in the name of the UHD installer. YY is the bitness of your Windows version (32 or 64).
To validate that LibUSB has been successfully installed, run uhd_find_devices from the bin folder of your UHD installation.
If the program fails to locate the LibUSB binaries an error message is displayed. This can happen for the following reasons:
You can build UHD software from source. There are two choices of compilers for Windows users:
Refer to Build Instructions (Windows)
Most distributions provide UHD as part of their package management. On Debian and Ubuntu systems, this will install the base UHD library, all headers and build-specific files, as well as utilities:
sudo apt-get install libuhd-dev uhd-host
On Fedora systems, an equivalent command would be:
sudo yum install uhd uhd-devel
Live CD/DVD/USBs are not supported.
On other distributions, please refer to your package manager's documentation.
We provide UHD binary installers for Ubuntu and Fedora users for every stable release. Typically, we will provide binaries for latest two LTS versions of Ubuntu, and for the latest two versions of Fedora. Live CD/DVD/USBs are not supported.
The latest versions of these binaries can be downloaded from here: http://files.ettus.com/binaries/uhd_stable/latest_release/
Copy and paste these commands into your terminal. This will install UHD software as well as allow you to receive package updates.
sudo add-apt-repository ppa:ettusresearch/uhd sudo apt-get update sudo apt-get install libuhd-dev uhd-host
Note: You might want to run the following command if you're updating repositories:
yum clean metadata all
Create the file /etc/yum.repos.d/ettus.repo. Copy this into the file:
[ettus-uhd-stable-repo] name=Ettus Research - UHD Stable $releasever-$basearchthon serial timeout baseurl=http://files.ettus.com/binaries/uhd/repo/uhd/fedora/$releasever/$basearch gpgcheck=0
Run the following commands:
sudo yum --enablerepo='ettus-uhd-stable-repo' install uhd
This is an automated way of installing UHD from source. See also Using PyBOMBS.
We recommend using MacPorts and actively support UHD development on OS X via this method. Using MacPorts, the correct hardware device images are automatically installed for you, and there are no post install tasks. With a single command, you can be up and running in short order.
If you do not already have MacPorts installed, you will need to install it first. Make sure to follow the MacPorts shell environment changes needed such that MacPorts installed executables are found before all others. These are the only changes to the shell environment needed to execute any MacPorts-installed executable. Setting any DYLD environment variable (e.g., DYLD_LIBRARY_PATH) for general use is highly discouraged, because doing so, in our experience, leads to problems down the road that are very difficult to diagnose. OSX provides robust means for correcting DYLD-based issues even after dependencies are installed.
Once MacPorts is installed, UHD and all of its dependencies can be installed by executing
sudo port install uhd
The latest developments in UHD can be installed via
sudo port install uhd-devel
Please note that the uhd-devel port, while tested for basic compilation and functionality, is not a formal release and hence should be considered beta software which might contain bugs or major issues.