Changes

Jump to navigation Jump to search

PCV services (view source)

Revision as of 17:50, 14 April 2020

12,720 bytes added ,  17:50, 14 April 2020
→‎bpc
Line 18: Line 18:  
| 5 || GetBoardPowerControlEvent
 
| 5 || GetBoardPowerControlEvent
 
|-
 
|-
−
| 6 || GetSleepButtonState
+
| 6 || [2.0.0+] GetSleepButtonState
 
|-
 
|-
−
| 7 || GetPowerEvent
+
| 7 || [2.0.0+] GetPowerEvent
 
|-
 
|-
−
| 8 ||
+
| 8 || [2.0.0-9.2.0] CreateWakeupTimer
 
|-
 
|-
−
| 9 ||
+
| 9 || [2.0.0-9.2.0] CancelWakeupTimer
 
|-
 
|-
−
| 10 ||
+
| 10 || [2.0.0-9.2.0] [[#EnableWakeupTimerOnDevice]]
 +
|-
 +
| 11 || [3.0.0-9.2.0] CreateWakeupTimerEx
 +
|-
 +
| 12 || [3.0.0-9.2.0] GetLastEnabledWakeupTimerType
 +
|-
 +
| 13 || [3.0.0-9.2.0] CleanAllWakeupTimers
 +
|-
 +
| 14 || [6.0.0+]
 +
|-
 +
| 15 || [10.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 =
Line 36: Line 49:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 0 || GetExternalRtcValue
+
| 0 || GetRtcTime
 +
|-
 +
| 1 || SetRtcTime
 +
|-
 +
| 2 || GetRtcResetDetected
 +
|-
 +
| 3 || [2.0.0+] ClearRtcResetDetected
 +
|-
 +
| 4 || [3.0.0+] SetUpRtcResetOnShutdown
 +
|}
 +
 
 +
= bpc:c =
 +
This is "nn::bpc::IBoardPowerControlManager".
 +
 
 +
[2.0.0+] This service was replaced by [[#bpc|bpc]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || ShutdownSystem
 +
|-
 +
| 1 || RebootSystem
 +
|-
 +
| 2 || GetWakeupReason
 +
|-
 +
| 3 || GetShutdownReason
 +
|-
 +
| 4 || GetAcOk
 +
|-
 +
| 5 || GetBoardPowerControlEvent
 +
|}
 +
 
 +
= bpc:b =
 +
This is "nn::bpc::IPowerButtonManager".
 +
 
 +
[2.0.0+] This service was merged into [[#bpc|bpc]].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 1 || SetExternalRtcValue
+
! Cmd || Name
 
|-
 
|-
−
| 2 || ReadExternalRtcResetFlag
+
| 0 || GetSleepButtonState
 
|-
 
|-
−
| 3 || ClearExternalRtcResetFlag
+
| 1 || GetPowerEvent
 
|}
 
|}
   −
GetExternalRtcValue / SetExternalRtcValue directly accesses the max77620_rtc0 device.
+
= bpc:w =
 +
This is "nn::bpc::IWakeupConfigManager".
 +
 
 +
[2.0.0+] This service was merged into [[#bpc|bpc]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || CreateWakeupTimer
 +
|-
 +
| 1 || CancelWakeupTimer
 +
|-
 +
| 2 || [[#EnableWakeupTimerOnDevice]]
 +
|}
    
= pcv =
 
= pcv =
Line 54: Line 119:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 0 || SetPowerEnabled
+
| [1.0.0-7.0.1] 0 || SetPowerEnabled
 
|-
 
|-
−
| 1 || SetClockEnabled
+
| [1.0.0-7.0.1] 1 || SetClockEnabled
 
|-
 
|-
−
| 2 || SetClockRate
+
| [1.0.0-7.0.1] 2 || SetClockRate
 
|-
 
|-
−
| 3 || GetClockRate
+
| [1.0.0-7.0.1] 3 || GetClockRate
 
|-
 
|-
−
| 4 || GetState
+
| [1.0.0-7.0.1] 4 || GetState
 
|-
 
|-
−
| 5 || GetPossibleClockRates
+
| [1.0.0-7.0.1] 5 || GetPossibleClockRates
 
|-
 
|-
−
| 6 || SetMinVClockRate
+
| [1.0.0-7.0.1] 6 || SetMinVClockRate
 
|-
 
|-
−
| 7 || SetReset
+
| [1.0.0-7.0.1] 7 || SetReset
 
|-
 
|-
−
| 8 || SetVoltageEnabled
+
| [1.0.0-7.0.1] 8 || SetVoltageEnabled
 
|-
 
|-
−
| 9 || GetVoltageEnabled
+
| [1.0.0-7.0.1] 9 || GetVoltageEnabled
 
|-
 
|-
−
| 10 || GetVoltageRange
+
| [1.0.0-7.0.1] 10 || GetVoltageRange
 
|-
 
|-
−
| 11 || SetVoltageValue
+
| [1.0.0-7.0.1] 11 || SetVoltageValue
 
|-
 
|-
−
| 12 || GetVoltageValue
+
| [1.0.0-7.0.1] 12 || GetVoltageValue
 
|-
 
|-
−
| 13 || GetTemperatureThresholds
+
| [1.0.0-7.0.1] 13 || GetTemperatureThresholds
 
|-
 
|-
−
| 14 || SetTemperature
+
| [1.0.0-7.0.1] 14 || SetTemperature
 
|-
 
|-
−
| 15 || Initialize
+
| [1.0.0-5.1.0] 15 || Initialize
 
|-
 
|-
−
| 16 || IsInitialized
+
| [1.0.0-5.1.0] 16 || IsInitialized
 
|-
 
|-
−
| 17 || Finalize
+
| [1.0.0-5.1.0] 17 || Finalize
 
|-
 
|-
−
| 18 || PowerOn
+
| [3.0.0-7.0.1] 18 || PowerOn
 
|-
 
|-
−
| 19 || PowerOff
+
| [3.0.0-7.0.1] 19 || PowerOff
 
|-
 
|-
−
| 20 || ChangeVoltage
+
| [3.0.0-7.0.1] 20 || ChangeVoltage
 
|-
 
|-
−
| 21 || GetPowerClockInfoEvent
+
| [3.0.0-7.0.1] 21 || GetPowerClockInfoEvent
 
|-
 
|-
−
| 22 || GetOscillatorClock
+
| [3.0.0-7.0.1] 22 || GetOscillatorClock
 
|-
 
|-
−
| 23 || GetDvfsTable
+
| [3.0.0-7.0.1] 23 || GetDvfsTable
 
|-
 
|-
−
| 24 || GetModuleStateTable
+
| [3.0.0-7.0.1] 24 || GetModuleStateTable
 
|-
 
|-
−
| 25 || GetPowerDomainStateTable
+
| [3.0.0-7.0.1] 25 || GetPowerDomainStateTable
 
|-
 
|-
−
| 26 || GetFuseInfo
+
| 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]]
 
|}
 
|}
   −
== User Name to Block Maps ==
+
[7.0.0+] The type-0xA output buffers were replaced with type-0x22 output buffers, for the following: GetDvfsTable, GetModuleStateTable, and GetPowerDomainStateTable.
 +
 
 +
== IsPoweredOn ==
 +
Takes a [[#PowerDomain|PowerDomain]] and returns a bool indicating the status of the requested voltage block.
 +
 
 +
== GetVoltage ==
 +
Takes a [[#PowerDomain|PowerDomain]] and returns an u32 voltage value for the requested voltage block.
 +
 
 +
= pcv:arb =
 +
This is "nn::pcv::IArbitrationManager".
   −
=== Power Switch / Clocking / Reset ===
+
This service no longer exists in [8.0.0+].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Name || Block || Rail || Notes
+
! Cmd || Name
 
|-
 
|-
−
| 0 || CpuBus || vdd_cpu ||
+
| 0 || ReleaseControl
 +
|}
 +
 
 +
= pcv:imm =
 +
This is "nn::pcv::IImmediateManager".
 +
 
 +
This service no longer exists in [8.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
|  1 || GPU || vdd_gpu ||
+
! Cmd || Name
 
|-
 
|-
−
| 2 || I2S1 || vdd_soc ||
+
| 0 || SetClockRate
 +
|}
 +
 
 +
= clkrst, clkrst:i =
 +
These are "nn::clkrst::IClkrstManager" and "nn::clkrst::IImmediateManager".
 +
 
 +
These were added with [8.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
|  3 || I2S2 || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 4 || I2S3 || vdd_soc ||
+
| 0 || [[#OpenSession]]
 
|-
 
|-
−
| 5 || PWM || vdd_soc ||
+
| 1 || GetTemperatureThresholds
 
|-
 
|-
−
| 6 || I2C1 || vdd_soc ||
+
| 2 || SetTemperature
 
|-
 
|-
−
| 7 || I2C2 || vdd_soc ||
+
| 3 || GetPossibleClockRates
 
|-
 
|-
−
| 8 || I2C3 || vdd_soc ||
+
| 4 || GetClockInfoEvent
 
|-
 
|-
−
| 9 || I2C4 || vdd_soc ||
+
| 5 || GetClockModuleNumLimit
 +
|}
 +
 
 +
== OpenSession ==
 +
Takes a [[#Module|DeviceCode]] and an u32. Returns an [[#IClkrstSession]].
 +
 
 +
== GetClockModuleNumLimit ==
 +
Returns 0x1A.
 +
 
 +
== IClkrstSession ==
 +
This is "nn::clkrst::IClkrstSession".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 10 || I2C5 || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 11 || I2C6 || vdd_soc ||
+
| 0 || SetClockEnabled
 
|-
 
|-
−
| 12 || SPI1 || vdd_soc ||
+
| 1 || SetClockDisabled
 
|-
 
|-
−
| 13 || SPI2 || vdd_soc ||
+
| 2 || SetResetAsserted
 
|-
 
|-
−
| 14 || SPI3 || vdd_soc ||
+
| 3 || SetResetDeasserted
 
|-
 
|-
−
| 15 || SPI4 || vdd_soc ||
+
| 4 || SetPowerEnabled
 
|-
 
|-
−
| 16 || DISP1 || vdd_soc ||
+
| 5 || SetPowerDisabled
 
|-
 
|-
−
| 17 || DISP2 || vdd_soc ||
+
| 6 || GetState
 
|-
 
|-
−
| 20 || SDMMC1 || vdd_soc ||
+
| 7 || SetClockRate
 
|-
 
|-
−
| 21 || SDMMC2 || vdd_soc ||
+
| 8 || GetClockRate
 
|-
 
|-
−
| 22 || SDMMC3 || vdd_soc ||
+
| 9 || SetMinVClockRate
 
|-
 
|-
−
| 23 || SDMMC4 || vdd_soc ||
+
| 10 || GetPossibleClockRates
 
|-
 
|-
−
| 24 || - || - || Not actual block. Used for debug and stuff.
+
| 11 || GetDvfsTable
 +
|}
 +
 
 +
= clkrst:a =
 +
This is "nn::clkrst::IArbitrationManager".
 +
 
 +
This was added with [8.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 25 || CSITE || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 26 || TSEC || vdd_soc ||
+
| 0 || [[#ReleaseControl]]
 +
|}
 +
 
 +
== ReleaseControl ==
 +
Takes a [[#Module|Module]]. No output.
 +
 
 +
= rgltr =
 +
This is "nn::regulator::IRegulatorManager".
 +
 
 +
This was added with [8.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 27 || MSELECT || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 28 || HDA2CODEC_2X || vdd_soc ||
+
| 0 || [[#OpenSession]]
 
|-
 
|-
−
| 29 || ACTMON || vdd_soc ||
+
| 1 || GetPowerDomainStateTable
 
|-
 
|-
−
| 30 || I2C_SLOW || vdd_soc ||
+
| 2 || GetPowerInfoEvent
 
|-
 
|-
−
| 31 || SOR1 || vdd_soc ||
+
| 3 || GetPowerModuleNumLimit
 +
|}
 +
 
 +
== OpenSession ==
 +
Takes a [[#PowerDomain|DeviceCode]] and returns an [[#IRegulatorSession]].
 +
 
 +
== GetPowerModuleNumLimit ==
 +
Returns 0x3.
 +
 
 +
== IRegulatorSession ==
 +
This is "nn::regulator::IRegulatorSession".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 33 || HDA || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 34 || XUSB_CORE_HOST || vdd_soc ||
+
| 0 || [[#SetVoltageEnabled]]
 
|-
 
|-
−
| 35 || XUSB_FALCON || vdd_soc ||
+
| 1 ||
 
|-
 
|-
−
| 36 || XUSB_FS || vdd_soc ||
+
| 2 || [[#GetVoltageEnabled]]
 
|-
 
|-
−
| 37 || XUSB_CORE_DEV || vdd_soc ||
+
| 3 || GetVoltageRange
 
|-
 
|-
−
| 38 || XUSB_SS_HOSTDEV || vdd_soc ||
+
| 4 || GetVoltageValue
 
|-
 
|-
−
| 39 || UARTA || vdd_soc ||
+
| 5 || [[#SetVoltageValue]]
 
|-
 
|-
−
| 40 || UARTB || vdd_soc ||
+
| 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 =
 +
This was added with [8.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 41 || UARTC || vdd_soc ||
+
! Cmd || Name
 
|-
 
|-
−
| 42 || UARTD || vdd_soc ||
+
| 0 || [[#GetRtcTime]]
 
|-
 
|-
−
| 43 || HOST1X || vdd_soc ||
+
| 1 || [[#SetRtcTime]]
 
|-
 
|-
−
| 44 || ENTROPY || vdd_soc ||
+
| 2 || [[#SetUpRtcResetOnShutdown]]
 
|-
 
|-
−
| 45 || SOC_THERM || vdd_soc ||
+
| 3 || [[#GetRtcResetDetected]]
 
|-
 
|-
−
| 46 || VIC || vdd_soc ||
+
| 4 || [[#ClearRtcResetDetected]]
 +
|}
 +
 
 +
== GetRtcTime ==
 +
Same as GetRtcTime from [[#bpc:r|bpc:r]], but takes an extra [[Bus_services#I2cDevice|DeviceCode]], which [[#bpc:r|bpc:r]] hardcodes to 0x3B000001 (max77620_rtc0) instead.
 +
 
 +
== SetRtcTime ==
 +
Same as SetRtcTime from [[#bpc:r|bpc:r]], but takes an extra [[Bus_services#I2cDevice|DeviceCode]], which [[#bpc:r|bpc:r]] hardcodes to 0x3B000001 (max77620_rtc0) instead.
 +
 
 +
== SetUpRtcResetOnShutdown ==
 +
Takes an u8 '''DoReset''' and a [[Bus_services#I2cDevice|DeviceCode]]. Similar to SetUpRtcResetOnShutdown from [[#bpc:r|bpc:r]], but this version assigns the provided boolean value on a per-client basis (instead of a global variable) and checks it when the current [[PSC_services#Power_Management_States|power state]] is "ReadyShutdown".
 +
 
 +
== GetRtcResetDetected ==
 +
Same as GetRtcResetDetected from [[#bpc:r|bpc:r]], but takes an extra [[Bus_services#I2cDevice|DeviceCode]], which [[#bpc:r|bpc:r]] hardcodes to 0x3B000001 (max77620_rtc0) instead.
 +
 
 +
== ClearRtcResetDetected ==
 +
Same as ClearRtcResetDetected from [[#bpc:r|bpc:r]], but takes an extra [[Bus_services#I2cDevice|DeviceCode]], which [[#bpc:r|bpc:r]] hardcodes to 0x3B000001 (max77620_rtc0) instead.
 +
 
 +
= 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"
 
|-
 
|-
−
| 47 || NVENC || vdd_soc ||
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 48 || NVJPG || vdd_soc ||
+
| 0 || GetStandardUserSystemClock || Returns an [[#ISystemClock]].
 
|-
 
|-
−
| 49 || NVDEC || vdd_soc ||
+
| 1 || GetStandardNetworkSystemClock || Returns an [[#ISystemClock]].
 
|-
 
|-
−
| 50 || QSPI || vdd_soc ||
+
| 2 || GetStandardSteadyClock || Returns an [[#ISteadyClock]].
 
|-
 
|-
−
| 52 || TSECB || vdd_soc ||
+
| 3 || GetTimeZoneService || Returns an [[#ITimeZoneService]].
 
|-
 
|-
−
| 53 || APE || vdd_soc ||
+
| 4 || GetStandardLocalSystemClock || Returns an [[#ISystemClock]].
 
|-
 
|-
−
| 54 || ACLK || vdd_soc ||
+
| 5 || [4.0.0+] GetEphemeralNetworkSystemClock || Returns an [[#ISystemClock]].
 
|-
 
|-
−
| 55 || UARTAPE || vdd_soc ||
+
| 20 || [6.0.0+] GetSharedMemoryNativeHandle ||  
 
|-
 
|-
−
| 56 || EMC || vdd_soc ||
+
| 30 || [6.0.0+] GetStandardNetworkClockOperationEventReadableHandle ||  
 
|-
 
|-
−
| 57 || PLLE0 || vdd_soc ||
+
| 31 || [6.0.0+] GetEphemeralNetworkClockOperationEventReadableHandle ||  
 
|-
 
|-
−
| 58 || PLLE0 || vdd_soc ||
+
| 50 || [4.0.0+] SetStandardSteadyClockInternalOffset ||  
 
|-
 
|-
−
| 59 || DSI || vdd_soc ||
+
| 100 || IsStandardUserSystemClockAutomaticCorrectionEnabled ||  
 
|-
 
|-
−
| 60 || MAUD || vdd_soc ||
+
| 101 || SetStandardUserSystemClockAutomaticCorrectionEnabled ||  
 
|-
 
|-
−
| 61 || DPAUX1 || vdd_soc ||
+
| 102 || [5.0.0+] GetStandardUserSystemClockInitialYear ||  
 
|-
 
|-
−
| 62 || MIPI_CAL || vdd_soc ||
+
| 200 || [3.0.0+] IsStandardNetworkSystemClockAccuracySufficient ||  
 
|-
 
|-
−
| 63 || UART_FST_MIPI_CAL || vdd_soc ||
+
| 201 || [6.0.0+] GetStandardUserSystemClockAutomaticCorrectionUpdatedTime ||  
 
|-
 
|-
−
| 64 || OSC || vdd_soc ||
+
| 300 || [4.0.0+] CalculateMonotonicSystemClockBaseTimePoint ||  
 
|-
 
|-
−
| 65 || SCLK || vdd_soc ||
+
| 400 || [4.0.0+] GetClockSnapshot ||  
 
|-
 
|-
−
| 66 || SOR_SAFE || vdd_soc ||
+
| 401 || [4.0.0+] GetClockSnapshotFromSystemClockContext ||  
 
|-
 
|-
−
| 67 || XUSB_SS || vdd_soc ||
+
| 500 || [4.0.0+] CalculateStandardUserSystemClockDifferenceByUser ||  
 
|-
 
|-
−
| 68 || XUSB_HOST || vdd_soc ||
+
| 501 || [4.0.0+] CalculateSpanBetween ||  
 +
|}
 +
 
 +
== ISteadyClock ==
 +
This is "nn::timesrv::detail::service::ISteadyClock".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 69 || XUSB_DEV || vdd_soc ||
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 70 || EXTPERIPH1 || vdd_soc ||
+
| 0 || GetCurrentTimePoint || No input, returns an output [[#SteadyClockTimePoint]].
 
|-
 
|-
−
| 71 || AHUB || vdd_soc ||
+
| 2 || GetTestOffset || No input, returns an output [[#TimeSpanType]].
 
|-
 
|-
−
| 72 || HDA2HDMICODEC || vdd_soc ||
+
| 3 || SetTestOffset || Takes an input [[#TimeSpanType]], no output.
 
|-
 
|-
−
| 73 || PLLP5 || vdd_soc ||
+
| 100 || [2.0.0+] GetRtcValue || No input, returns an output s64.
 
|-
 
|-
−
| 74 || USBD || vdd_soc ||
+
| 101 || [2.0.0+] IsRtcResetDetected || No input, returns an output u8 bool.
 
|-
 
|-
−
| 75 || USB2 || vdd_soc ||
+
| 102 || [2.0.0+] GetSetupResultValue || No input, returns an output u32.
 
|-
 
|-
−
| 76 || PCIE || vdd_soc ||
+
| 200 || [3.0.0+] GetInternalOffset || No input, returns an output [[#TimeSpanType]].
 
|-
 
|-
−
| 77 || AFI || vdd_soc ||
+
| 201 || [3.0.0-3.0.2] SetInternalOffset || Takes an input [[#TimeSpanType]], no output.
 +
|}
 +
 
 +
=== SteadyClockTimePoint ===
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 78 || PCIEXCLK || vdd_soc ||
+
! Offset || Size || Description
 
|-
 
|-
−
| 79 || PEX_USB_UPHY || vdd_soc ||
+
| 0x0 || 0x8|| A u64 representing a point in time.
 
|-
 
|-
−
| 80 || XUSB_PADCTL || vdd_soc ||
+
| 0x8 || 0x10 || An ID representing the clock source.
 +
|}
 +
 
 +
This is a 0x18-byte struct.
 +
 
 +
=== TimeSpanType ===
 +
This is an u64.
 +
 
 +
== ISystemClock ==
 +
This is "nn::timesrv::detail::service::ISystemClock".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 81 || APBDMA || vdd_soc ||
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 82 || USB2_TRK || vdd_soc ||
+
| 0 || GetCurrentTime || Returns an output [[#PosixTime]].
 
|-
 
|-
−
| 83 || PLLE0 || vdd_soc ||
+
| 1 || SetCurrentTime || Takes an input [[#PosixTime]].
 
|-
 
|-
−
| 84 || PLLE0 || vdd_soc ||
+
| 2 || GetSystemClockContext || Returns an output [[#SystemClockContext]].
 
|-
 
|-
−
| 85 || CEC || vdd_soc ||
+
| 3 || SetSystemClockContext || Takes an input [[#SystemClockContext]].
 
|-
 
|-
 +
| 4 || [9.0.0+] GetOperationEventReadableHandle ||
 
|}
 
|}
   −
=== Voltage ===
+
=== PosixTime ===
 +
This is an s64 for UTC POSIX time.
 +
 
 +
=== SystemClockContext ===
 +
This is an 0x20-byte struct.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Name || Block || Notes
+
! Offset || Size || Description
 
|-
 
|-
−
| 0 || max77620_sd0 ||  
+
| 0x0 || 0x8|| a [[#PosixTime]] representing the system clock epoch.
 
|-
 
|-
−
| 1 || max77620_sd1 ||  
+
| 0x8 || 0x18 || a [[#SteadyClockTimePoint]]
 +
|}
 +
 
 +
== ITimeZoneService ==
 +
This is "nn::timesrv::detail::service::ITimeZoneService".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 2 || max77620_sd2 ||  
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 3 || max77620_sd3 ||  
+
| 0 || GetDeviceLocationName || No input, returns an output [[#LocationName]].
 
|-
 
|-
−
| 4 || max77620_ldo0 ||  
+
| 1 || SetDeviceLocationName || Takes an input [[#LocationName]], no output.
 
|-
 
|-
−
| 5 || max77620_ldo1 ||  
+
| 2 || GetTotalLocationNameCount || No input, returns an output s32.
 
|-
 
|-
−
| 6 || max77620_ldo2 ||  
+
| 3 || LoadLocationNameList ||  
 
|-
 
|-
−
| 7 || max77620_ldo3 ||  
+
| 4 || LoadTimeZoneRule || Takes an input [[#LocationName]] and a type-0x16 output buffer for [[#TimeZoneRule]], no output.
 
|-
 
|-
−
| 8 || max77620_ldo4 ||  
+
| 5 || [2.0.0+] GetTimeZoneRuleVersion || No input, returns an output [[#TimeZoneRuleVersion]].
 
|-
 
|-
−
| 9 || max77620_ldo5 ||  
+
| 6 || [5.0.0+] GetDeviceLocationNameAndUpdatedTime ||  
 
|-
 
|-
−
| 10 || max77620_ldo6 ||  
+
| 100 || ToCalendarTime || Takes an input [[#PosixTime]] and a type-0x15 input buffer for [[#TimeZoneRule]], returns an output [[#CalendarTime]] and [[#CalendarAdditionalInfo]].
 
|-
 
|-
−
| 11 || max77620_ldo7 ||  
+
| 101 || ToCalendarTimeWithMyRule || Takes an input [[#PosixTime]], returns an output [[#CalendarTime]] and [[#CalendarAdditionalInfo]].
 
|-
 
|-
−
| 12 || max77620_ldo8 ||  
+
| 201 || ToPosixTime || Takes an input [[#CalendarTime]], a type-0x15 input buffer for [[#TimeZoneRule]], an type-0xA output buffer for [[#PosixTime]] array, and returns an output s32.
−
|-
  −
| 13 || max77621_cpu ||
  −
|-
  −
| 14 || max77621_gpu ||
   
|-
 
|-
 +
| 202 || ToPosixTimeWithMyRule || Takes an input [[#CalendarTime]], an type-0xA output buffer for [[#PosixTime]] array, and returns an output s32.
 
|}
 
|}
   −
Note: max77620 GPIOs are only used internally by the driver during init, and not exposed via an API.
+
=== LoadLocationNameList ===
 +
Takes an input s32 LocationName_index and a type-0x6 output buffer for [[#LocationName]], returns an output s32 for total output entries.
 +
 
 +
=== LocationName ===
 +
This contains a TimeZone location string with a max size of 0x24 bytes.
 +
 
 +
=== TimeZoneRule ===
 +
This is an 0x4000-byte struct. Official sw uses fixed-size 0x4000 for the buffer size with the above commands.
 +
 
 +
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).
   −
= pcv:arb =
+
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).
−
This is "nn::pcv::IArbitrationManager".
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name
+
! 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
 
|-
 
|-
−
| 0 || ReleaseControl
+
| 0x2d38 || 0x4 || defaulttype
 
|-
 
|-
 +
| 0x2d3c || 0x12c4 || Reserved / Unused
 
|}
 
|}
   −
= pcv:imm =
+
=== ttinfo ===
−
This is "nn::pcv::IImmediateManager".
+
This is an 0x10-byte struct.
 +
Represent a Time Type Information used in [[#TimeZoneRule]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || tt_gmtoff
 +
|-
 +
| 0x4 || 0x1 || tt_isdst
 +
|-
 +
| 0x5 || 0x3 || Padding
 +
|-
 +
| 0x8 || 0x4 || tt_abbrind
 +
|-
 +
| 0xC || 0x1 || tt_ttisstd
 
|-
 
|-
−
| 0 || SetClockRate
+
| 0xD || 0x1 || tt_ttisgmt
 
|-
 
|-
 +
| 0xE || 0x2 || Padding
 
|}
 
|}
   −
= time:u, time:a, time:s =
+
=== TimeZoneRuleVersion ===
−
This is "nn::timesrv::detail::service::IStaticService".
+
This is an u128.
    +
=== CalendarTime ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x2 || Year
 +
|-
 +
| 0x2 || 0x1 || Month
 +
|-
 +
| 0x3 || 0x1 || Day
 +
|-
 +
| 0x4 || 0x1 || Hour
 
|-
 
|-
−
| 0 || GetStandardUserSystemClock || Returns an [[#ISystemClock]].
+
| 0x5 || 0x1 || Minute
 
|-
 
|-
−
| 1 || GetStandardNetworkSystemClock || Returns an [[#ISystemClock]].
+
| 0x6 || 0x1 || Second
 
|-
 
|-
−
| 2 || GetStandardSteadyClock || Returns an [[#ISteadyClock]].
+
| 0x7 || 0x1 || Padding / unknown?
 +
|}
 +
 
 +
This is an 0x8-byte struct.
 +
 
 +
=== CalendarAdditionalInfo ===
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 3 || GetTimeZoneService || Returns an [[#ITimeZoneService]].
+
! Offset || Size || Description
 
|-
 
|-
−
| 4 || GetStandardLocalSystemClock || Returns an [[#ISystemClock]].
+
| 0x0 || 0x4 || 0-based day-of-week.
 
|-
 
|-
−
| 100 || IsStandardUserSystemClockAutomaticCorrectionEnabled ||  
+
| 0x4 || 0x4 || 0-based day-of-year.
 
|-
 
|-
−
| 101 || SetStandardUserSystemClockAutomaticCorrectionEnabled ||  
+
| 0x8 || 0x8 || Timezone name string.
 
|-
 
|-
−
| 200 || IsStandardNetworkSystemClockAccuracySufficient ||  
+
| 0x10 || 0x4 || 0 = no DST, 1 = DST.
 
|-
 
|-
 +
| 0x14 || 0x4 || s32 seconds relative to UTC for this timezone.
 
|}
 
|}
   −
== ISteadyClock ==
+
This is an 0x18-byte struct. This stores timezone info.
 +
 
 +
= Module =
 +
This is "nn::pcv::Module".
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Name || DeviceCode || Block || Rail || Notes
 +
|-
 +
|  0 || 0x40000001 || CpuBus || vdd_cpu ||
 +
|-
 +
|  1 || 0x40000002 || GPU || vdd_gpu ||
 +
|-
 +
|  2 || 0x40000003 || I2S1 || vdd_soc ||
 +
|-
 +
|  3 || 0x40000004 || I2S2 || vdd_soc ||
 +
|-
 +
|  4 || 0x40000005 || I2S3 || vdd_soc ||
 +
|-
 +
|  5 || 0x40000006 || PWM || vdd_soc ||
 +
|-
 +
|  6 || 0x02000001 || I2C1 || vdd_soc ||
 +
|-
 +
|  7 || 0x02000002 || I2C2 || vdd_soc ||
 +
|-
 +
|  8 || 0x02000003 || I2C3 || vdd_soc ||
 +
|-
 +
|  9 || 0x02000004 || I2C4 || vdd_soc ||
 +
|-
 +
| 10 || 0x02000005 || I2C5 || vdd_soc ||
 +
|-
 +
| 11 || 0x02000006 || I2C6 || vdd_soc ||
 +
|-
 +
| 12 || 0x07000000 || SPI1 || vdd_soc ||
 +
|-
 +
| 13 || 0x07000001 || SPI2 || vdd_soc ||
 +
|-
 +
| 14 || 0x07000002 || SPI3 || vdd_soc ||
 +
|-
 +
| 15 || 0x07000003 || SPI4 || vdd_soc ||
 +
|-
 +
| 16 || 0x40000011 || DISP1 || vdd_soc ||
 +
|-
 +
| 17 || 0x40000012 || DISP2 || vdd_soc ||
 +
|-
 +
| 18 || 0x40000013 || ISP || - || Not an actual block. Used for debug.
 +
|-
 +
| 19 || 0x40000014 || VI || - || Not an actual block. Used for debug.
 +
|-
 +
| 20 || 0x40000015 || SDMMC1 || vdd_soc ||
 +
|-
 +
| 21 || 0x40000016 || SDMMC2 || vdd_soc ||
 +
|-
 +
| 22 || 0x40000017 || SDMMC3 || vdd_soc ||
 +
|-
 +
| 23 || 0x40000018 || SDMMC4 || vdd_soc ||
 +
|-
 +
| 24 || 0x40000019 || OWR || - || Not an actual block. Used for debug.
 +
|-
 +
| 25 || 0x4000001A || CSITE || vdd_soc ||
 +
|-
 +
| 26 || 0x4000001B || TSEC || vdd_soc ||
 +
|-
 +
| 27 || 0x4000001C || MSELECT || vdd_soc ||
 +
|-
 +
| 28 || 0x4000001D || HDA2CODEC_2X || vdd_soc ||
 +
|-
 +
| 29 || 0x4000001E || ACTMON || vdd_soc ||
 +
|-
 +
| 30 || 0x4000001F || I2C_SLOW || vdd_soc ||
 +
|-
 +
| 31 || 0x40000020 || SOR1 || vdd_soc ||
 +
|-
 +
| 32 || 0x40000021 || SATA || - || Not an actual block. Used for debug.
 +
|-
 +
| 33 || 0x40000022 || HDA || vdd_soc ||
 +
|-
 +
| 34 || 0x40000023 || XUSB_CORE_HOST || vdd_soc ||
 +
|-
 +
| 35 || 0x40000024 || XUSB_FALCON || vdd_soc ||
 +
|-
 +
| 36 || 0x40000025 || XUSB_FS || vdd_soc ||
 +
|-
 +
| 37 || 0x40000026 || XUSB_CORE_DEV || vdd_soc ||
 +
|-
 +
| 38 || 0x40000027 || XUSB_SS_HOSTDEV || vdd_soc ||
 +
|-
 +
| 39 || 0x03000001 || UARTA || vdd_soc ||
 +
|-
 +
| 40 || 0x35000405 || UARTB || vdd_soc ||
 +
|-
 +
| 41 || 0x3500040F || UARTC || vdd_soc ||
 +
|-
 +
| 42 || 0x37000001 || UARTD || vdd_soc ||
 +
|-
 +
| 43 || 0x4000002C || HOST1X || vdd_soc ||
 +
|-
 +
| 44 || 0x4000002D || ENTROPY || vdd_soc ||
 +
|-
 +
| 45 || 0x4000002E || SOC_THERM || vdd_soc ||
 +
|-
 +
| 46 || 0x4000002F || VIC || vdd_soc ||
 +
|-
 +
| 47 || 0x40000030 || NVENC || vdd_soc ||
 +
|-
 +
| 48 || 0x40000031 || NVJPG || vdd_soc ||
 +
|-
 +
| 49 || 0x40000032 || NVDEC || vdd_soc ||
 +
|-
 +
| 50 || 0x40000033 || QSPI || vdd_soc ||
 +
|-
 +
| 51 || 0x40000034 || 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 ||
 
|-
 
|-
−
| 0 || GetCurrentTimePoint || No input, returns an output [[#SteadyClockTimePoint]].
+
| 78 || 0x4000004F || PCIEXCLK || vdd_soc ||
 
|-
 
|-
−
| 2 || GetTestOffset || No input, returns an output [[#TimeSpanType]].
+
| 79 || 0x40000050 || PEX_USB_UPHY || vdd_soc ||
 
|-
 
|-
−
| 3 || SetTestOffset || Takes an input [[#TimeSpanType]], no output.
+
| 80 || 0x40000051 || XUSB_PADCTL || vdd_soc ||
 
|-
 
|-
−
| 100 || GetRtcValue || No input, returns an output s64.
+
| 81 || 0x40000052 || APBDMA || vdd_soc ||
 
|-
 
|-
−
| 101 || IsRtcResetDetected || No input, returns an output u8 bool.
+
| 82 || 0x40000053 || USB2_TRK || vdd_soc ||
 
|-
 
|-
−
| 102 || GetSetupResultValue || No input, returns an output u32.
+
| 83 || 0x40000054 || PLLE0 || vdd_soc ||
 
|-
 
|-
−
| 200 || GetInternalOffset || No input, returns an output [[#TimeSpanType]].
+
| 84 || 0x40000055 || PLLE0 || vdd_soc ||
 
|-
 
|-
−
| 201 || SetInternalOffset || Takes an input [[#TimeSpanType]], no output.
+
| 85 || 0x40000056 || CEC || vdd_soc ||
 
|-
 
|-
 +
| [6.0.0+] 86 || 0x40000057 || EXTPERIPH2 || vdd_soc ||
 
|}
 
|}
   −
=== SteadyClockTimePoint ===
+
= PowerDomain =
−
This is a 0x18-byte struct.
+
This is "nn::pcv::PowerDomain".
   −
=== TimeSpanType ===
  −
This is an u64.
  −
  −
== ISystemClock ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Name || DeviceCode || Block || Notes
 +
|-
 +
|  0 || 0x3A000080 || max77620_sd0 ||
 +
|-
 +
|  1 || 0x3A000081 || max77620_sd1 ||
 +
|-
 +
|  2 || 0x3A000082 || max77620_sd2 ||
 +
|-
 +
|  3 || 0x3A000083 || max77620_sd3 ||
 
|-
 
|-
−
| 0 || GetCurrentTime || Returns an nn::time::PosixTime (time since epoch).
+
| 4 || 0x3A0000A0 || max77620_ldo0 || 1.2v
 
|-
 
|-
−
| 1 || SetCurrentTime || Takes an nn::time::PosixTime.
+
| 5 || 0x3A0000A1 || max77620_ldo1 ||  
 
|-
 
|-
−
| 2 || GetSystemClockContext || Returns an 0x20 byte struct (nn::time::SystemClockContext).
+
| 6 || 0x3A0000A2 || max77620_ldo2 || SDcard power, 1.8v - 3.3v
 
|-
 
|-
−
| 3 || SetSystemClockContext  || Takes an nn::time::SystemClockContext
+
| 7 || 0x3A0000A3 || max77620_ldo3 || GC ASIC 3.1v
 
|-
 
|-
−
|}
+
| 8 || 0x3A0000A4 || max77620_ldo4 || RTC power, 0.85v
−
 
  −
== ITimeZoneService ==
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Cmd || Name || Notes
+
| 9 || 0x3A0000A5 || max77620_ldo5 || GC ASIC 1.8v
 
|-
 
|-
−
| 0 || GetDeviceLocationName || Returns an nn::time::LocationName (0x24 bytes).
+
| 10 || 0x3A0000A6 || max77620_ldo6 || AVDD touchscreen, 2.9v
 
|-
 
|-
−
| 1 || SetDeviceLocationName || Takes an nn::time::LocationName.
+
| 11 || 0x3A0000A7 || max77620_ldo7 ||  
 
|-
 
|-
−
| 2 || GetTotalLocationNameCount || Returns an 0x20 byte struct (nn::time::SystemClockContext).
+
| 12 || 0x3A0000A8 || max77620_ldo8 || DisplayPort, 1.05v
 
|-
 
|-
−
| 3 || LoadLocationNameList ||  
+
| 13 || 0x3A000003 || max77621_cpu ||  
 
|-
 
|-
−
| 4 || LoadTimeZoneRule ||  
+
| 14 || 0x3A000004 || max77621_gpu ||  
 
|-
 
|-
−
| 5 || GetTimeZoneRuleVersion ||
+
| [6.0.0+] 15 || 0x3A000003 || max77812_cpu ||  
 
|-
 
|-
−
| 100 || ToCalendarTime ||  
+
| [6.0.0+] 16 || 0x3A000004 || max77812_gpu ||  
 
|-
 
|-
−
| 101 || ToCalendarTimeWithMyRule ||  
+
| [6.0.0+] 17 || 0x3A000005 || max77812_dram ||  
 
|-
 
|-
−
| 200 || ToPosixTime ||  
+
| [8.0.0+] - || 0x3C000004 || || SDCard
 
|-
 
|-
−
| 201 || ToPosixTimeWithMyRule ||  
+
| [8.0.0+] - || 0x34000007 || || HDMI
 
|-
 
|-
 +
| [8.0.0+] - || 0x3500041A || || MCU
 
|}
 
|}
 +
 +
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/3797...9170"

Navigation menu