riscvsystem/riscv_system

RISC-V GNU工具链、OpenOCD与FreeRTOS模板镜像

镜像概述

本Docker镜像提供了RISC-V开发所需的完整工具链与环境，集成GNU工具链、OpenOCD调试工具及FreeRTOS模板，支持在Visual Studio Code中快速开展RISC-V嵌入式项目开发。

核心功能

1. 集成RISC-V GNU工具链，实现RISC-V程序的编译、链接与调试
2. 包含RISC-V OpenOCD，支持硬件调试接口（如JTAG）
3. 内置FreeRTOS模板，简化实时操作系统应用开发
4. 推荐Visual Studio Code扩展列表，优化开发流程与体验

使用场景

• RISC-V架构嵌入式项目的开发与调试
• FreeRTOS在RISC-V平台的应用开发与验证
• 学习RISC-V架构及嵌入式系统开发的实验环境

配置说明

Visual Studio Code配置

1. 安装Visual Studio Code：https://code.visualstudio.com/download
2. 安装必需扩展（可通过VS 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
3. 远程开发扩展（可选）：
   • 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
4. CMake配置：按下Ctrl+Shift+P打开命令面板，执行CMake: Select a Kit并选择[unspecified]

Docker部署步骤

Linux（Ubuntu 20.04+）安装Docker

bash
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

安装Docker Compose（可选）：

bash
sudo apt-get install docker-compose-plugin

Windows安装Docker

安装Docker Desktop for Windows（仅支持Windows 10/11及Windows Server 2022）：https://www.docker.com/products/docker-desktop/

拉取镜像

bash
docker pull riscvsystem/riscv_system:latest

运行容器

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

说明：该命令以 detached 模式运行容器，映射3333端口用于GDB和OpenOCD通信，挂载本地/root/riscv_system目录到容器内/riscv_system路径（需替换为实际本地路径）。

连接容器

bash
docker exec -it riscv_system_docker bash