I2C Services - Revision history

TimmSkiller: /* I2C Service Names */

2026-05-28T12:49:36Z

I2C Service Names

← Older revision		Revision as of 16:49, 28 May 2026
Line 22:		Line 22:
	\| "i2c::DEB"		\| "i2c::DEB"
	\| 7, 8		\| 7, 8
	\| ~~Unknown~~		\| dmnt
	\|-		\|-
	\| "i2c::HID"		\| "i2c::HID"

TimmSkiller at 14:48, 28 May 2026

2026-05-28T12:48:58Z

← Older revision		Revision as of 16:48, 28 May 2026
Line 1:		Line 1:
	[[Category:Services]]		[[Category:Services]]
			__FORCETOC__
	== I2C Service Names ==		== I2C Service Names ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"

TimmSkiller at 14:48, 28 May 2026

2026-05-28T12:48:17Z

← Older revision		Revision as of 16:48, 28 May 2026
Line 1:		Line 1:
	[[Category:Services]]		[[Category:Services]]
	= I2C Service Names =		== I2C Service Names ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 50:		Line 50:
	Each I2C service can only access certain I2C [[I2C_Registers\|device(s)]].		Each I2C service can only access certain I2C [[I2C_Registers\|device(s)]].

	= ~~I2C Service~~ =		== Commands ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 106:		Line 106:
	Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].		Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].

	= Common Result Values =		== Common Result Values ==
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-

TimmSkiller: Add common errors

2026-05-28T12:47:34Z

Add common errors

← Older revision		Revision as of 16:47, 28 May 2026
Line 48:		Line 48:
	\|}		\|}

	Each I2C service can only access certain I2C [[I2C_Registers\|device(s)]]~~. When the specified deviceid isn't accessible, error 0xE0A02FEA is returned~~.		Each I2C service can only access certain I2C [[I2C_Registers\|device(s)]].

	= I2C Service =		= I2C Service =
Line 105:		Line 105:

	Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].		Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].

			= Common Result Values =
			{\| class="wikitable" border="1"
			\|-
			! Result code !! Description
			\|-
			\| 0xE0A02FEA \|\| The current session is not permitted to access the specified device ID.
			\|-
			\| 0xF9602FEF \|\| Communication error. Device may not be connected.
			\|}

TimmSkiller: /* I2C Service Names */

2026-05-28T12:27:43Z

I2C Service Names

← Older revision		Revision as of 16:27, 28 May 2026
Line 4:		Line 4:
	\|-		\|-
	! Service names		! Service names
	! Accessible [[I2C_Registers\|deviceIDs]]		! Accessible [[I2C_Registers#I2C_Devices\|deviceIDs]]
	! Service used by sysmodule		! Service used by sysmodule
	\|-		\|-

TimmSkiller: /* I2C Service Names */

2026-05-28T12:07:25Z

I2C Service Names

← Older revision		Revision as of 16:07, 28 May 2026
Line 4:		Line 4:
	\|-		\|-
	! Service names		! Service names
	~~! Notes~~
	! Accessible [[I2C_Registers\|deviceIDs]]		! Accessible [[I2C_Registers\|deviceIDs]]
	! Service used by sysmodule		! Service used by sysmodule
	\|-		\|-
	\| "i2c::MCU"		\| "i2c::MCU"
	\|
	\| 0, 3		\| 0, 3
	\| [[MCU_Services\|MCU]]		\| [[MCU_Services\|MCU]]
	\|-		\|-
	\| "i2c::CAM"		\| "i2c::CAM"
	\|
	\| 1, 2, 4		\| 1, 2, 4
	\| [[Camera_Services\|Camera]]		\| [[Camera_Services\|Camera]]
	\|-		\|-
	\| "i2c::LCD"		\| "i2c::LCD"
	\|
	\| 5, 6		\| 5, 6
	\| [[GSP_Services\|GSP]]		\| [[GSP_Services\|GSP]]
	\|-		\|-
	\| "i2c::DEB"		\| "i2c::DEB"
	\|
	\| 7, 8		\| 7, 8
	\| Unknown		\| Unknown
	\|-		\|-
	\| "i2c::HID"		\| "i2c::HID"
	\|
	\| 9, 10, 11, 12		\| 9, 10, 11, 12
	\| [[HID_Services\|HID]]		\| [[HID_Services\|HID]]
	\|-		\|-
	\| "i2c::IR"		\| "i2c::IR"
	\|
	\| 13, and additionally for New3DS i2c module: 17		\| 13, and additionally for New3DS i2c module: 17
	\| [[IR_Services\|IR]]		\| [[IR_Services\|IR]]
	\|-		\|-
	\| "i2c::EEP"		\| "i2c::EEP"
	\|
	\| 14		\| 14
	\| [[Config_Services\|Cfg]]		\| [[Config_Services\|Cfg]]
			\|-
			\| colspan="3" \|
			New3DS-sysmodule specific services:

	\|-		\|-
	\| "i2c::NFC"		\| "i2c::NFC"
	~~\| Only available via the New3DS i2c sysmodule.~~
	\| 15		\| 15
	\| New3DS [[NFC_Services\|NFC]]		\| New3DS [[NFC_Services\|NFC]]
	\|-		\|-
	\| "i2c::QTM"		\| "i2c::QTM"
	~~\| Only available via the New3DS i2c sysmodule.~~
	\| 16		\| 16
	\| New3DS [[QTM_Services\|QTM]]		\| New3DS [[QTM_Services\|QTM]]

TimmSkiller: /* I2C Service */

2026-05-28T11:57:52Z

I2C Service

← Older revision		Revision as of 15:57, 28 May 2026
Line 96:		Line 96:
	\|-		\|-
	\| 0x001200C2 \|\| [[I2C:ReadRegistersBuffer8\|ReadRegistersBuffer8]] \|\| All		\| 0x001200C2 \|\| [[I2C:ReadRegistersBuffer8\|ReadRegistersBuffer8]] \|\| All
	\|}		\|-
			\| colspan="3" \|
	and, for the New3DS-specific version of the sysmodule (though technically the Old3DS supports these commands as well):		and, for the New3DS-specific version of the sysmodule (though technically the Old3DS supports these commands as well):
	~~{\| class="wikitable" border="1"~~
	\|-		\|-
	\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]		\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]

TimmSkiller: /* I2C Service */

2026-05-28T11:56:07Z

I2C Service

← Older revision		Revision as of 15:56, 28 May 2026
Line 96:		Line 96:
	\|-		\|-
	\| 0x001200C2 \|\| [[I2C:ReadRegistersBuffer8\|ReadRegistersBuffer8]] \|\| All		\| 0x001200C2 \|\| [[I2C:ReadRegistersBuffer8\|ReadRegistersBuffer8]] \|\| All
			\|}
			and, for the New3DS-specific version of the sysmodule (though technically the Old3DS supports these commands as well):
			{\| class="wikitable" border="1"
	\|-		\|-
	\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]		\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]
Line 104:		Line 107:
	\|}		\|}

	~~Commands 0x00130040..0x00150080 are only usable with the New3DS i2c module: on Old3DS the actual command-handler function for each of these commands just return an error.~~ Commands 0x00140082 and 0x00150080 are used by [[NFC_Services\|NFC]] module. Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].		Commands 0x00140082 and 0x00150080 are used by [[NFC_Services\|NFC]] module.

			Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].

TimmSkiller: Rename commands appropriately

2026-05-28T10:40:54Z

Rename commands appropriately

← Older revision		Revision as of 14:40, 28 May 2026
Line 61:		Line 61:
	! Command Header !! Description !! Available since system-version		! Command Header !! Description !! Available since system-version
	\|-		\|-
	\| 0x00010100 \|\| [[I2C:~~SetRegisterBits8~~\|~~SetRegisterBits8~~]] \|\| All		\| 0x00010100 \|\| [[I2C:ReplaceRegisterBits8\|ReplaceRegisterBits8]] \|\| All
	\|-		\|-
	\| 0x000200C0 \|\| [[I2C:~~EnableRegisterBits8~~\|~~EnableRegisterBits8~~]] \|\| All		\| 0x000200C0 \|\| [[I2C:SetRegisterBits8\|SetRegisterBits8]] \|\| All
	\|-		\|-
	\| 0x000300C0 \|\| [[I2C:~~DisableRegisterBits8~~\|~~DisableRegisterBits8~~]] \|\| All		\| 0x000300C0 \|\| [[I2C:ClearRegisterBits8\|ClearRegisterBits8]] \|\| All
	\|-		\|-
	\| 0x00040102 \|\| [[I2C:~~MultiSetRegisterBits16~~\|~~MultiSetRegisterBits16~~]] \|\| All		\| 0x00040102 \|\| [[I2C:MultiReplaceRegisterBits16\|MultiReplaceRegisterBits16]] \|\| All
	\|-		\|-
	\| 0x000500C0 \|\| [[I2C:WriteRegister8\|WriteRegister8]] \|\| All		\| 0x000500C0 \|\| [[I2C:WriteRegister8\|WriteRegister8]] \|\| All
	\|-		\|-
	\| 0x00060080 \|\| [[I2C:~~WriteCommand8~~\|~~WriteCommand8~~]] \|\| All		\| 0x00060080 \|\| [[I2C:WriteDeviceRaw8\|WriteDeviceRaw8]] \|\| All
	\|-		\|-
	\| 0x000700C0 \|\| [[I2C:WriteRegister16\|WriteRegister16]] \|\| All		\| 0x000700C0 \|\| [[I2C:WriteRegister16\|WriteRegister16]] \|\| All
Line 87:		Line 87:
	\| 0x000D00C0 \|\| [[I2C:ReadRegisters8\|ReadRegisters8]] \|\| All		\| 0x000D00C0 \|\| [[I2C:ReadRegisters8\|ReadRegisters8]] \|\| All
	\|-		\|-
	\| 0x000E00C2 \|\| [[I2C:~~WriteRegisterBuffer~~\|~~WriteRegisterBuffer~~]] \|\| All		\| 0x000E00C2 \|\| [[I2C:WriteRegisters8_2\|WriteRegisters8_2]] \|\| All
	\|-		\|-
	\| 0x000F00C0 \|\| [[I2C:~~ReadRegisterBuffer~~\|~~ReadRegisterBuffer~~]] \|\| All		\| 0x000F00C0 \|\| [[I2C:LegacyReadRegisters8\|LegacyReadRegisters8]] \|\| All
	\|-		\|-
	\| 0x001000C0 \|\| [[I2C:~~ReadEEPROM~~\|~~ReadEEPROM~~]] \|\| All		\| 0x001000C0 \|\| [[I2C:ReadRegisters16\|ReadRegisters16]] \|\| All
	\|-		\|-
	\| 0x001100C2 \|\| [[I2C:~~WriteRegisterBuffer~~\|~~WriteRegisterBuffer~~]] \|\| All		\| 0x001100C2 \|\| [[I2C:WriteRegistersBuffer8\|WriteRegistersBuffer8]] \|\| All
	\|-		\|-
	\| 0x001200C2 \|\| [[I2C:~~ReadRegisterBuffer~~\|~~ReadRegisterBuffer~~]] \|\| All		\| 0x001200C2 \|\| [[I2C:ReadRegistersBuffer8\|ReadRegistersBuffer8]] \|\| All
	\|-		\|-
	\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]		\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]

TimmSkiller: Rework table to link to command pages

2026-05-28T09:43:48Z

Rework table to link to command pages

← Older revision		Revision as of 13:43, 28 May 2026
Line 59:		Line 59:
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Command Header		! Command Header !! Description !! Available since system-version
	! Available since system-version
	~~! Description~~
	\|-		\|-
	\| 0x00010100		\| 0x00010100 \|\| [[I2C:SetRegisterBits8\|SetRegisterBits8]] \|\| All
	\|
	\| SetRegisterBits8 ~~(u8 devid, u8 regid, u8 regdata, u8 mask)~~
	\|-		\|-
	\| 0x000200C0		\| 0x000200C0 \|\| [[I2C:EnableRegisterBits8\|EnableRegisterBits8]] \|\| All
	\|
	\| EnableRegisterBits8 ~~(u8 devid, u8 regid, u8 enablemask)~~
	\|-		\|-
	\| 0x000300C0		\| 0x000300C0 \|\| [[I2C:DisableRegisterBits8\|DisableRegisterBits8]] \|\| All
	\|
	\| DisableRegisterBits8 ~~(u8 devid, u8 regid, u8 disablemask)~~
	\|-		\|-
	\| 0x00040102		\| 0x00040102 \|\| [[I2C:MultiSetRegisterBits16\|MultiSetRegisterBits16]] \|\| All
	\|
	\| MultiSetRegisterBits16 ~~(u16 regid, u16 regdata, u16 mask, devcount, u8* devidlistptr)~~
	\|-		\|-
	\| 0x000500C0		\| 0x000500C0 \|\| [[I2C:WriteRegister8\|WriteRegister8]] \|\| All
	\|
	\| WriteRegister8 ~~(u8 devid, u8 regid, u8 regdata)~~
	\|-		\|-
	\| 0x00060080		\| 0x00060080 \|\| [[I2C:WriteCommand8\|WriteCommand8]] \|\| All
	\|
	\| WriteCommand8 ~~(u8 devid, u8 cmdid)~~
	\|-		\|-
	\| 0x000700C0		\| 0x000700C0 \|\| [[I2C:WriteRegister16\|WriteRegister16]] \|\| All
	\|
	\| WriteRegister16 ~~(u8 devid, u8 regid, u16 regdata)~~
	\|-		\|-
	\| 0x000800C2		\| 0x000800C2 \|\| [[I2C:MultiWriteRegister16\|MultiWriteRegister16]] \|\| All
	\|
	\| MultiWriteRegister16 ~~(u16 regid, u16 regdata, devcount, u8* devidlistptr)~~
	\|-		\|-
	\| 0x00090080		\| 0x00090080 \|\| [[I2C:ReadRegister8\|ReadRegister8]] \|\| All
	\|
	\| u8 ReadRegister8 ~~(u8 devid, u8 regid)~~
	\|-		\|-
	\| 0x000A0080		\| 0x000A0080 \|\| [[I2C:ReadRegister16\|ReadRegister16]] \|\| All
	\|
	\| ~~u16~~ ReadRegister16 ~~(u8 devid, u8 regid)~~
	\|-		\|-
	\| 0x000B00C2		\| 0x000B00C2 \|\| [[I2C:WriteRegisters8\|WriteRegisters8]] \|\| All
	\|
	\| WriteRegisters8 ~~(u8 devid, u8 regid, buffersize, (buffersize << 14) <nowiki>~~\|~~</nowiki> 0x402, u8* bufferptr)~~
	\|-		\|-
	\| 0x000C00C2		\| 0x000C00C2 \|\| [[I2C:WriteRegisters16\|WriteRegisters16]] \|\| All
	\|
	\| WriteRegisters16 ~~(u8 devid, u16 regid, buffersize, (buffersize << 15) <nowiki>~~\|~~</nowiki> 0x402, u16* bufferptr)~~
	\|-		\|-
	\| 0x000D00C0		\| 0x000D00C0 \|\| [[I2C:ReadRegisters8\|ReadRegisters8]] \|\| All
	\|
	\| ReadRegisters8 ~~(u8 devid, u8 regid, buffersize, +0x180: (buffersize << 14) <nowiki>~~\|~~</nowiki> 2, +0x184: u8 bufferptr)~~
	\|-		\|-
	\| 0x000E00C2		\| 0x000E00C2 \|\| [[I2C:WriteRegisterBuffer\|WriteRegisterBuffer]] \|\| All
	\|
	\| WriteRegisterBuffer ~~(u8 devid, u8 regid, unused (bufsize?), (bufsize << 14) <nowiki>~~\|~~</nowiki> 0x402, void* buffer)~~
	\|-		\|-
	\| 0x000F00C0		\| 0x000F00C0 \|\| [[I2C:ReadRegisterBuffer\|ReadRegisterBuffer]] \|\| All
	\|
	\| ReadRegisterBuffer ~~(u8 devid, u8 regid, min(bufsize, 0x20)), +0x180: (bufsize << 14) <nowiki>~~\|~~</nowiki> 2, void* buffer~~
	\|-		\|-
	\| 0x001000C0		\| 0x001000C0 \|\| [[I2C:ReadEEPROM\|ReadEEPROM]] \|\| All
	\|
	\| ReadEEPROM ~~(u8 devid = 14, u16 blockid, min(bufsize >> 1, 0x10)), +0x180: (bufsize << 15) <nowiki>~~\|~~</nowiki> 2, u16* buffer~~
	\|-		\|-
	\| 0x001100C2		\| 0x001100C2 \|\| [[I2C:WriteRegisterBuffer\|WriteRegisterBuffer]] \|\| All
	\|
	\| WriteRegisterBuffer~~(u8 devid, u8 regid, buffersize, u8 *buff)~~
	\|-		\|-
	\| 0x001200C2		\| 0x001200C2 \|\| [[I2C:ReadRegisterBuffer\|ReadRegisterBuffer]] \|\| All
	\|
	\| ReadRegisterBuffer~~(u8 devid, u8 regid, buffersize, u8 *buff)~~
	\|-		\|-
	\| 0x00130040		\| 0x00130040 \|\| [[I2C:ReadDeviceRaw8\|ReadDeviceRaw8]] \|\| [[8.0.0-18]]
	\| [[8.0.0-18]]
	\| ReadDeviceRaw8(u8 devid) Writes the output read u8 I2C data to cmdreply[2]. After successfully selecting the I2C device, it writes 0xE1 to CNT then loads the output u8 I2C data from the DATA register.
	\|-		\|-
	\| 0x00140082		\| 0x00140082 \|\| [[I2C:WriteDeviceRaw\|WriteDeviceRaw]] \|\| [[8.0.0-18]]
	\| [[8.0.0-18]]
	~~\| WriteDeviceRaw(u8 devid, u32 buffersize, (buffersize << 14) <nowiki>\|</nowiki> 0x402, bufferptr) This is basically the write-data version of command 0x00150080.~~
	\|-		\|-
	\| 0x00150080		\| 0x00150080 \|\| [[I2C:ReadDeviceRaw\|ReadDeviceRaw]] \|\| [[8.0.0-18]]
	\| [[8.0.0-18]]
	\| ReadDeviceRaw(u8 devid, u32 buffersize, +0x180: (buffersize << 14) <nowiki>\|</nowiki> 2, +0x184: bufferptr) This is the >1-byte version of command 0x00130040, except value 0xF0 is used for CNT instead of 0xE1.
	\|}		\|}

	Commands 0x00130040..0x00150080 are only usable with the New3DS i2c module: on Old3DS the actual command-handler function for each of these commands just return an error. Commands 0x00140082 and 0x00150080 are used by [[NFC_Services\|NFC]] module. Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].		Commands 0x00130040..0x00150080 are only usable with the New3DS i2c module: on Old3DS the actual command-handler function for each of these commands just return an error. Commands 0x00140082 and 0x00150080 are used by [[NFC_Services\|NFC]] module. Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by [[IR Services]].