IntelFsp2Pkg/SplitFspBin.py: Support rebasing 1.x binary.

[mirror_edk2.git] / OvmfPkg / SioBusDxe / SioService.c

/** @file\r
  The SioBusDxe driver is used to create child devices on the ISA bus and\r
  installs the Super I/O protocols on them.\r
\r
  Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>\r
\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "SioBusDxe.h"\r
\r
//\r
// Super I/O Protocol interfaces\r
//\r
EFI_SIO_PROTOCOL mSioInterface = {\r
  SioRegisterAccess,\r
  SioGetResources,\r
  SioSetResources,\r
  SioPossibleResources,\r
  SioModify\r
};\r
\r
//\r
// COM 1 UART Controller\r
//\r
GLOBAL_REMOVE_IF_UNREFERENCED\r
SIO_RESOURCES_IO mCom1Resources = {\r
  { { ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR }, 0x3F8, 8 },\r
  { ACPI_END_TAG_DESCRIPTOR,                    0        }\r
};\r
\r
//\r
// COM 2 UART Controller\r
//\r
GLOBAL_REMOVE_IF_UNREFERENCED\r
SIO_RESOURCES_IO mCom2Resources = {\r
  { { ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR }, 0x2F8, 8 },\r
  { ACPI_END_TAG_DESCRIPTOR,                    0        }\r
};\r
\r
//\r
// PS/2 Keyboard Controller\r
//\r
GLOBAL_REMOVE_IF_UNREFERENCED\r
SIO_RESOURCES_IO mPs2KeyboardDeviceResources = {\r
  { { ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR }, 0x60, 5 },\r
  { ACPI_END_TAG_DESCRIPTOR,                    0       }\r
};\r
\r
//\r
// Table of SIO Controllers\r
//\r
GLOBAL_REMOVE_IF_UNREFERENCED\r
SIO_DEVICE_INFO mDevicesInfo[] = {\r
  {\r
    EISA_PNP_ID (0x501),\r
    0,\r
    { (ACPI_SMALL_RESOURCE_HEADER *) &mCom1Resources }\r
  },  // COM 1 UART Controller\r
  {\r
    EISA_PNP_ID (0x501),\r
    1,\r
    { (ACPI_SMALL_RESOURCE_HEADER *) &mCom2Resources }\r
  },  // COM 2 UART Controller\r
  {\r
    EISA_PNP_ID(0x303),\r
    0,\r
    { (ACPI_SMALL_RESOURCE_HEADER *) &mPs2KeyboardDeviceResources }\r
  }   // PS/2 Keyboard Controller\r
};\r
\r
//\r
// ACPI Device Path Node template\r
//\r
GLOBAL_REMOVE_IF_UNREFERENCED\r
ACPI_HID_DEVICE_PATH mAcpiDeviceNodeTemplate = {\r
  {        // Header\r
    ACPI_DEVICE_PATH,\r
    ACPI_DP,\r
    {\r
      (UINT8) (sizeof (ACPI_HID_DEVICE_PATH)),\r
      (UINT8) ((sizeof (ACPI_HID_DEVICE_PATH)) >> 8)\r
    }\r
  },\r
  0x0,     // HID\r
  0x0      // UID\r
};\r
\r
\r
/**\r
  Provides a low level access to the registers for the Super I/O.\r
\r
  @param[in]     This           Indicates a pointer to the calling context.\r
  @param[in]     Write          Specifies the type of the register operation.\r
                                If this parameter is TRUE, Value is interpreted\r
                                as an input parameter and the operation is a\r
                                register write. If this parameter is FALSE,\r
                                Value is interpreted as an output parameter and\r
                                the operation is a register read.\r
  @param[in]     ExitCfgMode    Exit Configuration Mode Indicator. If this\r
                                parameter is set to TRUE, the Super I/O driver\r
                                will turn off configuration mode of the Super\r
                                I/O prior to returning from this function. If\r
                                this parameter is set to FALSE, the Super I/O\r
                                driver will leave Super I/O in the\r
                                configuration mode. The Super I/O driver must\r
                                track the current state of the Super I/O and\r
                                enable the configuration mode of Super I/O if\r
                                necessary prior to register access.\r
  @param[in]     Register       Register number.\r
  @param[in,out] Value          If Write is TRUE, Value is a pointer to the\r
                                buffer containing the byte of data to be\r
                                written to the Super I/O register. If Write is\r
                                FALSE, Value is a pointer to the destination\r
                                buffer for the byte of data to be read from the\r
                                Super I/O register.\r
\r
  @retval EFI_SUCCESS           The operation completed successfully.\r
  @retval EFI_INVALID_PARAMETER The Value is NULL.\r
  @retval EFI_INVALID_PARAMETER Invalid Register number.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SioRegisterAccess (\r
  IN CONST EFI_SIO_PROTOCOL    *This,\r
  IN       BOOLEAN             Write,\r
  IN       BOOLEAN             ExitCfgMode,\r
  IN       UINT8               Register,\r
  IN OUT   UINT8               *Value\r
  )\r
{\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Provides an interface to get a list of the current resources consumed by the\r
  device in the ACPI Resource Descriptor format.\r
\r
  GetResources() returns a list of resources currently consumed by the device.\r
  The ResourceList is a pointer to the buffer containing resource descriptors\r
  for the device. The descriptors are in the format of Small or Large ACPI\r
  resource descriptor as defined by ACPI specification (2.0 & 3.0). The buffer\r
  of resource descriptors is terminated with the 'End tag' resource descriptor.\r
\r
  @param[in]  This              Indicates a pointer to the calling context.\r
  @param[out] ResourceList      A pointer to an ACPI resource descriptor list\r
                                that defines the current resources used by the\r
                                device.\r
\r
  @retval EFI_SUCCESS           The operation completed successfully.\r
  @retval EFI_INVALID_PARAMETER ResourceList is NULL.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SioGetResources (\r
  IN CONST EFI_SIO_PROTOCOL            *This,\r
  OUT      ACPI_RESOURCE_HEADER_PTR    *ResourceList\r
  )\r
{\r
  SIO_DEV    *SioDevice;\r
\r
  if (ResourceList == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  SioDevice = SIO_DEV_FROM_SIO (This);\r
  if (SioDevice->DeviceIndex < ARRAY_SIZE (mDevicesInfo)) {\r
    *ResourceList = mDevicesInfo[SioDevice->DeviceIndex].Resources;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Sets the resources for the device.\r
\r
  @param[in] This               Indicates a pointer to the calling context.\r
  @param[in] ResourceList       Pointer to the ACPI resource descriptor list.\r
\r
  @retval EFI_SUCCESS           The operation completed successfully.\r
  @retval EFI_INVALID_PARAMETER ResourceList is invalid.\r
  @retval EFI_ACCESS_DENIED     Some of the resources in ResourceList are in\r
                                use.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SioSetResources (\r
  IN CONST EFI_SIO_PROTOCOL            *This,\r
  IN       ACPI_RESOURCE_HEADER_PTR    ResourceList\r
  )\r
{\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Provides a collection of resource descriptor lists. Each resource descriptor\r
  list in the collection defines a combination of resources that can\r
  potentially be used by the device.\r
\r
  @param[in]  This                  Indicates a pointer to the calling context.\r
  @param[out] ResourceCollection    Collection of the resource descriptor\r
                                    lists.\r
\r
  @retval EFI_SUCCESS               The operation completed successfully.\r
  @retval EFI_INVALID_PARAMETER     ResourceCollection is NULL.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SioPossibleResources (\r
  IN CONST EFI_SIO_PROTOCOL            *This,\r
  OUT      ACPI_RESOURCE_HEADER_PTR    *ResourceCollection\r
  )\r
{\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Provides an interface for a table based programming of the Super I/O\r
  registers.\r
\r
  The Modify() function provides an interface for table based programming of\r
  the Super I/O registers. This function can be used to perform programming of\r
  multiple Super I/O registers with a single function call. For each table\r
  entry, the Register is read, its content is bitwise ANDed with AndMask, and\r
  then ORed with OrMask before being written back to the Register. The Super\r
  I/O driver must track the current state of the Super I/O and enable the\r
  configuration mode of Super I/O if necessary prior to table processing. Once\r
  the table is processed, the Super I/O device has to be returned to the\r
  original state.\r
\r
  @param[in] This               Indicates a pointer to the calling context.\r
  @param[in] Command            A pointer to an array of NumberOfCommands\r
                                EFI_SIO_REGISTER_MODIFY structures. Each\r
                                structure specifies a single Super I/O register\r
                                modify operation.\r
  @param[in] NumberOfCommands   Number of elements in the Command array.\r
\r
  @retval EFI_SUCCESS           The operation completed successfully.\r
  @retval EFI_INVALID_PARAMETER Command is NULL.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SioModify (\r
  IN CONST EFI_SIO_PROTOCOL           *This,\r
  IN CONST EFI_SIO_REGISTER_MODIFY    *Command,\r
  IN       UINTN                      NumberOfCommands\r
  )\r
{\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Create the child device with a given device index.\r
\r
  @param[in] This              The EFI_DRIVER_BINDING_PROTOCOL instance.\r
  @param[in] Controller        The handle of ISA bus controller.\r
  @param[in] PciIo             The pointer to the PCI protocol.\r
  @param[in] ParentDevicePath  Device path of the ISA bus controller.\r
  @param[in] DeviceIndex       Index of the device supported by this driver.\r
\r
  @retval EFI_SUCCESS          The child device has been created successfully.\r
  @retval Others               Error occured during the child device creation.\r
\r
**/\r
EFI_STATUS\r
SioCreateChildDevice (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   Controller,\r
  IN EFI_PCI_IO_PROTOCOL          *PciIo,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *ParentDevicePath,\r
  IN UINT32                       DeviceIndex\r
  )\r
{\r
  EFI_STATUS    Status;\r
  SIO_DEV       *SioDevice;\r
\r
  //\r
  // Initialize the SIO_DEV structure\r
  //\r
  SioDevice = AllocateZeroPool (sizeof (SIO_DEV));\r
  if (SioDevice == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  SioDevice->Signature  = SIO_DEV_SIGNATURE;\r
  SioDevice->Handle     = NULL;\r
  SioDevice->PciIo      = PciIo;\r
\r
  //\r
  // Construct the child device path\r
  //\r
  mAcpiDeviceNodeTemplate.HID = mDevicesInfo[DeviceIndex].Hid;\r
  mAcpiDeviceNodeTemplate.UID = mDevicesInfo[DeviceIndex].Uid;\r
  SioDevice->DevicePath = AppendDevicePathNode (\r
                            ParentDevicePath,\r
                            (EFI_DEVICE_PATH_PROTOCOL *) &mAcpiDeviceNodeTemplate\r
                            );\r
  if (SioDevice->DevicePath == NULL) {\r
    Status = EFI_OUT_OF_RESOURCES;\r
    goto Done;\r
  }\r
\r
  CopyMem (&SioDevice->Sio, &mSioInterface, sizeof (EFI_SIO_PROTOCOL));\r
  SioDevice->DeviceIndex = DeviceIndex;\r
\r
  //\r
  // Create a child handle and install Device Path and Super I/O protocols\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &SioDevice->Handle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  SioDevice->DevicePath,\r
                  &gEfiSioProtocolGuid,\r
                  &SioDevice->Sio,\r
                  NULL\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    goto Done;\r
  }\r
\r
  Status = gBS->OpenProtocol (\r
                  Controller,\r
                  &gEfiPciIoProtocolGuid,\r
                  (VOID **) &PciIo,\r
                  This->DriverBindingHandle,\r
                  SioDevice->Handle,\r
                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    gBS->UninstallMultipleProtocolInterfaces (\r
           SioDevice->Handle,\r
           &gEfiDevicePathProtocolGuid,\r
           SioDevice->DevicePath,\r
           &gEfiSioProtocolGuid,\r
           &SioDevice->Sio,\r
           NULL\r
           );\r
  }\r
\r
Done:\r
  if (EFI_ERROR (Status)) {\r
    if (SioDevice->DevicePath != NULL) {\r
      FreePool (SioDevice->DevicePath);\r
    }\r
\r
    FreePool (SioDevice);\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
  Create all the ISA child devices on the ISA bus controller (PCI to ISA\r
  bridge).\r
\r
  @param[in] This              The EFI_DRIVER_BINDING_PROTOCOL instance.\r
  @param[in] Controller        The handle of ISA bus controller.\r
  @param[in] PciIo             The pointer to the PCI protocol.\r
  @param[in] ParentDevicePath  Device path of the ISA bus controller.\r
\r
  @retval The number of child device that is successfully created.\r
\r
**/\r
UINT32\r
SioCreateAllChildDevices (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   Controller,\r
  IN EFI_PCI_IO_PROTOCOL          *PciIo,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *ParentDevicePath\r
  )\r
{\r
  UINT32        Index;\r
  UINT32        ChildDeviceNumber;\r
  EFI_STATUS    Status;\r
\r
  ChildDeviceNumber = 0;\r
\r
  for (Index = 0; Index < ARRAY_SIZE (mDevicesInfo); Index++) {\r
    Status = SioCreateChildDevice (\r
               This,\r
               Controller,\r
               PciIo,\r
               ParentDevicePath,\r
               Index\r
               );\r
    if (!EFI_ERROR (Status)) {\r
      ChildDeviceNumber++;\r
    }\r
  }\r
\r
  return ChildDeviceNumber;\r
}\r