Skip to content

Commit 44b22a3

Browse files
committed
move APIO instructions further down.
1 parent 264c2d9 commit 44b22a3

File tree

2 files changed

+33
-33
lines changed

2 files changed

+33
-33
lines changed

Docs/getting_started.md

Lines changed: 1 addition & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -14,39 +14,7 @@ You might want to [update your firmware](https://github.com/tinyvision-ai-inc/pi
1414

1515
- Program a custom firmware onto the RP2040: [Programming the MCU](/programming_the_mcu.html).
1616

17-
18-
## Quick-start with APIO
19-
20-
The [APIO](https://github.com/FPGAwars/apio) project is a command line tool to fetch and use
21-
the [oss-cad-suite](https://github.com/YosysHQ/oss-cad-suite-build) FPGA toolchain based
22-
on [Yosys](https://github.com/YosysHQ/).
23-
24-
It will bring an up-to-date build environment running quickly.
25-
26-
On Windows, you will first need to setup the `libusbK` driver for `pico-ice DFU (CRAM)`
27-
[with Zadig](https://zadig.akeo.ie/) or [with UsbDriverTool](https://visualgdb.com/UsbDriverTool/)
28-
([doc](https://github.com/FPGAwars/apio/wiki/Quick-start)).
29-
30-
```
31-
# Download the latest APIO dev version (with pico-ice support):
32-
pip3 install git+https://github.com/FPGAwars/apio
33-
34-
# Download and install oss-cad-suite
35-
apio install -a
36-
37-
# Build a new directory with a "blinky" example project inside
38-
mkdir pico-ice-blinky; cd pico-ice-blinky
39-
apio examples -f iCE40-UP5K/blink
40-
41-
# Set the board to "pico-ice"
42-
apio init --sayyes --board pico-ice
43-
44-
# Build the project using yosys/nextpnr
45-
apio build
46-
47-
# Plug your pico-ice board and upload the blinky project to it
48-
apio upload
49-
```
17+
- Use APIO to program the FPGA: [Use APIO](/use_apio.html).
5018

5119

5220
## Default Firmware

Docs/use_apio.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Use APIO
2+
3+
The [APIO](https://github.com/FPGAwars/apio) project is a command line tool to fetch and use
4+
the [oss-cad-suite](https://github.com/YosysHQ/oss-cad-suite-build) FPGA toolchain based
5+
on [Yosys](https://github.com/YosysHQ/).
6+
7+
It will bring an up-to-date build environment running quickly.
8+
9+
On Windows, you will first need to setup the `libusbK` driver for `pico-ice DFU (CRAM)`
10+
[with Zadig](https://zadig.akeo.ie/) or [with UsbDriverTool](https://visualgdb.com/UsbDriverTool/)
11+
([doc](https://github.com/FPGAwars/apio/wiki/Quick-start)).
12+
13+
```
14+
# Download the latest APIO dev version (with pico-ice support):
15+
pip3 install git+https://github.com/FPGAwars/apio
16+
17+
# Download and install oss-cad-suite
18+
apio install -a
19+
20+
# Build a new directory with a "blinky" example project inside
21+
mkdir pico-ice-blinky; cd pico-ice-blinky
22+
apio examples -f iCE40-UP5K/blink
23+
24+
# Set the board to "pico-ice"
25+
apio init --sayyes --board pico-ice
26+
27+
# Build the project using yosys/nextpnr
28+
apio build
29+
30+
# Plug your pico-ice board and upload the blinky project to it
31+
apio upload
32+
```

0 commit comments

Comments
 (0)