lowRISC / lowRISC/mocha

KMAC DV - Chip-level cross-IP tests (entropy-to-KMAC, ROM KMAC-app)

Open
#680 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
SystemVerilog
Stars
38
Forks
21
Avg merge
2d 23h
Merged PRs (30d)
14

Description

Chip-level cross-IP integration paths involving KMAC (TOP_CROSS_IP_PATHS, chip V2). Placeholders registered.

Testpoints:

  • chip_entropy_src_kmac (entropy_src_kmac_test / entropy_src_kmac_test_cheri): SW enables KMAC entropy masking and requests a masked SHA3-256 operation; with the entropy source active, KMAC completes in masked mode and produces the correct digest, confirming the entropy-source-to-KMAC internal routing.
  • chip_kmac_rom_app (kmac_rom_app_test): monitor the KMAC application interface during the ROM integrity check at boot, confirming the ROM controller drives the app request, KMAC computes the digest, and the pass/fail result fed back to rom_ctrl matches expectation.

Note: chip_kmac_rom_app is implicitly exercised on every successful V1 boot (the ROM integrity check uses KMAC), so this testpoint adds explicit monitoring of that path.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the TOP_CROSS_IP_PATHS chip V2 testpoint registrations and locate entropy_src_kmac_test, entropy_src_kmac_test_cheri, and kmac_rom_app_test. Read the existing entropy-source and ROM-integrity test flows first. Done means both paths are explicitly monitored: masked SHA3-256 produces the expected digest, and the ROM KMAC result fed to rom_ctrl matches the expected pass/fail outcome.

Written by the indexing model from the issue text.

Assessment

Domain
cryptography, embedded-iot, testing
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.