]>
Commit | Line | Data |
---|---|---|
bcecde14 | 1 | /** @file\r |
2 | \r | |
81c0d6e9 | 3 | Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>\r |
bcecde14 | 4 | \r |
5 | This program and the accompanying materials\r | |
6 | are licensed and made available under the terms and conditions\r | |
7 | of the BSD License which accompanies this distribution. The\r | |
8 | full text of the license may be found at\r | |
9 | http://opensource.org/licenses/bsd-license.php\r | |
10 | \r | |
11 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
12 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
13 | \r | |
14 | **/\r | |
15 | \r | |
16 | #ifndef _LEGACY_BIOS_INTERFACE_\r | |
17 | #define _LEGACY_BIOS_INTERFACE_\r | |
18 | \r | |
19 | \r | |
20 | #include <FrameworkDxe.h>\r | |
21 | \r | |
22 | #include <Guid/SmBios.h>\r | |
23 | #include <Guid/Acpi.h>\r | |
24 | #include <Guid/DxeServices.h>\r | |
25 | #include <Guid/LegacyBios.h>\r | |
26 | #include <Guid/StatusCodeDataTypeId.h>\r | |
0f8b0298 | 27 | #include <Guid/ImageAuthentication.h>\r |
bcecde14 | 28 | \r |
29 | #include <Protocol/BlockIo.h>\r | |
30 | #include <Protocol/LoadedImage.h>\r | |
31 | #include <Protocol/PciIo.h>\r | |
32 | #include <Protocol/Cpu.h>\r | |
f767f990 | 33 | #include <Protocol/Timer.h>\r |
bcecde14 | 34 | #include <Protocol/IsaIo.h>\r |
35 | #include <Protocol/LegacyRegion2.h>\r | |
36 | #include <Protocol/SimpleTextIn.h>\r | |
37 | #include <Protocol/LegacyInterrupt.h>\r | |
38 | #include <Protocol/LegacyBios.h>\r | |
39 | #include <Protocol/DiskInfo.h>\r | |
40 | #include <Protocol/GenericMemoryTest.h>\r | |
41 | #include <Protocol/LegacyBiosPlatform.h>\r | |
42 | #include <Protocol/DevicePath.h>\r | |
43 | #include <Protocol/Legacy8259.h>\r | |
44 | #include <Protocol/PciRootBridgeIo.h>\r | |
bcecde14 | 45 | \r |
46 | #include <Library/BaseLib.h>\r | |
47 | #include <Library/DebugLib.h>\r | |
48 | #include <Library/UefiLib.h>\r | |
49 | #include <Library/BaseMemoryLib.h>\r | |
50 | #include <Library/ReportStatusCodeLib.h>\r | |
51 | #include <Library/UefiRuntimeServicesTableLib.h>\r | |
52 | #include <Library/HobLib.h>\r | |
53 | #include <Library/UefiDriverEntryPoint.h>\r | |
54 | #include <Library/MemoryAllocationLib.h>\r | |
55 | #include <Library/UefiBootServicesTableLib.h>\r | |
56 | #include <Library/IoLib.h>\r | |
57 | #include <Library/PcdLib.h>\r | |
58 | #include <Library/DevicePathLib.h>\r | |
59 | #include <Library/DxeServicesTableLib.h>\r | |
60 | #include <Library/PeCoffLib.h>\r | |
61 | #include <Library/CacheMaintenanceLib.h>\r | |
62 | #include <Library/DebugAgentLib.h>\r | |
63 | \r | |
64 | //\r | |
bcecde14 | 65 | // BUGBUG: This entry maybe changed to PCD in future and wait for\r |
66 | // redesign of BDS library\r | |
67 | //\r | |
68 | #define MAX_BBS_ENTRIES 0x100\r | |
69 | \r | |
70 | //\r | |
71 | // Thunk Status Codes\r | |
72 | // (These apply only to errors with the thunk and not to the code that was\r | |
73 | // thunked to.)\r | |
74 | //\r | |
75 | #define THUNK_OK 0x00\r | |
76 | #define THUNK_ERR_A20_UNSUP 0x01\r | |
77 | #define THUNK_ERR_A20_FAILED 0x02\r | |
78 | \r | |
79 | //\r | |
80 | // Vector base definitions\r | |
81 | //\r | |
82 | //\r | |
83 | // 8259 Hardware definitions\r | |
84 | //\r | |
85 | #define LEGACY_MODE_BASE_VECTOR_MASTER 0x08\r | |
86 | #define LEGACY_MODE_BASE_VECTOR_SLAVE 0x70\r | |
87 | \r | |
88 | //\r | |
89 | // The original PC used INT8-F for master PIC. Since these mapped over\r | |
90 | // processor exceptions TIANO moved the master PIC to INT68-6F.\r | |
91 | //\r | |
92 | // The vector base for slave PIC is set as 0x70 for PC-AT compatibility.\r | |
93 | //\r | |
94 | #define PROTECTED_MODE_BASE_VECTOR_MASTER 0x68\r | |
95 | #define PROTECTED_MODE_BASE_VECTOR_SLAVE 0x70\r | |
96 | \r | |
81c0d6e9 | 97 | //\r |
98 | // When we call CSM16 functions, some CSM16 use es:[offset + 0xabcd] to get data passed from CSM32, \r | |
99 | // offset + 0xabcd could overflow which exceeds 0xFFFF which is invalid in real mode. \r | |
100 | // So this will keep offset as small as possible to avoid offset overflow in real mode. \r | |
101 | //\r | |
102 | #define NORMALIZE_EFI_SEGMENT(_Adr) (UINT16) (((UINTN) (_Adr)) >> 4)\r | |
103 | #define NORMALIZE_EFI_OFFSET(_Adr) (UINT16) (((UINT16) ((UINTN) (_Adr))) & 0xf)\r | |
104 | \r | |
bcecde14 | 105 | //\r |
106 | // Trace defines\r | |
107 | //\r | |
108 | //\r | |
109 | #define LEGACY_BDA_TRACE 0x000\r | |
110 | #define LEGACY_BIOS_TRACE 0x040\r | |
111 | #define LEGACY_BOOT_TRACE 0x080\r | |
112 | #define LEGACY_CMOS_TRACE 0x0C0\r | |
113 | #define LEGACY_IDE_TRACE 0x100\r | |
114 | #define LEGACY_MP_TRACE 0x140\r | |
115 | #define LEGACY_PCI_TRACE 0x180\r | |
116 | #define LEGACY_SIO_TRACE 0x1C0\r | |
117 | \r | |
118 | #define LEGACY_PCI_TRACE_000 LEGACY_PCI_TRACE + 0x00\r | |
119 | #define LEGACY_PCI_TRACE_001 LEGACY_PCI_TRACE + 0x01\r | |
120 | #define LEGACY_PCI_TRACE_002 LEGACY_PCI_TRACE + 0x02\r | |
121 | #define LEGACY_PCI_TRACE_003 LEGACY_PCI_TRACE + 0x03\r | |
122 | #define LEGACY_PCI_TRACE_004 LEGACY_PCI_TRACE + 0x04\r | |
123 | #define LEGACY_PCI_TRACE_005 LEGACY_PCI_TRACE + 0x05\r | |
124 | #define LEGACY_PCI_TRACE_006 LEGACY_PCI_TRACE + 0x06\r | |
125 | #define LEGACY_PCI_TRACE_007 LEGACY_PCI_TRACE + 0x07\r | |
126 | #define LEGACY_PCI_TRACE_008 LEGACY_PCI_TRACE + 0x08\r | |
127 | #define LEGACY_PCI_TRACE_009 LEGACY_PCI_TRACE + 0x09\r | |
128 | #define LEGACY_PCI_TRACE_00A LEGACY_PCI_TRACE + 0x0A\r | |
129 | #define LEGACY_PCI_TRACE_00B LEGACY_PCI_TRACE + 0x0B\r | |
130 | #define LEGACY_PCI_TRACE_00C LEGACY_PCI_TRACE + 0x0C\r | |
131 | #define LEGACY_PCI_TRACE_00D LEGACY_PCI_TRACE + 0x0D\r | |
132 | #define LEGACY_PCI_TRACE_00E LEGACY_PCI_TRACE + 0x0E\r | |
133 | #define LEGACY_PCI_TRACE_00F LEGACY_PCI_TRACE + 0x0F\r | |
134 | \r | |
edf4af6f | 135 | #define BDA_VIDEO_MODE 0x49\r |
bcecde14 | 136 | \r |
137 | typedef struct {\r | |
138 | UINTN PciSegment;\r | |
139 | UINTN PciBus;\r | |
140 | UINTN PciDevice;\r | |
141 | UINTN PciFunction;\r | |
142 | UINT32 ShadowAddress;\r | |
143 | UINT32 ShadowedSize;\r | |
144 | UINT8 DiskStart;\r | |
145 | UINT8 DiskEnd;\r | |
146 | } ROM_INSTANCE_ENTRY;\r | |
147 | \r | |
148 | //\r | |
149 | // Values for RealModeGdt\r | |
150 | //\r | |
151 | #if defined (MDE_CPU_IA32)\r | |
152 | \r | |
153 | #define NUM_REAL_GDT_ENTRIES 3\r | |
154 | #define CONVENTIONAL_MEMORY_TOP 0xA0000 // 640 KB\r | |
155 | #define INITIAL_VALUE_BELOW_1K 0x0\r | |
156 | \r | |
157 | #elif defined (MDE_CPU_X64)\r | |
158 | \r | |
159 | #define NUM_REAL_GDT_ENTRIES 8\r | |
160 | #define CONVENTIONAL_MEMORY_TOP 0xA0000 // 640 KB\r | |
161 | #define INITIAL_VALUE_BELOW_1K 0x0\r | |
162 | \r | |
163 | #elif defined (MDE_CPU_IPF)\r | |
164 | \r | |
165 | #define NUM_REAL_GDT_ENTRIES 3\r | |
166 | #define CONVENTIONAL_MEMORY_TOP 0x80000 // 512 KB\r | |
167 | #define INITIAL_VALUE_BELOW_1K 0xff\r | |
168 | \r | |
169 | #endif\r | |
170 | \r | |
bcecde14 | 171 | #pragma pack(1)\r |
172 | \r | |
173 | //\r | |
174 | // Define what a processor GDT looks like\r | |
175 | //\r | |
176 | typedef struct {\r | |
177 | UINT32 LimitLo : 16;\r | |
178 | UINT32 BaseLo : 16;\r | |
179 | UINT32 BaseMid : 8;\r | |
180 | UINT32 Type : 4;\r | |
181 | UINT32 System : 1;\r | |
182 | UINT32 Dpl : 2;\r | |
183 | UINT32 Present : 1;\r | |
184 | UINT32 LimitHi : 4;\r | |
185 | UINT32 Software : 1;\r | |
186 | UINT32 Reserved : 1;\r | |
187 | UINT32 DefaultSize : 1;\r | |
188 | UINT32 Granularity : 1;\r | |
189 | UINT32 BaseHi : 8;\r | |
190 | } GDT32;\r | |
191 | \r | |
192 | typedef struct {\r | |
193 | UINT16 LimitLow;\r | |
194 | UINT16 BaseLow;\r | |
195 | UINT8 BaseMid;\r | |
196 | UINT8 Attribute;\r | |
197 | UINT8 LimitHi;\r | |
198 | UINT8 BaseHi;\r | |
199 | } GDT64;\r | |
200 | \r | |
201 | //\r | |
202 | // Define what a processor descriptor looks like\r | |
203 | // This data structure must be kept in sync with ASM STRUCT in Thunk.inc\r | |
204 | //\r | |
205 | typedef struct {\r | |
206 | UINT16 Limit;\r | |
207 | UINT64 Base;\r | |
208 | } DESCRIPTOR64;\r | |
209 | \r | |
210 | typedef struct {\r | |
211 | UINT16 Limit;\r | |
212 | UINT32 Base;\r | |
213 | } DESCRIPTOR32;\r | |
214 | \r | |
215 | //\r | |
216 | // Low stub lay out\r | |
217 | //\r | |
218 | #define LOW_STACK_SIZE (8 * 1024) // 8k?\r | |
219 | #define EFI_MAX_E820_ENTRY 100\r | |
220 | #define FIRST_INSTANCE 1\r | |
221 | #define NOT_FIRST_INSTANCE 0\r | |
222 | \r | |
223 | #if defined (MDE_CPU_IA32)\r | |
224 | typedef struct {\r | |
225 | //\r | |
226 | // Space for the code\r | |
227 | // The address of Code is also the beginning of the relocated Thunk code\r | |
228 | //\r | |
229 | CHAR8 Code[4096]; // ?\r | |
230 | //\r | |
231 | // The address of the Reverse Thunk code\r | |
232 | // Note that this member CONTAINS the address of the relocated reverse thunk\r | |
233 | // code unlike the member variable 'Code', which IS the address of the Thunk\r | |
234 | // code.\r | |
235 | //\r | |
236 | UINT32 LowReverseThunkStart;\r | |
237 | \r | |
238 | //\r | |
239 | // Data for the code (cs releative)\r | |
240 | //\r | |
241 | DESCRIPTOR32 GdtDesc; // Protected mode GDT\r | |
242 | DESCRIPTOR32 IdtDesc; // Protected mode IDT\r | |
243 | UINT32 FlatSs;\r | |
244 | UINT32 FlatEsp;\r | |
245 | \r | |
246 | UINT32 LowCodeSelector; // Low code selector in GDT\r | |
247 | UINT32 LowDataSelector; // Low data selector in GDT\r | |
248 | UINT32 LowStack;\r | |
249 | DESCRIPTOR32 RealModeIdtDesc;\r | |
250 | \r | |
251 | //\r | |
252 | // real-mode GDT (temporary GDT with two real mode segment descriptors)\r | |
253 | //\r | |
254 | GDT32 RealModeGdt[NUM_REAL_GDT_ENTRIES];\r | |
255 | DESCRIPTOR32 RealModeGdtDesc;\r | |
256 | \r | |
257 | //\r | |
258 | // Members specifically for the reverse thunk\r | |
259 | // The RevReal* members are used to store the current state of real mode\r | |
260 | // before performing the reverse thunk. The RevFlat* members must be set\r | |
261 | // before calling the reverse thunk assembly code.\r | |
262 | //\r | |
263 | UINT16 RevRealDs;\r | |
264 | UINT16 RevRealSs;\r | |
265 | UINT32 RevRealEsp;\r | |
266 | DESCRIPTOR32 RevRealIdtDesc;\r | |
267 | UINT16 RevFlatDataSelector; // Flat data selector in GDT\r | |
268 | UINT32 RevFlatStack;\r | |
269 | \r | |
270 | //\r | |
271 | // A low memory stack\r | |
272 | //\r | |
273 | CHAR8 Stack[LOW_STACK_SIZE];\r | |
274 | \r | |
275 | //\r | |
276 | // Stack for flat mode after reverse thunk\r | |
277 | // @bug - This may no longer be necessary if the reverse thunk interface\r | |
278 | // is changed to have the flat stack in a different location.\r | |
279 | //\r | |
280 | CHAR8 RevThunkStack[LOW_STACK_SIZE];\r | |
281 | \r | |
282 | //\r | |
283 | // Legacy16 Init memory map info\r | |
284 | //\r | |
285 | EFI_TO_COMPATIBILITY16_INIT_TABLE EfiToLegacy16InitTable;\r | |
286 | \r | |
287 | EFI_TO_COMPATIBILITY16_BOOT_TABLE EfiToLegacy16BootTable;\r | |
288 | \r | |
289 | CHAR8 InterruptRedirectionCode[32];\r | |
290 | EFI_LEGACY_INSTALL_PCI_HANDLER PciHandler;\r | |
291 | EFI_DISPATCH_OPROM_TABLE DispatchOpromTable;\r | |
292 | BBS_TABLE BbsTable[MAX_BBS_ENTRIES];\r | |
293 | } LOW_MEMORY_THUNK;\r | |
294 | \r | |
295 | #elif defined (MDE_CPU_X64)\r | |
296 | \r | |
297 | typedef struct {\r | |
298 | //\r | |
299 | // Space for the code\r | |
300 | // The address of Code is also the beginning of the relocated Thunk code\r | |
301 | //\r | |
302 | CHAR8 Code[4096]; // ?\r | |
303 | \r | |
304 | //\r | |
305 | // Data for the code (cs releative)\r | |
306 | //\r | |
307 | DESCRIPTOR64 X64GdtDesc; // Protected mode GDT\r | |
308 | DESCRIPTOR64 X64IdtDesc; // Protected mode IDT\r | |
309 | UINTN X64Ss;\r | |
310 | UINTN X64Esp;\r | |
311 | \r | |
312 | UINTN RealStack;\r | |
313 | DESCRIPTOR32 RealModeIdtDesc;\r | |
314 | DESCRIPTOR32 RealModeGdtDesc;\r | |
315 | \r | |
316 | //\r | |
317 | // real-mode GDT (temporary GDT with two real mode segment descriptors)\r | |
318 | //\r | |
319 | GDT64 RealModeGdt[NUM_REAL_GDT_ENTRIES];\r | |
320 | UINT64 PageMapLevel4;\r | |
321 | \r | |
322 | //\r | |
323 | // A low memory stack\r | |
324 | //\r | |
325 | CHAR8 Stack[LOW_STACK_SIZE];\r | |
326 | \r | |
327 | //\r | |
328 | // Legacy16 Init memory map info\r | |
329 | //\r | |
330 | EFI_TO_COMPATIBILITY16_INIT_TABLE EfiToLegacy16InitTable;\r | |
331 | \r | |
332 | EFI_TO_COMPATIBILITY16_BOOT_TABLE EfiToLegacy16BootTable;\r | |
333 | \r | |
334 | CHAR8 InterruptRedirectionCode[32];\r | |
335 | EFI_LEGACY_INSTALL_PCI_HANDLER PciHandler;\r | |
336 | EFI_DISPATCH_OPROM_TABLE DispatchOpromTable;\r | |
337 | BBS_TABLE BbsTable[MAX_BBS_ENTRIES];\r | |
338 | } LOW_MEMORY_THUNK;\r | |
339 | \r | |
340 | #elif defined (MDE_CPU_IPF)\r | |
341 | \r | |
342 | typedef struct {\r | |
343 | //\r | |
344 | // Space for the code\r | |
345 | // The address of Code is also the beginning of the relocated Thunk code\r | |
346 | //\r | |
347 | CHAR8 Code[4096]; // ?\r | |
348 | //\r | |
349 | // The address of the Reverse Thunk code\r | |
350 | // Note that this member CONTAINS the address of the relocated reverse thunk\r | |
351 | // code unlike the member variable 'Code', which IS the address of the Thunk\r | |
352 | // code.\r | |
353 | //\r | |
354 | UINT32 LowReverseThunkStart;\r | |
355 | \r | |
356 | //\r | |
357 | // Data for the code (cs releative)\r | |
358 | //\r | |
359 | DESCRIPTOR32 GdtDesc; // Protected mode GDT\r | |
360 | DESCRIPTOR32 IdtDesc; // Protected mode IDT\r | |
361 | UINT32 FlatSs;\r | |
362 | UINT32 FlatEsp;\r | |
363 | \r | |
364 | UINT32 LowCodeSelector; // Low code selector in GDT\r | |
365 | UINT32 LowDataSelector; // Low data selector in GDT\r | |
366 | UINT32 LowStack;\r | |
367 | DESCRIPTOR32 RealModeIdtDesc;\r | |
368 | \r | |
369 | //\r | |
370 | // real-mode GDT (temporary GDT with two real mode segment descriptors)\r | |
371 | //\r | |
372 | GDT32 RealModeGdt[NUM_REAL_GDT_ENTRIES];\r | |
373 | DESCRIPTOR32 RealModeGdtDesc;\r | |
374 | \r | |
375 | //\r | |
376 | // Members specifically for the reverse thunk\r | |
377 | // The RevReal* members are used to store the current state of real mode\r | |
378 | // before performing the reverse thunk. The RevFlat* members must be set\r | |
379 | // before calling the reverse thunk assembly code.\r | |
380 | //\r | |
381 | UINT16 RevRealDs;\r | |
382 | UINT16 RevRealSs;\r | |
383 | UINT32 RevRealEsp;\r | |
384 | DESCRIPTOR32 RevRealIdtDesc;\r | |
385 | UINT16 RevFlatDataSelector; // Flat data selector in GDT\r | |
386 | UINT32 RevFlatStack;\r | |
387 | \r | |
388 | //\r | |
389 | // A low memory stack\r | |
390 | //\r | |
391 | CHAR8 Stack[LOW_STACK_SIZE];\r | |
392 | \r | |
393 | //\r | |
394 | // Stack for flat mode after reverse thunk\r | |
395 | // @bug - This may no longer be necessary if the reverse thunk interface\r | |
396 | // is changed to have the flat stack in a different location.\r | |
397 | //\r | |
398 | CHAR8 RevThunkStack[LOW_STACK_SIZE];\r | |
399 | \r | |
400 | //\r | |
401 | // Legacy16 Init memory map info\r | |
402 | //\r | |
403 | EFI_TO_COMPATIBILITY16_INIT_TABLE EfiToLegacy16InitTable;\r | |
404 | \r | |
405 | EFI_TO_COMPATIBILITY16_BOOT_TABLE EfiToLegacy16BootTable;\r | |
406 | \r | |
407 | CHAR8 InterruptRedirectionCode[32];\r | |
408 | EFI_LEGACY_INSTALL_PCI_HANDLER PciHandler;\r | |
409 | EFI_DISPATCH_OPROM_TABLE DispatchOpromTable;\r | |
410 | BBS_TABLE BbsTable[MAX_BBS_ENTRIES];\r | |
411 | } LOW_MEMORY_THUNK;\r | |
412 | \r | |
413 | #endif\r | |
414 | \r | |
415 | //\r | |
416 | // PnP Expansion Header\r | |
417 | //\r | |
418 | typedef struct {\r | |
419 | UINT32 PnpSignature;\r | |
420 | UINT8 Revision;\r | |
421 | UINT8 Length;\r | |
422 | UINT16 NextHeader;\r | |
423 | UINT8 Reserved1;\r | |
424 | UINT8 Checksum;\r | |
425 | UINT32 DeviceId;\r | |
426 | UINT16 MfgPointer;\r | |
427 | UINT16 ProductNamePointer;\r | |
428 | UINT8 Class;\r | |
429 | UINT8 SubClass;\r | |
430 | UINT8 Interface;\r | |
431 | UINT8 DeviceIndicators;\r | |
432 | UINT16 Bcv;\r | |
433 | UINT16 DisconnectVector;\r | |
434 | UINT16 Bev;\r | |
435 | UINT16 Reserved2;\r | |
436 | UINT16 StaticResourceVector;\r | |
437 | } LEGACY_PNP_EXPANSION_HEADER;\r | |
438 | \r | |
439 | typedef struct {\r | |
440 | UINT8 PciSegment;\r | |
441 | UINT8 PciBus;\r | |
442 | UINT8 PciDevice;\r | |
443 | UINT8 PciFunction;\r | |
444 | UINT16 Vid;\r | |
445 | UINT16 Did;\r | |
446 | UINT16 SysSid;\r | |
447 | UINT16 SVid;\r | |
448 | UINT8 Class;\r | |
449 | UINT8 SubClass;\r | |
450 | UINT8 Interface;\r | |
451 | UINT8 Reserved;\r | |
452 | UINTN RomStart;\r | |
453 | UINTN ManufacturerString;\r | |
454 | UINTN ProductNameString;\r | |
455 | } LEGACY_ROM_AND_BBS_TABLE;\r | |
456 | \r | |
457 | //\r | |
458 | // Structure how EFI has mapped a devices HDD drive numbers.\r | |
459 | // Boot to EFI aware OS or shell requires this mapping when\r | |
460 | // 16-bit CSM assigns drive numbers.\r | |
461 | // This mapping is ignored booting to a legacy OS.\r | |
462 | //\r | |
463 | typedef struct {\r | |
464 | UINT8 PciSegment;\r | |
465 | UINT8 PciBus;\r | |
466 | UINT8 PciDevice;\r | |
467 | UINT8 PciFunction;\r | |
468 | UINT8 StartDriveNumber;\r | |
469 | UINT8 EndDriveNumber;\r | |
470 | } LEGACY_EFI_HDD_TABLE;\r | |
471 | \r | |
472 | //\r | |
473 | // This data is passed to Leacy16Boot\r | |
474 | //\r | |
475 | typedef enum {\r | |
476 | EfiAcpiAddressRangeMemory = 1,\r | |
477 | EfiAcpiAddressRangeReserved = 2,\r | |
478 | EfiAcpiAddressRangeACPI = 3,\r | |
479 | EfiAcpiAddressRangeNVS = 4\r | |
480 | } EFI_ACPI_MEMORY_TYPE;\r | |
481 | \r | |
482 | typedef struct {\r | |
483 | UINT64 BaseAddr;\r | |
484 | UINT64 Length;\r | |
485 | EFI_ACPI_MEMORY_TYPE Type;\r | |
486 | } EFI_E820_ENTRY64;\r | |
487 | \r | |
488 | typedef struct {\r | |
489 | UINT32 BassAddrLow;\r | |
490 | UINT32 BaseAddrHigh;\r | |
491 | UINT32 LengthLow;\r | |
492 | UINT32 LengthHigh;\r | |
493 | EFI_ACPI_MEMORY_TYPE Type;\r | |
494 | } EFI_E820_ENTRY;\r | |
495 | \r | |
496 | #pragma pack()\r | |
497 | \r | |
498 | extern BBS_TABLE *mBbsTable;\r | |
499 | \r | |
500 | extern EFI_GENERIC_MEMORY_TEST_PROTOCOL *gGenMemoryTest;\r | |
501 | \r | |
bcecde14 | 502 | #define PORT_70 0x70\r |
503 | #define PORT_71 0x71\r | |
504 | \r | |
505 | #define CMOS_0A 0x0a ///< Status register A\r | |
506 | #define CMOS_0D 0x0d ///< Status register D\r | |
507 | #define CMOS_0E 0x0e ///< Diagnostic Status\r | |
508 | #define CMOS_0F 0x0f ///< Shutdown status\r | |
509 | #define CMOS_10 0x10 ///< Floppy type\r | |
510 | #define CMOS_12 0x12 ///< IDE type\r | |
511 | #define CMOS_14 0x14 ///< Same as BDA 40:10\r | |
512 | #define CMOS_15 0x15 ///< Low byte of base memory in 1k increments\r | |
513 | #define CMOS_16 0x16 ///< High byte of base memory in 1k increments\r | |
514 | #define CMOS_17 0x17 ///< Low byte of 1MB+ memory in 1k increments - max 15 MB\r | |
515 | #define CMOS_18 0x18 ///< High byte of 1MB+ memory in 1k increments - max 15 MB\r | |
516 | #define CMOS_19 0x19 ///< C: extended drive type\r | |
517 | #define CMOS_1A 0x1a ///< D: extended drive type\r | |
518 | #define CMOS_2E 0x2e ///< Most significient byte of standard checksum\r | |
519 | #define CMOS_2F 0x2f ///< Least significient byte of standard checksum\r | |
520 | #define CMOS_30 0x30 ///< CMOS 0x17\r | |
521 | #define CMOS_31 0x31 ///< CMOS 0x18\r | |
522 | #define CMOS_32 0x32 ///< Century byte\r | |
523 | \r | |
f767f990 | 524 | //\r |
525 | // 8254 Timer registers\r | |
526 | //\r | |
527 | #define TIMER0_COUNT_PORT 0x40\r | |
528 | #define TIMER1_COUNT_PORT 0x41\r | |
529 | #define TIMER2_COUNT_PORT 0x42\r | |
530 | #define TIMER_CONTROL_PORT 0x43\r | |
531 | \r | |
532 | //\r | |
533 | // Timer 0, Read/Write LSB then MSB, Square wave output, binary count use.\r | |
534 | //\r | |
535 | #define TIMER0_CONTROL_WORD 0x36 \r | |
bcecde14 | 536 | \r |
537 | #define LEGACY_BIOS_INSTANCE_SIGNATURE SIGNATURE_32 ('L', 'B', 'I', 'T')\r | |
538 | typedef struct {\r | |
539 | UINTN Signature;\r | |
540 | \r | |
541 | EFI_HANDLE Handle;\r | |
542 | EFI_LEGACY_BIOS_PROTOCOL LegacyBios;\r | |
543 | \r | |
544 | EFI_HANDLE ImageHandle;\r | |
545 | \r | |
546 | //\r | |
547 | // CPU Architectural Protocol \r | |
548 | //\r | |
549 | EFI_CPU_ARCH_PROTOCOL *Cpu;\r | |
550 | \r | |
f767f990 | 551 | //\r |
552 | // Timer Architectural Protocol \r | |
553 | //\r | |
554 | EFI_TIMER_ARCH_PROTOCOL *Timer;\r | |
555 | BOOLEAN TimerUses8254; \r | |
556 | \r | |
bcecde14 | 557 | //\r |
558 | // Protocol to Lock and Unlock 0xc0000 - 0xfffff\r | |
559 | //\r | |
560 | EFI_LEGACY_REGION2_PROTOCOL *LegacyRegion;\r | |
561 | \r | |
562 | EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *LegacyBiosPlatform;\r | |
563 | \r | |
564 | //\r | |
565 | // Interrupt control for thunk and PCI IRQ\r | |
566 | //\r | |
567 | EFI_LEGACY_8259_PROTOCOL *Legacy8259;\r | |
f767f990 | 568 | \r |
bcecde14 | 569 | //\r |
570 | // PCI Interrupt PIRQ control\r | |
571 | //\r | |
572 | EFI_LEGACY_INTERRUPT_PROTOCOL *LegacyInterrupt;\r | |
573 | \r | |
574 | //\r | |
575 | // Generic Memory Test\r | |
576 | //\r | |
577 | EFI_GENERIC_MEMORY_TEST_PROTOCOL *GenericMemoryTest;\r | |
578 | \r | |
579 | //\r | |
580 | // TRUE if PCI Interupt Line registers have been programmed.\r | |
581 | //\r | |
582 | BOOLEAN PciInterruptLine;\r | |
583 | \r | |
584 | //\r | |
585 | // Code space below 1MB needed by thunker to transition to real mode.\r | |
586 | // Contains stack and real mode code fragments\r | |
587 | //\r | |
588 | LOW_MEMORY_THUNK *IntThunk;\r | |
589 | \r | |
590 | //\r | |
591 | // Starting shadow address of the Legacy BIOS\r | |
592 | //\r | |
593 | UINT32 BiosStart;\r | |
594 | UINT32 LegacyBiosImageSize;\r | |
595 | \r | |
596 | //\r | |
597 | // Start of variables used by CsmItp.mac ITP macro file and/os LegacyBios\r | |
598 | //\r | |
599 | UINT8 Dump[4];\r | |
600 | \r | |
601 | //\r | |
602 | // $EFI Legacy16 code entry info in memory < 1 MB;\r | |
603 | //\r | |
604 | EFI_COMPATIBILITY16_TABLE *Legacy16Table;\r | |
605 | VOID *Legacy16InitPtr;\r | |
606 | VOID *Legacy16BootPtr;\r | |
607 | VOID *InternalIrqRoutingTable;\r | |
608 | UINT32 NumberIrqRoutingEntries;\r | |
609 | VOID *BbsTablePtr;\r | |
610 | VOID *HddTablePtr;\r | |
611 | UINT32 NumberHddControllers;\r | |
612 | \r | |
613 | //\r | |
614 | // Cached copy of Legacy16 entry point\r | |
615 | //\r | |
616 | UINT16 Legacy16CallSegment;\r | |
617 | UINT16 Legacy16CallOffset;\r | |
618 | \r | |
619 | //\r | |
620 | // Returned from $EFI and passed in to OPROMS\r | |
621 | //\r | |
622 | UINT16 PnPInstallationCheckSegment;\r | |
623 | UINT16 PnPInstallationCheckOffset;\r | |
624 | \r | |
625 | //\r | |
626 | // E820 table\r | |
627 | //\r | |
628 | EFI_E820_ENTRY E820Table[EFI_MAX_E820_ENTRY];\r | |
629 | UINT32 NumberE820Entries;\r | |
630 | \r | |
631 | //\r | |
632 | // True if legacy VGA INT 10h handler installed\r | |
633 | //\r | |
634 | BOOLEAN VgaInstalled;\r | |
635 | \r | |
636 | //\r | |
637 | // Number of IDE drives\r | |
638 | //\r | |
639 | UINT8 IdeDriveCount;\r | |
640 | \r | |
641 | //\r | |
642 | // Current Free Option ROM space. An option ROM must NOT go past\r | |
643 | // BiosStart.\r | |
644 | //\r | |
645 | UINT32 OptionRom;\r | |
646 | \r | |
647 | //\r | |
648 | // Save Legacy16 unexpected interrupt vector. Reprogram INT 68-6F from\r | |
649 | // EFI values to legacy value just before boot.\r | |
650 | //\r | |
651 | UINT32 BiosUnexpectedInt;\r | |
652 | UINT32 ThunkSavedInt[8];\r | |
653 | UINT16 ThunkSeg;\r | |
654 | LEGACY_EFI_HDD_TABLE *LegacyEfiHddTable;\r | |
655 | UINT16 LegacyEfiHddTableIndex;\r | |
656 | UINT8 DiskEnd;\r | |
657 | UINT8 Disk4075;\r | |
658 | UINT16 TraceIndex;\r | |
659 | UINT16 Trace[0x200];\r | |
660 | \r | |
661 | //\r | |
662 | // Indicate that whether GenericLegacyBoot is entered or not\r | |
663 | //\r | |
664 | BOOLEAN LegacyBootEntered; \r | |
665 | \r | |
666 | //\r | |
667 | // CSM16 PCI Interface Version\r | |
668 | //\r | |
669 | UINT16 Csm16PciInterfaceVersion;\r | |
670 | \r | |
671 | } LEGACY_BIOS_INSTANCE;\r | |
672 | \r | |
673 | \r | |
674 | #pragma pack(1)\r | |
675 | \r | |
676 | /*\r | |
677 | 40:00-01 Com1\r | |
678 | 40:02-03 Com2\r | |
679 | 40:04-05 Com3\r | |
680 | 40:06-07 Com4\r | |
681 | 40:08-09 Lpt1\r | |
682 | 40:0A-0B Lpt2\r | |
683 | 40:0C-0D Lpt3\r | |
684 | 40:0E-0E Ebda segment\r | |
685 | 40:10-11 MachineConfig\r | |
686 | 40:12 Bda12 - skip\r | |
687 | 40:13-14 MemSize below 1MB\r | |
688 | 40:15-16 Bda15_16 - skip\r | |
689 | 40:17 Keyboard Shift status\r | |
690 | 40:18-19 Bda18_19 - skip\r | |
691 | 40:1A-1B Key buffer head\r | |
692 | 40:1C-1D Key buffer tail\r | |
693 | 40:1E-3D Bda1E_3D- key buffer -skip\r | |
694 | 40:3E-3F FloppyData 3E = Calibration status 3F = Motor status\r | |
695 | 40:40 FloppyTimeout\r | |
696 | 40:41-74 Bda41_74 - skip\r | |
697 | 40:75 Number of HDD drives\r | |
698 | 40:76-77 Bda76_77 - skip\r | |
699 | 40:78-79 78 = Lpt1 timeout, 79 = Lpt2 timeout\r | |
700 | 40:7A-7B 7A = Lpt3 timeout, 7B = Lpt4 timeout\r | |
701 | 40:7C-7D 7C = Com1 timeout, 7D = Com2 timeout\r | |
702 | 40:7E-7F 7E = Com3 timeout, 7F = Com4 timeout\r | |
703 | 40:80-81 Pointer to start of key buffer\r | |
704 | 40:82-83 Pointer to end of key buffer\r | |
705 | 40:84-87 Bda84_87 - skip\r | |
706 | 40:88 HDD Data Xmit rate\r | |
707 | 40:89-8f skip\r | |
708 | 40:90 Floppy data rate\r | |
709 | 40:91-95 skip\r | |
710 | 40:96 Keyboard Status\r | |
711 | 40:97 LED Status\r | |
712 | 40:98-101 skip\r | |
713 | */\r | |
714 | typedef struct {\r | |
715 | UINT16 Com1;\r | |
716 | UINT16 Com2;\r | |
717 | UINT16 Com3;\r | |
718 | UINT16 Com4;\r | |
719 | UINT16 Lpt1;\r | |
720 | UINT16 Lpt2;\r | |
721 | UINT16 Lpt3;\r | |
722 | UINT16 Ebda;\r | |
723 | UINT16 MachineConfig;\r | |
724 | UINT8 Bda12;\r | |
725 | UINT16 MemSize;\r | |
726 | UINT8 Bda15_16[0x02];\r | |
727 | UINT8 ShiftStatus;\r | |
728 | UINT8 Bda18_19[0x02];\r | |
729 | UINT16 KeyHead;\r | |
730 | UINT16 KeyTail;\r | |
731 | UINT16 Bda1E_3D[0x10];\r | |
732 | UINT16 FloppyData;\r | |
733 | UINT8 FloppyTimeout;\r | |
734 | UINT8 Bda41_74[0x34];\r | |
735 | UINT8 NumberOfDrives;\r | |
736 | UINT8 Bda76_77[0x02];\r | |
737 | UINT16 Lpt1_2Timeout;\r | |
738 | UINT16 Lpt3_4Timeout;\r | |
739 | UINT16 Com1_2Timeout;\r | |
740 | UINT16 Com3_4Timeout;\r | |
741 | UINT16 KeyStart;\r | |
742 | UINT16 KeyEnd;\r | |
743 | UINT8 Bda84_87[0x4];\r | |
744 | UINT8 DataXmit;\r | |
745 | UINT8 Bda89_8F[0x07];\r | |
746 | UINT8 FloppyXRate;\r | |
747 | UINT8 Bda91_95[0x05];\r | |
748 | UINT8 KeyboardStatus;\r | |
749 | UINT8 LedStatus;\r | |
750 | } BDA_STRUC;\r | |
751 | #pragma pack()\r | |
752 | \r | |
753 | #define LEGACY_BIOS_INSTANCE_FROM_THIS(this) CR (this, LEGACY_BIOS_INSTANCE, LegacyBios, LEGACY_BIOS_INSTANCE_SIGNATURE)\r | |
754 | \r | |
755 | /**\r | |
756 | Thunk to 16-bit real mode and execute a software interrupt with a vector\r | |
757 | of BiosInt. Regs will contain the 16-bit register context on entry and\r | |
758 | exit.\r | |
759 | \r | |
760 | @param This Protocol instance pointer.\r | |
761 | @param BiosInt Processor interrupt vector to invoke\r | |
762 | @param Regs Register contexted passed into (and returned) from thunk to\r | |
763 | 16-bit mode\r | |
764 | \r | |
765 | @retval FALSE Thunk completed, and there were no BIOS errors in the target code.\r | |
766 | See Regs for status.\r | |
767 | @retval TRUE There was a BIOS erro in the target code.\r | |
768 | \r | |
769 | **/\r | |
770 | BOOLEAN\r | |
771 | EFIAPI\r | |
772 | LegacyBiosInt86 (\r | |
773 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
774 | IN UINT8 BiosInt,\r | |
775 | IN EFI_IA32_REGISTER_SET *Regs\r | |
776 | );\r | |
777 | \r | |
778 | \r | |
779 | /**\r | |
780 | Thunk to 16-bit real mode and call Segment:Offset. Regs will contain the\r | |
781 | 16-bit register context on entry and exit. Arguments can be passed on\r | |
782 | the Stack argument\r | |
783 | \r | |
784 | @param This Protocol instance pointer.\r | |
785 | @param Segment Segemnt of 16-bit mode call\r | |
786 | @param Offset Offset of 16-bit mdoe call\r | |
787 | @param Regs Register contexted passed into (and returned) from\r | |
788 | thunk to 16-bit mode\r | |
789 | @param Stack Caller allocated stack used to pass arguments\r | |
790 | @param StackSize Size of Stack in bytes\r | |
791 | \r | |
792 | @retval FALSE Thunk completed, and there were no BIOS errors in\r | |
793 | the target code. See Regs for status.\r | |
794 | @retval TRUE There was a BIOS erro in the target code.\r | |
795 | \r | |
796 | **/\r | |
797 | BOOLEAN\r | |
798 | EFIAPI\r | |
799 | LegacyBiosFarCall86 (\r | |
800 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
801 | IN UINT16 Segment,\r | |
802 | IN UINT16 Offset,\r | |
803 | IN EFI_IA32_REGISTER_SET *Regs,\r | |
804 | IN VOID *Stack,\r | |
805 | IN UINTN StackSize\r | |
806 | );\r | |
807 | \r | |
808 | \r | |
809 | /**\r | |
810 | Test to see if a legacy PCI ROM exists for this device. Optionally return\r | |
811 | the Legacy ROM instance for this PCI device.\r | |
812 | \r | |
813 | @param This Protocol instance pointer.\r | |
814 | @param PciHandle The PCI PC-AT OPROM from this devices ROM BAR will\r | |
815 | be loaded\r | |
816 | @param RomImage Return the legacy PCI ROM for this device\r | |
817 | @param RomSize Size of ROM Image\r | |
818 | @param Flags Indicates if ROM found and if PC-AT.\r | |
819 | \r | |
820 | @retval EFI_SUCCESS Legacy Option ROM availible for this device\r | |
821 | @retval EFI_UNSUPPORTED Legacy Option ROM not supported.\r | |
822 | \r | |
823 | **/\r | |
824 | EFI_STATUS\r | |
825 | EFIAPI\r | |
826 | LegacyBiosCheckPciRom (\r | |
827 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
828 | IN EFI_HANDLE PciHandle,\r | |
829 | OUT VOID **RomImage, OPTIONAL\r | |
830 | OUT UINTN *RomSize, OPTIONAL\r | |
831 | OUT UINTN *Flags\r | |
832 | );\r | |
833 | \r | |
834 | \r | |
835 | /**\r | |
836 | Assign drive number to legacy HDD drives prior to booting an EFI\r | |
837 | aware OS so the OS can access drives without an EFI driver.\r | |
838 | Note: BBS compliant drives ARE NOT available until this call by\r | |
839 | either shell or EFI.\r | |
840 | \r | |
841 | @param This Protocol instance pointer.\r | |
842 | @param BbsCount Number of BBS_TABLE structures\r | |
843 | @param BbsTable List BBS entries\r | |
844 | \r | |
845 | @retval EFI_SUCCESS Drive numbers assigned\r | |
846 | \r | |
847 | **/\r | |
848 | EFI_STATUS\r | |
849 | EFIAPI\r | |
850 | LegacyBiosPrepareToBootEfi (\r | |
851 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
852 | OUT UINT16 *BbsCount,\r | |
853 | OUT BBS_TABLE **BbsTable\r | |
854 | );\r | |
855 | \r | |
856 | \r | |
857 | /**\r | |
858 | To boot from an unconventional device like parties and/or execute\r | |
859 | HDD diagnostics.\r | |
860 | \r | |
861 | @param This Protocol instance pointer.\r | |
862 | @param Attributes How to interpret the other input parameters\r | |
863 | @param BbsEntry The 0-based index into the BbsTable for the parent\r | |
864 | device.\r | |
865 | @param BeerData Pointer to the 128 bytes of ram BEER data.\r | |
866 | @param ServiceAreaData Pointer to the 64 bytes of raw Service Area data.\r | |
867 | The caller must provide a pointer to the specific\r | |
868 | Service Area and not the start all Service Areas.\r | |
869 | EFI_INVALID_PARAMETER if error. Does NOT return if no error.\r | |
870 | \r | |
871 | **/\r | |
872 | EFI_STATUS\r | |
873 | EFIAPI\r | |
874 | LegacyBiosBootUnconventionalDevice (\r | |
875 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
876 | IN UDC_ATTRIBUTES Attributes,\r | |
877 | IN UINTN BbsEntry,\r | |
878 | IN VOID *BeerData,\r | |
879 | IN VOID *ServiceAreaData\r | |
880 | );\r | |
881 | \r | |
882 | \r | |
883 | /**\r | |
884 | Load a legacy PC-AT OPROM on the PciHandle device. Return information\r | |
885 | about how many disks were added by the OPROM and the shadow address and\r | |
886 | size. DiskStart & DiskEnd are INT 13h drive letters. Thus 0x80 is C:\r | |
887 | \r | |
888 | @param This Protocol instance pointer.\r | |
889 | @param PciHandle The PCI PC-AT OPROM from this devices ROM BAR will\r | |
890 | be loaded. This value is NULL if RomImage is\r | |
891 | non-NULL. This is the normal case.\r | |
892 | @param RomImage A PCI PC-AT ROM image. This argument is non-NULL\r | |
893 | if there is no hardware associated with the ROM\r | |
894 | and thus no PciHandle, otherwise is must be NULL.\r | |
895 | Example is PXE base code.\r | |
896 | @param Flags Indicates if ROM found and if PC-AT.\r | |
897 | @param DiskStart Disk number of first device hooked by the ROM. If\r | |
898 | DiskStart is the same as DiskEnd no disked were\r | |
899 | hooked.\r | |
900 | @param DiskEnd Disk number of the last device hooked by the ROM.\r | |
901 | @param RomShadowAddress Shadow address of PC-AT ROM\r | |
902 | @param RomShadowedSize Size of RomShadowAddress in bytes\r | |
903 | \r | |
904 | @retval EFI_SUCCESS Legacy ROM loaded for this device\r | |
905 | @retval EFI_INVALID_PARAMETER PciHandle not found\r | |
906 | @retval EFI_UNSUPPORTED There is no PCI ROM in the ROM BAR or no onboard\r | |
907 | ROM\r | |
908 | \r | |
909 | **/\r | |
910 | EFI_STATUS\r | |
911 | EFIAPI\r | |
912 | LegacyBiosInstallPciRom (\r | |
913 | IN EFI_LEGACY_BIOS_PROTOCOL * This,\r | |
914 | IN EFI_HANDLE PciHandle,\r | |
915 | IN VOID **RomImage,\r | |
916 | OUT UINTN *Flags,\r | |
917 | OUT UINT8 *DiskStart, OPTIONAL\r | |
918 | OUT UINT8 *DiskEnd, OPTIONAL\r | |
919 | OUT VOID **RomShadowAddress, OPTIONAL\r | |
920 | OUT UINT32 *RomShadowedSize OPTIONAL\r | |
921 | );\r | |
922 | \r | |
923 | \r | |
924 | /**\r | |
925 | Fill in the standard BDA for Keyboard LEDs\r | |
926 | \r | |
927 | @param This Protocol instance pointer.\r | |
928 | @param Leds Current LED status\r | |
929 | \r | |
930 | @retval EFI_SUCCESS It should always work.\r | |
931 | \r | |
932 | **/\r | |
933 | EFI_STATUS\r | |
934 | EFIAPI\r | |
935 | LegacyBiosUpdateKeyboardLedStatus (\r | |
936 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
937 | IN UINT8 Leds\r | |
938 | );\r | |
939 | \r | |
940 | \r | |
941 | /**\r | |
942 | Get all BBS info\r | |
943 | \r | |
944 | @param This Protocol instance pointer.\r | |
945 | @param HddCount Number of HDD_INFO structures\r | |
946 | @param HddInfo Onboard IDE controller information\r | |
947 | @param BbsCount Number of BBS_TABLE structures\r | |
948 | @param BbsTable List BBS entries\r | |
949 | \r | |
950 | @retval EFI_SUCCESS Tables returned\r | |
951 | @retval EFI_NOT_FOUND resource not found\r | |
952 | @retval EFI_DEVICE_ERROR can not get BBS table\r | |
953 | \r | |
954 | **/\r | |
955 | EFI_STATUS\r | |
956 | EFIAPI\r | |
957 | LegacyBiosGetBbsInfo (\r | |
958 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
959 | OUT UINT16 *HddCount,\r | |
960 | OUT HDD_INFO **HddInfo,\r | |
961 | OUT UINT16 *BbsCount,\r | |
962 | OUT BBS_TABLE **BbsTable\r | |
963 | );\r | |
964 | \r | |
965 | \r | |
966 | /**\r | |
967 | Shadow all legacy16 OPROMs that haven't been shadowed.\r | |
968 | Warning: Use this with caution. This routine disconnects all EFI\r | |
969 | drivers. If used externally then caller must re-connect EFI\r | |
970 | drivers.\r | |
971 | \r | |
972 | @param This Protocol instance pointer.\r | |
973 | \r | |
974 | @retval EFI_SUCCESS OPROMs shadowed\r | |
975 | \r | |
976 | **/\r | |
977 | EFI_STATUS\r | |
978 | EFIAPI\r | |
979 | LegacyBiosShadowAllLegacyOproms (\r | |
980 | IN EFI_LEGACY_BIOS_PROTOCOL *This\r | |
981 | );\r | |
982 | \r | |
983 | \r | |
984 | /**\r | |
985 | Attempt to legacy boot the BootOption. If the EFI contexted has been\r | |
986 | compromised this function will not return.\r | |
987 | \r | |
988 | @param This Protocol instance pointer.\r | |
989 | @param BbsDevicePath EFI Device Path from BootXXXX variable.\r | |
990 | @param LoadOptionsSize Size of LoadOption in size.\r | |
991 | @param LoadOptions LoadOption from BootXXXX variable\r | |
992 | \r | |
993 | @retval EFI_SUCCESS Removable media not present\r | |
994 | \r | |
995 | **/\r | |
996 | EFI_STATUS\r | |
997 | EFIAPI\r | |
998 | LegacyBiosLegacyBoot (\r | |
999 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
1000 | IN BBS_BBS_DEVICE_PATH *BbsDevicePath,\r | |
1001 | IN UINT32 LoadOptionsSize,\r | |
1002 | IN VOID *LoadOptions\r | |
1003 | );\r | |
1004 | \r | |
1005 | \r | |
1006 | /**\r | |
1007 | Allocate memory < 1 MB and copy the thunker code into low memory. Se up\r | |
1008 | all the descriptors.\r | |
1009 | \r | |
1010 | @param Private Private context for Legacy BIOS\r | |
1011 | \r | |
1012 | @retval EFI_SUCCESS Should only pass.\r | |
1013 | \r | |
1014 | **/\r | |
1015 | EFI_STATUS\r | |
1016 | LegacyBiosInitializeThunk (\r | |
1017 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1018 | );\r | |
1019 | \r | |
1020 | \r | |
1021 | /**\r | |
1022 | Fill in the standard BDA and EBDA stuff before Legacy16 load\r | |
1023 | \r | |
1024 | @param Private Legacy BIOS Instance data\r | |
1025 | \r | |
1026 | @retval EFI_SUCCESS It should always work.\r | |
1027 | \r | |
1028 | **/\r | |
1029 | EFI_STATUS\r | |
1030 | LegacyBiosInitBda (\r | |
1031 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1032 | );\r | |
1033 | \r | |
1034 | \r | |
1035 | /**\r | |
1036 | Collect IDE Inquiry data from the IDE disks\r | |
1037 | \r | |
1038 | @param Private Legacy BIOS Instance data\r | |
1039 | @param HddInfo Hdd Information\r | |
1040 | @param Flag Reconnect IdeController or not\r | |
1041 | \r | |
1042 | @retval EFI_SUCCESS It should always work.\r | |
1043 | \r | |
1044 | **/\r | |
1045 | EFI_STATUS\r | |
1046 | LegacyBiosBuildIdeData (\r | |
1047 | IN LEGACY_BIOS_INSTANCE *Private,\r | |
1048 | IN HDD_INFO **HddInfo,\r | |
1049 | IN UINT16 Flag\r | |
1050 | );\r | |
1051 | \r | |
1052 | \r | |
1053 | /**\r | |
1054 | Enable ide controller. This gets disabled when LegacyBoot.c is about\r | |
1055 | to run the Option ROMs.\r | |
1056 | \r | |
1057 | @param Private Legacy BIOS Instance data\r | |
1058 | \r | |
1059 | \r | |
1060 | **/\r | |
1061 | VOID\r | |
1062 | EnableIdeController (\r | |
1063 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1064 | );\r | |
1065 | \r | |
1066 | \r | |
1067 | /**\r | |
1068 | If the IDE channel is in compatibility (legacy) mode, remove all\r | |
1069 | PCI I/O BAR addresses from the controller.\r | |
1070 | \r | |
1071 | @param IdeController The handle of target IDE controller\r | |
1072 | \r | |
1073 | \r | |
1074 | **/\r | |
1075 | VOID\r | |
1076 | InitLegacyIdeController (\r | |
1077 | IN EFI_HANDLE IdeController\r | |
1078 | );\r | |
1079 | \r | |
1080 | \r | |
1081 | /**\r | |
1082 | Program the interrupt routing register in all the PCI devices. On a PC AT system\r | |
1083 | this register contains the 8259 IRQ vector that matches it's PCI interrupt.\r | |
1084 | \r | |
1085 | @param Private Legacy BIOS Instance data\r | |
1086 | \r | |
1087 | @retval EFI_SUCCESS Succeed.\r | |
1088 | @retval EFI_ALREADY_STARTED All PCI devices have been processed.\r | |
1089 | \r | |
1090 | **/\r | |
1091 | EFI_STATUS\r | |
1092 | PciProgramAllInterruptLineRegisters (\r | |
1093 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1094 | );\r | |
1095 | \r | |
1096 | \r | |
1097 | /**\r | |
1098 | Collect EFI Info about legacy devices.\r | |
1099 | \r | |
1100 | @param Private Legacy BIOS Instance data\r | |
1101 | \r | |
1102 | @retval EFI_SUCCESS It should always work.\r | |
1103 | \r | |
1104 | **/\r | |
1105 | EFI_STATUS\r | |
1106 | LegacyBiosBuildSioData (\r | |
1107 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1108 | );\r | |
1109 | \r | |
1110 | \r | |
1111 | /**\r | |
1112 | Shadow all the PCI legacy ROMs. Use data from the Legacy BIOS Protocol\r | |
1113 | to chose the order. Skip any devices that have already have legacy\r | |
1114 | BIOS run.\r | |
1115 | \r | |
1116 | @param Private Protocol instance pointer.\r | |
1117 | \r | |
1118 | @retval EFI_SUCCESS Succeed.\r | |
1119 | @retval EFI_UNSUPPORTED Cannot get VGA device handle.\r | |
1120 | \r | |
1121 | **/\r | |
1122 | EFI_STATUS\r | |
1123 | PciShadowRoms (\r | |
1124 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1125 | );\r | |
1126 | \r | |
1127 | \r | |
1128 | /**\r | |
1129 | Fill in the standard BDA and EBDA stuff prior to legacy Boot\r | |
1130 | \r | |
1131 | @param Private Legacy BIOS Instance data\r | |
1132 | \r | |
1133 | @retval EFI_SUCCESS It should always work.\r | |
1134 | \r | |
1135 | **/\r | |
1136 | EFI_STATUS\r | |
1137 | LegacyBiosCompleteBdaBeforeBoot (\r | |
1138 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1139 | );\r | |
1140 | \r | |
1141 | \r | |
1142 | /**\r | |
1143 | Fill in the standard CMOS stuff before Legacy16 load\r | |
1144 | \r | |
1145 | @param Private Legacy BIOS Instance data\r | |
1146 | \r | |
1147 | @retval EFI_SUCCESS It should always work.\r | |
1148 | \r | |
1149 | **/\r | |
1150 | EFI_STATUS\r | |
1151 | LegacyBiosInitCmos (\r | |
1152 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1153 | );\r | |
1154 | \r | |
1155 | \r | |
1156 | /**\r | |
1157 | Fill in the standard CMOS stuff prior to legacy Boot\r | |
1158 | \r | |
1159 | @param Private Legacy BIOS Instance data\r | |
1160 | \r | |
1161 | @retval EFI_SUCCESS It should always work.\r | |
1162 | \r | |
1163 | **/\r | |
1164 | EFI_STATUS\r | |
1165 | LegacyBiosCompleteStandardCmosBeforeBoot (\r | |
1166 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1167 | );\r | |
1168 | \r | |
1169 | \r | |
1170 | /**\r | |
1171 | Contains the code that is copied into low memory (below 640K).\r | |
1172 | This code reflects interrupts 0x68-0x6f to interrupts 0x08-0x0f.\r | |
1173 | This template must be copied into low memory, and the IDT entries\r | |
1174 | 0x68-0x6F must be point to the low memory copy of this code. Each\r | |
1175 | entry is 4 bytes long, so IDT entries 0x68-0x6F can be easily\r | |
1176 | computed.\r | |
1177 | \r | |
1178 | **/\r | |
1179 | VOID\r | |
1180 | InterruptRedirectionTemplate (\r | |
1181 | VOID\r | |
1182 | );\r | |
1183 | \r | |
1184 | \r | |
1185 | /**\r | |
1186 | Build the E820 table.\r | |
1187 | \r | |
1188 | @param Private Legacy BIOS Instance data\r | |
1189 | @param Size Size of E820 Table\r | |
1190 | \r | |
1191 | @retval EFI_SUCCESS It should always work.\r | |
1192 | \r | |
1193 | **/\r | |
1194 | EFI_STATUS\r | |
1195 | LegacyBiosBuildE820 (\r | |
1196 | IN LEGACY_BIOS_INSTANCE *Private,\r | |
1197 | OUT UINTN *Size\r | |
1198 | );\r | |
1199 | \r | |
1200 | /**\r | |
1201 | This function is to put all AP in halt state.\r | |
1202 | \r | |
1203 | @param Private Legacy BIOS Instance data\r | |
1204 | \r | |
1205 | **/\r | |
1206 | VOID\r | |
1207 | ShutdownAPs (\r | |
1208 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1209 | );\r | |
1210 | \r | |
1211 | /**\r | |
1212 | Worker function for LegacyBiosGetFlatDescs, retrieving content of\r | |
1213 | specific registers.\r | |
1214 | \r | |
1215 | @param IntThunk Pointer to IntThunk of Legacy BIOS context.\r | |
1216 | \r | |
1217 | **/\r | |
1218 | VOID\r | |
1219 | GetRegisters (\r | |
1220 | LOW_MEMORY_THUNK *IntThunk\r | |
1221 | );\r | |
1222 | \r | |
1223 | /**\r | |
1224 | Routine for calling real thunk code.\r | |
1225 | \r | |
1226 | @param RealCode The address of thunk code.\r | |
1227 | @param BiosInt The Bios interrupt vector number.\r | |
1228 | @param CallAddress The address of 16-bit mode call.\r | |
1229 | \r | |
1230 | @return Status returned by real thunk code\r | |
1231 | \r | |
1232 | **/\r | |
1233 | UINTN\r | |
1234 | CallRealThunkCode (\r | |
1235 | UINT8 *RealCode,\r | |
1236 | UINT8 BiosInt,\r | |
1237 | UINT32 CallAddress\r | |
1238 | );\r | |
1239 | \r | |
1240 | /**\r | |
1241 | Routine for generating soft interrupt.\r | |
1242 | \r | |
1243 | @param Vector The interrupt vector number.\r | |
1244 | \r | |
1245 | **/\r | |
1246 | VOID\r | |
1247 | GenerateSoftInit (\r | |
1248 | UINT8 Vector\r | |
1249 | );\r | |
1250 | \r | |
1251 | /**\r | |
1252 | Do an AllocatePages () of type AllocateMaxAddress for EfiBootServicesCode\r | |
1253 | memory.\r | |
1254 | \r | |
1255 | @param AllocateType Allocated Legacy Memory Type\r | |
1256 | @param StartPageAddress Start address of range\r | |
1257 | @param Pages Number of pages to allocate\r | |
1258 | @param Result Result of allocation\r | |
1259 | \r | |
1260 | @retval EFI_SUCCESS Legacy16 code loaded\r | |
1261 | @retval Other No protocol installed, unload driver.\r | |
1262 | \r | |
1263 | **/\r | |
1264 | EFI_STATUS\r | |
1265 | AllocateLegacyMemory (\r | |
1266 | IN EFI_ALLOCATE_TYPE AllocateType,\r | |
1267 | IN EFI_PHYSICAL_ADDRESS StartPageAddress,\r | |
1268 | IN UINTN Pages,\r | |
1269 | OUT EFI_PHYSICAL_ADDRESS *Result\r | |
1270 | );\r | |
1271 | \r | |
1272 | /**\r | |
1273 | Get a region from the LegacyBios for Tiano usage. Can only be invoked once.\r | |
1274 | \r | |
1275 | @param This Protocol instance pointer.\r | |
1276 | @param LegacyMemorySize Size of required region\r | |
1277 | @param Region Region to use. 00 = Either 0xE0000 or 0xF0000\r | |
1278 | block Bit0 = 1 0xF0000 block Bit1 = 1 0xE0000\r | |
1279 | block\r | |
1280 | @param Alignment Address alignment. Bit mapped. First non-zero\r | |
1281 | bit from right is alignment.\r | |
1282 | @param LegacyMemoryAddress Region Assigned\r | |
1283 | \r | |
1284 | @retval EFI_SUCCESS Region assigned\r | |
1285 | @retval EFI_ACCESS_DENIED Procedure previously invoked\r | |
1286 | @retval Other Region not assigned\r | |
1287 | \r | |
1288 | **/\r | |
1289 | EFI_STATUS\r | |
1290 | EFIAPI\r | |
1291 | LegacyBiosGetLegacyRegion (\r | |
1292 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
1293 | IN UINTN LegacyMemorySize,\r | |
1294 | IN UINTN Region,\r | |
1295 | IN UINTN Alignment,\r | |
1296 | OUT VOID **LegacyMemoryAddress\r | |
1297 | );\r | |
1298 | \r | |
1299 | /**\r | |
1300 | Get a region from the LegacyBios for Tiano usage. Can only be invoked once.\r | |
1301 | \r | |
1302 | @param This Protocol instance pointer.\r | |
1303 | @param LegacyMemorySize Size of data to copy\r | |
1304 | @param LegacyMemoryAddress Legacy Region destination address Note: must\r | |
1305 | be in region assigned by\r | |
1306 | LegacyBiosGetLegacyRegion\r | |
1307 | @param LegacyMemorySourceAddress Source of data\r | |
1308 | \r | |
1309 | @retval EFI_SUCCESS Region assigned\r | |
1310 | @retval EFI_ACCESS_DENIED Destination outside assigned region\r | |
1311 | \r | |
1312 | **/\r | |
1313 | EFI_STATUS\r | |
1314 | EFIAPI\r | |
1315 | LegacyBiosCopyLegacyRegion (\r | |
1316 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
1317 | IN UINTN LegacyMemorySize,\r | |
1318 | IN VOID *LegacyMemoryAddress,\r | |
1319 | IN VOID *LegacyMemorySourceAddress\r | |
1320 | );\r | |
1321 | \r | |
1322 | /**\r | |
1323 | Find Legacy16 BIOS image in the FLASH device and shadow it into memory. Find\r | |
1324 | the $EFI table in the shadow area. Thunk into the Legacy16 code after it had\r | |
1325 | been shadowed.\r | |
1326 | \r | |
1327 | @param Private Legacy BIOS context data\r | |
1328 | \r | |
1329 | @retval EFI_SUCCESS Legacy16 code loaded\r | |
1330 | @retval Other No protocol installed, unload driver.\r | |
1331 | \r | |
1332 | **/\r | |
1333 | EFI_STATUS\r | |
1334 | ShadowAndStartLegacy16 (\r | |
1335 | IN LEGACY_BIOS_INSTANCE *Private\r | |
1336 | );\r | |
1337 | \r | |
1338 | /**\r | |
1339 | Checks the state of the floppy and if media is inserted.\r | |
1340 | \r | |
1341 | This routine checks the state of the floppy and if media is inserted.\r | |
1342 | There are 3 cases:\r | |
1343 | No floppy present - Set BBS entry to ignore\r | |
1344 | Floppy present & no media - Set BBS entry to lowest priority. We cannot\r | |
1345 | set it to ignore since 16-bit CSM will\r | |
1346 | indicate no floppy and thus drive A: is\r | |
1347 | unusable. CSM-16 will not try floppy since\r | |
1348 | lowest priority and thus not incur boot\r | |
1349 | time penality.\r | |
1350 | Floppy present & media - Set BBS entry to some priority.\r | |
1351 | \r | |
1352 | @return State of floppy media\r | |
1353 | \r | |
1354 | **/\r | |
1355 | UINT8\r | |
1356 | HasMediaInFloppy (\r | |
1357 | VOID\r | |
1358 | );\r | |
1359 | \r | |
1360 | /**\r | |
1361 | Identify drive data must be updated to actual parameters before boot.\r | |
1362 | This requires updating the checksum, if it exists.\r | |
1363 | \r | |
1364 | @param IdentifyDriveData ATA Identify Data\r | |
1365 | @param Checksum checksum of the ATA Identify Data\r | |
1366 | \r | |
1367 | @retval EFI_SUCCESS checksum calculated\r | |
1368 | @retval EFI_SECURITY_VIOLATION IdentifyData invalid\r | |
1369 | \r | |
1370 | **/\r | |
1371 | EFI_STATUS\r | |
1372 | CalculateIdentifyDriveChecksum (\r | |
1373 | IN UINT8 *IdentifyDriveData,\r | |
1374 | OUT UINT8 *Checksum\r | |
1375 | );\r | |
1376 | \r | |
1377 | /**\r | |
1378 | Identify drive data must be updated to actual parameters before boot.\r | |
1379 | \r | |
1380 | @param IdentifyDriveData ATA Identify Data\r | |
1381 | \r | |
1382 | **/\r | |
1383 | VOID\r | |
1384 | UpdateIdentifyDriveData (\r | |
1385 | IN UINT8 *IdentifyDriveData\r | |
1386 | );\r | |
1387 | \r | |
1388 | /**\r | |
1389 | Complete build of BBS TABLE.\r | |
1390 | \r | |
1391 | @param Private Legacy BIOS Instance data\r | |
1392 | @param BbsTable BBS Table passed to 16-bit code\r | |
1393 | \r | |
1394 | @retval EFI_SUCCESS Removable media not present\r | |
1395 | \r | |
1396 | **/\r | |
1397 | EFI_STATUS\r | |
1398 | LegacyBiosBuildBbs (\r | |
1399 | IN LEGACY_BIOS_INSTANCE *Private,\r | |
1400 | IN BBS_TABLE *BbsTable\r | |
1401 | );\r | |
1402 | \r | |
1403 | /**\r | |
1404 | Read CMOS register through index/data port.\r | |
1405 | \r | |
1406 | @param[in] Index The index of the CMOS register to read.\r | |
1407 | \r | |
1408 | @return The data value from the CMOS register specified by Index.\r | |
1409 | \r | |
1410 | **/\r | |
1411 | UINT8\r | |
1412 | LegacyReadStandardCmos (\r | |
1413 | IN UINT8 Index\r | |
1414 | );\r | |
1415 | \r | |
1416 | /**\r | |
1417 | Write CMOS register through index/data port.\r | |
1418 | \r | |
1419 | @param[in] Index The index of the CMOS register to write.\r | |
1420 | @param[in] Value The value of CMOS register to write.\r | |
1421 | \r | |
1422 | @return The value written to the CMOS register specified by Index.\r | |
1423 | \r | |
1424 | **/\r | |
1425 | UINT8\r | |
1426 | LegacyWriteStandardCmos (\r | |
1427 | IN UINT8 Index,\r | |
1428 | IN UINT8 Value\r | |
1429 | );\r | |
1430 | \r | |
1431 | /**\r | |
1432 | Calculate the new standard CMOS checksum and write it.\r | |
1433 | \r | |
1434 | @param Private Legacy BIOS Instance data\r | |
1435 | \r | |
1436 | @retval EFI_SUCCESS Calculate 16-bit checksum successfully\r | |
1437 | \r | |
1438 | **/\r | |
1439 | EFI_STATUS\r | |
1440 | LegacyCalculateWriteStandardCmosChecksum (\r | |
1441 | VOID\r | |
1442 | );\r | |
1443 | \r | |
1444 | /**\r | |
1445 | Test to see if a legacy PCI ROM exists for this device. Optionally return\r | |
1446 | the Legacy ROM instance for this PCI device.\r | |
1447 | \r | |
1448 | @param[in] This Protocol instance pointer.\r | |
1449 | @param[in] PciHandle The PCI PC-AT OPROM from this devices ROM BAR will be loaded\r | |
1450 | @param[out] RomImage Return the legacy PCI ROM for this device\r | |
1451 | @param[out] RomSize Size of ROM Image\r | |
1452 | @param[out] RuntimeImageLength Runtime size of ROM Image\r | |
1453 | @param[out] Flags Indicates if ROM found and if PC-AT.\r | |
1454 | @param[out] OpromRevision Revision of the PCI Rom\r | |
1455 | @param[out] ConfigUtilityCodeHeaderPointer of Configuration Utility Code Header\r | |
1456 | \r | |
1457 | @return EFI_SUCCESS Legacy Option ROM availible for this device\r | |
1458 | @return EFI_ALREADY_STARTED This device is already managed by its Oprom\r | |
1459 | @return EFI_UNSUPPORTED Legacy Option ROM not supported.\r | |
1460 | \r | |
1461 | **/\r | |
1462 | EFI_STATUS\r | |
1463 | LegacyBiosCheckPciRomEx (\r | |
1464 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
1465 | IN EFI_HANDLE PciHandle,\r | |
1466 | OUT VOID **RomImage, OPTIONAL\r | |
1467 | OUT UINTN *RomSize, OPTIONAL\r | |
1468 | OUT UINTN *RuntimeImageLength, OPTIONAL\r | |
1469 | OUT UINTN *Flags, OPTIONAL\r | |
1470 | OUT UINT8 *OpromRevision, OPTIONAL\r | |
1471 | OUT VOID **ConfigUtilityCodeHeader OPTIONAL\r | |
1472 | );\r | |
1473 | \r | |
1474 | /**\r | |
1475 | Relocate this image under 4G memory for IPF.\r | |
1476 | \r | |
1477 | @param ImageHandle Handle of driver image.\r | |
1478 | @param SystemTable Pointer to system table.\r | |
1479 | \r | |
1480 | @retval EFI_SUCCESS Image successfully relocated.\r | |
1481 | @retval EFI_ABORTED Failed to relocate image.\r | |
1482 | \r | |
1483 | **/\r | |
1484 | EFI_STATUS\r | |
1485 | RelocateImageUnder4GIfNeeded (\r | |
1486 | IN EFI_HANDLE ImageHandle,\r | |
1487 | IN EFI_SYSTEM_TABLE *SystemTable\r | |
1488 | );\r | |
1489 | \r | |
1490 | /**\r | |
1491 | Thunk to 16-bit real mode and call Segment:Offset. Regs will contain the\r | |
1492 | 16-bit register context on entry and exit. Arguments can be passed on\r | |
1493 | the Stack argument\r | |
1494 | \r | |
1495 | @param This Protocol instance pointer.\r | |
1496 | @param Segment Segemnt of 16-bit mode call\r | |
1497 | @param Offset Offset of 16-bit mdoe call\r | |
1498 | @param Regs Register contexted passed into (and returned) from thunk to\r | |
1499 | 16-bit mode\r | |
1500 | @param Stack Caller allocated stack used to pass arguments\r | |
1501 | @param StackSize Size of Stack in bytes\r | |
1502 | \r | |
1503 | @retval FALSE Thunk completed, and there were no BIOS errors in the target code.\r | |
1504 | See Regs for status.\r | |
1505 | @retval TRUE There was a BIOS erro in the target code.\r | |
1506 | \r | |
1507 | **/\r | |
1508 | BOOLEAN\r | |
1509 | EFIAPI\r | |
1510 | InternalLegacyBiosFarCall (\r | |
1511 | IN EFI_LEGACY_BIOS_PROTOCOL *This,\r | |
1512 | IN UINT16 Segment,\r | |
1513 | IN UINT16 Offset,\r | |
1514 | IN EFI_IA32_REGISTER_SET *Regs,\r | |
1515 | IN VOID *Stack,\r | |
1516 | IN UINTN StackSize\r | |
1517 | );\r | |
1518 | \r | |
1519 | #endif\r |