riscvsystem/riscv_system repository overview

⁠RISC-V GNU Toolchain, RISC-V OpenOCD and FreeRTOS Template

Simple Template with RISC-V GNU Toolchain, RISC-V OpenOCD and FreeRTOS for Visual Studio Code.

Visual Studio Code installer: link⁠

Visual Studio Code guide for Windows: link⁠

Visual Studio Code guide for Linux: link⁠

Required extensions for Visual Studio Code (Can be added from recommendations in Visual Studio Code):

ms-vscode.cmake-tools
ms-vscode.cpptools
ms-vscode.cpptools-extension-pack
ms-vscode.cpptools-themes
twxs.cmake
webfreak.debug
sunshaoce.RISC-V
rihong.riscv-extension

Additional extensions for Visual Studio Code for Remote Development and Docker Containers:

ms-vscode-remote.remote-ssh
ms-vscode-remote.remote-ssh-edit
ms-vscode.remote-server
ms-vscode-remote.vscode-remote-extensionpack
ms-vscode.remote-explorer

In Visual Studio Code CMake Select a Kit menu select [unspecified] (it will open automaticaly or just use Ctrl+Shift+P and print CMake: Select a Kit)

⁠Docker

⁠Installation (Docker)

⁠Linux (Ubuntu 20.04+)

Install Docker:

sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
sudo apt-get install docker-ce

Install Docker Compose (Optional):

sudo apt-get install docker-compose-plugin

Another variants: Docker Docs⁠ or Digital Ocean⁠

⁠Windows

Install Docker Desktop for Windows (Only for Windows 10/11 and Windows Server 2022): link⁠

⁠Download Docker Image

Pre-build Docker Images with default argumets values located at Docker Hub repository: riscvsystem/riscv_system⁠

For downloading latest Docker Image run the following command in Terminal (Linux) or Docker CLI (Windows) console:

docker pull riscvsystem/riscv_system:latest

⁠Run Docker Container

Run Docker Container riscv_system_docker with image riscvsystem/riscv_system:latest (In detached mode (-d) with allocated pseudo-TTY (-t)). Additionaly bind port 3333 for GDB and OpenOCD (-p 3333:3333) and mount riscv_system directory with code (In this example riscv_system path is /root/riscv_system) to container (path /riscv_system).

It can be done from Terminal (Linux) or Docker CLI (Windows) console with following command:

docker run -d \
           -t \
           -p 3333:3333 \
           -v /root/riscv_system:/riscv_system \
           --name riscv_system_docker \
           riscvsystem/riscv_system:latest

⁠Connect to Docker Container

Connect to riscv_system_docker Docker Container from Terminal (Linux) or Docker CLI (Windows) console:

docker exec -it riscv_system_docker bash