apio upload [OPTIONS]
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 cmd_drivers
.
apio upload
-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 cmd_boards
- 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 ==============================