Difference between revisions of "GSP Services"

From 3dbrew
Jump to navigation Jump to search
m (Add gsp::Gpu and gsp::Lcd anchors)
 
(40 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category:Services]]
+
__TOC__
 +
{{Anchor|GSPGPU}}{{Anchor|gsp::Gpu}}
 
= GSP service "gsp::Gpu" =
 
= GSP service "gsp::Gpu" =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
!  Command Header
 
!  Command Header
 +
!  Available since system version
 +
!  GSP rights required
 
!  Description
 
!  Description
 
|-
 
|-
 
| 0x00010082
 
| 0x00010082
 +
|
 +
| Yes
 
| [[GSPGPU:WriteHWRegs|WriteHWRegs]]
 
| [[GSPGPU:WriteHWRegs|WriteHWRegs]]
 
|-
 
|-
 
| 0x00020084
 
| 0x00020084
 +
|
 +
| Yes
 
| [[GSPGPU:WriteHWRegsWithMask|WriteHWRegsWithMask]]
 
| [[GSPGPU:WriteHWRegsWithMask|WriteHWRegsWithMask]]
 
|-
 
|-
 
| 0x00030082
 
| 0x00030082
 +
|
 +
| Yes
 
| [[GSPGPU:WriteHWRegRepeat|WriteHWRegRepeat]]
 
| [[GSPGPU:WriteHWRegRepeat|WriteHWRegRepeat]]
 
|-
 
|-
 
| 0x00040080
 
| 0x00040080
 +
|
 +
| Yes
 
| [[GSPGPU:ReadHWRegs|ReadHWRegs]]
 
| [[GSPGPU:ReadHWRegs|ReadHWRegs]]
 
|-
 
|-
 
| 0x00050200
 
| 0x00050200
 +
|
 +
| Yes
 
| [[GSPGPU:SetBufferSwap|SetBufferSwap]]
 
| [[GSPGPU:SetBufferSwap|SetBufferSwap]]
 
|-
 
|-
 
| 0x00060082
 
| 0x00060082
 +
|
 +
| No
 
| SetCommandList (Stubbed)
 
| SetCommandList (Stubbed)
 
|-
 
|-
 
| 0x000700C2
 
| 0x000700C2
 +
|
 +
| No
 
| RequestDma (Stubbed)
 
| RequestDma (Stubbed)
 
|-
 
|-
 
| 0x00080082
 
| 0x00080082
 +
|
 +
| No
 
| [[GSPGPU:FlushDataCache|FlushDataCache]]
 
| [[GSPGPU:FlushDataCache|FlushDataCache]]
 
|-
 
|-
 
| 0x00090082
 
| 0x00090082
 +
|
 +
| No
 
| [[GSPGPU:InvalidateDataCache|InvalidateDataCache]]
 
| [[GSPGPU:InvalidateDataCache|InvalidateDataCache]]
 
|-
 
|-
 
| 0x000A0044
 
| 0x000A0044
| RegisterInterruptEvents
+
|
 +
| No
 +
| RegisterInterruptEvents (Stubbed)
 
|-
 
|-
 
| 0x000B0040
 
| 0x000B0040
 +
|
 +
| See below
 
| [[GSPGPU:SetLcdForceBlack|SetLcdForceBlack]]
 
| [[GSPGPU:SetLcdForceBlack|SetLcdForceBlack]]
 
|-
 
|-
 
| 0x000C0000
 
| 0x000C0000
 +
|
 +
| No
 
| [[GSPGPU:TriggerCmdReqQueue|TriggerCmdReqQueue]]
 
| [[GSPGPU:TriggerCmdReqQueue|TriggerCmdReqQueue]]
 
|-
 
|-
 
| 0x000D0140
 
| 0x000D0140
 +
|
 +
| No
 
| SetDisplayTransfer (Stubbed)
 
| SetDisplayTransfer (Stubbed)
 
|-
 
|-
 
| 0x000E0180
 
| 0x000E0180
 +
|
 +
| No
 
| SetTextureCopy (Stubbed)
 
| SetTextureCopy (Stubbed)
 
|-
 
|-
 
| 0x000F0200
 
| 0x000F0200
 +
|
 +
| No
 
| SetMemoryFill (Stubbed)
 
| SetMemoryFill (Stubbed)
 
|-
 
|-
 
| 0x00100040
 
| 0x00100040
| SetAxiConfigQoSMode
+
|  
 +
| No
 +
| [[GSPGPU:SetAxiConfigQoSMode|SetAxiConfigQoSMode]]
 
|-
 
|-
 
| 0x00110040
 
| 0x00110040
| SetPerfLogMode
+
|  
 +
| No
 +
| [[GSPGPU:SetPerfLogMode|SetPerfLogMode]]
 
|-
 
|-
 
| 0x00120000
 
| 0x00120000
| GetPerfLog
+
|  
 +
| No
 +
| [[GSPGPU:GetPerfLog|GetPerfLog]]
 
|-
 
|-
 
| 0x00130042
 
| 0x00130042
 +
|
 +
| No
 
| [[GSPGPU:RegisterInterruptRelayQueue|RegisterInterruptRelayQueue]]
 
| [[GSPGPU:RegisterInterruptRelayQueue|RegisterInterruptRelayQueue]]
 
|-
 
|-
 
| 0x00140000
 
| 0x00140000
| UnregisterInterruptRelayQueue
+
|  
 +
| No
 +
| [[GSPGPU:UnregisterInterruptRelayQueue|UnregisterInterruptRelayQueue]]
 
|-
 
|-
 
| 0x00150002
 
| 0x00150002
| TryAcquireRight
+
|  
 +
| No
 +
| [[GSPGPU:TryAcquireRight|TryAcquireRight]]
 
|-
 
|-
 
| 0x00160042
 
| 0x00160042
| AcquireRight (bool unk, 0, u32 processhandle)
+
|  
 +
| No
 +
| [[GSPGPU:AcquireRight|AcquireRight]]
 
|-
 
|-
 
| 0x00170000
 
| 0x00170000
| ReleaseRight
+
|  
 +
| No
 +
| [[GSPGPU:ReleaseRight|ReleaseRight]]
 
|-
 
|-
 
| 0x00180000
 
| 0x00180000
| ImportDisplayCaptureInfo
+
|  
 +
| No
 +
| [[GSPGPU:ImportDisplayCaptureInfo|ImportDisplayCaptureInfo]]
 
|-
 
|-
 
| 0x00190000
 
| 0x00190000
| SaveVramSysArea
+
|  
 +
| See below
 +
| [[GSPGPU:SaveVramSysArea|SaveVramSysArea]]
 
|-
 
|-
 
| 0x001A0000
 
| 0x001A0000
| RestoreVramSysArea
+
|  
 +
| See below
 +
| [[GSPGPU:RestoreVramSysArea|RestoreVramSysArea]]
 
|-
 
|-
 
| 0x001B0000
 
| 0x001B0000
| ResetGpuCore
+
|  
 +
| Yes
 +
| [[GSPGPU:ResetGpuCore|ResetGpuCore]]
 
|-
 
|-
 
| 0x001C0040
 
| 0x001C0040
| SetLedForceOff
+
|  
 +
| No
 +
| [[GSPGPU:SetLedForceOff|SetLedForceOff]]
 
|-
 
|-
 
| 0x001D0040
 
| 0x001D0040
 +
|
 +
| No
 
| SetTestCommand (Stubbed)
 
| SetTestCommand (Stubbed)
 
|-
 
|-
 
| 0x001E0080
 
| 0x001E0080
| SetInternalPriorities
+
|  
 +
| No
 +
| [[GSPGPU:SetInternalPriorities|SetInternalPriorities]]
 +
|-
 +
| 0x001F0082
 +
| [[8.0.0-18]]
 +
| No
 +
| [[GSPGPU:StoreDataCache|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.
+
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 [[GSPGPU:WriteHWRegs|writes]] to registers during initialization, this is normally not used however.
  
 +
If a process has acquired rights, attempting to [[GSPGPU:SetLcdForceBlack|set LCDs to black]] from another process will fail.
 +
Saving/restoring VRAM requires bit0 of process [[GSPGPU:RegisterInterruptRelayQueue|flags]] to be set.
 +
 +
{{Anchor|GSPLCD}}{{Anchor|gsp::Lcd}}
 
= GSP service "gsp::Lcd" =
 
= GSP service "gsp::Lcd" =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
!  Command Header
 
!  Command Header
 +
!  Available since system version
 
!  Description
 
!  Description
 
|-
 
|-
| 0x0001....
+
| 0x00010040
| ?
+
|  
 +
| [[GSPLCD:EnableABL|EnableABL]]
 +
|-
 +
| 0x00020040
 +
|
 +
| [[GSPLCD:DisableABL|DisableABL]]
 +
|-
 +
| 0x00030080
 +
|
 +
| [[GSPLCD:SetRSLut|SetRSLut]]
 +
|-
 +
| 0x000400C0
 +
|
 +
| [[GSPLCD:SetRSParams|SetRSParams]]
 
|-
 
|-
| 0x0002....
+
| 0x00050140
| ?
+
|  
 +
| [[GSPLCD:SetABLArea|SetABLArea]]
 
|-
 
|-
| 0x0003....
+
| 0x00060140
 +
|
 
| ?
 
| ?
 
|-
 
|-
| 0x0004....
+
| 0x00070080
| ?
+
|  
 +
| [[GSPLCD:SetInertia|SetInertia]]
 
|-
 
|-
| 0x0005....
+
| 0x000800C0
| ?
+
|  
 +
| [[GSPLCD:SetDitherMode|SetDitherMode]]
 
|-
 
|-
| 0x0006....
+
| 0x00090140
| ?
+
|  
 +
| [[GSPLCD:SetDitherParams|SetDitherParams]]
 
|-
 
|-
| 0x0007....
+
| 0x000A0080
| ?
+
|  
 +
| [[GSPLCD:SetBrightnessRaw|SetBrightnessRaw]]
 
|-
 
|-
| 0x0008....
+
| 0x000B0080
| ?
+
|  
 +
| [[GSPLCD:SetBrightness|SetBrightness]]
 
|-
 
|-
| 0x0009....
+
| 0x000C0040
| ?
+
|  
 +
| [[GSPLCD:ReloadConfig|ReloadConfig]]
 
|-
 
|-
| 0x000A....
+
| 0x000D0040
| ?
+
|  
 +
| [[GSPLCD:RestoreConfig|RestoreConfig]]
 
|-
 
|-
| 0x000B....
+
| 0x000E0000
| ?
+
|  
 +
| [[GSPLCD:GetPowerState|GetPowerState]]
 
|-
 
|-
| 0x000C....
+
| 0x000F0000
| ?
+
|  
 +
| [[GSPLCD:PowerOnAllBacklights|PowerOnAllBacklights]]
 
|-
 
|-
| 0x000D....
+
| 0x00100000
| ?
+
|  
 +
| [[GSPLCD:PowerOffAllBacklights|PowerOffAllBacklights]]
 
|-
 
|-
| 0x000E....
+
| 0x00110040
| ?
+
|  
 +
| [[GSPLCD:PowerOnBacklight|PowerOnBacklight]]
 
|-
 
|-
| 0x000F....
+
| 0x00120040
| ?
+
|  
 +
| [[GSPLCD:PowerOffBacklight|PowerOffBacklight]]
 
|-
 
|-
| 0x0010....
+
| 0x00130040
| ?
+
|  
 +
| [[GSPLCD:SetLedForceOff|SetLedForceOff]]
 
|-
 
|-
| 0x0012....
+
| 0x00140000
| ?
+
| [[8.0.0-18]]
 +
| [[GSPLCD:GetVendor|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].
 
|-
 
|-
| 0x0013....
+
| 0x00150040
| ?
+
| [[8.0.0-18]]
 +
| [[GSPLCD:GetBrightness|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.
 
Unlike gsp::Gpu, GSP module does not start a separate thread for handling these service commands.
 +
 +
= Version history =
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Version
 +
!  Changes
 +
|-
 +
| [[8.0.0-18|v8196]]
 +
| Support for the new LINEAR memory region was implemented(for cache commands and vaddr->physaddr conversion). Support for the new process-mem 0x1E800000 region(however the GPU can't actually access this memory) was added for vaddr->physaddr conversion. Originally GSP module ignored vaddr->physaddr conversion errors(like with vaddrs outside of the handled ranges) and just wrote physaddr value0 to the GPU registers, however now GSP module returns an error for that instead(see [[GSP_Shared_Memory#Command_Buffer_Header|here]] regarding errors being written to GSP shared-mem). New services commands were added too, see above.
 +
|}
 +
 +
=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_Services|QTM]] commands.
 +
 +
[[Category:Services]]

Latest revision as of 09:41, 18 September 2024

GSP service "gsp::Gpu"[edit]

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 See below SetLcdForceBlack
0x000C0000 No TriggerCmdReqQueue
0x000D0140 No SetDisplayTransfer (Stubbed)
0x000E0180 No SetTextureCopy (Stubbed)
0x000F0200 No SetMemoryFill (Stubbed)
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 acquired rights, attempting to set LCDs to black from another process will fail. Saving/restoring VRAM requires bit0 of process flags to be set.

GSP service "gsp::Lcd"[edit]

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[edit]

Version Changes
v8196 Support for the new LINEAR memory region was implemented(for cache commands and vaddr->physaddr conversion). Support for the new process-mem 0x1E800000 region(however the GPU can't actually access this memory) was added for vaddr->physaddr conversion. Originally GSP module ignored vaddr->physaddr conversion errors(like with vaddrs outside of the handled ranges) and just wrote physaddr value0 to the GPU registers, however now GSP module returns an error for that instead(see here regarding errors being written to GSP shared-mem). New services commands were added too, see above.

New3DS[edit]

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.