ARACHNE-PNR(1)

✨ ARACHNE-PNR ✨

okay bestie, welcome to arachne-pnr 💖 this is the manual page for the place and route tool for iCE40 family FPGAs — literally the glow-up stage of your hardware compilation pipeline 🦋

---

🌸 SYNOPSIS 🌸

arachne-pnr [options] <filename>

---

💅 DESCRIPTION 💅

So here's the tea 🫖: arachne-pnr does the place and route step of the hardware compilation process for FPGAs. It takes a technology-mapped netlist in BLIF format as input — like the kind that comes out of the Yosys synthesis suite, for example. Iconic collab fr fr 🤝

Right now it targets the Lattice Semiconductor iCE40 family of FPGAs, and its output is a textual bitstream representation that's meant to be assembled by the IceStorm icepack command. The output of icepack is a binary bitstream, and that bad boy can be uploaded straight to a hardware device. main character pipeline energy, no cap 👑

---

✨ OPTIONS ✨

• -h, --help — prints this usage message. Your little "what do I do" moment 🥺
• -q, --quiet — run quiet. Don't output progress messages. no yapping mode 🤫
• -d <device>, --device <device> — target device <device>. Supported devices:
  • 1k — Lattice Semiconductor iCE40LP/HX1K
  • 8k — Lattice Semiconductor iCE40LP/HX8K

Default: 1k

• -c <file>, --chipdb <chipdb-file> — read the chip database from <chipdb-file>. Default: /usr/share/arachne-pnr/chipdb-<device>.bin
• --write-binary-chipdb <file> — write the binary chipdb to <file> 💾
• -l, --no-promote-globals — don't promote nets to globals. leave them where they are bestie ✋
• -B <file>, --post-pack-blif <file> — write the post-pack netlist to <file> as BLIF.
• -V <file>, --post-pack-verilog <file> — write the post-pack netlist to <file> as Verilog.
• --post-place-blif <file> — write the post-place netlist to <file> as BLIF.
• --route-only — the input must include placement. no placement, no service 🚫
• -p <pcf-file>, --pcf-file <pcf-file> — read physical constraints from <pcf-file>.
• -P <package>, --package <package> — target package <package>. Default: tq144 for 1k, ct256 for 8k
• -r — randomize seed 🎲✨
• -m <int>, --max-passes <int> — maximum number of routing passes. Default: 200
• -s <int>, --seed <int> — set the seed for the random generator to <int>. Default: 1
• -w <pcf-file>, --write-pcf <pcf-file> — write pin assignments to <pcf-file> after placement 📍
• -o <output-file>, --output-file <output-file> — write output to <output-file>.

---

👑 AUTHOR 👑

This manual page was written by Ruben Undheim <ruben.undheim@gmail.com> for the Debian project (and may be used by others). king behavior honestly 🙇♀️

---

and that's the whole vibe, bestie 💖 this page is from the ARACHNE-PNR(1) manual, dated 16 November 2022 — go forth and route those nets, you absolute legend 🌈✨🎀