HID services

See here for the HID shared-memory.

hid

This is "nn::hid::IHidServer".

Cmd	Name
0	#CreateAppletResource
1	ActivateDebugPad
11	ActivateTouchScreen
21	ActivateMouse
31	ActivateKeyboard
32	[6.0.0+] SendKeyboardLockKeyEvent
40	AcquireXpadIdEventHandle
41	ReleaseXpadIdEventHandle
51	ActivateXpad
55	GetXpadIds
56	ActivateJoyXpad
58	GetJoyXpadLifoHandle
59	GetJoyXpadIds
60	ActivateSixAxisSensor
61	DeactivateSixAxisSensor
62	GetSixAxisSensorLifoHandle
63	ActivateJoySixAxisSensor
64	DeactivateJoySixAxisSensor
65	GetJoySixAxisSensorLifoHandle
66	StartSixAxisSensor
67	StopSixAxisSensor
68	IsSixAxisSensorFusionEnabled
69	EnableSixAxisSensorFusion
70	#SetSixAxisSensorFusionParameters
71	#GetSixAxisSensorFusionParameters
72	#ResetSixAxisSensorFusionParameters
73	SetAccelerometerParameters
74	GetAccelerometerParameters
75	ResetAccelerometerParameters
76	SetAccelerometerPlayMode
77	GetAccelerometerPlayMode
78	ResetAccelerometerPlayMode
79	#SetGyroscopeZeroDriftMode
80	#GetGyroscopeZeroDriftMode
81	#ResetGyroscopeZeroDriftMode
82	IsSixAxisSensorAtRest
83	[6.0.0+] IsFirmwareUpdateAvailableForSixAxisSensor
91	ActivateGesture
100	#SetSupportedNpadStyleSet
101	#GetSupportedNpadStyleSet
102	#SetSupportedNpadIdType
103	#ActivateNpad
104	#DeactivateNpad
106	#AcquireNpadStyleSetUpdateEventHandle
107	DisconnectNpad
108	GetPlayerLedPattern
109	[5.0.0+] #ActivateNpadWithRevision
120	#SetNpadJoyHoldType
121	#GetNpadJoyHoldType
122	#SetNpadJoyAssignmentModeSingleByDefault
123	#SetNpadJoyAssignmentModeSingle
124	#SetNpadJoyAssignmentModeDual
125	#MergeSingleJoyAsDualJoy
126	StartLrAssignmentMode
127	StopLrAssignmentMode
128	SetNpadHandheldActivationMode
129	#GetNpadHandheldActivationMode
130	SwapNpadAssignment
131	IsUnintendedHomeButtonInputProtectionEnabled
132	EnableUnintendedHomeButtonInputProtection
133	[5.0.0+] SetNpadJoyAssignmentModeSingleWithDestination
134	[6.1.0+] SetNpadAnalogStickUseCenterClamp
135	[8.0.0+] SetNpadCaptureButtonAssignment
136	[8.0.0+] ClearNpadCaptureButtonAssignment
200	#GetVibrationDeviceInfo
201	#SendVibrationValue
202	#GetActualVibrationValue
203	#CreateActiveVibrationDeviceList
204	#PermitVibration
205	#IsVibrationPermitted
206	#SendVibrationValues
207	[4.0.0+] SendVibrationGcErmCommand
208	[4.0.0+] GetActualVibrationGcErmCommand
209	[4.0.0+] BeginPermitVibrationSession
210	[4.0.0+] EndPermitVibrationSession
211	[7.0.0+] #IsVibrationDeviceMounted
300	[3.0.0+] #ActivateConsoleSixAxisSensor
301	[3.0.0+] StartConsoleSixAxisSensor
302	[3.0.0+] StopConsoleSixAxisSensor
303	[5.0.0+] #ActivateSevenSixAxisSensor
304	[5.0.0+] #StartSevenSixAxisSensor
305	[5.0.0+] #StopSevenSixAxisSensor
306	[5.0.0+] #InitializeSevenSixAxisSensor
307	[5.0.0+] #FinalizeSevenSixAxisSensor
308	[5.0.0+] #SetSevenSixAxisSensorFusionStrength
309	[5.0.0+] #GetSevenSixAxisSensorFusionStrength
310	[6.0.0+] #ResetSevenSixAxisSensorTimestamp
400	[3.0.0+] IsUsbFullKeyControllerEnabled
401	[3.0.0+] EnableUsbFullKeyController
402	[3.0.0+] IsUsbFullKeyControllerConnected
403	[4.0.0+] HasBattery
404	[4.0.0+] HasLeftRightBattery
405	[4.0.0+] #GetNpadInterfaceType
406	[4.0.0+] GetNpadLeftRightInterfaceType
407	[9.0.0+] GetNpadOfHighestBatteryLevelForJoyLeft
408	[9.0.0+] GetNpadOfHighestBatteryLevelForJoyRight
500	[5.0.0+] GetPalmaConnectionHandle
501	[5.0.0+] InitializePalma
502	[5.0.0+] AcquirePalmaOperationCompleteEvent
503	[5.0.0+] GetPalmaOperationInfo
504	[5.0.0+] PlayPalmaActivity
505	[5.0.0+] SetPalmaFrModeType
506	[5.0.0+] ReadPalmaStep
507	[5.0.0+] EnablePalmaStep
508	[5.0.0+] ResetPalmaStep
509	[5.0.0+] ReadPalmaApplicationSection
510	[5.0.0+] WritePalmaApplicationSection
511	[5.0.0+] ReadPalmaUniqueCode
512	[5.0.0+] SetPalmaUniqueCodeInvalid
513	[5.0.0+] WritePalmaActivityEntry
514	[5.0.0+] WritePalmaRgbLedPatternEntry
515	[5.0.0+] WritePalmaWaveEntry
516	[5.0.0+] SetPalmaDataBaseIdentificationVersion
517	[5.0.0+] GetPalmaDataBaseIdentificationVersion
518	[5.0.0+] SuspendPalmaFeature
519	[5.1.0+] GetPalmaOperationResult
520	[5.1.0+] ReadPalmaPlayLog
521	[5.1.0+] ResetPalmaPlayLog
522	[5.1.0+] SetIsPalmaAllConnectable
523	[5.1.0+] SetIsPalmaPairedConnectable
524	[5.1.0+] PairPalma
525	[5.1.0+] SetPalmaBoostMode
526	[7.0.0+] CancelWritePalmaWaveEntry
527	[8.0.0+] EnablePalmaBoostMode
528	[8.0.0+] GetPalmaBluetoothAddress
529	[8.0.0+] SetDisallowedPalmaConnection
1000	SetNpadCommunicationMode
1001	GetNpadCommunicationMode
1002	[9.0.0+] SetTouchScreenConfiguration
1003	[9.0.0+] IsFirmwareUpdateNeededForNotification

CreateAppletResource

Takes a PID and an u64 AppletResourceUserId. Returns an #IAppletResource.

SetSixAxisSensorFusionParameters

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, two floats, and an u64 AppletResourceUserId, no output.

Official sw will throw an error before using this cmd, if the first float is outside of the bounds of 0.0f-1.0f.

GetSixAxisSensorFusionParameters

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, and an u64 AppletResourceUserId, returns two output floats.

ResetSixAxisSensorFusionParameters

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, and an u64 AppletResourceUserId, no output.

SetGyroscopeZeroDriftMode

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, an u32 #GyroscopeZeroDriftMode, and an u64 AppletResourceUserId, no output.

GetGyroscopeZeroDriftMode

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, and an u64 AppletResourceUserId, returns an output u32 #GyroscopeZeroDriftMode.

Gets the value written by #SetGyroscopeZeroDriftMode.

ResetGyroscopeZeroDriftMode

Takes a PID-descriptor, an u32 #SixAxisSensorHandle, and an u64 AppletResourceUserId, no output.

Same as #SetGyroscopeZeroDriftMode except the #GyroscopeZeroDriftMode is hard-coded to value 1 (Standard).

SetSupportedNpadStyleSet

Takes a PID-descriptor, an u32 #NpadStyleTag, and an u64 AppletResourceUserId, no output.

GetSupportedNpadStyleSet

Takes a PID-descriptor and an u64 AppletResourceUserId, returns an u32 #NpadStyleTag.

SetSupportedNpadIdType

Takes a PID-descriptor, a type-0x9 input buffer, and an AppletResourceUserId. No output.

The input buffer contains an array of u32 #NpadIdType.

ActivateNpad

Takes a PID-descriptor and an AppletResourceUserId. No output.

On newer sysvers this runs the same code as #ActivateNpadWithRevision, with revision=0.

DeactivateNpad

Takes a PID-descriptor and an AppletResourceUserId. No output.

This just returns 0.

AcquireNpadStyleSetUpdateEventHandle

Takes a PID, an input u32, an u64 AppletResourceUserId, and an u64. Returns an output event handle, autoclear for this is user-specified.

The value for the last u64 doesn't seem to matter (?): official sw sets this to the address of the structure used for storing the event which is initialized after using this cmd.

ActivateNpadWithRevision

Takes a PID-descriptor, a s32 revision, and an AppletResourceUserId. No output.

Revisions:

• 0x0: Initial revision, pre-5.0.0.
• 0x1: [5.0.0+]
• 0x2: [6.0.0+]
• 0x3: [8.0.0+]

SetNpadJoyHoldType

Takes a PID-descriptor, a s64, and an AppletResourceUserId. No output.

GetNpadJoyHoldType

Takes a PID-descriptor and an AppletResourceUserId. Returns an output s64.

SetNpadJoyAssignmentModeSingleByDefault

Takes a PID-descriptor, an u32, and an AppletResourceUserId. No output.

SetNpadJoyAssignmentModeSingle

Takes a PID-descriptor, an u32, AppletResourceUserId, and s64 NpadJoyDeviceType. No output.

SetNpadJoyAssignmentModeDual

Takes a PID-descriptor, an u32, and an AppletResourceUserId. No output.

MergeSingleJoyAsDualJoy

Takes a PID-descriptor, two u32s, and an AppletResourceUserId. No output.

GetNpadHandheldActivationMode

Takes a PID and an u64 AppletResourceUserId. Returns an output u64. Official user-processes panic if the output u64 is not 0-2.

GetVibrationDeviceInfo

Takes a #VibrationDeviceHandle. Returns an output #VibrationDeviceInfo.

SendVibrationValue

Takes a PID-descriptor, a #VibrationDeviceHandle, a #VibrationValue immediately after that, and an u64 AppletResourceUserId. No output.

GetActualVibrationValue

Takes a PID-descriptor, a #VibrationDeviceHandle, and an u64 AppletResourceUserId. Returns an output #VibrationValue.

CreateActiveVibrationDeviceList

No input. Returns an #IActiveVibrationDeviceList.

PermitVibration

Takes an input u8 bool. No output.

This affects the config displayed by System Settings.

IsVibrationPermitted

No input. Returns an output u8 bool.

SendVibrationValues

Takes an u64 AppletResourceUserId, and two type-0x9 input buffers containing an array of: #VibrationDeviceHandle for first buffer, and #VibrationValue for the second buffer.

Official sw uses the same entry-count for each array.

IsVibrationDeviceMounted

Takes a PID, an #VibrationDeviceHandle, and an u64 AppletResourceUserId, returns an output u8 bool.

ActivateConsoleSixAxisSensor

Takes a PID and an u64 AppletResourceUserId, no output.

ActivateSevenSixAxisSensor

Takes a PID and an u64 AppletResourceUserId, no output.

Unused by official sw, #ActivateConsoleSixAxisSensor is used instead. However, internally ActivateSevenSixAxisSensor is identical to #ActivateConsoleSixAxisSensor. Deactivation is done with hiddbg DeactivateConsoleSixAxisSensor (which is unused by official sw).

StartSevenSixAxisSensor

Takes a PID and an u64 AppletResourceUserId, no output.

StopSevenSixAxisSensor

Takes a PID and an u64 AppletResourceUserId, no output.

InitializeSevenSixAxisSensor

Takes a PID, an u64 AppletResourceUserId, two u64s for the size of each TransferMemory, and two TransferMemory handles. No output.

The size of the first TransferMemory is 0x1000 with MemoryPermission=read-only, while the second one has size 0x7F000 with MemoryPermission=none.

FinalizeSevenSixAxisSensor

Takes a PID and an u64 AppletResourceUserId, no output.

SetSevenSixAxisSensorFusionStrength

Takes a PID, a float, and an u64 AppletResourceUserId, no output.

GetSevenSixAxisSensorFusionStrength

Takes a PID and an u64 AppletResourceUserId, returns an output float.

ResetSevenSixAxisSensorTimestamp

Takes a PID and an u64 AppletResourceUserId, no output.

GetNpadInterfaceType

Takes an input u32 NpadIdType, returns an output u8 #NpadInterfaceType.

The NpadInterfaceType must be 1-4, otherwise this will assert.

IAppletResource

Cmd	Name
0	#GetSharedMemoryHandle

GetSharedMemoryHandle

No input. Returned a sharedmem handle.

IActiveVibrationDeviceList

This is "nn::hid::IActiveVibrationDeviceList".

Cmd	Name
0	#ActivateVibrationDevice

ActivateVibrationDevice

Takes an input #VibrationDeviceHandle. No output.

GyroscopeZeroDriftMode

This is "nn::hid::GyroscopeZeroDriftMode".

Value	Description
0	Loose
1	Standard
2	Tight

SixAxisSensorHandle

This is an u32.

VibrationDeviceHandle

This is an u32.

VibrationDeviceInfo

This is a 0x8-byte struct.

VibrationValue

This is a 0x10-byte struct, which contains 4 float values.

NpadStyleTag

This is a bitfield describing which controller styles are supported.

Bits	Description	Notes
0	NpadFullKey	Pro Controller.
1	NpadHandheld	Joy-Con controller in handheld mode.
2	NpadJoyDual	Joy-Con controller in dual mode.
3	NpadJoyLeft	Joy-Con left controller in single mode.
4	NpadJoyRight	Joy-Con right controller in single mode.
5	NpadGc	GameCube controller.
6	NpadPalma	Poké Ball Plus controller.
7	NpadLark	NES/Famicom controller.
8	NpadHandheldLark	NES/Famicom controller in handheld mode.
9	NpadLucia	SNES controller.
10-28	Reserved
29	NpadSystemExt	Generic external controller.
30	NpadSystem	Generic controller.
31	Reserved

NpadIdType

This is an u32. This is the controller index used in sharedmem.

Value	Description
0x0	No1
0x1	No2
0x2	No3
0x3	No4
0x4	No5
0x5	No6
0x6	No7
0x7	No8
0x10	Other
0x20	Handheld

NpadInterfaceType

This is the output u8 returned by #GetNpadInterfaceType.

Value	Description
1	Bluetooth
2	Rail
3	USB
4	Unknown

hid:dbg

This is "nn::hid::IHidDebugServer".

Cmd	Name
0	DeactivateDebugPad
1	SetDebugPadAutoPilotState
2	UnsetDebugPadAutoPilotState
10	DeactivateTouchScreen
11	SetTouchScreenAutoPilotState
12	UnsetTouchScreenAutoPilotState
13	[9.0.0+] GetTouchScreenConfiguration
20	DeactivateMouse
21	SetMouseAutoPilotState
22	UnsetMouseAutoPilotState
30	DeactivateKeyboard
31	SetKeyboardAutoPilotState
32	UnsetKeyboardAutoPilotState
50	DeactivateXpad
51	SetXpadAutoPilotState
52	UnsetXpadAutoPilotState
53 ([1.0.0-8.1.0] 60)	#DeactivateJoyXpad
60	[9.0.0+] ClearNpadSystemCommonPolicy
91	DeactivateGesture
110	DeactivateHomeButton
111	SetHomeButtonAutoPilotState
112	UnsetHomeButtonAutoPilotState
120	DeactivateSleepButton
121	SetSleepButtonAutoPilotState
122	UnsetSleepButtonAutoPilotState
123	DeactivateInputDetector
130	DeactivateCaptureButton
131	SetCaptureButtonAutoPilotState
132	UnsetCaptureButtonAutoPilotState
133	[3.0.0+] SetShiftAccelerometerCalibrationValue
134	[3.0.0+] GetShiftAccelerometerCalibrationValue
135	[3.0.0+] SetShiftGyroscopeCalibrationValue
136	[3.0.0+] GetShiftGyroscopeCalibrationValue
140	[3.0.0+] DeactivateConsoleSixAxisSensor
141	[5.0.0+] GetConsoleSixAxisSensorSamplingFrequency
142	[5.0.0+] DeactivateSevenSixAxisSensor
143	[5.0.0+] GetConsoleSixAxisSensorCountStates
144	[8.0.0+] GetAccelerometerFsr
145	[8.0.0+] SetAccelerometerFsr
146	[8.0.0+] GetAccelerometerOdr
147	[8.0.0+] SetAccelerometerOdr
148	[8.0.0+] GetGyroscopeFsr
149	[8.0.0+] SetGyroscopeFsr
150	[8.0.0+] GetGyroscopeOdr
151	[8.0.0+] SetGyroscopeOdr
201	ActivateFirmwareUpdate
202	DeactivateFirmwareUpdate
203	#StartFirmwareUpdate
204	GetFirmwareUpdateStage
205	#GetFirmwareVersion
206	#GetDestinationFirmwareVersion
207	#DiscardFirmwareInfoCacheForRevert
208	[3.0.0+] StartFirmwareUpdateForRevert
209	[3.0.0+] GetAvailableFirmwareVersionForRevert
210	[4.0.0+] IsFirmwareUpdatingDevice
211	[6.0.0+] StartFirmwareUpdateIndividual
215	[6.0.0+] SetUsbFirmwareForceUpdateEnabled
216	[6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
221	[3.0.0+] #UpdateControllerColor
222	[4.0.0+] ConnectUsbPadsAsync
223	[4.0.0+] DisconnectUsbPadsAsync
224	[5.0.0+] #UpdateDesignInfo
225	[5.0.0+] #GetUniquePadDriverState
226	[5.0.0+] #GetSixAxisSensorDriverStates
227	[5.0.0+] GetRxPacketHistory
228	[6.0.0+] #AcquireOperationEventHandle
229	[6.0.0+] #ReadSerialFlash
230	[6.0.0+] #WriteSerialFlash
231	[6.0.0+] #GetOperationResult
232	[6.0.0+] EnableShipmentMode
233	[6.0.0+] ClearPairingInfo
234	[6.0.0+] #GetUniquePadDeviceTypeSetInternal
235	[7.0.0+] EnableAnalogStickPower
236	[9.0.0+] RequestKuinaUartClockCal
237	[9.0.0+] GetKuinaUartClockCal
238	[9.0.0+] SetKuinaUartClockTrim
239	[9.0.0+] KuinaLoopbackTest
240	[9.0.0+] RequestBatteryVoltage
241	[9.0.0+] GetBatteryVoltage
242	[9.0.0+] GetUniquePadPowerInfo
243	[9.0.0+] RebootUniquePad
244	[9.0.0+] RequestKuinaFirmwareVersion
245	[9.0.0+] GetKuinaFirmwareVersion
246	[9.0.0+] GetVidPid
301	[5.0.0-8.1.0] #GetAbstractedPadHandles
302	[5.0.0-8.1.0] #GetAbstractedPadState
303	[5.0.0-8.1.0] #GetAbstractedPadsState
321	[5.0.0-8.1.0] #SetAutoPilotVirtualPadState
322	[5.0.0-8.1.0] #UnsetAutoPilotVirtualPadState
323	[5.0.0+] #UnsetAllAutoPilotVirtualPadState
324	[7.0.0+] #AttachHdlsWorkBuffer
325	[7.0.0+] #ReleaseHdlsWorkBuffer
326	[7.0.0+] #DumpHdlsNpadAssignmentState
327	[7.0.0+] #DumpHdlsStates
328	[7.0.0+] #ApplyHdlsNpadAssignmentState
329	[7.0.0+] #ApplyHdlsStateList
330	[7.0.0+] #AttachHdlsVirtualDevice
331	[7.0.0+] #DetachHdlsVirtualDevice
332	[7.0.0+] #SetHdlsState
350	[5.0.0+] AddRegisteredDevice
400	[6.0.0+] DisableExternalMcuOnNxDevice
401	[6.0.0+] DisableRailDeviceFiltering
500	[8.0.0+] SetFactoryInt
501	[8.0.0+] IsFactoryBootEnabled
550	[9.0.0+] SetAnalogStickModelDataTemporarily
551	[9.0.0+] GetAnalogStickModelData
552	[9.0.0+] ResetAnalogStickModelData

StartFirmwareUpdate

Takes a total of 0x20-bytes of input, 2 handles, and returns an output handle.

[3.0.0+] Now takes a total of 8-bytes of input, and no longer uses any input/output handles.

GetFirmwareVersion

Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.

[3.0.0+] Now returns an additional 0xC-bytes of output.

GetDestinationFirmwareVersion

Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.

[3.0.0+] Now returns an additional 0xC-bytes of output.

DiscardFirmwareInfoCacheForRevert

Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.

[3.0.0+] No input/output.

UpdateControllerColor

Takes two input u32s for the colors, an input u64 UniquePadId, and no output.

A state flag must be clear, otherwise an error is thrown. Afterwards, this flag is set.

Sends the spi-write subcommand to the specified controller, for writing the color data. This writes to offset 0x6050 size 0x6, where the first 3-bytes are from the first u32 and the remaining 3-bytes are from the second u32.

UpdateDesignInfo

Takes 4 input u32s for the colors, an input u8, an input u64 UniquePadId, and no output.

A state flag must be clear (same as #UpdateControllerColor), otherwise an error is thrown. Afterwards, this flag is set.

Sends the spi-write subcommand to the specified controller, for writing to offset 0x6050 size 0xD. The first 3-bytes from each u32 is used for the spi-write-data, with the u8 being copied immediately afterwards the color data.

GetUniquePadDriverState

Takes a total of 8-bytes of input, returns a total of 0x20-bytes of output.

[9.0.0+] Now takes a total of 8-bytes of input, returns a total of 0x18-bytes of output.

GetSixAxisSensorDriverStates

Takes a total of 8-bytes of input and a type-0xA output buffer, returns a total of 8-bytes of output.

[9.0.0+] Now takes a total of 8-bytes of input and a type-0x6 output buffer, returns a total of 8-bytes of output.

AcquireOperationEventHandle

Takes an input u64 UniquePadId, returns an output Event handle. The EventClearMode used by official sw is user-specified.

This is not used internally by sdk-nso besides exposing it to the user. With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).

This must be used before #ReadSerialFlash/#WriteSerialFlash. Afterwards, this Event is used to wait for the async operation started by #ReadSerialFlash/#WriteSerialFlash to finish. After waiting on the Event, #GetOperationResult should be used.

ReadSerialFlash

Takes an input TransferMemory handle, an input u32 offset, an input u64 size, and an u64 UniquePadId, no output.

Reads from the specified controller's spi-flash. The input size is the original size without page-alignment. The TransferMemory permissions is RW-.

See also #AcquireOperationEventHandle.

With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).

WriteSerialFlash

Takes an input TransferMemory handle, an input u32 offset, an input u64 tmem_size, an input u64 size, and an u64 UniquePadId, no output.

Writes to the specified controller's spi-flash. The TransferMemory permissions is R--.

See also #AcquireOperationEventHandle.

With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).

GetOperationResult

Takes an input u64 UniquePadId, no output.

Get the Result for the Operation and handles cleanup, for the specified controller.

This is not used internally by sdk-nso besides exposing it to the user. With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).

GetUniquePadDeviceTypeSetInternal

Takes an input u64 UniquePadId, returns an #DeviceTypeInternal.

GetAbstractedPadHandles

Takes a type-0xA output buffer containing an array of u64 AbstractedPadHandle and returns an output s32 for total entries.

Returns a handle for each controller detected by the system.

GetAbstractedPadState

Takes an input u64 AbstractedPadHandle, returns an output #AbstractedPadState.

GetAbstractedPadsState

Takes a type-0xA output buffer containing an array of u64 AbstractedPadHandle, a type-0x22 output buffer containing an array of #AbstractedPadState, and returns an output s32 for total entries.

SetAutoPilotVirtualPadState

Takes an input s8 AbstractedVirtualPadId and an input #AbstractedPadState, no output.

UnsetAutoPilotVirtualPadState

Takes an input s8 AbstractedVirtualPadId, no output.

Clears AutoPilot state for the specified pad.

UnsetAllAutoPilotVirtualPadState

No input/output.

Same as #UnsetAutoPilotVirtualPadState except this clears state for every pad.

AttachHdlsWorkBuffer

Takes an input TransferMemory handle and an u64 for the TransferMemory size, no output.

Official user-processes use TransferMemory size=0x1000 and permissions=RW.

This TransferMemory is used as input/output by the other Hdls commands.

Hdls is for virtual HID controllers.

ReleaseHdlsWorkBuffer

No input/output.

DumpHdlsNpadAssignmentState

No input/output.

After using this cmd, the output #HdlsNpadAssignment is located at tmem+0.

DumpHdlsStates

No input/output.

After using this cmd, the output #HdlsStateList struct is located at tmem+0.

ApplyHdlsNpadAssignmentState

Takes an input u8 bool, no output.

Prior to using this cmd, the input #HdlsNpadAssignment is written to tmem+0 by the user-process.

ApplyHdlsStateList

No input/output.

Prior to using this cmd, the input #HdlsStateList is written to tmem+0 by the user-process.

The #HdlsState will be applied for each HdlsHandle. If a HdlsHandle is not found, code similar to #AttachHdlsVirtualDevice will run with the #HdlsDeviceInfo, then it will continue with applying state with the new device.

AttachHdlsVirtualDevice

Takes an #HdlsDeviceInfo, returns a 8-byte HdlsHandle.

DetachHdlsVirtualDevice

Takes an input 8-byte HdlsHandle, no output.

SetHdlsState

Takes an input #HdlsState and an input 8-byte HdlsHandle, no output.

[9.0.0+] Input order was swapped: now takes an input 8-byte HdlsHandle and a #HdlsState, no output.

AbstractedPadState

Offset	Size	Description
0x0	0x4	Type, only 1 bit can be set. Converted to #HdlsDeviceInfo::type internally by #SetAutoPilotVirtualPadState.
0x4	0x1	Flags. #SetAutoPilotVirtualPadState only uses bit0: when clear it will skip using the rest of the input and run #UnsetAutoPilotVirtualPadState internally.
0x5	0x3	Padding
0x8	0x4	RGBA Single Body Color
0xC	0x4	RGBA Single Buttons Color
0x10	0x1	See #HiddbgHdlsDeviceInfo::#NpadInterfaceType.
0x11	0x3	Padding
0x14	0x24	#HdlsState. Unknown if the last 4-bytes are included in this struct, #SetAutoPilotVirtualPadState/#hiddbgGetAbstractedPadsState only uses the first 0x20-bytes.
0x38	0x60	Unused with #SetAutoPilotVirtualPadState/#GetAbstractedPadsState.

Normally the input state is merged with an existing controller selected by Type. However in some cases (BIT(2-5) with type2!=0x2 and BIT(31)) it's detected as a dedicated controller.

Type:

Bits	#HdlsDeviceInfo::type bits	Description	Notes
0	0
1	15		#DeviceType |= BIT(1)
2	1
3	2
4	1
5	2
6	3
7	11		#DeviceType |= BIT(11)
8	12		#DeviceType |= BIT(12)
9	13		#DeviceType |= BIT(13)
10	14		#DeviceType |= BIT(14)
11	15		#DeviceType |= BIT(11)
12	12		#DeviceType |= BIT(12)
13	13		#DeviceType |= BIT(13)
14	14		#DeviceType |= BIT(14)
15	17
31	21		#DeviceType = BIT(31)

The above "#DeviceType |=" notes only apply when type2 is 0x2.

HdlsNpadAssignment

This is a 0x208-byte struct.

Offset	Size	Description
0x0	0x4	s32 Total entries
0x4	0x4	Padding
0x8	0x200(0x20*0x10)	Array of #HdlsNpadAssignmentEntry.

HdlsNpadAssignmentEntry

This is a 0x20-byte struct.

Offset	Size	Description
0x0	0x8	HdlsHandle
0x8	0x4	?
0xC	0x4	?
0x10	0x8	?
0x18	0x1	?
0x19	0x7	Padding

HdlsStateList

This is a 0x408-byte struct.

[9.0.0+] This is a 0x488-byte struct.

Offset	Size	Description
0x0	0x4	s32 Total entries
0x4	0x4	Padding
0x8	<#HdlsStateListEntry size>*0x10	Array of #HdlsStateListEntry.

This contains a list of all controllers, including non-virtual controllers.

HdlsStateListEntry

This is a 0x40-byte struct.

[9.0.0+] This is a 0x48-byte struct.

Offset	Size	Description
0x0	0x8	HdlsHandle
0x8	#HdlsDeviceInfo size	#HdlsDeviceInfo. With #ApplyHdlsStateList this is only used when creating new devices.
0x8 + #HdlsDeviceInfo size, with 8-byte alignment	0x24	#HdlsState
<Immediately following the above>	0x4	Padding

HdlsDeviceInfo

This is a 0x10-byte struct.

Offset	Size	Description
0x0	0x4	#DeviceTypeInternal
0x4	0x4	RGBA Single Body Color
0x8	0x4	RGBA Single Buttons Color
0xC	0x1	#NpadInterfaceType. Additional type field used with the above type field, if the value doesn't match one of the following a default is used. Type Pro-Controller: value 0x3 indicates that the controller is connected via USB. Type bit21: value 0x3 = unknown. When value is 0x2, state is merged with an existing controller (when the type value is compatible with this). Otherwise, it's a dedicated controller.
0xD	0x3	Padding

[9.0.0+] This is a 0x14-byte struct.

Offset	Size	Description
0x0	0x1	#DeviceTypeInternal
0x1	0x1	#NpadInterfaceType. Similar to the field from the old struct.
0x2	0x2	Padding
0x4	0x4	RGBA Single Body Color
0x8	0x4	RGBA Single Buttons Color
0xC	0x4	RGBA Unknown Body Color
0x10	0x4	RGBA Unknown Buttons Color

DeviceTypeInternal

This is "nn::hid::detail::DeviceTypeInternal".

Bits	Description
0-7	BIT(N*4+0) = Pro Controller, BIT(N*4+1) = Joy-Con Left, BIT(N*4+2) = Joy-Con Right, BIT(N*4+3) = invalid. Where N is 0-1.
8-10	Pro Controller
11	Famicom left controller
12	Famicom right controller (with microphone)
13	NES left controller
14	NES right controller
15-16	Invalid
17	Generic external controller
18-20	Invalid
21-23	Generic controller

[9.0.0+] This is "nn::hidtypes::DeviceType".

Value	DeviceType	UniquePadType	Description
1	JoyRight, HandheldRight	JoyRight	Joy-Con right controller
2	JoyLeft, HandheldLeft	JoyLeft	Joy-Con left controller
3	FullKey	FullKey	Pro Controller
4	JoyLeft	JoyLeft	SNES left controller
5	JoyRight	JoyRight	SNES right controller
6	FullKey	FullKey	Gc Controller
7	HvcLarkLeft, HandheldHvcLarkLeft	JoyLeft	Famicom left controller
8	HvcLarkRight, HandheldHvcLarkRight	JoyRight	Famicom right controller (with microphone)
9	NesLarkLeft, HandheldNesLarkLeft	JoyLeft	NES left controller
10	NesLarkRight, HandheldNesLarkRight	JoyRight	NES right controller
11	SystemExt	FullKey	Unknown
12	Palma	System	Poké Ball Plus controller
13	FullKey	FullKey	Unknown
14	HandheldLeft	JoyLeft	SNES left controller in handheld mode
15	FullKey	FullKey	Unknown
16	FullKey	FullKey	Unknown
17	Unknown	Unknown	Unknown
18	HandheldRight	JoyRight	SNES right controller in handheld mode
19	System	System	Unknown (has NpadFullKey style tag)
20	System	System	Unknown (has NpadJoyDual style tag)
21	System	System	Unknown (has NpadJoyDual style tag)

HdlsState

This is a 0x24-byte struct.

Offset	Size	Description
0x0	0x1	powerConnected for the main PowerInfo.
0x1	0x1	ORRed with powerConnected to set the value of the first byte for the controller flags.
0x2	0x6	Unknown
0x8	0x4	batteryCharge for the main PowerInfo.
0xC	0x4	Buttons. Bit18 = HOME and bit19 = Capture.
0x10	0x10(4*2*2)	Joystick data, see HID_Shared_Memory#Controller_State.
0x20	0x1	Unused for input. Set with output from #DumpHdlsStates (zero in some cases).
0x21	0x3	Padding

[9.0.0+]:

Offset	Size	Description
0x0	0x4	batteryCharge for the main PowerInfo.
0x4	0x4	Unknown
0x8	0x8	Buttons, masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
0x10	0x10(4*2*2)	Joystick data, see HID_Shared_Memory#Controller_State.
0x20	0x1	Unused for input. Set with output from #DumpHdlsStates (zero in some cases).
0x21	0x3	Padding

hid:sys

This is "nn::hid::IHidSystemServer".

Cmd	Name
31	SendKeyboardLockKeyEvent
101	AcquireHomeButtonEventHandle
111	ActivateHomeButton
121	AcquireSleepButtonEventHandle
131	ActivateSleepButton
141	AcquireCaptureButtonEventHandle
151	ActivateCaptureButton
161	[7.0.0+] GetPlatformConfig
210	AcquireNfcDeviceUpdateEventHandle
211	GetNpadsWithNfc
212	AcquireNfcActivateEventHandle
213	ActivateNfc
214	[4.0.0+] GetXcdHandleForNpadWithNfc
215	[4.0.0+] IsNfcActivated
230	AcquireIrSensorEventHandle
231	ActivateIrSensor
301	ActivateNpadSystem
303	ApplyNpadSystemCommonPolicy
304	EnableAssigningSingleOnSlSrPress
305	DisableAssigningSingleOnSlSrPress
306	GetLastActiveNpad
307	GetNpadSystemExtStyle
308	[5.0.0+] ApplyNpadSystemCommonPolicyFull
309	[5.0.0+] GetNpadFullKeyGripColor
310	[6.0.0+] #GetMaskedSupportedNpadStyleSet
311	SetNpadPlayerLedBlinkingDevice
312	[6.0.0+] SetSupportedNpadStyleSetAll
313	[9.0.0+] GetNpadCaptureButtonAssignment
314	[9.0.0+] GetAppletFooterUiType
315	[9.0.0+] GetAppletDetailedUiType
321	[3.0.0+] #GetUniquePadsFromNpad
322	GetIrSensorState
323	GetXcdHandleForNpadWithIrSensor
500	SetAppletResourceUserId
501	RegisterAppletResourceUserId
502	UnregisterAppletResourceUserId
503	EnableAppletToGetInput
504	SetAruidValidForVibration
505	EnableAppletToGetSixAxisSensor
510	#SetVibrationMasterVolume
511	GetVibrationMasterVolume
512	[3.0.0+] BeginPermitVibrationSession
513	[3.0.0+] EndPermitVibrationSession
520	EnableHandheldHids
521	DisableHandheldHids
522	[9.0.0+] SetJoyConRailEnabled
523	[9.0.0+] IsJoyConRailEnabled
540	AcquirePlayReportControllerUsageUpdateEvent
541	GetPlayReportControllerUsages
542	AcquirePlayReportRegisteredDeviceUpdateEvent
543	GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)
544	[3.0.0+] AcquireConnectionTriggerTimeoutEvent
545	[3.0.0+] SendConnectionTrigger
546	[3.0.0+] AcquireDeviceRegisteredEventForControllerSupport
547	[3.0.0+] GetAllowedBluetoothLinksCount
548	[5.0.0+] GetRegisteredDevices
549	[6.0.0+] GetConnectableRegisteredDevices
700	ActivateUniquePad
702	AcquireUniquePadConnectionEventHandle
703	#GetUniquePadIds
751	AcquireJoyDetachOnBluetoothOffEventHandle
800	ListSixAxisSensorHandles
801	IsSixAxisSensorUserCalibrationSupported
802	ResetSixAxisSensorCalibrationValues
803	StartSixAxisSensorUserCalibration
804	CancelSixAxisSensorUserCalibration
805	[3.0.0+] GetUniquePadBluetoothAddress
806	[3.0.0+] DisconnectUniquePad
807	[5.0.0+] #GetUniquePadType
808	[5.0.0+] GetUniquePadInterface
809	[5.0.0+] GetUniquePadSerialNumber
810	[5.0.0+] GetUniquePadControllerNumber
811	[5.0.0+] GetSixAxisSensorUserCalibrationStage
812	[8.0.0+] GetConsoleUniqueSixAxisSensorHandle
821	StartAnalogStickManualCalibration
822	RetryCurrentAnalogStickManualCalibrationStage
823	CancelAnalogStickManualCalibration
824	ResetAnalogStickManualCalibration
825	[5.0.0+] GetAnalogStickState
826	[5.0.0+] GetAnalogStickManualCalibrationStage
827	[5.0.0+] IsAnalogStickButtonPressed
828	[5.0.0+] IsAnalogStickInReleasePosition
829	[5.0.0+] IsAnalogStickInCircumference
830	[7.0.0+] #SetNotificationLedPattern
831	[9.0.0+] #SetNotificationLedPatternWithTimeout
832	[9.0.0+] #PrepareHidsForNotificationWake
850	[3.0.0+] IsUsbFullKeyControllerEnabled
851	[3.0.0+] EnableUsbFullKeyController
852	[3.0.0+] IsUsbConnected
870	[5.1.0+] IsHandheldButtonPressedOnConsoleMode
900	ActivateInputDetector
901	#NotifyInputDetector
1000	[3.0.0+] InitializeFirmwareUpdate
1001	[3.0.0+] GetFirmwareVersion
1002	[3.0.0+] GetAvailableFirmwareVersion
1003	[3.0.0+] IsFirmwareUpdateAvailable
1004	[3.0.0+] CheckFirmwareUpdateRequired
1005	[3.0.0+] StartFirmwareUpdate
1006	[3.0.0+] AbortFirmwareUpdate
1007	[3.0.0+] GetFirmwareUpdateState
1008	[4.0.0+] ActivateAudioControl
1009	[4.0.0+] AcquireAudioControlEventHandle
1010	[4.0.0+] GetAudioControlStates
1011	[4.0.0+] DeactivateAudioControl
1050	[5.0.0+] IsSixAxisSensorAccurateUserCalibrationSupported
1051	[5.0.0+] StartSixAxisSensorAccurateUserCalibration
1052	[5.0.0+] CancelSixAxisSensorAccurateUserCalibration
1053	[5.0.0+] GetSixAxisSensorAccurateUserCalibrationState
1100	[5.0.0+] #GetHidbusSystemServiceObject
1120	[6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
1130	[6.0.0+] InitializeUsbFirmwareUpdate
1131	[6.0.0+] FinalizeUsbFirmwareUpdate
1132	[6.0.0+] CheckUsbFirmwareUpdateRequired
1133	[6.0.0+] StartUsbFirmwareUpdate
1134	[6.0.0+] GetUsbFirmwareUpdateState
1150	[8.0.0+] SetTouchScreenMagnification
1151	[9.0.0+] GetTouchScreenFirmwareVersion
1152	[9.0.0+] SetTouchScreenDefaultConfiguration
1153	[9.0.0+] GetTouchScreenDefaultConfiguration
1154	[9.0.0+] IsFirmwareAvailableForNotification
1155	[9.0.0+] SetForceHandheldStyleVibration
1156	[9.0.0+] SendConnectionTriggerWithoutTimeoutEvent

GetMaskedSupportedNpadStyleSet

Takes an input u64 AppletResourceUserId, returns an output u32 #NpadStyleTag.

Official sw uses the output from GetAppletResourceUserIdOfCallerApplet with this.

GetUniquePadsFromNpad

Takes an input u32 #NpadIdType, a type-0xA output buffer, and returns an output s64 for total output entries (which is copied to a s32 by official sw).

The output buffer contains an array of u64 UniquePadId.

SetVibrationMasterVolume

Takes an input 32bit float.

GetUniquePadIds

Takes a type-0xA output buffer, and returns an output s64 for total output entries (which is copied to a s32 by official sw).

The output buffer contains an array of u64 UniquePadId.

GetUniquePadType

Takes an input u64 UniquePadId and returns an output u64 #UniquePadType.

SetNotificationLedPattern

Takes an input #NotificationLedPattern and an u64 UniquePadId, no output.

The specified controller must have a HOME button.

This sends subcommand 0x38 to the specified controller, for setting the pattern for the HOME button notification LED. The input structure is converted to the format used by this subcommand.

[9.0.0+] This runs code similar to #SetNotificationLedPatternWithTimeout, except it passes the following param values to an internal func: flag=1 and TimeSpan=0 (with #SetNotificationLedPatternWithTimeout these are flag=0 and TimeSpan={input value}).

SetNotificationLedPatternWithTimeout

Takes an input #NotificationLedPattern, an u64 UniquePadId, and an s64 TimeSpan, no output.

PrepareHidsForNotificationWake

Takes a type-0x9 input buffer containing an array of u64 UniquePadId, no output.

NotifyInputDetector

Takes an input u32 bitmask InputSourceId, no output.

This is the only hid:sys command used by USB-sysmodule (with value 0x40).

GetHidbusSystemServiceObject

No input, returns an #IHidbusSystemServer.

IHidbusSystemServer

This is "nn::hidbus::IHidbusSystemServer".

This was added with [5.0.0+].

Cmd	Name
500	SetAppletResourceUserId
501	RegisterAppletResourceUserId
502	UnregisterAppletResourceUserId

NotificationLedPattern

Offset	Size	Subcommand argdata bytepos	Subcommand argdata nibble	Description
0x0	0x1	0x0	Low	Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF.
0x1	0x1	0x0	High	Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles.
0x2	0x1	0x1	Low	Number of Full Cycles. Value 0x1-0xF: 1 - 15 full cycles. Value 0x0 is repeat forever, but if Mini Cycle Base Duration is set to 0x0, it does the 1st Mini Cycle with a 12.5ms base duration and then the LED stays on with LED Start Intensity.
0x3	0x1	0x1	High	LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
0x4	0x1	0x2	High	Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
0x5	0x1	0x3	High	Fading Transition Steps to Mini Cycle 1 (Uses PWM). Value 0x0: Instant. Each step duration is based on Mini Cycle Step Duration Multiplier.
0x6	0x1	0x3	Low	Final Step Duration Multiplier of Mini Cycle 1. Value is a Multiplier of Mini Cycle Base Duration. Value 0x0: 12.5ms, 0x1 - xF: 1x - 15x.
0x7	0x1			Unused
0x8	0x1	0x2	Low	Mini Cycle 2 LED Intensity.
0x9	0x1	0x4	High	Fading Transition Steps to Mini Cycle 2 (see above).
0xA	0x1	0x4	Low	Final Step Duration Multiplier of Mini Cycle 2 (see above).
0xB	0x1			Unused
0xC	0x1	0x5	High	Mini Cycle 3 LED Intensity.
0xD	0x1	0x6	High	Fading Transition Steps to Mini Cycle 3 (see above).
0xE	0x1	0x6	Low	Final Step Duration Multiplier of Mini Cycle 3 (see above).
0xF	0x1			Unused
0x10	0x1	0x5	Low	Mini Cycle 4 LED Intensity.
0x11	0x1	0x7	High	Fading Transition Duration to Mini Cycle 4 (see above).
0x12	0x1	0x7	Low	Final Step Duration Multiplier of Mini Cycle 4 (see above).
0x13	0x1			Unused
0x14	0x1	0x8	High	Mini Cycle 5 LED Intensity.
0x15	0x1	0x9	High	Fading Transition Steps to Mini Cycle 5 (see above).
0x16	0x1	0x9	Low	Final Step Duration Multiplier of Mini Cycle 5 (see above).
0x17	0x1			Unused
0x18	0x1	0x8	Low	Mini Cycle 6 LED Intensity.
0x19	0x1	0xA	High	Fading Transition Steps to Mini Cycle 6 (see above).
0x1A	0x1	0xA	Low	Final Step Duration Multiplier of Mini Cycle 6 (see above).
0x1B	0x1			Unused
0x1C	0x1	0xB	High	Mini Cycle 7 LED Intensity.
0x1D	0x1	0xC	High	Fading Transition Steps to Mini Cycle 7 (see above).
0x1E	0x1	0xC	Low	Final Step Duration Multiplier of Mini Cycle 7 (see above).
0x1F	0x1			Unused
0x20	0x1	0xB	Low	Mini Cycle 8 LED Intensity.
0x21	0x1	0xD	Low	Fading Transition Steps to Mini Cycle 8 (see above).
0x22	0x1	0xD	High	Final Step Duration Multiplier of Mini Cycle 8 (see above).
0x23	0x1			Unused
0x24	0x1	0xE	High	Mini Cycle 9 LED Intensity.
0x25	0x1	0xF	High	Fading Transition Steps to Mini Cycle 9 (see above).
0x26	0x1	0xF	Low	Final Step Duration Multiplier of Mini Cycle 9 (see above).
0x27	0x1			Unused
0x28	0x1	0xE	Low	Mini Cycle 10 LED Intensity.
0x29	0x1	0x10	High	Fading Transition Steps to Mini Cycle 10 (see above).
0x2A	0x1	0x10	Low	Final Step Duration Multiplier of Mini Cycle 10 (see above).
0x2B	0x1			Unused
0x2C	0x1	0x11	High	Mini Cycle 11 LED Intensity.
0x2D	0x1	0x12	High	Fading Transition Steps to Mini Cycle 11 (see above).
0x2E	0x1	0x12	Low	Final Step Duration Multiplier of Mini Cycle 11 (see above).
0x2F	0x1			Unused
0x30	0x1	0x11	Low	Mini Cycle 12 LED Intensity.
0x31	0x1	0x13	High	Fading Transition Steps to Mini Cycle 12 (see above).
0x32	0x1	0x13	Low	Final Step Duration Multiplier of Mini Cycle 12 (see above).
0x33	0x1			Unused
0x34	0x1	0x14	High	Mini Cycle 13 LED Intensity.
0x35	0x1	0x15	High	Fading Transition Steps to Mini Cycle 13 (see above).
0x36	0x1	0x15	Low	Final Step Duration Multiplier of Mini Cycle 13 (see above).
0x37	0x1			Unused
0x38	0x1	0x14	Low	Mini Cycle 14 LED Intensity.
0x39	0x1	0x16	High	Fading Transition Steps to Mini Cycle 14 (see above).
0x3A	0x1	0x16	Low	Final Step Duration Multiplier of Mini Cycle 14 (see above).
0x3B	0x1			Unused
0x3C	0x1	0x17	High	Mini Cycle 15 LED Intensity.
0x3D	0x1	0x18	High	Fading Transition Steps to Mini Cycle 15 (see above).
0x3E	0x1	0x18	Low	Final Step Duration Multiplier of Mini Cycle 15 (see above).
0x3F	0x1			Unused
0x40	0x1	0x17	Low	Mini Cycle 16 LED Intensity.
0x41	0x1	0x19	High	Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
0x42	0x1	0x19	Low	Final Step Duration Multiplier of Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
0x43	0x1			Unused
0x44	0x1	0x1A	High	Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
0x45	0x1	0x1A	Low	Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
0x46	0x1			Padding
0x47	0x1			Padding

This is "nn::hid::system::NotificationLedPattern".

This is a 0x48-byte struct.

The above descriptions in the table are based on the info from here.

argdata in the subcommand is initialized as follows: ((u8*)cmd_argdata)[pos] = u8_in[pos2] | u8_in[pos3]<<4; Hence, 4bits from pairs of 2-bytes of the input struct are combined to write to the subcommand. Only the low 4bits of each used byte in the struct is used. This is written to stack initially, then copied to the actual cmd_argdata (the data immediately following the subcommandID byte). There's a total of 0x1B-bytes of cmd_argdata initialized from this.

The layout of cmd_argdata is as follows:

Offset	Size	Description
0x0	0x1B	See above.
0x1B	0xB	Cleared to zero.
0x26	0x5	Unused
0x2B	0x8	Set to an input value, which is hard-coded 0.
0x33	0x2	Set to value 0.
0x35	0x1	Set to value 1.

DeviceType

This is "nn::hid::system::DeviceType".

Bits	Description	Notes
0	FullKey	Pro Controller and Gc controller.
1		Unknown
2	HandheldLeft	Joy-Con/Famicom/NES left controller in handheld mode.
3	HandheldRight	Joy-Con/Famicom/NES right controller in handheld mode.
4	JoyLeft	Joy-Con left controller.
5	JoyRight	Joy-Con right controller.
6	Palma	Poké Ball Plus controller.
7	LarkLeft (HVC)	Famicom left controller.
8	LarkRight (HVC)	Famicom right controller (with microphone).
9	LarkLeft (NES)	NES left controller.
10	LarkRight (NES)	NES right controller.
11-14		Reserved
15	SystemExt	Generic external controller.
16-30		Reserved
31	System	Generic controller.

UniquePadType

This is "nn::hid::system::UniquePadType".

Value	Description
0x0	System
0x1	FullKey
0x2	JoyRight
0x3	JoyLeft
0x4	Unknown

hid:tmp

This is "nn::hid::IHidTemporaryServer".

This service was added with [3.0.0+], then removed with [8.0.0+].

Cmd	Name
0	GetConsoleSixAxisSensorCalibrationValues

irs

This is "nn::irsensor::IIrSensorServer".

Cmd	Name
302	#ActivateIrsensor
303	#DeactivateIrsensor
304	#GetIrsensorSharedMemoryHandle
305	#StopImageProcessor
306	#RunMomentProcessor
307	#RunClusteringProcessor
308	#RunImageTransferProcessor
309	#GetImageTransferProcessorState
310	#RunTeraPluginProcessor
311	#GetNpadIrCameraHandle
312	#RunPointingProcessor
313	#SuspendImageProcessor
314	[3.0.0+] #CheckFirmwareVersion
315	[4.0.0+] SetFunctionLevel
316	[4.0.0+] RunImageTransferExProcessor
317	[4.0.0+] RunIrLedProcessor
318	[4.0.0+] StopImageProcessorAsync
319	[4.0.0+] ActivateIrsensorWithFunctionLevel

ActivateIrsensor

Takes a PID-descriptor and an AppletResourceUserId. No output.

DeactivateIrsensor

Takes a PID-descriptor and an AppletResourceUserId. No output.

GetIrsensorSharedMemoryHandle

Takes a PID-descriptor and an AppletResourceUserId. Returns a SharedMemory handle.

The SharedMemory is mapped with permissions=read-only and size=0x8000.

StopImageProcessor

Takes a PID-descriptor, an #IrCameraHandle, and an AppletResourceUserId. No output.

RunMomentProcessor

Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, and a #PackedMomentProcessorConfig. No output.

RunClusteringProcessor

Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, and a #PackedClusteringProcessorConfig. No output.

RunImageTransferProcessor

Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, a #PackedImageTransferProcessorConfig, an u64 for the TransferMemory_size, and a TransferMemory handle. No output.

Official sw creates the TransferMemory with an user-specified buffer and permissions=0.

GetImageTransferProcessorState

Takes a PID-descriptor, a type-0x6 output buffer, an #IrCameraHandle, and an AppletResourceUserId. Returns an #ImageTransferProcessorState. No output.

RunTeraPluginProcessor

Takes a PID-descriptor, an #IrCameraHandle, a #PackedTeraPluginProcessorConfig (immediately after the previous word), and an AppletResourceUserId. No output.

GetNpadIrCameraHandle

Takes an input u32 NpadTypeId. Returns an output #IrCameraHandle.

RunPointingProcessor

Takes a PID-descriptor, an #IrCameraHandle, a #PackedDpdProcessorConfig (immediately after the previous word), and an AppletResourceUserId. No output.

SuspendImageProcessor

Takes a PID-descriptor, an #IrCameraHandle, and an AppletResourceUserId. No output.

CheckFirmwareVersion

Takes a PID-descriptor, an #IrCameraHandle, a #PackedMcuVersion, and an AppletResourceUserId. No output.

IrCameraHandle

This is an u32.

PackedMomentProcessorConfig

This is a 0x20-byte struct. This is converted from another structure by the official user-process.

Offset	Size	Description	DefaultConfig
0x0	0x8	?	0x493E0
0x8	0x1	?	0x0
0x9	0x1	?	0x8
0xA	0x1	?	0x0
0xB	0x5	Padding
0x10	0x8	u16, u32, u16	{Not written}, 0x1400000, 0xF0
0x18	0x4	Hard-coded to 0xA0003.
0x1C	0x1	?	0x1
0x1D	0x1	?	0x50
0x1E	0x2	Padding

PackedClusteringProcessorConfig

This is a 0x28-byte struct.

PackedImageTransferProcessorConfig

This is a 0x18-byte struct. This is converted from another structure by the official user-process. The conversion is the same as PackedMomentProcessorConfig, except the code using out +0x1C/+0x1D was removed, and the constant is now located at out+0x10. The code which wrote to out u64 +0x10 from in+0x24 was replaced with code which writes an u8 to out+0x14.

ImageTransferProcessorState

This is a 0x10-byte struct.

PackedTeraPluginProcessorConfig

This is an u64.

PackedDpdProcessorConfig

This is a 0x10-byte struct.

PackedMcuVersion

This is an u32.

irs:sys

This is "nn::irsensor::IIrSensorSystemServer".

Cmd	Name
500	SetAppletResourceUserId
501	RegisterAppletResourceUserId
502	UnregisterAppletResourceUserId
503	EnableAppletToGetInput

ahid:cd

This is "nn::ahid::IServerSession".

Used for USB HID devices.

This service no longer exists in [9.0.0+].

Cmd	Name
0	#AcquireDevice
1	#ReleaseDevice
2	#GetCtrlSession
3	#GetReadSession
4	[1.0.0-2.3.0] #GetWriteSession

AcquireDevice

Takes an input s32, no output.

ReleaseDevice

Takes an input s32, no output.

GetCtrlSession

Takes an input u32, returns an #ICtrlSession.

GetReadSession

Takes an input u32, returns an #IReadSession.

GetWriteSession

Takes an input u32, returns an #IWriteSession.

ICtrlSession

This is "nn::ahid::ICtrlSession".

This no longer exists in [9.0.0+].

Cmd	Name
0	GetString
1	GetCodeBook
2	GetReport
3	SetReport
4	GetIdle
5	SetIdle
6	GetProtocol
7	SetProtocol
8	GetDescriptor
9	SetDescriptor
10	GetStateChangeEvent
11	SignalStateChangeEvent
12	[3.0.0+] Write

All of these use USB CtrlXfer, except for GetStateChangeEvent and SignalStateChangeEvent, and GetCodeBook which copies 0x4000-bytes from state to output.

IReadSession

This is "nn::ahid::IReadSession".

This no longer exists in [9.0.0+].

Cmd	Name
0	#Read

Read

Uses PostBufferAsync etc with the INPUT endpoint. The size must be <=0x1000. The actual transfer size is returned in an output u64. The data is copied from the tmpbuf to the output buffer using the actual-transfer-size.

[3.0.0+] Now takes a total of 8-bytes of input.

IWriteSession

This is "nn::ahid::IWriteSession".

This was removed with [3.0.0+].

Cmd	Name
0	#Write

Write

This is the inverse of #IReadSession cmd0. Uses the OUTPUT endpoint with an input buffer.

ahid:hdr

This is "nn::ahid::hdr::ISession".

Used internally for USB HID devices.

This service no longer exists in [9.0.0+].

Cmd	Name
0	GetDeviceEntries
1	GetDeviceList
2	GetDeviceParameters
3	AttachDevice
4	DetachDevice
5	[6.0.0+] SetDeviceFilter

xcd:sys

This is "nn::xcd::detail::ISystemServer".

Cmd	Name
0	GetDataFormat
1	SetDataFormat
2	GetMcuState
3	SetMcuState
4	GetMcuVersionForNfc
5	CheckNfcDevicePower
6	[5.0.0+] SetMcuStateImmediate
10	SetNfcEvent
11	GetNfcInfo
12	StartNfcDiscovery
13	StopNfcDiscovery
14	StartNtagRead
15	StartNtagWrite
16	SendNfcRawData
17	RegisterMifareKey
18	ClearMifareKey
19	StartMifareRead
20	StartMifareWrite
101	GetAwakeTriggerReasonForLeftRail
102	GetAwakeTriggerReasonForRightRail

[5.0.0+] SetDataFormat, SetMcuState, and ClearMifareKey: now takes a total of 0xC-bytes of input instead of 0x10.

[6.0.0+]: The buffer type used by GetNfcInfo is now 0x32 instead of 0x1A.

hidbus

This is "nn::hidbus::IHidbusServer".

This was added with [5.0.0+].

Official sw opens a temporary service-session for each func using this, with it being closed once done: no global session is kept open.

Cmd	Name
1	#GetBusHandle
2	#IsExternalDeviceConnected
3	#Initialize
4	#Finalize
5	#EnableExternalDevice
6	#GetExternalDeviceId
7	#SendCommandAsync
8	#GetSendCommandAsynceResult
9	#SetEventForSendCommandAsycResult
10	#GetSharedMemoryHandle
11	#EnableJoyPollingReceiveMode
12	#DisableJoyPollingReceiveMode
13	[5.0.0-6.2.0] GetPollingData
14	[6.0.0+] #SetStatusManagerType

sdknso doesn't use the GetPollingData cmd.

GetBusHandle

Takes an input u32 #NpadIdType, an u64 #BusType, an u64 AppletResourceUserId, returns an output u8 bool and a #BusHandle.

The bool indicates whether the #BusHandle is valid.

Official sw will assert when #BusHandle InternalIndex is >=0x11 (>=0x13 with [6.0.0+]). This same check is also done for all funcs using #BusHandle as input.

This cmd will throw an error when #BusType is invalid.

IsExternalDeviceConnected

Takes an input #BusHandle, returns an output u8 bool.

This is not used by sdknso.

Initialize

Takes an input #BusHandle, an u64 AppletResourceUserId, no output.

Prior to using this cmd, sdknso handles sharedmem mapping if not done previously.

Finalize

Takes an input #BusHandle, an u64 AppletResourceUserId, no output.

EnableExternalDevice

Takes an input u8 bool, a #BusHandle, an u64, an u64 AppletResourceUserId, no output.

sdknso passes value 0x38900050018 (0x3A600050018 with 7.x+) for the u64.

The bool flag indicates whether to enable the device (true = enable, false = disable). When false, this will use #DisableJoyPollingReceiveMode if needed.

GetExternalDeviceId

Takes an input #BusHandle, returns an output u32 ExternalDeviceId.

SendCommandAsync

Takes a type-0x21 input buffer and a #BusHandle, no output.

GetSendCommandAsynceResult

Takes a type-0x22 output buffer and a #BusHandle, returns an output u32.

Official sw copies the u32 to an output u64, for the actual output size.

SetEventForSendCommandAsycResult

Takes an input #BusHandle, returns an output Event handle with EventClearMode=0.

Official sw with SendAndReceive clears this event (6.x+ sdknso), uses #SendCommandAsync, waits on + clears this event, then uses #GetSendCommandAsynceResult.

GetSharedMemoryHandle

No input, returns an output SharedMemory handle.

The SharedMemory is mapped with size 0x1000 and permissions=R--.

See also #SetStatusManagerType.

This sharedmem is the StatusManager. This sharedmem contains an array of 0x100-byte (0x80-byte with [6.0.0+]) entries, with entry-count {max BusHandles}.

sdknso only uses the first 0x10-bytes of these entries, the rest is the ignored. Entry structure:

Offset	Size	Description
0x0	0x1	Bool flag
0x1	0x3	Padding
0x4	0x4	Result
0x8	0x1	DeviceEnabled. Bool flag indicating whether a device is enabled.
0x9	0x1	IsValid. Bool flag indicating whether this entry is valid.
0xA	0x1	PollingEnabled. Bool flag indicating whether polling is enabled.
0xB	0x1	Unknown / padding?
0xC	0x4	#JoyPollingMode

EnableJoyPollingReceiveMode

Takes a type-0x21 input buffer, a TransferMemory handle, an u32 tmem_size, an u32 #JoyPollingMode, a #BusHandle, no output.

The TransferMemory is created with an user-specified output buffer, with permissions=R--.

The content of the TransferMemory depends of the #JoyPollingMode. This is used by GetJoyPollingReceivedData. Structure of the TransferMemory (DisableSixAxisPollingDataAccessor, EnableSixAxisPollingDataAccessor, JoyButtonOnlyPollingDataAccessor):

Offset	Size	Description
0x0	0x4	Result.
0x0	0x4	Padding.
0x8	0x18	Initialized sysmodule-side, not used by sdknso.
0x20	0x8	Latest entry.
0x28	0x8	Total entries.

The entries specific to the #JoyPollingMode follow, with 0xA entries total. Each entry starts with an u64 timestamp. Structure for each mode, after the timestamp:

DisableSixAxisPollingDataAccessor:

Offset	Size	Description
0x0	0x26	Data
0x26	0x1	Size of data.
0x27	0x1	Padding
0x28	0x8	Timestamp

JoyEnableSixAxisPollingDataAccessor:

Offset	Size	Description
0x0	0x8	Data
0x8	0x1	Size of data.
0x9	0x7	Padding
0x10	0x8	Timestamp

JoyButtonOnlyPollingDataAccessor:

Offset	Size	Description
0x0	0x2C	Data
0x2C	0x1	Size of data.
0x2D	0x3	Padding
0x30	0x8	Timestamp

DisableJoyPollingReceiveMode

Takes an input #BusHandle, no output.

SetStatusManagerType

Takes an input u32, no output.

This is used by sdknso immediately after mapping sharedmem (before #Initialize) with hard-coded value 0x2.

BusHandle

This is "nn::hidbus::BusHandle". This is 0x8-bytes.

Offset	Size	Description
0x0	0x4	AbstractedPadId
0x4	0x1	InternalIndex
0x5	0x1	PlayerNumber
0x6	0x1	BusTypeId
0x7	0x1	IsValid

JoyPollingReceivedData

This is "nn::hidbus::JoyPollingReceivedData". This is 0x40-bytes.

This is copied from the entries in TransferMemory by GetJoyPollingReceivedData.

Offset	Size	Description
0x0	0x30	Data
0x30	0x8	Size of data.
0x38	0x8	Timestamp

BusType

This is "nn::hidbus::BusType". This is an u32.

Value	Description
0	JoyLeftRail
1	JoyRightRail
2	[6.0.0+] LarkRightRail (for microphone)

JoyPollingMode

This is "nn::hidbus::JoyPollingMode". This is an u32. This must be one of the below values otherwise #EnableJoyPollingReceiveMode will assert.

Value	Description
0	sdknso uses GetJoyDisableSixAxisPollingDataAccessor with this.
1	sdknso uses GetJoyEnableSixAxisPollingDataAccessor with this.
2	[6.0.0+] sdknso uses GetJoyButtonOnlyPollingDataAccessor with this.

ExternalDevices

The following devices are used via hidbus:

• Ring-Con
• Famicom right controller (with microphone)

RomFS

The hid-sysmodule RomFS contains:

 ftmFwUpdate
   ├── NTD_4CD_1801.fts256
   ├── NTD_4CD_2602.fts256
   ├── NTD_4CD_3801.fts256
   └── NTD_4CD_xxxx.fts256 [7.0.0+]

These are firmware files for the touchscreen controller.

[9.0.0+] The hid-sysmodule RomFS now contains:

 ftmFwUpdate
   ├── FTS_00120100.fts256
   ├── FTS_32000001.fts256
   ├── FTS_32000102.fts256
   ├── FTS_32000302.fts256
   └── FTS_32000402.fts256

Firmware update

HID-sysmodule mounts the contents of title 0100000000000822 as "systemData" or the contents of title 010000000000B22B as "systemDataD". Both titles contain the same files, but 0100000000000822 is used on retail units while 010000000000B22B is used for development.

These titles contain the following files:

• ExpectVersionInfo.csv - List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey", "Palma" or "Handheld", "type" can be "BT", "MCU", "USB" or "SioH" and "version" is the hexadecimal representation of the firmware file's version.
• FirmwareInfo.csv - List in the format "[device],[type],[version],[file]" where "device", "type" and "version" should match the values from "ExpectVersionInfo" and "file" is the name of the firmware file.
• ukyosakyo_ep2_ota.bin - Left/Right Joy-Con BT firmware.
• raizo_ep2_ota.bin - Pro Controller BT firmware.
• tera_ota.bin - Right Joy-Con MCU firmware.
• tera_ota_iap.bin - Right Joy-Con MCU (IAP profile) firmware.
• tera_fullkey_ota.bin - Pro Controller MCU firmware.
• tera_fullkey_ota_iap.bin - Pro Controller MCU (IAP profile) firmware.
• [6.0.0+] ProController.dfu - Pro Controller USB firmware.
• [6.1.0+] PalmaFw.bin - Poké Ball Plus BT firmware.
• [9.0.0+] ExpectVersionInfo-platform.hoag.csv - Same as "ExpectVersionInfo.csv" but for the Switch Lite platform.
• [9.0.0+] FirmwareInfo-platform.hoag.csv - Same as "FirmwareInfo.csv" but for the Switch Lite platform.
• [9.0.0+] sioh.bin - Switch Lite Joy-Con firmware.
• [9.0.0+] sioh_iap.bin - Switch Lite Joy-Con (IAP profile) firmware.