usbd-blaster 0.1.1

USB Blaster for Embedded Devices
Documentation

USB Blaster for Embedded Devices

What is this?

A crate for emulating a USB Blaster device, written in Rust.

For the Arduino MKR Vidor 4000, you can use this to program the onboard FPGA with Quartus.

Usage

Requirements

  • Rust language (rustup, cargo)
  • Embedded compiler toolchain
    • for ARM: arm-none-eabi-gcc (ArchLinux users, get gcc-arm-none-eabi-bin) and rustup target add thumbv6m-none-eabi
  • Board flashing tool

Flashing the USB Blaster

Arduino MKR Vidor 4000

cargo build --release --target thumbv6m-none-eabi --example arduino_mkrvidor4000
arm-none-eabi-objcopy -O binary target/thumbv6m-none-eabi/release/usbblaster-rs target/usbblaster-rs.bin
# Manual step: push reset button twice in quick succession to enter flash mode
bossac -i -d -U true -i -e -w -v target/usbblaster-rs.bin -R

Using the USB Blaster

Intel (Altera) Quartus

# Verify that the blaster exists
jtagconfig
# Flash your FPGA
quartus_pgm -m jtag -o 'p;project-name.sof'

OpenOCD

openocd -f /usr/share/openocd/scripts/interface/altera-usb-blaster.cfg

You can safely ignore the following error:

Error: IR capture error at bit 2, saw 0x3FFFFFFFFFFFFD55 not 0x...3

This seems to happen on other USB blasters too. If you know why this is and can fix it, feel free to open a PR.

How it works

USB

The board is set up as a USB device with the same VendorId and ProductId as an Altera USB Blaster.

The blaster communicates via a vendor-specific interface (Class = 255, SubClass = 255, Protocol = 255). When vendor-typed control requests are received, it emulates the ROM and the responses of the FTDI245 chip.

Just like the FT245, endpoint 1 is input-only and endpoint 2 is output-only. These are used to control blaster operation.

Blaster

The blaster has two operating modes: bit-bang (default) or shift. In bit-bang, there is direct control of the JTAG lines; every received byte translates to instructions on how to drive TDI/TMS/TCK. It also contains flags for whether this instruction is a read or write, and if the blaster should switch to shift mode and shift out the next n bytes. In shift mode, the blaster will shift out the next n (anywhere from 0 to 63) received bytes to the TDI line.

Bit-bang mode is useful for JTAG control, shift mode is useful for a bulk transfer like writing an FPGA bitstream.

To-Do

  • Support optional TRST JTAG pin
    • This is nontrivial, because you need to duplicate a lot of code to add in an extra field with a different trait
  • Make pull requests for changes made
    • LCK_C & LCK_F
    • SRAM QoS for Arduino USB in ArduinoCore-SAMD
    • MKR Vidor 4000 support in atsamd-hal
    • Enable FPGA Clock equivalent
  • Document everything in this repo
  • Additional comments

Special Thanks