Changes

no edit summary
Line 95: Line 95:  
|-
 
|-
 
| 91 || [[#ActivateGesture]]
 
| 91 || [[#ActivateGesture]]
 +
|-
 +
| 92 || [18.0.0+] SetGestureOutputRanges
 
|-
 
|-
 
| 100 || [[#SetSupportedNpadStyleSet]]
 
| 100 || [[#SetSupportedNpadStyleSet]]
Line 173: 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 195: 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 281: 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]]
Line 533: 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 1,025: Line 1,038:  
|-
 
|-
 
| 17 || [13.0.0+] IsTouchScreenManaged
 
| 17 || [13.0.0+] IsTouchScreenManaged
 +
|-
 +
| 18 || [18.0.0+] SetTouchScreenAutoPilotStateWithAruid
 
|-
 
|-
 
| 20 || [[#DeactivateMouse]]
 
| 20 || [[#DeactivateMouse]]
Line 1,139: 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,233: 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,255: Line 1,276:  
|-
 
|-
 
| 600 || [10.0.0+] ConvertPadState
 
| 600 || [10.0.0+] ConvertPadState
 +
|-
 +
| 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]]
 +
|-
 +
| 606 || [18.0.0+] [[#SetButtonConfigEmbeddedEnabled]]
 +
|-
 +
| 607 || [18.0.0+] [[#IsButtonConfigEnabled]]
 +
|-
 +
| 608 || [18.0.0+] [[#IsButtonConfigEmbeddedEnabled]]
 +
|-
 +
| 609 || [18.0.0+] [[#SetButtonConfigEmbedded]]
 +
|-
 +
| 610 || [18.0.0+] [[#SetButtonConfigFull]]
 +
|-
 +
| 611 || [18.0.0+] [[#SetButtonConfigLeft]]
 +
|-
 +
| 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
 
| 650 || [12.0.0+] AddButtonPlayData
Line 1,360: 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,681: Line 1,736:  
|-
 
|-
 
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
 
| 812 || [8.0.0+] GetConsoleUniqueSixAxisSensorHandle
 +
|-
 +
| 813 || [18.0.0+] GetDeviceType
 
|-
 
|-
 
| 821 || StartAnalogStickManualCalibration
 
| 821 || StartAnalogStickManualCalibration
Line 1,782: 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,898: 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 2,060: Line 2,125:     
It first ensures the touch screen IC's chip id is one of the following:
 
It first ensures the touch screen IC's chip id is one of the following:
  0x7036 - STMicroelectronics FingerTipS FT9CJ/FT9CF
+
  0x7036 - Ftm4cd60d (STMicroelectronics FingerTipS FT9CJ/FT9CF)
  0x4036 - ?
+
  0x4036 - Fst2ba61ya1
    
Then constructs the final firmware version as follows:
 
Then constructs the final firmware version as follows:
Line 7,281: Line 7,346:  
| "MY" || [[#DeviceTypeInternal|DeviceType]] 4 and [[#DeviceTypeInternal|DeviceType]] 5
 
| "MY" || [[#DeviceTypeInternal|DeviceType]] 4 and [[#DeviceTypeInternal|DeviceType]] 5
 
|-
 
|-
| "LC" || [[#DeviceTypeInternal|DeviceType]] 6 and [[#DeviceTypeInternal|DeviceType]] 30
+
| "LC" || "Tarragon" ([[#DeviceTypeInternal|DeviceType]] 6) and [[#DeviceTypeInternal|DeviceType]] 30
 
|-
 
|-
 
| "HL" || Famicom left controller
 
| "HL" || Famicom left controller
Line 7,477: Line 7,542:  
| 2 || Rail
 
| 2 || Rail
 
|-
 
|-
| 3 || USB
+
| 3 || Usb
 
|-
 
|-
 
| 4 || Embedded
 
| 4 || Embedded
Line 7,723: Line 7,788:  
| 5 || JoyRight || RightController || ||
 
| 5 || JoyRight || RightController || ||
 
|-
 
|-
| 6 || FullKey || FullKeyController || ||
+
| 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,774: Line 7,839:  
|}
 
|}
   −
= NpadPowerInfo =
+
= VidPidDefinition =
This is "nn::hid::system::NpadPowerInfo".
+
This is "nn::hidtypes::VidPidDefinition".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 7,784: 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]]
 
|-
 
|-
| 0x0 || 0x4 || TypeValue
+
| 0x57E || 0x2006 || 0x2006 || 2
 
|-
 
|-
| 0x0 || 0x1 ||  
+
| 0x57E || 0x2007 || 0x2007 || 1
 
|-
 
|-
| 0x1 || 0x1 ||  
+
| 0x57E || 0x2009 || 0x2009 || 3
|}
+
|-
 
+
| 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
|}
  −
 
  −
= VibrationDeviceInfo =
  −
This is "nn::hid::VibrationDeviceInfo" / "nn::hid::VibrationDeviceInfoForIpc". This is a 0x8-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x57E || 0x300D || 0x300D || [17.0.0+] 14
 
|-
 
|-
| 0x0 || 0x4 || [[#VibrationDeviceType|DeviceType]]
+
| 0xF0D || 0x92 || 0x92 || 15
 
|-
 
|-
| 0x4 || 0x4 || [[#VibrationDevicePosition|Position]]
+
| 0xF0D || 0xAB || 0xAA || 15
|}
  −
 
  −
= VibrationDeviceType =
  −
This is "nn::hid::VibrationDeviceType".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Unknown
+
| 0xF0D || 0xC1 || 0xC1 || 15
 
|-
 
|-
| 1 || LinearResonantActuator
+
| 0xF0D || 0xFF || 0xF0 || 15
 
|-
 
|-
| 2 || GcErm
+
| 0xF0D || 0x22F || 0x200 || 15
 
|-
 
|-
| 3 || Erm
+
| 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,903: 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
 
|-
 
|-
| 1 || Standard
+
| 0x0 || 0x4 || TypeValue
 +
|-
 +
| 0x0 || 0x1 || NpadStyleIndex
 +
|-
 +
| 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,970: 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,984: Line 8,021:  
!  Description
 
!  Description
 
|-
 
|-
| 0 || PlayActivity
+
| 0 || Unknown
 
|-
 
|-
| 1 || SetFrModeType
+
| 1 || LinearResonantActuator
 
|-
 
|-
| 2 || ReadStep
+
| 2 || GcErm
 
|-
 
|-
| 3 || EnableStep
+
| 3 || Erm
 +
|}
 +
 
 +
= VibrationDevicePosition =
 +
This is "nn::hid::VibrationDevicePosition".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 4 || ResetStep
+
| 0 || None
 
|-
 
|-
| 5 || ReadApplicationSection
+
| 1 || Left
 
|-
 
|-
| 6 || WriteApplicationSection
+
| 2 || Right
 +
|}
 +
 
 +
= VibrationValue =
 +
This is "nn::hid::VibrationValue". This is a 0x10-byte struct, which contains 4 float values.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 7 || ReadUniqueCode
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 8 || SetUniqueCodeInvalid
+
| 0x0
 +
| 0x4
 +
| AmplitudeLow
 
|-
 
|-
| 9 || WriteActivityEntry
+
| 0x4
 +
| 0x4
 +
| FrequencyLow
 
|-
 
|-
| 10 || WriteRgbLedPatternEntry
+
| 0x8
 +
| 0x4
 +
| AmplitudeHigh
 
|-
 
|-
| 11 || WriteWaveEntry
+
| 0xC
|-
+
| 0x4
| 12 || ReadDataBaseIdentificationVersion
+
| FrequencyHigh
|-
  −
| 13 || WriteDataBaseIdentificationVersion
  −
|-
  −
| 14 || SuspendFeature
  −
|-
  −
| 15 || [5.1.0+] ReadPlayLog
  −
|-
  −
| 16 || [5.1.0+] ResetPlayLog
   
|}
 
|}
   −
= PalmaFrModeType =
+
= VibrationGcErmCommand =
This is "nn::hid::PalmaFrModeType".
+
This is "nn::hid::VibrationGcErmCommand".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  Value
 
!  Value
 +
!  Name
 
!  Description
 
!  Description
 
|-
 
|-
| 0 || Off
+
| 0 || Stop || Stops the vibration with a decay phase.
 
|-
 
|-
| 1 || B01
+
| 1 || Start || Starts the vibration.
 
|-
 
|-
| 2 || B02
+
| 2 || StopHard || Stops the vibration immediately, with no decay phase.
|-
  −
| 3 || B03
  −
|-
  −
| 4 || Downloaded
   
|}
 
|}
   −
= PalmaApplicationSectionAccessBuffer =
+
= AccelerometerPlayMode =
This is "nn::hid::PalmaApplicationSectionAccessBuffer". This is a 0x100-byte struct.
+
This is "nn::hid::debug::AccelerometerPlayMode" (pre-10.0.0 this is "nn::hid::AccelerometerPlayMode").
 
  −
= PalmaActivityEntry =
  −
This is "nn::hid::PalmaActivityEntry".
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || Loose
 
|-
 
|-
| 0x0 || 0x2 || RgbLedPatternIndex.
+
| 1 || Tight
|-
  −
| 0x2 || 0x2 || Padding
  −
|-
  −
| 0x4 || 0x4 || [[#PalmaWaveSet|WaveSet]].
  −
|-
  −
| 0x8 || 0x2 || WaveIndex.
   
|}
 
|}
   −
= PalmaWaveSet =
+
= GyroscopeZeroDriftMode =
This is "nn::hid::PalmaWaveSet".
+
This is "nn::hid::GyroscopeZeroDriftMode".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,063: Line 8,104:  
!  Description
 
!  Description
 
|-
 
|-
| 0 || Small
+
| 0 || Loose
 
|-
 
|-
| 1 || Medium
+
| 1 || Standard
 
|-
 
|-
| 2 || Large
+
| 2 || Tight
 
|}
 
|}
   −
= PalmaFeature =
+
= PalmaConnectionHandle =
This is "nn::hid::PalmaFeature".
+
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"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Bit
+
! Offset || Size || Description
! Description
   
|-
 
|-
| 0
+
| 0x0 || 0x4 || [[#PalmaOperationType]]
| FrMode
   
|-
 
|-
| 1
+
| 0x4 || 0x4 || Result
| RumbleFeedback
  −
|-
  −
| 2
  −
| Step
  −
|-
  −
| 3
  −
| MuteSwitch
   
|-
 
|-
 +
| 0x8 || 0x140 || Buffer for [[#GetPalmaOperationInfo]].
 
|}
 
|}
   −
= AbstractedPadState =
+
= PalmaOperationType =
 +
This is "nn::hid::PalmaOperationType".
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || PlayActivity
 
|-
 
|-
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
+
| 1 || SetFrModeType
 
|-
 
|-
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
+
| 2 || ReadStep
 
|-
 
|-
| 0x5 || 0x3 || Padding
+
| 3 || EnableStep
 
|-
 
|-
| 0x8 || 0x4 || RGBA Single Body Color
+
| 4 || ResetStep
 
|-
 
|-
| 0xC || 0x4 || RGBA Single Buttons Color
+
| 5 || ReadApplicationSection
 
|-
 
|-
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
+
| 6 || WriteApplicationSection
 
|-
 
|-
| 0x11 || 0x3 || Padding
+
| 7 || ReadUniqueCode
 
|-
 
|-
| 0x14 || 0x24 || [[#HdlsState]]. Unknown if the last 4-bytes are included in this struct, [[#SetAutoPilotVirtualPadState]]/[[#hiddbgGetAbstractedPadsState]] only uses the first 0x20-bytes.
+
| 8 || SetUniqueCodeInvalid
 
|-
 
|-
| 0x38 || 0x60 || Unused with [[#SetAutoPilotVirtualPadState]]/[[#GetAbstractedPadsState]].
+
| 9 || WriteActivityEntry
|}
  −
 
  −
Normally the input state is merged with an existing controller selected by Type. However in some cases (BIT(2-5) with type2!=0x2 and BIT(31)) it's detected as a dedicated controller.
  −
 
  −
Type:
  −
{| class="wikitable" border="1"
  −
!  Bits
  −
!  [[#HdlsDeviceInfo]]::type bits
  −
!  Description
  −
!  Notes
   
|-
 
|-
| 0 || 0 || ||  
+
| 10 || WriteRgbLedPatternEntry
 
|-
 
|-
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
+
| 11 || WriteWaveEntry
 
|-
 
|-
| 2 || 1 || ||  
+
| 12 || ReadDataBaseIdentificationVersion
 
|-
 
|-
| 3 || 2 || ||  
+
| 13 || WriteDataBaseIdentificationVersion
 
|-
 
|-
| 4 || 1 || ||  
+
| 14 || SuspendFeature
 
|-
 
|-
| 5 || 2 || ||  
+
| 15 || [5.1.0+] ReadPlayLog
 
|-
 
|-
| 6 || 3 || ||  
+
| 16 || [5.1.0+] ResetPlayLog
 +
|}
 +
 
 +
= PalmaFrModeType =
 +
This is "nn::hid::PalmaFrModeType".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
+
| 0 || Off
 
|-
 
|-
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
+
| 1 || B01
 
|-
 
|-
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
+
| 2 || B02
 
|-
 
|-
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
+
| 3 || B03
 
|-
 
|-
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
+
| 4 || Downloaded
 +
|}
 +
 
 +
= PalmaApplicationSectionAccessBuffer =
 +
This is "nn::hid::PalmaApplicationSectionAccessBuffer". This is a 0x100-byte struct.
 +
 
 +
= PalmaActivityEntry =
 +
This is "nn::hid::PalmaActivityEntry".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
+
! Offset || Size || Description
 
|-
 
|-
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
+
| 0x0 || 0x2 || RgbLedPatternIndex.
 
|-
 
|-
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
+
| 0x2 || 0x2 || Padding
 
|-
 
|-
| 15 || 17 || ||
+
| 0x4 || 0x4 || [[#PalmaWaveSet|WaveSet]].
|-
  −
| 31 || 21 || || [[#DeviceType]] = BIT(31)
   
|-
 
|-
 +
| 0x8 || 0x2 || WaveIndex.
 
|}
 
|}
   −
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
+
= PalmaWaveSet =
 
+
This is "nn::hid::PalmaWaveSet".
= DebugPadAutoPilotState =
  −
This is "nn::hid::debug::DebugPadAutoPilotState"
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset
+
| 0 || Small
! Size
  −
! Description
   
|-
 
|-
| 0x0
+
| 1 || Medium
| 0x4
  −
| [[#DebugPadAttributeSet|Attributes]]
   
|-
 
|-
| 0x4
+
| 2 || Large
| 0x4
  −
| [[#DebugPadButtonSet|Buttons]]
  −
|-
  −
| 0x8
  −
| 0x8
  −
| [[#AnalogStickState|AnalogStickL]]
  −
|-
  −
| 0x10
  −
| 0x8
  −
| [[#AnalogStickState|AnalogStickR]]
   
|}
 
|}
   −
= MouseAutoPilotState =
+
= PalmaFeature =
This is "nn::hid::debug::MouseAutoPilotState".
+
This is "nn::hid::PalmaFeature".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Bit
! Size
   
! Description
 
! Description
 
|-
 
|-
| 0x0
+
| 0
| 0x4
+
| FrMode
| X
   
|-
 
|-
| 0x4
+
| 1
| 0x4
+
| RumbleFeedback
| Y
   
|-
 
|-
| 0x8
+
| 2
| 0x4
+
| Step
| DeltaX
   
|-
 
|-
| 0xC
+
| 3
| 0x4
+
| MuteSwitch
| DeltaY
   
|-
 
|-
| 0x10
  −
| 0x4
  −
| WheelDelta
  −
|-
  −
| 0x14
  −
| 0x4
  −
| [[#MouseButtonSet|Buttons]]
  −
|-
  −
| 0x18
  −
| 0x4
  −
| [[#MouseAttributeSet|Attributes]]
   
|}
 
|}
   −
= KeyboardAutoPilotState =
+
= AbstractedPadState =
This is "nn::hid::debug::KeyboardAutoPilotState".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset || Size || Description
! Size
  −
! Description
   
|-
 
|-
| 0x0
+
| 0x0 || 0x4 || Type, only 1 bit can be set. Converted to [[#HdlsDeviceInfo]]::type internally by [[#SetAutoPilotVirtualPadState]].
| 0x8
  −
| [[#KeyboardModifierSet|Modifiers]]
   
|-
 
|-
| 0x8
+
| 0x4 || 0x1 || Flags. [[#SetAutoPilotVirtualPadState]] only uses bit0: when clear it will skip using the rest of the input and run [[#UnsetAutoPilotVirtualPadState]] internally.
| 0x20
  −
| [[#KeyboardKeySet|Keys]]
  −
|}
  −
 
  −
= SleepButtonAutoPilotState =
  −
This is "nn::hid::debug::SleepButtonAutoPilotState". This is a 0x8-byte struct with 8-byte alignment.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset
+
| 0x5 || 0x3 || Padding
! Size
  −
! Description
   
|-
 
|-
| 0x0 || 0x8 || Buttons (only bit0 is used)
+
| 0x8 || 0x4 || RGBA Single Body Color
|}
  −
 
  −
= PowerInfo =
  −
This is "nn::hidtypes::PowerInfo".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset
+
| 0xC || 0x4 || RGBA Single Buttons Color
! Size
  −
! Description
   
|-
 
|-
| 0x0 || 0x4 || BatteryLevel
+
| 0x10 || 0x1 || See [[#HiddbgHdlsDeviceInfo]]::[[#NpadInterfaceType]].
 
|-
 
|-
| 0x4 || 0x4 || [[#PowerAttribute]]
+
| 0x11 || 0x3 || Padding
|}
  −
 
  −
= PowerAttribute =
  −
This is "nn::hidtypes::PowerAttribute". This is a 32-bit flag.
  −
 
  −
{| class="wikitable" border="1"
  −
!  Bits
  −
!  Description
   
|-
 
|-
| 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
+
| 1 || 15 || || [[#DeviceType]] |= BIT(1)
| HasVirtualSixAxisSensorAcceleration
   
|-
 
|-
| 1
+
| 2 || 1 || ||
| HasVirtualSixAxisSensorAngle
+
|-
|}
+
| 3 || 2 || ||
 
+
|-
= HdlsHandle =
+
| 4 || 1 || ||
This is "nn::hid::debug::HdlsHandle". This is a 0x8-byte struct with 8-byte alignment.
+
|-
 
+
| 5 || 2 || ||
= HdlsSessionId =
+
|-
This is "nn::hid::debug::detail::HdlsSessionId". This is a 0x8-byte struct with 8-byte alignment.
+
| 6 || 3 || ||
 
  −
= HdlsNpadAssignment =
  −
This is a 0x208-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 7 || 11 || || [[#DeviceType]] |= BIT(11)
 
|-
 
|-
| 0x0 || 0x4 || s32 Total entries
+
| 8 || 12 || || [[#DeviceType]] |= BIT(12)
 
|-
 
|-
| 0x4 || 0x4 || Padding
+
| 9 || 13 || || [[#DeviceType]] |= BIT(13)
 
|-
 
|-
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
+
| 10 || 14 || || [[#DeviceType]] |= BIT(14)
|}
  −
 
  −
= HdlsNpadAssignmentEntry =
  −
This is a 0x20-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 11 || 15 || || [[#DeviceType]] |= BIT(11)
 
|-
 
|-
| 0x0 || 0x8 || [[#HdlsHandle]]
+
| 12 || 12 || || [[#DeviceType]] |= BIT(12)
 
|-
 
|-
| 0x8 || 0x4 || ?
+
| 13 || 13 || || [[#DeviceType]] |= BIT(13)
 
|-
 
|-
| 0xC || 0x4 || ?
+
| 14 || 14 || || [[#DeviceType]] |= BIT(14)
 
|-
 
|-
| 0x10 || 0x8 || ?
+
| 15 || 17 || ||  
 
|-
 
|-
| 0x18 || 0x1 || ?
+
| 31 || 21 || || [[#DeviceType]] = BIT(31)
 
|-
 
|-
| 0x19 || 0x7 || Padding
   
|}
 
|}
   −
= HdlsStateList =
+
The above "[[#DeviceType]] |=" notes only apply when type2 is 0x2.
This is a 0x408-byte struct.
     −
[9.0.0+] This is a 0x488-byte struct.
+
= DebugPadAutoPilotState =
 +
This is "nn::hid::debug::DebugPadAutoPilotState"
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x4 || s32 Total entries
+
| 0x0
|-
+
| 0x4
| 0x4 || 0x4 || Padding
+
| [[#DebugPadAttributeSet|Attributes]]
 +
|-
 +
| 0x4
 +
| 0x4
 +
| [[#DebugPadButtonSet|Buttons]]
 +
|-
 +
| 0x8
 +
| 0x8
 +
| [[#AnalogStickState|AnalogStickL]]
 
|-
 
|-
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
+
| 0x10
 +
| 0x8
 +
| [[#AnalogStickState|AnalogStickR]]
 
|}
 
|}
   −
This contains a list of all controllers, including non-virtual controllers.
+
= MouseAutoPilotState =
 
+
This is "nn::hid::debug::MouseAutoPilotState".
= HdlsStateListEntry =
  −
This is a 0x40-byte struct.
  −
 
  −
[9.0.0+] This is a 0x48-byte struct.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 +
|-
 +
| 0x0
 +
| 0x4
 +
| X
 +
|-
 +
| 0x4
 +
| 0x4
 +
| Y
 +
|-
 +
| 0x8
 +
| 0x4
 +
| DeltaX
 
|-
 
|-
| 0x0 || 0x8 || [[#HdlsHandle]]
+
| 0xC
 +
| 0x4
 +
| DeltaY
 
|-
 
|-
| 0x8 || [[#HdlsDeviceInfo]] size || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
+
| 0x10
 +
| 0x4
 +
| WheelDelta
 
|-
 
|-
| 0x8 + [[#HdlsDeviceInfo]] size, with 8-byte alignment || 0x24 || [[#HdlsState]]
+
| 0x14
 +
| 0x4
 +
| [[#MouseButtonSet|Buttons]]
 
|-
 
|-
| <Immediately following the above> || 0x4 || Padding
+
| 0x18
 +
| 0x4
 +
| [[#MouseAttributeSet|Attributes]]
 
|}
 
|}
   −
= HdlsDeviceInfo =
+
= KeyboardAutoPilotState =
This is "nn::hid::debug::HdlsDeviceInfo". This is a 0x10-byte struct.
+
This is "nn::hid::debug::KeyboardAutoPilotState".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x4 || [[#DeviceTypeInternal]]
+
| 0x0
 +
| 0x8
 +
| [[#KeyboardModifierSet|Modifiers]]
 
|-
 
|-
| 0x4 || 0x4 || RGBA Single Body Color
+
| 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"
 
|-
 
|-
| 0x8 || 0x4 || RGBA Single Buttons Color
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 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.
+
| 0x0 || 0x8 || Buttons (only bit0 is used)
|-
  −
| 0xD || 0x3 || Padding
   
|}
 
|}
   −
[9.0.0+] This is a 0x14-byte struct.
+
= PowerInfo =
 +
This is "nn::hidtypes::PowerInfo".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
+
| 0x0 || 0x4 || BatteryLevel
 
|-
 
|-
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
+
| 0x4 || 0x4 || [[#PowerAttribute]]
 +
|}
 +
 
 +
= PowerAttribute =
 +
This is "nn::hidtypes::PowerAttribute". This is a 32-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 +
!  Bits
 +
!  Description
 
|-
 
|-
| 0x2 || 0x2 || Padding
+
| 0
 +
| IsPowered
 
|-
 
|-
| 0x4 || 0x4 || RGBA Single Body Color
+
| 1
|-
+
| IsCharging
| 0x8 || 0x4 || RGBA Single Buttons Color
  −
|-
  −
| 0xC || 0x4 || RGBA Left Grip Color
  −
|-
  −
| 0x10 || 0x4 || RGBA Right Grip Color
   
|}
 
|}
   −
= HdlsState =
+
= HdlsAttribute =
This is "nn::hid::debug::HdlsState". This is a 0x24-byte struct.
+
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 || 0x1 || IsPowered for the main PowerInfo.
+
| 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"
 
|-
 
|-
| 0x1 || 0x1 || ORRed with IsPowered to set the value of the first byte for the controller [[#NpadSystemProperties]].
+
! Offset || Size || Description
 
|-
 
|-
| 0x2 || 0x6 || Unknown
+
| 0x0 || 0x4 || s32 Total entries
 
|-
 
|-
| 0x8 || 0x4 || BatteryLevel for the main PowerInfo.
+
| 0x4 || 0x4 || Padding
 
|-
 
|-
| 0xC || 0x4 || [[#NpadButton|Buttons]]. Bit18 = HOME and bit19 = Capture.
+
| 0x8 || 0x200(0x20*0x10) || Array of [[#HdlsNpadAssignmentEntry]].
|-
  −
| 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):
+
= HdlsNpadAssignmentEntry =
 +
This is a 0x20-byte struct.
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || [[#PowerInfo]]
+
| 0x0 || 0x8 || [[#HdlsHandle]]
 +
|-
 +
| 0x8 || 0x4 || ?
 
|-
 
|-
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
+
| 0xC || 0x4 || ?
 
|-
 
|-
| 0x10 || 0x10(4*2*2) || Joystick data.
+
| 0x10 || 0x8 || ?
 
|-
 
|-
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
+
| 0x18 || 0x1 || ?
 
|-
 
|-
| 0x21 || 0x7 || Padding
+
| 0x19 || 0x7 || Padding
 
|}
 
|}
   −
[12.0.0+] (0x40-bytes):
+
= HdlsStateList =
 +
This is a 0x408-byte struct.
 +
 
 +
[9.0.0+] This is a 0x488-byte struct.
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || [[#PowerInfo]]
+
| 0x0 || 0x4 || s32 Total entries
 
|-
 
|-
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
+
| 0x4 || 0x4 || Padding
 
|-
 
|-
| 0x10 || 0x10(4*2*2) || Joystick data.
+
| 0x8 || <[[#HdlsStateListEntry]] size>*0x10 || Array of [[#HdlsStateListEntry]].
|-
+
|}
| 0x20 || 0xC || VirtualSixAxisSensorAcceleration
+
 
 +
This contains a list of all controllers, including non-virtual controllers.
 +
 
 +
= HdlsStateListEntry =
 +
This is a 0x40-byte struct.
 +
 
 +
[9.0.0+] This is a 0x48-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 
|-
 
|-
| 0x2C || 0xC || VirtualSixAxisSensorAngle
+
| 0x0 || 0x8 || [[#HdlsHandle]]
 
|-
 
|-
| 0x38 || 0x4 || [[#HdlsAttribute]]
+
| 0x8 || [[#HdlsDeviceInfo]] size || [[#HdlsDeviceInfo]]. With [[#ApplyHdlsStateList]] this is only used when creating new devices.
 
|-
 
|-
| 0x3C || 0x1 || Indicator. Unused for input.
+
| 0x8 + [[#HdlsDeviceInfo]] size, with 8-byte alignment || 0x24 || [[#HdlsState]]
 
|-
 
|-
| 0x3D || 0x3 || Padding
+
| <Immediately following the above> || 0x4 || Padding
 
|}
 
|}
   −
= DebugRegisteredDevice =
+
= HdlsDeviceInfo =
This is "nn::hid::debug::RegisteredDevice". This is a 0x58-byte struct with 2-byte alignment.
+
This is "nn::hid::debug::HdlsDeviceInfo". This is a 0x10-byte struct.
   −
= RegisteredDevice =
+
{| class="wikitable" border="1"
This is "nn::hid::system::RegisteredDevice". This is a 0x68-byte struct with 4-byte alignment.
+
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#DeviceTypeInternal]]
 +
|-
 +
| 0x4 || 0x4 || RGBA Single Body Color
 +
|-
 +
| 0x8 || 0x4 || RGBA Single Buttons Color
 +
|-
 +
| 0xC || 0x1 || [[#NpadInterfaceType]]. Additional type field used with the above type field, if the value doesn't match one of the following a default is used. Type Pro-Controller: value 0x3 indicates that the controller is connected via USB. Type bit21: value 0x3 = unknown. When value is 0x2, state is merged with an existing controller (when the type value is compatible with this). Otherwise, it's a dedicated controller.
 +
|-
 +
| 0xD || 0x3 || Padding
 +
|}
   −
= NotificationLedPattern =
+
[9.0.0+] This is a 0x14-byte struct.
This is "nn::hid::system::NotificationLedPattern". This is a 0x48-byte struct.
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset || Size || Description
! Size
  −
! Description
   
|-
 
|-
| 0x0
+
| 0x0 || 0x1 || [[#DeviceTypeInternal]]
| 0x1
  −
| TimeUnit
   
|-
 
|-
| 0x1
+
| 0x1 || 0x1 || [[#NpadInterfaceType]]. Similar to the field from the old struct.
| 0x1
  −
| FrameCount
   
|-
 
|-
| 0x2
+
| 0x2 || 0x2 || Padding
| 0x1
  −
| CycleCount
   
|-
 
|-
| 0x3
+
| 0x4 || 0x4 || RGBA Single Body Color
| 0x1
  −
| InitialBrightness
   
|-
 
|-
| 0x4
+
| 0x8 || 0x4 || RGBA Single Buttons Color
| 0x4 * 15
+
|-
| [[#Frame|Frames]]
+
| 0xC || 0x4 || RGBA Left Grip Color
 +
|-
 +
| 0x10 || 0x4 || RGBA Right Grip Color
 +
|}
 +
 
 +
= HdlsState =
 +
This is "nn::hid::debug::HdlsState". This is a 0x24-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || IsPowered for the main PowerInfo.
 +
|-
 +
| 0x1 || 0x1 || ORRed with IsPowered to set the value of the first byte for the controller [[#NpadSystemProperties]].
 +
|-
 +
| 0x2 || 0x6 || Unknown
 +
|-
 +
| 0x8 || 0x4 || BatteryLevel for the main PowerInfo.
 +
|-
 +
| 0xC || 0x4 || [[#NpadButton|Buttons]]. Bit18 = HOME and bit19 = Capture.
 
|-
 
|-
| 0x40
+
| 0x10 || 0x10(4*2*2) || Joystick data.
| 0x1
  −
| FinalBrightness
   
|-
 
|-
| 0x41
+
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
| 0x1
  −
| TimeTowardsFinalBrightness
   
|-
 
|-
| 0x42
+
| 0x21 || 0x3 || Padding
| 0x6
  −
| Reserved
   
|}
 
|}
   −
== Frame ==
+
[9.0.0+] (0x28-bytes):
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset
+
! Offset || Size || Description
! Size
+
|-
! Description
+
| 0x0 || 0x8 || [[#PowerInfo]]
 
|-
 
|-
| 0x0
+
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
| 0x1
  −
| Brightness
   
|-
 
|-
| 0x1
+
| 0x10 || 0x10(4*2*2) || Joystick data.
| 0x1
  −
| TimeTowards
   
|-
 
|-
| 0x2
+
| 0x20 || 0x1 || Indicator. Unused for input. Set with output from [[#DumpHdlsStates]] (zero in some cases).
| 0x1
  −
| TimeToHold
   
|-
 
|-
| 0x3
+
| 0x21 || 0x7 || Padding
| 0x1
  −
| Reserved
   
|}
 
|}
   −
= SystemButtonConfigEmbedded =
+
[12.0.0+] (0x40-bytes):
This is "nn::hid::system::ButtonConfigEmbedded". This is a 0x2C8-byte struct.
  −
 
  −
= SystemButtonConfigFull =
  −
This is "nn::hid::system::ButtonConfigFull". This is a 0x2C8-byte struct.
  −
 
  −
= SystemButtonConfigLeft =
  −
This is "nn::hid::system::ButtonConfigLeft". This is a 0x1C8-byte struct.
  −
 
  −
= SystemButtonConfigRight =
  −
This is "nn::hid::system::ButtonConfigRight". This is a 0x1A0-byte struct.
  −
 
  −
= ButtonConfigEmbedded =
  −
This is "nn::hidconfig::ButtonConfigEmbedded". This is a 0x54-byte struct.
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeft]]
+
| 0x0 || 0x8 || [[#PowerInfo]]
 
|-
 
|-
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonUp]]
+
| 0x8 || 0x8 || [[#NpadButton|Buttons]], masked with 0xfffffffff00fffff. See above table regarding HOME/Capture buttons.
 
|-
 
|-
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRight]]
+
| 0x10 || 0x10(4*2*2) || Joystick data.
 
|-
 
|-
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonDown]]
+
| 0x20 || 0xC || VirtualSixAxisSensorAcceleration
 
|-
 
|-
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonA]]
+
| 0x2C || 0xC || VirtualSixAxisSensorAngle
 
|-
 
|-
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonB]]
+
| 0x38 || 0x4 || [[#HdlsAttribute]]
 
|-
 
|-
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonX]]
+
| 0x3C || 0x1 || Indicator. Unused for input.
 
|-
 
|-
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonY]]
+
| 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"
 
|-
 
|-
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickL]]
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickR]]
+
| 0x0
 +
| 0x1
 +
| TimeUnit
 
|-
 
|-
| 0x28 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonL]]
+
| 0x1
 +
| 0x1
 +
| FrameCount
 
|-
 
|-
| 0x2C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonR]]
+
| 0x2
 +
| 0x1
 +
| CycleCount
 
|-
 
|-
| 0x30 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZL]]
+
| 0x3
 +
| 0x1
 +
| InitialBrightness
 
|-
 
|-
| 0x34 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZR]]
+
| 0x4
 +
| 0x4 * 15
 +
| [[#Frame|Frames]]
 
|-
 
|-
| 0x38 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonSelect]]
+
| 0x40
 +
| 0x1
 +
| FinalBrightness
 
|-
 
|-
| 0x3C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStart]]
+
| 0x41
 +
| 0x1
 +
| TimeTowardsFinalBrightness
 
|-
 
|-
| 0x40 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonCapture]]
+
| 0x42
|-
+
| 0x6
| 0x44 || 0x8 || [[#AnalogStickAssignment|HardwareStickL]]
+
| Reserved
|-
  −
| 0x4C || 0x8 || [[#AnalogStickAssignment|HardwareStickR]]
   
|}
 
|}
   −
== DigitalButtonAssignment ==
+
== Frame ==
This is "nn::hidconfig::DigitalButtonAssignment".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || A
+
! Offset
 +
! Size
 +
! Description
 
|-
 
|-
| 1 || B
+
| 0x0
 +
| 0x1
 +
| Brightness
 
|-
 
|-
| 2 || X
+
| 0x1
 +
| 0x1
 +
| TimeTowards
 
|-
 
|-
| 3 || Y
+
| 0x2
 +
| 0x1
 +
| TimeToHold
 
|-
 
|-
| 4 || StickL
+
| 0x3
|-
+
| 0x1
| 5 || StickR
+
| Reserved
|-
+
|}
| 6 || L
+
 
|-
+
= SystemButtonConfigEmbedded =
| 7 || R
+
This is "nn::hid::system::ButtonConfigEmbedded". This is a 0x2C8-byte struct.
|-
+
 
| 8 || ZL
+
= SystemButtonConfigFull =
 +
This is "nn::hid::system::ButtonConfigFull". This is a 0x2C8-byte struct.
 +
 
 +
= SystemButtonConfigLeft =
 +
This is "nn::hid::system::ButtonConfigLeft". This is a 0x1C8-byte struct.
 +
 
 +
= SystemButtonConfigRight =
 +
This is "nn::hid::system::ButtonConfigRight". This is a 0x1A0-byte struct.
 +
 
 +
= ButtonConfigEmbedded =
 +
This is "nn::hidconfig::ButtonConfigEmbedded". This is a 0x54-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeft]]
 
|-
 
|-
| 9 || ZR
+
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonUp]]
 
|-
 
|-
| 10 || Select
+
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRight]]
 
|-
 
|-
| 11 || Start
+
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonDown]]
 
|-
 
|-
| 12 || Left
+
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonA]]
 
|-
 
|-
| 13 || Up
+
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonB]]
 
|-
 
|-
| 14 || Right
+
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonX]]
 
|-
 
|-
| 15 || Down
+
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonY]]
 
|-
 
|-
| 16 || LeftSL
+
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickL]]
 
|-
 
|-
| 17 || LeftSR
+
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickR]]
 
|-
 
|-
| 18 || RightSL
+
| 0x28 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonL]]
 
|-
 
|-
| 19 || RightSR
+
| 0x2C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonR]]
 
|-
 
|-
| 20 || HomeButton
+
| 0x30 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZL]]
 
|-
 
|-
| 21 || CaptureButton
+
| 0x34 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZR]]
 
|-
 
|-
| 22 || Invalid
+
| 0x38 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonSelect]]
|}
  −
 
  −
== AnalogStickAssignment ==
  −
This is "nn::hidconfig::AnalogStickAssignment".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x3C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStart]]
 
|-
 
|-
| 0x0 || 0x4 || [[#AnalogStickRotation]]
+
| 0x40 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonCapture]]
 
|-
 
|-
| 0x4 || 0x1 || IsPairedStickAssigned
+
| 0x44 || 0x8 || [[#AnalogStickAssignment|HardwareStickL]]
 
|-
 
|-
| 0x5 || 0x3 || Reserved
+
| 0x4C || 0x8 || [[#AnalogStickAssignment|HardwareStickR]]
 
|}
 
|}
   −
== AnalogStickRotation ==
+
== DigitalButtonAssignment ==
This is "nn::hidconfig::AnalogStickRotation".
+
This is "nn::hidconfig::DigitalButtonAssignment".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,681: Line 8,764:  
!  Description
 
!  Description
 
|-
 
|-
| 0 || None
+
| 0 || A
 +
|-
 +
| 1 || B
 +
|-
 +
| 2 || X
 +
|-
 +
| 3 || Y
 +
|-
 +
| 4 || StickL
 +
|-
 +
| 5 || StickR
 +
|-
 +
| 6 || L
 +
|-
 +
| 7 || R
 
|-
 
|-
| 1 || Clockwise90
+
| 8 || ZL
 
|-
 
|-
| 2 || Anticlockwise90
+
| 9 || ZR
|}
  −
 
  −
= ButtonConfigFull =
  −
This is "nn::hidconfig::ButtonConfigFull". This is a 0x54-byte struct.
  −
 
  −
This is identical to [[#ButtonConfigEmbedded]].
  −
 
  −
= ButtonConfigLeft =
  −
This is "nn::hidconfig::ButtonConfigLeft". This is a 0x34-byte struct.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 10 || Select
 
|-
 
|-
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeft]]
+
| 11 || Start
 
|-
 
|-
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonUp]]
+
| 12 || Left
 
|-
 
|-
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRight]]
+
| 13 || Up
 
|-
 
|-
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonDown]]
+
| 14 || Right
 
|-
 
|-
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickL]]
+
| 15 || Down
 
|-
 
|-
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonL]]
+
| 16 || LeftSL
 
|-
 
|-
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZL]]
+
| 17 || LeftSR
 
|-
 
|-
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonSelect]]
+
| 18 || RightSL
 
|-
 
|-
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeftSL]]
+
| 19 || RightSR
 
|-
 
|-
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeftSR]]
+
| 20 || HomeButton
 
|-
 
|-
| 0x28 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonCapture]]
+
| 21 || CaptureButton
 
|-
 
|-
| 0x2C || 0x8 || [[#AnalogStickAssignment|HardwareStickL]]
+
| 22 || Invalid
 
|}
 
|}
   −
= ButtonConfigRight =
+
== AnalogStickAssignment ==
This is "nn::hidconfig::ButtonConfigRight". This is a 0x30-byte struct.
+
This is "nn::hidconfig::AnalogStickAssignment".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,732: Line 8,818:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonA]]
+
| 0x0 || 0x4 || [[#AnalogStickRotation]]
 
|-
 
|-
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonB]]
+
| 0x4 || 0x1 || IsPairedStickAssigned
 
|-
 
|-
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonX]]
+
| 0x5 || 0x3 || Reserved
|-
  −
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonY]]
  −
|-
  −
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickR]]
  −
|-
  −
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonR]]
  −
|-
  −
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZR]]
  −
|-
  −
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStart]]
  −
|-
  −
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRightSL]]
  −
|-
  −
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRightSR]]
  −
|-
  −
| 0x28 || 0x8 || [[#AnalogStickAssignment|HardwareStickR]]
   
|}
 
|}
   −
= StorageName =
+
== AnalogStickRotation ==
This is "nn::hidconfig::StorageName". This is a 0x81-byte struct.
+
This is "nn::hidconfig::AnalogStickRotation".
 
  −
This is an UTF-8 NUL-terminated name string.
  −
 
  −
= InterfaceType =
  −
This is "nn::hidtypes::InterfaceType".
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 8,767: Line 8,832:  
!  Description
 
!  Description
 
|-
 
|-
| 1 || Bluetooth
+
| 0 || None
 
|-
 
|-
| 2 || Rail
+
| 1 || Clockwise90
 
|-
 
|-
| 3 || USB
+
| 2 || Anticlockwise90
|-
  −
| 4 || Embedded
   
|}
 
|}
   −
= DigitalButton =
+
= ButtonConfigFull =
This is "nn::hidtypes::DigitalButton". This is a 64-bit flag.
+
This is "nn::hidconfig::ButtonConfigFull". This is a 0x54-byte struct.
 +
 
 +
This is identical to [[#ButtonConfigEmbedded]].
 +
 
 +
= ButtonConfigLeft =
 +
This is "nn::hidconfig::ButtonConfigLeft". This is a 0x34-byte struct.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Bit
+
! Offset || Size || Description
! Description
   
|-
 
|-
| 0
+
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeft]]
| A
   
|-
 
|-
| 1
+
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonUp]]
| B
   
|-
 
|-
| 2
+
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRight]]
| X
   
|-
 
|-
| 3
+
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonDown]]
| Y
   
|-
 
|-
| 4
+
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickL]]
| StickL
   
|-
 
|-
| 5
+
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonL]]
| StickR
   
|-
 
|-
| 6
+
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZL]]
| L
   
|-
 
|-
| 7
+
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonSelect]]
| R
   
|-
 
|-
| 8
+
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeftSL]]
| ZL
   
|-
 
|-
| 9
+
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonLeftSR]]
| ZR
   
|-
 
|-
| 10
+
| 0x28 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonCapture]]
| Start
   
|-
 
|-
| 11
+
| 0x2C || 0x8 || [[#AnalogStickAssignment|HardwareStickL]]
| Select
+
|}
 +
 
 +
= ButtonConfigRight =
 +
This is "nn::hidconfig::ButtonConfigRight". This is a 0x30-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 12
+
! Offset || Size || Description
| Left
   
|-
 
|-
| 13
+
| 0x0 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonA]]
| Up
   
|-
 
|-
| 14
+
| 0x4 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonB]]
| Right
   
|-
 
|-
| 15
+
| 0x8 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonX]]
| Down
   
|-
 
|-
| 16
+
| 0xC || 0x4 || [[#DigitalButtonAssignment|HardwareButtonY]]
| SL
   
|-
 
|-
| 17
+
| 0x10 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStickR]]
| SR
   
|-
 
|-
| 18
+
| 0x14 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonR]]
| Home
   
|-
 
|-
| 19
+
| 0x18 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonZR]]
| Shot
   
|-
 
|-
| 20
+
| 0x1C || 0x4 || [[#DigitalButtonAssignment|HardwareButtonStart]]
| StickLLeft
   
|-
 
|-
| 21
+
| 0x20 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRightSL]]
| StickLUp
   
|-
 
|-
| 22
+
| 0x24 || 0x4 || [[#DigitalButtonAssignment|HardwareButtonRightSR]]
| StickLRight
   
|-
 
|-
| 23
+
| 0x28 || 0x8 || [[#AnalogStickAssignment|HardwareStickR]]
| StickLDown
+
|}
 +
 
 +
= StorageName =
 +
This is "nn::hidconfig::StorageName". This is a 0x81-byte struct.
 +
 
 +
This is an UTF-8 NUL-terminated name string.
 +
 
 +
= InterfaceType =
 +
This is "nn::hidtypes::InterfaceType".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 24
+
| 1 || Bluetooth
| StickRLeft
   
|-
 
|-
| 25
+
| 2 || Rail
| StickRUp
   
|-
 
|-
| 26
+
| 3 || Usb
| StickRRight
   
|-
 
|-
| 27
+
| 4 || Embedded
| StickRDown
+
|}
 +
 
 +
= DigitalButton =
 +
This is "nn::hidtypes::DigitalButton". This is a 64-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 28
+
! Bit
| Palma
+
! Description
 
|-
 
|-
| 29
+
| 0
| HandheldLeftB
+
| A
 
|-
 
|-
| 30
+
| 1
| Plus
+
| B
 
|-
 
|-
| 31
+
| 2
| Minus
+
| X
 
|-
 
|-
| 32
+
| 3
| Z
+
| Y
 
|-
 
|-
| 33
+
| 4
| LeftSL
+
| StickL
 
|-
 
|-
| 34
+
| 5
| LeftSR
+
| StickR
 
|-
 
|-
| 35
+
| 6
| RightSL
+
| L
 +
|-
 +
| 7
 +
| R
 
|-
 
|-
| 36
+
| 8
| RightSR
+
| ZL
 
|-
 
|-
| 37
+
| 9
| LeftC
+
| ZR
 
|-
 
|-
| 38
+
| 10
| UpC
+
| Start
 
|-
 
|-
| 39
+
| 11
| RightC
+
| Select
 
|-
 
|-
| 40
+
| 12
| DownC
+
| Left
|}
  −
 
  −
= AssignmentStyle =
  −
This is "nn::hidtypes::AssignmentStyle". This is a 32-bit flag.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Bit
+
| 13
! Description
+
| Up
 
|-
 
|-
| 0
+
| 14
| IsExternalAssigned
+
| Right
 
|-
 
|-
| 1
+
| 15
| IsExternalLeftAssigned
+
| Down
 
|-
 
|-
| 2
+
| 16
| IsExternalRightAssigned
+
| SL
 
|-
 
|-
| 3
+
| 17
| IsHandheldAssigned
+
| SR
 
|-
 
|-
| 4
+
| 18
| IsHandheldLeftAssigned
+
| Home
 
|-
 
|-
| 5
+
| 19
| IsHandheldRightAssigned
+
| Shot
|}
  −
 
  −
= FeatureType =
  −
This is "nn::hidtypes::FeatureType". This is a 64-bit flag.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Bit
+
| 20
! Description
+
| StickLLeft
 
|-
 
|-
| 0
+
| 21
| HasLeftAnalogStick
+
| StickLUp
 
|-
 
|-
| 1
+
| 22
| HasRightAnalogStick
+
| StickLRight
 
|-
 
|-
| 2
+
| 23
| HasLeftSixAxisSensor
+
| StickLDown
 
|-
 
|-
| 3
+
| 24
| HasRightSixAxisSensor
+
| StickRLeft
 
|-
 
|-
| 4
+
| 25
| HasExternalSixAxisSensor
+
| StickRUp
 
|-
 
|-
| 5
+
| 26
| HasLeftLraVibrationDevice
+
| StickRRight
 
|-
 
|-
| 6
+
| 27
| HasRightLraVibrationDevice
+
| StickRDown
 
|-
 
|-
| 7
+
| 28
| HasGcVibrationDevice
+
| Palma
 
|-
 
|-
| 8
+
| 29
| HasErmVibrationDevice
+
| HandheldLeftB
 
|-
 
|-
| 9
+
| 30
| HasLeftJoyRailBus
+
| Plus
 
|-
 
|-
| 10
+
| 31
| HasRightJoyRailBus
+
| Minus
 
|-
 
|-
| 11
+
| 32
| HasInternalBus
+
| Z
 
|-
 
|-
| 12
+
| 33
| HasPalmaIc
+
| LeftSL
 
|-
 
|-
| 13
+
| 34
| HasNfc
+
| LeftSR
 
|-
 
|-
| 14
+
| 35
| HasIrSensor
+
| RightSL
 
|-
 
|-
| 15
+
| 36
| IsAnalogStickCalibrationSupported
+
| RightSR
 
|-
 
|-
| 16
+
| 37
| IsSixAxisSensorUserCalibrationSupported
+
| LeftC
 
|-
 
|-
| 17
+
| 38
| HasLeftRightBattery
+
| UpC
 
|-
 
|-
| 18
+
| 39
| HasStandardBattery
+
| RightC
 
|-
 
|-
| 19
+
| 40
| HasBattery
+
| DownC
 +
|}
 +
 
 +
= AssignmentStyle =
 +
This is "nn::hidtypes::AssignmentStyle". This is a 32-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 20
+
! Bit
| HasMainColor
+
! Description
 
|-
 
|-
| 21
+
| 0
| HasSubColor
+
| IsExternalAssigned
 
|-
 
|-
| 22
+
| 1
| HasIdentificationCode
+
| IsExternalLeftAssigned
 
|-
 
|-
| 23
+
| 2
| HasBluetoothAddress
+
| IsExternalRightAssigned
 
|-
 
|-
| 24
+
| 3
| HasMcu
+
| IsHandheldAssigned
 
|-
 
|-
| 25
+
| 4
| HasNotificationLed
+
| IsHandheldLeftAssigned
 
|-
 
|-
| 26
+
| 5
| HasDirectionalButtons
+
| IsHandheldRightAssigned
 +
|}
 +
 
 +
= FeatureType =
 +
This is "nn::hidtypes::FeatureType". This is a 64-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 27
+
! Bit
| HasIndicatorLed
+
! Description
 
|-
 
|-
| 28
+
| 0
| IsEmbeddedController
+
| HasLeftAnalogStick
 
|-
 
|-
| 29
+
| 1
| IsFullController
+
| HasRightAnalogStick
 
|-
 
|-
| 30
+
| 2
| IsLeftController
+
| HasLeftJoySixAxisSensor
 
|-
 
|-
| 31
+
| 3
| IsRightController
+
| HasRightJoySixAxisSensor
 
|-
 
|-
| 32
+
| 4
| IsUsbHidDevice
+
| HasFullKeySixAxisSensor
 
|-
 
|-
| 33
+
| 5
| IsKuinaDevice
+
| HasLeftLraVibrationDevice
 
|-
 
|-
| 34
+
| 6
| IsDirectUsbToBtSwitchingDevice
+
| HasRightLraVibrationDevice
 
|-
 
|-
| 35
+
| 7
| NormalizeAnalogStickWithInnerCross
+
| HasGcVibrationDevice
|}
  −
 
  −
= Color =
  −
This is "nn::hidtypes::Color".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 8
 +
| HasErmVibrationDevice
 
|-
 
|-
| 0x0 || 0x4 || BodyColor
+
| 9
 +
| HasLeftJoyRailBus
 
|-
 
|-
| 0x4 || 0x4 || ButtonColor
+
| 10
 +
| HasRightJoyRailBus
 
|-
 
|-
| 0x8 || 0x4 || LeftGripColor
+
| 11
 +
| HasInternalBus
 
|-
 
|-
| 0xC || 0x4 || RightGripColor
+
| 12
|}
+
| IsPalma
 
  −
= DeviceDescriptorType =
  −
This is "nn::hidtypes::DeviceDescriptorType".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 13
 +
| HasNfc
 
|-
 
|-
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
+
| 14
 +
| HasIrSensor
 
|-
 
|-
| 0x1 || 0x7 || Reserved
+
| 15
 +
| IsAnalogStickCalibrationSupported
 
|-
 
|-
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
+
| 16
 +
| IsSixAxisSensorUserCalibrationSupported
 
|-
 
|-
| 0x10 || 0x8 || [[#DigitalButton|DigitalButton]]
+
| 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
 
|-
 
|-
| 0x18 || 0x4 || [[#AssignmentStyle|AssignmentStyle]]
+
| 33
 +
| IsKuinaDevice
 
|-
 
|-
| 0x1C || 0x10 || [[#Color|DeviceColor]]
+
| 34
 +
| IsDirectUsbToBtSwitchingDevice
 
|-
 
|-
| 0x2C || 0x4 || Reserved
+
| 35
 +
| IsNormalizeAnalogStickWithInnerCross
 
|}
 
|}
   −
= UnmaskFeatureDescriptorType =
+
= Color =
This is "nn::hid::server::UnmaskFeatureDescriptorType".
+
This is "nn::hidtypes::Color".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,097: Line 9,210:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
+
| 0x0 || 0x4 || BodyColor
 
|-
 
|-
| 0x1 || 0x1 || [[#InterfaceType|InterfaceType]]
+
| 0x4 || 0x4 || ButtonColor
 
|-
 
|-
| 0x2 || 0x6 || Reserved
+
| 0x8 || 0x4 || LeftGripColor
 
|-
 
|-
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
+
| 0xC || 0x4 || RightGripColor
 
|}
 
|}
   −
= FirmwareVersionInfo =
+
= DeviceDescriptorType =
This is "nn::hidtypes::FirmwareVersionInfo".
+
This is "nn::hidtypes::DeviceDescriptorType".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,113: Line 9,226:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#FirmwareVersionAttribute|FirmwareVersionAttribute]]
+
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
 +
|-
 +
| 0x1 || 0x7 || Reserved
 +
|-
 +
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
 
|-
 
|-
| 0x4 || 0x2 ||
+
| 0x10 || 0x8 || [[#DigitalButton|DigitalButton]]
 
|-
 
|-
| 0x6 || 0x2 || MajorVersion
+
| 0x18 || 0x4 || [[#AssignmentStyle|AssignmentStyle]]
 
|-
 
|-
| 0x8 || 0x2 || MinorVersion
+
| 0x1C || 0x10 || [[#Color|DeviceColor]]
 
|-
 
|-
| 0xA || 0x2 ||
+
| 0x2C || 0x4 || Reserved
 
|}
 
|}
   −
= FirmwareVersionAttribute =
+
= DeviceDescriptionList =
This is "nn::hidtypes::FirmwareVersionAttribute". This is a 32-bit flag.
+
This is "nn::hidtypes::detail::DeviceDescriptionList". This is a list of [[#DeviceDescriptorType|DeviceDescriptorType]] objects maintained by the hid-sysmodule.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Bit
+
! [[#DeviceTypeInternal|DeviceType]] || [[#FeatureType|FeatureType]] || [[#DigitalButton|DigitalButton]] || [[#AssignmentStyle|AssignmentStyle]] || [[#Color|DeviceColor]]
! Description
+
|-
 +
| 1 || 0x18BDBE44A || 0x18F0406AF || 0x24 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 +
|-
 +
| 2 || 0x14CDB8225 || 0x6F8F950 || 0x12 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 
|-
 
|-
| 0
+
| 3 || 0x72BBDA073 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
| IsCustomerCodeCorruption
   
|-
 
|-
| 1
+
| 4 || 0x108000025 || 0x6F8F950 || 0x2 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
| IsIapCorrupted
  −
|}
  −
 
  −
= IrCameraHandle =
  −
This is "nn::irsensor::IrCameraHandle".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 5 || 0x10800004A || 0x18F0406AF || 0x4 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 
|-
 
|-
| 0x0 || 0x1 || PlayerNumber
+
| 6 || 0x108800013 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 0x1 || 0x1 || DeviceType
+
| 7 || 0x108CA0000 || 0x2008FCC3 || 0x11 || 0xFF322891, 0xFFFFFFFF, 0x00000000, 0x00000000
 
|-
 
|-
| 0x2 || 0x2 || Reserved
+
| 8 || 0x108CA0800 || 0x4F0C3 || 0x21 || 0xFF322891, 0xFFFFFFFF, 0x00000000, 0x00000000
|}
  −
 
  −
= IrCameraStatus =
  −
This is "nn::irsensor::IrCameraStatus".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Available
+
| 9 || 0x108CA0000 || 0x2008FCC3 || 0x11 || 0xFFD9D7D7, 0xFFFFFFFF, 0x00000000, 0x00000000
 
|-
 
|-
| 1 || Unsupported
+
| 10 || 0x108CA0000 || 0x4FCC3 || 0x21 || 0xFFD9D7D7, 0xFFFFFFFF, 0x00000000, 0x00000000
 
|-
 
|-
| 2 || Unconnected
+
| 11 || 0x700CC0000 || 0xFFCF || 0x0 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
|}
  −
 
  −
= IrCameraInternalStatus =
  −
This is "nn::irsensor::IrCameraInternalStatus".
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Stopped
+
| 12 || 0x841011 || 0x10000010 || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 1 || FirmwareUpdateNeeded
+
| 13 || 0x83 || 0xFF0F6CF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 2 ||  
+
| 14 || 0x1 || 0xF8F950 || 0x10 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 
|-
 
|-
| 3 ||  
+
| 15 || 0x3 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 4 ||  
+
| 16 || 0x3 || 0xFFCFFFF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 5 || FirmwareVersionRequested
+
| 17 || 0x1001A013 || 0xFFCFFFF || 0x8 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 6 || FirmwareVersionIsInvalid
+
| 18 || 0x2 || 0xF0406AF || 0x20 || 0xFF828282, 0xFF0F0F0F, 0x00000000, 0x00000000
 
|-
 
|-
| 7 || [4.0.0+] Ready
+
| 19 || 0x1088DA073 || 0xFFCF3FF || 0x1 || 0xFF2D2D2D, 0xFFE6E6E6, 0xFF464646, 0xFF464646
 
|-
 
|-
| 8 || [4.0.0+] Setting
+
| 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
 
|}
 
|}
   −
= IrSensorMode =
+
= UnmaskFeatureDescriptorType =
This is "nn::irsensor::detail::StatusManager::IrSensorMode".
+
This is "nn::hid::server::UnmaskFeatureDescriptorType".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || None
+
! Offset || Size || Description
 
|-
 
|-
| 1 || [[#MomentProcessorState|MomentProcessor]]
+
| 0x0 || 0x1 || [[#DeviceTypeInternal|DeviceType]]
 
|-
 
|-
| 2 || [[#ClusteringProcessorState|ClusteringProcessor]]
+
| 0x1 || 0x1 || [[#InterfaceType|InterfaceType]]
 
|-
 
|-
| 3 || [[#ImageTransferProcessorState|ImageTransferProcessor]]
+
| 0x2 || 0x6 || Reserved
 
|-
 
|-
| 4 || [[#PointingProcessorMarkerState|PointingProcessorMarker]]
+
| 0x8 || 0x8 || [[#FeatureType|FeatureType]]
|-
  −
| 5 || [[#TeraPluginProcessorState|TeraPluginProcessor]]
  −
|-
  −
| 6 || Unknown
   
|}
 
|}
   −
= ImageProcessorStatus =
+
= UnmaskFeatureDescriptorList =
This is "nn::irsensor::ImageProcessorStatus".
+
This is "nn::hid::server::UnmaskFeatureDescriptorList". This is a list of [[#UnmaskFeatureDescriptorType|UnmaskFeatureDescriptorType]] objects maintained by the hid-sysmodule.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Stopped
+
! [[#DeviceTypeInternal|DeviceType]] || [[#InterfaceType|InterfaceType]] || [[#FeatureType|FeatureType]]
 
|-
 
|-
| 1 || Running
+
| 3 || 3 || 0x2000
|}
  −
 
  −
= ImageTransferProcessorFormat =
  −
This is "nn::irsensor::ImageTransferProcessorFormat".
  −
 
  −
This controls the IR Sensor image resolution.
  −
 
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || 320x240
+
| 2 || 2 || 0x200
 
|-
 
|-
| 1 || 160x120
+
| 1 || 2 || 0x400
 
|-
 
|-
| 2 || 80x60
+
| 19 || 3 || 0x2000
 
|-
 
|-
| 3 || [4.0.0+] 40x30
+
| 2 || 3 || 0x200
 
|-
 
|-
| 4 || [4.0.0+] 20x15
+
| 1 || 3 || 0x6400
 
|}
 
|}
   −
= MomentProcessorConfig =
+
= FirmwareVersionInfo =
This is "nn::irsensor::MomentProcessorConfig".
+
This is "nn::hidtypes::FirmwareVersionInfo".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,254: Line 9,342:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
+
| 0x0 || 0x4 || [[#FirmwareVersionAttribute|FirmwareVersionAttribute]]
 
|-
 
|-
| 0x8 || 0x4 || LightTarget (default is 0)
+
| 0x4 || 0x2 ||
 
|-
 
|-
| 0xC || 0x4 || Gain (default is 0x8)
+
| 0x6 || 0x2 || MajorVersion
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
+
| 0x8 || 0x2 || MinorVersion
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0xA || 0x2 ||
|-
+
|}
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
+
 
 +
= FirmwareVersionAttribute =
 +
This is "nn::hidtypes::FirmwareVersionAttribute". This is a 32-bit flag.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
+
! Bit
 +
! Description
 
|-
 
|-
| 0x1C || 0x2 || WindowOfInterestWidth (default is 0x140)
+
| 0
 +
| IsCustomerCodeCorruption
 
|-
 
|-
| 0x1E || 0x2 || WindowOfInterestHeight (default is 0xF0)
+
| 1
|-
+
| IsIapCorrupted
| 0x20 || 0x4 || Preprocess (default is 0x1)
  −
|-
  −
| 0x24 || 0x4 || PreprocessIntensityThreshold (default is 0x50)
   
|}
 
|}
   −
= PackedMomentProcessorConfig =
+
= IrCameraHandle =
This is "nn::irsensor::PackedMomentProcessorConfig".
+
This is "nn::irsensor::IrCameraHandle".
 
  −
This is converted from [[#MomentProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,286: Line 9,375:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
+
| 0x0 || 0x1 || PlayerNumber
 
|-
 
|-
| 0x8 || 0x1 || LightTarget (default is 0)
+
| 0x1 || 0x1 || DeviceType
 
|-
 
|-
| 0x9 || 0x1 || Gain (default is 0x8)
+
| 0x2 || 0x2 || Reserved
 +
|}
 +
 
 +
= IrCameraStatus =
 +
This is "nn::irsensor::IrCameraStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed (default is 0)
+
| 0 || Available
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 1 || Unsupported
 
|-
 
|-
| 0x10 || 0x2 || WindowOfInterestX (default is 0)
+
| 2 || Unconnected
 +
|}
 +
 
 +
= IrCameraInternalStatus =
 +
This is "nn::irsensor::IrCameraInternalStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0x12 || 0x2 || WindowOfInterestY (default is 0)
+
| 0 || Stopped
 
|-
 
|-
| 0x14 || 0x2 || WindowOfInterestWidth (default is 0x140)
+
| 1 || FirmwareUpdateNeeded
 
|-
 
|-
| 0x16 || 0x2 || WindowOfInterestHeight (default is 0xF0)
+
| 2 ||  
 
|-
 
|-
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 3 ||  
 
|-
 
|-
| 0x1C || 0x1 || Preprocess (default is 0x1)
+
| 4 ||  
 +
|-
 +
| 5 || FirmwareVersionRequested
 +
|-
 +
| 6 || FirmwareVersionIsInvalid
 
|-
 
|-
| 0x1D || 0x1 || PreprocessIntensityThreshold (default is 0x50)
+
| 7 || [4.0.0+] Ready
 
|-
 
|-
| 0x1E || 0x2 || Reserved
+
| 8 || [4.0.0+] Setting
 
|}
 
|}
   −
= ClusteringProcessorConfig =
+
= IrSensorMode =
This is "nn::irsensor::ClusteringProcessorConfig".
+
This is "nn::irsensor::detail::StatusManager::IrSensorMode".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
! Offset || Size || Description
+
| 0 || None
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime (default is 200000)
+
| 1 || [[#MomentProcessorState|MomentProcessor]]
 
|-
 
|-
| 0x8 || 0x4 || LightTarget (default is 0)
+
| 2 || [[#ClusteringProcessorState|ClusteringProcessor]]
 
|-
 
|-
| 0xC || 0x4 || Gain (default is 0x2)
+
| 3 || [[#ImageTransferProcessorState|ImageTransferProcessor]]
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
+
| 4 || [[#PointingProcessorMarkerState|PointingProcessorMarker]]
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 5 || [[#TeraPluginProcessorState|TeraPluginProcessor]]
 
|-
 
|-
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
+
| 6 || Unknown
 +
|}
 +
 
 +
= ImageProcessorStatus =
 +
This is "nn::irsensor::ImageProcessorStatus".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
+
| 0 || Stopped
 
|-
 
|-
| 0x1C || 0x2 || WindowOfInterestWidth (default is 320)
+
| 1 || Running
 +
|}
 +
 
 +
= ImageTransferProcessorFormat =
 +
This is "nn::irsensor::ImageTransferProcessorFormat".
 +
 
 +
This controls the IR Sensor image resolution.
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 
|-
 
|-
| 0x1E || 0x2 || WindowOfInterestHeight (default is 240)
+
| 0 || 320x240
 
|-
 
|-
| 0x20 || 0x4 || ObjectPixelCountMin (default is 0x3)
+
| 1 || 160x120
 
|-
 
|-
| 0x24 || 0x4 || ObjectPixelCountMax (default is 0x12C00)
+
| 2 || 80x60
 
|-
 
|-
| 0x28 || 0x4 || ObjectIntensityMin (default is 150)
+
| 3 || [4.0.0+] 40x30
 
|-
 
|-
| 0x2C || 0x1 || IsExternalLightFilterEnabled (default is 0x1)
+
| 4 || [4.0.0+] 20x15
 
|}
 
|}
   −
= PackedClusteringProcessorConfig =
+
= MomentProcessorConfig =
This is "nn::irsensor::PackedClusteringProcessorConfig".
+
This is "nn::irsensor::MomentProcessorConfig".
 
  −
This is converted from [[#ClusteringProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,356: Line 9,483:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x8 || 0x4 || LightTarget (default is 0)
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
| 0xC || 0x4 || Gain (default is 0x8)
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x10 || 0x1 || IsNegativeImageUsed (default is 0)
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x11 || 0x7 || Reserved
 
|-
 
|-
| 0x10 || 0x2 || WindowOfInterestX
+
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x12 || 0x2 || WindowOfInterestY
+
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0x14 || 0x2 || WindowOfInterestWidth
+
| 0x1C || 0x2 || WindowOfInterestWidth (default is 0x140)
 
|-
 
|-
| 0x16 || 0x2 || WindowOfInterestHeight
+
| 0x1E || 0x2 || WindowOfInterestHeight (default is 0xF0)
 
|-
 
|-
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x20 || 0x4 || Preprocess (default is 0x1)
 
|-
 
|-
| 0x1C || 0x4 || ObjectPixelCountMin
+
| 0x24 || 0x4 || PreprocessIntensityThreshold (default is 0x50)
|-
  −
| 0x20 || 0x4 || ObjectPixelCountMax
  −
|-
  −
| 0x24 || 0x1 || ObjectIntensityMin
  −
|-
  −
| 0x25 || 0x1 || IsExternalLightFilterEnabled
  −
|-
  −
| 0x26 || 0x2 || Reserved
   
|}
 
|}
   −
= ImageTransferProcessorConfig =
+
= PackedMomentProcessorConfig =
This is "nn::irsensor::ImageTransferProcessorConfig".
+
This is "nn::irsensor::PackedMomentProcessorConfig".
 +
 
 +
This is converted from [[#MomentProcessorConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,394: Line 9,515:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x8 || ExposureTime (default is 0x493E0)
 
|-
 
|-
| 0x8 || 0x4 || LightTarget
+
| 0x8 || 0x1 || LightTarget (default is 0)
 
|-
 
|-
| 0xC || 0x4 || Gain
+
| 0x9 || 0x1 || Gain (default is 0x8)
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed
+
| 0xA || 0x1 || IsNegativeImageUsed (default is 0)
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0xB || 0x5 || Reserved
 
|-
 
|-
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|Format]]
+
| 0x10 || 0x2 || WindowOfInterestX (default is 0)
|}
  −
 
  −
= PackedImageTransferProcessorConfig =
  −
This is "nn::irsensor::PackedImageTransferProcessorConfig".
  −
 
  −
This is converted from [[#ImageTransferProcessorConfig]].
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x12 || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x14 || 0x2 || WindowOfInterestWidth (default is 0x140)
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x16 || 0x2 || WindowOfInterestHeight (default is 0xF0)
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x1C || 0x1 || Preprocess (default is 0x1)
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x1D || 0x1 || PreprocessIntensityThreshold (default is 0x50)
 
|-
 
|-
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x1E || 0x2 || Reserved
|-
  −
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|Format]]
  −
|-
  −
| 0x15 || 0x3 || Reserved
   
|}
 
|}
   −
= ImageTransferProcessorState =
+
= ClusteringProcessorConfig =
This is "nn::irsensor::ImageTransferProcessorState".
+
This is "nn::irsensor::ClusteringProcessorConfig".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,440: Line 9,549:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || SamplingNumber
+
| 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
 +
|-
 +
| 0x18 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x8 || 0x4 || AmbientNoiseLevel
+
| 0x1A || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0xC || 0x4 || Reserved
+
| 0x1C || 0x2 || WindowOfInterestWidth (default is 320)
|}
  −
 
  −
= TeraPluginProcessorConfig =
  −
This is "nn::irsensor::TeraPluginProcessorConfig".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x1E || 0x2 || WindowOfInterestHeight (default is 240)
 
|-
 
|-
| 0x0 || 0x1 || Mode
+
| 0x20 || 0x4 || ObjectPixelCountMin (default is 0x3)
 
|-
 
|-
| 0x1 || 0x1 ||  
+
| 0x24 || 0x4 || ObjectPixelCountMax (default is 0x12C00)
 
|-
 
|-
| 0x2 || 0x1 ||  
+
| 0x28 || 0x4 || ObjectIntensityMin (default is 150)
 
|-
 
|-
| 0x3 || 0x1 ||  
+
| 0x2C || 0x1 || IsExternalLightFilterEnabled (default is 0x1)
 
|}
 
|}
   −
= PackedTeraPluginProcessorConfig =
+
= PackedClusteringProcessorConfig =
This is "nn::irsensor::PackedTeraPluginProcessorConfig".
+
This is "nn::irsensor::PackedClusteringProcessorConfig".
   −
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 9,474: Line 9,585:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x0 || 0x8 || ExposureTime
 +
|-
 +
| 0x8 || 0x1 || LightTarget
 +
|-
 +
| 0x9 || 0x1 || Gain
 +
|-
 +
| 0xA || 0x1 || IsNegativeImageUsed
 +
|-
 +
| 0xB || 0x5 || Reserved
 +
|-
 +
| 0x10 || 0x2 || WindowOfInterestX
 
|-
 
|-
| 0x4 || 0x1 || Mode
+
| 0x12 || 0x2 || WindowOfInterestY
 
|-
 
|-
| 0x5 || 0x1 ||  
+
| 0x14 || 0x2 || WindowOfInterestWidth
 
|-
 
|-
| 0x6 || 0x1 ||  
+
| 0x16 || 0x2 || WindowOfInterestHeight
 
|-
 
|-
| 0x7 || 0x1 ||  
+
| 0x18 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
|}
  −
 
  −
= PointingProcessorConfig =
  −
This is "nn::irsensor::PointingProcessorConfig".
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
! Offset || Size || Description
+
| 0x1C || 0x4 || ObjectPixelCountMin
 
|-
 
|-
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x20 || 0x4 || ObjectPixelCountMax
 
|-
 
|-
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
+
| 0x24 || 0x1 || ObjectIntensityMin
 
|-
 
|-
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
+
| 0x25 || 0x1 || IsExternalLightFilterEnabled
 
|-
 
|-
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
+
| 0x26 || 0x2 || Reserved
 
|}
 
|}
   −
= PackedPointingProcessorConfig =
+
= ImageTransferProcessorConfig =
This is "nn::irsensor::PackedPointingProcessorConfig".
+
This is "nn::irsensor::ImageTransferProcessorConfig".
 
  −
This is converted from [[#PointingProcessorConfig]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,510: Line 9,623:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
+
| 0x0 || 0x8 || ExposureTime
 +
|-
 +
| 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]]
 
|}
 
|}
   −
= PackedMcuVersion =
+
= PackedImageTransferProcessorConfig =
This is "nn::irsensor::PackedMcuVersion".
+
This is "nn::irsensor::PackedImageTransferProcessorConfig".
 +
 
 +
This is converted from [[#ImageTransferProcessorConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,528: Line 9,645:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x2 || MajorVersion
+
| 0x0 || 0x8 || ExposureTime
 
|-
 
|-
| 0x2 || 0x2 || MinorVersion
+
| 0x8 || 0x1 || LightTarget
|}
  −
 
  −
== Versions ==
  −
{| class="wikitable" border="1"
   
|-
 
|-
! MajorVersion || MinorVersion || SystemVersion
+
| 0x9 || 0x1 || Gain
 
|-
 
|-
| 0x3 || 0xB || [1.0.0+]
+
| 0xA || 0x1 || IsNegativeImageUsed
 
|-
 
|-
| 0x4 || 0x12 || [4.0.0+]
+
| 0xB || 0x5 || Reserved
 
|-
 
|-
| 0x5 || 0x18 || [5.0.0+]
+
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x6 || 0x1A || [6.0.0+]
+
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|Format]]
 
|-
 
|-
| 0x8 || 0x1B || [8.0.0+]
+
| 0x15 || 0x3 || Reserved
 
|}
 
|}
   −
= PackedFunctionLevel =
+
= ImageTransferProcessorState =
This is nn::irsensor::PackedFunctionLevel.
+
This is "nn::irsensor::ImageTransferProcessorState".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,556: Line 9,669:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x1 || [[#IrSensorFunctionLevel]]
+
| 0x0 || 0x8 || SamplingNumber
 +
|-
 +
| 0x8 || 0x4 || AmbientNoiseLevel
 
|-
 
|-
| 0x1 || 0x3 || Reserved
+
| 0xC || 0x4 || Reserved
 
|}
 
|}
   −
== IrSensorFunctionLevel ==
+
= TeraPluginProcessorConfig =
This is "nn::irsensor::IrSensorFunctionLevel".
+
This is "nn::irsensor::TeraPluginProcessorConfig".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Value || SystemVersion
+
! Offset || Size || Description
 
|-
 
|-
| 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+]
   
|}
 
|}
   −
= ImageTransferProcessorExConfig =
+
= PackedTeraPluginProcessorConfig =
This is "nn::irsensor::ImageTransferProcessorExConfig".
+
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+].
 +
 
 +
[[#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 9,586: Line 9,703:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 
|-
 
|-
| 0x8 || 0x4 || LightTarget
+
| 0x4 || 0x1 || Mode
 
|-
 
|-
| 0xC || 0x4 || Gain
+
| 0x5 || 0x1 ||  
 
|-
 
|-
| 0x10 || 0x1 || IsNegativeImageUsed
+
| 0x6 || 0x1 ||  
 
|-
 
|-
| 0x11 || 0x7 || Reserved
+
| 0x7 || 0x1 ||  
 +
|}
 +
 
 +
= PointingProcessorConfig =
 +
This is "nn::irsensor::PointingProcessorConfig".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|OrigFormat]]
+
! Offset || Size || Description
 
|-
 
|-
| 0x1C || 0x4 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
+
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x20 || 0x2 || TrimmingStartX
+
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0x22 || 0x2 || TrimmingStartY
+
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
 
|-
 
|-
| 0x24 || 0x1 || IsExternalLightFilterEnabled
+
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
 
|}
 
|}
   −
= PackedImageTransferProcessorExConfig =
+
= PackedPointingProcessorConfig =
This is "nn::irsensor::PackedImageTransferProcessorExConfig".
+
This is "nn::irsensor::PackedPointingProcessorConfig".
   −
This is converted from [[#ImageTransferProcessorExConfig]].
+
This is converted from [[#PointingProcessorConfig]].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,616: Line 9,739:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x8 || ExposureTime
+
| 0x0 || 0x2 || WindowOfInterestX (default is 0)
 
|-
 
|-
| 0x8 || 0x1 || LightTarget
+
| 0x2 || 0x2 || WindowOfInterestY (default is 0)
 
|-
 
|-
| 0x9 || 0x1 || Gain
+
| 0x4 || 0x2 || WindowOfInterestWidth (default is 320)
 
|-
 
|-
| 0xA || 0x1 || IsNegativeImageUsed
+
| 0x6 || 0x2 || WindowOfInterestHeight (default is 240)
 
|-
 
|-
| 0xB || 0x5 || Reserved
+
| 0x8 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
|-
  −
| 0x10 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
  −
|-
  −
| 0x14 || 0x1 || [[#ImageTransferProcessorFormat|OrigFormat]]
  −
|-
  −
| 0x15 || 0x1 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
  −
|-
  −
| 0x16 || 0x2 || TrimmingStartX
  −
|-
  −
| 0x18 || 0x2 || TrimmingStartY
  −
|-
  −
| 0x1A || 0x1 || IsExternalLightFilterEnabled
  −
|-
  −
| 0x1B || 0x5 || Reserved
   
|}
 
|}
   −
= IrLedProcessorConfig =
+
= PackedMcuVersion =
This is "nn::irsensor::IrLedProcessorConfig".
+
This is "nn::irsensor::PackedMcuVersion".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 9,648: Line 9,757:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || LightTarget
+
| 0x0 || 0x2 || MajorVersion
 +
|-
 +
| 0x2 || 0x2 || MinorVersion
 
|}
 
|}
   −
= PackedIrLedProcessorConfig =
+
== Versions ==
This is "nn::irsensor::PackedIrLedProcessorConfig".
  −
 
  −
This is converted from [[#IrLedProcessorConfig]].
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! MajorVersion || MinorVersion || SystemVersion
 
|-
 
|-
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
+
| 0x3 || 0xB || [1.0.0+]
 +
|-
 +
| 0x4 || 0x12 || [4.0.0+]
 +
|-
 +
| 0x5 || 0x18 || [5.0.0+]
 
|-
 
|-
| 0x4 || 0x1 || LightTarget
+
| 0x6 || 0x1A || [6.0.0+]
 
|-
 
|-
| 0x5 || 0x3 || Padding
+
| 0x8 || 0x1B || [8.0.0+]
 
|}
 
|}
   −
= AdaptiveClusteringProcessorConfig =
+
= PackedFunctionLevel =
This is "nn::irsensor::AdaptiveClusteringProcessorConfig".
+
This is nn::irsensor::PackedFunctionLevel.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || [[#IrSensorFunctionLevel]]
 +
|-
 +
| 0x1 || 0x3 || Reserved
 +
|}
   −
AdaptiveClusteringProcessor was added with [5.0.0+].
+
== IrSensorFunctionLevel ==
 +
This is "nn::irsensor::IrSensorFunctionLevel".
   −
This is converted to [[#TeraPluginProcessorConfig]] by the user-process. [[#TeraPluginProcessorConfig]]+0x3 is zero.
+
{| class="wikitable" border="1"
 +
|-
 +
! Value || SystemVersion
 +
|-
 +
| 0 || [1.0.0+]
 +
|-
 +
| 1 || [4.0.0+]
 +
|-
 +
| 2 || [5.0.0+]
 +
|-
 +
| 3 || [6.0.0+]
 +
|-
 +
| 4 || [8.0.0+]
 +
|}
   −
The default config is all-zero.
+
= ImageTransferProcessorExConfig =
 +
This is "nn::irsensor::ImageTransferProcessorExConfig".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || ExposureTime
 +
|-
 +
| 0x8 || 0x4 || LightTarget
 +
|-
 +
| 0xC || 0x4 || Gain
 +
|-
 +
| 0x10 || 0x1 || IsNegativeImageUsed
 +
|-
 +
| 0x11 || 0x7 || Reserved
 +
|-
 +
| 0x18 || 0x4 || [[#ImageTransferProcessorFormat|OrigFormat]]
 +
|-
 +
| 0x1C || 0x4 || [[#ImageTransferProcessorFormat|TrimmingFormat]]
 +
|-
 +
| 0x20 || 0x2 || TrimmingStartX
 +
|-
 +
| 0x22 || 0x2 || TrimmingStartY
 +
|-
 +
| 0x24 || 0x1 || IsExternalLightFilterEnabled
 +
|}
 +
 
 +
= PackedImageTransferProcessorExConfig =
 +
This is "nn::irsensor::PackedImageTransferProcessorExConfig".
 +
 
 +
This is converted from [[#ImageTransferProcessorExConfig]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 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]]
 +
|-
 +
| 0x16 || 0x2 || TrimmingStartX
 +
|-
 +
| 0x18 || 0x2 || TrimmingStartY
 +
|-
 +
| 0x1A || 0x1 || IsExternalLightFilterEnabled
 +
|-
 +
| 0x1B || 0x5 || Reserved
 +
|}
 +
 
 +
= IrLedProcessorConfig =
 +
This is "nn::irsensor::IrLedProcessorConfig".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || LightTarget
 +
|}
 +
 
 +
= PackedIrLedProcessorConfig =
 +
This is "nn::irsensor::PackedIrLedProcessorConfig".
 +
 
 +
This is converted from [[#IrLedProcessorConfig]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#PackedMcuVersion|RequiredMcuVersion]]
 +
|-
 +
| 0x4 || 0x1 || LightTarget
 +
|-
 +
| 0x5 || 0x3 || Padding
 +
|}
 +
 
 +
= AdaptiveClusteringProcessorConfig =
 +
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"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#AdaptiveClusteringMode]]
 +
|-
 +
| 0x4 || 0x4 || [6.0.0+] [[#AdaptiveClusteringTargetDistance]]
 +
|}
 +
 
 +
== AdaptiveClusteringMode ==
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || StaticFov
 +
|-
 +
| 1 || DynamicFov
 +
|}
 +
 
 +
Controls the mode for [[#TeraPluginProcessorConfig]] (DynamicFov -> 0x10; StaticFov -> 0x0F).
 +
 
 +
== AdaptiveClusteringTargetDistance ==
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || Near
 +
|-
 +
| 1 || Middle
 +
|-
 +
| 2 || Far
 +
|}
 +
 
 +
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"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#HandAnalysisMode]]
 +
|}
 +
 
 +
== HandAnalysisMode ==
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || None (invalid)
 +
|-
 +
| 1 || Silhouette
 +
|-
 +
| 2 || Image
 +
|-
 +
| 3 || SilhouetteAndImage
 +
|-
 +
| 4 || [4.0.0+] SilhouetteOnly
 +
|}
 +
 
 +
= BusHandle =
 +
This is "nn::hidbus::BusHandle".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || AbstractedPadId
 +
|-
 +
| 0x4 || 0x1 || InternalIndex
 +
|-
 +
| 0x5 || 0x1 || PlayerNumber
 +
|-
 +
| 0x6 || 0x1 || BusTypeId
 +
|-
 +
| 0x7 || 0x1 || IsValid
 +
|}
 +
 
 +
= JoyPollingReceivedData =
 +
This is "nn::hidbus::JoyPollingReceivedData".
 +
 
 +
This is copied from the entries in [[#EnableJoyPollingReceiveMode|TransferMemory]] by GetJoyPollingReceivedData.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x30 || Data
 +
|-
 +
| 0x30 || 0x8 || OutSize
 +
|-
 +
| 0x38 || 0x8 || SamplingNumber
 +
|}
 +
 
 +
= BusType =
 +
This is "nn::hidbus::BusType".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || LeftJoyRail
 +
|-
 +
| 1 || RightJoyRail
 +
|-
 +
| 2 || [6.0.0+] InternalBus (for Lark microphone)
 +
|}
 +
 
 +
= JoyPollingMode =
 +
This is "nn::hidbus::JoyPollingMode".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || SixAxisSensorDisable
 +
|-
 +
| 1 || SixAxisSensorEnable
 +
|-
 +
| 2 || ButtonOnly
 +
|}
 +
 
 +
Other values causes [[#EnableJoyPollingReceiveMode]] to assert.
 +
 
 +
= StatusManagerType =
 +
This is "nn::hidbus::detail::StatusManagerType".
 +
 
 +
{| class="wikitable" border="1"
 +
!  Value
 +
!  Description
 +
|-
 +
| 0 || None
 +
|-
 +
| 1 || 16
 +
|-
 +
| 2 || 32
 +
|}
 +
 
 +
= ExternalDevices =
 +
The following devices are used via hidbus:
 +
* [[Ring-Con]]
 +
** [[#BusType|BusType]] is 0 (LeftJoyRail) or 1 (RightJoyRail).
 +
** [[#GetExternalDeviceId|DeviceId]] is 0x20 ("Ronde").
 +
* Famicom right controller (with microphone)
 +
** [[#BusType|BusType]] is 2 (InternalBus).
 +
** [[#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+]
 +
 
 +
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
 +
 
 +
[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]].
 +
 
 +
= Firmware Update =
 +
HID-sysmodule mounts the contents of title [[Title_list|0100000000000822]] as "systemData" or the contents of title [[Title_list|010000000000B22B]] as "systemDataD". Both titles contain the same files, but [[Title_list|0100000000000822]] is used on retail units while [[Title_list|010000000000B22B]] is used for development.
 +
 
 +
These titles contain the following files:
 +
* '''ExpectVersionInfo.csv'''
 +
** List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey", "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"
 +
|-
 +
! 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
 
|-
 
|-
| 0x0 || 0x4 || [[#AdaptiveClusteringMode]]
+
| [11.0.0+]
 +
| 0407
 
|-
 
|-
| 0x4 || 0x4 || [6.0.0+] [[#AdaptiveClusteringTargetDistance]]
+
| [12.1.0+]
|}
+
| 0410
 
  −
== AdaptiveClusteringMode ==
  −
{| class="wikitable" border="1"
  −
!  Value
  −
!  Description
   
|-
 
|-
| 0 || StaticFov
+
| [13.0.0+]
 +
| 0417
 
|-
 
|-
| 1 || DynamicFov
+
| [14.0.0+]
 +
| 0419
 
|}
 
|}
   −
Controls the mode for [[#TeraPluginProcessorConfig]] (DynamicFov -> 0x10; StaticFov -> 0x0F).
+
=== Raizo ===
 
  −
== AdaptiveClusteringTargetDistance ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
!  Value
  −
!  Description
   
|-
 
|-
| 0 || Near
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 1 || Middle
+
| [1.0.0+]
 +
| 0348
 
|-
 
|-
| 2 || Far
+
| [15.0.0+]
 +
| 0421
 
|}
 
|}
   −
Controls the second and third bytes for [[#TeraPluginProcessorConfig]] (Near-> 0x00, 0x00; Middle -> 0x01, 0x03; Far -> 0x01, 0x08).
+
=== Tera ===
 
  −
= 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"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! SystemVersion
|-
+
! FirmwareVersion
| 0x0 || 0x4 || [[#HandAnalysisMode]]
  −
|}
  −
 
  −
== HandAnalysisMode ==
  −
{| class="wikitable" border="1"
  −
!  Value
  −
! Description
   
|-
 
|-
| 0 || None (invalid)
+
| [1.0.0+]
 +
| 030B
 
|-
 
|-
| 1 || Silhouette
+
| [4.0.0+]
 +
| 0412
 
|-
 
|-
| 2 || Image
+
| [5.0.0+]
 +
| 0518
 
|-
 
|-
| 3 || SilhouetteAndImage
+
| [6.0.0+]
 +
| 061A
 
|-
 
|-
| 4 || [4.0.0+] SilhouetteOnly
+
| [8.0.0+]
 +
| 081B
 
|}
 
|}
   −
= BusHandle =
+
=== TeraFullKey ===
This is "nn::hidbus::BusHandle".
  −
 
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
! Offset || Size || Description
+
! SystemVersion
 +
! FirmwareVersion
 
|-
 
|-
| 0x0 || 0x4 || AbstractedPadId
+
| [1.0.0+]
|-
+
| 0305
| 0x4 || 0x1 || InternalIndex
  −
|-
  −
| 0x5 || 0x1 || PlayerNumber
  −
|-
  −
| 0x6 || 0x1 || BusTypeId
  −
|-
  −
| 0x7 || 0x1 || IsValid
   
|}
 
|}
   −
= JoyPollingReceivedData =
+
=== ProController ===
This is "nn::hidbus::JoyPollingReceivedData".
  −
 
  −
This is copied from the entries in [[#EnableJoyPollingReceiveMode|TransferMemory]] by GetJoyPollingReceivedData.
  −
 
   
{| 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)
  −
** [[#BusType]] is 2, ExternalDeviceId is 0x21. 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.
  −
* Used by Starlink: Battle For Atlas.
  −
** [[#BusType]] is 1, ExternalDeviceId is 0x28. 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+]
  −
  −
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
  −
  −
[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]].
  −
  −
= Firmware update =
  −
HID-sysmodule mounts the contents of title [[Title_list|0100000000000822]] as "systemData" or the contents of title [[Title_list|010000000000B22B]] as "systemDataD". Both titles contain the same files, but [[Title_list|0100000000000822]] is used on retail units while [[Title_list|010000000000B22B]] is used for development.
  −
  −
These titles contain the following files:
  −
* '''ExpectVersionInfo.csv''' - List in the format "[device],[type],[version]" where "device" can be "JoyLeft", "JoyRight", "FullKey", "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''' - 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".
  −
* [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".
      
[[Category:Services]]
 
[[Category:Services]]