Nintendo Switch Brew

Settings services: Difference between revisions

← Older editNewer edit →
No edit summary
(38 intermediate revisions by 3 users not shown)
Line 166: Line 166:
| 0 || GetBluetoothBdAddress
| 0 || GetBluetoothBdAddress
|-
|-
| 1 || GetConfigurationId1
| 1 || [[#GetConfigurationId1]]
|-
|-
| 2 || GetAccelerometerOffset
| 2 || GetAccelerometerOffset
Line 228: Line 228:
| 32 || [5.0.0+] GetUsbTypeCPowerSourceCircuitVersion
| 32 || [5.0.0+] GetUsbTypeCPowerSourceCircuitVersion
|-
|-
| 33 || [9.0.0+] GetAnalogStickModuleTypeL
| 33 || [8.1.1+] GetAnalogStickModuleTypeL
|-
|-
| 34 || [9.0.0+] GetAnalogStickModelParameterL
| 34 || [8.1.1+] GetAnalogStickModelParameterL
|-
|-
| 35 || [9.0.0+] GetAnalogStickFactoryCalibrationL
| 35 || [8.1.1+] GetAnalogStickFactoryCalibrationL
|-
|-
| 36 || [9.0.0+] GetAnalogStickModuleTypeR
| 36 || [8.1.1+] GetAnalogStickModuleTypeR
|-
|-
| 37 || [9.0.0+] GetAnalogStickModelParameterR
| 37 || [8.1.1+] GetAnalogStickModelParameterR
|-
|-
| 38 || [9.0.0+] GetAnalogStickFactoryCalibrationR
| 38 || [8.1.1+] GetAnalogStickFactoryCalibrationR
|-
|-
| 39 || [9.0.0+] GetConsoleSixAxisSensorModuleType
| 39 || [8.1.1+] GetConsoleSixAxisSensorModuleType
|-
|-
| 40 || [9.0.0+] GetConsoleSixAxisSensorHorizontalOffset
| 40 || [8.1.1+] GetConsoleSixAxisSensorHorizontalOffset
|-
|-
| 41 || [6.0.0+] GetBatteryVersion
| 41 || [6.0.0+] GetBatteryVersion
|-
| 42 || [10.0.0+] [[#GetDeviceId]]
|-
| 43 || [10.0.0+] GetConsoleSixAxisSensorMountType
|}
|}


Used for accessing data calibrated at the factory.
Used for accessing data calibrated at the factory.
== GetConfigurationId1 ==
Returns the [[#ConfigurationId1]].


== GetEciDeviceCertificate ==
== GetEciDeviceCertificate ==
Takes a type-0x16 output buffer with fixed size 0x180.
Takes a type-0x16 output buffer containing a [[#EccB233DeviceCertificate]].


Returns the device certificate (ECC signed). This is identical to 3DS DeviceCert/CTCert besides the strings. NIM loads the DeviceId from this.
Returns the device certificate (ECC signed). This is identical to 3DS DeviceCert/CTCert besides the strings. NIM loads the DeviceId from this.


== GetEticketDeviceCertificate ==
== GetEticketDeviceCertificate ==
Takes a type-0x16 output buffer with fixed size 0x240.
Takes a type-0x16 output buffer containing a [[#Rsa2048DeviceCertificate]].


Returns the ETicket certificate (RSA signed).
Returns the ETicket certificate (RSA signed).


== GetSslKey ==
== GetSslKey ==
Takes a type-0x16 output buffer with fixed size 0x134.
Takes a type-0x16 output buffer containing a [[#SslKey]].


Returns the extended SSL key (0x130 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal SSL key (0x110 bytes).
Returns the extended SSL key (0x130 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal SSL key (0x110 bytes).
Line 267: Line 274:


== GetSslCertificate ==
== GetSslCertificate ==
Takes a type-0x16 output buffer with fixed size 0x804.
Takes a type-0x16 output buffer containing a [[#SslCertificate]].
 
Returns a [[Settings_services#setcal_Container_Structure|container]] with the plaintext SSL certificate.


Used by SSL-sysmodule, see [[SSL_services|here]].
Used by SSL-sysmodule, see [[SSL_services|here]].


== GetGameCardKey ==
== GetGameCardKey ==
Takes a type-0x16 output buffer with fixed size 0x134.
Takes a type-0x16 output buffer containing a [[#GameCardKey]].


Returns the extended GameCard key (0x130 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal GameCard key (0x110 bytes).
Returns the extended GameCard key (0x130 bytes) from [[Calibration#CAL0|CAL0]]. If the extended key is not programmed then it falls back to the normal GameCard key (0x110 bytes).


== GetGameCardCertificate ==
== GetGameCardCertificate ==
Takes a type-0x16 output buffer with fixed size 0x404.
Takes a type-0x16 output buffer containing a [[#GameCardCertificate]].


Returns a [[Settings_services#setcal_Container_Structure|container]] with the GameCard certificate.
== GetEciDeviceKey ==
No input, returns an [[#EccB233DeviceKey]].


== 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 ==
Takes a type-0x16 output buffer with fixed size 0x244.
Takes a type-0x16 output buffer containing a [[#Rsa2048DeviceKey]].


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 ==
== GetEciDeviceCertificate2 ==
Same as [[#GetEciDeviceCertificate]], but returns a RSA-2048 variant of the device certificate.
Same as [[#GetEciDeviceCertificate]], but [[#Rsa2048DeviceCertificate|returns]] a RSA-2048 variant of the device certificate.


== GetEciDeviceKey2 ==
== GetEciDeviceKey2 ==
Same as [[#GetEciDeviceKey]], but returns a RSA-2048 variant of the device key.
Same as [[#GetEciDeviceKey]], but [[#Rsa2048DeviceKey|returns]] a RSA-2048 variant of the device key.
 
== GetDeviceId ==
Returns an u64 '''DeviceId''' by reading and converting the hexadecimal string at offset 0xC6 inside [[#EccB233DeviceCertificate]] or [[#Rsa2048DeviceCertificate]].
 
== AccelerometerOffset ==
This is "nn::settings::factory::AccelerometerOffset". Its size is 0x06 bytes.
 
== AccelerometerScale ==
This is "nn::settings::factory::AccelerometerScale". Its size is 0x06 bytes.
 
== AmiiboEcdsaCertificate ==
This is "nn::settings::factory::AmiiboEcdsaCertificate". Its size is 0x70 bytes.
 
== AmiiboEcqvBlsCertificate ==
This is "nn::settings::factory::AmiiboEcqvBlsCertificate". Its size is 0x20 bytes.
 
== AmiiboEcqvBlsKey ==
This is "nn::settings::factory::AmiiboEcqvBlsKey". Its size is 0x40 bytes.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x40
| Key
|-
| 0x44
| 0x4
| Key generation
|}
 
== AmiiboEcqvBlsRootCertificate ==
This is "nn::settings::factory::AmiiboEcqvBlsRootCertificate". Its size is 0x90 bytes.
 
== AmiiboEcqvCertificate ==
This is "nn::settings::factory::AmiiboEcqvCertificate". Its size is 0x14 bytes.
 
== AmiiboKey ==
This is "nn::settings::factory::AmiiboKey". Its size is 0x50 bytes.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x50
| Key
|-
| 0x50
| 0x4
| Key generation
|}
 
== AnalogStickFactoryCalibration ==
This is "nn::settings::factory::AnalogStickFactoryCalibration". Its size is 0x09 bytes.
 
== AnalogStickModelParameter ==
This is "nn::settings::factory::AnalogStickModelParameter". Its size is 0x12 bytes.
 
== BatteryLot ==
This is "nn::settings::BatteryLot". Its size is 0x18 bytes.
 
== BdAddress ==
This is "nn::settings::factory::BdAddress". Its size is 0x06 bytes.
 
== ConfigurationId1 ==
This is "nn::settings::factory::ConfigurationId1". Its size is 0x1E bytes.
 
Usually, this is a string with the following format:
  {device}_{revision}_{major_version}_{minor_version}_{micro_version}
 
Where:
  {device}: "MP", "EDEV", "SDEV", "HDEV", "HOAG", "COPPER" or "CALCIO".
  {revision}: 2 digit number.
  {major_version}: 2 digit number.
  {minor_version}: 2 digit number.
  {micro_version}: 2 digit number.
 
== ConsoleSixAxisSensorHorizontalOffset ==
This is "nn::settings::factory::ConsoleSixAxisSensorHorizontalOffset". Its size is 0x06 bytes.
 
== CountryCode ==
This is "nn::settings::factory::CountryCode". Its size is 0x04 bytes.
 
== EccB233DeviceCertificate ==
This is "nn::settings::factory::EccB233DeviceCertificate". Its size is 0x180 bytes.
 
== EccB233DeviceKey ==
This is "nn::settings::factory::EccB233DeviceKey". Its size is 0x30 bytes or 0x54 bytes in the extended version.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x54
| Key
|-
| 0x54
| 0x4
| Key generation
|}
 
== GameCardCertificate ==
This is "nn::settings::factory::GameCardCertificate". Its maximum size is 0x404 bytes.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x4
| GameCard certificate size
|-
| 0x4
| {above size}
| GameCard certificate data
|}
 
== GameCardKey ==
This is "nn::settings::factory::GameCardKey". Its size is 0x110 bytes or 0x130 bytes in the extended version.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x130
| Key
|-
| 0x130
| 0x4
| Key generation
|}
 
== GyroscopeOffset ==
This is "nn::settings::factory::GyroscopeOffset". Its size is 0x06 bytes.
 
== GyroscopeScale ==
This is "nn::settings::factory::GyroscopeScale". Its size is 0x06 bytes.
 
== MacAddress ==
This is "nn::settings::factory::MacAddress". Its size is 0x06 bytes.
 
== Rsa2048DeviceCertificate ==
This is "nn::settings::factory::Rsa2048DeviceCertificate". Its size is 0x240 bytes.
 
== Rsa2048DeviceKey ==
This is "nn::settings::factory::Rsa2048DeviceKey". Its size is 0x220 bytes or 0x240 bytes in the extended version.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x240
| Key
|-
| 0x240
| 0x4
| Key generation
|}
 
== SerialNumber ==
This is "nn::settings::factory::SerialNumber". Its size is 0x18 bytes.
 
== SpeakerParameter ==
This is "nn::settings::factory::SpeakerParameter". Its size is 0x5A bytes.


== setcal Container Structure ==
== SslCertificate ==
This is "nn::settings::factory::SslCertificate". Its maximum size is 0x804 bytes.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 308: Line 497:
| 0x0
| 0x0
| 0x4
| 0x4
| Size (same size used for decryption if needed)
| SSL certificate size
|-
|-
| 0x4
| 0x4
| {above size}
| {above size}
| Actual data starts here.
| SSL certificate data
|}
|}


This container is used for returning data with variable sizes.
== SslKey ==
This is "nn::settings::factory::SslKey". Its size is 0x110 bytes or 0x130 bytes in the extended version.
 
If [[Calibration#CAL0|Calibration Version]] >= 9, this is now:
{| class="wikitable" border="1"
|-
! Offset
! Size
! Name
|-
| 0x0
| 0x130
| Key
|-
| 0x130
| 0x4
| Key generation
|}
 
== RegionCode ==
This is "nn::settings::factory::RegionCode". Its size is 0x04 bytes.


= set:sys =
= set:sys =
Line 324: Line 533:
! Cmd || Name
! Cmd || Name
|-
|-
| 0 || SetLanguageCode
| 0 || [[#SetLanguageCode]]
|-
|-
| 1 || SetNetworkSettings
| 1 || SetNetworkSettings
Line 356: Line 565:
| 16 || SetUserSystemClockContext
| 16 || SetUserSystemClockContext
|-
|-
| 17 || GetAccountSettings
| 17 || [[#GetAccountSettings]]
|-
|-
| 18 || SetAccountSettings
| 18 || [[#SetAccountSettings]]
|-
|-
| 19 || GetAudioVolume
| 19 || GetAudioVolume
Line 364: Line 573:
| 20 || SetAudioVolume
| 20 || SetAudioVolume
|-
|-
| 21 || GetEulaVersions
| 21 || [[#GetEulaVersions]]
|-
|-
| 22 || SetEulaVersions
| 22 || [[#SetEulaVersions]]
|-
|-
| 23 || [[#GetColorSetId]]
| 23 || [[#GetColorSetId]]
Line 380: Line 589:
| 28 || SetAutomaticApplicationDownloadFlag
| 28 || SetAutomaticApplicationDownloadFlag
|-
|-
| 29 || GetNotificationSettings
| 29 || [[#GetNotificationSettings]]
|-
|-
| 30 || SetNotificationSettings
| 30 || [[#SetNotificationSettings]]
|-
|-
| 31 || GetAccountNotificationSettings
| 31 || [[#GetAccountNotificationSettings]]
|-
|-
| 32 || SetAccountNotificationSettings
| 32 || [[#SetAccountNotificationSettings]]
|-
|-
| 35 || GetVibrationMasterVolume
| 35 || GetVibrationMasterVolume
Line 396: Line 605:
| 38 || [[#GetSettingsItemValue]]
| 38 || [[#GetSettingsItemValue]]
|-
|-
| 39 || GetTvSettings
| 39 || [[#GetTvSettings]]
|-
|-
| 40 || SetTvSettings
| 40 || [[#SetTvSettings]]
|-
|-
| 41 || GetEdid
| 41 || GetEdid
Line 416: Line 625:
| 48 || SetQuestFlag
| 48 || SetQuestFlag
|-
|-
| 49 || GetDataDeletionSettings
| 49 || [[#GetDataDeletionSettings]]
|-
|-
| 50 || SetDataDeletionSettings
| 50 || [[#SetDataDeletionSettings]]
|-
|-
| 51 || GetInitialSystemAppletProgramId
| 51 || GetInitialSystemAppletProgramId
Line 428: Line 637:
| 54 || SetDeviceTimeZoneLocationName
| 54 || SetDeviceTimeZoneLocationName
|-
|-
| 55 || GetWirelessCertificationFileSize
| 55 || [[#GetWirelessCertificationFileSize]]
|-
|-
| 56 || [[Flash_Filesystem#PRODINFOF|GetWirelessCertificationFile]]
| 56 || [[#GetWirelessCertificationFile]]
|-
|-
| 57 || SetRegionCode
| 57 || [[#SetRegionCode]]
|-
|-
| 58 || GetNetworkSystemClockContext
| 58 || GetNetworkSystemClockContext
Line 444: Line 653:
| 62 || [[#GetDebugModeFlag]]
| 62 || [[#GetDebugModeFlag]]
|-
|-
| 63 || GetPrimaryAlbumStorage
| 63 || [[#GetPrimaryAlbumStorage]]
|-
|-
| 64 || SetPrimaryAlbumStorage
| 64 || [[#SetPrimaryAlbumStorage]]
|-
|-
| 65 || GetUsb30EnableFlag
| 65 || GetUsb30EnableFlag
Line 452: Line 661:
| 66 || SetUsb30EnableFlag
| 66 || SetUsb30EnableFlag
|-
|-
| 67 || GetBatteryLot
| 67 || [[#GetBatteryLot]]
|-
|-
| 68 || [[#GetSerialNumber]]
| 68 || [[#GetSerialNumber]]
Line 460: Line 669:
| 70 || SetNfcEnableFlag
| 70 || SetNfcEnableFlag
|-
|-
| 71 || GetSleepSettings
| 71 || [[#GetSleepSettings]]
|-
|-
| 72 || SetSleepSettings
| 72 || [[#SetSleepSettings]]
|-
|-
| 73 || GetWirelessLanEnableFlag
| 73 || GetWirelessLanEnableFlag
Line 468: Line 677:
| 74 || SetWirelessLanEnableFlag
| 74 || SetWirelessLanEnableFlag
|-
|-
| 75 || GetInitialLaunchSettings
| 75 || [[#GetInitialLaunchSettings]]
|-
|-
| 76 || SetInitialLaunchSettings
| 76 || [[#SetInitialLaunchSettings]]
|-
|-
| 77 || GetDeviceNickName
| 77 || GetDeviceNickName
Line 476: Line 685:
| 78 || SetDeviceNickName
| 78 || SetDeviceNickName
|-
|-
| 79 || GetProductModel
| 79 || [[#GetProductModel]]
|-
|-
| 80 || GetLdnChannel
| 80 || GetLdnChannel
Line 498: Line 707:
| 89 || SetBluetoothEnableFlag
| 89 || SetBluetoothEnableFlag
|-
|-
| 90 || GetMiiAuthorId
| 90 || [[#GetMiiAuthorId]]
|-
|-
| 91 || SetShutdownRtcValue
| 91 || SetShutdownRtcValue
Line 566: Line 775:
| 123 || [4.0.0+] SetServiceDiscoveryControlSettings
| 123 || [4.0.0+] SetServiceDiscoveryControlSettings
|-
|-
| 124 || [4.0.0+] GetErrorReportSharePermission
| 124 || [4.0.0+] [[#GetErrorReportSharePermission]]
|-
|-
| 125 || [4.0.0+] SetErrorReportSharePermission
| 125 || [4.0.0+] [[#SetErrorReportSharePermission]]
|-
|-
| 126 || [4.0.0+] GetAppletLaunchFlags
| 126 || [4.0.0+] [[#GetAppletLaunchFlags]]
|-
|-
| 127 || [4.0.0+] SetAppletLaunchFlags
| 127 || [4.0.0+] [[#SetAppletLaunchFlags]]
|-
|-
| 128 || [4.0.0+] GetConsoleSixAxisSensorAccelerationBias
| 128 || [4.0.0+] GetConsoleSixAxisSensorAccelerationBias
Line 590: Line 799:
| 135 || [4.0.0+] SetConsoleSixAxisSensorAngularVelocityGain
| 135 || [4.0.0+] SetConsoleSixAxisSensorAngularVelocityGain
|-
|-
| 136 || [4.0.0+] GetKeyboardLayout
| 136 || [4.0.0+] [[#GetKeyboardLayout]]
|-
|-
| 137 || [4.0.0+] SetKeyboardLayout
| 137 || [4.0.0+] [[#SetKeyboardLayout]]
|-
|-
| 138 || [4.0.0+] GetWebInspectorFlag
| 138 || [4.0.0+] GetWebInspectorFlag
Line 616: Line 825:
| 148 || [5.0.0+] SetConsoleSixAxisSensorAngularAcceleration
| 148 || [5.0.0+] SetConsoleSixAxisSensorAngularAcceleration
|-
|-
| 149 || [5.0.0+] GetRebootlessSystemUpdateVersion
| 149 || [5.0.0+] [[#GetRebootlessSystemUpdateVersion]]
|-
|-
| 150 || [5.0.0+] GetDeviceTimeZoneLocationUpdatedTime
| 150 || [5.0.0+] GetDeviceTimeZoneLocationUpdatedTime
Line 634: Line 843:
| 157 || [6.0.0+] SetPctlReadyFlag
| 157 || [6.0.0+] SetPctlReadyFlag
|-
|-
| 158 || [9.0.0+] GetAnalogStickUserCalibrationL
| 158 || [8.1.1+] GetAnalogStickUserCalibrationL
|-
|-
| 159 || [9.0.0+] SetAnalogStickUserCalibrationL
| 159 || [8.1.1+] SetAnalogStickUserCalibrationL
|-
|-
| 160 || [9.0.0+] GetAnalogStickUserCalibrationR
| 160 || [8.1.1+] GetAnalogStickUserCalibrationR
|-
|-
| 161 || [9.0.0+] SetAnalogStickUserCalibrationR
| 161 || [8.1.1+] SetAnalogStickUserCalibrationR
|-
|-
| 162 || [6.0.0+] GetPtmBatteryVersion
| 162 || [6.0.0+] GetPtmBatteryVersion
Line 658: Line 867:
| 169 || [7.0.0+] SetThemeId
| 169 || [7.0.0+] SetThemeId
|-
|-
| 170 || [7.0.0+] GetChineseTraditionalInputMethod
| 170 || [7.0.0+] [[#GetChineseTraditionalInputMethod]]
|-
|-
| 171 || [7.0.0+] SetChineseTraditionalInputMethod
| 171 || [7.0.0+] [[#SetChineseTraditionalInputMethod]]
|-
|-
| 172 || [7.0.0+] GetPtmCycleCountReliability
| 172 || [7.0.0+] GetPtmCycleCountReliability
Line 666: Line 875:
| 173 || [7.0.0+] SetPtmCycleCountReliability
| 173 || [7.0.0+] SetPtmCycleCountReliability
|-
|-
| 174 || [9.0.0+] [[#GetHomeMenuScheme]]
| 174 || [8.1.1+] [[#GetHomeMenuScheme]]
|-
|-
| 175 || [7.0.0+] GetThemeSettings
| 175 || [7.0.0+] GetThemeSettings
Line 690: Line 899:
| 185 || [9.0.0+] [[#GetHomeMenuSchemeModel]]
| 185 || [9.0.0+] [[#GetHomeMenuSchemeModel]]
|-
|-
| 186 || [9.0.0+] GetMemoryUsageRateFlag
| 186 || [9.0.0+] [[#GetMemoryUsageRateFlag]]
|-
| 187 || [9.0.0+] [[#GetTouchScreenMode]]
|-
|-
| 187 || [9.0.0+] GetTouchScreenMode
| 188 || [9.0.0+] [[#SetTouchScreenMode]]
|-
|-
| 188 || [9.0.0+] SetTouchScreenMode
| 189 || [10.0.0+] [[#GetButtonConfigSettingsFull]]
|-
| 190 || [10.0.0+] [[#SetButtonConfigSettingsFull]]
|-
| 191 || [10.0.0+] [[#GetButtonConfigSettingsEmbedded]]
|-
| 192 || [10.0.0+] [[#SetButtonConfigSettingsEmbedded]]
|-
| 193 || [10.0.0+] [[#GetButtonConfigSettingsLeft]]
|-
| 194 || [10.0.0+] [[#SetButtonConfigSettingsLeft]]
|-
| 195 || [10.0.0+] [[#GetButtonConfigSettingsRight]]
|-
| 196 || [10.0.0+] [[#SetButtonConfigSettingsRight]]
|-
| 197 || [10.0.0+] [[#GetButtonConfigRegisteredSettingsEmbedded]]
|-
| 198 || [10.0.0+] [[#SetButtonConfigRegisteredSettingsEmbedded]]
|-
| 199 || [10.0.0+] [[#GetButtonConfigRegisteredSettings]]
|-
| 200 || [10.0.0+] [[#SetButtonConfigRegisteredSettings]]
|}
|}


Official user-processes get a new service session handle each time a set:sys cmd is used, with the session being closed aftewards.
Official user-processes gets a new service session handle each time a set:sys cmd is used, with the session being closed afterwards.
 
== SetLanguageCode ==
Takes an input [[#LanguageCode]], no output.


== GetFirmwareVersion ==
== GetFirmwareVersion ==
Line 705: Line 941:


Then the above 0x100-byte data is copied to the output buffer.
Then the above 0x100-byte data is copied to the output buffer.
== GetAccountSettings ==
No input, returns an output [[#AccountSettings]].
== SetAccountSettings ==
Takes an input [[#AccountSettings]], no output.
== GetEulaVersions ==
Takes a type-0x6 output buffer containing an array of [[#EulaVersion]], returns an output s32 total_out.
== SetEulaVersions ==
Takes a type-0x5 input buffer containing an array of [[#EulaVersion]], no output.


== GetColorSetId ==
== GetColorSetId ==
Line 716: Line 964:
== SetColorSetId ==
== SetColorSetId ==
Takes an input s32, no output.
Takes an input s32, no output.
== GetNotificationSettings ==
No input, returns an output [[#NotificationSettings]].
== SetNotificationSettings ==
Takes an input [[#NotificationSettings]], no output.
== GetAccountNotificationSettings ==
Takes a type-0x6 output buffer containing an array of [[#AccountNotificationSettings]], returns an output s32 total_out.
== SetAccountNotificationSettings ==
Takes a type-0x5 input buffer containing an array of [[#AccountNotificationSettings]], no output.


== GetSettingsItemValue ==
== GetSettingsItemValue ==
Line 723: Line 983:


If loading from main config fails, it will also attempt to load config from various state if the input strings match hard-coded strings.
If loading from main config fails, it will also attempt to load config from various state if the input strings match hard-coded strings.
== GetTvSettings ==
No input, returns an output [[#TvSettings]].
== SetTvSettings ==
Takes an input [[#TvSettings]], no output.


== GetDebugModeFlag ==
== GetDebugModeFlag ==
Line 730: Line 996:


Returned retval is always 0.
Returned retval is always 0.
== GetPrimaryAlbumStorage ==
No input, returns an output s32 [[#PrimaryAlbumStorage]].
== SetPrimaryAlbumStorage ==
Takes an input s32 [[#PrimaryAlbumStorage]], no output.
== GetBatteryLot ==
No input, returns an output [[#BatteryLot]].


== GetSerialNumber ==
== GetSerialNumber ==
Returns the 0x18-byte SerialNumber string.
Returns the 0x18-byte SerialNumber string.
== GetSleepSettings ==
No input, returns an output [[#SleepSettings]].
== SetSleepSettings ==
Takes an input [[#SleepSettings]], no output.
== GetInitialLaunchSettings ==
No input, returns an output [[#InitialLaunchSettings]].
== SetInitialLaunchSettings ==
Takes an input [[#InitialLaunchSettings]], no output.
== GetProductModel ==
No input, returns an output s32.
== GetMiiAuthorId ==
No input, returns an output "nn::util::Uuid".


== GetServiceDiscoveryControlSettings ==
== GetServiceDiscoveryControlSettings ==
Returns an u32 [[#ServiceDiscoveryControlSettings|ServiceDiscoveryControlSettings]].
Returns an u32 [[#ServiceDiscoveryControlSettings|ServiceDiscoveryControlSettings]].
== GetErrorReportSharePermission ==
No input, returns an output s32 [[#ErrorReportSharePermission]].
== SetErrorReportSharePermission ==
Takes an input s32 [[#ErrorReportSharePermission]], no output.
== GetAppletLaunchFlags ==
No input, returns an u32 bitmask [[#AppletLaunchFlag]].
== SetAppletLaunchFlags ==
Takes an input u32 bitmask [[#AppletLaunchFlag]], no output.
== GetKeyboardLayout ==
No input, returns an output s32 [[#KeyboardLayout]].
== SetKeyboardLayout ==
Takes an input s32 [[#KeyboardLayout]], no output.


== GetAllowedSslHosts ==
== GetAllowedSslHosts ==
Takes a type-0x6 output buffer, returns an output s32. This buffer contains an array of 0x8-byte "nn::settings::system::AllowedSslHost" entries.
Takes a type-0x6 output buffer, returns an output s32 entry count. This buffer contains an array of 0x100-byte "nn::settings::system::AllowedSslHost" entries.
 
== GetRebootlessSystemUpdateVersion ==
No input, returns an output [[#RebootlessSystemUpdateVersion]].


== GetQuestFlag ==
== 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.
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.
== GetDataDeletionSettings ==
No input, returns an output [[#DataDeletionSettings]].
== SetDataDeletionSettings ==
Takes an input [[#DataDeletionSettings]], no output.
== GetWirelessCertificationFileSize ==
No input, returns an output u64 size.
== GetWirelessCertificationFile ==
Takes a type-0x6 output buffer, returns an output u64 size.
This gets the [[Flash_Filesystem#PRODINFOF|WirelessCertificationFile]].
== SetRegionCode ==
Takes an input s32 [[#RegionCode]], no output.
== GetChineseTraditionalInputMethod ==
No input, returns an output s32 [[#ChineseTraditionalInputMethod]].
== SetChineseTraditionalInputMethod ==
Takes an input s32 [[#ChineseTraditionalInputMethod]], no output.


== GetHomeMenuScheme ==
== GetHomeMenuScheme ==
Line 751: Line 1,088:


== GetT ==
== GetT ==
No input, returns an output u8 bool flag.
No input, returns an output u8 bool '''IsT'''.


[9.0.0+] This is a wrapper for [[#GetPlatformRegion]]: <code>flag = PlatformRegion==2</code>.
[9.0.0+] This is a wrapper for [[#GetPlatformRegion]]: <code>IsT = (PlatformRegion == 2)</code>.


== SetT ==
== SetT ==
Takes an input u8 bool flag, no output.
Takes an input u8 bool '''IsT''', no output.


[9.0.0+] This is a wrapper for [[#SetPlatformRegion]]: <code>PlatformRegion = 1 + (flag & 1)</code>.
[9.0.0+] This is a wrapper for [[#SetPlatformRegion]]: <code>PlatformRegion = 1 + (IsT & 1)</code>.


== GetPlatformRegion ==
== GetPlatformRegion ==
Line 770: Line 1,107:


Loads the 0xB-byte setting <"settings_debug", "home_menu_scheme_model">, throwing an error if loading this fails. Depending on the content of the setting, the output u32 is either determined by the value of this setting, or loaded from [[Calibration]].
Loads the 0xB-byte setting <"settings_debug", "home_menu_scheme_model">, throwing an error if loading this fails. Depending on the content of the setting, the output u32 is either determined by the value of this setting, or loaded from [[Calibration]].
== GetMemoryUsageRateFlag ==
No input, returns an output u8 bool.
== GetTouchScreenMode ==
No input, returns an output s32.
Official sw loads the output as an u8 and copies it to an output [[#TouchScreenMode]].
== SetTouchScreenMode ==
Takes an input s32, no output.
Official sw sets the input to an u8 loaded from an input [[#TouchScreenMode]].
== GetButtonConfigSettingsFull ==
Takes a type-0x6 output buffer containing an array of [[#ButtonConfigSettings]], returns an output s32.
== SetButtonConfigSettingsFull ==
Takes a type-0x5 input buffer containing an array of [[#ButtonConfigSettings]], no output.
== GetButtonConfigSettingsEmbedded ==
Takes a type-0x6 output buffer containing an array of [[#ButtonConfigSettings]], returns an output s32.
== SetButtonConfigSettingsEmbedded ==
Takes a type-0x5 input buffer containing an array of [[#ButtonConfigSettings]], no output.
== GetButtonConfigSettingsLeft ==
Takes a type-0x6 output buffer containing an array of [[#ButtonConfigSettings]], returns an output s32.
== SetButtonConfigSettingsLeft ==
Takes a type-0x5 input buffer containing an array of [[#ButtonConfigSettings]], no output.
== GetButtonConfigSettingsRight ==
Takes a type-0x6 output buffer containing an array of [[#ButtonConfigSettings]], returns an output s32.
== SetButtonConfigSettingsRight ==
Takes a type-0x5 input buffer containing an array of [[#ButtonConfigSettings]], no output.
== GetButtonConfigRegisteredSettingsEmbedded ==
Takes a type-0x16 output buffer containing a [[#ButtonConfigRegisteredSettings]], no output.
== SetButtonConfigRegisteredSettingsEmbedded ==
Takes a type-0x15 input buffer containing a [[#ButtonConfigRegisteredSettings]], no output.
== GetButtonConfigRegisteredSettings ==
Takes a type-0x6 output buffer containing an array of [[#ButtonConfigRegisteredSettings]], returns an output s32.
== SetButtonConfigRegisteredSettings ==
Takes a type-0x5 input buffer containing an array of [[#ButtonConfigRegisteredSettings]], no output.
== UserSelectorFlag ==
This is "nn::settings::system::UserSelectorFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || SkipsIfSingleUser
|-
| 31 || Unknown
|}
== UserSelectorSettings ==
This is "nn::settings::system::UserSelectorSettings".
This contains an u32 bitmask for [[#UserSelectorFlag]].
== AccountSettings ==
This is "nn::settings::system::AccountSettings".
This contains [[#UserSelectorSettings]].
== SteadyClockSourceId ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || NetworkSystemClock
|-
| 1 || SteadyClock
|}
== NotificationVolume ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || Mute
|-
| 1 || Low
|-
| 2 || High
|}
== FriendPresenceOverlayPermission ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || NotConfirmed
|-
| 1 || NoDisplay
|-
| 2 || FavoriteFriends
|-
| 3 || Friends
|}
== TvResolution ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || Auto
|-
| 1 || 1080p
|-
| 2 || 720p
|-
| 3 || 480p
|}
== HdmiContentType ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || None
|-
| 1 || Graphics
|-
| 2 || Cinema
|-
| 3 || Photo
|-
| 4 || Game
|}
== RgbRange ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || Auto
|-
| 1 || Full
|-
| 2 || Limited
|}
== CmuMode ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || None
|-
| 1 || ColorInvert
|-
| 2 || HighContrast
|-
| 3 || GrayScale
|}
== HandheldSleepPlan ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || 1Min
|-
| 1 || 3Min
|-
| 2 || 5Min
|-
| 3 || 10Min
|-
| 4 || 30Min
|-
| 5 || Never
|}
== ConsoleSleepPlan ==
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || 1Hour
|-
| 1 || 2Hour
|-
| 2 || 3Hour
|-
| 3 || 6Hour
|-
| 4 || 12Hour
|-
| 5 || Never
|}
== EulaVersion ==
This is "nn::settings::system::EulaVersion".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || Version
|-
| 0x4 || 0x4 || RegionCode
|-
| 0x8 || 0x4 || [[#SteadyClockSourceId|SteadyClockSourceId]]
|-
| 0xC || 0x4 || Reserved
|-
| 0x10 || 0x8 || [[Glue_services#PosixTime|NetworkClockTimePoint]]
|-
| 0x18 || 0x18 || [[Glue_services#SteadyClockTimePoint|SteadyClockTimePoint]]
|}
== NotificationTime ==
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || Hour
|-
| 0x4 || 0x4 || Minute
|}
== NotificationFlag ==
This is "nn::settings::system::NotificationFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || RingtoneFlag
|-
| 1 || DownloadCompletionFlag
|-
| 8 || EnablesNews
|-
| 9 || IncomingLampFlag
|}
== NotificationSettings ==
This is "nn::settings::system::NotificationSettings".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#NotificationFlag|NotificationFlag]]
|-
| 0x4 || 0x4 || [[#NotificationVolume|NotificationVolume]]
|-
| 0x8 || 0x8 || [[#NotificationTime|HeadTime]]
|-
| 0x10 || 0x8 || [[#NotificationTime|TailTime]]
|}
== AccountNotificationFlag ==
This is "nn::settings::system::AccountNotificationFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || FriendOnlineFlag
|-
| 1 || FriendRequestFlag
|-
| 8 || CoralInvitationFlag
|}
== AccountNotificationSettings ==
This is "nn::settings::system::AccountNotificationSettings".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x10 || [[Account_services|AccountUid]]
|-
| 0x10 || 0x4 || [[#AccountNotificationFlag|AccountNotificationFlag]]
|-
| 0x14 || 0x1 || [[#FriendPresenceOverlayPermission|FriendPresenceOverlayPermission]]
|-
| 0x15 || 0x1 || [[#FriendPresenceOverlayPermission|FriendInvitationOverlayPermission]]
|-
| 0x16 || 0x2 || Reserved
|}
== TvFlag ==
This is "nn::settings::system::TvFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || Allows4k
|-
| 1 || Allows3d
|-
| 2 || AllowsCec
|-
| 3 || PreventsScreenBurnIn
|}
== TvSettings ==
This is "nn::settings::system::TvSettings".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#TvFlag|TvFlag]]
|-
| 0x4 || 0x4 || [[#TvResolution|TvResolution]]
|-
| 0x8 || 0x4 || [[#HdmiContentType|HdmiContentType]]
|-
| 0xC || 0x4 || [[#RgbRange|RgbRange]]
|-
| 0x10 || 0x4 || [[#CmuMode|CmuMode]]
|-
| 0x14 || 0x4 || TvUnderscan
|-
| 0x18 || 0x4 || TvGamma
|-
| 0x1C || 0x4 || ContrastRatio
|}
== DataDeletionFlag ==
This is "nn::settings::system::DataDeletionFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || AutomaticDeletionFlag
|}
== DataDeletionSettings ==
This is "nn::settings::system::DataDeletionSettings".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#DataDeletionFlag|DataDeletionFlag]].
|-
| 0x4 || 0x4 || UseCount
|}
== BatteryLot ==
This is "nn::settings::BatteryLot". Its size is 0x18 bytes.
== SleepFlag ==
This is "nn::settings::system::SleepFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || SleepsWhilePlayingMedia
|-
| 1 || WakesAtPowerStateChange
|}
== SleepSettings ==
This is "nn::settings::system::SleepSettings".
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#SleepFlag|SleepFlag]]
|-
| 0x4 || 0x4 || [[#HandheldSleepPlan|HandheldSleepPlan]]
|-
| 0x8 || 0x4 || [[#ConsoleSleepPlan|ConsoleSleepPlan]]
|}
== InitialLaunchFlag ==
This is "nn::settings::system::InitialLaunchFlag".
{| class="wikitable" border="1"
!  Bits
!  Description
|-
| 0 || InitialLaunchCompletionFlag
|-
| 8 || InitialLaunchUserAdditionFlag
|-
| 16 || InitialLaunchTimestampFlag
|}
== InitialLaunchSettings ==
This is "nn::settings::system::InitialLaunchSettings". This struct is 8-byte aligned.
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#InitialLaunchFlag|InitialLaunchFlag]]
|-
| 0x4 || 0x4 || Reserved
|-
| 0x8 || 0x18 || [[Glue_services#SteadyClockTimePoint|InitialLaunchTimestampOffset]]
|}
== RebootlessSystemUpdateVersion ==
This is "nn::settings::system::RebootlessSystemUpdateVersion". This struct is 4-byte aligned.
This is the content of the RebootlessSystemUpdateVersion SystemData, in the "/version" file.
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || Version
|-
| 0x4 || 0x1C || Reserved
|-
| 0x20 || 0x20 || DisplayVersion
|}
== PrimaryAlbumStorage ==
This is u32 enum "nn::settings::system::PrimaryAlbumStorage".
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || Nand
|-
| 1 || SdCard
|}
== ErrorReportSharePermission ==
This is "nn::settings::system::ErrorReportSharePermission".
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 0 || NotConfirmed
|-
| 1 || Granted
|-
| 2 || Denied
|}


== ServiceDiscoveryControlSettings ==
== ServiceDiscoveryControlSettings ==
This is a 32-bit bitfield.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
!  Bits
!  Bits
Line 782: Line 1,582:
|}
|}


= System Config =
== AppletLaunchFlag ==
There's a common config title (*818), and a config title for each [[SPL_services|HardwareType]].
This is "nn::settings::system::AppletLaunchFlag". This is an u32 bitmask.
 
== KeyboardLayout ==
This is "nn::settings::KeyboardLayout".
 
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 1 || EnglishUs
|-
| 2 || EnglishUsInternational
|-
| 3 || EnglishUk
|-
| 4 || French
|-
| 5 || FrenchCa
|-
| 6 || Spanish
|-
| 7 || SpanishLatin
|-
| 8 || German
|-
| 9 || Italian
|-
| 10 || Portuguese
|-
| 11 || Russian
|-
| 12 || Korean
|-
| 13 || ChineseSimplified
|-
| 14 || ChineseTraditional
|}
 
== ChineseTraditionalInputMethod ==
This is "nn::settings::ChineseTraditionalInputMethod".
 
{| class="wikitable" border="1"
|-
!  Value
!  Description
|-
| 1 ||
|-
| 2 ||
|}
 
== TouchScreenMode ==
This is "nn::settings::system::TouchScreenMode".
 
This is an u8. This controls "Touch-Screen Sensitivity", values:
* 0: Stylus.
* 1: Standard, the default.
 
== ButtonConfigSettings ==
This is "nn::settings::system::ButtonConfigSettings". This is a 0x5A8-byte struct.
 
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x1 || IsFull bool flag. 0 = empty config, 1 = config set. Also accessed as an u32, but only bit0 is used.
|-
| 0x1 || 0x3 || Padding
|-
| 0x4 || 0x1C4 || Unused
|-
| 0x1C8 || 0x3E0 || Config
|}
 
== ButtonConfigRegisteredSettings ==
This is "nn::settings::system::ButtonConfigRegisteredSettings". This is a 0x5C8-byte struct.
 
== BluetoothDevicesSettings ==
This is "nn::settings::system::BluetoothDevicesSettings". This is a 0x200-byte struct.
 
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x6 || [[Bluetooth_Driver_services#Address|Address]]
|-
| 0x6 || 0x20 || Name string
|-
| 0x26 || 0x2 ||
|-
| 0x28 || 0x1 ||
|-
| 0x29 || 0x10 || Uuid
|-
| 0x39 || 0x1 ||
|-
| 0x3A || 0x2 ||
|-
| 0x3C || 0x4 ||
|-
| 0x40 || 0x2 ||
|-
| 0x42 || 0x2 ||
|-
| 0x44 || 0x2 ||
|-
| 0x46 || 0x80 ||
|-
| 0xC6 || 0x2 ||
|-
| 0xC8 || 0x1 ||
|-
| 0xC9 || 0x1 ||
|-
| 0xCA || 0x2 ||
|-
| 0xCC || 0x8 ||
|-
| 0xD4 || 0x1 ||
|-
| 0xD5 || 0x12B ||
|}
 
= System Configuration =
There's a common configuration title (*818), and one configuration title for each [[SMC#HardwareType|HardwareType]].


See [[System_Settings]].
See [[System_Settings]].


[[Category:Services]]
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Settings_services"