2020-12-17 21:04:53 +08:00
# Quasar RISC-V Core from Lampro Mellon
## Configuration
### Contents
2020-12-29 19:51:52 +08:00
Name | Description
---------------------- | ------------------------------
quasar.config | Configuration script for core
quasar_config_gen.py | Python wrapper to run quasar.config
2020-12-17 21:04:53 +08:00
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 :
```
./snapshots/< target >
├── common_defines.vh # `defines for testbench
├── defines.h # #defines for C/assembly headers
├── param.vh # Actual Design parameters
├── pdef.vh # Parameter structure definition
├── pd_defines.vh # `defines for physical design
├── perl_configs.pl # Perl %configs hash for scripting
├── pic_map_auto.h # PIC memory map based on configure size
├── whisper.json # JSON file for swerv-iss
└── link.ld # Default linker file for tests
```
While the defines may be modified by hand, it is recommended that this script be used to generate a consistent set.
### Targets
2020-12-29 19:51:52 +08:00
There are 4 predefined target configurations: `default` , `default_ahb` , `typical_pd` and `high_perf` that can be selected via the `-target=name` option to quasar.config.
2020-12-17 21:04:53 +08:00
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
2020-12-29 19:51:52 +08:00
`quasar.config` may be edited to add additional target configurations, or new configurations may be created via the command line `-set` or `-unset` options.
2020-12-17 21:04:53 +08:00
2020-12-29 19:51:52 +08:00
**Run `$RV_ROOT/configs/quasar.config -h` for options and settable parameters.**