MdeModulePkg/Universal/PlatformDriOverrideDxe/PlatformDriOverrideDxe.inf

   1 ## @file
   2 #  This driver produces UEFI PLATFORM_DRIVER_OVERRIDE_PROTOCOL if this protocol doesn't exist.
   3 #  It doesn't install again if this protocol exists.
   4 #  It only implements one interface GetDriver of PLATFORM_DRIVER_OVERRIDE_PROTOCOL protocol
   5 #  and doesn't support other two interfaces GetDriverPath, DriverLoaded.
   6 #
   7 #  This driver also offers an UI interface in device manager to let user configure
   8 #  platform override protocol to override the default algorithm for matching
   9 #  drivers to controllers.
  10 #
  11 #  The main flow:
  12 #  1. It dynamicly locate all controller device path.
  13 #  2. It dynamicly locate all drivers which support binding protocol.
  14 #  3. It export and dynamicly update two menu to let user select the
  15 #     mapping between drivers to controllers.
  16 #  4. It save all the mapping info in NV variables for the following boot,
  17 #     which will be consumed by GetDriver API of the produced the platform override protocol.
  18 #
  19 # Caution: This module is a sample implementation for the test purpose.
  20 #
  21 # Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
  22 #
  23 #  SPDX-License-Identifier: BSD-2-Clause-Patent
  24 #
  25 ##
  26
  27 [Defines]
  28   INF_VERSION                    = 0x00010005
  29   BASE_NAME                      = PlatDriOverrideDxe
  30   MODULE_UNI_FILE                = PlatDriOverrideDxe.uni
  31   FILE_GUID                      = 35034CE2-A6E5-4fb4-BABE-A0156E9B2549
  32   MODULE_TYPE                    = DXE_DRIVER
  33   VERSION_STRING                 = 1.0
  34   ENTRY_POINT                    = PlatDriOverrideDxeInit
  35   UNLOAD_IMAGE                   = PlatDriOverrideDxeUnload
  36
  37 #
  38 # The following information is for reference only and not required by the build tools.
  39 #
  40 #  VALID_ARCHITECTURES           = IA32 X64 EBC
  41 #
  42
  43 [Sources]
  44   VfrStrings.uni
  45   Vfr.vfr
  46   PlatDriOverrideDxe.c
  47   PlatOverMngr.h
  48   PlatDriOverrideLib.c
  49   InternalPlatDriOverrideDxe.h
  50
  51 [Packages]
  52   MdePkg/MdePkg.dec
  53   MdeModulePkg/MdeModulePkg.dec
  54
  55 [LibraryClasses]
  56   BaseLib
  57   DebugLib
  58   UefiLib
  59   UefiDriverEntryPoint
  60   UefiBootServicesTableLib
  61   HiiLib
  62   BaseMemoryLib
  63   MemoryAllocationLib
  64   DevicePathLib
  65   DxeServicesTableLib
  66   UefiRuntimeServicesTableLib
  67   PrintLib
  68
  69 [Guids]
  70   #
  71   # This GUID C Name is not required for build since it is from UefiLib and not directly used by this module source.
  72   #  gEfiGlobalVariableGuid                     ## SOMETIMES_CONSUMES   ## Variable:L"PlatformLang" # this variable specifies the platform supported language string (RFC 4646 format)
  73   #  gEfiGlobalVariableGuid                     ## SOMETIMES_CONSUMES   ## Variable:L"Lang" # this variable specifies the platform supported language string (ISO 639-2 format)
  74   #
  75   # There could be more than one variables, from PlatDriOver, PlatDriOver1, PlatDriOver2,...
  76   #  gEfiCallerIdGuid                           ## Private  ## Variable:L"PlatDriOver"
  77   #
  78   gEfiIfrTianoGuid                              ## SOMETIMES_PRODUCES   ## UNDEFINED
  79   ## SOMETIMES_CONSUMES ## GUID # HiiIsConfigHdrMatch Data
  80   ## SOMETIMES_PRODUCES ## GUID # HiiGetBrowserData Data
  81   ## SOMETIMES_CONSUMES ## GUID # HiiSetBrowserData Data
  82   ## SOMETIMES_PRODUCES ## GUID # HiiConstructConfigHdr Data
  83   ## CONSUMES           ## HII
  84   gPlatformOverridesManagerGuid
  85
  86 [Protocols]
  87   gEfiComponentName2ProtocolGuid                ## SOMETIMES_CONSUMES # Get Driver Name if ComponentName2Protocol exists
  88   gEfiComponentNameProtocolGuid                 ## SOMETIMES_CONSUMES # Get Driver Name if ComponentNameProtocol exists and ComponentName2Protocol doesn't exist
  89   gEfiFirmwareVolume2ProtocolGuid               ## SOMETIMES_CONSUMES # Get Driver Name from EFI UI section if ComponentName2Protocol and ComponentNameProtocol don't exist
  90   gEfiPciIoProtocolGuid                         ## SOMETIMES_CONSUMES # Find the PCI device if PciIo protocol is installed
  91   gEfiBusSpecificDriverOverrideProtocolGuid     ## SOMETIMES_CONSUMES # Check whether the PCI device contains one or more efi drivers in its option rom by this protocol
  92
  93   gEfiDriverBindingProtocolGuid                 ## SOMETIMES_CONSUMES
  94   gEfiLoadedImageProtocolGuid                   ## SOMETIMES_CONSUMES
  95   gEfiLoadedImageDevicePathProtocolGuid         ## SOMETIMES_CONSUMES # Show the drivers in the second page that support DriverBindingProtocol, LoadedImageProtocol and LoadedImageDevicePathProtocol
  96
  97   gEfiFormBrowser2ProtocolGuid                  ## CONSUMES
  98   gEfiHiiConfigRoutingProtocolGuid              ## CONSUMES
  99   gEfiHiiConfigAccessProtocolGuid               ## PRODUCES
 100   gEfiPlatformDriverOverrideProtocolGuid        ## PRODUCES
 101   ## PRODUCES
 102   ## SOMETIMES_CONSUMES # Show the controller device in the first page that support DevicePathProtocol
 103   gEfiDevicePathProtocolGuid
 104
 105 [Depex]
 106   gEfiFormBrowser2ProtocolGuid AND gEfiHiiConfigRoutingProtocolGuid
 107
 108 [UserExtensions.TianoCore."ExtraFiles"]
 109   PlatDriOverrideDxeExtra.uni