HID services: Difference between revisions

| 405 || [4.0.0+] GetNpadInterfaceType

Takes an u32 [[#NpadStyleTag]].

Returns an u32 [[#NpadStyleTag]].

Takes an input u32, an u64 [[AM_services|AppletResourceUserId]], and an u64. Returns an output event handle, autoclear for this is user-specified.

Takes a total of 0x10-bytes of input and a PID, returns an output u8 bool.

| NES controller.

| NES controller in handheld mode.

|  

|

|

| 60 || DeactivateJoyXpad

| 225 || [5.0.0+] GetUniquePadDriverState

| 226 || [5.0.0+] GetSixAxisSensorDriverStates

| 230 || [6.0.0+] WriteSerialFlash

| 234 || [6.0.0+] GetUniquePadDeviceTypeSetInternal

| 301 || [5.0.0+] [[#GetAbstractedPadHandles]]

| 302 || [5.0.0+] [[#GetAbstractedPadState]]

| 303 || [5.0.0+] [[#GetAbstractedPadsState]]

| 321 || [5.0.0+] [[#SetAutoPilotVirtualPadState]]

| 322 || [5.0.0+] [[#UnsetAutoPilotVirtualPadState]]

| 323 || [5.0.0+] [[#UnsetAllAutoPilotVirtualPadState]]

| 324 || [7.0.0+] [[#AttachHdlsWorkBuffer]]

| 325 || [7.0.0+] [[#ReleaseHdlsWorkBuffer]]

| 326 || [7.0.0+] [[#DumpHdlsNpadAssignmentState]]

| 327 || [7.0.0+] [[#DumpHdlsStates]]

| 328 || [7.0.0+] [[#ApplyHdlsNpadAssignmentState]]

This is a 0x208-byte struct. This seems to be an array, structure unknown.

| 0x0 || 0x98 || ?

|}

 

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

 

! 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

|}

 

 

{| class="wikitable" border="1"

! Offset || Size || Description

| 0x0 || 0x4 || Only one bit can be set, see below.

| 0x4 || 0x4 || RGBA Single Body Color

| 0x8 || 0x4 || RGBA Single Buttons Color

| 0xC || 0x1 || 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 Joy-Con Left/Right: with value 0x2 the system doesn't list the controller in hid sharedmem. Type bit21: value 0x3 = unknown.

This is a 0x10-byte struct.

 

| 0-7

|  

| BIT(N*4+0) = Pro-Controller, BIT(N*4+1) = Joy-Con Left, BIT(N*4+2) = Joy-Con Right, BIT(N*4+3) = invalid. Where N is 0-1.

| 8-10

|  

| Pro-Controller

| 11

|  

| Famicom-Controller

| 12

|  

| Famicom-Controller II with microphone

| 13

|  

| NES-Controller ([[#DeviceType]]=0x200)

| 14

|  

| NES-Controller ([[#DeviceType]]=0x400)

| 15-16

|  

| Invalid

| 17

|  

| Unknown ([[#DeviceType]]=0x8000)

| 18-20

|  

| Invalid

| 21-23

|  

| Unknown ([[#DeviceType]]=0x80000000)

== HdlsState ==

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

 

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

! Cmd || Name

| 31 || SendKeyboardLockKeyEvent

| 101 || AcquireHomeButtonEventHandle

| 111 || ActivateHomeButton

| 121 || AcquireSleepButtonEventHandle

| 131 || ActivateSleepButton

| 141 || AcquireCaptureButtonEventHandle

| 151 || ActivateCaptureButton

| 161 || [7.0.0+] GetPlatformConfig

| 210 || AcquireNfcDeviceUpdateEventHandle

| 211 || GetNpadsWithNfc

| 212 || AcquireNfcActivateEventHandle

| 213 || ActivateNfc

| 214 || [4.0.0+] GetXcdHandleForNpadWithNfc

| 215 || [4.0.0+] IsNfcActivated

| 230 || AcquireIrSensorEventHandle

| 231 || ActivateIrSensor

| 301 || ActivateNpadSystem

| 303 || ApplyNpadSystemCommonPolicy

| 304 || EnableAssigningSingleOnSlSrPress

| 305 || DisableAssigningSingleOnSlSrPress

| 306 || GetLastActiveNpad

| 307 || GetNpadSystemExtStyle

| 308 || [5.0.0+] ApplyNpadSystemCommonPolicyFull

| 309 || [5.0.0+] GetNpadFullKeyGripColor

| 310 || [6.0.0+] GetMaskedSupportedNpadStyleSet

| 311 || SetNpadPlayerLedBlinkingDevice

| 312 || [6.0.0+] SetSupportedNpadStyleSetAll

| 321 || [3.0.0+] [[#GetUniquePadsFromNpad]]

| 322 || GetIrSensorState

| 323 || GetXcdHandleForNpadWithIrSensor

| 500 || SetAppletResourceUserId

| 501 || RegisterAppletResourceUserId

| 502 || UnregisterAppletResourceUserId

| 503 || EnableAppletToGetInput

| 504 || SetAruidValidForVibration

| 505 || EnableAppletToGetSixAxisSensor

| 510 || [[#SetVibrationMasterVolume]]

| 511 || GetVibrationMasterVolume

| 512 || [3.0.0+] BeginPermitVibrationSession

| 513 || [3.0.0+] EndPermitVibrationSession

| 520 || EnableHandheldHids

| 521 || DisableHandheldHids

| 540 || AcquirePlayReportControllerUsageUpdateEvent

| 541 || GetPlayReportControllerUsages

| 542 || AcquirePlayReportRegisteredDeviceUpdateEvent

| 543 || GetRegisteredDevicesOld ([1.0.0-4.1.0] GetRegisteredDevices)

| 544 || [3.0.0+] AcquireConnectionTriggerTimeoutEvent

| 545 || [3.0.0+] SendConnectionTrigger

| 546 || [3.0.0+] AcquireDeviceRegisteredEventForControllerSupport

| 547 || [3.0.0+] GetAllowedBluetoothLinksCount

| 548 || [5.0.0+] GetRegisteredDevices

| 549 || [6.0.0+] GetConnectableRegisteredDevices

| 700 || ActivateUniquePad

| 702 || AcquireUniquePadConnectionEventHandle

| 703 || [[#GetUniquePadIds]]

| 751 || AcquireJoyDetachOnBluetoothOffEventHandle

| 800 || ListSixAxisSensorHandles

| 801 || IsSixAxisSensorUserCalibrationSupported

| 802 || ResetSixAxisSensorCalibrationValues

| 803 || StartSixAxisSensorUserCalibration

| 804 || CancelSixAxisSensorUserCalibration

| 805 || [3.0.0+] GetUniquePadBluetoothAddress

| 806 || [3.0.0+] DisconnectUniquePad

| 807 || [5.0.0+] GetUniquePadType

| 808 || [5.0.0+] GetUniquePadInterface

| 809 || [5.0.0+] GetUniquePadSerialNumber

| 810 || [5.0.0+] GetUniquePadControllerNumber

| 811 || [5.0.0+] GetSixAxisSensorUserCalibrationStage

| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle

| 821 || StartAnalogStickManualCalibration

| 822 || RetryCurrentAnalogStickManualCalibrationStage

| 823 || CancelAnalogStickManualCalibration

| 824 || ResetAnalogStickManualCalibration

| 825 || [5.0.0+] GetAnalogStickState

| 826 || [5.0.0+] GetAnalogStickManualCalibrationStage

| 827 || [5.0.0+] IsAnalogStickButtonPressed

| 828 || [5.0.0+] IsAnalogStickInReleasePosition

| 829 || [5.0.0+] IsAnalogStickInCircumference

| 830 || [7.0.0+] [[#SetNotificationLedPattern]]

| 850 || [3.0.0+] IsUsbFullKeyControllerEnabled

| 851 || [3.0.0+] EnableUsbFullKeyController

| 852 || [3.0.0+] IsUsbConnected

| 870 || [5.1.0+] IsHandheldButtonPressedOnConsoleMode

| 900 || ActivateInputDetector

| 901 || [[#NotifyInputDetector]]

| 1000 || [3.0.0+] InitializeFirmwareUpdate

| 1001 || [3.0.0+] GetFirmwareVersion

| 1002 || [3.0.0+] GetAvailableFirmwareVersion

| 1003 || [3.0.0+] IsFirmwareUpdateAvailable

| 1004 || [3.0.0+] CheckFirmwareUpdateRequired

| 1005 || [3.0.0+] StartFirmwareUpdate

| 1006 || [3.0.0+] AbortFirmwareUpdate

| 1007 || [3.0.0+] GetFirmwareUpdateState

| 1008 || [4.0.0+] ActivateAudioControl

| 1009 || [4.0.0+] AcquireAudioControlEventHandle

| 1010 || [4.0.0+] GetAudioControlStates

| 1011 || [4.0.0+] DeactivateAudioControl

| 1050 || [5.0.0+] IsSixAxisSensorAccurateUserCalibrationSupported

| 1051 || [5.0.0+] StartSixAxisSensorAccurateUserCalibration

| 1052 || [5.0.0+] CancelSixAxisSensorAccurateUserCalibration

| 1053 || [5.0.0+] GetSixAxisSensorAccurateUserCalibrationState

| 1100 || [5.0.0+] [[#GetHidbusSystemServiceObject]]

| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled

| 1130 || [6.0.0+] InitializeUsbFirmwareUpdate

| 1131 || [6.0.0+] FinalizeUsbFirmwareUpdate

| 1132 || [6.0.0+] CheckUsbFirmwareUpdateRequired

| 1133 || [6.0.0+] StartUsbFirmwareUpdate

| 1134 || [6.0.0+] GetUsbFirmwareUpdateState

| 1150 || [8.0.0+] SetTouchScreenMagnification

|}

 

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

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

Takes an input u32 bitmask InputSourceId, no output.

 

== SetNotificationLedPattern ==

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

 

 

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

| Pro Controller.

| Joy-Con left controller in handheld mode.

| Joy-Con right controller in handheld mode.

| Joy-Con left controller in single mode.

| Joy-Con right controller in single mode.

|  

| Famicom controller.

|  

| Famicom controller II with microphone.

|  

| NES controller.

|  

| NES controller (same as above?).

| Unknown

|  

| Unknown controller type.

| Unknown

|  

| Unknown controller type (similar to bit15?).

Used for USB HID devices.  

| 0 || || Takes an input s32, no output.

| 1 || || Takes an input s32, no output.

| 2 || || Takes an input u32, returns an [[#ICtrlSession]].

| 3 || || Takes an input u32, returns an [[#IReadSession]].

| [1.0.0-2.3.0] 4 || || Takes an input u32, returns an [[#IWriteSession]].

| 0 || ||  

| 1 || ||  

| 2 || ||  

| 3 || ||  

| 4 || ||  

| 5 || ||  

| 6 || ||  

| 7 || ||  

| 8 || ||  

| 9 || ||  

| 10 || ||  

| 11 || ||  

| 12 || [3.0.0+] ||  

| 0 || ||  

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

| 0 ||  

| 1 ||  

| 2 ||  

| 3 ||  

| 4 ||

| 5 || [6.0.0+]

* '''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.