How riscv-software-src/riscv-unified-db works
Main Components
• Core Database Layer
• IDL (Interface Definition Language) Compiler
• Multiple Backend Generators
• Configuration Management System
• Schema Validation Layer
Component Details and Relationships
a. Core Database Layer
• Represents the central repository of RISC-V specifications
• Contains extensions, instructions, CSRs, and documentation
• To: Schema Validation Layer, Backend Generators
b. IDL Compiler
• Processes formal specifications
• Handles AST generation and symbol tables
• To: Core Database Layer, Backend Generators
c. Backend Generators
• HTML Documentation Generator
• PDF Generator
• Configuration-specific Generator
• Extension Documentation Generator
• To: Core Database Layer, Configuration Management
d. Configuration Management System
• Handles different RISC-V configurations
• Manages implementation-specific options
• To: Core Database Layer, Backend Generators
e. Schema Validation Layer
• Validates YAML specifications
• Ensures data integrity
• To: Core Database Layer
Data Flow Representation
• Input flow: Raw specifications → Schema Validation → Core Database
• Processing flow: Core Database → IDL Compiler → Backend Generators
• Output flow: Backend Generators → Generated Artifacts
Key Integration Points
• Configuration Management ↔ Backend Generators
• Core Database ↔ IDL Compiler
• Schema Validation ↔ Core Database
Additional Elements
• Input Sources (YAML files, IDL specifications)
• Output Artifacts (HTML docs, PDFs, ISA manuals)
• External Tools Integration points
Implementation Notes
Annotations for:
• Ruby-based implementation
• Container-based deployment options
• YAML/JSON schema validation
• Antora documentation integration
• Clear hierarchical layout
• Proper component relationships
• Consistent styling
• Exportable formats