2c883e9d5e
Handoff snapshot of the env-gated diagnostic scaffolding used across the intro-video RE. Kept out of the milestone commits (645feb8..5573ac1) to keep those clean; committed here so nothing is lost on handoff. New — XENIA_PROFILE wall-time profiler (crates/xenia-gpu/src/prof.rs): Coarse buckets attributing playback wall time to interpreter (step_block), kernel HLE (call_export), block decode/cache (lookup_or_build), texture decode, host draw, and present; prints periodic snapshots (every 500M guest instr, or every 500 presents) + a clean-exit report. Hot path is gated on a cached is_on() (one relaxed load) so it is zero-cost when XENIA_PROFILE is unset. Call sites: main.rs run_superblock / parallel worker (step_block, lookup_or_build, call_export), texture_cache ensure_cached, render.rs present + dispatch_xenos_draws. First profile (movie playback, headless single-thread lockstep): effective ~35 MIPS; interpreter body ~40% @ ~95-102 MIPS; texture decode 0.3% (cache works); present ~0%; the rest is per-block dispatch + scheduler plumbing (~13 instr/block over 229M blocks). Overhead-bound, not interpreter-body bound; the levers are coarser execution units (superblock chaining) and ultimately a JIT. Pre-existing read-only probe knobs (were uncommitted; env-gated, observe-only): XENIA_RET_CAPTURE_PC/_REG/_MEM, LOG_RESUMES, LOG_WAITS, LOG_SIGNAL, FORCE_TID, STARVE_LIMIT, INCUMBENT_PICK, INSTR_PER_MS, DUMP_FRAME, DUMP_WGSL, BIND_LOG, CONST_LOG, DISPATCH_REC, AUDIT_PC_TRACE. Tooling: sylph-run.sh (movie oracle loop, 180s default timeout), zq.py (DuckDB disasm/xref helper). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
52 lines
1.6 KiB
Rust
52 lines
1.6 KiB
Rust
//! Xenos GPU emulation for xenia-rs.
|
|
//!
|
|
//! Modules:
|
|
//! - [`pm4`]: packet format decoder + Type-3 opcode set.
|
|
//! - [`ring_view`]: ring-buffer bookkeeping (base/size/read/write pointers).
|
|
//! - [`register_file`]: 0x6000-entry register array backing the CP + state.
|
|
//! - [`gpu_system`]: top-level `GpuSystem` + PM4 executor running one packet
|
|
//! per call (see the plan's P2 for the design rationale).
|
|
//!
|
|
//! Legacy module `ring_drain` and `command_processor` are retained while P3+
|
|
//! migrations finish; they will be removed once every caller is on
|
|
//! [`gpu_system::GpuSystem`].
|
|
|
|
pub mod command_processor;
|
|
pub mod draw_capture;
|
|
pub mod draw_state;
|
|
pub mod edram;
|
|
pub mod gpu_system;
|
|
pub mod handle;
|
|
pub mod mmio_region;
|
|
pub mod pm4;
|
|
pub mod primitive;
|
|
pub mod prof;
|
|
pub mod register_file;
|
|
pub mod ring_drain;
|
|
pub mod ring_view;
|
|
pub mod render_target_cache;
|
|
pub mod resolve;
|
|
pub mod shader_metrics;
|
|
pub mod shaders;
|
|
pub mod texture_cache;
|
|
pub mod tiled_address;
|
|
pub mod translator;
|
|
pub mod ucode;
|
|
pub mod xenos_constants;
|
|
|
|
pub use gpu_system::{
|
|
ExecOutcome, GpuBlock, GpuMmio, GpuStats, GpuSystem, InterruptSource, PendingInterrupt,
|
|
PHYSICAL_BACKING_BASE, ShaderBlob, SwapNotification, WaitCmp, physical_to_backing,
|
|
};
|
|
pub use handle::{
|
|
DrainReply, GpuBackend, GpuCommand, GpuDigestSnapshot, GpuHandle, GpuWorker,
|
|
shutdown_and_join_with_timeout, spawn_gpu_worker, spawn_noop_worker,
|
|
};
|
|
pub use mmio_region::build_region as build_mmio_region;
|
|
pub use pm4::{
|
|
PacketHeader, PacketKind, PM4_INTERRUPT, PM4_NOP, PM4_XE_SWAP, SWAP_SIGNATURE,
|
|
type3_opcode_name,
|
|
};
|
|
pub use ring_drain::{DrainResult, drain};
|
|
pub use ring_view::RingBufferView;
|