aboutsummaryrefslogtreecommitdiffstats
path: root/iceprog
diff options
context:
space:
mode:
authorClifford Wolf <clifford@clifford.at>2017-08-31 14:55:36 +0200
committerClifford Wolf <clifford@clifford.at>2017-08-31 15:00:41 +0200
commit8354bc6086f11002cc58497f91f43200a09c13a9 (patch)
tree8a8ff79693f41b9678581ecd03900cc98513fa8b /iceprog
parent7b07cd489d771d543c4db808f7b1eb22ced976bb (diff)
downloadicestorm-8354bc6086f11002cc58497f91f43200a09c13a9.tar.gz
icestorm-8354bc6086f11002cc58497f91f43200a09c13a9.tar.bz2
icestorm-8354bc6086f11002cc58497f91f43200a09c13a9.zip
Removed files that are under GNU licenses
Diffstat (limited to 'iceprog')
-rw-r--r--iceprog/Makefile3
-rw-r--r--iceprog/iceprog.1155
2 files changed, 0 insertions, 158 deletions
diff --git a/iceprog/Makefile b/iceprog/Makefile
index d71a9b7..8739ba6 100644
--- a/iceprog/Makefile
+++ b/iceprog/Makefile
@@ -24,12 +24,9 @@ iceprog$(EXE): iceprog.o
install: all
mkdir -p $(DESTDIR)$(PREFIX)/bin
cp iceprog$(EXE) $(DESTDIR)$(PREFIX)/bin/iceprog$(EXE)
- mkdir -p $(DESTDIR)$(PREFIX)/share/man/man1
- install -c -m 644 iceprog.1 $(DESTDIR)$(PREFIX)/share/man/man1
uninstall:
rm -f $(DESTDIR)$(PREFIX)/bin/iceprog$(EXE)
- rm -f $(DESTDIR)$(PREFIX)/share/man/man1/iceprog.1
clean:
rm -f iceprog
diff --git a/iceprog/iceprog.1 b/iceprog/iceprog.1
deleted file mode 100644
index 22d3882..0000000
--- a/iceprog/iceprog.1
+++ /dev/null
@@ -1,155 +0,0 @@
-.\" Manpage for iceprog(1)
-.\" Copyright (C) 2017 Roland Lutz
-.\"
-.\" Permission is granted to copy, distribute and/or modify this document
-.\" under the terms of the GNU Free Documentation License, Version 1.3 or
-.\" any later version published by the Free Software Foundation; with no
-.\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-.\"
-.TH ICEPROG "1" "June 2017" "IceStorm" "User Commands"
-.SH NAME
-iceprog \- simple programming tool for FTDI\-based Lattice iCE programmers
-.SH SYNOPSIS
-.B iceprog
-[\-b|\-n|\-c] \fIINPUT\-FILE\fR
-
-.B iceprog
-\-r|\-R\fI\,BYTES\fR \fIOUTPUT\-FILE\fR
-
-.B iceprog
-\-S \fIINPUT\-FILE\fR
-
-.B iceprog
-\-t
-.SH DESCRIPTION
-The \fBiceprog\fR program is a simple programming tool for FTDI\-based
-Lattice iCE programmers which can read, write and erase the flash and
-write the SRAM of an FPGA. It is typically invoked after the
-bitstream has been converted by \fBicepack\fR to the iCE40 \fB.bin\fR
-format as the last step of the build process to transfer the bitstream
-to the FPGA.
-.SS Operation mode
-When no special option is given, \fBiceprog\fR erases all 64kB sectors
-which would be touched by the written data, writes the data to the
-flash, and then reads it back and verifies it.
-
-\fIPlease note:\fR If the data is not aligned to 64kB, some data
-before (if \fB\-o\fR is used) and after the written data may be erased
-as well.
-
-The way the flash is erased can be changed with the following options:
-.TP
-\fB\-b\fR
-Bulk erase the entire flash before writing. When using this option,
-\fBiceprog\fR can be invoked without an \fIINPUT\-FILE\fR; in this
-case, the flash is just bulk erased, and nothing is written.
-.TP
-\fB\-n\fR
-Don't erase the flash before writing.
-.PP
-Instead of the default erase/write/verify, \fBiceprog\fR can perform
-some other operations:
-.TP
-\fB\-c\fR
-Just read the data which would have been written from the flash and
-verify it (`check').
-.TP
-\fB\-r\fR
-Read the first 256 kB from flash and write them to a file.
-.TP
-\fB\-R\fR \fISIZE\-IN\-BYTES\fR
-Read the specified number of bytes from the flash and write them to a
-file. You can append `\fBk\fR' to the size to specify it in kilobytes
-and `\fBM\fR' to specify it in megabytes.
-.TP
-\fB\-S\fR
-Perform SRAM programming.
-.TP
-\fB\-t\fR
-Just read the flash ID sequence.
-.PP
-All of the above options are mutually exclusive.
-.SS General options
-.TP
-\fB\-d\fR \fIDEVICE\-STRING\fR
-Use the specified USB device instead of the default one (which is
-vendor ID 0x0403 and device ID 0x6010). The supported notations for
-\fIDEVICE\-STRING\fR are:
-
-\fBd:\,\f(BIdevicenode\fR \- path of the bus and device node within
-USB device tree (usually at /proc/bus/usb/); e.g., `d:002/005'
-
-\fBi:\,\f(BIvendor\/\fB:\,\f(BIproduct\fR \- first device with given
-vendor and product ID. IDs can be decimal, octal (preceded by
-`\fB0\fR'), or hex (preceded by `\fB0x\fR'); e.g., `i:0x0403:0x6010'
-
-\fBi:\,\f(BIvendor\/\fB:\,\f(BIproduct\/\fB:\,\f(BIindex\fR \- same as
-above, with index being the number of the device (starting with 0) if
-there is more than one device with this vendor and product ID; e.g.,
-`i:0x0403:0x6010:0'
-
-\fBs:\,\f(BIvendor\/\fB:\,\f(BIproduct\/\fB:\,\f(BIserial\-string\fR
-\- first device with given vendor ID, product ID and serial string.
-.TP
-\fB\-I\fR A|B|C|D
-Connect to the specified interface on the FTDI chip. If this option
-is omitted, interface A is used.
-.TP
-\fB\-o\fR \fIOFFSET\-IN\-BYTES\fR
-Start reading/writing at address \fIOFFSET\-IN\-BYTES\fR instead of the
-beginning of the memory. You can append `\fBk\fR' to the offset to
-specify it in kilobytes and `\fBM\fR' to specify it in megabytes.
-.TP
-\fB\-v\fR
-Write more verbose messages.
-.TP
-\fB\-\-help\fR
-Display a help text and exit.
-.SS Exit status
-.TP
-.B 0
-on success,
-.TP
-.B 1
-if a non\-hardware error occurred (e.g., failure to read from or write
-to a file, or invoked with invalid options),
-.TP
-.B 2
-if communication with the hardware failed (e.g., cannot find the iCE
-FTDI USB device),
-.TP
-.B 3
-if verification of the data failed.
-.SS Notes for iCEstick (iCE40HX\-1k devel board)
-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>
-.SS 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.
-.SH AUTHOR
-Written by Clifford Wolf.
-.SH REPORTING BUGS
-If you have a bug report, please file an issue on github:
-<https://github.com/cliffordwolf/icestorm/issues>
-.SH COPYRIGHT
-Most of Project IceStorm is licensed under the ISC license:
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.SH SEE ALSO
-Full documentation at: <http://hedmen.org/icestorm-doc/>
-.br
-or available locally via: info \(aq(icestorm) iceprog invocation\(aq