]> git.proxmox.com Git - mirror_edk2.git/blame_incremental - MdeModulePkg/Universal/Console/TerminalDxe/Terminal.c
projects / mirror_edk2.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
ECC clean up.
[mirror_edk2.git] / MdeModulePkg / Universal / Console / TerminalDxe / Terminal.c
... / ...
CommitLineData
1/** @file\r
2 Produces Simple Text Input Protocol, Simple Text Input Extended Protocol and\r
3 Simple Text Output Protocol upon Serial IO Protocol.\r
4\r
5Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
6All rights reserved. This program and the accompanying materials\r
7are licensed and made available under the terms and conditions of the BSD License\r
8which accompanies this distribution. The full text of the license may be found at\r
9http://opensource.org/licenses/bsd-license.php\r
10\r
11THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13\r
14**/\r
15\r
16\r
17#include "Terminal.h"\r
18\r
19//\r
20// Globals\r
21//\r
22EFI_DRIVER_BINDING_PROTOCOL gTerminalDriverBinding = {\r
23 TerminalDriverBindingSupported,\r
24 TerminalDriverBindingStart,\r
25 TerminalDriverBindingStop,\r
26 0xa,\r
27 NULL,\r
28 NULL\r
29};\r
30\r
31\r
32EFI_GUID *gTerminalType[] = {\r
33 &gEfiPcAnsiGuid,\r
34 &gEfiVT100Guid,\r
35 &gEfiVT100PlusGuid,\r
36 &gEfiVTUTF8Guid\r
37};\r
38\r
39\r
40TERMINAL_DEV mTerminalDevTemplate = {\r
41 TERMINAL_DEV_SIGNATURE,\r
42 NULL,\r
43 0,\r
44 NULL,\r
45 NULL,\r
46 { // SimpleTextInput\r
47 TerminalConInReset,\r
48 TerminalConInReadKeyStroke,\r
49 NULL\r
50 },\r
51 { // SimpleTextOutput\r
52 TerminalConOutReset,\r
53 TerminalConOutOutputString,\r
54 TerminalConOutTestString,\r
55 TerminalConOutQueryMode,\r
56 TerminalConOutSetMode,\r
57 TerminalConOutSetAttribute,\r
58 TerminalConOutClearScreen,\r
59 TerminalConOutSetCursorPosition,\r
60 TerminalConOutEnableCursor,\r
61 NULL\r
62 },\r
63 { // SimpleTextOutputMode\r
64 1, // MaxMode\r
65 0, // Mode\r
66 EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK), // Attribute\r
67 0, // CursorColumn\r
68 0, // CursorRow\r
69 TRUE // CursorVisible\r
70 },\r
71 0, // SerialInTimeOut\r
72 { // RawFiFo\r
73 0,\r
74 0,\r
75 { 0 }\r
76 },\r
77 { // UnicodeFiFo\r
78 0,\r
79 0,\r
80 { 0 }\r
81 },\r
82 { // EfiKeyFiFo\r
83 0,\r
84 0,\r
85 { {0} }\r
86 },\r
87 NULL, // ControllerNameTable\r
88 NULL, // TwoSecondTimeOut\r
89 INPUT_STATE_DEFAULT,\r
90 RESET_STATE_DEFAULT,\r
91 FALSE,\r
92 { // SimpleTextInputEx\r
93 TerminalConInResetEx,\r
94 TerminalConInReadKeyStrokeEx,\r
95 NULL,\r
96 TerminalConInSetState,\r
97 TerminalConInRegisterKeyNotify,\r
98 TerminalConInUnregisterKeyNotify,\r
99 },\r
100 { // NotifyList\r
101 NULL,\r
102 NULL,\r
103 }\r
104};\r
105\r
106/**\r
107 Test to see if this driver supports Controller.\r
108\r
109 @param This Protocol instance pointer.\r
110 @param Controller Handle of device to test\r
111 @param RemainingDevicePath Optional parameter use to pick a specific child\r
112 device to start.\r
113\r
114 @retval EFI_SUCCESS This driver supports this device.\r
115 @retval EFI_ALREADY_STARTED This driver is already running on this device.\r
116 @retval other This driver does not support this device.\r
117\r
118**/\r
119EFI_STATUS\r
120EFIAPI\r
121TerminalDriverBindingSupported (\r
122 IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
123 IN EFI_HANDLE Controller,\r
124 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
125 )\r
126{\r
127 EFI_STATUS Status;\r
128 EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath;\r
129 EFI_SERIAL_IO_PROTOCOL *SerialIo;\r
130 VENDOR_DEVICE_PATH *Node;\r
131\r
132 //\r
133 // If remaining device path is not NULL, then make sure it is a\r
134 // device path that describes a terminal communications protocol.\r
135 //\r
136 if (RemainingDevicePath != NULL) {\r
137\r
138 Node = (VENDOR_DEVICE_PATH *) RemainingDevicePath;\r
139\r
140 if (Node->Header.Type != MESSAGING_DEVICE_PATH ||\r
141 Node->Header.SubType != MSG_VENDOR_DP ||\r
142 DevicePathNodeLength(&Node->Header) != sizeof(VENDOR_DEVICE_PATH)) {\r
143\r
144 return EFI_UNSUPPORTED;\r
145\r
146 }\r
147 //\r
148 // only supports PC ANSI, VT100, VT100+ and VT-UTF8 terminal types\r
149 //\r
150 if (!CompareGuid (&Node->Guid, &gEfiPcAnsiGuid) &&\r
151 !CompareGuid (&Node->Guid, &gEfiVT100Guid) &&\r
152 !CompareGuid (&Node->Guid, &gEfiVT100PlusGuid) &&\r
153 !CompareGuid (&Node->Guid, &gEfiVTUTF8Guid)) {\r
154\r
155 return EFI_UNSUPPORTED;\r
156 }\r
157 }\r
158 //\r
159 // Open the IO Abstraction(s) needed to perform the supported test\r
160 //\r
161 Status = gBS->OpenProtocol (\r
162 Controller,\r
163 &gEfiDevicePathProtocolGuid,\r
164 (VOID **) &ParentDevicePath,\r
165 This->DriverBindingHandle,\r
166 Controller,\r
167 EFI_OPEN_PROTOCOL_BY_DRIVER\r
168 );\r
169 if (Status == EFI_ALREADY_STARTED) {\r
170 return EFI_SUCCESS;\r
171 }\r
172\r
173 if (EFI_ERROR (Status)) {\r
174 return Status;\r
175 }\r
176\r
177 gBS->CloseProtocol (\r
178 Controller,\r
179 &gEfiDevicePathProtocolGuid,\r
180 This->DriverBindingHandle,\r
181 Controller\r
182 );\r
183\r
184 //\r
185 // The Controller must support the Serial I/O Protocol.\r
186 // This driver is a bus driver with at most 1 child device, so it is\r
187 // ok for it to be already started.\r
188 //\r
189 Status = gBS->OpenProtocol (\r
190 Controller,\r
191 &gEfiSerialIoProtocolGuid,\r
192 (VOID **) &SerialIo,\r
193 This->DriverBindingHandle,\r
194 Controller,\r
195 EFI_OPEN_PROTOCOL_BY_DRIVER\r
196 );\r
197 if (Status == EFI_ALREADY_STARTED) {\r
198 return EFI_SUCCESS;\r
199 }\r
200\r
201 if (EFI_ERROR (Status)) {\r
202 return Status;\r
203 }\r
204 //\r
205 // Close the I/O Abstraction(s) used to perform the supported test\r
206 //\r
207 gBS->CloseProtocol (\r
208 Controller,\r
209 &gEfiSerialIoProtocolGuid,\r
210 This->DriverBindingHandle,\r
211 Controller\r
212 );\r
213\r
214 return Status;\r
215}\r
216\r
217/**\r
218 Start this driver on Controller by opening a Serial IO protocol,\r
219 reading Device Path, and creating a child handle with a Simple Text In,\r
220 Simple Text In Ex and Simple Text Out protocol, and device path protocol.\r
221 And store Console Device Environment Variables.\r
222\r
223 @param This Protocol instance pointer.\r
224 @param Controller Handle of device to bind driver to\r
225 @param RemainingDevicePath Optional parameter use to pick a specific child\r
226 device to start.\r
227\r
228 @retval EFI_SUCCESS This driver is added to Controller.\r
229 @retval EFI_ALREADY_STARTED This driver is already running on Controller.\r
230 @retval other This driver does not support this device.\r
231\r
232**/\r
233EFI_STATUS\r
234EFIAPI\r
235TerminalDriverBindingStart (\r
236 IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
237 IN EFI_HANDLE Controller,\r
238 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
239 )\r
240{\r
241 EFI_STATUS Status;\r
242 EFI_SERIAL_IO_PROTOCOL *SerialIo;\r
243 EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath;\r
244 VENDOR_DEVICE_PATH *Node;\r
245 VENDOR_DEVICE_PATH *DefaultNode;\r
246 EFI_SERIAL_IO_MODE *Mode;\r
247 UINTN SerialInTimeOut;\r
248 TERMINAL_DEV *TerminalDevice;\r
249 UINT8 TerminalType;\r
250 EFI_OPEN_PROTOCOL_INFORMATION_ENTRY *OpenInfoBuffer;\r
251 UINTN EntryCount;\r
252 UINTN Index;\r
253 EFI_DEVICE_PATH_PROTOCOL *DevicePath;\r
254 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *SimpleTextOutput;\r
255\r
256 TerminalDevice = NULL;\r
257 DefaultNode = NULL;\r
258 //\r
259 // Get the Device Path Protocol to build the device path of the child device\r
260 //\r
261 Status = gBS->OpenProtocol (\r
262 Controller,\r
263 &gEfiDevicePathProtocolGuid,\r
264 (VOID **) &ParentDevicePath,\r
265 This->DriverBindingHandle,\r
266 Controller,\r
267 EFI_OPEN_PROTOCOL_BY_DRIVER\r
268 );\r
269 if (EFI_ERROR (Status) && Status != EFI_ALREADY_STARTED) {\r
270 return Status;\r
271 }\r
272\r
273 //\r
274 // Open the Serial I/O Protocol BY_DRIVER. It might already be started.\r
275 //\r
276 Status = gBS->OpenProtocol (\r
277 Controller,\r
278 &gEfiSerialIoProtocolGuid,\r
279 (VOID **) &SerialIo,\r
280 This->DriverBindingHandle,\r
281 Controller,\r
282 EFI_OPEN_PROTOCOL_BY_DRIVER\r
283 );\r
284 if (EFI_ERROR (Status) && Status != EFI_ALREADY_STARTED) {\r
285 return Status;\r
286 }\r
287\r
288 if (Status != EFI_ALREADY_STARTED) {\r
289 //\r
290 // If Serial I/O is not already open by this driver, then tag the handle\r
291 // with the Terminal Driver GUID and update the ConInDev, ConOutDev, and\r
292 // StdErrDev variables with the list of possible terminal types on this\r
293 // serial port.\r
294 //\r
295 Status = gBS->OpenProtocol (\r
296 Controller,\r
297 &gEfiCallerIdGuid,\r
298 NULL,\r
299 This->DriverBindingHandle,\r
300 Controller,\r
301 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
302 );\r
303 if (EFI_ERROR (Status)) {\r
304 Status = gBS->InstallMultipleProtocolInterfaces (\r
305 &Controller,\r
306 &gEfiCallerIdGuid,\r
307 DuplicateDevicePath (ParentDevicePath),\r
308 NULL\r
309 );\r
310 if (EFI_ERROR (Status)) {\r
311 goto Error;\r
312 }\r
313 //\r
314 // if the serial device is a hot plug device, do not update the\r
315 // ConInDev, ConOutDev, and StdErrDev variables.\r
316 //\r
317 Status = gBS->OpenProtocol (\r
318 Controller,\r
319 &gEfiHotPlugDeviceGuid,\r
320 NULL,\r
321 This->DriverBindingHandle,\r
322 Controller,\r
323 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
324 );\r
325 if (EFI_ERROR (Status)) {\r
326 TerminalUpdateConsoleDevVariable (L"ConInDev", ParentDevicePath);\r
327 TerminalUpdateConsoleDevVariable (L"ConOutDev", ParentDevicePath);\r
328 TerminalUpdateConsoleDevVariable (L"ErrOutDev", ParentDevicePath);\r
329 }\r
330 }\r
331 }\r
332 //\r
333 // Make sure a child handle does not already exist. This driver can only\r
334 // produce one child per serial port.\r
335 //\r
336 Status = gBS->OpenProtocolInformation (\r
337 Controller,\r
338 &gEfiSerialIoProtocolGuid,\r
339 &OpenInfoBuffer,\r
340 &EntryCount\r
341 );\r
342 if (!EFI_ERROR (Status)) {\r
343 Status = EFI_SUCCESS;\r
344 for (Index = 0; Index < EntryCount; Index++) {\r
345 if ((OpenInfoBuffer[Index].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
346 Status = EFI_ALREADY_STARTED;\r
347 }\r
348 }\r
349\r
350 FreePool (OpenInfoBuffer);\r
351 if (EFI_ERROR (Status)) {\r
352 return Status;\r
353 }\r
354 }\r
355 //\r
356 // If RemainingDevicePath is NULL, then create default device path node\r
357 //\r
358 if (RemainingDevicePath == NULL) {\r
359 DefaultNode = AllocateZeroPool (sizeof (VENDOR_DEVICE_PATH));\r
360 if (DefaultNode == NULL) {\r
361 Status = EFI_OUT_OF_RESOURCES;\r
362 goto Error;\r
363 }\r
364\r
365 TerminalType = FixedPcdGet8 (PcdDefaultTerminalType);\r
366 //\r
367 // Must be between PCANSITYPE (0) and VTUTF8TYPE (3)\r
368 //\r
369 ASSERT (TerminalType <= VTUTF8TYPE);\r
370\r
371 CopyMem (&DefaultNode->Guid, gTerminalType[TerminalType], sizeof (EFI_GUID));\r
372 RemainingDevicePath = (EFI_DEVICE_PATH_PROTOCOL *) DefaultNode;\r
373 } else {\r
374 //\r
375 // Use the RemainingDevicePath to determine the terminal type\r
376 //\r
377 Node = (VENDOR_DEVICE_PATH *)RemainingDevicePath;\r
378 if (CompareGuid (&Node->Guid, &gEfiPcAnsiGuid)) {\r
379 TerminalType = PCANSITYPE;\r
380 } else if (CompareGuid (&Node->Guid, &gEfiVT100Guid)) {\r
381 TerminalType = VT100TYPE;\r
382 } else if (CompareGuid (&Node->Guid, &gEfiVT100PlusGuid)) {\r
383 TerminalType = VT100PLUSTYPE;\r
384 } else if (CompareGuid (&Node->Guid, &gEfiVTUTF8Guid)) {\r
385 TerminalType = VTUTF8TYPE;\r
386 } else {\r
387 goto Error;\r
388 }\r
389 }\r
390\r
391 //\r
392 // Initialize the Terminal Dev\r
393 //\r
394 TerminalDevice = AllocateCopyPool (sizeof (TERMINAL_DEV), &mTerminalDevTemplate);\r
395 if (TerminalDevice == NULL) {\r
396 Status = EFI_OUT_OF_RESOURCES;\r
397 goto Error;\r
398 }\r
399\r
400 TerminalDevice->TerminalType = TerminalType;\r
401 TerminalDevice->SerialIo = SerialIo;\r
402\r
403 InitializeListHead (&TerminalDevice->NotifyList);\r
404 Status = gBS->CreateEvent (\r
405 EVT_NOTIFY_WAIT,\r
406 TPL_NOTIFY,\r
407 TerminalConInWaitForKeyEx,\r
408 &TerminalDevice->SimpleInputEx,\r
409 &TerminalDevice->SimpleInputEx.WaitForKeyEx\r
410 );\r
411 if (EFI_ERROR (Status)) {\r
412 goto Error;\r
413 }\r
414\r
415\r
416 Status = gBS->CreateEvent (\r
417 EVT_NOTIFY_WAIT,\r
418 TPL_NOTIFY,\r
419 TerminalConInWaitForKey,\r
420 &TerminalDevice->SimpleInput,\r
421 &TerminalDevice->SimpleInput.WaitForKey\r
422 );\r
423 if (EFI_ERROR (Status)) {\r
424 goto Error;\r
425 }\r
426 //\r
427 // initialize the FIFO buffer used for accommodating\r
428 // the pre-read pending characters\r
429 //\r
430 InitializeRawFiFo (TerminalDevice);\r
431 InitializeUnicodeFiFo (TerminalDevice);\r
432 InitializeEfiKeyFiFo (TerminalDevice);\r
433\r
434 //\r
435 // Set the timeout value of serial buffer for\r
436 // keystroke response performance issue\r
437 //\r
438 Mode = TerminalDevice->SerialIo->Mode;\r
439\r
440 SerialInTimeOut = 0;\r
441 if (Mode->BaudRate != 0) {\r
442 SerialInTimeOut = (1 + Mode->DataBits + Mode->StopBits) * 2 * 1000000 / (UINTN) Mode->BaudRate;\r
443 }\r
444\r
445 Status = TerminalDevice->SerialIo->SetAttributes (\r
446 TerminalDevice->SerialIo,\r
447 Mode->BaudRate,\r
448 Mode->ReceiveFifoDepth,\r
449 (UINT32) SerialInTimeOut,\r
450 (EFI_PARITY_TYPE) (Mode->Parity),\r
451 (UINT8) Mode->DataBits,\r
452 (EFI_STOP_BITS_TYPE) (Mode->StopBits)\r
453 );\r
454 if (EFI_ERROR (Status)) {\r
455 //\r
456 // if set attributes operation fails, invalidate\r
457 // the value of SerialInTimeOut,thus make it\r
458 // inconsistent with the default timeout value\r
459 // of serial buffer. This will invoke the recalculation\r
460 // in the readkeystroke routine.\r
461 //\r
462 TerminalDevice->SerialInTimeOut = 0;\r
463 } else {\r
464 TerminalDevice->SerialInTimeOut = SerialInTimeOut;\r
465 }\r
466 //\r
467 // Build the device path for the child device\r
468 //\r
469 Status = SetTerminalDevicePath (\r
470 TerminalDevice->TerminalType,\r
471 ParentDevicePath,\r
472 &TerminalDevice->DevicePath\r
473 );\r
474 if (EFI_ERROR (Status)) {\r
475 goto Error;\r
476 }\r
477\r
478 DevicePath = TerminalDevice->DevicePath;\r
479\r
480 Status = TerminalDevice->SimpleInput.Reset (\r
481 &TerminalDevice->SimpleInput,\r
482 FALSE\r
483 );\r
484 if (EFI_ERROR (Status)) {\r
485 //\r
486 // Need to report Error Code first\r
487 //\r
488 goto ReportError;\r
489 }\r
490 //\r
491 // Set Simple Text Output Protocol from template.\r
492 //\r
493 SimpleTextOutput = CopyMem (\r
494 &TerminalDevice->SimpleTextOutput,\r
495 &mTerminalDevTemplate.SimpleTextOutput,\r
496 sizeof (mTerminalDevTemplate.SimpleTextOutput)\r
497 );\r
498 SimpleTextOutput->Mode = &TerminalDevice->SimpleTextOutputMode;\r
499\r
500 TerminalDevice->SimpleTextOutputMode.MaxMode = 3;\r
501 //\r
502 // For terminal devices, cursor is always visible\r
503 //\r
504 TerminalDevice->SimpleTextOutputMode.CursorVisible = TRUE;\r
505 Status = TerminalConOutSetAttribute (\r
506 SimpleTextOutput,\r
507 EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK)\r
508 );\r
509 if (EFI_ERROR (Status)) {\r
510 goto ReportError;\r
511 }\r
512\r
513 Status = TerminalConOutReset (SimpleTextOutput, FALSE);\r
514 if (EFI_ERROR (Status)) {\r
515 goto ReportError;\r
516 }\r
517\r
518 Status = TerminalConOutSetMode (SimpleTextOutput, 0);\r
519 if (EFI_ERROR (Status)) {\r
520 goto ReportError;\r
521 }\r
522\r
523 Status = TerminalConOutEnableCursor (SimpleTextOutput, TRUE);\r
524 if (EFI_ERROR (Status)) {\r
525 goto ReportError;\r
526 }\r
527\r
528 Status = gBS->CreateEvent (\r
529 EVT_TIMER,\r
530 TPL_CALLBACK,\r
531 NULL,\r
532 NULL,\r
533 &TerminalDevice->TwoSecondTimeOut\r
534 );\r
535\r
536 //\r
537 // Build the component name for the child device\r
538 //\r
539 TerminalDevice->ControllerNameTable = NULL;\r
540 switch (TerminalDevice->TerminalType) {\r
541 case PCANSITYPE:\r
542 AddUnicodeString2 (\r
543 "eng",\r
544 gTerminalComponentName.SupportedLanguages,\r
545 &TerminalDevice->ControllerNameTable,\r
546 (CHAR16 *)L"PC-ANSI Serial Console",\r
547 TRUE\r
548 );\r
549 AddUnicodeString2 (\r
550 "en",\r
551 gTerminalComponentName2.SupportedLanguages,\r
552 &TerminalDevice->ControllerNameTable,\r
553 (CHAR16 *)L"PC-ANSI Serial Console",\r
554 FALSE\r
555 );\r
556\r
557 break;\r
558\r
559 case VT100TYPE:\r
560 AddUnicodeString2 (\r
561 "eng",\r
562 gTerminalComponentName.SupportedLanguages,\r
563 &TerminalDevice->ControllerNameTable,\r
564 (CHAR16 *)L"VT-100 Serial Console",\r
565 TRUE\r
566 );\r
567 AddUnicodeString2 (\r
568 "en",\r
569 gTerminalComponentName2.SupportedLanguages,\r
570 &TerminalDevice->ControllerNameTable,\r
571 (CHAR16 *)L"VT-100 Serial Console",\r
572 FALSE\r
573 );\r
574\r
575 break;\r
576\r
577 case VT100PLUSTYPE:\r
578 AddUnicodeString2 (\r
579 "eng",\r
580 gTerminalComponentName.SupportedLanguages,\r
581 &TerminalDevice->ControllerNameTable,\r
582 (CHAR16 *)L"VT-100+ Serial Console",\r
583 TRUE\r
584 );\r
585 AddUnicodeString2 (\r
586 "en",\r
587 gTerminalComponentName2.SupportedLanguages,\r
588 &TerminalDevice->ControllerNameTable,\r
589 (CHAR16 *)L"VT-100+ Serial Console",\r
590 FALSE\r
591 );\r
592\r
593 break;\r
594\r
595 case VTUTF8TYPE:\r
596 AddUnicodeString2 (\r
597 "eng",\r
598 gTerminalComponentName.SupportedLanguages,\r
599 &TerminalDevice->ControllerNameTable,\r
600 (CHAR16 *)L"VT-UTF8 Serial Console",\r
601 TRUE\r
602 );\r
603 AddUnicodeString2 (\r
604 "en",\r
605 gTerminalComponentName2.SupportedLanguages,\r
606 &TerminalDevice->ControllerNameTable,\r
607 (CHAR16 *)L"VT-UTF8 Serial Console",\r
608 FALSE\r
609 );\r
610\r
611 break;\r
612 }\r
613 //\r
614 // Install protocol interfaces for the serial device.\r
615 //\r
616 Status = gBS->InstallMultipleProtocolInterfaces (\r
617 &TerminalDevice->Handle,\r
618 &gEfiDevicePathProtocolGuid,\r
619 TerminalDevice->DevicePath,\r
620 &gEfiSimpleTextInProtocolGuid,\r
621 &TerminalDevice->SimpleInput,\r
622 &gEfiSimpleTextInputExProtocolGuid,\r
623 &TerminalDevice->SimpleInputEx,\r
624 &gEfiSimpleTextOutProtocolGuid,\r
625 &TerminalDevice->SimpleTextOutput,\r
626 NULL\r
627 );\r
628 if (EFI_ERROR (Status)) {\r
629 goto Error;\r
630 }\r
631 //\r
632 // if the serial device is a hot plug device, attaches the HotPlugGuid\r
633 // onto the terminal device handle.\r
634 //\r
635 Status = gBS->OpenProtocol (\r
636 Controller,\r
637 &gEfiHotPlugDeviceGuid,\r
638 NULL,\r
639 This->DriverBindingHandle,\r
640 Controller,\r
641 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
642 );\r
643 if (!EFI_ERROR (Status)) {\r
644 Status = gBS->InstallMultipleProtocolInterfaces (\r
645 &TerminalDevice->Handle,\r
646 &gEfiHotPlugDeviceGuid,\r
647 NULL,\r
648 NULL\r
649 );\r
650 }\r
651 //\r
652 // Register the Parent-Child relationship via\r
653 // EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER.\r
654 //\r
655 Status = gBS->OpenProtocol (\r
656 Controller,\r
657 &gEfiSerialIoProtocolGuid,\r
658 (VOID **) &TerminalDevice->SerialIo,\r
659 This->DriverBindingHandle,\r
660 TerminalDevice->Handle,\r
661 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
662 );\r
663 if (EFI_ERROR (Status)) {\r
664 goto Error;\r
665 }\r
666\r
667 if (DefaultNode != NULL) {\r
668 FreePool (DefaultNode);\r
669 }\r
670\r
671 return EFI_SUCCESS;\r
672\r
673ReportError:\r
674 //\r
675 // Report error code before exiting\r
676 //\r
677 REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
678 EFI_ERROR_CODE | EFI_ERROR_MINOR,\r
679 PcdGet32 (PcdStatusCodeValueRemoteConsoleError),\r
680 DevicePath\r
681 );\r
682\r
683Error:\r
684 //\r
685 // Use the Stop() function to free all resources allocated in Start()\r
686 //\r
687 if (TerminalDevice != NULL) {\r
688\r
689 if (TerminalDevice->Handle != NULL) {\r
690 This->Stop (This, Controller, 1, &TerminalDevice->Handle);\r
691 } else {\r
692\r
693 if (TerminalDevice->TwoSecondTimeOut != NULL) {\r
694 gBS->CloseEvent (TerminalDevice->TwoSecondTimeOut);\r
695 }\r
696\r
697 if (TerminalDevice->SimpleInput.WaitForKey != NULL) {\r
698 gBS->CloseEvent (TerminalDevice->SimpleInput.WaitForKey);\r
699 }\r
700\r
701 if (TerminalDevice->SimpleInputEx.WaitForKeyEx != NULL) {\r
702 gBS->CloseEvent (TerminalDevice->SimpleInputEx.WaitForKeyEx);\r
703 }\r
704\r
705 TerminalFreeNotifyList (&TerminalDevice->NotifyList);\r
706\r
707 if (TerminalDevice->ControllerNameTable != NULL) {\r
708 FreeUnicodeStringTable (TerminalDevice->ControllerNameTable);\r
709 }\r
710\r
711 if (TerminalDevice->DevicePath != NULL) {\r
712 FreePool (TerminalDevice->DevicePath);\r
713 }\r
714\r
715 FreePool (TerminalDevice);\r
716 }\r
717 }\r
718\r
719 if (DefaultNode != NULL) {\r
720 FreePool (DefaultNode);\r
721 }\r
722\r
723 This->Stop (This, Controller, 0, NULL);\r
724\r
725 return Status;\r
726}\r
727\r
728/**\r
729 Stop this driver on Controller by closing Simple Text In, Simple Text\r
730 In Ex, Simple Text Out protocol, and removing parent device path from\r
731 Console Device Environment Variables.\r
732\r
733 @param This Protocol instance pointer.\r
734 @param Controller Handle of device to stop driver on\r
735 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of\r
736 children is zero stop the entire bus driver.\r
737 @param ChildHandleBuffer List of Child Handles to Stop.\r
738\r
739 @retval EFI_SUCCESS This driver is removed Controller.\r
740 @retval other This driver could not be removed from this device.\r
741\r
742**/\r
743EFI_STATUS\r
744EFIAPI\r
745TerminalDriverBindingStop (\r
746 IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
747 IN EFI_HANDLE Controller,\r
748 IN UINTN NumberOfChildren,\r
749 IN EFI_HANDLE *ChildHandleBuffer\r
750 )\r
751{\r
752 EFI_STATUS Status;\r
753 UINTN Index;\r
754 BOOLEAN AllChildrenStopped;\r
755 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *SimpleTextOutput;\r
756 TERMINAL_DEV *TerminalDevice;\r
757 EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath;\r
758 EFI_SERIAL_IO_PROTOCOL *SerialIo;\r
759 EFI_DEVICE_PATH_PROTOCOL *DevicePath;\r
760\r
761 Status = gBS->HandleProtocol (\r
762 Controller,\r
763 &gEfiDevicePathProtocolGuid,\r
764 (VOID **) &DevicePath\r
765 );\r
766 if (EFI_ERROR (Status)) {\r
767 return Status;\r
768 }\r
769\r
770 //\r
771 // Complete all outstanding transactions to Controller.\r
772 // Don't allow any new transaction to Controller to be started.\r
773 //\r
774 if (NumberOfChildren == 0) {\r
775 //\r
776 // Close the bus driver\r
777 //\r
778 Status = gBS->OpenProtocol (\r
779 Controller,\r
780 &gEfiCallerIdGuid,\r
781 (VOID **) &ParentDevicePath,\r
782 This->DriverBindingHandle,\r
783 Controller,\r
784 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
785 );\r
786 if (!EFI_ERROR (Status)) {\r
787 //\r
788 // Remove Parent Device Path from\r
789 // the Console Device Environment Variables\r
790 //\r
791 TerminalRemoveConsoleDevVariable (L"ConInDev", ParentDevicePath);\r
792 TerminalRemoveConsoleDevVariable (L"ConOutDev", ParentDevicePath);\r
793 TerminalRemoveConsoleDevVariable (L"ErrOutDev", ParentDevicePath);\r
794\r
795 //\r
796 // Uninstall the Terminal Driver's GUID Tag from the Serial controller\r
797 //\r
798 Status = gBS->UninstallMultipleProtocolInterfaces (\r
799 Controller,\r
800 &gEfiCallerIdGuid,\r
801 ParentDevicePath,\r
802 NULL\r
803 );\r
804\r
805 //\r
806 // Free the ParentDevicePath that was duplicated in Start()\r
807 //\r
808 if (!EFI_ERROR (Status)) {\r
809 FreePool (ParentDevicePath);\r
810 }\r
811 }\r
812\r
813 gBS->CloseProtocol (\r
814 Controller,\r
815 &gEfiSerialIoProtocolGuid,\r
816 This->DriverBindingHandle,\r
817 Controller\r
818 );\r
819\r
820 gBS->CloseProtocol (\r
821 Controller,\r
822 &gEfiDevicePathProtocolGuid,\r
823 This->DriverBindingHandle,\r
824 Controller\r
825 );\r
826\r
827 return EFI_SUCCESS;\r
828 }\r
829\r
830 AllChildrenStopped = TRUE;\r
831\r
832 for (Index = 0; Index < NumberOfChildren; Index++) {\r
833\r
834 Status = gBS->OpenProtocol (\r
835 ChildHandleBuffer[Index],\r
836 &gEfiSimpleTextOutProtocolGuid,\r
837 (VOID **) &SimpleTextOutput,\r
838 This->DriverBindingHandle,\r
839 ChildHandleBuffer[Index],\r
840 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
841 );\r
842 if (!EFI_ERROR (Status)) {\r
843\r
844 TerminalDevice = TERMINAL_CON_OUT_DEV_FROM_THIS (SimpleTextOutput);\r
845\r
846 gBS->CloseProtocol (\r
847 Controller,\r
848 &gEfiSerialIoProtocolGuid,\r
849 This->DriverBindingHandle,\r
850 ChildHandleBuffer[Index]\r
851 );\r
852\r
853 Status = gBS->UninstallMultipleProtocolInterfaces (\r
854 ChildHandleBuffer[Index],\r
855 &gEfiSimpleTextInProtocolGuid,\r
856 &TerminalDevice->SimpleInput,\r
857 &gEfiSimpleTextInputExProtocolGuid,\r
858 &TerminalDevice->SimpleInputEx,\r
859 &gEfiSimpleTextOutProtocolGuid,\r
860 &TerminalDevice->SimpleTextOutput,\r
861 &gEfiDevicePathProtocolGuid,\r
862 TerminalDevice->DevicePath,\r
863 NULL\r
864 );\r
865 if (EFI_ERROR (Status)) {\r
866 gBS->OpenProtocol (\r
867 Controller,\r
868 &gEfiSerialIoProtocolGuid,\r
869 (VOID **) &SerialIo,\r
870 This->DriverBindingHandle,\r
871 ChildHandleBuffer[Index],\r
872 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
873 );\r
874 } else {\r
875\r
876 if (TerminalDevice->ControllerNameTable != NULL) {\r
877 FreeUnicodeStringTable (TerminalDevice->ControllerNameTable);\r
878 }\r
879\r
880 Status = gBS->OpenProtocol (\r
881 ChildHandleBuffer[Index],\r
882 &gEfiHotPlugDeviceGuid,\r
883 NULL,\r
884 This->DriverBindingHandle,\r
885 Controller,\r
886 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
887 );\r
888 if (!EFI_ERROR (Status)) {\r
889 Status = gBS->UninstallMultipleProtocolInterfaces (\r
890 ChildHandleBuffer[Index],\r
891 &gEfiHotPlugDeviceGuid,\r
892 NULL,\r
893 NULL\r
894 );\r
895 } else {\r
896 Status = EFI_SUCCESS;\r
897 }\r
898\r
899 gBS->CloseEvent (TerminalDevice->TwoSecondTimeOut);\r
900 gBS->CloseEvent (TerminalDevice->SimpleInput.WaitForKey);\r
901 gBS->CloseEvent (TerminalDevice->SimpleInputEx.WaitForKeyEx);\r
902 TerminalFreeNotifyList (&TerminalDevice->NotifyList);\r
903 FreePool (TerminalDevice->DevicePath);\r
904 FreePool (TerminalDevice);\r
905 }\r
906 }\r
907\r
908 if (EFI_ERROR (Status)) {\r
909 AllChildrenStopped = FALSE;\r
910 }\r
911 }\r
912\r
913 if (!AllChildrenStopped) {\r
914 return EFI_DEVICE_ERROR;\r
915 }\r
916\r
917 return EFI_SUCCESS;\r
918}\r
919\r
920\r
921/**\r
922 Free notify functions list.\r
923\r
924 @param ListHead The list head\r
925\r
926 @retval EFI_SUCCESS Free the notify list successfully.\r
927 @retval EFI_INVALID_PARAMETER ListHead is NULL.\r
928\r
929**/\r
930EFI_STATUS\r
931TerminalFreeNotifyList (\r
932 IN OUT LIST_ENTRY *ListHead\r
933 )\r
934{\r
935 TERMINAL_CONSOLE_IN_EX_NOTIFY *NotifyNode;\r
936\r
937 if (ListHead == NULL) {\r
938 return EFI_INVALID_PARAMETER;\r
939 }\r
940 while (!IsListEmpty (ListHead)) {\r
941 NotifyNode = CR (\r
942 ListHead->ForwardLink,\r
943 TERMINAL_CONSOLE_IN_EX_NOTIFY,\r
944 NotifyEntry,\r
945 TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE\r
946 );\r
947 RemoveEntryList (ListHead->ForwardLink);\r
948 FreePool (NotifyNode);\r
949 }\r
950\r
951 return EFI_SUCCESS;\r
952}\r
953\r
954\r
955/**\r
956 Update terminal device path in Console Device Environment Variables.\r
957\r
958 @param VariableName The Console Device Environment Variable.\r
959 @param ParentDevicePath The terminal device path to be updated.\r
960\r
961**/\r
962VOID\r
963TerminalUpdateConsoleDevVariable (\r
964 IN CHAR16 *VariableName,\r
965 IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath\r
966 )\r
967{\r
968 EFI_STATUS Status;\r
969 UINTN VariableSize;\r
970 UINT8 TerminalType;\r
971 EFI_DEVICE_PATH_PROTOCOL *Variable;\r
972 EFI_DEVICE_PATH_PROTOCOL *NewVariable;\r
973 EFI_DEVICE_PATH_PROTOCOL *TempDevicePath;\r
974\r
975 Variable = NULL;\r
976\r
977 //\r
978 // Get global variable and its size according to the name given.\r
979 //\r
980 Variable = TerminalGetVariableAndSize (\r
981 VariableName,\r
982 &gEfiGlobalVariableGuid,\r
983 &VariableSize\r
984 );\r
985 //\r
986 // Append terminal device path onto the variable.\r
987 //\r
988 for (TerminalType = PCANSITYPE; TerminalType <= VTUTF8TYPE; TerminalType++) {\r
989 SetTerminalDevicePath (TerminalType, ParentDevicePath, &TempDevicePath);\r
990 NewVariable = AppendDevicePathInstance (Variable, TempDevicePath);\r
991 if (Variable != NULL) {\r
992 FreePool (Variable);\r
993 }\r
994\r
995 if (TempDevicePath != NULL) {\r
996 FreePool (TempDevicePath);\r
997 }\r
998\r
999 Variable = NewVariable;\r
1000 }\r
1001\r
1002 VariableSize = GetDevicePathSize (Variable);\r
1003\r
1004 Status = gRT->SetVariable (\r
1005 VariableName,\r
1006 &gEfiGlobalVariableGuid,\r
1007 EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,\r
1008 VariableSize,\r
1009 Variable\r
1010 );\r
1011 ASSERT_EFI_ERROR (Status);\r
1012 FreePool (Variable);\r
1013\r
1014 return ;\r
1015}\r
1016\r
1017\r
1018/**\r
1019 Remove terminal device path from Console Device Environment Variables.\r
1020\r
1021 @param VariableName Console Device Environment Variables.\r
1022 @param ParentDevicePath The terminal device path to be updated.\r
1023\r
1024**/\r
1025VOID\r
1026TerminalRemoveConsoleDevVariable (\r
1027 IN CHAR16 *VariableName,\r
1028 IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath\r
1029 )\r
1030{\r
1031 EFI_STATUS Status;\r
1032 BOOLEAN FoundOne;\r
1033 BOOLEAN Match;\r
1034 UINTN VariableSize;\r
1035 UINTN InstanceSize;\r
1036 UINT8 TerminalType;\r
1037 EFI_DEVICE_PATH_PROTOCOL *Instance;\r
1038 EFI_DEVICE_PATH_PROTOCOL *Variable;\r
1039 EFI_DEVICE_PATH_PROTOCOL *OriginalVariable;\r
1040 EFI_DEVICE_PATH_PROTOCOL *NewVariable;\r
1041 EFI_DEVICE_PATH_PROTOCOL *SavedNewVariable;\r
1042 EFI_DEVICE_PATH_PROTOCOL *TempDevicePath;\r
1043\r
1044 Variable = NULL;\r
1045 Instance = NULL;\r
1046\r
1047 //\r
1048 // Get global variable and its size according to the name given.\r
1049 //\r
1050 Variable = TerminalGetVariableAndSize (\r
1051 VariableName,\r
1052 &gEfiGlobalVariableGuid,\r
1053 &VariableSize\r
1054 );\r
1055 if (Variable == NULL) {\r
1056 return ;\r
1057 }\r
1058\r
1059 FoundOne = FALSE;\r
1060 OriginalVariable = Variable;\r
1061 NewVariable = NULL;\r
1062\r
1063 //\r
1064 // Get first device path instance from Variable\r
1065 //\r
1066 Instance = GetNextDevicePathInstance (&Variable, &InstanceSize);\r
1067 if (Instance == NULL) {\r
1068 FreePool (OriginalVariable);\r
1069 return ;\r
1070 }\r
1071 //\r
1072 // Loop through all the device path instances of Variable\r
1073 //\r
1074 do {\r
1075 //\r
1076 // Loop through all the terminal types that this driver supports\r
1077 //\r
1078 Match = FALSE;\r
1079 for (TerminalType = PCANSITYPE; TerminalType <= VTUTF8TYPE; TerminalType++) {\r
1080\r
1081 SetTerminalDevicePath (TerminalType, ParentDevicePath, &TempDevicePath);\r
1082\r
1083 //\r
1084 // Compare the generated device path to the current device path instance\r
1085 //\r
1086 if (TempDevicePath != NULL) {\r
1087 if (CompareMem (Instance, TempDevicePath, InstanceSize) == 0) {\r
1088 Match = TRUE;\r
1089 FoundOne = TRUE;\r
1090 }\r
1091\r
1092 FreePool (TempDevicePath);\r
1093 }\r
1094 }\r
1095 //\r
1096 // If a match was not found, then keep the current device path instance\r
1097 //\r
1098 if (!Match) {\r
1099 SavedNewVariable = NewVariable;\r
1100 NewVariable = AppendDevicePathInstance (NewVariable, Instance);\r
1101 if (SavedNewVariable != NULL) {\r
1102 FreePool (SavedNewVariable);\r
1103 }\r
1104 }\r
1105 //\r
1106 // Get next device path instance from Variable\r
1107 //\r
1108 FreePool (Instance);\r
1109 Instance = GetNextDevicePathInstance (&Variable, &InstanceSize);\r
1110 } while (Instance != NULL);\r
1111\r
1112 FreePool (OriginalVariable);\r
1113\r
1114 if (FoundOne) {\r
1115 VariableSize = GetDevicePathSize (NewVariable);\r
1116\r
1117 Status = gRT->SetVariable (\r
1118 VariableName,\r
1119 &gEfiGlobalVariableGuid,\r
1120 EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,\r
1121 VariableSize,\r
1122 NewVariable\r
1123 );\r
1124 ASSERT_EFI_ERROR (Status);\r
1125 }\r
1126\r
1127 if (NewVariable != NULL) {\r
1128 FreePool (NewVariable);\r
1129 }\r
1130\r
1131 return ;\r
1132}\r
1133\r
1134\r
1135/**\r
1136 Read the EFI variable (VendorGuid/Name) and return a dynamically allocated\r
1137 buffer, and the size of the buffer. On failure return NULL.\r
1138\r
1139 @param Name String part of EFI variable name\r
1140 @param VendorGuid GUID part of EFI variable name\r
1141 @param VariableSize Returns the size of the EFI variable that was read\r
1142\r
1143 @return Dynamically allocated memory that contains a copy of the EFI variable.\r
1144 Caller is responsible freeing the buffer. If variable was not read,\r
1145 NULL returned.\r
1146\r
1147**/\r
1148VOID *\r
1149TerminalGetVariableAndSize (\r
1150 IN CHAR16 *Name,\r
1151 IN EFI_GUID *VendorGuid,\r
1152 OUT UINTN *VariableSize\r
1153 )\r
1154{\r
1155 EFI_STATUS Status;\r
1156 UINTN BufferSize;\r
1157 VOID *Buffer;\r
1158\r
1159 Buffer = NULL;\r
1160\r
1161 //\r
1162 // Pass in a small size buffer to find the actual variable size.\r
1163 //\r
1164 BufferSize = 1;\r
1165 Buffer = AllocatePool (BufferSize);\r
1166 if (Buffer == NULL) {\r
1167 *VariableSize = 0;\r
1168 return NULL;\r
1169 }\r
1170\r
1171 Status = gRT->GetVariable (Name, VendorGuid, NULL, &BufferSize, Buffer);\r
1172\r
1173 if (Status == EFI_SUCCESS) {\r
1174 *VariableSize = BufferSize;\r
1175 return Buffer;\r
1176\r
1177 } else if (Status == EFI_BUFFER_TOO_SMALL) {\r
1178 //\r
1179 // Allocate the buffer to return\r
1180 //\r
1181 FreePool (Buffer);\r
1182 Buffer = AllocatePool (BufferSize);\r
1183 if (Buffer == NULL) {\r
1184 *VariableSize = 0;\r
1185 return NULL;\r
1186 }\r
1187 //\r
1188 // Read variable into the allocated buffer.\r
1189 //\r
1190 Status = gRT->GetVariable (Name, VendorGuid, NULL, &BufferSize, Buffer);\r
1191 if (EFI_ERROR (Status)) {\r
1192 BufferSize = 0;\r
1193 FreePool (Buffer);\r
1194 Buffer = NULL;\r
1195 }\r
1196 } else {\r
1197 //\r
1198 // Variable not found or other errors met.\r
1199 //\r
1200 BufferSize = 0;\r
1201 FreePool (Buffer);\r
1202 Buffer = NULL;\r
1203 }\r
1204\r
1205 *VariableSize = BufferSize;\r
1206 return Buffer;\r
1207}\r
1208\r
1209/**\r
1210 Build terminal device path according to terminal type.\r
1211\r
1212 @param TerminalType The terminal type is PC ANSI, VT100, VT100+ or VT-UTF8.\r
1213 @param ParentDevicePath Parent device path.\r
1214 @param TerminalDevicePath Returned terminal device path, if building successfully.\r
1215\r
1216 @retval EFI_UNSUPPORTED Terminal does not belong to the supported type.\r
1217 @retval EFI_OUT_OF_RESOURCES Generate terminal device path failed.\r
1218 @retval EFI_SUCCESS Build terminal device path successfully.\r
1219\r
1220**/\r
1221EFI_STATUS\r
1222SetTerminalDevicePath (\r
1223 IN UINT8 TerminalType,\r
1224 IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath,\r
1225 OUT EFI_DEVICE_PATH_PROTOCOL **TerminalDevicePath\r
1226 )\r
1227{\r
1228 VENDOR_DEVICE_PATH Node;\r
1229\r
1230 *TerminalDevicePath = NULL;\r
1231 Node.Header.Type = MESSAGING_DEVICE_PATH;\r
1232 Node.Header.SubType = MSG_VENDOR_DP;\r
1233\r
1234 //\r
1235 // Generate terminal device path node according to terminal type.\r
1236 //\r
1237 switch (TerminalType) {\r
1238\r
1239 case PCANSITYPE:\r
1240 CopyGuid (&Node.Guid, &gEfiPcAnsiGuid);\r
1241 break;\r
1242\r
1243 case VT100TYPE:\r
1244 CopyGuid (&Node.Guid, &gEfiVT100Guid);\r
1245 break;\r
1246\r
1247 case VT100PLUSTYPE:\r
1248 CopyGuid (&Node.Guid, &gEfiVT100PlusGuid);\r
1249 break;\r
1250\r
1251 case VTUTF8TYPE:\r
1252 CopyGuid (&Node.Guid, &gEfiVTUTF8Guid);\r
1253 break;\r
1254\r
1255 default:\r
1256 return EFI_UNSUPPORTED;\r
1257 }\r
1258\r
1259 //\r
1260 // Get VENDOR_DEVCIE_PATH size and put into Node.Header\r
1261 //\r
1262 SetDevicePathNodeLength (\r
1263 &Node.Header,\r
1264 sizeof (VENDOR_DEVICE_PATH)\r
1265 );\r
1266\r
1267 //\r
1268 // Append the terminal node onto parent device path\r
1269 // to generate a complete terminal device path.\r
1270 //\r
1271 *TerminalDevicePath = AppendDevicePathNode (\r
1272 ParentDevicePath,\r
1273 (EFI_DEVICE_PATH_PROTOCOL *) &Node\r
1274 );\r
1275 if (*TerminalDevicePath == NULL) {\r
1276 return EFI_OUT_OF_RESOURCES;\r
1277 }\r
1278\r
1279 return EFI_SUCCESS;\r
1280}\r
1281\r
1282/**\r
1283 Initialize the Raw Data FIFO.\r
1284\r
1285 @param TerminalDevice The terminal device.\r
1286\r
1287**/\r
1288VOID\r
1289InitializeRawFiFo (\r
1290 IN TERMINAL_DEV *TerminalDevice\r
1291 )\r
1292{\r
1293 //\r
1294 // Make the raw FIFO empty.\r
1295 //\r
1296 TerminalDevice->RawFiFo.Head = TerminalDevice->RawFiFo.Tail;\r
1297}\r
1298\r
1299/**\r
1300 Initialize the Unicode FIFO.\r
1301\r
1302 @param TerminalDevice The terminal device.\r
1303\r
1304**/\r
1305VOID\r
1306InitializeUnicodeFiFo (\r
1307 IN TERMINAL_DEV *TerminalDevice\r
1308 )\r
1309{\r
1310 //\r
1311 // Make the unicode FIFO empty\r
1312 //\r
1313 TerminalDevice->UnicodeFiFo.Head = TerminalDevice->UnicodeFiFo.Tail;\r
1314}\r
1315\r
1316/**\r
1317 Initialize the EFI Key FIFO.\r
1318\r
1319 @param TerminalDevice The terminal device.\r
1320\r
1321**/\r
1322VOID\r
1323InitializeEfiKeyFiFo (\r
1324 IN TERMINAL_DEV *TerminalDevice\r
1325 )\r
1326{\r
1327 //\r
1328 // Make the efi key FIFO empty\r
1329 //\r
1330 TerminalDevice->EfiKeyFiFo.Head = TerminalDevice->EfiKeyFiFo.Tail;\r
1331}\r
1332\r
1333\r
1334/**\r
1335 The user Entry Point for module Terminal. The user code starts with this function.\r
1336\r
1337 @param ImageHandle The firmware allocated handle for the EFI image.\r
1338 @param SystemTable A pointer to the EFI System Table.\r
1339\r
1340 @retval EFI_SUCCESS The entry point is executed successfully.\r
1341 @retval other Some error occurs when executing this entry point.\r
1342\r
1343**/\r
1344EFI_STATUS\r
1345EFIAPI\r
1346InitializeTerminal(\r
1347 IN EFI_HANDLE ImageHandle,\r
1348 IN EFI_SYSTEM_TABLE *SystemTable\r
1349 )\r
1350{\r
1351 EFI_STATUS Status;\r
1352\r
1353 //\r
1354 // Install driver model protocol(s).\r
1355 //\r
1356 Status = EfiLibInstallDriverBindingComponentName2 (\r
1357 ImageHandle,\r
1358 SystemTable,\r
1359 &gTerminalDriverBinding,\r
1360 ImageHandle,\r
1361 &gTerminalComponentName,\r
1362 &gTerminalComponentName2\r
1363 );\r
1364 ASSERT_EFI_ERROR (Status);\r
1365\r
1366 return Status;\r
1367}\r
EFI Development Kit II mirror for PVE