git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11105 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			455 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			455 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*++
 | |
| 
 | |
| Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
 | |
| This program and the accompanying materials
 | |
| are licensed and made available under the terms and conditions of the BSD License
 | |
| which accompanies this distribution.  The full text of the license may be found at
 | |
| http://opensource.org/licenses/bsd-license.php
 | |
| 
 | |
| THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 | |
| WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | |
| 
 | |
| Module Name:
 | |
| 
 | |
|     UnixUgaScreen.c
 | |
| 
 | |
| Abstract:
 | |
| 
 | |
|   This file produces the graphics abstration of UGA. It is called by
 | |
|   UnixUgaDriver.c file which deals with the EFI 1.1 driver model.
 | |
|   This file just does graphics.
 | |
| 
 | |
| --*/
 | |
| 
 | |
| #include "UnixUga.h"
 | |
| 
 | |
| EFI_UNIX_THUNK_PROTOCOL *mUnix;
 | |
| EFI_EVENT          mUgaScreenExitBootServicesEvent;
 | |
| 
 | |
| EFI_STATUS
 | |
| UnixUgaStartWindow (
 | |
|   IN  UGA_PRIVATE_DATA    *Private,
 | |
|   IN  UINT32              HorizontalResolution,
 | |
|   IN  UINT32              VerticalResolution,
 | |
|   IN  UINT32              ColorDepth,
 | |
|   IN  UINT32              RefreshRate
 | |
|   );
 | |
| 
 | |
| VOID
 | |
| EFIAPI
 | |
| KillNtUgaThread (
 | |
|   IN EFI_EVENT  Event,
 | |
|   IN VOID       *Context
 | |
|   );
 | |
| 
 | |
| //
 | |
| // UGA Protocol Member Functions
 | |
| //
 | |
| 
 | |
| EFI_STATUS
 | |
| EFIAPI
 | |
| UnixUgaGetMode (
 | |
|   EFI_UGA_DRAW_PROTOCOL *This,
 | |
|   UINT32                *HorizontalResolution,
 | |
|   UINT32                *VerticalResolution,
 | |
|   UINT32                *ColorDepth,
 | |
|   UINT32                *RefreshRate
 | |
|   )
 | |
| /*++
 | |
| 
 | |
|   Routine Description:
 | |
|     Return the current video mode information.
 | |
| 
 | |
|   Arguments:
 | |
|     This                  - Protocol instance pointer.
 | |
|     HorizontalResolution  - Current video horizontal resolution in pixels
 | |
|     VerticalResolution    - Current video Vertical resolution in pixels
 | |
|     ColorDepth            - Current video color depth in bits per pixel
 | |
|     RefreshRate           - Current video refresh rate in Hz.
 | |
| 
 | |
|   Returns:
 | |
|     EFI_SUCCESS     - Mode information returned.
 | |
|     EFI_NOT_STARTED - Video display is not initialized. Call SetMode ()
 | |
|     EFI_INVALID_PARAMETER - One of the input args was NULL.
 | |
| 
 | |
| --*/
 | |
| // TODO:    ADD IN/OUT description here
 | |
| {
 | |
|   UGA_PRIVATE_DATA  *Private;
 | |
| 
 | |
|   Private = UGA_DRAW_PRIVATE_DATA_FROM_THIS (This);
 | |
| 
 | |
|   if (Private->HardwareNeedsStarting) {
 | |
|     return EFI_NOT_STARTED;
 | |
|   }
 | |
| 
 | |
|   if ((HorizontalResolution == NULL) ||
 | |
|       (VerticalResolution   == NULL) ||
 | |
|       (ColorDepth           == NULL) ||
 | |
|       (RefreshRate          == NULL)) {
 | |
|     return EFI_INVALID_PARAMETER;
 | |
|   }
 | |
| 
 | |
|   *HorizontalResolution = Private->HorizontalResolution;
 | |
|   *VerticalResolution   = Private->VerticalResolution;
 | |
|   *ColorDepth           = Private->ColorDepth;
 | |
|   *RefreshRate          = Private->RefreshRate;
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| EFI_STATUS
 | |
| EFIAPI
 | |
| UnixUgaSetMode (
 | |
|   EFI_UGA_DRAW_PROTOCOL *This,
 | |
|   UINT32                HorizontalResolution,
 | |
|   UINT32                VerticalResolution,
 | |
|   UINT32                ColorDepth,
 | |
|   UINT32                RefreshRate
 | |
|   )
 | |
| /*++
 | |
| 
 | |
|   Routine Description:
 | |
|     Return the current video mode information.
 | |
| 
 | |
|   Arguments:
 | |
|     This                  - Protocol instance pointer.
 | |
|     HorizontalResolution  - Current video horizontal resolution in pixels
 | |
|     VerticalResolution    - Current video Vertical resolution in pixels
 | |
|     ColorDepth            - Current video color depth in bits per pixel
 | |
|     RefreshRate           - Current video refresh rate in Hz.
 | |
| 
 | |
|   Returns:
 | |
|     EFI_SUCCESS     - Mode information returned.
 | |
|     EFI_NOT_STARTED - Video display is not initialized. Call SetMode ()
 | |
|     EFI_INVALID_PARAMETER - One of the input args was NULL.
 | |
| 
 | |
| --*/
 | |
| // TODO:    EFI_DEVICE_ERROR - add return value to function comment
 | |
| // TODO:    EFI_DEVICE_ERROR - add return value to function comment
 | |
| // TODO:    ADD IN/OUT description here
 | |
| {
 | |
|   EFI_STATUS        Status;
 | |
|   UGA_PRIVATE_DATA  *Private;
 | |
|   EFI_UGA_PIXEL     Fill;
 | |
| 
 | |
|   Private = UGA_DRAW_PRIVATE_DATA_FROM_THIS (This);
 | |
| 
 | |
|   if (Private->HardwareNeedsStarting) {
 | |
|     Status = UnixUgaStartWindow (
 | |
|               Private,
 | |
|               HorizontalResolution,
 | |
|               VerticalResolution,
 | |
|               ColorDepth,
 | |
|               RefreshRate
 | |
|               );
 | |
|     if (EFI_ERROR (Status)) {
 | |
|       return EFI_DEVICE_ERROR;
 | |
|     }
 | |
| 
 | |
|     Private->HardwareNeedsStarting = FALSE;
 | |
|   }
 | |
|   Status = Private->UgaIo->UgaSize(Private->UgaIo,
 | |
|              HorizontalResolution,
 | |
|              VerticalResolution);
 | |
| 
 | |
|   Private->HorizontalResolution = HorizontalResolution;
 | |
|   Private->VerticalResolution   = VerticalResolution;
 | |
|   Private->ColorDepth           = ColorDepth;
 | |
|   Private->RefreshRate          = RefreshRate;
 | |
| 
 | |
|   Fill.Red                      = 0x7f;
 | |
|   Fill.Green                    = 0x7F;
 | |
|   Fill.Blue                     = 0x7f;
 | |
|   This->Blt (
 | |
|           This,
 | |
|           &Fill,
 | |
|           EfiUgaVideoFill,
 | |
|           0,
 | |
|           0,
 | |
|           0,
 | |
|           0,
 | |
|           HorizontalResolution,
 | |
|           VerticalResolution,
 | |
|           HorizontalResolution * sizeof (EFI_UGA_PIXEL)
 | |
|           );
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| EFI_STATUS
 | |
| EFIAPI
 | |
| UnixUgaBlt (
 | |
|   IN  EFI_UGA_DRAW_PROTOCOL                   *This,
 | |
|   IN  EFI_UGA_PIXEL                           *BltBuffer, OPTIONAL
 | |
|   IN  EFI_UGA_BLT_OPERATION                   BltOperation,
 | |
|   IN  UINTN                                   SourceX,
 | |
|   IN  UINTN                                   SourceY,
 | |
|   IN  UINTN                                   DestinationX,
 | |
|   IN  UINTN                                   DestinationY,
 | |
|   IN  UINTN                                   Width,
 | |
|   IN  UINTN                                   Height,
 | |
|   IN  UINTN                                   Delta         OPTIONAL
 | |
|   )
 | |
| /*++
 | |
| 
 | |
|   Routine Description:
 | |
|     Blt pixels from the rectangle (Width X Height) formed by the BltBuffer
 | |
|     onto the graphics screen starting a location (X, Y). (0, 0) is defined as
 | |
|     the upper left hand side of the screen. (X, Y) can be outside of the
 | |
|     current screen geometry and the BltBuffer will be cliped when it is
 | |
|     displayed. X and Y can be negative or positive. If Width or Height is
 | |
|     bigger than the current video screen the image will be clipped.
 | |
| 
 | |
|   Arguments:
 | |
|     This          - Protocol instance pointer.
 | |
|     X             - X location on graphics screen.
 | |
|     Y             - Y location on the graphics screen.
 | |
|     Width         - Width of BltBuffer.
 | |
|     Height        - Hight of BltBuffer
 | |
|     BltOperation  - Operation to perform on BltBuffer and video memory
 | |
|     BltBuffer     - Buffer containing data to blt into video buffer. This
 | |
|                     buffer has a size of Width*Height*sizeof(EFI_UGA_PIXEL)
 | |
|     SourceX       - If the BltOperation is a EfiCopyBlt this is the source
 | |
|                     of the copy. For other BLT operations this argument is not
 | |
|                     used.
 | |
|     SourceX       - If the BltOperation is a EfiCopyBlt this is the source
 | |
|                     of the copy. For other BLT operations this argument is not
 | |
|                     used.
 | |
| 
 | |
|   Returns:
 | |
|     EFI_SUCCESS           - The palette is updated with PaletteArray.
 | |
|     EFI_INVALID_PARAMETER - BltOperation is not valid.
 | |
|     EFI_DEVICE_ERROR      - A hardware error occured writting to the video
 | |
|                              buffer.
 | |
| 
 | |
| --*/
 | |
| // TODO:    SourceY - add argument and description to function comment
 | |
| // TODO:    DestinationX - add argument and description to function comment
 | |
| // TODO:    DestinationY - add argument and description to function comment
 | |
| // TODO:    Delta - add argument and description to function comment
 | |
| {
 | |
|   UGA_PRIVATE_DATA  *Private;
 | |
|   EFI_TPL           OriginalTPL;
 | |
|   EFI_STATUS        Status;
 | |
|   UGA_BLT_ARGS      UgaBltArgs;
 | |
| 
 | |
|   Private = UGA_DRAW_PRIVATE_DATA_FROM_THIS (This);
 | |
| 
 | |
|   if ((BltOperation < 0) || (BltOperation >= EfiUgaBltMax)) {
 | |
|     return EFI_INVALID_PARAMETER;
 | |
|   }
 | |
| 
 | |
|   if (Width == 0 || Height == 0) {
 | |
|     return EFI_INVALID_PARAMETER;
 | |
|   }
 | |
|   //
 | |
|   // If Delta is zero, then the entire BltBuffer is being used, so Delta
 | |
|   // is the number of bytes in each row of BltBuffer.  Since BltBuffer is Width pixels size,
 | |
|   // the number of bytes in each row can be computed.
 | |
|   //
 | |
|   if (Delta == 0) {
 | |
|     Delta = Width * sizeof (EFI_UGA_PIXEL);
 | |
|   }
 | |
| 
 | |
|   //
 | |
|   // We have to raise to TPL Notify, so we make an atomic write the frame buffer.
 | |
|   // We would not want a timer based event (Cursor, ...) to come in while we are
 | |
|   // doing this operation.
 | |
|   //
 | |
|   OriginalTPL = gBS->RaiseTPL (TPL_NOTIFY);
 | |
| 
 | |
|   //
 | |
|   // Pack UGA Draw protocol parameters to UGA_BLT_ARGS structure to adapt to
 | |
|   // UgaBlt() API of Unix UGA IO protocol.
 | |
|   //
 | |
|   UgaBltArgs.DestinationX = DestinationX;
 | |
|   UgaBltArgs.DestinationY = DestinationY;
 | |
|   UgaBltArgs.Height       = Height;
 | |
|   UgaBltArgs.Width        = Width;
 | |
|   UgaBltArgs.SourceX      = SourceX;
 | |
|   UgaBltArgs.SourceY      = SourceY;
 | |
|   UgaBltArgs.Delta        = Delta;
 | |
|   Status = Private->UgaIo->UgaBlt (Private->UgaIo,
 | |
|              BltBuffer,
 | |
|              BltOperation,
 | |
|              &UgaBltArgs
 | |
|              );
 | |
| 
 | |
|   gBS->RestoreTPL (OriginalTPL);
 | |
| 
 | |
|   return Status;
 | |
| }
 | |
| 
 | |
| 
 | |
| //
 | |
| // Construction and Destruction functions
 | |
| //
 | |
| 
 | |
| EFI_STATUS
 | |
| UnixUgaSupported (
 | |
|   IN  EFI_UNIX_IO_PROTOCOL  *UnixIo
 | |
|   )
 | |
| /*++
 | |
| 
 | |
| Routine Description:
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| Returns:
 | |
| 
 | |
|   None
 | |
| 
 | |
| --*/
 | |
| // TODO:    UnixIo - add argument and description to function comment
 | |
| // TODO:    EFI_UNSUPPORTED - add return value to function comment
 | |
| // TODO:    EFI_SUCCESS - add return value to function comment
 | |
| {
 | |
|   //
 | |
|   // Check to see if the IO abstraction represents a device type we support.
 | |
|   //
 | |
|   // This would be replaced a check of PCI subsystem ID, etc.
 | |
|   //
 | |
|   if (!CompareGuid (UnixIo->TypeGuid, &gEfiUnixUgaGuid)) {
 | |
|     return EFI_UNSUPPORTED;
 | |
|   }
 | |
| 
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| 
 | |
| EFI_STATUS
 | |
| UnixUgaStartWindow (
 | |
|   IN  UGA_PRIVATE_DATA    *Private,
 | |
|   IN  UINT32              HorizontalResolution,
 | |
|   IN  UINT32              VerticalResolution,
 | |
|   IN  UINT32              ColorDepth,
 | |
|   IN  UINT32              RefreshRate
 | |
|   )
 | |
| /*++
 | |
| 
 | |
| Routine Description:
 | |
| 
 | |
|   TODO: Add function description
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
|   Private               - TODO: add argument description
 | |
|   HorizontalResolution  - TODO: add argument description
 | |
|   VerticalResolution    - TODO: add argument description
 | |
|   ColorDepth            - TODO: add argument description
 | |
|   RefreshRate           - TODO: add argument description
 | |
| 
 | |
| Returns:
 | |
| 
 | |
|   TODO: add return values
 | |
| 
 | |
| --*/
 | |
| {
 | |
|   EFI_STATUS          Status;
 | |
| 
 | |
|   mUnix  = Private->UnixThunk;
 | |
| 
 | |
|   Private->HorizontalResolution = HorizontalResolution;
 | |
|   Private->VerticalResolution   = VerticalResolution;
 | |
| 
 | |
|   //
 | |
|   // Register to be notified on exit boot services so we can destroy the window.
 | |
|   //
 | |
|   Status = gBS->CreateEvent (
 | |
|                   EVT_SIGNAL_EXIT_BOOT_SERVICES,
 | |
|                   TPL_CALLBACK,
 | |
|                   KillNtUgaThread,
 | |
|                   Private,
 | |
|                   &mUgaScreenExitBootServicesEvent
 | |
|                   );
 | |
| 
 | |
|   Status = Private->UnixThunk->UgaCreate(&Private->UgaIo, Private->WindowName);
 | |
|   return Status;
 | |
| }
 | |
| 
 | |
| EFI_STATUS
 | |
| UnixUgaConstructor (
 | |
|   UGA_PRIVATE_DATA    *Private
 | |
|   )
 | |
| /*++
 | |
| 
 | |
| Routine Description:
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| Returns:
 | |
| 
 | |
|   None
 | |
| 
 | |
| --*/
 | |
| // TODO:    Private - add argument and description to function comment
 | |
| // TODO:    EFI_SUCCESS - add return value to function comment
 | |
| {
 | |
| 
 | |
|   Private->UgaDraw.GetMode        = UnixUgaGetMode;
 | |
|   Private->UgaDraw.SetMode        = UnixUgaSetMode;
 | |
|   Private->UgaDraw.Blt            = UnixUgaBlt;
 | |
| 
 | |
|   Private->HardwareNeedsStarting  = TRUE;
 | |
|   Private->UgaIo = NULL;
 | |
| 
 | |
|   UnixUgaInitializeSimpleTextInForWindow (Private);
 | |
| 
 | |
|   UnixUgaInitializeSimplePointerForWindow (Private);
 | |
| 
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| EFI_STATUS
 | |
| UnixUgaDestructor (
 | |
|   UGA_PRIVATE_DATA     *Private
 | |
|   )
 | |
| /*++
 | |
| 
 | |
| Routine Description:
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| Returns:
 | |
| 
 | |
|   None
 | |
| 
 | |
| --*/
 | |
| // TODO:    Private - add argument and description to function comment
 | |
| // TODO:    EFI_SUCCESS - add return value to function comment
 | |
| {
 | |
|   if (!Private->HardwareNeedsStarting) {
 | |
|     Private->UgaIo->UgaClose(Private->UgaIo);
 | |
|     Private->UgaIo = NULL;
 | |
|   }
 | |
| 
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| VOID
 | |
| EFIAPI
 | |
| KillNtUgaThread (
 | |
|   IN EFI_EVENT  Event,
 | |
|   IN VOID       *Context
 | |
|   )
 | |
| /*++
 | |
| 
 | |
| Routine Description:
 | |
| 
 | |
|   This is the UGA screen's callback notification function for exit-boot-services.
 | |
|   All we do here is call UnixUgaDestructor().
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
|   Event   - not used
 | |
|   Context - pointer to the Private structure.
 | |
| 
 | |
| Returns:
 | |
| 
 | |
|   None.
 | |
| 
 | |
| --*/
 | |
| {
 | |
|   EFI_STATUS  Status;
 | |
|   Status = UnixUgaDestructor (Context);
 | |
| }
 |