Update the copyright notice format

[mirror_edk2.git] / MdeModulePkg / Bus / Usb / UsbKbDxe / UsbKbDxe.inf

diff --git a/MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf b/MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf
index 6408c052a658363c1db4078edea7a1659ef31e49..6c2c7f43150ac36eaeb283b52525e90303c2fcb1 100644 (file)
--- a/MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf
+++ b/MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf
@@ -1,10 +1,21 @@
-#/** @file\r
-# Component name for module UsbKb\r
+## @file\r
+# USB Keyboard Driver that manages USB keyboard and produces Simple Text Input\r
+# Protocol and Simple Text Input Ex Protocol.\r
 #\r
-# FIX ME!\r
-# Copyright (c) 2006, Intel Corporation. All right reserved.\r
+# USB Keyboard Driver consumes USB I/O Protocol and Device Path Protocol, and produces\r
+# Simple Text Input Protocol and Simple Text Input Ex Protocol on USB keyboard devices.\r
+# It initializes the keyboard layout according to info retrieved from HII database.\r
+# If HII cannot provide the info, this module uses its carried default one if PCD allows.\r
+# It manages the USB keyboard device via Asynchronous Interrupt Transfer of USB I/O Protocol,\r
+# and parses the data according to USB HID documents.\r
+# This module refers to following specifications:\r
+# 1. Universal Serial Bus HID Firmware Specification, ver 1.11\r
+# 2. Universal Serial Bus HID Usage Tables, ver 1.12\r
+# 3. UEFI Specification, v2.1\r
 #\r
-#  All rights reserved. This program and the accompanying materials\r
+# Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+#\r
+#  This program and the accompanying materials\r
 #  are licensed and made available under the terms and conditions of the BSD License\r
 #  which accompanies this distribution. The full text of the license may be found at\r
 #  http://opensource.org/licenses/bsd-license.php\r
@@ -13,17 +24,14 @@
 #  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 #\r
 #\r
-#**/\r
+##\r
 \r
 [Defines]\r
   INF_VERSION                    = 0x00010005\r
   BASE_NAME                      = UsbKbDxe\r
   FILE_GUID                      = 2D2E62CF-9ECF-43b7-8219-94E7FC713DFE\r
-  MODULE_TYPE                    = DXE_DRIVER\r
+  MODULE_TYPE                    = UEFI_DRIVER\r
   VERSION_STRING                 = 1.0\r
-  EDK_RELEASE_VERSION            = 0x00020000\r
-  EFI_SPECIFICATION_VERSION      = 0x00020000\r
-\r
   ENTRY_POINT                    = USBKeyboardDriverBindingEntryPoint\r
 \r
 #\r
@@ -31,17 +39,21 @@
 #\r
 #  VALID_ARCHITECTURES           = IA32 X64 IPF EBC\r
 #\r
+#  DRIVER_BINDING                =  gUsbKeyboardDriverBinding                        \r
+#  COMPONENT_NAME                =  gUsbKeyboardComponentName\r
+#  COMPONENT_NAME2               =  gUsbKeyboardComponentName2\r
+#\r
 \r
-[Sources.common]\r
-  efikey.c\r
-  efikey.h\r
-  keyboard.c\r
+[Sources]\r
+  EfiKey.c\r
+  EfiKey.h\r
+  KeyBoard.c\r
   ComponentName.c\r
-  keyboard.h\r
+  KeyBoard.h\r
 \r
 [Packages]\r
   MdePkg/MdePkg.dec\r
-\r
+  MdeModulePkg/MdeModulePkg.dec\r
 \r
 [LibraryClasses]\r
   MemoryAllocationLib\r
@@ -53,24 +65,46 @@
   ReportStatusCodeLib\r
   DebugLib\r
   PcdLib\r
-  UsbLib\r
-\r
+  UefiUsbLib\r
+  HiiLib\r
 \r
 [Guids]\r
-  gEfiHotPlugDeviceGuid                         # ALWAYS_CONSUMED\r
-\r
+  ##\r
+  # Event registered to EFI_HII_SET_KEYBOARD_LAYOUT_EVENT_GUID group,\r
+  # which will be triggered by EFI_HII_DATABASE_PROTOCOL.SetKeyboardLayout().\r
+  #\r
+  gEfiHiiKeyBoardLayoutGuid                     ## SOMETIME_CONSUMES  ## Event\r
 \r
 [Protocols]\r
-  gEfiUsbIoProtocolGuid                         # PROTOCOL ALWAYS_CONSUMED\r
-  gEfiDevicePathProtocolGuid                    # PROTOCOL ALWAYS_CONSUMED\r
-  gEfiSimpleTextInProtocolGuid                  # PROTOCOL ALWAYS_CONSUMED\r
+  gEfiUsbIoProtocolGuid                         ## TO_START\r
+  gEfiDevicePathProtocolGuid                    ## TO_START\r
+  gEfiSimpleTextInProtocolGuid                  ## BY_START\r
+  gEfiSimpleTextInputExProtocolGuid             ## BY_START\r
+  ##\r
+  # If HII Database Protocol exists, then keyboard layout from HII database is used.\r
+  # Otherwise, USB keyboard module tries to use its carried default layout.\r
+  #\r
+  gEfiHiiDatabaseProtocolGuid                   ## SOMETIMES_CONSUMES (Default value is used if it's absent.)\r
+  \r
+[FeaturePcd]\r
+  gEfiMdeModulePkgTokenSpaceGuid.PcdDisableDefaultKeyboardLayoutInUsbKbDriver ## SOMETIME_CONSUMES (Checked when no layout is provided by HII.) \r
 \r
-[PcdsFixedAtBuild]\r
-  PcdStatusCodeValueKeyboardEnable|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardPresenceDetect|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardDisable|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardReset|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardClearBuffer|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardSelfTest|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardInterfaceError|gEfiMdePkgTokenSpaceGuid\r
-  PcdStatusCodeValueKeyboardInputError|gEfiMdePkgTokenSpaceGuid
\ No newline at end of file
+# [Event]\r
+#   ##\r
+#   # Periodic timer event for generation of repeat key\r
+#   #\r
+#   EVENT_TYPE_PERIODIC_TIMER                   ## PRODUCES\r
+#   ##\r
+#   # Periodic timer event for delayed recovery, which deals with device error.\r
+#   #\r
+#   EVENT_TYPE_PERIODIC_TIMER                   ## PRODUCES\r
+#   ##\r
+#   # Event for EFI_SIMPLE_TEXT_INPUT_PROTOCOL.WaitForKey\r
+#   #\r
+#   EVENT_TYPE_NOTIFY_WAIT                      ## PRODUCES\r
+#   ##\r
+#   # Event for EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL.WaitForKeyEx\r
+#   #\r
+#   EVENT_TYPE_NOTIFY_WAIT                      ## PRODUCES\r
+#\r
+#\r