apio upload¶
Contents
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¶
- 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 ==============================