Docker for Caliptra RTL Simulation with VCS

This repository provides a Docker-based environment for running Caliptra RTL simulations using Synopsys VCS. It simplifies setup and ensures consistency across different systems.

Features

• CentOS 7.3-based, adding mirrors to avoid yum issues caused by EOL.
• Pre-requisites for VCS
• Pre-built RISC-V toolchain (cross compiler, multilib, zicsr/zifencei extensions)

Pre-requisites

• Set the variables: SYNOPSYS_ROOT, VCS_HOME and SNPSLMD_LIC in Makefile.
• Pull all submodules correctly:

git submodule update --init --recursive
git submodule update --recursive

Working with Docker

make build
make start
make enter
make kill

Caliptra RTL

Caliptra workspace should look like this:

ws/
├── Makefile
├── usr/
│   └── caliptra-rtl # Repo listed below (fork of caliptra-rtl)
├── work/
    └── $(test)_$(sim)/
        └── ...

Caliptra RTL dev repo on branch dev-v2.0 (forked from Caliptra v2.0 stable release).

Run Simulation

Inside the docker container (in ws folder)

make list # Print a list of tests
make test=<test>

eg. tests:

• hello_world_iccm
• hello_world_vcs
• smoke_test_sha256
• smoke_test_veer
• smoke_test_aes_gcm

Key Files

• top RTL: src/riscv_core/veer_el2/rtl/el2_veer_wrapper.sv
• top TB: src/integration/tb/caliptra_top_tb.sv
• SoC IFC: src/soc_ifc/rtl/soc_ifc_top.sv
• Software (c): src/integration/test_suites/${test}
• Include dirs: src/integration/config/caliptra_top_tb.vf

How tests are loaded:

• $(CALIPTRA_ROOT)/tools/scripts/Makefile test=$(test)
• This generates:
  • program.hex - the primary program image
  • iccm.hex - data to preload into the ICCM (Instruction Closely Coupled Memory) inside the core subsystem.
  • dccm.hex - data to preload into the DCCM (Data Closely Coupled Memory).
  • mailbox.hex - contents for the mailbox SRAM.
• Testbench loads them