Difference between revisions of "LCD Registers"

From 3dbrew
Jump to navigation Jump to search
m (Generalize naming)
 
(32 intermediate revisions by 12 users not shown)
Line 1: Line 1:
== Registers ==
+
Other registers that used to be documented on this page are now at [[GPU Registers]].
 +
 
 +
= Registers =
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  NAME
 
!  NAME
Line 7: Line 9:
 
!  WIDTH
 
!  WIDTH
 
|-
 
|-
| REG_LCDCOLORFILLMAIN
+
| Parallax barrier enable
| 0x10202204
+
| 0x10202000
| 0x1ED02204
+
| 0x1ED02000
| 0xFFFD6204
+
| 0xFFFD6000
| 4
+
| 0x4
 
|-
 
|-
| REG_LCDCOLORFILLSUB
+
| Parallax barrier PWM
| 0x10202A04
+
| 0x10202004
| 0x1ED02A04
+
| 0x1ED02004
| 0xFFFD6A04
+
| 0xFFFD6004
| 4
+
| 0x4
 +
|-
 +
| LCD status
 +
| 0x10202008
 +
| 0x1ED02008
 +
| 0xFFFD6008
 +
| 0x4
 +
|-
 +
| LCD clock disable
 +
| 0x1020200C
 +
| 0x1ED0200C
 +
| 0xFFFD600C
 +
| 0x4
 +
|-
 +
| ?
 +
| 0x10202010
 +
| 0x1ED02010
 +
| 0xFFFD6010
 +
| 0x4
 +
|-
 +
| LCD reset
 +
| 0x10202014
 +
| 0x1ED02014
 +
| 0xFFFD6014
 +
| 0x4
 +
|-
 +
| Top Screen [[#LCD Configuration|LCD Configuration]]
 +
| 0x10202200
 +
| 0x1ED02200
 +
| 0xFFFD6200
 +
| 0x600
 +
|-
 +
| Bottom Screen [[#LCD Configuration|LCD Configuration]]
 +
| 0x10202A00
 +
| 0x1ED02A00
 +
| 0xFFFD6A00
 +
| 0x600
 +
|-
 +
| ?
 +
| 0x10203200
 +
| 0x1ED03200
 +
| 0xFFFD7200
 +
| 0x40
 
|}
 
|}
  
REG_*MAIN registers are used for the top LCD, while SUB is used for the bottom LCD. The registers for the main LCD is located at 0x1EF00400, while the sub LCD registers are located at 0x1EF00500.
+
On screen-init (error screen), Boot11 sets 0x10202004 to 0xA390A39.
  
== REG_LCDCOLORFILL ==
+
== LCD Configuration ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Bit
+
Offset
 +
!  Size
 
!  Description
 
!  Description
 
|-
 
|-
| 7-0
+
| 0x00
| Red component intensity
+
| 0x4
 +
| [[#Flags|Flags]]
 +
|-
 +
| 0x04
 +
| 0x4
 +
| [[#Fill Color|Fill Color]]
 +
|-
 +
| 0x10
 +
| 0x10
 +
| [[#ABL Area|ABL Area]]
 +
|-
 +
| 0x20
 +
| 0x4
 +
| GTH Ratio
 +
|-
 +
| 0x24
 +
| 0x4
 +
| Min GTH
 +
|-
 +
| 0x28
 +
| 0x4
 +
| MinMax
 +
|-
 +
| 0x2C
 +
| 0x4
 +
| ExMax
 +
|-
 +
| 0x30
 +
| 0x4
 +
| Inertia
 +
|-
 +
| 0x38
 +
| 0x4
 +
| MinRS
 +
|-
 +
| 0x3C
 +
| 0x4
 +
| MaxRS
 +
|-
 +
| 0x40
 +
| 0x4
 +
| [[#Backlight Level|Backlight Level]]
 +
|-
 +
| 0x44
 +
| 0x4
 +
| [[#Backlight Interval|Backlight Interval]]
 +
|-
 +
| 0x60
 +
| 0x20
 +
| Dither
 
|-
 
|-
| 15-8
+
| 0x80
| Green component intensity
+
| 0x24
 +
| LutListRS
 
|-
 
|-
| 23-16
+
| 0xF0
| Blue component intensity
+
| 0x0C
 +
| ?
 
|-
 
|-
| 24
+
| 0x100
| Enable
+
| 0x100
 +
| LCD calibration data, pulled from nand:/ro/sys/HWCAL0.dat offset 0x77C.
 +
N3DS only. This area on old3DS is zero-filled and not writable.
 
|-
 
|-
| 31-25
+
| 0x200
 +
| 0x400
 
| ?
 
| ?
 
|}
 
|}
When the enable bit is set, the specified solid color is displayed on the LCD instead of the rendered graphics.
 
  
== 0x1EF00X5C ==
+
=== Flags ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
! Bit
+
! Bit
! Description
+
! Description
 +
|-
 +
| 0
 +
| ABL on
 
|-
 
|-
| 15-0
+
| 8
| Framebuffer width?
+
| ?
 
|-
 
|-
| 31-16
+
| 9
| Framebuffer height?
+
| ?
 
|}
 
|}
  
This register might control the framebuffer dimensions, however writing to this doesn't affect the displayed LCD image.
+
Bits 8 and 9 control dither.
  
== 0x1EF00X78 ==
+
=== Fill Color ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  Bit
 
!  Bit
 
!  Description
 
!  Description
 
|-
 
|-
| 0
+
| 7-0
| LCD framebuffer to display (0=first, 1=second)
+
| Red component intensity
 +
|-
 +
| 15-8
 +
| Green component intensity
 
|-
 
|-
| 7-1
+
| 23-16
| ?
+
| Blue component intensity
 
|-
 
|-
| 31-8
+
| 24
| Unused
+
| Enable
 
|}
 
|}
  
== 0x1EF00X90 ==
+
When the enable bit is set, the specified solid color is displayed on the LCD instead of the framebuffer.
 +
 
 +
=== ABL Area ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Bit
+
Offset
 
!  Description
 
!  Description
 
|-
 
|-
| 3-0
+
| 0x00
| ?
+
| X begin
 +
|-
 +
| 0x04
 +
| X end
 
|-
 
|-
| 11-4
+
| 0x08
| Controls the framebuffer width
+
| Y begin
 
|-
 
|-
| 31-12
+
| 0x0C
| ?
+
| Y end
 
|}
 
|}
  
== Framebuffers ==
+
The values refer to 90° clockwise rotated screens.
 +
 
 +
=== Backlight Level ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Address
+
Bit
 
!  Description
 
!  Description
 
|-
 
|-
| 0x1EF00468
+
| 9-0
| Main LCD, first framebuffer for 3D left
+
| Backlight PWM duty on (0 = off)
 +
|}
 +
 
 +
=== Backlight Interval ===
 +
{| class="wikitable" border="1"
 +
!  Bit
 +
!  Description
 
|-
 
|-
| 0x1EF0046C
+
| 9-0
| Main LCD, second framebuffer for 3D left
+
| Backlight PWM Interval, minus 1
 
|-
 
|-
| 0x1EF00494
+
| 16
| Main LCD, first framebuffer for 3D right
+
| Enable LCD (0 = disabled, 1 = enabled).
 
|-
 
|-
| 0x1EF00498
+
| 17
| Main LCD, second framebuffer for 3D right
+
| RS on (?)
 
|-
 
|-
| 0x1EF00568
+
| 18
| Sub LCD, first framebuffer
+
| ?
|-
 
| 0x1EF0056C
 
| Sub LCD, second framebuffer
 
|-
 
| 0x1EF00594
 
| Sub LCD, unused first framebuffer
 
|-
 
| 0x1EF00598
 
| Sub LCD, unused second framebuffer
 
 
|}
 
|}
  
The above framebuffer registers contains the physical address for each framebuffer, normally located in FCRAM in the application's GSP heap.
+
On old 2DS, disabling the top LCD does nothing, disabling the bottom LCD affects both screens.
 
+
Setting bit 18 makes the screen darker.
These LCD framebuffers normally contain the last rendered frames from the GPU. The color format is BGR8. The framebuffers are drawn from left-to-right, instead of top-to-bottom.(Thus the beginning of the framebuffer is drawn starting at the left side of the screen)
 
 
 
Both of the 3D screen left/right framebuffers are displayed regardless of the 3D slider's state, normally when the 3D slider's state is set to "off" the left/right framebuffer addresses are set to the same physical address.
 

Latest revision as of 14:12, 24 October 2023

Other registers that used to be documented on this page are now at GPU Registers.

Registers[edit]

NAME PHYSICAL ADDRESS PROCESS VIRTUAL ADDRESS KERNEL VIRTUAL ADDRESS WIDTH
Parallax barrier enable 0x10202000 0x1ED02000 0xFFFD6000 0x4
Parallax barrier PWM 0x10202004 0x1ED02004 0xFFFD6004 0x4
LCD status 0x10202008 0x1ED02008 0xFFFD6008 0x4
LCD clock disable 0x1020200C 0x1ED0200C 0xFFFD600C 0x4
? 0x10202010 0x1ED02010 0xFFFD6010 0x4
LCD reset 0x10202014 0x1ED02014 0xFFFD6014 0x4
Top Screen LCD Configuration 0x10202200 0x1ED02200 0xFFFD6200 0x600
Bottom Screen LCD Configuration 0x10202A00 0x1ED02A00 0xFFFD6A00 0x600
? 0x10203200 0x1ED03200 0xFFFD7200 0x40

On screen-init (error screen), Boot11 sets 0x10202004 to 0xA390A39.

LCD Configuration[edit]

Offset Size Description
0x00 0x4 Flags
0x04 0x4 Fill Color
0x10 0x10 ABL Area
0x20 0x4 GTH Ratio
0x24 0x4 Min GTH
0x28 0x4 MinMax
0x2C 0x4 ExMax
0x30 0x4 Inertia
0x38 0x4 MinRS
0x3C 0x4 MaxRS
0x40 0x4 Backlight Level
0x44 0x4 Backlight Interval
0x60 0x20 Dither
0x80 0x24 LutListRS
0xF0 0x0C ?
0x100 0x100 LCD calibration data, pulled from nand:/ro/sys/HWCAL0.dat offset 0x77C.

N3DS only. This area on old3DS is zero-filled and not writable.

0x200 0x400 ?

Flags[edit]

Bit Description
0 ABL on
8 ?
9 ?

Bits 8 and 9 control dither.

Fill Color[edit]

Bit Description
7-0 Red component intensity
15-8 Green component intensity
23-16 Blue component intensity
24 Enable

When the enable bit is set, the specified solid color is displayed on the LCD instead of the framebuffer.

ABL Area[edit]

Offset Description
0x00 X begin
0x04 X end
0x08 Y begin
0x0C Y end

The values refer to 90° clockwise rotated screens.

Backlight Level[edit]

Bit Description
9-0 Backlight PWM duty on (0 = off)

Backlight Interval[edit]

Bit Description
9-0 Backlight PWM Interval, minus 1
16 Enable LCD (0 = disabled, 1 = enabled).
17 RS on (?)
18 ?

On old 2DS, disabling the top LCD does nothing, disabling the bottom LCD affects both screens. Setting bit 18 makes the screen darker.