cores-swerv-el2/configs/README.md

SweRV RISC-V EL2 core from Western Digital

Configuration

Contents

Name	Description
swerv.config	Configuration script for SweRV-EL2

This script will generate a consistent set of defines/#defines/parameters needed for the design and testbench.
A perl hash (perl_configs.pl) and a JSON format for SweRV-iss are also generated. This set of include files :

$RV_ROOT/configs/snapshots/<target>
├── common_defines.vh                       # `defines for testbench
├── defines.h                               # #defines for C/assembly headers
├── el2_param.vh                            # Actual Design parameters
├── el2_pdef.vh                             # Parameter structure definition
├── pd_defines.vh                           # `defines for physical design
├── perl_configs.pl                         # Perl %configs hash for scripting
├── el2_pic_ctrl_verilator_unroll.sv        # Unrolled verilog based on PIC size (for verilator only)
├── pic_map_auto.h                          # PIC memory map based on configure size
└── whisper.json                            # JSON file for swerv-iss

While the defines may be modified by hand, it is recommended that this script be used to generate a consistent set.

Targets

There are 4 predefined target configurations: default, default_ahb, typical_pd and high_perf that can be selected via the -target=name option to swerv.config.

Target	Description
default	Default configuration. AXI4 bus interface.
default_ahb	Default configuration, AHB-Lite bus interface
typical_pd	No ICCM, AXI4 bus interface
high_perf	Large BTB/BHT, AXI4 interface

swerv.config may be edited to add additional target configurations, or new configurations may be created via the command line -set or -unset options.