Program SD Cards into 4-bit mode (support for this is required in the spec). This...
[mirror_edk2.git] / IntelFrameworkModulePkg / Library / PlatformBdsLibNull / BdsPlatform.c
CommitLineData
ddac74d1 1/** @file\r
2 This file include all platform action which can be customized by IBV/OEM.\r
3\r
180a5a35
HT
4Copyright (c) 2004 - 2008, Intel Corporation. All rights reserved.<BR>\r
5This program and the accompanying materials\r
ddac74d1 6are licensed and made available under the terms and conditions of the BSD License\r
7which accompanies this distribution. The full text of the license may be found at\r
8http://opensource.org/licenses/bsd-license.php\r
9\r
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15#include "BdsPlatform.h"\r
16\r
17//\r
18// BDS Platform Functions\r
19//\r
20/**\r
21 Platform Bds init. Include the platform firmware vendor, revision\r
22 and so crc check.\r
23\r
ddac74d1 24**/\r
25VOID\r
26EFIAPI\r
27PlatformBdsInit (\r
f7cdf5cd 28 VOID\r
ddac74d1 29 )\r
30{\r
ddac74d1 31}\r
32\r
33/**\r
34 Connect the predefined platform default console device. Always try to find\r
35 and enable the vga device if have.\r
36\r
37 @param PlatformConsole Predefined platform default console device array.\r
38\r
39 @retval EFI_SUCCESS Success connect at least one ConIn and ConOut\r
40 device, there must have one ConOut device is\r
41 active vga device.\r
42 @return Return the status of BdsLibConnectAllDefaultConsoles ()\r
43\r
44**/\r
45EFI_STATUS\r
46PlatformBdsConnectConsole (\r
47 IN BDS_CONSOLE_CONNECT_ENTRY *PlatformConsole\r
48 )\r
49{\r
50 return EFI_SUCCESS;\r
51}\r
52\r
53/**\r
54 Connect with predefined platform connect sequence,\r
55 the OEM/IBV can customize with their own connect sequence.\r
56**/\r
57VOID\r
58PlatformBdsConnectSequence (\r
59 VOID\r
60 )\r
61{\r
ddac74d1 62}\r
63\r
64/**\r
65 Load the predefined driver option, OEM/IBV can customize this\r
66 to load their own drivers\r
67\r
68 @param BdsDriverLists - The header of the driver option link list.\r
69\r
70**/\r
71VOID\r
72PlatformBdsGetDriverOption (\r
73 IN OUT LIST_ENTRY *BdsDriverLists\r
74 )\r
75{\r
ddac74d1 76}\r
77\r
78/**\r
79 Perform the platform diagnostic, such like test memory. OEM/IBV also\r
80 can customize this function to support specific platform diagnostic.\r
81\r
82 @param MemoryTestLevel The memory test intensive level\r
83 @param QuietBoot Indicate if need to enable the quiet boot\r
a798a789 84 @param BaseMemoryTest A pointer to BdsMemoryTest()\r
ddac74d1 85\r
86**/\r
87VOID\r
88PlatformBdsDiagnostics (\r
89 IN EXTENDMEM_COVERAGE_LEVEL MemoryTestLevel,\r
a798a789 90 IN BOOLEAN QuietBoot,\r
91 IN BASEM_MEMORY_TEST BaseMemoryTest\r
ddac74d1 92 )\r
93{\r
ddac74d1 94}\r
95\r
96/**\r
97 The function will execute with as the platform policy, current policy\r
98 is driven by boot mode. IBV/OEM can customize this code for their specific\r
99 policy action.\r
100\r
ddac74d1 101 @param DriverOptionList The header of the driver option link list\r
102 @param BootOptionList The header of the boot option link list\r
a798a789 103 @param ProcessCapsules A pointer to ProcessCapsules()\r
104 @param BaseMemoryTest A pointer to BaseMemoryTest()\r
ddac74d1 105\r
106**/\r
107VOID\r
108EFIAPI\r
109PlatformBdsPolicyBehavior (\r
ddac74d1 110 IN LIST_ENTRY *DriverOptionList,\r
a798a789 111 IN LIST_ENTRY *BootOptionList,\r
112 IN PROCESS_CAPSULES ProcessCapsules,\r
113 IN BASEM_MEMORY_TEST BaseMemoryTest\r
ddac74d1 114 )\r
115{\r
ddac74d1 116}\r
117\r
118/**\r
119 Hook point after a boot attempt succeeds. We don't expect a boot option to\r
120 return, so the UEFI 2.0 specification defines that you will default to an\r
121 interactive mode and stop processing the BootOrder list in this case. This\r
122 is also a platform implementation and can be customized by IBV/OEM.\r
123\r
124 @param Option Pointer to Boot Option that succeeded to boot.\r
125\r
126**/\r
127VOID\r
128EFIAPI\r
129PlatformBdsBootSuccess (\r
130 IN BDS_COMMON_OPTION *Option\r
131 )\r
132{\r
ddac74d1 133}\r
134\r
135/**\r
136 Hook point after a boot attempt fails.\r
137\r
138 @param Option Pointer to Boot Option that failed to boot.\r
139 @param Status Status returned from failed boot.\r
140 @param ExitData Exit data returned from failed boot.\r
141 @param ExitDataSize Exit data size returned from failed boot.\r
142\r
143**/\r
144VOID\r
145EFIAPI\r
146PlatformBdsBootFail (\r
147 IN BDS_COMMON_OPTION *Option,\r
148 IN EFI_STATUS Status,\r
149 IN CHAR16 *ExitData,\r
150 IN UINTN ExitDataSize\r
151 )\r
152{\r
ddac74d1 153}\r
154\r
155/**\r
156 This function is remained for IBV/OEM to do some platform action,\r
157 if there no console device can be connected.\r
158\r
159 @return EFI_SUCCESS Direct return success now.\r
160\r
161**/\r
162EFI_STATUS\r
163PlatformBdsNoConsoleAction (\r
164 VOID\r
165 )\r
166{\r
167 return EFI_SUCCESS;\r
168}\r
169\r
170/**\r
171 This function locks platform flash that is not allowed to be updated during normal boot path.\r
172 The flash layout is platform specific.\r
ddac74d1 173**/\r
63b67687 174VOID\r
ddac74d1 175EFIAPI\r
176PlatformBdsLockNonUpdatableFlash (\r
177 VOID\r
178 )\r
179{\r
63b67687
LG
180 return ;\r
181}\r
182\r
183\r
184/**\r
185 Lock the ConsoleIn device in system table. All key\r
186 presses will be ignored until the Password is typed in. The only way to\r
187 disable the password is to type it in to a ConIn device.\r
188\r
189 @param Password Password used to lock ConIn device.\r
190\r
191 @retval EFI_SUCCESS lock the Console In Spliter virtual handle successfully.\r
192 @retval EFI_UNSUPPORTED Password not found\r
193\r
194**/\r
195EFI_STATUS\r
196EFIAPI\r
197LockKeyboards (\r
198 IN CHAR16 *Password\r
199 )\r
200{\r
201 return EFI_UNSUPPORTED;\r
ddac74d1 202}\r