465cb6845437f57d15f05a271d1b01f634e11b56
[mirror_edk2.git] / ArmPlatformPkg / Library / PL111Lcd / PL111Lcd.c
1 /** @file
2 This file contains the platform independent parts of PL111Lcd
3
4 Copyright (c) 2011-2018, ARM Ltd. All rights reserved.<BR>
5
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
10
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
13
14 **/
15 #include <Library/DebugLib.h>
16 #include <Library/IoLib.h>
17 #include <Library/LcdHwLib.h>
18 #include <Library/LcdPlatformLib.h>
19 #include <Library/MemoryAllocationLib.h>
20
21 #include "PL111Lcd.h"
22
23 /** Check for presence of PL111.
24
25 @retval EFI_SUCCESS Returns success if platform implements a
26 PL111 controller.
27
28 @retval EFI_NOT_FOUND PL111 display controller not found the plaform.
29 **/
30 EFI_STATUS
31 LcdIdentify (
32 VOID
33 )
34 {
35 DEBUG ((EFI_D_WARN, "Probing ID registers at 0x%lx for a PL111\n",
36 PL111_REG_CLCD_PERIPH_ID_0));
37
38 // Check if this is a PL111
39 if (MmioRead8 (PL111_REG_CLCD_PERIPH_ID_0) == PL111_CLCD_PERIPH_ID_0 &&
40 MmioRead8 (PL111_REG_CLCD_PERIPH_ID_1) == PL111_CLCD_PERIPH_ID_1 &&
41 (MmioRead8 (PL111_REG_CLCD_PERIPH_ID_2) & 0xf) == PL111_CLCD_PERIPH_ID_2 &&
42 MmioRead8 (PL111_REG_CLCD_PERIPH_ID_3) == PL111_CLCD_PERIPH_ID_3 &&
43 MmioRead8 (PL111_REG_CLCD_P_CELL_ID_0) == PL111_CLCD_P_CELL_ID_0 &&
44 MmioRead8 (PL111_REG_CLCD_P_CELL_ID_1) == PL111_CLCD_P_CELL_ID_1 &&
45 MmioRead8 (PL111_REG_CLCD_P_CELL_ID_2) == PL111_CLCD_P_CELL_ID_2 &&
46 MmioRead8 (PL111_REG_CLCD_P_CELL_ID_3) == PL111_CLCD_P_CELL_ID_3) {
47 return EFI_SUCCESS;
48 }
49 return EFI_NOT_FOUND;
50 }
51
52 /** Initialize display.
53
54 @param[in] VramBaseAddress Address of the framebuffer.
55
56 @retval EFI_SUCCESS Initialization of display successful.
57 **/
58 EFI_STATUS
59 LcdInitialize (
60 IN EFI_PHYSICAL_ADDRESS VramBaseAddress
61 )
62 {
63 // Define start of the VRAM. This never changes for any graphics mode
64 MmioWrite32 (PL111_REG_LCD_UP_BASE, (UINT32)VramBaseAddress);
65 MmioWrite32 (PL111_REG_LCD_LP_BASE, 0); // We are not using a double buffer
66
67 // Disable all interrupts from the PL111
68 MmioWrite32 (PL111_REG_LCD_IMSC, 0);
69
70 return EFI_SUCCESS;
71 }
72
73 /** Set requested mode of the display.
74
75 @param[in] ModeNumbe Display mode number.
76
77 @retval EFI_SUCCESS Display mode set successfuly.
78 @retval !(EFI_SUCCESS) Other errors.
79
80 **/
81 EFI_STATUS
82 LcdSetMode (
83 IN UINT32 ModeNumber
84 )
85 {
86 EFI_STATUS Status;
87 UINT32 HRes;
88 UINT32 HSync;
89 UINT32 HBackPorch;
90 UINT32 HFrontPorch;
91 UINT32 VRes;
92 UINT32 VSync;
93 UINT32 VBackPorch;
94 UINT32 VFrontPorch;
95 UINT32 LcdControl;
96 LCD_BPP LcdBpp;
97
98 // Set the video mode timings and other relevant information
99 Status = LcdPlatformGetTimings (
100 ModeNumber,
101 &HRes,
102 &HSync,
103 &HBackPorch,
104 &HFrontPorch,
105 &VRes,
106 &VSync,
107 &VBackPorch,
108 &VFrontPorch
109 );
110 if (EFI_ERROR (Status)) {
111 ASSERT_EFI_ERROR (Status);
112 return Status;
113 }
114
115 Status = LcdPlatformGetBpp (ModeNumber, &LcdBpp);
116 if (EFI_ERROR (Status)) {
117 ASSERT_EFI_ERROR (Status);
118 return Status;
119 }
120
121 // Disable the CLCD_LcdEn bit
122 MmioAnd32 (PL111_REG_LCD_CONTROL, ~PL111_CTRL_LCD_EN);
123
124 // Set Timings
125 MmioWrite32 (
126 PL111_REG_LCD_TIMING_0,
127 HOR_AXIS_PANEL (HBackPorch, HFrontPorch, HSync, HRes)
128 );
129
130 MmioWrite32 (
131 PL111_REG_LCD_TIMING_1,
132 VER_AXIS_PANEL (VBackPorch, VFrontPorch, VSync, VRes)
133 );
134
135 MmioWrite32 (PL111_REG_LCD_TIMING_2, CLK_SIG_POLARITY (HRes));
136 MmioWrite32 (PL111_REG_LCD_TIMING_3, 0);
137
138 // PL111_REG_LCD_CONTROL
139 LcdControl = PL111_CTRL_LCD_EN | PL111_CTRL_LCD_BPP (LcdBpp) |
140 PL111_CTRL_LCD_TFT | PL111_CTRL_LCD_PWR | PL111_CTRL_BGR;
141 MmioWrite32 (PL111_REG_LCD_CONTROL, LcdControl);
142
143 return EFI_SUCCESS;
144 }
145
146 /** De-initializes the display.
147 */
148 VOID
149 LcdShutdown (
150 VOID
151 )
152 {
153 // Disable the controller
154 MmioAnd32 (PL111_REG_LCD_CONTROL, ~PL111_CTRL_LCD_EN);
155 }