4,562
edits
Changes
Jump to navigation
Jump to search
Line 130:
Line 130: − + + + + + Line 154:
Line 158: − + + + − + − + − + − + − + − + − + − + − + − + − + − + − + Line 206:
Line 212: − + + + + + + + + + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + Line 305:
Line 319: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 384:
Line 427: − + + + + + Line 465:
Line 512: − + − + − + − + − + Line 479:
Line 526: − + + + + + + + + + + + + + + + + + Line 485:
Line 548: − + − + − + − + − + − + Line 507:
Line 570: − + Line 513:
Line 576: − + Line 519:
Line 582: − + Line 534:
Line 597: + + Line 546:
Line 611: + + + + + + + + + + + + + + + + + + Line 552:
Line 635: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 574:
Line 811: + + Line 613:
Line 852: − + Line 635:
Line 874: − + − + Line 651:
Line 890: − + − + − + − + Line 667:
Line 906: − + Line 681:
Line 920: − + − + Line 694:
Line 933: + + Line 713:
Line 954: − + + + − + − + − + Line 725:
Line 968: − + − + − + − + − + − + − + − + Line 757:
Line 1,000: − + Line 770:
Line 1,013: + + + + + + + + + + + + Line 779:
Line 1,034: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 823:
Line 1,283: − + − + − + − + − + Line 959:
Line 1,419: − + Line 992:
Line 1,452: + + Line 1,007:
Line 1,469: + + + + Line 1,036:
Line 1,502: + + Line 1,056:
Line 1,524: + + Line 1,083:
Line 1,553: + + + + + + Line 1,115:
Line 1,591: − + Line 1,125:
Line 1,601: − + + − Starting with [[3.0.0]] HID-sysmodule now contains strings for data stored in title [[Title_list|0100000000000822]].+ + + + + + + + + + + + +
→HdlsState
| 133 || [5.0.0+] SetNpadJoyAssignmentModeSingleWithDestination
| 133 || [5.0.0+] SetNpadJoyAssignmentModeSingleWithDestination
|-
|-
| 134 || [6.1.0+]
| 134 || [6.1.0+] SetNpadAnalogStickUseCenterClamp
|-
| 135 || [8.0.0+] SetNpadCaptureButtonAssignment
|-
| 136 || [8.0.0+] ClearNpadCaptureButtonAssignment
|-
|-
| 200 || [[#GetVibrationDeviceInfo]]
| 200 || [[#GetVibrationDeviceInfo]]
| 210 || [4.0.0+] EndPermitVibrationSession
| 210 || [4.0.0+] EndPermitVibrationSession
|-
|-
| 300 || ActivateConsoleSixAxisSensor
| 211 || [7.0.0+] [[#IsVibrationDeviceMounted]]
|-
| 300 || [3.0.0+] ActivateConsoleSixAxisSensor
|-
|-
| 301 || StartConsoleSixAxisSensor
| 301 || [3.0.0+] StartConsoleSixAxisSensor
|-
|-
| 302 || StopConsoleSixAxisSensor
| 302 || [3.0.0+] StopConsoleSixAxisSensor
|-
|-
| 303 || [5.0.0+] ActivateSevenSixAxisSensor
| 303 || [5.0.0+] [[#ActivateSevenSixAxisSensor]]
|-
|-
| 304 || [5.0.0+] StartSevenSixAxisSensor
| 304 || [5.0.0+] [[#StartSevenSixAxisSensor]]
|-
|-
| 305 || [5.0.0+] StopSevenSixAxisSensor
| 305 || [5.0.0+] [[#StopSevenSixAxisSensor]]
|-
|-
| 306 || [5.0.0+] InitializeSevenSixAxisSensor
| 306 || [5.0.0+] [[#InitializeSevenSixAxisSensor]]
|-
|-
| 307 || [5.0.0+] FinalizeSevenSixAxisSensor
| 307 || [5.0.0+] [[#FinalizeSevenSixAxisSensor]]
|-
|-
| 308 || [5.0.0+] SetSevenSixAxisSensorFusionStrength
| 308 || [5.0.0+] [[#SetSevenSixAxisSensorFusionStrength]]
|-
|-
| 309 || [5.0.0+] GetSevenSixAxisSensorFusionStrength
| 309 || [5.0.0+] [[#GetSevenSixAxisSensorFusionStrength]]
|-
|-
| 310 || [6.0.0+] ResetSevenSixAxisSensorTimestamp
| 310 || [6.0.0+] [[#ResetSevenSixAxisSensorTimestamp]]
|-
|-
| 400 || IsUsbFullKeyControllerEnabled
| 400 || [3.0.0+] IsUsbFullKeyControllerEnabled
|-
|-
| 401 || EnableUsbFullKeyController
| 401 || [3.0.0+] EnableUsbFullKeyController
|-
|-
| 402 || IsUsbFullKeyControllerConnected
| 402 || [3.0.0+] IsUsbFullKeyControllerConnected
|-
|-
| 403 || [4.0.0+] HasBattery
| 403 || [4.0.0+] HasBattery
| 507 || [5.0.0+] EnablePalmaStep
| 507 || [5.0.0+] EnablePalmaStep
|-
|-
| 508 || [6.0.0+] ResetPalmaStep ([5.0.0-6.0.0] SuspendPalmaStep)
| 508 || [5.0.0+] ResetPalmaStep
|-
| 509 || [5.0.0+] ReadPalmaApplicationSection
|-
| 510 || [5.0.0+] WritePalmaApplicationSection
|-
| 511 || [5.0.0+] ReadPalmaUniqueCode
|-
| 512 || [5.0.0+] SetPalmaUniqueCodeInvalid
|-
|-
| 509 || [6.0.0+] ReadPalmaApplicationSection ([5.0.0-6.0.0] ResetPalmaStep)
| 513 || [5.0.0+] WritePalmaActivityEntry
|-
|-
| 510 || [6.0.0+] WritePalmaApplicationSection ([5.0.0-6.0.0] ReadPalmaApplicationSection)
| 514 || [5.0.0+] WritePalmaRgbLedPatternEntry
|-
|-
| 511 || [6.0.0+] ReadPalmaUniqueCode ([5.0.0-6.0.0] WritePalmaApplicationSection)
| 515 || [5.0.0+] WritePalmaWaveEntry
|-
|-
| 512 || [6.0.0+] SetPalmaUniqueCodeInvalid ([5.0.0-6.0.0] ReadPalmaUniqueCode)
| 516 || [5.0.0+] SetPalmaDataBaseIdentificationVersion
|-
|-
| 513 || [6.0.0+] WritePalmaActivityEntry ([5.0.0-6.0.0] SetPalmaUniqueCodeInvalid)
| 517 || [5.0.0+] GetPalmaDataBaseIdentificationVersion
|-
|-
| 514 || [6.0.0+] WritePalmaRgbLedPatternEntry
| 518 || [5.0.0+] SuspendPalmaFeature
|-
|-
| 515 || [6.0.0+] WritePalmaWaveEntry
| 519 || [5.1.0+] GetPalmaOperationResult
|-
|-
| 516 || [6.0.0+] SetPalmaDataBaseIdentificationVersion
| 520 || [5.1.0+] ReadPalmaPlayLog
|-
|-
| 517 || [6.0.0+] GetPalmaDataBaseIdentificationVersion
| 521 || [5.1.0+] ResetPalmaPlayLog
|-
|-
| 518 || [6.0.0+] SuspendPalmaFeature
| 522 || [5.1.0+] SetIsPalmaAllConnectable
|-
|-
| 519 || [6.0.0+] GetPalmaOperationResult
| 523 || [5.1.0+] SetIsPalmaPairedConnectable
|-
|-
| 520 || [6.0.0+] ReadPalmaPlayLog ([5.1.0-6.0.0] WritePalmaActivityEntry)
| 524 || [5.1.0+] PairPalma
|-
|-
| 521 || [6.0.0+] ResetPalmaPlayLog ([5.1.0-6.0.0] WritePalmaRgbLedPatternEntry)
| 525 || [5.1.0+] SetPalmaBoostMode
|-
|-
| 522 || [6.0.0+] SetIsPalmaAllConnectable
| 526 || [7.0.0+] CancelWritePalmaWaveEntry
|-
|-
| 523 || [6.0.0+] SetIsPalmaPairedConnectable
| 527 || [8.0.0+] EnablePalmaBoostMode
|-
|-
| 524 || [6.0.0+] PairPalma
| 528 || [8.0.0+] GetPalmaBluetoothAddress
|-
|-
| 525 || [6.0.0+] SetPalmaBoostMode
| 529 || [8.0.0+] SetDisallowedPalmaConnection
|-
|-
| 1000 || SetNpadCommunicationMode
| 1000 || SetNpadCommunicationMode
Official sw uses the same entry-count for each array.
Official sw uses the same entry-count for each array.
== IsVibrationDeviceMounted ==
Takes a total of 0x10-bytes of input and a PID, returns an output u8 bool.
== ActivateSevenSixAxisSensor ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], no output.
== StartSevenSixAxisSensor ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], no output.
== StopSevenSixAxisSensor ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], no output.
== InitializeSevenSixAxisSensor ==
Takes a PID, an u64 [[AM_services|AppletResourceUserId]], two u64s for the size of each TransferMemory, and two TransferMemory handles. No output.
The size of the first TransferMemory is 0x1000 with MemoryPermission=read-only, while the second one has size 0x7F000 with MemoryPermission=none.
== FinalizeSevenSixAxisSensor ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], no output.
== SetSevenSixAxisSensorFusionStrength ==
Takes a PID, a float, and an u64 [[AM_services|AppletResourceUserId]], no output.
== GetSevenSixAxisSensorFusionStrength ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], returns an output float.
== ResetSevenSixAxisSensorTimestamp ==
Takes a PID and an u64 [[AM_services|AppletResourceUserId]], no output.
== VibrationDeviceHandle ==
== VibrationDeviceHandle ==
| NES controller in handheld mode.
| NES controller in handheld mode.
|-
|-
| 9-28
| 9
| NpadLucia
|
|-
| 10-28
| Reserved
| Reserved
|
|
| 132 || UnsetCaptureButtonAutoPilotState
| 132 || UnsetCaptureButtonAutoPilotState
|-
|-
| 133 || SetShiftAccelerometerCalibrationValue
| 133 || [3.0.0+] SetShiftAccelerometerCalibrationValue
|-
|-
| 134 || GetShiftAccelerometerCalibrationValue
| 134 || [3.0.0+] GetShiftAccelerometerCalibrationValue
|-
|-
| 135 || SetShiftGyroscopeCalibrationValue
| 135 || [3.0.0+] SetShiftGyroscopeCalibrationValue
|-
|-
| 136 || GetShiftGyroscopeCalibrationValue
| 136 || [3.0.0+] GetShiftGyroscopeCalibrationValue
|-
|-
| 140 || DeactivateConsoleSixAxisSensor
| 140 || [3.0.0+] DeactivateConsoleSixAxisSensor
|-
|-
| 141 || [5.0.0+] GetConsoleSixAxisSensorSamplingFrequency
| 141 || [5.0.0+] GetConsoleSixAxisSensorSamplingFrequency
| 142 || [5.0.0+] DeactivateSevenSixAxisSensor
| 142 || [5.0.0+] DeactivateSevenSixAxisSensor
|-
|-
| 143 || [6.0.0+] GetConsoleSixAxisSensorCountStates
| 143 || [5.0.0+] GetConsoleSixAxisSensorCountStates
|-
| 144 || [8.0.0+] GetAccelerometerFsr
|-
| 145 || [8.0.0+] SetAccelerometerFsr
|-
| 146 || [8.0.0+] GetAccelerometerOdr
|-
| 147 || [8.0.0+] SetAccelerometerOdr
|-
| 148 || [8.0.0+] GetGyroscopeFsr
|-
| 149 || [8.0.0+] SetGyroscopeFsr
|-
| 150 || [8.0.0+] GetGyroscopeOdr
|-
| 151 || [8.0.0+] SetGyroscopeOdr
|-
|-
| 201 || ActivateFirmwareUpdate
| 201 || ActivateFirmwareUpdate
| 202 || DeactivateFirmwareUpdate
| 202 || DeactivateFirmwareUpdate
|-
|-
| 203 || StartFirmwareUpdate
| 203 || [[#StartFirmwareUpdate]]
|-
|-
| 204 || GetFirmwareUpdateStage
| 204 || GetFirmwareUpdateStage
|-
|-
| 205 || GetFirmwareVersion
| 205 || [[#GetFirmwareVersion]]
|-
|-
| 206 || GetDestinationFirmwareVersion
| 206 || [[#GetDestinationFirmwareVersion]]
|-
|-
| 207 || DiscardFirmwareInfoCacheForRevert
| 207 || [[#DiscardFirmwareInfoCacheForRevert]]
|-
|-
| 208 || StartFirmwareUpdateForRevert
| 208 || [3.0.0+] StartFirmwareUpdateForRevert
|-
|-
| 209 || GetAvailableFirmwareVersionForRevert
| 209 || [3.0.0+] GetAvailableFirmwareVersionForRevert
|-
|-
| 210 || [4.0.0+] IsFirmwareUpdatingDevice
| 210 || [4.0.0+] IsFirmwareUpdatingDevice
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
|-
|-
| 221 || UpdateControllerColor
| 221 || [3.0.0+] [[#UpdateControllerColor]]
|-
|-
| 222 || [4.0.0+] ConnectUsbPadsAsync
| 222 || [4.0.0+] ConnectUsbPadsAsync
| 223 || [4.0.0+] DisconnectUsbPadsAsync
| 223 || [4.0.0+] DisconnectUsbPadsAsync
|-
|-
| 224 || [5.0.0+] UpdateDesignInfo
| 224 || [5.0.0+] [[#UpdateDesignInfo]]
|-
|-
| 225 || [5.0.0+] GetUniquePadDriverState
| 225 || [5.0.0+] GetUniquePadDriverState
| 226 || [5.0.0+] GetSixAxisSensorDriverStates
| 226 || [5.0.0+] GetSixAxisSensorDriverStates
|-
|-
| 227 || [6.0.0+] GetRxPacketHistory
| 227 || [5.0.0+] GetRxPacketHistory
|-
|-
| 228 || [6.0.0+] AcquireOperationEventHandle
| 228 || [6.0.0+] AcquireOperationEventHandle
|-
|-
| 234 || [6.0.0+] GetUniquePadDeviceTypeSetInternal
| 234 || [6.0.0+] GetUniquePadDeviceTypeSetInternal
|-
| 235 || [7.0.0+] EnableAnalogStickPower
|-
|-
| 301 || [5.0.0+] GetAbstractedPadHandles
| 301 || [5.0.0+] GetAbstractedPadHandles
|-
|-
| 323 || [5.0.0+] UnsetAllAutoPilotVirtualPadState
| 323 || [5.0.0+] UnsetAllAutoPilotVirtualPadState
|-
| 324 || [7.0.0+] [[#AttachHdlsWorkBuffer]]
|-
| 325 || [7.0.0+] [[#ReleaseHdlsWorkBuffer]]
|-
| 326 || [7.0.0+] [[#DumpHdlsNpadAssignmentState]]
|-
| 327 || [7.0.0+] [[#DumpHdlsStates]]
|-
| 328 || [7.0.0+] [[#ApplyHdlsNpadAssignmentState]]
|-
| 329 || [7.0.0+] [[#ApplyHdlsStateList]]
|-
| 330 || [7.0.0+] [[#AttachHdlsVirtualDevice]]
|-
| 331 || [7.0.0+] [[#DetachHdlsVirtualDevice]]
|-
| 332 || [7.0.0+] [[#SetHdlsState]]
|-
|-
| 350 || [5.0.0+] AddRegisteredDevice
| 350 || [5.0.0+] AddRegisteredDevice
|-
|-
| 401 || [6.0.0+] DisableRailDeviceFiltering
| 401 || [6.0.0+] DisableRailDeviceFiltering
|-
| 500 || [8.0.0+] SetFactoryInt
|-
| 501 || [8.0.0+] IsFactoryBootEnabled
|}
|}
== StartFirmwareUpdate ==
Takes a total of 0x20-bytes of input, 2 handles, and returns an output handle.
[3.0.0+] Now takes a total of 8-bytes of input, and no longer uses any input/output handles.
== GetFirmwareVersion ==
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
[3.0.0+] Now returns an additional 0xC-bytes of output.
== GetDestinationFirmwareVersion ==
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
[3.0.0+] Now returns an additional 0xC-bytes of output.
== DiscardFirmwareInfoCacheForRevert ==
Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.
[3.0.0+] No input/output.
== UpdateControllerColor ==
Takes two input u32s for the colors, an input u64 '''UniquePadId''', and no output.
A state flag must be clear, otherwise an error is thrown. Afterwards, this flag is set.
Sends the spi-write subcommand to the specified controller, for writing the [[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.
== UpdateDesignInfo ==
Takes 4 input u32s for the colors, an input u8, an input u64 '''UniquePadId''', and no output.
A state flag must be clear (same as [[#UpdateControllerColor]]), otherwise an error is thrown. Afterwards, this flag is set.
Sends the spi-write subcommand to the specified controller, for writing to offset 0x6050 size 0xD. The first 3-bytes from each u32 is used for the spi-write-data, with the u8 being copied immediately afterwards the color data.
== AttachHdlsWorkBuffer ==
Takes an input TransferMemory handle and an u64 for the TransferMemory size, no output.
Official user-processes use TransferMemory size=0x1000 and permissions=RW.
This TransferMemory is used as input/output by the other Hdls commands.
Hdls is for virtual HID controllers.
== ReleaseHdlsWorkBuffer ==
No input/output.
== DumpHdlsNpadAssignmentState ==
No input/output.
After using this cmd, the output [[#HdlsNpadAssignment]] is located at tmem+0.
== DumpHdlsStates ==
No input/output.
After using this cmd, the output [[#HdlsStateList]] struct is located at tmem+0.
== ApplyHdlsNpadAssignmentState ==
Takes an input u8 bool, no output.
Prior to using this cmd, the input [[#HdlsNpadAssignment]] is written to tmem+0 by the user-process.
== ApplyHdlsStateList ==
No input/output.
Prior to using this cmd, the input [[#HdlsStateList]] is written to tmem+0 by the user-process.
The [[#HdlsState]] will be applied for each HdlsHandle. If a HdlsHandle is not found, code similar to [[#AttachHdlsVirtualDevice]] will run with the [[#HdlsDeviceInfo]], then it will continue with applying state with the new device.
== AttachHdlsVirtualDevice ==
Takes an [[#HdlsDeviceInfo]], returns a 8-byte '''HdlsHandle'''.
== DetachHdlsVirtualDevice ==
Takes an input 8-byte '''HdlsHandle''', no output.
== SetHdlsState ==
Takes an input [[#HdlsState]] and an input 8-byte '''HdlsHandle''', no output.
== HdlsNpadAssignment ==
This is a 0x208-byte struct. This seems to be an array, structure unknown.
== HdlsStateList ==
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || Total entries
|-
| 0x4 || 0x4 || Padding
|-
| 0x8 || 0x400(0x40*0x10) || Array of [[#HdlsStateListEntry]].
|}
This is a 0x408-byte struct.
This contains a list of all controllers, including non-virtual controllers.
=== HdlsStateListEntry ===
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x8 || HdlsHandle
|-
| 0x8 || 0x10 || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
|-
| 0x18 || 0x24 || [[#HdlsState]]
|-
| 0x3C || 0x4 || Padding
|}
This is a 0x40-byte struct.
== HdlsDeviceInfo ==
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || [[#NpadStyleTag]], only one bit can be set.
|-
| 0x4 || 0x4 || RGBA Single Body Color
|-
| 0x8 || 0x4 || RGBA Single Buttons Color
|-
| 0xC || 0x1 || Unknown
|-
| 0xD || 0x3 || Padding
|}
This is a 0x10-byte struct.
== HdlsState ==
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x8 || Unknown
|-
| 0x8 || 0x4 || batteryCharge for the main [[HID_Shared_Memory#Controllers|PowerInfo]].
|-
| 0xC || 0x4 || 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
|}
This is a 0x24-byte struct.
= hid:sys =
= hid:sys =
|-
|-
| 151 || ActivateCaptureButton
| 151 || ActivateCaptureButton
|-
| 161 || [7.0.0+] GetPlatformConfig
|-
|-
| 210 || AcquireNfcDeviceUpdateEventHandle
| 210 || AcquireNfcDeviceUpdateEventHandle
| 312 || [6.0.0+] SetSupportedNpadStyleSetAll
| 312 || [6.0.0+] SetSupportedNpadStyleSetAll
|-
|-
| 321 || GetUniquePadsFromNpad
| 321 || [3.0.0+] [[#GetUniquePadsFromNpad]]
|-
|-
| 322 || GetIrSensorState
| 322 || GetIrSensorState
| 511 || GetVibrationMasterVolume
| 511 || GetVibrationMasterVolume
|-
|-
| 512 || BeginPermitVibrationSession
| 512 || [3.0.0+] BeginPermitVibrationSession
|-
|-
| 513 || EndPermitVibrationSession
| 513 || [3.0.0+] EndPermitVibrationSession
|-
|-
| 520 || EnableHandheldHids
| 520 || EnableHandheldHids
| 543 || GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)
| 543 || GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)
|-
|-
| 544 || AcquireConnectionTriggerTimeoutEvent
| 544 || [3.0.0+] AcquireConnectionTriggerTimeoutEvent
|-
|-
| 545 || SendConnectionTrigger
| 545 || [3.0.0+] SendConnectionTrigger
|-
|-
| 546 || AcquireDeviceRegisteredEventForControllerSupport
| 546 || [3.0.0+] AcquireDeviceRegisteredEventForControllerSupport
|-
|-
| 547 || GetAllowedBluetoothLinksCount
| 547 || [3.0.0+] GetAllowedBluetoothLinksCount
|-
|-
| 548 || [5.0.0+] GetRegisteredDevices
| 548 || [5.0.0+] GetRegisteredDevices
| 702 || AcquireUniquePadConnectionEventHandle
| 702 || AcquireUniquePadConnectionEventHandle
|-
|-
| 703 || GetUniquePadIds
| 703 || [[#GetUniquePadIds]]
|-
|-
| 751 || AcquireJoyDetachOnBluetoothOffEventHandle
| 751 || AcquireJoyDetachOnBluetoothOffEventHandle
| 804 || CancelSixAxisSensorUserCalibration
| 804 || CancelSixAxisSensorUserCalibration
|-
|-
| 805 || GetUniquePadBluetoothAddress
| 805 || [3.0.0+] GetUniquePadBluetoothAddress
|-
|-
| 806 || DisconnectUniquePad
| 806 || [3.0.0+] DisconnectUniquePad
|-
|-
| 807 || [5.0.0+] GetUniquePadType
| 807 || [5.0.0+] GetUniquePadType
|-
|-
| 811 || [5.0.0+] GetSixAxisSensorUserCalibrationStage
| 811 || [5.0.0+] GetSixAxisSensorUserCalibrationStage
|-
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
|-
|-
| 821 || StartAnalogStickManualCalibration
| 821 || StartAnalogStickManualCalibration
| 829 || [5.0.0+] IsAnalogStickInCircumference
| 829 || [5.0.0+] IsAnalogStickInCircumference
|-
|-
| 850 || IsUsbFullKeyControllerEnabled
| 830 || [7.0.0+] [[#SetNotificationLedPattern]]
|-
| 850 || [3.0.0+] IsUsbFullKeyControllerEnabled
|-
|-
| 851 || EnableUsbFullKeyController
| 851 || [3.0.0+] EnableUsbFullKeyController
|-
|-
| 852 || IsUsbConnected
| 852 || [3.0.0+] IsUsbConnected
|-
|-
| 870 || [6.0.0+] IsHandheldButtonPressedOnConsoleMode
| 870 || [5.1.0+] IsHandheldButtonPressedOnConsoleMode
|-
|-
| 900 || ActivateInputDetector
| 900 || ActivateInputDetector
| 901 || [[#NotifyInputDetector]]
| 901 || [[#NotifyInputDetector]]
|-
|-
| 1000 || InitializeFirmwareUpdate
| 1000 || [3.0.0+] InitializeFirmwareUpdate
|-
|-
| 1001 || GetFirmwareVersion
| 1001 || [3.0.0+] GetFirmwareVersion
|-
|-
| 1002 || GetAvailableFirmwareVersion
| 1002 || [3.0.0+] GetAvailableFirmwareVersion
|-
|-
| 1003 || IsFirmwareUpdateAvailable
| 1003 || [3.0.0+] IsFirmwareUpdateAvailable
|-
|-
| 1004 || CheckFirmwareUpdateRequired
| 1004 || [3.0.0+] CheckFirmwareUpdateRequired
|-
|-
| 1005 || StartFirmwareUpdate
| 1005 || [3.0.0+] StartFirmwareUpdate
|-
|-
| 1006 || AbortFirmwareUpdate
| 1006 || [3.0.0+] AbortFirmwareUpdate
|-
|-
| 1007 || GetFirmwareUpdateState
| 1007 || [3.0.0+] GetFirmwareUpdateState
|-
|-
| 1008 || [4.0.0+] ActivateAudioControl
| 1008 || [4.0.0+] ActivateAudioControl
| 1053 || [5.0.0+] GetSixAxisSensorAccurateUserCalibrationState
| 1053 || [5.0.0+] GetSixAxisSensorAccurateUserCalibrationState
|-
|-
| 1100 || [5.0.0+] GetHidbusSystemServiceObject
| 1100 || [5.0.0+] [[#GetHidbusSystemServiceObject]]
|-
|-
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
|-
|-
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
|-
| 1150 || [8.0.0+] SetTouchScreenMagnification
|}
|}
== GetUniquePadsFromNpad ==
Takes an input u32 [[#NpadIdType]], a type-0xA output buffer, and returns an output u64 for total output entries.
The output buffer contains an array of u64 '''UniquePadId'''.
== SetVibrationMasterVolume ==
== SetVibrationMasterVolume ==
Takes an input 32bit float.
Takes an input 32bit float.
== GetUniquePadIds ==
Takes a type-0xA output buffer, and returns an output u64 for total output entries.
The output buffer contains an array of u64 '''UniquePadId'''.
== NotifyInputDetector ==
== NotifyInputDetector ==
This is the only hid:sys command used by USB-sysmodule (with value 0x40).
This is the only hid:sys command used by USB-sysmodule (with value 0x40).
== SetNotificationLedPattern ==
Takes an input [[#NotificationLedPattern]] and an u64 '''UniquePadId''', no output.
The specified controller must have a HOME button.
This sends subcommand 0x38 to the specified controller, for setting the pattern for the HOME button notification LED. The input structure is converted to the format used by this [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md#subcommand-0x38-set-home-light subcommand].
== GetHidbusSystemServiceObject ==
No input, returns an [[#IHidbusSystemServer]].
== NotificationLedPattern ==
{| class="wikitable" border="1"
|-
! Offset || Size || Subcommand argdata bytepos || Subcommand argdata nibble || Description
|-
| 0x0 || 0x1 || 0x0 || Low || Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF.
|-
| 0x1 || 0x1 || 0x0 || High || Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles.
|-
| 0x2 || 0x1 || 0x1 || Low || Number of Full Cycles. Value 0x1-0xF: 1 - 15 full cycles. Value 0x0 is repeat forever, but if Mini Cycle Base Duration is set to 0x0, it does the 1st Mini Cycle with a 12.5ms base duration and then the LED stays on with LED Start Intensity.
|-
| 0x3 || 0x1 || 0x1 || High || LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
|-
| 0x4 || 0x1 || 0x2 || High || Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
|-
| 0x5 || 0x1 || 0x3 || High || Fading Transition Steps to Mini Cycle 1 (Uses PWM). Value 0x0: Instant. Each step duration is based on Mini Cycle Step Duration Multiplier.
|-
| 0x6 || 0x1 || 0x3 || Low || Final Step Duration Multiplier of Mini Cycle 1. Value is a Multiplier of Mini Cycle Base Duration. Value 0x0: 12.5ms, 0x1 - xF: 1x - 15x.
|-
| 0x7 || 0x1 || || || Unused
|-
| 0x8 || 0x1 || 0x2 || Low || Mini Cycle 2 LED Intensity.
|-
| 0x9 || 0x1 || 0x4 || High || Fading Transition Steps to Mini Cycle 2 (see above).
|-
| 0xA || 0x1 || 0x4 || Low || Final Step Duration Multiplier of Mini Cycle 2 (see above).
|-
| 0xB || 0x1 || || || Unused
|-
| 0xC || 0x1 || 0x5 || High || Mini Cycle 3 LED Intensity.
|-
| 0xD || 0x1 || 0x6 || High || Fading Transition Steps to Mini Cycle 3 (see above).
|-
| 0xE || 0x1 || 0x6 || Low || Final Step Duration Multiplier of Mini Cycle 3 (see above).
|-
| 0xF || 0x1 || || || Unused
|-
| 0x10 || 0x1 || 0x5 || Low || Mini Cycle 4 LED Intensity.
|-
| 0x11 || 0x1 || 0x7 || High || Fading Transition Duration to Mini Cycle 4 (see above).
|-
| 0x12 || 0x1 || 0x7 || Low || Final Step Duration Multiplier of Mini Cycle 4 (see above).
|-
| 0x13 || 0x1 || || || Unused
|-
| 0x14 || 0x1 || 0x8 || High || Mini Cycle 5 LED Intensity.
|-
| 0x15 || 0x1 || 0x9 || High || Fading Transition Steps to Mini Cycle 5 (see above).
|-
| 0x16 || 0x1 || 0x9 || Low || Final Step Duration Multiplier of Mini Cycle 5 (see above).
|-
| 0x17 || 0x1 || || || Unused
|-
| 0x18 || 0x1 || 0x8 || Low || Mini Cycle 6 LED Intensity.
|-
| 0x19 || 0x1 || 0xA || High || Fading Transition Steps to Mini Cycle 6 (see above).
|-
| 0x1A || 0x1 || 0xA || Low || Final Step Duration Multiplier of Mini Cycle 6 (see above).
|-
| 0x1B || 0x1 || || || Unused
|-
| 0x1C || 0x1 || 0xB || High || Mini Cycle 7 LED Intensity.
|-
| 0x1D || 0x1 || 0xC || High || Fading Transition Steps to Mini Cycle 7 (see above).
|-
| 0x1E || 0x1 || 0xC || Low || Final Step Duration Multiplier of Mini Cycle 7 (see above).
|-
| 0x1F || 0x1 || || || Unused
|-
| 0x20 || 0x1 || 0xB || Low || Mini Cycle 8 LED Intensity.
|-
| 0x21 || 0x1 || 0xD || Low || Fading Transition Steps to Mini Cycle 8 (see above).
|-
| 0x22 || 0x1 || 0xD || High || Final Step Duration Multiplier of Mini Cycle 8 (see above).
|-
| 0x23 || 0x1 || || || Unused
|-
| 0x24 || 0x1 || 0xE || High || Mini Cycle 9 LED Intensity.
|-
| 0x25 || 0x1 || 0xF || High || Fading Transition Steps to Mini Cycle 9 (see above).
|-
| 0x26 || 0x1 || 0xF || Low || Final Step Duration Multiplier of Mini Cycle 9 (see above).
|-
| 0x27 || 0x1 || || || Unused
|-
| 0x28 || 0x1 || 0xE || Low || Mini Cycle 10 LED Intensity.
|-
| 0x29 || 0x1 || 0x10 || High || Fading Transition Steps to Mini Cycle 10 (see above).
|-
| 0x2A || 0x1 || 0x10 || Low || Final Step Duration Multiplier of Mini Cycle 10 (see above).
|-
| 0x2B || 0x1 || || || Unused
|-
| 0x2C || 0x1 || 0x11 || High || Mini Cycle 11 LED Intensity.
|-
| 0x2D || 0x1 || 0x12 || High || Fading Transition Steps to Mini Cycle 11 (see above).
|-
| 0x2E || 0x1 || 0x12 || Low || Final Step Duration Multiplier of Mini Cycle 11 (see above).
|-
| 0x2F || 0x1 || || || Unused
|-
| 0x30 || 0x1 || 0x11 || Low || Mini Cycle 12 LED Intensity.
|-
| 0x31 || 0x1 || 0x13 || High || Fading Transition Steps to Mini Cycle 12 (see above).
|-
| 0x32 || 0x1 || 0x13 || Low || Final Step Duration Multiplier of Mini Cycle 12 (see above).
|-
| 0x33 || 0x1 || || || Unused
|-
| 0x34 || 0x1 || 0x14 || High || Mini Cycle 13 LED Intensity.
|-
| 0x35 || 0x1 || 0x15 || High || Fading Transition Steps to Mini Cycle 13 (see above).
|-
| 0x36 || 0x1 || 0x15 || Low || Final Step Duration Multiplier of Mini Cycle 13 (see above).
|-
| 0x37 || 0x1 || || || Unused
|-
| 0x38 || 0x1 || 0x14 || Low || Mini Cycle 14 LED Intensity.
|-
| 0x39 || 0x1 || 0x16 || High || Fading Transition Steps to Mini Cycle 14 (see above).
|-
| 0x3A || 0x1 || 0x16 || Low || Final Step Duration Multiplier of Mini Cycle 14 (see above).
|-
| 0x3B || 0x1 || || || Unused
|-
| 0x3C || 0x1 || 0x17 || High || Mini Cycle 15 LED Intensity.
|-
| 0x3D || 0x1 || 0x18 || High || Fading Transition Steps to Mini Cycle 15 (see above).
|-
| 0x3E || 0x1 || 0x18 || Low || Final Step Duration Multiplier of Mini Cycle 15 (see above).
|-
| 0x3F || 0x1 || || || Unused
|-
| 0x40 || 0x1 || 0x17 || Low || Mini Cycle 16 LED Intensity.
|-
| 0x41 || 0x1 || 0x19 || High || Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
|-
| 0x42 || 0x1 || 0x19 || Low || Final Step Duration Multiplier of Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
|-
| 0x43 || 0x1 || || || Unused
|-
| 0x44 || 0x1 || 0x1A || High || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
|-
| 0x45 || 0x1 || 0x1A || Low || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
|-
| 0x46 || 0x1 || || || Padding
|-
| 0x47 || 0x1 || || || Padding
|-
|}
This is "nn::hid::system::NotificationLedPattern".
This is a 0x48-byte struct.
The above descriptions in the table are based on the info from [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md here].
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.
The layout of cmd_argdata is as follows:
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x1B || See above.
|-
| 0x1B || 0xB || Cleared to zero.
|-
| 0x26 || 0x5 || Unused
|-
| 0x2B || 0x8 || Set to an input value, which is hard-coded 0.
|-
| 0x33 || 0x2 || Set to value 0.
|-
| 0x35 || 0x1 || Set to value 1.
|}
== IHidbusSystemServer ==
This is "nn::hidbus::IHidbusSystemServer".
This was added with [5.0.0+].
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 500 ||
|-
| 501 ||
|-
| 502 ||
|}
= hid:tmp =
= hid:tmp =
This is "nn::hid::IHidTemporaryServer".
This is "nn::hid::IHidTemporaryServer".
This service was added with [3.0.0+], then removed with [8.0.0+].
{| class="wikitable" border="1"
{| class="wikitable" border="1"
| 314 || [3.0.0+] [[#CheckFirmwareVersion]]
| 314 || [3.0.0+] [[#CheckFirmwareVersion]]
|-
|-
| 315 || [5.0.0+] SetFunctionLevel
| 315 || [4.0.0+] SetFunctionLevel
|-
|-
| 316 || [5.0.0+] RunImageTransferExProcessor
| 316 || [4.0.0+] RunImageTransferExProcessor
|-
|-
| 317 || [5.0.0+] RunIrLedProcessor
| 317 || [4.0.0+] RunIrLedProcessor
|-
|-
| 318 || [5.0.0+] StopImageProcessorAsync
| 318 || [4.0.0+] StopImageProcessorAsync
|-
|-
| 319 || [5.0.0+] ActivateIrsensorWithFunctionLevel
| 319 || [4.0.0+] ActivateIrsensorWithFunctionLevel
|}
|}
| 3 || || Takes an input u32, returns an [[#IReadSession]].
| 3 || || Takes an input u32, returns an [[#IReadSession]].
|-
|-
| 4 || || Takes an input u32, returns an [[#IWriteSession]].
| [1.0.0-2.3.0] 4 || || Takes an input u32, returns an [[#IWriteSession]].
|}
|}
|-
|-
| 11 || ||
| 11 || ||
|-
| 12 || [3.0.0+] ||
|}
|}
Cmd0 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.
Cmd0 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+] Cmd0 now takes a total of 8-bytes of input.
== IWriteSession ==
== IWriteSession ==
This is "nn::ahid::IWriteSession".
This is "nn::ahid::IWriteSession".
This was removed with [3.0.0+].
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 4 ||
| 4 ||
|-
| 5 || [6.0.0+]
|}
|}
|-
|-
| 5 || CheckNfcDevicePower
| 5 || CheckNfcDevicePower
|-
| 6 || [5.0.0+]
|-
|-
| 10 || SetNfcEvent
| 10 || SetNfcEvent
| 102 || GetAwakeTriggerReasonForRightRail
| 102 || GetAwakeTriggerReasonForRightRail
|}
|}
[5.0.0+] SetDataFormat, SetMcuState, and ClearMifareKey: now takes a total of 0xC-bytes of input instead of 0x10.
[6.0.0+]: The buffer type used by GetNfcInfo is now 0x32 instead of 0x1A.
= hidbus =
= hidbus =
This is "nn::hidbus::IHidbusServer".
This is "nn::hidbus::IHidbusServer".
This was added with [5.0.0+].
{| class="wikitable" border="1"
{| class="wikitable" border="1"
| 12 || DisableJoyPollingReceiveMode
| 12 || DisableJoyPollingReceiveMode
|-
|-
| 13 || GetPollingData
| [5.0.0-6.2.0] 13 || GetPollingData
|-
|-
| 14 || [6.0.0+] SetStatusManagerType
| 14 || [6.0.0+] SetStatusManagerType
├── NTD_4CD_1801.fts256
├── NTD_4CD_1801.fts256
├── NTD_4CD_2602.fts256
├── NTD_4CD_2602.fts256
└── NTD_4CD_3801.fts256
├── NTD_4CD_3801.fts256
└── NTD_4CD_xxxx.fts256 [7.0.0+]
These are firmware files for the touchscreen controller.
These are firmware files for the touchscreen controller.
= Firmware update =
= Firmware update =
HID-sysmodule mounts the contents of title [[Title_list|0100000000000822]] as "systemData" or the contents of title [[Title_list|010000000000B22B]] as "systemDataD". Both titles contain the same files, but [[Title_list|0100000000000822]] is used on retail units while [[Title_list|010000000000B22B]] is used for development.
These titles contain the following files:
* '''ExpectVersionInfo.csv''' - List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey" or "Palma", "type" can be "BT", "MCU" or "USB" and "version" is the hexadecimal representation of the firmware file's version.
* '''FirmwareInfo.csv''' - List in the format "[device],[type],[version],[file]" where "device", "type" and "version" should match the values from "ExpectVersionInfo" and "file" is the name of the firmware file.
* '''ukyosakyo_ep2_ota.bin''' - Left/Right Joy-Con BT firmware.
* '''raizo_ep2_ota.bin''' - Pro Controller BT firmware.
* '''tera_ota.bin''' - Right Joy-Con MCU firmware.
* '''tera_ota_iap.bin''' - Right Joy-Con MCU (IAP profile) firmware.
* '''tera_fullkey_ota.bin''' - Pro Controller MCU firmware.
* '''tera_fullkey_ota_iap.bin''' - Pro Controller MCU (IAP profile) firmware.
* [6.0.0+] '''ProController.dfu''' - Pro Controller USB firmware.
* [6.1.0+] '''PalmaFw.bin''' - Poké Ball Plus BT firmware.
[[Category:Services]]
[[Category:Services]]