Joy-Con Firmware - Revision history

Hexkyz: Moved to main page

2023-08-20T18:43:07Z

Moved to main page

Hexkyz at 19:39, 6 September 2022

2022-09-06T17:39:10Z

← Older revision		Revision as of 21:39, 6 September 2022
Line 24:		Line 24:
	\| 0x5000 \|\| 0x1 \|\| Shipment		\| 0x5000 \|\| 0x1 \|\| Shipment
	\|-		\|-
	\| 0x6000 \|\| 0x1000 \|\| [[#~~Factory Configuration Sector~~\|~~Factory Configuration~~]]		\| 0x6000 \|\| 0x1000 \|\| [[#FactoryConfiguration\|FactoryConfiguration]]
	\|-		\|-
	\| 0x8000 \|\| 0x1000 \|\| [[#~~User Calibration Sector~~\|~~User Calibration~~]]		\| 0x8000 \|\| 0x1000 \|\| [[#UserCalibration\|UserCalibration]]
	\|}		\|}

	== ~~Factory Configuration Sector~~ ==		== FactoryConfiguration ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 179:		Line 179:
	\|}		\|}

	== ~~User Calibration Sector~~ ==		== UserCalibration ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-

Hexkyz: /* Joy-Con Firmware File */

2022-09-06T17:37:54Z

Joy-Con Firmware File

← Older revision		Revision as of 21:37, 6 September 2022
Line 7:		Line 7:
	\|-		\|-
	! Offset		! Offset
	~~! Endianness~~
	! Size		! Size
	! Description		! Description
	\|-		\|-
	\| 0x00 ~~\|\| B~~ \|\| 0x14 \|\| Magic number??		\| 0x00 \|\| 0x14 \|\| Magic number??
	\|-		\|-
	\| 0x15 ~~\|\| L~~ \|\| 0x06 \|\| Unique MAC Address of controller		\| 0x15 \|\| 0x06 \|\| Unique MAC Address of controller
	\|-		\|-
	\| 0x3B3 ~~\|\| L~~ \|\| 0x04 \|\| Offset to Factory Firmware		\| 0x3B3 \|\| 0x04 \|\| Offset to Factory Firmware
	\|-		\|-
	\| 0x1FF4 ~~\|\| B~~ \|\| 0x08 \|\| OTA Magic, if the controller is Over-The-Air updated.		\| 0x1FF4 \|\| 0x08 \|\| OTA Magic, if the controller is Over-The-Air updated.
	\|-		\|-
	\| 0x1FFC ~~\|\| L~~ \|\| 0x04 \|\| Offset to OTA Firmware, if OTA Magic is valid.		\| 0x1FFC \|\| 0x04 \|\| Offset to OTA Firmware, if OTA Magic is valid.
	\|-		\|-
	\| ~~0x6000 \|\| Mixed~~ \|\| 0x1000 \|\| ~~Factory configuration (see [[#Factory Configuration Sector\|Factory Configuration Sector]])~~		\| 0x2000 \|\| 0x1000 \|\| PairingInfo
	\|-		\|-
	\| ~~0x8000~~ \|\| ~~Mixed~~ \|\| 0x1000 \|\| ~~User calibration (see~~ [[#User Calibration Sector\|User Calibration ~~Sector~~]])		\| 0x5000 \|\| 0x1 \|\| Shipment
			\|-
			\| 0x6000 \|\| 0x1000 \|\| [[#Factory Configuration Sector\|Factory Configuration]]
			\|-
			\| 0x8000 \|\| 0x1000 \|\| [[#User Calibration Sector\|User Calibration]]
	\|}		\|}

Line 30:		Line 33:
	\|-		\|-
	! Offset		! Offset
	~~! Endianness~~
	! Size		! Size
	! Description		! Description
	\|-		\|-
	\| 0x00 ~~\|\| B~~ \|\| 0x10 \|\| IdentificationCode		\| 0x00 \|\| 0x10 \|\| IdentificationCode
	\|-		\|-
	\| 0x12 ~~\|\| B~~ \|\| 0x01 \|\| [[#Type\|Type]]		\| 0x12 \|\| 0x01 \|\| [[#Type\|Type]]
	\|-		\|-
	\| 0x1B ~~\|\| B~~ \|\| 0x01 \|\| FormatVersion		\| 0x1B \|\| 0x01 \|\| FormatVersion
	\|-		\|-
	\| 0x20 ~~\|\| B~~ \|\| 0x18 \|\| [[#Cal1\|Cal1]]		\| 0x20 \|\| 0x18 \|\| [[#Cal1\|Cal1]]
	\|-		\|-
	\| 0x3D ~~\|\| B~~ \|\| 0x12 \|\| [[#Cal2\|Cal2]]		\| 0x3D \|\| 0x12 \|\| [[#Cal2\|Cal2]]
	\|-		\|-
	\| 0x4F ~~\|\| B~~ \|\| 0x01 \|\| Reserved		\| 0x4F \|\| 0x01 \|\| Reserved
	\|-		\|-
	\| 0x50 ~~\|\| B~~ \|\| 0x0D \|\| [[#Design\|Design]]		\| 0x50 \|\| 0x0D \|\| [[#Design\|Design]]
	\|-		\|-
	\| 0x80 ~~\|\| B~~ \|\| 0x18 \|\| [[#Model1\|Model1]]		\| 0x80 \|\| 0x18 \|\| [[#Model1\|Model1]]
	\|-		\|-
	\| 0x98 ~~\|\| B~~ \|\| 0x12 \|\| [[#Model2\|Model2]]		\| 0x98 \|\| 0x12 \|\| [[#Model2\|Model2]]
	\|}		\|}

Line 181:		Line 183:
	\|-		\|-
	! Offset		! Offset
	~~! Endianness~~
	! Size		! Size
	! Description		! Description
	\|-		\|-
	\| 0x10 ~~\|\| B~~ \|\| 0x18 \|\| [[#UserCal1\|UserCal1]]		\| 0x10 \|\| 0x18 \|\| [[#UserCal1\|UserCal1]]
	\|-		\|-
	\| 0x28 ~~\|\| B~~ \|\| 0x18 \|\| [[#UserCal2\|UserCal2]]		\| 0x28 \|\| 0x18 \|\| [[#UserCal2\|UserCal2]]
	\|}		\|}

Hexkyz: /* Type */

2022-08-29T19:21:01Z

Type

← Older revision		Revision as of 23:21, 29 August 2022
Line 57:		Line 57:
	\|-		\|-
	! Value		! Value
	! ~~Name~~		! Description
	\|-		\|-
	\| 0x01 \|\| JoyLeft		\| 0x01 \|\| JoyLeft
Line 65:		Line 65:
	\| 0x03 \|\| SwitchProController		\| 0x03 \|\| SwitchProController
	\|-		\|-
	\| 0x04 \|\| ~~Reserved~~ ([[HID_services#DeviceTypeInternal\|DeviceType]] 4)		\| 0x04 \|\| ([[HID_services#DeviceTypeInternal\|DeviceType]] 4)
	\|-		\|-
	\| 0x05 \|\| ~~Reserved~~ ([[HID_services#DeviceTypeInternal\|DeviceType]] 5)		\| 0x05 \|\| ([[HID_services#DeviceTypeInternal\|DeviceType]] 5)
	\|-		\|-
	\| 0x06 \|\| ~~Reserved~~ ([[HID_services#DeviceTypeInternal\|DeviceType]] 6)		\| 0x06 \|\| ([[HID_services#DeviceTypeInternal\|DeviceType]] 6)
	\|-		\|-
	\| 0x07 \|\| LarkHvc1		\| 0x07 \|\| LarkHvc1
Line 81:		Line 81:
	\| 0x0B \|\| Lucia		\| 0x0B \|\| Lucia
	\|-		\|-
	\| 0x0C \|\| Lagon		\| 0x0C \|\| [12.0.0+] Lagon
	\|-		\|-
	\| 0x0D \|\| Lager		\| 0x0D \|\| [13.0.0+] Lager
	\|-		\|-
	\| ~~0x21~~ \|\| ~~Reserved~~ ([[HID_services#DeviceTypeInternal\|DeviceType]] 14)		\| 0x0E \|\| [14.0.0+] ([[HID_services#DeviceTypeInternal\|DeviceType]] 30)
	\|-		\|-
	\| 0x22 \|\| ~~Reserved~~ ([[HID_services#DeviceTypeInternal\|DeviceType]] 18)		\| 0x21 \|\| FiftyLeft ([[HID_services#DeviceTypeInternal\|DeviceType]] 14)
			\|-
			\| 0x22 \|\| FiftyRight ([[HID_services#DeviceTypeInternal\|DeviceType]] 18)
	\|}		\|}

Hexkyz: /* User Calibration Sector */

2021-11-07T18:32:44Z

User Calibration Sector

← Older revision		Revision as of 21:32, 7 November 2021
Line 183:		Line 183:
	! Description		! Description
	\|-		\|-
	\| 0x10 \|\| B \|\| 0x18 \|\| UserCal1		\| 0x10 \|\| B \|\| 0x18 \|\| [[#UserCal1\|UserCal1]]
	\|-		\|-
	\| 0x28 \|\| B \|\| 0x18 \|\| UserCal2		\| 0x28 \|\| B \|\| 0x18 \|\| [[#UserCal2\|UserCal2]]
	\|}		\|}

Hexkyz at 19:32, 7 November 2021

2021-11-07T18:32:00Z

@@ Line 40: / Line 40: @@
 | 0x1B || B || 0x01 || FormatVersion
 |-
-| 0x20 || B || 0x18 || Cal1
+| 0x20 || B || 0x18 || [[#Cal1|Cal1]]
 |-
-| 0x3D || B || 0x19 || Cal2
+| 0x3D || B || 0x12 || [[#Cal2|Cal2]]
 |-
-| 0x50 || B || 0x0D || [[#DesignInfo|DesignInfo]]
+| 0x4F || B || 0x01 || Reserved
 |-
-| 0x80 || B || 0x18 || Model1
+| 0x50 || B || 0x0D || [[#Design|Design]]
 |-
-| 0x98 || B || 0x12 || Model2
+| 0x80 || B || 0x18 || [[#Model1|Model1]]
 |}
@@ Line 88: / Line 90: @@
 |}
-=== DesignInfo ===
+=== Cal1 ===
 {| class="wikitable" border="1"
 |-
@@ Line 127: / Line 151: @@
 |-
 | 0x02 || LuciaU, LagerU
 |}
@@ Line 137: / Line 183: @@
 ! Description
 |-
-| 0x10 || B || 0x0B || LeftAnalogStickUserCal
+| 0x10 || B || 0x18 || UserCal1
 |-
-| 0x1B || B || 0x0B || RightAnalogStickUserCal
+| 0x28 || B || 0x18 || UserCal2
 |-
-| 0x26 || B || 0x1A || SixAxisSensorUserCal
+| 0x00 || 0x18 || SixAxisSensorCalibrationValue
 |}

Hexkyz at 19:04, 7 November 2021

2021-11-07T18:04:23Z

← Older revision		Revision as of 21:04, 7 November 2021
Line 51:		Line 51:
	\|}		\|}

	=== Type===		=== Type ===
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 95:		Line 95:
	! Description		! Description
	\|-		\|-
	\| 0x00 \|\| ~~0x06~~ \|\| [[#ControllerColor\|~~ControllerColorMain~~]]		\| 0x00 \|\| 0x0C \|\| [[#ControllerColor\|ControllerColor]]
	\|-		\|-
	\| ~~0x06~~ \|\| ~~0x06~~ \|\| [[#~~ControllerColor~~\|~~ControllerColorSub~~]]		\| 0x0C \|\| 0x01 \|\| [[#DesignVariation\|DesignVariation]]
	\|-
	~~\| 0x0C \|\| 0x01 \|\| DesignVariation~~
	\|}		\|}

Line 112:		Line 110:
	\|-		\|-
	\| 0x03 \|\| 0x03 \|\| Button color of controller in RGB Hex (see [[Joy-Con#Colors\|Joy-Con Colors]])		\| 0x03 \|\| 0x03 \|\| Button color of controller in RGB Hex (see [[Joy-Con#Colors\|Joy-Con Colors]])
			\|-
			\| 0x06 \|\| 0x03 \|\| Left grip color of controller in RGB Hex
			\|-
			\| 0x09 \|\| 0x03 \|\| Right grip color of controller in RGB Hex
			\|}

			==== DesignVariation ====
			{\| class="wikitable" border="1"
			\|-
			! Value
			! Name
			\|-
			\| 0x00 \|\| LuciaJ, LagerJ
			\|-
			\| 0x01 \|\| LuciaE, LagerE
			\|-
			\| 0x02 \|\| LuciaU, LagerU
	\|}		\|}

Hexkyz: /* DesignInfo */

2021-11-07T17:56:00Z

DesignInfo

← Older revision		Revision as of 20:56, 7 November 2021
Line 95:		Line 95:
	! Description		! Description
	\|-		\|-
	\| 0x00 \|\| 0x06 \|\| [[#ControllerColor\|~~ControllerColor~~]]		\| 0x00 \|\| 0x06 \|\| [[#ControllerColor\|ControllerColorMain]]
	\|-		\|-
	\| 0x06 \|\| ~~0x07~~ \|\| ~~Unknown~~		\| 0x06 \|\| 0x06 \|\| [[#ControllerColor\|ControllerColorSub]]
			\|-
			\| 0x0C \|\| 0x01 \|\| DesignVariation
	\|}		\|}

Hexkyz: /* Type */

2021-11-07T17:32:35Z

Type

@@ Line 57: / Line 57: @@
 ! Name
 |-
-| 0x01 || Joy-Con Left
+| 0x01 || JoyLeft
 |-
-| 0x02 || Joy-Con Right
+| 0x02 || JoyRight
 |-
-| 0x03 || Pro Controller
+| 0x03 || SwitchProController
 |}

Hexkyz at 17:45, 17 August 2020

2020-08-17T15:45:04Z

← Older revision		Revision as of 19:45, 17 August 2020
Line 1:		Line 1:
	The Joy-Con is internally called Ukyo. (~~Strings in the firmware~~) The firmware is written in C++. ~~(Also found in strings in the firmware)~~		The Joy-Con are internally called Ukyo (Left) and Sakyo (Right). The firmware is written in C++.

	= Joy-Con Firmware File =		= Joy-Con Firmware File =

	The length of the firmware must be 524288 bytes.		The length of the firmware must be 524288 bytes.

Line 28:		Line 27:

	== Factory Configuration Sector ==		== Factory Configuration Sector ==

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 36:		Line 34:
	! Description		! Description
	\|-		\|-
	\| 0x00 \|\| B \|\| 0x10 \|\| ~~Serial number~~		\| 0x00 \|\| B \|\| 0x10 \|\| IdentificationCode
			\|-
			\| 0x12 \|\| B \|\| 0x01 \|\| [[#Type\|Type]]
	\|-		\|-
	\| ~~0x10~~ \|\| ? \|\| ~~0x02~~ \|\| ~~Unknown~~		\| 0x1B \|\| B \|\| 0x01 \|\| FormatVersion
	\|-		\|-
	\| ~~0x12~~ \|\| B \|\| ~~0x01~~ \|\| ~~Type descriptor (see [[#Type Descriptor\|Type Descriptor]])~~		\| 0x20 \|\| B \|\| 0x18 \|\| Cal1
	\|-		\|-
	\| ~~0x13~~ \|\| ? \|\| ~~0x3D~~ \|\| ~~Unknown~~		\| 0x3D \|\| B \|\| 0x19 \|\| Cal2
	\|-		\|-
	\| 0x50 \|\| B \|\| ~~0x03~~ \|\| ~~Body color of Controller in RGB Hex (see~~ [[~~Joy-Con~~#~~Colors~~\|~~Joy-Con Colors~~]])		\| 0x50 \|\| B \|\| 0x0D \|\| [[#DesignInfo\|DesignInfo]]
	\|-		\|-
	\| ~~0x53~~ \|\| B \|\| ~~0x03~~ \|\| ~~Button color of Controller in RGB Hex (see [[Joy-Con#Colors\|Joy-Con Colors]])~~		\| 0x80 \|\| B \|\| 0x18 \|\| Model1
	\|-		\|-
	\| ~~0x56~~ \|\| ? \|\| ~~0xFAA~~ \|\| ~~Unknown~~		\| 0x98 \|\| B \|\| 0x12 \|\| Model2
	\|}		\|}

	=== Type ~~Descriptor~~ ===		=== Type===

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Value		! Value
	! ~~Type~~ Name		! Name
	\|-		\|-
	\| 0x01 \|\| Joy-Con Left		\| 0x01 \|\| Joy-Con Left
Line 65:		Line 64:
	\|}		\|}

	== ~~User Calibration Sector~~ ==		=== DesignInfo ===
			{\| class="wikitable" border="1"
			\|-
			! Offset
			! Size
			! Description
			\|-
			\| 0x00 \|\| 0x06 \|\| [[#ControllerColor\|ControllerColor]]
			\|-
			\| 0x06 \|\| 0x07 \|\| Unknown
			\|}

			==== ControllerColor ====
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Offset		! Offset
	~~! Endianness~~
	! Size		! Size
	! Description		! Description
	\|-		\|-
	\| 0x00 \|\| ? \|\| ~~0x11~~ \|~~\| Unknown~~		\| 0x00 \|\| 0x03 \|\| Body color of controller in RGB Hex (see [[Joy-Con#Colors\|Joy-Con Colors]])
	\|-		\|-
	\| ~~0x10~~ \|\| B \|\| ~~0x0B~~ \|\| ~~Left Stick~~ Calibration ~~(Factory 0xFF?)~~		\| 0x03 \|\| 0x03 \|\| Button color of controller in RGB Hex (see [[Joy-Con#Colors\|Joy-Con Colors]])
			\|}

			== User Calibration Sector ==
			{\| class="wikitable" border="1"
			\|-
			! Offset
			! Endianness
			! Size
			! Description
	\|-		\|-
	\| ~~0x1B~~ \|\| B \|\| 0x0B \|\| ~~Right Stick Calibration (Factory 0xFF?)~~		\| 0x10 \|\| B \|\| 0x0B \|\| LeftAnalogStickUserCal
	\|-		\|-
	\| ~~0x26~~ \|\| B \|\| ~~0x1A~~ \|\| ~~Sensor Calibration (Factory 0xFF?)~~		\| 0x1B \|\| B \|\| 0x0B \|\| RightAnalogStickUserCal
	\|-		\|-
	\| ~~0x40~~ \|\| ? \|\| ~~0xFBF~~ \|\| ~~Unknown~~		\| 0x26 \|\| B \|\| 0x1A \|\| SixAxisSensorUserCal
	\|}		\|}

	= Firmware Chunks =		= Firmware Chunks =

	The firmware itself is stored in PatchRAM chunks, located at the Factory Offset or the OTA Offset. Each chunk has a Record Type, Size and Data.		The firmware itself is stored in PatchRAM chunks, located at the Factory Offset or the OTA Offset. Each chunk has a Record Type, Size and Data.

Line 104:		Line 121:

	== Record Types ==		== Record Types ==

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 121:		Line 137:

	=== Record 0x08 ===		=== Record 0x08 ===

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 143:		Line 158:

	=== Record 0x0A ===		=== Record 0x0A ===

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 158:		Line 172:

	=== Record 0x0B ===		=== Record 0x0B ===

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 170:		Line 183:

	== Memory Regions ==		== Memory Regions ==

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-