Installation

Apio is written in Python and works on Linux (+ARM), Mac OS X, Windows.

System requirements

Operating System:
 

Linux (+ARM), Mac OS X or Windows

Python Interpreter:
 

Python 2.7

Attention

Windows Users: Please Download the latest Python 2.7.x and install it. DON’T FORGET to select Add python.exe to Path feature on the “Customize” stage, otherwise Python Package Manager pip command will not be available.

../_images/python-installer-add-path.png
Terminal Application:
 

All commands below should be executed in Command-line application (Terminal). For Mac OS X and Linux OS - Terminal application, for Windows OS – cmd.exe application.

Install Apio

The latest stable version of Apio may be installed or upgraded via Python Package Manager (pip) as follows:

$ pip install -U apio

If pip command is not available run easy_install pip.

Note that you may run into permissions issues running these commands. You have a few options here:

  • Run with sudo to install Apio and dependencies globally
  • Specify the pip install –user option to install local to your user
  • Run the command in a virtualenv local to a specific project working set.

Note

Debian users can also install the application and its packages by executing:

$ curl -sSL http://fpgalibre.sf.net/debian/go | sudo sh
$ sudo apt-get install apio
$ sudo apt-get install apio-scons apio-icestorm apio-iverilog apio-examples apio-system

Install FPGA FTDI drivers

Using apio

$ apio drivers --enable

To revert the FTDI drivers configuration

$ apio drivers --disable

Manually

Linux

Download 80-icestick.rules and execute

$ sudo cp 80-icestick.rules /etc/udev/rules.d/
$ sudo service udev restart

Mac OS X

Install homebrew and libftdi

$ brew install libftdi

Configure the drivers

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

To revert the drivers configuration

$ sudo kextload -b com.FTDI.driver.FTDIUSBSerialDriver -q
$ sudo kextload -b com.apple.driver.AppleUSBFTDI -q

Windows

Go to this tutorial and follow its steps