Changes

Jump to navigation Jump to search
6,755 bytes added ,  17:03, 6 December 2020
no edit summary
Line 8: Line 8:  
! Cmd || Name || Notes
 
! Cmd || Name || Notes
 
|-
 
|-
| 1 || ||  
+
| 1 || [[#CaptureRawImage]] ||  
 
|-
 
|-
| 2 || ||  
+
| 2 || [[#CaptureRawImageWithTimeout]] ||  
 
|-
 
|-
| 3 || [5.0.0+] ? || Takes a total of 8-bytes of input, no output.
+
| 3 || [5.0.0+] AttachSharedBuffer || Takes a total of 8-bytes of input, no output.
 
|-
 
|-
| 5 || [5.0.0+] ? || Takes a total of 0x10-bytes of input, no output.
+
| 5 || [5.0.0+] CaptureRawImageToAttachedSharedBuffer || Takes a total of 0x10-bytes of input, no output.
 
|-
 
|-
 
| 210 || [6.0.0+] ? || Takes a total of 0x50-bytes of input, a type-0x15 input buffer, and a type-0x45 input buffer, returns a total of 0x20-bytes of output.
 
| 210 || [6.0.0+] ? || Takes a total of 0x50-bytes of input, a type-0x15 input buffer, and a type-0x45 input buffer, returns a total of 0x20-bytes of output.
 
|-
 
|-
| [2.0.0-4.1.0] 1001 || || Takes a total of 0x10-bytes of input, no output.
+
| [2.0.0-4.1.0] 1001 || RequestTakingScreenShot || Takes a total of 0x10-bytes of input, no output.
 
|-
 
|-
| [2.0.0-4.1.0] 1002 || || Takes a total of 0x18-bytes of input, no output.
+
| [2.0.0-4.1.0] 1002 || RequestTakingScreenShotWithTimeout || Takes a total of 0x18-bytes of input, no output.
 
|-
 
|-
| [3.0.0-4.1.0] 1003 || || Takes a total of 0x58-bytes of input, no output.
+
| [3.0.0-4.1.0] 1003 || RequestTakingScreenShotEx || Takes a total of 0x58-bytes of input, no output.
 
|-
 
|-
| 1004 || [5.0.0+] ? || Takes a total of 0x60-bytes of input, no output.
+
| 1004 || [5.0.0+] RequestTakingScreenShotEx1 || Takes a total of 0x60-bytes of input, no output. [6.0.0+]: In addition, this also takes a type-0x15 input buffer. [11.0.0+] Now takes an additional 8-bytes of input.
 
|-
 
|-
| 1009 || [5.0.0+] ? || Takes a total of 0x10-bytes of input, no output.
+
| 1009 || [5.0.0+] CancelTakingScreenShot || Takes a total of 0x10-bytes of input, no output.
 
|-
 
|-
| 1010 || [5.0.0+] ? || Takes a total of 0x10-bytes of input, no output.
+
| 1010 || [5.0.0+] SetTakingScreenShotCancelState || Takes a total of 0x10-bytes of input, no output.
 
|-
 
|-
| 1011 || || Takes a total of 8-bytes of input, no output.
+
| 1011 || NotifyTakingScreenShotRefused || Takes a total of 8-bytes of input, no output.
 
|-
 
|-
| 1012 || || Takes a total of 8-bytes of input, no output.
+
| 1012 || NotifyTakingScreenShotFailed || Takes a total of 8-bytes of input, no output.
 
|-
 
|-
| 1101 || [4.0.0+] ? ||  
+
| 1101 || [4.0.0+] [[#SetupOverlayMovieThumbnail]] ||  
 
|-
 
|-
 
| 1106 || [4.0.0+] ? ||  
 
| 1106 || [4.0.0+] ? ||  
Line 40: Line 40:  
| 1107 || [4.0.0+] ? ||  
 
| 1107 || [4.0.0+] ? ||  
 
|-
 
|-
| 1201 || [3.0.0+] ? || Takes a total of 0x10-bytes of input, returns a total of 0x18-bytes of output.
+
| 1201 || [3.0.0+] OpenRawScreenShotReadStream || Takes a total of 0x10-bytes of input, returns a total of 0x18-bytes of output.
 
|-
 
|-
| 1202 || [3.0.0+] ? || No input/output.
+
| 1202 || [3.0.0+] CloseRawScreenShotReadStream || No input/output.
 
|-
 
|-
| 1203 || [3.0.0+] ? || Takes a total of 8-bytes of input and a type-0x6 output buffer, returns a total of 8-bytes of output.
+
| 1203 || [3.0.0+] ReadRawScreenShotReadStream || Takes a total of 8-bytes of input and a type-0x6 output buffer, returns a total of 8-bytes of output.
 +
|-
 +
| 1204 || [9.0.0+] || Takes a total of 0x10-bytes of input and a type-0x46 output buffer, returns a total of 8-bytes of output.
 
|}
 
|}
   Line 50: Line 52:  
* cmd1106/1107: User-processes use hard-coded sizes 0x400 and 0x404 for the first/second type-0x15 buffers.
 
* cmd1106/1107: User-processes use hard-coded sizes 0x400 and 0x404 for the first/second type-0x15 buffers.
 
* cmd1201/1202/1203: These are only usable when the previously loaded value from [[Settings_services|set:sys GetDebugModeFlag]] is set.
 
* cmd1201/1202/1203: These are only usable when the previously loaded value from [[Settings_services|set:sys GetDebugModeFlag]] is set.
 +
* cmd1204: Also required the mentioned debug flag but does no longer as of [10.0.0].
    
The only caps:sc commands used by [[GRC_services|GRC]] are: 1101, 1106, and 1107.
 
The only caps:sc commands used by [[GRC_services|GRC]] are: 1101, 1106, and 1107.
   −
== Cmd1 ==
+
[8.0.0+] Cmd210 and cmd1004 now takes an additional type-0x15 input buffer.
 +
 
 +
== CaptureRawImage ==
 
Takes a type-0x46 output buffer, an input u32 '''layer_stack''', two input u64s '''width'''/'''height''', an input s64 '''buffer_count''', and an input s64 '''buffer_index'''.
 
Takes a type-0x46 output buffer, an input u32 '''layer_stack''', two input u64s '''width'''/'''height''', an input s64 '''buffer_count''', and an input s64 '''buffer_index'''.
   Line 66: Line 71:  
Stubbed with [5.0.0+], where it now returns error 0x7FECE.
 
Stubbed with [5.0.0+], where it now returns error 0x7FECE.
   −
== Cmd2 ==
+
== CaptureRawImageWithTimeout ==
Calls the same internal func as cmd1, where the last param is an additional cmd input u64 instead of hard-coded value 0x5f5e100.
+
Calls the same internal func as [[#CaptureRawImage]], where the last param is an additional cmd input u64 instead of hard-coded value 0x5f5e100.
    
Stubbed with [5.0.0+], where it now returns error 0x7FECE.
 
Stubbed with [5.0.0+], where it now returns error 0x7FECE.
   −
== Cmd1101 ==
+
== SetupOverlayMovieThumbnail ==
 
Takes two input u64s '''width'''/'''height''', a 0x18-byte input struct, and two type-0x46 output buffers.
 
Takes two input u64s '''width'''/'''height''', a 0x18-byte input struct, and two type-0x46 output buffers.
   Line 83: Line 88:  
Takes a 0x40-byte input struct, two input u64s '''width'''/'''height''', a 0x18-byte input struct, two type-0x15 input buffers, a type-0x6 output buffer, and two type-0x46 output buffers, returns 3 output u64s.
 
Takes a 0x40-byte input struct, two input u64s '''width'''/'''height''', a 0x18-byte input struct, two type-0x15 input buffers, a type-0x6 output buffer, and two type-0x46 output buffers, returns 3 output u64s.
   −
'''width'''/'''height''' have same requirements as [[#Cmd1101]]. The size of the type-0x6 buffer must be at least 0x7D000. The requirements for the type-0x46 buffers are the same as [[#Cmd1101]].
+
'''width'''/'''height''' have same requirements as [[#SetupOverlayMovieThumbnail]]. The size of the type-0x6 buffer must be at least 0x7D000. The requirements for the type-0x46 buffers are the same as [[#SetupOverlayMovieThumbnail]].
 +
 
 +
[5.0.0+] Now takes a total of 0x68-bytes of input instead of 0x30.
    
== Cmd1107 ==
 
== Cmd1107 ==
 
Takes a 0x40-byte input struct, two input u64s '''width'''/'''height''', a 0x18-byte input struct, two type-0x15 input buffers, a type-0x6 output buffer, and a type-0x45 input buffer, returns 3 output u64s.
 
Takes a 0x40-byte input struct, two input u64s '''width'''/'''height''', a 0x18-byte input struct, two type-0x15 input buffers, a type-0x6 output buffer, and a type-0x45 input buffer, returns 3 output u64s.
   −
'''width'''/'''height''' have same requirements as [[#Cmd1101]]. The size of the type-0x6 buffer must be at least 0x7D000. The size of the type-0x45 buffer must be at least 0x384000.
+
'''width'''/'''height''' have same requirements as [[#SetupOverlayMovieThumbnail]]. The size of the type-0x6 buffer must be at least 0x7D000. The size of the type-0x45 buffer must be at least 0x384000.
 +
 
 +
[5.0.0+] Now takes a total of 0x68-bytes of input instead of 0x30.
    
= caps:ss =
 
= caps:ss =
Line 97: Line 106:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
| 201 ||
+
| 201 || SaveScreenShot
 
|-
 
|-
| 202 ||
+
| 202 || SaveEditedScreenShot
 
|-
 
|-
| 203 ||
+
| 203 || [3.0.0+] SaveScreenShotEx0
 
|-
 
|-
| 204 ||
+
| 204 || [3.0.0+] SaveEditedScreenShotEx0
 +
|-
 +
| 206 || [?+]
 +
|-
 +
| 208 || [5.0.0+] SaveScreenShotOfMovieEx1
 
|}
 
|}
    
= caps:su =
 
= caps:su =
This is "nn::capsrv::sf::IScreenShotApplicationService". This was moved to [[Applet_Manager_services|AM]] with [6.0.0+].
+
This is "nn::capsrv::sf::IScreenShotApplicationService".
 +
 
 +
This was added with [3.0.0+]. This was moved to [[Applet_Manager_services|AM]] with [6.0.0+].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 125: Line 140:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
| 0 || Initialize
+
| 0 || RegisterCallback
 +
|-
 +
| 1 || UnregisterCallback
 +
|-
 +
| 2 || TriggerSystemEvent
 +
|-
 +
| 3 || PerformAction
 +
|-
 +
| 4 || QueryState
 +
|-
 +
| 5 || OnSystemEvent
 
|-
 
|-
| 1 ||
+
| 6 || [2.0.0+] CancelCurrentCall
 
|-
 
|-
| 2 ||
+
| 100 || [4.0.0+] [[#GetHdcpServiceObject]]
 +
|}
 +
 
 +
== GetHdcpServiceObject ==
 +
No input, returns a [[#IHdcpController]].
 +
 
 +
= IHdcpController =
 +
This is "nn::hdcp::IHdcpController".
 +
 
 +
Added with [4.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 3 || PerformOneTouchPlay
+
! Cmd || Name
 
|-
 
|-
| 4 ||
+
| 0 || GetHdcpStateTransitionEvent
 
|-
 
|-
| 5 ||
+
| 1 || GetHdcpAuthenticationState
 
|-
 
|-
| 6 || [2.0.0+]
+
| 2 || SetCurrentHdcpMode
 
|-
 
|-
| 100 || [4.0.0+] GetHdcpServiceObject
+
| 3 || GetCurrentHdcpMode
 
|}
 
|}
   Line 177: Line 213:  
| 0 || [[#vi:u|GetDisplayService]]
 
| 0 || [[#vi:u|GetDisplayService]]
 
|-
 
|-
 +
| 1 || [9.0.0+] [[#vi:u|GetDisplayServiceWithProxyNameExchange]]
 
|}
 
|}
    
== GetDisplayService ==
 
== GetDisplayService ==
Returns an [[#IApplicationDisplayService]]. Takes an input u32, user-processes use 0 or 1, with 0 for regular-applications normally. 0 = user-service(vi:u), 1 = non-user-service? Returns an error when using value 1 with vi:u(same error listed below for IApplicationDisplayService for unavailable commands).
+
Returns an [[#IApplicationDisplayService]]. Takes an input u32, user-processes use 0 or 1, with 0 for regular-applications normally. 0 = user-service(vi:u), 1 = system/manager service (vi:s/vi:m). Returns an error when using value 1 with vi:u(same error listed below for IApplicationDisplayService for unavailable commands), however passing 1 to vi:s/vi:m results in the IApplicationDisplayService having greater privileges.
 +
 
 +
== GetDisplayServiceWithProxyNameExchange ==
 +
Takes an input u32, and returns an [[#IApplicationDisplayService]].
    
= vi:s =
 
= vi:s =
Line 314: Line 354:     
== GetDisplayResolution ==
 
== GetDisplayResolution ==
Takes an input u64 DisplayId and returns two output u64s: width and height.
+
Takes an input u64 DisplayId and returns two output s64s: width and height. Official sw copies these to s32 output fields.
    
== OpenLayer ==
 
== OpenLayer ==
Line 338: Line 378:     
== GetIndirectLayerImageMap ==
 
== GetIndirectLayerImageMap ==
Takes a PID-descriptor, an type-0x46 buffer, and four u64s: width(s32), height(s32), <output from [[AM_services|AM]] GetIndirectLayerConsumerHandle>, and [[AM_services|AppletResourceUserId]]. Returns two output u64s.
+
Takes a PID-descriptor, an type-0x46 buffer, two s64s width/height, then two u64s: <output from [[AM_services|AM]] GetIndirectLayerConsumerHandle>, and [[AM_services|AppletResourceUserId]]. Returns two output s64s, which are copied to output u64s by official sw.
 +
 
 +
Official sw sets the width/height using input s32s.
    
Calls the same func as [[#GetIndirectLayerImageCropMap]] internally, with the input floats set to 0.0f, then 1.0f for the rest.
 
Calls the same func as [[#GetIndirectLayerImageCropMap]] internally, with the input floats set to 0.0f, then 1.0f for the rest.
Line 346: Line 388:     
== GetIndirectLayerImageRequiredMemoryInfo ==
 
== GetIndirectLayerImageRequiredMemoryInfo ==
Takes two input u64s: width and height. Returns two output u64s. First u64 is the buffer size to use with the ImageMap cmds, second u64 is the buffer address alignment for those cmds.
+
Takes two input s64s: width and height. Returns two output s64s, which are copied to output u64s by official sw. First field is the buffer size to use with the ImageMap cmds, second field is the buffer address alignment for those cmds.
 +
 
 +
Official sw sets the width/height using input s32s.
    
== GetDisplayVsyncEvent ==
 
== GetDisplayVsyncEvent ==
Line 380: Line 424:  
|-
 
|-
 
| 2209 || SetLayerAlpha
 
| 2209 || SetLayerAlpha
 +
|-
 +
| 2210 || [11.0.0+] SetLayerPositionAndSize
 
|-
 
|-
 
| 2312 || [1.0.0-6.2.0] CreateStrayLayer
 
| 2312 || [1.0.0-6.2.0] CreateStrayLayer
Line 426: Line 472:  
|-
 
|-
 
| 3217 || SetDisplayCmuLuma
 
| 3217 || SetDisplayCmuLuma
 +
|-
 +
| 3218 || [11.0.0+] SetDisplayCrcMode
 +
|-
 +
| 6013 || [10.0.0+] GetLayerPresentationSubmissionTimestamps
 
|-
 
|-
 
| 8225 || [4.0.0+] GetSharedBufferMemoryHandleId
 
| 8225 || [4.0.0+] GetSharedBufferMemoryHandleId
Line 446: Line 496:  
|-
 
|-
 
| 8258 || [5.0.0+] CancelSharedFrameBuffer
 
| 8258 || [5.0.0+] CancelSharedFrameBuffer
 +
|-
 +
| 9000 || [11.0.0+] GetDp2hdmiController
 +
|}
 +
 +
=== GetDp2hdmiController ===
 +
No input, returns an [[#IDp2hdmiController]].
 +
 +
=== IDp2hdmiController ===
 +
This is "nn::dp2hdmi::detail::IDp2hdmiController".
 +
 +
This was added with [11.0.0+].
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || GetFirmwareVersion
 +
|-
 +
| 1 || GetAvailableFirmwareVersion
 +
|-
 +
| 2 || CheckFirmwareUpdateRequired
 +
|-
 +
| 3 || StartFirmwareUpdate
 +
|-
 +
| 4 || StartFirmwareUpdateWithSpecifiedImage
 +
|-
 +
| 5 || OverwriteFirmware
 +
|-
 +
| 6 || OverwriteFirmwareWithSpecifiedImage
 +
|-
 +
| 7 || GetFirmwareUpdateState
 +
|-
 +
| 8 || ResetDevice
 
|}
 
|}
   Line 459: Line 542:  
| 201 || [4.0.0+] FreeProcessHeapBlock
 
| 201 || [4.0.0+] FreeProcessHeapBlock
 
|-
 
|-
| 1102 || GetDisplayResolution
+
| 1102 || [3.0.0+] GetDisplayResolution
 
|-
 
|-
 
| 2010 || CreateManagedLayer
 
| 2010 || CreateManagedLayer
Line 492: Line 575:  
|-
 
|-
 
| 2601 || [4.0.0+] GetDisplayErrorEvent
 
| 2601 || [4.0.0+] GetDisplayErrorEvent
 +
|-
 +
| 2701 || [11.0.0+] GetDisplayFatalErrorEvent
 
|-
 
|-
 
| 4201 || SetDisplayAlpha
 
| 4201 || SetDisplayAlpha
Line 500: Line 585:  
|-
 
|-
 
| 4206 || [4.0.0+] SetDefaultDisplay
 
| 4206 || [4.0.0+] SetDefaultDisplay
 +
|-
 +
| 4207 || [11.0.0+] ResetDisplayPanel
 +
|-
 +
| 4208 || [11.0.0+] EnableDisplayFatalError
 +
|-
 +
| 4300 || [11.0.0+] GetInternalPanelId
 
|-
 
|-
 
| 6000 || AddToLayerStack
 
| 6000 || AddToLayerStack
Line 530: Line 621:  
|-
 
|-
 
| 8000 || SetConductorLayer
 
| 8000 || SetConductorLayer
 +
|-
 +
| 8001 || [8.0.0+] SetTimestampTracking
 
|-
 
|-
 
| 8100 || SetIndirectProducerFlipOffset
 
| 8100 || SetIndirectProducerFlipOffset
Line 593: Line 686:  
| 8298 || [5.0.0+] ExpandStartupLogoOnSharedFrameBuffer
 
| 8298 || [5.0.0+] ExpandStartupLogoOnSharedFrameBuffer
 
|}
 
|}
 +
 +
[10.0.0+] AttachLayerPresentationTracer now takes an additional 8-bytes of input.
 +
 +
[5.0.0+] SetDetachedSharedFrameBufferImage now takes an additional 0x10-bytes of input. CopyDetachedSharedFrameBufferImage now takes an additional 0x18-bytes of input. SetDetachedSharedFrameBufferSubImage now takes an additional 0x10-bytes of input, and the buffer type was changed from 0x5 to 0x45.
 +
 +
= lbl =
 +
This is "nn::lbl::detail::ILblController".
 +
 +
[11.0.0+] this was moved from [[PTM_services|ptm]].
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || SaveCurrentSetting
 +
|-
 +
| 1 || LoadCurrentSetting
 +
|-
 +
| 2 || SetCurrentBrightnessSetting
 +
|-
 +
| 3 || GetCurrentBrightnessSetting
 +
|-
 +
| 4 || ApplyCurrentBrightnessSettingToBacklight
 +
|-
 +
| 5 || GetBrightnessSettingAppliedToBacklight
 +
|-
 +
| 6 || SwitchBacklightOn
 +
|-
 +
| 7 || SwitchBacklightOff
 +
|-
 +
| 8 || GetBacklightSwitchStatus
 +
|-
 +
| 9 || EnableDimming
 +
|-
 +
| 10 || DisableDimming
 +
|-
 +
| 11 || IsDimmingEnabled
 +
|-
 +
| 12 || EnableAutoBrightnessControl
 +
|-
 +
| 13 || DisableAutoBrightnessControl
 +
|-
 +
| 14 || IsAutoBrightnessControlEnabled
 +
|-
 +
| 15 || SetAmbientLightSensorValue
 +
|-
 +
| 16 || [[#GetAmbientLightSensorValue]]
 +
|-
 +
| 17 || SetBrightnessReflectionDelayLevel
 +
|-
 +
| 18 || GetBrightnessReflectionDelayLevel
 +
|-
 +
| 19 || SetCurrentBrightnessMapping
 +
|-
 +
| 20 || GetCurrentBrightnessMapping
 +
|-
 +
| 21 || SetCurrentAmbientLightSensorMapping
 +
|-
 +
| 22 || GetCurrentAmbientLightSensorMapping
 +
|-
 +
| 23 || [3.0.0+] IsAmbientLightSensorAvailable
 +
|-
 +
| 24 || [3.0.0+] SetCurrentBrightnessSettingForVrMode
 +
|-
 +
| 25 || [3.0.0+] GetCurrentBrightnessSettingForVrMode
 +
|-
 +
| 26 || [3.0.0+] [[#EnableVrMode]]
 +
|-
 +
| 27 || [3.0.0+] [[#DisableVrMode]]
 +
|-
 +
| 28 || [3.0.0+] [[#IsVrModeEnabled]]
 +
|-
 +
| 29 || [7.0.0+] IsAutoBrightnessControlSupported
 +
|}
 +
 +
== Ambient Light Sensor Notes ==
 +
The BH1730 outputs 2 values. Visible light and IR light. This is then calculated through an algorithm that checks for Gain, Measurement time, filter qualities and ouputs lux (max correct measurement of 100K lux).
 +
The default values are Gain 64x and ITIME of 38 (256 - 218). This allows for a max lux value of 17972 lux when visible light value is maximum and IR light is 0. When both of them are on their limit, the output is 1192 lux.
 +
The sensor is fully configurable.
 +
 +
== GetAmbientLightSensorValue ==
 +
No input. Before 5.x, outputs lux in float. (5.0.0+) Returns an output struct:
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || bOverLimit. (u32) Equals to 1 if visible or IR light data is over 65534.
 +
|-
 +
| 0x4 || 0x4 || fLux. (float) Value in lux from the ambient light sensor.
 +
|}
 +
Note: if bOverLimit=1 and the default ALS configuration is used, the measurement of fLux should not be considered and the actual max value depends on the type of light. Ranges from 12.5K - 17.5K.
 +
 +
== GetCurrentBrightnessSetting ==
 +
No input. Returns an output u32 int of the current backlight level.
 +
 +
== GetBrightnessSettingAppliedToBacklight ==
 +
No input. Returns an output u32 int of the backlight level computed from the ambient light sensor.
 +
 +
== IsAutoBrightnessControlEnabled ==
 +
No input. Returns an output u8 bool indicating whether auto brightness is enabled.
 +
 +
== EnableVrMode ==
 +
No input/output. Used by [[AM_services#SetVrModeEnabled]].
 +
 +
Sets a global state field to 0x1.
 +
 +
== DisableVrMode ==
 +
No input/output. Used by [[AM_services#SetVrModeEnabled]].
 +
 +
Sets the global state field used by [[#EnableVrMode]] to 0x0.
 +
 +
== IsVrModeEnabled ==
 +
No input. Returns an output u8 bool set by the above commands.
    
= DisplayInfo =
 
= DisplayInfo =

Navigation menu