OPENFPGALOADER(1)

📦
version 0.13.1 · 2 versions
, in debian trixie, ubuntu resolute

💖 NAME 💖

bestie, welcome to OPENFPGALOADER(1) — this is the manual page for openFPGALoader v0.13.1, and she is iconic. 🌈

🎀 SYNOPSIS 🎀

openFPGALoader [OPTION...] BIT_FILE

🦋 DESCRIPTION 🦋

openFPGALoader -- a program to flash FPGA. that's it, that's the whole vibe, and she does it beautifully. ✨

🌸 OPTIONS 🌸

okay so here's the full list, no skipping, no "you'll figure it out" energy. every single one, fr fr:

  • --altsetting arg — DFU interface altsetting (only for DFU mode, so don't come for her otherwise) 💅
  • --bitstream arg — bitstream
  • --secondary-bitstream arg — secondary bitstream (some Xilinx UltraScale boards)
  • -b, --board arg — board name — may be used instead of cable, iykyk
  • -B, --bridge arg — disables 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 the negative edge instead of the positive one 🌀
  • --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
k so important lil note: Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. periodt. 💅

💀 REPORTING BUGS 💀

found something cursed? Report bugs to gwenhael.goavec-merou@trabucayre.com. she wants to know, bestie, don't gatekeep. 🫶

🔥 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. go read it, she ate. 👑

and that's the whole page!! 🌈✨ this was openFPGALoader v0.13.1, manual page OPENFPGALOADER(1), dated March 2025 — mwah, love u, go flash something 💖🦋🌸

📦 where this page comes from