PPC services

Revision as of 14:51, 16 April 2019 by Hexkyz (talk | contribs) (→‎apm)

APM is utilized for setting system performance profiles including clocks for CPU, GPU, and memory.

apm

This is "nn::apm::IManager".

This was moved to AM with [8.0.0+].

Cmd Name
0 #OpenSession
1 GetPerformanceMode
6 [7.0.0+] IsCpuOverclockEnabled

OpenSession

Returns an #ISession.

apm:p

This is "nn::apm::IManagerPrivileged".

This service no longer exists in [8.0.0+].

Cmd Name
0 OpenSession

OpenSession

Returns an #ISession.

apm:sys

This is "nn::apm::ISystemManager".

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.

CpuBoostMode

Mode Description
0 Disabled.
1 Use performance configurations 0x92220009 and 0x9222000A, or 0x9222000B and 0x9222000C.
2 Use performance configurations 0x9222000B and 0x9222000C.

GetCurrentPerformanceConfiguration

Returns the currently active #PerformanceConfiguration (default value is 0x00020003).

ISession

This is "nn::apm::ISession".

Cmd Name
0 SetPerformanceConfiguration
1 GetPerformanceConfiguration
2 [8.0.0+]

SetPerformanceConfiguration

Takes an u32 #PerformanceMode and an u32 #PerformanceConfiguration.

GetPerformanceConfiguration

Takes an u32 #PerformanceMode and returns an output u32 #PerformanceConfiguration.

PerformanceMode

Value Name
0 Handheld
1 Docked

PerformanceConfiguration

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
[7.0.0+] 0x92220009 1785 768 1600
[7.0.0+] 0x9222000A 1785 768 1331.2
[7.0.0+] 0x9222000B 1020 768 1600
[7.0.0+] 0x9222000C 1020 768 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.

fgm, fgm:0, fgm:9

This is "nn::fgm::sf::ISession".

Cmd Name
0 Initialize

IRequest

This is "nn::fgm::sf::IRequest".

Cmd Name
0 Initialize
1 Set
2 Get
3 Cancel

fgm:dbg

This is "nn::fgm::sf::IDebugger".

Cmd Name
0 Initialize
1 Read
2 Cancel

Settings

Key Size Notes
battery_draining_enabled 1 ?
performance_mode_policy strlen "auto": use boost mode when docked. "normal": never use boost mode. "boost": always use boost mode (SDEV only).
sdev_cpu_overclock_enabled 1 SDEV only. Used to allow access to 1224MHz CPU mode.
sdev_throttling_additional_delay_us 4 SDEV only.
sdev_throttling_additional_delay_enabled 1 SDEV only.
throttling_for_smpd_enabled 1 Not used as of 3.0.
throttling_for_undock_enabled 1 Not used as of 3.0.