ECPBRAM(1)

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

✨ NAME ✨

okay so ecpbram — that's her name, she's in section 1 of the manual (the General Commands girly), and her whole vibe is Project Trellis. that's it bestie, that's the name section, short and slay 💅

💖 DESCRIPTION 💖

so Project Trellis is the Open Source Tools for ECP5 FPGAs situation — that's literally the tagline, no cap, that's what it is.

and then there's this one binary living at debian/tmp/usr/bin/ecpbram, and its entire job is being the ECP5 BRAM content initialization tool. that's it. that's the job. it initializes BRAM content and it does it gorgeously. main character energy fr fr 🎀

  • Copyright © 2019 Sylvain Munaut <tnt@246tNt.com>
  • Copyright © 2016 Claire Xenia Wolf <claire@yosyshq.com>

giving them their flowers because they ate, periodt 💐👑

✨ Allowed options ✨

here's the whole menu bestie — we are NOT skimming, we are reading every single one because you deserve the full picture 🫶

💅 Generic options:

  • -h [ --help ] — shows you the help. the classic. the comfort flag. ask her for help and she will provide 🙈
  • -v [ --verbose ] — verbose output. she will say MORE. she will tell you everything she's doing and honestly? we love an over-sharer 🌸

🔥 Initialize options:

  • -i [ --input ] arg — the input configuration file. the config coming IN, the source of truth you're reading from 💜
  • -o [ --output ] arg — the output configuration file. the config going OUT, where you want the result to land ✨
  • -f [ --from ] arg — original content hex file. this is the BEFORE picture, the starting hex 🍓
  • -t [ --to ] arg — new content hex file. this is the AFTER picture, the glow-up hex 💖

🌈 Generate options:

  • -g [ --generate ] arg — generates random hex of the given geometry into the given file. just. random hex. for free. iconic behaviour honestly 🌟
  • -s [ --seed ] arg — seeds the random generator with a fixed value, so your randomness is reproducible and not just chaos 🎀
  • -w [ --width ] arg — the width of the BRAM content — and it's measured in bits, bestie, keep up 🦋
  • -d [ --depth ] arg — the idepth of the BRAM content — and that's in # of words. and yes, idepth. that's literally what it says, we don't make the rules, we just report them 💀🙈
lowkey reminder: those last two, -w and -d, are straight from the page character for character — so don't go "fixing" the spelling, she said what she said 🫶

and THAT'S the page, bestie, you're fully caught up and honestly you ate 💅✨

signing off with the receipts: this manual is ecpbram 1.4-3, dated March 2026. go init some BRAM, ily, mwah 💋🎀💖

📦 where this page comes from