ucbbar/riscv-docker-images

RISC-V开发工具Docker镜像

镜像概述

本Docker镜像集成了构建和运行基于RISC-V的RTL（寄存器传输级）设计与软件项目所需的核心工具，包括RISC-V Tools、Verilator、Yosys和SBT。这些工具的组合为RISC-V相关开发提供了一站式环境，简化了开发流程并确保环境一致性。

核心功能与特性

• 工具集成：预装以下关键开发工具

  • RISC-V Tools：RISC-V架构的核心开发工具链
  • Verilator：开源Verilog/SystemVerilog模拟器和综合工具
  • Yosys：开源硬件综合工具
  • SBT（Scala Build Tool）：用于构建Scala项目的构建工具

• 版本标识：镜像标签遵循固定格式，格式为：RISC-V Tools版本(哈希)-Verilator版本(版本号)-标签号，便于版本管理和追溯。

工具来源

• RISC-V Tools：直接取自GitHub仓库 https://github.com/riscv/riscv-tools
• Verilator：从Verilator官方网站安装 [***]
• Yosys：从Yosys官方网站安装 [***]
• Dockerfile：镜像构建文件托管于ucb-bar GitHub仓库 https://github.com/ucb-bar/riscv-docker-images

使用场景与适用范围

• RISC-V架构的RTL设计开发与验证
• RISC-V软件项目的编译、调试与运行
• RISC-V相关教学、研究和原型验证
• 需要统一开发环境的团队协作场景

使用方法

基本使用流程

1. 拉取镜像
   根据所需版本标签拉取镜像：

   bash
   docker pull ucbbar/riscv-docker-images:<tag>
   

   其中 <tag> 需替换为具体版本标签（如 riscv-tools-hash-verilator-4.216-1）。

2. 运行容器
   启动交互式容器以使用工具链：

   bash
   docker run -it ucbbar/riscv-docker-images:<tag> /bin/bash
   

3. 验证工具
   在容器内执行以下命令验证工具是否正常安装：

   bash
   riscv64-unknown-elf-gcc --version  # 验证RISC-V工具链
   verilator --version                # 验证Verilator
   yosys -V                          # 验证Yosys
   sbt sbtVersion                    # 验证SBT
   

挂载项目目录（可选）

如需在容器内访问本地项目文件，可通过 -v 参数挂载目录：

bash
docker run -it -v /本地项目路径:/容器内路径 ucbbar/riscv-docker-images:<tag> /bin/bash

注意事项

• 镜像标签中的RISC-V Tools版本以Git哈希表示，Verilator版本以版本号表示，标签号用于区分相同工具组合的不同构建版本。
• 如需自定义工具版本或添加额外依赖，可参考GitHub仓库中的Dockerfile进行二次构建。