# BIOS Documentation

This folder contains repository-level documentation for the recovered Lenovo
HR650X / Intel Purley AMI UEFI BIOS tree.

## Start Here

- [Firmware Overview](firmware_overview.md) - high-level platform, package, and
  subsystem orientation.
- [Boot and Runtime Lifecycle](boot_and_runtime_lifecycle.md) - phase-by-phase
  behavioural flow from PEI through DXE, SMM, setup, OS handoff, and runtime.
- [Subsystem Behaviour Map](subsystem_behaviour_map.md) - navigation map from
  externally visible behaviours to recovered module evidence.

## Layout Evidence

- [Original Source Layout Recovery](original_layout_recovery.md) - recovered
  package/source-path grouping from debug/assert/PDB/source-path evidence.
- [Original Layout Evidence](original_layout_evidence.json) - machine-readable
  evidence generated by `tools/recover_original_layout.py`.

These docs describe recovered firmware evidence, not pristine vendor source.
Where behaviour is uncertain, prefer the module `.c`, `.h`, `.md`, and README
files as the authoritative local evidence.