Changes

Jump to: navigation, search

PCV services

4,867 bytes added, 16 September
m
no edit summary
| 7 || [2.0.0+] GetPowerEvent
|-
| 8 || [2.0.0+]CreateWakeupTimer
|-
| 9 || [2.0.0+]CancelWakeupTimer
|-
| 10 || [2.0.0+] [[#EnableWakeupTimerOnDevice]]
|-
| 11 || [3.0.0+]CreateWakeupTimerEx
|-
| 12 || [3.0.0+]GetLastEnabledWakeupTimerType
|-
| 13 || [3.0.0+]CleanAllWakeupTimers
|-
| 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 =
This is "nn::bpc::IRtcManager".
 
This service no longer exists in [9.0.0+].
{| class="wikitable" border="1"
! Cmd || Name
|-
| 0 || GetExternalRtcValueGetRtcTime
|-
| 1 || SetExternalRtcValueSetRtcTime
|-
| 2 || ReadExternalRtcResetFlagGetRtcResetDetected
|-
| 3 || [2.0.0+] ClearExternalRtcResetFlagClearRtcResetDetected
|-
| 4 || [3.0.0+]SetUpRtcResetOnShutdown
|}
GetExternalRtcValue GetRtcTime / SetExternalRtcValue SetRtcTime directly accesses the max77620_rtc0 device.
= pcv =
| 26 || [3.0.0+] GetFuseInfo
|-
| 27 || [5.0.0+]GetDramId
|-
| [6.0.0-7.0.1] 28 ||[[#IsPoweredOn]]
|-
| [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.
== User Name to Block Maps 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 ==These are "nn::pcv::Module_X" where X is the power, clock and reset block name. [8.0.0+] Every module name is now mapped to an ID. 
=== Power Switch / Clocking / Reset ===
{| class="wikitable" border="1"
|-
! Name || ID || Block || Rail || Notes|-| 0 || 0x40000001 || CpuBus || vdd_cpu |||-| 1 || 0x40000002 || GPU || vdd_gpu |||-| 2 || 0x40000003 || I2S1 || vdd_soc |||-| 3 || 0x40000004 || I2S2 || vdd_soc ||
|-
| 0 4 || CpuBus 0x40000005 || vdd_cpu I2S3 || vdd_soc ||
|-
| 1 5 || GPU 0x40000006 || vdd_gpu PWM || vdd_soc ||
|-
| 2 6 || I2S1 0x02000001 || I2C1 || vdd_soc ||
|-
| 3 7 || I2S2 0x02000002 || I2C2 || vdd_soc ||
|-
| 4 8 || I2S3 0x02000003 || I2C3 || vdd_soc ||
|-
| 5 9 || PWM 0x02000004 || I2C4 || vdd_soc ||
|-
| 6 10 || I2C1 0x02000005 || I2C5 || vdd_soc ||
|-
| 7 11 || I2C2 0x02000006 || I2C6 || vdd_soc ||
|-
| 8 12 || I2C3 0x07000000 || SPI1 || vdd_soc ||
|-
| 9 13 || I2C4 0x07000001 || SPI2 || vdd_soc ||
|-
| 10 14 || I2C5 0x07000002 || SPI3 || vdd_soc ||
|-
| 11 15 || I2C6 0x07000003 || SPI4 || vdd_soc ||
|-
| 12 16 || SPI1 0x40000011 || DISP1 || vdd_soc ||
|-
| 13 17 || SPI2 0x40000012 || DISP2 || vdd_soc ||
|-
| 14 18 || SPI3 0x40000013 || vdd_soc ISP ||- || Not an actual block. Used for debug.
|-
| 15 19 || SPI4 0x40000014 || vdd_soc VI ||- || Not an actual block. Used for debug.
|-
| 16 20 || DISP1 0x40000015 || SDMMC1 || vdd_soc ||
|-
| 17 21 || DISP2 0x40000016 || SDMMC2 || vdd_soc ||
|-
| 20 22 || SDMMC1 0x40000017 || SDMMC3 || vdd_soc ||
|-
| 21 23 || SDMMC2 0x40000018 || SDMMC4 || vdd_soc ||
|-
| 22 24 || SDMMC3 0x40000019 || vdd_soc OWR ||- || Not an actual block. Used for debug.
|-
| 23 25 || SDMMC4 0x4000001A || CSITE || vdd_soc ||
|-
| 24 26 || - 0x4000001B || - TSEC || vdd_soc || Not actual block. Used for debug and stuff.
|-
| 25 27 || CSITE 0x4000001C || MSELECT || vdd_soc ||
|-
| 26 28 || TSEC 0x4000001D || HDA2CODEC_2X || vdd_soc ||
|-
| 27 29 || MSELECT 0x4000001E || ACTMON || vdd_soc ||
|-
| 28 30 || HDA2CODEC_2X 0x4000001F || I2C_SLOW || vdd_soc ||
|-
| 29 31 || ACTMON 0x40000020 || SOR1 || vdd_soc ||
|-
| 30 32 || I2C_SLOW 0x40000021 || vdd_soc SATA ||- || Not an actual block. Used for debug.
|-
| 31 33 || SOR1 0x40000022 || HDA || vdd_soc ||
|-
| 33 34 || HDA 0x40000023 || XUSB_CORE_HOST || vdd_soc ||
|-
| 34 35 || XUSB_CORE_HOST 0x40000024 || XUSB_FALCON || vdd_soc ||
|-
| 35 36 || XUSB_FALCON 0x40000025 || XUSB_FS || vdd_soc ||
|-
| 36 37 || XUSB_FS 0x40000026 || XUSB_CORE_DEV || vdd_soc ||
|-
| 37 38 || XUSB_CORE_DEV 0x40000027 || XUSB_SS_HOSTDEV || vdd_soc ||
|-
| 38 39 || XUSB_SS_HOSTDEV 0x03000001 || UARTA || vdd_soc ||
|-
| 39 40 || UARTA 0x35000405 || UARTB || vdd_soc ||
|-
| 40 41 || UARTB 0x3500040F || UARTC || vdd_soc ||
|-
| 41 42 || UARTC 0x37000001 || UARTD || vdd_soc ||
|-
| 42 43 || UARTD 0x4000002C || HOST1X || vdd_soc ||
|-
| 43 44 || HOST1X 0x4000002D || ENTROPY || vdd_soc ||
|-
| 44 45 || ENTROPY 0x4000002E || SOC_THERM || vdd_soc ||
|-
| 45 46 || SOC_THERM 0x4000002F || VIC || vdd_soc ||
|-
| 46 47 || VIC 0x40000030 || NVENC || vdd_soc ||
|-
| 47 48 || NVENC 0x40000031 || NVJPG || vdd_soc ||
|-
| 48 49 || NVJPG 0x40000032 || NVDEC || vdd_soc ||
|-
| 49 50 || NVDEC 0x40000033 || QSPI || vdd_soc ||
|-
| 50 51 || QSPI 0x40000034 || vdd_soc VI_I2C ||- || Not an actual block. Used for debug.
|-
| 52 || 0x40000035 || TSECB || vdd_soc ||
|-
| 53 || 0x40000036 || APE || vdd_soc ||
|-
| 54 || 0x40000037 || ACLK || vdd_soc ||
|-
| 55 || 0x40000038 || UARTAPE || vdd_soc ||
|-
| 56 || 0x40000039 || EMC || vdd_soc ||
|-
| 57 || 0x4000003A || PLLE0 || vdd_soc ||
|-
| 58 || 0x4000003B || PLLE0 || vdd_soc ||
|-
| 59 || 0x4000003C || DSI || vdd_soc ||
|-
| 60 || 0x4000003D || MAUD || vdd_soc ||
|-
| 61 || 0x4000003E || DPAUX1 || vdd_soc ||
|-
| 62 || 0x4000003F || MIPI_CAL || vdd_soc ||
|-
| 63 || 0x40000040 || UART_FST_MIPI_CAL || vdd_soc ||
|-
| 64 || 0x40000041 || OSC || vdd_soc ||
|-
| 65 || 0x40000042 || SCLK || vdd_soc ||
|-
| 66 || 0x40000043 || SOR_SAFE || vdd_soc ||
|-
| 67 || 0x40000044 || XUSB_SS || vdd_soc ||
|-
| 68 || 0x40000045 || XUSB_HOST || vdd_soc ||
|-
| 69 || 0x40000046 || XUSB_DEV || vdd_soc ||
|-
| 70 || 0x40000047 || EXTPERIPH1 || vdd_soc ||
|-
| 71 || 0x40000048 || AHUB || vdd_soc ||
|-
| 72 || 0x40000049 || HDA2HDMICODEC || vdd_soc ||
|-
| 73 || 0x4000004A || PLLP5 || vdd_soc ||
|-
| 74 || 0x4000004B || USBD || vdd_soc ||
|-
| 75 || 0x4000004C || USB2 || vdd_soc ||
|-
| 76 || 0x4000004D || PCIE || vdd_soc ||
|-
| 77 || 0x4000004E || AFI || vdd_soc ||
|-
| 78 || 0x4000004F || PCIEXCLK || vdd_soc ||
|-
| 79 || 0x40000050 || PEX_USB_UPHY || vdd_soc ||
|-
| 80 || 0x40000051 || XUSB_PADCTL || vdd_soc ||
|-
| 81 || 0x40000052 || APBDMA || vdd_soc ||
|-
| 82 || 0x40000053 || USB2_TRK || vdd_soc ||
|-
| 83 || 0x40000054 || PLLE0 || vdd_soc ||
|-
| 84 || 0x40000055 || PLLE0 || vdd_soc ||
|-
| 85 || 0x40000056 || CEC || vdd_soc ||
|-
| [6.0.0+] 86 || 0x40000057 || EXTPERIPH2 || vdd_soc ||
|}
|-
| 14 || max77621_gpu ||
|-
| [6.0.0+] 15 || max77812_cpu ||
|-
| [6.0.0+] 16 || max77812_gpu ||
|-
| [6.0.0+] 17 || max77812_dram ||
|}
= clkrst, clkrst:i =
These are "nn::clkrst::IClkrstManager" and "nn::clkrst::IClkrstImmediateManagerIImmediateManager".
These were added with [8.0.0+].
! Cmd || Name
|-
| 0 || [[#OpenSession]]
|-
| 1 ||GetTemperatureThresholds
|-
| 2 ||SetTemperature
|-
| 3 ||GetPossibleClockRates
|-
| 4 ||GetClockInfoEvent
|-
| 5 ||GetClockModuleNumLimit
|}
 
== OpenSession ==
Takes an u32 '''ModuleID''', an u32 '''ModuleUnk''' and returns an [[#IClkrstSession]].
 
== GetClockModuleNumLimit ==
Returns 0x1A.
== IClkrstSession ==
= clkrst:a =
This is "nn::clkrst::IClkrstArbitrationManagerIArbitrationManager".
This was added with [8.0.0+].
! Cmd || Name
|-
| 0 || [[#ReleaseControl]]
|}
 
== ReleaseControl ==
Takes an u32 '''ModuleID'''. No output.
= rgltr =
! Cmd || Name
|-
| 0 || [[#OpenSession]]
|-
| 1 ||GetPowerDomainStateTable
|-
| 2 ||GetPowerInfoEvent
|-
| 3 ||GetPowerModuleNumLimit
|}
 
== OpenSession ==
Takes an u32 '''ModuleID''' and returns an [[#IRegulatorSession]].
 
== GetPowerModuleNumLimit ==
Returns 0x3.
== IRegulatorSession ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || SetLdoEnabled || Takes a bool. Enables the LDO this session was opened for.[[#SetVoltageEnabled]]
|-
| 1 || ||
|-
| 2 || GetLdoEnabled || Returns a bool. True if voltage is enabled, false if not.[[#GetVoltageEnabled]]
|-
| 3 || ||GetVoltageRange
|-
| 4 || ||GetVoltageValue
|-
| 5 || SetLdoVoltage || Takes in a voltage and sets the LDO to this voltage.[[#SetVoltageValue]]
|-
| 6 || ||ChangeVoltage
|}
 
=== SetVoltageEnabled ===
Takes a bool. Enables/disables the LDO this session was opened for.
 
=== GetVoltageEnabled ===
Returns a bool. True if voltage is enabled, false if not.
 
=== SetVoltageValue ===
Takes in a voltage in microvolts and sets the LDO to this voltage.
= rtc =
! Cmd || Name
|-
| 0 ||GetRtcTime
|-
| 1 ||SetRtcTime
|-
| 2 ||SetRtcClientUnknownBool
|-
| 3 ||GetRtcResetDetected
|-
| 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 =
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"
| 2 || GetSystemClockContext || Returns an output [[#SystemClockContext]].
|-
| 3 || SetSystemClockContext || Takes an input [[#SystemClockContext]].|-| 4 || [9.0.0+] GetOperationEventReadableHandle ||
|}
=== PosixTime ===
This is an u64 s64 for UTC POSIX time.
=== SystemClockContext ===
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 ===
27
edits

Navigation menu