PTM services: Difference between revisions
No edit summary |
|||
Line 6: | Line 6: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || OpenController | | 0 || [[#OpenController]] | ||
|} | |} | ||
== OpenController == | |||
Takes an input u32. Returns an output [[#IController]]. | |||
== IController == | == IController == | ||
Line 78: | Line 81: | ||
| 17 || [[#GetBatteryChargeInfoFields]] | | 17 || [[#GetBatteryChargeInfoFields]] | ||
|- | |- | ||
| 18 || [3.0.0+] GetBatteryChargeCalibratedEvent | | 18 || [3.0.0+] [[#GetBatteryChargeCalibratedEvent]] | ||
|} | |} | ||
== GetBatteryChargePercentage == | == GetBatteryChargePercentage == | ||
No input | No input. Returns an output u32. | ||
== GetChargerType == | == GetChargerType == | ||
No input | No input. Returns an output [[#ChargerType|ChargerType]]. | ||
== EnableBatteryCharging == | == EnableBatteryCharging == | ||
Line 94: | Line 97: | ||
== IsBatteryChargingEnabled == | == IsBatteryChargingEnabled == | ||
No input | No input. Returns an output bool. | ||
== AcquireControllerPowerSupply == | == AcquireControllerPowerSupply == | ||
Line 103: | Line 106: | ||
== OpenSession == | == OpenSession == | ||
No input | No input. Returns an output [[#IPsmSession]]. | ||
== EnableEnoughPowerChargeEmulation == | == EnableEnoughPowerChargeEmulation == | ||
Line 118: | Line 121: | ||
== GetBatteryVoltageState == | == GetBatteryVoltageState == | ||
No input | No input. Returns an output [[#BatteryVoltageState|BatteryVoltageState]]. | ||
== GetRawBatteryChargePercentage == | == GetRawBatteryChargePercentage == | ||
No input | No input. Returns an output double. | ||
== IsEnoughPowerSupplied == | == IsEnoughPowerSupplied == | ||
No input | No input. Returns an output bool. | ||
== GetBatteryAgePercentage == | == GetBatteryAgePercentage == | ||
No input | No input. returns an output double. | ||
== GetBatteryChargeInfoEvent == | == GetBatteryChargeInfoEvent == | ||
No input | No input. returns an output Event handle. | ||
== GetBatteryChargeInfoFields == | == GetBatteryChargeInfoFields == | ||
No input | No input. Returns an output [[#BatteryChargeInfoFields|BatteryChargeInfoFields]]. | ||
=== | == GetBatteryChargeCalibratedEvent == | ||
No input. returns an output Event handle. | |||
== IPsmSession == | == IPsmSession == | ||
Line 218: | Line 160: | ||
=== BindStateChangeEvent === | === BindStateChangeEvent === | ||
No input | No input. Returns an output Event handle with EventClearMode=0. | ||
=== UnbindStateChangeEvent === | === UnbindStateChangeEvent === | ||
Line 224: | Line 166: | ||
=== SetChargerTypeChangeEventEnabled === | === SetChargerTypeChangeEventEnabled === | ||
Takes an input | Takes an input bool. No output. | ||
=== SetPowerSupplyChangeEventEnabled === | === SetPowerSupplyChangeEventEnabled === | ||
Takes an input | Takes an input bool. No output. | ||
=== SetBatteryVoltageStateChangeEventEnabled === | === SetBatteryVoltageStateChangeEventEnabled === | ||
Takes an input | Takes an input bool. No output. | ||
= tc = | = tc = | ||
Line 279: | Line 221: | ||
| 4 || [8.0.0+] ? (Takes a total of 4-bytes of input, returns an [[#IUnknown0]]) | | 4 || [8.0.0+] ? (Takes a total of 4-bytes of input, returns an [[#IUnknown0]]) | ||
|} | |} | ||
== GetTemperatureRange == | |||
Takes an u8 [[#Location]] and returns an s32 minimum temperature + s32 maximum temperature. | |||
The returned temperature values are in Celsius. | |||
== GetTemperature == | |||
Takes an u8 [[#Location]] and returns an output s32. | |||
The output is the temperature in Celsius. | |||
== SetMeasurementMode == | |||
Takes an u8 [[#Location]] and an u8 MeasurementMode, no output. | |||
== GetTemperatureMilliC == | |||
Takes an u8 [[#Location]] and returns an output s32. | |||
The output is the temperature in MilliC. | |||
== IUnknown0 == | == IUnknown0 == | ||
Line 297: | Line 257: | ||
| 4 || [10.0.0+] | | 4 || [10.0.0+] | ||
|} | |} | ||
= pcm = | = pcm = | ||
Line 345: | Line 287: | ||
| 0 || [[#OpenSession]] | | 0 || [[#OpenSession]] | ||
|- | |- | ||
| 1 || GetPerformanceMode | | 1 || [[#GetPerformanceMode]] | ||
|- | |- | ||
| 6 || [7.0.0+] [[#IsCpuOverclockEnabled]] | | 6 || [7.0.0+] [[#IsCpuOverclockEnabled]] | ||
Line 351: | Line 293: | ||
== OpenSession == | == OpenSession == | ||
Returns an [[#ISession]]. | No input. Returns an output [[#ISession]]. | ||
== GetPerformanceMode == | |||
No input. Returns an output [[#PerformanceMode]]. | |||
== IsCpuOverclockEnabled == | == IsCpuOverclockEnabled == | ||
No input | No input. Returns an output bool. | ||
= apm:sys = | = apm:sys = | ||
Line 363: | Line 308: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || RequestPerformanceMode | | 0 || [[#RequestPerformanceMode]] | ||
|- | |- | ||
| 1 || GetPerformanceEvent | | 1 || [[#GetPerformanceEvent]] | ||
|- | |- | ||
| 2 || GetThrottlingState | | 2 || [[#GetThrottlingState]] | ||
|- | |- | ||
| 3 || GetLastThrottlingState | | 3 || [[#GetLastThrottlingState]] | ||
|- | |- | ||
| 4 || ClearLastThrottlingState | | 4 || [[#ClearLastThrottlingState]] | ||
|- | |- | ||
| 5 || [5.0.0+] LoadAndApplySettings | | 5 || [5.0.0+] [[#LoadAndApplySettings]] | ||
|- | |- | ||
| 6 || [7.0.0+] [[#SetCpuBoostMode]] | | 6 || [7.0.0+] [[#SetCpuBoostMode]] | ||
Line 379: | Line 324: | ||
| 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]] | | 7 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]] | ||
|} | |} | ||
== RequestPerformanceMode == | |||
Takes an input [[#PerformanceMode]]. No output. | |||
== GetPerformanceEvent == | == GetPerformanceEvent == | ||
Returns an [[# | Takes an input [[#EventTarget]]. Returns an Event handle with EventClearMode 0. | ||
== GetThrottlingState == | |||
No input. Returns an output [[#ThrottlingState]]. | |||
== GetLastThrottlingState == | |||
No input. Returns an output [[#ThrottlingState]]. | |||
== ClearLastThrottlingState == | |||
No input/output. | |||
== LoadAndApplySettings == | |||
No input/output. | |||
== SetCpuBoostMode == | == SetCpuBoostMode == | ||
Takes an | Takes an input [[#CpuBoostMode]]. No output. | ||
== GetCurrentPerformanceConfiguration == | == GetCurrentPerformanceConfiguration == | ||
Returns | No input. Returns an output [[#PerformanceConfiguration]] (default value is 0x00020003). | ||
= ISession = | = ISession = | ||
Line 396: | Line 356: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || SetPerformanceConfiguration | | 0 || [[#SetPerformanceConfiguration]] | ||
|- | |- | ||
| 1 || GetPerformanceConfiguration | | 1 || [[#GetPerformanceConfiguration]] | ||
|- | |- | ||
| 2 || [8.0.0+] [[#SetCpuOverclockEnabled]] | | 2 || [8.0.0+] [[#SetCpuOverclockEnabled]] | ||
Line 404: | Line 364: | ||
== SetPerformanceConfiguration == | == SetPerformanceConfiguration == | ||
Takes an | Takes an input [[#PerformanceMode]] and an input [[#PerformanceConfiguration]]. No output. | ||
== GetPerformanceConfiguration == | == GetPerformanceConfiguration == | ||
Takes an | Takes an input [[#PerformanceMode]]. Returns an output [[#PerformanceConfiguration]]. | ||
== SetCpuOverclockEnabled == | == SetCpuOverclockEnabled == | ||
Takes an input | Takes an input bool. No output. | ||
= fgm, fgm:0, fgm:1, fgm:2, fgm:3, fgm:4, fgm:5, fgm:6, fgm:7, fgm:9 = | = fgm, fgm:0, fgm:1, fgm:2, fgm:3, fgm:4, fgm:5, fgm:6, fgm:7, fgm:9 = | ||
These are "nn::fgm::sf::ISession". | These are "nn::fgm::sf::ISession". | ||
Each service represents a different priority from 0 to 9. The "fgm" service represents priority 8 ( | Each service represents a different priority from 0 (Highest/Thermal) to 9 (Lowest). The "fgm" service represents priority 8 (Default). | ||
[2.0.0+] Only "fgm", "fgm:0" and "fgm:9" are now valid. | [2.0.0+] Only "fgm", "fgm:0" and "fgm:9" are now valid. | ||
Line 427: | Line 387: | ||
== Initialize == | == Initialize == | ||
No input. Returns an [[#IRequest]]. | No input. Returns an output [[#IRequest]]. | ||
== IRequest == | == IRequest == | ||
Line 446: | Line 406: | ||
=== Initialize === | === Initialize === | ||
Takes a PID-descriptor, a [[#Module]] and | Takes a PID-descriptor, a [[#Module|ModuleId]] and a reserved input u64. Returns an Event handle with EventClearMode 0. | ||
=== Set === | === Set === | ||
Takes 2 u32s ''' | Takes 2 u32s '''ClockRateMin''' and '''ClockRateMax'''. No output. | ||
=== Get === | === Get === | ||
No input. Returns an u32 ''' | No input. Returns an u32 '''ClockRateActual'''. | ||
=== Cancel === | === Cancel === | ||
Line 464: | Line 424: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || Initialize | | 0 || [[#Initialize_3|Initialize]] | ||
|- | |- | ||
| 1 || Read | | 1 || [[#Read|Read]] | ||
|- | |- | ||
| 2 || Cancel | | 2 || [[#Cancel_2|Cancel]] | ||
|} | |} | ||
== Initialize == | |||
Takes the current process handle (0xFFFF8001) and an input u64 '''MemorySize'''. Returns an Event handle with EventClearMode 0. | |||
== Read == | |||
Takes a type-0x6 output buffer of [[#DebugEntry|DebugEntry]]. Returns three output s32s '''NumberReadOut''', '''NumberLostOut''' and '''NumberRemainingOut'''. | |||
== Cancel == | |||
No input/output. | |||
= lbl = | = lbl = | ||
Line 514: | Line 483: | ||
| 15 || SetAmbientLightSensorValue | | 15 || SetAmbientLightSensorValue | ||
|- | |- | ||
| 16 || | | 16 || GetAmbientLightSensorValue | ||
|- | |- | ||
| 17 || SetBrightnessReflectionDelayLevel | | 17 || SetBrightnessReflectionDelayLevel | ||
Line 534: | Line 503: | ||
| 25 || [3.0.0+] GetCurrentBrightnessSettingForVrMode | | 25 || [3.0.0+] GetCurrentBrightnessSettingForVrMode | ||
|- | |- | ||
| 26 || [3.0.0+] | | 26 || [3.0.0+] EnableVrMode | ||
|- | |- | ||
| 27 || [3.0.0+] | | 27 || [3.0.0+] DisableVrMode | ||
|- | |- | ||
| 28 || [3.0.0+] | | 28 || [3.0.0+] IsVrModeEnabled | ||
|- | |- | ||
| 29 || [7.0.0+] IsAutoBrightnessControlSupported | | 29 || [7.0.0+] IsAutoBrightnessControlSupported | ||
|} | |} | ||
= | = ChargerType = | ||
This is "nn::psm::ChargerType". | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
! | ! Value || Name | ||
|- | |||
| 0 || Unconnected | |||
|- | |||
| 1 || EnoughPower | |||
|- | |- | ||
| | | 2 || LowPower | ||
|- | |- | ||
| | | 3 || NotSupported | ||
|} | |} | ||
= | = BatteryVoltageState = | ||
This is "nn::psm::BatteryVoltageState". | |||
== | {| class="wikitable" border="1" | ||
|- | |||
! Value || Name | |||
|- | |||
| 0 || ShutdownRequired | |||
|- | |||
| 1 || SleepRequired | |||
|- | |||
| 2 || BoostPerformanceModeProhibited | |||
|- | |||
| 3 || Good | |||
|} | |||
= | = BatteryChargeInfoFields = | ||
This is a 0x40-byte struct. | |||
== | {| class="wikitable" border="1" | ||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x00 || 0x4 || u32. Input (Sink) current limit in mA | |||
== | |- | ||
| 0x04 || 0x4 || u32. Output (Source/Vbus/OTG) current limit in mA | |||
|- | |||
| 0x08 || 0x4 || u32. Battery charging current limit in mA | |||
|- | |||
| 0x0C || 0x4 || u32. Battery charging voltage limit in mV | |||
|- | |||
| 0x10 || 0x4 || enum, same as power-role? Always 1 except when OTG where it becomes 2 | |||
|- | |||
| 0x14 || 0x4 || Possibly a bit field | |||
|- | |||
| 0x18 || 0x4 || u32. Charging limits state based on battery temperature | |||
|- | |||
| 0x1C || 0x4 || u32. Battery Temperature (milli C) | |||
|- | |||
| 0x20 || 0x4 || u32. Capacity now per cent-mille (i.e. 100% = 100000 pcm) | |||
|- | |||
| 0x24 || 0x4 || u32. Voltage avg in mV | |||
|- | |||
| 0x28 || 0x4 || u32. Battery age (capacity full / capacity design) per cent-mille (i.e. 100% = 100000 pcm) | |||
|- | |||
| 0x2C || 0x4 || enum. Power role (0: Unknown, 1: Sink, 2: Source) | |||
|- | |||
| 0x30 || 0x4 || enum. [[#Charger_Type]] | |||
|- | |||
| 0x34 || 0x4 || u32. Charger voltage limit in mV | |||
|- | |||
| 0x38 || 0x4 || u32. Charger current limit in mA | |||
|- | |||
| 0x3C || 0x4 || Bit field (bit0: potentially no hub, bit8: Joy-con charging, bit12: OTG) | |||
|} | |||
= Location = | = Location = | ||
Line 593: | Line 595: | ||
= CpuBoostMode = | = CpuBoostMode = | ||
This is "nn::apm::CpuBoostMode". | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
Line 607: | Line 611: | ||
= PerformanceMode = | = PerformanceMode = | ||
This is "nn::apm::PerformanceMode". | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
Line 619: | Line 625: | ||
= PerformanceConfiguration = | = PerformanceConfiguration = | ||
This is "nn::apm::PerformanceConfiguration". | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
Line 659: | Line 667: | ||
Configurations 0x10001 and 0x20000 are only available while docked. Configurations 0x10002 and 0x20002 are only available for SDEV units. | Configurations 0x10001 and 0x20000 are only available while docked. Configurations 0x10002 and 0x20002 are only available for SDEV units. | ||
= EventTarget = | |||
This is "nn::apm::EventTarget". | |||
{| class="wikitable" border="1" | |||
|- | |||
! Value || Description | |||
|- | |||
| 0 || PerformanceModeChanged | |||
|- | |||
| 1 || SleepRequiredByLowVoltage | |||
|} | |||
= ThrottlingState = | |||
This is "nn::apm::ThrottlingState". | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x0 || 0x8 || DurationNanoSeconds | |||
|- | |||
| 0x8 || 0x4 || ThrottlingRateCpuDividend | |||
|- | |||
| 0xC || 0x4 || ThrottlingRateCpuDivisor | |||
|- | |||
| 0x10 || 0x4 || ThrottlingRateGpuDividend | |||
|- | |||
| 0x14 || 0x4 || ThrottlingRateGpuDivisor | |||
|- | |||
| 0x18 || 0x4 || ThrottleStatus | |||
|- | |||
| 0x1C || 0x4 || CpuPSkipStatus | |||
|- | |||
| 0x20 || 0x4 || GpuPSkipStatus | |||
|- | |||
| 0x24 || 0x1 || Enabled | |||
|- | |||
| 0x25 || 0x1 || Invoked | |||
|- | |||
| 0x26 || 0x2 || Reserved | |||
|} | |||
= Module = | = Module = | ||
Line 667: | Line 717: | ||
! Name || Block | ! Name || Block | ||
|- | |- | ||
| 0 || | | 0 || Cpu | ||
|- | |||
| 1 || Gpu | |||
|- | |||
| 2 || Emc | |||
|- | |||
| 3 || SysBus | |||
|- | |||
| 4 || Mselect | |||
|- | |||
| 5 || Nvdec | |||
|- | |||
| 6 || Nvenc | |||
|- | |||
| 7 || Nvjpg | |||
|- | |- | ||
| | | 8 || Test | ||
|} | |||
= EventId = | |||
This is "nn::fgm::EventId". | |||
{| class="wikitable" border="1" | |||
|- | |- | ||
| | ! Name || Block | ||
|- | |- | ||
| | | 0 || Set | ||
|- | |||
| 1 || Unset | |||
|- | |||
| 2 || Completion | |||
|} | |||
= DebugEntry = | |||
This is "nn::fgm::DebugEntry". | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x0 || 0x4 || [[#EventId|EventId]] | |||
|- | |||
| 0x4 || 0x4 || [[#Module|ModuleId]] | |||
|- | |||
| 0x8 || 0x8 || Timestamp | |||
|- | |||
| 0x10 || 0x40 || [[#RequestEntry|RequestEntry]] (EventId = Set), empty (EventId = Unset) or [[#CompletionEntry|CompletionEntry]] (EventId = Completion) | |||
|} | |||
= RequestEntry = | |||
This is "nn::fgm::RequestEntry". | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x0 || 0x8 || ProcessId | |||
|- | |||
| 0x8 || 0x4 || Priority | |||
|- | |||
| 0xC || 0x4 || ClockRateMin | |||
|- | |||
| 0x10 || 0x4 || ClockRateMax | |||
|- | |||
| 0x14 || 0x2C || Reserved | |||
|} | |||
= CompletionEntry = | |||
This is "nn::fgm::CompletionEntry". | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |- | ||
| | | 0x0 || 0x4 || ClockRateMin | ||
|- | |- | ||
| | | 0x4 || 0x4 || ClockRateMax | ||
|- | |- | ||
| | | 0x8 || 0x4 || ClockRateActual | ||
|- | |- | ||
| | | 0xC || 0x34 || Reserved | ||
|} | |} | ||