Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/workflow_metadata/pr_hash
Original file line number Diff line number Diff line change
@@ -1 +1 @@
033d5c0fa02fb8f8aade6a526aa25077e921c84cb0181779e6c80a6a9f20d482fe798efbc00b4ea46bd3d0c35f7798d0
7af545b1a3da5069f1806a381ea72c4a11b7e0ccfd1d2c27019d94dc709c5fd48723d4c36da8a2786847f1cc56845c49
2 changes: 1 addition & 1 deletion .github/workflow_metadata/pr_timestamp
Original file line number Diff line number Diff line change
@@ -1 +1 @@
1756064170
1756163149
2 changes: 2 additions & 0 deletions docs/CaliptraSSIntegrationSpecification.md
Original file line number Diff line number Diff line change
Expand Up @@ -1256,6 +1256,8 @@ See [Life-cycle Controller Register Map](../src/lc_ctrl/rtl/lc_ctrl.rdl).

To protect from clock stretching attacks Caliptra mandates using a clock source that is constructed within the SOC (eg. PLL, Calibrated Ring Oscillator, etc). For such a clock source, a SOC may require fuses to be programmed. TP programming demands a reliable and deterministic clock signal to ensure correct fuse write operations; which SOC may not have during the early phases of manufacturing flow due to above constraints. In order to overcome this issue, this `external clock` can be used typically in the manufacturing phase of a SOC; and for such SOCs this external clock is supplied from a platform (e.g an ATE). Since the Caliptra subsystem includes only one clock input (`cptra_ss_clk_i`), the SoC integrator is responsible for ensuring that this input can be switched to a stable source.

The Life-cycle Controller requires a token to execute conditional state transitions. All tokens reside within a single partition, which the integrator can lock only once. Therefore, if any required tokens are not programmed before the partition is locked, they will remain at their default value of 0 and cannot be updated afterward.

3. **Scan Path Exclusions**:
- Ensure that the RAW\_UNLOCK token is excluded from the scan chain. This token is different from other LC transition tokens as it is stored in the in gates but in a hashed form as other tokens. It is recommended to exclude since it is not provisioned through fuse macro as other tokens.
To exclude it from scan, the following hierarchies must be excluded: `*::lc_ctrl_fsm::hashed_tokens_{higher, lower}[RawUnlockTokenIdx]` and `*::lc_ctrl_fsm::hashed_token_mux`.
Expand Down
1 change: 0 additions & 1 deletion src/axi2tlul/config/axi2tlul.vf
Original file line number Diff line number Diff line change
Expand Up @@ -89,5 +89,4 @@ ${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/caliptra_prim/rtl/caliptra_prim
${CALIPTRA_SS_ROOT}/src/axi2tlul/rtl/axi2tlul_cmd_intg_gen.sv
${CALIPTRA_SS_ROOT}/src/axi2tlul/rtl/sub2tlul.sv
${CALIPTRA_SS_ROOT}/src/axi2tlul/rtl/axi2tlul.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/tlul/rtl/tlul_pkg.sv
2 changes: 0 additions & 2 deletions src/axi_mem/config/axi_mem_pkg.vf
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
+incdir+${CALIPTRA_SS_ROOT}/src/axi_mem/rtl
+incdir+${CALIPTRA_SS_ROOT}/src/axi_mem/testbench
${CALIPTRA_SS_ROOT}/src/axi_mem/rtl/axi_mem_if.sv
${CALIPTRA_SS_ROOT}/src/axi_mem/rtl/axi_mem.sv
${CALIPTRA_SS_ROOT}/src/axi_mem/testbench/rom.sv
1 change: 0 additions & 1 deletion src/dmi/config/dm_pkg.vf
Original file line number Diff line number Diff line change
Expand Up @@ -29,5 +29,4 @@ ${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/caliptra_prim/rtl/caliptra_prim
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/caliptra_prim/rtl/caliptra_prim_count_pkg.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/caliptra_prim/rtl/keymgr_pkg.sv
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dm_pkg.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dm_pkg.sv
1 change: 0 additions & 1 deletion src/dmi/config/dmi_jtag.vf
Original file line number Diff line number Diff line change
Expand Up @@ -32,5 +32,4 @@ ${CALIPTRA_SS_ROOT}/src/dmi/rtl/dm_pkg.sv
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dmi_jtag_tap.sv
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dmi_cdc.sv
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dmi_jtag.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/dmi/rtl/dm_pkg.sv
1 change: 0 additions & 1 deletion src/fuse_ctrl/config/fuse_ctrl.vf
Original file line number Diff line number Diff line change
Expand Up @@ -196,5 +196,4 @@ ${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_part_buf.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_part_unbuf.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_scrmbl.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/libs/rtl/caliptra_ss_prim_assert_sec_cm.svh
1 change: 0 additions & 1 deletion src/fuse_ctrl/config/fuse_ctrl_pkg.vf
Original file line number Diff line number Diff line change
Expand Up @@ -111,5 +111,4 @@ ${CALIPTRA_SS_ROOT}/src/ast/rtl/ast_pkg.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_reg_pkg.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_pkg.sv
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_part_pkg.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/fuse_ctrl/rtl/otp_ctrl_part_pkg.sv
1 change: 0 additions & 1 deletion src/i3c_core/config/i3c_core.vf
Original file line number Diff line number Diff line change
Expand Up @@ -96,5 +96,4 @@ ${CALIPTRA_SS_ROOT}/src/i3c_core/../../third_party/i3c-core/src/ctrl/controller.
${CALIPTRA_SS_ROOT}/src/i3c_core/../../third_party/i3c-core/src/ctrl/stable_high_detector.sv
${CALIPTRA_SS_ROOT}/src/i3c_core/../../third_party/i3c-core/src/i3c.sv
${CALIPTRA_SS_ROOT}/src/i3c_core/../../third_party/i3c-core/src/i3c_wrapper.sv
${CALIPTRA_SS_ROOT}/third_party/caliptra-rtl/src/integration/rtl/caliptra_reg_defines.svh
${CALIPTRA_SS_ROOT}/src/i3c_core/../../third_party/i3c-core/src/i3c_defines.svh
Loading