PicoRV32 Toolchain Build Environment

This repository provides a Docker-based environment to build the RISC-V toolchain for the PicoRV32 CPU.

Prerequisites

• Docker and Docker Compose installed on your host machine.

Automated Build (Recommended)

The easiest way to build the toolchain and export binaries to your host is using Docker Compose. This automatically handles the image build, bind mounts, and the compilation sequence.

# This will build the environment and run the compilation process
docker compose up --build

The binaries will be installed into the toolchains/ directory on your host machine (e.g., toolchains/riscv32i/bin/...).

Logging

The build process captures all output to dated log files in the toolchains/ directory (e.g., toolchain_build_log_YYYYMMDD_HHMMSS.log) to prevent TTY bottlenecks and preserve build history.

Manual Build (Interactive)

If you prefer to run the build steps manually:

1. Build the image:

   docker build -t picorv32-env .

2. Run the container with the output mount:

   mkdir -p toolchains
   docker run -it --rm -v $(pwd)/toolchains:/opt picorv32-env

3. Execute build commands inside the container:

   make download-tools
   printf 'YES\n' | make -j$(nproc) build-tools

Pre-built Releases

Pre-compiled toolchain binaries are automatically published as GitHub Releases on every push to main. You can download the picorv32-toolchain.tar.gz package from the Releases page and extract it in your environment into /opt or your preferred directory.

---

Copyright Notice

P38 heterogeneous multi-tiled system with support for message queues (MoSAIC) Copyright (c) 2024, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.

If you have questions about your rights to use or distribute this software, please contact Berkeley Lab's Intellectual Property Office at IPO@lbl.gov.

NOTICE. This Software was developed under funding from the U.S. Department of Energy and the U.S. Government consequently retains certain rights. As such, the U.S. Government has been granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the Software to reproduce, distribute copies to the public, prepare derivative works, and perform publicly and display publicly, and to permit others to do so.