Project IceStorm - FreeBSD

IceStorm on FreeBSD

back to main IceStorm page.

local links

Arachne-pnr, Yosys, c1 - FreeBSD,


2018-07-14: c1 - ada2p2 - tools info iceprog

tingo@kg-core1$ iceprog --help
Simple programming tool for FTDI-based Lattice iCE programmers.
Usage: iceprog [-b|-n|-c] <input file>
       iceprog -r|-R<bytes> <output file>
       iceprog -S <input file>
       iceprog -t

General options:
  -d <device string>    use the specified USB device [default: i:0x0403:0x6010 or i:0x0403:0x6014]
                          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)
  -I [ABCD]             connect to the specified interface on the FTDI chip
                          [default: A]
  -o <offset in bytes>  start address for read/write [default: 0]
                          (append 'k' to the argument for size in kilobytes,
                          or 'M' for size in megabytes)
  -v                    verbose output

Mode of operation:
  [default]             write file contents to flash, then verify
  -r                    read first 256 kB from flash and write to file
  -R <size in bytes>    read the specified number of bytes from flash
                          (append 'k' to the argument for size in kilobytes,
                          or 'M' for size in megabytes)
  -c                    do not write flash, only verify (`check')
  -S                    perform SRAM programming
  -t                    just read the flash ID sequence

Erase mode (only meaningful in default mode):
  [default]             erase aligned chunks of 64kB in write mode
                          This means that some data after the written data (or
                          even before when -o is used) may be erased as well.
  -b                    bulk erase entire flash before writing
  -e <size in bytes>    erase flash as if we were writing that number of bytes
  -n                    do not erase flash before writing

Miscellaneous options:
      --help            display this help and exit
  --                    treat all remaining arguments as filenames

Exit status:
  0 on success,
  1 if a non-hardware error occurred (e.g., failure to read from or
    write to a file, or invoked with invalid options),
  2 if communication with the hardware failed (e.g., cannot find the
    iCE FTDI USB device),
  3 if verification of the data failed.

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:

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.

If you have a bug report, please file an issue on github:


tingo@kg-core1$ icepack -?

Usage: icepack [options] [input-file [output-file]]

        unpack mode (implied when called as 'iceunpack')

        verbose (repeat to increase verbosity)

        disable final deep-sleep SPI flash command after bitstream is loaded

        write cram bitmap as netpbm file

        write cram bitmap (fill tiles) as netpbm file

        write cram bitmap (checkerboard) as netpbm file
        repeat to flip the selection of tiles

        write bram data, not cram, to the netpbm file

    -B0, -B1, -B2, -B3
        only include the specified bank in the netpbm file


2018-07-14: c1 - ada2p2 - pkg - files

root@kg-core1# pkg info -l icestorm


2018-07-14: c1 - ada2p2 - ports I installed icestorm from ports on my FreeBSD workstation (c1)

Jul 14 12:11:02 kg-core1 pkg-static: icestorm-g20180310 installed

the machine runs

tingo@kg-core1$ uname -a
FreeBSD 10.4-STABLE FreeBSD 10.4-STABLE #1 r329982: Sun Feb 25 20:35:06 CET 2018  amd64