PPC services: Difference between revisions

Missile (talk | contribs)
whoops
No longer needed
 
(34 intermediate revisions by 5 users not shown)
Line 1: Line 1:
APM is utilized for setting system performance profiles; including clocks for CPU, GPU, and memory.
PPC is used for setting system performance profiles including clocks for CPU, GPU, and memory.
 
[9.0.0+] The PPC system module is now stubbed and all its services were moved into [[PTM_services|PTM]].
 
= apm =
This is "nn::apm::IManager".
 
This was moved to [[Applet_Manager_services|AM]] with [8.0.0+] and is now a shim for [[#apm:am|apm:am]].


== apm ==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name || Notes
! Cmd || Name
|-
| 0 || [[#OpenSession]]
|-
| 1 || GetPerformanceMode
|-
| 6 || [7.0.0+] [[#IsCpuOverclockEnabled]]
|}
 
== OpenSession ==
Returns an [[#ISession]].
 
== IsCpuOverclockEnabled ==
No input, returns an output u8 bool.
 
= apm:p =
This is "nn::apm::IManagerPrivileged".
 
This service no longer exists in [8.0.0+].
 
{| class="wikitable" border="1"
|-
|-
| 0 || [[#ISession|GetISession]] ||
! Cmd || Name
|-
|-
| 1 || GetPerformanceMode ||  
| 0 || OpenSession
|}
|}


=== ISession ===
== OpenSession ==
Returns an [[#ISession]].
 
= apm:am =
This is "nn::apm::IManager".
 
This was added with [8.0.0+] and is the same as the old [[#apm|apm]] service.
 
= apm:sys =
This is "nn::apm::ISystemManager".
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name || Notes
! Cmd || Name
|-
| 0 || RequestPerformanceMode
|-
| 1 || GetPerformanceEvent
|-
|-
| 0 || SetPerformanceConfiguration || Takes u32 PerformanceMode
| 2 || GetThrottlingState
|-
|-
| 1 || GetPerformanceConfiguration  || Takes u32 PerformanceMode, u32 PerformanceConfiguration
| 3 || GetLastThrottlingState
|-
| 4 || ClearLastThrottlingState
|-
| 5 || [5.0.0+] LoadAndApplySettings
|-
| 6 || [7.0.0+] [[#SetCpuBoostMode]]
|-
| 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
|}
|}


=== PerformanceMode ===
== GetPerformanceEvent ==
Returns an [[#ISession]].
 
== SetCpuBoostMode ==
Takes an u32 [[#CpuBoostMode]].
 
== GetCurrentPerformanceConfiguration ==
Returns the currently active [[#PerformanceConfiguration]] (default value is 0x00020003).
 
= ISession =
This is "nn::apm::ISession".
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Value || Name
! Cmd || Name
|-
| 0 || SetPerformanceConfiguration
|-
| 1 || GetPerformanceConfiguration
|-
| 2 || [8.0.0+] [[#SetCpuOverclockEnabled]]
|}
 
== SetPerformanceConfiguration ==
Takes an u32 [[#PerformanceMode]] and an u32 [[#PerformanceConfiguration]].
 
== GetPerformanceConfiguration ==
Takes an u32 [[#PerformanceMode]] and returns an output u32 [[#PerformanceConfiguration]].
 
== SetCpuOverclockEnabled ==
Takes an input u8 bool, no output.
 
= fgm, fgm:0, fgm:9 =
This is "nn::fgm::sf::ISession".
 
{| class="wikitable" border="1"
|-
|-
| 0 || Handheld
! Cmd || Name
|-
|-
| 1 || Docked
| 0 || Initialize
|}
|}


=== PerformanceConfiguration ===
== IRequest ==
This is "nn::fgm::sf::IRequest".
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Value || Name
! Cmd || Name
|-
| 0 || Initialize
|-
| 1 || Set
|-
| 2 || Get
|-
| 3 || Cancel
|}
 
= fgm:dbg =
This is "nn::fgm::sf::IDebugger".
 
{| class="wikitable" border="1"
|-
|-
| 0x10000 || Docked profiles
! Cmd || Name
|-
|-
| 0x10001 ||  
| 0 || Initialize
|-
|-
| 0x10002 ||  
| 1 || Read
|-
|-
| 0x20000 || Handheld profiles
| 2 || Cancel
|}
 
= CpuBoostMode =
{| class="wikitable" border="1"
|-
|-
| 0x20001 ||  
! Value || Description
|-
|-
| 0x20002 ||  
| 0 || Disabled.
|-
|-
| 0x20003 ||  
| 1 || Boost CPU. Additionally, throttle GPU to minimum.
Use [[#PerformanceConfiguration|performance configurations]] 0x92220009 and 0x9222000A, or 0x9222000B and 0x9222000C.
|-
|-
| 0x20004 ||  
| 2 || Conserve power. Only throttle GPU to minimum.
Use [[#PerformanceConfiguration|performance configurations]] 0x9222000B and 0x9222000C.
|}
 
= PerformanceMode =
{| class="wikitable" border="1"
|-
|-
| 0x20005 ||  
! Value || Description
|-
|-
| 0x20006 ||  
| -1 || Invalid
|-
|-
| 0x92220007 || Unknown profiles
| 0 || Normal
|-
|-
| 0x92220008 ||  
| 1 || Boost
|}
|}
The lower 16 bits seem to loosely indicate relative profile performance, with higher values being slower. Unknown profiles can be applied in handheld mode (these may be ultra-low-power modes).


== apm:p ==
= PerformanceConfiguration =
{| class="wikitable" border="1"
|-
! Value || Description || CPU clock (MHz) || GPU clock (MHz) || Memory clock (MHz)
|-
| 0x00000000 || Invalid || 0 || 0 || 0
|-
| 0x00010000 || Cpu1020MhzGpu384Mhz || 1020.0 || 384.0 || 1600.0
|-
| 0x00010001 || Cpu1020MhzGpu768Mhz || 1020.0 || 768.0 || 1600.0
|-
| 0x00010002 || Cpu1224MhzGpu691Mhz || 1224.0 || 691.2 || 1600.0
|-
| 0x00020000 || Cpu1020MhzGpu230Mhz|| 1020.0 || 230.4 || 1600.0
|-
| 0x00020001 || Cpu1020MhzGpu307Mhz || 1020.0 || 307.2 || 1600.0
|-
| 0x00020002 || Cpu1224MhzGpu230Mhz || 1224.0 || 230.4 || 1600.0
|-
| 0x00020003 || Cpu1020MhzGpu307MhzEmc1331Mhz || 1020.0 || 307.2 || 1331.2
|-
| 0x00020004 || Cpu1020MhzGpu384MhzEmc1331Mhz || 1020.0 || 384.0 || 1331.2
|-
| 0x00020005 || Cpu1020MhzGpu307MhzEmc1065Mhz || 1020.0 || 307.2 || 1065.6
|-
| 0x00020006 || Cpu1020MhzGpu384MhzEmc1065Mhz || 1020.0 || 384.0 || 1065.6
|-
| 0x92220007 || Cpu1020MhzGpu460MhzEmc1600Mhz || 1020.0 || 460.8 || 1600.0
|-
| 0x92220008 || Cpu1020MhzGpu460MhzEmc1331Mhz || 1020.0 || 460.8 || 1331.2
|-
| [7.0.0+] 0x92220009 || Cpu1785MhzGpu76MhzEmc1600Mhz || 1785.0 || 76.8 || 1600.0
|-
| [7.0.0+] 0x9222000A || Cpu1785MhzGpu76MhzEmc1331Mhz || 1785.0 || 76.8 || 1331.2
|-
| [7.0.0+] 0x9222000B || Cpu1020MhzGpu76MhzEmc1600Mhz || 1020.0 || 76.8 || 1600.0
|-
| [7.0.0+] 0x9222000C || Cpu1020MhzGpu76MhzEmc1331Mhz || 1020.0 || 76.8 || 1331.2
|}


Configurations 0x10001 and 0x20000 are only available while docked. Configurations 0x10002 and 0x20002 are only available for SDEV units.


== apm:sys ==
Some of these require apm:p.


[[Category:Services]]
[[Category:Services]]