Settings services
set
This is "nn::settings::ISettingsServer".
Cmd | Name |
---|---|
0 | #GetLanguageCode |
1 | #GetAvailableLanguageCodes |
2 | [4.0.0+] #MakeLanguageCode |
3 | #GetAvailableLanguageCodeCount |
4 | #GetRegionCode |
5 | [4.0.0+] #GetAvailableLanguageCodes2 |
6 | [4.0.0+] #GetAvailableLanguageCodeCount2 |
7 | [4.0.0+] #GetKeyCodeMap |
8 | [5.0.0+] #GetQuestFlag |
9 | [6.0.0+] #GetKeyCodeMap2 |
10 | [9.0.0+] #GetFirmwareVersionForDebug |
11 | [10.1.0+] #GetDeviceNickName |
12 | [18.0.0+] GetKeyCodeMapByPort |
[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.
GetLanguageCode
No input, returns an output #LanguageCode. This is the current system language.
GetAvailableLanguageCodes
Takes a type-0xA buffer containing the #LanguageCode output array, returns an output s32.
MakeLanguageCode
Takes an input #Language, returns an output #LanguageCode.
GetAvailableLanguageCodeCount
No input, returns an output s32.
GetRegionCode
No input, returns a RegionCode.
GetAvailableLanguageCodes2
Takes a type-0x6 buffer containing the #LanguageCode output array, returns an output s32.
GetAvailableLanguageCodeCount2
No input, returns an output s32.
GetKeyCodeMap
Takes a type-0x16 output buffer containing KeyCodeMap, official sw uses fixed size 0x1000. This is probably related to HID keyboard.
GetFirmwareVersionForDebug
Takes a type-0x16 output buffer containing a 0x80-byte "nn::oe::FirmwareVersionForDebug".
This uses #GetDebugModeFlag internally, if the output flag is 0 an error is thrown.
This runs the same code as GetFirmwareVersion2, with the last 0x80-bytes of the output being copied to the output buffer.
set:fd
This is "nn::settings::IFirmwareDebugSettingsServer".
[4.0.0+] Only exposed if in development mode.
Cmd | Name |
---|---|
2 | SetSettingsItemValue |
3 | ResetSettingsItemValue |
4 | CreateSettingsItemKeyIterator |
10 | [4.0.0+] ReadSettings |
11 | [4.0.0+] ResetSettings |
20 | [4.0.0+] SetWebInspectorFlag |
21 | [4.0.0+] SetAllowedSslHosts |
22 | [4.0.0+] SetHostFsMountPoint |
23 | [9.0.0+] SetMemoryUsageRateFlag |
ISettingsItemKeyIterator
This is "nn::settings::ISettingsItemKeyIterator".
Cmd | Name |
---|---|
0 | GoNext |
1 | GetKeySize |
2 | GetKey |
set:cal
This is "nn::settings::IFactorySettingsServer".
Used for accessing data calibrated at the factory.
GetBluetoothBdAddress
No input. Returns a BdAddress.
GetConfigurationId1
No input. Returns a ConfigurationId1.
GetAccelerometerOffset
No input. Returns a AccelerometerOffset.
GetAccelerometerScale
No input. Returns a AccelerometerScale.
GetGyroscopeOffset
No input. Returns a GyroscopeOffset.
GetGyroscopeScale
No input. Returns a GyroscopeScale.
GetWirelessLanMacAddress
No input. Returns a MacAddress.
GetWirelessLanCountryCodeCount
No input. Returns a s32 OutCount.
GetWirelessLanCountryCodes
Takes a type-0x16 output buffer containing an array of CountryCode. Returns a s32 OutCount.
GetSerialNumber
No input. Returns a SerialNumber.
SetInitialSystemAppletProgramId
Takes an input ProgramId. No output.
SetOverlayDispProgramId
Takes an input ProgramId. No output.
GetBatteryLot
No input. Returns a BatteryLot.
GetEciDeviceCertificate
Takes a type-0x16 output buffer containing a EccB233DeviceCertificate. No output.
Returns the device certificate (ECC signed). This is identical to 3DS DeviceCert/CTCert besides the strings. NIM loads the DeviceId from this.
GetEticketDeviceCertificate
Takes a type-0x16 output buffer containing a Rsa2048DeviceCertificate. No output.
Returns the ETicket certificate (RSA signed).
GetSslKey
Takes a type-0x16 output buffer containing a SslKey. No output.
Returns the extended SSL key (0x130 bytes) from CAL0. If the extended key is not programmed then it falls back to the normal SSL key (0x110 bytes).
Used by SSL-sysmodule, see here.
GetSslCertificate
Takes a type-0x16 output buffer containing a SslCertificate. No output.
Used by SSL-sysmodule, see here.
GetGameCardKey
Takes a type-0x16 output buffer containing a GameCardKey. No output.
Returns the extended GameCard key (0x130 bytes) from CAL0. If the extended key is not programmed then it falls back to the normal GameCard key (0x110 bytes).
GetGameCardCertificate
Takes a type-0x16 output buffer containing a GameCardCertificate. No output.
GetEciDeviceKey
No input. Returns an EccB233DeviceKey.
Returns the extended device ECC-B233 key (0x50 bytes) from CAL0. If the extended key is not programmed then it falls back to the normal device ECC-B233 key (0x30 bytes).
GetEticketDeviceKey
Takes a type-0x16 output buffer containing a Rsa2048DeviceKey. No output.
Returns the extended ETicket RSA-2048 key (0x240 bytes) from CAL0. If the extended key is not programmed then it falls back to the normal ETicket RSA-2048 key (0x220 bytes).
GetSpeakerParameter
No input. Returns a SpeakerParameter.
GetLcdVendorId
No input. Returns a LcdVendorId.
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.
GetAmiiboKey
No input. Returns an AmiiboKey.
GetAmiiboEcqvCertificate
No input. Returns an AmiiboEcqvCertificate.
GetAmiiboEcdsaCertificate
No input. Returns an AmiiboEcdsaCertificate.
GetAmiiboEcqvBlsKey
No input. Returns an AmiiboEcqvBlsKey.
GetAmiiboEcqvBlsCertificate
No input. Returns an AmiiboEcqvBlsCertificate.
GetAmiiboEcqvBlsRootCertificate
No input. Returns an AmiiboEcqvBlsRootCertificate.
GetUsbTypeCPowerSourceCircuitVersion
No input. Returns an UsbTypeCPowerSourceCircuitVersion.
GetAnalogStickModuleTypeL
No input. Returns an AnalogStickModuleType.
GetAnalogStickModelParameterL
No input. Returns an AnalogStickModelParameter.
GetAnalogStickFactoryCalibrationL
No input. Returns an AnalogStickFactoryCalibration.
GetAnalogStickModuleTypeR
No input. Returns an AnalogStickModuleType.
GetAnalogStickModelParameterR
No input. Returns an AnalogStickModelParameter.
GetAnalogStickFactoryCalibrationR
No input. Returns an AnalogStickFactoryCalibration.
GetConsoleSixAxisSensorModuleType
No input. Returns a ConsoleSixAxisSensorModuleType.
GetConsoleSixAxisSensorHorizontalOffset
No input. Returns a ConsoleSixAxisSensorHorizontalOffset.
GetBatteryVersion
No input. Returns a BatteryVersion.
GetDeviceId
No input. Returns an u64 DeviceId by reading and converting the hexadecimal string at offset 0xC6 inside #EccB233DeviceCertificate or #Rsa2048DeviceCertificate.
GetConsoleSixAxisSensorMountType
No input. Returns a ConsoleSixAxisSensorMountType.
set:sys
This is "nn::settings::ISystemSettingsServer".
Cmd | Name |
---|---|
0 | #SetLanguageCode |
1 | SetNetworkSettings |
2 | GetNetworkSettings |
3 | #GetFirmwareVersion |
4 | [3.0.0+] GetFirmwareVersion2 |
5 | [5.0.0+] GetFirmwareVersionDigest |
7 | GetLockScreenFlag |
8 | SetLockScreenFlag |
9 | GetBacklightSettings |
10 | SetBacklightSettings |
11 | SetBluetoothDevicesSettings |
12 | GetBluetoothDevicesSettings |
13 | GetExternalSteadyClockSourceId |
14 | SetExternalSteadyClockSourceId |
15 | GetUserSystemClockContext |
16 | SetUserSystemClockContext |
17 | #GetAccountSettings |
18 | #SetAccountSettings |
19 | GetAudioVolume |
20 | SetAudioVolume |
21 | #GetEulaVersions |
22 | #SetEulaVersions |
23 | #GetColorSetId |
24 | #SetColorSetId |
25 | GetConsoleInformationUploadFlag |
26 | SetConsoleInformationUploadFlag |
27 | GetAutomaticApplicationDownloadFlag |
28 | SetAutomaticApplicationDownloadFlag |
29 | #GetNotificationSettings |
30 | #SetNotificationSettings |
31 | #GetAccountNotificationSettings |
32 | #SetAccountNotificationSettings |
35 | GetVibrationMasterVolume |
36 | SetVibrationMasterVolume |
37 | GetSettingsItemValueSize |
38 | #GetSettingsItemValue |
39 | #GetTvSettings |
40 | #SetTvSettings |
41 | GetEdid |
42 | SetEdid |
43 | GetAudioOutputMode |
44 | SetAudioOutputMode |
45 | GetSpeakerAutoMuteFlag ([1.0.0-12.1.0] IsForceMuteOnHeadphoneRemoved) |
46 | SetSpeakerAutoMuteFlag ([1.0.0-12.1.0] SetForceMuteOnHeadphoneRemoved) |
47 | #GetQuestFlag |
48 | SetQuestFlag |
49 | #GetDataDeletionSettings |
50 | #SetDataDeletionSettings |
51 | GetInitialSystemAppletProgramId |
52 | GetOverlayDispProgramId |
53 | GetDeviceTimeZoneLocationName |
54 | SetDeviceTimeZoneLocationName |
55 | #GetWirelessCertificationFileSize |
56 | #GetWirelessCertificationFile |
57 | #SetRegionCode |
58 | GetNetworkSystemClockContext |
59 | SetNetworkSystemClockContext |
60 | IsUserSystemClockAutomaticCorrectionEnabled |
61 | SetUserSystemClockAutomaticCorrectionEnabled |
62 | #GetDebugModeFlag |
63 | #GetPrimaryAlbumStorage |
64 | #SetPrimaryAlbumStorage |
65 | GetUsb30EnableFlag |
66 | SetUsb30EnableFlag |
67 | #GetBatteryLot |
68 | #GetSerialNumber |
69 | GetNfcEnableFlag |
70 | SetNfcEnableFlag |
71 | #GetSleepSettings |
72 | #SetSleepSettings |
73 | GetWirelessLanEnableFlag |
74 | SetWirelessLanEnableFlag |
75 | #GetInitialLaunchSettings |
76 | #SetInitialLaunchSettings |
77 | #GetDeviceNickName |
78 | #SetDeviceNickName |
79 | #GetProductModel |
80 | GetLdnChannel |
81 | SetLdnChannel |
82 | AcquireTelemetryDirtyFlagEventHandle |
83 | GetTelemetryDirtyFlags |
84 | GetPtmBatteryLot |
85 | SetPtmBatteryLot |
86 | GetPtmFuelGaugeParameter |
87 | SetPtmFuelGaugeParameter |
88 | GetBluetoothEnableFlag |
89 | SetBluetoothEnableFlag |
90 | #GetMiiAuthorId |
91 | SetShutdownRtcValue |
92 | GetShutdownRtcValue |
93 | AcquireFatalDirtyFlagEventHandle |
94 | GetFatalDirtyFlags |
95 | [2.0.0+] GetAutoUpdateEnableFlag |
96 | [2.0.0+] SetAutoUpdateEnableFlag |
97 | [2.0.0+] GetNxControllerSettings |
98 | [2.0.0+] SetNxControllerSettings |
99 | [2.0.0+] GetBatteryPercentageFlag |
100 | [2.0.0+] SetBatteryPercentageFlag |
101 | [2.0.0+] GetExternalRtcResetFlag |
102 | [2.0.0+] SetExternalRtcResetFlag |
103 | [3.0.0+] GetUsbFullKeyEnableFlag |
104 | [3.0.0+] SetUsbFullKeyEnableFlag |
105 | [3.0.0+] SetExternalSteadyClockInternalOffset |
106 | [3.0.0+] GetExternalSteadyClockInternalOffset |
107 | [3.0.0+] GetBacklightSettingsEx |
108 | [3.0.0+] SetBacklightSettingsEx |
109 | [3.0.0+] GetHeadphoneVolumeWarningCount |
110 | [3.0.0+] SetHeadphoneVolumeWarningCount |
111 | [3.0.0+] GetBluetoothAfhEnableFlag |
112 | [3.0.0+] SetBluetoothAfhEnableFlag |
113 | [3.0.0+] GetBluetoothBoostEnableFlag |
114 | [3.0.0+] SetBluetoothBoostEnableFlag |
115 | [3.0.0+] GetInRepairProcessEnableFlag |
116 | [3.0.0+] SetInRepairProcessEnableFlag |
117 | [3.0.0+] GetHeadphoneVolumeUpdateFlag |
118 | [3.0.0+] SetHeadphoneVolumeUpdateFlag |
119 | [3.0.0-14.1.2] NeedsToUpdateHeadphoneVolume |
120 | [3.0.0+] GetPushNotificationActivityModeOnSleep |
121 | [3.0.0+] SetPushNotificationActivityModeOnSleep |
122 | [4.0.0+] #GetServiceDiscoveryControlSettings |
123 | [4.0.0+] SetServiceDiscoveryControlSettings |
124 | [4.0.0+] #GetErrorReportSharePermission |
125 | [4.0.0+] #SetErrorReportSharePermission |
126 | [4.0.0+] #GetAppletLaunchFlags |
127 | [4.0.0+] #SetAppletLaunchFlags |
128 | [4.0.0+] GetConsoleSixAxisSensorAccelerationBias |
129 | [4.0.0+] SetConsoleSixAxisSensorAccelerationBias |
130 | [4.0.0+] GetConsoleSixAxisSensorAngularVelocityBias |
131 | [4.0.0+] SetConsoleSixAxisSensorAngularVelocityBias |
132 | [4.0.0+] GetConsoleSixAxisSensorAccelerationGain |
133 | [4.0.0+] SetConsoleSixAxisSensorAccelerationGain |
134 | [4.0.0+] GetConsoleSixAxisSensorAngularVelocityGain |
135 | [4.0.0+] SetConsoleSixAxisSensorAngularVelocityGain |
136 | [4.0.0+] #GetKeyboardLayout |
137 | [4.0.0+] #SetKeyboardLayout |
138 | [4.0.0+] GetWebInspectorFlag |
139 | [4.0.0+] #GetAllowedSslHosts |
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 |
158 | [8.1.1+] GetAnalogStickUserCalibrationL |
159 | [8.1.1+] SetAnalogStickUserCalibrationL |
160 | [8.1.1+] GetAnalogStickUserCalibrationR |
161 | [8.1.1+] SetAnalogStickUserCalibrationR |
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 |
174 | [8.1.1+] #GetHomeMenuScheme |
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 |
183 | [9.0.0+] #GetPlatformRegion |
184 | [9.0.0+] #SetPlatformRegion |
185 | [9.0.0+] #GetHomeMenuSchemeModel |
186 | [9.0.0+] #GetMemoryUsageRateFlag |
187 | [9.0.0+] #GetTouchScreenMode |
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 |
201 | [10.1.0+] #GetFieldTestingFlag |
202 | [10.1.0+] #SetFieldTestingFlag |
203 | [11.0.0+] GetPanelCrcMode |
204 | [11.0.0+] SetPanelCrcMode |
205 | [13.0.0+] GetNxControllerSettingsEx |
206 | [13.0.0+] SetNxControllerSettingsEx |
207 | [14.0.0+] GetHearingProtectionSafeguardFlag |
208 | [14.0.0+] SetHearingProtectionSafeguardFlag |
209 | [14.0.0+] GetHearingProtectionSafeguardRemainingTime |
210 | [14.0.0+] SetHearingProtectionSafeguardRemainingTime |
221 | [17.0.0+] GetForceMonauralOutputFlag |
222 | [17.0.0+] SetForceMonauralOutputFlag |
251 | [18.0.0+] GetAccountIdentificationSettings |
252 | [18.0.0+] SetAccountIdentificationSettings |
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
Takes a type-0x1A output buffer. User-processes use hard-coded size 0x100.
If needed, reads the content of the System_Version_Title "/file" into state. This is only done once.
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
No input, returns an output s32.
This is the current Theme set by System Settings.
- 0: "Basic White"
- 1: "Basic Black"
SetColorSetId
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
Takes two type-0x19 input buffers and a type-0x6 output buffer. Returns an output u64 for the actual size written to the outbuf.
The outbuf_size is compared with the config_size. When config_size is larger than outbuf_size, outbuf_size is used for the memcpy, otherwise config_size is used. Afterwards the size used for the memcpy is written to output(see above).
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
Returns an output u8.
Loads the 1-byte config for <"settings_debug", "is_debug_mode_enabled">. If that fails, value 0x1 is written to output. This uses the same func as ReadSetting internally.
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
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.
GetDeviceNickName
Takes a type-0x16 output buffer containing a #DeviceNickName.
With [10.1.0+] sdknso now uses the set cmd instead of the setsys cmd.
SetDeviceNickName
Takes a type-0x15 input buffer containing a #DeviceNickName.
GetProductModel
No input, returns an output s32.
GetMiiAuthorId
No input, returns an output "nn::util::Uuid".
GetServiceDiscoveryControlSettings
Returns an u32 ServiceDiscoveryControlSettings.
No input, returns an output s32 #ErrorReportSharePermission.
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
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
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 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
No input, returns an output 0x14-byte struct "nn::settings::system::HomeMenuScheme".
This struct contains 5 RGBA8 u32s for colors: Main, Back, Sub, Bezel and Extra.
The colors are loaded from Calibration, with the set of fields to use selected by ColorVariation. When ColorVariation is invalid (must be 1-4), the following fixed color values are returned: 0xFF323232, 0xFF323232, 0xFFFFFFFF, 0xFFFFFFFF, 0xFF000000.
GetT
No input, returns an output u8 bool IsT.
[9.0.0+] This is a wrapper for #GetPlatformRegion: IsT = (PlatformRegion == 2)
.
SetT
Takes an input u8 bool IsT, no output.
[9.0.0+] This is a wrapper for #SetPlatformRegion: PlatformRegion = 1 + (IsT & 1)
.
GetPlatformRegion
No input, returns an output s32.
SetPlatformRegion
Takes an input s32, no output.
GetHomeMenuSchemeModel
No input, returns an output u32.
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.
GetFieldTestingFlag
No input, returns an output bool.
SetFieldTestingFlag
Takes an input bool, no output.
Language
This is "nn::settings::Language".
Value | Description |
---|---|
0 | Japanese |
1 | AmericanEnglish |
2 | French |
3 | German |
4 | Italian |
5 | Spanish |
6 | Chinese |
7 | Korean |
8 | Dutch |
9 | Portuguese |
10 | Russian |
11 | Taiwanese |
12 | BritishEnglish |
13 | CanadianFrench |
14 | LatinAmericanSpanish |
15 | [4.0.0+] SimplifiedChinese |
16 | [4.0.0+] TraditionalChinese |
17 | [10.1.0+] BrazilianPortuguese |
LanguageCode
This is "nn::settings::LanguageCode". This is an u64, which is a NUL-terminated string.
Value | #Language |
---|---|
"ja" | Japanese |
"en-US" | AmericanEnglish |
"fr" | French |
"de" | German |
"it" | Italian |
"es" | Spanish |
"zh-CN" | Chinese |
"ko" | Korean |
"nl" | Dutch |
"pt" | Portuguese |
"ru" | Russian |
"zh-TW" | Taiwanese |
"en-GB" | BritishEnglish |
"fr-CA" | CanadianFrench |
"es-419" | LatinAmericanSpanish |
"zh-Hans" | [4.0.0+] SimplifiedChinese |
"zh-Hant" | [4.0.0+] TraditionalChinese |
"pt-BR" | [10.1.0+] BrazilianPortuguese |
AccelerometerOffset
This is "nn::settings::factory::AccelerometerOffset".
Offset | Size | Description |
---|---|---|
0x0 | 0x2 | X |
0x2 | 0x2 | Y |
0x4 | 0x2 | Z |
AccelerometerScale
This is "nn::settings::factory::AccelerometerScale".
Offset | Size | Description |
---|---|---|
0x0 | 0x2 | X |
0x2 | 0x2 | Y |
0x4 | 0x2 | Z |
AmiiboEcdsaCertificate
This is "nn::settings::factory::AmiiboEcdsaCertificate". This is a 0x70-byte struct.
AmiiboEcqvBlsCertificate
This is "nn::settings::factory::AmiiboEcqvBlsCertificate". This is a 0x20-byte struct.
AmiiboEcqvBlsKey
This is "nn::settings::factory::AmiiboEcqvBlsKey". This is a 0x40-byte struct.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x40 | Key |
0x40 | 0x4 | KeyGeneration |
AmiiboEcqvBlsRootCertificate
This is "nn::settings::factory::AmiiboEcqvBlsRootCertificate". This is a 0x90-byte struct.
AmiiboEcqvCertificate
This is "nn::settings::factory::AmiiboEcqvCertificate". This is a 0x14-byte struct.
AmiiboKey
This is "nn::settings::factory::AmiiboKey". This is a 0x50-byte struct.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x50 | Key |
0x50 | 0x4 | KeyGeneration |
AnalogStickFactoryCalibration
This is "nn::settings::factory::AnalogStickFactoryCalibration". Same as AnalogStickFactoryCalibration.
AnalogStickModelParameter
This is "nn::settings::factory::AnalogStickModelParameter". Same as AnalogStickModelParameter.
BatteryLot
This is "nn::settings::BatteryLot". This is a 0x18-byte struct.
BdAddress
This is "nn::settings::factory::BdAddress". This is a 0x6-byte struct.
ConfigurationId1
This is "nn::settings::factory::ConfigurationId1". This is a 0x1E-byte struct.
Usually, this is a string with the following format:
{EventType}_{ProductModelType}_{MajorVersion}_{MinorVersion}_{MicroVersion}
EventType
Value | Description |
---|---|
"FP" | Functional prototype |
"EP" | Engineering prototype |
"DP" | Design prototype |
"DPRD" | Design prototype for R&D |
"HOAG" | Hoag prototype |
"COPPER" | Copper prototype |
"EDEV" | Extcon development kit for Icosa and Iowa |
"SDEV" | SPI development kit for Icosa and Iowa |
"MEDEV" | Mariko EDEV (deprecated) |
"MSDEV" | Mariko SDEV (deprecated) |
"HDEV" | Development kit for Hoag |
"ADEV" | Development kit for Aula |
"MP" | Mass production (retail Icosa) |
"MNX" | Mariko NX (retail Iowa) |
"ANX" | Aula NX (retail Aula) |
ProductModelType
Value | Description |
---|---|
"00" | Icosa |
"01" | Iowa (previously Copper) |
"02" | Hoag |
"03" | Calcio |
"04" | Aula |
ConsoleSixAxisSensorHorizontalOffset
This is "nn::settings::factory::ConsoleSixAxisSensorHorizontalOffset". Same as ConsoleSixAxisSensorHorizontalOffset.
CountryCode
This is "nn::settings::factory::CountryCode". This is a 0x3-byte struct.
EccB233DeviceCertificate
This is "nn::settings::factory::EccB233DeviceCertificate". This is a 0x180-byte struct.
EccB233DeviceKey
This is "nn::settings::factory::EccB233DeviceKey". This is a 0x30-byte struct or a 0x54-byte struct in the extended version.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x54 | Key |
0x54 | 0x4 | KeyGeneration |
GameCardCertificate
This is "nn::settings::factory::GameCardCertificate". This is a 0x400-byte struct.
GameCardKey
This is "nn::settings::factory::GameCardKey". This is a 0x110-byte struct or a 0x130-byte struct in the extended version.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x130 | Key |
0x130 | 0x4 | KeyGeneration |
GyroscopeOffset
This is "nn::settings::factory::GyroscopeOffset".
Offset | Size | Description |
---|---|---|
0x0 | 0x2 | X |
0x2 | 0x2 | Y |
0x4 | 0x2 | Z |
GyroscopeScale
This is "nn::settings::factory::GyroscopeScale".
Offset | Size | Description |
---|---|---|
0x0 | 0x2 | X |
0x2 | 0x2 | Y |
0x4 | 0x2 | Z |
MacAddress
This is "nn::settings::factory::MacAddress". This is a 0x6-byte struct.
Rsa2048DeviceCertificate
This is "nn::settings::factory::Rsa2048DeviceCertificate". This is a 0x240-byte struct.
Rsa2048DeviceKey
This is "nn::settings::factory::Rsa2048DeviceKey". This is a 0x220-byte struct or a 0x240-byte struct in the extended version.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x240 | Key |
0x240 | 0x4 | KeyGeneration |
SerialNumber
This is "nn::settings::factory::SerialNumber". This is a 0x18-byte struct.
SpeakerParameter
This is "nn::settings::factory::SpeakerParameter". This is copied from the first 0x5A bytes of SpeakerCalibrationValue.
SslCertificate
This is "nn::settings::factory::SslCertificate". This is a 0x804-byte struct.
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Size |
0x4 | Variable | Data |
SslKey
This is "nn::settings::factory::SslKey". This is a 0x110-byte struct or a 0x130-byte struct in the extended version.
If Calibration Version >= 9, this is now:
Offset | Size | Description |
---|---|---|
0x0 | 0x130 | Key |
0x130 | 0x4 | KeyGeneration |
RegionCode
This is "nn::settings::factory::RegionCode".
Value | Description |
---|---|
0 | Japan |
1 | Usa |
2 | Europe |
3 | Australia |
4 | China |
5 | Korea |
6 | Taiwan |
AudioOutputMode
This is "nn::settings::system::AudioOutputMode".
Value | Description |
---|---|
0 | 1ch |
1 | 2ch |
2 | 5_1ch |
3 | 7_1ch |
AudioOutputModeTarget
This is "nn::settings::system::AudioOutputModeTarget".
Value | Description |
---|---|
0 | Hdmi |
1 | Speaker |
2 | Headphone |
AudioVolumeTarget
This is "nn::settings::system::AudioVolumeTarget".
Value | Description |
---|---|
0 | Speaker |
1 | Headphone |
DeviceNickName
This is "nn::settings::system::DeviceNickName". This is a 0x80-byte struct.
Edid
This is "nn::settings::system::Edid".
Offset | Size | Description |
---|---|---|
0x0 | 0x80 | Data0 |
0x80 | 0x80 | Data1 |
RegionCode
This is "nn::settings::system::RegionCode".
Value | Description |
---|---|
0 | Japan |
1 | Usa |
2 | Europe |
3 | Australia |
4 | HongKongTaiwanKorea |
5 | China |
UserSelectorFlag
This is "nn::settings::system::UserSelectorFlag".
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.
ClockSourceId
This is "nn::settings::system::ClockSourceId".
Value | Description |
---|---|
0 | NetworkSystemClock |
1 | SteadyClock |
NotificationVolume
This is "nn::settings::system::NotificationVolume".
Value | Description |
---|---|
0 | Mute |
1 | Low |
2 | High |
FriendPresenceOverlayPermission
This is "nn::settings::system::FriendPresenceOverlayPermission".
Value | Description |
---|---|
0 | NotConfirmed |
1 | NoDisplay |
2 | FavoriteFriends |
3 | Friends |
TvResolution
This is "nn::settings::system::TvResolution".
Value | Description |
---|---|
0 | Auto |
1 | 1080p |
2 | 720p |
3 | 480p |
HdmiContentType
This is "nn::settings::system::HdmiContentType".
Value | Description |
---|---|
0 | None |
1 | Graphics |
2 | Cinema |
3 | Photo |
4 | Game |
RgbRange
This is "nn::settings::system::RgbRange".
Value | Description |
---|---|
0 | Auto |
1 | Full |
2 | Limited |
CmuMode
This is "nn::settings::system::CmuMode".
Value | Description |
---|---|
0 | None |
1 | ColorInvert |
2 | HighContrast |
3 | GrayScale |
HandheldSleepPlan
This is "nn::settings::system::HandheldSleepPlan".
Value | Description |
---|---|
0 | 1Min |
1 | 3Min |
2 | 5Min |
3 | 10Min |
4 | 30Min |
5 | Never |
ConsoleSleepPlan
This is "nn::settings::system::ConsoleSleepPlan".
Value | Description |
---|---|
0 | 1Hour |
1 | 2Hour |
2 | 3Hour |
3 | 6Hour |
4 | 12Hour |
5 | Never |
EulaVersion
This is "nn::settings::system::EulaVersion".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Version |
0x4 | 0x4 | RegionCode |
0x8 | 0x4 | ClockType |
0xC | 0x4 | Reserved |
0x10 | 0x8 | NetworkSystemClock |
0x18 | 0x18 | SteadyClock |
FirmwareVersion
This is "nn::settings::system::FirmwareVersion".
Offset | Size | Description |
---|---|---|
0x0 | 0x1 | Major |
0x1 | 0x1 | Minor |
0x2 | 0x1 | Micro |
0x3 | 0x1 | Reserved |
0x4 | 0x4 | ReleaseNumber |
0x8 | 0x20 | Platform |
0x28 | 0x40 | Revision |
0x68 | 0x18 | DisplayVersion |
0x80 | 0x80 | DisplayName |
PtmFuelGaugeParameter
This is "nn::settings::system::PtmFuelGaugeParameter".
Offset | Size | Description |
---|---|---|
0x0 | 0x2 | Rcomp0 |
0x2 | 0x2 | TempCo |
0x4 | 0x2 | FullCap |
0x6 | 0x2 | FullCapNom |
0x8 | 0x2 | IavgEmpty |
0xA | 0x2 | QrTable00 |
0xC | 0x2 | QrTable10 |
0xE | 0x2 | QrTable20 |
0x10 | 0x2 | QrTable30 |
0x12 | 0x2 | Reserved |
0x14 | 0x4 | Cycles |
SecuritySettings
This is "nn::settings::system::SecuritySettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | AuthenticationMode |
0x4 | 0x4 | EncryptionMode |
0x8 | 0x40 | KeyMaterial |
0x48 | 0x4 | KeyMaterialLength |
NotificationTime
This is "nn::settings::system::NotificationTime".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Hour |
0x4 | 0x4 | Minute |
NotificationFlag
This is "nn::settings::system::NotificationFlag".
Bits | Description |
---|---|
0 | RingtoneFlag |
1 | DownloadCompletionFlag |
8 | EnablesNews |
9 | IncomingLampFlag |
NotificationSettings
This is "nn::settings::system::NotificationSettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Flags |
0x4 | 0x4 | Volume |
0x8 | 0x8 | HeadTime |
0x10 | 0x8 | TailTime |
AccountNotificationFlag
This is "nn::settings::system::AccountNotificationFlag".
Bits | Description |
---|---|
0 | FriendOnlineFlag |
1 | FriendRequestFlag |
8 | CoralInvitationFlag |
AccountNotificationSettings
This is "nn::settings::system::AccountNotificationSettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x10 | Uid |
0x10 | 0x4 | Flags |
0x14 | 0x1 | FriendPresenceOverlayPermission |
0x15 | 0x1 | FriendInvitationOverlayPermission |
0x16 | 0x2 | Reserved |
TvFlag
This is "nn::settings::system::TvFlag".
Bits | Description |
---|---|
0 | Allows4k |
1 | Allows3d |
2 | AllowsCec |
3 | PreventsScreenBurnIn |
TvSettings
This is "nn::settings::system::TvSettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Flags |
0x4 | 0x4 | TvResolution |
0x8 | 0x4 | HdmiContentType |
0xC | 0x4 | RgbRange |
0x10 | 0x4 | CmuMode |
0x14 | 0x4 | TvUnderscan |
0x18 | 0x4 | TvGamma |
0x1C | 0x4 | ContrastRatio |
DataDeletionFlag
This is "nn::settings::system::DataDeletionFlag".
Bits | Description |
---|---|
0 | AutomaticDeletionFlag |
DataDeletionSettings
This is "nn::settings::system::DataDeletionSettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Flags |
0x4 | 0x4 | UseCount |
SleepFlag
This is "nn::settings::system::SleepFlag".
Bits | Description |
---|---|
0 | SleepsWhilePlayingMedia |
1 | WakesAtPowerStateChange |
SleepSettings
This is "nn::settings::system::SleepSettings".
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Flags |
0x4 | 0x4 | HandheldSleepPlan |
0x8 | 0x4 | ConsoleSleepPlan |
InitialLaunchFlag
This is "nn::settings::system::InitialLaunchFlag".
Bits | Description |
---|---|
0 | InitialLaunchCompletionFlag |
8 | InitialLaunchUserAdditionFlag |
16 | InitialLaunchTimestampFlag |
InitialLaunchSettings
This is "nn::settings::system::InitialLaunchSettings". This struct is 8-byte aligned.
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Flags |
0x4 | 0x4 | Reserved |
0x8 | 0x18 | TimeStamp |
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.
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Version |
0x4 | 0x1C | Reserved |
0x20 | 0x20 | DisplayVersion |
PrimaryAlbumStorage
This is "nn::settings::system::PrimaryAlbumStorage".
Value | Description |
---|---|
0 | Nand |
1 | SdCard |
This is "nn::settings::system::ErrorReportSharePermission".
Value | Description |
---|---|
0 | NotConfirmed |
1 | Granted |
2 | Denied |
ServiceDiscoveryControlSettings
This is "nn::settings::system::ServiceDiscoveryControlSettings".
Bits | Description |
---|---|
0 | IsChangeEnvironmentIdentifierDisabled |
AppletLaunchFlag
This is "nn::settings::system::AppletLaunchFlag". This is an u32 bitmask.
KeyboardLayout
This is "nn::settings::KeyboardLayout".
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".
Value | Description |
---|---|
1 | |
2 |
TouchScreenMode
This is "nn::settings::system::TouchScreenMode".
Value | Description |
---|---|
0 | Stylus |
1 | Standard |
ButtonConfigSettings
This is "nn::settings::system::ButtonConfigSettings". This is a 0x5A8-byte struct.
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.
Offset | Size | Description |
---|---|---|
0x0 | 0x6 | BdAddr |
0x6 | 0x20 | DeviceName |
0x26 | 0x3 | ClassOfDevice |
0x29 | 0x10 | LinkKey |
0x39 | 0x1 | LinkKeyPresent |
0x3A | 0x2 | Version |
0x3C | 0x4 | TrustedServices |
0x40 | 0x2 | Vid |
0x42 | 0x2 | Pid |
0x44 | 0x1 | SubClass |
0x45 | 0x1 | AttributeMask |
0x46 | 0x2 | DescriptorLength |
0x48 | 0x80 | Descriptor |
0xC8 | 0x1 | KeyType |
0xC9 | 0x1 | DeviceType |
0xCA | 0x2 | BrrSize |
0xCC | 0x9 | Brr |
0xD5 | 0x12B | Reserved |
NxControllerLegacySettings
This is "nn::settings::system::NxControllerLegacySettings" ([1.0.0-12.1.0] "nn::settings::system::NxControllerSettings"). This is a 0x29-byte struct.
NxControllerSettings
This is "nn::settings::system::NxControllerSettings". This is a 0x42C-byte struct. This was added with [13.0.0+].
System Configuration
There's a common configuration title (*818), and one configuration title for each HardwareType.
See System_Settings.