Initial import.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@3 6f19259b-4bc3-4df7-8a09-765794883524

1 files changed, 346 insertions, 0 deletions

diff --git a/EdkModulePkg/Bus/Pci/CirrusLogic/Dxe/CirrusLogic5430.c b/EdkModulePkg/Bus/Pci/CirrusLogic/Dxe/CirrusLogic5430.c
new file mode 100644
index 0000000000..91d6accd99
--- /dev/null
+++ b/EdkModulePkg/Bus/Pci/CirrusLogic/Dxe/CirrusLogic5430.c
@@ -0,0 +1,346 @@
+/*++

+

+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.             

+

+Module Name:

+

+  CirrusLogic5430.c

+    

+Abstract:

+

+  Cirrus Logic 5430 Controller Driver.

+  This driver is a sample implementation of the UGA Draw Protocol for the

+  Cirrus Logic 5430 family of PCI video controllers.  This driver is only

+  usable in the EFI pre-boot environment.  This sample is intended to show

+  how the UGA Draw Protocol is able to function.  The UGA I/O Protocol is not

+  implemented in this sample.  A fully compliant EFI UGA driver requires both

+  the UGA Draw and the UGA I/O Protocol.  Please refer to Microsoft's

+  documentation on UGA for details on how to write a UGA driver that is able

+  to function both in the EFI pre-boot environment and from the OS runtime.

+

+Revision History:

+

+--*/

+

+//

+// Cirrus Logic 5430 Controller Driver

+//

+

+#include "CirrusLogic5430.h"

+

+EFI_DRIVER_BINDING_PROTOCOL gCirrusLogic5430DriverBinding = {

+  CirrusLogic5430ControllerDriverSupported,

+  CirrusLogic5430ControllerDriverStart,

+  CirrusLogic5430ControllerDriverStop,

+  0x10,

+  NULL,

+  NULL

+};

+

+EFI_STATUS

+EFIAPI

+CirrusLogic5430ControllerDriverSupported (

+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,

+  IN EFI_HANDLE                     Controller,

+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath

+  )

+/*++

+

+Routine Description:

+

+Arguments:

+

+Returns:

+

+    None

+

+--*/

+// TODO:    This - add argument and description to function comment

+// TODO:    Controller - add argument and description to function comment

+// TODO:    RemainingDevicePath - add argument and description to function comment

+{

+  EFI_STATUS          Status;

+  EFI_PCI_IO_PROTOCOL *PciIo;

+  PCI_TYPE00          Pci;

+

+  //

+  // Open the PCI I/O Protocol

+  //

+  Status = gBS->OpenProtocol (

+                  Controller,

+                  &gEfiPciIoProtocolGuid,

+                  (VOID **) &PciIo,

+                  This->DriverBindingHandle,

+                  Controller,

+                  EFI_OPEN_PROTOCOL_BY_DRIVER

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  //

+  // Read the PCI Configuration Header from the PCI Device

+  //

+  Status = PciIo->Pci.Read (

+                        PciIo,

+                        EfiPciIoWidthUint32,

+                        0,

+                        sizeof (Pci) / sizeof (UINT32),

+                        &Pci

+                        );

+  if (EFI_ERROR (Status)) {

+    goto Done;

+  }

+

+  Status = EFI_UNSUPPORTED;

+  //

+  // See if the I/O enable is on.  Most systems only allow one VGA device to be turned on

+  // at a time, so see if this is one that is turned on.

+  //

+  //  if (((Pci.Hdr.Command & 0x01) == 0x01)) {

+  //

+  // See if this is a Cirrus Logic PCI controller

+  //

+  if (Pci.Hdr.VendorId == CIRRUS_LOGIC_VENDOR_ID) {

+    //

+    // See if this is a 5430 or a 5446 PCI controller

+    //

+    if (Pci.Hdr.DeviceId == CIRRUS_LOGIC_5430_DEVICE_ID) {

+      Status = EFI_SUCCESS;

+    }

+

+    if (Pci.Hdr.DeviceId == CIRRUS_LOGIC_5430_ALTERNATE_DEVICE_ID) {

+      Status = EFI_SUCCESS;

+    }

+

+    if (Pci.Hdr.DeviceId == CIRRUS_LOGIC_5446_DEVICE_ID) {

+      Status = EFI_SUCCESS;

+    }

+  }

+

+Done:

+  //

+  // Close the PCI I/O Protocol

+  //

+  gBS->CloseProtocol (

+        Controller,

+        &gEfiPciIoProtocolGuid,

+        This->DriverBindingHandle,

+        Controller

+        );

+

+  return Status;

+}

+

+EFI_STATUS

+EFIAPI

+CirrusLogic5430ControllerDriverStart (

+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,

+  IN EFI_HANDLE                     Controller,

+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath

+  )

+/*++

+

+Routine Description:

+

+Arguments:

+

+Returns:

+

+    None

+

+--*/

+// TODO:    This - add argument and description to function comment

+// TODO:    Controller - add argument and description to function comment

+// TODO:    RemainingDevicePath - add argument and description to function comment

+{

+  EFI_STATUS                      Status;

+  CIRRUS_LOGIC_5430_PRIVATE_DATA  *Private;

+

+  //

+  // Allocate Private context data for UGA Draw inteface.

+  //

+  Private = NULL;

+  Private = AllocateZeroPool (sizeof (CIRRUS_LOGIC_5430_PRIVATE_DATA));

+  if (Private == NULL) {

+    Status = EFI_OUT_OF_RESOURCES;

+    goto Error;

+  }

+

+  //

+  // Set up context record

+  //

+  Private->Signature  = CIRRUS_LOGIC_5430_PRIVATE_DATA_SIGNATURE;

+  Private->Handle     = Controller;

+

+  //

+  // Open PCI I/O Protocol

+  //

+  Status = gBS->OpenProtocol (

+                  Private->Handle,

+                  &gEfiPciIoProtocolGuid,

+                  (VOID **) &Private->PciIo,

+                  This->DriverBindingHandle,

+                  Private->Handle,

+                  EFI_OPEN_PROTOCOL_BY_DRIVER

+                  );

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  Status = Private->PciIo->Attributes (

+                            Private->PciIo,

+                            EfiPciIoAttributeOperationEnable,

+                            EFI_PCI_DEVICE_ENABLE | EFI_PCI_IO_ATTRIBUTE_VGA_MEMORY | EFI_PCI_IO_ATTRIBUTE_VGA_IO,

+                            NULL

+                            );

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  //

+  // Start the UGA Draw software stack.

+  //

+  Status = CirrusLogic5430UgaDrawConstructor (Private);

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  //

+  // Publish the UGA Draw interface to the world

+  //

+  Status = gBS->InstallMultipleProtocolInterfaces (

+                  &Private->Handle,

+                  &gEfiUgaDrawProtocolGuid,

+                  &Private->UgaDraw,

+                  NULL

+                  );

+

+Error:

+  if (EFI_ERROR (Status)) {

+    if (Private) {

+      if (Private->PciIo) {

+        Private->PciIo->Attributes (

+                          Private->PciIo,

+                          EfiPciIoAttributeOperationDisable,

+                          EFI_PCI_DEVICE_ENABLE | EFI_PCI_IO_ATTRIBUTE_VGA_MEMORY | EFI_PCI_IO_ATTRIBUTE_VGA_IO,

+                          NULL

+                          );

+      }

+    }

+

+    //

+    // Close the PCI I/O Protocol

+    //

+    gBS->CloseProtocol (

+          Private->Handle,

+          &gEfiPciIoProtocolGuid,

+          This->DriverBindingHandle,

+          Private->Handle

+          );

+    if (Private) {

+      gBS->FreePool (Private);

+    }

+  }

+

+  return Status;

+}

+

+EFI_STATUS

+EFIAPI

+CirrusLogic5430ControllerDriverStop (

+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,

+  IN EFI_HANDLE                     Controller,

+  IN UINTN                          NumberOfChildren,

+  IN EFI_HANDLE                     *ChildHandleBuffer

+  )

+/*++

+

+Routine Description:

+

+Arguments:

+

+Returns:

+

+    None

+

+--*/

+// TODO:    This - add argument and description to function comment

+// TODO:    Controller - add argument and description to function comment

+// TODO:    NumberOfChildren - add argument and description to function comment

+// TODO:    ChildHandleBuffer - add argument and description to function comment

+// TODO:    EFI_SUCCESS - add return value to function comment

+{

+  EFI_UGA_DRAW_PROTOCOL           *UgaDraw;

+  EFI_STATUS                      Status;

+  CIRRUS_LOGIC_5430_PRIVATE_DATA  *Private;

+

+  Status = gBS->OpenProtocol (

+                  Controller,

+                  &gEfiUgaDrawProtocolGuid,

+                  (VOID **) &UgaDraw,

+                  This->DriverBindingHandle,

+                  Controller,

+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL

+                  );

+  if (EFI_ERROR (Status)) {

+    //

+    // If the UGA Draw interface does not exist the driver is not started

+    //

+    return Status;

+  }

+

+  //

+  // Get our private context information

+  //

+  Private = CIRRUS_LOGIC_5430_PRIVATE_DATA_FROM_UGA_DRAW_THIS (UgaDraw);

+

+  //

+  // Remove the UGA Draw interface from the system

+  //

+  Status = gBS->UninstallMultipleProtocolInterfaces (

+                  Private->Handle,

+                  &gEfiUgaDrawProtocolGuid,

+                  &Private->UgaDraw,

+                  NULL

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  //

+  // Shutdown the hardware

+  //

+  CirrusLogic5430UgaDrawDestructor (Private);

+

+  Private->PciIo->Attributes (

+                    Private->PciIo,

+                    EfiPciIoAttributeOperationDisable,

+                    EFI_PCI_DEVICE_ENABLE | EFI_PCI_IO_ATTRIBUTE_VGA_MEMORY | EFI_PCI_IO_ATTRIBUTE_VGA_IO,

+                    NULL

+                    );

+

+  //

+  // Close the PCI I/O Protocol

+  //

+  gBS->CloseProtocol (

+        Controller,

+        &gEfiPciIoProtocolGuid,

+        This->DriverBindingHandle,

+        Controller

+        );

+

+  //

+  // Free our instance data

+  //

+  gBS->FreePool (Private);

+

+  return EFI_SUCCESS;

+}