---
name: "openFPGALoader"
section: "1"
platform: "linux"
package: "openfpgaloader"
version: "0.13.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/openFPGALoader"
---

# openFPGALoader(1)

manual page for openFPGALoader v0.13.1

## NAME

openFPGALoader - manual page for openFPGALoader v0.13.1

## SYNOPSIS

**openFPGALoader** \[*OPTION*...\] *BIT\_FILE*

## DESCRIPTION

openFPGALoader **--** a program to flash FPGA

- **--altsetting** arg

  DFU interface altsetting (only for DFU mode)

- **--bitstream** arg

  bitstream

- **--secondary-bitstream** arg

  secondary bitstream (some Xilinx UltraScale boards)

- **-b**, **--board** arg

  board name, may be used instead of cable

- **-B**, **--bridge** arg

  disable spiOverJtag model detection by providing bitstream(intel/xilinx)

- **-c**, **--cable** arg

  jtag interface

- **--status-pin** arg

  JTAG mode / FTDI: GPIO pin number to use as a status indicator (active low)

- **--invert-read-edge**

  JTAG mode / FTDI: read on negative edge instead of positive

- **--vid** arg

  probe Vendor ID

- **--pid** arg

  probe Product ID

- **--cable-index** arg

  probe index (FTDI and cmsisDAP)

- **--busdev-num** arg

  select a probe by it bus and device number (bus\_num:device\_addr)

- **--ftdi-serial** arg

  FTDI chip serial number

- **--ftdi-channel** arg

  FTDI chip channel number (channels 0-3 map to A-D)

- **-d**, **--device** arg

  device to use (*/dev/ttyUSBx*)

- **--detect**

  detect FPGA, add **-f** to show connected flash

- **--dfu**

  DFU mode

- **--dump-flash**

  Dump flash mode

- **--bulk-erase**

  Bulk erase flash

- **--enable-quad**

  Enable quad mode for SPI Flash

- **--disable-quad**

  Disable quad mode for SPI Flash

- **--target-flash** arg

  for boards with multiple flash chips (some Xilinx UltraScale boards), select the target flash: primary (default), secondary or both

- **--external-flash**

  select ext flash for device with internal and external storage

- **--file-size** arg

  provides size in Byte to dump, must be used with dump-flash

- **--file-type** arg

  provides file type instead of let's deduced by using extension

- **--flash-sector** arg

  flash sector (Lattice parts only)

- **--fpga-part** arg

  fpga model flavor + package

- **--freq** arg

  jtag frequency (Hz)

- **-f**, **--write-flash**

  write bitstream in flash (default: false)

- **--index-chain** arg

  device index in JTAG-chain

- **--misc-device** arg

  add JTAG non-FPGA devices \<idcode,irlen,name\>

- **--ip** arg

  IP address (XVC and remote bitbang client)

- **--list-boards**

  list all supported boards

- **--list-cables**

  list all supported cables

- **--list-fpga**

  list all supported FPGA

- **-m**, **--write-sram**

  write bitstream in SRAM (default: true)

- **-o**, **--offset** arg

  Start address (in bytes) for read/write into non volatile memory (default: 0)

- **--pins** arg

  pin config TDI:TDO:TCK:TMS

- **--probe-firmware** arg

  firmware for JTAG probe (usbBlasterII)

- **--protect-flash** arg

  protect SPI flash area

- **--quiet**

  Produce quiet output (no progress bar)

- **-r**, **--reset**

  reset FPGA after operations

- **--scan-usb**

  scan USB to display connected probes

- **--skip-load-bridge**

  skip writing bridge to SRAM when in write-flash mode

- **--skip-reset**

  skip resetting the device when in write-flash mode

- **--spi**

  SPI mode (only for FTDI in serial mode)

- **--unprotect-flash**

  Unprotect flash blocks

- **-v**, **--verbose**

  Produce verbose output

- **--verbose-level** arg

  verbose level **-1**: quiet, 0: normal, 1:verbose, 2:debug

- **-h**, **--help**

  Give this help list

- **--verify**

  Verify write operation (SPI Flash only)

- **--xvc**

  Xilinx Virtual Cable Functions

- **--port** arg

  Xilinx Virtual Cable and remote bitbang Port (default 3721)

- **--mcufw** arg

  Microcontroller firmware

- **--conmcu**

  Connect JTAG to MCU

- **-D**, **--read-dna**

  Read DNA (Xilinx FPGA only)

- **-X**, **--read-xadc**

  Read XADC (Xilinx FPGA only)

- **--read-register** arg

  Read Status Register(Xilinx FPGA only)

- **--user-flash** arg

  User flash file (Gowin LittleBee FPGA only)

- **-V**, **--Version**

  Print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

## REPORTING BUGS

Report bugs to \<gwenhael.goavec-merou@trabucayre.com\>.

## SEE ALSO

The full documentation for **openFPGALoader** is maintained as a Texinfo manual.  If the **info** and **openFPGALoader** programs are properly installed at your site, the command

-

  **info openFPGALoader**

should give you access to the complete manual.