Riescue
Contents:
Getting Started
Install and Setup
Requirements
Sourcing Dependencies
riscv-gnu-toolchain
Whisper ISS
Spike ISS
Installing RiESCUE
Troubleshooting
Developing
Developing
Intro to RiESCUE, RiescueD, and RiescueC
What’s RiESCUE?
RiESCUE Directed Testing Framework -
RiescueD
RiescueD
use cases:
RiESCUE Compliance Testing -
RiescueC
RiescueC
Use Cases:
RiescueD - Getting Started
First RiescueD Test
Prerequisites
Running RiescueD
A Simple Test
Run RiescueD and build the test
Next Steps
Randomizing Data & Addresses
Adding Some Random Data and Addresses
Test Configuration Headers
Random Data Generation
Random Memory Initialization
Randomization with Seeds
Virtual Memory
Setting Up Virtual Memory
Test Configuration Headers
Random Address Generation
Page Mapping Configuration
Memory Initialization
Virtual Memory Test Patterns
Advanced Features
RiescueC - Getting Started
RiescueC Overview
What RiescueC Does
RiescueC Modes
Getting Started
Configuration
Two-Pass Generation
What You Get
Next Steps
Bringup Mode Tutorial
Generating a RV64I Bringup Test
Generating a RV64G Bringup Test
A closer look at the Bringup JSON file
Test Plan Tutorial
Test Plan Overview
Test Plan Architecture
Example Test Plan
Test Plan Structure
Test Execution Planning
CTK - Getting Started
CTK Tutorial
Basic Usage
Test Kit Structure
Advanced Usage
Troubleshooting
Bug Reporting
Next Steps
Configuration & Memory Map Basics
Basic Configuration
Required Settings
Memory Map Structure
Address Format
Using Configuration in Tests
Configuration Templates
Validation and Debugging
Advanced Configuration
User Guide
RiescueD User Guide
What is RiescueD?
Key Features
Getting Started
Basic Workflow
RiescueD Directives Reference
Test Header Directives
Random Data Generation
Random Address Generation
Memory Reservation
Page Table Generation
Memory Initialization
Example Test Structure
Advanced Features
Exception Handling with OS_SETUP_CHECK_EXCP
Page Map Feature
Environment Randomization
Best Practices
Test Organization
Memory Management
Randomization Strategy
Debugging Tips
Common Issues
Debug Output
Performance Considerations
Test Generation Speed
Simulation Performance
Configuration Files
CPU Configuration
Integration with Simulators
Further Resources
Need Help?
RiescueC User Guide
Generating A Vector Test Kit
Prerequisites
Quick Start
Complete Example
Vector Instruction Generation
Next Steps
Reference Documentation
Python API Reference
RiescueD
Command-line Interface
API
RiescueC
RiescueC
FeatMgr
FeatMgr
FeatMgrBuilder
FeatMgrBuilder
CTK
Command-line Interface
API
RiescueD Test File Reference
RiescueD Directives
Test Generation Directives
Exception Types Reference
Macro Reference
Test Headers Reference
Basic Test Configuration
Multiprocessor Configuration
Test Metadata
Extension Configuration
Complete Example
Configuration Reference
Configuration Schema Reference
Required Configuration Elements
Memory Map Components
Feature Configuration
Test Generation Parameters
Complete Configuration Example
Validation Rules
FeatMgr Command Line Interface
Riescue
Index
Index
B
|
C
|
D
|
F
|
G
|
I
|
R
|
S
|
W
B
build() (riescue.FeatMgrBuilder method)
(riescue.RiescueD method)
C
configure() (riescue.Ctk method)
(riescue.RiescueD method)
Ctk (class in riescue)
D
duplicate() (riescue.FeatMgr method)
(riescue.FeatMgrBuilder method)
F
FeatMgr (class in riescue)
FeatMgrBuilder (class in riescue)
G
generate() (riescue.Ctk method)
(riescue.RiescueD method)
get_compiler_march_string() (riescue.FeatMgr method)
get_feature_randomize() (riescue.FeatMgr method)
get_misa_bits() (riescue.FeatMgr method)
get_summary() (riescue.FeatMgr method)
I
is_feature_enabled() (riescue.FeatMgr method)
is_feature_supported() (riescue.FeatMgr method)
R
RiescueC (class in riescue)
RiescueD (class in riescue)
run() (riescue.Ctk method)
(riescue.RiescueD method)
run_bringup() (riescue.RiescueC method)
run_cli() (riescue.RiescueC class method)
run_test_plan() (riescue.RiescueC method)
S
simulate() (riescue.RiescueD method)
W
with_args() (riescue.FeatMgrBuilder method)
with_cpu_json() (riescue.FeatMgrBuilder method)
with_paging_mode() (riescue.FeatMgrBuilder method)
with_priv_mode() (riescue.FeatMgrBuilder method)
with_test_header() (riescue.FeatMgrBuilder method)