Back to Eliza

Linux CPU/AP Boot Evidence Inventory

packages/chip/docs/evidence/cpu/linux/README.md

2.0.12.0 KB
Original Source

Linux CPU/AP Boot Evidence Inventory

Status: local platform contract clear; executable generated-AP Linux boot evidence still blocked.

This directory tracks Linux boot-facing evidence for the selected CPU/AP path. It separates locally checkable platform contracts from transcripts that must come from a real simulator or target run.

Local Gates

Run these from the repository root:

sh
python3 scripts/check_linux_platform_contract.py
python3 scripts/check_linux_memory_platform_contract.py
python3 scripts/capture_cpu_ap_evidence.py dts-audit \
  --path sw/linux/dts/eliza-e1.dts \
  --run-dtc \
  --require-e1-peripherals \
  --require-bootable
python3 scripts/check_linux_hardware_contract_gate.py
python3 scripts/check_chipyard_generated_linux_contract.py

check_linux_platform_contract.py verifies the locally solvable pieces:

  • sw/linux/dts/eliza-e1.dts exposes RV64GC, Sv39, memory, CLINT, PLIC, ns16550 console, and eliza,e1-* MMIO nodes.
  • sw/linux/drivers/e1 binds the DTS compatibles and does not advertise missing timer or interrupt-controller source files.
  • sw/buildroot selects e1-mmio-smoke, and the smoke checks the public Linux driver surface instead of /dev/mem.
  • QEMU and Renode remain reference-only; Chipyard is the generated-AP handoff; CVA6 remains an alternate blocked path.

Remaining Boot Blockers

These cannot be closed by editing repository metadata alone:

  • Generate or import build/chipyard/eliza_rocket/ElizaRocketConfig.manifest.json.
  • Build the generated Chipyard Verilator simulator.
  • Provide an OpenSBI/Linux payload accepted by scripts/locate_chipyard_linux_payload.py.
  • Run scripts/run_chipyard_eliza_linux_smoke.sh on a Linux host/container.
  • Archive real transcripts with scripts/capture_chipyard_linux_evidence.sh all.
  • Re-run python3 scripts/check_cpu_ap_evidence.py --require-evidence.

QEMU virt and Renode logs can validate payload plumbing only. They do not close the e1-chip or generated-AP Linux evidence gates.