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.
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.
Once UHD has been installed the UmTRX module must be built and installed.
$ git clone https://github.com/fairwaves/UHD-Fairwaves.git $ 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.