Skip to content
This repository has been archived by the owner on May 10, 2022. It is now read-only.

Home

Jump to bottom
Juan Gonzalez-Gomez edited this page Feb 29, 2016 · 70 revisions

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/
  • Execute the build-toolchain.sh script:
$ bash build-toolchain.sh

It will apt-get-install the packages needed, clone the github repositories, compile the tools statically and package them into a tarball

When it is finished, the toolchain-icestorm-<platform>-<version>.tar.gz file will be created.

These are the different platforms:

  • linux_i686
  • linux_x86_64
  • windows (x86, amd64)
  • darwin (x86_64)

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-iceprog-windows-7.zip package with iceprog 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-iceprog-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 10-64 bits. 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

  • 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! :-)

Authors

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

Credits

  • Cristóbal Bueno: Bug reported. Testing. Thanks!

License

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

Clone this wiki locally