Changes

Jump to navigation Jump to search
3,475 bytes added ,  19:49, 30 January 2021
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.
   −
== apm ==
+
[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 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"
 
|-
 
|-
! Cmd || Name || Notes
+
! Cmd || Name
 
|-
 
|-
| 0 || OpenSession || Returns an [[#ISession]].
+
| 0 || [[#OpenSession]]
 
|-
 
|-
| 1 || GetPerformanceMode ||  
+
| 1 || GetPerformanceMode
 +
|-
 +
| 6 || [7.0.0+] [[#IsCpuOverclockEnabled]]
 
|}
 
|}
   −
== apm:p ==
+
== OpenSession ==
 +
Returns an [[#ISession]].
 +
 
 +
== IsCpuOverclockEnabled ==
 +
No input, returns an output u8 bool.
 +
 
 +
= 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"
 
|-
 
|-
! Cmd || Name || Notes
+
! Cmd || Name
 
|-
 
|-
| 0 || OpenSession || Returns an [[#ISession]].
+
| 0 || OpenSession
 
|}
 
|}
   −
== apm:sys ==
+
== 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".
 
This is "nn::apm::ISystemManager".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || RequestPerformanceMode
 +
|-
 +
| 1 || GetPerformanceEvent
 +
|-
 +
| 2 || GetThrottlingState
 +
|-
 +
| 3 || GetLastThrottlingState
 +
|-
 +
| 4 || ClearLastThrottlingState
 +
|-
 +
| 5 || [5.0.0+] LoadAndApplySettings
 +
|-
 +
| 6 || [7.0.0+] [[#SetCpuBoostMode]]
 +
|-
 +
| 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
 +
|}
 +
 
 +
== 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"
 +
|-
 +
! 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"
 +
|-
 +
! Cmd || Name
 
|-
 
|-
| 0 || RequestPerformanceMode ||
+
| 0 || Initialize
 +
|}
 +
 
 +
== IRequest ==
 +
This is "nn::fgm::sf::IRequest".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 
|-
 
|-
| 1 || GetPerformanceEvent || Returns an [[#ISession]].
+
| 0 || Initialize
 
|-
 
|-
| 2 || GetThrottlingState ||  
+
| 1 || Set
 
|-
 
|-
| 3 || GetLastThrottlingState ||  
+
| 2 || Get
 
|-
 
|-
| 4 || ClearLastThrottlingState ||  
+
| 3 || Cancel
 
|}
 
|}
   −
== ISession ==
+
= fgm:dbg =
 +
This is "nn::fgm::sf::IDebugger".
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || Initialize
 +
|-
 +
| 1 || Read
 +
|-
 +
| 2 || Cancel
 +
|}
 +
 
 +
= CpuBoostMode =
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value || Description
 +
|-
 +
| 0 || Disabled.
 
|-
 
|-
| 0 || SetPerformanceConfiguration || Takes u32 PerformanceMode and u32 PerformanceConfiguration.
+
| 1 || Boost CPU. Additionally, throttle GPU to minimum.
 +
Use [[#PerformanceConfiguration|performance configurations]] 0x92220009 and 0x9222000A, or 0x9222000B and 0x9222000C.
 
|-
 
|-
| 1 || GetPerformanceConfiguration  || Takes u32 PerformanceMode, returns output u32 PerformanceConfiguration.
+
| 2 || Conserve power. Only throttle GPU to minimum.
 +
Use [[#PerformanceConfiguration|performance configurations]] 0x9222000B and 0x9222000C.
 
|}
 
|}
   −
=== PerformanceMode ===
+
= PerformanceMode =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Value || Name
+
! Value || Description
 +
|-
 +
| -1 || Invalid
 
|-
 
|-
| 0 || Handheld
+
| 0 || Normal
 
|-
 
|-
| 1 || Docked
+
| 1 || Boost
 
|}
 
|}
   −
=== PerformanceConfiguration ===
+
= PerformanceConfiguration =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Value || CPU clock || GPU clock || Memory clock
+
! Value || Description || CPU clock (MHz) || GPU clock (MHz) || Memory clock (MHz)
 
|-
 
|-
| 0x00010000 || 1020 || 384 || 1600
+
| 0x00000000 || Invalid || 0 || 0 || 0
 
|-
 
|-
| 0x00010001 || 1020 || 768 || 1600
+
| 0x00010000 || Cpu1020MhzGpu384Mhz || 1020.0 || 384.0 || 1600.0
 
|-
 
|-
| 0x00010002 || 1224 || 691.2 || 1600
+
| 0x00010001 || Cpu1020MhzGpu768Mhz || 1020.0 || 768.0 || 1600.0
 
|-
 
|-
| 0x00020000 || 1020 || 230.4 || 1600
+
| 0x00010002 || Cpu1224MhzGpu691Mhz || 1224.0 || 691.2 || 1600.0
 
|-
 
|-
| 0x00020001 || 1020 || 307.2 || 1600
+
| 0x00020000 || Cpu1020MhzGpu230Mhz|| 1020.0 || 230.4 || 1600.0
 
|-
 
|-
| 0x00020002 || 1224|| 230.4 || 1600
+
| 0x00020001 || Cpu1020MhzGpu307Mhz || 1020.0 || 307.2 || 1600.0
 
|-
 
|-
| 0x00020003 || 1020 || 307 || 1331.2
+
| 0x00020002 || Cpu1224MhzGpu230Mhz || 1224.0 || 230.4 || 1600.0
 
|-
 
|-
| 0x00020004 || 1020 || 384 || 1331.2
+
| 0x00020003 || Cpu1020MhzGpu307MhzEmc1331Mhz || 1020.0 || 307.2 || 1331.2
 
|-
 
|-
| 0x00020005 || 1020 || 307.2 || 1065.6
+
| 0x00020004 || Cpu1020MhzGpu384MhzEmc1331Mhz || 1020.0 || 384.0 || 1331.2
 
|-
 
|-
| 0x00020006 || 1020 || 384 || 1065.6
+
| 0x00020005 || Cpu1020MhzGpu307MhzEmc1065Mhz || 1020.0 || 307.2 || 1065.6
 
|-
 
|-
| 0x92220007 || 1020 || 460.8 || 1600
+
| 0x00020006 || Cpu1020MhzGpu384MhzEmc1065Mhz || 1020.0 || 384.0 || 1065.6
 
|-
 
|-
| 0x92220008 || 1020 || 460.8 || 1331.2
+
| 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
 
|}
 
|}
Clocks are all in MHz.
     −
Configurations 0x10001 and 0x20000 are only available while docked. Configurations 0x10002 and 0x20002 do not seem to be available at all (dependent on apm settings?).
+
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.
 
Some of these require apm:p.
   −
== Settings ==
+
= Settings =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Key || Size || Notes
 
! Key || Size || Notes
 
|-
 
|-
| battery_draining_enabled|| 1 || ?
+
| background_download_stress_testing_storage || strlen || "sdcard", "builtin", "system".
 +
|-
 +
| battery_draining_enabled || 1 || ?
 +
|-
 +
| fs_access_log_mode || strlen || "log", "sdcard", "log+sdcard", "off".
 +
|-
 +
| fs_speed_emulation_mode || strlen || "faster", "slower", "random", "off".
 +
|-
 +
| host_romfs_redirection_target || strlen || "builtin", "off".
 +
|-
 +
| idle_time_detect_mode || strlen || "on", "off".
 +
|-
 +
| initial_tick_value || strlen || "7days", "14days", "30days", "90days", "hex": ?.
 +
|-
 +
| memory_mode || strlen || "auto", "4GB", "6GB".
 +
|-
 +
| needs_update_vulnerability_policy || strlen || "default": ?, "force_true": ?, "force_false": ?.
 +
|-
 +
| operation_mode_policy || strlen || "auto": ?, "handheld", "console".
 +
|-
 +
| performance_mode_policy || strlen || "auto": use boost mode when docked. "normal": never use boost mode. "boost": always use boost mode (SDEV only).
 +
|-
 +
| screenshot_target || strlen || "screenshot": ?, "physical": ?.
 
|-
 
|-
| performance_mode_policy|| strlen || "auto": use boost mode when docked. "normal": never use boost mode. "boost": always use boost mode (devkit only).
+
| sdev_cpu_overclock_enabled || 1 || SDEV only. Used to allow access to 1224MHz CPU mode.
 
|-
 
|-
| sdev_cpu_overclock_enabled || 1 || Not used as of 3.0. May have been used to allow access to 1224MHz CPU mode?
+
| sdev_throttling_additional_delay_us || 4 || SDEV only.
 
|-
 
|-
| sdev_throttling_additional_delay_us || 4 || ?
+
| sdev_throttling_additional_delay_enabled || 1 || SDEV only.
 
|-
 
|-
| sdev_throttling_additional_delay_enabled || 1 || ?
+
| sleep_mode || strlen || "default": ?, "pseudo": ?.
 
|-
 
|-
 
| throttling_for_smpd_enabled || 1 || Not used as of 3.0.
 
| throttling_for_smpd_enabled || 1 || Not used as of 3.0.

Navigation menu