I2C Registers - Revision history

MarcusD: /* Custom registers for controller 0xC7 */

2025-10-29T00:57:09Z

Custom registers for controller 0xC7

← Older revision		Revision as of 03:57, 29 October 2025
Line 980:		Line 980:
	! Valid bits		! Valid bits
	! Description		! Description
			\|-
			\| 0x02
			\| Factory protection
			\| 0x01
			\| When 0, not only the factory controls are write-protected, but also the factory key.
			Set to 1 by default, which means that factory controls are enableable and writable.
	\|-		\|-
	\| 0x03		\| 0x03

MarcusD: /* Custom registers for controller 0xC7 */

2025-10-29T00:34:31Z

Custom registers for controller 0xC7

← Older revision		Revision as of 03:34, 29 October 2025
Line 1,005:		Line 1,005:

	bit0 - color invert		bit0 - color invert
	bit1 - ~~slight gamma increase~~		bit1 - trim 8bpc to 6bpc (seems like color[1:0] <= color[7:6])
	\|-		\|-
	\| 0x11		\| 0x11

MarcusD: Update info about battery middle pin and temperature reading

2024-09-06T11:38:24Z

Update info about battery middle pin and temperature reading

← Older revision		Revision as of 15:38, 6 September 2024
Line 737:		Line 737:
	byte 0x00: Console type, see [[Configuration_Memory#MCU_HW_INFO\|here]]		byte 0x00: Console type, see [[Configuration_Memory#MCU_HW_INFO\|here]]
	byte 0x01: PMIC vendor code		byte 0x01: PMIC vendor code
	byte 0x02: Battery vendor code		byte 0x02: Battery vendor code (determined from battery middle pin)
	0x00: Maxell		0x00: Maxell (middle pin tied to GND)
	CTR-003 CTR-A-BP (old3DS)		CTR-003 CTR-A-BP (old3DS)
	CTR-003 CTR-A-BPMX-C3 (2DS): Wuxi Hitachi Maxell Co.,Ltd.		CTR-003 CTR-A-BPMX-C3 (2DS): Wuxi Hitachi Maxell Co.,Ltd.
Line 746:		Line 746:
	byte 0x04: MGIC version (minor?)		byte 0x04: MGIC version (minor?)
	byte 0x05: RCOMP(?)		byte 0x05: RCOMP(?)
	byte 0x06: ~~Battery middle terminal~~ NTC reading (more heat causes this value to go down, and cooling off will make this value go back up)		byte 0x06: On-board battery slot NTC reading (more heat causes this value to go down, and cooling off will make this value go back up)
	byte 0x09: system model (see [[Cfg:GetSystemModel#System_Model_Values\|Cfg:GetSystemModel]] for values)		byte 0x09: system model (see [[Cfg:GetSystemModel#System_Model_Values\|Cfg:GetSystemModel]] for values)
	byte 0x0A: Red Power LED mode (0 = off, 1 = on)		byte 0x0A: Red Power LED mode (0 = off, 1 = on)

MarcusD: Add and fix MCU-related battery and voltage info

2024-06-22T16:15:35Z

Add and fix MCU-related battery and voltage info

← Older revision		Revision as of 20:15, 22 June 2024
Line 316:		Line 316:
	\| s		\| s
	\| ro		\| ro
	\| ~~Battery~~ temperature (in ~~Celcius?~~)		\| Internal battery temperature (in Celsius)
	\|-		\|-
	\| 0x0B		\| 0x0B
	\| s		\| s
	\| ro		\| ro
	\| Battery percentage		\| Battery percentage (integer part).

			Valid values are in range of 0 to 100 inclusive.
	\|-		\|-
	\| 0x0C		\| 0x0C
	\| s		\| s
	\| ro		\| ro
	\| Battery percentage, fractional part ~~(seems~~ to have a resolution of around 0.1% according to tests)		\| Battery percentage (fractional part).

			Seems to have a resolution of around 0.1% according to tests.

			To calculate battery charge percentage in full resolution:
			MCU[0x0B] + (MCU[0x0C] / 256.0F)
	\|-		\|-
	\| 0x0D		\| 0x0D
	\| s		\| s
	\| ro		\| ro
	\| System voltage		\| System voltage.

			This voltage seems to be measured at the load side, so the voltage reading will always be lower than direct probes across the battery due to the various voltage drops in the system by the time the voltage is measured.

			To calculate system voltage in Volts:
			MCU[0x0D] * 5 / 256.0F
	\|-		\|-
	\| 0x0E		\| 0x0E
Line 726:		Line 738:
	byte 0x01: PMIC vendor code		byte 0x01: PMIC vendor code
	byte 0x02: Battery vendor code		byte 0x02: Battery vendor code
			0x00: Maxell
			CTR-003 CTR-A-BP (old3DS)
			CTR-003 CTR-A-BPMX-C3 (2DS): Wuxi Hitachi Maxell Co.,Ltd.
			CTR-003 CTR-A-BPMX-C5 (Switch Pro Controller): Wuxi Maxell Co., Ltd.
			SPR-003 SPR-A-BPMX-C3 (new3DSXL): Wuxi Hitachi Maxell Co.,Ltd.
	byte 0x03: MGIC version (major?)		byte 0x03: MGIC version (major?)
	byte 0x04: MGIC version (minor?)		byte 0x04: MGIC version (minor?)
	byte 0x05: RCOMP(?)		byte 0x05: RCOMP(?)
	byte 0x06: ~~battery related?~~ (~~seems~~ to ~~decrease while charging~~ and ~~increase while discharging~~)		byte 0x06: Battery middle terminal NTC reading (more heat causes this value to go down, and cooling off will make this value go back up)
	byte 0x09: system model (see [[Cfg:GetSystemModel#System_Model_Values\|Cfg:GetSystemModel]] for values)		byte 0x09: system model (see [[Cfg:GetSystemModel#System_Model_Values\|Cfg:GetSystemModel]] for values)
	byte 0x0A: Red Power LED mode (0 = off, 1 = on)		byte 0x0A: Red Power LED mode (0 = off, 1 = on)

TuxSH at 17:17, 13 June 2024

2024-06-13T15:17:54Z

← Older revision		Revision as of 19:17, 13 June 2024
Line 737:		Line 737:
	byte 0x0F: RGB LED blue intensity		byte 0x0F: RGB LED blue intensity
	byte 0x11: WiFi LED brightness		byte 0x11: WiFi LED brightness
	byte 0x12: ~~always 0~~?		byte 0x12: raw button states?
			bit0: unset while Power button is held
			bit1: unset while HOME button is held
			bit2: unset while WiFi slider is held
			bit5: unset while the charging LED is active
			bit6: unset while charger is plugged in

	On MCU_FIRM major version 1 the size of this is 9, reading past the 9th byte will yield AA instead of FF.		On MCU_FIRM major version 1 the size of this is 9, reading past the 9th byte will yield AA instead of FF.

TuxSH at 19:31, 12 June 2024

2024-06-12T17:31:16Z

← Older revision		Revision as of 21:31, 12 June 2024
Line 704:		Line 704:
	bytes 6 and 7: Unused		bytes 6 and 7: Unused
	bytes 8 to 175: Playtime data for legacy titles		bytes 8 to 175: Playtime data for legacy titles
	bytes 176 to 188: ~~Playtime~~ data		bytes 176 to 188: Temporary playtime data in case console doesn't shut down gracefully, updated every 5 minutes
	bytes 188 to 199: Unused		bytes 188 to 199: Unused
	\|-		\|-
Line 737:		Line 737:
	byte 0x0F: RGB LED blue intensity		byte 0x0F: RGB LED blue intensity
	byte 0x11: WiFi LED brightness		byte 0x11: WiFi LED brightness
	byte 0x12: ~~raw button states~~?		byte 0x12: always 0?
	~~bit0: unset while Power button is held~~
	~~bit1: unset while HOME button is held~~
	~~bit2: unset while WiFi slider is held~~
	~~bit5: unset while the charging LED is active~~
	~~bit6: unset while charger is plugged in~~

	On MCU_FIRM major version 1 the size of this is 9, reading past the 9th byte will yield AA instead of FF.		On MCU_FIRM major version 1 the size of this is 9, reading past the 9th byte will yield AA instead of FF.

PlasmaGrass: Stub for Device 17

2024-04-28T11:15:30Z

Stub for Device 17

@@ Line 1,355: / Line 1,355: @@
 | Firmware image for this chunk, size varies.
 | This is used during NFC module startup to upload the firmware image to the NFC controller. This is used repeatedly to upload multiple chunks of the image.
 |}

PlasmaGrass: /* Device 3 */ MCU bit 11: Accelerometer status

2024-04-08T02:57:43Z

Device 3: MCU bit 11: Accelerometer status

← Older revision		Revision as of 06:57, 8 April 2024
Line 383:		Line 383:
	bit09: Charger plugged in		bit09: Charger plugged in
	bit10: RTC alarm (when some conditions are met it's sent when the current day and month and year matches the current RTC time)		bit10: RTC alarm (when some conditions are met it's sent when the current day and month and year matches the current RTC time)
	bit11: ~~??? (accelerometer related)~~		bit11: Accelerometer I2C read/write done [https://github.com/profi200/libn3ds/blob/083c8ffa3f56a49802fa74b6afe45a96820f0439/include/arm11/drivers/mcu_regmap.h#L124]
	bit12: HID update		bit12: HID update
	bit13: Battery percentage status change (triggered at 10%, 5%, and 0% while discharging)		bit13: Battery percentage status change (triggered at 10%, 5%, and 0% while discharging)

MarcusD: Added some more display info. TODO: move the part number and its decoding somewhere else

2024-03-14T13:22:38Z

Added some more display info. TODO: move the part number and its decoding somewhere else

← Older revision		Revision as of 16:22, 14 March 2024
Line 834:		Line 834:
	\| Controller ID		\| Controller ID
	\|		\|
	\| Upper 4bits is manufacturer. Lower 4bits is unknown, most likely revision, possibly encoded as a Johnson counter.		\| Upper 4bits is manufacturer. Lower 4bits is unknown, most likely revision, possibly encoded as a Johnson counter. The fields are encoded this way, most likely for the register checksum feature.

			Manufacturers:
			- 0x0 - SHARP (LTPS(?) TN), old I2CLCD, found in old3DS (non-XL) only
			- 0x1 - JDI (LTPS IPS), found in select new3DS and new3DSXL consoles
			- 0xC - SHARP (LTPS(?) TN), new I2CLCD
			- 0xE - SHARP (TFT), found in 2DS only

	Known IDs:		Known IDs:
Line 840:		Line 846:
	- 0xC3 - older old3DSXL		- 0xC3 - older old3DSXL
	- 0xE1 - 2DS		- 0xE1 - 2DS
			- LQ050B1LW10B
			- LQ = normal TFT
			- 050 = panel 5 inches diagonal
			- B = "other" display format
			- 1 = transmissive (backlight-compatible)
			- L = LVDS
			- W = unknown coating type
			- 10 = model number
			- B = unknown suffix
	- 0x10 - some select new3DS and new3DSXL with IPS screens		- 0x10 - some select new3DS and new3DSXL with IPS screens
	- 0x01 - old3DS		- 0x01 - old3DS
	- ~~0x00~~ - unknown~~, gsp compares for this exact Controller ID for an alternate initialization path~~		- LS035T7LE38P (top screen)
			- LS = TFT (LTPS or SI-TFT ?)
	~~Manufacturers:~~		- 035 = panel 3.5 inches diagonal
	- ~~0xC~~ - ~~SHARP~~ (TN)		- T = "other 16:9" (even though the panel is 16:10 in physical size, or 32:10 in terms of pixel count)
	~~- 0x1~~ - ~~JDI~~ (LTPS ~~IPS~~)~~, found in select new3DS and new3DSXL consoles~~		- 7 = unknown backing type
	- ~~0xE~~ - unknown, ~~found in 2DS only~~		- L = LVDS
	- ~~0x0~~ - ~~unknown~~, ~~found in old3DS~~ (~~non-XL~~) ~~only~~		- E = unknown coating type
			- 38 = model number
			- P = unknow suffix
			- LS030Q7DW48P (bottom screen)
			- LS = TFT (LTPS or SI-TFT ?)
			- 030 = panel 3 inches diagonal
			- Q = QVGA (320x240)
			- 7 = unknown backing type
			- D = parallel RGB (unspecified, but it's known to be RGB888 for this display)
			- W = unknown coating type
			- 48 = model number
			- P = unknow suffix
			- 0x00 - no controller, or dead (I2CLCD always ACKs reads, but returns 00 if dead)
	\|}		\|}


	=== Custom registers for controller 0x00 ===		=== Custom registers for controller 0x00 ===

MarcusD: finally correct this awful misinformation. also make the formatting slightly better

2023-10-28T16:54:11Z

finally correct this awful misinformation. also make the formatting slightly better

← Older revision		Revision as of 20:54, 28 October 2023
Line 342:		Line 342:
	\| ro		\| ro
	\| Flags: bit7-5 are read via [[MCU_Services\|mcu::GPU]]. The rest of them are read via [[MCU_Services\|mcu::RTC]].		\| Flags: bit7-5 are read via [[MCU_Services\|mcu::GPU]]. The rest of them are read via [[MCU_Services\|mcu::RTC]].
	~~bit01~~: ShellState		bit1: ShellState
	~~bit03~~: AdapterState		bit3: AdapterState
	~~bit04~~: BatteryChargeState		bit4: BatteryChargeState
	~~bit05~~: Bottom screen backlight on		bit5: Bottom screen backlight on
	~~bit06~~: Top screen backlight on		bit6: Top screen backlight on
	~~bit07~~: ~~GPU~~ on~~(?)~~		bit7: LCD panel voltage on
	\|-		\|-
	\| 0x10		\| 0x10
Line 442:		Line 442:
	\| d		\| d
	\| wo		\| wo
	\| Used to ~~set~~ LCD ~~states~~		\| Used to turn on or turn off LCD-related boost circuits. Bits 5:2 can be read back so see whether backlight setting is in progress or not, however bits 1:0 get cleared as soon as the request gets acknowledged.
	bit0: ~~don't push to LCDs~~		bit0: LCD panel voltage off
	bit1: ~~push to LCDs~~		bit1: LCD panel voltage on
	bit2: ~~bottom~~ screen backlight off		bit2: Bottom screen backlight off
	bit3: ~~bottom~~ screen backlight on		bit3: Bottom screen backlight on
	bit4: ~~top~~ screen backlight off		bit4: Top screen backlight off
	bit5: ~~top~~ screen backlight on		bit5: Top screen backlight on

	Bits 4 and 5 have no effect on a 2DS because the backlight source is the bottom screen.		Bits 4 and 5 have no effect on a 2DS because the backlight source is the bottom screen.