PCV services: Difference between revisions
→Power Switch / Clocking / Reset: add debug block names |
mNo edit summary |
||
(11 intermediate revisions by 4 users not shown) | |||
Line 22: | Line 22: | ||
| 7 || [2.0.0+] GetPowerEvent | | 7 || [2.0.0+] GetPowerEvent | ||
|- | |- | ||
| 8 || [2.0.0+] | | 8 || [2.0.0+] CreateWakeupTimer | ||
|- | |- | ||
| 9 || [2.0.0+] | | 9 || [2.0.0+] CancelWakeupTimer | ||
|- | |- | ||
| 10 || [2.0.0+] | | 10 || [2.0.0+] [[#EnableWakeupTimerOnDevice]] | ||
|- | |- | ||
| 11 || [3.0.0+] | | 11 || [3.0.0+] CreateWakeupTimerEx | ||
|- | |- | ||
| 12 || [3.0.0+] | | 12 || [3.0.0+] GetLastEnabledWakeupTimerType | ||
|- | |- | ||
| 13 || [3.0.0+] | | 13 || [3.0.0+] CleanAllWakeupTimers | ||
|- | |- | ||
| 14 || [6.0.0+] | | 14 || [6.0.0+] | ||
|} | |} | ||
== EnableWakeupTimerOnDevice == | |||
No input, returns a total of 0x10-bytes of output. [3.0.0+] Now returns a total of 0xC-bytes of output. | |||
= bpc:r = | = bpc:r = | ||
This is "nn::bpc::IRtcManager". | This is "nn::bpc::IRtcManager". | ||
This service no longer exists in [9.0.0+]. | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
Line 44: | Line 49: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || | | 0 || GetRtcTime | ||
|- | |- | ||
| 1 || | | 1 || SetRtcTime | ||
|- | |- | ||
| 2 || | | 2 || GetRtcResetDetected | ||
|- | |- | ||
| 3 || [2.0.0+] | | 3 || [2.0.0+] ClearRtcResetDetected | ||
|- | |- | ||
| 4 || [3.0.0+] | | 4 || [3.0.0+] SetUpRtcResetOnShutdown | ||
|} | |} | ||
GetRtcTime / SetRtcTime directly accesses the max77620_rtc0 device. | |||
= pcv = | = pcv = | ||
Line 120: | Line 125: | ||
| 27 || [5.0.0+] GetDramId | | 27 || [5.0.0+] GetDramId | ||
|- | |- | ||
| [6.0.0-7.0.1] 28 || | | [6.0.0-7.0.1] 28 || [[#IsPoweredOn]] | ||
|- | |- | ||
| [6.0.0-7.0.1] 29 || | | [6.0.0-7.0.1] 29 || [[#GetVoltage]] | ||
|} | |} | ||
[7.0.0+] The type-0xA output buffers were replaced with type-0x22 output buffers, for the following: GetDvfsTable, GetModuleStateTable, and GetPowerDomainStateTable. | [7.0.0+] The type-0xA output buffers were replaced with type-0x22 output buffers, for the following: GetDvfsTable, GetModuleStateTable, and GetPowerDomainStateTable. | ||
== IsPoweredOn == | |||
Takes an u32 '''PowerControlTarget''' and returns a bool indicating the status of the requested [[#Voltage|voltage block]]. | |||
== GetVoltage == | |||
Takes an u32 '''PowerControlTarget''' and returns an u32 voltage value for the requested [[#Voltage|voltage block]]. | |||
== Modules == | == Modules == | ||
Line 517: | Line 528: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || | | 0 || GetRtcTime | ||
|- | |- | ||
| 1 || | | 1 || SetRtcTime | ||
|- | |- | ||
| 2 || | | 2 || SetRtcClientUnknownBool | ||
|- | |- | ||
| 3 || | | 3 || GetRtcResetDetected | ||
|- | |- | ||
| 4 || | | 4 || ClearRtcResetDetected | ||
|} | |} | ||
Commands 0, 1, 3, 4 call the same internal functions as bpc:r, except they take an extra u32 [[Bus_services#Known_Devices_2|device code]], where bpc:r hardcodes 0x3B000001 (max77620_rtc0). | |||
Command 2 takes a u8 bool and a u32 device code; it opens an i2c session to the device code, and sets *(i2c_session_client_object + 0x38) = bool. | |||
= time:u, time:a, time:s = | = time:u, time:a, time:s = | ||
This is "nn::timesrv::detail::service::IStaticService". | This is "nn::timesrv::detail::service::IStaticService". | ||
[9.0.0+] These services were moved to [[Glue_services|Glue]] and [[PSC_services|PSC]]. | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
Line 628: | Line 645: | ||
| 2 || GetSystemClockContext || Returns an output [[#SystemClockContext]]. | | 2 || GetSystemClockContext || Returns an output [[#SystemClockContext]]. | ||
|- | |- | ||
| 3 || SetSystemClockContext | | 3 || SetSystemClockContext || Takes an input [[#SystemClockContext]]. | ||
|- | |||
| 4 || [9.0.0+] GetOperationEventReadableHandle || | |||
|} | |} | ||
=== PosixTime === | === PosixTime === | ||
This is an | This is an s64 for UTC POSIX time. | ||
=== SystemClockContext === | === SystemClockContext === | ||
Line 686: | Line 705: | ||
This is loaded from the [[Title_list|TimeZoneBinary]] title with the specified LocationName under the zoneinfo/ directory, the content is then converted into this TimeZoneRule structure. | This is loaded from the [[Title_list|TimeZoneBinary]] title with the specified LocationName under the zoneinfo/ directory, the content is then converted into this TimeZoneRule structure. | ||
The files contained under zoneinfo/ directory are Tzif2 files without Tzif1 header and data at the begining of them (see [https://tools.ietf.org/html/rfc8536 RFC8536] for more information). | |||
The conversion of a Tzif2 file to a TimeZoneRule structure is based on [https://github.com/eggert/tz/blob/master/localtime.c tz database code] with some custom modifications (Leap seconds aren't handled, no usage of "posixrules" and Tzif1 support stripped out). | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x0 || 0x4 || timecnt | |||
|- | |||
| 0x4 || 0x4 || typecnt | |||
|- | |||
| 0x8 || 0x4 || charcnt | |||
|- | |||
| 0xC || 0x1 || goback | |||
|- | |||
| 0xD || 0x1 || goahead | |||
|- | |||
| 0xE || 0x2 || Padding | |||
|- | |||
| 0x10 || 0x8 * 1000 || ats | |||
|- | |||
| 0x1f50 || 0x1 * 1000 || types | |||
|- | |||
| 0x2338 || 0x10 * 128 || ttis (time type information), struct ttinfo[1000] | |||
|- | |||
| 0x2b38 || 0x1 * 512 || chars | |||
|- | |||
| 0x2d38 || 0x4 || defaulttype | |||
|- | |||
| 0x2d3c || 0x12c4 || Reserved / Unused | |||
|} | |||
=== ttinfo === | |||
This is an 0x10-byte struct. | |||
Represent a Time Type Information used in [[#TimeZoneRule]]. | |||
{| class="wikitable" border="1" | |||
|- | |||
! Offset || Size || Description | |||
|- | |||
| 0x0 || 0x4 || tt_gmtoff | |||
|- | |||
| 0x4 || 0x1 || tt_isdst | |||
|- | |||
| 0x5 || 0x3 || Padding | |||
|- | |||
| 0x8 || 0x4 || tt_abbrind | |||
|- | |||
| 0xC || 0x1 || tt_ttisstd | |||
|- | |||
| 0xD || 0x1 || tt_ttisgmt | |||
|- | |||
| 0xE || 0x2 || Padding | |||
|} | |||
=== TimeZoneRuleVersion === | === TimeZoneRuleVersion === |