ECPPACK(1)

💖 ECPPACK 💖

okay so bestie, this is the manual for ecppack — it lives in the General Commands section of the manual, and it's your girl for packing up an ECP5 bitstream. Project Trellis energy, open source, iconic, no notes 💅

---

✨ NAME ✨

ecppack — Project Trellis 🦋

---

🌸 SYNOPSIS 🌸

ecppack input.config [output.bit] [options]

---

🎀 DESCRIPTION 🎀

Error: input file is mandatory. 😭 like literally, you have to give it an input file, that's not optional, that's the whole point bestie.

Project Trellis - Open Source Tools for ECP5 FPGAs Version 1.4-3

debian/tmp/usr/bin/ecppack: ECP5 bitstream packer ✨

---

👑 COPYRIGHT 👑

Copyright © 2018 gatecat <gatecat@ds0.me> 💜

---

🌈 Allowed options:

here's the whole menu, every single one, no skipping, we're eating good tonight 🔥

• -h, --help — show help 🙈 like pls just tell me what to type
• -v, --verbose — verbose output, aka give me ALL the tea ☕
• --db arg — Trellis database folder location 📁 where the lore lives
• --usercode arg — USERCODE to set in bitstream 🏷️
• --idcode arg — IDCODE to override in bitstream 🆔
• --freq arg — config frequency in MHz ⏱️
• --svf arg — output SVF file 📤
• --svf-rowsize arg — SVF row size in bits (default 8000) 📏 yes the default is literally 8000, remember it
• --compress — compress bitstream to reduce size 🤏 smaller is cuter honestly
• --spimode arg — SPI Mode to use (fast-read, dual-spi, qspi) 🧚 your three flavours, pick one
• --background — enable background reconfiguration in bitstream 🌙 main character energy, doing stuff in the background
• --delta arg — create a delta partial bitstream given a reference config 🔀
• --bootaddr arg — set next BOOTADDR in bitstream and enable multi-boot 🥾
• --input arg — input textual configuration 📥
• --bit arg — output bitstream file 📦
• --version — show current version and exit 👋 and then she's gone, bye

---

and that's the whole page, bestie 🫶 this is ecppack version 1.4-3, dated March 2026, and yes she ate 💅 periodt ✨🌸