ice40_viewer icon indicating copy to clipboard operation
ice40_viewer copied to clipboard

This project aims to develop a tool to graphically view a place-n-routed ICE40 configuration, showing the exact placement of every signal and logic gates. It reads the *.asc files that are also used as input to icepack to generate the final bitstream. Both HX1K and HX8K devices are supported.

This is still work in progress, and some connections are not shown, eg. global nets and BRAM connections. Still, it should already be quite functional.

The latest version is hosted on github.io for easy access:

https://knielsen.github.io/ice40_viewer/ice40_viewer.html

See the bottom of the page (below the canvas display) for instructions.

There is also a standalone version available as the program iceview_html.py. This program reads an input *.asc file and outputs a standalone .html page containing the viewer. Optionally, the result can be opened directly in a browser of choice (-s option):

iceview_html.py -s firefox input.asc output.html

This should provide a convenient way to use the viewer during FPGA development.

Instructions for installing the HTTP-server version: Dump the files somewhere accessible through a web server, and open ice40_viewer.html in a browser.

One really simple way, useful for development, is to use Python's SimpleHTTPServer. Simply run it from the directory containing the source files:

python -m SimpleHTTPServer

Then the tool is available as http://localhost:8000/ice40_viewer.html

License: ISC license, see file LICENSE.

Most of the examples are from https://github.com/nesl/ice40_examples, and are under a GPL-v3 license, see examples/LICENSE.

Contact: Kristian Nielsen [email protected]