Revision as of 19:04, 7 November 2021

The Joy-Con are internally called Ukyo (Left) and Sakyo (Right). The firmware is written in C++.

Joy-Con Firmware File

The length of the firmware must be 524288 bytes.

Offset	Endianness	Size	Description
0x00	B	0x14	Magic number??
0x15	L	0x06	Unique MAC Address of controller
0x3B3	L	0x04	Offset to Factory Firmware
0x1FF4	B	0x08	OTA Magic, if the controller is Over-The-Air updated.
0x1FFC	L	0x04	Offset to OTA Firmware, if OTA Magic is valid.
0x6000	Mixed	0x1000	Factory configuration (see Factory Configuration Sector)
0x8000	Mixed	0x1000	User calibration (see User Calibration Sector)

Offset	Endianness	Size	Description
0x00	B	0x10	IdentificationCode
0x12	B	0x01	Type
0x1B	B	0x01	FormatVersion
0x20	B	0x18	Cal1
0x3D	B	0x19	Cal2
0x50	B	0x0D	DesignInfo
0x80	B	0x18	Model1
0x98	B	0x12	Model2

Offset	Size	Description
0x00	0x0C	ControllerColor
0x0C	0x01	DesignVariation

Offset	Size	Description
0x00	0x03	Body color of controller in RGB Hex (see Joy-Con Colors)
0x03	0x03	Button color of controller in RGB Hex (see Joy-Con Colors)
0x06	0x03	Left grip color of controller in RGB Hex
0x09	0x03	Right grip color of controller in RGB Hex

Offset	Endianness	Size	Description
0x10	B	0x0B	LeftAnalogStickUserCal
0x1B	B	0x0B	RightAnalogStickUserCal
0x26	B	0x1A	SixAxisSensorUserCal

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.

Offset	Endianness	Size	Description
0x00	L	0x01	Record type (see Record Types)
0x01	L	0x02	Size of data (size)
0x03	Mixed	(size)	Data

Value	Record name	Description
0x08	REC8	ROM1 Patches (See Record 0x08 and Memory Regions)
0x0A	RECA	RAM (Ram Low and Ram High) Patches (See Record 0x0A and Memory Regions)
0x0B	RECB	Unknown
0xFE	END	End of chunk stream

Offset	Endianness	Size	Description
0x00	L	0x01	Index
0x01	L	0x04	Address
0x05	B	0x04	Data
0x09	L	0x02	Unk1?
0x0B	L	0x02	Unk2?
0x0D	L	0x02	Body size???

Offset	Endianness	Size	Description	Note
0x00	L	0x04	Address	-
0x04	B	(Note)	Data	To calculate the size do: chunk_datasize (See Firmware Chunks)-4

Offset	Endianness	Size	Description
0x00	L	0x04	Address

@@ Line 51: / Line 51: @@
 |}
-=== Type===
+=== Type ===
 {| class="wikitable" border="1"
 |-
@@ Line 95: / Line 95: @@
 ! 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]])
+|-
+| 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
 |}