AnyPS5/docs/dev/debt/libSceHmd.md

libSceHmd technical debt

Silent stubs

• libSceHmd implements only the disconnected-headset path: initialization succeeds, device queries report NotDetected, and opening a device returns DeviceDisconnected. Headset support, tracking, rendering and additional HMD exports are not implemented; SDK-level ABI compatibility and in-game behaviour remain unverified.

Unknown function info

• libSceHmd internal and capture exports - input/output directions and argument registers are recovered for shared VR2D data, device binding, optical and serial queries, screen status and capture operations. VR2D records are 128 bytes, optical output 16, serial output 16, PU position output 20, crash-dump output 68, audio/video status 32, and reprojection debug outputs 216 or 1136. Payload field meanings and capture callback contracts remain incomplete; these structures use forward declarations.

• libSceHmd queries without a headset (libSceHmd) - the signatures, the distortion work memory (0x20000, aligned to 0x400) and reprojection buffer sizes (garlic 0x100000, onion 0x810, both aligned to 0x100), and the results of sceHmdGetFieldOfView, sceHmdGet2DEyeOffset, sceHmdGetInertialSensorData (HANDLE_INVALID once initialized; field of view checks its output for null first) and sceHmdGetAssyError (null output, then DEVICE_DISCONNECTED once initialized) follow shadPS4 (PS4) with no headset, not a PS5 measurement. Before initialization sceHmdGetFieldOfView returns NOT_INITIALIZED for a non-null output, where shadPS4 checks the handle first and returns HANDLE_INVALID. The third argument of sceHmdGetInertialSensorData is unnamed there and taken as a count

• sceHmdDistortionGetCompoundEyeCorrectionCommand returns a constant error without consuming arguments in the supplied module; unused argument types remain unresolved.

• sceHmdInternalGetDefaultLedData takes an unused handle, a 32-bit mask output and a nine-byte LED output. Output sizes match the paired setter; mask bits and LED payload semantics remain unresolved. The protected body is unchanged.

Device, field-of-view, assembly-error, distortion, sensor and DFU query signatures are recovered from native register use. Field of view and assembly errors each output four floats; device information occupies 64 bytes and distortion output spans 76 bytes. The remaining device/sensor/report field semantics and DFU status bit meanings are unresolved. Assembly confirms integer error returns where decompilation incorrectly inferred void. Protected bodies are unchanged.

Reprojection initialization and display-buffer signatures are recovered: initialization takes a parameter pointer, 32-bit mode and null reserved pointer; display-buffer setup takes a VideoOut handle, two buffer indices and reserved pointer, while adding a buffer takes an index and reserved pointer. Parameter fields remain incomplete. Protected bodies are unchanged.

Work-memory queries, capture start, separate-mode open and crash-report cancellation consume no arguments in the supplied native implementation. The mirroring aspect debug setter takes five 16-bit values followed by a byte mode; the individual scalar meanings remain unresolved. These argument lists are confirmed; protected bodies remain unimplemented.

Reprojection start signatures are recovered, including the five arguments of StartMultilayer2 hidden by an incomplete decompilation. Standard and wide-near starts take frame parameters, pose, 64-bit flip argument and reserved pointer; overlay variants add an overlay descriptor. The 2D variant takes parameters, flip argument and reserved pointer. Multilayer takes a layer array/count, submission parameters, pose, flip argument and reserved pointer. Frame, pose, overlay and submission field semantics remain incomplete. Protected bodies are unchanged.

Distortion and 2D VR command queries take a 32-bit HMD handle, input descriptor and command-buffer output. The output contains a command pointer at offset zero and a 32-bit dword count at offset eight. Descriptor fields and GPU resource types remain incomplete; the standard, wide-near and 2D descriptors are distinct. Protected bodies are unchanged.

The ELF export table aliases the Distortion correction/2D command and work-memory queries to their corresponding HMD queries, confirming identical signatures. Distortion initialization consumes only a work-memory pointer. No shader code or calibration constants are copied; protected bodies remain unchanged.