Nintendo Switch Brew

Joy-Con: Difference between revisions

← Older editNewer edit →
CapNem (talk | contribs)
12 edits
Joy-Con codenames were reversed, can confirm this with prototype board labels and also Japanese history
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Joy-Con is the name for the Switch's primary game controllers. The controllers communicate to the console through bluetooth and can be disconnected from the main unit.
Joy-Con is the name for the Switch's primary game controllers. The Joy-Con are internally called Sakyo (Left) and Ukyo (Right).


= Hardware =
= Hardware =
The controllers themselves are simple to disassemble and identify.
== Sakyo ==
[[File:JoyconFront.jpg|400px|thumb|The front of the Joy-Con internal[https://www.ifixit.com/Teardown/Nintendo+Switch+Teardown/78263]]]
[[File:JoyconRear.jpg|400px|thumb|The rear of the Joy-Con internal[https://www.ifixit.com/Teardown/Nintendo+Switch+Teardown/78263]]]
{| class="wikitable"
{| class="wikitable"
! Color || Item
! Component || Description
|-
|-
| Red || Broadcom BCM20734 Bluetooth 4.1/2.4 GHz Transceiver
| SoC || Broadcom BCM20734
|-
|-
| Orange || STMicroelectronics NFCBEA 812006 33 (Likely NFC reader IC)
| IMU || STMicroelectronics LSM6DS3H
|-
|-
| Yellow|| Macronix International MX25U4033E 4 Mb CMOS Flash
| PMIC || Texas Instruments BQ24072
|-
| Storage || Macronix International MX25U4033E 4 Mb CMOS Flash
|}
|}


= Firmware =
== Ukyo ==
''See also: [[Joy-Con Firmware]]''
 
The firmware of the Joy-Cons seems to be generic across all instances. Details such as the handedness of the controller and the color is just indicated in a configuration part of the flash. Judging by quick glance at the firmware, it's probably identical to that used on the Pro Controller as well.
{| class="wikitable"
{| class="wikitable"
! Controller || 1.0.0
! Component || Description
|-
|-
| Joy-Con Left (Blue) || [[:File:pad.L.bin|flash dump]]
| SoC || Broadcom BCM20734
|-
|-
| Joy-Con Right (Red) || [[:File:pad.R.bin|flash dump]]
| MCU || STMicroelectronics STM32P411
|-
| NFC || STMicroelectronics ST21NFCB
|-
| IMU || STMicroelectronics LSM6DS3H
|-
| PMIC || Texas Instruments BQ24072
|-
| Storage || Macronix International MX25U4033E 4 Mb CMOS Flash
|}
|}
The flash is in a patch-ram format. Tools for dealing with it are available [https://github.com/shuffle2/nxpad].
A dump of the ROM region (taken while firmware was running) can be found [[:File:bcm20734_rom.bin|here]]. Note this is the same SoC used on the other controller models, as well.


= Protocol =
= Protocol =
The Joy-Con can communicate wirelessly over Bluetooth or through the rails over UART. This uses a Nintendo proprietary protocol called "Nwcp".  
The Joy-Con can communicate wirelessly over Bluetooth or through the rails over UART. The latter uses a Nintendo proprietary protocol called "Nwcp".  


== NwcpPacket ==
== NwcpPacket ==
Line 126: Line 128:
! Description
! Description
|-
|-
| 0x91 || DeviceCommandToDevice
| 0x91 || DeviceCommandIn
|-
|-
| 0x92 || Hid
| 0x92 || Hid
|-
|-
| 0x94 || DeviceCommandFromDevice
| 0x93 ||
|-
| 0x94 || DeviceCommandOut
|-
| 0x95 ||
|-
|-
| 0x9A ||  
| 0x9A ||  
Line 137: Line 143:
|-
|-
| 0xA5 || Handshake
| 0xA5 || Handshake
|}
== HidCommandInputReport ==
This is a 0x31-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| LatencyTimer
|-
| 0x2
| 0x1
| PowerInfo
|-
| 0x3
| 0x1
| RightPadButtonStatus
|-
| 0x4
| 0x1
| SharedButtonStatus
|-
| 0x5
| 0x1
| LeftPadButtonStatus
|-
| 0x6
| 0x3
| LeftAnalogStickData
|-
| 0x9
| 0x3
| RightAnalogStickData
|-
| 0xC
| 0x1
| MotorStatus
|-
| 0xD
| 0x1
| CommandAck
|-
| 0xE
| 0x1
| [[#HidCommand|CommandId]]
|-
| 0xF
| 0x22
| CommandReply
|}
== HidMcuUpdateInputReport ==
This is a 0x30-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| LatencyTimer
|-
| 0x2
| 0x1
| PowerInfo
|-
| 0x3
| 0x1
| RightPadButtonStatus
|-
| 0x4
| 0x1
| SharedButtonStatus
|-
| 0x5
| 0x1
| LeftPadButtonStatus
|-
| 0x6
| 0x3
| LeftAnalogStickData
|-
| 0x9
| 0x3
| RightAnalogStickData
|-
| 0xC
| 0x1
| MotorStatus
|-
| 0xD
| 0x23
| McuUpdateData
|}
== HidBasicInputReport ==
This is a 0x31-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| LatencyTimer
|-
| 0x2
| 0x1
| PowerInfo
|-
| 0x3
| 0x1
| RightPadButtonStatus
|-
| 0x4
| 0x1
| SharedButtonStatus
|-
| 0x5
| 0x1
| LeftPadButtonStatus
|-
| 0x6
| 0x3
| LeftAnalogStickData
|-
| 0x9
| 0x3
| RightAnalogStickData
|-
| 0xC
| 0x1
| MotorStatus
|-
| 0xD
| 0x24
| BasicData
|}
== HidMcuInputReport ==
This is a 0x16A-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| LatencyTimer
|-
| 0x2
| 0x1
| PowerInfo
|-
| 0x3
| 0x1
| RightPadButtonStatus
|-
| 0x4
| 0x1
| SharedButtonStatus
|-
| 0x5
| 0x1
| LeftPadButtonStatus
|-
| 0x6
| 0x3
| LeftAnalogStickData
|-
| 0x9
| 0x3
| RightAnalogStickData
|-
| 0xC
| 0x1
| MotorStatus
|-
| 0xD
| 0x6
| SensorAccelSample0
|-
| 0x13
| 0x6
| SensorGyroSample0
|-
| 0x19
| 0x6
| SensorAccelSample1
|-
| 0x1F
| 0x6
| SensorGyroSample1
|-
| 0x25
| 0x6
| SensorAccelSample2
|-
| 0x2B
| 0x6
| SensorGyroSample2
|-
| 0x31
| 0x139
| McuData
|}
== HidAttachmentInputReport ==
This is a 0x16A-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| LatencyTimer
|-
| 0x2
| 0x1
| PowerInfo
|-
| 0x3
| 0x1
| RightPadButtonStatus
|-
| 0x4
| 0x1
| SharedButtonStatus
|-
| 0x5
| 0x1
| LeftPadButtonStatus
|-
| 0x6
| 0x3
| LeftAnalogStickData
|-
| 0x9
| 0x3
| RightAnalogStickData
|-
| 0xC
| 0x1
| MotorStatus
|-
| 0xD
| 0x6
| SensorAccelSample0
|-
| 0x13
| 0x6
| SensorGyroSample0
|-
| 0x19
| 0x6
| SensorAccelSample1
|-
| 0x1F
| 0x6
| SensorGyroSample1
|-
| 0x25
| 0x6
| SensorAccelSample2
|-
| 0x2B
| 0x6
| SensorGyroSample2
|-
| 0x31
| 0x139
| AttachmentData
|}
== HidGenericInputReport ==
This is a 0xC-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x2
| ButtonStatus
|-
| 0x3
| 0x1
| StickHatData
|-
| 0x4
| 0x4
| LeftAnalogStickData
|-
| 0x8
| 0x4
| RightAnalogStickData
|}
== HidCommandOutputReport ==
This is a 0x31-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| PacketNumber
|-
| 0x2
| 0x8
| MotorData
|-
| 0xA
| 0x1
| [[#HidCommand|CommandId]]
|-
| 0xB
| 0x26
| CommandData
|}
== HidMcuUpdateOutputReport ==
This is a 0x13E-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| PacketNumber
|-
| 0x2
| 0x8
| MotorData
|-
| 0xA
| 0x134
| McuUpdateData
|}
== HidBasicOutputReport ==
This is a 0xA-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| PacketNumber
|-
| 0x2
| 0x8
| MotorData
|}
== HidMcuOutputReport ==
This is a 0x30-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| PacketNumber
|-
| 0x2
| 0x8
| MotorData
|-
| 0xA
| 0x26
| McuData
|}
== HidAttachmentOutputReport ==
This is a 0x30-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| [[#HidReportId|ReportId]]
|-
| 0x1
| 0x1
| PacketNumber
|-
| 0x2
| 0x8
| MotorData
|-
| 0xA
| 0x26
| AttachmentData
|}
== HidReportId ==
{| class="wikitable" border="1"
! Value
! Description
|-
| 0x01 || CommandOutputReport
|-
| 0x03 || McuUpdateOutputReport
|-
| 0x10 || BasicOutputReport
|-
| 0x11 || McuOutputReport
|-
| 0x12 || AttachmentOutputReport
|-
| 0x21 || CommandInputReport
|-
| 0x23 || McuUpdateInputReport
|-
| 0x30 || BasicInputReport
|-
| 0x31 || McuInputReport
|-
| 0x32 || AttachmentInputReport
|-
| 0x33 ||
|-
| 0x3F || GenericInputReport
|-
| 0x70 || OtaEnableFwuReport
|-
| 0x71 || OtaSetupReadReport
|-
| 0x72 || OtaReadReport
|-
| 0x73 || OtaWriteReport
|-
| 0x74 || OtaEraseReport
|-
| 0x75 || OtaLaunchReport
|-
| 0x80 || ExtGripOutputReport
|-
| 0x81 || ExtGripInputReport
|-
| 0x82 ||
|}
|}


Line 295: Line 815:
|}
|}


== Left & Right Separate Joy-con ==
== ExtGripCommand ==
When paired directly to a computer over bluetooth, the joy-con both provide identical HID input report descriptor. This does not appear to include motion controls, IR data, or NFC. They both behave as detached single-player controllers.
{| class="wikitable" border="1"
! Value
! Description
|-
| 0x01 || Inquiry
|-
| 0x02 || CreateHidConnection
|-
| 0x03 || DeleteHidConnection
|-
| 0x04 || StartHidData
|-
| 0x05 || StopHidData
|-
| 0x06 ||
|-
| 0x07 || GetFirmwareVersion
|-
| 0x08 ||
|-
| 0x91 || LoopbackTest
|-
| 0x92 ||
|-
| 0xA0 || SetUartClockTrim
|}
 
= Firmware =
The firmware is stored inside the flash in Broadcom's PatchRAM format as follows:
 
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x1000 || StaticSection
|-
| 0x1000 || 0x1000 || [[#FailsafeSection|FailsafeSection]]
|-
| 0x2000 || 0x1000 || [[#VolatileSection|VolatileSection]]
|-
| 0x3000 || 0x1000 || VolatileSectionBackup1
|-
| 0x4000 || 0x1000 || VolatileSectionBackup2
|-
| 0x5000 || 0x1000 || [[#ShipmentInfo|ShipmentInfo]]
|-
| 0x6000 || 0x1000 || [[#FactoryConfiguration|FactoryConfiguration]]
|-
| 0x8000 || 0x1000 || [[#UserCalibration|UserCalibration]]
|-
| 0x9000 || 0x7000 || Reserved
|-
| 0x10000 || 0x18000 || DynamicSection1
|-
| 0x28000 || 0x18000 || DynamicSection2
|-
| 0x40000 || 0x40000 || Reserved
|}
 
== FailsafeSection ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0xFF4 || Reserved
|-
| 0xFF4 || 0x8 || Signature
|-
| 0xFFC || 0x4 || Ds2Offset
|}


HID Input Report Descriptor (Hexadecimal):
== VolatileSection ==
<pre>
{| class="wikitable" border="1"
00000000: 05010905 A1010601 FF852109 21750895  ....¡...ÿ…!.!u.•
|-
00000010: 30810285 30093075 08953081 02853109  0..…0.0u.•0..…1.
! Offset
00000020: 31750896 69018102 85320932 75089669  1u.–i...…2.2u.–i
! Size
00000030: 01810285 33093375 08966901 8102853F  ...…3.3u.–i...…?
! Description
00000040: 05091901 29101500 25017501 95108102  ....)...%.u.•...
|-
00000050: 05010939 15002507 75049501 81420509  ...9..%.u.•..B..
| 0x0 || 0x26 ||
00000060: 75049501 81010501 09300931 09330934  u.•......0.1.3.4
|-
00000070: 16000027 FFFF0000 75109504 81020601  ...'ÿÿ..u.•.....
| 0x26 || 0xFDA || Reserved
00000080: FF850109 01750895 30910285 10091075  ÿ…...u.•0‘.…...u
|}
00000090: 08953091 02851109 11750895 30910285  .•0‘.…...u.•0‘.…
000000A0: 12091275 08953091 02C0              ...u.•0‘.À
</pre>


{| class="wikitable"
== ShipmentInfo ==
! Parsed Bytes || Description
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x1 || Shipment
|-
| 0x1 || 0xFFF || Reserved
|}
 
== FactoryConfiguration ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x10 || IdentificationCode
|-
| 0x10 || 0x2 || Reserved
|-
| 0x12 || 0x1 || [[#Type|Type]]
|-
| 0x13 || 0x1 || BoardRevision
|-
| 0x14 || 0x7 || Reserved
|-
| 0x1B || 0x1 || FormatVersion
|-
| 0x1C || 0x4 || Reserved
|-
| 0x20 || 0x18 || [[#Cal1|Cal1]]
|-
| 0x38 || 0x5 || Reserved
|-
| 0x3D || 0x12 || [[#Cal2|Cal2]]
|-
| 0x4F || 0x1 || Reserved
|-
| 0x50 || 0xD || [[#Design|Design]]
|-
| 0x5D || 0x23 || Reserved
|-
| 0x80 || 0x18 || [[#Model1|Model1]]
|-
| 0x98 || 0x12 || [[#Model2|Model2]]
|-
| 0xAA || 0x1 || Reserved
|-
| 0xAB || 0x1 || AccelerometerAxisAssignment
|-
| 0xAC || 0x1 || GyroscopeAxisAssignment
|-
| 0xAD || 0x1 || MainAnalogStickAxisAssignment
|-
| 0xAE || 0x1 || SubAnalogStickAxisAssignment
|-
| 0xAF || 0x151 || Reserved
|-
| 0x200 || 0x2 || BatteryVoltage
|-
| 0x202 || 0xB7E || Reserved
|-
| 0xD80 || 0x2 || TarragonVid
|-
| 0xD82 || 0x2 || TarragonPid
|-
| 0xD84 || 0x7C || Reserved
|-
| 0xE00 || 0x100 || InspectionLog
|}
 
=== Type ===
{| class="wikitable" border="1"
|-
! Value
! Description
|-
|-
|0x05, 0x01,        || Usage Page (Generic Desktop Ctrls)
| 0x01 || JoyLeft
|-
|-
|0x09, 0x05,        || Usage (Game Pad)
| 0x02 || JoyRight
|-
|-
|0xA1, 0x01,        || Collection (Application)
| 0x03 || SwitchProController
|-
|-
|0x06, 0x01, 0xFF,  ||   Usage Page (Vendor Defined 0xFF01)
| 0x04 || ([[HID_services#DeviceTypeInternal|DeviceType]] 4)
|-
|-
|0x85, 0x21,        ||   Report ID (33)
| 0x05 || ([[HID_services#DeviceTypeInternal|DeviceType]] 5)
|-
|-
|0x09, 0x21,        ||   Usage (0x21)
| 0x06 || Tarragon ([[HID_services#DeviceTypeInternal|DeviceType]] 6)
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x07 || LarkHvc1
|-
|-
|0x95, 0x30,        ||   Report Count (48)
| 0x08 || LarkHvc2
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x09 || LarkNesLeft
|-
|-
|0x85, 0x30,        ||   Report ID (48)
| 0x0A || LarkNesRight
|-
|-
|0x09, 0x30,        ||   Usage (0x30)
| 0x0B || Lucia
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x0C || [12.0.0+] Lagon
|-
|-
|0x95, 0x30,        ||   Report Count (48)
| 0x0D || [13.0.0+] Lager
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x0E || [14.0.0+] ([[HID_services#DeviceTypeInternal|DeviceType]] 30)
|-
|-
|0x85, 0x31,        ||   Report ID (49)
| 0x21 || FiftyLeft ([[HID_services#DeviceTypeInternal|DeviceType]] 14)
|-
|-
|0x09, 0x31,        ||   Usage (0x31)
| 0x22 || FiftyRight ([[HID_services#DeviceTypeInternal|DeviceType]] 18)
|}
 
=== Cal1 ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x18 || [[#SixAxisSensorCalibrationValue|SixAxisSensorCalibrationValue]]
|}
 
==== SixAxisSensorCalibrationValue ====
{| class="wikitable" border="1"
|-
|-
|0x75, 0x08,        ||  Report Size (8)
! Offset
! Size
! Description
|-
|-
|0x96, 0x69, 0x01,  ||   Report Count (361)
| 0x0 || 0x2 || Accelerometer0OffsetX
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x2 || 0x2 || Accelerometer0OffsetY
|-
|-
|0x85, 0x32,        ||   Report ID (50)
| 0x4 || 0x2 || Accelerometer0OffsetZ
|-
|-
|0x09, 0x32,        ||   Usage (0x32)
| 0x6 || 0x2 || Accelerometer1GScaleX
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x8 || 0x2 || Accelerometer1GScaleY
|-
|-
|0x96, 0x69, 0x01,  ||   Report Count (361)
| 0xA || 0x2 || Accelerometer1GScaleZ
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0xC || 0x2 || Gyroscope0OffsetX
|-
|-
|0x85, 0x33,        ||   Report ID (51)
| 0xE || 0x2 || Gyroscope0OffsetY
|-
|-
|0x09, 0x33,        ||   Usage (0x33)
| 0x10 || 0x2 || Gyroscope0OffsetZ
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x12 || 0x2 || Gyroscope78RpmX
|-
|-
|0x96, 0x69, 0x01,  ||   Report Count (361)
| 0x14 || 0x2 || Gyroscope78RpmY
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x16 || 0x2 || Gyroscope78RpmZ
|}
 
=== Cal2 ===
{| class="wikitable" border="1"
|-
|-
|0x85, 0x3F,        ||  Report ID (63)
! Offset
! Size
! Description
|-
|-
|0x05, 0x09,        ||   Usage Page (Button)
| 0x0 || 0x9 || [[#MainAnalogStickCalibrationValue|MainAnalogStickCalibrationValue]]
|-
|-
|0x19, 0x01,        ||   Usage Minimum (0x01)
| 0x9 || 0x9 || [[#SubAnalogStickCalibrationValue|SubAnalogStickCalibrationValue]]
|}
 
==== MainAnalogStickCalibrationValue ====
{| class="wikitable" border="1"
|-
|-
|0x29, 0x10,        ||  Usage Maximum (0x10)
! Offset
! Size
! Description
|-
|-
|0x15, 0x00,        ||   Logical Minimum (0)
| 0x0 || 0x3 || AnalogStickCalXPositiveAndAnalogStickCalYPositive
|-
|-
|0x25, 0x01,        ||   Logical Maximum (1)
| 0x3 || 0x3 || AnalogStickCalX0AndAnalogStickCalY0
|-
|-
|0x75, 0x01,        ||   Report Size (1)
| 0x6 || 0x3 || AnalogStickCalXNegativeAndAnalogStickCalYNegative
|}
 
==== SubAnalogStickCalibrationValue ====
{| class="wikitable" border="1"
|-
|-
|0x95, 0x10,        ||  Report Count (16)
! Offset
! Size
! Description
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x0 || 0x3 || AnalogStickCalX0AndAnalogStickCalY0
|-
|-
|0x05, 0x01,        ||   Usage Page (Generic Desktop Ctrls)
| 0x3 || 0x3 || AnalogStickCalXNegativeAndAnalogStickCalYNegative
|-
|-
|0x09, 0x39,        ||   Usage (Hat switch)
| 0x6 || 0x3 || AnalogStickCalXPositiveAndAnalogStickCalYPositive
|}
 
=== Design ===
{| class="wikitable" border="1"
|-
|-
|0x15, 0x00,        ||  Logical Minimum (0)
! Offset
! Size
! Description
|-
|-
|0x25, 0x07,        ||   Logical Maximum (7)
| 0x0 || 0xC || [[#ControllerColor|ControllerColor]]
|-
|-
|0x75, 0x04,        ||   Report Size (4)
| 0xC || 0x1 || [[#DesignVariation|DesignVariation]]
|}
 
==== ControllerColor ====
{| class="wikitable" border="1"
|-
|-
|0x95, 0x01,        ||  Report Count (1)
! Offset
! Size
! Description
|-
|-
|0x81, 0x42,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)
| 0x0 || 0x3 || MainColor (body color of controller in RGB Hex, see [[Joy-Con#Colors|Joy-Con Colors]])
|-
|-
|0x05, 0x09,        ||   Usage Page (Button)
| 0x3 || 0x3 || SubColor (button color of controller in RGB Hex, see [[Joy-Con#Colors|Joy-Con Colors]])
|-
|-
|0x75, 0x04,        ||   Report Size (4)
| 0x6 || 0x3 || 3rdColor (left grip color of controller in RGB Hex)
|-
|-
|0x95, 0x01,        ||   Report Count (1)
| 0x9 || 0x3 || 4thColor (right grip color of controller in RGB Hex)
|}
 
==== DesignVariation ====
{| class="wikitable" border="1"
|-
|-
|0x81, 0x01,        ||  Input (Const,Array,Abs,No Wrap,Linear,Preferred State,No Null Position)
! Value
! Name
|-
|-
|0x05, 0x01,        ||   Usage Page (Generic Desktop Ctrls)
| 0x0 || LuciaJ, LagerJ
|-
|-
|0x09, 0x30,        ||   Usage (X)
| 0x1 || LuciaE, LagerE
|-
|-
|0x09, 0x31,       ||   Usage (Y)
| 0x2 || LuciaU, LagerU
|}
 
=== Model1 ===
{| class="wikitable" border="1"
|-
|-
|0x09, 0x33,        ||  Usage (Rx)
! Offset
! Size
! Description
|-
|-
|0x09, 0x34,        ||   Usage (Ry)
| 0x0 || 0x6 || [[#SixAxisSensorHorizontalOffset|SixAxisSensorHorizontalOffset]]
|-
|-
|0x16, 0x00, 0x00,  ||   Logical Minimum (0)
| 0x6 || 0x12 || [[#AnalogStickModuleParam|MainAnalogStickModuleParam]]
|}
 
==== SixAxisSensorHorizontalOffset ====
{| class="wikitable" border="1"
|-
|-
|0x27, 0xFF, 0xFF, 0x00, 0x00,  ||  Logical Maximum (65534)
! Offset
! Size
! Description
|-
|-
|0x75, 0x10,        ||   Report Size (16)
| 0x0 || 0x2 || HorizontalOffsetX
|-
|-
|0x95, 0x04,        ||   Report Count (4)
| 0x2 || 0x2 || HorizontalOffsetY
|-
|-
|0x81, 0x02,        ||   Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
| 0x4 || 0x2 || HorizontalOffsetZ
|}
 
==== AnalogStickModuleParam ====
{| class="wikitable" border="1"
|-
|-
|0x06, 0x01, 0xFF,  ||  Usage Page (Vendor Defined 0xFF01)
! Offset
! Size
! Description
|-
|-
|0x85, 0x01,        ||   Report ID (1)
| 0x0 || 0x3 || TypicalStrokeXAndTypicalStrokeY
|-
|-
|0x09, 0x01,        ||   Usage (0x01)
| 0x3 || 0x3 || CenterDeadZoneSizeAndCircuitDeadZoneScale
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x6 || 0x3 || MinimumStrokeXPositiveAndMinimumStrokeYPositive
|-
|-
|0x95, 0x30,        ||   Report Count (48)
| 0x9 || 0x3 || MinimumStrokeXNegativeAndMinimumStrokeYNegative
|-
|-
|0x91, 0x02,        ||   Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
| 0xC || 0x3 || CenterRangeXPositiveAndCenterRangeYPositive
|-
|-
|0x85, 0x10,        ||   Report ID (16)
| 0xF || 0x3 || CenterRangeXNegativeAndCenterRangeYNegative
|}
 
=== Model2 ===
{| class="wikitable" border="1"
|-
|-
|0x09, 0x10,        ||  Usage (0x10)
! Offset
! Size
! Description
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x0 || 0x12 || [[#AnalogStickModuleParam|SubAnalogStickModuleParam]]
|}
 
== UserCalibration ==
{| class="wikitable" border="1"
|-
|-
|0x95, 0x30,        ||  Report Count (48)
! Offset
! Size
! Description
|-
|-
|0x91, 0x02,        ||   Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
| 0x0 || 0x10 || Reserved
|-
|-
|0x85, 0x11,        ||   Report ID (17)
| 0x10 || 0x16 || [[#UserCal1|UserCal1]]
|-
|-
|0x09, 0x11,        ||   Usage (0x11)
| 0x26 || 0x1A || [[#UserCal2|UserCal2]]
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0x40 || 0xFC0 || Reserved
|}
 
=== UserCal1 ===
{| class="wikitable" border="1"
|-
|-
|0x95, 0x30,        ||  Report Count (48)
! Offset
! Size
! Description
|-
|-
|0x91, 0x02,        ||   Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
| 0x0 || 0x2 || MagicNumber
|-
|-
|0x85, 0x12,        ||   Report ID (18)
| 0x2 || 0x9 || [[#MainAnalogStickCalibrationValue|MainAnalogStickUserCalibrationValue]]
|-
|-
|0x09, 0x12,        ||   Usage (0x12)
| 0xB || 0x2 || MagicNumber
|-
|-
|0x75, 0x08,        ||   Report Size (8)
| 0xD || 0x9 || [[#SubAnalogStickCalibrationValue|SubAnalogStickUserCalibrationValue]]
|}
 
=== UserCal2 ===
{| class="wikitable" border="1"
|-
|-
|0x95, 0x30,        ||  Report Count (48)
! Offset
! Size
! Description
|-
|-
|0x91, 0x02,        ||   Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
| 0x0 || 0x2 || MagicNumber
|-
|-
|0xC0,              || End Collection
| 0x2 || 0x18 || [[#SixAxisSensorCalibrationValue|SixAxisSensorUserCalibrationValue]]
|}
|}


== Colors ==
== Colors ==
HEX codes for the colors shown in the "Controllers" menu of the Switch UI can be found in a Joy-con SPI dump starting at offset 0x6050. Body color is first followed by button color and each is 3 bytes long. These values are able to be re-written with any HEX color value to make the Joy-cons show up as different colors in the UI. The following is a list of official HEX colors recovered from SPI dumps.
HEX codes for the colors shown in the "Controllers" menu of the Switch UI can be found in a Joy-con SPI dump starting at offset 0x6050. Body color is first followed by button color and each is 3 bytes long. These values are able to be re-written with any HEX color value to make the Joy-cons show up as different colors in the UI. The following is a list of official HEX colors recovered from SPI dumps.
{| class="wikitable"
{| class="wikitable"
! Developer Kit Joy-Con || Release || Body HEX || Button HEX
! Developer Kit Joy-Con || Release || Body HEX || Button HEX
Line 509: Line 1,270:
|-
|-
| White / ホワイト || 2021.10.08 || #E6E6E6 || #323232
| White / ホワイト || 2021.10.08 || #E6E6E6 || #323232
|-
| Pastel Pink / パステルピンク || 2023.06.30 || #FFAFAF || #372D2D
|-
| Pastel Yellow / パステルイエロー || 2023.06.30 || #F5FF82 || #32332D
|-
| Pastel Purple / パステルパープル || 2023.06.30 || #F0CBEB || #373037
|-
| Pastel Green / パステルグリーン || 2023.06.30 || #BCFFC8 || #2D322D
|-
|-
! Special Edition Joy-Con Color || Release || Body HEX || Button HEX
! Special Edition Joy-Con Color || Release || Body HEX || Button HEX
Line 568: Line 1,337:
| Pokémon: Scarlet × Violet OLED Edition Violet Right Joy-Con / （有機ELモデル） ポケットモンスター スカーレット・バイオレット || 2022.11.04 || #9650AA || #32322D
| Pokémon: Scarlet × Violet OLED Edition Violet Right Joy-Con / （有機ELモデル） ポケットモンスター スカーレット・バイオレット || 2022.11.04 || #9650AA || #32322D
|-
|-
| Legend of Zelda: Tears of the Kingdom Edition Gold Joy-Con / （有機ELモデル） ゼルダの伝説　ティアーズ オブ ザ キングダムエディション || 2023.04.28 || #D2BE69 || #32322D
| Legend of Zelda: Tears of the Kingdom Edition Gold Joy-Con / （有機ELモデル） ゼルダの伝説　ティアーズ オブ ザ キングダム || 2023.04.28 || #D2BE69 || #32322D
|-
|-
| // *(Prize Awarded for Labo Contest - No Retail) // **(Available Japan Only)
| // *(Prize Awarded for Labo Contest - No Retail) // **(Available Japan Only)
|}
|}
= Additional Links =
[https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering Reverse Engineering of the Joy-Con by Github user dekuNukem]
Retrieved from "https://switchbrew.org/wiki/Joy-Con"