From 78b8f909784676c5ec6f02a6c48d51ec2a589f96 Mon Sep 17 00:00:00 2001 From: Arthur Hanson Rasmusson Date: Tue, 29 Sep 2026 16:11:28 -0400 Subject: docs: add the full-system picture and interaction/scheduling diagrams - new 03-architecture/09-full-system-picture.md: end-state map, GSP boot, guest init, RPC lifecycle, memory model, work path (bridge and end state), scheduling, isolation levels, KVM/mdev/VFIO, BAR/engine/channel/GMMU, portability, performance model, implementation/test status - new 03-architecture/10-interaction-and-scheduling.md: interaction inventory, control-plane call path, msgq element lifecycle, channel pump, concurrency, timing budgets, multi-tenant scheduling, teardown ordering, versioning - README: mermaid system diagram replaces the ASCII block; reading list extended and renumbered - component docs: GSP boot sequence, mdev/VFIO lifecycle, end-state interaction sequence; STATE-CURRENT links --- .../03-architecture/08-physical-gpu-integration.md | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'docs/03-architecture/08-physical-gpu-integration.md') diff --git a/docs/03-architecture/08-physical-gpu-integration.md b/docs/03-architecture/08-physical-gpu-integration.md index f156429..06df22b 100644 --- a/docs/03-architecture/08-physical-gpu-integration.md +++ b/docs/03-architecture/08-physical-gpu-integration.md @@ -167,6 +167,33 @@ per-context scheduling. Tenant policy and fairness are a later layer on top. device-ownership lifecycle; the emulation path remains the control plane and is reused. +## 9. Interaction sequence (end state) + +```mermaid +sequenceDiagram + autonumber + participant GD as Guest driver + participant EMU as GSP-RM emulation - control + participant BE as Backend - real GSP client + participant GSP as Real GSP firmware + participant ENG as Engines + + GD->>EMU: objects, vaspaces, channel creation + EMU->>BE: translate to real objects [planned] + BE->>GSP: allocate real objects and channels + GD->>EMU: work submissions + EMU->>BE: decoded and translated push streams + BE->>ENG: submit on real channels + ENG-->>BE: completions and faults + BE->>EMU: relay into guest memory + EMU-->>GD: trackers and events advance +``` + +The full interaction and scheduling view (queues, interrupts, timing classes, +multi-tenant policy) is in +[`10-interaction-and-scheduling.md`](10-interaction-and-scheduling.md); the +system map is in [`09-full-system-picture.md`](09-full-system-picture.md). + ## See also - [`06-host-module-and-hybrid-model.md`](06-host-module-and-hybrid-model.md) - the host module, memory model, build contracts -- cgit v1.2.3