Skip to main content

Open source ecosystem for open FPGA boards

Project description

PyPI Version Build Status License


Open source ecosystem for open FPGA boards

Apio (pronounced [ˈa.pjo]) is a multiplatform toolbox, with static pre-built packages, project configuration tools and easy command interface to verify, synthesize, simulate and upload your verilog designs.

Apio is used by Icestudio.

Table of contents


Find all the information on this WIKI PAGE


  1. Install Python and pip

  2. Install the latest apio: pip install -U apio

Apio packages

Package Installation Description
drivers apio install drivers Drivers tools (only for Windows)
examples apio install examples Verilog basic examples, pinouts, etc
gtkwave apio install gtkwave Simulation viewer. GTKWave project (only for Windows)
yosys apio install yosys FPGA synthesis. Yosys project
ice40 apio install ice40 iCE40 place & route and configuration tools. Icestorm project
ecp5 apio install ecp5 ECP5 tools including Project Trellis and nextpnr
iverilog apio install iverilog Verilog simulation and synthesis tool. Icarus Verilog project
scons apio install scons A software construction tool. Scons project
system apio install system Tools for listing the USB devices and retrieving information from the FTDI chips
verilator apio install verilator Verilog HDL simulator. Verilator project
icesprog apio install icesprog Programmer for the iCESugar
dfu-utils apio install dfu Device Firmware Upgrade Utilities
fujprog apio install fujprog Programmer for ULX2/3S boards

Supported platforms

linux_x86_64, linux_i686, linux_armv7l, linux_aarch64, windows_x86, windows_amd64, darwin.

Supported boards


Board name Interface
IceZUM Alhambra FTDI
Nandland Go board FTDI
iCEstick Evaluation Kit FTDI
iCEblink40-HX1K Digilent Adept


Board name Interface
Alhambra II FTDI
BlackIce Serial
BlackIce II Serial
Blackice-mx Serial
Kéfir I iCE40-HX4K FTDI
iCE40-HX8K Breakout Board FTDI
Alchitry Cu FTDI
iceFUN Serial


Board name Interface
TinyFPGA B2 Serial
TinyFPGA BX Serial


Board name Interface
Fomu DFU
FPGA 101 Workshop Badge Board FTDI
iCEBreaker FTDI
iCEBreaker bitsy DFU
iCE40 UltraPlus Breakout Board FTDI
UPDuino v1.0 FTDI
UPDuino v2.0 FTDI
UPDuino v2.1 FTDI
UPDuino v3.0 FTDI
iCESugar v1.5 FTDI


Board name Interface
OrangeCrab r0.2 DFU
ButterStick r1.0 DFU
TinyFPGA-EX-rev1 Serial
TinyFPGA-EX-rev2 Serial
ULX3S-12F Ujprog
ULX3S-25F Ujprog
ULX3S-45F Ujprog
ULX3S-85F Ujprog
ColorLight-5A-75B-V61 FT2232H
ColorLight-5A-75B-V7 FT2232H
ColorLight-5A-75B-V8 FT2232H
ColorLight-5A-75E-V6 FT2232H
ColorLight-5A-75E-V71 FT2232H, FT232H or USB-Blaster
ColorLight-i5-v7.0 FT2232H, FT232H or USB-Blaster
iCESugar-Pro FT2232H, FT232H or USB-Blaster
FleaFPGA-Ohm FT2232H, FT232H or USB-Blaster
ECP5-Evaluation-Board FT2232H


Board name Interface
iCESugar-nano FTDI

NOTE: all supported Icestorm FPGAs can be used with --fpga or --size, --type and --pack options.


The complete documentation of the project can be found in Read the Docs: There is also a list of frequently asked questions (FAQ) that you can check here.


git clone
cd apio


pip install tox
tox -e offline
tox -e coverage


cd docs
make html
firefox _build/html/index.html

Debian packaging

Also you can find the debian scripts to package the full application and all the packages here:

Thanks Salvador E. Tropea!


Apio in RPI2: iCEstick, Icezum and icoBOARD

Apio: an easy multi-platform toolbox for open FPGAs




  • APIO was inspired by PlatformIO.

  • FPGAwars community has developed this project in a voluntary and altruistic way since 11/2016.

  • BQ sponsored this project from 02/2016 to 11/2016. Thanks.


Licensed under GPL 2.0 and Creative Commons Attribution-ShareAlike 4.0 International License.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apio-0.8.1.tar.gz (1.2 MB view hashes)

Uploaded source

Built Distribution

apio-0.8.1-py3-none-any.whl (70.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page