Nintendo Switch Brew

HID services: Difference between revisions

← Older editNewer edit →
No edit summary
No edit summary
Line 439: Line 439:
=== ActivateVibrationDevice ===
=== ActivateVibrationDevice ===
Takes an input [[#VibrationDeviceHandle]]. No output.
Takes an input [[#VibrationDeviceHandle]]. No output.
== GyroscopeZeroDriftMode ==
This is "nn::hid::GyroscopeZeroDriftMode".
{| class="wikitable" border="1"
!  Value
!  Description
|-
| 0 || Loose
|-
| 1 || Standard
|-
| 2 || Tight
|}


== SixAxisSensorHandle ==
== SixAxisSensorHandle ==
Line 466: Line 452:
This is a 0x10-byte struct, which contains 4 float values.
This is a 0x10-byte struct, which contains 4 float values.


== NpadStyleTag ==
= hid:dbg =
This is "nn::hid::NpadStyleTag".
This is "nn::hid::IHidDebugServer".


{| class="wikitable" border="1"
{| class="wikitable" border="1"
!  Bits
!  Description
!  Notes
|-
|-
| 0
! Cmd || Name
| NpadFullKey
|-
| Pro Controller
| 0 || DeactivateDebugPad
|-
|-
| 1
| 1 || SetDebugPadAutoPilotState
| NpadHandheld
| Joy-Con controller in handheld mode
|-
|-
| 2
| 2 || UnsetDebugPadAutoPilotState
| NpadJoyDual
|-
| Joy-Con controller in dual mode
| 10 || DeactivateTouchScreen
|-
|-
| 3
| 11 || SetTouchScreenAutoPilotState
| NpadJoyLeft
| Joy-Con left controller in single mode
|-
|-
| 4
| 12 || UnsetTouchScreenAutoPilotState
| NpadJoyRight
| Joy-Con right controller in single mode
|-
|-
| 5
| 13 || [9.0.0+] GetTouchScreenConfiguration
| NpadGc
| GameCube controller
|-
|-
| 6
| 20 || DeactivateMouse
| NpadPalma
| Poké Ball Plus controller
|-
|-
| 7
| 21 || SetMouseAutoPilotState
| NpadLark
| NES/Famicom controller
|-
|-
| 8
| 22 || UnsetMouseAutoPilotState
| NpadHandheldLark
| NES/Famicom controller in handheld mode
|-
|-
| 9
| 30 || DeactivateKeyboard
| NpadLucia
| SNES controller
|-
|-
| 10-28
| 31 || SetKeyboardAutoPilotState
| Reserved
|
|-
|-
| 29
| 32 || UnsetKeyboardAutoPilotState
| NpadSystemExt
| Generic external controller
|-
|-
| 30
| 50 || DeactivateXpad
| NpadSystem
| Generic controller
|-
|-
| 31
| 51 || SetXpadAutoPilotState
| Reserved
|
|}
 
== NpadIdType ==
This is "nn::hid::NpadIdType". This is the controller index used in [[HID_Shared_Memory#Controllers|sharedmem]].
 
{| class="wikitable" border="1"
!  Value
!  Description
|-
|-
| 0x0 || No1
| 52 || UnsetXpadAutoPilotState
|-
|-
| 0x1 || No2
| 53 ([1.0.0-8.1.0] 60) || [[#DeactivateJoyXpad]]
|-
|-
| 0x2 || No3
| 60 || [9.0.0+] ClearNpadSystemCommonPolicy
|-
|-
| 0x3 || No4
| 91 || DeactivateGesture
|-
|-
| 0x4 || No5
| 110 || DeactivateHomeButton
|-
|-
| 0x5 || No6
| 111 || SetHomeButtonAutoPilotState
|-
|-
| 0x6 || No7
| 112 || UnsetHomeButtonAutoPilotState
|-
|-
| 0x7 || No8
| 120 || DeactivateSleepButton
|-
|-
| 0x10 || Other
| 121 || SetSleepButtonAutoPilotState
|-
|-
| 0x20 || Handheld
| 122 || UnsetSleepButtonAutoPilotState
|}
 
== NpadInterfaceType ==
This is "nn::hid::NpadInterfaceType".
 
{| class="wikitable" border="1"
!  Value
!  Description
|-
|-
| 1 || Bluetooth
| 123 || DeactivateInputDetector
|-
|-
| 2 || Rail
| 130 || DeactivateCaptureButton
|-
|-
| 3 || USB
| 131 || SetCaptureButtonAutoPilotState
|-
|-
| 4 || Unknown
| 132 || UnsetCaptureButtonAutoPilotState
|}
 
= hid:dbg =
This is "nn::hid::IHidDebugServer".
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 133 || [3.0.0+] SetShiftAccelerometerCalibrationValue
|-
|-
| 0 || DeactivateDebugPad
| 134 || [3.0.0+] GetShiftAccelerometerCalibrationValue
|-
|-
| 1 || SetDebugPadAutoPilotState
| 135 || [3.0.0+] SetShiftGyroscopeCalibrationValue
|-
|-
| 2 || UnsetDebugPadAutoPilotState
| 136 || [3.0.0+] GetShiftGyroscopeCalibrationValue
|-
|-
| 10 || DeactivateTouchScreen
| 140 || [3.0.0+] DeactivateConsoleSixAxisSensor
|-
|-
| 11 || SetTouchScreenAutoPilotState
| 141 || [5.0.0+] GetConsoleSixAxisSensorSamplingFrequency
|-
|-
| 12 || UnsetTouchScreenAutoPilotState
| 142 || [5.0.0+] DeactivateSevenSixAxisSensor
|-
|-
| 13 || [9.0.0+] GetTouchScreenConfiguration
| 143 || [5.0.0+] GetConsoleSixAxisSensorCountStates
|-
|-
| 20 || DeactivateMouse
| 144 || [8.0.0+] GetAccelerometerFsr
|-
|-
| 21 || SetMouseAutoPilotState
| 145 || [8.0.0+] SetAccelerometerFsr
|-
|-
| 22 || UnsetMouseAutoPilotState
| 146 || [8.0.0+] GetAccelerometerOdr
|-
|-
| 30 || DeactivateKeyboard
| 147 || [8.0.0+] SetAccelerometerOdr
|-
|-
| 31 || SetKeyboardAutoPilotState
| 148 || [8.0.0+] GetGyroscopeFsr
|-
|-
| 32 || UnsetKeyboardAutoPilotState
| 149 || [8.0.0+] SetGyroscopeFsr
|-
|-
| 50 || DeactivateXpad
| 150 || [8.0.0+] GetGyroscopeOdr
|-
|-
| 51 || SetXpadAutoPilotState
| 151 || [8.0.0+] SetGyroscopeOdr
|-
|-
| 52 || UnsetXpadAutoPilotState
| 201 || ActivateFirmwareUpdate
|-
|-
| 53 ([1.0.0-8.1.0] 60) || [[#DeactivateJoyXpad]]
| 202 || DeactivateFirmwareUpdate
|-
|-
| 60 || [9.0.0+] ClearNpadSystemCommonPolicy
| 203 || [[#StartFirmwareUpdate]]
|-
|-
| 91 || DeactivateGesture
| 204 || GetFirmwareUpdateStage
|-
|-
| 110 || DeactivateHomeButton
| 205 || [[#GetFirmwareVersion]]
|-
|-
| 111 || SetHomeButtonAutoPilotState
| 206 || [[#GetDestinationFirmwareVersion]]
|-
|-
| 112 || UnsetHomeButtonAutoPilotState
| 207 || [[#DiscardFirmwareInfoCacheForRevert]]
|-
|-
| 120 || DeactivateSleepButton
| 208 || [3.0.0+] StartFirmwareUpdateForRevert
|-
|-
| 121 || SetSleepButtonAutoPilotState
| 209 || [3.0.0+] GetAvailableFirmwareVersionForRevert
|-
|-
| 122 || UnsetSleepButtonAutoPilotState
| 210 || [4.0.0+] IsFirmwareUpdatingDevice
|-
|-
| 123 || DeactivateInputDetector
| 211 || [6.0.0+] StartFirmwareUpdateIndividual
|-
|-
| 130 || DeactivateCaptureButton
| 215 || [6.0.0+] SetUsbFirmwareForceUpdateEnabled
|-
|-
| 131 || SetCaptureButtonAutoPilotState
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
|-
|-
| 132 || UnsetCaptureButtonAutoPilotState
| 221 || [3.0.0+] [[#UpdateControllerColor]]
|-
|-
| 133 || [3.0.0+] SetShiftAccelerometerCalibrationValue
| 222 || [4.0.0+] ConnectUsbPadsAsync
|-
|-
| 134 || [3.0.0+] GetShiftAccelerometerCalibrationValue
| 223 || [4.0.0+] DisconnectUsbPadsAsync
|-
|-
| 135 || [3.0.0+] SetShiftGyroscopeCalibrationValue
| 224 || [5.0.0+] [[#UpdateDesignInfo]]
|-
|-
| 136 || [3.0.0+] GetShiftGyroscopeCalibrationValue
| 225 || [5.0.0+] [[#GetUniquePadDriverState]]
|-
|-
| 140 || [3.0.0+] DeactivateConsoleSixAxisSensor
| 226 || [5.0.0+] [[#GetSixAxisSensorDriverStates]]
|-
|-
| 141 || [5.0.0+] GetConsoleSixAxisSensorSamplingFrequency
| 227 || [5.0.0+] GetRxPacketHistory
|-
|-
| 142 || [5.0.0+] DeactivateSevenSixAxisSensor
| 228 || [6.0.0+] [[#AcquireOperationEventHandle]]
|-
|-
| 143 || [5.0.0+] GetConsoleSixAxisSensorCountStates
| 229 || [6.0.0+] [[#ReadSerialFlash]]
|-
|-
| 144 || [8.0.0+] GetAccelerometerFsr
| 230 || [6.0.0+] [[#WriteSerialFlash]]
|-
|-
| 145 || [8.0.0+] SetAccelerometerFsr
| 231 || [6.0.0+] [[#GetOperationResult]]
|-
|-
| 146 || [8.0.0+] GetAccelerometerOdr
| 232 || [6.0.0+] EnableShipmentMode
|-
|-
| 147 || [8.0.0+] SetAccelerometerOdr
| 233 || [6.0.0+] ClearPairingInfo
|-
|-
| 148 || [8.0.0+] GetGyroscopeFsr
| 234 || [6.0.0+] [[#GetUniquePadDeviceTypeSetInternal]]
|-
|-
| 149 || [8.0.0+] SetGyroscopeFsr
| 235 || [7.0.0+] EnableAnalogStickPower
|-
|-
| 150 || [8.0.0+] GetGyroscopeOdr
| 236 || [9.0.0+] RequestKuinaUartClockCal
|-
|-
| 151 || [8.0.0+] SetGyroscopeOdr
| 237 || [9.0.0+] GetKuinaUartClockCal
|-
|-
| 201 || ActivateFirmwareUpdate
| 238 || [9.0.0+] SetKuinaUartClockTrim
|-
|-
| 202 || DeactivateFirmwareUpdate
| 239 || [9.0.0+] KuinaLoopbackTest
|-
|-
| 203 || [[#StartFirmwareUpdate]]
| 240 || [9.0.0+] RequestBatteryVoltage
|-
|-
| 204 || GetFirmwareUpdateStage
| 241 || [9.0.0+] GetBatteryVoltage
|-
|-
| 205 || [[#GetFirmwareVersion]]
| 242 || [9.0.0+] GetUniquePadPowerInfo
|-
|-
| 206 || [[#GetDestinationFirmwareVersion]]
| 243 || [9.0.0+] RebootUniquePad
|-
|-
| 207 || [[#DiscardFirmwareInfoCacheForRevert]]
| 244 || [9.0.0+] RequestKuinaFirmwareVersion
|-
|-
| 208 || [3.0.0+] StartFirmwareUpdateForRevert
| 245 || [9.0.0+] GetKuinaFirmwareVersion
|-
|-
| 209 || [3.0.0+] GetAvailableFirmwareVersionForRevert
| 246 || [9.0.0+] GetVidPid
|-
|-
| 210 || [4.0.0+] IsFirmwareUpdatingDevice
| 301 || [5.0.0-8.1.0] [[#GetAbstractedPadHandles]]
|-
|-
| 211 || [6.0.0+] StartFirmwareUpdateIndividual
| 302 || [5.0.0-8.1.0] [[#GetAbstractedPadState]]
|-
|-
| 215 || [6.0.0+] SetUsbFirmwareForceUpdateEnabled
| 303 || [5.0.0-8.1.0] [[#GetAbstractedPadsState]]
|-
|-
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
| 321 || [5.0.0-8.1.0] [[#SetAutoPilotVirtualPadState]]
|-
|-
| 221 || [3.0.0+] [[#UpdateControllerColor]]
| 322 || [5.0.0-8.1.0] [[#UnsetAutoPilotVirtualPadState]]
|-
|-
| 222 || [4.0.0+] ConnectUsbPadsAsync
| 323 || [5.0.0+] [[#UnsetAllAutoPilotVirtualPadState]]
|-
|-
| 223 || [4.0.0+] DisconnectUsbPadsAsync
| 324 || [7.0.0+] [[#AttachHdlsWorkBuffer]]
|-
|-
| 224 || [5.0.0+] [[#UpdateDesignInfo]]
| 325 || [7.0.0+] [[#ReleaseHdlsWorkBuffer]]
|-
|-
| 225 || [5.0.0+] [[#GetUniquePadDriverState]]
| 326 || [7.0.0+] [[#DumpHdlsNpadAssignmentState]]
|-
|-
| 226 || [5.0.0+] [[#GetSixAxisSensorDriverStates]]
| 327 || [7.0.0+] [[#DumpHdlsStates]]
|-
|-
| 227 || [5.0.0+] GetRxPacketHistory
| 328 || [7.0.0+] [[#ApplyHdlsNpadAssignmentState]]
|-
|-
| 228 || [6.0.0+] [[#AcquireOperationEventHandle]]
| 329 || [7.0.0+] [[#ApplyHdlsStateList]]
|-
|-
| 229 || [6.0.0+] [[#ReadSerialFlash]]
| 330 || [7.0.0+] [[#AttachHdlsVirtualDevice]]
|-
|-
| 230 || [6.0.0+] [[#WriteSerialFlash]]
| 331 || [7.0.0+] [[#DetachHdlsVirtualDevice]]
|-
|-
| 231 || [6.0.0+] [[#GetOperationResult]]
| 332 || [7.0.0+] [[#SetHdlsState]]
|-
|-
| 232 || [6.0.0+] EnableShipmentMode
| 350 || [5.0.0+] AddRegisteredDevice
|-
|-
| 233 || [6.0.0+] ClearPairingInfo
| 400 || [6.0.0+] DisableExternalMcuOnNxDevice
|-
|-
| 234 || [6.0.0+] [[#GetUniquePadDeviceTypeSetInternal]]
| 401 || [6.0.0+] DisableRailDeviceFiltering
|-
|-
| 235 || [7.0.0+] EnableAnalogStickPower
| 500 || [8.0.0+] SetFactoryInt
|-
|-
| 236 || [9.0.0+] RequestKuinaUartClockCal
| 501 || [8.0.0+] IsFactoryBootEnabled
|-
|-
| 237 || [9.0.0+] GetKuinaUartClockCal
| 550 || [9.0.0+] SetAnalogStickModelDataTemporarily
|-
|-
| 238 || [9.0.0+] SetKuinaUartClockTrim
| 551 || [9.0.0+] GetAnalogStickModelData
|-
|-
| 239 || [9.0.0+] KuinaLoopbackTest
| 552 || [9.0.0+] ResetAnalogStickModelData
|-
|}
| 240 || [9.0.0+] RequestBatteryVoltage
 
|-
== StartFirmwareUpdate ==
| 241 || [9.0.0+] GetBatteryVoltage
Takes a total of 0x20-bytes of input, 2 handles, and returns an output handle.
|-
 
| 242 || [9.0.0+] GetUniquePadPowerInfo
[3.0.0+] Now takes a total of 8-bytes of input, and no longer uses any input/output handles.
|-
 
| 243 || [9.0.0+] RebootUniquePad
== GetFirmwareVersion ==
|-
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
| 244 || [9.0.0+] RequestKuinaFirmwareVersion
 
|-
[3.0.0+] Now returns an additional 0xC-bytes of output.
| 245 || [9.0.0+] GetKuinaFirmwareVersion
 
|-
== GetDestinationFirmwareVersion ==
| 246 || [9.0.0+] GetVidPid
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
|-
 
| 301 || [5.0.0-8.1.0] [[#GetAbstractedPadHandles]]
[3.0.0+] Now returns an additional 0xC-bytes of output.
|-
 
| 302 || [5.0.0-8.1.0] [[#GetAbstractedPadState]]
== DiscardFirmwareInfoCacheForRevert ==
|-
Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.
| 303 || [5.0.0-8.1.0] [[#GetAbstractedPadsState]]
 
|-
[3.0.0+] No input/output.
| 321 || [5.0.0-8.1.0] [[#SetAutoPilotVirtualPadState]]
 
|-
== UpdateControllerColor ==
| 322 || [5.0.0-8.1.0] [[#UnsetAutoPilotVirtualPadState]]
Takes two input u32s for the colors, an input u64 '''UniquePadId''', and no output.
|-
 
| 323 || [5.0.0+] [[#UnsetAllAutoPilotVirtualPadState]]
A state flag must be clear, otherwise an error is thrown. Afterwards, this flag is set.
|-
 
| 324 || [7.0.0+] [[#AttachHdlsWorkBuffer]]
Sends the spi-write subcommand to the specified controller, for writing the [[Joy-Con#Colors|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.
|-
 
| 325 || [7.0.0+] [[#ReleaseHdlsWorkBuffer]]
== UpdateDesignInfo ==
|-
Takes 4 input u32s for the colors, an input u8, an input u64 '''UniquePadId''', and no output.
| 326 || [7.0.0+] [[#DumpHdlsNpadAssignmentState]]
 
|-
A state flag must be clear (same as [[#UpdateControllerColor]]), otherwise an error is thrown. Afterwards, this flag is set.
| 327 || [7.0.0+] [[#DumpHdlsStates]]
 
|-
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.
| 328 || [7.0.0+] [[#ApplyHdlsNpadAssignmentState]]
 
|-
== GetUniquePadDriverState ==
| 329 || [7.0.0+] [[#ApplyHdlsStateList]]
Takes a total of 8-bytes of input, returns a total of 0x20-bytes of output.
|-
 
| 330 || [7.0.0+] [[#AttachHdlsVirtualDevice]]
[9.0.0+] Now takes a total of 8-bytes of input, returns a total of 0x18-bytes of output.
|-
| 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 ==
== GetSixAxisSensorDriverStates ==
Takes a total of 0x20-bytes of input, 2 handles, and returns an output handle.
Takes a total of 8-bytes of input and a type-0xA output buffer, returns a total of 8-bytes of output.


[3.0.0+] Now takes a total of 8-bytes of input, and no longer uses any input/output handles.
[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.


== GetFirmwareVersion ==
== AcquireOperationEventHandle ==
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
Takes an input u64 '''UniquePadId''', returns an output Event handle. The EventClearMode used by official sw is user-specified.


[3.0.0+] Now returns an additional 0xC-bytes of output.
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).


== GetDestinationFirmwareVersion ==
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.
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.
== ReadSerialFlash ==
Takes an input TransferMemory handle, an input u32 offset, an input u64 size, and an u64 '''UniquePadId''', no output.


== DiscardFirmwareInfoCacheForRevert ==
Reads from the specified controller's spi-flash. The input size is the original size without page-alignment. The TransferMemory permissions is RW-.
Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.


[3.0.0+] No input/output.
See also [[#AcquireOperationEventHandle]].


== UpdateControllerColor ==
With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).
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.
== 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.


Sends the spi-write subcommand to the specified controller, for writing the [[Joy-Con#Colors|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.
Writes to the specified controller's spi-flash. The TransferMemory permissions is R--.


== UpdateDesignInfo ==
See also [[#AcquireOperationEventHandle]].
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.
With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).


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.
== GetOperationResult ==
Takes an input u64 '''UniquePadId''', no output.


== GetUniquePadDriverState ==
Get the Result for the Operation and handles cleanup, for the specified controller.
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.
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).


== GetSixAxisSensorDriverStates ==
== GetUniquePadDeviceTypeSetInternal ==
Takes a total of 8-bytes of input and a type-0xA output buffer, returns a total of 8-bytes of output.
Takes an input u64 '''UniquePadId''', returns an [[#DeviceTypeInternal]].


[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.
== GetAbstractedPadHandles ==
Takes a type-0xA output buffer containing an array of u64 '''AbstractedPadHandle''' and returns an output s32 for total entries.


== AcquireOperationEventHandle ==
Returns a handle for each controller detected by the system.
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).
== GetAbstractedPadState ==
Takes an input u64 '''AbstractedPadHandle''', returns an output [[#AbstractedPadState]].


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.
== 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.


== ReadSerialFlash ==
== SetAutoPilotVirtualPadState ==
Takes an input TransferMemory handle, an input u32 offset, an input u64 size, and an u64 '''UniquePadId''', no output.
Takes an input s8 '''AbstractedVirtualPadId''' and an input [[#AbstractedPadState]], 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-.
== UnsetAutoPilotVirtualPadState ==
Takes an input s8 '''AbstractedVirtualPadId''', no output.


See also [[#AcquireOperationEventHandle]].
Clears AutoPilot state for the specified pad.


With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).
== UnsetAllAutoPilotVirtualPadState ==
No input/output.


== WriteSerialFlash ==
Same as [[#UnsetAutoPilotVirtualPadState]] except this clears state for every pad.
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--.
== AttachHdlsWorkBuffer ==
Takes an input TransferMemory handle and an u64 for the TransferMemory size, no output.


See also [[#AcquireOperationEventHandle]].
Official user-processes use TransferMemory size=0x1000 and permissions=RW.


With the sdk-nso for [9.0.0+] the wrapper funcs for this was removed (sdk-nso still has the actual cmd).
This TransferMemory is used as input/output by the other Hdls commands.


== GetOperationResult ==
Hdls is for virtual HID controllers.
Takes an input u64 '''UniquePadId''', no output.


Get the Result for the Operation and handles cleanup, for the specified controller.
== ReleaseHdlsWorkBuffer ==
No input/output.


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).
== DumpHdlsNpadAssignmentState ==
No input/output.


== GetUniquePadDeviceTypeSetInternal ==
After using this cmd, the output [[#HdlsNpadAssignment]] is located at tmem+0.
Takes an input u64 '''UniquePadId''', returns an [[#DeviceTypeInternal]].


== GetAbstractedPadHandles ==
== DumpHdlsStates ==
Takes a type-0xA output buffer containing an array of u64 '''AbstractedPadHandle''' and returns an output s32 for total entries.
No input/output.


Returns a handle for each controller detected by the system.
After using this cmd, the output [[#HdlsStateList]] struct is located at tmem+0.


== GetAbstractedPadState ==
== ApplyHdlsNpadAssignmentState ==
Takes an input u64 '''AbstractedPadHandle''', returns an output [[#AbstractedPadState]].
Takes an input u8 bool, no output.


== GetAbstractedPadsState ==
Prior to using this cmd, the input [[#HdlsNpadAssignment]] is written to tmem+0 by the user-process.
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 ==
== ApplyHdlsStateList ==
Takes an input s8 '''AbstractedVirtualPadId''' and an input [[#AbstractedPadState]], no output.
No input/output.


== UnsetAutoPilotVirtualPadState ==
Prior to using this cmd, the input [[#HdlsStateList]] is written to tmem+0 by the user-process.
Takes an input s8 '''AbstractedVirtualPadId''', no output.


Clears AutoPilot state for the specified pad.
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.


== UnsetAllAutoPilotVirtualPadState ==
== AttachHdlsVirtualDevice ==
No input/output.
Takes an [[#HdlsDeviceInfo]], returns a 8-byte '''HdlsHandle'''.


Same as [[#UnsetAutoPilotVirtualPadState]] except this clears state for every pad.
== DetachHdlsVirtualDevice ==
Takes an input 8-byte '''HdlsHandle''', no output.


== AttachHdlsWorkBuffer ==
== SetHdlsState ==
Takes an input TransferMemory handle and an u64 for the TransferMemory size, no output.
Takes an input [[#HdlsState]] and an input 8-byte '''HdlsHandle''', no output.


Official user-processes use TransferMemory size=0x1000 and permissions=RW.
[9.0.0+] Input order was swapped: now takes an input 8-byte '''HdlsHandle''' and a [[#HdlsState]], no output.


This TransferMemory is used as input/output by the other Hdls commands.
= hid:sys =
This is "nn::hid::IHidSystemServer".


Hdls is for virtual HID controllers.
{| class="wikitable" border="1"
 
|-
== ReleaseHdlsWorkBuffer ==
! Cmd || Name
No input/output.
|-
 
| 31 || SendKeyboardLockKeyEvent
== DumpHdlsNpadAssignmentState ==
|-
No input/output.
| 101 || AcquireHomeButtonEventHandle
 
|-
After using this cmd, the output [[#HdlsNpadAssignment]] is located at tmem+0.
| 111 || ActivateHomeButton
 
|-
== DumpHdlsStates ==
| 121 || AcquireSleepButtonEventHandle
No input/output.
|-
 
| 131 || ActivateSleepButton
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 ==
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 141 || AcquireCaptureButtonEventHandle
|-
|-
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
| 151 || ActivateCaptureButton
|-
|-
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
| 161 || [7.0.0+] GetPlatformConfig
|-
|-
| 0x5 || 0x3 || Padding
| 210 || AcquireNfcDeviceUpdateEventHandle
|-
|-
| 0x8 || 0x4 || RGBA Single Body Color
| 211 || GetNpadsWithNfc
|-
|-
| 0xC || 0x4 || RGBA Single Buttons Color
| 212 || AcquireNfcActivateEventHandle
|-
|-
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
| 213 || ActivateNfc
|-
|-
| 0x11 || 0x3 || Padding
| 214 || [4.0.0+] GetXcdHandleForNpadWithNfc
|-
|-
| 0x14 || 0x24 || [[#HdlsState]]. Unknown if the last 4-bytes are included in this struct, [[#SetAutoPilotVirtualPadState]]/[[#hiddbgGetAbstractedPadsState]] only uses the first 0x20-bytes.
| 215 || [4.0.0+] IsNfcActivated
|-
|-
| 0x38 || 0x60 || Unused with [[#SetAutoPilotVirtualPadState]]/[[#GetAbstractedPadsState]].
| 230 || AcquireIrSensorEventHandle
|}
 
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:
{| class="wikitable" border="1"
!  Bits
!  [[#HdlsDeviceInfo]]::type bits
!  Description
!  Notes
|-
|-
| 0 || 0 || ||  
| 231 || ActivateIrSensor
|-
|-
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
| 301 || ActivateNpadSystem
|-
|-
| 2 || 1 || ||  
| 303 || ApplyNpadSystemCommonPolicy
|-
|-
| 3 || 2 || ||  
| 304 || EnableAssigningSingleOnSlSrPress
|-
|-
| 4 || 1 || ||  
| 305 || DisableAssigningSingleOnSlSrPress
|-
|-
| 5 || 2 || ||  
| 306 || GetLastActiveNpad
|-
|-
| 6 || 3 || ||  
| 307 || GetNpadSystemExtStyle
|-
|-
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
| 308 || [5.0.0+] ApplyNpadSystemCommonPolicyFull
|-
|-
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
| 309 || [5.0.0+] GetNpadFullKeyGripColor
|-
|-
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
| 310 || [6.0.0+] [[#GetMaskedSupportedNpadStyleSet]]
|-
|-
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
| 311 || SetNpadPlayerLedBlinkingDevice
|-
|-
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
| 312 || [6.0.0+] SetSupportedNpadStyleSetAll
|-
|-
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
| 313 || [9.0.0+] GetNpadCaptureButtonAssignment
|-
|-
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
| 314 || [9.0.0+] GetAppletFooterUiType
|-
|-
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
| 315 || [9.0.0+] GetAppletDetailedUiType
|-
|-
| 15 || 17 || ||  
| 321 || [3.0.0+] [[#GetUniquePadsFromNpad]]
|-
|-
| 31 || 21 || || [[#DeviceType]] = BIT(31)
| 322 || GetIrSensorState
|-
|-
|}
| 323 || GetXcdHandleForNpadWithIrSensor
 
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
 
== HdlsNpadAssignment ==
This is a 0x208-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 500 || SetAppletResourceUserId
|-
|-
| 0x0 || 0x4 || s32 Total entries
| 501 || RegisterAppletResourceUserId
|-
|-
| 0x4 || 0x4 || Padding
| 502 || UnregisterAppletResourceUserId
|-
|-
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
| 503 || EnableAppletToGetInput
|}
 
=== HdlsNpadAssignmentEntry ===
This is a 0x20-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 504 || SetAruidValidForVibration
|-
|-
| 0x0 || 0x8 || HdlsHandle
| 505 || EnableAppletToGetSixAxisSensor
|-
|-
| 0x8 || 0x4 || ?
| 510 || [[#SetVibrationMasterVolume]]
|-
|-
| 0xC || 0x4 || ?
| 511 || GetVibrationMasterVolume
|-
| 512 || [3.0.0+] BeginPermitVibrationSession
|-
| 513 || [3.0.0+] EndPermitVibrationSession
|-
|-
| 0x10 || 0x8 || ?
| 520 || EnableHandheldHids
|-
|-
| 0x18 || 0x1 || ?
| 521 || DisableHandheldHids
|-
|-
| 0x19 || 0x7 || Padding
| 522 || [9.0.0+] SetJoyConRailEnabled
|}
 
== HdlsStateList ==
This is a 0x408-byte struct.
 
[9.0.0+] This is a 0x488-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 523 || [9.0.0+] IsJoyConRailEnabled
|-
|-
| 0x0 || 0x4 || s32 Total entries
| 540 || AcquirePlayReportControllerUsageUpdateEvent
|-
|-
| 0x4 || 0x4 || Padding
| 541 || GetPlayReportControllerUsages
|-
|-
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
| 542 || AcquirePlayReportRegisteredDeviceUpdateEvent
|}
 
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.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 543 || GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)
|-
|-
| 0x0 || 0x8 || HdlsHandle
| 544 || [3.0.0+] AcquireConnectionTriggerTimeoutEvent
|-
|-
| 0x8 || [[#HdlsDeviceInfo]] size || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
| 545 || [3.0.0+] SendConnectionTrigger
|-
|-
| 0x8 + [[#HdlsDeviceInfo]] size, with 8-byte alignment || 0x24 || [[#HdlsState]]
| 546 || [3.0.0+] AcquireDeviceRegisteredEventForControllerSupport
|-
|-
| <Immediately following the above> || 0x4 || Padding
| 547 || [3.0.0+] GetAllowedBluetoothLinksCount
|}
 
== HdlsDeviceInfo ==
This is a 0x10-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 548 || [5.0.0+] GetRegisteredDevices
|-
|-
| 0x0 || 0x4 || [[#DeviceTypeInternal]]
| 549 || [6.0.0+] GetConnectableRegisteredDevices
|-
|-
| 0x4 || 0x4 || RGBA Single Body Color
| 700 || ActivateUniquePad
|-
|-
| 0x8 || 0x4 || RGBA Single Buttons Color
| 702 || AcquireUniquePadConnectionEventHandle
|-
|-
| 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.
| 703 || [[#GetUniquePadIds]]
|-
|-
| 0xD || 0x3 || Padding
| 751 || AcquireJoyDetachOnBluetoothOffEventHandle
|}
 
[9.0.0+] This is a 0x14-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 800 || ListSixAxisSensorHandles
|-
|-
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
| 801 || IsSixAxisSensorUserCalibrationSupported
|-
|-
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
| 802 || ResetSixAxisSensorCalibrationValues
|-
|-
| 0x2 || 0x2 || Padding
| 803 || StartSixAxisSensorUserCalibration
|-
|-
| 0x4 || 0x4 || RGBA Single Body Color
| 804 || CancelSixAxisSensorUserCalibration
|-
|-
| 0x8 || 0x4 || RGBA Single Buttons Color
| 805 || [3.0.0+] GetUniquePadBluetoothAddress
|-
|-
| 0xC || 0x4 || RGBA Unknown Body Color
| 806 || [3.0.0+] DisconnectUniquePad
|-
|-
| 0x10 || 0x4 || RGBA Unknown Buttons Color
| 807 || [5.0.0+] [[#GetUniquePadType]]
|}
 
== DeviceTypeInternal ==
This is "nn::hid::detail::DeviceTypeInternal".
 
{| class="wikitable" border="1"
!  Bits
!  Description
|-
|-
| 0-7
| 808 || [5.0.0+] GetUniquePadInterface
| 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.
|-
| 809 || [5.0.0+] GetUniquePadSerialNumber
|-
|-
| 8-10
| 810 || [5.0.0+] GetUniquePadControllerNumber
| Pro Controller
|-
|-
| 11
| 811 || [5.0.0+] GetSixAxisSensorUserCalibrationStage
| Famicom left controller
|-
|-
| 12
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
| Famicom right controller (with microphone)
|-
|-
| 13
| 821 || StartAnalogStickManualCalibration
| NES left controller
|-
|-
| 14
| 822 || RetryCurrentAnalogStickManualCalibrationStage
| NES right controller
|-
|-
| 15-16
| 823 || CancelAnalogStickManualCalibration
| Invalid
|-
|-
| 17
| 824 || ResetAnalogStickManualCalibration
| Generic external controller
|-
|-
| 18-20
| 825 || [5.0.0+] GetAnalogStickState
| Invalid
|-
|-
| 21-23
| 826 || [5.0.0+] GetAnalogStickManualCalibrationStage
| Generic controller
|}
 
[9.0.0+] This is "nn::hidtypes::DeviceType".
 
{| class="wikitable" border="1"
!  Value
!  [[#DeviceType|DeviceType]]
!  [[#UniquePadType|UniquePadType]]
!  Description
|-
|-
| 1 || JoyRight, HandheldRight || JoyRight || Joy-Con right controller
| 827 || [5.0.0+] IsAnalogStickButtonPressed
|-
|-
| 2 || JoyLeft, HandheldLeft || JoyLeft || Joy-Con left controller
| 828 || [5.0.0+] IsAnalogStickInReleasePosition
|-
|-
| 3 || FullKey || FullKey || Pro Controller
| 829 || [5.0.0+] IsAnalogStickInCircumference
|-
|-
| 4 || JoyLeft || JoyLeft || Reserved
| 830 || [7.0.0+] [[#SetNotificationLedPattern]]
|-
|-
| 5 || JoyRight || JoyRight || Reserved
| 831 || [9.0.0+] [[#SetNotificationLedPatternWithTimeout]]
|-
|-
| 6 || FullKey || FullKey || Reserved
| 832 || [9.0.0+] [[#PrepareHidsForNotificationWake]]
|-
|-
| 7 || LarkHvcLeft, HandheldLarkHvcLeft || JoyLeft || Famicom left controller
| 850 || [3.0.0+] IsUsbFullKeyControllerEnabled
|-
|-
| 8 || LarkHvcRight, HandheldLarkHvcRight || JoyRight || Famicom right controller (with microphone)
| 851 || [3.0.0+] EnableUsbFullKeyController
|-
|-
| 9 || LarkNesLeft, HandheldLarkNesLeft || JoyLeft || NES left controller
| 852 || [3.0.0+] IsUsbConnected
|-
|-
| 10 || LarkNesRight, HandheldLarkNesRight || JoyRight || NES right controller
| 870 || [5.1.0+] IsHandheldButtonPressedOnConsoleMode
|-
|-
| 11 || Lucia || FullKey || SNES controller
| 900 || ActivateInputDetector
|-
|-
| 12 || Palma || Other || Poké Ball Plus controller
| 901 || [[#NotifyInputDetector]]
|-
|-
| 13 || FullKey || FullKey || Gc controller
| 1000 || [3.0.0+] InitializeFirmwareUpdate
|-
|-
| 14 || HandheldLeft || JoyLeft || Reserved
| 1001 || [3.0.0+] GetFirmwareVersion
|-
|-
| 15 || FullKey || FullKey || Reserved
| 1002 || [3.0.0+] GetAvailableFirmwareVersion
|-
|-
| 16 || FullKey || FullKey || Reserved
| 1003 || [3.0.0+] IsFirmwareUpdateAvailable
|-
|-
| 17 || DebugPad || DebugPad || Debug controller
| 1004 || [3.0.0+] CheckFirmwareUpdateRequired
|-
|-
| 18 || HandheldRight || JoyRight || Reserved
| 1005 || [3.0.0+] StartFirmwareUpdate
|-
|-
| 19 || System || Other || Unknown (has [[#NpadStyleTag|NpadFullKey]] style tag)
| 1006 || [3.0.0+] AbortFirmwareUpdate
|-
|-
| 20 || System || Other || Unknown (has [[#NpadStyleTag|NpadJoyDual]] style tag)
| 1007 || [3.0.0+] GetFirmwareUpdateState
|-
|-
| 21 || System || Other || Unknown (has [[#NpadStyleTag|NpadJoyDual]] style tag)
| 1008 || [4.0.0+] ActivateAudioControl
|}
 
== HdlsState ==
This is a 0x24-byte struct.
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 1009 || [4.0.0+] AcquireAudioControlEventHandle
|-
|-
| 0x0 || 0x1 || powerConnected for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
| 1010 || [4.0.0+] GetAudioControlStates
|-
|-
| 0x1 || 0x1 || ORRed with powerConnected to set the value of the first byte for the controller [[HID_Shared_Memory#Flags|flags]].
| 1011 || [4.0.0+] DeactivateAudioControl
|-
|-
| 0x2 || 0x6 || Unknown
| 1050 || [5.0.0+] IsSixAxisSensorAccurateUserCalibrationSupported
|-
|-
| 0x8 || 0x4 || batteryCharge for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
| 1051 || [5.0.0+] StartSixAxisSensorAccurateUserCalibration
|-
|-
| 0xC || 0x4 || [[HID_Shared_Memory#Button_State|Buttons]]. Bit18 = HOME and bit19 = Capture.
| 1052 || [5.0.0+] CancelSixAxisSensorAccurateUserCalibration
|-
|-
| 0x10 || 0x10(4*2*2) || Joystick data, see [[HID_Shared_Memory#Controller_State]].
| 1053 || [5.0.0+] GetSixAxisSensorAccurateUserCalibrationState
|-
|-
| 0x20 || 0x1 || Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
| 1100 || [5.0.0+] [[#GetHidbusSystemServiceObject]]
|-
|-
| 0x21 || 0x3 || Padding
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
|}
 
[9.0.0+]:
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 1130 || [6.0.0+] InitializeUsbFirmwareUpdate
|-
|-
| 0x0 || 0x4 || batteryCharge for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
| 1131 || [6.0.0+] FinalizeUsbFirmwareUpdate
|-
|-
| 0x4 || 0x4 || Unknown
| 1132 || [6.0.0+] CheckUsbFirmwareUpdateRequired
|-
|-
| 0x8 || 0x8 || [[HID_Shared_Memory#Button_State|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
| 1133 || [6.0.0+] StartUsbFirmwareUpdate
|-
|-
| 0x10 || 0x10(4*2*2) || Joystick data, see [[HID_Shared_Memory#Controller_State]].
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
|-
|-
| 0x20 || 0x1 || Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
| 1150 || [8.0.0+] SetTouchScreenMagnification
|-
|-
| 0x21 || 0x3 || Padding
| 1151 || [9.0.0+] GetTouchScreenFirmwareVersion
|}
 
= hid:sys =
This is "nn::hid::IHidSystemServer".
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 1152 || [9.0.0+] SetTouchScreenDefaultConfiguration
|-
|-
| 31 || SendKeyboardLockKeyEvent
| 1153 || [9.0.0+] GetTouchScreenDefaultConfiguration
|-
|-
| 101 || AcquireHomeButtonEventHandle
| 1154 || [9.0.0+] IsFirmwareAvailableForNotification
|-
|-
| 111 || ActivateHomeButton
| 1155 || [9.0.0+] SetForceHandheldStyleVibration
|-
|-
| 121 || AcquireSleepButtonEventHandle
| 1156 || [9.0.0+] SendConnectionTriggerWithoutTimeoutEvent
|-
|}
| 131 || ActivateSleepButton
 
|-
== GetMaskedSupportedNpadStyleSet ==
| 141 || AcquireCaptureButtonEventHandle
Takes an input u64 AppletResourceUserId, returns an output u32 [[#NpadStyleTag]].
|-
 
| 151 || ActivateCaptureButton
Official sw uses the output from [[Applet_Manager_services|GetAppletResourceUserIdOfCallerApplet]] with this.
|-
 
| 161 || [7.0.0+] GetPlatformConfig
== 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).
| 210 || AcquireNfcDeviceUpdateEventHandle
 
|-
The output buffer contains an array of u64 '''UniquePadId'''.
| 211 || GetNpadsWithNfc
 
|-
== SetVibrationMasterVolume ==
| 212 || AcquireNfcActivateEventHandle
Takes an input 32bit float.
|-
 
| 213 || ActivateNfc
== 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).
| 214 || [4.0.0+] GetXcdHandleForNpadWithNfc
 
|-
The output buffer contains an array of u64 '''UniquePadId'''.
| 215 || [4.0.0+] IsNfcActivated
 
|-
== GetUniquePadType ==
| 230 || AcquireIrSensorEventHandle
Takes an input u64 '''UniquePadId''' and returns an output u64 [[#UniquePadType]].
|-
 
| 231 || ActivateIrSensor
== SetNotificationLedPattern ==
|-
Takes an input [[#NotificationLedPattern]] and an u64 '''UniquePadId''', no output.
| 301 || ActivateNpadSystem
 
|-
The specified controller must have a HOME button.
| 303 || ApplyNpadSystemCommonPolicy
 
|-
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 [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md#subcommand-0x38-set-home-light subcommand].
| 304 || EnableAssigningSingleOnSlSrPress
 
|-
[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}).
| 305 || DisableAssigningSingleOnSlSrPress
 
|-
== SetNotificationLedPatternWithTimeout ==
| 306 || GetLastActiveNpad
Takes an input [[#NotificationLedPattern]], an u64 '''UniquePadId''', and an s64 TimeSpan, no output.
|-
 
| 307 || GetNpadSystemExtStyle
== 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+].
 
{| class="wikitable" border="1"
|-
|-
| 308 || [5.0.0+] ApplyNpadSystemCommonPolicyFull
! Cmd || Name
|-
|-
| 309 || [5.0.0+] GetNpadFullKeyGripColor
| 500 || SetAppletResourceUserId
|-
|-
| 310 || [6.0.0+] [[#GetMaskedSupportedNpadStyleSet]]
| 501 || RegisterAppletResourceUserId
|-
|-
| 311 || SetNpadPlayerLedBlinkingDevice
| 502 || UnregisterAppletResourceUserId
|-
|}
| 312 || [6.0.0+] SetSupportedNpadStyleSetAll
 
= hid:tmp =
This is "nn::hid::IHidTemporaryServer".
 
This service was added with [3.0.0+], then removed with [8.0.0+].
 
{| class="wikitable" border="1"
|-
|-
| 313 || [9.0.0+] GetNpadCaptureButtonAssignment
! Cmd || Name
|-
|-
| 314 || [9.0.0+] GetAppletFooterUiType
| 0 || GetConsoleSixAxisSensorCalibrationValues
|}
 
= irs =
This is "nn::irsensor::IIrSensorServer".
 
{| class="wikitable" border="1"
|-
|-
| 315 || [9.0.0+] GetAppletDetailedUiType
! Cmd || Name
|-
|-
| 321 || [3.0.0+] [[#GetUniquePadsFromNpad]]
| 302 || [[#ActivateIrsensor]]
|-
|-
| 322 || GetIrSensorState
| 303 || [[#DeactivateIrsensor]]
|-
|-
| 323 || GetXcdHandleForNpadWithIrSensor
| 304 || [[#GetIrsensorSharedMemoryHandle]]
|-
|-
| 500 || SetAppletResourceUserId
| 305 || [[#StopImageProcessor]]
|-
|-
| 501 || RegisterAppletResourceUserId
| 306 || [[#RunMomentProcessor]]
|-
|-
| 502 || UnregisterAppletResourceUserId
| 307 || [[#RunClusteringProcessor]]
|-
|-
| 503 || EnableAppletToGetInput
| 308 || [[#RunImageTransferProcessor]]
|-
|-
| 504 || SetAruidValidForVibration
| 309 || [[#GetImageTransferProcessorState]]
|-
|-
| 505 || EnableAppletToGetSixAxisSensor
| 310 || [[#RunTeraPluginProcessor]]
|-
|-
| 510 || [[#SetVibrationMasterVolume]]
| 311 || [[#GetNpadIrCameraHandle]]
|-
|-
| 511 || GetVibrationMasterVolume
| 312 || [[#RunPointingProcessor]]
|-
|-
| 512 || [3.0.0+] BeginPermitVibrationSession
| 313 || [[#SuspendImageProcessor]]
|-
|-
| 513 || [3.0.0+] EndPermitVibrationSession
| 314 || [3.0.0+] [[#CheckFirmwareVersion]]
|-
|-
| 520 || EnableHandheldHids
| 315 || [4.0.0+] SetFunctionLevel
|-
|-
| 521 || DisableHandheldHids
| 316 || [4.0.0+] RunImageTransferExProcessor
|-
|-
| 522 || [9.0.0+] SetJoyConRailEnabled
| 317 || [4.0.0+] RunIrLedProcessor
|-
|-
| 523 || [9.0.0+] IsJoyConRailEnabled
| 318 || [4.0.0+] StopImageProcessorAsync
|-
|-
| 540 || AcquirePlayReportControllerUsageUpdateEvent
| 319 || [4.0.0+] ActivateIrsensorWithFunctionLevel
|-
|}
| 541 || GetPlayReportControllerUsages
 
|-
== ActivateIrsensor ==
| 542 || AcquirePlayReportRegisteredDeviceUpdateEvent
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. No output.
|-
 
| 543 || GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)
== DeactivateIrsensor ==
|-
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. No output.
| 544 || [3.0.0+] AcquireConnectionTriggerTimeoutEvent
 
|-
== GetIrsensorSharedMemoryHandle ==
| 545 || [3.0.0+] SendConnectionTrigger
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. Returns a SharedMemory handle.
|-
 
| 546 || [3.0.0+] AcquireDeviceRegisteredEventForControllerSupport
The SharedMemory is mapped with permissions=read-only and size=0x8000.
|-
 
| 547 || [3.0.0+] GetAllowedBluetoothLinksCount
== StopImageProcessor ==
|-
Takes a PID-descriptor, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. No output.
| 548 || [5.0.0+] GetRegisteredDevices
 
|-
== RunMomentProcessor ==
| 549 || [6.0.0+] GetConnectableRegisteredDevices
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], and a [[#PackedMomentProcessorConfig]]. No output.
|-
 
| 700 || ActivateUniquePad
== RunClusteringProcessor ==
|-
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], and a [[#PackedClusteringProcessorConfig]]. No output.
| 702 || AcquireUniquePadConnectionEventHandle
 
|-
== RunImageTransferProcessor ==
| 703 || [[#GetUniquePadIds]]
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], a [[#PackedImageTransferProcessorConfig]], an u64 for the TransferMemory_size, and a TransferMemory handle. No output.
|-
 
| 751 || AcquireJoyDetachOnBluetoothOffEventHandle
Official sw creates the TransferMemory with an user-specified buffer and permissions=0.
|-
 
| 800 || ListSixAxisSensorHandles
== GetImageTransferProcessorState ==
|-
Takes a PID-descriptor, a type-0x6 output buffer, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. Returns an [[#ImageTransferProcessorState]]. No output.
| 801 || IsSixAxisSensorUserCalibrationSupported
 
|-
== RunTeraPluginProcessor==
| 802 || ResetSixAxisSensorCalibrationValues
Takes a PID-descriptor, an [[#IrCameraHandle]], a [[#PackedTeraPluginProcessorConfig]] (immediately after the previous word), and an [[AM_services|AppletResourceUserId]]. No output.
|-
 
| 803 || StartSixAxisSensorUserCalibration
== GetNpadIrCameraHandle ==
|-
Takes an input u32 NpadTypeId. Returns an output [[#IrCameraHandle]].
| 804 || CancelSixAxisSensorUserCalibration
 
|-
== RunPointingProcessor ==
| 805 || [3.0.0+] GetUniquePadBluetoothAddress
Takes a PID-descriptor, an [[#IrCameraHandle]], a [[#PackedDpdProcessorConfig]] (immediately after the previous word), and an [[AM_services|AppletResourceUserId]]. No output.
|-
 
| 806 || [3.0.0+] DisconnectUniquePad
== SuspendImageProcessor ==
|-
Takes a PID-descriptor, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. No output.
| 807 || [5.0.0+] [[#GetUniquePadType]]
 
|-
== CheckFirmwareVersion ==
| 808 || [5.0.0+] GetUniquePadInterface
Takes a PID-descriptor, an [[#IrCameraHandle]], a [[#PackedMcuVersion]], and an [[AM_services|AppletResourceUserId]]. No output.
|-
 
| 809 || [5.0.0+] GetUniquePadSerialNumber
== PackedClusteringProcessorConfig ==
|-
This is a 0x28-byte struct.
| 810 || [5.0.0+] GetUniquePadControllerNumber
 
== 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".
 
{| class="wikitable" border="1"
|-
|-
| 811 || [5.0.0+] GetSixAxisSensorUserCalibrationStage
! Cmd || Name
|-
|-
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
| 500 || SetAppletResourceUserId
|-
|-
| 821 || StartAnalogStickManualCalibration
| 501 || RegisterAppletResourceUserId
|-
|-
| 822 || RetryCurrentAnalogStickManualCalibrationStage
| 502 || UnregisterAppletResourceUserId
|-
|-
| 823 || CancelAnalogStickManualCalibration
| 503 || EnableAppletToGetInput
|}
 
= ahid:cd =
This is "nn::ahid::IServerSession".
 
Used for USB HID devices.
 
This service no longer exists in [9.0.0+].
 
{| class="wikitable" border="1"
|-
|-
| 824 || ResetAnalogStickManualCalibration
! Cmd || Name
|-
|-
| 825 || [5.0.0+] GetAnalogStickState
| 0 || [[#AcquireDevice]]
|-
|-
| 826 || [5.0.0+] GetAnalogStickManualCalibrationStage
| 1 || [[#ReleaseDevice]]
|-
|-
| 827 || [5.0.0+] IsAnalogStickButtonPressed
| 2 || [[#GetCtrlSession]]
|-
|-
| 828 || [5.0.0+] IsAnalogStickInReleasePosition
| 3 || [[#GetReadSession]]
|-
|-
| 829 || [5.0.0+] IsAnalogStickInCircumference
| 4 || [1.0.0-2.3.0] [[#GetWriteSession]]
|-
|}
| 830 || [7.0.0+] [[#SetNotificationLedPattern]]
 
|-
== AcquireDevice ==
| 831 || [9.0.0+] [[#SetNotificationLedPatternWithTimeout]]
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+].
 
{| class="wikitable" border="1"
|-
|-
| 832 || [9.0.0+] [[#PrepareHidsForNotificationWake]]
! Cmd || Name
|-
|-
| 850 || [3.0.0+] IsUsbFullKeyControllerEnabled
| 0 || GetString
|-
|-
| 851 || [3.0.0+] EnableUsbFullKeyController
| 1 || GetCodeBook
|-
|-
| 852 || [3.0.0+] IsUsbConnected
| 2 || GetReport
|-
|-
| 870 || [5.1.0+] IsHandheldButtonPressedOnConsoleMode
| 3 || SetReport
|-
|-
| 900 || ActivateInputDetector
| 4 || GetIdle
|-
|-
| 901 || [[#NotifyInputDetector]]
| 5 || SetIdle
|-
|-
| 1000 || [3.0.0+] InitializeFirmwareUpdate
| 6 || GetProtocol
|-
|-
| 1001 || [3.0.0+] GetFirmwareVersion
| 7 || SetProtocol
|-
|-
| 1002 || [3.0.0+] GetAvailableFirmwareVersion
| 8 || GetDescriptor
|-
|-
| 1003 || [3.0.0+] IsFirmwareUpdateAvailable
| 9 || SetDescriptor
|-
|-
| 1004 || [3.0.0+] CheckFirmwareUpdateRequired
| 10 || GetStateChangeEvent
|-
|-
| 1005 || [3.0.0+] StartFirmwareUpdate
| 11 || SignalStateChangeEvent
|-
|-
| 1006 || [3.0.0+] AbortFirmwareUpdate
| 12 || [3.0.0+] Write
|}
 
All of these use USB [[USB_services|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+].
 
{| class="wikitable" border="1"
|-
|-
| 1007 || [3.0.0+] GetFirmwareUpdateState
! Cmd || Name
|-
|-
| 1008 || [4.0.0+] ActivateAudioControl
| 0 || [[#Read]]
|}
 
=== Read ===
Uses [[USB_services|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+].
 
{| class="wikitable" border="1"
|-
|-
| 1009 || [4.0.0+] AcquireAudioControlEventHandle
! Cmd || Name
|-
|-
| 1010 || [4.0.0+] GetAudioControlStates
| 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+].
 
{| class="wikitable" border="1"
|-
|-
| 1011 || [4.0.0+] DeactivateAudioControl
! Cmd || Name
|-
|-
| 1050 || [5.0.0+] IsSixAxisSensorAccurateUserCalibrationSupported
| 0 || GetDeviceEntries
|-
|-
| 1051 || [5.0.0+] StartSixAxisSensorAccurateUserCalibration
| 1 || GetDeviceList
|-
|-
| 1052 || [5.0.0+] CancelSixAxisSensorAccurateUserCalibration
| 2 || GetDeviceParameters
|-
|-
| 1053 || [5.0.0+] GetSixAxisSensorAccurateUserCalibrationState
| 3 || AttachDevice
|-
|-
| 1100 || [5.0.0+] [[#GetHidbusSystemServiceObject]]
| 4 || DetachDevice
|-
|-
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
| 5 || [6.0.0+] SetDeviceFilter
|}
 
= xcd:sys =
This is "nn::xcd::detail::ISystemServer".
 
{| class="wikitable" border="1"
|-
|-
| 1130 || [6.0.0+] InitializeUsbFirmwareUpdate
! Cmd || Name
|-
|-
| 1131 || [6.0.0+] FinalizeUsbFirmwareUpdate
| 0 || GetDataFormat
|-
|-
| 1132 || [6.0.0+] CheckUsbFirmwareUpdateRequired
| 1 || SetDataFormat
|-
|-
| 1133 || [6.0.0+] StartUsbFirmwareUpdate
| 2 || GetMcuState
|-
|-
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
| 3 || SetMcuState
|-
|-
| 1150 || [8.0.0+] SetTouchScreenMagnification
| 4 || GetMcuVersionForNfc
|-
| 5 || CheckNfcDevicePower
|-
| 6 || [5.0.0+] SetMcuStateImmediate
|-
| 10 || SetNfcEvent
|-
| 11 || GetNfcInfo
|-
|-
| 1151 || [9.0.0+] GetTouchScreenFirmwareVersion
| 12 || StartNfcDiscovery
|-
|-
| 1152 || [9.0.0+] SetTouchScreenDefaultConfiguration
| 13 || StopNfcDiscovery
|-
|-
| 1153 || [9.0.0+] GetTouchScreenDefaultConfiguration
| 14 || StartNtagRead
|-
|-
| 1154 || [9.0.0+] IsFirmwareAvailableForNotification
| 15 || StartNtagWrite
|-
|-
| 1155 || [9.0.0+] SetForceHandheldStyleVibration
| 16 || SendNfcRawData
|-
|-
| 1156 || [9.0.0+] SendConnectionTriggerWithoutTimeoutEvent
| 17 || RegisterMifareKey
|}
|-
 
| 18 || ClearMifareKey
== GetMaskedSupportedNpadStyleSet ==
|-
Takes an input u64 AppletResourceUserId, returns an output u32 [[#NpadStyleTag]].
| 19 || StartMifareRead
 
|-
Official sw uses the output from [[Applet_Manager_services|GetAppletResourceUserIdOfCallerApplet]] with this.
| 20 || StartMifareWrite
 
|-
== GetUniquePadsFromNpad ==
| 101 || GetAwakeTriggerReasonForLeftRail
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).
|-
| 102 || GetAwakeTriggerReasonForRightRail
|}


The output buffer contains an array of u64 '''UniquePadId'''.
[5.0.0+] SetDataFormat, SetMcuState, and ClearMifareKey: now takes a total of 0xC-bytes of input instead of 0x10.


== SetVibrationMasterVolume ==
[6.0.0+]: The buffer type used by GetNfcInfo is now 0x32 instead of 0x1A.
Takes an input 32bit float.


== GetUniquePadIds ==
= hidbus =
Takes a type-0xA output buffer, and returns an output s64 for total output entries (which is copied to a s32 by official sw).
This is "nn::hidbus::IHidbusServer".


The output buffer contains an array of u64 '''UniquePadId'''.
This was added with [5.0.0+].


== GetUniquePadType ==
Official sw opens a temporary service-session for each func using this, with it being closed once done: no global session is kept open.
Takes an input u64 '''UniquePadId''' and returns an output u64 [[#UniquePadType]].


== SetNotificationLedPattern ==
{| class="wikitable" border="1"
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 [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md#subcommand-0x38-set-home-light 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+].
 
{| class="wikitable" border="1"
|-
! Cmd || Name
! Cmd || Name
|-
|-
| 500 || SetAppletResourceUserId
| 1 || [[#GetBusHandle]]
|-
|-
| 501 || RegisterAppletResourceUserId
| 2 || [[#IsExternalDeviceConnected]]
|-
|-
| 502 || UnregisterAppletResourceUserId
| 3 || [[#Initialize]]
|}
 
== NotificationLedPattern ==
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Subcommand argdata bytepos || Subcommand argdata nibble || Description
| 4 || [[#Finalize]]
|-
|-
| 0x0 || 0x1 || 0x0 || Low || Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF.
| 5 || [[#EnableExternalDevice]]
|-
|-
| 0x1 || 0x1 || 0x0 || High || Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles.
| 6 || [[#GetExternalDeviceId]]
|-
|-
| 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.
| 7 || [[#SendCommandAsync]]
|-
|-
| 0x3 || 0x1 || 0x1 || High || LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
| 8 || [[#GetSendCommandAsynceResult]]
|-
|-
| 0x4 || 0x1 || 0x2 || High || Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
| 9 || [[#SetEventForSendCommandAsycResult]]
|-
|-
| 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.
| 10 || [[#GetSharedMemoryHandle]]
|-
|-
| 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.
| 11 || [[#EnableJoyPollingReceiveMode]]
|-
|-
| 0x7 || 0x1 || || || Unused
| 12 || [[#DisableJoyPollingReceiveMode]]
|-
|-
| 0x8 || 0x1 || 0x2 || Low || Mini Cycle 2 LED Intensity.
| 13 || [5.0.0-6.2.0] GetPollingData
|-
|-
| 0x9 || 0x1 || 0x4 || High || Fading Transition Steps to Mini Cycle 2 (see above).
| 14 || [6.0.0+] [[#SetStatusManagerType]]
|-
|}
| 0xA || 0x1 || 0x4 || Low || Final Step Duration Multiplier of Mini Cycle 2 (see above).
 
|-
sdknso doesn't use the GetPollingData cmd.
| 0xB || 0x1 || || || Unused
 
|-
== GetBusHandle ==
| 0xC || 0x1 || 0x5 || High || Mini Cycle 3 LED Intensity.
Takes an input u32 [[#NpadIdType]], an u64 [[#BusType]], an u64 [[AM_services|AppletResourceUserId]], returns an output u8 bool and a [[#BusHandle]].
|-
 
| 0xD || 0x1 || 0x6 || High || Fading Transition Steps to Mini Cycle 3 (see above).
The bool indicates whether the [[#BusHandle]] is valid.
|-
 
| 0xE || 0x1 || 0x6 || Low || Final Step Duration Multiplier of Mini Cycle 3 (see above).
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.
|-
 
| 0xF || 0x1 || || || Unused
This cmd will throw an error when [[#BusType]] is invalid.
|-
 
| 0x10 || 0x1 || 0x5 || Low || Mini Cycle 4 LED Intensity.
== IsExternalDeviceConnected ==
|-
Takes an input [[#BusHandle]], returns an output u8 bool.
| 0x11 || 0x1 || 0x7 || High || Fading Transition Duration to Mini Cycle 4 (see above).
 
|-
This is not used by sdknso.
| 0x12 || 0x1 || 0x7 || Low || Final Step Duration Multiplier of Mini Cycle 4 (see above).
 
|-
== Initialize ==
| 0x13 || 0x1 || || || Unused
Takes an input [[#BusHandle]], an u64 [[AM_services|AppletResourceUserId]], no output.
|-
 
| 0x14 || 0x1 || 0x8 || High || Mini Cycle 5 LED Intensity.
Prior to using this cmd, sdknso handles [[#GetSharedMemoryHandle|sharedmem]] mapping if not done previously.
|-
 
| 0x15 || 0x1 || 0x9 || High || Fading Transition Steps to Mini Cycle 5 (see above).
== Finalize ==
|-
Takes an input [[#BusHandle]], an u64 [[AM_services|AppletResourceUserId]], no output.
| 0x16 || 0x1 || 0x9 || Low || Final Step Duration Multiplier of Mini Cycle 5 (see above).
 
|-
== EnableExternalDevice ==
| 0x17 || 0x1 || || || Unused
Takes an input u8 bool, a [[#BusHandle]], an u64, an u64 [[AM_services|AppletResourceUserId]], no output.
|-
 
| 0x18 || 0x1 || 0x8 || Low || Mini Cycle 6 LED Intensity.
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 [[#SetStatusManagerType|[6.0.0+]]]) entries, with entry-count {max [[#GetBusHandle|BusHandles]]}.
 
sdknso only uses the first 0x10-bytes of these entries, the rest is the ignored. Entry structure:
 
{| class="wikitable" border="1"
|-
|-
| 0x19 || 0x1 || 0xA || High || Fading Transition Steps to Mini Cycle 6 (see above).
! Offset || Size || Description
|-
|-
| 0x1A || 0x1 || 0xA || Low || Final Step Duration Multiplier of Mini Cycle 6 (see above).
| 0x0 || 0x1 || Bool flag
|-
|-
| 0x1B || 0x1 || || || Unused
| 0x1 || 0x3 || Padding
|-
|-
| 0x1C || 0x1 || 0xB || High || Mini Cycle 7 LED Intensity.
| 0x4 || 0x4 || Result
|-
|-
| 0x1D || 0x1 || 0xC || High || Fading Transition Steps  to Mini Cycle 7 (see above).
| 0x8 || 0x1 || DeviceEnabled. Bool flag indicating whether a device is [[#EnableExternalDevice|enabled]].
|-
|-
| 0x1E || 0x1 || 0xC || Low || Final Step Duration Multiplier of Mini Cycle 7 (see above).
| 0x9 || 0x1 || IsValid. Bool flag indicating whether this entry is valid.
|-
|-
| 0x1F || 0x1 || || || Unused
| 0xA || 0x1 || PollingEnabled. Bool flag indicating whether polling is [[#EnableJoyPollingReceiveMode|enabled]].
|-
|-
| 0x20 || 0x1 || 0xB || Low || Mini Cycle 8 LED Intensity.
| 0xB || 0x1 || Unknown / padding?
|-
|-
| 0x21 || 0x1 || 0xD || Low || Fading Transition Steps to Mini Cycle 8 (see above).
| 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):
 
{| class="wikitable" border="1"
|-
|-
| 0x22 || 0x1 || 0xD || High || Final Step Duration Multiplier of Mini Cycle 8 (see above).
! Offset || Size || Description
|-
|-
| 0x23 || 0x1 || || || Unused
| 0x0 || 0x4 || Result.
|-
|-
| 0x24 || 0x1 || 0xE || High || Mini Cycle 9 LED Intensity.
| 0x0 || 0x4 || Padding.
|-
|-
| 0x25 || 0x1 || 0xF || High || Fading Transition Steps to Mini Cycle 9 (see above).
| 0x8 || 0x18 || Initialized sysmodule-side, not used by sdknso.
|-
|-
| 0x26 || 0x1 || 0xF || Low || Final Step Duration Multiplier of Mini Cycle 9 (see above).
| 0x20 || 0x8 || Latest entry.
|-
|-
| 0x27 || 0x1 || || || Unused
| 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:
 
{| class="wikitable" border="1"
|-
|-
| 0x28 || 0x1 || 0xE || Low || Mini Cycle 10 LED Intensity.
! Offset || Size || Description
|-
|-
| 0x29 || 0x1 || 0x10 || High || Fading Transition Steps to Mini Cycle 10 (see above).
| 0x0 || 0x26 || Data
|-
|-
| 0x2A || 0x1 || 0x10 || Low || Final Step Duration Multiplier of Mini Cycle 10 (see above).
| 0x26 || 0x1 || Size of data.
|-
|-
| 0x2B || 0x1 || || || Unused
| 0x27 || 0x1 || Padding
|-
|-
| 0x2C || 0x1 || 0x11 || High || Mini Cycle 11 LED Intensity.
| 0x28 || 0x8 || Timestamp
|-
|}
| 0x2D || 0x1 || 0x12 || High || Fading Transition Steps to Mini Cycle 11 (see above).
 
JoyEnableSixAxisPollingDataAccessor:
 
{| class="wikitable" border="1"
|-
|-
| 0x2E || 0x1 || 0x12 || Low || Final Step Duration Multiplier of Mini Cycle 11 (see above).
! Offset || Size || Description
|-
|-
| 0x2F || 0x1 || || || Unused
| 0x0 || 0x8 || Data
|-
|-
| 0x30 || 0x1 || 0x11 || Low || Mini Cycle 12 LED Intensity.
| 0x8 || 0x1 || Size of data.
|-
|-
| 0x31 || 0x1 || 0x13 || High || Fading Transition Steps to Mini Cycle 12 (see above).
| 0x9 || 0x7 || Padding
|-
|-
| 0x32 || 0x1 || 0x13 || Low || Final Step Duration Multiplier of Mini Cycle 12 (see above).
| 0x10 || 0x8 || Timestamp
|}
 
JoyButtonOnlyPollingDataAccessor:
 
{| class="wikitable" border="1"
|-
|-
| 0x33 || 0x1 || || || Unused
! Offset || Size || Description
|-
|-
| 0x34 || 0x1 || 0x14 || High || Mini Cycle 13 LED Intensity.
| 0x0 || 0x2C || Data
|-
|-
| 0x35 || 0x1 || 0x15 || High || Fading Transition Steps to Mini Cycle 13 (see above).
| 0x2C || 0x1 || Size of data.
|-
|-
| 0x36 || 0x1 || 0x15 || Low || Final Step Duration Multiplier of Mini Cycle 13 (see above).
| 0x2D || 0x3 || Padding
|-
|-
| 0x37 || 0x1 || || || Unused
| 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 [[#GetSharedMemoryHandle|sharedmem]] (before [[#Initialize]]) with hard-coded value 0x2.
 
= GyroscopeZeroDriftMode =
This is "nn::hid::GyroscopeZeroDriftMode".
 
{| class="wikitable" border="1"
!  Value
!  Description
|-
|-
| 0x38 || 0x1 || 0x14 || Low || Mini Cycle 14 LED Intensity.
| 0 || Loose
|-
|-
| 0x39 || 0x1 || 0x16 || High || Fading Transition Steps to Mini Cycle 14 (see above).
| 1 || Standard
|-
|-
| 0x3A || 0x1 || 0x16 || Low || Final Step Duration Multiplier of Mini Cycle 14 (see above).
| 2 || Tight
|}
 
= NpadStyleTag =
This is "nn::hid::NpadStyleTag".
 
{| class="wikitable" border="1"
!  Bits
!  Description
!  Notes
|-
|-
| 0x3B || 0x1 || || || Unused
| 0
| NpadFullKey
| Pro Controller
|-
|-
| 0x3C || 0x1 || 0x17 || High || Mini Cycle 15 LED Intensity.
| 1
| NpadHandheld
| Joy-Con controller in handheld mode
|-
|-
| 0x3D || 0x1 || 0x18 || High || Fading Transition Steps to Mini Cycle 15 (see above).
| 2
| NpadJoyDual
| Joy-Con controller in dual mode
|-
|-
| 0x3E || 0x1 || 0x18 || Low || Final Step Duration Multiplier of Mini Cycle 15 (see above).
| 3
| NpadJoyLeft
| Joy-Con left controller in single mode
|-
|-
| 0x3F || 0x1 || || || Unused
| 4
| NpadJoyRight
| Joy-Con right controller in single mode
|-
|-
| 0x40 || 0x1 || 0x17 || Low || Mini Cycle 16 LED Intensity.
| 5
| NpadGc
| GameCube controller
|-
|-
| 0x41 || 0x1 || 0x19 || High || Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
| 6
| NpadPalma
| Poké Ball Plus controller
|-
|-
| 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.)
| 7
| NpadLark
| NES/Famicom controller
|-
|-
| 0x43 || 0x1 || || || Unused
| 8
| NpadHandheldLark
| NES/Famicom controller in handheld mode
|-
|-
| 0x44 || 0x1 || 0x1A || High || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
| 9
| NpadLucia
| SNES controller
|-
|-
| 0x45 || 0x1 || 0x1A || Low || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
| 10-28
| Reserved
|
|-
|-
| 0x46 || 0x1 || || || Padding
| 29
| NpadSystemExt
| Generic external controller
|-
|-
| 0x47 || 0x1 || || || Padding
| 30
| NpadSystem
| Generic controller
|-
|-
| 31
| Reserved
|
|}
|}


This is "nn::hid::system::NotificationLedPattern".
= NpadIdType =
This is "nn::hid::NpadIdType". This is the controller index used in [[HID_Shared_Memory#Controllers|sharedmem]].


This is a 0x48-byte struct.
{| class="wikitable" border="1"
 
!  Value
The above descriptions in the table are based on the info from [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md here].
!  Description
 
|-
argdata in the subcommand is initialized as follows: <code>((u8*)cmd_argdata)[pos] = u8_in[pos2] | u8_in[pos3]<<4;</code> 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.
| 0x0 || No1
 
|-
The layout of cmd_argdata is as follows:
| 0x1 || No2
{| class="wikitable" border="1"
|-
| 0x2 || No3
|-
|-
! Offset || Size || Description
| 0x3 || No4
|-
|-
| 0x0 || 0x1B || See above.
| 0x4 || No5
|-
|-
| 0x1B || 0xB || Cleared to zero.
| 0x5 || No6
|-
|-
| 0x26 || 0x5 || Unused
| 0x6 || No7
|-
|-
| 0x2B || 0x8 || Set to an input value, which is hard-coded 0.
| 0x7 || No8
|-
|-
| 0x33 || 0x2 || Set to value 0.
| 0x10 || Other
|-
|-
| 0x35 || 0x1 || Set to value 1.
| 0x20 || Handheld
|}
|}


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


{| class="wikitable" border="1"
{| class="wikitable" border="1"
!  Bits
!  Value
!  Description
!  Description
|-
|-
| 0
| 1 || Bluetooth
| FullKey
|-
|-
| 1
| 2 || Rail
| DebugPad
|-
|-
| 2
| 3 || USB
| HandheldLeft
|-
|-
| 3
| 4 || Unknown
| HandheldRight
|}
 
= AbstractedPadState =
{| class="wikitable" border="1"
|-
|-
| 4
! Offset || Size || Description
| JoyLeft
|-
|-
| 5
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
| JoyRight
|-
|-
| 6
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
| Palma
|-
|-
| 7
| 0x5 || 0x3 || Padding
| LarkHvcLeft
|-
|-
| 8
| 0x8 || 0x4 || RGBA Single Body Color
| LarkHvcRight
|-
|-
| 9
| 0xC || 0x4 || RGBA Single Buttons Color
| LarkNesLeft
|-
|-
| 10
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
| LarkNesRight
|-
|-
| 11
| 0x11 || 0x3 || Padding
| HandheldLarkHvcLeft
|-
|-
| 12
| 0x14 || 0x24 || [[#HdlsState]]. Unknown if the last 4-bytes are included in this struct, [[#SetAutoPilotVirtualPadState]]/[[#hiddbgGetAbstractedPadsState]] only uses the first 0x20-bytes.
| HandheldLarkHvcRight
|-
|-
| 13
| 0x38 || 0x60 || Unused with [[#SetAutoPilotVirtualPadState]]/[[#GetAbstractedPadsState]].
| HandheldLarkNesLeft
|-
| 14
| HandheldLarkNesRight
|-
| 15
| Lucia
|-
| 16-30
| Reserved
|-
| 31
| System
|}
|}


== UniquePadType ==
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.
This is "nn::hid::system::UniquePadType".


Type:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
!  Value
!  Bits
!  [[#HdlsDeviceInfo]]::type bits
!  Description
!  Description
!  Notes
|-
| 0 || 0 || ||
|-
|-
| 0x0 || Other
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
|-
|-
| 0x1 || FullKey
| 2 || 1 || ||  
|-
|-
| 0x2 || JoyRight
| 3 || 2 || ||  
|-
|-
| 0x3 || JoyLeft
| 4 || 1 || ||  
|-
|-
| 0x4 || DebugPad
| 5 || 2 || ||  
|}
 
= hid:tmp =
This is "nn::hid::IHidTemporaryServer".
 
This service was added with [3.0.0+], then removed with [8.0.0+].
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 6 || 3 || ||  
|-
|-
| 0 || GetConsoleSixAxisSensorCalibrationValues
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
|}
 
= irs =
This is "nn::irsensor::IIrSensorServer".
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
|-
|-
| 302 || [[#ActivateIrsensor]]
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
|-
|-
| 303 || [[#DeactivateIrsensor]]
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
|-
|-
| 304 || [[#GetIrsensorSharedMemoryHandle]]
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
|-
|-
| 305 || [[#StopImageProcessor]]
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
|-
|-
| 306 || [[#RunMomentProcessor]]
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
|-
|-
| 307 || [[#RunClusteringProcessor]]
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
|-
|-
| 308 || [[#RunImageTransferProcessor]]
| 15 || 17 || ||  
|-
|-
| 309 || [[#GetImageTransferProcessorState]]
| 31 || 21 || || [[#DeviceType]] = BIT(31)
|-
|-
| 310 || [[#RunTeraPluginProcessor]]
|}
 
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
 
= HdlsNpadAssignment =
This is a 0x208-byte struct.
 
{| class="wikitable" border="1"
|-
|-
| 311 || [[#GetNpadIrCameraHandle]]
! Offset || Size || Description
|-
| 0x0 || 0x4 || s32 Total entries
|-
| 0x4 || 0x4 || Padding
|-
|-
| 312 || [[#RunPointingProcessor]]
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
|}
 
= HdlsNpadAssignmentEntry =
This is a 0x20-byte struct.
 
{| class="wikitable" border="1"
|-
|-
| 313 || [[#SuspendImageProcessor]]
! Offset || Size || Description
|-
|-
| 314 || [3.0.0+] [[#CheckFirmwareVersion]]
| 0x0 || 0x8 || HdlsHandle
|-
|-
| 315 || [4.0.0+] SetFunctionLevel
| 0x8 || 0x4 || ?
|-
|-
| 316 || [4.0.0+] RunImageTransferExProcessor
| 0xC || 0x4 || ?
|-
|-
| 317 || [4.0.0+] RunIrLedProcessor
| 0x10 || 0x8 || ?
|-
|-
| 318 || [4.0.0+] StopImageProcessorAsync
| 0x18 || 0x1 || ?
|-
|-
| 319 || [4.0.0+] ActivateIrsensorWithFunctionLevel
| 0x19 || 0x7 || Padding
|}
|}


== ActivateIrsensor ==
= HdlsStateList =
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. No output.
This is a 0x408-byte struct.


== DeactivateIrsensor ==
[9.0.0+] This is a 0x488-byte struct.
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. No output.


== GetIrsensorSharedMemoryHandle ==
{| class="wikitable" border="1"
Takes a PID-descriptor and an [[AM_services|AppletResourceUserId]]. Returns a SharedMemory handle.
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || s32 Total entries
|-
| 0x4 || 0x4 || Padding
|-
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
|}


The SharedMemory is mapped with permissions=read-only and size=0x8000.
This contains a list of all controllers, including non-virtual controllers.


== StopImageProcessor ==
= HdlsStateListEntry =
Takes a PID-descriptor, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. No output.
This is a 0x40-byte struct.  


== RunMomentProcessor ==
[9.0.0+] This is a 0x48-byte struct.
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], and a [[#PackedMomentProcessorConfig]]. No output.


== RunClusteringProcessor ==
{| class="wikitable" border="1"
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], and a [[#PackedClusteringProcessorConfig]]. No output.
|-
 
! Offset || Size || Description
== RunImageTransferProcessor ==
|-
Takes a PID-descriptor, an [[#IrCameraHandle]], an [[AM_services|AppletResourceUserId]], a [[#PackedImageTransferProcessorConfig]], an u64 for the TransferMemory_size, and a TransferMemory handle. No output.
| 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
|}


Official sw creates the TransferMemory with an user-specified buffer and permissions=0.
= HdlsDeviceInfo =
This is a 0x10-byte struct.


== GetImageTransferProcessorState ==
{| class="wikitable" border="1"
Takes a PID-descriptor, a type-0x6 output buffer, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. Returns an [[#ImageTransferProcessorState]]. No output.
|-
! 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
|}


== RunTeraPluginProcessor==
[9.0.0+] This is a 0x14-byte struct.
Takes a PID-descriptor, an [[#IrCameraHandle]], a [[#PackedTeraPluginProcessorConfig]] (immediately after the previous word), and an [[AM_services|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 [[AM_services|AppletResourceUserId]]. No output.
 
== SuspendImageProcessor ==
Takes a PID-descriptor, an [[#IrCameraHandle]], and an [[AM_services|AppletResourceUserId]]. No output.
 
== CheckFirmwareVersion ==
Takes a PID-descriptor, an [[#IrCameraHandle]], a [[#PackedMcuVersion]], and an [[AM_services|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.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description || DefaultConfig
! Offset || Size || Description
|-
|-
| 0x0 || 0x8 || ? || 0x493E0
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
|-
|-
| 0x8 || 0x1 || ? || 0x0
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
|-
|-
| 0x9 || 0x1 || ? || 0x8
| 0x2 || 0x2 || Padding
|-
|-
| 0xA || 0x1 || ? || 0x0
| 0x4 || 0x4 || RGBA Single Body Color
|-
|-
| 0xB || 0x5 || Padding ||  
| 0x8 || 0x4 || RGBA Single Buttons Color
|-
|-
| 0x10 || 0x8 || u16, u32, u16 || {Not written}, 0x1400000, 0xF0
| 0xC || 0x4 || RGBA Unknown Body Color
|-
|-
| 0x18 || 0x4 || Hard-coded to 0xA0003. ||
| 0x10 || 0x4 || RGBA Unknown Buttons Color
|-
| 0x1C || 0x1 || ? || 0x1
|-
| 0x1D || 0x1 || ? || 0x50
|-
| 0x1E || 0x2 || Padding ||
|}
|}


== PackedClusteringProcessorConfig ==
= DeviceTypeInternal =
This is a 0x28-byte struct.
This is "nn::hid::detail::DeviceTypeInternal".
 
== 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".


{| class="wikitable" border="1"
{| class="wikitable" border="1"
!  Bits
!  Description
|-
|-
! Cmd || Name
| 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.
|-
|-
| 500 || SetAppletResourceUserId
| 8-10
| Pro Controller
|-
|-
| 501 || RegisterAppletResourceUserId
| 11
| Famicom left controller
|-
|-
| 502 || UnregisterAppletResourceUserId
| 12
| Famicom right controller (with microphone)
|-
|-
| 503 || EnableAppletToGetInput
| 13
|}
| NES left controller
 
= ahid:cd =
This is "nn::ahid::IServerSession".
 
Used for USB HID devices.
 
This service no longer exists in [9.0.0+].
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 14
| NES right controller
|-
|-
| 0 || [[#AcquireDevice]]
| 15-16
| Invalid
|-
|-
| 1 || [[#ReleaseDevice]]
| 17
| Generic external controller
|-
|-
| 2 || [[#GetCtrlSession]]
| 18-20
| Invalid
|-
|-
| 3 || [[#GetReadSession]]
| 21-23
|-
| Generic controller
| 4 || [1.0.0-2.3.0] [[#GetWriteSession]]
|}
|}


== AcquireDevice ==
[9.0.0+] This is "nn::hidtypes::DeviceType".
Takes an input s32, no output.


== ReleaseDevice ==
{| class="wikitable" border="1"
Takes an input s32, no output.
!  Value
 
!  [[#DeviceType|DeviceType]]
== GetCtrlSession ==
!  [[#UniquePadType|UniquePadType]]
Takes an input u32, returns an [[#ICtrlSession]].
!  Description
 
|-
== GetReadSession ==
| 1 || JoyRight, HandheldRight || JoyRight || Joy-Con right controller
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+].
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 2 || JoyLeft, HandheldLeft || JoyLeft || Joy-Con left controller
|-
|-
| 0 || GetString
| 3 || FullKey || FullKey || Pro Controller
|-
|-
| 1 || GetCodeBook
| 4 || JoyLeft || JoyLeft || Reserved
|-
|-
| 2 || GetReport
| 5 || JoyRight || JoyRight || Reserved
|-
|-
| 3 || SetReport
| 6 || FullKey || FullKey || Reserved
|-
|-
| 4 || GetIdle
| 7 || LarkHvcLeft, HandheldLarkHvcLeft || JoyLeft || Famicom left controller
|-
|-
| 5 || SetIdle
| 8 || LarkHvcRight, HandheldLarkHvcRight || JoyRight || Famicom right controller (with microphone)
|-
|-
| 6 || GetProtocol
| 9 || LarkNesLeft, HandheldLarkNesLeft || JoyLeft || NES left controller
|-
|-
| 7 || SetProtocol
| 10 || LarkNesRight, HandheldLarkNesRight || JoyRight || NES right controller
|-
|-
| 8 || GetDescriptor
| 11 || Lucia || FullKey || SNES controller
|-
| 12 || Palma || Other || Poké Ball Plus controller
|-
| 13 || FullKey || FullKey || Gc controller
|-
| 14 || HandheldLeft || JoyLeft || Reserved
|-
| 15 || FullKey || FullKey || Reserved
|-
| 16 || FullKey || FullKey || Reserved
|-
| 17 || DebugPad || DebugPad || Debug controller
|-
|-
| 9 || SetDescriptor
| 18 || HandheldRight || JoyRight || Reserved
|-
|-
| 10 || GetStateChangeEvent
| 19 || System || Other || Unknown (has [[#NpadStyleTag|NpadFullKey]] style tag)
|-
|-
| 11 || SignalStateChangeEvent
| 20 || System || Other || Unknown (has [[#NpadStyleTag|NpadJoyDual]] style tag)
|-
|-
| 12 || [3.0.0+] Write
| 21 || System || Other || Unknown (has [[#NpadStyleTag|NpadJoyDual]] style tag)
|}
|}


All of these use USB [[USB_services|CtrlXfer]], except for GetStateChangeEvent and SignalStateChangeEvent, and GetCodeBook which copies 0x4000-bytes from state to output.
= HdlsState =
 
This is a 0x24-byte struct.
== IReadSession ==
This is "nn::ahid::IReadSession".
 
This no longer exists in [9.0.0+].


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
! Offset || Size || Description
|-
| 0x0 || 0x1 || powerConnected for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
|-
| 0x1 || 0x1 || ORRed with powerConnected to set the value of the first byte for the controller [[HID_Shared_Memory#Flags|flags]].
|-
| 0x2 || 0x6 || Unknown
|-
| 0x8 || 0x4 || batteryCharge for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
|-
| 0xC || 0x4 || [[HID_Shared_Memory#Button_State|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).
|-
|-
| 0 || [[#Read]]
| 0x21 || 0x3 || Padding
|}
|}


=== Read ===
[9.0.0+]:
Uses [[USB_services|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+].
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
! Offset || Size || Description
|-
|-
| 0 || [[#Write]]
| 0x0 || 0x4 || batteryCharge for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
|-
| 0x4 || 0x4 || Unknown
|-
| 0x8 || 0x8 || [[HID_Shared_Memory#Button_State|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
|}
|}


=== Write ===
= NotificationLedPattern =
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+].
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
! Offset || Size || Subcommand argdata bytepos || Subcommand argdata nibble || Description
|-
|-
| 0 || GetDeviceEntries
| 0x0 || 0x1 || 0x0 || Low || Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF.
|-
|-
| 1 || GetDeviceList
| 0x1 || 0x1 || 0x0 || High || Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles.
|-
|-
| 2 || GetDeviceParameters
| 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.
|-
|-
| 3 || AttachDevice
| 0x3 || 0x1 || 0x1 || High || LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
|-
|-
| 4 || DetachDevice
| 0x4 || 0x1 || 0x2 || High || Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
|-
|-
| 5 || [6.0.0+] SetDeviceFilter
| 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.
|}
 
= xcd:sys =
This is "nn::xcd::detail::ISystemServer".
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 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.
|-
|-
| 0 || GetDataFormat
| 0x7 || 0x1 || || || Unused
|-
|-
| 1 || SetDataFormat
| 0x8 || 0x1 || 0x2 || Low || Mini Cycle 2 LED Intensity.
|-
|-
| 2 || GetMcuState
| 0x9 || 0x1 || 0x4 || High || Fading Transition Steps to Mini Cycle 2 (see above).
|-
|-
| 3 || SetMcuState
| 0xA || 0x1 || 0x4 || Low || Final Step Duration Multiplier of Mini Cycle 2 (see above).
|-
|-
| 4 || GetMcuVersionForNfc
| 0xB || 0x1 || || || Unused
|-
|-
| 5 || CheckNfcDevicePower
| 0xC || 0x1 || 0x5 || High || Mini Cycle 3 LED Intensity.
|-
|-
| 6 || [5.0.0+] SetMcuStateImmediate
| 0xD || 0x1 || 0x6 || High || Fading Transition Steps to Mini Cycle 3 (see above).
|-
|-
| 10 || SetNfcEvent
| 0xE || 0x1 || 0x6 || Low || Final Step Duration Multiplier of Mini Cycle 3 (see above).
|-
|-
| 11 || GetNfcInfo
| 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).
|-
|-
| 12 || StartNfcDiscovery
| 0x12 || 0x1 || 0x7 || Low || Final Step Duration Multiplier of Mini Cycle 4 (see above).
|-
|-
| 13 || StopNfcDiscovery
| 0x13 || 0x1 || || || Unused
|-
|-
| 14 || StartNtagRead
| 0x14 || 0x1 || 0x8 || High || Mini Cycle 5 LED Intensity.
|-
|-
| 15 || StartNtagWrite
| 0x15 || 0x1 || 0x9 || High || Fading Transition Steps to Mini Cycle 5 (see above).
|-
|-
| 16 || SendNfcRawData
| 0x16 || 0x1 || 0x9 || Low || Final Step Duration Multiplier of Mini Cycle 5 (see above).
|-
|-
| 17 || RegisterMifareKey
| 0x17 || 0x1 || || || Unused
|-
|-
| 18 || ClearMifareKey
| 0x18 || 0x1 || 0x8 || Low || Mini Cycle 6 LED Intensity.
|-
|-
| 19 || StartMifareRead
| 0x19 || 0x1 || 0xA || High || Fading Transition Steps to Mini Cycle 6 (see above).
|-
|-
| 20 || StartMifareWrite
| 0x1A || 0x1 || 0xA || Low || Final Step Duration Multiplier of Mini Cycle 6 (see above).
|-
|-
| 101 || GetAwakeTriggerReasonForLeftRail
| 0x1B || 0x1 || || || Unused
|-
|-
| 102 || GetAwakeTriggerReasonForRightRail
| 0x1C || 0x1 || 0xB || High || Mini Cycle 7 LED Intensity.
|}
 
[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.
 
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
| 0x1D || 0x1 || 0xC || High || Fading Transition Steps  to Mini Cycle 7 (see above).
|-
|-
| 1 || [[#GetBusHandle]]
| 0x1E || 0x1 || 0xC || Low || Final Step Duration Multiplier of Mini Cycle 7 (see above).
|-
|-
| 2 || [[#IsExternalDeviceConnected]]
| 0x1F || 0x1 || || || Unused
|-
|-
| 3 || [[#Initialize]]
| 0x20 || 0x1 || 0xB || Low || Mini Cycle 8 LED Intensity.
|-
|-
| 4 || [[#Finalize]]
| 0x21 || 0x1 || 0xD || Low || Fading Transition Steps to Mini Cycle 8 (see above).
|-
|-
| 5 || [[#EnableExternalDevice]]
| 0x22 || 0x1 || 0xD || High || Final Step Duration Multiplier of Mini Cycle 8 (see above).
|-
|-
| 6 || [[#GetExternalDeviceId]]
| 0x23 || 0x1 || || || Unused
|-
|-
| 7 || [[#SendCommandAsync]]
| 0x24 || 0x1 || 0xE || High || Mini Cycle 9 LED Intensity.
|-
|-
| 8 || [[#GetSendCommandAsynceResult]]
| 0x25 || 0x1 || 0xF || High || Fading Transition Steps to Mini Cycle 9 (see above).
|-
|-
| 9 || [[#SetEventForSendCommandAsycResult]]
| 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
|-
|-
| 10 || [[#GetSharedMemoryHandle]]
| 0x2C || 0x1 || 0x11 || High || Mini Cycle 11 LED Intensity.
|-
|-
| 11 || [[#EnableJoyPollingReceiveMode]]
| 0x2D || 0x1 || 0x12 || High || Fading Transition Steps to Mini Cycle 11 (see above).
|-
|-
| 12 || [[#DisableJoyPollingReceiveMode]]
| 0x2E || 0x1 || 0x12 || Low || Final Step Duration Multiplier of Mini Cycle 11 (see above).
|-
|-
| 13 || [5.0.0-6.2.0] GetPollingData
| 0x2F || 0x1 || || || Unused
|-
|-
| 14 || [6.0.0+] [[#SetStatusManagerType]]
| 0x30 || 0x1 || 0x11 || Low || Mini Cycle 12 LED Intensity.
|}
|-
 
| 0x31 || 0x1 || 0x13 || High || Fading Transition Steps to Mini Cycle 12 (see above).
sdknso doesn't use the GetPollingData cmd.
|-
 
| 0x32 || 0x1 || 0x13 || Low || Final Step Duration Multiplier of Mini Cycle 12 (see above).
== GetBusHandle ==
|-
Takes an input u32 [[#NpadIdType]], an u64 [[#BusType]], an u64 [[AM_services|AppletResourceUserId]], returns an output u8 bool and a [[#BusHandle]].
| 0x33 || 0x1 || || || Unused
 
|-
The bool indicates whether the [[#BusHandle]] is valid.
| 0x34 || 0x1 || 0x14 || High || Mini Cycle 13 LED Intensity.
 
|-
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.
| 0x35 || 0x1 || 0x15 || High || Fading Transition Steps to Mini Cycle 13 (see above).
 
|-
This cmd will throw an error when [[#BusType]] is invalid.
| 0x36 || 0x1 || 0x15 || Low || Final Step Duration Multiplier of Mini Cycle 13 (see above).
 
|-
== IsExternalDeviceConnected ==
| 0x37 || 0x1 || || || Unused
Takes an input [[#BusHandle]], returns an output u8 bool.
|-
 
| 0x38 || 0x1 || 0x14 || Low || Mini Cycle 14 LED Intensity.
This is not used by sdknso.
|-
 
| 0x39 || 0x1 || 0x16 || High || Fading Transition Steps to Mini Cycle 14 (see above).
== Initialize ==
|-
Takes an input [[#BusHandle]], an u64 [[AM_services|AppletResourceUserId]], no output.
| 0x3A || 0x1 || 0x16 || Low || Final Step Duration Multiplier of Mini Cycle 14 (see above).
 
|-
Prior to using this cmd, sdknso handles [[#GetSharedMemoryHandle|sharedmem]] mapping if not done previously.
| 0x3B || 0x1 || || || Unused
 
|-
== Finalize ==
| 0x3C || 0x1 || 0x17 || High || Mini Cycle 15 LED Intensity.
Takes an input [[#BusHandle]], an u64 [[AM_services|AppletResourceUserId]], no output.
|-
 
| 0x3D || 0x1 || 0x18 || High || Fading Transition Steps to Mini Cycle 15 (see above).
== EnableExternalDevice ==
|-
Takes an input u8 bool, a [[#BusHandle]], an u64, an u64 [[AM_services|AppletResourceUserId]], no output.
| 0x3E || 0x1 || 0x18 || Low || Final Step Duration Multiplier of Mini Cycle 15 (see above).
 
|-
sdknso passes value 0x38900050018 (0x3A600050018 with 7.x+) for the u64.
| 0x3F || 0x1 || || || Unused
 
|-
The bool flag indicates whether to enable the device (true = enable, false = disable). When false, this will use [[#DisableJoyPollingReceiveMode]] if needed.
| 0x40 || 0x1 || 0x17 || Low || Mini Cycle 16 LED Intensity.
 
|-
== GetExternalDeviceId ==
| 0x41 || 0x1 || 0x19 || High || Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
Takes an input [[#BusHandle]], returns an output u32 ExternalDeviceId.
|-
 
| 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.)
== SendCommandAsync ==
|-
Takes a type-0x21 input buffer and a [[#BusHandle]], no output.
| 0x43 || 0x1 || || || Unused
 
|-
== GetSendCommandAsynceResult ==
| 0x44 || 0x1 || 0x1A || High || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
Takes a type-0x22 output buffer and a [[#BusHandle]], returns an output u32.
|-
| 0x45 || 0x1 || 0x1A || Low || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
|-
| 0x46 || 0x1 || || || Padding
|-
| 0x47 || 0x1 || || || Padding
|-
|}


Official sw copies the u32 to an output u64, for the actual output size.
This is "nn::hid::system::NotificationLedPattern".


== SetEventForSendCommandAsycResult ==
This is a 0x48-byte struct.
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]].
The above descriptions in the table are based on the info from [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md here].


== GetSharedMemoryHandle ==
argdata in the subcommand is initialized as follows: <code>((u8*)cmd_argdata)[pos] = u8_in[pos2] | u8_in[pos3]<<4;</code> 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.
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 [[#SetStatusManagerType|[6.0.0+]]]) entries, with entry-count {max [[#GetBusHandle|BusHandles]]}.
 
sdknso only uses the first 0x10-bytes of these entries, the rest is the ignored. Entry structure:


The layout of cmd_argdata is as follows:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
! Offset || Size || Description
|-
|-
| 0x0 || 0x1 || Bool flag
| 0x0 || 0x1B || See above.
|-
|-
| 0x1 || 0x3 || Padding
| 0x1B || 0xB || Cleared to zero.
|-
|-
| 0x4 || 0x4 || Result
| 0x26 || 0x5 || Unused
|-
|-
| 0x8 || 0x1 || DeviceEnabled. Bool flag indicating whether a device is [[#EnableExternalDevice|enabled]].
| 0x2B || 0x8 || Set to an input value, which is hard-coded 0.
|-
|-
| 0x9 || 0x1 || IsValid. Bool flag indicating whether this entry is valid.
| 0x33 || 0x2 || Set to value 0.
|-
|-
| 0xA || 0x1 || PollingEnabled. Bool flag indicating whether polling is [[#EnableJoyPollingReceiveMode|enabled]].
| 0x35 || 0x1 || Set to value 1.
|-
| 0xB || 0x1 || Unknown / padding?
|-
| 0xC || 0x4 || [[#JoyPollingMode]]
|}
|}


== EnableJoyPollingReceiveMode ==
= DeviceType =
Takes a type-0x21 input buffer, a TransferMemory handle, an u32 tmem_size, an u32 [[#JoyPollingMode]], a [[#BusHandle]], no output.
This is "nn::hid::system::DeviceType".


The TransferMemory is created with an user-specified output buffer, with permissions=R--.
{| class="wikitable" border="1"
 
!  Bits
The content of the TransferMemory depends of the [[#JoyPollingMode]]. This is used by GetJoyPollingReceivedData. Structure of the TransferMemory (DisableSixAxisPollingDataAccessor, EnableSixAxisPollingDataAccessor, JoyButtonOnlyPollingDataAccessor):
!  Description
 
|-
{| class="wikitable" border="1"
| 0
| FullKey
|-
|-
! Offset || Size || Description
| 1
| DebugPad
|-
|-
| 0x0 || 0x4 || Result.
| 2
| HandheldLeft
|-
|-
| 0x0 || 0x4 || Padding.
| 3
| HandheldRight
|-
|-
| 0x8 || 0x18 || Initialized sysmodule-side, not used by sdknso.
| 4
| JoyLeft
|-
|-
| 0x20 || 0x8 || Latest entry.
| 5
| JoyRight
|-
|-
| 0x28 || 0x8 || Total entries.
| 6
|}
| Palma
 
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:
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 7
| LarkHvcLeft
|-
|-
| 0x0 || 0x26 || Data
| 8
| LarkHvcRight
|-
|-
| 0x26 || 0x1 || Size of data.
| 9
| LarkNesLeft
|-
|-
| 0x27 || 0x1 || Padding
| 10
| LarkNesRight
|-
|-
| 0x28 || 0x8 || Timestamp
| 11
|}
| HandheldLarkHvcLeft
 
JoyEnableSixAxisPollingDataAccessor:
 
{| class="wikitable" border="1"
|-
|-
! Offset || Size || Description
| 12
| HandheldLarkHvcRight
|-
|-
| 0x0 || 0x8 || Data
| 13
|-
| HandheldLarkNesLeft
| 0x8 || 0x1 || Size of data.
|-
|-
| 14
| 0x9 || 0x7 || Padding
| HandheldLarkNesRight
|-
|-
| 0x10 || 0x8 || Timestamp
| 15
|}
| Lucia
 
|-
JoyButtonOnlyPollingDataAccessor:
| 16-30
 
| Reserved
{| class="wikitable" border="1"
|-
|-
| 31
! Offset || Size || Description
| System
|-
|}
| 0x0 || 0x2C || Data
 
|-
= UniquePadType =
| 0x2C || 0x1 || Size of data.
This is "nn::hid::system::UniquePadType".
|-
 
| 0x2D || 0x3 || Padding
{| class="wikitable" border="1"
|-
!  Value
| 0x30 || 0x8 || Timestamp
!  Description
|-
| 0x0 || Other
|-
| 0x1 || FullKey
|-
| 0x2 || JoyRight
|-
| 0x3 || JoyLeft
|-
| 0x4 || DebugPad
|}
 
= IrCameraHandle =
This is an u32.
 
= PackedMomentProcessorConfig =
This is a 0x20-byte struct. This is converted from another structure by the official user-process.
 
{| class="wikitable" border="1"
|-
! 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 ||
|}
|}


== DisableJoyPollingReceiveMode ==
= BusHandle =
Takes an input [[#BusHandle]], no output.
 
== SetStatusManagerType ==
Takes an input u32, no output.
 
This is used by sdknso immediately after mapping [[#GetSharedMemoryHandle|sharedmem]] (before [[#Initialize]]) with hard-coded value 0x2.
 
== BusHandle ==
This is "nn::hidbus::BusHandle". This is 0x8-bytes.
This is "nn::hidbus::BusHandle". This is 0x8-bytes.


Line 2,386: Line 2,386:
|}
|}


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


Line 2,402: Line 2,402:
|}
|}


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


Line 2,416: Line 2,416:
|}
|}


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


Line 2,430: Line 2,430:
|}
|}


== ExternalDevices ==
= ExternalDevices =
The following devices are used via hidbus:
The following devices are used via hidbus:
* [[Ring-Con]]
* [[Ring-Con]]
Retrieved from "https://switchbrew.org/wiki/HID_services"