bladeRF/linux/kernel
Robert Ghilduta 8d9ed972ca fix HS buffering
This commit defines nios_gpio(7) as the GPIF buffer size control signal. The FX3
firmware makes the DMA engine operate on GPIF buffers that are twice the size of
the maximum sized URB. Since this is speed dependent, bladeRFs operating in HS
will have their GPIF DMA controllers only read 1024 bytes of data (512*2)
instead of 2048 (1024) as is expected when the device is in SS mode. To fix
this, the driver tells the library when a device is HS, the library then s the
nios_gpio bit that causes the FPGA to limit itself to only reading/writing to
the 32bit GPIF for 256 cycle at a time (instead of 512 cycles at SS).
2013-07-22 03:45:40 -07:00
..
.bladeRF.c.swn linux_kernel: RX and TX fixes 2013-07-22 03:45:28 -07:00
bladeRF.c fix HS buffering 2013-07-22 03:45:40 -07:00
bladeRF.h kernel: Changing USB VID/PID to OpenMoko instead of Cypress. 2013-07-06 14:03:45 -07:00
Makefile FSK bridge example 2013-02-18 20:11:39 -08:00
README.md linux: Fixed some typos an added some URLs. 2013-07-17 00:33:13 -04:00

bladeRF Linux Kernel Driver

The linux kernel driver implements a USB device and has some buffering to be able to place multiple packets in flight at a time achieve the high datarates associated with USB 3.0 Superspeed.

Requirements

Even though we build a module for the kernel, your kernels source code is required to build against. We've tested with kernels as old as 3.5.0, but we mostly use Ubuntu for testing and development.

Building

  1. make
  2. See that bladeRF.ko has been made.
  3. sudo insmod bladeRF.ko

The kernel module should now be installed and ready to be used.

bladeRF udev Rule

Usually the udev rules associated with USB devices use the VID and PID to determine the matching for the rule and change the mode to be accessible to users of that group. In our testing, it's been seen that the particular udev rule changes the mode of /dev/bus/usb/... but not the preferred dev entry we create of /dev/bladerf#. Due to this, we have a relatively broad udev rule:

KERNEL=="bladerf*", MODE="0660", GROUP="plugdev"

Please feel free to suggest a tigher rule that applies the appropriate mode to the /dev/bladerf# entry.