apio upload

Usage

apio upload [OPTIONS]

Description

Upload the bitstream to the FPGA. It builds the project if required.

It also performs an automatic discovery and validation of the FTDI chip depending on the selected board.

Required packages: scons, system, icestorm.

Note

FTDI driver configuration must be done before upload. More information in apio drivers.

Options

-b, --board

Select a specific board.

--serial-port

Select a specific serial port. You can check the available serial devices with the command apio system --lsserial.

--ftdi-id

Select a specific FTDI index. You can check the available FTDI indexes with the command apio system --lsftdi. This numerical index is provided by libftdi1, that is different from libftdi0.

-s, --sram

Perform SRAM programming. Only available for iceprog compatible boards.

-p, --project-dir

Set the target directory for the project.

-v, --verbose

Show the entire output of the command.

--verbose-yosys

Show the yosys output of the command.

--verbose-arachne

Show the arachne output of the command.

Note

All available boards, FPGAs, sizes, types and packs are showed in apio boards

Examples

  1. Upload the leds example
$ apio upload
[] Processing icezum
---------------------------------------------------------------------------------------------
[...]
iceprog -d i:0x0403:0x6010:0 hardware.bin
init..
cdone: high
reset..
cdone: low
flash ID: 0x20 0xBA 0x16 0x10 0x00 0x00 0x23 0x51 0x85 0x32 0x13 0x00 0x54 0x00 0x29 0x10 0x06 0x15 0x51 0x62
file size: 32220
erase 64kB sector at 0x000000..
programming..
reading..
VERIFY OK
cdone: high
Bye.
================================== [SUCCESS] Took 1.96 seconds ==============================