3dbrew

I2C Registers: Difference between revisions

← Older edit
MarcusD (talk | contribs)
Trusted
225 edits
Add more freshly discovered I2CLCD registers
MarcusD (talk | contribs)
Trusted
225 edits
Update info about battery middle pin and temperature reading
 
(13 intermediate revisions by 3 users not shown)
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 342: Line 354:
| 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 383: Line 395:
   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)
Line 442: Line 454:
| 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.
Line 704: Line 716:
   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 725: 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 (middle pin tied to GND)
      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: 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)
Line 834: Line 851:
| 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 863:
   - 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 ===
Line 885: Line 928:
| 0xF7
| 0xF7
| Regonfigures the input pins and pin behavior of the controller.
| Regonfigures the input pins and pin behavior of the controller.
bit0 - color value invert (D = ~D, or D = 255 - D)
bit1 - color format remap (D7:D2 <-- D5:D0, that is left shift color data by 2)
bit2 - ???
bit4 - ???
bit5 - ???
bit6 - ???
bit7 - DS-style undriven screen (it will be white instead of black, see shared register 0x01)
|-
|-
| 0x11
| 0x11
Line 890: Line 941:
| 0x7F
| 0x7F
| Image filters and pixel clock control.
| Image filters and pixel clock control.
bit0 - Horizontal Flip (scan from right to left)
bit1 - red-blue swap
bit2 - ???
bit3 - ???
bit4 - ???
bit5 - ???
bit6 - ???
|-
| 0x1D
| ???
| 0x0F
| Unknown, bit0 enables registers 0x12 to 0x19 to control some analog timing controls to the display panel itself.
|-
|-
| 0x50
| 0x50
Line 901: Line 965:
| Unknown. While other bits seem to have no effect, bit0 kills the controller until a power cycle.
| Unknown. While other bits seem to have no effect, bit0 kills the controller until a power cycle.
|}
|}


=== Custom registers for controller 0xC3 ===
=== Custom registers for controller 0xC3 ===
Line 929: Line 992:
|}
|}


Factory mode registers for unlock register 0x03:
{| class="wikitable" border="1"
!  Register
!  Name
!  Valid bits
!  Description
|-
| 0x10
| Image control?
| 0xD7
| Most bits are unknown.
bit0 - color invert
bit1 - slight gamma increase
|-
| 0x11
| Image transform?
| 0x7F
| Mostly unknown.
bit0 - Invert horizontal scan direction (0 = left to right, 1 = right to left)
bit1 - red-blue swap
bit2 - Invert vertical scan direction (0 = top to bottom, 1 = bottom to top)
bit3 - Invert the order of each scanline pair (might be needed if bit2 is toggled)
bit4 - Enable interlaced signal (use bit3 to swap fields)
bit5 - ???
bit6 - ???
|-
| 0x70-0x83
| Color curve red
| rowspan=3 |
| rowspan=3 | These registers are used for fine-tuning the analog driving curve of the screen
Positive:
- byte 00 (0xFF) - ???
- byte 01 (0xFF) - ???
- byte 02 (0x3F) - ???
- byte 03 (0x3F) - ???
- byte 04 (0x3F) - ???
- byte 05 (0x3F) - ???
- byte 06 (0x3F) - ???
- byte 07 (0x3F) - ???
- byte 08 (0x3F) - ???
- byte 09 (0x3F) - ???
Negative:
- byte 10 (0xFF) - ???
- byte 11 (0xFF) - ???
- byte 12 (0x3F) - ???
- byte 13 (0x3F) - ???
- byte 14 (0x3F) - ???
- byte 15 (0x3F) - ???
- byte 16 (0x3F) - ???
- byte 17 (0x3F) - ???
- byte 18 (0x3F) - ???
- byte 19 (0x3F) - ???
|-
| 0x84-0x97
| Color curve green
|-
| 0x98-0xAB
| Color curve blue
|}


=== Custom registers for controller 0xE1 ===
=== Custom registers for controller 0xE1 ===
Line 934: Line 1,059:


This is the only I2CLCD which responds on both I2CLCD addresses. The dominant screen is the bottom one.
This is the only I2CLCD which responds on both I2CLCD addresses. The dominant screen is the bottom one.
Most registers are similar to controller 0xC7, but there are some differences due to the split shared panel nature.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 952: Line 1,079:
|}
|}


Factory mode registers for unlock register 0x03:
{| class="wikitable" border="1"
!  Register
!  Name
!  Valid bits
!  Description
|-
| 0x10
| Image control?
| 0xD7
| Most bits are unknown. This applies to the whole display panel.
bit0 - color invert
bit1 - slight gamma increase
|-
| 0x11
| Image transform
| 0x33
|
bit0 - top half horizontal flip
bit1 - top half red-blue swap
bit4 - bottom half horizontal flip
bit5 - bottom half red-blue swap
|-
| 0x70-0x83
| Analog curve top
| rowspan=2 |
| rowspan=2 | Consists of two unknown curve values. Seems to be nonstandard.
Pair 1:
byte 00 (0xFF) - ???
byte 01 (0xFF) - ???
byte 02 (0xFF) - ???
byte 03 (0xFF) - ???
byte 04 (0x3F) - ???
byte 05 (0x3F) - ???
byte 06 (0x3F) - ???
byte 07 (0x3F) - ???
byte 08 (0x3F) - ???
byte 09 (0x3F) - ???
Part 2:
byte 10 (0xFF) - ???
byte 11 (0xFF) - ???
byte 12 (0xFF) - ???
byte 13 (0xFF) - ???
byte 14 (0x3F) - ???
byte 15 (0x3F) - ???
byte 16 (0x3F) - ???
byte 17 (0x3F) - ???
byte 18 (0x3F) - ???
byte 19 (0x3F) - ???
|-
| 0x84-0x97
| Analog curve bottom
|}


=== Custom registers for controller 0x10 ===
=== Custom registers for controller 0x10 ===
Line 1,189: Line 1,372:
| Firmware image for this chunk, size varies.
| 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.
| 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.
|}
== Device 17 ==
(Stub)
Used by New 3DS for ZL, ZR, C stick
This device do not use registers. After writing the address, read the next several bytes.
{| class="wikitable" border="1"
!  Offset
!  Description
|-
| 0x0
| Fixed 0x80
|-
| 0x1
| Buttons (ZL = 0x4, ZR = 0x2)
|}
|}
Retrieved from "https://www.3dbrew.org/wiki/I2C_Registers"