NEXTPNR-GOWIN(1)

📦
version 0.7 · 3 versions
, in ubuntu questing

💖 NEXTPNR-GOWIN 💖

okay bestie, sit down, hydrate, because we're talking about nextpnr-gowin — that's the Next Generation Place and Route tool, manual page NEXTPNR-GOWIN(1) from the General Commands section. Version 0.7-1build1, if you were wondering. She's iconic, she's doing the most, and she has SO many flags. Let's go. 🫶

✨ NAME ✨

nextpnr-gowin — Next Generation Place and Route

🌸 DESCRIPTION 🌸

nextpnr-gowin — Next Generation Place and Route (Version 0.7-1build1)

like. the whole personality is right there in the name. place. and. route. periodt. 💅

🎀 General options 🎀

the daily drivers, the little guys, the ones you'll actually type. every single one of them, no cap:

  • -h, --help — show help. she's giving tutorial era 💖
  • -v, --verbose — verbose output. she tells you EVERYTHING. oversharing queen 🌈
  • -q, --quiet — quiet mode, only errors and warnings displayed. main character who doesn't do small talk ✨
  • --Werror — Turn warnings into errors. no warnings allowed, we die like professionals 💀
  • -l, --log arg — log file, all log messages are written to this file regardless of -q. so even in quiet mode, the receipts go in the file. iykyk 🧚
  • --debug — debug output
  • --debug-placer — debug output from placer only
  • --debug-router — debug output from router only
  • --threads arg — number of threads for passes where this is configurable. parallelism bestie 🏃‍♀️💨
  • -f, --force — keep running after errors. she's delusional in the most productive way possible, we love her 😭
  • --gui — start gui. aesthetics mode activated 🎀
  • --gui-no-aa — disable anti aliasing (use together with --gui option). crunchy pixels, retro vibe 👑
  • --run arg — python file to execute instead of default flow
  • --pre-pack arg — python file to run before packing
  • --pre-place arg — python file to run before placement
  • --pre-route arg — python file to run before routing
  • --post-route arg — python file to run after routing
  • --on-failure arg — python file to run in event of crash for design introspection. yes girl, journal about it 💜
  • --json arg — JSON design file to ingest. eat up 🍓
  • --write arg — JSON design file to write
  • --top arg — name of top module
  • --seed arg — seed value for random number generator
  • -r, --randomize-seed — randomize seed value for random number generator. chaos gremlin energy, we stan 🌈
  • --placer arg — placer algorithm to use; available: sa, heap; default: heap
  • --router arg — router algorithm to use; available: router1, router2; default: router1
  • --slack_redist_iter arg — number of iterations between slack redistribution
  • --cstrweight arg — placer weighting for relative constraint satisfaction
  • --starttemp arg — placer SA start temperature. she's hot, she's cold, she's SA 🔥
  • --pack-only — pack design only without placement or routing
  • --no-route — process design without routing
  • --no-place — process design without placement
  • --no-pack — process design without packing
  • --ignore-loops — ignore combinational loops in timing analysis
  • --ignore-rel-clk — ignore clock-to-clock relations in timing checks
  • -V, --version — show version
  • --test — check architecture database integrity. vibe check, but for databases ✨
  • --freq arg — set target frequency for design in MHz
  • --timing-allow-fail — allow timing to fail in design. setting up your own flop era, respectfully 🙈
  • --no-tmdriv — disable timing-driven placement
  • --sdf arg — SDF delay back-annotation file to write
  • --sdf-cvc — enable tweaks for SDF file compatibility with the CVC simulator
  • --no-print-critical-path-source — disable printing of the line numbers associated with each net in the critical path
  • --placer-heap-alpha arg — placer heap alpha value (float, default: 0.1)
  • --placer-heap-beta arg — placer heap beta value (float, default: 0.9)
  • --placer-heap-critexp arg — placer heap criticality exponent (int, default: 2)
  • --placer-heap-timingweight arg — placer heap timing weight (int, default: 10)
  • --placer-heap-cell-placement-timeout arg — allow placer to attempt up to max(10000, total cells^2 / N) iterations to place a cell (int N, default: 8, 0 for no timeout)
  • --parallel-refine — use new experimental parallelised engine for placement refinement
  • --router2-heatmap arg — prefix for router2 resource congestion heatmaps. she's giving weather girl 🌡️
  • --tmg-ripup — enable experimental timing-driven ripup in router
  • --router2-tmg-ripup — enable experimental timing-driven ripup in router (deprecated; use --tmg-ripup instead). bestie she's OLD, use the new one, fr fr 💀
  • --router2-alt-weights — use alternate router2 weights
  • --report arg — write timing and utilization report in JSON format to file
  • --detailed-timing-report — Append detailed net timing data to the JSON report
  • --placed-svg arg — write render of placement to SVG file
  • --routed-svg arg — write render of routing to SVG file

🦋 Architecture specific options 🦋

the gowin-flavoured part of the menu, lowkey the whole point:

  • --device arg — device name
  • --family arg — family name
  • --cst arg — physical constraints file
  • --enable-globals — enable separate routing of the clocks
  • --disable-globals — disable separate routing of the clocks
  • --enable-auto-longwires — automatic detection and routing of long wires
💅 reminder bestie: --router2-tmg-ripup is deprecated, so use --tmg-ripup instead. and --force really will keep running after errors, which is a choice. make it an informed one.

nextpnr-gowin version 0.7-1build1, dated January 2025 — that's the whole tea, that's the whole manual, go place and route something gorgeous. mwah. 💖✨🎀🦋🌸💅🫶

📦 where this page comes from