I2C Services: Difference between revisions

From 3dbrew
Jump to navigation Jump to search
← Older editNewer edit →
No edit summary
TimmSkiller (talk | contribs)
Trusted
828 edits
Rework table to link to command pages
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]].

Revision as of 13:43, 28 May 2026

I2C Service Names

Service names Notes Accessible deviceIDs Service used by sysmodule
"i2c::MCU" 0, 3 MCU
"i2c::CAM" 1, 2, 4 Camera
"i2c::LCD" 5, 6 GSP
"i2c::DEB" 7, 8 Unknown
"i2c::HID" 9, 10, 11, 12 HID
"i2c::IR" 13, and additionally for New3DS i2c module: 17 IR
"i2c::EEP" 14 Cfg
"i2c::NFC" Only available via the New3DS i2c sysmodule. 15 New3DS NFC
"i2c::QTM" Only available via the New3DS i2c sysmodule. 16 New3DS QTM

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

I2C Service

Command Header Description Available since system-version
0x00010100 SetRegisterBits8 All
0x000200C0 EnableRegisterBits8 All
0x000300C0 DisableRegisterBits8 All
0x00040102 MultiSetRegisterBits16 All
0x000500C0 WriteRegister8 All
0x00060080 WriteCommand8 All
0x000700C0 WriteRegister16 All
0x000800C2 MultiWriteRegister16 All
0x00090080 ReadRegister8 All
0x000A0080 ReadRegister16 All
0x000B00C2 WriteRegisters8 All
0x000C00C2 WriteRegisters16 All
0x000D00C0 ReadRegisters8 All
0x000E00C2 WriteRegisterBuffer All
0x000F00C0 ReadRegisterBuffer All
0x001000C0 ReadEEPROM All
0x001100C2 WriteRegisterBuffer All
0x001200C2 ReadRegisterBuffer All
0x00130040 ReadDeviceRaw8 8.0.0-18
0x00140082 WriteDeviceRaw 8.0.0-18
0x00150080 ReadDeviceRaw 8.0.0-18

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 module. Command 0x00150080 is also used for reading ZL, ZR, and C-stick data by IR Services.

Retrieved from "https://www.3dbrew.org/w/index.php?title=I2C_Services&oldid=23784"