lowRISC / lowRISC/mocha

SPI host DV - Top-level loopback smoke test

Open
#672 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

Implement the chip-level SPI host loopback smoke test (`chip_spi_host_smoke`, testplan V1).

The UVM testbench (`hw/top_chip/dv/tb/tb.sv`) already wires `spi_host_sd_o[0]` (COPI) to `spi_host_sd_i[1]` (CIPO) as a hardware loopback in standard SPI mode, so no SPI agent is required for this test.

Scope:
- SW initialises the SPI host by writing its configuration registers (`CONTROL`, `CONFIGOPTS`, `CSID`) and reads back a configuration register to confirm reachability via `xbar_peri`.
- SW writes a known 32-bit word (e.g. `0xDEADC0DE`), reads one word back over the loopback, and passes if the received value matches.

Notes:
- Registered as `spi_host_smoke` / `spi_host_smoke_cheri` in `hw/top_chip/dv/top_chip_sim_cfg.hjson` (currently placeholder).
- The existing `sw/device/tests/spi_host/sdcard_tests.c` is a separate, unrelated test and is not this smoke; a dedicated minimal loopback smoke SW image is needed.
- Both vanilla and CHERI firmware images should be exercised.

Testpoint: `chip_spi_host_smoke` in `hw/top_chip/data/chip_testplan.hjson`.

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 with hw/top_chip/dv/tb/tb.sv and the placeholder entries in hw/top_chip/dv/top_chip_sim_cfg.hjson, then read the chip_spi_host_smoke testpoint in hw/top_chip/data/chip_testplan.hjson. Add the dedicated minimal loopback smoke firmware rather than reusing sw/device/tests/spi_host/sdcard_tests.c, and verify matching data with both vanilla and CHERI images.

Written by the indexing model from the issue text.

Assessment

Domain
testing
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.