Difference between revisions of "Unit PL110"

Latest revision as of 03:45, 5 September 2023

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_CONTROL_LCDEN = (1 shl 0);`
`PL110_CLCD_CONTROL_LCDBPP1 = (0 shl 1);`	LCD bits per pixel: 000 = 1 bpp
`PL110_CLCD_CONTROL_LCDBPP2 = (1 shl 1);`	LCD bits per pixel: 001 = 2 bpp
`PL110_CLCD_CONTROL_LCDBPP4 = (2 shl 1);`	LCD bits per pixel: 010 = 4 bpp
`PL110_CLCD_CONTROL_LCDBPP8 = (3 shl 1);`	LCD bits per pixel: 011 = 8 bpp
`PL110_CLCD_CONTROL_LCDBPP16 = (4 shl 1);`	LCD bits per pixel: 100 = 16 bpp
`PL110_CLCD_CONTROL_LCDBPP16_565 = (6 shl 1);`	LCD bits per pixel: 110 = 16 bpp 565 (PL111 only)
`PL110_CLCD_CONTROL_LCDBPP16_444 = (7 shl 1);`	LCD bits per pixel: 111 = 16 bpp 444 (PL111 only)
`PL110_CLCD_CONTROL_LCDBPP24 = (5 shl 1);`	LCD bits per pixel: 101 = 24 bpp
`PL110_CLCD_CONTROL_LCDBW = (1 shl 4);`	STN LCD is monochrome (black and white) (0 = STN LCD is color/1 = STN LCD is monochrome)
`PL110_CLCD_CONTROL_LCDTFT = (1 shl 5);`	LCD is TFT (0 = LCD is an STN display, use gray scaler/1 = LCD is TFT, do not use gray scaler)
`PL110_CLCD_CONTROL_LCDMONO8 = (1 shl 6);`	Monochrome LCD has an 8-bit interface (0 = mono LCD uses 4-bit interface/1 = mono LCD uses 8-bit interface)
`PL110_CLCD_CONTROL_LCDDUAL = (1 shl 7);`	LCD interface is dual panel STN (0 = single panel LCD is in use/1 = dual panel LCD is in use)
`PL110_CLCD_CONTROL_BGR = (1 shl 8);`	RGB or BGR format selection (0 = RGB normal output/1 = BGR red and blue swapped.)
`PL110_CLCD_CONTROL_BEBO = (1 shl 9);`	Big-endian byte order (0 = little-endian byte order/1 = big-endian byte order)
`PL110_CLCD_CONTROL_BEPO = (1 shl 10);`	Big-endian pixel ordering within a byte (0 = little-endian pixel ordering within a byte/1= big-endian pixel ordering within a byte)
`PL110_CLCD_CONTROL_LCDPWR = (1 shl 11);`	LCD power enable
`PL110_CLCD_CONTROL_LCDVCOMP_VSYNC = (0 shl 12);`	Generate interrupt at: 00 = start of vertical synchronization
`PL110_CLCD_CONTROL_LCDVCOMP_BPORCH = (1 shl 12);`	Generate interrupt at: 01 = start of back porch
`PL110_CLCD_CONTROL_LCDVCOMP_VIDEO = (2 shl 12);`	Generate interrupt at: 10 = start of active video
`PL110_CLCD_CONTROL_LCDVCOMP_FPORCH = (3 shl 12);`	Generate interrupt at: 11 = start of front porch
`PL110_CLCD_CONTROL_LDMAFIFOTIME = (1 shl 15);`	Unknown
`PL110_CLCD_CONTROL_WATERMARK = (1 shl 16);`	LCD DMA FIFO Watermark level

[Expand]

PL110 control PL110_CONTROL_*

[Expand]

PL110 timing0 PL110_TIMING0_*

[Expand]

PL110 timing1 PL110_TIMING1_*

[Expand]

PL110 timing2 PL110_TIMING2_*

Type definitions

PL110 CLCD registers

[Expand]

PPL110CLCDRegisters = ^TPL110CLCDRegisters;

TPL110CLCDRegisters = record

PL110 framebuffer properties

[Expand]

PPL110Framebuffer = ^TPL110Framebuffer;

TPL110Framebuffer = record

Public variables

None defined

Function declarations

PL110 functions

[Expand]

function PL110FramebufferCreateVGA(Address:PtrUInt; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;

Description: Create, register and allocate a new PL110 Framebuffer device which can be accessed using the framebuffer API

[Expand]

function PL110FramebufferCreateSVGA(Address:PtrUInt; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;

Description: Create, register and allocate a new PL110 Framebuffer device which can be accessed using the framebuffer API

[Expand]

function PL110FramebufferDestroy(Framebuffer:PFramebufferDevice):LongWord;

Description: Release, deregister and destroy a PL110 Framebuffer device created by this driver

PL110 framebuffer functions

[Expand]

function PL110FramebufferAllocate(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;

Description: Implementation of FramebufferDeviceAllocate API for PL110 Framebuffer

[Expand]

function PL110FramebufferRelease(Framebuffer:PFramebufferDevice):LongWord;

Description: Implementation of FramebufferDeviceRelease API for PL110 Framebuffer

[Expand]

function PL110FramebufferBlank(Framebuffer:PFramebufferDevice; Blank:Boolean):LongWord;

Description: Implementation of FramebufferDevicBlank API for PL110 Framebuffer

[Expand]

function PL110FramebufferCommit(Framebuffer:PFramebufferDevice; Address:PtrUInt; Size,Flags:LongWord):LongWord;

Description: Implementation of FramebufferDeviceCommit API for PL110 Framebuffer

[Expand]

function PL110FramebufferSetOffsetEx(Framebuffer:PFramebufferDevice; X,Y:LongWord; Pan,Switch:Boolean):LongWord;

Description: Implementation of FramebufferDeviceSetOffsetEx API for PL110 Framebuffer

Return to Unit Reference

@@ Line 26: / Line 26: @@
 | <code>PL110_FRAMEBUFFER_DESCRIPTION = 'ARM PrimeCell PL110 Color LCD';</code>
 | Description of PL110 device
+|-
+|colspan="2"|&nbsp;
+|-
+| <code>PL110_MAX_PHYSICALWIDTH = 1024;</code>
+| &nbsp;
+|-
+| <code>PL110_MAX_PHYSICALHEIGHT = 1024;</code>
+| &nbsp;
 |-
 |}
@@ Line 264: / Line 272: @@
 |-
 | <code>PL110_CLCD_CONTROL_BGR = (1 shl 8);</code>
-| RGB of BGR format selection (0 = RGB normal output/1 = BGR red and blue swapped.)
+| RGB or BGR format selection (0 = RGB normal output/1 = BGR red and blue swapped.)
 |-
 | <code>PL110_CLCD_CONTROL_BEBO = (1 shl 9);</code>
@@ Line 366: / Line 374: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-|colspan="2"|Note: Layout of the PL110 registers (See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html)
+|colspan="2"|Note: Layout of the PL110 registers (See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I904421.html)
 |-
 | <code>TIMING0:LongWord;</code>
@@ Line 474: / Line 482: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCreateVGA(Address:LongWord; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;</pre>
+<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCreateVGA(Address:PtrUInt; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Create, register and allocate a new PL110 Framebuffer device which can be accessed using the framebuffer API</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Address'''
+! Address
 | The address of the PL110 registers
 |-
-! '''Name'''
+! Name
 | The text description of this device which will show in the device list (Optional)
 |-
-! '''Rotation'''
+! Rotation
 | The rotation value for the framebuffer device (eg FRAMEBUFFER_ROTATION_180)
 |-
-! '''Width'''
+! Width
 | The width of the framebuffer in pixels
 |-
-! '''Height'''
+! Height
 | The height of the framebuffer in pixels
 |-
-! '''Depth'''
+! Depth
 | The color depth (bits per pixel) for the framebuffer (eg FRAMEBUFFER_DEPTH_16)
 |-
-! '''Return'''
+! Return
 | Pointer to the new Framebuffer device or nil if the framebuffer device could not be created
 |-
@@ Line 504: / Line 512: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCreateSVGA(Address:LongWord; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;</pre>
+<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCreateSVGA(Address:PtrUInt; const Name:String; Rotation,Width,Height,Depth:LongWord):PFramebufferDevice;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Create, register and allocate a new PL110 Framebuffer device which can be accessed using the framebuffer API</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Address'''
+! Address
 | The address of the PL110 registers
 |-
-! '''Name'''
+! Name
 | The text description of this device which will show in the device list (Optional)
 |-
-! '''Rotation'''
+! Rotation
 | The rotation value for the framebuffer device (eg FRAMEBUFFER_ROTATION_180)
 |-
-! '''Width'''
+! Width
 | The width of the framebuffer in pixels
 |-
-! '''Height'''
+! Height
 | The height of the framebuffer in pixels
 |-
-! '''Depth'''
+! Depth
 | The color depth (bits per pixel) for the framebuffer (eg FRAMEBUFFER_DEPTH_16)
 |-
-! '''Return'''
+! Return
 | Pointer to the new Framebuffer device or nil if the framebuffer device could not be created
 |-
@@ Line 539: / Line 547: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Framebuffer'''
+! Framebuffer
 | The Framebuffer device to destroy
 |-
-! '''Return'''
+! Return
 | ERROR_SUCCESS if completed or another error code on failure
 |-
@@ Line 557: / Line 565: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use FramebufferDeviceAllocate instead
+| Not intended to be called directly by applications, use FramebufferDeviceAllocate instead.
 |-
 |}
@@ Line 569: / Line 577: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use FramebufferDeviceRelease instead
+| Not intended to be called directly by applications, use FramebufferDeviceRelease instead.
 |-
 |}
@@ Line 581: / Line 589: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use FramebufferDevicBlank instead
+| Not intended to be called directly by applications, use FramebufferDevicBlank instead.
 |-
 |}
@@ Line 588: / Line 596: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCommit(Framebuffer:PFramebufferDevice; Address,Size,Flags:LongWord):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferCommit(Framebuffer:PFramebufferDevice; Address:PtrUInt; Size,Flags:LongWord):LongWord;</pre>
 <div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceCommit API for PL110 Framebuffer</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use FramebufferDeviceCommit instead
+| Not intended to be called directly by applications, use FramebufferDeviceCommit instead.
-|-
-|}
-</div></div>
-<br />
-<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferSetOffset(Framebuffer:PFramebufferDevice; X,Y:LongWord; Pan:Boolean):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetOffset API for PL110 Framebuffer</div>
-<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
-{| class="wikitable" style="font-size: 14px; background: white;"
-|-
-! '''Note'''
-| Not intended to be called directly by applications, use FramebufferDeviceSetOffset instead
 |-
 |}
@@ Line 612: / Line 608: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
-<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferSetProperties(Framebuffer:PFramebufferDevice; Properties:PFramebufferProperties):LongWord;</pre>
+<pre style="border: 0; padding-bottom:0px;">function PL110FramebufferSetOffsetEx(Framebuffer:PFramebufferDevice; X,Y:LongWord; Pan,Switch:Boolean):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetProperties API for PL110 Framebuffer</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of FramebufferDeviceSetOffsetEx API for PL110 Framebuffer</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use FramebufferDeviceSetProperties instead
+| Not intended to be called directly by applications, use FramebufferDeviceSetOffsetEx instead.
 |-
 |}

`PL110_FRAMEBUFFER_DESCRIPTION = 'ARM PrimeCell PL110 Color LCD';`	Description of PL110 device

`PL110_MAX_PHYSICALWIDTH = 1024;`
`PL110_MAX_PHYSICALHEIGHT = 1024;`

`PL110_MODE_UNKNOWN = 0;`
`PL110_MODE_VGA = 1;`	Connected to a VGA display
`PL110_MODE_SVGA = 2;`	Connected to a SVGA display
`PL110_MODE_TFT = 3;`	Connected to a TFT display
`PL110_MODE_STN = 4;`	Connected to an STN display

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_TIMING0 = $00000000;`	Horizontal Axis Panel Control Register
`PL110_CLCD_TIMING1 = $00000004;`	Vertical Axis Panel Control Register
`PL110_CLCD_TIMING2 = $00000008;`	Clock and Signal Polarity Control Register
`PL110_CLCD_TIMING3 = $0000000c;`	Line End Control Register
`PL110_CLCD_UPBASE = $00000010;`	Upper Panel Frame Base Address Registers
`PL110_CLCD_LPBASE = $00000014;`	Lower Panel Frame Base Address Registers
`PL110_CLCD_CONTROL = $00000018;`	Control Register Note: Reversed in VersatilePB implementation, 0x0000001c in PL110 TRM
`PL110_CLCD_IMSC = $0000001c;`	Interrupt Mask Set/Clear Register Note: Reversed in VersatilePB implementation, 0x00000018 in PL110 TRM
`PL110_CLCD_RIS = $00000020;`	Raw Interrupt Status Register
`PL110_CLCD_MIS = $00000024;`	Masked Interrupt Status Register
`PL110_CLCD_ICR = $00000028;`	Interrupt Clear Register
`PL110_CLCD_UPCURR = $0000002C;`	Upper Panel Current Address Value Registers
`PL110_CLCD_LPCURR = $00000030;`	Lower Panel Current Address Value Registers
`PL110_CLCD_PALETTE = $00000200;`	Color Palette Register

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_TIMING0_HBP = ($FF shl 24);`	Horizontal back porch
`PL110_CLCD_TIMING0_HFP = ($FF shl 16);`	Horizontal front porch
`PL110_CLCD_TIMING0_HSW = ($FF shl 8);`	Horizontal synchronization pulse width
`PL110_CLCD_TIMING0_PPL = ($FC shl 2);`	Pixels-per-line (Actual pixels-per-line = 16 * (PPL + 1))

Difference between revisions of "Unit PL110"

Latest revision as of 03:45, 5 September 2023

Contents

Description

Constants

Type definitions

Public variables

Function declarations

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_TIMING1_VBP = ($FF shl 24);`	Vertical back porch
`PL110_CLCD_TIMING1_VFP = ($FF shl 16);`	Vertical front porch
`PL110_CLCD_TIMING1_VSW = ($FC shl 10);`	Vertical synchronization pulse width
`PL110_CLCD_TIMING1_LPP = ($3FF shl 0);`	Lines per panel is the number of active lines per screen (Program to number of lines required minus 1)

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_TIMING2_PCD_HI = ($1F shl 27);`	Upper five bits of Panel Clock Divisor
`PL110_CLCD_TIMING2_BCD = (1 shl 26);`	Bypass pixel clock divider
`PL110_CLCD_TIMING2_CPL = ($3FF shl 16);`	Clocks per line
`PL110_CLCD_TIMING2_IOE = (1 shl 14);`	Invert output enable
`PL110_CLCD_TIMING2_IPC = (1 shl 13);`	Invert panel clock
`PL110_CLCD_TIMING2_IHS = (1 shl 12);`	Invert horizontal synchron
`PL110_CLCD_TIMING2_IVS = (1 shl 11);`	Invert vertical synchronization
`PL110_CLCD_TIMING2_ACB = ($1F shl 6);`	AC bias pin frequency
`PL110_CLCD_TIMING2_CLKSEL = (1 shl 5);`	This bit drives the CLCDCLKSEL signal which is used as the select signal for the external LCD clock multiplexor
`PL110_CLCD_TIMING2_PCD_LO = ($1F shl 0);`	Lower five bits of Panel Clock Divisor

See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I913915.html

`PL110_CLCD_TIMING3_LEE = (1 shl 16);`	LCD Line end enable: 0 = CLLE disabled (held LOW)/1 = CLLE signal active
`PL110_CLCD_TIMING3_LED = ($3F shl 0);`	Line-end signal delay from the rising-edge of the last panel clock

`PL110_CONTROL_VGA = PL110_CLCD_CONTROL_LCDTFT or PL110_CLCD_CONTROL_LCDVCOMP_BPORCH;`
`PL110_CONTROL_SVGA = PL110_CLCD_CONTROL_LCDTFT or PL110_CLCD_CONTROL_LCDVCOMP_BPORCH;`

`PL110_TIMING0_VGA = $3F1F3F9C;`
`PL110_TIMING0_SVGA = $1313A4C4;`

`PL110_TIMING1_VGA = $090B61DF;`
`PL110_TIMING1_SVGA = $0505F657;`

`PL110_TIMING2_VGA = $067F1800;`
`PL110_TIMING2_SVGA = $071F1800;`

Note: Layout of the PL110 registers (See: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0161e/I904421.html)
`TIMING0:LongWord;`	Horizontal Axis Panel Control Register
`TIMING1:LongWord;`	Vertical Axis Panel Control Register
`TIMING2:LongWord;`	Clock and Signal Polarity Control Register
`TIMING3:LongWord;`	Line End Control Register
`UPBASE:LongWord;`	Upper Panel Frame Base Address Registers
`CONTROL:LongWord;`	Control Register Note: Reversed in VersatilePB implementation, 0x0000001c in PL110 TRM
`IMSC:LongWord;`	Interrupt Mask Set/Clear Register Note: Reversed in VersatilePB implementation, 0x00000018 in PL110 TRM
`RIS:LongWord;`	Raw Interrupt Status Register
`MIS:LongWord;`	Masked Interrupt Status Register
`ICR:LongWord;`	Interrupt Clear Register
`UPCURR:LongWord;`	Upper Panel Current Address Value Registers
`LPCURR:LongWord;`	Lower Panel Current Address Value Registers

Framebuffer Properties
`Framebuffer:TFramebufferDevice;`
PL110 Properties
`Mode:LongWord;`	PL110 framebuffer mode (eg PL110_MODE_TFT)
`Depth:LongWord;`	Framebuffer color depth (eg FRAMEBUFFER_DEPTH_16)
`Width:LongWord;`	Framebuffer width in pixels
`Height:LongWord;`	Framebuffer height in pixels
`Rotation:LongWord;`	Framebuffer rotation (eg FRAMEBUFFER_ROTATION_180)
Driver Properties
`Control:LongWord;`	Preset Control register value
`Timing0:LongWord;`	Preset Timing0 register value
`Timing1:LongWord;`	Preset Timing1 register value
`Timing2:LongWord;`	Preset Timing2 register value
`Timing3:LongWord;`	Preset Timing2 register value
`Registers:PPL110CLCDRegisters;`	PL110 registers

Address	The address of the PL110 registers
Name	The text description of this device which will show in the device list (Optional)
Rotation	The rotation value for the framebuffer device (eg FRAMEBUFFER_ROTATION_180)
Width	The width of the framebuffer in pixels
Height	The height of the framebuffer in pixels
Depth	The color depth (bits per pixel) for the framebuffer (eg FRAMEBUFFER_DEPTH_16)
Return	Pointer to the new Framebuffer device or nil if the framebuffer device could not be created

Framebuffer	The Framebuffer device to destroy
Return	ERROR_SUCCESS if completed or another error code on failure