Controller Applet - Revision history

Yellows8 at 18:03, 16 December 2020

2020-12-16T17:03:21Z

@@ Line 92: / Line 92: @@
 |-
 | 0x1 || 0x3 || u8 padding[3].
 |}
@@ Line 146: / Line 164: @@
 |-
 | 0x4 || 0x4 || u32 selectedId, NpadId.
 |}

Yellows8: /* ControllerSupportArgPrivate */

2020-12-16T16:48:36Z

ControllerSupportArgPrivate

← Older revision		Revision as of 19:48, 16 December 2020
Line 33:		Line 33:
	\| 0x0 \|\| 0x4 \|\| Size of this ControllerSupportArgPrivate struct.		\| 0x0 \|\| 0x4 \|\| Size of this ControllerSupportArgPrivate struct.
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| Size of ~~the storage following this one (~~[[#ControllerSupportArg~~]] or [[#ControllerFirmwareUpdateArg]]). With ShowControllerKeyRemappingForSystem, this is the size of [[#ControllerSupportArg]] even though the actual storage is [[#ControllerKeyRemappingArg~~]].		\| 0x4 \|\| 0x4 \|\| Size of [[#ControllerSupportArg]].
	\|-		\|-
	\| 0x8 \|\| 0x1 \|\| Flag0		\| 0x8 \|\| 0x1 \|\| Flag0

Yellows8 at 17:31, 16 December 2020

2020-12-16T16:31:38Z

← Older revision		Revision as of 19:31, 16 December 2020
Line 16:		Line 16:
	\|-		\|-
	\| [8.0.0+] \|\| 0x7		\| [8.0.0+] \|\| 0x7
			\|-
			\| [11.0.0+] \|\| 0x8
	\|}		\|}

Line 31:		Line 33:
	\| 0x0 \|\| 0x4 \|\| Size of this ControllerSupportArgPrivate struct.		\| 0x0 \|\| 0x4 \|\| Size of this ControllerSupportArgPrivate struct.
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| Size of the storage following this one ([[#ControllerSupportArg]] or [[#ControllerFirmwareUpdateArg]]).		\| 0x4 \|\| 0x4 \|\| Size of the storage following this one ([[#ControllerSupportArg]] or [[#ControllerFirmwareUpdateArg]]). With ShowControllerKeyRemappingForSystem, this is the size of [[#ControllerSupportArg]] even though the actual storage is [[#ControllerKeyRemappingArg]].
	\|-		\|-
	\| 0x8 \|\| 0x1 \|\| Flag0		\| 0x8 \|\| 0x1 \|\| Flag0
Line 39:		Line 41:
	\| 0xA \|\| 0x1 \|\| [[#ControllerSupportMode]]		\| 0xA \|\| 0x1 \|\| [[#ControllerSupportMode]]
	\|-		\|-
	\| 0xB \|\| 0x1 \|\| [[#ControllerSupportCaller]]. Always zero except with ShowControllerFirmwareUpdateForSystem, which sets this to the input param.		\| 0xB \|\| 0x1 \|\| [[#ControllerSupportCaller]]. Always zero except with ShowControllerFirmwareUpdateForSystem/ShowControllerKeyRemappingForSystem, which sets this to the input param.
	\|-		\|-
	\| 0xC \|\| 0x4 \|\| Output from [[HID_services#GetSupportedNpadStyleSet\|GetSupportedNpadStyleSet]]. With ShowControllerSupportForSystem on pre-3.0.0 this is value 0.		\| 0xC \|\| 0x4 \|\| Output from [[HID_services#GetSupportedNpadStyleSet\|GetSupportedNpadStyleSet]]. With ShowControllerSupportForSystem on pre-3.0.0 this is value 0.
Line 103:		Line 105:
	\| 1 \|\| [3.0.0+] ShowControllerStrapGuide		\| 1 \|\| [3.0.0+] ShowControllerStrapGuide
	\|-		\|-
	\| 2 \|\| [3.0.0+] ShowControllerFirmwareUpdate		\| 2 \|\| [3.0.0+] ShowControllerFirmwareUpdate
			\|-
			\| 4 \|\| [11.0.0+] ShowControllerKeyRemappingForSystem
	\|}		\|}

Line 142:		Line 146:
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| u32 selectedId, NpadId.		\| 0x4 \|\| 0x4 \|\| u32 selectedId, NpadId.
			\|}

			== ControllerKeyRemappingArg ==
			This is "nn::hid::system::ControllerKeyRemappingArg". This is a 0x10-byte struct.

			The defaults for this is all-zero for the first 0xC-bytes.

			{\| class="wikitable" border="1"
			\|-
			! Offset
			! Size
			! Description
			\|-
			\| 0x0 \|\| 0x8 \|\|
			\|-
			\| 0x8 \|\| 0x4 \|\|
			\|-
			\| 0xC \|\| 0x4 \|\| Padding
	\|}		\|}

	== Usage ==		== Usage ==
	User-processes should push a common arguments struct, an [[#ControllerSupportArgPrivate]], then [[#ControllerSupportArg]] or [[#ControllerFirmwareUpdateArg]].		User-processes should push a common arguments struct, an [[#ControllerSupportArgPrivate]], then [[#ControllerSupportArg]] / [[#ControllerFirmwareUpdateArg]] / [[#ControllerKeyRemappingArg]].

	On success, an output storage should be popped, with size 0xC being used to read from there (sdknso ignores the actual storage size). When [[#ControllerSupportArg]] was previously used, the first 8-bytes are copied to the output [[#ControllerSupportResultInfo]] (which the user can ignore), otherwise it's ignored. The remaining u32 determines the Result:		On success, an output storage should be popped, with size 0xC being used to read from there (sdknso ignores the actual storage size). When [[#ControllerSupportArg]] was previously used, the first 8-bytes are copied to the output [[#ControllerSupportResultInfo]] (which the user can ignore), otherwise it's ignored. The remaining u32 determines the Result:

Yellows8 at 21:23, 28 November 2019

2019-11-28T20:23:15Z

← Older revision		Revision as of 23:23, 28 November 2019
Line 48:		Line 48:
	== ControllerSupportArg ==		== ControllerSupportArg ==
	This is "nn::hid::ControllerSupportArg". This is a 0x21C-byte (0x9C-byte with version <=0x2, 0x430-byte with version 0x7) struct pushed for input storage.		This is "nn::hid::ControllerSupportArg". This is a 0x21C-byte (0x9C-byte with version <=0x2, 0x430-byte with version 0x7) struct pushed for input storage.

	~~Layout with the original version:~~

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 57:		Line 55:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| s8 playerCountMin (must be >=0 and <=~~max_controllers~~). Older versions assert when invalid, newer versions clamp the used value to a valid range.		\| 0x0 \|\| 0x1 \|\| s8 playerCountMin (must be >=0 and <=max_supported_players). Older versions assert when invalid, newer versions clamp the used value to a valid range.
	\|-		\|-
	\| 0x1 \|\| 0x1 \|\| s8 playerCountMax (must be >=1 and <=~~max_controllers~~). Older versions assert when invalid, newer versions clamp the used value to a valid range.		\| 0x1 \|\| 0x1 \|\| s8 playerCountMax (must be >=1 and <=max_supported_players). Older versions assert when invalid, newer versions clamp the used value to a valid range.
	\|-		\|-
	\| 0x2 \|\| 0x1 \|\| u8 enableTakeOverConnection.		\| 0x2 \|\| 0x1 \|\| u8 enableTakeOverConnection. Disconnects the controllers when not enabled.
	\|-		\|-
	\| 0x3 \|\| 0x1 \|\| u8 enableLeftJustify.		\| 0x3 \|\| 0x1 \|\| u8 enableLeftJustify.
Line 67:		Line 65:
	\| 0x4 \|\| 0x1 \|\| u8 enablePermitJoyDual.		\| 0x4 \|\| 0x1 \|\| u8 enablePermitJoyDual.
	\|-		\|-
	\| 0x5 \|\| 0x1 \|\| u8 enableSingleMode.		\| 0x5 \|\| 0x1 \|\| u8 enableSingleMode. Enables using a single player in handheld-mode, dual-mode, or single-mode (playerCount* are overridden). Using handheld-mode is not allowed if this is not enabled.
	\|-		\|-
	\| 0x6 \|\| 0x1 \|\| u8 enableIdentificationColor. Enables using the array ~~at offset 0x7~~ when non-zero.		\| 0x6 \|\| 0x1 \|\| u8 enableIdentificationColor. Enables using the identificationColor array when non-zero.
	\|-		\|-
	\| 0x7 \|\| 4*~~max_controllers~~ \|\| u8 identificationColor[4]. Array of 4-byte entries for each ~~controller~~, see below for total entries (max controllers). This entry contains ~~individual~~ u8s.		\| 0x7 \|\| 4*max_supported_players \|\| u8 identificationColor[4]. Array of 4-byte entries for each player, see below for total entries (max controllers). This entry contains 4 u8s, for the RGBA8 color. This controls the color of the UI player box outline.
	\|-		\|-
	\| 0x7 + 4*~~max_controllers~~ \|\| 0x1 \|\| u8 enableExplainText. Enables using the ExplainText data when non-zero.		\| 0x7 + 4*max_supported_players \|\| 0x1 \|\| u8 enableExplainText. Enables using the ExplainText data when non-zero.
	\|}		\|}

Line 89:		Line 87:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| u8 enableForceUpdate.		\| 0x0 \|\| 0x1 \|\| u8 enableForceUpdate, non-zero to enable. Default is 0. Forces a firmware update when enabled, without an UI option to skip it.
	\|-		\|-
	\| 0x1 \|\| 0x3 \|\| u8 padding[3].		\| 0x1 \|\| 0x3 \|\| u8 padding[3].
Line 115:		Line 113:

	ShowControllerSupportCore will assert if the mode is ShowControllerFirmwareUpdate, and ShowControllerFirmwareUpdateCore will assert if the mode is not ShowControllerFirmwareUpdate.		ShowControllerSupportCore will assert if the mode is ShowControllerFirmwareUpdate, and ShowControllerFirmwareUpdateCore will assert if the mode is not ShowControllerFirmwareUpdate.

			ShowControllerSupport seems to only display the applet UI when doing so is actually needed?(This doesn't apply to the ForSystem version)

	== ControllerSupportCaller ==		== ControllerSupportCaller ==
Line 124:		Line 124:
	\|-		\|-
	\| 0 \|\| Application		\| 0 \|\| Application
			\|-
			\| 1 \|\| Skips the firmware-update confirmation dialog. This has the same affect as using the controller-update option from qlaunch System Settings.
	\|}		\|}

Line 139:		Line 141:
	\| 0x1 \|\| 0x3 \|\| u8 padding[3].		\| 0x1 \|\| 0x3 \|\| u8 padding[3].
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| u32 selectedId.		\| 0x4 \|\| 0x4 \|\| u32 selectedId, NpadId.
	\|}		\|}

Yellows8: /* ControllerSupportMode */

2019-11-27T19:20:02Z

ControllerSupportMode

← Older revision		Revision as of 22:20, 27 November 2019
Line 113:		Line 113:

	ShowControllerFirmwareUpdateForSystem is the same as ShowControllerFirmwareUpdate, except [[#ControllerSupportArgPrivate\|Flag1]] is set to 1 and [[#ControllerSupportArgPrivate\|ControllerSupportCaller]] is set to the input param.		ShowControllerFirmwareUpdateForSystem is the same as ShowControllerFirmwareUpdate, except [[#ControllerSupportArgPrivate\|Flag1]] is set to 1 and [[#ControllerSupportArgPrivate\|ControllerSupportCaller]] is set to the input param.

			ShowControllerSupportCore will assert if the mode is ShowControllerFirmwareUpdate, and ShowControllerFirmwareUpdateCore will assert if the mode is not ShowControllerFirmwareUpdate.

	== ControllerSupportCaller ==		== ControllerSupportCaller ==

Hexkyz at 19:23, 27 November 2019

2019-11-27T18:23:24Z

← Older revision		Revision as of 21:23, 27 November 2019
Line 37:		Line 37:
	\| 0x9 \|\| 0x1 \|\| Flag1		\| 0x9 \|\| 0x1 \|\| Flag1
	\|-		\|-
	\| 0xA \|\| 0x1 \|\| [[#~~Type~~]]		\| 0xA \|\| 0x1 \|\| [[#ControllerSupportMode]]
	\|-		\|-
	\| 0xB \|\| 0x1 \|\| ~~<code>nn::hid::system::~~ControllerSupportCaller~~</code>~~. Always zero except with ShowControllerFirmwareUpdateForSystem, which sets this to the input param.		\| 0xB \|\| 0x1 \|\| [[#ControllerSupportCaller]]. Always zero except with ShowControllerFirmwareUpdateForSystem, which sets this to the input param.
	\|-		\|-
	\| 0xC \|\| 0x4 \|\| Output from [[HID_services#GetSupportedNpadStyleSet\|GetSupportedNpadStyleSet]]. With ShowControllerSupportForSystem on pre-3.0.0 this is value 0.		\| 0xC \|\| 0x4 \|\| Output from [[HID_services#GetSupportedNpadStyleSet\|GetSupportedNpadStyleSet]]. With ShowControllerSupportForSystem on pre-3.0.0 this is value 0.
Line 94:		Line 94:
	\|}		\|}

	== ~~Type~~ ==		== ControllerSupportMode ==
			This is "nn::hid::system::ControllerSupportMode".

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 111:		Line 113:

	ShowControllerFirmwareUpdateForSystem is the same as ShowControllerFirmwareUpdate, except [[#ControllerSupportArgPrivate\|Flag1]] is set to 1 and [[#ControllerSupportArgPrivate\|ControllerSupportCaller]] is set to the input param.		ShowControllerFirmwareUpdateForSystem is the same as ShowControllerFirmwareUpdate, except [[#ControllerSupportArgPrivate\|Flag1]] is set to 1 and [[#ControllerSupportArgPrivate\|ControllerSupportCaller]] is set to the input param.

			== ControllerSupportCaller ==
			This is "nn::hid::system::ControllerSupportCaller".

			{\| class="wikitable" border="1"
			\|-
			! Value \|\| Description
			\|-
			\| 0 \|\| Application
			\|}

	== ControllerSupportResultInfo ==		== ControllerSupportResultInfo ==

Hexkyz: /* Type */

2019-11-27T16:20:11Z

Type

← Older revision		Revision as of 19:20, 27 November 2019
Line 97:		Line 97:
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! ~~Name \|\| Type value~~ \|\| Description		! Value \|\| Description
	\|-		\|-
	~~\| ShowControllerSupport \|~~\| 0 \|\|		\| 0 \|\| ShowControllerSupport
	\|-		\|-
	\| [3.0.0+] ShowControllerStrapGuide ~~\|\| 1 \|\|~~		\| 1 \|\| [3.0.0+] ShowControllerStrapGuide
	\|-		\|-
	\| [3.0.0+] ShowControllerFirmwareUpdate ~~\|\| 2 \|\|~~		\| 2 \|\| [3.0.0+] ShowControllerFirmwareUpdate
	\|}		\|}

Hexkyz at 17:17, 27 November 2019

2019-11-27T16:17:59Z

← Older revision		Revision as of 19:17, 27 November 2019
Line 57:		Line 57:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| s8 playerCountMin, must be >=0 and <=max_controllers. Older versions assert when invalid, newer versions clamp the used value to a valid range.		\| 0x0 \|\| 0x1 \|\| s8 playerCountMin (must be >=0 and <=max_controllers). Older versions assert when invalid, newer versions clamp the used value to a valid range.
	\|-		\|-
	\| 0x1 \|\| 0x1 \|\| s8 playerCountMax, must be >=1 and <=max_controllers. Older versions assert when invalid, newer versions clamp the used value to a valid range.		\| 0x1 \|\| 0x1 \|\| s8 playerCountMax (must be >=1 and <=max_controllers). Older versions assert when invalid, newer versions clamp the used value to a valid range.
	\|-		\|-
	\| 0x2 \|\| ~~0x4~~ \|\| ~~Unknown~~ u8 ~~flags, non-zero for enabled~~.		\| 0x2 \|\| 0x1 \|\| u8 enableTakeOverConnection.
	\|-		\|-
	\| ~~0x6~~ \|\| 0x1 \|\| ~~Enables using the array at offset 0x7 when non-zero~~.		\| 0x3 \|\| 0x1 \|\| u8 enableLeftJustify.
	\|-		\|-
	\| ~~0x7~~ \|\| ~~4*max_controllers~~ \|\| ~~Array of 4-byte entries for each controller, see below for total entries (max controllers). This entry contains individual u8s~~.		\| 0x4 \|\| 0x1 \|\| u8 enablePermitJoyDual.
	\|-		\|-
	\| 0x7 + 4*max_controllers \|\| 0x1 \|\| Enables using the ExplainText data when non-zero.		\| 0x5 \|\| 0x1 \|\| u8 enableSingleMode.
			\|-
			\| 0x6 \|\| 0x1 \|\| u8 enableIdentificationColor. Enables using the array at offset 0x7 when non-zero.
			\|-
			\| 0x7 \|\| 4*max_controllers \|\| u8 identificationColor[4]. Array of 4-byte entries for each controller, see below for total entries (max controllers). This entry contains individual u8s.
			\|-
			\| 0x7 + 4*max_controllers \|\| 0x1 \|\| u8 enableExplainText. Enables using the ExplainText data when non-zero.
	\|}		\|}

Line 83:		Line 89:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| u8 ~~flag~~		\| 0x0 \|\| 0x1 \|\| u8 enableForceUpdate.
	\|-		\|-
	\| 0x1 \|\| 0x3 \|\| ~~Unused~~.		\| 0x1 \|\| 0x3 \|\| u8 padding[3].
	\|}		\|}

Line 115:		Line 121:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| ?		\| 0x0 \|\| 0x1 \|\| s8 playerCount.
	\|-		\|-
	\| 0x1 \|\| 0x3 \|\| ~~Padding~~		\| 0x1 \|\| 0x3 \|\| u8 padding[3].
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\| ?		\| 0x4 \|\| 0x4 \|\| u32 selectedId.
	\|}		\|}

Yellows8: /* ControllerSupportResultInfo */

2019-11-27T04:59:36Z

ControllerSupportResultInfo

@@ Line 108: / Line 108: @@
 == ControllerSupportResultInfo ==
 This is "nn::hid::ControllerSupportResultInfo". This is a 8-byte struct.
 == Usage ==

Yellows8: /* ControllerFirmwareUpdateArg */

2019-11-27T04:50:22Z

ControllerFirmwareUpdateArg

← Older revision		Revision as of 07:50, 27 November 2019
Line 83:		Line 83:
	! Description		! Description
	\|-		\|-
	\| 0x0 \|\| 0x1 \|\| ?		\| 0x0 \|\| 0x1 \|\| u8 flag
	\|-		\|-
	\| 0x1 \|\| 0x3 \|\| Unused.		\| 0x1 \|\| 0x3 \|\| Unused.