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 |
| + | |} |
| + | |
| + | == VolatileSection == |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x26 || |
| + | |- |
| + | | 0x26 || 0xFDA || Reserved |
| + | |} |
| | | |
− | HID Input Report Descriptor (Hexadecimal):
| + | == ShipmentInfo == |
− | <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 || 0x1 || Shipment |
− | 00000060: 75049501 81010501 09300931 09330934 u.•......0.1.3.4
| + | |- |
− | 00000070: 16000027 FFFF0000 75109504 81020601 ...'ÿÿ..u.•.....
| + | | 0x1 || 0xFFF || 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" | + | == FactoryConfiguration == |
− | ! Parsed Bytes || Description | + | {| 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" |
| |- | | |- |
− | |0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
| + | ! Value |
| + | ! Description |
| |- | | |- |
− | |0x09, 0x05, || Usage (Game Pad) | + | | 0x01 || JoyLeft |
| |- | | |- |
− | |0xA1, 0x01, || Collection (Application) | + | | 0x02 || JoyRight |
| |- | | |- |
− | |0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01) | + | | 0x03 || SwitchProController |
| |- | | |- |
− | |0x85, 0x21, || Report ID (33) | + | | 0x04 || ([[HID_services#DeviceTypeInternal|DeviceType]] 4) |
| |- | | |- |
− | |0x09, 0x21, || Usage (0x21) | + | | 0x05 || ([[HID_services#DeviceTypeInternal|DeviceType]] 5) |
| |- | | |- |
− | |0x75, 0x08, || Report Size (8) | + | | 0x06 || Tarragon ([[HID_services#DeviceTypeInternal|DeviceType]] 6) |
| |- | | |- |
− | |0x95, 0x30, || Report Count (48) | + | | 0x07 || LarkHvc1 |
| |- | | |- |
− | |0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) | + | | 0x08 || LarkHvc2 |
| |- | | |- |
− | |0x85, 0x30, || Report ID (48) | + | | 0x09 || LarkNesLeft |
| |- | | |- |
− | |0x09, 0x30, || Usage (0x30) | + | | 0x0A || LarkNesRight |
| |- | | |- |
− | |0x75, 0x08, || Report Size (8) | + | | 0x0B || Lucia |
| |- | | |- |
− | |0x95, 0x30, || Report Count (48) | + | | 0x0C || [12.0.0+] Lagon |
| |- | | |- |
− | |0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) | + | | 0x0D || [13.0.0+] Lager |
| |- | | |- |
− | |0x85, 0x31, || Report ID (49) | + | | 0x0E || [14.0.0+] ([[HID_services#DeviceTypeInternal|DeviceType]] 30) |
| |- | | |- |
− | |0x09, 0x31, || Usage (0x31) | + | | 0x21 || FiftyLeft ([[HID_services#DeviceTypeInternal|DeviceType]] 14) |
| |- | | |- |
− | |0x75, 0x08, || Report Size (8) | + | | 0x22 || FiftyRight ([[HID_services#DeviceTypeInternal|DeviceType]] 18) |
| + | |} |
| + | |
| + | === Cal1 === |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x18 || [[#SixAxisSensorCalibrationValue|SixAxisSensorCalibrationValue]] |
| + | |} |
| + | |
| + | ==== SixAxisSensorCalibrationValue ==== |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! 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 514: |
Line 1,283: |
| | Nintendo Switch Gray Joy-Con / Nintendo Switch グレー || 2017.03.03 || #828282 || #0F0F0F | | | Nintendo Switch Gray Joy-Con / Nintendo Switch グレー || 2017.03.03 || #828282 || #0F0F0F |
| |- | | |- |
− | | Nintendo Switch Neon-Blue Left Joy-Con / Nintendo Switch ネオンブルー・ネオンレッド || 2017.03.03 || #828282 || #0F0F0F | + | | Nintendo Switch Neon-Blue Left Joy-Con / Nintendo Switch ネオンブルー・ネオンレッド || 2017.03.03 || #0AB9E6 || #001E1E |
| |- | | |- |
− | | Nintendo Switch Neon-Red Right Joy-Con / Nintendo Switch ネオンブルー・ネオンレッド || 2017.03.03 || #828282 || #0F0F0F | + | | Nintendo Switch Neon-Red Right Joy-Con / Nintendo Switch ネオンブルー・ネオンレッド || 2017.03.03 || #FF3C28 || #1E0A0A |
| |- | | |- |
| | Splatoon 2 Edition Neon-Green Left Joy-Con / スプラトゥーン2 || 2017.07.21 || #1EDC00 || #002800 | | | Splatoon 2 Edition Neon-Green Left Joy-Con / スプラトゥーン2 || 2017.07.21 || #1EDC00 || #002800 |
Line 567: |
Line 1,336: |
| |- | | |- |
| | 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 |
| |- | | |- |
| | // *(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]
| |