Skip to content

Commit cd236d4

Browse files
committed
Docs: add instructios about APIO
1 parent 08040a3 commit cd236d4

File tree

2 files changed

+37
-6
lines changed

2 files changed

+37
-6
lines changed

Docs/getting_started.md

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,40 @@ parent: pico-ice
88
# Getting Started
99

1010
Once you receive the board, you would be able to plug via USB and see the RGB LED blinking.
11-
This is from the
12-
[default FPGA bitstream](https://github.com/tinyvision-ai-inc/UPduino-v3.0/blob/master/RTL/blink_led/rgb_blink.bin)
13-
loaded onto the board. It should work with any iCE40-based board.
14-
15-
From here, you can:
11+
You might want to [update your firmware](https://github.com/tinyvision-ai-inc/pico-ice/releases/) to make sure to have the latest bugfixes.
1612

1713
- Program a new FPGA design onto the iCE40: [programming the FPGA](/programming_the_fpga.html).
1814

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

17+
## Quick-start with APIO
18+
19+
The [APIO](https://github.com/FPGAwars/apio) project is a command line tool to fetch and use
20+
the [oss-cad-suite](https://github.com/YosysHQ/oss-cad-suite-build) FPGA toolchain based
21+
on [Yosys](https://github.com/YosysHQ/).
22+
23+
It will bring an up-to-date build environment running quickly.
24+
25+
```
26+
# Download the latest APIO dev version (with pico-ice support):
27+
pip3 install git+https://github.com/FPGAwars/apio
28+
29+
# Download and install oss-cad-suite
30+
apio install -a
31+
32+
# Build a new directory with a "blinky" example project inside
33+
mkdir pico-ice-blinky; cd pico-ice-blinky
34+
apio examples -f iCE40-UP5K/blink
35+
36+
# Set the board to "pico-ice"
37+
apio init --sayyes --board pico-ice
38+
39+
# Build the project using yosys/nextpnr
40+
apio build
41+
42+
# Plug your pico-ice board and upload the blinky project to it
43+
apio upload
44+
```
2145

2246
## Default Firmware
2347

Docs/learn.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,11 @@ nav_order: 4
88

99
A large number of resources exists for learning FPGA design.
1010

11-
Some of them have been collected and aggregated on this page:
11+
Some of them have been collected and aggregated on this page.
12+
13+
An online class was held by tinyVision.ai, and is available freely:
14+
15+
- [Hands-on-FPGA-class](https://github.com/tinyvision-ai-inc/Hands-on-FPGA-class/)
1216

1317
## Video format
1418

@@ -192,6 +196,9 @@ Some of them have been collected and aggregated on this page:
192196

193197
## Courses
194198

199+
- [Hands-on FPGA class](https://github.com/tinyvision-ai-inc/Hands-on-FPGA-class/)
200+
A 8-week class was given by tinyVision.ai for getting started with FPGAs.
201+
195202
- [Intel FPGA Academy](https://fpgacademy.org/courses.html)
196203
Digital logic/FPGA courses by Intel.
197204
requires .edu email (contact intel for access without .edu email but response may vary)

0 commit comments

Comments
 (0)