Settings services: Difference between revisions
(32 intermediate revisions by 7 users not shown) | |||
Line 10: | Line 10: | ||
| 1 || GetAvailableLanguageCodes || Takes a type-0xA buffer containing the [[#LanguageCode]] output array, returns an output s32. | | 1 || GetAvailableLanguageCodes || Takes a type-0xA buffer containing the [[#LanguageCode]] output array, returns an output s32. | ||
|- | |- | ||
| 2 || [4.0.0+] MakeLanguageCode || | | 2 || [4.0.0+] MakeLanguageCode || Takes an input [[#Language]], returns an output [[#LanguageCode]]. | ||
|- | |- | ||
| 3 || GetAvailableLanguageCodeCount || No input, returns an output s32. | | 3 || GetAvailableLanguageCodeCount || No input, returns an output s32. | ||
|- | |- | ||
| 4 || GetRegionCode || No input, returns | | 4 || GetRegionCode || No input, returns a [[#RegionCode]]. | ||
|- | |- | ||
| 5 || [4.0.0+] GetAvailableLanguageCodes2 || | | 5 || [4.0.0+] GetAvailableLanguageCodes2 || Takes a type-0x6 buffer containing the [[#LanguageCode]] output array, returns an output s32. | ||
|- | |- | ||
| 6 || [4.0.0+] GetAvailableLanguageCodeCount2 || | | 6 || [4.0.0+] GetAvailableLanguageCodeCount2 || No input, returns an output s32. | ||
|- | |- | ||
| 7 || [4.0.0+] GetKeyCodeMap || | | 7 || [4.0.0+] GetKeyCodeMap || | ||
|- | |||
| 8 || [5.0.0+] GetQuestFlag || Identical to "set:sys" [[#set:sys|GetQuestFlag]]. | |||
|- | |||
| 9 || [6.0.0+] GetKeyCodeMap2 || | |||
|} | |} | ||
"nn::settings::Language" is basically array indices in the output array from GetAvailableLanguageCodes. | [4.0.0+] Official user-processes now use GetAvailableLanguageCodes2/GetAvailableLanguageCodeCount2 instead of {original commands}. | ||
In official user-processes in the [[#Language]]->[[#LanguageCode]] conversion function (MakeLanguageCode): | |||
* During one-time init, GetAvailableLanguageCodes is used to initialize the LanguageCodes array cache, with max_entries=0xF (buffer size in u64s). [4.0.0+] GetAvailableLanguageCodes2 is now used with max_entries 0x40. | |||
* [4.0.0+] When the input [[#Language]] is larger than the cached total_entries from the above command output, or [[#Language]] is negative, command MakeLanguageCode is used instead of the array. | |||
== GetKeyCodeMap == | |||
Takes a type-0x16 output buffer containing KeyCodeMap, official sw uses fixed size 0x1000. This is probably related to HID keyboard. | |||
== Language == | |||
"nn::settings::Language" (s32) is basically array indices in the output array from GetAvailableLanguageCodes. | |||
== LanguageCode == | == LanguageCode == | ||
This is "nn::settings::LanguageCode". | This is "nn::settings::LanguageCode". | ||
This is an u64, which is a NUL-terminated string. | This is an u64, which is a NUL-terminated string. | ||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
! Array-index / " | ! Array-index / [[#Language]] || [[#LanguageCode]] || Icon [[NCA_Content_FS#FS-type3|language]] filename | ||
|- | |||
| 0 || ja || "Japanese" | |||
|- | |||
| 1 || en-US || "AmericanEnglish" | |||
|- | |||
| 2 || fr || "French" | |||
|- | |||
| 3 || de || "German" | |||
|- | |||
| 4 || it || "Italian" | |||
|- | |||
| 5 || es || "Spanish" | |||
|- | |||
| 6 || zh-CN || "Chinese" | |||
|- | |||
| 7 || ko || "Korean" | |||
|- | |||
| 8 || nl || "Dutch" | |||
|- | |||
| 9 || pt || "Portuguese" | |||
|- | |- | ||
| | | 10 || ru || "Russian" | ||
|- | |- | ||
| | | 11 || zh-TW || "Taiwanese" | ||
|- | |- | ||
| | | 12 || en-GB || "BritishEnglish" | ||
|- | |- | ||
| | | 13 || fr-CA || "CanadianFrench" | ||
|- | |- | ||
| 4 || | | 14 || es-419 || "LatinAmericanSpanish" | ||
|- | |||
| [4.0.0+] 15 || zh-Hans || "SimplifiedChinese" | |||
|- | |||
| [4.0.0+] 16 || zh-Hant || "TraditionalChinese" | |||
|} | |||
== RegionCode == | |||
A region code is a signed 32-bit value representing a particular region. Currently the available regions defined by the system are as follows: | |||
{| class="wikitable" border="1" | |||
|- | |- | ||
| | ! Value || Region | ||
|- | |- | ||
| | | 0 || Japan | ||
|- | |- | ||
| | | 1 || USA | ||
|- | |- | ||
| | | 2 || Europe | ||
|- | |- | ||
| | | 3 || Australia | ||
|- | |- | ||
| | | 4 || China | ||
|- | |- | ||
| | | 5 || Korea | ||
|- | |- | ||
| | | 6 || Taiwan | ||
|- | |- | ||
| | | Any other value || Considered an unknown region | ||
|- | |- | ||
|} | |} | ||
= set:fd = | = set:fd = | ||
This is "nn::settings::IFirmwareDebugSettingsServer". | This is "nn::settings::IFirmwareDebugSettingsServer". | ||
[4.0.0+] Only exposed if in [[SPL_services#IsDebugMode|debug mode]]. | |||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
Line 155: | Line 199: | ||
| 23 || [4.0.0+] GetLcdVendorId | | 23 || [4.0.0+] GetLcdVendorId | ||
|- | |- | ||
| 24 || [5.0.0+] [[#GetEciDeviceCertificate2]] | |||
|- | |||
| 25 || [5.0.0+] [[#GetEciDeviceKey2]] | |||
|- | |||
| 26 || [5.0.0+] GetAmiiboKey | |||
|- | |||
| 27 || [5.0.0+] GetAmiiboEcqvCertificate | |||
|- | |||
| 28 || [5.0.0+] GetAmiiboEcdsaCertificate | |||
|- | |||
| 29 || [5.0.0+] GetAmiiboEcqvBlsKey | |||
|- | |||
| 30 || [5.0.0+] GetAmiiboEcqvBlsCertificate | |||
|- | |||
| 31 || [5.0.0+] GetAmiiboEcqvBlsRootCertificate | |||
|- | |||
| 32 || [5.0.0+] GetUsbTypeCPowerSourceCircuitVersion | |||
|- | |||
| 41 || [6.0.0+] GetBatteryVersion | |||
|} | |} | ||
Line 195: | Line 258: | ||
== GetEciDeviceKey == | == GetEciDeviceKey == | ||
Returns the extended device ECC-B233 key (0x50 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal device ECC-B233 key (0x30 bytes). | Returns the extended device ECC-B233 key (0x50 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal device ECC-B233 key (0x30 bytes). | ||
[5.0.0+] Now returns an additional 4-bytes. | |||
== GetEticketDeviceKey == | == GetEticketDeviceKey == | ||
Line 200: | Line 265: | ||
Returns the extended ETicket RSA-2048 key (0x240 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal ETicket RSA-2048 key (0x220 bytes). | Returns the extended ETicket RSA-2048 key (0x240 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal ETicket RSA-2048 key (0x220 bytes). | ||
== GetEciDeviceCertificate2 == | |||
Same as [[#GetEciDeviceCertificate]], but returns a RSA-2048 variant of the device certificate. | |||
== GetEciDeviceKey2 == | |||
Same as [[#GetEciDeviceKey]], but returns a RSA-2048 variant of the device key. | |||
== setcal Container Structure == | == setcal Container Structure == | ||
Line 235: | Line 306: | ||
|- | |- | ||
| 4 || [3.0.0+] GetFirmwareVersion2 | | 4 || [3.0.0+] GetFirmwareVersion2 | ||
|- | |||
| 5 || [5.0.0+] GetFirmwareVersionDigest | |||
|- | |- | ||
| 7 || GetLockScreenFlag | | 7 || GetLockScreenFlag | ||
Line 312: | Line 385: | ||
| 46 || SetForceMuteOnHeadphoneRemoved | | 46 || SetForceMuteOnHeadphoneRemoved | ||
|- | |- | ||
| 47 || GetQuestFlag | | 47 || [[#GetQuestFlag]] | ||
|- | |- | ||
| 48 || SetQuestFlag | | 48 || SetQuestFlag | ||
Line 496: | Line 569: | ||
| 138 || [4.0.0+] GetWebInspectorFlag | | 138 || [4.0.0+] GetWebInspectorFlag | ||
|- | |- | ||
| 139 || [4.0.0+] GetAllowedSslHosts | | 139 || [4.0.0+] [[#GetAllowedSslHosts]] | ||
|- | |- | ||
| 140 || [4.0.0+] GetHostFsMountPoint | | 140 || [4.0.0+] GetHostFsMountPoint | ||
|- | |||
| 141 || [5.0.0+] GetRequiresRunRepairTimeReviser | |||
|- | |||
| 142 || [5.0.0+] SetRequiresRunRepairTimeReviser | |||
|- | |||
| 143 || [5.0.0+] SetBlePairingSettings | |||
|- | |||
| 144 || [5.0.0+] GetBlePairingSettings | |||
|- | |||
| 145 || [5.0.0+] GetConsoleSixAxisSensorAngularVelocityTimeBias | |||
|- | |||
| 146 || [5.0.0+] SetConsoleSixAxisSensorAngularVelocityTimeBias | |||
|- | |||
| 147 || [5.0.0+] GetConsoleSixAxisSensorAngularAcceleration | |||
|- | |||
| 148 || [5.0.0+] SetConsoleSixAxisSensorAngularAcceleration | |||
|- | |||
| 149 || [5.0.0+] GetRebootlessSystemUpdateVersion | |||
|- | |||
| 150 || [5.0.0+] GetDeviceTimeZoneLocationUpdatedTime | |||
|- | |||
| 151 || [5.0.0+] SetDeviceTimeZoneLocationUpdatedTime | |||
|- | |||
| 152 || [6.0.0+] GetUserSystemClockAutomaticCorrectionUpdatedTime | |||
|- | |||
| 153 || [6.0.0+] SetUserSystemClockAutomaticCorrectionUpdatedTime | |||
|- | |||
| 154 || [6.0.0+] GetAccountOnlineStorageSettings | |||
|- | |||
| 155 || [6.0.0+] SetAccountOnlineStorageSettings | |||
|- | |||
| 156 || [6.0.0+] GetPctlReadyFlag | |||
|- | |||
| 157 || [6.0.0+] SetPctlReadyFlag | |||
|- | |||
| 162 || [6.0.0+] GetPtmBatteryVersion | |||
|- | |||
| 163 || [6.0.0+] SetPtmBatteryVersion | |||
|- | |||
| 164 || [6.0.0+] GetUsb30HostEnableFlag | |||
|- | |||
| 165 || [6.0.0+] SetUsb30HostEnableFlag | |||
|- | |||
| 166 || [6.0.0+] GetUsb30DeviceEnableFlag | |||
|- | |||
| 167 || [6.0.0+] SetUsb30DeviceEnableFlag | |||
|- | |||
| 168 || [7.0.0+] GetThemeId | |||
|- | |||
| 169 || [7.0.0+] SetThemeId | |||
|- | |||
| 170 || [7.0.0+] GetChineseTraditionalInputMethod | |||
|- | |||
| 171 || [7.0.0+] SetChineseTraditionalInputMethod | |||
|- | |||
| 172 || [7.0.0+] GetPtmCycleCountReliability | |||
|- | |||
| 173 || [7.0.0+] SetPtmCycleCountReliability | |||
|- | |||
| 175 || [7.0.0+] GetThemeSettings | |||
|- | |||
| 176 || [7.0.0+] SetThemeSettings | |||
|- | |||
| 177 || [7.0.0+] GetThemeKey | |||
|- | |||
| 178 || [7.0.0+] SetThemeKey | |||
|- | |||
| 179 || [8.0.0+] GetZoomFlag | |||
|- | |||
| 180 || [8.0.0+] SetZoomFlag | |||
|- | |||
| 181 || [8.0.0+] GetT | |||
|- | |||
| 182 || [8.0.0+] SetT | |||
|} | |} | ||
Line 540: | Line 687: | ||
== GetServiceDiscoveryControlSettings == | == GetServiceDiscoveryControlSettings == | ||
Returns 0x01 if [[Safemode|safemode]] needs to be launched. | Returns 0x01 if [[Safemode|safemode]] needs to be launched. | ||
== GetAllowedSslHosts == | |||
Takes a type-0x6 output buffer, returns an output s32. This buffer contains an array of 0x8-byte "nn::settings::system::AllowedSslHost" entries. | |||
== GetQuestFlag == | |||
Gets a flag determining whether the console is a kiosk unit (codenamed "Quest"). Used by qlaunch to determine whether to launch Retail Interactive Display Menu. | |||
= System Config = | |||
There's a common config title (*818), and a config title for each [[SPL_services|HardwareType]]. | |||
[5.0.0+] New config fields were added to the HardwareType-specific config: | |||
* "systeminitializer!eks_enabled" 1 for non-Mariko, 0 otherwise. | |||
* "systeminitializer!bct_eks_offset" Offset within the [[BCT]] where the [[Flash_Filesystem|keyblob]]/"EKS" is stored. | |||
* "systeminitializer!bct_version_offset" Offset within the [[BCT]] where the keyblob version is stored (bootloader0_info.version). | |||
* "systeminitializer!boot_image_update_type" 0 for non-Mariko, 1 otherwise. | |||
"bct_eks_offset" and "bct_version_offset" are only present in non-Mariko config, since (?) Mariko "eks_enabled" is 0. This presumably means the [[Flash_Filesystem|keyblob]]/"EKS" is not embedded in [[BCT]] with Mariko? | |||
[[Category:Services]] | [[Category:Services]] |