/** @file Copyright (c) 2006 Intel Corporation. All rights reserved 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. **/ #include "VgaMiniPort.h" // // EFI Driver Binding Protocol Instance // // This driver has a version value of 0x00000000. This is the // lowest possible priority for a driver. This is done on purpose to help // the developers of UGA drivers. This driver can bind if no UGA driver // is present, so a console is available. Then, when a UGA driver is loaded // this driver can be disconnected, and the UGA driver can be connected. // As long as the UGA driver has a version value greater than 0x00000000, it // will be connected first and will block this driver from connecting. // EFI_DRIVER_BINDING_PROTOCOL gPciVgaMiniPortDriverBinding = { PciVgaMiniPortDriverBindingSupported, PciVgaMiniPortDriverBindingStart, PciVgaMiniPortDriverBindingStop, 0x00000000, NULL, NULL }; // // Driver Entry Point // EFI_STATUS EFIAPI PciVgaMiniPortDriverEntryPoint ( IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable ) /** Routine Description: Driver Entry Point. Arguments: (Standard EFI Image entry - EFI_IMAGE_ENTRY_POINT) Returns: EFI_STATUS **/ { return EfiLibInstallDriverBindingComponentName2 ( ImageHandle, SystemTable, &gPciVgaMiniPortDriverBinding, ImageHandle, &gPciVgaMiniPortComponentName, &gPciVgaMiniPortComponentName2 ); } /** Supported. (Standard DriverBinding Protocol Supported() function) @return EFI_STATUS **/ EFI_STATUS EFIAPI PciVgaMiniPortDriverBindingSupported ( IN EFI_DRIVER_BINDING_PROTOCOL *This, IN EFI_HANDLE Controller, IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath ) { EFI_STATUS Status; EFI_PCI_IO_PROTOCOL *PciIo; PCI_TYPE00 Pci; // // Open the IO Abstraction(s) needed to perform the supported test // Status = gBS->OpenProtocol ( Controller, &gEfiPciIoProtocolGuid, (VOID **) &PciIo, This->DriverBindingHandle, Controller, EFI_OPEN_PROTOCOL_BY_DRIVER ); if (EFI_ERROR (Status)) { return Status; } // // See if this is a PCI VGA Controller by looking at the Command register and // Class Code Register // Status = PciIo->Pci.Read ( PciIo, EfiPciIoWidthUint32, 0, sizeof (Pci) / sizeof (UINT32), &Pci ); if (EFI_ERROR (Status)) { goto Done; } Status = EFI_UNSUPPORTED; // // See if the device is an enabled VGA device. // Most systems can only have on VGA device on at a time. // if (((Pci.Hdr.Command & 0x03) == 0x03) && IS_PCI_VGA (&Pci)) { Status = EFI_SUCCESS; } Done: gBS->CloseProtocol ( Controller, &gEfiPciIoProtocolGuid, This->DriverBindingHandle, Controller ); return Status; } /** Install VGA Mini Port Protocol onto VGA device handles (Standard DriverBinding Protocol Start() function) @return EFI_STATUS **/ EFI_STATUS EFIAPI PciVgaMiniPortDriverBindingStart ( IN EFI_DRIVER_BINDING_PROTOCOL *This, IN EFI_HANDLE Controller, IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath ) { EFI_STATUS Status; EFI_PCI_IO_PROTOCOL *PciIo; PCI_VGA_MINI_PORT_DEV *PciVgaMiniPortPrivate; PciVgaMiniPortPrivate = NULL; PciIo = NULL; // // Open the IO Abstraction(s) needed // Status = gBS->OpenProtocol ( Controller, &gEfiPciIoProtocolGuid, (VOID **) &PciIo, This->DriverBindingHandle, Controller, EFI_OPEN_PROTOCOL_BY_DRIVER ); if (EFI_ERROR (Status)) { goto Done; } // // Allocate the private device structure // Status = gBS->AllocatePool ( EfiBootServicesData, sizeof (PCI_VGA_MINI_PORT_DEV), (VOID **) &PciVgaMiniPortPrivate ); if (EFI_ERROR (Status)) { goto Done; } ZeroMem (PciVgaMiniPortPrivate, sizeof (PCI_VGA_MINI_PORT_DEV)); // // Initialize the private device structure // PciVgaMiniPortPrivate->Signature = PCI_VGA_MINI_PORT_DEV_SIGNATURE; PciVgaMiniPortPrivate->Handle = Controller; PciVgaMiniPortPrivate->PciIo = PciIo; PciVgaMiniPortPrivate->VgaMiniPort.SetMode = PciVgaMiniPortSetMode; PciVgaMiniPortPrivate->VgaMiniPort.VgaMemoryOffset = 0xb8000; PciVgaMiniPortPrivate->VgaMiniPort.CrtcAddressRegisterOffset = 0x3d4; PciVgaMiniPortPrivate->VgaMiniPort.CrtcDataRegisterOffset = 0x3d5; PciVgaMiniPortPrivate->VgaMiniPort.VgaMemoryBar = EFI_PCI_IO_PASS_THROUGH_BAR; PciVgaMiniPortPrivate->VgaMiniPort.CrtcAddressRegisterBar = EFI_PCI_IO_PASS_THROUGH_BAR; PciVgaMiniPortPrivate->VgaMiniPort.CrtcDataRegisterBar = EFI_PCI_IO_PASS_THROUGH_BAR; PciVgaMiniPortPrivate->VgaMiniPort.MaxMode = 1; // // Install Vga Mini Port Protocol // Status = gBS->InstallMultipleProtocolInterfaces ( &Controller, &gEfiVgaMiniPortProtocolGuid, &PciVgaMiniPortPrivate->VgaMiniPort, NULL ); Done: if (EFI_ERROR (Status)) { gBS->CloseProtocol ( Controller, &gEfiPciIoProtocolGuid, This->DriverBindingHandle, Controller ); if (PciVgaMiniPortPrivate) { gBS->FreePool (PciVgaMiniPortPrivate); } } return Status; } /** Stop. (Standard DriverBinding Protocol Stop() function) @return EFI_STATUS **/ EFI_STATUS EFIAPI PciVgaMiniPortDriverBindingStop ( IN EFI_DRIVER_BINDING_PROTOCOL *This, IN EFI_HANDLE Controller, IN UINTN NumberOfChildren, IN EFI_HANDLE *ChildHandleBuffer ) { EFI_STATUS Status; EFI_VGA_MINI_PORT_PROTOCOL *VgaMiniPort; PCI_VGA_MINI_PORT_DEV *PciVgaMiniPortPrivate; Status = gBS->OpenProtocol ( Controller, &gEfiVgaMiniPortProtocolGuid, (VOID **) &VgaMiniPort, This->DriverBindingHandle, Controller, EFI_OPEN_PROTOCOL_GET_PROTOCOL ); if (EFI_ERROR (Status)) { return Status; } PciVgaMiniPortPrivate = PCI_VGA_MINI_PORT_DEV_FROM_THIS (VgaMiniPort); Status = gBS->UninstallProtocolInterface ( Controller, &gEfiVgaMiniPortProtocolGuid, &PciVgaMiniPortPrivate->VgaMiniPort ); if (EFI_ERROR (Status)) { return Status; } gBS->CloseProtocol ( Controller, &gEfiPciIoProtocolGuid, This->DriverBindingHandle, Controller ); gBS->FreePool (PciVgaMiniPortPrivate); return EFI_SUCCESS; } // // VGA Mini Port Protocol Functions // /** GC_TODO: Add function description @param This GC_TODO: add argument description @param ModeNumber GC_TODO: add argument description @retval EFI_UNSUPPORTED GC_TODO: Add description for return value @retval EFI_SUCCESS GC_TODO: Add description for return value **/ EFI_STATUS EFIAPI PciVgaMiniPortSetMode ( IN EFI_VGA_MINI_PORT_PROTOCOL *This, IN UINTN ModeNumber ) { if (ModeNumber > This->MaxMode) { return EFI_UNSUPPORTED; } return EFI_SUCCESS; }