]> git.proxmox.com Git - mirror_edk2.git/blobdiff - IntelFrameworkModulePkg/Bus/Isa/Ps2MouseAbsolutePointerDxe/Ps2MouseAbsolutePointer.c
IntelFrameworkModulePkg: Fix typos in comments
[mirror_edk2.git] / IntelFrameworkModulePkg / Bus / Isa / Ps2MouseAbsolutePointerDxe / Ps2MouseAbsolutePointer.c
index 55ebf95351086bfc604ae286130dc7348cbf455b..bf8adfcb2f77c1cf190811e7f82aba59c8359afa 100644 (file)
@@ -1,9 +1,9 @@
-/**@file\r
-  A faked PS/2 Touchpad driver. Routines that interacts with callers,\r
+/** @file\r
+  A faked PS/2 Absolute Pointer driver. Routines that interacts with callers,\r
   conforming to EFI driver model\r
   \r
-Copyright (c) 2006 - 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>\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
@@ -109,9 +109,9 @@ PS2MouseAbsolutePointerDriverSupported (
 }\r
 \r
 /**\r
-  Start this driver on ControllerHandle by opening a IsaIo\r
-  protocol, creating PS2_MOUSE_ABSOLUTE_POINTER_DEV device and install gEfiAbsolutePointerProtocolGuid\r
-  finnally.\r
+  Start this driver on ControllerHandle by opening a IsaIo protocol, creating\r
+  PS2_MOUSE_ABSOLUTE_POINTER_DEV device and install gEfiAbsolutePointerProtocolGuid\r
+  finally.\r
 \r
   @param  This                 Protocol instance pointer.\r
   @param  ControllerHandle     Handle of device to bind driver to\r
@@ -205,9 +205,9 @@ PS2MouseAbsolutePointerDriverStart (
   //\r
   MouseAbsolutePointerDev->Signature       = PS2_MOUSE_ABSOLUTE_POINTER_DEV_SIGNATURE;\r
   MouseAbsolutePointerDev->Handle          = Controller;\r
-  MouseAbsolutePointerDev->SampleRate      = SSR_20;\r
-  MouseAbsolutePointerDev->Resolution      = CMR4;\r
-  MouseAbsolutePointerDev->Scaling         = SF1;\r
+  MouseAbsolutePointerDev->SampleRate      = SampleRate20;\r
+  MouseAbsolutePointerDev->Resolution      = MouseResolution4;\r
+  MouseAbsolutePointerDev->Scaling         = Scaling1;\r
   MouseAbsolutePointerDev->DataPackageSize = 3;\r
   MouseAbsolutePointerDev->IsaIo           = IsaIo;\r
   MouseAbsolutePointerDev->DevicePath      = ParentDevicePath;\r
@@ -230,6 +230,12 @@ PS2MouseAbsolutePointerDriverStart (
   //\r
   // Initialize keyboard controller if necessary\r
   //\r
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (  \r
+    EFI_PROGRESS_CODE,\r
+    EFI_PERIPHERAL_MOUSE | EFI_P_MOUSE_PC_SELF_TEST,\r
+    ParentDevicePath\r
+    );\r
+\r
   IsaIo->Io.Read (IsaIo, EfiIsaIoWidthUint8, KBC_CMD_STS_PORT, 1, &Data);\r
   if ((Data & KBC_SYSF) != KBC_SYSF) {\r
     Status = KbcSelfTest (IsaIo);\r
@@ -250,7 +256,10 @@ PS2MouseAbsolutePointerDriverStart (
   //\r
   // Reset the mouse\r
   //\r
-  Status = MouseAbsolutePointerDev->AbsolutePointerProtocol.Reset (&MouseAbsolutePointerDev->AbsolutePointerProtocol, TRUE);\r
+  Status = MouseAbsolutePointerDev->AbsolutePointerProtocol.Reset (\r
+                     &MouseAbsolutePointerDev->AbsolutePointerProtocol,\r
+                     FeaturePcdGet (PcdPs2MouseExtendedVerification)\r
+                     );\r
   if (EFI_ERROR (Status)) {\r
     //\r
     // mouse not connected\r
@@ -259,6 +268,13 @@ PS2MouseAbsolutePointerDriverStart (
     StatusCode  = EFI_PERIPHERAL_MOUSE | EFI_P_EC_NOT_DETECTED;\r
     goto ErrorExit;\r
   }\r
+\r
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
+    EFI_PROGRESS_CODE,\r
+    EFI_PERIPHERAL_MOUSE | EFI_P_PC_DETECTED,\r
+    ParentDevicePath\r
+    );\r
+\r
   //\r
   // Setup the WaitForKey event\r
   //\r
@@ -363,7 +379,7 @@ ErrorExit:
   }\r
 \r
   if (MouseAbsolutePointerDev != NULL) {\r
-    gBS->FreePool (MouseAbsolutePointerDev);\r
+    FreePool (MouseAbsolutePointerDev);\r
   }\r
 \r
   gBS->CloseProtocol (\r
@@ -386,7 +402,7 @@ ErrorExit:
 }\r
 \r
 /**\r
-  Stop this driver on ControllerHandle. Support stoping any child handles\r
+  Stop this driver on ControllerHandle. Support stopping any child handles\r
   created by this driver.\r
 \r
   @param  This              Protocol instance pointer.\r
@@ -444,10 +460,6 @@ PS2MouseAbsolutePointerDriverStop (
   if (EFI_ERROR (Status)) {\r
     return Status;\r
   }\r
-  //\r
-  // Disable mouse on keyboard controller\r
-  //\r
-  KbcDisableAux (MouseAbsolutePointerDev->IsaIo);\r
 \r
   //\r
   // Cancel mouse data polling timer, close timer event\r
@@ -466,7 +478,7 @@ PS2MouseAbsolutePointerDriverStop (
 \r
   gBS->CloseEvent (MouseAbsolutePointerDev->AbsolutePointerProtocol.WaitForInput);\r
   FreeUnicodeStringTable (MouseAbsolutePointerDev->ControllerNameTable);\r
-  gBS->FreePool (MouseAbsolutePointerDev);\r
+  FreePool (MouseAbsolutePointerDev);\r
 \r
   gBS->CloseProtocol (\r
          Controller,\r
@@ -486,14 +498,14 @@ PS2MouseAbsolutePointerDriverStop (
 }\r
 \r
 /**\r
-  Reset the Mouse and do BAT test for it, if ExtendedVerification isTRUE and there is a mouse device connectted to system\r
+  Reset the Mouse and do BAT test for it, if ExtendedVerification is TRUE and there is a mouse device connected to system.\r
 \r
   @param This                 - Pointer of simple pointer Protocol.\r
   @param ExtendedVerification - Whether configure mouse parameters. True: do; FALSE: skip.\r
 \r
 \r
   @retval EFI_SUCCESS         - The command byte is written successfully.\r
-  @retval EFI_DEVICE_ERROR    - Errors occurred during reseting keyboard.\r
+  @retval EFI_DEVICE_ERROR    - Errors occurred during resetting keyboard.\r
 \r
 **/\r
 EFI_STATUS\r
@@ -604,7 +616,7 @@ Exit:
 /**\r
   Check whether there is Ps/2 mouse device in system\r
 \r
-  @param PS2_MOUSE_DEV - Mouse Private Data Structure\r
+  @param MouseAbsolutePointerDev - Absolute Pointer Device Private Data Structure\r
 \r
   @retval TRUE                - Keyboard in System.\r
   @retval FALSE               - Keyboard not in System.\r
@@ -674,22 +686,19 @@ MouseAbsolutePointerGetState (
 \r
 /**\r
 \r
-  Event notification function for SIMPLE_POINTER.WaitForInput event\r
-  Signal the event if there is input from mouse\r
+  Event notification function for SIMPLE_POINTER.WaitForInput event.\r
+  Signal the event if there is input from mouse.\r
 \r
   @param Event    event object\r
   @param Context  event context\r
 \r
 **/\r
-\r
 VOID\r
 EFIAPI\r
 MouseAbsolutePointerWaitForInput (\r
   IN  EFI_EVENT               Event,\r
   IN  VOID                    *Context\r
   )\r
-// GC_TODO:    Event - add argument and description to function comment\r
-// GC_TODO:    Context - add argument and description to function comment\r
 {\r
   PS2_MOUSE_ABSOLUTE_POINTER_DEV *MouseAbsolutePointerDev;\r
 \r
@@ -706,8 +715,8 @@ MouseAbsolutePointerWaitForInput (
 }\r
 \r
 /**\r
-  Event notification function for TimerEvent event\r
-  If mouse device is connected to system, try to get the mouse packet data\r
+  Event notification function for TimerEvent event.\r
+  If mouse device is connected to system, try to get the mouse packet data.\r
 \r
   @param Event      -  TimerEvent in PS2_MOUSE_DEV\r
   @param Context    -  Pointer to PS2_MOUSE_DEV structure\r