Jesús Arroyo Torrens edited this page Aug 24, 2016 · 70 revisions

Introduction

Binaries from 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/FPGAwars/toolchain-icestorm.git
$ cd toolchain-icestorm/
  • Add in the ARCH attribute the selected architectures. This is located in the build.sh script:
Platform Arch
Windows windows
Linux 64 bits linux_x86_64
Linux 32 bits linux_i686
BQ Aquaris 4.5 Ubuntu phone armv7l
Raspberry pi II armv7l
BQ Aquaris M10 Ubuntu Tablet aarch64
Mac OS X darwin
  • Execute the script.
$ ./build.sh clean

After some time, the packages toolchain-icestorm-ARCH-x.tar.gz will be generated in the _packages 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.

$ ./build.sh clean

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 system scons icestorm
Installing system package:
Download tools-usb-ftdi-linux_x86_64-1.tar.bz2
Downloading  [####################################]  100%             
Unpacking  [####################################]  100%
Package 'system' has been successfully installed!
Install tool-scons
Download scons-2.4.1.tar.gz
Downloading  [####################################]  100%             
Unpacking  [####################################]  100%
Package 'scons' has been successfully installed!
Install toolchain-icestorm
Download toolchain-icestorm-x86_64-9.tar.gz
Downloading  [####################################]  100%             
Unpacking  [####################################]  100%
Package 'icestorm' has been successfully installed!

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 iceprog 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!

[2016-March-22]: Sebastián Gallardo tested it on Windows 7 - 32 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! :-)

Testing in ubuntu phone

The documentation has been moved to this page

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:

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.