PPC services: Difference between revisions

No longer needed
 
(17 intermediate revisions by 4 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 =
= apm =
This is "nn::apm::IManager".
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]].


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 12: Line 16:
| 1 || GetPerformanceMode
| 1 || GetPerformanceMode
|-
|-
| 6 || IsCpuOverclockEnabled
| 6 || [7.0.0+] [[#IsCpuOverclockEnabled]]
|}
|}


== OpenSession ==
== OpenSession ==
Returns an [[#ISession]].
Returns an [[#ISession]].
== IsCpuOverclockEnabled ==
No input, returns an output u8 bool.


= apm:p =
= apm:p =
This is "nn::apm::IManagerPrivileged".
This is "nn::apm::IManagerPrivileged".
This service no longer exists in [8.0.0+].


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 30: Line 39:
== OpenSession ==
== OpenSession ==
Returns an [[#ISession]].
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 =
= apm:sys =
Line 50: Line 64:
| 5 || [5.0.0+] LoadAndApplySettings
| 5 || [5.0.0+] LoadAndApplySettings
|-
|-
| 6 || [7.0.0+] SetCpuBoostMode
| 6 || [7.0.0+] [[#SetCpuBoostMode]]
|-
|-
| 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
| 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
Line 57: Line 71:
== GetPerformanceEvent ==
== GetPerformanceEvent ==
Returns an [[#ISession]].
Returns an [[#ISession]].
== SetCpuBoostMode ==
Takes an u32 [[#CpuBoostMode]].


== GetCurrentPerformanceConfiguration ==
== GetCurrentPerformanceConfiguration ==
Line 71: Line 88:
|-
|-
| 1 || GetPerformanceConfiguration
| 1 || GetPerformanceConfiguration
|-
| 2 || [8.0.0+] [[#SetCpuOverclockEnabled]]
|}
|}


== SetPerformanceConfiguration ==
== SetPerformanceConfiguration ==
Takes u32 [[#PerformanceMode]] and u32 [[#PerformanceConfiguration]].
Takes an u32 [[#PerformanceMode]] and an u32 [[#PerformanceConfiguration]].


== GetPerformanceConfiguration ==
== GetPerformanceConfiguration ==
Takes u32 [[#PerformanceMode]], returns output u32 [[#PerformanceConfiguration]].
Takes an u32 [[#PerformanceMode]] and returns an output u32 [[#PerformanceConfiguration]].
 
== PerformanceMode ==
{| class="wikitable" border="1"
|-
! Value || Name
|-
| 0 || Handheld
|-
| 1 || Docked
|}
 
== PerformanceConfiguration ==
{| class="wikitable" border="1"
|-
! Value || CPU clock || GPU clock || Memory clock
|-
| 0x00010000 || 1020 || 384 || 1600
|-
| 0x00010001 || 1020 || 768 || 1600
|-
| 0x00010002 || 1224 || 691.2 || 1600
|-
| 0x00020000 || 1020 || 230.4 || 1600
|-
| 0x00020001 || 1020 || 307.2 || 1600
|-
| 0x00020002 || 1224|| 230.4 || 1600
|-
| 0x00020003 || 1020 || 307 || 1331.2
|-
| 0x00020004 || 1020 || 384 || 1331.2
|-
| 0x00020005 || 1020 || 307.2 || 1065.6
|-
| 0x00020006 || 1020 || 384 || 1065.6
|-
| 0x92220007 || 1020  || 460.8 || 1600
|-
| 0x92220008 || 1020 || 460.8 || 1331.2
|}
Clocks are all in MHz.
 
Configurations 0x10001 and 0x20000 are only available while docked. Configurations 0x10002 and 0x20002 are only available for SDEV units.


Some of these require apm:p.
== SetCpuOverclockEnabled ==
Takes an input u8 bool, no output.


= fgm, fgm:0, fgm:9 =
= fgm, fgm:0, fgm:9 =
Line 164: Line 141:
|}
|}


= Settings =
= CpuBoostMode =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Key || Size || Notes
! Value || Description
|-
|-
| battery_draining_enabled || 1 || ?
| 0 || Disabled.
|-
|-
| performance_mode_policy || strlen || "auto": use boost mode when docked. "normal": never use boost mode. "boost": always use boost mode (SDEV only).
| 1 || Boost CPU. Additionally, throttle GPU to minimum.
Use [[#PerformanceConfiguration|performance configurations]] 0x92220009 and 0x9222000A, or 0x9222000B and 0x9222000C.
|-
|-
| sdev_cpu_overclock_enabled || 1 || SDEV only. Used to allow access to 1224MHz CPU mode.
| 2 || Conserve power. Only throttle GPU to minimum.
Use [[#PerformanceConfiguration|performance configurations]] 0x9222000B and 0x9222000C.
|}
 
= PerformanceMode =
{| class="wikitable" border="1"
|-
|-
| sdev_throttling_additional_delay_us || 4 || SDEV only.
! Value || Description
|-
|-
| sdev_throttling_additional_delay_enabled || 1 || SDEV only.
| -1 || Invalid
|-
|-
| throttling_for_smpd_enabled || 1 || Not used as of 3.0.
| 0 || Normal
|-
|-
| throttling_for_undock_enabled || 1 || Not used as of 3.0.
| 1 || Boost
|}
|}
= 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.
Some of these require apm:p.


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