Skip to content

[v1p0,RTL] Make lc_ctrl RAW unlock token a caliptra_ss_top input signal#785

Merged
ekarabu merged 7 commits intopatch_ss_v1p0from
lowrisc_ss_v1p0_raw_unlock_token
Oct 8, 2025
Merged

[v1p0,RTL] Make lc_ctrl RAW unlock token a caliptra_ss_top input signal#785
ekarabu merged 7 commits intopatch_ss_v1p0from
lowrisc_ss_v1p0_raw_unlock_token

Conversation

@andreaskurth
Copy link
Contributor

Before this change, lc_ctrl's RAW unlock token was defined in
lc_ctrl_state_pkg, which lives in the caliptra-rtl submodule
repository. This is problematic as integrators need to be able to
change the RAW unlock token but should not change the caliptra-rtl
repository.

This change makes the (hashed) RAW unlock token an input signal of
caliptra_ss_top and propagates the signal down to lc_ctrl.
Integrators can thus simply define the value of the RAW unlock token by
assigning a signal (which can be driven by a constant) to
caliptra_ss_top's cptra_ss_raw_unlock_token_hashed_i input.

This contributes to resolving Issue #784.

This is required so that CI doesn't fail for the next two commits.
@andreaskurth andreaskurth marked this pull request as ready for review October 2, 2025 18:11
@ekarabu
Copy link
Collaborator

ekarabu commented Oct 3, 2025

Fails the promote-pipeline: FILE LIST CHECK CALIPTRA SUBSYSTEM
With this setting:

run_clp_github_val_flow : "False"
run_abr_github_val_flow : "False"
run_clp_ss_github_val_flow : "true"
bypass_ado_branch_val : "False"
github_branch_name : "lowrisc_ss_v1p0_raw_unlock_token"
github_dest_name : "patch_ss_v1p0"
abr_dut_name : "abr_top"

@andreaskurth andreaskurth force-pushed the lowrisc_ss_v1p0_raw_unlock_token branch from 4b1a90a to 91626cc Compare October 6, 2025 08:55
Before this change, lc_ctrl's RAW unlock token was defined in
`lc_ctrl_state_pkg`, which lives in the `caliptra-rtl` submodule
repository.  This is problematic as integrators need to be able to
change the RAW unlock token but should not change the `caliptra-rtl`
repository.

This change makes the (hashed) RAW unlock token an input signal of
`caliptra_ss_top` and propagates the signal down to `lc_ctrl`.
Integrators can thus simply define the value of the RAW unlock token by
assigning a signal (which can be driven by a constant) to
`caliptra_ss_top`'s `cptra_ss_raw_unlock_token_hashed_i` input.
This hashed and the unhashed RAW unlock token were generated with
`tools/scripts/lc_ctrl_script/gen_lc_ctrl_token.py`.
@andreaskurth andreaskurth force-pushed the lowrisc_ss_v1p0_raw_unlock_token branch from 91626cc to 7bc5e0e Compare October 6, 2025 09:22
…' with updated timestamp and hash after successful run
@andreaskurth
Copy link
Contributor Author

Fixed; the promote pipeline has passed. I've also cherry-picked commits from #792 to validate the token change flow and update the HW spec and integration guidelines.

@ekarabu ekarabu merged commit b8ba810 into patch_ss_v1p0 Oct 8, 2025
7 checks passed
@ekarabu ekarabu deleted the lowrisc_ss_v1p0_raw_unlock_token branch October 8, 2025 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants