How chipsalliance/caliptra-sw works
Main Components
a. Hardware Layer
• RISC-V CPU Core
• ROM (Read-Only Memory)
• Hardware Peripherals (from /hw/1.0/registers)
• FPGA Implementation
• Verilator Simulation Environment
b. Firmware Layer
• ROM Module (First executed code)
• FMC (First Mutable Code)
• Runtime Environment
• Drivers Layer
c. Software Layer
• libcaliptra (C-API Interface)
• Test Harness
• Build Tools
• Simulation/Emulation Tools
Key Relationships
a. Boot Flow
ROM -> FMC -> Runtime
b. Hardware Access Path
Firmware -> Drivers -> Hardware Peripherals
c. External Interface
Host System -> libcaliptra -> Mailbox Interface -> Caliptra
Architectural Patterns
• External Host |
• ↕
• libcaliptra API |
• ↕
• Mailbox Interface |
• ↕
• Runtime Module |
• ↕
• FMC Module |
• ↕
• ROM Module |
• ↕
• Hardware Layer |
Component Interactions
• Hardware peripherals and drivers
• Mailbox interface and external host
• Test infrastructure and various layers
Additional Elements
• Build system components
• CI/CD infrastructure
• Test frameworks
• Documentation generation
Remember to emphasize:
Test/verification points
This will create a comprehensive view of the Caliptra system while maintaining clarity about its security-focused nature and complex testing infrastructure.