Nintendo Switch Brew - Recent changes [en]

Settings services

Hexkyz — Thu, 14 May 2026 01:04:13 GMT

← Older revision		Revision as of 05:04, 14 May 2026
Line 2,575:		Line 2,575:
	= ProductModel =		= ProductModel =
	Ths is "nn::settings::system::ProductModel".		Ths is "nn::settings::system::ProductModel".

	~~Range 1-6 is Nintendo Switch, range 7-12 is Nintendo Switch 2.~~

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Value		! Value
	! ~~[[#ProductModelName~~\|~~ProductModelName]]~~		! Description
			\|-
			\| 0 \|\| Invalid
			\|-
			\| 1 \|\| Nx
	\|-		\|-
	\| 1 \|\| ~~"HAC"~~		\| 2 \|\| NxCopper
	\|-		\|-
	\| 3 \|\| ~~"HAD"~~		\| 3 \|\| NxIowa
	\|-		\|-
	\| 4 \|\| ~~"HDH"~~		\| 4 \|\| NxHoag
	\|-		\|-
	\| 6 \|\| ~~"HEG"~~		\| 5 \|\| NxCalcio
	\|-		\|-
	\| 7 \|\| ~~"BEE"~~		\| 6 \|\| NxAula
			\|-
			\| 7 \|\|
			\|-
			\| 8 \|\|
			\|-
			\| 9 \|\|
			\|-
			\| 10 \|\|
			\|-
			\| 11 \|\|
			\|-
			\| 12 \|\|
	\|}		\|}

			Range 1-6 is Nintendo Switch, range 7-12 is Nintendo Switch 2.

	= ProductModelName =		= ProductModelName =
	This is "nn::settings::system::ProductModelName". This is a 0x8-byte struct containing a [[#ProductModel\|string]].		This is "nn::settings::system::ProductModelName". This is a 0x8-byte struct containing a [[#ProductModel\|string]].

	= ~~System Configuration~~ =		{\| class="wikitable" border="1"
			\|-
			! Value
			! [[#ProductModel\|ProductModel]]
			\|-
			\| "HAC" \|\| 1
			\|-
			\| "HAD" \|\| 3
			\|-
			\| "HDH" \|\| 4
			\|-
			\| "HEG" \|\| 6
			\|-
			\| "BEE" \|\| 7
			\|}

			= SystemConfiguration =
	There's a common configuration title (*818), and one configuration title for each [[SMC#HardwareType\|HardwareType]].		There's a common configuration title (*818), and one configuration title for each [[SMC#HardwareType\|HardwareType]].

Migration services

Yellows8 — Wed, 13 May 2026 15:03:58 GMT

Show changes

Network

Yellows8 — Tue, 12 May 2026 21:37:50 GMT

transfer

← Older revision		Revision as of 01:37, 13 May 2026
(4 intermediate revisions by the same user not shown)
Line 274:		Line 274:
	** The json response is parsed as the following (HTTP status must be 201):		** The json response is parsed as the following (HTTP status must be 201):
	*** <code>{"transfer_event":{"transfer_event_id":<number>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>		*** <code>{"transfer_event":{"transfer_event_id":<number>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>
	*** The minimum required fields are status and ~~created_at~~. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and expires_at. <status_str> must match one of various strings, such as "started".
	*** The output transfer_event_id is then used as the first "%lld" in the above URIs.		*** The output transfer_event_id is then used as the first "%lld" in the above URIs.
			*** The rest of the fields are likely only used with "nn::migration::device::*" (?).

	* "/%lld/%s":		* "/%lld/%s":
	** The POST data is empty.		** The POST data is empty.
	** The json response is parsed as the following (HTTP status must be 200):		** The json response is parsed as the following (HTTP status must be 200):
	*** {...}		*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

			* "/%lld":
			** This is used following certain network requests which failed, depending on the Result. In one case it's used without a prior network request.
			** No POST data (?).
			** The json response is parsed as the following (HTTP status must be 200):
			*** This is parsed similar to /start above. The minimum required fields are the same as /start.
			*** Most usage of this will return 0 instead of the Result from the request which failed, when status is the expected value and expires_at>0.

			* "/%lld/register_destination":
			** The json POST data contains the following:
			*** <code>{"dst_device_appearance_main":"<str0>","dst_device_appearance_controller":"<str1>"}</code>
			*** <str0>/<str1> are the same as with "/start".
			** The json response is parsed as the following (HTTP status must be 200):
			*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

			* "/%lld/save_datas/%lld/generate_key_seed_package" / "/%lld/generate_key_seed_package":
			** The json POST data contains the following:
			*** <code>{"challenge":"%s"}</code>
			*** Where %s is the 0x10-byte challenge ([[Filesystem_services#ISaveDataTransferManagerWithDivision\|ISaveDataTransferManagerWithDivision GetChallenge]]) printed with "%02x" for each byte.
			** The response is parsed as follows (HTTP status must be 200):
			*** This is base64 decoded. The output is then later used with [[Filesystem_services#ISaveDataTransferManagerWithDivision\|ISaveDataTransferManagerWithDivision SetKeySeedPackage]].

	== Others ==		== Others ==

Settings services

Timschneeb — Mon, 11 May 2026 02:55:04 GMT

GetKeyCodeMap

@@ Line 61: / Line 61: @@
 == GetKeyCodeMap ==
-Takes a type-0x16 output buffer containing KeyCodeMap, official sw uses fixed size 0x1000. This is probably related to HID keyboard.
+Takes a type-0x16 output buffer containing KeyCodeMap, official sw uses fixed size 0x1000. This is related to the USB HID keyboard.
 == GetFirmwareVersionForDebug ==

User:Timschneeb

Timschneeb — Mon, 11 May 2026 00:59:54 GMT

User account Timschneeb was created

Qlaunch

UltraSearcher123 — Sun, 10 May 2026 20:45:22 GMT

Forgot to close the parentheses :p

@@ Line 1: / Line 1: @@
-This is the title with process-name "qlaunch" launched by [[NS_services|ns]] with a [[NCM_services#ProgramId|ProgramId]] loaded from system-config.
+This is the title with process name "qlaunch" (Quick Launch), launched by [[NS_services|NS services]], with its [[NCM_services#ProgramId|Program ID]] being loaded from system config.
 * Home Menu
 * [[System Settings]]
@@ Line 7: / Line 8: @@
 = Hidden Features =
 == Flog ==
-qlaunch periodically checks if the user is in "/RootScene/SceneResidentMenu", which represents the Home Menu (aka main-menu). If so, the following checks are then performed in order:
+qlaunch periodically checks if the user is in "/RootScene/SceneResidentMenu", which represents the Home Menu (aka main-menu).
 * The Joy-Cons' state is read from [[HID_Shared_Memory|HID shared memory]] and both must be active and detached from the console.
-* "StartSixAxisSensor" [[HID_services#hid|hid]] command is called for each Joy-Con so motion data can be captured.
+** (The "StartSixAxisSensor" [[HID_services#hid|HID]] command is called for each Joy-Con so that motion data can be captured).
-* After capturing the motion data, the same motion checks for both Joy-Cons must pass at the same time. This motion data is analyzed in a small state machine consisting of a total of 7 steps and the motion itself is a reference to [https://www.youtube.com/watch?v=BdQg43n2OaM&t=17s Iwata's Direct gesture]. Hold the Joy-Cons pointing forwards/downwards, then move Joy-Cons to a vertical position, and hold it there for a bit. The Joy-Con grip can be used for this.
-* The system's month and day must be July 11th, which is the date of Iwata's [https://en.wikipedia.org/wiki/Satoru_Iwata passing]. The loaded date originates from network-time-sync'd time, regardless of whether the user has it enabled or not. When the system was never connected to the Internet and is on [[1.0.0]] it comes from the user-specified date instead. For newer systems, trying to load the network time if it was never set will result in an error: they won't ever be able to launch flog without a time-sync with Nintendo servers. This is loaded from the [[PCV_services|time]] service-cmds, with the actual time-sync being handled by [[NIM_services|NIM]].
+* After capturing the motion data, the same motion checks for both Joy-Cons must pass at the same time:
-* A wrapper for "GetLanguageCode" [[Settings_services#set|set]] command is called and the returned code must be 0 (JPja), 1 (USen) or 2 (EUen). Other combinations of region and language may have it's code translated internally to a valid one (0, 1 or 2), which seems to be the case for 12 (CNzh), 13 (KRko) and 14 (TWzh).
+** (This motion data is analyzed via a 7-step process; the motion itself is a reference to [https://www.youtube.com/watch?v=BdQg43n2OaM&t=17s Iwata's 'Nintendo Direct' gesture], and may take a few attempts to get right)
-* Lastly, "IsSystemProgramInstalled" [[NS_Services#ns:am|ns:am]] command is called, which should return 1 if the [[Flog|flog]] title is installed.
+*** 1) Hold the Joy-Cons in your hand as if you were gripping a steering wheel.
-Once everything passes it continues to the code which launches [[Flog|flog]]. When [[Flog|flog]] is launched a small audio clip named "SeTestTone" is played which matches [https://www.youtube.com/embed/SeVTJu_Yn2Y?start=17&end=18&autoplay=1 this].
+To access the menu, the following conditions must be met:
-As of [[4.0.0]] this feature has been removed from qlaunch.
+* Open the "Settings" app from the Home Menu.
-== SaveData Repair ==
+This will call various [[OLSC_services#olsc:s|OLSC services]], which in turn will issue requests to [[Network#storage|repair services]].
-This will call various [[OLSC_services#olsc:s|olsc:s]] which in turn will issue requests to the [[Network#storage|repair service]]. Without specific authorization from the server, this will always display a message like: "This feature is currently unavailable."
+(Without specific authorization from the server, this will always display a message stating "This feature is currently unavailable", and the menu will not appear).

User:UltraSearcher123

UltraSearcher123 — Sun, 10 May 2026 18:49:23 GMT

User account UltraSearcher123 was created

Network

Yellows8 — Sat, 09 May 2026 03:26:47 GMT

transfer

← Older revision		Revision as of 07:26, 9 May 2026
Line 276:		Line 276:
	*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".
	*** The output transfer_event_id is then used as the first "%lld" in the above URIs.		*** The output transfer_event_id is then used as the first "%lld" in the above URIs.

			* "/%lld/%s":
			** The POST data is empty.
			** The json response is parsed as the following (HTTP status must be 200):
			*** {...}

	== Others ==		== Others ==

Migration services

Yellows8 — Sat, 09 May 2026 01:22:45 GMT

AbortAsync2

← Older revision		Revision as of 05:22, 9 May 2026
(One intermediate revision by the same user not shown)
Line 487:		Line 487:
	This is roughly the same as [[#AbortAsync\|AbortAsync]] except for the additional functionality done by the async task (etc), for when the input bool is set.		This is roughly the same as [[#AbortAsync\|AbortAsync]] except for the additional functionality done by the async task (etc), for when the input bool is set.

	The async task does the following in that block when the input bool is ~~set~~ (handling any errors as needed / calling any logging funcs as needed):		The async task does the following in that block when the input bool is false (handling any errors as needed / calling any logging funcs as needed):
	* This block also only runs when a vfunc ret is false.		* This block also only runs when a vfunc ret is false.
	** Calls a func.		** Calls a func.
	*** Calls a func to get ~~a state field~~, if this ~~is -1~~ this ~~then~~ just returns 0.		*** Calls a func to get the [[#GetTransferEventId\|transfer_event_id]], if this wasn't set yet this just returns 0.
	*** Calls a func.		*** Calls a func.
	*** Handles [[Sockets_services\|sockets]]/etc initialization.		*** Handles [[Sockets_services\|sockets]]/etc initialization.
Line 496:		Line 496:
	*** Uses network request [[Network\|transfer_events/%lld/abort_transfer]].		*** Uses network request [[Network\|transfer_events/%lld/abort_transfer]].
	*** Nifm usage ends here. Handles [[Sockets_services\|sockets]] cleanup, etc.		*** Nifm usage ends here. Handles [[Sockets_services\|sockets]] cleanup, etc.
	** If the above func returned an error, depending on the Result this may call a func which logs a report with [[PSC_services\|srepo]].		** If the above func returned an error, depending on the Result this may call a func which logs a report with [[PSC_services\|srepo]]. If this code-path is used it also sets the Result returned later to 0.

	=== DebugWaitStateSynchronizationFinalizedAsync ===		=== DebugWaitStateSynchronizationFinalizedAsync ===

Error codes

Yellows8 — Fri, 08 May 2026 22:05:33 GMT

Error Codes

← Older revision		Revision as of 02:05, 9 May 2026
Line 1,857:		Line 1,857:
	\| 0x17727C \|\| 124 \|\| 3001 \|\| ResultUnacceptableApplicationVersion		\| 0x17727C \|\| 124 \|\| 3001 \|\| ResultUnacceptableApplicationVersion
	\|-		\|-
	\| 0x1F4E7C \|\| 124 \|\| 4007 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/28046/ ~~Account~~ Permanent Ban]		\| 0x1F4E7C \|\| 124 \|\| 4007 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/28046/ Console Permanent Ban]
	\|-		\|-
	\| 0x23387C \|\| 124 \|\| 4508 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/28046/ ~~Account~~ Permanent Ban]		\| 0x23387C \|\| 124 \|\| 4508 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/28046/ Console Permanent Ban]
	\|-		\|-
	\| 0x234A7C \|\| 124 \|\| 4517 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/43652/ ~~Account~~ Ban]		\| 0x234A7C \|\| 124 \|\| 4517 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/43652/ Console Ban]
	\|-		\|-
	\| 0x24027C \|\| 124 \|\| 4609 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/46482/ Service Discontinued]		\| 0x24027C \|\| 124 \|\| 4609 \|\| [https://en-americas-support.nintendo.com/app/answers/detail/a_id/46482/ Service Discontinued]

Migration services

Yellows8 — Fri, 08 May 2026 18:09:59 GMT

ConnectByServerIdAsync

← Older revision		Revision as of 22:09, 8 May 2026
(3 intermediate revisions by the same user not shown)
Line 461:		Line 461:
	** Clears the connected state flag.		** Clears the connected state flag.
	* Calls a vfunc, throwing an error when ret is false.		* Calls a vfunc, throwing an error when ret is false.
	* Calls a func.		* Calls a func. This essentially loops through the fs data also used by [[#GetList\|GetList]], using [[NS_services\|IApplicationManagerInterface DeleteSaveData]] with each entry (with the SaveDataId field from the entry and SaveDataSpaceId = User).
	* Calls vfuncs, then returns.		* Calls vfuncs, then returns.

Line 470:		Line 470:
	* ...		* ...
	* Runs essentially the same code-block as [[#CompleteAsync\|CompleteAsync]] for the connected flag, without the network messages.		* Runs essentially the same code-block as [[#CompleteAsync\|CompleteAsync]] for the connected flag, without the network messages.
	* When a vfunc returns true, call a func.		* When a vfunc returns true, call the same savedata-deletion func as [[#CompleteAsync\|CompleteAsync]].
	* Calls vfuncs then returns.		* Calls vfuncs then returns.

Line 597:		Line 597:
	*** The funcs called from the above flag-block are roughly same. These send a message, handle receiving a message, then send another message + receive a message. For flag==false these are [[#Messages\|MessageId]] 0x0/0x1, while for flag==true these are MessageId 0x8/0x9.		*** The funcs called from the above flag-block are roughly same. These send a message, handle receiving a message, then send another message + receive a message. For flag==false these are [[#Messages\|MessageId]] 0x0/0x1, while for flag==true these are MessageId 0x8/0x9.
	** A func is called which copies 0x10-bytes from entryptr+0x10+0x26C into state.		** A func is called which copies 0x10-bytes from entryptr+0x10+0x26C into state.
	* ~~Clears stack.~~ Calls a func.		* Calls a func to get the data which is sent with SendClientProfile below.
	* Calls a func. This uses network message [[#SendClientProfile\|SendClientProfile]].		* Calls a func. This uses network message [[#SendClientProfile\|SendClientProfile]].
	* Calls a vfunc.		* Calls a vfunc.
Line 609:		Line 609:
	*** Uses network message [[#GetList\|GetList]].		*** Uses network message [[#GetList\|GetList]].
	*** Calls a func.		*** Calls a func.
	** Calls a func. (fs ~~related?)~~		** Calls a func. This loops through the fs data previously received by [[#GetList\|GetList]], to sum the size field (entry+0x4) with each entry. Once finished this updates state then writes data into a separate fs file.
	** Calls a func. This uses network message [[#Leave\|Leave]]. Then the socket is closed. Lastly, a func is called which handles closing [[LDN_services\|ldn]] (CloseStation, Finalize) and [[Sockets_services\|sockets]].		** Calls a func. This uses network message [[#Leave\|Leave]]. Then the socket is closed. Lastly, a func is called which handles closing [[LDN_services\|ldn]] (CloseStation, Finalize) and [[Sockets_services\|sockets]].
	** Calls a func.		** Calls a func.
Line 653:		Line 653:
	* ...		* ...
	* Calls vfuncs.		* Calls vfuncs.
	* Calls various funcs to check state. ~~This includes calling~~ a fs~~-related~~ func?		* Calls various funcs to check state. Depending on state this may call a func which:
			** Loops through the fs data previously received by [[#GetList\|GetList]]. With each entry, calls a func. This uses [[Filesystem_services\|FindSaveDataWithFilter]] and uses the output with [[NS_services\|IApplicationManagerInterface DeleteSaveData]].
	* If a state flag is not set, a func is called:		* If a state flag is not set, a func is called:
	** Uses network message [[#PrepareTransferDisconnect\|PrepareTransferDisconnect]].		** Uses network message [[#PrepareTransferDisconnect\|PrepareTransferDisconnect]].
Line 662:		Line 663:
	** Calls the func which handles reconnecting to the network.		** Calls the func which handles reconnecting to the network.
	* Calls a func when a previously loaded state field is 0.		* Calls a func when a previously loaded state field is 0.
	* Calls a func. ~~(fs related?)~~		* Calls a func to read the current entry, from the fs data previously received with [[#GetList\|GetList]].
	* Calls a func which validates the output from ~~an earlier~~ func.		* Calls a func which validates the entry data output from the above func (u8 +0x0).
	* Logs a report with [[PSC_services\|srepo]].		* Logs a report with [[PSC_services\|srepo]]. Includes data from the above entry, etc.
	* Uses network message [[#PrepareTransfer\|PrepareTransfer]]. Uses [[Filesystem_services\|ISaveDataTransferManagerWithDivision SetLocalKeySeedPackage]] with the relevant response data.		* Uses network message [[#PrepareTransfer\|PrepareTransfer]]. Uses [[Filesystem_services\|ISaveDataTransferManagerWithDivision SetLocalKeySeedPackage]] with the relevant response data.
	* Logs a report with [[PSC_services\|srepo]]. "tr_size" is logged by adding two u64 fields from the 0x20-byte struct returned by [[#PrepareTransfer\|PrepareTransfer]]: +0x18 and +0x8.		* Logs a report with [[PSC_services\|srepo]]. "tr_size" is logged by adding two u64 fields from the 0x20-byte struct returned by [[#PrepareTransfer\|PrepareTransfer]]: +0x18 and +0x8.
	* Calls a func.		* Calls a func, for loading data from the above entry.
	* Calls a func for getting state data.		* Calls a func for getting state data.
	* Calls a func which writes the various input to the output struct. This is then passed to the the following func which is called:		* Calls a func which writes the various input to the output struct. This is then passed to the the following func which is called:
Line 703:		Line 704:
	* Handles cleanup for [[Sockets_services\|sockets]].		* Handles cleanup for [[Sockets_services\|sockets]].
	* When successful at this point it runs the following block:		* When successful at this point it runs the following block:
	** Calls a func. (fs ~~related?)~~		** Calls a func. This loops through the fs data previously received by [[#GetList\|GetList]]. With each entry, uses [[NS_services\|IApplicationVersionInterface UpgradeLaunchRequiredVersion]] with the data from the entry. Uses [[OLSC_services\|IRemoteStorageController]] cmd28, then when successful uses [[OLSC_services\|IRemoteStorageController GetLoadedDataInfo]]. Then [[OLSC_services\|IOlscServiceForSystemService SetUserSaveDataProperty]] is used with the entry data. Once finished, it also uses [[OLSC_services\|IDaemonController RunTransferTaskAutonomyRegistration]].
	** Calls a func.		** Calls a func.
	** Calls a func, which logs a report with [[PSC_services\|srepo]].		** Calls a func, which logs a report with [[PSC_services\|srepo]].
Line 712:		Line 713:
	No input/output.		No input/output.

	When the [[#ConnectByServerIdAsync\|connected]] state flag is set, this runs code similar to [[#SuspendAsync\|SuspendAsync]], without the network message. Then ~~various vfuncs are called~~. ~~Various funcs are also called~~ as ~~needed (fs related?)~~.		When the [[#ConnectByServerIdAsync\|connected]] state flag is set, this runs code similar to [[#SuspendAsync\|SuspendAsync]], without the network message. Then:
			* Calls a vfunc. When ret is true:
			** Calls a vfunc. When ret is true, calls the same func for UpgradeLaunchRequiredVersion as [[#CompleteAsync_2\|CompleteAsync]].
			** Otherwise when false:
			*** Calls a vfunc.
			*** Calls the same savedata-deletion func as [[#TransferNextAsync\|TransferNextAsync]].
			* Calls vfuncs.

	=== AbortAsync ===		=== AbortAsync ===
Line 1,421:		Line 1,428:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| Type: 0 = SaveDataType System, 1 = SaveDataType Account, 2 = SaveDataType Device.		\| 0x0 \|\| 0x1 \|\| Type: 0 = SaveDataType System, 1 = SaveDataType Account, 2 = SaveDataType Device. >=3 is invalid.
	\|-		\|-
	\| 0x1 \|\| 0x1 \|\| IsAccountIdValid (whether loading the AccountId was successful when UserId is non-zero)		\| 0x1 \|\| 0x1 \|\| IsAccountIdValid (whether loading the AccountId was successful when UserId is non-zero)