.\" Text automatically generated by txt2man
.TH ARACHNE-PNR 1 "17 July 2018" "" ""
.SH NAME
\fBarachne-pnr \fP- Place and route tool for iCE40 family FGPAs
\fB
.SH SYNOPSIS
.nf
.fam C
\fBarachne-pnr\fP [\fIoptions\fP] <filename>

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION

Arachne-pnr implements the place and route step of the hardware compilation
process for FPGAs. It accepts as input a technology-mapped netlist in BLIF
format, as output by the Yosys synthesis suite for example. It currently
targets the Lattice Semiconductor iCE40 family of FPGAs. Its output is a
textual bitstream representation for assembly by the IceStorm icepack command.
The output of icepack is a binary bitstream which can be uploaded to a hardware
device.
.RE
.PP

.SH OPTIONS


.TP
.B
\fB-h\fP, \fB--help\fP
Print this usage message.
.TP
.B
\fB-q\fP, \fB--quiet\fP
Run quiet.  Don't output progress messages.
.TP
.B
\fB-d\fP <device>, \fB--device\fP <device>
Target device <device>.  Supported devices:
1k - Lattice Semiconductor iCE40LP/HX1K
8k - Lattice Semiconductor iCE40LP/HX8K
Default: 1k
.TP
.B
\fB-c\fP <file>, \fB--chipdb\fP <chipdb-file>
Read chip database from <chipdb-file>.
Default: /usr/share/\fBarachne-pnr\fP/chipdb-<device>.bin
.TP
.B
\fB--write-binary-chipdb\fP <file>
Write binary chipdb to <file>.
.TP
.B
\fB-l\fP, \fB--no-promote-globals\fP
Don't promote nets to globals.
.TP
.B
\fB-B\fP <file>, \fB--post-pack-blif\fP <file>
Write post-pack netlist to <file> as BLIF.
.TP
.B
\fB-V\fP <file>, \fB--post-pack-verilog\fP <file>
Write post-pack netlist to <file> as Verilog.
.TP
.B
\fB--post-place-blif\fP <file>
Write post-place netlist to <file> as BLIF.
.TP
.B
\fB--route-only\fP
Input must include placement.
.TP
.B
\fB-p\fP <pcf-file>, \fB--pcf-file\fP <pcf-file>
Read physical constraints from <pcf-file>.
.TP
.B
\fB-P\fP <package>, \fB--package\fP <package>
Target package <package>.
Default: tq144 for 1k, ct256 for 8k
.TP
.B
\fB-r\fP
Randomize seed.
.TP
.B
\fB-m\fP <int>, \fB--max-passes\fP <int>
Maximum number of routing passes.
Default: 200
.TP
.B
\fB-s\fP <int>, \fB--seed\fP <int>
Set seed for random generator to <int>.
Default: 1
.TP
.B
\fB-w\fP <pcf-file>, \fB--write-pcf\fP <pcf-file>
Write pin assignments to <pcf-file> after placement.
.TP
.B
\fB-o\fP <output-file>, \fB--output-file\fP <output-file>
Write output to <output-file>.
.RE
.PP




.SH AUTHOR
This manual page was written by Ruben Undheim <ruben.undheim@gmail.com> for the Debian project (and may be used by others).
.RE
.PP