ppsspp_gpu_stats
Query GPU counters like FPS, vblank rate, and timing to debug PPSSPP emulator performance.
Instructions
PURPOSE: Query GPU counters — fps, vblanks per second, timing info.
USAGE: session_id. The CPU must be RUNNING; paused, the MCP pre-probe returns CPU_STATE_ERROR instead of hanging — which doubles as the cheapest paused-CPU probe.
BEHAVIOR: READ-ONLY.
ON TIMEOUT: the error names WHY it timed out -- expected_stall (the CPU was stepping, so no frame is coming), pairing_broken (a broadcast arrived meanwhile, so ticket pairing failed), or no_producer (nothing was broadcast at all, so the emulator is not producing frames -- check for a modal dialog blocking it). A CPU_FREEZE_SUSPECTED is re-checked against the frame heartbeat first: if no frames are arriving it is reported as WS_TIMEOUT with a no-producer attribution, NOT as a CPU freeze.
RETURNS: {fps, vblanks_per_second, info, timing, raw, text}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | Active session ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | Yes | Frames per second. None if PPSSPP didn't return it (e.g., no game running, or response shape differs). | |
| raw | Yes | Raw `gpu.stats.get` response from PPSSPP. | |
| info | Yes | GPU info dict (vendor / name / version, etc.). | |
| text | Yes | Unified text representation: 'fps={FPS} vblanks={VBLANKS} info_keys={N} timing_keys={N}'. | |
| timing | Yes | GPU timing dict (frame / block / vertex timing, etc.). | |
| vblanks_per_second | Yes | VBlanks per second. None if PPSSPP didn't return it. |