RISC-V GAP¶

Drivers¶

See “Drivers” section for FTDI Chip debug probe.

AutoTiler¶

You need GAP8 AutoTiler library, please request it via support@greenwaves-technologies.com

Put a library somewhere on a disk and add this folder to library path using build_flags in “platformio.ini” (Project Configuration File). For example,

[env:gapuino]
platform = riscv_gap
board = gapuino
framework = ...
build_flags = -L/path/to/libtile/folder

Running modes¶

GAPuino supports 2 main modes:

1. Running from RAM, boot_mode=jtag

2. Running from HyperFlash, boot_mode=jtag_hyper

A running process can be controlled through the internal upload commands:

• load, @TODO

• reqloop, @TODO

• ioloop, @TODO

• start, @TODO

• wait, @TODO

You can configure “boot mode” and list of upload commands using “platformio.ini” (Project Configuration File). Default values are:

• board_upload.boot_mode = jtag

• board_upload.commands = load reqloop ioloop start wait

Uploading files to HyperFlash¶

1. Create new project using PlatformIO IDE or initialize project using PlatformIO Core (CLI) and pio project init (if you have not initialized it yet)

2. Create data folder (it should be on the same level as src folder) and put files here. Also, you can specify own location for data_dir

3. Run “Upload File System image” task in PlatformIO IDE or use PlatformIO Core (CLI) and pio run --target command with uploadfs target.

Examples:

• PULP OS File System

Tools & Debug Probes¶

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Stable¶

; Latest stable version, NOT recommended
; Pin the version as shown below
[env:latest_stable]
platform = riscv_gap
board = ...

; Specific version
[env:custom_stable]
platform = riscv_gap@x.y.z
board = ...

Upstream¶

[env:upstream_develop]
platform = https://github.com/platformio/platform-riscv_gap.git
board = ...

GreenWaves Technologies¶