ECPUNPACK(1)

📦
version 1.4 · 7 versions
, in ubuntu resolute, ubuntu stonking

💖 ECPUNPACK 💖

okay bestie so this is ecpunpack, and it lives in the General Commands section of your manual, and it's part of Project Trellis. that's the whole NAME section, no cap. 🌸

✨ SYNOPSIS ✨

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

like. that's it. that's the shape of it. input.bit goes in, stuff comes out, and everything in square brackets is optional because she's ✨flexible✨. 🎀

🦋 DESCRIPTION 🦋

so real talk, here's what the page tells us:

Error: input file is mandatory.

bestie. the input file is MANDATORY. you cannot skip it. you cannot forget it. if you forget it, you get that error and honestly? you deserve it a little. 😭

and here's the full intro line, verbatim, because it's giving context and we love context:

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

debian/tmp/usr/bin/ecpunpack: ECP5 bitstream to text config converter

so basically: ECP5 bitstream in, text config out. that's the whole vibe. it converts. it's a converter. iconic behavior honestly. 💅

Copyright © 2018 gatecat <gatecat@ds0.me>

shoutout gatecat, the literal main character of this file. 🫶

🌈 Allowed options: 🌈

okay here's the good part. every single flag, zero skipped, we don't do that here:

  • -h, --help — shows you the help. baby's first move when you're lost. use it. 🍼
  • -v, --verbose — verbose output, aka she TALKS. more words, more info, more everything. 💬
  • --db arg — the Trellis database folder location. tell her where the database lives. she needs it. 🗂️
  • --idcode arg — the IDCODE to override in the bitstream. yes, override. you're the boss here. 👑
  • --input arg — the input bitstream file. remember how we said mandatory? this is that. ⭐
  • --textcfg arg — the output textual configuration. this is the thing you're making. the whole point. the moment. 💖
ngl bestie, --input and the positional input.bit are both doing the "where's the input" job, so read carefully and don't get it twisted. 🙈

🧚 SEE ALSO 🧚

nothing here, bestie — the original page doesn't list any SEE ALSO references, and i am not about to invent friends for her. imaginary friends are not a vibe when it comes to manpages. 💀

ecpunpack 1.4-3 • March 2026

that's the version and the date, mwah, signing off, love you, go convert something. 💜✨🦋

📦 where this page comes from