Skip to content

README: add Subsystem as independently versioned component in 2.x compatibility tables #685

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 7 commits into
base: main
Choose a base branch
from
+15 −8
Open

README: add Subsystem as independently versioned component in 2.x compatibility tables #685

Changes from 4 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
257b9bc
README: add Subsystem to versioned components list and version tables
Copilot May 13, 2026
cf46b87
README: update Subsystem RTL versions to 2.0.2+ and 2.1.2+
Copilot May 13, 2026
299dcaf
Fix formatting and wording in versioning section
calebofearth May 13, 2026
948f740
README: enforce Core RTL 2.0.4+ and 2.1.2+ with security notes
Copilot May 13, 2026
0756467
Docs: add checklist requirement for versioning matrix compliant RTL r…
Copilot May 14, 2026
d39edd4
Update evaluation methodology for RTL release compliance
calebofearth May 14, 2026
281d80a
Merge remote-tracking branch 'origin/main' into copilot/update-readme…
calebofearth May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 12 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ sets out the charter governing the Caliptra project.

## Versioning

Caliptra is released in independently versioned components: RTL, ROM, FMC and Runtime FW. They are all represented by 3 values: major.minor.patch (such as 1.0.2). The first 2 values, major.minor, correspond to a set of features caliptra supports. The patch value is incremented as new releases are made with bug fixes. Lastly, mutable firmware (FMC/FW) have security version numbers (SVNs) that are incremented as required by when addressing security-critical issues. These are specified with the label (svn/svn) for (FMC/FW) versions respectively.
Caliptra is released in independently versioned components: Core RTL, Subsystem RTL, ROM, FMC, Runtime FW. They are all represented by 3 values: major.minor.patch (such as 1.0.2). The first 2 values, major.minor, correspond to a set of features caliptra supports. The patch value is incremented as new releases are made with bug fixes. Lastly, mutable firmware (FMC/FW) have security version numbers (SVNs) that are incremented as required by when addressing security-critical issues. These are specified with the label (svn/svn) for (FMC/FW) versions respectively.

Not all components necessarily need to be of the same major.minor version to be compatible. Details are below:

Expand Down Expand Up @@ -118,13 +118,14 @@ Additional Features
- IDevID CSR HMAC Signing
- Crypto Offload Mailbox Services

\*\*\* Only RTL release versions 2.0.2+ should be used due to ROM compatibility requirements.
\*\*\* Integrators must use Caliptra Core RTL release versions 2.0.4+ for security hardening.

Compatible Configurations:

| RTL | ROM | Runtime FMC/FW |
| --- | --- | --- |
| 2.0.2+ | 2.0.x | 2.0.x (0/0) |
| Configuration | RTL | ROM | Runtime FMC/FW |
| --- | --- | --- | --- |
| Core | 2.0.4+ | 2.0.x | 2.0.x (0/0) |
| Subsystem | 2.0.2+ | 2.0.x | 2.0.x (0/0) |

### Caliptra 2.1

Expand All @@ -135,11 +136,14 @@ Additional Features
- Support for AES DMA mode
- Caliptra Core mailbox size reduced to 16 KiB in subsystem mode

\*\*\* Integrators must use Caliptra Core RTL release versions 2.1.2+ for security hardening.

Compatible Configurations:

| RTL | ROM | Runtime FMC/FW |
| --- | --- | --- |
| 2.1.x | 2.1.x | 2.1.x (0/0) |
| Configuration | RTL | ROM | Runtime FMC/FW |
| --- | --- | --- | --- |
| Core | 2.1.2+ | 2.1.x | 2.1.x (0/0) |
| Subsystem | 2.1.2+ | 2.1.x | 2.1.x (0/0) |


## Test Dashboards
Expand Down