Home

Introduction

Binaries for the Icestorm tools (yosys, arachne and icetools). They have been compiled statically and packaged for Platformio and Apio

Building a new release

Follow this steps for building a new release of the Icestorm tools:

• Clone the Toolchain-icestorm repo and enter into the directory:

$ git clone https://github.com/bqlabs/toolchain-icestorm.git
$ cd toolchain-icestorm/

• Depending on the target platform, execute the corresponding build script:

Platform	Execute
Windows 64 bits	$ bash build-windows_x86_64.sh
Windows 32 bits	$ bash build-windows_i386.sh
Linux 32 bits	$ bash build-linux_i686.sh
Ubuntu phone	$ bash build-ubuntu-phone_armhf.sh

After some time, the package toolchain-icestorm-ARCH-x.tar.gz will be generated in the package directory (where ARCH is the target platform and x the version)

Cleaning

Execute the same build script with the target clean for deleting all the packages and intermediate files generated. Example:

$ bash build-windows_x86_64.sh clean

Upload a new release with travis

Increment version number X in build script

$ git commit -a -m 'Version updated'
$ git push upstream master

$ git tag 0.X
$ git push upstream 0.X

Installing the Icestorm package

You can install the latest icestorm package using Apio. Follow these steps:

• Install apio:

$ pip install apio

• Install the icestorm tools with:

$ apio install
Install tool-scons
Download scons-2.4.1.tar.gz
Downloading  [####################################]  100%             
Unpacking  [####################################]  100%
Install toolchain-icestorm
Download toolchain-icestorm-x86_64-4.tar.gz
Downloading  [####################################]  100%             
Unpacking  [####################################]  100%

Testing in windows

These instructions are temporal. When the whole icestorm tools are cross-compiled and integrated into Apio, the installation and tests will be done in a different manner

But in the meanwhile, the instructions for testing the different packages are the following:

Testing iceprog

• Download the toolchain-icestorm-windows-7.zip package for windows. It has been cross-compiled from Linux to windows. It is 32-bits version, so that it should work on both 32 and 64 windows versions

• Uncompress the toolchain-icestorm-windows-7.zip file

• Move the bin\iceprog.exe exectuable file to the Desktop

• Move the examples\icestick*.bin bitstreams files to the Desktop

• Plug the icestick board into the computer usb

• Make sure you have installed the correct drivers. Follow these instructions

• Open the cmd command terminal interface

• Drag the icprog into the terminal and insert an space

• Drag the bitstream t1.bin to the terminal and press Enter. Iceprog should be execute with the t1.bin as an argument. The bitstream should be uploaded into the icestick board:

If all the icestick leds are turn on... Congrats! You have uploaded your first bitstream from Windows!

• Download the other two examples: t2.bin and t3.bin

More tests

[2016-Feb-28]: Cristóbal Bueno tested it on Windows 8.1 64 bits. Thanks!

[2016-March-1]: Carlos Díaz tested it on Windows 10 - 64 bits. Thanks!

[2016-March-05]: Eladio Delgado tested it on Windows 7 - 64 bits on an Icezum Alhambra board. Thanks!

Testing in MAC

These instructions are temporal. When the whole icestorm tools are cross-compiled and integrated into Apio, the installation and tests will be done in a different manner

But in the meanwhile, the instructions for testing the different packages are the following:

Testing iceprog

• Download the toolchain-icestorm-iceprog-darwin-7.tar.gz package with iceprog for MAC

• Uncompress the package and drag the folder toolchain-icestorm to your desktop

• Make sure you have brew installed
• Open the command line interface and Execute the following command for installing the libftdi library:

$ brew install libftdi0

• Unplug the icestick board and unload any ftdi driver:

$ sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver
$ sudo kextunload -b com.apple.driver.AppleUSBFTDI

• Plug the icestick board
• Open the toolchain-icestorm folder from the desktop

• Move into the bin folder and drag the iceprog file to the terminal

• Move into the examples/icestick folder and drag the t1.bin file into the terminal

• Press Enter in the terminal. The bitstream will be upload into the FPGA

• Repeat with the t2.bin and t3.bin examples

Congrats! You've uploaded your first bitstream into the FPGA using opensource tools! :-)

Testing in ubuntu phone

TODO

Authors

• Jesús Arroyo
• Juan González (Obijuan)

Credits

• Cristóbal Bueno: Bug reported and Testing on Windows 8 - 64 bits. Thanks!
• Carlos Díaz: Testing on Windows 10. Thanks!
• Sebastian Gallardo: Testing on Windows 32 bits. Thanks!

License

Licensed under a GPL v2 and Creative Commons Attribution-ShareAlike 4.0 International License

Links:

• Installling icestorm on a mac