iCEDude
(Version 0.1.2.0)

A programming tool for the iCE40 FPGA evaluation boards produced by LATTICE Semiconductor.

About this tool

The tool provides an avrdude like interface to program and interact with the iCE40 evaluation boards, e.g., the iCEblink40-HX1K Evaluation Kit and the iCEstick Evaluation Kit. The tool is written in Haskell and uses libusb as a backend to communicate with the devices.

The project was inspired by the iceBurn project of David Carne, is however rewritten completely from scratch. The reason for that was primarily to increase the number of supported platforms. Escpecially since PyUSB is quite buggy and not the best choice when using a non-Linux environment, e.g., on Apple products. Furthermore, the rewriting process was useful to understand the interaction with the different components and to learn about the overall structure.

Nevertheless, we thank David Carne for finding out the different data values and data structures, which are needed to communicate with the device.

The tool has been tested on the iCEblink40-HX1K Evaluation Kit under a Linux and under a Mac environment. Feedback for other devices is welcome.

Installation

iCEDude is written in Haskell and can be compiled using the Glasgow Haskell Compiler (GHC).

Dependencies:

• libusb (on mac: brew install libusb)

• GHC (recommended version: >= 7.6.1, Haskell2010)

• usb (recommended version: >= 1.3)

• mtl (recommended version: >= 2.2)

• bytestring (recommended version: >= 0.10)

• directory (recommended version: >= 1.2)

• transformers (recommended version: >= 0.4)

• vector (recommended version: >= 0.10)

Building the tool should be simple using cabal

cabal install

or, if you work in a UNIX environment, simply by using

make

Usage

icedude [OPTIONS]...

Operations:

Command	Description
-l	List all supported devices.
-d <id>	Select a specific device.
-U <memtype>:r|w|v:<data>	Memory operation specification.
-e	Perform a chip erase.
-h	Print this help and exit.
-v	Quiet output.