]> git.proxmox.com Git - mirror_edk2.git/blob - Vlv2TbltDevicePkg/Override/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c
projects / mirror_edk2.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
Align the overrider with EDK2 trunk.
[mirror_edk2.git] / Vlv2TbltDevicePkg / Override / MdeModulePkg / Universal / Console / ConSplitterDxe / ConSplitter.c
1 /** @file
2 Console Splitter Driver. Any Handle that attatched console I/O protocols
3 (Console In device, Console Out device, Console Error device, Simple Pointer
4 protocol, Absolute Pointer protocol) can be bound by this driver.
5
6 So far it works like any other driver by opening a SimpleTextIn and/or
7 SimpleTextOut protocol with EFI_OPEN_PROTOCOL_BY_DRIVER attributes. The big
8 difference is this driver does not layer a protocol on the passed in
9 handle, or construct a child handle like a standard device or bus driver.
10 This driver produces three virtual handles as children, one for console input
11 splitter, one for console output splitter and one for error output splitter.
12 These 3 virtual handles would be installed on gST.
13
14 Each virtual handle, that supports the Console I/O protocol, will be produced
15 in the driver entry point. The virtual handle are added on driver entry and
16 never removed. Such design ensures sytem function well during none console
17 device situation.
18
19 Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
20 This program and the accompanying materials
21 are licensed and made available under the terms and conditions of the BSD License
22 which accompanies this distribution. The full text of the license may be found at
23 http://opensource.org/licenses/bsd-license.php
24
25 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
26 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
27
28 **/
29
30 #include "ConSplitter.h"
31
32 //
33 // Identify if ConIn is connected in PcdConInConnectOnDemand enabled mode.
34 // default not connect
35 //
36 BOOLEAN mConInIsConnect = FALSE;
37
38 //
39 // Text In Splitter Private Data template
40 //
41 GLOBAL_REMOVE_IF_UNREFERENCED TEXT_IN_SPLITTER_PRIVATE_DATA mConIn = {
42 TEXT_IN_SPLITTER_PRIVATE_DATA_SIGNATURE,
43 (EFI_HANDLE) NULL,
44
45 {
46 ConSplitterTextInReset,
47 ConSplitterTextInReadKeyStroke,
48 (EFI_EVENT) NULL
49 },
50 0,
51 (EFI_SIMPLE_TEXT_INPUT_PROTOCOL **) NULL,
52 0,
53
54 {
55 ConSplitterTextInResetEx,
56 ConSplitterTextInReadKeyStrokeEx,
57 (EFI_EVENT) NULL,
58 ConSplitterTextInSetState,
59 ConSplitterTextInRegisterKeyNotify,
60 ConSplitterTextInUnregisterKeyNotify
61 },
62 0,
63 (EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL **) NULL,
64 0,
65 {
66 (LIST_ENTRY *) NULL,
67 (LIST_ENTRY *) NULL
68 },
69
70 {
71 ConSplitterSimplePointerReset,
72 ConSplitterSimplePointerGetState,
73 (EFI_EVENT) NULL,
74 (EFI_SIMPLE_POINTER_MODE *) NULL
75 },
76 {
77 0x10000,
78 0x10000,
79 0x10000,
80 TRUE,
81 TRUE
82 },
83 0,
84 (EFI_SIMPLE_POINTER_PROTOCOL **) NULL,
85 0,
86
87 {
88 ConSplitterAbsolutePointerReset,
89 ConSplitterAbsolutePointerGetState,
90 (EFI_EVENT) NULL,
91 (EFI_ABSOLUTE_POINTER_MODE *) NULL
92 },
93 {
94 0, // AbsoluteMinX
95 0, // AbsoluteMinY
96 0, // AbsoluteMinZ
97 0x10000, // AbsoluteMaxX
98 0x10000, // AbsoluteMaxY
99 0x10000, // AbsoluteMaxZ
100 0 // Attributes
101 },
102 0,
103 (EFI_ABSOLUTE_POINTER_PROTOCOL **) NULL,
104 0,
105 FALSE,
106
107 FALSE,
108 FALSE
109 };
110
111
112 //
113 // Uga Draw Protocol Private Data template
114 //
115 GLOBAL_REMOVE_IF_UNREFERENCED EFI_UGA_DRAW_PROTOCOL mUgaDrawProtocolTemplate = {
116 ConSplitterUgaDrawGetMode,
117 ConSplitterUgaDrawSetMode,
118 ConSplitterUgaDrawBlt
119 };
120
121 //
122 // Graphics Output Protocol Private Data template
123 //
124 GLOBAL_REMOVE_IF_UNREFERENCED EFI_GRAPHICS_OUTPUT_PROTOCOL mGraphicsOutputProtocolTemplate = {
125 ConSplitterGraphicsOutputQueryMode,
126 ConSplitterGraphicsOutputSetMode,
127 ConSplitterGraphicsOutputBlt,
128 NULL
129 };
130
131
132 //
133 // Text Out Splitter Private Data template
134 //
135 GLOBAL_REMOVE_IF_UNREFERENCED TEXT_OUT_SPLITTER_PRIVATE_DATA mConOut = {
136 TEXT_OUT_SPLITTER_PRIVATE_DATA_SIGNATURE,
137 (EFI_HANDLE) NULL,
138 {
139 ConSplitterTextOutReset,
140 ConSplitterTextOutOutputString,
141 ConSplitterTextOutTestString,
142 ConSplitterTextOutQueryMode,
143 ConSplitterTextOutSetMode,
144 ConSplitterTextOutSetAttribute,
145 ConSplitterTextOutClearScreen,
146 ConSplitterTextOutSetCursorPosition,
147 ConSplitterTextOutEnableCursor,
148 (EFI_SIMPLE_TEXT_OUTPUT_MODE *) NULL
149 },
150 {
151 1,
152 0,
153 0,
154 0,
155 0,
156 FALSE,
157 },
158
159 {
160 NULL,
161 NULL,
162 NULL
163 },
164 0,
165 0,
166 0,
167 0,
168
169 {
170 NULL,
171 NULL,
172 NULL,
173 NULL
174 },
175 (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *) NULL,
176 0,
177 0,
178
179 0,
180 (TEXT_OUT_AND_GOP_DATA *) NULL,
181 0,
182 (TEXT_OUT_SPLITTER_QUERY_DATA *) NULL,
183 0,
184 (INT32 *) NULL
185 };
186
187 //
188 // Standard Error Text Out Splitter Data Template
189 //
190 GLOBAL_REMOVE_IF_UNREFERENCED TEXT_OUT_SPLITTER_PRIVATE_DATA mStdErr = {
191 TEXT_OUT_SPLITTER_PRIVATE_DATA_SIGNATURE,
192 (EFI_HANDLE) NULL,
193 {
194 ConSplitterTextOutReset,
195 ConSplitterTextOutOutputString,
196 ConSplitterTextOutTestString,
197 ConSplitterTextOutQueryMode,
198 ConSplitterTextOutSetMode,
199 ConSplitterTextOutSetAttribute,
200 ConSplitterTextOutClearScreen,
201 ConSplitterTextOutSetCursorPosition,
202 ConSplitterTextOutEnableCursor,
203 (EFI_SIMPLE_TEXT_OUTPUT_MODE *) NULL
204 },
205 {
206 1,
207 0,
208 0,
209 0,
210 0,
211 FALSE,
212 },
213
214 {
215 NULL,
216 NULL,
217 NULL
218 },
219 0,
220 0,
221 0,
222 0,
223
224 {
225 NULL,
226 NULL,
227 NULL,
228 NULL
229 },
230 (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *) NULL,
231 0,
232 0,
233
234 0,
235 (TEXT_OUT_AND_GOP_DATA *) NULL,
236 0,
237 (TEXT_OUT_SPLITTER_QUERY_DATA *) NULL,
238 0,
239 (INT32 *) NULL
240 };
241
242 //
243 // Driver binding instance for Console Input Device
244 //
245 EFI_DRIVER_BINDING_PROTOCOL gConSplitterConInDriverBinding = {
246 ConSplitterConInDriverBindingSupported,
247 ConSplitterConInDriverBindingStart,
248 ConSplitterConInDriverBindingStop,
249 0xa,
250 NULL,
251 NULL
252 };
253
254 //
255 // Driver binding instance for Console Out device
256 //
257 EFI_DRIVER_BINDING_PROTOCOL gConSplitterConOutDriverBinding = {
258 ConSplitterConOutDriverBindingSupported,
259 ConSplitterConOutDriverBindingStart,
260 ConSplitterConOutDriverBindingStop,
261 0xa,
262 NULL,
263 NULL
264 };
265
266 //
267 // Driver binding instance for Standard Error device
268 //
269 EFI_DRIVER_BINDING_PROTOCOL gConSplitterStdErrDriverBinding = {
270 ConSplitterStdErrDriverBindingSupported,
271 ConSplitterStdErrDriverBindingStart,
272 ConSplitterStdErrDriverBindingStop,
273 0xa,
274 NULL,
275 NULL
276 };
277
278 //
279 // Driver binding instance for Simple Pointer protocol
280 //
281 EFI_DRIVER_BINDING_PROTOCOL gConSplitterSimplePointerDriverBinding = {
282 ConSplitterSimplePointerDriverBindingSupported,
283 ConSplitterSimplePointerDriverBindingStart,
284 ConSplitterSimplePointerDriverBindingStop,
285 0xa,
286 NULL,
287 NULL
288 };
289
290 //
291 // Driver binding instance for Absolute Pointer protocol
292 //
293 EFI_DRIVER_BINDING_PROTOCOL gConSplitterAbsolutePointerDriverBinding = {
294 ConSplitterAbsolutePointerDriverBindingSupported,
295 ConSplitterAbsolutePointerDriverBindingStart,
296 ConSplitterAbsolutePointerDriverBindingStop,
297 0xa,
298 NULL,
299 NULL
300 };
301
302 /**
303 The Entry Point for module ConSplitter. The user code starts with this function.
304
305 Installs driver module protocols and. Creates virtual device handles for ConIn,
306 ConOut, and StdErr. Installs Simple Text In protocol, Simple Text In Ex protocol,
307 Simple Pointer protocol, Absolute Pointer protocol on those virtual handlers.
308 Installs Graphics Output protocol and/or UGA Draw protocol if needed.
309
310 @param[in] ImageHandle The firmware allocated handle for the EFI image.
311 @param[in] SystemTable A pointer to the EFI System Table.
312
313 @retval EFI_SUCCESS The entry point is executed successfully.
314 @retval other Some error occurs when executing this entry point.
315
316 **/
317 EFI_STATUS
318 EFIAPI
319 ConSplitterDriverEntry(
320 IN EFI_HANDLE ImageHandle,
321 IN EFI_SYSTEM_TABLE *SystemTable
322 )
323 {
324 EFI_STATUS Status;
325
326 //
327 // Install driver model protocol(s).
328 //
329 Status = EfiLibInstallDriverBindingComponentName2 (
330 ImageHandle,
331 SystemTable,
332 &gConSplitterConInDriverBinding,
333 ImageHandle,
334 &gConSplitterConInComponentName,
335 &gConSplitterConInComponentName2
336 );
337 ASSERT_EFI_ERROR (Status);
338
339 Status = EfiLibInstallDriverBindingComponentName2 (
340 ImageHandle,
341 SystemTable,
342 &gConSplitterSimplePointerDriverBinding,
343 NULL,
344 &gConSplitterSimplePointerComponentName,
345 &gConSplitterSimplePointerComponentName2
346 );
347 ASSERT_EFI_ERROR (Status);
348
349 Status = EfiLibInstallDriverBindingComponentName2 (
350 ImageHandle,
351 SystemTable,
352 &gConSplitterAbsolutePointerDriverBinding,
353 NULL,
354 &gConSplitterAbsolutePointerComponentName,
355 &gConSplitterAbsolutePointerComponentName2
356 );
357 ASSERT_EFI_ERROR (Status);
358
359 Status = EfiLibInstallDriverBindingComponentName2 (
360 ImageHandle,
361 SystemTable,
362 &gConSplitterConOutDriverBinding,
363 NULL,
364 &gConSplitterConOutComponentName,
365 &gConSplitterConOutComponentName2
366 );
367 ASSERT_EFI_ERROR (Status);
368
369 Status = EfiLibInstallDriverBindingComponentName2 (
370 ImageHandle,
371 SystemTable,
372 &gConSplitterStdErrDriverBinding,
373 NULL,
374 &gConSplitterStdErrComponentName,
375 &gConSplitterStdErrComponentName2
376 );
377 ASSERT_EFI_ERROR (Status);
378
379 //
380 // Either Graphics Output protocol or UGA Draw protocol must be supported.
381 //
382 ASSERT (FeaturePcdGet (PcdConOutGopSupport) ||
383 FeaturePcdGet (PcdConOutUgaSupport));
384
385 //
386 // The driver creates virtual handles for ConIn, ConOut, StdErr.
387 // The virtual handles will always exist even if no console exist in the
388 // system. This is need to support hotplug devices like USB.
389 //
390 //
391 // Create virtual device handle for ConIn Splitter
392 //
393 Status = ConSplitterTextInConstructor (&mConIn);
394 if (!EFI_ERROR (Status)) {
395 Status = gBS->InstallMultipleProtocolInterfaces (
396 &mConIn.VirtualHandle,
397 &gEfiSimpleTextInProtocolGuid,
398 &mConIn.TextIn,
399 &gEfiSimpleTextInputExProtocolGuid,
400 &mConIn.TextInEx,
401 &gEfiSimplePointerProtocolGuid,
402 &mConIn.SimplePointer,
403 &gEfiAbsolutePointerProtocolGuid,
404 &mConIn.AbsolutePointer,
405 NULL
406 );
407 if (!EFI_ERROR (Status)) {
408 //
409 // Update the EFI System Table with new virtual console
410 // and update the pointer to Simple Text Input protocol.
411 //
412 gST->ConsoleInHandle = mConIn.VirtualHandle;
413 gST->ConIn = &mConIn.TextIn;
414 }
415 }
416 //
417 // Create virtual device handle for ConOut Splitter
418 //
419 Status = ConSplitterTextOutConstructor (&mConOut);
420 if (!EFI_ERROR (Status)) {
421 Status = gBS->InstallMultipleProtocolInterfaces (
422 &mConOut.VirtualHandle,
423 &gEfiSimpleTextOutProtocolGuid,
424 &mConOut.TextOut,
425 NULL
426 );
427 if (!EFI_ERROR (Status)) {
428 //
429 // Update the EFI System Table with new virtual console
430 // and Update the pointer to Text Output protocol.
431 //
432 gST->ConsoleOutHandle = mConOut.VirtualHandle;
433 gST->ConOut = &mConOut.TextOut;
434 }
435
436 }
437
438 //
439 // Create virtual device handle for StdErr Splitter
440 //
441 Status = ConSplitterTextOutConstructor (&mStdErr);
442 if (!EFI_ERROR (Status)) {
443 Status = gBS->InstallMultipleProtocolInterfaces (
444 &mStdErr.VirtualHandle,
445 &gEfiSimpleTextOutProtocolGuid,
446 &mStdErr.TextOut,
447 NULL
448 );
449 if (!EFI_ERROR (Status)) {
450 //
451 // Update the EFI System Table with new virtual console
452 // and update the pointer to Text Output protocol.
453 //
454 gST->StandardErrorHandle = mStdErr.VirtualHandle;
455 gST->StdErr = &mStdErr.TextOut;
456 }
457 }
458
459 //
460 // Update the CRC32 in the EFI System Table header
461 //
462 gST->Hdr.CRC32 = 0;
463 gBS->CalculateCrc32 (
464 (UINT8 *) &gST->Hdr,
465 gST->Hdr.HeaderSize,
466 &gST->Hdr.CRC32
467 );
468
469 return EFI_SUCCESS;
470
471 }
472
473 /**
474 Construct console input devices' private data.
475
476 @param ConInPrivate A pointer to the TEXT_IN_SPLITTER_PRIVATE_DATA
477 structure.
478
479 @retval EFI_OUT_OF_RESOURCES Out of resources.
480 @retval EFI_SUCCESS Text Input Devcie's private data has been constructed.
481 @retval other Failed to construct private data.
482
483 **/
484 EFI_STATUS
485 ConSplitterTextInConstructor (
486 TEXT_IN_SPLITTER_PRIVATE_DATA *ConInPrivate
487 )
488 {
489 EFI_STATUS Status;
490
491 //
492 // Allocate buffer for Simple Text Input device
493 //
494 Status = ConSplitterGrowBuffer (
495 sizeof (EFI_SIMPLE_TEXT_INPUT_PROTOCOL *),
496 &ConInPrivate->TextInListCount,
497 (VOID **) &ConInPrivate->TextInList
498 );
499 if (EFI_ERROR (Status)) {
500 return EFI_OUT_OF_RESOURCES;
501 }
502
503 //
504 // Create Event to wait for a key
505 //
506 Status = gBS->CreateEvent (
507 EVT_NOTIFY_WAIT,
508 TPL_NOTIFY,
509 ConSplitterTextInWaitForKey,
510 ConInPrivate,
511 &ConInPrivate->TextIn.WaitForKey
512 );
513 ASSERT_EFI_ERROR (Status);
514
515 //
516 // Allocate buffer for Simple Text Input Ex device
517 //
518 Status = ConSplitterGrowBuffer (
519 sizeof (EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *),
520 &ConInPrivate->TextInExListCount,
521 (VOID **) &ConInPrivate->TextInExList
522 );
523 if (EFI_ERROR (Status)) {
524 return EFI_OUT_OF_RESOURCES;
525 }
526 //
527 // Create Event to wait for a key Ex
528 //
529 Status = gBS->CreateEvent (
530 EVT_NOTIFY_WAIT,
531 TPL_NOTIFY,
532 ConSplitterTextInWaitForKey,
533 ConInPrivate,
534 &ConInPrivate->TextInEx.WaitForKeyEx
535 );
536 ASSERT_EFI_ERROR (Status);
537
538 InitializeListHead (&ConInPrivate->NotifyList);
539
540 ConInPrivate->AbsolutePointer.Mode = &ConInPrivate->AbsolutePointerMode;
541 //
542 // Allocate buffer for Absolute Pointer device
543 //
544 Status = ConSplitterGrowBuffer (
545 sizeof (EFI_ABSOLUTE_POINTER_PROTOCOL *),
546 &ConInPrivate->AbsolutePointerListCount,
547 (VOID **) &ConInPrivate->AbsolutePointerList
548 );
549 if (EFI_ERROR (Status)) {
550 return EFI_OUT_OF_RESOURCES;
551 }
552 //
553 // Create Event to wait for device input for Absolute pointer device
554 //
555 Status = gBS->CreateEvent (
556 EVT_NOTIFY_WAIT,
557 TPL_NOTIFY,
558 ConSplitterAbsolutePointerWaitForInput,
559 ConInPrivate,
560 &ConInPrivate->AbsolutePointer.WaitForInput
561 );
562 ASSERT_EFI_ERROR (Status);
563
564 ConInPrivate->SimplePointer.Mode = &ConInPrivate->SimplePointerMode;
565 //
566 // Allocate buffer for Simple Pointer device
567 //
568 Status = ConSplitterGrowBuffer (
569 sizeof (EFI_SIMPLE_POINTER_PROTOCOL *),
570 &ConInPrivate->PointerListCount,
571 (VOID **) &ConInPrivate->PointerList
572 );
573 if (EFI_ERROR (Status)) {
574 return EFI_OUT_OF_RESOURCES;
575 }
576 //
577 // Create Event to wait for device input for Simple pointer device
578 //
579 Status = gBS->CreateEvent (
580 EVT_NOTIFY_WAIT,
581 TPL_NOTIFY,
582 ConSplitterSimplePointerWaitForInput,
583 ConInPrivate,
584 &ConInPrivate->SimplePointer.WaitForInput
585 );
586 ASSERT_EFI_ERROR (Status);
587 //
588 // Create Event to signal ConIn connection request
589 //
590 Status = gBS->CreateEventEx (
591 EVT_NOTIFY_SIGNAL,
592 TPL_CALLBACK,
593 ConSplitterEmptyCallbackFunction,
594 NULL,
595 &gConnectConInEventGuid,
596 &ConInPrivate->ConnectConInEvent
597 );
598
599 return Status;
600 }
601
602 /**
603 Construct console output devices' private data.
604
605 @param ConOutPrivate A pointer to the TEXT_OUT_SPLITTER_PRIVATE_DATA
606 structure.
607
608 @retval EFI_OUT_OF_RESOURCES Out of resources.
609 @retval EFI_SUCCESS Text Input Devcie's private data has been constructed.
610
611 **/
612 EFI_STATUS
613 ConSplitterTextOutConstructor (
614 TEXT_OUT_SPLITTER_PRIVATE_DATA *ConOutPrivate
615 )
616 {
617 EFI_STATUS Status;
618 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
619
620 //
621 // Copy protocols template
622 //
623 if (FeaturePcdGet (PcdConOutUgaSupport)) {
624 CopyMem (&ConOutPrivate->UgaDraw, &mUgaDrawProtocolTemplate, sizeof (EFI_UGA_DRAW_PROTOCOL));
625 }
626 if (FeaturePcdGet (PcdConOutGopSupport)) {
627 CopyMem (&ConOutPrivate->GraphicsOutput, &mGraphicsOutputProtocolTemplate, sizeof (EFI_GRAPHICS_OUTPUT_PROTOCOL));
628 }
629
630 //
631 // Initilize console output splitter's private data.
632 //
633 ConOutPrivate->TextOut.Mode = &ConOutPrivate->TextOutMode;
634
635 //
636 // When new console device is added, the new mode will be set later,
637 // so put current mode back to init state.
638 //
639 ConOutPrivate->TextOutMode.Mode = 0xFF;
640 //
641 // Allocate buffer for Console Out device
642 //
643 Status = ConSplitterGrowBuffer (
644 sizeof (TEXT_OUT_AND_GOP_DATA),
645 &ConOutPrivate->TextOutListCount,
646 (VOID **) &ConOutPrivate->TextOutList
647 );
648 if (EFI_ERROR (Status)) {
649 return EFI_OUT_OF_RESOURCES;
650 }
651 //
652 // Allocate buffer for Text Out query data
653 //
654 Status = ConSplitterGrowBuffer (
655 sizeof (TEXT_OUT_SPLITTER_QUERY_DATA),
656 &ConOutPrivate->TextOutQueryDataCount,
657 (VOID **) &ConOutPrivate->TextOutQueryData
658 );
659 if (EFI_ERROR (Status)) {
660 return EFI_OUT_OF_RESOURCES;
661 }
662
663 //
664 // Setup the default console to 80 x 25 and mode to 0
665 //
666 ConOutPrivate->TextOutQueryData[0].Columns = 80;
667 ConOutPrivate->TextOutQueryData[0].Rows = 25;
668 TextOutSetMode (ConOutPrivate, 0);
669
670
671 if (FeaturePcdGet (PcdConOutUgaSupport)) {
672 //
673 // Setup the UgaDraw to 800 x 600 x 32 bits per pixel, 60Hz.
674 //
675 ConSplitterUgaDrawSetMode (&ConOutPrivate->UgaDraw, 800, 600, 32, 60);
676 }
677 if (FeaturePcdGet (PcdConOutGopSupport)) {
678 //
679 // Setup resource for mode information in Graphics Output Protocol interface
680 //
681 if ((ConOutPrivate->GraphicsOutput.Mode = AllocateZeroPool (sizeof (EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE))) == NULL) {
682 return EFI_OUT_OF_RESOURCES;
683 }
684 if ((ConOutPrivate->GraphicsOutput.Mode->Info = AllocateZeroPool (sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION))) == NULL) {
685 return EFI_OUT_OF_RESOURCES;
686 }
687 //
688 // Setup the DevNullGraphicsOutput to 800 x 600 x 32 bits per pixel
689 // DevNull will be updated to user-defined mode after driver has started.
690 //
691 if ((ConOutPrivate->GraphicsOutputModeBuffer = AllocateZeroPool (sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION))) == NULL) {
692 return EFI_OUT_OF_RESOURCES;
693 }
694 Info = &ConOutPrivate->GraphicsOutputModeBuffer[0];
695 Info->Version = 0;
696 Info->HorizontalResolution = 800;
697 Info->VerticalResolution = 600;
698 Info->PixelFormat = PixelBltOnly;
699 Info->PixelsPerScanLine = 800;
700 CopyMem (ConOutPrivate->GraphicsOutput.Mode->Info, Info, sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
701 ConOutPrivate->GraphicsOutput.Mode->SizeOfInfo = sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION);
702
703 //
704 // Initialize the following items, theset items remain unchanged in GraphicsOutput->SetMode()
705 // GraphicsOutputMode->FrameBufferBase, GraphicsOutputMode->FrameBufferSize
706 //
707 ConOutPrivate->GraphicsOutput.Mode->FrameBufferBase = (EFI_PHYSICAL_ADDRESS) (UINTN) NULL;
708 ConOutPrivate->GraphicsOutput.Mode->FrameBufferSize = 0;
709
710 ConOutPrivate->GraphicsOutput.Mode->MaxMode = 1;
711 //
712 // Initial current mode to unknown state, and then set to mode 0
713 //
714 ConOutPrivate->GraphicsOutput.Mode->Mode = 0xffff;
715 ConOutPrivate->GraphicsOutput.SetMode (&ConOutPrivate->GraphicsOutput, 0);
716 }
717
718 return EFI_SUCCESS;
719 }
720
721
722 /**
723 Test to see if the specified protocol could be supported on the specified device.
724
725 @param This Driver Binding protocol pointer.
726 @param ControllerHandle Handle of device to test.
727 @param Guid The specified protocol.
728
729 @retval EFI_SUCCESS The specified protocol is supported on this device.
730 @retval EFI_UNSUPPORTED The specified protocol attempts to be installed on virtul handle.
731 @retval other Failed to open specified protocol on this device.
732
733 **/
734 EFI_STATUS
735 ConSplitterSupported (
736 IN EFI_DRIVER_BINDING_PROTOCOL *This,
737 IN EFI_HANDLE ControllerHandle,
738 IN EFI_GUID *Guid
739 )
740 {
741 EFI_STATUS Status;
742 VOID *Instance;
743
744 //
745 // Make sure the Console Splitter does not attempt to attach to itself
746 //
747 if (ControllerHandle == mConIn.VirtualHandle ||
748 ControllerHandle == mConOut.VirtualHandle ||
749 ControllerHandle == mStdErr.VirtualHandle
750 ) {
751 return EFI_UNSUPPORTED;
752 }
753
754 //
755 // Check to see whether the specific protocol could be opened BY_DRIVER
756 //
757 Status = gBS->OpenProtocol (
758 ControllerHandle,
759 Guid,
760 &Instance,
761 This->DriverBindingHandle,
762 ControllerHandle,
763 EFI_OPEN_PROTOCOL_BY_DRIVER
764 );
765
766 if (EFI_ERROR (Status)) {
767 return Status;
768 }
769
770 gBS->CloseProtocol (
771 ControllerHandle,
772 Guid,
773 This->DriverBindingHandle,
774 ControllerHandle
775 );
776
777 return EFI_SUCCESS;
778 }
779
780 /**
781 Test to see if Console In Device could be supported on the Controller.
782
783 @param This Driver Binding protocol instance pointer.
784 @param ControllerHandle Handle of device to test.
785 @param RemainingDevicePath Optional parameter use to pick a specific child
786 device to start.
787
788 @retval EFI_SUCCESS This driver supports this device.
789 @retval other This driver does not support this device.
790
791 **/
792 EFI_STATUS
793 EFIAPI
794 ConSplitterConInDriverBindingSupported (
795 IN EFI_DRIVER_BINDING_PROTOCOL *This,
796 IN EFI_HANDLE ControllerHandle,
797 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
798 )
799 {
800 return ConSplitterSupported (
801 This,
802 ControllerHandle,
803 &gEfiConsoleInDeviceGuid
804 );
805 }
806
807 /**
808 Test to see if Simple Pointer protocol could be supported on the Controller.
809
810 @param This Driver Binding protocol instance pointer.
811 @param ControllerHandle Handle of device to test.
812 @param RemainingDevicePath Optional parameter use to pick a specific child
813 device to start.
814
815 @retval EFI_SUCCESS This driver supports this device.
816 @retval other This driver does not support this device.
817
818 **/
819 EFI_STATUS
820 EFIAPI
821 ConSplitterSimplePointerDriverBindingSupported (
822 IN EFI_DRIVER_BINDING_PROTOCOL *This,
823 IN EFI_HANDLE ControllerHandle,
824 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
825 )
826 {
827 return ConSplitterSupported (
828 This,
829 ControllerHandle,
830 &gEfiSimplePointerProtocolGuid
831 );
832 }
833
834 /**
835 Test to see if Absolute Pointer protocol could be supported on the Controller.
836
837 @param This Driver Binding protocol instance pointer.
838 @param ControllerHandle Handle of device to test.
839 @param RemainingDevicePath Optional parameter use to pick a specific child
840 device to start.
841
842 @retval EFI_SUCCESS This driver supports this device.
843 @retval other This driver does not support this device.
844
845 **/
846 EFI_STATUS
847 EFIAPI
848 ConSplitterAbsolutePointerDriverBindingSupported (
849 IN EFI_DRIVER_BINDING_PROTOCOL *This,
850 IN EFI_HANDLE ControllerHandle,
851 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
852 )
853 {
854 return ConSplitterSupported (
855 This,
856 ControllerHandle,
857 &gEfiAbsolutePointerProtocolGuid
858 );
859 }
860
861
862 /**
863 Test to see if Console Out Device could be supported on the Controller.
864
865 @param This Driver Binding protocol instance pointer.
866 @param ControllerHandle Handle of device to test.
867 @param RemainingDevicePath Optional parameter use to pick a specific child
868 device to start.
869
870 @retval EFI_SUCCESS This driver supports this device.
871 @retval other This driver does not support this device.
872
873 **/
874 EFI_STATUS
875 EFIAPI
876 ConSplitterConOutDriverBindingSupported (
877 IN EFI_DRIVER_BINDING_PROTOCOL *This,
878 IN EFI_HANDLE ControllerHandle,
879 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
880 )
881 {
882 return ConSplitterSupported (
883 This,
884 ControllerHandle,
885 &gEfiConsoleOutDeviceGuid
886 );
887 }
888
889 /**
890 Test to see if Standard Error Device could be supported on the Controller.
891
892 @param This Driver Binding protocol instance pointer.
893 @param ControllerHandle Handle of device to test.
894 @param RemainingDevicePath Optional parameter use to pick a specific child
895 device to start.
896
897 @retval EFI_SUCCESS This driver supports this device.
898 @retval other This driver does not support this device.
899
900 **/
901 EFI_STATUS
902 EFIAPI
903 ConSplitterStdErrDriverBindingSupported (
904 IN EFI_DRIVER_BINDING_PROTOCOL *This,
905 IN EFI_HANDLE ControllerHandle,
906 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
907 )
908 {
909 return ConSplitterSupported (
910 This,
911 ControllerHandle,
912 &gEfiStandardErrorDeviceGuid
913 );
914 }
915
916
917 /**
918 Start ConSplitter on devcie handle by opening Console Device Guid on device handle
919 and the console virtual handle. And Get the console interface on controller handle.
920
921 @param This Driver Binding protocol instance pointer.
922 @param ControllerHandle Handle of device.
923 @param ConSplitterVirtualHandle Console virtual Handle.
924 @param DeviceGuid The specified Console Device, such as ConInDev,
925 ConOutDev.
926 @param InterfaceGuid The specified protocol to be opened.
927 @param Interface Protocol interface returned.
928
929 @retval EFI_SUCCESS This driver supports this device.
930 @retval other Failed to open the specified Console Device Guid
931 or specified protocol.
932
933 **/
934 EFI_STATUS
935 ConSplitterStart (
936 IN EFI_DRIVER_BINDING_PROTOCOL *This,
937 IN EFI_HANDLE ControllerHandle,
938 IN EFI_HANDLE ConSplitterVirtualHandle,
939 IN EFI_GUID *DeviceGuid,
940 IN EFI_GUID *InterfaceGuid,
941 OUT VOID **Interface
942 )
943 {
944 EFI_STATUS Status;
945 VOID *Instance;
946
947 //
948 // Check to see whether the ControllerHandle has the DeviceGuid on it.
949 //
950 Status = gBS->OpenProtocol (
951 ControllerHandle,
952 DeviceGuid,
953 &Instance,
954 This->DriverBindingHandle,
955 ControllerHandle,
956 EFI_OPEN_PROTOCOL_BY_DRIVER
957 );
958 if (EFI_ERROR (Status)) {
959 return Status;
960 }
961
962 //
963 // Open the Parent Handle for the child.
964 //
965 Status = gBS->OpenProtocol (
966 ControllerHandle,
967 DeviceGuid,
968 &Instance,
969 This->DriverBindingHandle,
970 ConSplitterVirtualHandle,
971 EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
972 );
973 if (EFI_ERROR (Status)) {
974 goto Err;
975 }
976
977 //
978 // Open InterfaceGuid on the virtul handle.
979 //
980 Status = gBS->OpenProtocol (
981 ControllerHandle,
982 InterfaceGuid,
983 Interface,
984 This->DriverBindingHandle,
985 ConSplitterVirtualHandle,
986 EFI_OPEN_PROTOCOL_GET_PROTOCOL
987 );
988
989 if (!EFI_ERROR (Status)) {
990 return EFI_SUCCESS;
991 }
992
993 //
994 // close the DeviceGuid on ConSplitter VirtualHandle.
995 //
996 gBS->CloseProtocol (
997 ControllerHandle,
998 DeviceGuid,
999 This->DriverBindingHandle,
1000 ConSplitterVirtualHandle
1001 );
1002
1003 Err:
1004 //
1005 // close the DeviceGuid on ControllerHandle.
1006 //
1007 gBS->CloseProtocol (
1008 ControllerHandle,
1009 DeviceGuid,
1010 This->DriverBindingHandle,
1011 ControllerHandle
1012 );
1013
1014 return Status;
1015 }
1016
1017
1018 /**
1019 Start Console In Consplitter on device handle.
1020
1021 @param This Driver Binding protocol instance pointer.
1022 @param ControllerHandle Handle of device to bind driver to.
1023 @param RemainingDevicePath Optional parameter use to pick a specific child
1024 device to start.
1025
1026 @retval EFI_SUCCESS Console In Consplitter is added to ControllerHandle.
1027 @retval other Console In Consplitter does not support this device.
1028
1029 **/
1030 EFI_STATUS
1031 EFIAPI
1032 ConSplitterConInDriverBindingStart (
1033 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1034 IN EFI_HANDLE ControllerHandle,
1035 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
1036 )
1037 {
1038 EFI_STATUS Status;
1039 EFI_SIMPLE_TEXT_INPUT_PROTOCOL *TextIn;
1040 EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *TextInEx;
1041
1042 //
1043 // Start ConSplitter on ControllerHandle, and create the virtual
1044 // agrogated console device on first call Start for a SimpleTextIn handle.
1045 //
1046 Status = ConSplitterStart (
1047 This,
1048 ControllerHandle,
1049 mConIn.VirtualHandle,
1050 &gEfiConsoleInDeviceGuid,
1051 &gEfiSimpleTextInProtocolGuid,
1052 (VOID **) &TextIn
1053 );
1054 if (EFI_ERROR (Status)) {
1055 return Status;
1056 }
1057
1058 //
1059 // Add this device into Text In devices list.
1060 //
1061 Status = ConSplitterTextInAddDevice (&mConIn, TextIn);
1062 if (EFI_ERROR (Status)) {
1063 return Status;
1064 }
1065
1066 Status = gBS->OpenProtocol (
1067 ControllerHandle,
1068 &gEfiSimpleTextInputExProtocolGuid,
1069 (VOID **) &TextInEx,
1070 This->DriverBindingHandle,
1071 mConIn.VirtualHandle,
1072 EFI_OPEN_PROTOCOL_GET_PROTOCOL
1073 );
1074 if (!EFI_ERROR (Status)) {
1075 //
1076 // If Simple Text Input Ex protocol exists,
1077 // add this device into Text In Ex devices list.
1078 //
1079 Status = ConSplitterTextInExAddDevice (&mConIn, TextInEx);
1080 }
1081
1082 return Status;
1083 }
1084
1085
1086 /**
1087 Start Simple Pointer Consplitter on device handle.
1088
1089 @param This Driver Binding protocol instance pointer.
1090 @param ControllerHandle Handle of device to bind driver to.
1091 @param RemainingDevicePath Optional parameter use to pick a specific child
1092 device to start.
1093
1094 @retval EFI_SUCCESS Simple Pointer Consplitter is added to ControllerHandle.
1095 @retval other Simple Pointer Consplitter does not support this device.
1096
1097 **/
1098 EFI_STATUS
1099 EFIAPI
1100 ConSplitterSimplePointerDriverBindingStart (
1101 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1102 IN EFI_HANDLE ControllerHandle,
1103 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
1104 )
1105 {
1106 EFI_STATUS Status;
1107 EFI_SIMPLE_POINTER_PROTOCOL *SimplePointer;
1108
1109 //
1110 // Start ConSplitter on ControllerHandle, and create the virtual
1111 // agrogated console device on first call Start for a SimplePointer handle.
1112 //
1113 Status = ConSplitterStart (
1114 This,
1115 ControllerHandle,
1116 mConIn.VirtualHandle,
1117 &gEfiSimplePointerProtocolGuid,
1118 &gEfiSimplePointerProtocolGuid,
1119 (VOID **) &SimplePointer
1120 );
1121 if (EFI_ERROR (Status)) {
1122 return Status;
1123 }
1124
1125 //
1126 // Add this devcie into Simple Pointer devices list.
1127 //
1128 return ConSplitterSimplePointerAddDevice (&mConIn, SimplePointer);
1129 }
1130
1131
1132 /**
1133 Start Absolute Pointer Consplitter on device handle.
1134
1135 @param This Driver Binding protocol instance pointer.
1136 @param ControllerHandle Handle of device to bind driver to.
1137 @param RemainingDevicePath Optional parameter use to pick a specific child
1138 device to start.
1139
1140 @retval EFI_SUCCESS Absolute Pointer Consplitter is added to ControllerHandle.
1141 @retval other Absolute Pointer Consplitter does not support this device.
1142
1143 **/
1144 EFI_STATUS
1145 EFIAPI
1146 ConSplitterAbsolutePointerDriverBindingStart (
1147 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1148 IN EFI_HANDLE ControllerHandle,
1149 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
1150 )
1151 {
1152 EFI_STATUS Status;
1153 EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointer;
1154
1155 //
1156 // Start ConSplitter on ControllerHandle, and create the virtual
1157 // agrogated console device on first call Start for a AbsolutePointer handle.
1158 //
1159 Status = ConSplitterStart (
1160 This,
1161 ControllerHandle,
1162 mConIn.VirtualHandle,
1163 &gEfiAbsolutePointerProtocolGuid,
1164 &gEfiAbsolutePointerProtocolGuid,
1165 (VOID **) &AbsolutePointer
1166 );
1167
1168 if (EFI_ERROR (Status)) {
1169 return Status;
1170 }
1171
1172 //
1173 // Add this devcie into Absolute Pointer devices list.
1174 //
1175 return ConSplitterAbsolutePointerAddDevice (&mConIn, AbsolutePointer);
1176 }
1177
1178
1179 /**
1180 Start Console Out Consplitter on device handle.
1181
1182 @param This Driver Binding protocol instance pointer.
1183 @param ControllerHandle Handle of device to bind driver to.
1184 @param RemainingDevicePath Optional parameter use to pick a specific child
1185 device to start.
1186
1187 @retval EFI_SUCCESS Console Out Consplitter is added to ControllerHandle.
1188 @retval other Console Out Consplitter does not support this device.
1189
1190 **/
1191 EFI_STATUS
1192 EFIAPI
1193 ConSplitterConOutDriverBindingStart (
1194 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1195 IN EFI_HANDLE ControllerHandle,
1196 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
1197 )
1198 {
1199 EFI_STATUS Status;
1200 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
1201 EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput;
1202 EFI_UGA_DRAW_PROTOCOL *UgaDraw;
1203 UINTN SizeOfInfo;
1204 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
1205
1206 //
1207 // Start ConSplitter on ControllerHandle, and create the virtual
1208 // agrogated console device on first call Start for a ConsoleOut handle.
1209 //
1210 Status = ConSplitterStart (
1211 This,
1212 ControllerHandle,
1213 mConOut.VirtualHandle,
1214 &gEfiConsoleOutDeviceGuid,
1215 &gEfiSimpleTextOutProtocolGuid,
1216 (VOID **) &TextOut
1217 );
1218 if (EFI_ERROR (Status)) {
1219 return Status;
1220 }
1221
1222 GraphicsOutput = NULL;
1223 UgaDraw = NULL;
1224 //
1225 // Try to Open Graphics Output protocol
1226 //
1227 Status = gBS->OpenProtocol (
1228 ControllerHandle,
1229 &gEfiGraphicsOutputProtocolGuid,
1230 (VOID **) &GraphicsOutput,
1231 This->DriverBindingHandle,
1232 mConOut.VirtualHandle,
1233 EFI_OPEN_PROTOCOL_GET_PROTOCOL
1234 );
1235
1236 if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
1237 //
1238 // Open UGA DRAW protocol
1239 //
1240 gBS->OpenProtocol (
1241 ControllerHandle,
1242 &gEfiUgaDrawProtocolGuid,
1243 (VOID **) &UgaDraw,
1244 This->DriverBindingHandle,
1245 mConOut.VirtualHandle,
1246 EFI_OPEN_PROTOCOL_GET_PROTOCOL
1247 );
1248 }
1249
1250 //
1251 // When new console device is added, the new mode will be set later,
1252 // so put current mode back to init state.
1253 //
1254 mConOut.TextOutMode.Mode = 0xFF;
1255
1256 //
1257 // If both ConOut and StdErr incorporate the same Text Out device,
1258 // their MaxMode and QueryData should be the intersection of both.
1259 //
1260 Status = ConSplitterTextOutAddDevice (&mConOut, TextOut, GraphicsOutput, UgaDraw);
1261 ConSplitterTextOutSetAttribute (&mConOut.TextOut, EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK));
1262
1263 if (FeaturePcdGet (PcdConOutUgaSupport)) {
1264 //
1265 // Get the UGA mode data of ConOut from the current mode
1266 //
1267 if (GraphicsOutput != NULL) {
1268 Status = GraphicsOutput->QueryMode (GraphicsOutput, GraphicsOutput->Mode->Mode, &SizeOfInfo, &Info);
1269 if (EFI_ERROR (Status)) {
1270 return Status;
1271 }
1272 ASSERT ( SizeOfInfo <= sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
1273
1274 mConOut.UgaHorizontalResolution = Info->HorizontalResolution;
1275 mConOut.UgaVerticalResolution = Info->VerticalResolution;
1276 mConOut.UgaColorDepth = 32;
1277 mConOut.UgaRefreshRate = 60;
1278
1279 FreePool (Info);
1280
1281 } else if (UgaDraw != NULL) {
1282 Status = UgaDraw->GetMode (
1283 UgaDraw,
1284 &mConOut.UgaHorizontalResolution,
1285 &mConOut.UgaVerticalResolution,
1286 &mConOut.UgaColorDepth,
1287 &mConOut.UgaRefreshRate
1288 );
1289 }
1290 }
1291
1292 return Status;
1293 }
1294
1295
1296 /**
1297 Start Standard Error Consplitter on device handle.
1298
1299 @param This Driver Binding protocol instance pointer.
1300 @param ControllerHandle Handle of device to bind driver to.
1301 @param RemainingDevicePath Optional parameter use to pick a specific child
1302 device to start.
1303
1304 @retval EFI_SUCCESS Standard Error Consplitter is added to ControllerHandle.
1305 @retval other Standard Error Consplitter does not support this device.
1306
1307 **/
1308 EFI_STATUS
1309 EFIAPI
1310 ConSplitterStdErrDriverBindingStart (
1311 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1312 IN EFI_HANDLE ControllerHandle,
1313 IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
1314 )
1315 {
1316 EFI_STATUS Status;
1317 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
1318
1319 //
1320 // Start ConSplitter on ControllerHandle, and create the virtual
1321 // agrogated console device on first call Start for a StandardError handle.
1322 //
1323 Status = ConSplitterStart (
1324 This,
1325 ControllerHandle,
1326 mStdErr.VirtualHandle,
1327 &gEfiStandardErrorDeviceGuid,
1328 &gEfiSimpleTextOutProtocolGuid,
1329 (VOID **) &TextOut
1330 );
1331 if (EFI_ERROR (Status)) {
1332 return Status;
1333 }
1334
1335 //
1336 // When new console device is added, the new mode will be set later,
1337 // so put current mode back to init state.
1338 //
1339 mStdErr.TextOutMode.Mode = 0xFF;
1340
1341 //
1342 // If both ConOut and StdErr incorporate the same Text Out device,
1343 // their MaxMode and QueryData should be the intersection of both.
1344 //
1345 Status = ConSplitterTextOutAddDevice (&mStdErr, TextOut, NULL, NULL);
1346 ConSplitterTextOutSetAttribute (&mStdErr.TextOut, EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK));
1347 if (EFI_ERROR (Status)) {
1348 return Status;
1349 }
1350
1351 return Status;
1352 }
1353
1354
1355 /**
1356 Stop ConSplitter on device handle by closing Console Device Guid on device handle
1357 and the console virtual handle.
1358
1359 @param This Protocol instance pointer.
1360 @param ControllerHandle Handle of device.
1361 @param ConSplitterVirtualHandle Console virtual Handle.
1362 @param DeviceGuid The specified Console Device, such as ConInDev,
1363 ConOutDev.
1364 @param InterfaceGuid The specified protocol to be opened.
1365 @param Interface Protocol interface returned.
1366
1367 @retval EFI_SUCCESS Stop ConSplitter on ControllerHandle successfully.
1368 @retval other Failed to Stop ConSplitter on ControllerHandle.
1369
1370 **/
1371 EFI_STATUS
1372 ConSplitterStop (
1373 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1374 IN EFI_HANDLE ControllerHandle,
1375 IN EFI_HANDLE ConSplitterVirtualHandle,
1376 IN EFI_GUID *DeviceGuid,
1377 IN EFI_GUID *InterfaceGuid,
1378 IN VOID **Interface
1379 )
1380 {
1381 EFI_STATUS Status;
1382
1383 Status = gBS->OpenProtocol (
1384 ControllerHandle,
1385 InterfaceGuid,
1386 Interface,
1387 This->DriverBindingHandle,
1388 ControllerHandle,
1389 EFI_OPEN_PROTOCOL_GET_PROTOCOL
1390 );
1391 if (EFI_ERROR (Status)) {
1392 return Status;
1393 }
1394 //
1395 // close the protocol refered.
1396 //
1397 gBS->CloseProtocol (
1398 ControllerHandle,
1399 DeviceGuid,
1400 This->DriverBindingHandle,
1401 ConSplitterVirtualHandle
1402 );
1403
1404 gBS->CloseProtocol (
1405 ControllerHandle,
1406 DeviceGuid,
1407 This->DriverBindingHandle,
1408 ControllerHandle
1409 );
1410
1411 return EFI_SUCCESS;
1412 }
1413
1414
1415 /**
1416 Stop Console In ConSplitter on ControllerHandle by closing Console In Devcice GUID.
1417
1418 @param This Driver Binding protocol instance pointer.
1419 @param ControllerHandle Handle of device to stop driver on
1420 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
1421 children is zero stop the entire bus driver.
1422 @param ChildHandleBuffer List of Child Handles to Stop.
1423
1424 @retval EFI_SUCCESS This driver is removed ControllerHandle
1425 @retval other This driver was not removed from this device
1426
1427 **/
1428 EFI_STATUS
1429 EFIAPI
1430 ConSplitterConInDriverBindingStop (
1431 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1432 IN EFI_HANDLE ControllerHandle,
1433 IN UINTN NumberOfChildren,
1434 IN EFI_HANDLE *ChildHandleBuffer
1435 )
1436 {
1437 EFI_STATUS Status;
1438 EFI_SIMPLE_TEXT_INPUT_PROTOCOL *TextIn;
1439 EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *TextInEx;
1440
1441 if (NumberOfChildren == 0) {
1442 return EFI_SUCCESS;
1443 }
1444
1445 Status = gBS->OpenProtocol (
1446 ControllerHandle,
1447 &gEfiSimpleTextInputExProtocolGuid,
1448 (VOID **) &TextInEx,
1449 This->DriverBindingHandle,
1450 ControllerHandle,
1451 EFI_OPEN_PROTOCOL_GET_PROTOCOL
1452 );
1453 if (!EFI_ERROR (Status)) {
1454 //
1455 // If Simple Text Input Ex protocol exists,
1456 // remove device from Text Input Ex devices list.
1457 //
1458 Status = ConSplitterTextInExDeleteDevice (&mConIn, TextInEx);
1459 if (EFI_ERROR (Status)) {
1460 return Status;
1461 }
1462 }
1463
1464 //
1465 // Close Simple Text In protocol on controller handle and virtual handle.
1466 //
1467 Status = ConSplitterStop (
1468 This,
1469 ControllerHandle,
1470 mConIn.VirtualHandle,
1471 &gEfiConsoleInDeviceGuid,
1472 &gEfiSimpleTextInProtocolGuid,
1473 (VOID **) &TextIn
1474 );
1475 if (EFI_ERROR (Status)) {
1476 return Status;
1477 }
1478
1479 //
1480 // Remove device from Text Input devices list.
1481 //
1482 return ConSplitterTextInDeleteDevice (&mConIn, TextIn);
1483 }
1484
1485
1486 /**
1487 Stop Simple Pointer protocol ConSplitter on ControllerHandle by closing
1488 Simple Pointer protocol.
1489
1490 @param This Driver Binding protocol instance pointer.
1491 @param ControllerHandle Handle of device to stop driver on
1492 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
1493 children is zero stop the entire bus driver.
1494 @param ChildHandleBuffer List of Child Handles to Stop.
1495
1496 @retval EFI_SUCCESS This driver is removed ControllerHandle
1497 @retval other This driver was not removed from this device
1498
1499 **/
1500 EFI_STATUS
1501 EFIAPI
1502 ConSplitterSimplePointerDriverBindingStop (
1503 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1504 IN EFI_HANDLE ControllerHandle,
1505 IN UINTN NumberOfChildren,
1506 IN EFI_HANDLE *ChildHandleBuffer
1507 )
1508 {
1509 EFI_STATUS Status;
1510 EFI_SIMPLE_POINTER_PROTOCOL *SimplePointer;
1511
1512 if (NumberOfChildren == 0) {
1513 return EFI_SUCCESS;
1514 }
1515
1516 //
1517 // Close Simple Pointer protocol on controller handle and virtual handle.
1518 //
1519 Status = ConSplitterStop (
1520 This,
1521 ControllerHandle,
1522 mConIn.VirtualHandle,
1523 &gEfiSimplePointerProtocolGuid,
1524 &gEfiSimplePointerProtocolGuid,
1525 (VOID **) &SimplePointer
1526 );
1527 if (EFI_ERROR (Status)) {
1528 return Status;
1529 }
1530
1531 //
1532 // Remove this device from Simple Pointer device list.
1533 //
1534 return ConSplitterSimplePointerDeleteDevice (&mConIn, SimplePointer);
1535 }
1536
1537
1538 /**
1539 Stop Absolute Pointer protocol ConSplitter on ControllerHandle by closing
1540 Absolute Pointer protocol.
1541
1542 @param This Driver Binding protocol instance pointer.
1543 @param ControllerHandle Handle of device to stop driver on
1544 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
1545 children is zero stop the entire bus driver.
1546 @param ChildHandleBuffer List of Child Handles to Stop.
1547
1548 @retval EFI_SUCCESS This driver is removed ControllerHandle
1549 @retval other This driver was not removed from this device
1550
1551 **/
1552 EFI_STATUS
1553 EFIAPI
1554 ConSplitterAbsolutePointerDriverBindingStop (
1555 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1556 IN EFI_HANDLE ControllerHandle,
1557 IN UINTN NumberOfChildren,
1558 IN EFI_HANDLE *ChildHandleBuffer
1559 )
1560 {
1561 EFI_STATUS Status;
1562 EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointer;
1563
1564 if (NumberOfChildren == 0) {
1565 return EFI_SUCCESS;
1566 }
1567
1568 //
1569 // Close Absolute Pointer protocol on controller handle and virtual handle.
1570 //
1571 Status = ConSplitterStop (
1572 This,
1573 ControllerHandle,
1574 mConIn.VirtualHandle,
1575 &gEfiAbsolutePointerProtocolGuid,
1576 &gEfiAbsolutePointerProtocolGuid,
1577 (VOID **) &AbsolutePointer
1578 );
1579 if (EFI_ERROR (Status)) {
1580 return Status;
1581 }
1582
1583 //
1584 // Remove this device from Absolute Pointer device list.
1585 //
1586 return ConSplitterAbsolutePointerDeleteDevice (&mConIn, AbsolutePointer);
1587 }
1588
1589
1590 /**
1591 Stop Console Out ConSplitter on device handle by closing Console Out Devcice GUID.
1592
1593 @param This Driver Binding protocol instance pointer.
1594 @param ControllerHandle Handle of device to stop driver on
1595 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
1596 children is zero stop the entire bus driver.
1597 @param ChildHandleBuffer List of Child Handles to Stop.
1598
1599 @retval EFI_SUCCESS This driver is removed ControllerHandle
1600 @retval other This driver was not removed from this device
1601
1602 **/
1603 EFI_STATUS
1604 EFIAPI
1605 ConSplitterConOutDriverBindingStop (
1606 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1607 IN EFI_HANDLE ControllerHandle,
1608 IN UINTN NumberOfChildren,
1609 IN EFI_HANDLE *ChildHandleBuffer
1610 )
1611 {
1612 EFI_STATUS Status;
1613 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
1614
1615 if (NumberOfChildren == 0) {
1616 return EFI_SUCCESS;
1617 }
1618
1619 //
1620 // Close Absolute Pointer protocol on controller handle and virtual handle.
1621 //
1622 Status = ConSplitterStop (
1623 This,
1624 ControllerHandle,
1625 mConOut.VirtualHandle,
1626 &gEfiConsoleOutDeviceGuid,
1627 &gEfiSimpleTextOutProtocolGuid,
1628 (VOID **) &TextOut
1629 );
1630 if (EFI_ERROR (Status)) {
1631 return Status;
1632 }
1633
1634 //
1635 // Remove this device from Text Out device list.
1636 //
1637 return ConSplitterTextOutDeleteDevice (&mConOut, TextOut);
1638 }
1639
1640
1641 /**
1642 Stop Standard Error ConSplitter on ControllerHandle by closing Standard Error GUID.
1643
1644 @param This Driver Binding protocol instance pointer.
1645 @param ControllerHandle Handle of device to stop driver on
1646 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
1647 children is zero stop the entire bus driver.
1648 @param ChildHandleBuffer List of Child Handles to Stop.
1649
1650 @retval EFI_SUCCESS This driver is removed ControllerHandle
1651 @retval other This driver was not removed from this device
1652
1653 **/
1654 EFI_STATUS
1655 EFIAPI
1656 ConSplitterStdErrDriverBindingStop (
1657 IN EFI_DRIVER_BINDING_PROTOCOL *This,
1658 IN EFI_HANDLE ControllerHandle,
1659 IN UINTN NumberOfChildren,
1660 IN EFI_HANDLE *ChildHandleBuffer
1661 )
1662 {
1663 EFI_STATUS Status;
1664 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
1665
1666 if (NumberOfChildren == 0) {
1667 return EFI_SUCCESS;
1668 }
1669
1670 //
1671 // Close Standard Error Device on controller handle and virtual handle.
1672 //
1673 Status = ConSplitterStop (
1674 This,
1675 ControllerHandle,
1676 mStdErr.VirtualHandle,
1677 &gEfiStandardErrorDeviceGuid,
1678 &gEfiSimpleTextOutProtocolGuid,
1679 (VOID **) &TextOut
1680 );
1681 if (EFI_ERROR (Status)) {
1682 return Status;
1683 }
1684 //
1685 // Delete this console error out device's data structures.
1686 //
1687 return ConSplitterTextOutDeleteDevice (&mStdErr, TextOut);
1688 }
1689
1690
1691 /**
1692 Take the passed in Buffer of size ElementSize and grow the buffer
1693 by CONSOLE_SPLITTER_ALLOC_UNIT * ElementSize bytes.
1694 Copy the current data in Buffer to the new version of Buffer and
1695 free the old version of buffer.
1696
1697 @param ElementSize Size of element in array.
1698 @param Count Current number of elements in array.
1699 @param Buffer Bigger version of passed in Buffer with all the
1700 data.
1701
1702 @retval EFI_SUCCESS Buffer size has grown.
1703 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
1704
1705 **/
1706 EFI_STATUS
1707 ConSplitterGrowBuffer (
1708 IN UINTN ElementSize,
1709 IN OUT UINTN *Count,
1710 IN OUT VOID **Buffer
1711 )
1712 {
1713 VOID *Ptr;
1714
1715 //
1716 // grow the buffer to new buffer size,
1717 // copy the old buffer's content to the new-size buffer,
1718 // then free the old buffer.
1719 //
1720 Ptr = ReallocatePool (
1721 ElementSize * (*Count),
1722 ElementSize * ((*Count) + CONSOLE_SPLITTER_ALLOC_UNIT),
1723 *Buffer
1724 );
1725 if (Ptr == NULL) {
1726 return EFI_OUT_OF_RESOURCES;
1727 }
1728 *Count += CONSOLE_SPLITTER_ALLOC_UNIT;
1729 *Buffer = Ptr;
1730 return EFI_SUCCESS;
1731 }
1732
1733
1734 /**
1735 Add Text Input Device in Consplitter Text Input list.
1736
1737 @param Private Text In Splitter pointer.
1738 @param TextIn Simple Text Input protocol pointer.
1739
1740 @retval EFI_SUCCESS Text Input Device added successfully.
1741 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
1742
1743 **/
1744 EFI_STATUS
1745 ConSplitterTextInAddDevice (
1746 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1747 IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *TextIn
1748 )
1749 {
1750 EFI_STATUS Status;
1751
1752 //
1753 // If the Text In List is full, enlarge it by calling ConSplitterGrowBuffer().
1754 //
1755 if (Private->CurrentNumberOfConsoles >= Private->TextInListCount) {
1756 Status = ConSplitterGrowBuffer (
1757 sizeof (EFI_SIMPLE_TEXT_INPUT_PROTOCOL *),
1758 &Private->TextInListCount,
1759 (VOID **) &Private->TextInList
1760 );
1761 if (EFI_ERROR (Status)) {
1762 return EFI_OUT_OF_RESOURCES;
1763 }
1764 }
1765 //
1766 // Add the new text-in device data structure into the Text In List.
1767 //
1768 Private->TextInList[Private->CurrentNumberOfConsoles] = TextIn;
1769 Private->CurrentNumberOfConsoles++;
1770
1771 //
1772 // Extra CheckEvent added to reduce the double CheckEvent().
1773 //
1774 gBS->CheckEvent (TextIn->WaitForKey);
1775
1776 return EFI_SUCCESS;
1777 }
1778
1779
1780 /**
1781 Remove Text Input Device from Consplitter Text Input list.
1782
1783 @param Private Text In Splitter pointer.
1784 @param TextIn Simple Text protocol pointer.
1785
1786 @retval EFI_SUCCESS Simple Text Device removed successfully.
1787 @retval EFI_NOT_FOUND No Simple Text Device found.
1788
1789 **/
1790 EFI_STATUS
1791 ConSplitterTextInDeleteDevice (
1792 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1793 IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *TextIn
1794 )
1795 {
1796 UINTN Index;
1797 //
1798 // Remove the specified text-in device data structure from the Text In List,
1799 // and rearrange the remaining data structures in the Text In List.
1800 //
1801 for (Index = 0; Index < Private->CurrentNumberOfConsoles; Index++) {
1802 if (Private->TextInList[Index] == TextIn) {
1803 for (; Index < Private->CurrentNumberOfConsoles - 1; Index++) {
1804 Private->TextInList[Index] = Private->TextInList[Index + 1];
1805 }
1806
1807 Private->CurrentNumberOfConsoles--;
1808 return EFI_SUCCESS;
1809 }
1810 }
1811
1812 return EFI_NOT_FOUND;
1813 }
1814
1815 /**
1816 Add Text Input Ex Device in Consplitter Text Input Ex list.
1817
1818 @param Private Text In Splitter pointer.
1819 @param TextInEx Simple Text Input Ex Input protocol pointer.
1820
1821 @retval EFI_SUCCESS Text Input Ex Device added successfully.
1822 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
1823
1824 **/
1825 EFI_STATUS
1826 ConSplitterTextInExAddDevice (
1827 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1828 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *TextInEx
1829 )
1830 {
1831 EFI_STATUS Status;
1832 LIST_ENTRY *Link;
1833 TEXT_IN_EX_SPLITTER_NOTIFY *CurrentNotify;
1834 UINTN TextInExListCount;
1835
1836 //
1837 // Enlarge the NotifyHandleList and the TextInExList
1838 //
1839 if (Private->CurrentNumberOfExConsoles >= Private->TextInExListCount) {
1840 for (Link = Private->NotifyList.ForwardLink; Link != &Private->NotifyList; Link = Link->ForwardLink) {
1841 CurrentNotify = TEXT_IN_EX_SPLITTER_NOTIFY_FROM_THIS (Link);
1842 TextInExListCount = Private->TextInExListCount;
1843
1844 Status = ConSplitterGrowBuffer (
1845 sizeof (EFI_HANDLE),
1846 &TextInExListCount,
1847 (VOID **) &CurrentNotify->NotifyHandleList
1848 );
1849 if (EFI_ERROR (Status)) {
1850 return EFI_OUT_OF_RESOURCES;
1851 }
1852 }
1853 Status = ConSplitterGrowBuffer (
1854 sizeof (EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *),
1855 &Private->TextInExListCount,
1856 (VOID **) &Private->TextInExList
1857 );
1858 if (EFI_ERROR (Status)) {
1859 return EFI_OUT_OF_RESOURCES;
1860 }
1861 }
1862
1863 //
1864 // Register the key notify in the new text-in device
1865 //
1866 for (Link = Private->NotifyList.ForwardLink; Link != &Private->NotifyList; Link = Link->ForwardLink) {
1867 CurrentNotify = TEXT_IN_EX_SPLITTER_NOTIFY_FROM_THIS (Link);
1868 Status = TextInEx->RegisterKeyNotify (
1869 TextInEx,
1870 &CurrentNotify->KeyData,
1871 CurrentNotify->KeyNotificationFn,
1872 &CurrentNotify->NotifyHandleList[Private->CurrentNumberOfExConsoles]
1873 );
1874 if (EFI_ERROR (Status)) {
1875 for (Link = Link->BackLink; Link != &Private->NotifyList; Link = Link->BackLink) {
1876 CurrentNotify = TEXT_IN_EX_SPLITTER_NOTIFY_FROM_THIS (Link);
1877 TextInEx->UnregisterKeyNotify (
1878 TextInEx,
1879 CurrentNotify->NotifyHandleList[Private->CurrentNumberOfExConsoles]
1880 );
1881 }
1882 return Status;
1883 }
1884 }
1885
1886 //
1887 // Add the new text-in device data structure into the Text Input Ex List.
1888 //
1889 Private->TextInExList[Private->CurrentNumberOfExConsoles] = TextInEx;
1890 Private->CurrentNumberOfExConsoles++;
1891
1892 //
1893 // Extra CheckEvent added to reduce the double CheckEvent().
1894 //
1895 gBS->CheckEvent (TextInEx->WaitForKeyEx);
1896
1897 return EFI_SUCCESS;
1898 }
1899
1900 /**
1901 Remove Text Ex Device from Consplitter Text Input Ex list.
1902
1903 @param Private Text In Splitter pointer.
1904 @param TextInEx Simple Text Ex protocol pointer.
1905
1906 @retval EFI_SUCCESS Simple Text Input Ex Device removed successfully.
1907 @retval EFI_NOT_FOUND No Simple Text Input Ex Device found.
1908
1909 **/
1910 EFI_STATUS
1911 ConSplitterTextInExDeleteDevice (
1912 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1913 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *TextInEx
1914 )
1915 {
1916 UINTN Index;
1917 //
1918 // Remove the specified text-in device data structure from the Text Input Ex List,
1919 // and rearrange the remaining data structures in the Text In List.
1920 //
1921 for (Index = 0; Index < Private->CurrentNumberOfExConsoles; Index++) {
1922 if (Private->TextInExList[Index] == TextInEx) {
1923 for (; Index < Private->CurrentNumberOfExConsoles - 1; Index++) {
1924 Private->TextInExList[Index] = Private->TextInExList[Index + 1];
1925 }
1926
1927 Private->CurrentNumberOfExConsoles--;
1928 return EFI_SUCCESS;
1929 }
1930 }
1931
1932 return EFI_NOT_FOUND;
1933 }
1934
1935
1936 /**
1937 Add Simple Pointer Device in Consplitter Simple Pointer list.
1938
1939 @param Private Text In Splitter pointer.
1940 @param SimplePointer Simple Pointer protocol pointer.
1941
1942 @retval EFI_SUCCESS Simple Pointer Device added successfully.
1943 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
1944
1945 **/
1946 EFI_STATUS
1947 ConSplitterSimplePointerAddDevice (
1948 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1949 IN EFI_SIMPLE_POINTER_PROTOCOL *SimplePointer
1950 )
1951 {
1952 EFI_STATUS Status;
1953
1954 //
1955 // If the Simple Pointer List is full, enlarge it by calling ConSplitterGrowBuffer().
1956 //
1957 if (Private->CurrentNumberOfPointers >= Private->PointerListCount) {
1958 Status = ConSplitterGrowBuffer (
1959 sizeof (EFI_SIMPLE_POINTER_PROTOCOL *),
1960 &Private->PointerListCount,
1961 (VOID **) &Private->PointerList
1962 );
1963 if (EFI_ERROR (Status)) {
1964 return EFI_OUT_OF_RESOURCES;
1965 }
1966 }
1967 //
1968 // Add the new text-in device data structure into the Simple Pointer List.
1969 //
1970 Private->PointerList[Private->CurrentNumberOfPointers] = SimplePointer;
1971 Private->CurrentNumberOfPointers++;
1972
1973 return EFI_SUCCESS;
1974 }
1975
1976
1977 /**
1978 Remove Simple Pointer Device from Consplitter Simple Pointer list.
1979
1980 @param Private Text In Splitter pointer.
1981 @param SimplePointer Simple Pointer protocol pointer.
1982
1983 @retval EFI_SUCCESS Simple Pointer Device removed successfully.
1984 @retval EFI_NOT_FOUND No Simple Pointer Device found.
1985
1986 **/
1987 EFI_STATUS
1988 ConSplitterSimplePointerDeleteDevice (
1989 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
1990 IN EFI_SIMPLE_POINTER_PROTOCOL *SimplePointer
1991 )
1992 {
1993 UINTN Index;
1994 //
1995 // Remove the specified text-in device data structure from the Simple Pointer List,
1996 // and rearrange the remaining data structures in the Text In List.
1997 //
1998 for (Index = 0; Index < Private->CurrentNumberOfPointers; Index++) {
1999 if (Private->PointerList[Index] == SimplePointer) {
2000 for (; Index < Private->CurrentNumberOfPointers - 1; Index++) {
2001 Private->PointerList[Index] = Private->PointerList[Index + 1];
2002 }
2003
2004 Private->CurrentNumberOfPointers--;
2005 return EFI_SUCCESS;
2006 }
2007 }
2008
2009 return EFI_NOT_FOUND;
2010 }
2011
2012
2013 /**
2014 Add Absolute Pointer Device in Consplitter Absolute Pointer list.
2015
2016 @param Private Text In Splitter pointer.
2017 @param AbsolutePointer Absolute Pointer protocol pointer.
2018
2019 @retval EFI_SUCCESS Absolute Pointer Device added successfully.
2020 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
2021
2022 **/
2023 EFI_STATUS
2024 ConSplitterAbsolutePointerAddDevice (
2025 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
2026 IN EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointer
2027 )
2028 {
2029 EFI_STATUS Status;
2030
2031 //
2032 // If the Absolute Pointer List is full, enlarge it by calling ConSplitterGrowBuffer().
2033 //
2034 if (Private->CurrentNumberOfAbsolutePointers >= Private->AbsolutePointerListCount) {
2035 Status = ConSplitterGrowBuffer (
2036 sizeof (EFI_ABSOLUTE_POINTER_PROTOCOL *),
2037 &Private->AbsolutePointerListCount,
2038 (VOID **) &Private->AbsolutePointerList
2039 );
2040 if (EFI_ERROR (Status)) {
2041 return EFI_OUT_OF_RESOURCES;
2042 }
2043 }
2044 //
2045 // Add the new text-in device data structure into the Absolute Pointer List.
2046 //
2047 Private->AbsolutePointerList[Private->CurrentNumberOfAbsolutePointers] = AbsolutePointer;
2048 Private->CurrentNumberOfAbsolutePointers++;
2049
2050 return EFI_SUCCESS;
2051 }
2052
2053
2054 /**
2055 Remove Absolute Pointer Device from Consplitter Absolute Pointer list.
2056
2057 @param Private Text In Splitter pointer.
2058 @param AbsolutePointer Absolute Pointer protocol pointer.
2059
2060 @retval EFI_SUCCESS Absolute Pointer Device removed successfully.
2061 @retval EFI_NOT_FOUND No Absolute Pointer Device found.
2062
2063 **/
2064 EFI_STATUS
2065 ConSplitterAbsolutePointerDeleteDevice (
2066 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
2067 IN EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointer
2068 )
2069 {
2070 UINTN Index;
2071 //
2072 // Remove the specified text-in device data structure from the Absolute Pointer List,
2073 // and rearrange the remaining data structures from the Absolute Pointer List.
2074 //
2075 for (Index = 0; Index < Private->CurrentNumberOfAbsolutePointers; Index++) {
2076 if (Private->AbsolutePointerList[Index] == AbsolutePointer) {
2077 for (; Index < Private->CurrentNumberOfAbsolutePointers - 1; Index++) {
2078 Private->AbsolutePointerList[Index] = Private->AbsolutePointerList[Index + 1];
2079 }
2080
2081 Private->CurrentNumberOfAbsolutePointers--;
2082 return EFI_SUCCESS;
2083 }
2084 }
2085
2086 return EFI_NOT_FOUND;
2087 }
2088
2089 /**
2090 Reallocate Text Out mode map.
2091
2092 Allocate new buffer and copy original buffer into the new buffer.
2093
2094 @param Private Consplitter Text Out pointer.
2095
2096 @retval EFI_SUCCESS Buffer size has grown
2097 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
2098
2099 **/
2100 EFI_STATUS
2101 ConSplitterGrowMapTable (
2102 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private
2103 )
2104 {
2105 UINTN Size;
2106 UINTN NewSize;
2107 UINTN TotalSize;
2108 INT32 *TextOutModeMap;
2109 INT32 *OldTextOutModeMap;
2110 INT32 *SrcAddress;
2111 INT32 Index;
2112 UINTN OldStepSize;
2113 UINTN NewStepSize;
2114
2115 NewSize = Private->TextOutListCount * sizeof (INT32);
2116 OldTextOutModeMap = Private->TextOutModeMap;
2117 TotalSize = NewSize * (Private->TextOutQueryDataCount);
2118
2119 //
2120 // Allocate new buffer for Text Out List.
2121 //
2122 TextOutModeMap = AllocatePool (TotalSize);
2123 if (TextOutModeMap == NULL) {
2124 return EFI_OUT_OF_RESOURCES;
2125 }
2126
2127 SetMem (TextOutModeMap, TotalSize, 0xFF);
2128 Private->TextOutModeMap = TextOutModeMap;
2129
2130 //
2131 // If TextOutList has been enlarged, need to realloc the mode map table
2132 // The mode map table is regarded as a two dimension array.
2133 //
2134 // Old New
2135 // 0 ---------> TextOutListCount ----> TextOutListCount
2136 // | -------------------------------------------
2137 // | | | |
2138 // | | | |
2139 // | | | |
2140 // | | | |
2141 // | | | |
2142 // \/ | | |
2143 // -------------------------------------------
2144 // QueryDataCount
2145 //
2146 if (OldTextOutModeMap != NULL) {
2147
2148 Size = Private->CurrentNumberOfConsoles * sizeof (INT32);
2149 Index = 0;
2150 SrcAddress = OldTextOutModeMap;
2151 NewStepSize = NewSize / sizeof(INT32);
2152 // If Private->CurrentNumberOfConsoles is not zero and OldTextOutModeMap
2153 // is not NULL, it indicates that the original TextOutModeMap is not enough
2154 // for the new console devices and has been enlarged by CONSOLE_SPLITTER_ALLOC_UNIT columns.
2155 //
2156 OldStepSize = NewStepSize - CONSOLE_SPLITTER_ALLOC_UNIT;
2157
2158 //
2159 // Copy the old data to the new one
2160 //
2161 while (Index < Private->TextOutMode.MaxMode) {
2162 CopyMem (TextOutModeMap, SrcAddress, Size);
2163 //
2164 // Go to next row of new TextOutModeMap.
2165 //
2166 TextOutModeMap += NewStepSize;
2167 //
2168 // Go to next row of old TextOutModeMap.
2169 //
2170 SrcAddress += OldStepSize;
2171 Index++;
2172 }
2173 //
2174 // Free the old buffer
2175 //
2176 FreePool (OldTextOutModeMap);
2177 }
2178
2179 return EFI_SUCCESS;
2180 }
2181
2182
2183 /**
2184 Add new device's output mode to console splitter's mode list.
2185
2186 @param Private Text Out Splitter pointer
2187 @param TextOut Simple Text Output protocol pointer.
2188
2189 @retval EFI_SUCCESS Device added successfully.
2190 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
2191
2192 **/
2193 EFI_STATUS
2194 ConSplitterAddOutputMode (
2195 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private,
2196 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut
2197 )
2198 {
2199 EFI_STATUS Status;
2200 INT32 MaxMode;
2201 INT32 Mode;
2202 UINTN Index;
2203
2204 MaxMode = TextOut->Mode->MaxMode;
2205 Private->TextOutMode.MaxMode = MaxMode;
2206
2207 //
2208 // Grow the buffer if query data buffer is not large enough to
2209 // hold all the mode supported by the first console.
2210 //
2211 while (MaxMode > (INT32) Private->TextOutQueryDataCount) {
2212 Status = ConSplitterGrowBuffer (
2213 sizeof (TEXT_OUT_SPLITTER_QUERY_DATA),
2214 &Private->TextOutQueryDataCount,
2215 (VOID **) &Private->TextOutQueryData
2216 );
2217 if (EFI_ERROR (Status)) {
2218 return EFI_OUT_OF_RESOURCES;
2219 }
2220 }
2221 //
2222 // Allocate buffer for the output mode map
2223 //
2224 Status = ConSplitterGrowMapTable (Private);
2225 if (EFI_ERROR (Status)) {
2226 return EFI_OUT_OF_RESOURCES;
2227 }
2228 //
2229 // As the first textout device, directly add the mode in to QueryData
2230 // and at the same time record the mapping between QueryData and TextOut.
2231 //
2232 Mode = 0;
2233 Index = 0;
2234 while (Mode < MaxMode) {
2235 Status = TextOut->QueryMode (
2236 TextOut,
2237 Mode,
2238 &Private->TextOutQueryData[Mode].Columns,
2239 &Private->TextOutQueryData[Mode].Rows
2240 );
2241 //
2242 // If mode 1 (80x50) is not supported, make sure mode 1 in TextOutQueryData
2243 // is clear to 0x0.
2244 //
2245 if ((EFI_ERROR(Status)) && (Mode == 1)) {
2246 Private->TextOutQueryData[Mode].Columns = 0;
2247 Private->TextOutQueryData[Mode].Rows = 0;
2248 }
2249 Private->TextOutModeMap[Index] = Mode;
2250 Mode++;
2251 Index += Private->TextOutListCount;
2252 }
2253
2254 return EFI_SUCCESS;
2255 }
2256
2257 /**
2258 Reconstruct TextOutModeMap to get intersection of modes.
2259
2260 This routine reconstruct TextOutModeMap to get the intersection
2261 of modes for all console out devices. Because EFI/UEFI spec require
2262 mode 0 is 80x25, mode 1 is 80x50, this routine will not check the
2263 intersection for mode 0 and mode 1.
2264
2265 @param TextOutModeMap Current text out mode map, begin with the mode 80x25
2266 @param NewlyAddedMap New text out mode map, begin with the mode 80x25
2267 @param MapStepSize Mode step size for one console device
2268 @param NewMapStepSize New Mode step size for one console device
2269 @param MaxMode IN: Current max text mode, OUT: Updated max text mode.
2270 @param CurrentMode IN: Current text mode, OUT: Updated current text mode.
2271
2272 **/
2273 VOID
2274 ConSplitterGetIntersection (
2275 IN INT32 *TextOutModeMap,
2276 IN INT32 *NewlyAddedMap,
2277 IN UINTN MapStepSize,
2278 IN UINTN NewMapStepSize,
2279 IN OUT INT32 *MaxMode,
2280 IN OUT INT32 *CurrentMode
2281 )
2282 {
2283 INT32 Index;
2284 INT32 *CurrentMapEntry;
2285 INT32 *NextMapEntry;
2286 INT32 *NewMapEntry;
2287 INT32 CurrentMaxMode;
2288 INT32 Mode;
2289
2290 //
2291 // According to EFI/UEFI spec, mode 0 and mode 1 have been reserved
2292 // for 80x25 and 80x50 in Simple Text Out protocol, so don't make intersection
2293 // for mode 0 and mode 1, mode number starts from 2.
2294 //
2295 Index = 2;
2296 CurrentMapEntry = &TextOutModeMap[MapStepSize * 2];
2297 NextMapEntry = CurrentMapEntry;
2298 NewMapEntry = &NewlyAddedMap[NewMapStepSize * 2];
2299
2300 CurrentMaxMode = *MaxMode;
2301 Mode = *CurrentMode;
2302
2303 while (Index < CurrentMaxMode) {
2304 if (*NewMapEntry == -1) {
2305 //
2306 // This mode is not supported any more. Remove it. Special care
2307 // must be taken as this remove will also affect current mode;
2308 //
2309 if (Index == *CurrentMode) {
2310 Mode = -1;
2311 } else if (Index < *CurrentMode) {
2312 Mode--;
2313 }
2314 (*MaxMode)--;
2315 } else {
2316 if (CurrentMapEntry != NextMapEntry) {
2317 CopyMem (NextMapEntry, CurrentMapEntry, MapStepSize * sizeof (INT32));
2318 }
2319
2320 NextMapEntry += MapStepSize;
2321 }
2322
2323 CurrentMapEntry += MapStepSize;
2324 NewMapEntry += NewMapStepSize;
2325 Index++;
2326 }
2327
2328 *CurrentMode = Mode;
2329
2330 return ;
2331 }
2332
2333 /**
2334 Sync the device's output mode to console splitter's mode list.
2335
2336 @param Private Text Out Splitter pointer.
2337 @param TextOut Simple Text Output protocol pointer.
2338
2339 **/
2340 VOID
2341 ConSplitterSyncOutputMode (
2342 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private,
2343 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut
2344 )
2345 {
2346 INT32 CurrentMaxMode;
2347 INT32 Mode;
2348 INT32 Index;
2349 INT32 *TextOutModeMap;
2350 INT32 *MapTable;
2351 INT32 QueryMode;
2352 TEXT_OUT_SPLITTER_QUERY_DATA *TextOutQueryData;
2353 UINTN Rows;
2354 UINTN Columns;
2355 UINTN StepSize;
2356 EFI_STATUS Status;
2357
2358 //
2359 // Must make sure that current mode won't change even if mode number changes
2360 //
2361 CurrentMaxMode = Private->TextOutMode.MaxMode;
2362 TextOutModeMap = Private->TextOutModeMap;
2363 StepSize = Private->TextOutListCount;
2364 TextOutQueryData = Private->TextOutQueryData;
2365
2366 //
2367 // Query all the mode that the newly added TextOut supports
2368 //
2369 Mode = 0;
2370 MapTable = TextOutModeMap + Private->CurrentNumberOfConsoles;
2371 while (Mode < TextOut->Mode->MaxMode) {
2372 Status = TextOut->QueryMode (TextOut, Mode, &Columns, &Rows);
2373
2374 if (EFI_ERROR(Status)) {
2375 if (Mode == 1) {
2376 //
2377 // If mode 1 (80x50) is not supported, make sure mode 1 in TextOutQueryData
2378 // is clear to 0x0.
2379 //
2380 MapTable[StepSize] = Mode;
2381 TextOutQueryData[Mode].Columns = 0;
2382 TextOutQueryData[Mode].Rows = 0;
2383 }
2384 Mode++;
2385 continue;
2386 }
2387 //
2388 // Search the intersection map and QueryData database to see if they intersects
2389 //
2390 Index = 0;
2391 while (Index < CurrentMaxMode) {
2392 QueryMode = *(TextOutModeMap + Index * StepSize);
2393 if ((TextOutQueryData[QueryMode].Rows == Rows) && (TextOutQueryData[QueryMode].Columns == Columns)) {
2394 MapTable[Index * StepSize] = Mode;
2395 break;
2396 }
2397 Index++;
2398 }
2399 Mode++;
2400 }
2401 //
2402 // Now search the TextOutModeMap table to find the intersection of supported
2403 // mode between ConSplitter and the newly added device.
2404 //
2405 ConSplitterGetIntersection (
2406 TextOutModeMap,
2407 MapTable,
2408 StepSize,
2409 StepSize,
2410 &Private->TextOutMode.MaxMode,
2411 &Private->TextOutMode.Mode
2412 );
2413
2414 return ;
2415 }
2416
2417
2418 /**
2419 Sync output device between ConOut and StdErr output.
2420
2421 @retval EFI_SUCCESS Sync implemented successfully.
2422 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
2423
2424 **/
2425 EFI_STATUS
2426 ConSplitterGetIntersectionBetweenConOutAndStrErr (
2427 VOID
2428 )
2429 {
2430 UINTN ConOutNumOfConsoles;
2431 UINTN StdErrNumOfConsoles;
2432 TEXT_OUT_AND_GOP_DATA *ConOutTextOutList;
2433 TEXT_OUT_AND_GOP_DATA *StdErrTextOutList;
2434 UINTN Indexi;
2435 UINTN Indexj;
2436 UINTN ConOutRows;
2437 UINTN ConOutColumns;
2438 UINTN StdErrRows;
2439 UINTN StdErrColumns;
2440 INT32 ConOutMaxMode;
2441 INT32 StdErrMaxMode;
2442 INT32 ConOutMode;
2443 INT32 StdErrMode;
2444 INT32 Mode;
2445 INT32 Index;
2446 INT32 *ConOutModeMap;
2447 INT32 *StdErrModeMap;
2448 INT32 *ConOutMapTable;
2449 INT32 *StdErrMapTable;
2450 TEXT_OUT_SPLITTER_QUERY_DATA *ConOutQueryData;
2451 TEXT_OUT_SPLITTER_QUERY_DATA *StdErrQueryData;
2452 UINTN ConOutStepSize;
2453 UINTN StdErrStepSize;
2454 BOOLEAN FoundTheSameTextOut;
2455 UINTN ConOutMapTableSize;
2456 UINTN StdErrMapTableSize;
2457
2458 ConOutNumOfConsoles = mConOut.CurrentNumberOfConsoles;
2459 StdErrNumOfConsoles = mStdErr.CurrentNumberOfConsoles;
2460 ConOutTextOutList = mConOut.TextOutList;
2461 StdErrTextOutList = mStdErr.TextOutList;
2462
2463 Indexi = 0;
2464 FoundTheSameTextOut = FALSE;
2465 while ((Indexi < ConOutNumOfConsoles) && (!FoundTheSameTextOut)) {
2466 Indexj = 0;
2467 while (Indexj < StdErrNumOfConsoles) {
2468 if (ConOutTextOutList->TextOut == StdErrTextOutList->TextOut) {
2469 FoundTheSameTextOut = TRUE;
2470 break;
2471 }
2472
2473 Indexj++;
2474 StdErrTextOutList++;
2475 }
2476
2477 Indexi++;
2478 ConOutTextOutList++;
2479 }
2480
2481 if (!FoundTheSameTextOut) {
2482 return EFI_SUCCESS;
2483 }
2484 //
2485 // Must make sure that current mode won't change even if mode number changes
2486 //
2487 ConOutMaxMode = mConOut.TextOutMode.MaxMode;
2488 ConOutModeMap = mConOut.TextOutModeMap;
2489 ConOutStepSize = mConOut.TextOutListCount;
2490 ConOutQueryData = mConOut.TextOutQueryData;
2491
2492 StdErrMaxMode = mStdErr.TextOutMode.MaxMode;
2493 StdErrModeMap = mStdErr.TextOutModeMap;
2494 StdErrStepSize = mStdErr.TextOutListCount;
2495 StdErrQueryData = mStdErr.TextOutQueryData;
2496
2497 //
2498 // Allocate the map table and set the map table's index to -1.
2499 //
2500 ConOutMapTableSize = ConOutMaxMode * sizeof (INT32);
2501 ConOutMapTable = AllocateZeroPool (ConOutMapTableSize);
2502 if (ConOutMapTable == NULL) {
2503 return EFI_OUT_OF_RESOURCES;
2504 }
2505
2506 SetMem (ConOutMapTable, ConOutMapTableSize, 0xFF);
2507
2508 StdErrMapTableSize = StdErrMaxMode * sizeof (INT32);
2509 StdErrMapTable = AllocateZeroPool (StdErrMapTableSize);
2510 if (StdErrMapTable == NULL) {
2511 return EFI_OUT_OF_RESOURCES;
2512 }
2513
2514 SetMem (StdErrMapTable, StdErrMapTableSize, 0xFF);
2515
2516 //
2517 // Find the intersection of the two set of modes. If they actually intersect, the
2518 // correponding entry in the map table is set to 1.
2519 //
2520 Mode = 0;
2521 while (Mode < ConOutMaxMode) {
2522 //
2523 // Search the intersection map and QueryData database to see if they intersect
2524 //
2525 Index = 0;
2526 ConOutMode = *(ConOutModeMap + Mode * ConOutStepSize);
2527 ConOutRows = ConOutQueryData[ConOutMode].Rows;
2528 ConOutColumns = ConOutQueryData[ConOutMode].Columns;
2529 while (Index < StdErrMaxMode) {
2530 StdErrMode = *(StdErrModeMap + Index * StdErrStepSize);
2531 StdErrRows = StdErrQueryData[StdErrMode].Rows;
2532 StdErrColumns = StdErrQueryData[StdErrMode].Columns;
2533 if ((StdErrRows == ConOutRows) && (StdErrColumns == ConOutColumns)) {
2534 ConOutMapTable[Mode] = 1;
2535 StdErrMapTable[Index] = 1;
2536 break;
2537 }
2538
2539 Index++;
2540 }
2541
2542 Mode++;
2543 }
2544 //
2545 // Now search the TextOutModeMap table to find the intersection of supported
2546 // mode between ConSplitter and the newly added device.
2547 //
2548 ConSplitterGetIntersection (
2549 ConOutModeMap,
2550 ConOutMapTable,
2551 mConOut.TextOutListCount,
2552 1,
2553 &(mConOut.TextOutMode.MaxMode),
2554 &(mConOut.TextOutMode.Mode)
2555 );
2556
2557 if (mConOut.TextOutMode.Mode < 0) {
2558 mConOut.TextOut.SetMode (&(mConOut.TextOut), 0);
2559 }
2560
2561 ConSplitterGetIntersection (
2562 StdErrModeMap,
2563 StdErrMapTable,
2564 mStdErr.TextOutListCount,
2565 1,
2566 &(mStdErr.TextOutMode.MaxMode),
2567 &(mStdErr.TextOutMode.Mode)
2568 );
2569
2570 if (mStdErr.TextOutMode.Mode < 0) {
2571 mStdErr.TextOut.SetMode (&(mStdErr.TextOut), 0);
2572 }
2573
2574 FreePool (ConOutMapTable);
2575 FreePool (StdErrMapTable);
2576
2577 return EFI_SUCCESS;
2578 }
2579
2580
2581 /**
2582 Add Grahpics Output modes into Consplitter Text Out list.
2583
2584 @param Private Text Out Splitter pointer.
2585 @param GraphicsOutput Graphics Output protocol pointer.
2586 @param UgaDraw UGA Draw protocol pointer.
2587
2588 @retval EFI_SUCCESS Output mode added successfully.
2589 @retval other Failed to add output mode.
2590
2591 **/
2592 EFI_STATUS
2593 ConSplitterAddGraphicsOutputMode (
2594 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private,
2595 IN EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput,
2596 IN EFI_UGA_DRAW_PROTOCOL *UgaDraw
2597 )
2598 {
2599 EFI_STATUS Status;
2600 UINTN Index;
2601 UINTN CurrentIndex;
2602 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Mode;
2603 UINTN SizeOfInfo;
2604 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
2605 EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE *CurrentGraphicsOutputMode;
2606 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *ModeBuffer;
2607 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *MatchedMode;
2608 UINTN NumberIndex;
2609 BOOLEAN Match;
2610 BOOLEAN AlreadyExist;
2611 UINT32 UgaHorizontalResolution;
2612 UINT32 UgaVerticalResolution;
2613 UINT32 UgaColorDepth;
2614 UINT32 UgaRefreshRate;
2615
2616 ASSERT (GraphicsOutput != NULL || UgaDraw != NULL);
2617
2618 CurrentGraphicsOutputMode = Private->GraphicsOutput.Mode;
2619
2620 Index = 0;
2621 CurrentIndex = 0;
2622 Status = EFI_SUCCESS;
2623
2624 if (Private->CurrentNumberOfUgaDraw != 0) {
2625 //
2626 // If any UGA device has already been added, then there is no need to
2627 // calculate intersection of display mode of different GOP/UGA device,
2628 // since only one display mode will be exported (i.e. user-defined mode)
2629 //
2630 goto Done;
2631 }
2632
2633 if (GraphicsOutput != NULL) {
2634 if (Private->CurrentNumberOfGraphicsOutput == 0) {
2635 //
2636 // This is the first Graphics Output device added
2637 //
2638 CurrentGraphicsOutputMode->MaxMode = GraphicsOutput->Mode->MaxMode;
2639 CurrentGraphicsOutputMode->Mode = GraphicsOutput->Mode->Mode;
2640 CopyMem (CurrentGraphicsOutputMode->Info, GraphicsOutput->Mode->Info, GraphicsOutput->Mode->SizeOfInfo);
2641 CurrentGraphicsOutputMode->SizeOfInfo = GraphicsOutput->Mode->SizeOfInfo;
2642 CurrentGraphicsOutputMode->FrameBufferBase = GraphicsOutput->Mode->FrameBufferBase;
2643 CurrentGraphicsOutputMode->FrameBufferSize = GraphicsOutput->Mode->FrameBufferSize;
2644
2645 //
2646 // Allocate resource for the private mode buffer
2647 //
2648 ModeBuffer = AllocatePool (sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION) * GraphicsOutput->Mode->MaxMode);
2649 if (ModeBuffer == NULL) {
2650 return EFI_OUT_OF_RESOURCES;
2651 }
2652 FreePool (Private->GraphicsOutputModeBuffer);
2653 Private->GraphicsOutputModeBuffer = ModeBuffer;
2654
2655 //
2656 // Store all supported display modes to the private mode buffer
2657 //
2658 Mode = ModeBuffer;
2659 for (Index = 0; Index < GraphicsOutput->Mode->MaxMode; Index++) {
2660 //
2661 // The Info buffer would be allocated by callee
2662 //
2663 Status = GraphicsOutput->QueryMode (GraphicsOutput, (UINT32) Index, &SizeOfInfo, &Info);
2664 if (EFI_ERROR (Status)) {
2665 return Status;
2666 }
2667 ASSERT ( SizeOfInfo <= sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
2668 CopyMem (Mode, Info, SizeOfInfo);
2669 Mode++;
2670 FreePool (Info);
2671 }
2672 } else {
2673 //
2674 // Check intersection of display mode
2675 //
2676 ModeBuffer = AllocatePool (sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION) * CurrentGraphicsOutputMode->MaxMode);
2677 if (ModeBuffer == NULL) {
2678 return EFI_OUT_OF_RESOURCES;
2679 }
2680
2681 MatchedMode = ModeBuffer;
2682 Mode = &Private->GraphicsOutputModeBuffer[0];
2683 for (Index = 0; Index < CurrentGraphicsOutputMode->MaxMode; Index++) {
2684 Match = FALSE;
2685
2686 for (NumberIndex = 0; NumberIndex < GraphicsOutput->Mode->MaxMode; NumberIndex++) {
2687 //
2688 // The Info buffer would be allocated by callee
2689 //
2690 Status = GraphicsOutput->QueryMode (GraphicsOutput, (UINT32) NumberIndex, &SizeOfInfo, &Info);
2691 if (EFI_ERROR (Status)) {
2692 return Status;
2693 }
2694 if ((Info->HorizontalResolution == Mode->HorizontalResolution) &&
2695 (Info->VerticalResolution == Mode->VerticalResolution)) {
2696 //
2697 // If GOP device supports one mode in current mode buffer,
2698 // it will be added into matched mode buffer
2699 //
2700 Match = TRUE;
2701 FreePool (Info);
2702 break;
2703 }
2704 FreePool (Info);
2705 }
2706
2707 if (Match) {
2708 AlreadyExist = FALSE;
2709
2710 //
2711 // Check if GOP mode has been in the mode buffer, ModeBuffer = MatchedMode at begin.
2712 //
2713 for (Info = ModeBuffer; Info < MatchedMode; Info++) {
2714 if ((Info->HorizontalResolution == Mode->HorizontalResolution) &&
2715 (Info->VerticalResolution == Mode->VerticalResolution)) {
2716 AlreadyExist = TRUE;
2717 break;
2718 }
2719 }
2720
2721 if (!AlreadyExist) {
2722 CopyMem (MatchedMode, Mode, sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
2723
2724 //
2725 // Physical frame buffer is no longer available, change PixelFormat to PixelBltOnly
2726 //
2727 MatchedMode->Version = 0;
2728 MatchedMode->PixelFormat = PixelBltOnly;
2729 ZeroMem (&MatchedMode->PixelInformation, sizeof (EFI_PIXEL_BITMASK));
2730
2731 MatchedMode++;
2732 }
2733 }
2734
2735 Mode++;
2736 }
2737
2738 //
2739 // Drop the old mode buffer, assign it to a new one
2740 //
2741 FreePool (Private->GraphicsOutputModeBuffer);
2742 Private->GraphicsOutputModeBuffer = ModeBuffer;
2743
2744 //
2745 // Physical frame buffer is no longer available when there are more than one physical GOP devices
2746 //
2747 CurrentGraphicsOutputMode->MaxMode = (UINT32) (((UINTN) MatchedMode - (UINTN) ModeBuffer) / sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
2748 CurrentGraphicsOutputMode->Info->PixelFormat = PixelBltOnly;
2749 ZeroMem (&CurrentGraphicsOutputMode->Info->PixelInformation, sizeof (EFI_PIXEL_BITMASK));
2750 CurrentGraphicsOutputMode->SizeOfInfo = sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION);
2751 CurrentGraphicsOutputMode->FrameBufferBase = (EFI_PHYSICAL_ADDRESS) (UINTN) NULL;
2752 CurrentGraphicsOutputMode->FrameBufferSize = 0;
2753 }
2754
2755 //
2756 // Graphics console driver can ensure the same mode for all GOP devices
2757 //
2758 for (Index = 0; Index < CurrentGraphicsOutputMode->MaxMode; Index++) {
2759 Mode = &Private->GraphicsOutputModeBuffer[Index];
2760 if ((Mode->HorizontalResolution == GraphicsOutput->Mode->Info->HorizontalResolution) &&
2761 (Mode->VerticalResolution == GraphicsOutput->Mode->Info->VerticalResolution)) {
2762 CurrentIndex = Index;
2763 break;
2764 }
2765 }
2766 if (Index >= CurrentGraphicsOutputMode->MaxMode) {
2767 //
2768 // if user defined mode is not found, set to default mode 800x600
2769 //
2770 for (Index = 0; Index < CurrentGraphicsOutputMode->MaxMode; Index++) {
2771 Mode = &Private->GraphicsOutputModeBuffer[Index];
2772 if ((Mode->HorizontalResolution == 800) && (Mode->VerticalResolution == 600)) {
2773 CurrentIndex = Index;
2774 break;
2775 }
2776 }
2777 }
2778 } else if (UgaDraw != NULL) {
2779 //
2780 // Graphics console driver can ensure the same mode for all GOP devices
2781 // so we can get the current mode from this video device
2782 //
2783 UgaDraw->GetMode (
2784 UgaDraw,
2785 &UgaHorizontalResolution,
2786 &UgaVerticalResolution,
2787 &UgaColorDepth,
2788 &UgaRefreshRate
2789 );
2790
2791 CurrentGraphicsOutputMode->MaxMode = 1;
2792 Info = CurrentGraphicsOutputMode->Info;
2793 Info->Version = 0;
2794 Info->HorizontalResolution = UgaHorizontalResolution;
2795 Info->VerticalResolution = UgaVerticalResolution;
2796 Info->PixelFormat = PixelBltOnly;
2797 Info->PixelsPerScanLine = UgaHorizontalResolution;
2798 CurrentGraphicsOutputMode->SizeOfInfo = sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION);
2799 CurrentGraphicsOutputMode->FrameBufferBase = (EFI_PHYSICAL_ADDRESS) (UINTN) NULL;
2800 CurrentGraphicsOutputMode->FrameBufferSize = 0;
2801
2802 //
2803 // Update the private mode buffer
2804 //
2805 CopyMem (&Private->GraphicsOutputModeBuffer[0], Info, sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
2806
2807 //
2808 // Only mode 0 is available to be set
2809 //
2810 CurrentIndex = 0;
2811 }
2812
2813 Done:
2814
2815 if (GraphicsOutput != NULL) {
2816 Private->CurrentNumberOfGraphicsOutput++;
2817 }
2818 if (UgaDraw != NULL) {
2819 Private->CurrentNumberOfUgaDraw++;
2820 }
2821
2822 //
2823 // Force GraphicsOutput mode to be set,
2824 //
2825
2826 Mode = &Private->GraphicsOutputModeBuffer[CurrentIndex];
2827 if ((GraphicsOutput != NULL) &&
2828 (Mode->HorizontalResolution == CurrentGraphicsOutputMode->Info->HorizontalResolution) &&
2829 (Mode->VerticalResolution == CurrentGraphicsOutputMode->Info->VerticalResolution)) {
2830 CurrentGraphicsOutputMode->Mode = (UINT32) CurrentIndex;
2831 if ((Mode->HorizontalResolution != GraphicsOutput->Mode->Info->HorizontalResolution) ||
2832 (Mode->VerticalResolution != GraphicsOutput->Mode->Info->VerticalResolution)) {
2833 //
2834 // If all existing video device has been set to common mode, only set new GOP device to
2835 // the common mode
2836 //
2837 for (NumberIndex = 0; NumberIndex < GraphicsOutput->Mode->MaxMode; NumberIndex ++) {
2838 Status = GraphicsOutput->QueryMode (GraphicsOutput, (UINT32) NumberIndex, &SizeOfInfo, &Info);
2839 if (EFI_ERROR (Status)) {
2840 return Status;
2841 }
2842 if ((Info->HorizontalResolution == Mode->HorizontalResolution) && (Info->VerticalResolution == Mode->VerticalResolution)) {
2843 FreePool (Info);
2844 break;
2845 }
2846 FreePool (Info);
2847 }
2848 Status = GraphicsOutput->SetMode (GraphicsOutput, (UINT32) NumberIndex);
2849 }
2850 } else {
2851 //
2852 // Current mode number may need update now, so set it to an invalid mode number
2853 //
2854 CurrentGraphicsOutputMode->Mode = 0xffff;
2855 //
2856 // Graphics console can ensure all GOP devices have the same mode which can be taken as current mode.
2857 //
2858 Status = Private->GraphicsOutput.SetMode (&Private->GraphicsOutput, (UINT32) CurrentIndex);
2859 if (EFI_ERROR(Status)) {
2860 //
2861 // If user defined mode is not valid for display device, set to the default mode 800x600.
2862 //
2863 (Private->GraphicsOutputModeBuffer[0]).HorizontalResolution = 800;
2864 (Private->GraphicsOutputModeBuffer[0]).VerticalResolution = 600;
2865 Status = Private->GraphicsOutput.SetMode (&Private->GraphicsOutput, 0);
2866 }
2867 }
2868
2869 return Status;
2870 }
2871
2872 /**
2873 Set the current console out mode.
2874
2875 This routine will get the current console mode information (column, row)
2876 from ConsoleOutMode variable and set it; if the variable does not exist,
2877 set to user defined console mode.
2878
2879 @param Private Consplitter Text Out pointer.
2880
2881 **/
2882 VOID
2883 ConsplitterSetConsoleOutMode (
2884 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private
2885 )
2886 {
2887 UINTN Col;
2888 UINTN Row;
2889 UINTN Mode;
2890 UINTN PreferMode;
2891 UINTN BaseMode;
2892 UINTN MaxMode;
2893 EFI_STATUS Status;
2894 CONSOLE_OUT_MODE ModeInfo;
2895 CONSOLE_OUT_MODE MaxModeInfo;
2896 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
2897
2898 PreferMode = 0xFF;
2899 BaseMode = 0xFF;
2900 TextOut = &Private->TextOut;
2901 MaxMode = (UINTN) (TextOut->Mode->MaxMode);
2902
2903 MaxModeInfo.Column = 0;
2904 MaxModeInfo.Row = 0;
2905 ModeInfo.Column = PcdGet32 (PcdConOutColumn);
2906 ModeInfo.Row = PcdGet32 (PcdConOutRow);
2907
2908 //
2909 // To find the prefer mode and basic mode from Text Out mode list
2910 //
2911 for (Mode = 0; Mode < MaxMode; Mode++) {
2912 Status = TextOut->QueryMode (TextOut, Mode, &Col, &Row);
2913 if (!EFI_ERROR(Status)) {
2914 if ((ModeInfo.Column != 0) && (ModeInfo.Row != 0)) {
2915 //
2916 // Use user defined column and row
2917 //
2918 if (Col == ModeInfo.Column && Row == ModeInfo.Row) {
2919 PreferMode = Mode;
2920 }
2921 } else {
2922 //
2923 // If user sets PcdConOutColumn or PcdConOutRow to 0,
2924 // find and set the highest text mode.
2925 //
2926 if ((Col >= MaxModeInfo.Column) && (Row >= MaxModeInfo.Row)) {
2927 MaxModeInfo.Column = Col;
2928 MaxModeInfo.Row = Row;
2929 PreferMode = Mode;
2930 }
2931 }
2932 if (Col == 80 && Row == 25) {
2933 BaseMode = Mode;
2934 }
2935 }
2936 }
2937
2938 //
2939 // Set prefer mode to Text Out devices.
2940 //
2941 Status = TextOut->SetMode (TextOut, PreferMode);
2942 if (EFI_ERROR(Status)) {
2943 //
2944 // if current mode setting is failed, default 80x25 mode will be set.
2945 //
2946 Status = TextOut->SetMode (TextOut, BaseMode);
2947 ASSERT(!EFI_ERROR(Status));
2948
2949 PcdSet32 (PcdConOutColumn, 80);
2950 PcdSet32 (PcdConOutRow, 25);
2951 }
2952
2953 return ;
2954 }
2955
2956
2957 /**
2958 Add Text Output Device in Consplitter Text Output list.
2959
2960 @param Private Text Out Splitter pointer.
2961 @param TextOut Simple Text Output protocol pointer.
2962 @param GraphicsOutput Graphics Output protocol pointer.
2963 @param UgaDraw UGA Draw protocol pointer.
2964
2965 @retval EFI_SUCCESS Text Output Device added successfully.
2966 @retval EFI_OUT_OF_RESOURCES Could not grow the buffer size.
2967
2968 **/
2969 EFI_STATUS
2970 ConSplitterTextOutAddDevice (
2971 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private,
2972 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut,
2973 IN EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput,
2974 IN EFI_UGA_DRAW_PROTOCOL *UgaDraw
2975 )
2976 {
2977 EFI_STATUS Status;
2978 UINTN CurrentNumOfConsoles;
2979 INT32 MaxMode;
2980 UINT32 UgaHorizontalResolution;
2981 UINT32 UgaVerticalResolution;
2982 UINT32 UgaColorDepth;
2983 UINT32 UgaRefreshRate;
2984 TEXT_OUT_AND_GOP_DATA *TextAndGop;
2985 UINTN SizeOfInfo;
2986 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
2987 EFI_STATUS DeviceStatus;
2988
2989 Status = EFI_SUCCESS;
2990 CurrentNumOfConsoles = Private->CurrentNumberOfConsoles;
2991
2992 //
2993 // If the Text Out List is full, enlarge it by calling ConSplitterGrowBuffer().
2994 //
2995 while (CurrentNumOfConsoles >= Private->TextOutListCount) {
2996 Status = ConSplitterGrowBuffer (
2997 sizeof (TEXT_OUT_AND_GOP_DATA),
2998 &Private->TextOutListCount,
2999 (VOID **) &Private->TextOutList
3000 );
3001 if (EFI_ERROR (Status)) {
3002 return EFI_OUT_OF_RESOURCES;
3003 }
3004 //
3005 // Also need to reallocate the TextOutModeMap table
3006 //
3007 Status = ConSplitterGrowMapTable (Private);
3008 if (EFI_ERROR (Status)) {
3009 return EFI_OUT_OF_RESOURCES;
3010 }
3011 }
3012
3013 TextAndGop = &Private->TextOutList[CurrentNumOfConsoles];
3014
3015 TextAndGop->TextOut = TextOut;
3016 TextAndGop->GraphicsOutput = GraphicsOutput;
3017 TextAndGop->UgaDraw = UgaDraw;
3018
3019 if (CurrentNumOfConsoles == 0) {
3020 //
3021 // Add the first device's output mode to console splitter's mode list
3022 //
3023 Status = ConSplitterAddOutputMode (Private, TextOut);
3024 } else {
3025 ConSplitterSyncOutputMode (Private, TextOut);
3026 }
3027
3028 Private->CurrentNumberOfConsoles++;
3029
3030 //
3031 // Scan both TextOutList, for the intersection TextOut device
3032 // maybe both ConOut and StdErr incorporate the same Text Out
3033 // device in them, thus the output of both should be synced.
3034 //
3035 ConSplitterGetIntersectionBetweenConOutAndStrErr ();
3036
3037 MaxMode = Private->TextOutMode.MaxMode;
3038 ASSERT (MaxMode >= 1);
3039
3040 DeviceStatus = EFI_DEVICE_ERROR;
3041 Status = EFI_DEVICE_ERROR;
3042
3043 //
3044 // This device display mode will be added into Graphics Ouput modes.
3045 //
3046 if ((GraphicsOutput != NULL) || (UgaDraw != NULL)) {
3047 DeviceStatus = ConSplitterAddGraphicsOutputMode (Private, GraphicsOutput, UgaDraw);
3048 }
3049
3050 if (FeaturePcdGet (PcdConOutUgaSupport)) {
3051 //
3052 // If UGA is produced by Consplitter
3053 //
3054 if (GraphicsOutput != NULL) {
3055 Status = GraphicsOutput->QueryMode (GraphicsOutput, GraphicsOutput->Mode->Mode, &SizeOfInfo, &Info);
3056 if (EFI_ERROR (Status)) {
3057 return Status;
3058 }
3059 ASSERT ( SizeOfInfo <= sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
3060
3061 UgaHorizontalResolution = Info->HorizontalResolution;
3062 UgaVerticalResolution = Info->VerticalResolution;
3063
3064 FreePool (Info);
3065
3066 } else if (UgaDraw != NULL) {
3067 Status = UgaDraw->GetMode (
3068 UgaDraw,
3069 &UgaHorizontalResolution,
3070 &UgaVerticalResolution,
3071 &UgaColorDepth,
3072 &UgaRefreshRate
3073 );
3074 if (!EFI_ERROR (Status) && EFI_ERROR (DeviceStatus)) {
3075 //
3076 // if GetMode is successfully and UGA device hasn't been set, set it
3077 //
3078 Status = ConSplitterUgaDrawSetMode (
3079 &Private->UgaDraw,
3080 UgaHorizontalResolution,
3081 UgaVerticalResolution,
3082 UgaColorDepth,
3083 UgaRefreshRate
3084 );
3085 }
3086 //
3087 // If GetMode/SetMode is failed, set to 800x600 mode
3088 //
3089 if(EFI_ERROR (Status)) {
3090 Status = ConSplitterUgaDrawSetMode (
3091 &Private->UgaDraw,
3092 800,
3093 600,
3094 32,
3095 60
3096 );
3097 }
3098 }
3099 }
3100
3101 if (((!EFI_ERROR (DeviceStatus)) || (!EFI_ERROR (Status))) &&
3102 ((Private->CurrentNumberOfGraphicsOutput + Private->CurrentNumberOfUgaDraw) == 1)) {
3103 if (!FeaturePcdGet (PcdConOutGopSupport)) {
3104 //
3105 // If Graphics Outpurt protocol not supported, UGA Draw protocol is installed
3106 // on the virtual handle.
3107 //
3108 Status = gBS->InstallMultipleProtocolInterfaces (
3109 &mConOut.VirtualHandle,
3110 &gEfiUgaDrawProtocolGuid,
3111 &mConOut.UgaDraw,
3112 NULL
3113 );
3114 } else if (!FeaturePcdGet (PcdConOutUgaSupport)) {
3115 //
3116 // If UGA Draw protocol not supported, Graphics Output Protocol is installed
3117 // on virtual handle.
3118 //
3119 Status = gBS->InstallMultipleProtocolInterfaces (
3120 &mConOut.VirtualHandle,
3121 &gEfiGraphicsOutputProtocolGuid,
3122 &mConOut.GraphicsOutput,
3123 NULL
3124 );
3125 } else {
3126 //
3127 // Boot Graphics Output protocol and UGA Draw protocol are supported,
3128 // both they will be installed on virtual handle.
3129 //
3130 Status = gBS->InstallMultipleProtocolInterfaces (
3131 &mConOut.VirtualHandle,
3132 &gEfiGraphicsOutputProtocolGuid,
3133 &mConOut.GraphicsOutput,
3134 &gEfiUgaDrawProtocolGuid,
3135 &mConOut.UgaDraw,
3136 NULL
3137 );
3138 }
3139 }
3140
3141 //
3142 // After adding new console device, all existing console devices should be
3143 // synced to the current shared mode.
3144 //
3145 ConsplitterSetConsoleOutMode (Private);
3146
3147 return Status;
3148 }
3149
3150
3151 /**
3152 Remove Text Out Device in Consplitter Text Out list.
3153
3154 @param Private Text Out Splitter pointer.
3155 @param TextOut Simple Text Output Pointer protocol pointer.
3156
3157 @retval EFI_SUCCESS Text Out Device removed successfully.
3158 @retval EFI_NOT_FOUND No Text Out Device found.
3159
3160 **/
3161 EFI_STATUS
3162 ConSplitterTextOutDeleteDevice (
3163 IN TEXT_OUT_SPLITTER_PRIVATE_DATA *Private,
3164 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut
3165 )
3166 {
3167 INT32 Index;
3168 UINTN CurrentNumOfConsoles;
3169 TEXT_OUT_AND_GOP_DATA *TextOutList;
3170 EFI_STATUS Status;
3171
3172 //
3173 // Remove the specified text-out device data structure from the Text out List,
3174 // and rearrange the remaining data structures in the Text out List.
3175 //
3176 CurrentNumOfConsoles = Private->CurrentNumberOfConsoles;
3177 Index = (INT32) CurrentNumOfConsoles - 1;
3178 TextOutList = Private->TextOutList;
3179 while (Index >= 0) {
3180 if (TextOutList->TextOut == TextOut) {
3181 if (TextOutList->UgaDraw != NULL) {
3182 Private->CurrentNumberOfUgaDraw--;
3183 }
3184 if (TextOutList->GraphicsOutput != NULL) {
3185 Private->CurrentNumberOfGraphicsOutput--;
3186 }
3187 CopyMem (TextOutList, TextOutList + 1, sizeof (TEXT_OUT_AND_GOP_DATA) * Index);
3188 CurrentNumOfConsoles--;
3189 break;
3190 }
3191
3192 Index--;
3193 TextOutList++;
3194 }
3195 //
3196 // The specified TextOut is not managed by the ConSplitter driver
3197 //
3198 if (Index < 0) {
3199 return EFI_NOT_FOUND;
3200 }
3201
3202 if ((Private->CurrentNumberOfGraphicsOutput == 0) && (Private->CurrentNumberOfUgaDraw == 0)) {
3203 //
3204 // If there is not any physical GOP and UGA device in system,
3205 // Consplitter GOP or UGA protocol will be uninstalled
3206 //
3207 if (!FeaturePcdGet (PcdConOutGopSupport)) {
3208 Status = gBS->UninstallProtocolInterface (
3209 Private->VirtualHandle,
3210 &gEfiUgaDrawProtocolGuid,
3211 &Private->UgaDraw
3212 );
3213 } else if (!FeaturePcdGet (PcdConOutUgaSupport)) {
3214 Status = gBS->UninstallProtocolInterface (
3215 Private->VirtualHandle,
3216 &gEfiGraphicsOutputProtocolGuid,
3217 &Private->GraphicsOutput
3218 );
3219 } else {
3220 Status = gBS->UninstallMultipleProtocolInterfaces (
3221 Private->VirtualHandle,
3222 &gEfiUgaDrawProtocolGuid,
3223 &Private->UgaDraw,
3224 &gEfiGraphicsOutputProtocolGuid,
3225 &Private->GraphicsOutput,
3226 NULL
3227 );
3228 }
3229 }
3230
3231 if (CurrentNumOfConsoles == 0) {
3232 //
3233 // If the number of consoles is zero, reset all parameters
3234 //
3235 Private->CurrentNumberOfConsoles = 0;
3236 Private->TextOutMode.MaxMode = 1;
3237 Private->TextOutQueryData[0].Columns = 80;
3238 Private->TextOutQueryData[0].Rows = 25;
3239 TextOutSetMode (Private, 0);
3240
3241 return EFI_SUCCESS;
3242 }
3243 //
3244 // Max Mode is realy an intersection of the QueryMode command to all
3245 // devices. So we must copy the QueryMode of the first device to
3246 // QueryData.
3247 //
3248 ZeroMem (
3249 Private->TextOutQueryData,
3250 Private->TextOutQueryDataCount * sizeof (TEXT_OUT_SPLITTER_QUERY_DATA)
3251 );
3252
3253 FreePool (Private->TextOutModeMap);
3254 Private->TextOutModeMap = NULL;
3255 TextOutList = Private->TextOutList;
3256
3257 //
3258 // Add the first TextOut to the QueryData array and ModeMap table
3259 //
3260 Status = ConSplitterAddOutputMode (Private, TextOutList->TextOut);
3261
3262 //
3263 // Now add one by one
3264 //
3265 Index = 1;
3266 Private->CurrentNumberOfConsoles = 1;
3267 TextOutList++;
3268 while ((UINTN) Index < CurrentNumOfConsoles) {
3269 ConSplitterSyncOutputMode (Private, TextOutList->TextOut);
3270 Index++;
3271 Private->CurrentNumberOfConsoles++;
3272 TextOutList++;
3273 }
3274
3275 ConSplitterGetIntersectionBetweenConOutAndStrErr ();
3276
3277 return Status;
3278 }
3279
3280
3281 /**
3282 Reset the input device and optionaly run diagnostics
3283
3284 @param This Protocol instance pointer.
3285 @param ExtendedVerification Driver may perform diagnostics on reset.
3286
3287 @retval EFI_SUCCESS The device was reset.
3288 @retval EFI_DEVICE_ERROR The device is not functioning properly and could
3289 not be reset.
3290
3291 **/
3292 EFI_STATUS
3293 EFIAPI
3294 ConSplitterTextInReset (
3295 IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
3296 IN BOOLEAN ExtendedVerification
3297 )
3298 {
3299 EFI_STATUS Status;
3300 EFI_STATUS ReturnStatus;
3301 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3302 UINTN Index;
3303
3304 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3305
3306 Private->KeyEventSignalState = FALSE;
3307
3308 //
3309 // return the worst status met
3310 //
3311 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
3312 Status = Private->TextInList[Index]->Reset (
3313 Private->TextInList[Index],
3314 ExtendedVerification
3315 );
3316 if (EFI_ERROR (Status)) {
3317 ReturnStatus = Status;
3318 }
3319 }
3320
3321 return ReturnStatus;
3322 }
3323
3324
3325 /**
3326 Reads the next keystroke from the input device. The WaitForKey Event can
3327 be used to test for existance of a keystroke via WaitForEvent () call.
3328
3329 @param Private Protocol instance pointer.
3330 @param Key Driver may perform diagnostics on reset.
3331
3332 @retval EFI_SUCCESS The keystroke information was returned.
3333 @retval EFI_NOT_READY There was no keystroke data availiable.
3334 @retval EFI_DEVICE_ERROR The keydtroke information was not returned due
3335 to hardware errors.
3336
3337 **/
3338 EFI_STATUS
3339 EFIAPI
3340 ConSplitterTextInPrivateReadKeyStroke (
3341 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
3342 OUT EFI_INPUT_KEY *Key
3343 )
3344 {
3345 EFI_STATUS Status;
3346 UINTN Index;
3347 EFI_INPUT_KEY CurrentKey;
3348
3349 Key->UnicodeChar = 0;
3350 Key->ScanCode = SCAN_NULL;
3351
3352 //
3353 // if no physical console input device exists, return EFI_NOT_READY;
3354 // if any physical console input device has key input,
3355 // return the key and EFI_SUCCESS.
3356 //
3357 for (Index = 0; Index < Private->CurrentNumberOfConsoles; Index++) {
3358 Status = Private->TextInList[Index]->ReadKeyStroke (
3359 Private->TextInList[Index],
3360 &CurrentKey
3361 );
3362 if (!EFI_ERROR (Status)) {
3363 *Key = CurrentKey;
3364 return Status;
3365 }
3366 }
3367
3368 return EFI_NOT_READY;
3369 }
3370
3371
3372
3373 /**
3374 Reads the next keystroke from the input device. The WaitForKey Event can
3375 be used to test for existance of a keystroke via WaitForEvent () call.
3376
3377 @param This Protocol instance pointer.
3378 @param Key Driver may perform diagnostics on reset.
3379
3380 @retval EFI_SUCCESS The keystroke information was returned.
3381 @retval EFI_NOT_READY There was no keystroke data availiable.
3382 @retval EFI_DEVICE_ERROR The keydtroke information was not returned due
3383 to hardware errors.
3384
3385 **/
3386 EFI_STATUS
3387 EFIAPI
3388 ConSplitterTextInReadKeyStroke (
3389 IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
3390 OUT EFI_INPUT_KEY *Key
3391 )
3392 {
3393 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3394
3395 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3396
3397 Private->KeyEventSignalState = FALSE;
3398
3399 //
3400 // Signal ConnectConIn event on first call in Lazy ConIn mode
3401 //
3402 if (!mConInIsConnect && PcdGetBool (PcdConInConnectOnDemand)) {
3403 DEBUG ((EFI_D_INFO, "Connect ConIn in first ReadKeyStoke in Lazy ConIn mode.\n"));
3404 gBS->SignalEvent (Private->ConnectConInEvent);
3405 mConInIsConnect = TRUE;
3406 }
3407
3408 return ConSplitterTextInPrivateReadKeyStroke (Private, Key);
3409 }
3410
3411
3412 /**
3413 This event aggregates all the events of the ConIn devices in the spliter.
3414
3415 If any events of physical ConIn devices are signaled, signal the ConIn
3416 spliter event. This will cause the calling code to call
3417 ConSplitterTextInReadKeyStroke ().
3418
3419 @param Event The Event assoicated with callback.
3420 @param Context Context registered when Event was created.
3421
3422 **/
3423 VOID
3424 EFIAPI
3425 ConSplitterTextInWaitForKey (
3426 IN EFI_EVENT Event,
3427 IN VOID *Context
3428 )
3429 {
3430 EFI_STATUS Status;
3431 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3432 UINTN Index;
3433
3434 Private = (TEXT_IN_SPLITTER_PRIVATE_DATA *) Context;
3435
3436 if (Private->KeyEventSignalState) {
3437 //
3438 // If KeyEventSignalState is flagged before, and not cleared by Reset() or ReadKeyStroke()
3439 //
3440 gBS->SignalEvent (Event);
3441 return ;
3442 }
3443
3444 //
3445 // If any physical console input device has key input, signal the event.
3446 //
3447 for (Index = 0; Index < Private->CurrentNumberOfConsoles; Index++) {
3448 Status = gBS->CheckEvent (Private->TextInList[Index]->WaitForKey);
3449 if (!EFI_ERROR (Status)) {
3450 gBS->SignalEvent (Event);
3451 Private->KeyEventSignalState = TRUE;
3452 }
3453 }
3454 }
3455
3456
3457
3458 /**
3459 Test if the key has been registered on input device.
3460
3461 @param RegsiteredData A pointer to a buffer that is filled in with the
3462 keystroke state data for the key that was
3463 registered.
3464 @param InputData A pointer to a buffer that is filled in with the
3465 keystroke state data for the key that was
3466 pressed.
3467
3468 @retval TRUE Key be pressed matches a registered key.
3469 @retval FLASE Match failed.
3470
3471 **/
3472 BOOLEAN
3473 IsKeyRegistered (
3474 IN EFI_KEY_DATA *RegsiteredData,
3475 IN EFI_KEY_DATA *InputData
3476 )
3477 {
3478 ASSERT (RegsiteredData != NULL && InputData != NULL);
3479
3480 if ((RegsiteredData->Key.ScanCode != InputData->Key.ScanCode) ||
3481 (RegsiteredData->Key.UnicodeChar != InputData->Key.UnicodeChar)) {
3482 return FALSE;
3483 }
3484
3485 //
3486 // Assume KeyShiftState/KeyToggleState = 0 in Registered key data means these state could be ignored.
3487 //
3488 if (RegsiteredData->KeyState.KeyShiftState != 0 &&
3489 RegsiteredData->KeyState.KeyShiftState != InputData->KeyState.KeyShiftState) {
3490 return FALSE;
3491 }
3492 if (RegsiteredData->KeyState.KeyToggleState != 0 &&
3493 RegsiteredData->KeyState.KeyToggleState != InputData->KeyState.KeyToggleState) {
3494 return FALSE;
3495 }
3496
3497 return TRUE;
3498
3499 }
3500
3501
3502 /**
3503 Reset the input device and optionaly run diagnostics
3504
3505 @param This Protocol instance pointer.
3506 @param ExtendedVerification Driver may perform diagnostics on reset.
3507
3508 @retval EFI_SUCCESS The device was reset.
3509 @retval EFI_DEVICE_ERROR The device is not functioning properly and could
3510 not be reset.
3511
3512 **/
3513 EFI_STATUS
3514 EFIAPI
3515 ConSplitterTextInResetEx (
3516 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
3517 IN BOOLEAN ExtendedVerification
3518 )
3519 {
3520 EFI_STATUS Status;
3521 EFI_STATUS ReturnStatus;
3522 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3523 UINTN Index;
3524
3525 Private = TEXT_IN_EX_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3526
3527 Private->KeyEventSignalState = FALSE;
3528
3529 //
3530 // return the worst status met
3531 //
3532 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfExConsoles; Index++) {
3533 Status = Private->TextInExList[Index]->Reset (
3534 Private->TextInExList[Index],
3535 ExtendedVerification
3536 );
3537 if (EFI_ERROR (Status)) {
3538 ReturnStatus = Status;
3539 }
3540 }
3541
3542 return ReturnStatus;
3543
3544 }
3545
3546
3547 /**
3548 Reads the next keystroke from the input device. The WaitForKey Event can
3549 be used to test for existance of a keystroke via WaitForEvent () call.
3550
3551 @param This Protocol instance pointer.
3552 @param KeyData A pointer to a buffer that is filled in with the
3553 keystroke state data for the key that was
3554 pressed.
3555
3556 @retval EFI_SUCCESS The keystroke information was returned.
3557 @retval EFI_NOT_READY There was no keystroke data availiable.
3558 @retval EFI_DEVICE_ERROR The keystroke information was not returned due
3559 to hardware errors.
3560 @retval EFI_INVALID_PARAMETER KeyData is NULL.
3561
3562 **/
3563 EFI_STATUS
3564 EFIAPI
3565 ConSplitterTextInReadKeyStrokeEx (
3566 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
3567 OUT EFI_KEY_DATA *KeyData
3568 )
3569 {
3570 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3571 EFI_STATUS Status;
3572 UINTN Index;
3573 EFI_KEY_DATA CurrentKeyData;
3574
3575
3576 if (KeyData == NULL) {
3577 return EFI_INVALID_PARAMETER;
3578 }
3579
3580 Private = TEXT_IN_EX_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3581
3582 Private->KeyEventSignalState = FALSE;
3583
3584 KeyData->Key.UnicodeChar = 0;
3585 KeyData->Key.ScanCode = SCAN_NULL;
3586
3587 //
3588 // Signal ConnectConIn event on first call in Lazy ConIn mode
3589 //
3590 if (!mConInIsConnect && PcdGetBool (PcdConInConnectOnDemand)) {
3591 DEBUG ((EFI_D_INFO, "Connect ConIn in first ReadKeyStoke in Lazy ConIn mode.\n"));
3592 gBS->SignalEvent (Private->ConnectConInEvent);
3593 mConInIsConnect = TRUE;
3594 }
3595
3596 //
3597 // if no physical console input device exists, return EFI_NOT_READY;
3598 // if any physical console input device has key input,
3599 // return the key and EFI_SUCCESS.
3600 //
3601 for (Index = 0; Index < Private->CurrentNumberOfExConsoles; Index++) {
3602 Status = Private->TextInExList[Index]->ReadKeyStrokeEx (
3603 Private->TextInExList[Index],
3604 &CurrentKeyData
3605 );
3606 if (!EFI_ERROR (Status)) {
3607 CopyMem (KeyData, &CurrentKeyData, sizeof (CurrentKeyData));
3608 return Status;
3609 }
3610 }
3611
3612 return EFI_NOT_READY;
3613 }
3614
3615
3616 /**
3617 Set certain state for the input device.
3618
3619 @param This Protocol instance pointer.
3620 @param KeyToggleState A pointer to the EFI_KEY_TOGGLE_STATE to set the
3621 state for the input device.
3622
3623 @retval EFI_SUCCESS The device state was set successfully.
3624 @retval EFI_DEVICE_ERROR The device is not functioning correctly and
3625 could not have the setting adjusted.
3626 @retval EFI_UNSUPPORTED The device does not have the ability to set its
3627 state.
3628 @retval EFI_INVALID_PARAMETER KeyToggleState is NULL.
3629
3630 **/
3631 EFI_STATUS
3632 EFIAPI
3633 ConSplitterTextInSetState (
3634 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
3635 IN EFI_KEY_TOGGLE_STATE *KeyToggleState
3636 )
3637 {
3638 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3639 EFI_STATUS Status;
3640 UINTN Index;
3641
3642 if (KeyToggleState == NULL) {
3643 return EFI_INVALID_PARAMETER;
3644 }
3645
3646 Private = TEXT_IN_EX_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3647
3648 //
3649 // if no physical console input device exists, return EFI_SUCCESS;
3650 // otherwise return the status of setting state of physical console input device
3651 //
3652 for (Index = 0; Index < Private->CurrentNumberOfExConsoles; Index++) {
3653 Status = Private->TextInExList[Index]->SetState (
3654 Private->TextInExList[Index],
3655 KeyToggleState
3656 );
3657 if (EFI_ERROR (Status)) {
3658 return Status;
3659 }
3660 }
3661
3662 return EFI_SUCCESS;
3663
3664 }
3665
3666
3667 /**
3668 Register a notification function for a particular keystroke for the input device.
3669
3670 @param This Protocol instance pointer.
3671 @param KeyData A pointer to a buffer that is filled in with the
3672 keystroke information data for the key that was
3673 pressed.
3674 @param KeyNotificationFunction Points to the function to be called when the key
3675 sequence is typed specified by KeyData.
3676 @param NotifyHandle Points to the unique handle assigned to the
3677 registered notification.
3678
3679 @retval EFI_SUCCESS The notification function was registered
3680 successfully.
3681 @retval EFI_OUT_OF_RESOURCES Unable to allocate resources for necesssary data
3682 structures.
3683 @retval EFI_INVALID_PARAMETER KeyData or KeyNotificationFunction or NotifyHandle is NULL.
3684
3685 **/
3686 EFI_STATUS
3687 EFIAPI
3688 ConSplitterTextInRegisterKeyNotify (
3689 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
3690 IN EFI_KEY_DATA *KeyData,
3691 IN EFI_KEY_NOTIFY_FUNCTION KeyNotificationFunction,
3692 OUT VOID **NotifyHandle
3693 )
3694 {
3695 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3696 EFI_STATUS Status;
3697 UINTN Index;
3698 TEXT_IN_EX_SPLITTER_NOTIFY *NewNotify;
3699 LIST_ENTRY *Link;
3700 TEXT_IN_EX_SPLITTER_NOTIFY *CurrentNotify;
3701
3702
3703 if (KeyData == NULL || NotifyHandle == NULL || KeyNotificationFunction == NULL) {
3704 return EFI_INVALID_PARAMETER;
3705 }
3706
3707 Private = TEXT_IN_EX_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3708
3709 //
3710 // Return EFI_SUCCESS if the (KeyData, NotificationFunction) is already registered.
3711 //
3712 for (Link = Private->NotifyList.ForwardLink; Link != &Private->NotifyList; Link = Link->ForwardLink) {
3713 CurrentNotify = TEXT_IN_EX_SPLITTER_NOTIFY_FROM_THIS (Link);
3714 if (IsKeyRegistered (&CurrentNotify->KeyData, KeyData)) {
3715 if (CurrentNotify->KeyNotificationFn == KeyNotificationFunction) {
3716 *NotifyHandle = CurrentNotify;
3717 return EFI_SUCCESS;
3718 }
3719 }
3720 }
3721
3722 //
3723 // Allocate resource to save the notification function
3724 //
3725 NewNotify = (TEXT_IN_EX_SPLITTER_NOTIFY *) AllocateZeroPool (sizeof (TEXT_IN_EX_SPLITTER_NOTIFY));
3726 if (NewNotify == NULL) {
3727 return EFI_OUT_OF_RESOURCES;
3728 }
3729 NewNotify->NotifyHandleList = (EFI_HANDLE *) AllocateZeroPool (sizeof (EFI_HANDLE) * Private->TextInExListCount);
3730 if (NewNotify->NotifyHandleList == NULL) {
3731 gBS->FreePool (NewNotify);
3732 return EFI_OUT_OF_RESOURCES;
3733 }
3734 NewNotify->Signature = TEXT_IN_EX_SPLITTER_NOTIFY_SIGNATURE;
3735 NewNotify->KeyNotificationFn = KeyNotificationFunction;
3736 CopyMem (&NewNotify->KeyData, KeyData, sizeof (EFI_KEY_DATA));
3737
3738 //
3739 // Return the wrong status of registering key notify of
3740 // physical console input device if meet problems
3741 //
3742 for (Index = 0; Index < Private->CurrentNumberOfExConsoles; Index++) {
3743 Status = Private->TextInExList[Index]->RegisterKeyNotify (
3744 Private->TextInExList[Index],
3745 KeyData,
3746 KeyNotificationFunction,
3747 &NewNotify->NotifyHandleList[Index]
3748 );
3749 if (EFI_ERROR (Status)) {
3750 //
3751 // Un-register the key notify on all physical console input devices
3752 //
3753 while (Index-- != 0) {
3754 Private->TextInExList[Index]->UnregisterKeyNotify (
3755 Private->TextInExList[Index],
3756 NewNotify->NotifyHandleList[Index]
3757 );
3758 }
3759 gBS->FreePool (NewNotify->NotifyHandleList);
3760 gBS->FreePool (NewNotify);
3761 return Status;
3762 }
3763 }
3764
3765 InsertTailList (&mConIn.NotifyList, &NewNotify->NotifyEntry);
3766
3767 *NotifyHandle = NewNotify;
3768
3769 return EFI_SUCCESS;
3770
3771 }
3772
3773
3774 /**
3775 Remove a registered notification function from a particular keystroke.
3776
3777 @param This Protocol instance pointer.
3778 @param NotificationHandle The handle of the notification function being
3779 unregistered.
3780
3781 @retval EFI_SUCCESS The notification function was unregistered
3782 successfully.
3783 @retval EFI_INVALID_PARAMETER The NotificationHandle is invalid.
3784
3785 **/
3786 EFI_STATUS
3787 EFIAPI
3788 ConSplitterTextInUnregisterKeyNotify (
3789 IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
3790 IN VOID *NotificationHandle
3791 )
3792 {
3793 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3794 UINTN Index;
3795 TEXT_IN_EX_SPLITTER_NOTIFY *CurrentNotify;
3796 LIST_ENTRY *Link;
3797
3798 if (NotificationHandle == NULL) {
3799 return EFI_INVALID_PARAMETER;
3800 }
3801
3802 Private = TEXT_IN_EX_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
3803
3804 for (Link = Private->NotifyList.ForwardLink; Link != &Private->NotifyList; Link = Link->ForwardLink) {
3805 CurrentNotify = TEXT_IN_EX_SPLITTER_NOTIFY_FROM_THIS (Link);
3806 if (CurrentNotify == NotificationHandle) {
3807 for (Index = 0; Index < Private->CurrentNumberOfExConsoles; Index++) {
3808 Private->TextInExList[Index]->UnregisterKeyNotify (
3809 Private->TextInExList[Index],
3810 CurrentNotify->NotifyHandleList[Index]
3811 );
3812 }
3813 RemoveEntryList (&CurrentNotify->NotifyEntry);
3814
3815 gBS->FreePool (CurrentNotify->NotifyHandleList);
3816 gBS->FreePool (CurrentNotify);
3817 return EFI_SUCCESS;
3818 }
3819 }
3820
3821 //
3822 // NotificationHandle is not found in database
3823 //
3824 return EFI_INVALID_PARAMETER;
3825 }
3826
3827
3828 /**
3829 Reset the input device and optionaly run diagnostics
3830
3831 @param This Protocol instance pointer.
3832 @param ExtendedVerification Driver may perform diagnostics on reset.
3833
3834 @retval EFI_SUCCESS The device was reset.
3835 @retval EFI_DEVICE_ERROR The device is not functioning properly and could
3836 not be reset.
3837
3838 **/
3839 EFI_STATUS
3840 EFIAPI
3841 ConSplitterSimplePointerReset (
3842 IN EFI_SIMPLE_POINTER_PROTOCOL *This,
3843 IN BOOLEAN ExtendedVerification
3844 )
3845 {
3846 EFI_STATUS Status;
3847 EFI_STATUS ReturnStatus;
3848 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3849 UINTN Index;
3850
3851 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_SIMPLE_POINTER_THIS (This);
3852
3853 Private->InputEventSignalState = FALSE;
3854
3855 if (Private->CurrentNumberOfPointers == 0) {
3856 return EFI_SUCCESS;
3857 }
3858 //
3859 // return the worst status met
3860 //
3861 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfPointers; Index++) {
3862 Status = Private->PointerList[Index]->Reset (
3863 Private->PointerList[Index],
3864 ExtendedVerification
3865 );
3866 if (EFI_ERROR (Status)) {
3867 ReturnStatus = Status;
3868 }
3869 }
3870
3871 return ReturnStatus;
3872 }
3873
3874
3875 /**
3876 Reads the next keystroke from the input device. The WaitForKey Event can
3877 be used to test for existance of a keystroke via WaitForEvent () call.
3878
3879 @param Private Protocol instance pointer.
3880 @param State The state information of simple pointer device.
3881
3882 @retval EFI_SUCCESS The keystroke information was returned.
3883 @retval EFI_NOT_READY There was no keystroke data availiable.
3884 @retval EFI_DEVICE_ERROR The keydtroke information was not returned due
3885 to hardware errors.
3886
3887 **/
3888 EFI_STATUS
3889 EFIAPI
3890 ConSplitterSimplePointerPrivateGetState (
3891 IN TEXT_IN_SPLITTER_PRIVATE_DATA *Private,
3892 IN OUT EFI_SIMPLE_POINTER_STATE *State
3893 )
3894 {
3895 EFI_STATUS Status;
3896 EFI_STATUS ReturnStatus;
3897 UINTN Index;
3898 EFI_SIMPLE_POINTER_STATE CurrentState;
3899
3900 State->RelativeMovementX = 0;
3901 State->RelativeMovementY = 0;
3902 State->RelativeMovementZ = 0;
3903 State->LeftButton = FALSE;
3904 State->RightButton = FALSE;
3905
3906 //
3907 // if no physical console input device exists, return EFI_NOT_READY;
3908 // if any physical console input device has key input,
3909 // return the key and EFI_SUCCESS.
3910 //
3911 ReturnStatus = EFI_NOT_READY;
3912 for (Index = 0; Index < Private->CurrentNumberOfPointers; Index++) {
3913
3914 Status = Private->PointerList[Index]->GetState (
3915 Private->PointerList[Index],
3916 &CurrentState
3917 );
3918 if (!EFI_ERROR (Status)) {
3919 if (ReturnStatus == EFI_NOT_READY) {
3920 ReturnStatus = EFI_SUCCESS;
3921 }
3922
3923 if (CurrentState.LeftButton) {
3924 State->LeftButton = TRUE;
3925 }
3926
3927 if (CurrentState.RightButton) {
3928 State->RightButton = TRUE;
3929 }
3930
3931 if (CurrentState.RelativeMovementX != 0 && Private->PointerList[Index]->Mode->ResolutionX != 0) {
3932 State->RelativeMovementX += (CurrentState.RelativeMovementX * (INT32) Private->SimplePointerMode.ResolutionX) / (INT32) Private->PointerList[Index]->Mode->ResolutionX;
3933 }
3934
3935 if (CurrentState.RelativeMovementY != 0 && Private->PointerList[Index]->Mode->ResolutionY != 0) {
3936 State->RelativeMovementY += (CurrentState.RelativeMovementY * (INT32) Private->SimplePointerMode.ResolutionY) / (INT32) Private->PointerList[Index]->Mode->ResolutionY;
3937 }
3938
3939 if (CurrentState.RelativeMovementZ != 0 && Private->PointerList[Index]->Mode->ResolutionZ != 0) {
3940 State->RelativeMovementZ += (CurrentState.RelativeMovementZ * (INT32) Private->SimplePointerMode.ResolutionZ) / (INT32) Private->PointerList[Index]->Mode->ResolutionZ;
3941 }
3942 } else if (Status == EFI_DEVICE_ERROR) {
3943 ReturnStatus = EFI_DEVICE_ERROR;
3944 }
3945 }
3946
3947 return ReturnStatus;
3948 }
3949
3950
3951 /**
3952 Reads the next keystroke from the input device. The WaitForKey Event can
3953 be used to test for existance of a keystroke via WaitForEvent () call.
3954
3955 @param This A pointer to protocol instance.
3956 @param State A pointer to state information on the pointer device
3957
3958 @retval EFI_SUCCESS The keystroke information was returned in State.
3959 @retval EFI_NOT_READY There was no keystroke data availiable.
3960 @retval EFI_DEVICE_ERROR The keydtroke information was not returned due
3961 to hardware errors.
3962
3963 **/
3964 EFI_STATUS
3965 EFIAPI
3966 ConSplitterSimplePointerGetState (
3967 IN EFI_SIMPLE_POINTER_PROTOCOL *This,
3968 IN OUT EFI_SIMPLE_POINTER_STATE *State
3969 )
3970 {
3971 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
3972
3973 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_SIMPLE_POINTER_THIS (This);
3974
3975 Private->InputEventSignalState = FALSE;
3976
3977 return ConSplitterSimplePointerPrivateGetState (Private, State);
3978 }
3979
3980
3981 /**
3982 This event agregates all the events of the ConIn devices in the spliter.
3983 If any events of physical ConIn devices are signaled, signal the ConIn
3984 spliter event. This will cause the calling code to call
3985 ConSplitterTextInReadKeyStroke ().
3986
3987 @param Event The Event assoicated with callback.
3988 @param Context Context registered when Event was created.
3989
3990 **/
3991 VOID
3992 EFIAPI
3993 ConSplitterSimplePointerWaitForInput (
3994 IN EFI_EVENT Event,
3995 IN VOID *Context
3996 )
3997 {
3998 EFI_STATUS Status;
3999 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
4000 UINTN Index;
4001
4002 Private = (TEXT_IN_SPLITTER_PRIVATE_DATA *) Context;
4003
4004 //
4005 // if InputEventSignalState is flagged before, and not cleared by Reset() or ReadKeyStroke()
4006 //
4007 if (Private->InputEventSignalState) {
4008 gBS->SignalEvent (Event);
4009 return ;
4010 }
4011 //
4012 // if any physical console input device has key input, signal the event.
4013 //
4014 for (Index = 0; Index < Private->CurrentNumberOfPointers; Index++) {
4015 Status = gBS->CheckEvent (Private->PointerList[Index]->WaitForInput);
4016 if (!EFI_ERROR (Status)) {
4017 gBS->SignalEvent (Event);
4018 Private->InputEventSignalState = TRUE;
4019 }
4020 }
4021 }
4022
4023 /**
4024 Resets the pointer device hardware.
4025
4026 @param This Protocol instance pointer.
4027 @param ExtendedVerification Driver may perform diagnostics on reset.
4028
4029 @retval EFI_SUCCESS The device was reset.
4030 @retval EFI_DEVICE_ERROR The device is not functioning correctly and
4031 could not be reset.
4032
4033 **/
4034 EFI_STATUS
4035 EFIAPI
4036 ConSplitterAbsolutePointerReset (
4037 IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,
4038 IN BOOLEAN ExtendedVerification
4039 )
4040 {
4041 EFI_STATUS Status;
4042 EFI_STATUS ReturnStatus;
4043 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
4044 UINTN Index;
4045
4046 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_ABSOLUTE_POINTER_THIS (This);
4047
4048 Private->AbsoluteInputEventSignalState = FALSE;
4049
4050 if (Private->CurrentNumberOfAbsolutePointers == 0) {
4051 return EFI_SUCCESS;
4052 }
4053 //
4054 // return the worst status met
4055 //
4056 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfAbsolutePointers; Index++) {
4057 Status = Private->AbsolutePointerList[Index]->Reset (
4058 Private->AbsolutePointerList[Index],
4059 ExtendedVerification
4060 );
4061 if (EFI_ERROR (Status)) {
4062 ReturnStatus = Status;
4063 }
4064 }
4065
4066 return ReturnStatus;
4067 }
4068
4069
4070 /**
4071 Retrieves the current state of a pointer device.
4072
4073 @param This Protocol instance pointer.
4074 @param State A pointer to the state information on the
4075 pointer device.
4076
4077 @retval EFI_SUCCESS The state of the pointer device was returned in
4078 State..
4079 @retval EFI_NOT_READY The state of the pointer device has not changed
4080 since the last call to GetState().
4081 @retval EFI_DEVICE_ERROR A device error occurred while attempting to
4082 retrieve the pointer device's current state.
4083
4084 **/
4085 EFI_STATUS
4086 EFIAPI
4087 ConSplitterAbsolutePointerGetState (
4088 IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,
4089 IN OUT EFI_ABSOLUTE_POINTER_STATE *State
4090 )
4091 {
4092 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
4093 EFI_STATUS Status;
4094 EFI_STATUS ReturnStatus;
4095 UINTN Index;
4096 EFI_ABSOLUTE_POINTER_STATE CurrentState;
4097
4098
4099 Private = TEXT_IN_SPLITTER_PRIVATE_DATA_FROM_ABSOLUTE_POINTER_THIS (This);
4100
4101 Private->AbsoluteInputEventSignalState = FALSE;
4102
4103 State->CurrentX = 0;
4104 State->CurrentY = 0;
4105 State->CurrentZ = 0;
4106 State->ActiveButtons = 0;
4107
4108 //
4109 // if no physical pointer device exists, return EFI_NOT_READY;
4110 // if any physical pointer device has changed state,
4111 // return the state and EFI_SUCCESS.
4112 //
4113 ReturnStatus = EFI_NOT_READY;
4114 for (Index = 0; Index < Private->CurrentNumberOfAbsolutePointers; Index++) {
4115
4116 Status = Private->AbsolutePointerList[Index]->GetState (
4117 Private->AbsolutePointerList[Index],
4118 &CurrentState
4119 );
4120 if (!EFI_ERROR (Status)) {
4121 if (ReturnStatus == EFI_NOT_READY) {
4122 ReturnStatus = EFI_SUCCESS;
4123 }
4124
4125 State->ActiveButtons = CurrentState.ActiveButtons;
4126
4127 if (!(Private->AbsolutePointerMode.AbsoluteMinX == 0 && Private->AbsolutePointerMode.AbsoluteMaxX == 0)) {
4128 State->CurrentX = CurrentState.CurrentX;
4129 }
4130 if (!(Private->AbsolutePointerMode.AbsoluteMinY == 0 && Private->AbsolutePointerMode.AbsoluteMaxY == 0)) {
4131 State->CurrentY = CurrentState.CurrentY;
4132 }
4133 if (!(Private->AbsolutePointerMode.AbsoluteMinZ == 0 && Private->AbsolutePointerMode.AbsoluteMaxZ == 0)) {
4134 State->CurrentZ = CurrentState.CurrentZ;
4135 }
4136
4137 } else if (Status == EFI_DEVICE_ERROR) {
4138 ReturnStatus = EFI_DEVICE_ERROR;
4139 }
4140 }
4141
4142 return ReturnStatus;
4143 }
4144
4145
4146 /**
4147 This event agregates all the events of the pointer devices in the splitter.
4148 If any events of physical pointer devices are signaled, signal the pointer
4149 splitter event. This will cause the calling code to call
4150 ConSplitterAbsolutePointerGetState ().
4151
4152 @param Event The Event assoicated with callback.
4153 @param Context Context registered when Event was created.
4154
4155 **/
4156 VOID
4157 EFIAPI
4158 ConSplitterAbsolutePointerWaitForInput (
4159 IN EFI_EVENT Event,
4160 IN VOID *Context
4161 )
4162 {
4163 EFI_STATUS Status;
4164 TEXT_IN_SPLITTER_PRIVATE_DATA *Private;
4165 UINTN Index;
4166
4167 Private = (TEXT_IN_SPLITTER_PRIVATE_DATA *) Context;
4168
4169 //
4170 // if AbsoluteInputEventSignalState is flagged before,
4171 // and not cleared by Reset() or GetState(), signal it
4172 //
4173 if (Private->AbsoluteInputEventSignalState) {
4174 gBS->SignalEvent (Event);
4175 return ;
4176 }
4177 //
4178 // if any physical console input device has key input, signal the event.
4179 //
4180 for (Index = 0; Index < Private->CurrentNumberOfAbsolutePointers; Index++) {
4181 Status = gBS->CheckEvent (Private->AbsolutePointerList[Index]->WaitForInput);
4182 if (!EFI_ERROR (Status)) {
4183 gBS->SignalEvent (Event);
4184 Private->AbsoluteInputEventSignalState = TRUE;
4185 }
4186 }
4187 }
4188
4189
4190 /**
4191 Reset the text output device hardware and optionaly run diagnostics
4192
4193 @param This Protocol instance pointer.
4194 @param ExtendedVerification Driver may perform more exhaustive verfication
4195 operation of the device during reset.
4196
4197 @retval EFI_SUCCESS The text output device was reset.
4198 @retval EFI_DEVICE_ERROR The text output device is not functioning
4199 correctly and could not be reset.
4200
4201 **/
4202 EFI_STATUS
4203 EFIAPI
4204 ConSplitterTextOutReset (
4205 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4206 IN BOOLEAN ExtendedVerification
4207 )
4208 {
4209 EFI_STATUS Status;
4210 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4211 UINTN Index;
4212 EFI_STATUS ReturnStatus;
4213
4214 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4215
4216 //
4217 // return the worst status met
4218 //
4219 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4220 Status = Private->TextOutList[Index].TextOut->Reset (
4221 Private->TextOutList[Index].TextOut,
4222 ExtendedVerification
4223 );
4224 if (EFI_ERROR (Status)) {
4225 ReturnStatus = Status;
4226 }
4227 }
4228
4229 This->SetAttribute (This, EFI_TEXT_ATTR (This->Mode->Attribute & 0x0F, EFI_BLACK));
4230
4231 //
4232 // reset all mode parameters
4233 //
4234 TextOutSetMode (Private, 0);
4235
4236 return ReturnStatus;
4237 }
4238
4239
4240 /**
4241 Write a Unicode string to the output device.
4242
4243 @param This Protocol instance pointer.
4244 @param WString The NULL-terminated Unicode string to be
4245 displayed on the output device(s). All output
4246 devices must also support the Unicode drawing
4247 defined in this file.
4248
4249 @retval EFI_SUCCESS The string was output to the device.
4250 @retval EFI_DEVICE_ERROR The device reported an error while attempting to
4251 output the text.
4252 @retval EFI_UNSUPPORTED The output device's mode is not currently in a
4253 defined text mode.
4254 @retval EFI_WARN_UNKNOWN_GLYPH This warning code indicates that some of the
4255 characters in the Unicode string could not be
4256 rendered and were skipped.
4257
4258 **/
4259 EFI_STATUS
4260 EFIAPI
4261 ConSplitterTextOutOutputString (
4262 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4263 IN CHAR16 *WString
4264 )
4265 {
4266 EFI_STATUS Status;
4267 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4268 UINTN Index;
4269 EFI_STATUS ReturnStatus;
4270 UINTN MaxColumn;
4271 UINTN MaxRow;
4272
4273 This->SetAttribute (This, This->Mode->Attribute);
4274
4275 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4276
4277 //
4278 // return the worst status met
4279 //
4280 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4281 Status = Private->TextOutList[Index].TextOut->OutputString (
4282 Private->TextOutList[Index].TextOut,
4283 WString
4284 );
4285 if (EFI_ERROR (Status)) {
4286 ReturnStatus = Status;
4287 }
4288 }
4289
4290 if (Private->CurrentNumberOfConsoles > 0) {
4291 Private->TextOutMode.CursorColumn = Private->TextOutList[0].TextOut->Mode->CursorColumn;
4292 Private->TextOutMode.CursorRow = Private->TextOutList[0].TextOut->Mode->CursorRow;
4293 } else {
4294 //
4295 // When there is no real console devices in system,
4296 // update cursor position for the virtual device in consplitter.
4297 //
4298 Private->TextOut.QueryMode (
4299 &Private->TextOut,
4300 Private->TextOutMode.Mode,
4301 &MaxColumn,
4302 &MaxRow
4303 );
4304 for (; *WString != CHAR_NULL; WString++) {
4305 switch (*WString) {
4306 case CHAR_BACKSPACE:
4307 if (Private->TextOutMode.CursorColumn == 0 && Private->TextOutMode.CursorRow > 0) {
4308 Private->TextOutMode.CursorRow--;
4309 Private->TextOutMode.CursorColumn = (INT32) (MaxColumn - 1);
4310 } else if (Private->TextOutMode.CursorColumn > 0) {
4311 Private->TextOutMode.CursorColumn--;
4312 }
4313 break;
4314
4315 case CHAR_LINEFEED:
4316 if (Private->TextOutMode.CursorRow < (INT32) (MaxRow - 1)) {
4317 Private->TextOutMode.CursorRow++;
4318 }
4319 break;
4320
4321 case CHAR_CARRIAGE_RETURN:
4322 Private->TextOutMode.CursorColumn = 0;
4323 break;
4324
4325 default:
4326 if (Private->TextOutMode.CursorColumn < (INT32) (MaxColumn - 1)) {
4327 Private->TextOutMode.CursorColumn++;
4328 } else {
4329 Private->TextOutMode.CursorColumn = 0;
4330 if (Private->TextOutMode.CursorRow < (INT32) (MaxRow - 1)) {
4331 Private->TextOutMode.CursorRow++;
4332 }
4333 }
4334 break;
4335 }
4336 }
4337 }
4338
4339 return ReturnStatus;
4340 }
4341
4342
4343 /**
4344 Verifies that all characters in a Unicode string can be output to the
4345 target device.
4346
4347 @param This Protocol instance pointer.
4348 @param WString The NULL-terminated Unicode string to be
4349 examined for the output device(s).
4350
4351 @retval EFI_SUCCESS The device(s) are capable of rendering the
4352 output string.
4353 @retval EFI_UNSUPPORTED Some of the characters in the Unicode string
4354 cannot be rendered by one or more of the output
4355 devices mapped by the EFI handle.
4356
4357 **/
4358 EFI_STATUS
4359 EFIAPI
4360 ConSplitterTextOutTestString (
4361 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4362 IN CHAR16 *WString
4363 )
4364 {
4365 EFI_STATUS Status;
4366 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4367 UINTN Index;
4368 EFI_STATUS ReturnStatus;
4369
4370 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4371
4372 //
4373 // return the worst status met
4374 //
4375 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4376 Status = Private->TextOutList[Index].TextOut->TestString (
4377 Private->TextOutList[Index].TextOut,
4378 WString
4379 );
4380 if (EFI_ERROR (Status)) {
4381 ReturnStatus = Status;
4382 }
4383 }
4384 //
4385 // There is no DevNullTextOutTestString () since a Unicode buffer would
4386 // always return EFI_SUCCESS.
4387 // ReturnStatus will be EFI_SUCCESS if no consoles are present
4388 //
4389 return ReturnStatus;
4390 }
4391
4392
4393 /**
4394 Returns information for an available text mode that the output device(s)
4395 supports.
4396
4397 @param This Protocol instance pointer.
4398 @param ModeNumber The mode number to return information on.
4399 @param Columns Returns the columns of the text output device
4400 for the requested ModeNumber.
4401 @param Rows Returns the rows of the text output device
4402 for the requested ModeNumber.
4403
4404 @retval EFI_SUCCESS The requested mode information was returned.
4405 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4406 the request.
4407 @retval EFI_UNSUPPORTED The mode number was not valid.
4408
4409 **/
4410 EFI_STATUS
4411 EFIAPI
4412 ConSplitterTextOutQueryMode (
4413 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4414 IN UINTN ModeNumber,
4415 OUT UINTN *Columns,
4416 OUT UINTN *Rows
4417 )
4418 {
4419 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4420 UINTN CurrentMode;
4421 INT32 *TextOutModeMap;
4422
4423 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4424
4425 //
4426 // Check whether param ModeNumber is valid.
4427 // ModeNumber should be within range 0 ~ MaxMode - 1.
4428 //
4429 if ( (ModeNumber > (UINTN)(((UINT32)-1)>>1)) ) {
4430 return EFI_UNSUPPORTED;
4431 }
4432
4433 if ((INT32) ModeNumber >= This->Mode->MaxMode) {
4434 return EFI_UNSUPPORTED;
4435 }
4436
4437 //
4438 // We get the available mode from mode intersection map if it's available
4439 //
4440 if (Private->TextOutModeMap != NULL) {
4441 TextOutModeMap = Private->TextOutModeMap + Private->TextOutListCount * ModeNumber;
4442 CurrentMode = (UINTN)(*TextOutModeMap);
4443 *Columns = Private->TextOutQueryData[CurrentMode].Columns;
4444 *Rows = Private->TextOutQueryData[CurrentMode].Rows;
4445 } else {
4446 *Columns = Private->TextOutQueryData[ModeNumber].Columns;
4447 *Rows = Private->TextOutQueryData[ModeNumber].Rows;
4448 }
4449
4450 if (*Columns <= 0 && *Rows <= 0) {
4451 return EFI_UNSUPPORTED;
4452
4453 }
4454
4455 return EFI_SUCCESS;
4456 }
4457
4458
4459 /**
4460 Sets the output device(s) to a specified mode.
4461
4462 @param This Protocol instance pointer.
4463 @param ModeNumber The mode number to set.
4464
4465 @retval EFI_SUCCESS The requested text mode was set.
4466 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4467 the request.
4468 @retval EFI_UNSUPPORTED The mode number was not valid.
4469
4470 **/
4471 EFI_STATUS
4472 EFIAPI
4473 ConSplitterTextOutSetMode (
4474 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4475 IN UINTN ModeNumber
4476 )
4477 {
4478 EFI_STATUS Status;
4479 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4480 UINTN Index;
4481 INT32 *TextOutModeMap;
4482 EFI_STATUS ReturnStatus;
4483
4484 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4485
4486 //
4487 // Check whether param ModeNumber is valid.
4488 // ModeNumber should be within range 0 ~ MaxMode - 1.
4489 //
4490 if ( (ModeNumber > (UINTN)(((UINT32)-1)>>1)) ) {
4491 return EFI_UNSUPPORTED;
4492 }
4493
4494 if ((INT32) ModeNumber >= This->Mode->MaxMode) {
4495 return EFI_UNSUPPORTED;
4496 }
4497 //
4498 // If the mode is being set to the curent mode, then just clear the screen and return.
4499 //
4500 if (Private->TextOutMode.Mode == (INT32) ModeNumber) {
4501 return ConSplitterTextOutClearScreen (This);
4502 }
4503 //
4504 // return the worst status met
4505 //
4506 TextOutModeMap = Private->TextOutModeMap + Private->TextOutListCount * ModeNumber;
4507 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4508 Status = Private->TextOutList[Index].TextOut->SetMode (
4509 Private->TextOutList[Index].TextOut,
4510 TextOutModeMap[Index]
4511 );
4512 if (EFI_ERROR (Status)) {
4513 ReturnStatus = Status;
4514 }
4515 }
4516
4517 //
4518 // Set mode parameter to specified mode number
4519 //
4520 TextOutSetMode (Private, ModeNumber);
4521
4522 return ReturnStatus;
4523 }
4524
4525
4526 /**
4527 Sets the background and foreground colors for the OutputString () and
4528 ClearScreen () functions.
4529
4530 @param This Protocol instance pointer.
4531 @param Attribute The attribute to set. Bits 0..3 are the
4532 foreground color, and bits 4..6 are the
4533 background color. All other bits are undefined
4534 and must be zero. The valid Attributes are
4535 defined in this file.
4536
4537 @retval EFI_SUCCESS The attribute was set.
4538 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4539 the request.
4540 @retval EFI_UNSUPPORTED The attribute requested is not defined.
4541
4542 **/
4543 EFI_STATUS
4544 EFIAPI
4545 ConSplitterTextOutSetAttribute (
4546 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4547 IN UINTN Attribute
4548 )
4549 {
4550 EFI_STATUS Status;
4551 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4552 UINTN Index;
4553 EFI_STATUS ReturnStatus;
4554
4555 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4556
4557 //
4558 // Check whether param Attribute is valid.
4559 //
4560 if ((Attribute | 0x7F) != 0x7F) {
4561 return EFI_UNSUPPORTED;
4562 }
4563
4564 //
4565 // return the worst status met
4566 //
4567 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4568 Status = Private->TextOutList[Index].TextOut->SetAttribute (
4569 Private->TextOutList[Index].TextOut,
4570 Attribute
4571 );
4572 if (EFI_ERROR (Status)) {
4573 ReturnStatus = Status;
4574 }
4575 }
4576
4577 Private->TextOutMode.Attribute = (INT32) Attribute;
4578
4579 return ReturnStatus;
4580 }
4581
4582
4583 /**
4584 Clears the output device(s) display to the currently selected background
4585 color.
4586
4587 @param This Protocol instance pointer.
4588
4589 @retval EFI_SUCCESS The operation completed successfully.
4590 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4591 the request.
4592 @retval EFI_UNSUPPORTED The output device is not in a valid text mode.
4593
4594 **/
4595 EFI_STATUS
4596 EFIAPI
4597 ConSplitterTextOutClearScreen (
4598 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This
4599 )
4600 {
4601 EFI_STATUS Status;
4602 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4603 UINTN Index;
4604 EFI_STATUS ReturnStatus;
4605
4606 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4607
4608 //
4609 // return the worst status met
4610 //
4611 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4612 Status = Private->TextOutList[Index].TextOut->ClearScreen (Private->TextOutList[Index].TextOut);
4613 if (EFI_ERROR (Status)) {
4614 ReturnStatus = Status;
4615 }
4616 }
4617
4618 //
4619 // No need to do extra check here as whether (Column, Row) is valid has
4620 // been checked in ConSplitterTextOutSetCursorPosition. And (0, 0) should
4621 // always be supported.
4622 //
4623 Private->TextOutMode.CursorColumn = 0;
4624 Private->TextOutMode.CursorRow = 0;
4625 Private->TextOutMode.CursorVisible = TRUE;
4626
4627 return ReturnStatus;
4628 }
4629
4630
4631 /**
4632 Sets the current coordinates of the cursor position
4633
4634 @param This Protocol instance pointer.
4635 @param Column The column position to set the cursor to. Must be
4636 greater than or equal to zero and less than the
4637 number of columns by QueryMode ().
4638 @param Row The row position to set the cursor to. Must be
4639 greater than or equal to zero and less than the
4640 number of rows by QueryMode ().
4641
4642 @retval EFI_SUCCESS The operation completed successfully.
4643 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4644 the request.
4645 @retval EFI_UNSUPPORTED The output device is not in a valid text mode,
4646 or the cursor position is invalid for the
4647 current mode.
4648
4649 **/
4650 EFI_STATUS
4651 EFIAPI
4652 ConSplitterTextOutSetCursorPosition (
4653 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4654 IN UINTN Column,
4655 IN UINTN Row
4656 )
4657 {
4658 EFI_STATUS Status;
4659 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4660 UINTN Index;
4661 EFI_STATUS ReturnStatus;
4662 UINTN MaxColumn;
4663 UINTN MaxRow;
4664 INT32 *TextOutModeMap;
4665 INT32 ModeNumber;
4666 INT32 CurrentMode;
4667
4668 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4669 TextOutModeMap = NULL;
4670 ModeNumber = Private->TextOutMode.Mode;
4671
4672 //
4673 // Get current MaxColumn and MaxRow from intersection map
4674 //
4675 if (Private->TextOutModeMap != NULL) {
4676 TextOutModeMap = Private->TextOutModeMap + Private->TextOutListCount * ModeNumber;
4677 CurrentMode = *TextOutModeMap;
4678 } else {
4679 CurrentMode = ModeNumber;
4680 }
4681
4682 MaxColumn = Private->TextOutQueryData[CurrentMode].Columns;
4683 MaxRow = Private->TextOutQueryData[CurrentMode].Rows;
4684
4685 if (Column >= MaxColumn || Row >= MaxRow) {
4686 return EFI_UNSUPPORTED;
4687 }
4688 //
4689 // return the worst status met
4690 //
4691 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4692 Status = Private->TextOutList[Index].TextOut->SetCursorPosition (
4693 Private->TextOutList[Index].TextOut,
4694 Column,
4695 Row
4696 );
4697 if (EFI_ERROR (Status)) {
4698 ReturnStatus = Status;
4699 }
4700 }
4701
4702 //
4703 // No need to do extra check here as whether (Column, Row) is valid has
4704 // been checked in ConSplitterTextOutSetCursorPosition. And (0, 0) should
4705 // always be supported.
4706 //
4707 Private->TextOutMode.CursorColumn = (INT32) Column;
4708 Private->TextOutMode.CursorRow = (INT32) Row;
4709
4710 return ReturnStatus;
4711 }
4712
4713
4714 /**
4715 Makes the cursor visible or invisible
4716
4717 @param This Protocol instance pointer.
4718 @param Visible If TRUE, the cursor is set to be visible. If
4719 FALSE, the cursor is set to be invisible.
4720
4721 @retval EFI_SUCCESS The operation completed successfully.
4722 @retval EFI_DEVICE_ERROR The device had an error and could not complete
4723 the request, or the device does not support
4724 changing the cursor mode.
4725 @retval EFI_UNSUPPORTED The output device is not in a valid text mode.
4726
4727 **/
4728 EFI_STATUS
4729 EFIAPI
4730 ConSplitterTextOutEnableCursor (
4731 IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
4732 IN BOOLEAN Visible
4733 )
4734 {
4735 EFI_STATUS Status;
4736 TEXT_OUT_SPLITTER_PRIVATE_DATA *Private;
4737 UINTN Index;
4738 EFI_STATUS ReturnStatus;
4739
4740 Private = TEXT_OUT_SPLITTER_PRIVATE_DATA_FROM_THIS (This);
4741
4742 //
4743 // return the worst status met
4744 //
4745 for (Index = 0, ReturnStatus = EFI_SUCCESS; Index < Private->CurrentNumberOfConsoles; Index++) {
4746 Status = Private->TextOutList[Index].TextOut->EnableCursor (
4747 Private->TextOutList[Index].TextOut,
4748 Visible
4749 );
4750 if (EFI_ERROR (Status)) {
4751 ReturnStatus = Status;
4752 }
4753 }
4754
4755 Private->TextOutMode.CursorVisible = Visible;
4756
4757 return ReturnStatus;
4758 }
4759
4760
4761 /**
4762 An empty function to pass error checking of CreateEventEx ().
4763
4764 @param Event Event whose notification function is being invoked.
4765 @param Context Pointer to the notification function's context,
4766 which is implementation-dependent.
4767
4768 **/
4769 VOID
4770 EFIAPI
4771 ConSplitterEmptyCallbackFunction (
4772 IN EFI_EVENT Event,
4773 IN VOID *Context
4774 )
4775 {
4776 }
EFI Development Kit II mirror for PVE