XBFLASH.QSPI(1)

📦 version 2.25.0, in ubuntu resolute, ubuntu stonking

okay bestie, pull up a chair 🎀 this is xbflash.qspi, and she lives in the User Commands part of the manual (section 1, the "just run me in your terminal" zone). Her whole thing, and I mean her whole thing, is programming, erasing, and reading QSPI flash on accelerator cards. No cap. Let's go ✨

🌸 NAME 🌸

xbflash.qspi — program, erase, and read QSPI flash on accelerator cards 💅

That's the name. That's the vibe. Iconic, brief, slays.

✨ DESCRIPTION ✨

The usage line, fr fr, this is literally all it says:

Usage: xbflash.qspi [options]

Short queen 👑 she lets the options do the talking.

💖 OPTIONS 💖

Okay so here's the thing — this manpage groups everything by mode, and each mode has a flag that has to be the very first option or it's not gonna work. Read those notes, bestie, I'm begging 🙈

🍓 "SPI flash" 🍓

  • --primary <MCS-path> — must be 1st option 🔥 like literally first, do not make her wait her turn
  • --secondary <MCS-path> — optional, default is empty 🫶
  • --card <BDF> — required, no brackets, she's mandatory
  • --force — optional, yes for prompt 💅
  • --bar <BAR-index-for-QSPI> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPI> — optional, default is 0x40000

🦋 "SPI factory-reset" 🦋

  • --factory-reset — must be 1st option 🔥
  • --dual-flash — optional flag, no value, just vibes
  • --card <BDF> — required
  • --force — optional, yes for prompt 💅
  • --bar <BAR-index-for-QSPI> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPI> — optional, default is 0x40000

🌈 "QSPIPS erase" 🌈

  • --qspips-erase — must be 1st option 🔥
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --length <length-to-read> — optional, default is 96MB
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000
  • --force — optional, yes for prompt 💅

⭐ "QSPIPS flash" ⭐

  • --qspips-flash — must be 1st option 🔥
  • --input <path-to-qspips-BOOT-BIN-file> — required, she needs her file
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000
  • --force — optional, yes for prompt 💅

💜 "QSPIPS read back" 💜

  • --qspips-read — must be 1st option 🔥
  • --output <output-file-to-save-read-contents> — required, where the tea gets saved
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --length <length-to-read> — optional, default is 128MB
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000

okay bestie so here's the part where I have to be real with you: the page literally prints this whole thing twice 😭 and I am NOT about to gatekeep half of it from you, so round two, exactly as she wrote it:

xbflash.qspi [options]

🍓 "SPI flash" 🍓

  • --primary <MCS-path> — must be 1st option 🔥
  • --secondary <MCS-path> — optional, default is empty 🫶
  • --card <BDF> — required
  • --force — optional, yes for prompt 💅
  • --bar <BAR-index-for-QSPI> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPI> — optional, default is 0x40000

🦋 "SPI factory-reset" 🦋

  • --factory-reset — must be 1st option 🔥
  • --dual-flash — optional flag, no value
  • --card <BDF> — required
  • --force — optional, yes for prompt 💅
  • --bar <BAR-index-for-QSPI> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPI> — optional, default is 0x40000

🌈 "QSPIPS erase" 🌈

  • --qspips-erase — must be 1st option 🔥
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --length <length-to-read> — optional, default is 96MB
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000
  • --force — optional, yes for prompt 💅

⭐ "QSPIPS flash" ⭐

  • --qspips-flash — must be 1st option 🔥
  • --input <path-to-qspips-BOOT-BIN-file> — required
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000
  • --force — optional, yes for prompt 💅

💜 "QSPIPS read back" 💜

  • --qspips-read — must be 1st option 🔥
  • --output <output-file-to-save-read-contents> — required
  • --card <BDF> — required
  • --offset <offset-on-flash-to-start-with> — optional, default is 0
  • --length <length-to-read> — optional, default is 128MB
  • --flash-type <qspips-flash-type> — optional, default is qspi_ps_x2_single
  • --bar <BAR-index-for-QSPIPS> — optional, default is 0
  • --bar-offset <BAR-offset-for-QSPIPS> — optional, default is 0x40000

🔥 SEE ALSO 🔥

The full documentation for xbflash.qspi is maintained as a Texinfo manual 📚 so if you want the complete complete version, that's where she's at. If the info and xbflash.qspi programs are properly installed at your site, this command:

info xbflash.qspi

should give you access to the complete manual ✨ go read her, she's worth it.

and that's the whole page, bestie 🫶 it's dated October 2025 and the footer tags the source as xbflash.qspi Usage:. love that for her. go flash something responsibly 💖🎀🦋

📦 where this page comes from