[arachne-pnr] 02/03: Improved man page. Added watch

[Ruben Undheim]

This is an automated email from the git hooks/post-receive script.

rubund-guest pushed a commit to branch master
in repository arachne-pnr.

commit 51bf461d6ceaf395a375dd3eb0d1e7d933924605
Author: Ruben Undheim <ruben.undheim at gmail.com>
Date:   Wed Oct 14 16:21:38 2015 +0200

    Improved man page. Added watch
---
 debian/man/arachne-pnr.txt | 71 +++++++++++++++++++++++++++++-----------------
 debian/watch               |  2 ++
 2 files changed, 47 insertions(+), 26 deletions(-)

diff --git a/debian/man/arachne-pnr.txt b/debian/man/arachne-pnr.txt
index 962d7f4..d220a40 100644
--- a/debian/man/arachne-pnr.txt
+++ b/debian/man/arachne-pnr.txt
@@ -1,42 +1,61 @@
 NAME
-  iceprog - simple programming tool for FTDI-based Lattice iCE programmers
+  arachne-pnr - Place and route tool for iCE40 family FGPAs
 
 SYNOPSIS
-  iceprog [options] <filename>
+  arachne-pnr [options] <filename>
 
 DESCRIPTION
 
-Notes for iCEstick (iCE40HX-1k devel board):
+ 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 harware
+ device.
 
-  An unmodified iCEstick can only be programmed via the serial flash.
-  Direct programming of the SRAM is not supported. For direct SRAM
-  programming the flash chip and one zero ohm resistor must be desoldered
-  and the FT2232H SI pin must be connected to the iCE SPI_SI pin, as shown
-  in this picture: http://www.clifford.at/gallery/2014-elektronik/IMG_20141115_183838
 
+OPTIONS
 
-Notes for the iCE40-HX8K Breakout Board:
 
-  Make sure that the jumper settings on the board match the selected
-  mode (SRAM or FLASH). See the iCE40-HX8K user manual for details.
+    -h, --help  Print this usage message.
 
+    -q, --quiet  Run quiet.  Don't output progress messages.
 
-OPTIONS
+    -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 chip database from <chipdb-file>.
+        Default: /usr/share/arachne-pnr/chipdb-<device>.bin
+
+    --write-binary-chipdb <file>  Write binary chipdb to <file>.
+
+    -l, --no-promote-globals     Don't promote nets to globals.
+
+    -B <file>, --post-pack-blif <file>  Write post-pack netlist to <file> as BLIF.
+
+    -V <file>, --post-pack-verilog <file>  Write post-pack netlist to <file> as Verilog.
+
+    --post-place-blif <file>  Write post-place netlist to <file> as BLIF.
+
+    --route-only   Input must include placement.
+
+    -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.
+
+    -s <int>, --seed <int>  Set seed for 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>.
 
-    -d <device-string>  use the specified USB device:
-            d:<devicenode>                (e.g. d:002/005)
-            i:<vendor>:<product>          (e.g. i:0x0403:0x6010)
-            i:<vendor>:<product>:<index>  (e.g. i:0x0403:0x6010:0)
-            s:<vendor>:<product>:<serial-string>
-    -I [ABCD]  connect to the specified interface on the FTDI chip
-    -r  read entire flash (32Mb / 4MB) and write to file
-    -R  read first 256 kB from flash and write to file
-    -c  do not write flash, only verify (check)
-    -b  bulk erase entire flash before writing
-    -n  do not erase flash before writing
-    -S  perform SRAM programming
-    -t  just read the flash ID sequence
-    -v  verbose output
 
  
 
diff --git a/debian/watch b/debian/watch
new file mode 100644
index 0000000..6528d8c
--- /dev/null
+++ b/debian/watch
@@ -0,0 +1,2 @@
+version=3
+https://github.com/cseed/arachne-pnr/releases /cseed/arachne-pnr/archive/\w+-(\d\S+)\.tar\.(?:bz2|gz|xz)

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/arachne-pnr.git