Apio Examples¶
This markdown page was generated automatically on November 7, 2026 from version 2026.10.26 of the Apio definitions package.
Apio project examples can be submitted to the apio-examples Github repository.
ICE40 examples¶
| EXAMPLE | DESCRIPTION |
|---|---|
| alchitry-cu/blinky | Blinks an LED |
| alhambra-ii/area-test | Uses most of the FPGA's resources |
| alhambra-ii/bcd-counter | BCD counter with submodule testbenches |
| alhambra-ii/bcd-counter-sv | SystemVerilog BCD counter with tests |
| alhambra-ii/blinky | Blinking led |
| alhambra-ii/constraint-files | Envs with different constraint files |
| alhambra-ii/getting-started | The Apio getting started docs example |
| alhambra-ii/ledon | Turns on an LED |
| alhambra-ii/multi-board | Builds one design for two boards |
| alhambra-ii/multi-env | Selects the blink rate with apio envs |
| alhambra-ii/pll | Blinks an LED with a 48MHz PLL clock |
| alhambra-ii/prog-cmd | Uses the 'programmer-cmd' option |
| alhambra-ii/speed-test | Measures the speed of a wide adder |
| alhambra-ii/template | Project template |
| azukar2/blinky | Blinks an LED (untested) |
| blackice-ii/blinky | Blinks an LED (untested) |
| blackice/blinky | Blinks an LED |
| edu-ciaa-fpga/and-gate-sv | An AND gate, in SystemVerilog |
| edu-ciaa-fpga/blinky | Blinks an LED |
| edu-ciaa-fpga/led-green | Turns on the green LED |
| edu-ciaa-fpga/template | Project template |
| fomu/blinky | Blinks an LED |
| fomu/dsp | Uses DSP blocks for a multiplier |
| fomu/rgb-led | Cycles the RGB LED through its colors |
| fpga101/blinky | Blinks an LED (untested) |
| go-board/blinky | Blinks an LED |
| go-board/leds | Turns on all the LEDs |
| go-board/template | Project template |
| ice40-hx1k-evb/blinky | Blinks an LED (untested) |
| ice40-hx1k-evb/leds | Buttons turn on the LEDs |
| ice40-hx8k-evb/blinky | Blinks an LED (untested) |
| ice40-hx8k-evb/leds | Buttons turn on the LEDs |
| ice40-hx8k/blinky | Blinks an LED (untested) |
| ice40-hx8k/leds | Turns on all the LEDs |
| ice40-up5k/blinky | Blinks an LED |
| ice40-up5k/led-green | Turns the RGB LED green |
| ice40-up5k/rgb-led | Cycles the RGB LED through its colors |
| ice40-up5k/switches | Switches set the RGB LED colors |
| iceblink40-hx1k/blinky | Blinks an LED (untested) |
| icebreaker-bitsy0/blinky | Blinks an LED (untested) |
| icebreaker-bitsy1/blinky | Blinks an LED (untested) |
| icebreaker/blinky | Blinks an LED |
| icebreaker/buttons | Buttons control the LEDs |
| icebreaker/led-green | Turns on the green LED |
| icefun/blinky | Blinks two LEDs of the LED matrix |
| icefun/led-matrix | LED matrix module |
| icestick/blinky | Blinks an LED (untested) |
| icestick/leds | Turns on all the LEDs |
| icestick/template | Project template |
| icesugar-1-5/blinky | Blinks an LED |
| icesugar-1-5/rgb-led | Cycles the RGB LED through its colors |
| icesugar-nano/blinky | Blinks an LED (untested) |
| icewerx/blinky | Blinks an LED |
| icewerx/ledon | Turns on the red LED |
| icezum/blinky | Blinks an LED |
| icezum/frere-jacques | Frère Jacques in two voices |
| icezum/leds | Turns on all the LEDs |
| icezum/marcha-imperial | Project template for the icezum board |
| icezum/template | Project template |
| icezum/wire | An LED follows a header pin |
| kefir/leds | Turns on all the LEDs |
| kefir/template | Project template |
| odt-icyblue-feather/blinky | Blinks an LED (untested) |
| ok-ice40pro/blinky | Blinks an LED (untested) |
| pico-ice/blinky | Blinks an LED (untested) |
| soan-papdi/blinky | Blinking LED (untested) |
| tinyfpga-b2/blinky | Blinks an LED wired to pin 13 |
| tinyfpga-b2/template | Project template |
| tinyfpga-bx/blink-sos | Flashes SOS in Morse code |
| tinyfpga-bx/blinky | Blinks an LED |
| tinyfpga-bx/clock-divider | Clock divider with two phases outputs |
| tinyfpga-bx/template | Project template |
| upduino/blinky | Blinks an LED (untested) |
| upduino2/blinky | Blinks an LED (untested) |
| upduino21/blinky | Blinks an LED (untested) |
| upduino3/blinky | Blinks an LED |
| upduino31/blinky | Blinks an LED |
| upduino31/rgb-led | Cycles the RGB LED through its colors |
| vsdsquadron-fm/blinky | Blinks an LED (untested) |
ECP5 examples¶
| EXAMPLE | DESCRIPTION |
|---|---|
| butterstick-r10-2g-85k-ft2232h/blinky | Blinks an LED (untested) |
| butterstick-r10-2g-85k-ft232h/blinky | Blinks an LED (untested) |
| butterstick-r10-2g-85k/blinky | Blinks an LED (untested) |
| colorlight-5a-75b-v61/blinky | Blinks an LED (untested) |
| colorlight-5a-75b-v7/blinky | Blinks an LED (untested) |
| colorlight-5a-75b-v8/blinky | Blinks an LED |
| colorlight-5a-75b-v8/ledon | Turns on the LED |
| colorlight-5a-75b-v8/ledon-sv | Turns on the LED |
| colorlight-5a-75b-v8/pll | Blinks an LED with a 120MHz PLL clock |
| colorlight-5a-75b-v8/speed-test | Measures the speed of an adder |
| colorlight-5a-75e-v6/blinky | Blinks an LED (untested) |
| colorlight-5a-75e-v71-ft2232h/blinky | Blinks an LED |
| colorlight-5a-75e-v71-ft2232h/ledon | Turns on the LED |
| colorlight-5a-75e-v71-ft232h/blinky | Blinks an LED |
| colorlight-5a-75e-v71-usb-blaster/blinky | Blinks an LED |
| colorlight-i5-v7-0-ram/blinky | Blinks an LED (untested) |
| colorlight-i5-v7-0/blinky | Blinks an LED (untested) |
| colorlight-i9-v7-2-cmsis-dap/blinky | Blinks an LED (untested) |
| colorlight-i9-v7-2-ft2232h/blinky | Blinks an LED (untested) |
| colorlight-i9-v7-2-ft232h/blinky | Blinks an LED (untested) |
| colorlight-i9-v7-2-usb-blaster/blinky | Blinks an LED (untested) |
| cynthion-r1-4/blinky | Blinks an LED |
| ecp5-evaluation-board/blinky | Blinks an LED (untested) |
| fleafpga-ohm-ft2232h/blinky | Blinks an LED (untested) |
| fleafpga-ohm-ft232h/blinky | Blinks an LED (untested) |
| fleafpga-ohm-usb-blaster/blinky | Blinks an LED (untested) |
| icepi-zero/blinky | Blinks an LED |
| icesugar-pro-ram/blinky | Blinks an LED |
| icesugar-pro/blinky | Blinks an LED |
| icesugar-pro/flash-and-ram | Blinky, programmed to flash or RAM |
| icesugar-pro/pll | Blinks an LED with a 120MHz PLL clock |
| mimas-ecp5-mini/blinky | Blinks an LED (untested) |
| orangecrab-r02-25f/blinky | Blinks an LED (untested) |
| orangecrab-r02-85f/blinky | Blinks an LED (untested) |
| ulx3s-12f/blinky | Blinks an LED |
| ulx3s-12f/ledon | Turns on one LED |
| ulx3s-25f/blinky | Blinks an LED |
| ulx3s-45f/blinky | Blinks an LED |
| ulx3s-45f/button-counter | LEDs show a counter and a button |
| ulx3s-85f/blinky | Blinks an LED |
| ulx3s-85f/button-counter | LEDs show a counter and a button |
| versa/blinky | Blinks an LED (untested) |
GOWIN examples¶
| EXAMPLE | DESCRIPTION |
|---|---|
| brs-100-gw1nr9/blinky | Blinks an LED |
| brs-100-gw1nr9/running-leds | Running lights on the 6 LEDs |
| epm11/blinky | Blinks an LED |
| sipeed-tang-nano-1k/blinky | Blinks an LED |
| sipeed-tang-nano-1k/rgb-led | Rotates the colors of the RGB LED |
| sipeed-tang-nano-20k/blinky | Blinks an LED |
| sipeed-tang-nano-20k/pll | Blinks an LED with a 180MHz PLL clock |
| sipeed-tang-nano-20k/speed-test | Measures the speed of an adder |
| sipeed-tang-nano-4k/blinky | Blinks an LED (untested) |
| sipeed-tang-nano-9k/blinky | Blinks an LED |
| sipeed-tang-nano-9k/blinky-sv | Blinks an LED, in SystemVerilog |
| sipeed-tang-nano-9k/pll | Blinks an LED with a 75MHz PLL clock |
| sipeed-tang-nano-9k/speed-test | Measures the speed of an adder |
| sipeed-tang-nano/blinky | Blinks an LED (untested) |
| sipeed-tang-primer-20k/blinky | 7-seg PMOD blink, Lite top-right |
| sipeed-tang-primer-20k/counter | 7-seg PMOD counter, Lite top-right |
XILINX examples¶
| EXAMPLE | DESCRIPTION |
|---|---|
| alchitry-au-plus/blinky | Blinks an LED |
| alchitry-au/blinky | Blinks an LED |
| alinx-ax7035/blink-envs | Blink rate set by apio.ini env |
| alinx-ax7035/blinky | Blinks an LED |
| arty-a7-100t/blinky | Blinks an LED |
| arty-a7-35t/blinky | Blinks an LED |
| arty-a7-35t/multi-env | Blink rate set by apio.ini env |
| arty-a7-35t/pll | Blinks an LED with a 200MHz PLL clock |
| arty-s7-25/blinky | Blinks an LED |
| arty-s7-50/blinky | Blinks an LED |
| basys3/blinky | Blinks an LED |
| basys3/ledon | Turns on one LED |
| cmod-a7-35t/blinky | Blinks an LED |
| colorlight-i9plus/blinky | Blinks an LED |
| microphase-a7-lite/blinky | Blinks an LED |
| mimas-a7/blinky | Blinks an LED |
| nexys-a7-100t/blinky | Blinks an LED |
| nexys-a7-50t/blinky | Blinks an LED |
| pynq-z1/blinky | Blinks an LED |
| pynq-z2/blinky | Blinks an LED |
| qmtech-xc7a100t-ft2232h/blinky | Blinks an LED |
| zedboard/blinky | Blinks an LED |
| zxtres-plus-plus/blinky | Blinks an LED |
| zxtres-plus/blinky | Blinks an LED |
| zxtres/blinky | Blinks an LED |
| zybo-z7-10/blinky | Blinks an LED |
| zybo-z7-20/blinky | Blinks an LED |