Versioning
Caliptra releases
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.
Caliptra 2.0
Additional Features
- Support ML-DSA Caliptra FW Signature
- Support OCP Recovery
- Support Caliptra Sub-System
- IDevID CSR HMAC Signing
- Crypto Offload Mailbox Services
Compatible Configurations
| RTL | ROM | Runtime FMC/FW |
|---|---|---|
| 2.0.x | 2.0.x | 2.0.x |
Caliptra 1.2
Additional Features
- Manifest-based Authorization
- SET_AUTH_MANIFEST
- AUTHORIZE_AND_STASH
- Deferred retrieval of IDEV CSR**
- GET_IDEVID_CSR
- Self-signed FMC Alias CSR
- GET_FMC_ALIAS_CSR
- DPE export of CDI
- SIGN_WITH_EXPORTED_ECDSA
- REVOKE_EXPORTED_CDI_HANDLE
- DPE max cert size increased to 6kB
** Requires 1.2 ROM
Compatible Configurations
| RTL | ROM | Runtime FMC/FW |
|---|---|---|
| 1.1.x | 1.2.x | 1.2.x |
| 1.1.x | 1.1.x | 1.2.x |
| 1.0.x | 1.0.x | 1.2.x |
Caliptra 1.1
Additional Features
- ECC HW performance enhancements*
- LMS HW acceleration*
- New Runtime commands
- LMS_SIGNATURE_VERIFY
- ADD_SUBJECT_ALT_NAME
- CERTIFY_KEY_EXTENDED
- Expanded PL0 contexts to 16
* Requires 1.1 RTL
Compatible Configurations
| RTL | ROM | Runtime FMC/FW |
|---|---|---|
| 1.1.x | 1.1.x | 1.1.x |
| 1.0.x | 1.0.x | 1.1.x |
Caliptra 1.0
Compatible Configurations
| RTL | ROM | Runtime FMC/FW |
|---|---|---|
| 1.0.x | 1.0.x | 1.0.x |
Development
Development Branches and Release Tags
There are several versions of Caliptra HW and SW collateral, described above. Each `major.minor` version has an associated development branch where release tags point to. The table below summarizes the git repositories and branches used for the development and maintenance of each Caliptra version in the project.
| Mode | Version | Caliptra Core HW Repo | Caliptra Subsystem HW Repo | Caliptra Core SW Repo | Caliptra MCU SW Repo |
|---|---|---|---|---|---|
| Passive | 1.0 | caliptra-rtl:patch_v1.0 | N/A | caliptra-sw:caliptra-1.x | N/A |
| Passive | 1.1 | caliptra-rtl:patch_v1.1 | N/A | caliptra-sw:caliptra-1.x | N/A |
| Passive/Subsystem | 2.0 | caliptra-rtl:patch_v2.0 | caliptra-ss:patch_ss_v1p0 | caliptra-sw:caliptra-2.0 | caliptra-mcu-sw:main |
| Passive/Subsystem | 2.1 | caliptra-rtl:patch_v2.1 | caliptra-ss:patch_ss_v2.1 | caliptra-sw:main | caliptra-mcu-sw:main-2.1 |