Skip to content

[kmac] Specify and implement a dynamic app interface extension#30141

Draft
etterli wants to merge 2 commits into
lowRISC:masterfrom
etterli:otbn-kmac-if-rtl
Draft

[kmac] Specify and implement a dynamic app interface extension#30141
etterli wants to merge 2 commits into
lowRISC:masterfrom
etterli:otbn-kmac-if-rtl

Conversation

@etterli
Copy link
Copy Markdown
Contributor

@etterli etterli commented May 18, 2026

This PR extends the current KMAC application interface so it supports changing the hashing configuration at runtime. The new interface mode is called 'dynamic'. The extension keeps full compatibility with the existing interface behavior, hereinafter referred to as 'static'.

The new interface behavior is described / specified in the hw/ip/kmac/doc/theory_of_operation.md.
The diagrams in the documentation are best viewed by building the documentation locally using:
util/site/build-docs.sh serve
(or if using VS code install the wavedrom and a mermaid extensions).

Note, this PR should not yet be merged, as the changes also directly break the keymgr, keymgr_dpe, rom_ctrl, and lc_ctrl IPs. The reason is that the types app_req_t and app_rsp_t are modified. This PR would also break the DV of kmac and the related IPs.

I will push commits resolving these problems but for now I think it would make sense to start reviewing the specification and core implementation of the interface.

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants