XTRX FPGA images & pre-compiled binaries
This repository hosts FPGA images and pre-compiled binaries for XTRX. Only rev4 hardware and Ubuntu 16.04 x86_64 binaries are published at this moment, that works well on Ubuntu 18.04 x86_64 as well.
NOTE: rev3 hardware support is phasing out, please contact email@example.com in order to get support.
Please report any problems running pre-compiled libraries from this repository directly this repo's issues.
binaries- pre-compiled host binary packages.
sources- reference source code used for building the binaries. Uses git submodules to reference to the relevant git repositories. See Manual Compilation for more details.
firmware- FPGA images for reflashing. (not yet published)
Manual compilation of host libraries from the
You need C and C++ compiler to build host libraries.
libusb1 is also required if you're using a USB3 adapter. For Debian-based systems:
% sudo apt-get install build-essential libusb-1.0-0-dev cmake dkms python-cheetah python
For Ubuntu 18.04 system you need to install Python 2.7 since python-cheetah is only available for 2.7
First, you need to clone relevant revisions of source modules:
% git submodule init % git submodule update
Now enter the
sources directory and run:
% cd sources % mkdir -p build % cd build % cmake .. OR if you don't want SoapySDR support: % cmake -DENABLE_SOAPY=NO .. % make
When everything is built you can install them:
% sudo make install % sudo ldconfig
PCIe kernel driver compilation
If you're connecting XTRX over a (mini)PCIe bus, you also need to install a kernel driver.
The easiest way is to use DKMS.
First, make sure DKMS can find the driver sources.
make install above will install the driver sources into
/usr/local/src while DKMS expect them in
/usr/src, so you should create a symlink:
% sudo ln -s /usr/local/src/xtrx-0.0.1-2/ /usr/src/
And now instruct DKMS to build the module:
% sudo /usr/sbin/dkms add -m xtrx -v "0.0.1-2" % sudo /usr/sbin/dkms build -m xtrx -v "0.0.1-2" % sudo /usr/sbin/dkms install -m xtrx -v "0.0.1-2"
If everything goes well, you can now load the driver:
and it should appear in
/proc/modules with relevant messages in
In case you face any issues with DKMS, please report the issue. Meantime, you should be able to build the driver manually. Enter the
sources/xtrx_linux_pcie_drv directory and run:
% make % sudo insmod xtrx.ko
Non root access for /dev/xtrx0
If you want to access XTRX from non-root user (which is the typical case) you need to install
cp sources/xtrx_linux_pcie_drv/50-xtrx.rules /etc/udev/rules.d/
After that you need to restart
udevd and remove and insert the XTRX driver (
rmmod xtrx; modprobe xtrx) or reboot the system. On ubuntu-like systems you can restart
udevadm control --reload-rules && udevadm trigger
Working with XTRX over PCIe bus
PCIe device ID is
% lspci -v -d 10ee: 01:00.0 Memory controller: Xilinx Corporation Device 7012 Subsystem: Xilinx Corporation Device 0007 Flags: fast devsel, IRQ 255 Memory at 91510000 (32-bit, non-prefetchable) [disabled] [size=4K] Memory at 91500000 (32-bit, non-prefetchable) [disabled] [size=64K] Capabilities:  Power Management version 3 Capabilities:  MSI: Enable- Count=1/4 Maskable- 64bit+ Capabilities:  Express Endpoint, MSI 03 Capabilities:  Device Serial Number 00-00-00-00-12-34-56-78
xtrx is loaded correctly, a character device
/dev/xtrx0 should appear.
Working with the USB3 adapter
USB3 adapter should appear on your system as USB device
0525:3380. Check it by running
% lsusb Bus 002 Device 002: ID 0525:3380 Netchip Technology, Inc.
Testing if XTRX is alive
Run this command to check that your XTRX is connected properly and is not dead:
% test_xtrx -t -l2
Output should be like this
CPU Features: SSE2+ SSE4.1+ AVX+ FMA+ Master: 31999999.863761; RX rate: 3999999.982970; TX rate: 0.000000 RX tunned: 899999999.046326 RX bandwidth: 2500000.000000 RX LNA gain: 15.000000 RX SAMPLES=524288 SLICE=524288 PARTS=1 PROCESSED RX SLICE 0 /0: res 0 TS: 0 65746 us DELTA 118 us LATE 328 us 524288 samples R= ffdff6ffeffd DELTA=-1553528470 XXXXX Overruns:0 Zeros:0 xAND=[0xffc0,0xffc0,0xff40,0xffc0] xOR=[0xffff,0xffff,0xff7f,0xffdf] Success! Processed RX 2 x 3.984 = 7.969 MSPS (WIRE: 31.874542) TX 2 x 0.000 = 0.000 MSPS (WIRE: 0.000000 MB/s)
If you see output similar to the one above, XTRX is ready to rock! And you can now build your very own application or install one already coming with the XTRX support:
- GNU Radio: https://github.com/xtrx-sdr/gr-osmosdr
- sdrangel: https://github.com/xtrx-sdr/sdrangel
- gqrx (no special branch, but install XTRX branch of gr-osmosdr first): http://gqrx.dk/
- kalibrate: https://github.com/xtrx-sdr/kalibrate-rtl
- osmo-trx: https://github.com/xtrx-sdr/osmo-trx
I don't see XTRX in
- XTRX is installed into miniPCIe slot. Make sure that your system actually has PCIe lanes routed. Some system routes only USB lines, in the case XTRX LED near edge will be blinking ON-OFF-ON-OFF-.. pattern with ~3sec period. If this this the case install XTRX in other slots.
XTRX is installed into PCIe slot via miniPCIe to PCIe adapter which is not our PCIeX2_FE card. This this rare but we found that some adapters are incompatible in some way (we're investigating the issuie) that prevents system to boot, try another adapter.
- XTRX is blinking with ON-OFF-OFF-OFF-ON-OFF-OFF-OFF pattern. It means XTRX hasn't been enumerated on PCIe bus. Try to use other PCIe or miniPCIe slot if available. Please contact firstname.lastname@example.org with details of you installation and system details for future assistance.
- In all other cases fell free to contact us email@example.com
XTRX installed into miniPCIe slot prevents the system from booting (don't get even to BIOS)
This problem can happen if your motherboard provide SMB signals to miniPCIe connector. Most system doesn't. The XTRX rev.4 use reseved pins that are held in hi-Z. However, during the startup DC/DC chip isn't initialized and XTRX actually pulling down the SMB DATA line that mostly connected to critical to boot chips. We're working on firmware fix but currently hardware modification (cutting the fuse on the bottom side of xtrx near the edge) is the only solution. Cut the fuse with a sharp knife. Make sure not to use much pressure since you can accidently cut other traces.
Systems that known to have such problem
|Intel||DQ77KB||SMBus even mentioned in the block diagrm doc|
|Lex||2I610HW||Both miniPCIe have SMBus routed|
I connected XTRX directly via microUSB cable and I don't see it
Unfortunatly USB2 PHY software isn't ready and wasn't pushed in the master. You can check this https://github.com/xtrx-sdr/images/issues/9 for more deatils and suggestions.
Is Windows driver support planned?
We plan to add Windows PCIe drivers but we don't have specific schedule for this right now. If it's blocking factor please contact us firstname.lastname@example.org. However, all other software layers are windows compatible and USB3380 adapter should work via WinUSB.