cosim-gpu documentation

cosim-gpu runs a real Linux guest in QEMU and a performance model of the AMD MI300X GPU in gem5; the two cooperate through vfio-user and shared memory. Chinese is the primary language and this English tree is kept in sync.

Getting Started

From environment setup and builds to the first co-simulation.

Getting Started
Architecture

Components, execution flow, memory model and the vfio-user interface.

Architecture overview
Cosim Launcher

CLI, YAML pipeline, session lifecycle and extension points of the Rust launcher.

Cosim Launcher
QEMU and gem5

QEMU as vhost and functional device model; gem5 as the performance simulator.

QEMU and gem5
Topology and hardware support

Single/multi-machine topologies, the machine catalog, hosts and devices.

Topology and hardware support
Reference and contributing

Schemas, parameters, versions and known issues; contribution workflow.

Reference