__TOC__
GSP service “gsp::Gpu” #
| Command Header | Available since system version | GSP rights required | Description |
|---|---|---|---|
| 0x00010082 | Yes | WriteHWRegs | |
| 0x00020084 | Yes | WriteHWRegsWithMask | |
| 0x00030082 | Yes | WriteHWRegRepeat | |
| 0x00040080 | Yes | ReadHWRegs | |
| 0x00050200 | Yes | SetBufferSwap | |
| 0x00060082 | No | SetCommandList (Stubbed) | |
| 0x000700C2 | No | RequestDma (Stubbed) | |
| 0x00080082 | No | FlushDataCache | |
| 0x00090082 | No | InvalidateDataCache | |
| 0x000A0044 | No | RegisterInterruptEvents (Stubbed) | |
| 0x000B0040 | Usually not (see below) | SetLcdForceBlack | |
| 0x000C0000 | No | TriggerCmdReqQueue | |
| 0x000D0140 | No | SetDisplayTransfer | |
| 0x000E0180 | No | SetTextureCopy | |
| 0x000F0200 | No | SetMemoryFill | |
| 0x00100040 | No | SetAxiConfigQoSMode | |
| 0x00110040 | No | SetPerfLogMode | |
| 0x00120000 | No | GetPerfLog | |
| 0x00130042 | No | RegisterInterruptRelayQueue | |
| 0x00140000 | No | UnregisterInterruptRelayQueue | |
| 0x00150002 | No | TryAcquireRight | |
| 0x00160042 | No | AcquireRight | |
| 0x00170000 | No | ReleaseRight | |
| 0x00180000 | No | ImportDisplayCaptureInfo | |
| 0x00190000 | See below | SaveVramSysArea | |
| 0x001A0000 | See below | RestoreVramSysArea | |
| 0x001B0000 | Yes | ResetGpuCore | |
| 0x001C0040 | No | SetLedForceOff | |
| 0x001D0040 | No | SetTestCommand (Stubbed) | |
| 0x001E0080 | No | SetInternalPriorities | |
| 0x001F0082 | 8.0.0-18 | No | StoreDataCache |
The GSP module starts a thread for handling commands for each service session, a maximum of 4 processes can use this service at once. Official applications have an optional code-path which writes to registers during initialization, this is normally not used however.
If a process has forcefully acquired rights (ErrDisp), attempting unset LCDs black-fill from another process will fail. Saving/restoring VRAM requires bit0 of process flags to be set.
GSP service “gsp::Lcd” #
| Command Header | Available since system version | Description |
|---|---|---|
| 0x00010040 | EnableABL | |
| 0x00020040 | DisableABL | |
| 0x00030080 | SetRSLut | |
| 0x000400C0 | SetRSParams | |
| 0x00050140 | SetABLArea | |
| 0x00060140 | ? | |
| 0x00070080 | SetInertia | |
| 0x000800C0 | SetDitherMode | |
| 0x00090140 | SetDitherParams | |
| 0x000A0080 | SetBrightnessRaw | |
| 0x000B0080 | SetBrightness | |
| 0x000C0040 | ReloadConfig | |
| 0x000D0040 | RestoreConfig | |
| 0x000E0000 | GetPowerState | |
| 0x000F0000 | PowerOnAllBacklights | |
| 0x00100000 | PowerOffAllBacklights | |
| 0x00110040 | PowerOnBacklight | |
| 0x00120040 | PowerOffBacklight | |
| 0x00130040 | SetLedForceOff | |
| 0x00140000 | 8.0.0-18 | GetVendor New3DS-only, stubbed on Old3DS: This only returns an error. Uninitialized data(not set by this command itself) is also written to u8 cmdreply_word[2]. |
| 0x00150040 | 8.0.0-18 | GetBrightness New3DS-only, stubbed on Old3DS: This only returns an error. Uninitialized data(not set by this command itself) is also written to u32 cmdreply_word[2]. |
Unlike gsp::Gpu, GSP module does not start a separate thread for handling these service commands.
Version history #
| Version | Changes |
|---|---|
| v8196 | Support for the new LINEAR memory region was implemented for cache commands and vaddr->paddr conversion. Support for the New3DS only QTM memory region was added for vaddr->paddr conversion. When vaddr->physaddr conversions fail while handling PSC commands, an error is now returned (see here regarding errors being written to GSP shared memory). |
New3DS #
There’s separate GSP-module titles for Old3DS and New3DS. PTM CheckNew3DS is only used by the New3DS title, for copying that flag into a state field. Elsewhere that field is checked for running additional code only on New3DS, for processing various state / using QTM commands.