Changes

Jump to navigation Jump to search
no edit summary
Line 13: Line 13:  
|-
 
|-
 
| 21 || [[#ActivateMouse]]
 
| 21 || [[#ActivateMouse]]
 +
|-
 +
| 26 || [16.0.0+] ActivateDebugMouse
 
|-
 
|-
 
| 31 || [[#ActivateKeyboard]]
 
| 31 || [[#ActivateKeyboard]]
Line 80: Line 82:  
| 83 || [6.0.0+] [[#IsFirmwareUpdateAvailableForSixAxisSensor]]
 
| 83 || [6.0.0+] [[#IsFirmwareUpdateAvailableForSixAxisSensor]]
 
|-
 
|-
| 84 || [13.0.0+] EnableSixAxisSensorUnalteredPassthrough
+
| 84 || [13.0.0+] [[#EnableSixAxisSensorUnalteredPassthrough]]
 
|-
 
|-
| 85 || [13.0.0+] IsSixAxisSensorUnalteredPassthroughEnabled
+
| 85 || [13.0.0+] [[#IsSixAxisSensorUnalteredPassthroughEnabled]]
 
|-
 
|-
| 86 || [13.0.0+] StoreSixAxisSensorCalibrationParameter
+
| 86 || [13.0.0+] [[#StoreSixAxisSensorCalibrationParameter]]
 
|-
 
|-
| 87 || [13.0.0+] LoadSixAxisSensorCalibrationParameter
+
| 87 || [13.0.0+] [[#LoadSixAxisSensorCalibrationParameter]]
 
|-
 
|-
| 88 || [13.0.0+] GetSixAxisSensorIcInformation
+
| 88 || [13.0.0+] [[#GetSixAxisSensorIcInformation]]
 
|-
 
|-
| 89 || [13.0.0+] ResetIsSixAxisSensorDeviceNewlyAssigned
+
| 89 || [13.0.0+] [[#ResetIsSixAxisSensorDeviceNewlyAssigned]]
 
|-
 
|-
 
| 91 || [[#ActivateGesture]]
 
| 91 || [[#ActivateGesture]]
 +
|-
 +
| 92 || [18.0.0+] SetGestureOutputRanges
 
|-
 
|-
 
| 100 || [[#SetSupportedNpadStyleSet]]
 
| 100 || [[#SetSupportedNpadStyleSet]]
Line 171: Line 175:  
|-
 
|-
 
| 212 || [11.0.0+] [[#SendVibrationValueInBool]]
 
| 212 || [11.0.0+] [[#SendVibrationValueInBool]]
 +
|-
 +
| 213 || [17.0.0+] SendVibrationValueInMode
 +
|-
 +
| 214 || [17.0.0+] SendVibrationValuesInMode
 
|-
 
|-
 
| 300 || [3.0.0+] [[#ActivateConsoleSixAxisSensor]]
 
| 300 || [3.0.0+] [[#ActivateConsoleSixAxisSensor]]
Line 193: Line 201:  
|-
 
|-
 
| 310 || [6.0.0+] [[#ResetSevenSixAxisSensorTimestamp]]
 
| 310 || [6.0.0+] [[#ResetSevenSixAxisSensorTimestamp]]
 +
|-
 +
| 311 || [17.0.0+] ForceActivateConsoleSixAxisSensor
 +
|-
 +
| 312 || [17.0.0+] ForceDeactivateConsoleSixAxisSensor
 
|-
 
|-
 
| 400 || [3.0.0+] [[#IsUsbFullKeyControllerEnabled]]
 
| 400 || [3.0.0+] [[#IsUsbFullKeyControllerEnabled]]
Line 279: Line 291:  
|-
 
|-
 
| 1003 || [9.0.0+] [[#IsFirmwareUpdateNeededForNotification]]
 
| 1003 || [9.0.0+] [[#IsFirmwareUpdateNeededForNotification]]
 +
|-
 +
| 1004 || [17.0.0+] SetTouchScreenResolution
 
|-
 
|-
 
| 2000 || [10.0.0+] [[#ActivateDigitizer]]
 
| 2000 || [10.0.0+] [[#ActivateDigitizer]]
 +
|-
 +
| 3000 || [15.0.0+] GetDebugPadGenericPadMap
 +
|-
 +
| 3001 || [15.0.0+] SetDebugPadGenericPadMap
 +
|-
 +
| 3002 || [15.0.0+] ResetDebugPadGenericPadMap
 +
|-
 +
| 3003 || [15.0.0+] GetDebugPadKeyboardMap
 +
|-
 +
| 3004 || [15.0.0+] SetDebugPadKeyboardMap
 +
|-
 +
| 3005 || [15.0.0+] ResetDebugPadKeyboardMap
 +
|-
 +
| 3006 || [15.0.0+] GetFullKeyGenericPadMap
 +
|-
 +
| 3007 || [15.0.0+] SetFullKeyGenericPadMap
 +
|-
 +
| 3008 || [15.0.0+] ResetFullKeyGenericPadMap
 +
|-
 +
| 3009 || [15.0.0+] GetFullKeyKeyboardMap
 +
|-
 +
| 3010 || [15.0.0+] SetFullKeyKeyboardMap
 +
|-
 +
| 3011 || [15.0.0+] ResetFullKeyKeyboardMap
 
|}
 
|}
   Line 441: Line 479:  
== IsFirmwareUpdateAvailableForSixAxisSensor ==
 
== IsFirmwareUpdateAvailableForSixAxisSensor ==
 
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], returns an output bool.
 
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], returns an output bool.
 +
 +
== EnableSixAxisSensorUnalteredPassthrough ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], a bool, and an [[AM_services|AppletResourceUserId]], no output.
 +
 +
== IsSixAxisSensorUnalteredPassthroughEnabled ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], returns an output bool.
 +
 +
== StoreSixAxisSensorCalibrationParameter ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], a SixAxisSensorCalibrationParameter, and an [[AM_services|AppletResourceUserId]], no output.
 +
 +
== LoadSixAxisSensorCalibrationParameter ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], returns a SixAxisSensorCalibrationParameter.
 +
 +
== GetSixAxisSensorIcInformation ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], returns a SixAxisSensorIcInformation.
 +
 +
== ResetIsSixAxisSensorDeviceNewlyAssigned ==
 +
Takes a PID, a [[#SixAxisSensorHandle]], and an [[AM_services|AppletResourceUserId]], no output.
    
== ActivateGesture ==
 
== ActivateGesture ==
Line 489: Line 545:  
* 0x2: [6.0.0+]
 
* 0x2: [6.0.0+]
 
* 0x3: [8.0.0+]
 
* 0x3: [8.0.0+]
 +
* 0x5: [18.0.0+]
    
== SetNpadJoyHoldType ==
 
== SetNpadJoyHoldType ==
Line 499: Line 556:     
== SetNpadJoyAssignmentModeSingleByDefault ==
 
== SetNpadJoyAssignmentModeSingleByDefault ==
Takes a PID-descriptor, an u32, and an [[AM_services|AppletResourceUserId]]. No output.
+
Takes a PID-descriptor, an u32 [[#NpadIdType]], and an [[AM_services|AppletResourceUserId]]. No output.
    
This eventually calls the same func as [[#SetNpadJoyAssignmentModeSingle]], except with [[#NpadJoyDeviceType]]=0.
 
This eventually calls the same func as [[#SetNpadJoyAssignmentModeSingle]], except with [[#NpadJoyDeviceType]]=0.
    
== SetNpadJoyAssignmentModeSingle ==
 
== SetNpadJoyAssignmentModeSingle ==
Takes a PID-descriptor, an u32, [[AM_services|AppletResourceUserId]], and s64 [[#NpadJoyDeviceType]]. No output.
+
Takes a PID-descriptor, an u32 [[#NpadIdType]], [[AM_services|AppletResourceUserId]], and s64 [[#NpadJoyDeviceType]]. No output.
    
This eventually runs the same code as [[#SetNpadJoyAssignmentModeSingleWithDestination]], except the output fields aren't exposed.
 
This eventually runs the same code as [[#SetNpadJoyAssignmentModeSingleWithDestination]], except the output fields aren't exposed.
    
== SetNpadJoyAssignmentModeDual ==
 
== SetNpadJoyAssignmentModeDual ==
Takes a PID-descriptor, an u32, and an [[AM_services|AppletResourceUserId]]. No output.
+
Takes a PID-descriptor, an u32 [[#NpadIdType]], and an [[AM_services|AppletResourceUserId]]. No output.
    
== MergeSingleJoyAsDualJoy ==
 
== MergeSingleJoyAsDualJoy ==
Takes a PID-descriptor, two u32s, and an [[AM_services|AppletResourceUserId]]. No output.
+
Takes a PID-descriptor, two u32 [[#NpadIdType]], and an [[AM_services|AppletResourceUserId]]. No output.
    
== StartLrAssignmentMode ==
 
== StartLrAssignmentMode ==
Line 671: Line 728:  
| 0x8 || 0x8 || Second timestamp (in samples).
 
| 0x8 || 0x8 || Second timestamp (in samples).
 
|-
 
|-
| 0x10 || 0x8 || ?
+
| 0x10 || 0x8 || ? (Increased every sleep cicle)
 +
|-
 +
| 0x18 || 0x4 || float AccelerationX
 +
|-
 +
| 0x1C || 0x4 || float AccelerationY
 +
|-
 +
| 0x20 || 0x4 || float AccelerationZ
 +
|-
 +
| 0x24 || 0x4 || float AngularVelocityX
 +
|-
 +
| 0x28 || 0x4 || float AngularVelocityY
 +
|-
 +
| 0x2C || 0x4 || float AngularVelocityZ
 +
|-
 +
| 0x30 || 0x4 || float QuaternionX
 +
|-
 +
| 0x34 || 0x4 || float QuaternionY
 +
|-
 +
| 0x38 || 0x4 || float QuaternionZ
 
|-
 
|-
| 0x18 || 0x28 || float data
+
| 0x3C || 0x4 || float QuaternionW
 
|}
 
|}
   Line 852: Line 927:     
The sysmodule also calls the code which eventually runs from this, from various other funcs internally (bool value varies).
 
The sysmodule also calls the code which eventually runs from this, from various other funcs internally (bool value varies).
 +
 +
This updates various state. If needed, this uses either [[BTM_services|StartBleScanForGeneral]] or [[BTM_services|StopBleScanForGeneral]].
    
== SetIsPalmaPairedConnectable ==
 
== SetIsPalmaPairedConnectable ==
Line 859: Line 936:     
This code is also called by another func internally by the sysmodule, where flag = {whether bit6 in a field is set} (presumably [[#NpadStyleSet]]). This is eventually called from various funcs, including [[#SetSupportedNpadStyleSet]].
 
This code is also called by another func internally by the sysmodule, where flag = {whether bit6 in a field is set} (presumably [[#NpadStyleSet]]). This is eventually called from various funcs, including [[#SetSupportedNpadStyleSet]].
 +
 +
This updates various state. If needed, this uses either [[BTM_services|StartBleScanForPairedDevice]] or [[BTM_services|StopBleScanForPairedDevice]].
    
== PairPalma ==
 
== PairPalma ==
 
Takes an input [[#PalmaConnectionHandle]], no output.
 
Takes an input [[#PalmaConnectionHandle]], no output.
 +
 +
This eventually uses [[BTM_services#BlePairDevice|BlePairDevice]] if needed, and updates state.
    
== SetPalmaBoostMode ==
 
== SetPalmaBoostMode ==
Line 904: Line 985:     
== IAppletResource ==
 
== IAppletResource ==
 +
This is "nn::hid::IAppletResource".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 955: Line 1,038:  
|-
 
|-
 
| 17 || [13.0.0+] IsTouchScreenManaged
 
| 17 || [13.0.0+] IsTouchScreenManaged
 +
|-
 +
| 18 || [18.0.0+] SetTouchScreenAutoPilotStateWithAruid
 
|-
 
|-
 
| 20 || [[#DeactivateMouse]]
 
| 20 || [[#DeactivateMouse]]
Line 961: Line 1,046:  
|-
 
|-
 
| 22 || [[#UnsetMouseAutoPilotState]]
 
| 22 || [[#UnsetMouseAutoPilotState]]
 +
|-
 +
| 25 || [16.0.0+] SetDebugMouseAutoPilotState
 +
|-
 +
| 26 || [16.0.0+] UnsetDebugMouseAutoPilotState
 
|-
 
|-
 
| 30 || [[#DeactivateKeyboard]]
 
| 30 || [[#DeactivateKeyboard]]
Line 1,011: Line 1,100:  
|-
 
|-
 
| 136 || [3.0.0+] GetShiftGyroscopeCalibrationValue
 
| 136 || [3.0.0+] GetShiftGyroscopeCalibrationValue
 +
|-
 +
| 137 || [15.0.0+] SetSixAxisSensorMode
 
|-
 
|-
 
| 140 || [3.0.0+] DeactivateConsoleSixAxisSensor
 
| 140 || [3.0.0+] DeactivateConsoleSixAxisSensor
Line 1,063: Line 1,154:  
|-
 
|-
 
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
 
| 216 || [6.0.0+] SetAllKuinaDevicesToFirmwareUpdateMode
 +
|-
 +
| 217 || [17.0.0+] StartFirmwareUpdateFromImageSet
 
|-
 
|-
 
| 221 || [3.0.0+] [[#UpdateControllerColor]]
 
| 221 || [3.0.0+] [[#UpdateControllerColor]]
Line 1,157: Line 1,250:  
|-
 
|-
 
| 350 || [5.0.0+] [[#AddRegisteredDevice]]
 
| 350 || [5.0.0+] [[#AddRegisteredDevice]]
 +
|-
 +
| 351 || [17.0.0+] GetRegisteredDevicesCountDebug
 +
|-
 +
| 352 || [17.0.0+] DeleteRegisteredDevicesDebug
 
|-
 
|-
 
| 400 || [6.0.0+] DisableExternalMcuOnNxDevice
 
| 400 || [6.0.0+] DisableExternalMcuOnNxDevice
Line 1,180: Line 1,277:  
| 600 || [10.0.0+] ConvertPadState
 
| 600 || [10.0.0+] ConvertPadState
 
|-
 
|-
| 650 || [12.0.0+] AddButtonPlayData
+
| 601 || [18.0.0+] [[#IsButtonConfigSupported]]
 +
|-
 +
| 602 || [18.0.0+] [[#IsButtonConfigEmbeddedSupported]]
 +
|-
 +
| 603 || [18.0.0+] [[#DeleteButtonConfig]]
 +
|-
 +
| 604 || [18.0.0+] [[#DeleteButtonConfigEmbedded]]
 +
|-
 +
| 605 || [18.0.0+] [[#SetButtonConfigEnabled]]
 
|-
 
|-
| 651 || [12.0.0+] StartButtonPlayData
+
| 606 || [18.0.0+] [[#SetButtonConfigEmbeddedEnabled]]
 
|-
 
|-
| 652 || [12.0.0+] StopButtonPlayData
+
| 607 || [18.0.0+] [[#IsButtonConfigEnabled]]
 
|-
 
|-
| 2000 || [10.0.0+] DeactivateDigitizer
+
| 608 || [18.0.0+] [[#IsButtonConfigEmbeddedEnabled]]
 
|-
 
|-
| 2001 || [10.0.0+] SetDigitizerAutoPilotState
+
| 609 || [18.0.0+] [[#SetButtonConfigEmbedded]]
 
|-
 
|-
| 2002 || [10.0.0+] UnsetDigitizerAutoPilotState
+
| 610 || [18.0.0+] [[#SetButtonConfigFull]]
|}
+
|-
 
+
| 611 || [18.0.0+] [[#SetButtonConfigLeft]]
== DeactivateDebugPad ==
+
|-
 +
| 612 || [18.0.0+] [[#SetButtonConfigRight]]
 +
|-
 +
| 613 || [18.0.0+] [[#GetButtonConfigEmbedded]]
 +
|-
 +
| 614 || [18.0.0+] [[#GetButtonConfigFull]]
 +
|-
 +
| 615 || [18.0.0+] [[#GetButtonConfigLeft]]
 +
|-
 +
| 616 || [18.0.0+] [[#GetButtonConfigRight]]
 +
|-
 +
| 650 || [12.0.0+] AddButtonPlayData
 +
|-
 +
| 651 || [12.0.0+] StartButtonPlayData
 +
|-
 +
| 652 || [12.0.0+] StopButtonPlayData
 +
|-
 +
| 2000 || [10.0.0+] DeactivateDigitizer
 +
|-
 +
| 2001 || [10.0.0+] SetDigitizerAutoPilotState
 +
|-
 +
| 2002 || [10.0.0+] UnsetDigitizerAutoPilotState
 +
|-
 +
| 3000 || [16.0.0+] ReloadFirmwareDebugSettings
 +
|}
 +
 
 +
== DeactivateDebugPad ==
 
No input/output.
 
No input/output.
   Line 1,254: Line 1,385:     
== GetFirmwareVersion ==
 
== GetFirmwareVersion ==
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
+
Takes an input [[#NpadIdType]] and an input [[#DeviceType]]. Returns an output [[#FirmwareVersion]].
 
  −
[3.0.0+] Now returns an additional 0xC-bytes of output.
      
== GetDestinationFirmwareVersion ==
 
== GetDestinationFirmwareVersion ==
Takes a total of 8-bytes of input, and returns a total of 4-bytes of output.
+
Takes an input [[#NpadIdType]] and an input [[#DeviceType]]. Returns an output [[#FirmwareVersion]].
 
  −
[3.0.0+] Now returns an additional 0xC-bytes of output.
      
== DiscardFirmwareInfoCacheForRevert ==
 
== DiscardFirmwareInfoCacheForRevert ==
Takes a total of 8-bytes of input, and returns a total of 5-bytes of output.
+
Takes an input [[#NpadIdType]] and an input [[#DeviceType]]. Returns a total of 5-bytes of output.
    
[3.0.0+] No input/output.
 
[3.0.0+] No input/output.
Line 1,286: Line 1,413:     
[9.0.0+] Now takes a total of 8-bytes of input, returns a total of 0x18-bytes of output.
 
[9.0.0+] Now takes a total of 8-bytes of input, returns a total of 0x18-bytes of output.
 +
 +
[18.0.0+] Now takes a total of 8-bytes of input, returns a total of 0x20-bytes of output.
    
== GetSixAxisSensorDriverStates ==
 
== GetSixAxisSensorDriverStates ==
Line 1,421: Line 1,550:  
|-
 
|-
 
| 31 || [[#SendKeyboardLockKeyEvent_2|SendKeyboardLockKeyEvent]]
 
| 31 || [[#SendKeyboardLockKeyEvent_2|SendKeyboardLockKeyEvent]]
 +
|-
 +
| 32 || [15.0.0+] SetSystemKeyboardState
 +
|-
 +
| 33 || [15.0.0+] UnsetSystemKeyboardState
 
|-
 
|-
 
| 101 || [[#AcquireHomeButtonEventHandle]]
 
| 101 || [[#AcquireHomeButtonEventHandle]]
Line 1,503: Line 1,636:  
|-
 
|-
 
| 326 || [10.0.0+] GetUniquePadAppletDetailedUiType
 
| 326 || [10.0.0+] GetUniquePadAppletDetailedUiType
 +
|-
 +
| 327 || [14.0.0+] GetAbstractedPadIdDataFromNpad
 +
|-
 +
| 328 || [14.0.0+] AttachAbstractedPadToNpad
 +
|-
 +
| 329 || [14.0.0+] DetachAbstractedPadAll
 +
|-
 +
| 330 || [14.0.0+] CheckAbstractedPadConnection
 
|-
 
|-
 
| 500 || SetAppletResourceUserId
 
| 500 || SetAppletResourceUserId
Line 1,515: Line 1,656:  
|-
 
|-
 
| 505 || EnableAppletToGetSixAxisSensor
 
| 505 || EnableAppletToGetSixAxisSensor
 +
|-
 +
| 506 || [14.0.0+] EnableAppletToGetPadInput
 +
|-
 +
| 507 || [14.0.0+] EnableAppletToGetTouchScreen
 
|-
 
|-
 
| 510 || [[#SetVibrationMasterVolume]]
 
| 510 || [[#SetVibrationMasterVolume]]
Line 1,591: Line 1,736:  
|-
 
|-
 
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
 
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
 +
|-
 +
| 813 || [18.0.0+] GetDeviceType
 
|-
 
|-
 
| 821 || StartAnalogStickManualCalibration
 
| 821 || StartAnalogStickManualCalibration
Line 1,664: Line 1,811:  
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
 
| 1120 || [6.0.0+] SetFirmwareHotfixUpdateSkipEnabled
 
|-
 
|-
| 1130 || [6.0.0+] InitializeUsbFirmwareUpdate
+
| 1130 || [6.0.0-15.0.1] InitializeUsbFirmwareUpdate
 
|-
 
|-
 
| 1131 || [6.0.0+] FinalizeUsbFirmwareUpdate
 
| 1131 || [6.0.0+] FinalizeUsbFirmwareUpdate
Line 1,673: Line 1,820:  
|-
 
|-
 
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
 
| 1134 || [6.0.0+] GetUsbFirmwareUpdateState
 +
|-
 +
| 1135 || [15.0.0+] InitializeUsbFirmwareUpdateWithoutMemory
 
|-
 
|-
 
| 1150 || [8.0.0+] SetTouchScreenMagnification
 
| 1150 || [8.0.0+] SetTouchScreenMagnification
 
|-
 
|-
| 1151 || [9.0.0+] GetTouchScreenFirmwareVersion
+
| 1151 || [9.0.0+] [[#GetTouchScreenFirmwareVersion]]
 
|-
 
|-
 
| 1152 || [9.0.0+] SetTouchScreenDefaultConfiguration
 
| 1152 || [9.0.0+] SetTouchScreenDefaultConfiguration
Line 1,690: Line 1,839:  
| 1157 || [10.0.0+] [[#CancelConnectionTrigger]]
 
| 1157 || [10.0.0+] [[#CancelConnectionTrigger]]
 
|-
 
|-
| 1200 || [10.0.0+] [[#IsButtonConfigSupported]]
+
| 1200 || [10.0.0-17.0.1] [[#IsButtonConfigSupported]]
 
|-
 
|-
| 1201 || [11.0.0+] [[#IsButtonConfigEmbeddedSupported]] ([10.0.0-10.2.0] [[#DeleteButtonConfig]])
+
| 1201 || [11.0.0-17.0.1] [[#IsButtonConfigEmbeddedSupported]] ([10.0.0-10.2.0] [[#DeleteButtonConfig]])
 
|-
 
|-
| 1202 || [11.0.0+] [[#DeleteButtonConfig]] ([10.0.0-10.2.0] [[#SetButtonConfigEnabled]])
+
| 1202 || [11.0.0-17.0.1] [[#DeleteButtonConfig]] ([10.0.0-10.2.0] [[#SetButtonConfigEnabled]])
 
|-
 
|-
| 1203 || [11.0.0+] [[#DeleteButtonConfigEmbedded]] ([10.0.0-10.2.0] [[#IsButtonConfigEnabled]])
+
| 1203 || [11.0.0-17.0.1] [[#DeleteButtonConfigEmbedded]] ([10.0.0-10.2.0] [[#IsButtonConfigEnabled]])
 
|-
 
|-
| 1204 || [11.0.0+] [[#SetButtonConfigEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigEmbedded]])
+
| 1204 || [11.0.0-17.0.1] [[#SetButtonConfigEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigEmbedded]])
 
|-
 
|-
| 1205 || [11.0.0+] [[#SetButtonConfigEmbeddedEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigFull]])
+
| 1205 || [11.0.0-17.0.1] [[#SetButtonConfigEmbeddedEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigFull]])
 
|-
 
|-
| 1206 || [11.0.0+] [[#IsButtonConfigEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigLeft]])
+
| 1206 || [11.0.0-17.0.1] [[#IsButtonConfigEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigLeft]])
 
|-
 
|-
| 1207 || [11.0.0+] [[#IsButtonConfigEmbeddedEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigRight]])
+
| 1207 || [11.0.0-17.0.1] [[#IsButtonConfigEmbeddedEnabled]] ([10.0.0-10.2.0] [[#SetButtonConfigRight]])
 
|-
 
|-
| 1208 || [11.0.0+] [[#SetButtonConfigEmbedded]] ([10.0.0-10.2.0] [[#GetButtonConfigEmbedded]])
+
| 1208 || [11.0.0-17.0.1] [[#SetButtonConfigEmbedded]] ([10.0.0-10.2.0] [[#GetButtonConfigEmbedded]])
 
|-
 
|-
| 1209 || [11.0.0+] [[#SetButtonConfigFull]] ([10.0.0-10.2.0] [[#GetButtonConfigFull]])
+
| 1209 || [11.0.0-17.0.1] [[#SetButtonConfigFull]] ([10.0.0-10.2.0] [[#GetButtonConfigFull]])
 
|-
 
|-
 
| 1210 || [10.0.0-10.2.0] [[#GetButtonConfigLeft]]
 
| 1210 || [10.0.0-10.2.0] [[#GetButtonConfigLeft]]
 
|-
 
|-
| 1211 || [11.0.0+] [[#SetButtonConfigRight]] ([10.0.0-10.2.0] [[#GetButtonConfigRight]])
+
| 1211 || [11.0.0-17.0.1] [[#SetButtonConfigRight]] ([10.0.0-10.2.0] [[#GetButtonConfigRight]])
 
|-
 
|-
| 1212 || [11.0.0+] [[#GetButtonConfigEmbedded]]
+
| 1212 || [11.0.0-17.0.1] [[#GetButtonConfigEmbedded]]
 
|-
 
|-
| 1213 || [11.0.0+] [[#GetButtonConfigFull]]
+
| 1213 || [11.0.0-17.0.1] [[#GetButtonConfigFull]]
 
|-
 
|-
| 1214 || [11.0.0+] [[#GetButtonConfigLeft]]
+
| 1214 || [11.0.0-17.0.1] [[#GetButtonConfigLeft]]
 
|-
 
|-
| 1215 || [11.0.0+] [[#GetButtonConfigRight]]
+
| 1215 || [11.0.0-17.0.1] [[#GetButtonConfigRight]]
 
|-
 
|-
 
| 1250 || [10.0.0+] [[#IsCustomButtonConfigSupported]]
 
| 1250 || [10.0.0+] [[#IsCustomButtonConfigSupported]]
Line 1,806: Line 1,955:  
| 1291 || [11.0.0+] [[#SetButtonConfigStorageRight]]
 
| 1291 || [11.0.0+] [[#SetButtonConfigStorageRight]]
 
|-
 
|-
| 12010 || [11.0.0+] [[#SetButtonConfigLeft]]
+
| 1308 || [18.0.0+] SetButtonConfigVisible
 +
|-
 +
| 1309 || [18.0.0+] IsButtonConfigVisible
 +
|-
 +
| 1320 || [17.0.0+] WakeTouchScreenUp
 +
|-
 +
| 1321 || [17.0.0+] PutTouchScreenToSleep
 +
|-
 +
| 12010 || [11.0.0-17.0.1] [[#SetButtonConfigLeft]]
 
|}
 
|}
   Line 1,877: Line 2,034:  
The specified controller must have a HOME button.
 
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].
+
This sends [https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md#subcommand-0x38-set-home-light subcommand 0x38] to the specified controller, for setting the pattern for the HOME button notification LED. The input structure is converted to the format 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 0x1D-bytes of cmd_argdata initialized from this.
 
+
 
[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}).
+
The layout of cmd_argdata is as follows:
 
+
{| class="wikitable" border="1"
== SetNotificationLedPatternWithTimeout ==
+
|-
Takes an input [[#NotificationLedPattern]], an [[#UniquePadId]], and an s64 TimeSpan, no output.
+
! Offset || Size || Description
 
+
|-
== PrepareHidsForNotificationWake ==
+
| 0x0 || 0x1 || <nowiki>((TimeUnit & 0xF) | ((FrameCount & 0xF) << 4))</nowiki>
Takes a type-0x9 input buffer containing an array of [[#UniquePadId]], no output.
+
|-
 
+
| 0x1 || 0x1 || <nowiki>((CycleCount & 0xF) | ((InitialBrightness & 0xF) << 4))</nowiki>
== IsUsbConnected ==
+
|-
Tales an input [[#UniquePadId]], returns an output bool.
+
| 0x2 || 0x1 || <nowiki>((Frame2Brightness & 0xF) | ((Frame1Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x3 || 0x1 || <nowiki>((Frame1TimeToHold & 0xF) | ((Frame1TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x4 || 0x1 || <nowiki>((Frame2TimeToHold & 0xF) | ((Frame2TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x5 || 0x1 || <nowiki>((Frame4Brightness & 0xF) | ((Frame3Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x6 || 0x1 || <nowiki>((Frame3TimeToHold & 0xF) | ((Frame3TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x7 || 0x1 || <nowiki>((Frame4TimeToHold & 0xF) | ((Frame4TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x8 || 0x1 || <nowiki>((Frame6Brightness & 0xF) | ((Frame5Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x9 || 0x1 || <nowiki>((Frame5TimeToHold & 0xF) | ((Frame5TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xA || 0x1 || <nowiki>((Frame6TimeToHold & 0xF) | ((Frame6TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xB || 0x1 || <nowiki>((Frame8Brightness & 0xF) | ((Frame7Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xC || 0x1 || <nowiki>((Frame7TimeToHold & 0xF) | ((Frame7TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xD || 0x1 || <nowiki>((Frame8TimeToHold & 0xF) | ((Frame8TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xE || 0x1 || <nowiki>((Frame10Brightness & 0xF) | ((Frame9Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0xF || 0x1 || <nowiki>((Frame9TimeToHold & 0xF) | ((Frame9TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x10 || 0x1 || <nowiki>((Frame10TimeToHold & 0xF) | ((Frame10TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x11 || 0x1 || <nowiki>((Frame12Brightness & 0xF) | ((Frame11Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x12 || 0x1 || <nowiki>((Frame11TimeToHold & 0xF) | ((Frame11TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x13 || 0x1 || <nowiki>((Frame12TimeToHold & 0xF) | ((Frame12TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x14 || 0x1 || <nowiki>((Frame14Brightness & 0xF) | ((Frame13Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x15 || 0x1 || <nowiki>((Frame13TimeToHold & 0xF) | ((Frame13TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x16 || 0x1 || <nowiki>((Frame14TimeToHold & 0xF) | ((Frame14TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x17 || 0x1 || <nowiki>((Reserved & 0xF) | ((Frame15Brightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x18 || 0x1 || <nowiki>((Frame15TimeToHold & 0xF) | ((Frame15TimeTowards & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x19 || 0x1 || <nowiki>((Reserved & 0xF) | ((Reserved & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x1A || 0x1 || <nowiki>((TimeTowardsFinalBrightness & 0xF) | ((FinalBrightness & 0xF) << 4))</nowiki>
 +
|-
 +
| 0x1B || 0x1 || <nowiki>(Timeout & 0xFF)</nowiki>
 +
|-
 +
| 0x1C || 0x1 || <nowiki>((Timeout >> 8) & 0xFF)</nowiki>
 +
|}
 +
 
 +
[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 [[#UniquePadId]], and an s64 TimeSpan, no output.
 +
 
 +
== PrepareHidsForNotificationWake ==
 +
Takes a type-0x9 input buffer containing an array of [[#UniquePadId]], no output.
 +
 
 +
== IsUsbConnected ==
 +
Tales an input [[#UniquePadId]], returns an output bool.
    
== NotifyInputDetector ==
 
== NotifyInputDetector ==
Line 1,897: Line 2,118:  
== GetHidbusSystemServiceObject ==
 
== GetHidbusSystemServiceObject ==
 
No input, returns an [[#IHidbusSystemServer]].
 
No input, returns an [[#IHidbusSystemServer]].
 +
 +
== GetTouchScreenFirmwareVersion ==
 +
No input. Returns a [[#FirmwareVersion]].
 +
 +
This requests the current firmware version from the touch screen IC.
 +
 +
It first ensures the touch screen IC's chip id is one of the following:
 +
0x7036 - Ftm4cd60d (STMicroelectronics FingerTipS FT9CJ/FT9CF)
 +
0x4036 - Fst2ba61ya1
 +
 +
Then constructs the final firmware version as follows:
 +
uint32_t FtsVersion = GetFtsReleasedVer();    // Matches the xxxx value found in the FTS_xxxx.fts256 and FTS_xxxx.ftb firmware files.
 +
 +
uint8_t FtsVersionByte0 = (FtsVersion & 0xFF);
 +
uint8_t FtsVersionByte1 = (FtsVersion & 0xFF00);
 +
uint8_t FtsVersionByte2 = (FtsVersion & 0xFF0000);
 +
uint8_t FtsVersionByte3 = (FtsVersion & 0xFF000000);
 +
 +
uint8_t FirmwareVersionByte0 = FtsVersionByte3;
 +
uint8_t FirmwareVersionByte1 = FtsVersionByte2;
 +
uint8_t FirmwareVersionByte2 = FtsVersionByte1;
 +
uint8_t FirmwareVersionByte3 = FtsVersionByte0;
 +
 +
if (FtsVersionByte3 <= 0x31) {
 +
    FirmwareVersionByte3 = 0;
 +
    FirmwareVersionByte1 = 0;
 +
    FirmwareVersionByte0 = 0x31;
 +
 +
    if (FtsVersionByte2 == 0x5) {
 +
        FirmwareVersionByte2 = 2;
 +
    } else if (FtsVersionByte2 == 0x12) {
 +
        FirmwareVersionByte2 = 0;
 +
    } else if (FtsVersionByte2 == 0x1A) {
 +
        FirmwareVersionByte2 = 1;
 +
    } else {
 +
        // Throw error.
 +
    }
 +
}
 +
 +
uint8_t FirmwareVersion[0x10] = {0};
 +
*(uint32_t *)FirmwareVersion = (FirmwareVersionByte3 << 24) | (FirmwareVersionByte2 << 16) | (FirmwareVersionByte1 << 8) | FirmwareVersionByte0;
 +
*((uint32_t *)FirmwareVersion + 1) = 0x5354;  // "TS"
 +
 +
return FirmwareVersion;
    
== IsFirmwareAvailableForNotification ==
 
== IsFirmwareAvailableForNotification ==
Line 3,144: Line 3,409:  
| 0x1C
 
| 0x1C
 
| [5.0.0+] [[#ConsoleSixAxisSensorSharedMemoryFormat|ConsoleSixAxisSensor]]
 
| [5.0.0+] [[#ConsoleSixAxisSensorSharedMemoryFormat|ConsoleSixAxisSensor]]
 +
|-
 +
| 0x3DC00
 +
| 0x400
 +
| [16.0.0+] [[#MouseSharedMemoryFormat|DebugMouse]]
 
|}
 
|}
   Line 4,450: Line 4,719:  
|-
 
|-
 
| 0x0
 
| 0x0
| 0x43F0 ([1.0.0-8.1.0] 0x4410)
+
| 0x43F8 ([9.0.0-12.1.0] 0x43F0, [1.0.0-8.1.0] 0x4410)
 
| [[#NpadInternalState]]
 
| [[#NpadInternalState]]
 
|}
 
|}
Line 4,598: Line 4,867:  
| 0x4
 
| 0x4
 
| [[#NpadLagerType|LagerType]]
 
| [[#NpadLagerType|LagerType]]
 +
|-
 +
| 0x43F0
 +
| 0x1 * 6
 +
| [13.0.0+] Array of [[#SixAxisSensorProperties]]
 
|}
 
|}
   Line 6,733: Line 7,006:  
|-
 
|-
 
| 31
 
| 31
| LagonCLeft (Left C button in N64 controller)
+
| [12.0.0+] LeftC (Left C button in N64 controller)
 
|-
 
|-
 
| 32
 
| 32
| LagonCUp (Up C button in N64 controller)
+
| [12.0.0+] UpC (Up C button in N64 controller)
 
|-
 
|-
 
| 33
 
| 33
| LagonCRight (Right C button in N64 controller)
+
| [12.0.0+] RightC (Right C button in N64 controller)
 
|-
 
|-
 
| 34
 
| 34
| LagonCDown (Down C button in N64 controller)
+
| [12.0.0+] DownC (Down C button in N64 controller)
 
|}
 
|}
   Line 6,760: Line 7,033:  
!  Bits
 
!  Bits
 
!  Description
 
!  Description
!  Notes
   
|-
 
|-
 
| 0
 
| 0
| NpadStyleFullKey
+
| NpadStyleFullKey (Pro Controller)
| Pro Controller
   
|-
 
|-
 
| 1
 
| 1
| NpadStyleHandheld
+
| NpadStyleHandheld (Joy-Con controller in handheld mode)
| Joy-Con controller in handheld mode
   
|-
 
|-
 
| 2
 
| 2
| NpadStyleJoyDual
+
| NpadStyleJoyDual (Joy-Con controller in dual mode)
| Joy-Con controller in dual mode
   
|-
 
|-
 
| 3
 
| 3
| NpadStyleJoyLeft
+
| NpadStyleJoyLeft (Joy-Con left controller in single mode)
| Joy-Con left controller in single mode
   
|-
 
|-
 
| 4
 
| 4
| NpadStyleJoyRight
+
| NpadStyleJoyRight (Joy-Con right controller in single mode)
| Joy-Con right controller in single mode
   
|-
 
|-
 
| 5
 
| 5
| NpadStyleGc
+
| NpadStyleGc (GameCube controller)
| GameCube controller
   
|-
 
|-
 
| 6
 
| 6
| NpadStylePalma
+
| NpadStylePalma (Poké Ball Plus controller)
| Poké Ball Plus controller
   
|-
 
|-
 
| 7
 
| 7
| NpadStyleLark
+
| NpadStyleLark (NES/Famicom controller)
| NES/Famicom controller
   
|-
 
|-
 
| 8
 
| 8
| NpadStyleHandheldLark
+
| NpadStyleHandheldLark (NES/Famicom controller in handheld mode)
| NES/Famicom controller in handheld mode
   
|-
 
|-
 
| 9
 
| 9
| NpadStyleLucia
+
| NpadStyleLucia (SNES controller)
| SNES controller
   
|-
 
|-
 
| 10
 
| 10
| NpadStyleLagon
+
| [12.0.0+] NpadStyleLagon (N64 controller)
| N64 controller
   
|-
 
|-
 
| 11
 
| 11
| NpadStyleLager
+
| [13.0.0+] NpadStyleLager (Sega Genesis controller)
| Sega Genesis controller
   
|-
 
|-
 
| 12-28
 
| 12-28
 
| Reserved
 
| Reserved
|
   
|-
 
|-
 
| 29
 
| 29
| NpadStyleSystemExt
+
| NpadStyleSystemExt (generic external controller)
| Generic external controller
   
|-
 
|-
 
| 30
 
| 30
| NpadStyleSystem
+
| NpadStyleSystem (generic controller)
| Generic controller
   
|-
 
|-
 
| 31
 
| 31
 
| Reserved
 
| Reserved
|
   
|}
 
|}
    
= NpadDeviceTypeSet =
 
= NpadDeviceTypeSet =
This is "nn::hid::system::NpadDeviceType". This is a BitFlagSet object for [[#NpadDeviceType]].
+
This is "nn::hid::system::NpadDeviceTypeSet". This is a BitFlagSet object for [[#DeviceType|NpadDeviceType]].
    
= NpadSystemPropertiesSet =
 
= NpadSystemPropertiesSet =
Line 6,834: Line 7,090:     
= NpadSystemProperties =
 
= NpadSystemProperties =
This is "nn::hid::NpadSystemProperties". This is a 64-bit flag.
+
This is "nn::hid::detail::NpadSystemProperties". This is a 64-bit flag.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,047: Line 7,303:  
|}
 
|}
   −
= AppletDetailedUiType =
+
= FirmwareVersion =
This is "nn::hid::system::AppletDetailedUiType".
+
This is "nn::hid::system::FirmwareVersion" ([1.0.0-2.3.0] "nn::hid::debug::FirmwareVersion").
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0x00000000 || None
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x01000000 || HandheldNone
+
| 0x0
 +
| 0x1
 +
| Major
 
|-
 
|-
| 0x02000000 || HandheldJoyConLeftOnly
+
| 0x1
 +
| 0x1
 +
| Minor
 +
|-
 +
| 0x2
 +
| 0x1
 +
| Micro
 +
|-
 +
| 0x3
 +
| 0x1
 +
| Revision
 +
|-
 +
| 0x4
 +
| 0xC
 +
| [3.0.0+] [[#DeviceIdentifier]]
 +
|}
 +
 
 +
== DeviceIdentifier ==
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| "JR" || Joy-Con right controller
 +
|-
 +
| "JL" || Joy-Con left controller
 +
|-
 +
| "FK" || Pro Controller
 +
|-
 +
| "MY" || [[#DeviceTypeInternal|DeviceType]] 4 and [[#DeviceTypeInternal|DeviceType]] 5
 +
|-
 +
| "LC" || "Tarragon" ([[#DeviceTypeInternal|DeviceType]] 6) and [[#DeviceTypeInternal|DeviceType]] 30
 +
|-
 +
| "HL" || Famicom left controller
 +
|-
 +
| "HR" || Famicom right controller (with microphone)
 +
|-
 +
| "NL" || NES left controller
 +
|-
 +
| "NR" || NES right controller
 +
|-
 +
| "SN" || SNES controller
 +
|-
 +
| "LT" || N64 controller
 +
|-
 +
| "LS" || Sega Genesis controller
 +
|-
 +
| "PB" || Poké Ball Plus controller
 +
|-
 +
| "SH" || SioH
 +
|-
 +
| "TS" || TouchScreen
 +
|}
 +
 
 +
= AppletDetailedUiType =
 +
This is "nn::hid::system::AppletDetailedUiType".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0x00000000 || None
 +
|-
 +
| 0x01000000 || HandheldNone
 +
|-
 +
| 0x02000000 || HandheldJoyConLeftOnly
 
|-
 
|-
 
| 0x02000001 || HandheldLarkHvc1Only
 
| 0x02000001 || HandheldLarkHvc1Only
Line 7,220: Line 7,542:  
| 2 || Rail
 
| 2 || Rail
 
|-
 
|-
| 3 || USB
+
| 3 || Usb
 
|-
 
|-
| 4 || Unknown
+
| 4 || Embedded
 
|}
 
|}
   Line 7,273: Line 7,595:  
|-
 
|-
 
| 3 || U
 
| 3 || U
 +
|}
 +
 +
= SixAxisSensorProperties =
 +
This is "nn::hid::server::SixAxisSensorProperties".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Bit
 +
! Description
 +
|-
 +
| 0
 +
| IsSixAxisSensorDeviceNewlyAssigned
 +
|-
 +
| 1
 +
| IsFirmwareUpdateAvailableForSixAxisSensor
 
|}
 
|}
   Line 7,380: Line 7,717:  
|-
 
|-
 
| 16
 
| 16
| Lagon
+
| [12.0.0+] Lagon
 
|-
 
|-
 
| 17
 
| 17
| Lager
+
| [13.0.0+] Lager
 
|-
 
|-
 
| 18-30
 
| 18-30
Line 7,439: Line 7,776:  
!  Description
 
!  Description
 
|-
 
|-
| 1 || JoyRight, HandheldRight || RightController || JoyDual, JoyRightHorizontal, JoyRightVertical, JoyDualRightOnly, HandheldJoyConRightOnly, HandheldJoyConLeftJoyConRight, HandheldLarkHvc1JoyConRight, HandheldLarkNesLeftJoyConRight, HandheldNone || Joy-Con right controller
+
| 0 || || || || Invalid
 
|-
 
|-
| 2 || JoyLeft, HandheldLeft || LeftController || JoyDual, JoyLeftHorizontal, JoyLeftVertical, JoyDualLeftOnly, HandheldJoyConLeftOnly, HandheldJoyConLeftJoyConRight, HandheldJoyConLeftLarkHvc2, HandheldJoyConLeftLarkNesRight, HandheldNone || Joy-Con left controller
+
| 1 || JoyRight, HandheldRight || RightController || JoyDual, JoyRightHorizontal, JoyRightVertical, JoyDualRightOnly, HandheldJoyConRightOnly, HandheldJoyConLeftJoyConRight, HandheldLarkHvc1JoyConRight, HandheldLarkNesLeftJoyConRight, HandheldNone || Joy-Con right controller (USB PID 0x2007)
 
|-
 
|-
| 3 || FullKey || FullKeyController || SwitchProController || Pro Controller
+
| 2 || JoyLeft, HandheldLeft || LeftController || JoyDual, JoyLeftHorizontal, JoyLeftVertical, JoyDualLeftOnly, HandheldJoyConLeftOnly, HandheldJoyConLeftJoyConRight, HandheldJoyConLeftLarkHvc2, HandheldJoyConLeftLarkNesRight, HandheldNone || Joy-Con left controller (USB PID 0x2006)
 
|-
 
|-
| 4 || JoyLeft || LeftController || || Reserved
+
| 3 || FullKey || FullKeyController || SwitchProController || Pro Controller (USB PID 0x2009)
 
|-
 
|-
| 5 || JoyRight || RightController || || Reserved
+
| 4 || JoyLeft || LeftController || ||
 
|-
 
|-
| 6 || FullKey || FullKeyController || || Reserved
+
| 5 || JoyRight || RightController || ||
 +
|-
 +
| 6 || FullKey || FullKeyController || || "Tarragon" controller
 
|-
 
|-
 
| 7 || LarkHvcLeft, HandheldLarkHvcLeft || LeftController || LarkHvc1, HandheldLarkHvc1Only, HandheldLarkHvc1JoyConRight, HandheldLarkHvc1LarkHvc2, HandheldLarkHvc1LarkNesRight, HandheldNone || Famicom left controller
 
| 7 || LarkHvcLeft, HandheldLarkHvcLeft || LeftController || LarkHvc1, HandheldLarkHvc1Only, HandheldLarkHvc1JoyConRight, HandheldLarkHvc1LarkHvc2, HandheldLarkHvc1LarkNesRight, HandheldNone || Famicom left controller
Line 7,459: Line 7,798:  
| 10 || LarkNesRight, HandheldLarkNesRight || RightController || LarkNesRight, HandheldLarkNesRightOnly, HandheldJoyConLeftLarkNesRight, HandheldLarkHvc1LarkNesRight, HandheldLarkNesLeftLarkNesRight, HandheldNone || NES right controller
 
| 10 || LarkNesRight, HandheldLarkNesRight || RightController || LarkNesRight, HandheldLarkNesRightOnly, HandheldJoyConLeftLarkNesRight, HandheldLarkHvc1LarkNesRight, HandheldLarkNesLeftLarkNesRight, HandheldNone || NES right controller
 
|-
 
|-
| 11 || Lucia || FullKeyController || LuciaU, LuciaJ, LuciaE || SNES controller
+
| 11 || Lucia || FullKeyController || LuciaU, LuciaJ, LuciaE || SNES controller (USB PID 0x2017)
 
|-
 
|-
 
| 12 || Palma || Embedded || Unknown || Poké Ball Plus controller
 
| 12 || Palma || Embedded || Unknown || Poké Ball Plus controller
Line 7,465: Line 7,804:  
| 13 || FullKey || FullKeyController || || Gc controller
 
| 13 || FullKey || FullKeyController || || Gc controller
 
|-
 
|-
| 14 || HandheldLeft || LeftController || || Reserved
+
| 14 || HandheldLeft || LeftController || || "Fifty" left controller
 
|-
 
|-
| 15 || FullKey || FullKeyController || || Reserved
+
| 15 || FullKey || FullKeyController || ||
 
|-
 
|-
| 16 || FullKey || FullKeyController || || Reserved
+
| 16 || FullKey || FullKeyController || ||
 
|-
 
|-
 
| 17 || DebugPad || DebugPadController || Verification || Debug controller
 
| 17 || DebugPad || DebugPadController || Verification || Debug controller
 
|-
 
|-
| 18 || HandheldRight || RightController || || Reserved
+
| 18 || HandheldRight || RightController || || "Fifty" right controller
 
|-
 
|-
 
| 19 || System || Embedded || CompatibleProController || Third party Pro Controller
 
| 19 || System || Embedded || CompatibleProController || Third party Pro Controller
Line 7,481: Line 7,820:  
| 21 || System || Embedded || CompatibleJoyCon, HandheldNone || Third party Joy-Con left controller
 
| 21 || System || Embedded || CompatibleJoyCon, HandheldNone || Third party Joy-Con left controller
 
|-
 
|-
| 22 || Lagon || FullKeyController || Lagon || N64 controller
+
| [12.0.0+] 22 || Lagon || FullKeyController || Lagon || N64 controller (USB PID 0x2019)
 
|-
 
|-
| 28 || Lager || FullKeyController || || Sega Genesis controller
+
| [12.0.0+] 23 || || || || Joy-Con Charging Grip (USB PID 0x200E)
|}
+
|-
 
+
| [13.0.0+] 24 || || || || "Kotetsu" (Pro Controller MCU) in DFU mode (USB PID 0x200F)
= NpadPowerInfo =
+
|-
This is "nn::hid::system::NpadPowerInfo".
+
| [13.0.0+] 25 || || || || "Kuina" (Joy-Con Charging Grip MCU) in DFU mode (USB PID 0x2008)
 
+
|-
{| class="wikitable" border="1"
+
| [13.0.0+] 26 || || || || SNES controller MCU in DFU mode (USB PID 0x2018)
 +
|-
 +
| [13.0.0+] 27 || || || || N64 controller MCU in DFU mode (USB PID 0x201A)
 +
|-
 +
| [13.0.0+] 28 || Lager || FullKeyController || || Sega Genesis controller (USB PID 0x201E)
 +
|-
 +
| [14.0.0+] 29 || || || || Sega Genesis controller MCU in DFU mode (USB PID 0x201F)
 +
|-
 +
| [14.0.0+] 30 || FullKey || FullKeyController || ||
 +
|}
 +
 
 +
= VidPidDefinition =
 +
This is "nn::hidtypes::VidPidDefinition".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
 
! Offset
 
! Offset
Line 7,496: Line 7,849:  
|-
 
|-
 
| 0x0
 
| 0x0
| 0x1
+
| 0x2
| IsPowered
+
| Vid
 
|-
 
|-
| 0x1
+
| 0x2
| 0x1
+
| 0x2
| IsCharging
+
| PidRangeMax
 
|-
 
|-
 +
| 0x4
 
| 0x2
 
| 0x2
 +
| PidRangeMin
 +
|-
 
| 0x6
 
| 0x6
 +
| 0x1
 +
| [[#DeviceTypeInternal|DeviceType]]
 +
|-
 +
| 0x7
 +
| 0x1
 
| Reserved
 
| Reserved
|-
  −
| 0x8
  −
| 0x6
  −
| [[#BatteryLevel|BatteryLevel]]
   
|}
 
|}
   −
= BatteryLevel =
+
= VidPidDefinitions =
This is "nn::hid::system::NpadBatteryLevel". This is a 4 byte value.
+
This is "nn::hidtypes::detail::VidPidDefinitions". This is a list of [[#VidPidDefinition|VidPidDefinition]] objects maintained by the hid-sysmodule.
 
  −
= ConsoleSixAxisSensorHandle =
  −
This is "nn::hid::ConsoleSixAxisSensorHandle". This is a 4-byte struct with 4-byte alignment.
  −
 
  −
sdknso GetConsoleSixAxisSensorHandle always returns a handle with value 0x13.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Vid || PidRangeMax || PidRangeMin || [[#DeviceTypeInternal|DeviceType]]
 +
|-
 +
| 0x57E || 0x2006 || 0x2006 || 2
 
|-
 
|-
| 0x0 || 0x4 || TypeValue
+
| 0x57E || 0x2007 || 0x2007 || 1
 
|-
 
|-
| 0x0 || 0x1 ||  
+
| 0x57E || 0x2009 || 0x2009 || 3
 
|-
 
|-
| 0x1 || 0x1 ||  
+
| 0x57E || 0x200F || 0x200F || 24
|}
  −
 
  −
= SixAxisSensorHandle =
  −
This is "nn::hid::SixAxisSensorHandle". This is a 4-byte struct with 4-byte alignment.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x57E || 0x200E || 0x200E || 23
 
|-
 
|-
| 0x0 || 0x4 || TypeValue
+
| 0x57E || 0x2008 || 0x2008 || 25
 
|-
 
|-
| 0x0 || 0x1 || NpadStyleIndex
+
| 0x57E || 0x2017 || 0x2017 || 11
 
|-
 
|-
| 0x1 || 0x1 || [[#NpadIdType|PlayerNumber]]
+
| 0x57E || 0x2018 || 0x2018 || 26
 
|-
 
|-
| 0x2 || 0x1 || DeviceIdx
+
| 0x57E || 0x2019 || 0x2019 || 22
|}
  −
 
  −
= VibrationDeviceHandle =
  −
This is "nn::hid::VibrationDeviceHandle". This is a 4-byte struct with 4-byte alignment.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x57E || 0x201A || 0x201A || 27
 
|-
 
|-
| 0x0 || 0x4 || TypeValue
+
| 0x57E || 0x201E || 0x201E || 28
 
|-
 
|-
| 0x0 || 0x1 || NpadStyleIndex
+
| 0x57E || 0x201F || 0x201F || 29
 
|-
 
|-
| 0x1 || 0x1 || [[#NpadIdType|PlayerNumber]]
+
| 0x57E || 0x337 || 0x337 || 13
 
|-
 
|-
| 0x2 || 0x1 || DeviceIdx
+
| 0x57E || 0x300E || 0x300E || [17.0.0+] 18
|}
+
|-
 
+
| 0x57E || 0x300D || 0x300D || [17.0.0+] 14
= VibrationDeviceInfo =
  −
This is "nn::hid::VibrationDeviceInfo" / "nn::hid::VibrationDeviceInfoForIpc". This is a 0x8-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0xF0D || 0x92 || 0x92 || 15
 
|-
 
|-
| 0x0 || 0x4 || [[#VibrationDeviceType|DeviceType]]
+
| 0xF0D || 0xAB || 0xAA || 15
 
|-
 
|-
| 0x4 || 0x4 || [[#VibrationDevicePosition|Position]]
+
| 0xF0D || 0xC1 || 0xC1 || 15
|}
  −
 
  −
= VibrationDeviceType =
  −
This is "nn::hid::VibrationDeviceType".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Unknown
+
| 0xF0D || 0xFF || 0xF0 || 15
 
|-
 
|-
| 1 || LinearResonantActuator
+
| 0xF0D || 0x22F || 0x200 || 15
 
|-
 
|-
| 2 || GcErm
+
| 0xE6F || 0x193 || 0x180 || 15
|}
  −
 
  −
= VibrationDevicePosition =
  −
This is "nn::hid::VibrationDevicePosition".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || None
+
| 0x20D6 || 0xA719 || 0xA710 || 15
 
|-
 
|-
| 1 || Left
+
| 0x20D6 || 0xA729 || 0xA720 || 15
 
|-
 
|-
| 2 || Right
+
| 0x33DD || 0xB || 0x1 || 15
 
|}
 
|}
   −
= VibrationValue =
+
= NpadPowerInfo =
This is "nn::hid::VibrationValue". This is a 0x10-byte struct, which contains 4 float values.
+
This is "nn::hid::system::NpadPowerInfo".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,613: Line 7,935:  
|-
 
|-
 
| 0x0
 
| 0x0
| 0x4
+
| 0x1
| AmplitudeLow
+
| IsPowered
 +
|-
 +
| 0x1
 +
| 0x1
 +
| IsCharging
 
|-
 
|-
| 0x4
+
| 0x2
| 0x4
+
| 0x6
| FrequencyLow
+
| Reserved
 
|-
 
|-
 
| 0x8
 
| 0x8
 
| 0x4
 
| 0x4
| AmplitudeHigh
+
| [[#BatteryLevel|BatteryLevel]]
|-
  −
| 0xC
  −
| 0x4
  −
| FrequencyHigh
   
|}
 
|}
   −
= VibrationGcErmCommand =
+
= BatteryLevel =
This is "nn::hid::VibrationGcErmCommand".
+
This is "nn::hid::system::NpadBatteryLevel". This is a 4 byte value.
 +
 
 +
= ConsoleSixAxisSensorHandle =
 +
This is "nn::hid::ConsoleSixAxisSensorHandle". This is a 4-byte struct with 4-byte alignment.
 +
 
 +
sdknso GetConsoleSixAxisSensorHandle always returns a handle with value 0x13.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Name
  −
!  Description
   
|-
 
|-
| 0 || Stop || Stops the vibration with a decay phase.
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || TypeValue
 
|-
 
|-
| 1 || Start || Starts the vibration.
+
| 0x0 || 0x1 ||  
 
|-
 
|-
| 2 || StopHard || Stops the vibration immediately, with no decay phase.
+
| 0x1 || 0x1 ||  
 
|}
 
|}
   −
= AccelerometerPlayMode =
+
= SixAxisSensorHandle =
This is "nn::hid::debug::AccelerometerPlayMode" (pre-10.0.0 this is "nn::hid::AccelerometerPlayMode").
+
This is "nn::hid::SixAxisSensorHandle". This is a 4-byte struct with 4-byte alignment.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Loose
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || TypeValue
 +
|-
 +
| 0x0 || 0x1 || NpadStyleIndex
 +
|-
 +
| 0x1 || 0x1 || [[#NpadIdType|PlayerNumber]]
 
|-
 
|-
| 1 || Tight
+
| 0x2 || 0x1 || DeviceIdx
 
|}
 
|}
   −
= GyroscopeZeroDriftMode =
+
= VibrationDeviceHandle =
This is "nn::hid::GyroscopeZeroDriftMode".
+
This is "nn::hid::VibrationDeviceHandle". This is a 4-byte struct with 4-byte alignment.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Loose
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || TypeValue
 +
|-
 +
| 0x0 || 0x1 || NpadStyleIndex
 
|-
 
|-
| 1 || Standard
+
| 0x1 || 0x1 || [[#NpadIdType|PlayerNumber]]
 
|-
 
|-
| 2 || Tight
+
| 0x2 || 0x1 || DeviceIdx
 
|}
 
|}
   −
= PalmaConnectionHandle =
+
= VibrationDeviceInfo =
This is "nn::hid::PalmaConnectionHandle". This is a 0x8-byte struct with 8-byte alignment.
+
This is "nn::hid::VibrationDeviceInfo" / "nn::hid::VibrationDeviceInfoForIpc". This is a 0x8-byte struct.
 
  −
= PalmaOperationInfo =
  −
This is "nn::hid::PalmaOperationInfo". This is a 0x148-byte struct.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,680: Line 8,009:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#PalmaOperationType]]
+
| 0x0 || 0x4 || [[#VibrationDeviceType|DeviceType]]
 
|-
 
|-
| 0x4 || 0x4 || Result
+
| 0x4 || 0x4 || [[#VibrationDevicePosition|Position]]
|-
  −
| 0x8 || 0x140 || Buffer for [[#GetPalmaOperationInfo]].
   
|}
 
|}
   −
= PalmaOperationType =
+
= VibrationDeviceType =
This is "nn::hid::PalmaOperationType".
+
This is "nn::hid::VibrationDeviceType".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,694: Line 8,021:  
!  Description
 
!  Description
 
|-
 
|-
| 0 || PlayActivity
+
| 0 || Unknown
 
|-
 
|-
| 1 || SetFrModeType
+
| 1 || LinearResonantActuator
 
|-
 
|-
| 2 || ReadStep
+
| 2 || GcErm
|-
  −
| 3 || EnableStep
  −
|-
  −
| 4 || ResetStep
  −
|-
  −
| 5 || ReadApplicationSection
   
|-
 
|-
| 6 || WriteApplicationSection
+
| 3 || Erm
|-
  −
| 7 || ReadUniqueCode
  −
|-
  −
| 8 || SetUniqueCodeInvalid
  −
|-
  −
| 9 || WriteActivityEntry
  −
|-
  −
| 10 || WriteRgbLedPatternEntry
  −
|-
  −
| 11 || WriteWaveEntry
  −
|-
  −
| 12 || ReadDataBaseIdentificationVersion
  −
|-
  −
| 13 || WriteDataBaseIdentificationVersion
  −
|-
  −
| 14 || SuspendFeature
  −
|-
  −
| [[5.1.0]]+ 15 || ReadPlayLog
  −
|-
  −
| [[5.1.0]]+ 16 || ResetPlayLog
   
|}
 
|}
   −
= PalmaFrModeType =
+
= VibrationDevicePosition =
This is "nn::hid::PalmaFrModeType".
+
This is "nn::hid::VibrationDevicePosition".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,736: Line 8,037:  
!  Description
 
!  Description
 
|-
 
|-
| 0 || Off
+
| 0 || None
 
|-
 
|-
| 1 || B01
+
| 1 || Left
 
|-
 
|-
| 2 || B02
+
| 2 || Right
|-
  −
| 3 || B03
  −
|-
  −
| 4 || Downloaded
   
|}
 
|}
   −
= PalmaApplicationSectionAccessBuffer =
+
= VibrationValue =
This is "nn::hid::PalmaApplicationSectionAccessBuffer". This is a 0x100-byte struct.
+
This is "nn::hid::VibrationValue". This is a 0x10-byte struct, which contains 4 float values.
 
  −
= PalmaActivityEntry =
  −
This is "nn::hid::PalmaActivityEntry".
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x2 || RgbLedPatternIndex.
+
| 0x0
 +
| 0x4
 +
| AmplitudeLow
 
|-
 
|-
| 0x2 || 0x2 || Padding
+
| 0x4
 +
| 0x4
 +
| FrequencyLow
 
|-
 
|-
| 0x4 || 0x4 || [[#PalmaWaveSet|WaveSet]].
+
| 0x8
 +
| 0x4
 +
| AmplitudeHigh
 
|-
 
|-
| 0x8 || 0x2 || WaveIndex.
+
| 0xC
 +
| 0x4
 +
| FrequencyHigh
 
|}
 
|}
   −
= PalmaWaveSet =
+
= VibrationGcErmCommand =
This is "nn::hid::PalmaWaveSet".
+
This is "nn::hid::VibrationGcErmCommand".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  Value
 
!  Value
 +
!  Name
 
!  Description
 
!  Description
 
|-
 
|-
| 0 || Small
+
| 0 || Stop || Stops the vibration with a decay phase.
 
|-
 
|-
| 1 || Medium
+
| 1 || Start || Starts the vibration.
 
|-
 
|-
| 2 || Large
+
| 2 || StopHard || Stops the vibration immediately, with no decay phase.
 
|}
 
|}
   −
= PalmaFeature =
+
= AccelerometerPlayMode =
This is "nn::hid::PalmaFeature".
+
This is "nn::hid::debug::AccelerometerPlayMode" (pre-10.0.0 this is "nn::hid::AccelerometerPlayMode").
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Bit
+
| 0 || Loose
! Description
  −
|-
  −
| 0
  −
| FrMode
  −
|-
  −
| 1
  −
| RumbleFeedback
  −
|-
  −
| 2
  −
| Step
  −
|-
  −
| 3
  −
| MuteSwitch
   
|-
 
|-
 +
| 1 || Tight
 
|}
 
|}
   −
= AbstractedPadState =
+
= GyroscopeZeroDriftMode =
 +
This is "nn::hid::GyroscopeZeroDriftMode".
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || Loose
 
|-
 
|-
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
+
| 1 || Standard
 
|-
 
|-
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
+
| 2 || Tight
 +
|}
 +
 
 +
= PalmaConnectionHandle =
 +
This is "nn::hid::PalmaConnectionHandle". This is a 0x8-byte struct with 8-byte alignment.
 +
 
 +
= PalmaOperationInfo =
 +
This is "nn::hid::PalmaOperationInfo". This is a 0x148-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x5 || 0x3 || Padding
+
! Offset || Size || Description
 
|-
 
|-
| 0x8 || 0x4 || RGBA Single Body Color
+
| 0x0 || 0x4 || [[#PalmaOperationType]]
 
|-
 
|-
| 0xC || 0x4 || RGBA Single Buttons Color
+
| 0x4 || 0x4 || Result
 
|-
 
|-
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
+
| 0x8 || 0x140 || Buffer for [[#GetPalmaOperationInfo]].
|-
  −
| 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.
+
= PalmaOperationType =
 +
This is "nn::hid::PalmaOperationType".
   −
Type:
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Bits
+
Value
!  [[#HdlsDeviceInfo]]::type bits
   
!  Description
 
!  Description
!  Notes
   
|-
 
|-
| 0 || 0 || ||
+
| 0 || PlayActivity
 
|-
 
|-
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
+
| 1 || SetFrModeType
 
|-
 
|-
| 2 || 1 || ||
+
| 2 || ReadStep
 
|-
 
|-
| 3 || 2 || ||
+
| 3 || EnableStep
 
|-
 
|-
| 4 || 1 || ||
+
| 4 || ResetStep
 
|-
 
|-
| 5 || 2 || ||
+
| 5 || ReadApplicationSection
 
|-
 
|-
| 6 || 3 || ||
+
| 6 || WriteApplicationSection
 
|-
 
|-
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
+
| 7 || ReadUniqueCode
 
|-
 
|-
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
+
| 8 || SetUniqueCodeInvalid
 
|-
 
|-
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
+
| 9 || WriteActivityEntry
 
|-
 
|-
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
+
| 10 || WriteRgbLedPatternEntry
 
|-
 
|-
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
+
| 11 || WriteWaveEntry
 
|-
 
|-
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
+
| 12 || ReadDataBaseIdentificationVersion
 
|-
 
|-
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
+
| 13 || WriteDataBaseIdentificationVersion
 
|-
 
|-
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
+
| 14 || SuspendFeature
 
|-
 
|-
| 15 || 17 || ||
+
| 15 || [5.1.0+] ReadPlayLog
|-
  −
| 31 || 21 || || [[#DeviceType]] = BIT(31)
   
|-
 
|-
 +
| 16 || [5.1.0+] ResetPlayLog
 
|}
 
|}
   −
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
+
= PalmaFrModeType =
 
+
This is "nn::hid::PalmaFrModeType".
= DebugPadAutoPilotState =
  −
This is "nn::hid::debug::DebugPadAutoPilotState"
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset
+
| 0 || Off
! Size
  −
! Description
   
|-
 
|-
| 0x0
+
| 1 || B01
| 0x4
  −
| [[#DebugPadAttributeSet|Attributes]]
   
|-
 
|-
| 0x4
+
| 2 || B02
| 0x4
  −
| [[#DebugPadButtonSet|Buttons]]
   
|-
 
|-
| 0x8
+
| 3 || B03
| 0x8
  −
| [[#AnalogStickState|AnalogStickL]]
   
|-
 
|-
| 0x10
+
| 4 || Downloaded
| 0x8
  −
| [[#AnalogStickState|AnalogStickR]]
   
|}
 
|}
   −
= MouseAutoPilotState =
+
= PalmaApplicationSectionAccessBuffer =
This is "nn::hid::debug::MouseAutoPilotState".
+
This is "nn::hid::PalmaApplicationSectionAccessBuffer". This is a 0x100-byte struct.
 +
 
 +
= PalmaActivityEntry =
 +
This is "nn::hid::PalmaActivityEntry".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset || Size || Description
! Size
  −
! Description
   
|-
 
|-
| 0x0
+
| 0x0 || 0x2 || RgbLedPatternIndex.
| 0x4
  −
| X
   
|-
 
|-
| 0x4
+
| 0x2 || 0x2 || Padding
| 0x4
  −
| Y
   
|-
 
|-
| 0x8
+
| 0x4 || 0x4 || [[#PalmaWaveSet|WaveSet]].
| 0x4
  −
| DeltaX
   
|-
 
|-
| 0xC
+
| 0x8 || 0x2 || WaveIndex.
| 0x4
+
|}
| DeltaY
+
 
 +
= PalmaWaveSet =
 +
This is "nn::hid::PalmaWaveSet".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0x10
+
| 0 || Small
| 0x4
  −
| WheelDelta
   
|-
 
|-
| 0x14
+
| 1 || Medium
| 0x4
  −
| [[#MouseButtonSet|Buttons]]
   
|-
 
|-
| 0x18
+
| 2 || Large
| 0x4
  −
| [[#MouseAttributeSet|Attributes]]
   
|}
 
|}
   −
= KeyboardAutoPilotState =
+
= PalmaFeature =
This is "nn::hid::debug::KeyboardAutoPilotState".
+
This is "nn::hid::PalmaFeature".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Bit
! Size
   
! Description
 
! Description
 
|-
 
|-
| 0x0
+
| 0
| 0x8
+
| FrMode
| [[#KeyboardModifierSet|Modifiers]]
+
|-
 +
| 1
 +
| RumbleFeedback
 
|-
 
|-
| 0x8
+
| 2
| 0x20
+
| Step
| [[#KeyboardKeySet|Keys]]
  −
|}
  −
 
  −
= SleepButtonAutoPilotState =
  −
This is "nn::hid::debug::SleepButtonAutoPilotState". This is a 0x8-byte struct with 8-byte alignment.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset
+
| 3
! Size
+
| MuteSwitch
! Description
   
|-
 
|-
| 0x0 || 0x8 || Buttons (only bit0 is used)
   
|}
 
|}
   −
= PowerInfo =
+
= AbstractedPadState =
This is "nn::hidtypes::PowerInfo".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset || Size || Description
! Size
+
|-
! Description
+
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
 
|-
 
|-
| 0x0 || 0x4 || BatteryLevel
+
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
 
|-
 
|-
| 0x4 || 0x4 || [[#PowerAttribute]]
+
| 0x5 || 0x3 || Padding
|}
+
|-
 
+
| 0x8 || 0x4 || RGBA Single Body Color
= PowerAttribute =
+
|-
This is "nn::hidtypes::PowerAttribute". This is a 32-bit flag.
+
| 0xC || 0x4 || RGBA Single Buttons Color
 
+
|-
{| class="wikitable" border="1"
+
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
!  Bits
+
|-
!  Description
+
| 0x11 || 0x3 || Padding
 
|-
 
|-
| 0
+
| 0x14 || 0x24 || [[#HdlsState]]. Unknown if the last 4-bytes are included in this struct, [[#SetAutoPilotVirtualPadState]]/[[#hiddbgGetAbstractedPadsState]] only uses the first 0x20-bytes.
| IsPowered
   
|-
 
|-
| 1
+
| 0x38 || 0x60 || Unused with [[#SetAutoPilotVirtualPadState]]/[[#GetAbstractedPadsState]].
| IsCharging
   
|}
 
|}
   −
= HdlsAttribute =
+
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::hidtypes::HdlsAttribute". This is a 32-bit flag.
      +
Type:
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  Bits
 
!  Bits
 +
!  [[#HdlsDeviceInfo]]::type bits
 
!  Description
 
!  Description
 +
!  Notes
 
|-
 
|-
| 0
+
| 0 || 0 || ||
| HasVirtualSixAxisSensorAcceleration
   
|-
 
|-
| 1
+
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
| HasVirtualSixAxisSensorAngle
  −
|}
  −
 
  −
= HdlsHandle =
  −
This is "nn::hid::debug::HdlsHandle". This is a 0x8-byte struct with 8-byte alignment.
  −
 
  −
= HdlsSessionId =
  −
This is "nn::hid::debug::detail::HdlsSessionId". This is a 0x8-byte struct with 8-byte alignment.
  −
 
  −
= HdlsNpadAssignment =
  −
This is a 0x208-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 2 || 1 || ||  
 
|-
 
|-
| 0x0 || 0x4 || s32 Total entries
+
| 3 || 2 || ||  
 
|-
 
|-
| 0x4 || 0x4 || Padding
+
| 4 || 1 || ||  
 
|-
 
|-
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
+
| 5 || 2 || ||  
|}
  −
 
  −
= HdlsNpadAssignmentEntry =
  −
This is a 0x20-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 6 || 3 || ||
 +
|-
 +
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
 
|-
 
|-
| 0x0 || 0x8 || [[#HdlsHandle]]
+
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
 
|-
 
|-
| 0x8 || 0x4 || ?
+
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
 
|-
 
|-
| 0xC || 0x4 || ?
+
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
 
|-
 
|-
| 0x10 || 0x8 || ?
+
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
 
|-
 
|-
| 0x18 || 0x1 || ?
+
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
 
|-
 
|-
| 0x19 || 0x7 || Padding
+
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
|}
  −
 
  −
= HdlsStateList =
  −
This is a 0x408-byte struct.
  −
 
  −
[9.0.0+] This is a 0x488-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
 
|-
 
|-
| 0x0 || 0x4 || s32 Total entries
+
| 15 || 17 || ||  
 
|-
 
|-
| 0x4 || 0x4 || Padding
+
| 31 || 21 || || [[#DeviceType]] = BIT(31)
 
|-
 
|-
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
   
|}
 
|}
   −
This contains a list of all controllers, including non-virtual controllers.
+
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
   −
= HdlsStateListEntry =
+
= DebugPadAutoPilotState =
This is a 0x40-byte struct.
+
This is "nn::hid::debug::DebugPadAutoPilotState"
 
  −
[9.0.0+] This is a 0x48-byte struct.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x8 || [[#HdlsHandle]]
+
| 0x0
 +
| 0x4
 +
| [[#DebugPadAttributeSet|Attributes]]
 
|-
 
|-
| 0x8 || [[#HdlsDeviceInfo]] size || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
+
| 0x4
 +
| 0x4
 +
| [[#DebugPadButtonSet|Buttons]]
 
|-
 
|-
| 0x8 + [[#HdlsDeviceInfo]] size, with 8-byte alignment || 0x24 || [[#HdlsState]]
+
| 0x8
 +
| 0x8
 +
| [[#AnalogStickState|AnalogStickL]]
 
|-
 
|-
| <Immediately following the above> || 0x4 || Padding
+
| 0x10
 +
| 0x8
 +
| [[#AnalogStickState|AnalogStickR]]
 
|}
 
|}
   −
= HdlsDeviceInfo =
+
= MouseAutoPilotState =
This is "nn::hid::debug::HdlsDeviceInfo". This is a 0x10-byte struct.
+
This is "nn::hid::debug::MouseAutoPilotState".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 +
|-
 +
| 0x0
 +
| 0x4
 +
| X
 +
|-
 +
| 0x4
 +
| 0x4
 +
| Y
 
|-
 
|-
| 0x0 || 0x4 || [[#DeviceTypeInternal]]
+
| 0x8
 +
| 0x4
 +
| DeltaX
 
|-
 
|-
| 0x4 || 0x4 || RGBA Single Body Color
+
| 0xC
 +
| 0x4
 +
| DeltaY
 
|-
 
|-
| 0x8 || 0x4 || RGBA Single Buttons Color
+
| 0x10
 +
| 0x4
 +
| WheelDelta
 
|-
 
|-
| 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.
+
| 0x14
 +
| 0x4
 +
| [[#MouseButtonSet|Buttons]]
 
|-
 
|-
| 0xD || 0x3 || Padding
+
| 0x18
 +
| 0x4
 +
| [[#MouseAttributeSet|Attributes]]
 
|}
 
|}
   −
[9.0.0+] This is a 0x14-byte struct.
+
= KeyboardAutoPilotState =
 +
This is "nn::hid::debug::KeyboardAutoPilotState".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
+
| 0x0
 +
| 0x8
 +
| [[#KeyboardModifierSet|Modifiers]]
 
|-
 
|-
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
+
| 0x8
 +
| 0x20
 +
| [[#KeyboardKeySet|Keys]]
 +
|}
 +
 
 +
= SleepButtonAutoPilotState =
 +
This is "nn::hid::debug::SleepButtonAutoPilotState". This is a 0x8-byte struct with 8-byte alignment.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x2 || 0x2 || Padding
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x4 || 0x4 || RGBA Single Body Color
+
| 0x0 || 0x8 || Buttons (only bit0 is used)
|-
  −
| 0x8 || 0x4 || RGBA Single Buttons Color
  −
|-
  −
| 0xC || 0x4 || RGBA Left Grip Color
  −
|-
  −
| 0x10 || 0x4 || RGBA Right Grip Color
   
|}
 
|}
   −
= HdlsState =
+
= PowerInfo =
This is "nn::hid::debug::HdlsState". This is a 0x24-byte struct.
+
This is "nn::hidtypes::PowerInfo".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x1 || IsPowered for the main PowerInfo.
+
| 0x0 || 0x4 || BatteryLevel
 
|-
 
|-
| 0x1 || 0x1 || ORRed with IsPowered to set the value of the first byte for the controller [[#NpadSystemProperties]].
+
| 0x4 || 0x4 || [[#PowerAttribute]]
|-
  −
| 0x2 || 0x6 || Unknown
  −
|-
  −
| 0x8 || 0x4 || BatteryLevel for the main PowerInfo.
  −
|-
  −
| 0xC || 0x4 || [[#NpadButton|Buttons]]. Bit18 = HOME and bit19 = Capture.
  −
|-
  −
| 0x10 || 0x10(4*2*2) || Joystick data.
  −
|-
  −
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
  −
|-
  −
| 0x21 || 0x3 || Padding
   
|}
 
|}
   −
[9.0.0+] (0x28-bytes):
+
= PowerAttribute =
 +
This is "nn::hidtypes::PowerAttribute". This is a 32-bit flag.
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Bits
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0
 +
| IsPowered
 
|-
 
|-
| 0x0 || 0x8 || [[#PowerInfo]]
+
| 1
|-
+
| IsCharging
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
  −
|-
  −
| 0x10 || 0x10(4*2*2) || Joystick data.
  −
|-
  −
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
  −
|-
  −
| 0x21 || 0x7 || Padding
   
|}
 
|}
   −
[12.0.0+] (0x40-bytes):
+
= HdlsAttribute =
 +
This is "nn::hidtypes::HdlsAttribute". This is a 32-bit flag.
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Bits
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0
 +
| HasVirtualSixAxisSensorAcceleration
 
|-
 
|-
| 0x0 || 0x8 || [[#PowerInfo]]
+
| 1
|-
+
| HasVirtualSixAxisSensorAngle
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
  −
|-
  −
| 0x10 || 0x10(4*2*2) || Joystick data.
  −
|-
  −
| 0x20 || 0xC || VirtualSixAxisSensorAcceleration
  −
|-
  −
| 0x2C || 0xC || VirtualSixAxisSensorAngle
  −
|-
  −
| 0x38 || 0x4 || [[#HdlsAttribute]]
  −
|-
  −
| 0x3C || 0x1 || Indicator. Unused for input.
  −
|-
  −
| 0x3D || 0x3 || Padding
   
|}
 
|}
   −
= DebugRegisteredDevice =
+
= HdlsHandle =
This is "nn::hid::debug::RegisteredDevice". This is a 0x58-byte struct with 2-byte alignment.
+
This is "nn::hid::debug::HdlsHandle". This is a 0x8-byte struct with 8-byte alignment.
   −
= RegisteredDevice =
+
= HdlsSessionId =
This is "nn::hid::system::RegisteredDevice". This is a 0x68-byte struct with 4-byte alignment.
+
This is "nn::hid::debug::detail::HdlsSessionId". This is a 0x8-byte struct with 8-byte alignment.
   −
= NotificationLedPattern =
+
= HdlsNpadAssignment =
This is "nn::hid::system::NotificationLedPattern". This is a 0x48-byte struct.
+
This is a 0x208-byte struct.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Subcommand argdata bytepos || Subcommand argdata nibble || Description
+
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x1 || 0x0 || Low || Mini Cycle Base Duration. Value 0x1-0xF: 12.5ms - 187.5ms. Value 0x0 = 0ms/OFF.
+
| 0x0 || 0x4 || s32 Total entries
 
|-
 
|-
| 0x1 || 0x1 || 0x0 || High || Number of Mini Cycles + 1. Value 0x0-0xF: 1 - 16 mini cycles.
+
| 0x4 || 0x4 || Padding
 
|-
 
|-
| 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.
+
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
 +
|}
 +
 
 +
= HdlsNpadAssignmentEntry =
 +
This is a 0x20-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x3 || 0x1 || 0x1 || High || LED Start Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
+
! Offset || Size || Description
 
|-
 
|-
| 0x4 || 0x1 || 0x2 || High || Mini Cycle 1 LED Intensity. Value 0x0-0xF: 0% - 100%. (In HW, 1 - 241 duty)
+
| 0x0 || 0x8 || [[#HdlsHandle]]
 
|-
 
|-
| 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.
+
| 0x8 || 0x4 || ?
 
|-
 
|-
| 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.
+
| 0xC || 0x4 || ?
 
|-
 
|-
| 0x7 || 0x1 || || || Unused
+
| 0x10 || 0x8 || ?
 
|-
 
|-
| 0x8 || 0x1 || 0x2 || Low || Mini Cycle 2 LED Intensity.
+
| 0x18 || 0x1 || ?
 
|-
 
|-
| 0x9 || 0x1 || 0x4 || High || Fading Transition Steps to Mini Cycle 2 (see above).
+
| 0x19 || 0x7 || Padding
 +
|}
 +
 
 +
= HdlsStateList =
 +
This is a 0x408-byte struct.
 +
 
 +
[9.0.0+] This is a 0x488-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0xA || 0x1 || 0x4 || Low || Final Step Duration Multiplier of Mini Cycle 2 (see above).
+
! Offset || Size || Description
 
|-
 
|-
| 0xB || 0x1 || || || Unused
+
| 0x0 || 0x4 || s32 Total entries
 
|-
 
|-
| 0xC || 0x1 || 0x5 || High || Mini Cycle 3 LED Intensity.
+
| 0x4 || 0x4 || Padding
 
|-
 
|-
| 0xD || 0x1 || 0x6 || High || Fading Transition Steps to Mini Cycle 3 (see above).
+
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
|-
+
|}
| 0xE || 0x1 || 0x6 || Low || Final Step Duration Multiplier of Mini Cycle 3 (see above).
+
 
|-
+
This contains a list of all controllers, including non-virtual controllers.
| 0xF || 0x1 || || || Unused
+
 
|-
+
= HdlsStateListEntry =
| 0x10 || 0x1 || 0x5 || Low || Mini Cycle 4 LED Intensity.
+
This is a 0x40-byte struct.
 +
 
 +
[9.0.0+] This is a 0x48-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x11 || 0x1 || 0x7 || High || Fading Transition Duration to Mini Cycle 4 (see above).
+
! Offset || Size || Description
 
|-
 
|-
| 0x12 || 0x1 || 0x7 || Low || Final Step Duration Multiplier of Mini Cycle 4 (see above).
+
| 0x0 || 0x8 || [[#HdlsHandle]]
 
|-
 
|-
| 0x13 || 0x1 || || || Unused
+
| 0x8 || [[#HdlsDeviceInfo]] size || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
 
|-
 
|-
| 0x14 || 0x1 || 0x8 || High || Mini Cycle 5 LED Intensity.
+
| 0x8 + [[#HdlsDeviceInfo]] size, with 8-byte alignment || 0x24 || [[#HdlsState]]
 
|-
 
|-
| 0x15 || 0x1 || 0x9 || High || Fading Transition Steps to Mini Cycle 5 (see above).
+
| <Immediately following the above> || 0x4 || Padding
 +
|}
 +
 
 +
= HdlsDeviceInfo =
 +
This is "nn::hid::debug::HdlsDeviceInfo". This is a 0x10-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x16 || 0x1 || 0x9 || Low || Final Step Duration Multiplier of Mini Cycle 5 (see above).
+
! Offset || Size || Description
 
|-
 
|-
| 0x17 || 0x1 || || || Unused
+
| 0x0 || 0x4 || [[#DeviceTypeInternal]]
 
|-
 
|-
| 0x18 || 0x1 || 0x8 || Low || Mini Cycle 6 LED Intensity.
+
| 0x4 || 0x4 || RGBA Single Body Color
 
|-
 
|-
| 0x19 || 0x1 || 0xA || High || Fading Transition Steps to Mini Cycle 6 (see above).
+
| 0x8 || 0x4 || RGBA Single Buttons Color
 
|-
 
|-
| 0x1A || 0x1 || 0xA || Low || Final Step Duration Multiplier of Mini Cycle 6 (see above).
+
| 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.
 
|-
 
|-
| 0x1B || 0x1 || || || Unused
+
| 0xD || 0x3 || Padding
 +
|}
 +
 
 +
[9.0.0+] This is a 0x14-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x1C || 0x1 || 0xB || High || Mini Cycle 7 LED Intensity.
+
! Offset || Size || Description
 
|-
 
|-
| 0x1D || 0x1 || 0xC || High || Fading Transition Steps  to Mini Cycle 7 (see above).
+
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
 
|-
 
|-
| 0x1E || 0x1 || 0xC || Low || Final Step Duration Multiplier of Mini Cycle 7 (see above).
+
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
 
|-
 
|-
| 0x1F || 0x1 || || || Unused
+
| 0x2 || 0x2 || Padding
 
|-
 
|-
| 0x20 || 0x1 || 0xB || Low || Mini Cycle 8 LED Intensity.
+
| 0x4 || 0x4 || RGBA Single Body Color
 
|-
 
|-
| 0x21 || 0x1 || 0xD || Low || Fading Transition Steps to Mini Cycle 8 (see above).
+
| 0x8 || 0x4 || RGBA Single Buttons Color
 
|-
 
|-
| 0x22 || 0x1 || 0xD || High || Final Step Duration Multiplier of Mini Cycle 8 (see above).
+
| 0xC || 0x4 || RGBA Left Grip Color
 
|-
 
|-
| 0x23 || 0x1 || || || Unused
+
| 0x10 || 0x4 || RGBA Right Grip Color
 +
|}
 +
 
 +
= HdlsState =
 +
This is "nn::hid::debug::HdlsState". This is a 0x24-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x24 || 0x1 || 0xE || High || Mini Cycle 9 LED Intensity.
+
! Offset || Size || Description
 
|-
 
|-
| 0x25 || 0x1 || 0xF || High || Fading Transition Steps to Mini Cycle 9 (see above).
+
| 0x0 || 0x1 || IsPowered for the main PowerInfo.
 
|-
 
|-
| 0x26 || 0x1 || 0xF || Low || Final Step Duration Multiplier of Mini Cycle 9 (see above).
+
| 0x1 || 0x1 || ORRed with IsPowered to set the value of the first byte for the controller [[#NpadSystemProperties]].
 
|-
 
|-
| 0x27 || 0x1 || || || Unused
+
| 0x2 || 0x6 || Unknown
 
|-
 
|-
| 0x28 || 0x1 || 0xE || Low || Mini Cycle 10 LED Intensity.
+
| 0x8 || 0x4 || BatteryLevel for the main PowerInfo.
 
|-
 
|-
| 0x29 || 0x1 || 0x10 || High || Fading Transition Steps to Mini Cycle 10 (see above).
+
| 0xC || 0x4 || [[#NpadButton|Buttons]]. Bit18 = HOME and bit19 = Capture.
 
|-
 
|-
| 0x2A || 0x1 || 0x10 || Low || Final Step Duration Multiplier of Mini Cycle 10 (see above).
+
| 0x10 || 0x10(4*2*2) || Joystick data.
 
|-
 
|-
| 0x2B || 0x1 || || || Unused
+
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
 
|-
 
|-
| 0x2C || 0x1 || 0x11 || High || Mini Cycle 11 LED Intensity.
+
| 0x21 || 0x3 || Padding
 +
|}
 +
 
 +
[9.0.0+] (0x28-bytes):
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x2D || 0x1 || 0x12 || High || Fading Transition Steps to Mini Cycle 11 (see above).
+
! Offset || Size || Description
 
|-
 
|-
| 0x2E || 0x1 || 0x12 || Low || Final Step Duration Multiplier of Mini Cycle 11 (see above).
+
| 0x0 || 0x8 || [[#PowerInfo]]
 
|-
 
|-
| 0x2F || 0x1 || || || Unused
+
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
 
|-
 
|-
| 0x30 || 0x1 || 0x11 || Low || Mini Cycle 12 LED Intensity.
+
| 0x10 || 0x10(4*2*2) || Joystick data.
 
|-
 
|-
| 0x31 || 0x1 || 0x13 || High || Fading Transition Steps to Mini Cycle 12 (see above).
+
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
 
|-
 
|-
| 0x32 || 0x1 || 0x13 || Low || Final Step Duration Multiplier of Mini Cycle 12 (see above).
+
| 0x21 || 0x7 || Padding
 +
|}
 +
 
 +
[12.0.0+] (0x40-bytes):
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x33 || 0x1 || || || Unused
+
! Offset || Size || Description
 
|-
 
|-
| 0x34 || 0x1 || 0x14 || High || Mini Cycle 13 LED Intensity.
+
| 0x0 || 0x8 || [[#PowerInfo]]
 
|-
 
|-
| 0x35 || 0x1 || 0x15 || High || Fading Transition Steps to Mini Cycle 13 (see above).
+
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
 
|-
 
|-
| 0x36 || 0x1 || 0x15 || Low || Final Step Duration Multiplier of Mini Cycle 13 (see above).
+
| 0x10 || 0x10(4*2*2) || Joystick data.
 
|-
 
|-
| 0x37 || 0x1 || || || Unused
+
| 0x20 || 0xC || VirtualSixAxisSensorAcceleration
 
|-
 
|-
| 0x38 || 0x1 || 0x14 || Low || Mini Cycle 14 LED Intensity.
+
| 0x2C || 0xC || VirtualSixAxisSensorAngle
 
|-
 
|-
| 0x39 || 0x1 || 0x16 || High || Fading Transition Steps to Mini Cycle 14 (see above).
+
| 0x38 || 0x4 || [[#HdlsAttribute]]
 
|-
 
|-
| 0x3A || 0x1 || 0x16 || Low || Final Step Duration Multiplier of Mini Cycle 14 (see above).
+
| 0x3C || 0x1 || Indicator. Unused for input.
 
|-
 
|-
| 0x3B || 0x1 || || || Unused
+
| 0x3D || 0x3 || Padding
 +
|}
 +
 
 +
= DebugRegisteredDevice =
 +
This is "nn::hid::debug::RegisteredDevice". This is a 0x58-byte struct with 2-byte alignment.
 +
 
 +
= RegisteredDevice =
 +
This is "nn::hid::system::RegisteredDevice". This is a 0x68-byte struct with 4-byte alignment.
 +
 
 +
= NotificationLedPattern =
 +
This is "nn::hid::system::NotificationLedPattern". This is a 0x48-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x3C || 0x1 || 0x17 || High || Mini Cycle 15 LED Intensity.
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x3D || 0x1 || 0x18 || High || Fading Transition Steps to Mini Cycle 15 (see above).
+
| 0x0
 +
| 0x1
 +
| TimeUnit
 
|-
 
|-
| 0x3E || 0x1 || 0x18 || Low || Final Step Duration Multiplier of Mini Cycle 15 (see above).
+
| 0x1
 +
| 0x1
 +
| FrameCount
 
|-
 
|-
| 0x3F || 0x1 || || || Unused
+
| 0x2
 +
| 0x1
 +
| CycleCount
 
|-
 
|-
| 0x40 || 0x1 || 0x17 || Low || Mini Cycle 16 LED Intensity.
+
| 0x3
 +
| 0x1
 +
| InitialBrightness
 
|-
 
|-
| 0x41 || 0x1 || 0x19 || High || Fading Transition Steps to Mini Cycle 16 (see above). (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
+
| 0x4
 +
| 0x4 * 15
 +
| [[#Frame|Frames]]
 
|-
 
|-
| 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.)
+
| 0x40
 +
| 0x1
 +
| FinalBrightness
 
|-
 
|-
| 0x43 || 0x1 || || || Unused
+
| 0x41
|-
+
| 0x1
| 0x44 || 0x1 || 0x1A || High || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
+
| TimeTowardsFinalBrightness
|-
  −
| 0x45 || 0x1 || 0x1A || Low || Unknown (Unused in older Joy-Con / Pro-Con FW. Unknown for new.)
  −
|-
  −
| 0x46 || 0x1 || || || Padding
  −
|-
  −
| 0x47 || 0x1 || || || Padding
   
|-
 
|-
 +
| 0x42
 +
| 0x6
 +
| Reserved
 
|}
 
|}
   −
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].
+
== Frame ==
 
  −
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"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x1B || See above.
+
| 0x0
 +
| 0x1
 +
| Brightness
 
|-
 
|-
| 0x1B || 0xB || Cleared to zero.
+
| 0x1
 +
| 0x1
 +
| TimeTowards
 
|-
 
|-
| 0x26 || 0x5 || Unused
+
| 0x2
 +
| 0x1
 +
| TimeToHold
 
|-
 
|-
| 0x2B || 0x8 || Set to an input value, which is hard-coded 0.
+
| 0x3
|-
+
| 0x1
| 0x33 || 0x2 || Set to value 0.
+
| Reserved
|-
  −
| 0x35 || 0x1 || Set to value 1.
   
|}
 
|}
   Line 8,579: Line 8,911:  
This is an UTF-8 NUL-terminated name string.
 
This is an UTF-8 NUL-terminated name string.
   −
= IrCameraHandle =
+
= InterfaceType =
This is "nn::irsensor::IrCameraHandle".
+
This is "nn::hidtypes::InterfaceType".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 1 || Bluetooth
 
|-
 
|-
| 0x0 || 0x1 || PlayerNumber
+
| 2 || Rail
 
|-
 
|-
| 0x1 || 0x1 || DeviceType
+
| 3 || Usb
 
|-
 
|-
| 0x2 || 0x2 || Reserved
+
| 4 || Embedded
 
|}
 
|}
   −
= IrCameraStatus =
+
= DigitalButton =
This is "nn::irsensor::IrCameraStatus".
+
This is "nn::hidtypes::DigitalButton". This is a 64-bit flag.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Available
+
! Bit
 +
! Description
 
|-
 
|-
| 1 || Unsupported
+
| 0
 +
| A
 
|-
 
|-
| 2 || Unconnected
+
| 1
|}
+
| B
 
  −
= IrCameraInternalStatus =
  −
This is "nn::irsensor::IrCameraInternalStatus".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Stopped
+
| 2
 +
| X
 
|-
 
|-
| 1 || FirmwareUpdateNeeded
+
| 3
 +
| Y
 
|-
 
|-
| 2 ||  
+
| 4
 +
| StickL
 
|-
 
|-
| 3 ||  
+
| 5
 +
| StickR
 
|-
 
|-
| 4 ||  
+
| 6
 +
| L
 
|-
 
|-
| 5 || FirmwareVersionRequested
+
| 7
 +
| R
 
|-
 
|-
| 6 || FirmwareVersionIsInvalid
+
| 8
 +
| ZL
 
|-
 
|-
| 7 || [4.0.0+] Ready
+
| 9
 +
| ZR
 
|-
 
|-
| 8 || [4.0.0+] Setting
+
| 10
 +
| Start
 +
|-
 +
| 11
 +
| Select
 +
|-
 +
| 12
 +
| Left
 +
|-
 +
| 13
 +
| Up
 +
|-
 +
| 14
 +
| Right
 +
|-
 +
| 15
 +
| Down
 +
|-
 +
| 16
 +
| SL
 +
|-
 +
| 17
 +
| SR
 +
|-
 +
| 18
 +
| Home
 +
|-
 +
| 19
 +
| Shot
 +
|-
 +
| 20
 +
| StickLLeft
 +
|-
 +
| 21
 +
| StickLUp
 +
|-
 +
| 22
 +
| StickLRight
 +
|-
 +
| 23
 +
| StickLDown
 +
|-
 +
| 24
 +
| StickRLeft
 +
|-
 +
| 25
 +
| StickRUp
 +
|-
 +
| 26
 +
| StickRRight
 +
|-
 +
| 27
 +
| StickRDown
 +
|-
 +
| 28
 +
| Palma
 +
|-
 +
| 29
 +
| HandheldLeftB
 +
|-
 +
| 30
 +
| Plus
 +
|-
 +
| 31
 +
| Minus
 +
|-
 +
| 32
 +
| Z
 +
|-
 +
| 33
 +
| LeftSL
 +
|-
 +
| 34
 +
| LeftSR
 +
|-
 +
| 35
 +
| RightSL
 +
|-
 +
| 36
 +
| RightSR
 +
|-
 +
| 37
 +
| LeftC
 +
|-
 +
| 38
 +
| UpC
 +
|-
 +
| 39
 +
| RightC
 +
|-
 +
| 40
 +
| DownC
 +
|}
 +
 
 +
= AssignmentStyle =
 +
This is "nn::hidtypes::AssignmentStyle". This is a 32-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Bit
 +
! Description
 +
|-
 +
| 0
 +
| IsExternalAssigned
 +
|-
 +
| 1
 +
| IsExternalLeftAssigned
 +
|-
 +
| 2
 +
| IsExternalRightAssigned
 +
|-
 +
| 3
 +
| IsHandheldAssigned
 +
|-
 +
| 4
 +
| IsHandheldLeftAssigned
 +
|-
 +
| 5
 +
| IsHandheldRightAssigned
 +
|}
 +
 
 +
= FeatureType =
 +
This is "nn::hidtypes::FeatureType". This is a 64-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Bit
 +
! Description
 +
|-
 +
| 0
 +
| HasLeftAnalogStick
 +
|-
 +
| 1
 +
| HasRightAnalogStick
 +
|-
 +
| 2
 +
| HasLeftJoySixAxisSensor
 +
|-
 +
| 3
 +
| HasRightJoySixAxisSensor
 +
|-
 +
| 4
 +
| HasFullKeySixAxisSensor
 +
|-
 +
| 5
 +
| HasLeftLraVibrationDevice
 +
|-
 +
| 6
 +
| HasRightLraVibrationDevice
 +
|-
 +
| 7
 +
| HasGcVibrationDevice
 +
|-
 +
| 8
 +
| HasErmVibrationDevice
 +
|-
 +
| 9
 +
| HasLeftJoyRailBus
 +
|-
 +
| 10
 +
| HasRightJoyRailBus
 +
|-
 +
| 11
 +
| HasInternalBus
 +
|-
 +
| 12
 +
| IsPalma
 +
|-
 +
| 13
 +
| HasNfc
 +
|-
 +
| 14
 +
| HasIrSensor
 +
|-
 +
| 15
 +
| IsAnalogStickCalibrationSupported
 +
|-
 +
| 16
 +
| IsSixAxisSensorUserCalibrationSupported
 +
|-
 +
| 17
 +
| HasLeftJoyRightJoyBattery
 +
|-
 +
| 18
 +
| HasFullKeyBattery
 +
|-
 +
| 19
 +
| IsDisconnectControllerIfBatteryNone
 +
|-
 +
| 20
 +
| HasControllerColor
 +
|-
 +
| 21
 +
| HasGripColor
 +
|-
 +
| 22
 +
| HasIdentificationCode
 +
|-
 +
| 23
 +
| HasBluetoothAddress
 +
|-
 +
| 24
 +
| HasMcu
 +
|-
 +
| 25
 +
| HasNotificationLed
 +
|-
 +
| 26
 +
| HasDirectionalButtons
 +
|-
 +
| 27
 +
| HasIndicatorLed
 +
|-
 +
| 28
 +
| IsButtonConfigEmbeddedSupported
 +
|-
 +
| 29
 +
| IsButtonConfigFullSupported
 +
|-
 +
| 30
 +
| IsButtonConfigLeftSupported
 +
|-
 +
| 31
 +
| IsButtonConfigRightSupported
 +
|-
 +
| 32
 +
| IsUsbHidDevice
 +
|-
 +
| 33
 +
| IsKuinaDevice
 +
|-
 +
| 34
 +
| IsDirectUsbToBtSwitchingDevice
 +
|-
 +
| 35
 +
| IsNormalizeAnalogStickWithInnerCross
 +
|}
 +
 
 +
= Color =
 +
This is "nn::hidtypes::Color".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || BodyColor
 +
|-
 +
| 0x4 || 0x4 || ButtonColor
 +
|-
 +
| 0x8 || 0x4 || LeftGripColor
 +
|-
 +
| 0xC || 0x4 || RightGripColor
 +
|}
 +
 
 +
= DeviceDescriptorType =
 +
This is "nn::hidtypes::DeviceDescriptorType".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
 +
|-
 +
| 0x1 || 0x7 || Reserved
 +
|-
 +
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
 +
|-
 +
| 0x10 || 0x8 || [[#DigitalButton|DigitalButton]]
 +
|-
 +
| 0x18 || 0x4 || [[#AssignmentStyle|AssignmentStyle]]
 +
|-
 +
| 0x1C || 0x10 || [[#Color|DeviceColor]]
 +
|-
 +
| 0x2C || 0x4 || Reserved
 +
|}
 +
 
 +
= DeviceDescriptionList =
 +
This is "nn::hidtypes::detail::DeviceDescriptionList". This is a list of [[#DeviceDescriptorType|DeviceDescriptorType]] objects maintained by the hid-sysmodule.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! [[#DeviceTypeInternal|DeviceType]] || [[#FeatureType|FeatureType]] || [[#DigitalButton|DigitalButton]] || [[#AssignmentStyle|AssignmentStyle]] || [[#Color|DeviceColor]]
 +
|-
 +
| 1 || 0x18BDBE44A || 0x18F0406AF || 0x24 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 2 || 0x14CDB8225 || 0x6F8F950 || 0x12 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 3 || 0x72BBDA073 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 4 || 0x108000025 || 0x6F8F950 || 0x2 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 5 || 0x10800004A || 0x18F0406AF || 0x4 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 6 || 0x108800013 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 7 || 0x108CA0000 || 0x2008FCC3 || 0x11 || 0xFF322891, 0xFFFFFFFF, 0x00000000, 0x00000000
 +
|-
 +
| 8 || 0x108CA0800 || 0x4F0C3 || 0x21 || 0xFF322891, 0xFFFFFFFF, 0x00000000, 0x00000000
 +
|-
 +
| 9 || 0x108CA0000 || 0x2008FCC3 || 0x11 || 0xFFD9D7D7, 0xFFFFFFFF, 0x00000000, 0x00000000
 +
|-
 +
| 10 || 0x108CA0000 || 0x4FCC3 || 0x21 || 0xFFD9D7D7, 0xFFFFFFFF, 0x00000000, 0x00000000
 +
|-
 +
| 11 || 0x700CC0000 || 0xFFCF || 0x0 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 12 || 0x841011 || 0x10000010 || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 13 || 0x83 || 0xFF0F6CF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 14 || 0x1 || 0xF8F950 || 0x10 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 15 || 0x3 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 16 || 0x3 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 17 || 0x1001A013 || 0xFFCFFFF || 0x8 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 18 || 0x2 || 0xF0406AF || 0x20 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 19 || 0x1088DA073 || 0xFFCF3FF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| 20 || 0x108CA0025 || 0x6F8F150 || 0x12 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 21 || 0x108CA604A || 0x18F0402AF || 0x24 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| [12.0.0+] 22 || 0xF00CC8101 || 0x1E1FCF6C3 || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| [12.0.0+] 23 || 0x100000000 || 0x0 || 0x0 || 0x00000000, 0x00000000, 0x00000000, 0x00000000
 +
|-
 +
| [13.0.0+] 28 || 0x700CC0000 || 0xCF6CF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|-
 +
| [14.0.0+] 30 || 0x108800003 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 +
|}
 +
 
 +
= UnmaskFeatureDescriptorType =
 +
This is "nn::hid::server::UnmaskFeatureDescriptorType".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
 +
|-
 +
| 0x1 || 0x1 || [[#InterfaceType|InterfaceType]]
 +
|-
 +
| 0x2 || 0x6 || Reserved
 +
|-
 +
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
 +
|}
 +
 
 +
= UnmaskFeatureDescriptorList =
 +
This is "nn::hid::server::UnmaskFeatureDescriptorList". This is a list of [[#UnmaskFeatureDescriptorType|UnmaskFeatureDescriptorType]] objects maintained by the hid-sysmodule.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! [[#DeviceTypeInternal|DeviceType]] || [[#InterfaceType|InterfaceType]] || [[#FeatureType|FeatureType]]
 +
|-
 +
| 3 || 3 || 0x2000
 +
|-
 +
| 2 || 2 || 0x200
 +
|-
 +
| 1 || 2 || 0x400
 +
|-
 +
| 19 || 3 || 0x2000
 +
|-
 +
| 2 || 3 || 0x200
 +
|-
 +
| 1 || 3 || 0x6400
 +
|}
 +
 
 +
= FirmwareVersionInfo =
 +
This is "nn::hidtypes::FirmwareVersionInfo".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#FirmwareVersionAttribute|FirmwareVersionAttribute]]
 +
|-
 +
| 0x4 || 0x2 ||
 +
|-
 +
| 0x6 || 0x2 || MajorVersion
 +
|-
 +
| 0x8 || 0x2 || MinorVersion
 +
|-
 +
| 0xA || 0x2 ||
 +
|}
 +
 
 +
= FirmwareVersionAttribute =
 +
This is "nn::hidtypes::FirmwareVersionAttribute". This is a 32-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Bit
 +
! Description
 +
|-
 +
| 0
 +
| IsCustomerCodeCorruption
 +
|-
 +
| 1
 +
| IsIapCorrupted
 +
|}
 +
 
 +
= IrCameraHandle =
 +
This is "nn::irsensor::IrCameraHandle".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || PlayerNumber
 +
|-
 +
| 0x1 || 0x1 || DeviceType
 +
|-
 +
| 0x2 || 0x2 || Reserved
 +
|}
 +
 
 +
= IrCameraStatus =
 +
This is "nn::irsensor::IrCameraStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || Available
 +
|-
 +
| 1 || Unsupported
 +
|-
 +
| 2 || Unconnected
 +
|}
 +
 
 +
= IrCameraInternalStatus =
 +
This is "nn::irsensor::IrCameraInternalStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || Stopped
 +
|-
 +
| 1 || FirmwareUpdateNeeded
 +
|-
 +
| 2 ||
 +
|-
 +
| 3 ||
 +
|-
 +
| 4 ||
 +
|-
 +
| 5 || FirmwareVersionRequested
 +
|-
 +
| 6 || FirmwareVersionIsInvalid
 +
|-
 +
| 7 || [4.0.0+] Ready
 +
|-
 +
| 8 || [4.0.0+] Setting
 +
|}
 +
 
 +
= IrSensorMode =
 +
This is "nn::irsensor::detail::StatusManager::IrSensorMode".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || None
 +
|-
 +
| 1 || [[#MomentProcessorState|MomentProcessor]]
 +
|-
 +
| 2 || [[#ClusteringProcessorState|ClusteringProcessor]]
 +
|-
 +
| 3 || [[#ImageTransferProcessorState|ImageTransferProcessor]]
 +
|-
 +
| 4 || [[#PointingProcessorMarkerState|PointingProcessorMarker]]
 +
|-
 +
| 5 || [[#TeraPluginProcessorState|TeraPluginProcessor]]
 +
|-
 +
| 6 || Unknown
 +
|}
 +
 
 +
= ImageProcessorStatus =
 +
This is "nn::irsensor::ImageProcessorStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || Stopped
 +
|-
 +
| 1 || Running
 +
|}
 +
 
 +
= ImageTransferProcessorFormat =
 +
This is "nn::irsensor::ImageTransferProcessorFormat".
 +
 
 +
This controls the IR Sensor image resolution.
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || 320x240
 +
|-
 +
| 1 || 160x120
 +
|-
 +
| 2 || 80x60
 +
|-
 +
| 3 || [4.0.0+] 40x30
 +
|-
 +
| 4 || [4.0.0+] 20x15
 +
|}
 +
 
 +
= MomentProcessorConfig =
 +
This is "nn::irsensor::MomentProcessorConfig".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
 +
|-
 +
| 0x8 || 0x4 || LightTarget (default is 0)
 +
|-
 +
| 0xC || 0x4 || Gain (default is 0x8)
 +
|-
 +
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
 +
|-
 +
| 0x11 || 0x7 || Reserved
 +
|-
 +
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
 +
|-
 +
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
 +
|-
 +
| 0x1C || 0x2 || WindowOfInterestWidth (default is 0x140)
 +
|-
 +
| 0x1E || 0x2 || WindowOfInterestHeight (default is 0xF0)
 +
|-
 +
| 0x20 || 0x4 || Preprocess (default is 0x1)
 +
|-
 +
| 0x24 || 0x4 || PreprocessIntensityThreshold (default is 0x50)
 +
|}
 +
 
 +
= PackedMomentProcessorConfig =
 +
This is "nn::irsensor::PackedMomentProcessorConfig".
 +
 
 +
This is converted from [[#MomentProcessorConfig]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
 +
|-
 +
| 0x8 || 0x1 || LightTarget (default is 0)
 +
|-
 +
| 0x9 || 0x1 || Gain (default is 0x8)
 +
|-
 +
| 0xA || 0x1 || IsNegativeImageUsed (default is 0)
 +
|-
 +
| 0xB || 0x5 || Reserved
 +
|-
 +
| 0x10 || 0x2 || WindowOfInterestX (default is 0)
 +
|-
 +
| 0x12 || 0x2 || WindowOfInterestY (default is 0)
 +
|-
 +
| 0x14 || 0x2 || WindowOfInterestWidth (default is 0x140)
 +
|-
 +
| 0x16 || 0x2 || WindowOfInterestHeight (default is 0xF0)
 +
|-
 +
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 +
|-
 +
| 0x1C || 0x1 || Preprocess (default is 0x1)
 +
|-
 +
| 0x1D || 0x1 || PreprocessIntensityThreshold (default is 0x50)
 +
|-
 +
| 0x1E || 0x2 || Reserved
 
|}
 
|}
   −
= IrSensorMode =
+
= ClusteringProcessorConfig =
This is "nn::irsensor::detail::StatusManager::IrSensorMode".
+
This is "nn::irsensor::ClusteringProcessorConfig".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || None
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || ExposureTime (default is 200000)
 +
|-
 +
| 0x8 || 0x4 || LightTarget (default is 0)
 +
|-
 +
| 0xC || 0x4 || Gain (default is 0x2)
 +
|-
 +
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
 +
|-
 +
| 0x11 || 0x7 || Reserved
 
|-
 
|-
| 1 || [[#MomentProcessorState|MomentProcessor]]
+
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 2 || [[#ClusteringProcessorState|ClusteringProcessor]]
+
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 3 || [[#ImageTransferProcessorState|ImageTransferProcessor]]
+
| 0x1C || 0x2 || WindowOfInterestWidth (default is 320)
 
|-
 
|-
| 4 || [[#PointingProcessorMarkerState|PointingProcessorMarker]]
+
| 0x1E || 0x2 || WindowOfInterestHeight (default is 240)
 
|-
 
|-
| 5 || [[#TeraPluginProcessorState|TeraPluginProcessor]]
+
| 0x20 || 0x4 || ObjectPixelCountMin (default is 0x3)
 
|-
 
|-
| 6 || Unknown
+
| 0x24 || 0x4 || ObjectPixelCountMax (default is 0x12C00)
|}
  −
 
  −
= ImageProcessorStatus =
  −
This is "nn::irsensor::ImageProcessorStatus".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Stopped
+
| 0x28 || 0x4 || ObjectIntensityMin (default is 150)
 
|-
 
|-
| 1 || Running
+
| 0x2C || 0x1 || IsExternalLightFilterEnabled (default is 0x1)
 
|}
 
|}
   −
= ImageTransferProcessorFormat =
+
= PackedClusteringProcessorConfig =
This is "nn::irsensor::ImageTransferProcessorFormat".
+
This is "nn::irsensor::PackedClusteringProcessorConfig".
   −
This controls the IR Sensor image resolution.
+
This is converted from [[#ClusteringProcessorConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || 320x240
+
! Offset || Size || Description
 
|-
 
|-
| 1 || 160x120
+
| 0x0 || 0x8 || ExposureTime
 
|-
 
|-
| 2 || 80x60
+
| 0x8 || 0x1 || LightTarget
 
|-
 
|-
| 3 || [4.0.0+] 40x30
+
| 0x9 || 0x1 || Gain
 
|-
 
|-
| 4 || [4.0.0+] 20x15
+
| 0xA || 0x1 || IsNegativeImageUsed
|}
  −
 
  −
= MomentProcessorConfig =
  −
This is "nn::irsensor::MomentProcessorConfig".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0xB || 0x5 || Reserved
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
+
| 0x10 || 0x2 || WindowOfInterestX
 
|-
 
|-
| 0x8 || 0x4 || LightTarget (default is 0)
+
| 0x12 || 0x2 || WindowOfInterestY
 
|-
 
|-
| 0xC || 0x4 || Gain (default is 0x8)
+
| 0x14 || 0x2 || WindowOfInterestWidth
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
+
| 0x16 || 0x2 || WindowOfInterestHeight
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x1C || 0x4 || ObjectPixelCountMin
 
|-
 
|-
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
+
| 0x20 || 0x4 || ObjectPixelCountMax
 
|-
 
|-
| 0x1C || 0x2 || WindowOfInterestWidth (default is 0x140)
+
| 0x24 || 0x1 || ObjectIntensityMin
 
|-
 
|-
| 0x1E || 0x2 || WindowOfInterestHeight (default is 0xF0)
+
| 0x25 || 0x1 || IsExternalLightFilterEnabled
 
|-
 
|-
| 0x20 || 0x4 || Preprocess (default is 0x1)
+
| 0x26 || 0x2 || Reserved
|-
  −
| 0x24 || 0x4 || PreprocessIntensityThreshold (default is 0x50)
   
|}
 
|}
   −
= PackedMomentProcessorConfig =
+
= ImageTransferProcessorConfig =
This is "nn::irsensor::PackedMomentProcessorConfig".
+
This is "nn::irsensor::ImageTransferProcessorConfig".
 
  −
This is converted from [[#MomentProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,726: Line 9,623:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
+
| 0x0 || 0x8 || ExposureTime
 
|-
 
|-
| 0x8 || 0x1 || LightTarget (default is 0)
+
| 0x8 || 0x4 || LightTarget
 
|-
 
|-
| 0x9 || 0x1 || Gain (default is 0x8)
+
| 0xC || 0x4 || Gain
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed (default is 0)
+
| 0x10 || 0x1 || IsNegativeImageUsed
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x11 || 0x7 || Reserved
 
|-
 
|-
| 0x10 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|Format]]
 +
|}
 +
 
 +
= PackedImageTransferProcessorConfig =
 +
This is "nn::irsensor::PackedImageTransferProcessorConfig".
 +
 
 +
This is converted from [[#ImageTransferProcessorConfig]].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x12 || 0x2 || WindowOfInterestY (default is 0)
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || ExposureTime
 +
|-
 +
| 0x8 || 0x1 || LightTarget
 
|-
 
|-
| 0x14 || 0x2 || WindowOfInterestWidth (default is 0x140)
+
| 0x9 || 0x1 || Gain
 
|-
 
|-
| 0x16 || 0x2 || WindowOfInterestHeight (default is 0xF0)
+
| 0xA || 0x1 || IsNegativeImageUsed
 
|-
 
|-
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0xB || 0x5 || Reserved
 
|-
 
|-
| 0x1C || 0x1 || Preprocess (default is 0x1)
+
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x1D || 0x1 || PreprocessIntensityThreshold (default is 0x50)
+
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|Format]]
 
|-
 
|-
| 0x1E || 0x2 || Reserved
+
| 0x15 || 0x3 || Reserved
 
|}
 
|}
   −
= ClusteringProcessorConfig =
+
= ImageTransferProcessorState =
This is "nn::irsensor::ClusteringProcessorConfig".
+
This is "nn::irsensor::ImageTransferProcessorState".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,760: Line 9,669:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 200000)
+
| 0x0 || 0x8 || SamplingNumber
 
|-
 
|-
| 0x8 || 0x4 || LightTarget (default is 0)
+
| 0x8 || 0x4 || AmbientNoiseLevel
 
|-
 
|-
| 0xC || 0x4 || Gain (default is 0x2)
+
| 0xC || 0x4 || Reserved
 +
|}
 +
 
 +
= TeraPluginProcessorConfig =
 +
This is "nn::irsensor::TeraPluginProcessorConfig".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
+
! Offset || Size || Description
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0x0 || 0x1 || Mode
 
|-
 
|-
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x1 || 0x1 ||  
 
|-
 
|-
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
+
| 0x2 || 0x1 ||  
 
|-
 
|-
| 0x1C || 0x2 || WindowOfInterestWidth (default is 320)
+
| 0x3 || 0x1 ||  
|-
  −
| 0x1E || 0x2 || WindowOfInterestHeight (default is 240)
  −
|-
  −
| 0x20 || 0x4 || ObjectPixelCountMin (default is 0x3)
  −
|-
  −
| 0x24 || 0x4 || ObjectPixelCountMax (default is 0x12C00)
  −
|-
  −
| 0x28 || 0x4 || ObjectIntensityMin (default is 150)
  −
|-
  −
| 0x2C || 0x1 || IsExternalLightFilterEnabled (default is 0x1)
   
|}
 
|}
   −
= PackedClusteringProcessorConfig =
+
= PackedTeraPluginProcessorConfig =
This is "nn::irsensor::PackedClusteringProcessorConfig".
+
This is "nn::irsensor::PackedTeraPluginProcessorConfig".
 +
 
 +
This is converted from [[#TeraPluginProcessorConfig]]. The data starting at offset 0x5 is only initialized by the user-process with [6.0.0+].
   −
This is converted from [[#ClusteringProcessorConfig]].
+
[[#TeraPluginProcessorConfig]] +0x0, +0x2, and +0x3 are copied to +0x4, 0x6, and +0x7 here. +0x5 here is set to 0x2 | ([[#TeraPluginProcessorConfig]]+0x1 << 7).
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,796: Line 9,703:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x4 || 0x1 || Mode
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
| 0x5 || 0x1 ||  
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x6 || 0x1 ||  
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x7 || 0x1 ||  
 +
|}
 +
 
 +
= PointingProcessorConfig =
 +
This is "nn::irsensor::PointingProcessorConfig".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x10 || 0x2 || WindowOfInterestX
+
! Offset || Size || Description
 
|-
 
|-
| 0x12 || 0x2 || WindowOfInterestY
+
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x14 || 0x2 || WindowOfInterestWidth
+
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0x16 || 0x2 || WindowOfInterestHeight
+
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
 
|-
 
|-
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
|-
  −
| 0x1C || 0x4 || ObjectPixelCountMin
  −
|-
  −
| 0x20 || 0x4 || ObjectPixelCountMax
  −
|-
  −
| 0x24 || 0x1 || ObjectIntensityMin
  −
|-
  −
| 0x25 || 0x1 || IsExternalLightFilterEnabled
  −
|-
  −
| 0x26 || 0x2 || Reserved
   
|}
 
|}
   −
= ImageTransferProcessorConfig =
+
= PackedPointingProcessorConfig =
This is "nn::irsensor::ImageTransferProcessorConfig".
+
This is "nn::irsensor::PackedPointingProcessorConfig".
 +
 
 +
This is converted from [[#PointingProcessorConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,834: Line 9,739:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x8 || 0x4 || LightTarget
+
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0xC || 0x4 || Gain
+
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed
+
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0x8 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
|-
  −
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|Format]]
   
|}
 
|}
   −
= PackedImageTransferProcessorConfig =
+
= PackedMcuVersion =
This is "nn::irsensor::PackedImageTransferProcessorConfig".
+
This is "nn::irsensor::PackedMcuVersion".
 
  −
This is converted from [[#ImageTransferProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,856: Line 9,757:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x2 || MajorVersion
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x2 || 0x2 || MinorVersion
 +
|}
 +
 
 +
== Versions ==
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
! MajorVersion || MinorVersion || SystemVersion
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x3 || 0xB || [1.0.0+]
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x4 || 0x12 || [4.0.0+]
 
|-
 
|-
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x5 || 0x18 || [5.0.0+]
 
|-
 
|-
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|Format]]
+
| 0x6 || 0x1A || [6.0.0+]
 
|-
 
|-
| 0x15 || 0x3 || Reserved
+
| 0x8 || 0x1B || [8.0.0+]
 
|}
 
|}
   −
= ImageTransferProcessorState =
+
= PackedFunctionLevel =
This is "nn::irsensor::ImageTransferProcessorState".
+
This is nn::irsensor::PackedFunctionLevel.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,880: Line 9,785:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || SamplingNumber
+
| 0x0 || 0x1 || [[#IrSensorFunctionLevel]]
 
|-
 
|-
| 0x8 || 0x4 || AmbientNoiseLevel
+
| 0x1 || 0x3 || Reserved
|-
  −
| 0xC || 0x4 || Reserved
   
|}
 
|}
   −
= TeraPluginProcessorConfig =
+
== IrSensorFunctionLevel ==
This is "nn::irsensor::TeraPluginProcessorConfig".
+
This is "nn::irsensor::IrSensorFunctionLevel".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Value || SystemVersion
 +
|-
 +
| 0 || [1.0.0+]
 
|-
 
|-
| 0x0 || 0x1 || Mode
+
| 1 || [4.0.0+]
 
|-
 
|-
| 0x1 || 0x1 ||  
+
| 2 || [5.0.0+]
 
|-
 
|-
| 0x2 || 0x1 ||  
+
| 3 || [6.0.0+]
 
|-
 
|-
| 0x3 || 0x1 ||  
+
| 4 || [8.0.0+]
 
|}
 
|}
   −
= PackedTeraPluginProcessorConfig =
+
= ImageTransferProcessorExConfig =
This is "nn::irsensor::PackedTeraPluginProcessorConfig".
+
This is "nn::irsensor::ImageTransferProcessorExConfig".
 
  −
This is converted from [[#TeraPluginProcessorConfig]]. The data starting at offset 0x5 is only initialized by the user-process with [6.0.0+].
  −
 
  −
[[#TeraPluginProcessorConfig]] +0x0, +0x2, and +0x3 are copied to +0x4, 0x6, and +0x7 here. +0x5 here is set to 0x2 | ([[#TeraPluginProcessorConfig]]+0x1 << 7).
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,914: Line 9,815:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x0 || 0x8 || ExposureTime
 
|-
 
|-
| 0x4 || 0x1 || Mode
+
| 0x8 || 0x4 || LightTarget
 
|-
 
|-
| 0x5 || 0x1 ||  
+
| 0xC || 0x4 || Gain
 
|-
 
|-
| 0x6 || 0x1 ||  
+
| 0x10 || 0x1 || IsNegativeImageUsed
 
|-
 
|-
| 0x7 || 0x1 ||
+
| 0x11 || 0x7 || Reserved
|}
  −
 
  −
= PointingProcessorConfig =
  −
This is "nn::irsensor::PointingProcessorConfig".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|OrigFormat]]
 
|-
 
|-
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x1C || 0x4 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
 
|-
 
|-
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
+
| 0x20 || 0x2 || TrimmingStartX
 
|-
 
|-
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
+
| 0x22 || 0x2 || TrimmingStartY
 
|-
 
|-
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
+
| 0x24 || 0x1 || IsExternalLightFilterEnabled
 
|}
 
|}
   −
= PackedPointingProcessorConfig =
+
= PackedImageTransferProcessorExConfig =
This is "nn::irsensor::PackedPointingProcessorConfig".
+
This is "nn::irsensor::PackedImageTransferProcessorExConfig".
   −
This is converted from [[#PointingProcessorConfig]].
+
This is converted from [[#ImageTransferProcessorExConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,950: Line 9,845:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x0 || 0x8 || ExposureTime
 +
|-
 +
| 0x8 || 0x1 || LightTarget
 +
|-
 +
| 0x9 || 0x1 || Gain
 +
|-
 +
| 0xA || 0x1 || IsNegativeImageUsed
 +
|-
 +
| 0xB || 0x5 || Reserved
 +
|-
 +
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 +
|-
 +
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|OrigFormat]]
 +
|-
 +
| 0x15 || 0x1 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
 
|-
 
|-
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
+
| 0x16 || 0x2 || TrimmingStartX
 
|-
 
|-
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
+
| 0x18 || 0x2 || TrimmingStartY
 
|-
 
|-
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
+
| 0x1A || 0x1 || IsExternalLightFilterEnabled
 
|-
 
|-
| 0x8 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x1B || 0x5 || Reserved
 
|}
 
|}
   −
= PackedMcuVersion =
+
= IrLedProcessorConfig =
This is "nn::irsensor::PackedMcuVersion".
+
This is "nn::irsensor::IrLedProcessorConfig".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,968: Line 9,877:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x2 || MajorVersion
+
| 0x0 || 0x4 || LightTarget
|-
  −
| 0x2 || 0x2 || MinorVersion
   
|}
 
|}
   −
== Versions ==
+
= PackedIrLedProcessorConfig =
{| class="wikitable" border="1"
+
This is "nn::irsensor::PackedIrLedProcessorConfig".
 +
 
 +
This is converted from [[#IrLedProcessorConfig]].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
! MajorVersion || MinorVersion || SystemVersion
+
! Offset || Size || Description
 
|-
 
|-
| 0x3 || 0xB || [1.0.0+]
+
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x4 || 0x12 || [4.0.0+]
+
| 0x4 || 0x1 || LightTarget
 
|-
 
|-
| 0x5 || 0x18 || [5.0.0+]
+
| 0x5 || 0x3 || Padding
|-
  −
| 0x6 || 0x1A || [6.0.0+]
  −
|-
  −
| 0x8 || 0x1B || [8.0.0+]
   
|}
 
|}
   −
= PackedFunctionLevel =
+
= AdaptiveClusteringProcessorConfig =
This is nn::irsensor::PackedFunctionLevel.
+
This is "nn::irsensor::AdaptiveClusteringProcessorConfig".
 +
 
 +
AdaptiveClusteringProcessor was added with [5.0.0+].
 +
 
 +
This is converted to [[#TeraPluginProcessorConfig]] by the user-process. [[#TeraPluginProcessorConfig]]+0x3 is zero.
 +
 
 +
The default config is all-zero.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,996: Line 9,909:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x1 || [[#IrSensorFunctionLevel]]
+
| 0x0 || 0x4 || [[#AdaptiveClusteringMode]]
 
|-
 
|-
| 0x1 || 0x3 || Reserved
+
| 0x4 || 0x4 || [6.0.0+] [[#AdaptiveClusteringTargetDistance]]
 
|}
 
|}
   −
== IrSensorFunctionLevel ==
+
== AdaptiveClusteringMode ==
This is "nn::irsensor::IrSensorFunctionLevel".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Value || SystemVersion
+
| 0 || StaticFov
 
|-
 
|-
| 0 || [1.0.0+]
+
| 1 || DynamicFov
|-
  −
| 1 || [4.0.0+]
  −
|-
  −
| 2 || [5.0.0+]
  −
|-
  −
| 3 || [6.0.0+]
  −
|-
  −
| 4 || [8.0.0+]
   
|}
 
|}
   −
= ImageTransferProcessorExConfig =
+
Controls the mode for [[#TeraPluginProcessorConfig]] (DynamicFov -> 0x10; StaticFov -> 0x0F).
This is "nn::irsensor::ImageTransferProcessorExConfig".
      +
== AdaptiveClusteringTargetDistance ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || Near
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 1 || Middle
 
|-
 
|-
| 0x8 || 0x4 || LightTarget
+
| 2 || Far
|-
+
|}
| 0xC || 0x4 || Gain
+
 
 +
Controls the second and third bytes for [[#TeraPluginProcessorConfig]] (Near-> 0x00, 0x00; Middle -> 0x01, 0x03; Far -> 0x01, 0x08).
 +
 
 +
= HandAnalysisConfig =
 +
This is "nn::irsensor::HandAnalysisConfig".
 +
 
 +
This is converted to [[#TeraPluginProcessorConfig]] by the user-process, which is all-zero except the mode.
 +
* pre-4.0.0: [[#TeraPluginProcessorConfig]] mode = [[#HandAnalysisMode]] - 1.
 +
* [4.0.0+]: Silhouette = 0x5, Image = 0x6, SilhouetteAndImage = 0x7, SilhouetteOnly = 0xA.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed
+
! Offset || Size || Description
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0x0 || 0x4 || [[#HandAnalysisMode]]
 +
|}
 +
 
 +
== HandAnalysisMode ==
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|OrigFormat]]
+
| 0 || None (invalid)
 
|-
 
|-
| 0x1C || 0x4 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
+
| 1 || Silhouette
 
|-
 
|-
| 0x20 || 0x2 || TrimmingStartX
+
| 2 || Image
 
|-
 
|-
| 0x22 || 0x2 || TrimmingStartY
+
| 3 || SilhouetteAndImage
 
|-
 
|-
| 0x24 || 0x1 || IsExternalLightFilterEnabled
+
| 4 || [4.0.0+] SilhouetteOnly
 
|}
 
|}
   −
= PackedImageTransferProcessorExConfig =
+
= BusHandle =
This is "nn::irsensor::PackedImageTransferProcessorExConfig".
+
This is "nn::hidbus::BusHandle".
 
  −
This is converted from [[#ImageTransferProcessorExConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,056: Line 9,977:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x4 || AbstractedPadId
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x4 || 0x1 || InternalIndex
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
| 0x5 || 0x1 || PlayerNumber
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x6 || 0x1 || BusTypeId
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x7 || 0x1 || IsValid
 +
|}
 +
 
 +
= JoyPollingReceivedData =
 +
This is "nn::hidbus::JoyPollingReceivedData".
 +
 
 +
This is copied from the entries in [[#EnableJoyPollingReceiveMode|TransferMemory]] by GetJoyPollingReceivedData.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
! Offset || Size || Description
 
|-
 
|-
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|OrigFormat]]
+
| 0x0 || 0x30 || Data
 
|-
 
|-
| 0x15 || 0x1 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
+
| 0x30 || 0x8 || OutSize
 
|-
 
|-
| 0x16 || 0x2 || TrimmingStartX
+
| 0x38 || 0x8 || SamplingNumber
|-
  −
| 0x18 || 0x2 || TrimmingStartY
  −
|-
  −
| 0x1A || 0x1 || IsExternalLightFilterEnabled
  −
|-
  −
| 0x1B || 0x5 || Reserved
   
|}
 
|}
   −
= IrLedProcessorConfig =
+
= BusType =
This is "nn::irsensor::IrLedProcessorConfig".
+
This is "nn::hidbus::BusType".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || LeftJoyRail
 +
|-
 +
| 1 || RightJoyRail
 
|-
 
|-
| 0x0 || 0x4 || LightTarget
+
| 2 || [6.0.0+] InternalBus (for Lark microphone)
 
|}
 
|}
   −
= PackedIrLedProcessorConfig =
+
= JoyPollingMode =
This is "nn::irsensor::PackedIrLedProcessorConfig".
+
This is "nn::hidbus::JoyPollingMode".
 
  −
This is converted from [[#IrLedProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || SixAxisSensorDisable
 
|-
 
|-
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 1 || SixAxisSensorEnable
 
|-
 
|-
| 0x4 || 0x1 || LightTarget
+
| 2 || ButtonOnly
|-
  −
| 0x5 || 0x3 || Padding
   
|}
 
|}
   −
= AdaptiveClusteringProcessorConfig =
+
Other values causes [[#EnableJoyPollingReceiveMode]] to assert.
This is "nn::irsensor::AdaptiveClusteringProcessorConfig".
     −
AdaptiveClusteringProcessor was added with [5.0.0+].
+
= StatusManagerType =
 
+
This is "nn::hidbus::detail::StatusManagerType".
This is converted to [[#TeraPluginProcessorConfig]] by the user-process. [[#TeraPluginProcessorConfig]]+0x3 is zero.
  −
 
  −
The default config is all-zero.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || None
 
|-
 
|-
| 0x0 || 0x4 || [[#AdaptiveClusteringMode]]
+
| 1 || 16
 
|-
 
|-
| 0x4 || 0x4 || [6.0.0+] [[#AdaptiveClusteringTargetDistance]]
+
| 2 || 32
 
|}
 
|}
   −
== AdaptiveClusteringMode ==
+
= ExternalDevices =
{| class="wikitable" border="1"
+
The following devices are used via hidbus:
!  Value
+
* [[Ring-Con]]
!  Description
+
** [[#BusType|BusType]] is 0 (LeftJoyRail) or 1 (RightJoyRail).
|-
+
** [[#GetExternalDeviceId|DeviceId]] is 0x20 ("Ronde").
| 0 || StaticFov
+
* Famicom right controller (with microphone)
|-
+
** [[#BusType|BusType]] is 2 (InternalBus).
| 1 || DynamicFov
+
** [[#GetExternalDeviceId|DeviceId]] is 0x21 ("LarkMic").
|}
+
** SendAndReceive is not used. EnableJoyPollingReceiveMode is used where the input buffer is an u32 with value 0, [[#JoyPollingMode]] = 2. GetJoyPollingReceivedData is used to get the output data.
 +
* "Starlink: Battle For Atlas" controller mount
 +
** [[#BusType|BusType]] is 1 (RightJoyRail).
 +
** [[#GetExternalDeviceId|DeviceId]] is 0x28 ("Flight").
 +
** EnableJoyPollingReceiveMode is used where the input buffer is an u16 with value 0x09, [[#JoyPollingMode]] = 0. SendAndReceive is called from 1 func. GetJoyPollingReceivedData is used to determine whether to call the same func which calls SendAndReceive, which is only done if <code>out_size==0x4 && data[0]==0x09 && (data[1] & 1 == 1)</code>.
 +
 
 +
= 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+]
   −
Controls the mode for [[#TeraPluginProcessorConfig]] (DynamicFov -> 0x10; StaticFov -> 0x0F).
+
These are firmware files for the touchscreen controller.
   −
== AdaptiveClusteringTargetDistance ==
+
[9.0.0+] The hid-sysmodule RomFS now contains:
{| class="wikitable" border="1"
+
  ftmFwUpdate
!  Value
+
    ├── FTS_00120100.fts256
!  Description
+
    ├── FTS_32000001.fts256
|-
+
    ├── FTS_32000102.fts256
| 0 || Near
+
    ├── FTS_32000302.fts256
|-
+
    └── FTS_32000402.fts256
| 1 || Middle
  −
|-
  −
| 2 || Far
  −
|}
     −
Controls the second and third bytes for [[#TeraPluginProcessorConfig]] (Near-> 0x00, 0x00; Middle -> 0x01, 0x03; Far -> 0x01, 0x08).
+
[10.0.0+] The RomFs for hid-sysmodule was removed. The data which used to be in RomFs was moved into title [[Title_list|0100000000000822]].
   −
= HandAnalysisConfig =
+
= Firmware Update =
This is "nn::irsensor::HandAnalysisConfig".
+
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.
   −
This is converted to [[#TeraPluginProcessorConfig]] by the user-process, which is all-zero except the mode.
+
These titles contain the following files:
* pre-4.0.0: [[#TeraPluginProcessorConfig]] mode = [[#HandAnalysisMode]] - 1.
+
* '''ExpectVersionInfo.csv'''
* [4.0.0+]: Silhouette = 0x5, Image = 0x6, SilhouetteAndImage = 0x7, SilhouetteOnly = 0xA.
+
** List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey", "Palma" or "Handheld", "type" can be "BT", "MCU", "USB" or "SioH" and "version" is the hexadecimal representation of the firmware file's version.
 +
* '''FirmwareInfo.csv'''
 +
** List in the format "[device],[type],[version],[file]" where "device", "type" and "version" should match the values from "ExpectVersionInfo" and "file" is the name of the firmware file.
 +
* '''ukyosakyo_ep2_ota.bin'''
 +
** Left/Right Joy-Con BT firmware.
 +
* '''raizo_ep2_ota.bin'''
 +
** Pro Controller BT firmware.
 +
* '''tera_ota.bin'''
 +
** Right Joy-Con MCU firmware.
 +
* '''tera_ota_iap.bin'''
 +
** Right Joy-Con MCU (IAP profile) firmware.
 +
* '''tera_fullkey_ota.bin'''
 +
** Pro Controller MCU firmware.
 +
* '''tera_fullkey_ota_iap.bin'''
 +
** Pro Controller MCU (IAP profile) firmware.
 +
* [6.0.0+] '''ProController.dfu'''
 +
** Pro Controller USB firmware.
 +
* [6.1.0+] '''PalmaFw.bin'''
 +
** Poké Ball Plus BT firmware.
 +
* [8.1.1+] '''ExpectVersionInfo-platform.hoag.csv'''
 +
** Same as "ExpectVersionInfo.csv" but for the Switch Lite platform.
 +
* [8.1.1+] '''FirmwareInfo-platform.hoag.csv'''
 +
** Same as "FirmwareInfo.csv" but for the Switch Lite platform.
 +
* [8.1.1+] '''sioh.bin'''
 +
** Switch Lite Joy-Con firmware.
 +
* [8.1.1+] '''sioh_iap.bin'''
 +
** Switch Lite Joy-Con (IAP profile) firmware.
 +
* [10.0.0+] '''FTS_00120100.fts256'''
 +
** Touch Screen controller firmware in FTS256 format.
 +
* [10.0.0+] '''FTS_32000001.fts256'''
 +
** Touch Screen controller firmware in FTS256 format for panel vendor "Nissha".
 +
* [10.0.0+] '''FTS_32000102.fts256'''
 +
** Touch Screen controller firmware in FTS256 format for panel vendor "GIS".
 +
* [10.0.0+] '''FTS_32000302.fts256'''
 +
** Touch Screen controller firmware in FTS256 format for panel vendor "Nissha_Hoag".
 +
* [10.0.0+] '''FTS_32000402.fts256'''
 +
** Touch Screen controller firmware in FTS256 format for panel vendor "GIS_Hoag".
 +
* [10.0.0+] '''TouchScreenConfiguration.csv'''
 +
** List in the format "[gpio],[gpio],[gpio],[config],[config]" where "gpio" can be "0" or "1" and "config" is an integer number.
 +
* [10.0.0+] '''TouchScreenFirmwareInfo.csv'''
 +
** List in the format "[driver],[gpio],[gpio],[gpio],[version],[file]" where "driver" can be "FTM" or "FST2", "gpio" can be "0" or "1", "version" is the hexadecimal representation of the firmware file's version and "file" is the name of the firmware file.
 +
* [13.0.0+] '''FTS_33000510.fts256'''
 +
** Touch Screen controller firmware in FTS256 format for panel vendor "Samsung_Aula".
 +
* [13.0.0] '''FTS_98000004.ftb'''
 +
** Touch Screen controller firmware in FTB format.
 +
* [13.1.0-13.2.1] '''FTS_50000001.ftb'''
 +
** Touch Screen controller firmware in FTB format for panel vendor "Nissha".
 +
* [14.0.0+] '''FTS_50000002.ftb'''
 +
** Touch Screen controller firmware in FTB format for panel vendor "Nissha".
    +
== Versions ==
 +
=== Ukyosakyo ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! SystemVersion
 +
! FirmwareVersion
 +
|-
 +
| [1.0.0+]
 +
| 0348
 +
|-
 +
| [5.0.0+]
 +
| 0389
 +
|-
 +
| [6.0.0+]
 +
| 038B
 +
|-
 +
| [7.0.0+]
 +
| 03A6
 +
|-
 +
| [8.0.0+]
 +
| 03B5
 +
|-
 +
| [9.0.0+]
 +
| 0400
 +
|-
 +
| [10.0.0+]
 +
| 0406
 +
|-
 +
| [11.0.0+]
 +
| 0407
 +
|-
 +
| [12.1.0+]
 +
| 0410
 +
|-
 +
| [13.0.0+]
 +
| 0417
 
|-
 
|-
| 0x0 || 0x4 || [[#HandAnalysisMode]]
+
| [14.0.0+]
 +
| 0419
 
|}
 
|}
   −
== HandAnalysisMode ==
+
=== Raizo ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
  −
|-
  −
| 0 || None (invalid)
  −
|-
  −
| 1 || Silhouette
   
|-
 
|-
| 2 || Image
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 3 || SilhouetteAndImage
+
| [1.0.0+]
 +
| 0348
 
|-
 
|-
| 4 || [4.0.0+] SilhouetteOnly
+
| [15.0.0+]
 +
| 0421
 
|}
 
|}
   −
= BusHandle =
+
=== Tera ===
This is "nn::hidbus::BusHandle".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 0x0 || 0x4 || AbstractedPadId
+
| [1.0.0+]
 +
| 030B
 
|-
 
|-
| 0x4 || 0x1 || InternalIndex
+
| [4.0.0+]
 +
| 0412
 
|-
 
|-
| 0x5 || 0x1 || PlayerNumber
+
| [5.0.0+]
 +
| 0518
 
|-
 
|-
| 0x6 || 0x1 || BusTypeId
+
| [6.0.0+]
 +
| 061A
 
|-
 
|-
| 0x7 || 0x1 || IsValid
+
| [8.0.0+]
 +
| 081B
 
|}
 
|}
   −
= JoyPollingReceivedData =
+
=== TeraFullKey ===
This is "nn::hidbus::JoyPollingReceivedData".
+
{| class="wikitable" border="1"
 
+
|-
This is copied from the entries in [[#EnableJoyPollingReceiveMode|TransferMemory]] by GetJoyPollingReceivedData.
+
! SystemVersion
 +
! FirmwareVersion
 +
|-
 +
| [1.0.0+]
 +
| 0305
 +
|}
    +
=== ProController ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! SystemVersion
|-
+
! FirmwareVersion
| 0x0 || 0x30 || Data
   
|-
 
|-
| 0x30 || 0x8 || OutSize
+
| -
 +
| 010A0200
 
|-
 
|-
| 0x38 || 0x8 || SamplingNumber
+
| [6.0.0+]
 +
| 01100210
 
|}
 
|}
   −
= BusType =
+
=== Palma ===
This is "nn::hidbus::BusType".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || LeftJoyRail
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 1 || RightJoyRail
+
| -
 +
| 1100
 
|-
 
|-
| 2 || [6.0.0+] InternalBus (for Lark microphone)
+
| [6.1.0+]
 +
| 1200
 
|}
 
|}
   −
= JoyPollingMode =
+
=== SioH ===
This is "nn::hidbus::JoyPollingMode".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || SixAxisSensorDisable
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 1 || SixAxisSensorEnable
+
| -
 +
| 000D
 
|-
 
|-
| 2 || ButtonOnly
+
| [8.1.1+]
|}
+
| 0200
 
  −
Other values causes [[#EnableJoyPollingReceiveMode]] to assert.
  −
 
  −
= StatusManagerType =
  −
This is "nn::hidbus::detail::StatusManagerType".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
  −
|-
  −
| 0 || None
   
|-
 
|-
| 1 || 16
+
| [10.0.0+]
 +
| 0301
 
|-
 
|-
| 2 || 32
+
| [11.0.0+]
 +
| 0304
 
|}
 
|}
  −
= ExternalDevices =
  −
The following devices are used via hidbus:
  −
* [[Ring-Con]]
  −
* Famicom right controller (with microphone)
  −
  −
= RomFS =
  −
The hid-sysmodule RomFS contains:
  −
  ftmFwUpdate
  −
    ├── NTD_4CD_1801.fts256
  −
    ├── NTD_4CD_2602.fts256
  −
    ├── NTD_4CD_3801.fts256
  −
    └── NTD_4CD_xxxx.fts256 [7.0.0+]
  −
  −
These are firmware files for the touchscreen controller.
  −
  −
[9.0.0+] The hid-sysmodule RomFS now contains:
  −
  ftmFwUpdate
  −
    ├── FTS_00120100.fts256
  −
    ├── FTS_32000001.fts256
  −
    ├── FTS_32000102.fts256
  −
    ├── FTS_32000302.fts256
  −
    └── FTS_32000402.fts256
  −
  −
= Firmware update =
  −
HID-sysmodule mounts the contents of title [[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.
  −
  −
[10.0.0+]: The RomFs for hid-sysmodule was removed, the data which used to be in that RomFs was moved into this SystemData (the below .fts256 files).
  −
  −
These titles contain the following files:
  −
* '''ExpectVersionInfo.csv''' - List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey", "Palma" or "Handheld", "type" can be "BT", "MCU", "USB" or "SioH" and "version" is the hexadecimal representation of the firmware file's version.
  −
* '''FirmwareInfo.csv''' - List in the format "[device],[type],[version],[file]" where "device", "type" and "version" should match the values from "ExpectVersionInfo" and "file" is the name of the firmware file.
  −
* '''ukyosakyo_ep2_ota.bin''' - Left/Right Joy-Con BT firmware.
  −
* '''raizo_ep2_ota.bin''' - Pro Controller BT firmware.
  −
* '''tera_ota.bin''' - Right Joy-Con MCU firmware.
  −
* '''tera_ota_iap.bin''' - Right Joy-Con MCU (IAP profile) firmware.
  −
* '''tera_fullkey_ota.bin''' - Pro Controller MCU firmware.
  −
* '''tera_fullkey_ota_iap.bin''' - Pro Controller MCU (IAP profile) firmware.
  −
* [6.0.0+] '''ProController.dfu''' - Pro Controller USB firmware.
  −
* [6.1.0+] '''PalmaFw.bin''' - Poké Ball Plus BT firmware.
  −
* [9.0.0+] '''ExpectVersionInfo-platform.hoag.csv''' - Same as "ExpectVersionInfo.csv" but for the Switch Lite platform.
  −
* [9.0.0+] '''FirmwareInfo-platform.hoag.csv''' - Same as "FirmwareInfo.csv" but for the Switch Lite platform.
  −
* [9.0.0+] '''sioh.bin''' - Switch Lite Joy-Con firmware.
  −
* [9.0.0+] '''sioh_iap.bin''' - Switch Lite Joy-Con (IAP profile) firmware.
  −
* [10.0.0+] '''FTS_00120100.fts256'''
  −
* [10.0.0+] '''FTS_32000001.fts256'''
  −
* [10.0.0+] '''FTS_32000102.fts256'''
  −
* [10.0.0+] '''FTS_32000302.fts256'''
  −
* [10.0.0+] '''FTS_32000402.fts256'''
  −
* [10.0.0+] '''TouchScreenConfiguration.csv'''
  −
* [10.0.0+] '''TouchScreenFirmwareInfo.csv'''
  −
* [13.0.0+] '''FTS_33000510.fts256'''
  −
* [13.0.0+] '''FTS_98000004.ftb'''
      
[[Category:Services]]
 
[[Category:Services]]

Navigation menu