bladeRF USB 3.0 Superspeed Software Defined Radio Source Code http://nuand.com
  • C 45.8%
  • VHDL 21%
  • Verilog 15.8%
  • Tcl 3.8%
  • MATLAB 3.2%
  • Other 10.3%
Find a file
Rey Tucker cb5dd4e954 hdl: bladerf-micro: weak pull-up on fx3_uart_rxd (#679)
Add a weak pull-up on fx3_uart_rxd

This is a bus used for both FPGA-to-FX3 UART data and FX3-to-Flash
SPI data, and without something driving it, it tends to float around
0.55 volts (which is very much a low/asserted signal for the UART).

When the FX3 SPI interface has the bus, it puts the FPGA into reset
via fx3_ctl(7), and fx3_uart_rxd goes high-Z accordingly.

I suspect what we're running into is a race condition between the FX3
reconfiguring the pin to UART mode and bringing the FPGA out of reset,
and the FPGA shifting from high-Z to high/idle, given:

- All of the "junk bytes" seen so far have been all ones followed by
  all zeroes, e.g. 0xF0, 0xFC, etc
- Being low for 5 clocks and then going high is indistinguishable from
  a start bit followed by 0xF0 followed by a stop bit.

Thus, by maintaining a constant weak pull-up on this bus, we can
ensure it's a logic high when idle.

There are possible side effects when the bus is in its SPI MOSI role,
but I believe they are minor. The FX3 is not expecting a pull-up/down
on this signal, and this is a critical pin for flash access. But,
C5's R_pu is 25 kohms, which means sinking 1.4 mA to pull it low, and
the FX3's absolute maximum output current is 20 mA, so I think we are
good here.
2018-10-26 16:02:01 -04:00
debian debian: update FPGA 0.7.3 -> 0.8.0 2018-09-12 19:15:14 -04:00
doc doc: version change checklist: debian changelog hint 2018-08-24 16:26:08 -04:00
firmware_common fx3: add BLADE_USB_CMD_QUERY_FPGA_SOURCE command 2018-09-26 14:50:23 -04:00
fpga_common fpga_common: fix overrun in 16x64 NIOS II packet packing 2017-12-21 12:54:57 -05:00
fx3_firmware fx3: update changelog for v2.3.1 2018-09-26 15:17:45 -04:00
hdl hdl: bladerf-micro: weak pull-up on fx3_uart_rxd (#679) 2018-10-26 16:02:01 -04:00
host host: bladeRF-cli: print ranges on sample rate, bandwidth, frequency 2018-10-26 15:56:50 -04:00
legal updated the year 2018-10-22 11:08:03 -04:00
.clang-format clang-format: minor tweak for brackets on lists 2017-12-21 12:55:09 -05:00
.gitignore add more FPGA build artifact dirs to .gitignore 2018-09-06 17:00:38 -04:00
CHANGELOG bladeRF 2018.08 2018-08-30 18:09:11 -04:00
CMakeLists.txt top: CMakeLists: if enabled, always build fx3 2018-09-26 12:50:48 -04:00
CONTRIBUTORS CONTRIBUTORS: self-updating 2017-08-02 18:06:21 -04:00
COPYING legal: add AGPLv3, mention FPGA IP licenses (#38) 2018-05-23 12:15:00 -04:00
README.md Update CMake options in READMEs (#285) 2014-07-27 13:32:49 -04:00

bladeRF Source

This repository contains all the source code required to program and interact with a bladeRF platform, including firmware for the Cypress FX3 USB controller, HDL for the Altera Cyclone IV FPGA, and C code for the host side libraries, drivers, and utilities. The source is organized as follows:

Directory Description
firmware_common Source and header files common between firmware and host software
fx3_firmware Firmware for the Cypress FX3 USB controller
hdl All HDL code associated with the Cyclone IV FPGA
host Host-side libraries, drivers, utilities and samples

Quick Start

  1. Clone this repository via: git clone https://github.com/Nuand/bladeRF.git
  2. Fetch the latest pre-built bladeRF FPGA image. See the README.md in the hdl directory for more information.
  3. Fetch the latest pre-built bladeRF firmware image. See the README.md in the fx3_firmware directory for more information.
  4. Follow the instructions in the host directory to build and install libbladeRF and the bladeRF-cli utility.
  5. Attach the bladeRF board to your fastest USB port.
  6. You should now be able to see your device in the list output via bladeRF-cli -p
  7. You can view additional information about the device via bladeRF-cli -e info -e version.
  8. If any warnings indicate that a firmware update is needed, run:bladeRF-cli -f <firmware_file>.
  • If you ever find the device booting into the FX3 bootloader (e.g., if you unplug the device in the middle of a firmware upgrade), see the recovery command in bladeRF-cli for additional details.
  1. See the overview of the bladeRF-cli for more information about loading the FPGA and using the command line interface tool

For more information, see the bladeRF wiki.

Build Variables

Below are global options to choose which parts of the bladeRF project should be built from the top level. Please see the fx3_firmware and host subdirectories for more specific options.

Option Description
-DENABLE_FX3_BUILD=<ON/OFF> Enables building the FX3 firmware. Default: OFF
-DENABLE_HOST_BUILD=<ON/OFF> Enables building the host library and utilities overall. Default: ON