Difference between revisions of "HID services"
Line 1,417: | Line 1,417: | ||
| 0 | | 0 | ||
| FullKey | | FullKey | ||
− | | Pro Controller. | + | | Pro Controller and Gc controller. |
|- | |- | ||
| 1 | | 1 | ||
Line 1,425: | Line 1,425: | ||
| 2 | | 2 | ||
| HandheldLeft | | HandheldLeft | ||
− | | Joy-Con left controller in handheld mode. | + | | Joy-Con/Famicom/NES left controller in handheld mode. |
|- | |- | ||
| 3 | | 3 | ||
| HandheldRight | | HandheldRight | ||
− | | Joy-Con right controller in handheld mode. | + | | Joy-Con/Famicom/NES right controller in handheld mode. |
|- | |- | ||
| 4 | | 4 | ||
| JoyLeft | | JoyLeft | ||
− | | Joy-Con left controller | + | | Joy-Con left controller. |
|- | |- | ||
| 5 | | 5 | ||
| JoyRight | | JoyRight | ||
− | | Joy-Con right controller | + | | Joy-Con right controller. |
|- | |- | ||
| 6 | | 6 | ||
Line 1,444: | Line 1,444: | ||
|- | |- | ||
| 7 | | 7 | ||
− | | | + | | LarkLeft (HVC) |
− | | Famicom controller. | + | | Famicom left controller. |
|- | |- | ||
| 8 | | 8 | ||
− | | | + | | LarkRight (HVC) |
− | | Famicom controller | + | | Famicom right controller (with microphone). |
|- | |- | ||
| 9 | | 9 | ||
− | | | + | | LarkLeft (NES) |
− | | NES controller. | + | | NES left controller. |
|- | |- | ||
| 10 | | 10 | ||
− | | | + | | LarkRight (NES) |
− | | NES controller | + | | NES right controller. |
|- | |- | ||
| 11-14 | | 11-14 | ||
| | | | ||
− | | | + | | Reserved |
|- | |- | ||
| 15 | | 15 | ||
− | | | + | | SystemExt |
− | | | + | | Generic external controller. |
|- | |- | ||
| 16-30 | | 16-30 | ||
| | | | ||
− | | | + | | Reserved |
|- | |- | ||
| 31 | | 31 | ||
− | | | + | | System |
− | | | + | | Generic controller. |
|} | |} | ||
Revision as of 18:58, 11 July 2019
See here for the HID shared-memory.
hid
This is "nn::hid::IHidServer".
Cmd | Name |
---|---|
0 | #CreateAppletResource |
1 | ActivateDebugPad |
11 | ActivateTouchScreen |
21 | ActivateMouse |
31 | ActivateKeyboard |
32 | [6.0.0+] SendKeyboardLockKeyEvent |
40 | AcquireXpadIdEventHandle |
41 | ReleaseXpadIdEventHandle |
51 | ActivateXpad |
55 | GetXpadIds |
56 | ActivateJoyXpad |
58 | GetJoyXpadLifoHandle |
59 | GetJoyXpadIds |
60 | ActivateSixAxisSensor |
61 | DeactivateSixAxisSensor |
62 | GetSixAxisSensorLifoHandle |
63 | ActivateJoySixAxisSensor |
64 | DeactivateJoySixAxisSensor |
65 | GetJoySixAxisSensorLifoHandle |
66 | StartSixAxisSensor |
67 | StopSixAxisSensor |
68 | IsSixAxisSensorFusionEnabled |
69 | EnableSixAxisSensorFusion |
70 | SetSixAxisSensorFusionParameters |
71 | GetSixAxisSensorFusionParameters |
72 | ResetSixAxisSensorFusionParameters |
73 | SetAccelerometerParameters |
74 | GetAccelerometerParameters |
75 | ResetAccelerometerParameters |
76 | SetAccelerometerPlayMode |
77 | GetAccelerometerPlayMode |
78 | ResetAccelerometerPlayMode |
79 | SetGyroscopeZeroDriftMode |
80 | GetGyroscopeZeroDriftMode |
81 | ResetGyroscopeZeroDriftMode |
82 | IsSixAxisSensorAtRest |
83 | [6.0.0+] IsFirmwareUpdateAvailableForSixAxisSensor |
91 | ActivateGesture |
100 | #SetSupportedNpadStyleSet |
101 | #GetSupportedNpadStyleSet |
102 | #SetSupportedNpadIdType |
103 | ActivateNpad |
104 | DeactivateNpad |
106 | #AcquireNpadStyleSetUpdateEventHandle |
107 | DisconnectNpad |
108 | GetPlayerLedPattern |
109 | [5.0.0+] ActivateNpadWithRevision |
120 | SetNpadJoyHoldType |
121 | GetNpadJoyHoldType |
122 | #SetNpadJoyAssignmentModeSingleByDefault |
123 | #SetNpadJoyAssignmentModeSingle |
124 | #SetNpadJoyAssignmentModeDual |
125 | #MergeSingleJoyAsDualJoy |
126 | StartLrAssignmentMode |
127 | StopLrAssignmentMode |
128 | SetNpadHandheldActivationMode |
129 | #GetNpadHandheldActivationMode |
130 | SwapNpadAssignment |
131 | IsUnintendedHomeButtonInputProtectionEnabled |
132 | EnableUnintendedHomeButtonInputProtection |
133 | [5.0.0+] SetNpadJoyAssignmentModeSingleWithDestination |
134 | [6.1.0+] SetNpadAnalogStickUseCenterClamp |
135 | [8.0.0+] SetNpadCaptureButtonAssignment |
136 | [8.0.0+] ClearNpadCaptureButtonAssignment |
200 | #GetVibrationDeviceInfo |
201 | #SendVibrationValue |
202 | #GetActualVibrationValue |
203 | #CreateActiveVibrationDeviceList |
204 | #PermitVibration |
205 | #IsVibrationPermitted |
206 | #SendVibrationValues |
207 | [4.0.0+] SendVibrationGcErmCommand |
208 | [4.0.0+] GetActualVibrationGcErmCommand |
209 | [4.0.0+] BeginPermitVibrationSession |
210 | [4.0.0+] EndPermitVibrationSession |
211 | [7.0.0+] #IsVibrationDeviceMounted |
300 | [3.0.0+] ActivateConsoleSixAxisSensor |
301 | [3.0.0+] StartConsoleSixAxisSensor |
302 | [3.0.0+] StopConsoleSixAxisSensor |
303 | [5.0.0+] #ActivateSevenSixAxisSensor |
304 | [5.0.0+] #StartSevenSixAxisSensor |
305 | [5.0.0+] #StopSevenSixAxisSensor |
306 | [5.0.0+] #InitializeSevenSixAxisSensor |
307 | [5.0.0+] #FinalizeSevenSixAxisSensor |
308 | [5.0.0+] #SetSevenSixAxisSensorFusionStrength |
309 | [5.0.0+] #GetSevenSixAxisSensorFusionStrength |
310 | [6.0.0+] #ResetSevenSixAxisSensorTimestamp |
400 | [3.0.0+] IsUsbFullKeyControllerEnabled |
401 | [3.0.0+] EnableUsbFullKeyController |
402 | [3.0.0+] IsUsbFullKeyControllerConnected |
403 | [4.0.0+] HasBattery |
404 | [4.0.0+] HasLeftRightBattery |
405 | [4.0.0+] GetNpadInterfaceType |
406 | [4.0.0+] GetNpadLeftRightInterfaceType |
500 | [5.0.0+] GetPalmaConnectionHandle |
501 | [5.0.0+] InitializePalma |
502 | [5.0.0+] AcquirePalmaOperationCompleteEvent |
503 | [5.0.0+] GetPalmaOperationInfo |
504 | [5.0.0+] PlayPalmaActivity |
505 | [5.0.0+] SetPalmaFrModeType |
506 | [5.0.0+] ReadPalmaStep |
507 | [5.0.0+] EnablePalmaStep |
508 | [5.0.0+] ResetPalmaStep |
509 | [5.0.0+] ReadPalmaApplicationSection |
510 | [5.0.0+] WritePalmaApplicationSection |
511 | [5.0.0+] ReadPalmaUniqueCode |
512 | [5.0.0+] SetPalmaUniqueCodeInvalid |
513 | [5.0.0+] WritePalmaActivityEntry |
514 | [5.0.0+] WritePalmaRgbLedPatternEntry |
515 | [5.0.0+] WritePalmaWaveEntry |
516 | [5.0.0+] SetPalmaDataBaseIdentificationVersion |
517 | [5.0.0+] GetPalmaDataBaseIdentificationVersion |
518 | [5.0.0+] SuspendPalmaFeature |
519 | [5.1.0+] GetPalmaOperationResult |
520 | [5.1.0+] ReadPalmaPlayLog |
521 | [5.1.0+] ResetPalmaPlayLog |
522 | [5.1.0+] SetIsPalmaAllConnectable |
523 | [5.1.0+] SetIsPalmaPairedConnectable |
524 | [5.1.0+] PairPalma |
525 | [5.1.0+] SetPalmaBoostMode |
526 | [7.0.0+] CancelWritePalmaWaveEntry |
527 | [8.0.0+] EnablePalmaBoostMode |
528 | [8.0.0+] GetPalmaBluetoothAddress |
529 | [8.0.0+] SetDisallowedPalmaConnection |
1000 | SetNpadCommunicationMode |
1001 | GetNpadCommunicationMode |
CreateAppletResource
Takes a PID and an u64 AppletResourceUserId. Returns an #IAppletResource.
SetSupportedNpadStyleSet
Takes an u32 #NpadStyleTag.
GetSupportedNpadStyleSet
Returns an u32 #NpadStyleTag.
SetSupportedNpadIdType
Takes a PID-descriptor, a type-0x9 input buffer, and an AppletResourceUserId. No output.
The input buffer contains an array of u32 #NpadIdType.
AcquireNpadStyleSetUpdateEventHandle
Takes an input u32, an u64 AppletResourceUserId, and an u64. Returns an output event handle, autoclear for this is user-specified.
The value for the last u64 doesn't seem to matter (?): official sw sets this to the address of the structure used for storing the event which is initialized after using this cmd.
SetNpadJoyAssignmentModeSingleByDefault
Takes a PID-descriptor, an u32, and an AppletResourceUserId. No output.
SetNpadJoyAssignmentModeSingle
Takes a PID-descriptor, an u32, AppletResourceUserId, and s64 NpadJoyDeviceType. No output.
SetNpadJoyAssignmentModeDual
Takes a PID-descriptor, an u32, and an AppletResourceUserId. No output.
MergeSingleJoyAsDualJoy
Takes a PID-descriptor, two u32s, and an AppletResourceUserId. No output.
GetNpadHandheldActivationMode
Takes a PID and an u64 AppletResourceUserId. Returns an output u64. Official user-processes panic if the output u64 is not 0-2.
GetVibrationDeviceInfo
Takes a #VibrationDeviceHandle. Returns an output #VibrationDeviceInfo.
SendVibrationValue
Takes a PID-descriptor, a #VibrationDeviceHandle, a #VibrationValue immediately after that, and an u64 AppletResourceUserId. No output.
GetActualVibrationValue
Takes a PID-descriptor, a #VibrationDeviceHandle, and an u64 AppletResourceUserId. Returns an output #VibrationValue.
CreateActiveVibrationDeviceList
No input. Returns an #IActiveVibrationDeviceList.
PermitVibration
Takes an input u8 bool. No output.
This affects the config displayed by System Settings.
IsVibrationPermitted
No input. Returns an output u8 bool.
SendVibrationValues
Takes an u64 AppletResourceUserId, and two type-0x9 input buffers containing an array of: #VibrationDeviceHandle for first buffer, and #VibrationValue for the second buffer.
Official sw uses the same entry-count for each array.
IsVibrationDeviceMounted
Takes a total of 0x10-bytes of input and a PID, returns an output u8 bool.
ActivateSevenSixAxisSensor
Takes a PID and an u64 AppletResourceUserId, no output.
StartSevenSixAxisSensor
Takes a PID and an u64 AppletResourceUserId, no output.
StopSevenSixAxisSensor
Takes a PID and an u64 AppletResourceUserId, no output.
InitializeSevenSixAxisSensor
Takes a PID, an u64 AppletResourceUserId, two u64s for the size of each TransferMemory, and two TransferMemory handles. No output.
The size of the first TransferMemory is 0x1000 with MemoryPermission=read-only, while the second one has size 0x7F000 with MemoryPermission=none.
FinalizeSevenSixAxisSensor
Takes a PID and an u64 AppletResourceUserId, no output.
SetSevenSixAxisSensorFusionStrength
Takes a PID, a float, and an u64 AppletResourceUserId, no output.
GetSevenSixAxisSensorFusionStrength
Takes a PID and an u64 AppletResourceUserId, returns an output float.
ResetSevenSixAxisSensorTimestamp
Takes a PID and an u64 AppletResourceUserId, no output.
VibrationDeviceHandle
This is an u32.
VibrationDeviceInfo
This is a 0x8-byte struct.
VibrationValue
This is a 0x10-byte struct, which contains 4 float values.
IAppletResource
Cmd | Name |
---|---|
0 | #GetSharedMemoryHandle |
No input. Returned a sharedmem handle.
IActiveVibrationDeviceList
This is "nn::hid::IActiveVibrationDeviceList".
Cmd | Name |
---|---|
0 | #ActivateVibrationDevice |
ActivateVibrationDevice
Takes an input #VibrationDeviceHandle. No output.
NpadStyleTag
This is a bitfield describing which controller styles are supported.
Bits | Description | Notes |
---|---|---|
0 | NpadFullKey | Pro Controller. |
1 | NpadHandheld | Joy-Con controller in handheld mode. |
2 | NpadJoyDual | Joy-Con controller in dual mode. |
3 | NpadJoyLeft | Joy-Con left controller in single mode. |
4 | NpadJoyRight | Joy-Con right controller in single mode. |
5 | NpadGc | GameCube controller. |
6 | NpadPalma | Poké Ball Plus controller. |
7 | NpadLark | NES controller. |
8 | NpadHandheldLark | NES controller in handheld mode. |
9 | NpadLucia | |
10-28 | Reserved | |
29 | NpadSystemExt | |
30 | NpadSystem | |
31 | Reserved |
NpadIdType
This is an u32. This is the controller index used in sharedmem. 0x20 is handheld.
hid:dbg
This is "nn::hid::IHidDebugServer".
Cmd | Name |
---|---|
0 | DeactivateDebugPad |
1 | SetDebugPadAutoPilotState |
2 | UnsetDebugPadAutoPilotState |
10 | DeactivateTouchScreen |
11 | SetTouchScreenAutoPilotState |
12 | UnsetTouchScreenAutoPilotState |
20 | DeactivateMouse |
21 | SetMouseAutoPilotState |
22 | UnsetMouseAutoPilotState |
30 | DeactivateKeyboard |
31 | SetKeyboardAutoPilotState |
32 | UnsetKeyboardAutoPilotState |
50 | DeactivateXpad |
51 | SetXpadAutoPilotState |
52 | UnsetXpadAutoPilotState |
60 | DeactivateJoyXpad |
91 | DeactivateGesture |
110 | DeactivateHomeButton |
111 | SetHomeButtonAutoPilotState |
112 | UnsetHomeButtonAutoPilotState |
120 | DeactivateSleepButton |
121 | SetSleepButtonAutoPilotState |
122 | UnsetSleepButtonAutoPilotState |
123 | DeactivateInputDetector |
130 | DeactivateCaptureButton |
131 | SetCaptureButtonAutoPilotState |
132 | UnsetCaptureButtonAutoPilotState |
133 | [3.0.0+] SetShiftAccelerometerCalibrationValue |
134 | [3.0.0+] GetShiftAccelerometerCalibrationValue |
135 | [3.0.0+] SetShiftGyroscopeCalibrationValue |
136 | [3.0.0+] GetShiftGyroscopeCalibrationValue |
140 | [3.0.0+] DeactivateConsoleSixAxisSensor |
141 | [5.0.0+] GetConsoleSixAxisSensorSamplingFrequency |
142 | [5.0.0+] DeactivateSevenSixAxisSensor |
143 | [5.0.0+] GetConsoleSixAxisSensorCountStates |
144 | [8.0.0+] GetAccelerometerFsr |
145 | [8.0.0+] SetAccelerometerFsr |
146 | [8.0.0+] GetAccelerometerOdr |
147 | [8.0.0+] SetAccelerometerOdr |
148 | [8.0.0+] GetGyroscopeFsr |
149 | [8.0.0+] SetGyroscopeFsr |
150 | [8.0.0+] GetGyroscopeOdr |
151 | [8.0.0+] SetGyroscopeOdr |
201 | ActivateFirmwareUpdate |
202 | DeactivateFirmwareUpdate |
203 | #StartFirmwareUpdate |
204 | GetFirmwareUpdateStage |
205 | #GetFirmwareVersion |
206 | #GetDestinationFirmwareVersion |
207 | #DiscardFirmwareInfoCacheForRevert |
208 | [3.0.0+] StartFirmwareUpdateForRevert |
209 | [3.0.0+] GetAvailableFirmwareVersionForRevert |
210 | [4.0.0+] IsFirmwareUpdatingDevice |
211 | [6.0.0+] StartFirmwareUpdateIndividual |
215 | [6.0.0+] SetUsbFirmwareForceUpdateEnabled |
216 | [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode |
221 | [3.0.0+] #UpdateControllerColor |
222 | [4.0.0+] ConnectUsbPadsAsync |
223 | [4.0.0+] DisconnectUsbPadsAsync |
224 | [5.0.0+] #UpdateDesignInfo |
225 | [5.0.0+] GetUniquePadDriverState |
226 | [5.0.0+] GetSixAxisSensorDriverStates |
227 | [5.0.0+] GetRxPacketHistory |
228 | [6.0.0+] AcquireOperationEventHandle |
229 | [6.0.0+] #ReadSerialFlash |
230 | [6.0.0+] WriteSerialFlash |
231 | [6.0.0+] GetOperationResult |
232 | [6.0.0+] EnableShipmentMode |
233 | [6.0.0+] ClearPairingInfo |
234 | [6.0.0+] GetUniquePadDeviceTypeSetInternal |
235 | [7.0.0+] EnableAnalogStickPower |
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 |
329 | [7.0.0+] #ApplyHdlsStateList |
330 | [7.0.0+] #AttachHdlsVirtualDevice |
331 | [7.0.0+] #DetachHdlsVirtualDevice |
332 | [7.0.0+] #SetHdlsState |
350 | [5.0.0+] AddRegisteredDevice |
400 | [6.0.0+] DisableExternalMcuOnNxDevice |
401 | [6.0.0+] DisableRailDeviceFiltering |
500 | [8.0.0+] SetFactoryInt |
501 | [8.0.0+] IsFactoryBootEnabled |
StartFirmwareUpdate
Takes a total of 0x20-bytes of input, 2 handles, and returns an output handle.
[3.0.0+] Now takes a total of 8-bytes of input, and no longer uses any input/output handles.
GetFirmwareVersion
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
[3.0.0+] Now returns an additional 0xC-bytes of output.
GetDestinationFirmwareVersion
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
[3.0.0+] Now returns an additional 0xC-bytes of output.
DiscardFirmwareInfoCacheForRevert
Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.
[3.0.0+] No input/output.
UpdateControllerColor
Takes two input u32s for the colors, an input u64 UniquePadId, and no output.
A state flag must be clear, otherwise an error is thrown. Afterwards, this flag is set.
Sends the spi-write subcommand to the specified controller, for writing the color data. This writes to offset 0x6050 size 0x6, where the first 3-bytes are from the first u32 and the remaining 3-bytes are from the second u32.
UpdateDesignInfo
Takes 4 input u32s for the colors, an input u8, an input u64 UniquePadId, and no output.
A state flag must be clear (same as #UpdateControllerColor), otherwise an error is thrown. Afterwards, this flag is set.
Sends the spi-write subcommand to the specified controller, for writing to offset 0x6050 size 0xD. The first 3-bytes from each u32 is used for the spi-write-data, with the u8 being copied immediately afterwards the color data.
ReadSerialFlash
Takes an input TransferMemory handle, an input u32 offset, an input u64 size, and an u64 UniquePadId, no output.
Reads from the specified controller's spi-flash. The input size is the original size without page-alignment. The TransferMemory permissions is RW-.
This doesn't seem to be usable?
GetAbstractedPadHandles
Takes a type-0xA output buffer containing an array of u64 AbstractedPadHandle and returns an output s32 for total entries.
Returns a handle for each controller detected by the system.
GetAbstractedPadState
Takes an input u64 AbstractedPadHandle, returns an output #AbstractedPadState.
GetAbstractedPadsState
Takes a type-0xA output buffer containing an array of u64 AbstractedPadHandle, a type-0x22 output buffer containing an array of #AbstractedPadState, and returns an output s32 for total entries.
SetAutoPilotVirtualPadState
Takes an input s8 AbstractedVirtualPadId and an input #AbstractedPadState, no output.
UnsetAutoPilotVirtualPadState
Takes an input s8 AbstractedVirtualPadId, no output.
Clears AutoPilot state for the specified pad.
UnsetAllAutoPilotVirtualPadState
No input/output.
Same as #UnsetAutoPilotVirtualPadState except this clears state for every pad.
AttachHdlsWorkBuffer
Takes an input TransferMemory handle and an u64 for the TransferMemory size, no output.
Official user-processes use TransferMemory size=0x1000 and permissions=RW.
This TransferMemory is used as input/output by the other Hdls commands.
Hdls is for virtual HID controllers.
ReleaseHdlsWorkBuffer
No input/output.
DumpHdlsNpadAssignmentState
No input/output.
After using this cmd, the output #HdlsNpadAssignment is located at tmem+0.
DumpHdlsStates
No input/output.
After using this cmd, the output #HdlsStateList struct is located at tmem+0.
ApplyHdlsNpadAssignmentState
Takes an input u8 bool, no output.
Prior to using this cmd, the input #HdlsNpadAssignment is written to tmem+0 by the user-process.
ApplyHdlsStateList
No input/output.
Prior to using this cmd, the input #HdlsStateList is written to tmem+0 by the user-process.
The #HdlsState will be applied for each HdlsHandle. If a HdlsHandle is not found, code similar to #AttachHdlsVirtualDevice will run with the #HdlsDeviceInfo, then it will continue with applying state with the new device.
AttachHdlsVirtualDevice
Takes an #HdlsDeviceInfo, returns a 8-byte HdlsHandle.
DetachHdlsVirtualDevice
Takes an input 8-byte HdlsHandle, no output.
SetHdlsState
Takes an input #HdlsState and an input 8-byte HdlsHandle, no output.
AbstractedPadState
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | Type, only 1 bit can be set. Converted to #HdlsDeviceInfo::type internally by #SetAutoPilotVirtualPadState. |
0x4 | 0x1 | Flags. #SetAutoPilotVirtualPadState only uses bit0: when clear it will skip using the rest of the input and run #UnsetAutoPilotVirtualPadState internally. |
0x5 | 0x3 | Padding |
0x8 | 0x4 | RGBA Single Body Color |
0xC | 0x4 | RGBA Single Buttons Color |
0x10 | 0x1 | Type2. See #HiddbgHdlsDeviceInfo::type2. |
0x11 | 0x3 | Padding |
0x14 | 0x24 | #HdlsState. Unknown if the last 4-bytes are included in this struct, #SetAutoPilotVirtualPadState/#hiddbgGetAbstractedPadsState only uses the first 0x20-bytes. |
0x38 | 0x60 | Unused with #SetAutoPilotVirtualPadState/#GetAbstractedPadsState. |
Normally the input state is merged with an existing controller selected by Type. However in some cases (BIT(2-5) with type2!=0x2 and BIT(31)) it's detected as a dedicated controller.
Type:
Bits | #HdlsDeviceInfo::type bits | Description | Notes |
---|---|---|---|
0 | 0 | ||
1 | 15 | #DeviceType |= BIT(1) | |
2 | 1 | ||
3 | 2 | ||
4 | 1 | ||
5 | 2 | ||
6 | 3 | ||
7 | 11 | #DeviceType |= BIT(11) | |
8 | 12 | #DeviceType |= BIT(12) | |
9 | 13 | #DeviceType |= BIT(13) | |
10 | 14 | #DeviceType |= BIT(14) | |
11 | 15 | #DeviceType |= BIT(11) | |
12 | 12 | #DeviceType |= BIT(12) | |
13 | 13 | #DeviceType |= BIT(13) | |
14 | 14 | #DeviceType |= BIT(14) | |
15 | 17 | ||
31 | 21 | #DeviceType = BIT(31) |
The above "#DeviceType |=" notes only apply when type2 is 0x2.
HdlsNpadAssignment
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | s32 Total entries |
0x4 | 0x4 | Padding |
0x8 | 0x200(0x20*0x10) | Array of #HdlsNpadAssignmentEntry. |
This is a 0x208-byte struct.
HdlsNpadAssignmentEntry
Offset | Size | Description |
---|---|---|
0x0 | 0x8 | HdlsHandle |
0x8 | 0x4 | ? |
0xC | 0x4 | ? |
0x10 | 0x8 | ? |
0x18 | 0x1 | ? |
0x19 | 0x7 | Padding |
This is a 0x20-byte struct.
HdlsStateList
Offset | Size | Description |
---|---|---|
0x0 | 0x4 | s32 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
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
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 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 |
This is a 0x10-byte struct.
Bits for the above type field:
Bits | Description | Notes |
---|---|---|
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
Offset | Size | Description |
---|---|---|
0x0 | 0x1 | powerConnected for the main PowerInfo. |
0x1 | 0x1 | ORRed with powerConnected to set the value of the first byte for the controller flags. |
0x2 | 0x6 | Unknown |
0x8 | 0x4 | batteryCharge for the main PowerInfo. |
0xC | 0x4 | Buttons. Bit18 = HOME and bit19 = Capture. |
0x10 | 0x10(4*2*2) | Joystick data, see HID_Shared_Memory#Controller_State. |
0x20 | 0x1 | Unused for input. Set with output from #DumpHdlsStates (zero in some cases). |
0x21 | 0x3 | Padding |
This is a 0x24-byte struct.
hid:sys
This is "nn::hid::IHidSystemServer".
Cmd | Name |
---|---|
31 | SendKeyboardLockKeyEvent |
101 | AcquireHomeButtonEventHandle |
111 | ActivateHomeButton |
121 | AcquireSleepButtonEventHandle |
131 | ActivateSleepButton |
141 | AcquireCaptureButtonEventHandle |
151 | ActivateCaptureButton |
161 | [7.0.0+] GetPlatformConfig |
210 | AcquireNfcDeviceUpdateEventHandle |
211 | GetNpadsWithNfc |
212 | AcquireNfcActivateEventHandle |
213 | ActivateNfc |
214 | [4.0.0+] GetXcdHandleForNpadWithNfc |
215 | [4.0.0+] IsNfcActivated |
230 | AcquireIrSensorEventHandle |
231 | ActivateIrSensor |
301 | ActivateNpadSystem |
303 | ApplyNpadSystemCommonPolicy |
304 | EnableAssigningSingleOnSlSrPress |
305 | DisableAssigningSingleOnSlSrPress |
306 | GetLastActiveNpad |
307 | GetNpadSystemExtStyle |
308 | [5.0.0+] ApplyNpadSystemCommonPolicyFull |
309 | [5.0.0+] GetNpadFullKeyGripColor |
310 | [6.0.0+] GetMaskedSupportedNpadStyleSet |
311 | SetNpadPlayerLedBlinkingDevice |
312 | [6.0.0+] SetSupportedNpadStyleSetAll |
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.
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 subcommand.
GetHidbusSystemServiceObject
No input, returns an #IHidbusSystemServer.
NotificationLedPattern
Offset | Size | Subcommand argdata bytepos | Subcommand argdata nibble | Description |
---|---|---|---|---|
0x0 | 0x1 | 0x0 | Low | Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF. |
0x1 | 0x1 | 0x0 | High | Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles. |
0x2 | 0x1 | 0x1 | Low | Number of Full Cycles. Value 0x1-0xF: 1 - 15 full cycles. Value 0x0 is repeat forever, but if Mini Cycle Base Duration is set to 0x0, it does the 1st Mini Cycle with a 12.5ms base duration and then the LED stays on with LED Start Intensity. |
0x3 | 0x1 | 0x1 | High | LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty) |
0x4 | 0x1 | 0x2 | High | Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty) |
0x5 | 0x1 | 0x3 | High | Fading Transition Steps to Mini Cycle 1 (Uses PWM). Value 0x0: Instant. Each step duration is based on Mini Cycle Step Duration Multiplier. |
0x6 | 0x1 | 0x3 | Low | Final Step Duration Multiplier of Mini Cycle 1. Value is a Multiplier of Mini Cycle Base Duration. Value 0x0: 12.5ms, 0x1 - xF: 1x - 15x. |
0x7 | 0x1 | Unused | ||
0x8 | 0x1 | 0x2 | Low | Mini Cycle 2 LED Intensity. |
0x9 | 0x1 | 0x4 | High | Fading Transition Steps to Mini Cycle 2 (see above). |
0xA | 0x1 | 0x4 | Low | Final Step Duration Multiplier of Mini Cycle 2 (see above). |
0xB | 0x1 | Unused | ||
0xC | 0x1 | 0x5 | High | Mini Cycle 3 LED Intensity. |
0xD | 0x1 | 0x6 | High | Fading Transition Steps to Mini Cycle 3 (see above). |
0xE | 0x1 | 0x6 | Low | Final Step Duration Multiplier of Mini Cycle 3 (see above). |
0xF | 0x1 | Unused | ||
0x10 | 0x1 | 0x5 | Low | Mini Cycle 4 LED Intensity. |
0x11 | 0x1 | 0x7 | High | Fading Transition Duration to Mini Cycle 4 (see above). |
0x12 | 0x1 | 0x7 | Low | Final Step Duration Multiplier of Mini Cycle 4 (see above). |
0x13 | 0x1 | Unused | ||
0x14 | 0x1 | 0x8 | High | Mini Cycle 5 LED Intensity. |
0x15 | 0x1 | 0x9 | High | Fading Transition Steps to Mini Cycle 5 (see above). |
0x16 | 0x1 | 0x9 | Low | Final Step Duration Multiplier of Mini Cycle 5 (see above). |
0x17 | 0x1 | Unused | ||
0x18 | 0x1 | 0x8 | Low | Mini Cycle 6 LED Intensity. |
0x19 | 0x1 | 0xA | High | Fading Transition Steps to Mini Cycle 6 (see above). |
0x1A | 0x1 | 0xA | Low | Final Step Duration Multiplier of Mini Cycle 6 (see above). |
0x1B | 0x1 | Unused | ||
0x1C | 0x1 | 0xB | High | Mini Cycle 7 LED Intensity. |
0x1D | 0x1 | 0xC | High | Fading Transition Steps to Mini Cycle 7 (see above). |
0x1E | 0x1 | 0xC | Low | Final Step Duration Multiplier of Mini Cycle 7 (see above). |
0x1F | 0x1 | Unused | ||
0x20 | 0x1 | 0xB | Low | Mini Cycle 8 LED Intensity. |
0x21 | 0x1 | 0xD | Low | Fading Transition Steps to Mini Cycle 8 (see above). |
0x22 | 0x1 | 0xD | High | Final Step Duration Multiplier of Mini Cycle 8 (see above). |
0x23 | 0x1 | Unused | ||
0x24 | 0x1 | 0xE | High | Mini Cycle 9 LED Intensity. |
0x25 | 0x1 | 0xF | High | Fading Transition Steps to Mini Cycle 9 (see above). |
0x26 | 0x1 | 0xF | Low | Final Step Duration Multiplier of Mini Cycle 9 (see above). |
0x27 | 0x1 | Unused | ||
0x28 | 0x1 | 0xE | Low | Mini Cycle 10 LED Intensity. |
0x29 | 0x1 | 0x10 | High | Fading Transition Steps to Mini Cycle 10 (see above). |
0x2A | 0x1 | 0x10 | Low | Final Step Duration Multiplier of Mini Cycle 10 (see above). |
0x2B | 0x1 | Unused | ||
0x2C | 0x1 | 0x11 | High | Mini Cycle 11 LED Intensity. |
0x2D | 0x1 | 0x12 | High | Fading Transition Steps to Mini Cycle 11 (see above). |
0x2E | 0x1 | 0x12 | Low | Final Step Duration Multiplier of Mini Cycle 11 (see above). |
0x2F | 0x1 | Unused | ||
0x30 | 0x1 | 0x11 | Low | Mini Cycle 12 LED Intensity. |
0x31 | 0x1 | 0x13 | High | Fading Transition Steps to Mini Cycle 12 (see above). |
0x32 | 0x1 | 0x13 | Low | Final Step Duration Multiplier of Mini Cycle 12 (see above). |
0x33 | 0x1 | Unused | ||
0x34 | 0x1 | 0x14 | High | Mini Cycle 13 LED Intensity. |
0x35 | 0x1 | 0x15 | High | Fading Transition Steps to Mini Cycle 13 (see above). |
0x36 | 0x1 | 0x15 | Low | Final Step Duration Multiplier of Mini Cycle 13 (see above). |
0x37 | 0x1 | Unused | ||
0x38 | 0x1 | 0x14 | Low | Mini Cycle 14 LED Intensity. |
0x39 | 0x1 | 0x16 | High | Fading Transition Steps to Mini Cycle 14 (see above). |
0x3A | 0x1 | 0x16 | Low | Final Step Duration Multiplier of Mini Cycle 14 (see above). |
0x3B | 0x1 | Unused | ||
0x3C | 0x1 | 0x17 | High | Mini Cycle 15 LED Intensity. |
0x3D | 0x1 | 0x18 | High | Fading Transition Steps to Mini Cycle 15 (see above). |
0x3E | 0x1 | 0x18 | Low | Final Step Duration Multiplier of Mini Cycle 15 (see above). |
0x3F | 0x1 | Unused | ||
0x40 | 0x1 | 0x17 | Low | Mini Cycle 16 LED Intensity. |
0x41 | 0x1 | 0x19 | High | Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.) |
0x42 | 0x1 | 0x19 | Low | Final Step Duration Multiplier of Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.) |
0x43 | 0x1 | Unused | ||
0x44 | 0x1 | 0x1A | High | Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.) |
0x45 | 0x1 | 0x1A | Low | Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.) |
0x46 | 0x1 | Padding | ||
0x47 | 0x1 | Padding |
This is "nn::hid::system::NotificationLedPattern".
This is a 0x48-byte struct.
The above descriptions in the table are based on the info from here.
argdata in the subcommand is initialized as follows: ((u8*)cmd_argdata)[pos] = u8_in[pos2] | u8_in[pos3]<<4;
Hence, 4bits from pairs of 2-bytes of the input struct are combined to write to the subcommand. Only the low 4bits of each used byte in the struct is used. This is written to stack initially, then copied to the actual cmd_argdata (the data immediately following the subcommandID byte). There's a total of 0x1B-bytes of cmd_argdata initialized from this.
The layout of cmd_argdata is as follows:
Offset | Size | Description |
---|---|---|
0x0 | 0x1B | See above. |
0x1B | 0xB | Cleared to zero. |
0x26 | 0x5 | Unused |
0x2B | 0x8 | Set to an input value, which is hard-coded 0. |
0x33 | 0x2 | Set to value 0. |
0x35 | 0x1 | Set to value 1. |
DeviceType
This is a bitmask describing the controller device type.
Bits | Description | Notes |
---|---|---|
0 | FullKey | Pro Controller and Gc controller. |
1 | Unknown | |
2 | HandheldLeft | Joy-Con/Famicom/NES left controller in handheld mode. |
3 | HandheldRight | Joy-Con/Famicom/NES right controller in handheld mode. |
4 | JoyLeft | Joy-Con left controller. |
5 | JoyRight | Joy-Con right controller. |
6 | Palma | Poké Ball Plus controller. |
7 | LarkLeft (HVC) | Famicom left controller. |
8 | LarkRight (HVC) | Famicom right controller (with microphone). |
9 | LarkLeft (NES) | NES left controller. |
10 | LarkRight (NES) | NES right controller. |
11-14 | Reserved | |
15 | SystemExt | Generic external controller. |
16-30 | Reserved | |
31 | System | Generic controller. |
IHidbusSystemServer
This is "nn::hidbus::IHidbusSystemServer".
This was added with [5.0.0+].
Cmd | Name |
---|---|
500 | |
501 | |
502 |
hid:tmp
This is "nn::hid::IHidTemporaryServer".
This service was added with [3.0.0+], then removed with [8.0.0+].
Cmd | Name |
---|---|
0 | GetConsoleSixAxisSensorCalibrationValues |
irs
This is "nn::irsensor::IIrSensorServer".
Cmd | Name |
---|---|
302 | #ActivateIrsensor |
303 | #DeactivateIrsensor |
304 | #GetIrsensorSharedMemoryHandle |
305 | #StopImageProcessor |
306 | #RunMomentProcessor |
307 | #RunClusteringProcessor |
308 | #RunImageTransferProcessor |
309 | #GetImageTransferProcessorState |
310 | #RunTeraPluginProcessor |
311 | #GetNpadIrCameraHandle |
312 | #RunPointingProcessor |
313 | #SuspendImageProcessor |
314 | [3.0.0+] #CheckFirmwareVersion |
315 | [4.0.0+] SetFunctionLevel |
316 | [4.0.0+] RunImageTransferExProcessor |
317 | [4.0.0+] RunIrLedProcessor |
318 | [4.0.0+] StopImageProcessorAsync |
319 | [4.0.0+] ActivateIrsensorWithFunctionLevel |
ActivateIrsensor
Takes a PID-descriptor and an AppletResourceUserId. No output.
DeactivateIrsensor
Takes a PID-descriptor and an AppletResourceUserId. No output.
Takes a PID-descriptor and an AppletResourceUserId. Returns a SharedMemory handle.
The SharedMemory is mapped with permissions=read-only and size=0x8000.
StopImageProcessor
Takes a PID-descriptor, an #IrCameraHandle, and an AppletResourceUserId. No output.
RunMomentProcessor
Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, and a #PackedMomentProcessorConfig. No output.
RunClusteringProcessor
Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, and a #PackedClusteringProcessorConfig. No output.
RunImageTransferProcessor
Takes a PID-descriptor, an #IrCameraHandle, an AppletResourceUserId, a #PackedImageTransferProcessorConfig, an u64 for the TransferMemory_size, and a TransferMemory handle. No output.
Official sw creates the TransferMemory with an user-specified buffer and permissions=0.
GetImageTransferProcessorState
Takes a PID-descriptor, a type-0x6 output buffer, an #IrCameraHandle, and an AppletResourceUserId. Returns an #ImageTransferProcessorState. No output.
RunTeraPluginProcessor
Takes a PID-descriptor, an #IrCameraHandle, a #PackedTeraPluginProcessorConfig (immediately after the previous word), and an AppletResourceUserId. No output.
GetNpadIrCameraHandle
Takes an input u32 NpadTypeId. Returns an output #IrCameraHandle.
RunPointingProcessor
Takes a PID-descriptor, an #IrCameraHandle, a #PackedDpdProcessorConfig (immediately after the previous word), and an AppletResourceUserId. No output.
SuspendImageProcessor
Takes a PID-descriptor, an #IrCameraHandle, and an AppletResourceUserId. No output.
CheckFirmwareVersion
Takes a PID-descriptor, an #IrCameraHandle, a #PackedMcuVersion, and an AppletResourceUserId. No output.
IrCameraHandle
This is an u32.
PackedMomentProcessorConfig
This is a 0x20-byte struct. This is converted from another structure by the official user-process.
Offset | Size | Description | DefaultConfig |
---|---|---|---|
0x0 | 0x8 | ? | 0x493E0 |
0x8 | 0x1 | ? | 0x0 |
0x9 | 0x1 | ? | 0x8 |
0xA | 0x1 | ? | 0x0 |
0xB | 0x5 | Padding | |
0x10 | 0x8 | u16, u32, u16 | {Not written}, 0x1400000, 0xF0 |
0x18 | 0x4 | Hard-coded to 0xA0003. | |
0x1C | 0x1 | ? | 0x1 |
0x1D | 0x1 | ? | 0x50 |
0x1E | 0x2 | Padding |
PackedClusteringProcessorConfig
This is a 0x28-byte struct.
PackedImageTransferProcessorConfig
This is a 0x18-byte struct. This is converted from another structure by the official user-process. The conversion is the same as PackedMomentProcessorConfig, except the code using out +0x1C/+0x1D was removed, and the constant is now located at out+0x10. The code which wrote to out u64 +0x10 from in+0x24 was replaced with code which writes an u8 to out+0x14.
ImageTransferProcessorState
This is a 0x10-byte struct.
PackedTeraPluginProcessorConfig
This is an u64.
PackedDpdProcessorConfig
This is a 0x10-byte struct.
PackedMcuVersion
This is an u32.
irs:sys
This is "nn::irsensor::IIrSensorSystemServer".
Cmd | Name |
---|---|
500 | SetAppletResourceUserId |
501 | RegisterAppletResourceUserId |
502 | UnregisterAppletResourceUserId |
503 | EnableAppletToGetInput |
ahid:cd
This is "nn::ahid::IServerSession".
Used for USB HID devices.
Cmd | Name | Notes |
---|---|---|
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. |
ICtrlSession
This is "nn::ahid::ICtrlSession".
Cmd | Name | Notes |
---|---|---|
0 | ||
1 | ||
2 | ||
3 | ||
4 | ||
5 | ||
6 | ||
7 | ||
8 | ||
9 | ||
10 | ||
11 | ||
12 | [3.0.0+] |
All of these use USB CtrlXfer, except for cmd10-11 which are event(?) related, and cmd1 which copies 0x4000-bytes from state to output.
IReadSession
This is "nn::ahid::IReadSession".
Cmd | Name | Notes |
---|---|---|
0 |
Cmd0 uses PostBufferAsync etc with the INPUT endpoint. The size must be <=0x1000. The actual transfer size is returned in an output u64. The data is copied from the tmpbuf to the output buffer using the actual-transfer-size.
[3.0.0+] Cmd0 now takes a total of 8-bytes of input.
IWriteSession
This is "nn::ahid::IWriteSession".
This was removed with [3.0.0+].
Cmd | Name | Notes |
---|---|---|
0 | 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.
Cmd | Name |
---|---|
0 | |
1 | |
2 | |
3 | |
4 | |
5 | [6.0.0+] |
xcd:sys
This is "nn::xcd::detail::ISystemServer".
Cmd | Name |
---|---|
0 | GetDataFormat |
1 | SetDataFormat |
2 | GetMcuState |
3 | SetMcuState |
4 | GetMcuVersionForNfc |
5 | CheckNfcDevicePower |
6 | [5.0.0+] |
10 | SetNfcEvent |
11 | GetNfcInfo |
12 | StartNfcDiscovery |
13 | StopNfcDiscovery |
14 | StartNtagRead |
15 | StartNtagWrite |
16 | SendNfcRawData |
17 | RegisterMifareKey |
18 | ClearMifareKey |
19 | StartMifareRead |
20 | StartMifareWrite |
101 | GetAwakeTriggerReasonForLeftRail |
102 | GetAwakeTriggerReasonForRightRail |
[5.0.0+] SetDataFormat, SetMcuState, and ClearMifareKey: now takes a total of 0xC-bytes of input instead of 0x10.
[6.0.0+]: The buffer type used by GetNfcInfo is now 0x32 instead of 0x1A.
hidbus
This is "nn::hidbus::IHidbusServer".
This was added with [5.0.0+].
Cmd | Name |
---|---|
1 | GetBusHandle |
2 | IsExternalDeviceConnected |
3 | Initialize |
4 | Finalize |
5 | EnableExternalDevice |
6 | GetExternalDeviceId |
7 | SendCommandAsync |
8 | GetSendCommandAsynceResult |
9 | SetEventForSendCommandAsycResult |
10 | GetSharedMemoryHandle |
11 | EnableJoyPollingReceiveMode |
12 | DisableJoyPollingReceiveMode |
[5.0.0-6.2.0] 13 | GetPollingData |
14 | [6.0.0+] SetStatusManagerType |
RomFS
The hid-sysmodule RomFS contains:
ftmFwUpdate ├── NTD_4CD_1801.fts256 ├── NTD_4CD_2602.fts256 ├── NTD_4CD_3801.fts256 └── NTD_4CD_xxxx.fts256 [7.0.0+]
These are firmware files for the touchscreen controller.
Firmware update
HID-sysmodule mounts the contents of title 0100000000000822 as "systemData" or the contents of title 010000000000B22B as "systemDataD". Both titles contain the same files, but 0100000000000822 is used on retail units while 010000000000B22B is used for development.
These titles contain the following files:
- ExpectVersionInfo.csv - List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey" 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.