Installing UHD and the UmTRX module


A host driver is provided by UHD plus a loadable module that adds UmTRX support.

If you already have a reasonably recent UHD install that was built with module support, you may only need to build and install the UmTRX module. However, at the time of writing the binary downloads from Ettus were built without this option enabled. See below for details.

We provide instructions for Linux users only, but the driver should work under Windows and MacOS X as well.

Important notes on upgrading form UHD 003.004

If you are presently using an UmTRX-specific version of UHD 003.004 and would like to be up and running with the new driver (UHD 003.008 and later), you must first upgrade the firmware on your UmTRX. For further details please see the UHD Upgrade page.

Warning: incorrect upgrade order may brick your UmTRX!


UmTRX driver is a loadable module for the UHD library, so the main UHD library is required for the UmTRX driver to operate. Loading UmTRX driver allows any of the myriad of UHD applications to work with UmTRX just like with any other UHD compatible device. Below we describe how to install the UHD library and UmTRX module for it.


The UHD version supported by the current UmTRX driver is 003.008.

Binary builds

Warning: The binary downloads from Ettus have module support disabled and doesn’t work with UmTRX.

If you’re an Ubuntu user, you can download UHD library built with loadable modules support from Josh Blum’s PPA:

$ sudo apt-get install python-software-properties
$ sudo add-apt-repository ppa:guruofquality/pothos

Building form source

Simply follow the standard procedure described in the UHD build guide.

UmTRX module

Once UHD has been installed the UmTRX module must be built and installed.

$ git clone
$ cd UHD-Fairwaves/host
$ mkdir build
$ cd build
$ cmake ../
$ make

On Ubuntu, Debian, RedHat and other Linux flavors supported by cpack, install the driver with a package. E.g. for Ubuntu/Debian:

$ cpack
$ dpkg -i umtrx_*.deb

If your Linux distribution is not supported by cpack, you can resort to the old school way:

$ sudo make install

If build fails with a boost-related error, a more recent version of Boost  may need to be installed.

That’s it!