RISC-V¶

Configuration:: platform = riscv

RISC-V is an open, free ISA enabling a new era of processor innovation through open standard collaboration. Born in academia and research, RISC-V ISA delivers a new level of free, extensible software and hardware freedom on architecture, paving the way for the next 50 years of computing design and innovation.

For more detailed information please visit vendor site.

Tutorials ¶

RISC-V ASM Video Tutorial

Examples ¶

Examples are listed from RISC-V development platform repository:

Debugging ¶

PIO Unified Debugger - “1-click” solution for debugging with a zero configuration.

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).

Warning

You will need to install debug tool drivers depending on your system. Please click on compatible debug tool below for the further instructions.

On-Board Debug Tools ¶

Boards listed below have on-board debug probe and ARE READY for debugging! You do not need to use/buy external debug probe.

Name	MCU	Frequency	Flash	RAM
HiFive1	FE310	320MHz	16MB	16KB

External Debug Tools ¶

Boards listed below are compatible with PIO Unified Debugger but DEPEND ON external debug probe. They ARE NOT READY for debugging. Please click on board name for the further details.

Name	MCU	Frequency	Flash	RAM
E51 Arty (Artix-7) FPGA Dev Kit	E51	1500MHz	16MB	256MB
Freedom E310 Arty (Artix-7) FPGA Dev Kit	E31	320MHz	16MB	256MB

Stable and upstream versions ¶

You can switch between stable releases of RISC-V development platform and the latest upstream version using platform option in “platformio.ini” (Project Configuration File) as described below.

Stable¶

; Latest stable version
[env:latest_stable]
platform = riscv
board = ...

; Custom stable version
[env:custom_stable]
platform = riscv@x.y.z
board = ...

Upstream¶

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

Packages ¶

Name	Description
framework-freedom-e-sdk	Open Source Software for Developing on the SiFive Freedom E Platform
tool-openocd-riscv	OpenOCD for RISC-V
toolchain-riscv	GNU toolchain for RISC-V, including GCC

Warning

Linux Users:

Install “udev” rules 99-platformio-udev.rules

Raspberry Pi users, please read this article Enable serial port on Raspberry Pi.

Windows Users:

Please check that you have a correctly installed USB driver from board manufacturer

Frameworks ¶

Name	Description
Freedom E SDK	Open Source Software for Developing on the SiFive Freedom E Platform

Boards ¶

Note

You can list pre-configured boards by platformio boards command or PlatformIO Boards Explorer
For more detailed board information please scroll tables below by horizontal.

SiFive¶

Name	Debug	MCU	Frequency	Flash	RAM
HiFive1	On-board	FE310	320MHz	16MB	16KB

Xilinx¶

Name	Debug	MCU	Frequency	Flash	RAM
E51 Arty (Artix-7) FPGA Dev Kit	External	E51	1500MHz	16MB	256MB
Freedom E310 Arty (Artix-7) FPGA Dev Kit	External	E31	320MHz	16MB	256MB