/** @file\r
+ USB Mouse Driver that manages USB mouse and produces Absolute Pointer Protocol.\r
\r
-Copyright (c) 2004 - 2007, Intel Corporation\r
-All rights reserved. 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
-\r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
-\r
- Module Name:\r
-\r
- UsbMouseAbsolutePointer.c\r
-\r
- Abstract:\r
-\r
+Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "UsbMouseAbsolutePointer.h"\r
\r
-#include <Library/DebugLib.h>\r
-#include <IndustryStandard/Usb.h>\r
-\r
-#include "mousehid.h"\r
-\r
-//\r
-// Prototypes\r
-// Driver model protocol interface\r
-//\r
-EFI_STATUS\r
-EFIAPI\r
-USBMouseAbsolutePointerDriverBindingEntryPoint (\r
- IN EFI_HANDLE ImageHandle,\r
- IN EFI_SYSTEM_TABLE *SystemTable\r
- );\r
-\r
-EFI_STATUS\r
-EFIAPI\r
-USBMouseAbsolutePointerDriverBindingSupported (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
- );\r
-\r
-EFI_STATUS\r
-EFIAPI\r
-USBMouseAbsolutePointerDriverBindingStart (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
- );\r
-\r
-EFI_STATUS\r
-EFIAPI\r
-USBMouseAbsolutePointerDriverBindingStop (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN UINTN NumberOfChildren,\r
- IN EFI_HANDLE *ChildHandleBuffer\r
- );\r
-\r
-EFI_GUID gEfiUsbMouseAbsolutePointerDriverGuid = {\r
- 0xa579f729, 0xa71d, 0x4b45, { 0xbe, 0xd7, 0xd, 0xb0, 0xa8, 0x7c, 0x3e, 0x8d }\r
-};\r
-\r
-EFI_DRIVER_BINDING_PROTOCOL gUsbMouseAbsolutePointerDriverBinding = {\r
+EFI_DRIVER_BINDING_PROTOCOL gUsbMouseAbsolutePointerDriverBinding = {\r
USBMouseAbsolutePointerDriverBindingSupported,\r
USBMouseAbsolutePointerDriverBindingStart,\r
USBMouseAbsolutePointerDriverBindingStop,\r
NULL\r
};\r
\r
-//\r
-// helper functions\r
-//\r
-STATIC\r
-BOOLEAN\r
-IsUsbMouseAbsolutePointer (\r
- IN EFI_USB_IO_PROTOCOL *UsbIo\r
- );\r
+/**\r
+ Entrypoint of USB Mouse Absolute Pointer Driver.\r
\r
-STATIC\r
-EFI_STATUS\r
-InitializeUsbMouseAbsolutePointerDevice (\r
- IN USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev\r
- );\r
+ This function is the entrypoint of USB Mouse Driver. It installs Driver Binding\r
+ Protocols together with Component Name Protocols.\r
\r
-STATIC\r
-VOID\r
-EFIAPI\r
-UsbMouseAbsolutePointerWaitForInput (\r
- IN EFI_EVENT Event,\r
- IN VOID *Context\r
- );\r
-\r
-//\r
-// Mouse interrupt handler\r
-//\r
-STATIC\r
-EFI_STATUS\r
-EFIAPI\r
-OnMouseAbsolutePointerInterruptComplete (\r
- IN VOID *Data,\r
- IN UINTN DataLength,\r
- IN VOID *Context,\r
- IN UINT32 Result\r
- );\r
-\r
-//\r
-// Mouse simulate TouchPad, Using AbsolutePointer Protocol\r
-//\r
-STATIC\r
-EFI_STATUS\r
-EFIAPI\r
-GetMouseAbsolutePointerState (\r
- IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,\r
- OUT EFI_ABSOLUTE_POINTER_STATE *MouseAbsolutePointerState\r
- );\r
+ @param ImageHandle The firmware allocated handle for the EFI image.\r
+ @param SystemTable A pointer to the EFI System Table.\r
\r
-STATIC\r
-EFI_STATUS\r
-EFIAPI\r
-UsbMouseAbsolutePointerReset (\r
- IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,\r
- IN BOOLEAN ExtendedVerification\r
- );\r
+ @retval EFI_SUCCESS The entry point is executed successfully.\r
\r
-//\r
-// Driver start here\r
-//\r
+**/\r
EFI_STATUS\r
EFIAPI\r
USBMouseAbsolutePointerDriverBindingEntryPoint (\r
- IN EFI_HANDLE ImageHandle,\r
- IN EFI_SYSTEM_TABLE *SystemTable\r
+ IN EFI_HANDLE ImageHandle,\r
+ IN EFI_SYSTEM_TABLE *SystemTable\r
)\r
-/*++\r
-\r
- Routine Description:\r
- Entry point for EFI drivers.\r
-\r
- Arguments:\r
- ImageHandle - EFI_HANDLE\r
- SystemTable - EFI_SYSTEM_TABLE\r
- Returns:\r
- EFI_SUCCESS\r
- others\r
-\r
---*/\r
{\r
- return EfiLibInstallDriverBindingComponentName2 (\r
- ImageHandle,\r
- SystemTable,\r
- &gUsbMouseAbsolutePointerDriverBinding,\r
- ImageHandle,\r
- &gUsbMouseAbsolutePointerComponentName,\r
- &gUsbMouseAbsolutePointerComponentName2\r
- );\r
-}\r
+ EFI_STATUS Status;\r
+\r
+ Status = EfiLibInstallDriverBindingComponentName2 (\r
+ ImageHandle,\r
+ SystemTable,\r
+ &gUsbMouseAbsolutePointerDriverBinding,\r
+ ImageHandle,\r
+ &gUsbMouseAbsolutePointerComponentName,\r
+ &gUsbMouseAbsolutePointerComponentName2\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
\r
+ return EFI_SUCCESS;\r
+}\r
\r
/**\r
- Test to see if this driver supports ControllerHandle. Any ControllerHandle\r
- that has UsbHcProtocol installed will be supported.\r
+ Check whether USB Mouse Absolute Pointer Driver supports this device.\r
\r
- @param This Protocol instance pointer.\r
- @param Controller Handle of device to test\r
- @param RemainingDevicePath Not used\r
+ @param This The driver binding protocol.\r
+ @param Controller The controller handle to check.\r
+ @param RemainingDevicePath The remaining device path.\r
\r
- @retval EFI_SUCCESS This driver supports this device.\r
- @retval EFI_UNSUPPORTED This driver does not support this device.\r
+ @retval EFI_SUCCESS The driver supports this controller.\r
+ @retval other This device isn't supported.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
USBMouseAbsolutePointerDriverBindingSupported (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
)\r
{\r
- EFI_STATUS OpenStatus;\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
- EFI_STATUS Status;\r
-\r
- OpenStatus = gBS->OpenProtocol (\r
- Controller,\r
- &gEfiUsbIoProtocolGuid,\r
- (VOID **) &UsbIo,\r
- This->DriverBindingHandle,\r
- Controller,\r
- EFI_OPEN_PROTOCOL_BY_DRIVER\r
- );\r
- if (EFI_ERROR (OpenStatus) && (OpenStatus != EFI_ALREADY_STARTED)) {\r
- return EFI_UNSUPPORTED;\r
- }\r
+ EFI_STATUS Status;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
\r
- if (OpenStatus == EFI_ALREADY_STARTED) {\r
- return EFI_ALREADY_STARTED;\r
+ Status = gBS->OpenProtocol (\r
+ Controller,\r
+ &gEfiUsbIoProtocolGuid,\r
+ (VOID **)&UsbIo,\r
+ This->DriverBindingHandle,\r
+ Controller,\r
+ EFI_OPEN_PROTOCOL_BY_DRIVER\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
}\r
- \r
+\r
//\r
- // Use the USB I/O protocol interface to see the Controller is\r
- // the Mouse controller that can be managed by this driver.\r
+ // Use the USB I/O Protocol interface to check whether Controller is\r
+ // a mouse device that can be managed by this driver.\r
//\r
Status = EFI_SUCCESS;\r
- if (!IsUsbMouseAbsolutePointer (UsbIo)) {\r
+ if (!IsUsbMouse (UsbIo)) {\r
Status = EFI_UNSUPPORTED;\r
}\r
- \r
+\r
gBS->CloseProtocol (\r
- Controller,\r
- &gEfiUsbIoProtocolGuid,\r
- This->DriverBindingHandle,\r
- Controller\r
- );\r
- \r
+ Controller,\r
+ &gEfiUsbIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+\r
return Status;\r
}\r
\r
-\r
/**\r
- Starting the Usb Bus Driver\r
+ Starts the mouse device with this driver.\r
+\r
+ This function consumes USB I/O Protocol, initializes USB mouse device,\r
+ installs Absolute Pointer Protocol, and submits Asynchronous Interrupt\r
+ Transfer to manage the USB mouse device.\r
\r
- @param This Protocol instance pointer.\r
- @param Controller Handle of device to test\r
- @param RemainingDevicePath Not used\r
+ @param This The driver binding instance.\r
+ @param Controller Handle of device to bind driver to.\r
+ @param RemainingDevicePath Optional parameter use to pick a specific child\r
+ device to start.\r
\r
@retval EFI_SUCCESS This driver supports this device.\r
@retval EFI_UNSUPPORTED This driver does not support this device.\r
- @retval EFI_DEVICE_ERROR This driver cannot be started due to device Error\r
- EFI_OUT_OF_RESOURCES- Can't allocate memory\r
- resources\r
- @retval EFI_ALREADY_STARTED Thios driver has been started\r
+ @retval EFI_DEVICE_ERROR This driver cannot be started due to device Error.\r
+ @retval EFI_OUT_OF_RESOURCES Can't allocate memory resources.\r
+ @retval EFI_ALREADY_STARTED This driver has been started.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
USBMouseAbsolutePointerDriverBindingStart (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
)\r
{\r
- EFI_STATUS Status;\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
- EFI_USB_ENDPOINT_DESCRIPTOR *EndpointDesc;\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
- UINT8 EndpointNumber;\r
- UINT8 Index;\r
- UINT8 EndpointAddr;\r
- UINT8 PollingInterval;\r
- UINT8 PacketSize;\r
-\r
- UsbMouseAbsolutePointerDevice = NULL;\r
- Status = EFI_SUCCESS;\r
-\r
+ EFI_STATUS Status;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
+ UINT8 EndpointNumber;\r
+ EFI_USB_ENDPOINT_DESCRIPTOR EndpointDescriptor;\r
+ UINT8 Index;\r
+ UINT8 EndpointAddr;\r
+ UINT8 PollingInterval;\r
+ UINT8 PacketSize;\r
+ BOOLEAN Found;\r
+ EFI_TPL OldTpl;\r
+\r
+ OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
+ //\r
+ // Open USB I/O Protocol\r
+ //\r
Status = gBS->OpenProtocol (\r
Controller,\r
&gEfiUsbIoProtocolGuid,\r
- (VOID **) &UsbIo,\r
+ (VOID **)&UsbIo,\r
This->DriverBindingHandle,\r
Controller,\r
- EFI_OPEN_PROTOCOL_BY_DRIVER \r
+ EFI_OPEN_PROTOCOL_BY_DRIVER\r
);\r
if (EFI_ERROR (Status)) {\r
- goto ErrorExit;\r
- }\r
- \r
- UsbMouseAbsolutePointerDevice = AllocateZeroPool (sizeof (USB_MOUSE_ABSOLUTE_POINTER_DEV));\r
- if (UsbMouseAbsolutePointerDevice == NULL) {\r
- Status = EFI_OUT_OF_RESOURCES;\r
- goto ErrorExit;\r
+ goto ErrorExit1;\r
}\r
\r
- UsbMouseAbsolutePointerDevice->UsbIo = UsbIo;\r
-\r
- UsbMouseAbsolutePointerDevice->Signature = USB_MOUSE_ABSOLUTE_POINTER_DEV_SIGNATURE;\r
-\r
- UsbMouseAbsolutePointerDevice->InterfaceDescriptor = AllocatePool (sizeof (EFI_USB_INTERFACE_DESCRIPTOR));\r
+ UsbMouseAbsolutePointerDevice = AllocateZeroPool (sizeof (USB_MOUSE_ABSOLUTE_POINTER_DEV));\r
+ ASSERT (UsbMouseAbsolutePointerDevice != NULL);\r
\r
- if (UsbMouseAbsolutePointerDevice->InterfaceDescriptor == NULL) {\r
- Status = EFI_OUT_OF_RESOURCES;\r
- goto ErrorExit;\r
- }\r
+ UsbMouseAbsolutePointerDevice->UsbIo = UsbIo;\r
+ UsbMouseAbsolutePointerDevice->Signature = USB_MOUSE_ABSOLUTE_POINTER_DEV_SIGNATURE;\r
\r
- EndpointDesc = AllocatePool (sizeof (EFI_USB_ENDPOINT_DESCRIPTOR));\r
- if (EndpointDesc == NULL) {\r
- Status = EFI_OUT_OF_RESOURCES;\r
- goto ErrorExit;\r
- }\r
//\r
// Get the Device Path Protocol on Controller's handle\r
//\r
Status = gBS->OpenProtocol (\r
Controller,\r
&gEfiDevicePathProtocolGuid,\r
- (VOID **) &UsbMouseAbsolutePointerDevice->DevicePath,\r
+ (VOID **)&UsbMouseAbsolutePointerDevice->DevicePath,\r
This->DriverBindingHandle,\r
Controller,\r
EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
if (EFI_ERROR (Status)) {\r
goto ErrorExit;\r
}\r
+\r
+ //\r
+ // Report Status Code here since USB mouse will be detected next.\r
+ //\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
+ EFI_PROGRESS_CODE,\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_PC_PRESENCE_DETECT),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
+ );\r
+\r
//\r
// Get interface & endpoint descriptor\r
//\r
UsbIo->UsbGetInterfaceDescriptor (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDevice->InterfaceDescriptor\r
- );\r
+ UsbIo,\r
+ &UsbMouseAbsolutePointerDevice->InterfaceDescriptor\r
+ );\r
\r
- EndpointNumber = UsbMouseAbsolutePointerDevice->InterfaceDescriptor->NumEndpoints;\r
+ EndpointNumber = UsbMouseAbsolutePointerDevice->InterfaceDescriptor.NumEndpoints;\r
\r
+ //\r
+ // Traverse endpoints to find interrupt endpoint IN\r
+ //\r
+ Found = FALSE;\r
for (Index = 0; Index < EndpointNumber; Index++) {\r
UsbIo->UsbGetEndpointDescriptor (\r
- UsbIo,\r
- Index,\r
- EndpointDesc\r
- );\r
-\r
- if ((EndpointDesc->Attributes & 0x03) == 0x03) {\r
-\r
+ UsbIo,\r
+ Index,\r
+ &EndpointDescriptor\r
+ );\r
+\r
+ if (((EndpointDescriptor.Attributes & (BIT0 | BIT1)) == USB_ENDPOINT_INTERRUPT) &&\r
+ ((EndpointDescriptor.EndpointAddress & USB_ENDPOINT_DIR_IN) != 0))\r
+ {\r
//\r
// We only care interrupt endpoint here\r
//\r
- UsbMouseAbsolutePointerDevice->IntEndpointDescriptor = EndpointDesc;\r
+ CopyMem (&UsbMouseAbsolutePointerDevice->IntEndpointDescriptor, &EndpointDescriptor, sizeof (EndpointDescriptor));\r
+ Found = TRUE;\r
+ break;\r
}\r
}\r
\r
- if (UsbMouseAbsolutePointerDevice->IntEndpointDescriptor == NULL) {\r
+ if (!Found) {\r
+ //\r
+ // Report Status Code to indicate that there is no USB mouse\r
//\r
- // No interrupt endpoint, then error\r
+ REPORT_STATUS_CODE (\r
+ EFI_ERROR_CODE | EFI_ERROR_MINOR,\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_EC_NOT_DETECTED)\r
+ );\r
+ //\r
+ // No interrupt endpoint found, then return unsupported.\r
//\r
Status = EFI_UNSUPPORTED;\r
goto ErrorExit;\r
}\r
\r
- Status = InitializeUsbMouseAbsolutePointerDevice (UsbMouseAbsolutePointerDevice);\r
+ //\r
+ // Report Status Code here since USB mouse has be detected.\r
+ //\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
+ EFI_PROGRESS_CODE,\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_PC_DETECTED),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
+ );\r
+\r
+ Status = InitializeUsbMouseDevice (UsbMouseAbsolutePointerDevice);\r
if (EFI_ERROR (Status)) {\r
- MouseAbsolutePointerReportStatusCode (\r
- UsbMouseAbsolutePointerDevice->DevicePath,\r
+ //\r
+ // Fail to initialize USB mouse device.\r
+ //\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
EFI_ERROR_CODE | EFI_ERROR_MINOR,\r
- PcdGet32 (PcdStatusCodeValueMouseInterfaceError)\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_EC_INTERFACE_ERROR),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
);\r
\r
goto ErrorExit;\r
}\r
\r
+ //\r
+ // Initialize and install EFI Absolute Pointer Protocol.\r
+ //\r
UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.GetState = GetMouseAbsolutePointerState;\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.Reset = UsbMouseAbsolutePointerReset;\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.Mode = &UsbMouseAbsolutePointerDevice->AbsolutePointerMode;\r
+ UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.Reset = UsbMouseAbsolutePointerReset;\r
+ UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.Mode = &UsbMouseAbsolutePointerDevice->Mode;\r
\r
Status = gBS->CreateEvent (\r
- EVT_NOTIFY_WAIT,\r
- TPL_NOTIFY,\r
- UsbMouseAbsolutePointerWaitForInput,\r
- UsbMouseAbsolutePointerDevice,\r
- &((UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol).WaitForInput)\r
- );\r
+ EVT_NOTIFY_WAIT,\r
+ TPL_NOTIFY,\r
+ UsbMouseAbsolutePointerWaitForInput,\r
+ UsbMouseAbsolutePointerDevice,\r
+ &((UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol).WaitForInput)\r
+ );\r
if (EFI_ERROR (Status)) {\r
goto ErrorExit;\r
}\r
\r
Status = gBS->InstallProtocolInterface (\r
- &Controller,\r
- &gEfiAbsolutePointerProtocolGuid,\r
- EFI_NATIVE_INTERFACE,\r
- &UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol\r
- );\r
+ &Controller,\r
+ &gEfiAbsolutePointerProtocolGuid,\r
+ EFI_NATIVE_INTERFACE,\r
+ &UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol\r
+ );\r
\r
if (EFI_ERROR (Status)) {\r
- Status = EFI_DEVICE_ERROR;\r
goto ErrorExit;\r
}\r
\r
//\r
- // After Enabling Async Interrupt Transfer on this mouse Device\r
- // we will be able to get key data from it. Thus this is deemed as\r
- // the enable action of the mouse\r
+ // The next step would be submitting Asynchronous Interrupt Transfer on this mouse device.\r
+ // After that we will be able to get key data from it. Thus this is deemed as\r
+ // the enable action of the mouse, so report status code accordingly.\r
//\r
-\r
- MouseAbsolutePointerReportStatusCode (\r
- UsbMouseAbsolutePointerDevice->DevicePath,\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
EFI_PROGRESS_CODE,\r
- PcdGet32 (PcdStatusCodeValueMouseEnable)\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_PC_ENABLE),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
);\r
\r
//\r
- // submit async interrupt transfer\r
+ // Submit Asynchronous Interrupt Transfer to manage this device.\r
//\r
- EndpointAddr = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->EndpointAddress;\r
- PollingInterval = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->Interval;\r
- PacketSize = (UINT8) (UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->MaxPacketSize);\r
+ EndpointAddr = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.EndpointAddress;\r
+ PollingInterval = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.Interval;\r
+ PacketSize = (UINT8)(UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.MaxPacketSize);\r
\r
Status = UsbIo->UsbAsyncInterruptTransfer (\r
UsbIo,\r
TRUE,\r
PollingInterval,\r
PacketSize,\r
- OnMouseAbsolutePointerInterruptComplete,\r
+ OnMouseInterruptComplete,\r
UsbMouseAbsolutePointerDevice\r
);\r
\r
- if (!EFI_ERROR (Status)) {\r
+ if (EFI_ERROR (Status)) {\r
+ //\r
+ // If submit error, uninstall that interface\r
+ //\r
+ gBS->UninstallProtocolInterface (\r
+ Controller,\r
+ &gEfiAbsolutePointerProtocolGuid,\r
+ &UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol\r
+ );\r
+ goto ErrorExit;\r
+ }\r
\r
- UsbMouseAbsolutePointerDevice->ControllerNameTable = NULL;\r
- AddUnicodeString2 (\r
- "eng",\r
- gUsbMouseAbsolutePointerComponentName.SupportedLanguages,\r
- &UsbMouseAbsolutePointerDevice->ControllerNameTable,\r
- L"Generic Usb Mouse Simulate TouchPad",\r
- TRUE\r
- );\r
- AddUnicodeString2 (\r
- "en",\r
- gUsbMouseAbsolutePointerComponentName2.SupportedLanguages,\r
- &UsbMouseAbsolutePointerDevice->ControllerNameTable,\r
- L"Generic Usb Mouse Simulate TouchPad2",\r
- FALSE\r
- );\r
+ UsbMouseAbsolutePointerDevice->ControllerNameTable = NULL;\r
+ AddUnicodeString2 (\r
+ "eng",\r
+ gUsbMouseAbsolutePointerComponentName.SupportedLanguages,\r
+ &UsbMouseAbsolutePointerDevice->ControllerNameTable,\r
+ L"Generic Usb Mouse Absolute Pointer",\r
+ TRUE\r
+ );\r
+ AddUnicodeString2 (\r
+ "en",\r
+ gUsbMouseAbsolutePointerComponentName2.SupportedLanguages,\r
+ &UsbMouseAbsolutePointerDevice->ControllerNameTable,\r
+ L"Generic Usb Mouse Absolute Pointer",\r
+ FALSE\r
+ );\r
\r
- return EFI_SUCCESS;\r
- }\r
+ gBS->RestoreTPL (OldTpl);\r
+ return EFI_SUCCESS;\r
\r
//\r
- // If submit error, uninstall that interface\r
+ // Error handler\r
//\r
- Status = EFI_DEVICE_ERROR;\r
-\r
- gBS->UninstallProtocolInterface (\r
- Controller,\r
- &gEfiAbsolutePointerProtocolGuid,\r
- &UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol\r
- );\r
-\r
ErrorExit:\r
if (EFI_ERROR (Status)) {\r
gBS->CloseProtocol (\r
- Controller,\r
- &gEfiUsbIoProtocolGuid,\r
- This->DriverBindingHandle,\r
- Controller\r
- );\r
+ Controller,\r
+ &gEfiUsbIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
\r
if (UsbMouseAbsolutePointerDevice != NULL) {\r
- if (UsbMouseAbsolutePointerDevice->InterfaceDescriptor != NULL) {\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice->InterfaceDescriptor);\r
- }\r
-\r
- if (UsbMouseAbsolutePointerDevice->IntEndpointDescriptor != NULL) {\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice->IntEndpointDescriptor);\r
- }\r
- \r
if ((UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol).WaitForInput != NULL) {\r
gBS->CloseEvent ((UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol).WaitForInput);\r
}\r
\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice);\r
+ FreePool (UsbMouseAbsolutePointerDevice);\r
UsbMouseAbsolutePointerDevice = NULL;\r
}\r
}\r
\r
+ErrorExit1:\r
+ gBS->RestoreTPL (OldTpl);\r
+\r
return Status;\r
}\r
\r
-\r
/**\r
- Stop this driver on ControllerHandle. Support stoping any child handles\r
- created by this driver.\r
+ Stop the USB mouse device handled by this driver.\r
\r
- @param This Protocol instance pointer.\r
- @param Controller Handle of device to stop driver on\r
- @param NumberOfChildren Number of Children in the ChildHandleBuffer\r
- @param ChildHandleBuffer List of handles for the children we need to stop.\r
+ @param This The driver binding protocol.\r
+ @param Controller The controller to release.\r
+ @param NumberOfChildren The number of handles in ChildHandleBuffer.\r
+ @param ChildHandleBuffer The array of child handle.\r
\r
- @return EFI_SUCCESS\r
- @return EFI_DEVICE_ERROR\r
- @return others\r
+ @retval EFI_SUCCESS The device was stopped.\r
+ @retval EFI_UNSUPPORTED Absolute Pointer Protocol is not installed on Controller.\r
+ @retval Others Fail to uninstall protocols attached on the device.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
USBMouseAbsolutePointerDriverBindingStop (\r
- IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
- IN EFI_HANDLE Controller,\r
- IN UINTN NumberOfChildren,\r
- IN EFI_HANDLE *ChildHandleBuffer\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN UINTN NumberOfChildren,\r
+ IN EFI_HANDLE *ChildHandleBuffer\r
)\r
{\r
- EFI_STATUS Status;\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
- EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointerProtocol;\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
+ EFI_STATUS Status;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
+ EFI_ABSOLUTE_POINTER_PROTOCOL *AbsolutePointerProtocol;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
\r
- //\r
- // Get our context back.\r
- //\r
Status = gBS->OpenProtocol (\r
- Controller,\r
- &gEfiAbsolutePointerProtocolGuid,\r
- (VOID **) &AbsolutePointerProtocol,\r
- This->DriverBindingHandle,\r
- Controller,\r
- EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
- );\r
+ Controller,\r
+ &gEfiAbsolutePointerProtocolGuid,\r
+ (VOID **)&AbsolutePointerProtocol,\r
+ This->DriverBindingHandle,\r
+ Controller,\r
+ EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
+ );\r
\r
if (EFI_ERROR (Status)) {\r
- return EFI_UNSUPPORTED;\r
+ return EFI_UNSUPPORTED;\r
}\r
- UsbMouseAbsolutePointerDevice = USB_MOUSE_ABSOLUTE_POINTER_DEV_FROM_MOUSE_PROTOCOL (AbsolutePointerProtocol);\r
\r
- gBS->CloseProtocol (\r
- Controller,\r
- &gEfiAbsolutePointerProtocolGuid,\r
- This->DriverBindingHandle,\r
- Controller\r
- );\r
+ UsbMouseAbsolutePointerDevice = USB_MOUSE_ABSOLUTE_POINTER_DEV_FROM_MOUSE_PROTOCOL (AbsolutePointerProtocol);\r
\r
UsbIo = UsbMouseAbsolutePointerDevice->UsbIo;\r
\r
//\r
- // Uninstall the Asyn Interrupt Transfer from this device\r
- // will disable the mouse data input from this device\r
+ // The key data input from this device will be disabled.\r
//\r
- MouseAbsolutePointerReportStatusCode (\r
- UsbMouseAbsolutePointerDevice->DevicePath,\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
EFI_PROGRESS_CODE,\r
- PcdGet32 (PcdStatusCodeValueMouseDisable)\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_PC_DISABLE),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
);\r
\r
//\r
- // Delete Mouse Async Interrupt Transfer\r
+ // Delete the Asynchronous Interrupt Transfer from this device\r
//\r
UsbIo->UsbAsyncInterruptTransfer (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->EndpointAddress,\r
- FALSE,\r
- UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->Interval,\r
- 0,\r
- NULL,\r
- NULL\r
- );\r
-\r
- gBS->CloseEvent (UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.WaitForInput);\r
- \r
- if (UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent) {\r
- gBS->CloseEvent (UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent);\r
- UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent = 0;\r
- }\r
+ UsbIo,\r
+ UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.EndpointAddress,\r
+ FALSE,\r
+ UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.Interval,\r
+ 0,\r
+ NULL,\r
+ NULL\r
+ );\r
\r
Status = gBS->UninstallProtocolInterface (\r
Controller,\r
}\r
\r
gBS->CloseProtocol (\r
- Controller,\r
- &gEfiUsbIoProtocolGuid,\r
- This->DriverBindingHandle,\r
- Controller\r
- );\r
+ Controller,\r
+ &gEfiUsbIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+\r
+ //\r
+ // Free all resources.\r
+ //\r
+ gBS->CloseEvent (UsbMouseAbsolutePointerDevice->AbsolutePointerProtocol.WaitForInput);\r
\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice->InterfaceDescriptor);\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice->IntEndpointDescriptor);\r
+ if (UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent != NULL) {\r
+ gBS->CloseEvent (UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent);\r
+ UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent = NULL;\r
+ }\r
\r
- if (UsbMouseAbsolutePointerDevice->ControllerNameTable) {\r
+ if (UsbMouseAbsolutePointerDevice->ControllerNameTable != NULL) {\r
FreeUnicodeStringTable (UsbMouseAbsolutePointerDevice->ControllerNameTable);\r
}\r
\r
- gBS->FreePool (UsbMouseAbsolutePointerDevice);\r
+ FreePool (UsbMouseAbsolutePointerDevice);\r
\r
return EFI_SUCCESS;\r
-\r
}\r
\r
-\r
/**\r
- Tell if a Usb Controller is a mouse\r
+ Uses USB I/O to check whether the device is a USB mouse device.\r
\r
- @param UsbIo Protocol instance pointer.\r
+ @param UsbIo Pointer to a USB I/O protocol instance.\r
\r
- @retval TRUE It is a mouse\r
- @retval FALSE It is not a mouse\r
+ @retval TRUE Device is a USB mouse device.\r
+ @retval FALSE Device is a not USB mouse device.\r
\r
**/\r
BOOLEAN\r
-IsUsbMouseAbsolutePointer (\r
- IN EFI_USB_IO_PROTOCOL *UsbIo\r
+IsUsbMouse (\r
+ IN EFI_USB_IO_PROTOCOL *UsbIo\r
)\r
{\r
EFI_STATUS Status;\r
EFI_USB_INTERFACE_DESCRIPTOR InterfaceDescriptor;\r
\r
//\r
- // Get the Default interface descriptor, now we only\r
- // suppose it is interface 1\r
+ // Get the default interface descriptor\r
//\r
Status = UsbIo->UsbGetInterfaceDescriptor (\r
UsbIo,\r
if ((InterfaceDescriptor.InterfaceClass == CLASS_HID) &&\r
(InterfaceDescriptor.InterfaceSubClass == SUBCLASS_BOOT) &&\r
(InterfaceDescriptor.InterfaceProtocol == PROTOCOL_MOUSE)\r
- ) {\r
- \r
+ )\r
+ {\r
return TRUE;\r
}\r
\r
return FALSE;\r
}\r
\r
-\r
/**\r
- Initialize the Usb Mouse Simulate TouchPad Device.\r
+ Initialize the USB mouse device.\r
+\r
+ This function retrieves and parses HID report descriptor, and\r
+ initializes state of USB_MOUSE_ABSOLUTE_POINTER_DEV. Then it sets indefinite idle\r
+ rate for the device. Finally it creates event for delayed recovery,\r
+ which deals with device error.\r
\r
- @param UsbMouseAbsolutePointerDev Device instance to be initialized\r
+ @param UsbMouseAbsolutePointerDev Device instance to be initialized.\r
\r
- @retval EFI_SUCCESS Success\r
- @retval EFI_DEVICE_ERROR Init error. EFI_OUT_OF_RESOURCES- Can't allocate\r
- memory\r
+ @retval EFI_SUCCESS USB mouse device successfully initialized.\r
+ @retval EFI_UNSUPPORTED HID descriptor type is not report descriptor.\r
+ @retval Other USB mouse device was not initialized successfully.\r
\r
**/\r
-STATIC\r
EFI_STATUS\r
-InitializeUsbMouseAbsolutePointerDevice (\r
- IN USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev\r
+InitializeUsbMouseDevice (\r
+ IN USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev\r
)\r
{\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
- UINT8 Protocol;\r
- EFI_STATUS Status;\r
- EFI_USB_HID_DESCRIPTOR MouseHidDesc;\r
- UINT8 *ReportDesc;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
+ UINT8 Protocol;\r
+ EFI_STATUS Status;\r
+ EFI_USB_HID_DESCRIPTOR *MouseHidDesc;\r
+ UINT8 *ReportDesc;\r
+ EFI_USB_CONFIG_DESCRIPTOR ConfigDesc;\r
+ VOID *Buf;\r
+ UINT32 TransferResult;\r
+ UINT16 Total;\r
+ USB_DESC_HEAD *Head;\r
+ BOOLEAN Start;\r
\r
UsbIo = UsbMouseAbsolutePointerDev->UsbIo;\r
\r
//\r
- // Get HID descriptor\r
+ // Get the current configuration descriptor. Note that it doesn't include other descriptors.\r
+ //\r
+ Status = UsbIo->UsbGetConfigDescriptor (\r
+ UsbIo,\r
+ &ConfigDesc\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+\r
+ //\r
+ // By issuing Get_Descriptor(Configuration) request with total length, we get the Configuration descriptor,\r
+ // all Interface descriptors, all Endpoint descriptors, and the HID descriptor for each interface.\r
//\r
- Status = UsbGetHidDescriptor (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDev->InterfaceDescriptor->InterfaceNumber,\r
- &MouseHidDesc\r
- );\r
+ Buf = AllocateZeroPool (ConfigDesc.TotalLength);\r
+ if (Buf == NULL) {\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
\r
+ Status = UsbGetDescriptor (\r
+ UsbIo,\r
+ (UINT16)((USB_DESC_TYPE_CONFIG << 8) | (ConfigDesc.ConfigurationValue - 1)),\r
+ 0,\r
+ ConfigDesc.TotalLength,\r
+ Buf,\r
+ &TransferResult\r
+ );\r
if (EFI_ERROR (Status)) {\r
+ FreePool (Buf);\r
return Status;\r
}\r
\r
+ Total = 0;\r
+ Start = FALSE;\r
+ Head = (USB_DESC_HEAD *)Buf;\r
+ MouseHidDesc = NULL;\r
+\r
//\r
- // Get Report descriptor\r
+ // Get HID descriptor from the receipt of Get_Descriptor(Configuration) request.\r
+ // This algorithm is based on the fact that the HID descriptor shall be interleaved\r
+ // between the interface and endpoint descriptors for HID interfaces.\r
//\r
- if (MouseHidDesc.HidClassDesc[0].DescriptorType != 0x22) {\r
+ while (Total < ConfigDesc.TotalLength) {\r
+ if (Head->Type == USB_DESC_TYPE_INTERFACE) {\r
+ if ((((USB_INTERFACE_DESCRIPTOR *)Head)->InterfaceNumber == UsbMouseAbsolutePointerDev->InterfaceDescriptor.InterfaceNumber) &&\r
+ (((USB_INTERFACE_DESCRIPTOR *)Head)->AlternateSetting == UsbMouseAbsolutePointerDev->InterfaceDescriptor.AlternateSetting))\r
+ {\r
+ Start = TRUE;\r
+ }\r
+ }\r
+\r
+ if (Start && (Head->Type == USB_DESC_TYPE_ENDPOINT)) {\r
+ break;\r
+ }\r
+\r
+ if (Start && (Head->Type == USB_DESC_TYPE_HID)) {\r
+ MouseHidDesc = (EFI_USB_HID_DESCRIPTOR *)Head;\r
+ break;\r
+ }\r
+\r
+ Total = Total + (UINT16)Head->Len;\r
+ Head = (USB_DESC_HEAD *)((UINT8 *)Buf + Total);\r
+ }\r
+\r
+ if (MouseHidDesc == NULL) {\r
+ FreePool (Buf);\r
return EFI_UNSUPPORTED;\r
}\r
\r
- ReportDesc = AllocateZeroPool (MouseHidDesc.HidClassDesc[0].DescriptorLength);\r
- if (ReportDesc == NULL) {\r
- return EFI_OUT_OF_RESOURCES;\r
+ //\r
+ // Get report descriptor\r
+ //\r
+ if (MouseHidDesc->HidClassDesc[0].DescriptorType != USB_DESC_TYPE_REPORT) {\r
+ FreePool (Buf);\r
+ return EFI_UNSUPPORTED;\r
}\r
\r
+ ReportDesc = AllocateZeroPool (MouseHidDesc->HidClassDesc[0].DescriptorLength);\r
+ ASSERT (ReportDesc != NULL);\r
+\r
Status = UsbGetReportDescriptor (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDev->InterfaceDescriptor->InterfaceNumber,\r
- MouseHidDesc.HidClassDesc[0].DescriptorLength,\r
- ReportDesc\r
- );\r
+ UsbIo,\r
+ UsbMouseAbsolutePointerDev->InterfaceDescriptor.InterfaceNumber,\r
+ MouseHidDesc->HidClassDesc[0].DescriptorLength,\r
+ ReportDesc\r
+ );\r
\r
if (EFI_ERROR (Status)) {\r
- gBS->FreePool (ReportDesc);\r
+ FreePool (Buf);\r
+ FreePool (ReportDesc);\r
return Status;\r
}\r
\r
// Parse report descriptor\r
//\r
Status = ParseMouseReportDescriptor (\r
- UsbMouseAbsolutePointerDev,\r
- ReportDesc,\r
- MouseHidDesc.HidClassDesc[0].DescriptorLength\r
- );\r
+ UsbMouseAbsolutePointerDev,\r
+ ReportDesc,\r
+ MouseHidDesc->HidClassDesc[0].DescriptorLength\r
+ );\r
\r
if (EFI_ERROR (Status)) {\r
- gBS->FreePool (ReportDesc);\r
+ FreePool (Buf);\r
+ FreePool (ReportDesc);\r
return Status;\r
}\r
\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMaxX = 1024;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMaxY = 1024;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMaxZ = 0;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMinX = 0;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMinY = 0;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.AbsoluteMinZ = 0;\r
- UsbMouseAbsolutePointerDev->AbsolutePointerMode.Attributes = 0x3;\r
- \r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMaxX = 1024;\r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMaxY = 1024;\r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMaxZ = 0;\r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMinX = 0;\r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMinY = 0;\r
+ UsbMouseAbsolutePointerDev->Mode.AbsoluteMinZ = 0;\r
+ UsbMouseAbsolutePointerDev->Mode.Attributes = 0x3;\r
+\r
//\r
- // Here we just assume interface 0 is the mouse interface\r
+ // Let the cursor's starting position is in the center of the screen.\r
+ //\r
+ UsbMouseAbsolutePointerDev->State.CurrentX =\r
+ DivU64x32 (UsbMouseAbsolutePointerDev->Mode.AbsoluteMaxX + UsbMouseAbsolutePointerDev->Mode.AbsoluteMinX, 2);\r
+ UsbMouseAbsolutePointerDev->State.CurrentY =\r
+ DivU64x32 (UsbMouseAbsolutePointerDev->Mode.AbsoluteMaxY + UsbMouseAbsolutePointerDev->Mode.AbsoluteMinY, 2);\r
+\r
+ //\r
+ // Set boot protocol for the USB mouse.\r
+ // This driver only supports boot protocol.\r
//\r
UsbGetProtocolRequest (\r
UsbIo,\r
- 0,\r
+ UsbMouseAbsolutePointerDev->InterfaceDescriptor.InterfaceNumber,\r
&Protocol\r
);\r
-\r
if (Protocol != BOOT_PROTOCOL) {\r
Status = UsbSetProtocolRequest (\r
- UsbIo,\r
- 0,\r
- BOOT_PROTOCOL\r
- );\r
+ UsbIo,\r
+ UsbMouseAbsolutePointerDev->InterfaceDescriptor.InterfaceNumber,\r
+ BOOT_PROTOCOL\r
+ );\r
\r
if (EFI_ERROR (Status)) {\r
- gBS->FreePool (ReportDesc);\r
- return EFI_DEVICE_ERROR;\r
+ FreePool (Buf);\r
+ FreePool (ReportDesc);\r
+ return Status;\r
}\r
}\r
\r
+ FreePool (Buf);\r
+ FreePool (ReportDesc);\r
+\r
//\r
- // Set indefinite Idle rate for USB Mouse\r
+ // Create event for delayed recovery, which deals with device error.\r
//\r
- UsbSetIdleRequest (\r
- UsbIo,\r
- 0,\r
- 0,\r
- 0\r
- );\r
-\r
- gBS->FreePool (ReportDesc);\r
-\r
- if (UsbMouseAbsolutePointerDev->DelayedRecoveryEvent) {\r
+ if (UsbMouseAbsolutePointerDev->DelayedRecoveryEvent != NULL) {\r
gBS->CloseEvent (UsbMouseAbsolutePointerDev->DelayedRecoveryEvent);\r
UsbMouseAbsolutePointerDev->DelayedRecoveryEvent = 0;\r
}\r
\r
- Status = gBS->CreateEvent (\r
- EVT_TIMER | EVT_NOTIFY_SIGNAL,\r
- TPL_NOTIFY,\r
- USBMouseAbsolutePointerRecoveryHandler,\r
- UsbMouseAbsolutePointerDev,\r
- &UsbMouseAbsolutePointerDev->DelayedRecoveryEvent\r
- );\r
+ gBS->CreateEvent (\r
+ EVT_TIMER | EVT_NOTIFY_SIGNAL,\r
+ TPL_NOTIFY,\r
+ USBMouseRecoveryHandler,\r
+ UsbMouseAbsolutePointerDev,\r
+ &UsbMouseAbsolutePointerDev->DelayedRecoveryEvent\r
+ );\r
\r
return EFI_SUCCESS;\r
}\r
\r
-\r
/**\r
- It is called whenever there is data received from async interrupt\r
- transfer.\r
+ Handler function for USB mouse's asynchronous interrupt transfer.\r
\r
- @param Data Data received.\r
- @param DataLength Length of Data\r
- @param Context Passed in context\r
- @param Result Async Interrupt Transfer result\r
+ This function is the handler function for USB mouse's asynchronous interrupt transfer\r
+ to manage the mouse. It parses data returned from asynchronous interrupt transfer, and\r
+ get button and movement state.\r
\r
- @return EFI_SUCCESS\r
- @return EFI_DEVICE_ERROR\r
+ @param Data A pointer to a buffer that is filled with key data which is\r
+ retrieved via asynchronous interrupt transfer.\r
+ @param DataLength Indicates the size of the data buffer.\r
+ @param Context Pointing to USB_KB_DEV instance.\r
+ @param Result Indicates the result of the asynchronous interrupt transfer.\r
+\r
+ @retval EFI_SUCCESS Asynchronous interrupt transfer is handled successfully.\r
+ @retval EFI_DEVICE_ERROR Hardware error occurs.\r
\r
**/\r
-STATIC\r
EFI_STATUS\r
EFIAPI\r
-OnMouseAbsolutePointerInterruptComplete (\r
- IN VOID *Data,\r
- IN UINTN DataLength,\r
- IN VOID *Context,\r
- IN UINT32 Result\r
+OnMouseInterruptComplete (\r
+ IN VOID *Data,\r
+ IN UINTN DataLength,\r
+ IN VOID *Context,\r
+ IN UINT32 Result\r
)\r
{\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
- UINT8 EndpointAddr;\r
- UINT32 UsbResult;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
+ UINT8 EndpointAddr;\r
+ UINT32 UsbResult;\r
\r
- UsbMouseAbsolutePointerDevice = (USB_MOUSE_ABSOLUTE_POINTER_DEV *) Context;\r
- UsbIo = UsbMouseAbsolutePointerDevice->UsbIo;\r
+ UsbMouseAbsolutePointerDevice = (USB_MOUSE_ABSOLUTE_POINTER_DEV *)Context;\r
+ UsbIo = UsbMouseAbsolutePointerDevice->UsbIo;\r
\r
if (Result != EFI_USB_NOERROR) {\r
//\r
// Some errors happen during the process\r
//\r
- MouseAbsolutePointerReportStatusCode (\r
- UsbMouseAbsolutePointerDevice->DevicePath,\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
EFI_ERROR_CODE | EFI_ERROR_MINOR,\r
- PcdGet32 (PcdStatusCodeValueMouseInputError)\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_EC_INPUT_ERROR),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
);\r
\r
if ((Result & EFI_USB_ERR_STALL) == EFI_USB_ERR_STALL) {\r
- EndpointAddr = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->EndpointAddress;\r
+ EndpointAddr = UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.EndpointAddress;\r
\r
UsbClearEndpointHalt (\r
UsbIo,\r
);\r
}\r
\r
+ //\r
+ // Delete & Submit this interrupt again\r
+ // Handler of DelayedRecoveryEvent triggered by timer will re-submit the interrupt.\r
+ //\r
UsbIo->UsbAsyncInterruptTransfer (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDevice->IntEndpointDescriptor->EndpointAddress,\r
- FALSE,\r
- 0,\r
- 0,\r
- NULL,\r
- NULL\r
- );\r
-\r
+ UsbIo,\r
+ UsbMouseAbsolutePointerDevice->IntEndpointDescriptor.EndpointAddress,\r
+ FALSE,\r
+ 0,\r
+ 0,\r
+ NULL,\r
+ NULL\r
+ );\r
+ //\r
+ // EFI_USB_INTERRUPT_DELAY is defined in USB standard for error handling.\r
+ //\r
gBS->SetTimer (\r
- UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent,\r
- TimerRelative,\r
- EFI_USB_INTERRUPT_DELAY\r
- );\r
+ UsbMouseAbsolutePointerDevice->DelayedRecoveryEvent,\r
+ TimerRelative,\r
+ EFI_USB_INTERRUPT_DELAY\r
+ );\r
return EFI_DEVICE_ERROR;\r
}\r
\r
- if (DataLength == 0 || Data == NULL) {\r
+ //\r
+ // If no error and no data, just return EFI_SUCCESS.\r
+ //\r
+ if ((DataLength == 0) || (Data == NULL)) {\r
return EFI_SUCCESS;\r
}\r
\r
//\r
- //Check mouse Data\r
+ // Check mouse Data\r
+ // USB HID Specification specifies following data format:\r
+ // Byte Bits Description\r
+ // 0 0 Button 1\r
+ // 1 Button 2\r
+ // 2 Button 3\r
+ // 4 to 7 Device-specific\r
+ // 1 0 to 7 X displacement\r
+ // 2 0 to 7 Y displacement\r
+ // 3 to n 0 to 7 Device specific (optional)\r
//\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerStateChanged = TRUE;\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerState.CurrentX += *((INT8 *) Data + 1);\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerState.CurrentY += *((INT8 *) Data + 2);\r
+ if (DataLength < 3) {\r
+ return EFI_DEVICE_ERROR;\r
+ }\r
+\r
+ UsbMouseAbsolutePointerDevice->StateChanged = TRUE;\r
+\r
+ UsbMouseAbsolutePointerDevice->State.ActiveButtons = *(UINT8 *)Data & (BIT0 | BIT1 | BIT2);\r
+\r
+ UsbMouseAbsolutePointerDevice->State.CurrentX =\r
+ MIN (\r
+ MAX (\r
+ (INT64)UsbMouseAbsolutePointerDevice->State.CurrentX + *((INT8 *)Data + 1),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMinX\r
+ ),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMaxX\r
+ );\r
+ UsbMouseAbsolutePointerDevice->State.CurrentY =\r
+ MIN (\r
+ MAX (\r
+ (INT64)UsbMouseAbsolutePointerDevice->State.CurrentY + *((INT8 *)Data + 2),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMinY\r
+ ),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMaxY\r
+ );\r
if (DataLength > 3) {\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerState.CurrentZ += *((INT8 *) Data + 3);\r
+ UsbMouseAbsolutePointerDevice->State.CurrentZ =\r
+ MIN (\r
+ MAX (\r
+ (INT64)UsbMouseAbsolutePointerDevice->State.CurrentZ + *((INT8 *)Data + 1),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMinZ\r
+ ),\r
+ (INT64)UsbMouseAbsolutePointerDevice->Mode.AbsoluteMaxZ\r
+ );\r
}\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerState.ActiveButtons = *(UINT8 *)Data & 0x3;\r
\r
return EFI_SUCCESS;\r
}\r
\r
/**\r
- Get the mouse state, see ABSOLUTE POINTER PROTOCOL.\r
+ Retrieves the current state of a pointer device.\r
\r
- @param This Protocol instance pointer.\r
- @param MouseState Current mouse state\r
+ @param This A pointer to the EFI_ABSOLUTE_POINTER_PROTOCOL instance.\r
+ @param MouseState A pointer to the state information on the pointer device.\r
\r
- @return EFI_SUCCESS\r
- @return EFI_DEVICE_ERROR\r
- @return EFI_NOT_READY\r
+ @retval EFI_SUCCESS The state of the pointer device was returned in State.\r
+ @retval EFI_NOT_READY The state of the pointer device has not changed since the last call to\r
+ GetState().\r
+ @retval EFI_DEVICE_ERROR A device error occurred while attempting to retrieve the pointer device's\r
+ current state.\r
+ @retval EFI_INVALID_PARAMETER State is NULL.\r
\r
**/\r
-STATIC\r
EFI_STATUS\r
EFIAPI\r
GetMouseAbsolutePointerState (\r
IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,\r
- OUT EFI_ABSOLUTE_POINTER_STATE *MouseAbsolutePointerState\r
+ OUT EFI_ABSOLUTE_POINTER_STATE *State\r
)\r
{\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *MouseAbsolutePointerDev;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *MouseAbsolutePointerDev;\r
\r
- if (MouseAbsolutePointerState == NULL) {\r
- return EFI_DEVICE_ERROR;\r
+ if (State == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
}\r
\r
MouseAbsolutePointerDev = USB_MOUSE_ABSOLUTE_POINTER_DEV_FROM_MOUSE_PROTOCOL (This);\r
\r
- if (!MouseAbsolutePointerDev->AbsolutePointerStateChanged) {\r
+ if (!MouseAbsolutePointerDev->StateChanged) {\r
return EFI_NOT_READY;\r
}\r
\r
+ //\r
+ // Retrieve mouse state from USB_MOUSE_ABSOLUTE_POINTER_DEV,\r
+ // which was filled by OnMouseInterruptComplete()\r
+ //\r
CopyMem (\r
- MouseAbsolutePointerState,\r
- &MouseAbsolutePointerDev->AbsolutePointerState,\r
+ State,\r
+ &MouseAbsolutePointerDev->State,\r
sizeof (EFI_ABSOLUTE_POINTER_STATE)\r
);\r
\r
- //\r
- // Clear previous move state\r
- //\r
- MouseAbsolutePointerDev->AbsolutePointerState.CurrentX = 0;\r
- MouseAbsolutePointerDev->AbsolutePointerState.CurrentY = 0;\r
- MouseAbsolutePointerDev->AbsolutePointerState.CurrentZ = 0;\r
- MouseAbsolutePointerDev->AbsolutePointerState.ActiveButtons = 0;\r
-\r
- MouseAbsolutePointerDev->AbsolutePointerStateChanged = FALSE;\r
+ MouseAbsolutePointerDev->StateChanged = FALSE;\r
\r
return EFI_SUCCESS;\r
}\r
\r
-\r
/**\r
- Reset the mouse device, see ABSOLUTE POINTER PROTOCOL.\r
+ Resets the pointer device hardware.\r
\r
- @param This Protocol instance pointer.\r
- @param ExtendedVerification Ignored here/\r
+ @param This A pointer to the EFI_ABSOLUTE_POINTER_PROTOCOL instance.\r
+ @param ExtendedVerification Indicates that the driver may perform a more exhaustive\r
+ verification operation of the device during reset.\r
\r
- @return EFI_SUCCESS\r
+ @retval EFI_SUCCESS The device was reset.\r
+ @retval EFI_DEVICE_ERROR The device is not functioning correctly and could not be reset.\r
\r
**/\r
-STATIC\r
EFI_STATUS\r
EFIAPI\r
UsbMouseAbsolutePointerReset (\r
- IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,\r
+ IN EFI_ABSOLUTE_POINTER_PROTOCOL *This,\r
IN BOOLEAN ExtendedVerification\r
)\r
{\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDevice;\r
\r
- UsbMouseAbsolutePointerDevice = USB_MOUSE_ABSOLUTE_POINTER_DEV_FROM_MOUSE_PROTOCOL (This);\r
+ UsbMouseAbsolutePointerDevice = USB_MOUSE_ABSOLUTE_POINTER_DEV_FROM_MOUSE_PROTOCOL (This);\r
\r
- MouseAbsolutePointerReportStatusCode (\r
- UsbMouseAbsolutePointerDevice->DevicePath,\r
+ REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
EFI_PROGRESS_CODE,\r
- PcdGet32 (PcdStatusCodeValueMouseReset)\r
+ (EFI_PERIPHERAL_MOUSE | EFI_P_PC_RESET),\r
+ UsbMouseAbsolutePointerDevice->DevicePath\r
);\r
\r
+ //\r
+ // Clear mouse state.\r
+ //\r
ZeroMem (\r
- &UsbMouseAbsolutePointerDevice->AbsolutePointerState,\r
+ &UsbMouseAbsolutePointerDevice->State,\r
sizeof (EFI_ABSOLUTE_POINTER_STATE)\r
);\r
- UsbMouseAbsolutePointerDevice->AbsolutePointerStateChanged = FALSE;\r
+\r
+ //\r
+ // Let the cursor's starting position is in the center of the screen.\r
+ //\r
+ UsbMouseAbsolutePointerDevice->State.CurrentX =\r
+ DivU64x32 (UsbMouseAbsolutePointerDevice->Mode.AbsoluteMaxX + UsbMouseAbsolutePointerDevice->Mode.AbsoluteMinX, 2);\r
+ UsbMouseAbsolutePointerDevice->State.CurrentY =\r
+ DivU64x32 (UsbMouseAbsolutePointerDevice->Mode.AbsoluteMaxY + UsbMouseAbsolutePointerDevice->Mode.AbsoluteMinY, 2);\r
+\r
+ UsbMouseAbsolutePointerDevice->StateChanged = FALSE;\r
\r
return EFI_SUCCESS;\r
}\r
\r
/**\r
- Event notification function for ABSOLUTE_POINTER.WaitForInput event\r
- Signal the event if there is input from mouse\r
+ Event notification function for EFI_ABSOLUTE_POINTER_PROTOCOL.WaitForInput event.\r
\r
- @param Event Wait Event\r
- @param Context Passed parameter to event handler\r
- VOID\r
+ @param Event Event to be signaled when there's input from mouse.\r
+ @param Context Points to USB_MOUSE_ABSOLUTE_POINTER_DEV instance.\r
\r
**/\r
-STATIC\r
VOID\r
EFIAPI\r
UsbMouseAbsolutePointerWaitForInput (\r
- IN EFI_EVENT Event,\r
- IN VOID *Context\r
+ IN EFI_EVENT Event,\r
+ IN VOID *Context\r
)\r
{\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev;\r
\r
- UsbMouseAbsolutePointerDev = (USB_MOUSE_ABSOLUTE_POINTER_DEV *) Context;\r
+ UsbMouseAbsolutePointerDev = (USB_MOUSE_ABSOLUTE_POINTER_DEV *)Context;\r
\r
//\r
- // Someone is waiting on the mouse event, if there's\r
- // input from mouse, signal the event\r
+ // If there's input from mouse, signal the event.\r
//\r
- if (UsbMouseAbsolutePointerDev->AbsolutePointerStateChanged) {\r
+ if (UsbMouseAbsolutePointerDev->StateChanged) {\r
gBS->SignalEvent (Event);\r
}\r
}\r
\r
/**\r
- Timer handler for Delayed Recovery timer.\r
+ Handler for Delayed Recovery event.\r
\r
- @param Event The Delayed Recovery event.\r
- @param Context Points to the USB_KB_DEV instance.\r
+ This function is the handler for Delayed Recovery event triggered\r
+ by timer.\r
+ After a device error occurs, the event would be triggered\r
+ with interval of EFI_USB_INTERRUPT_DELAY. EFI_USB_INTERRUPT_DELAY\r
+ is defined in USB standard for error handling.\r
\r
+ @param Event The Delayed Recovery event.\r
+ @param Context Points to the USB_MOUSE_ABSOLUTE_POINTER_DEV instance.\r
\r
**/\r
VOID\r
EFIAPI\r
-USBMouseAbsolutePointerRecoveryHandler (\r
- IN EFI_EVENT Event,\r
- IN VOID *Context\r
+USBMouseRecoveryHandler (\r
+ IN EFI_EVENT Event,\r
+ IN VOID *Context\r
)\r
{\r
- USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev;\r
- EFI_USB_IO_PROTOCOL *UsbIo;\r
+ USB_MOUSE_ABSOLUTE_POINTER_DEV *UsbMouseAbsolutePointerDev;\r
+ EFI_USB_IO_PROTOCOL *UsbIo;\r
\r
- UsbMouseAbsolutePointerDev = (USB_MOUSE_ABSOLUTE_POINTER_DEV *) Context;\r
+ UsbMouseAbsolutePointerDev = (USB_MOUSE_ABSOLUTE_POINTER_DEV *)Context;\r
\r
- UsbIo = UsbMouseAbsolutePointerDev->UsbIo;\r
+ UsbIo = UsbMouseAbsolutePointerDev->UsbIo;\r
\r
+ //\r
+ // Re-submit Asynchronous Interrupt Transfer for recovery.\r
+ //\r
UsbIo->UsbAsyncInterruptTransfer (\r
- UsbIo,\r
- UsbMouseAbsolutePointerDev->IntEndpointDescriptor->EndpointAddress,\r
- TRUE,\r
- UsbMouseAbsolutePointerDev->IntEndpointDescriptor->Interval,\r
- UsbMouseAbsolutePointerDev->IntEndpointDescriptor->MaxPacketSize,\r
- OnMouseAbsolutePointerInterruptComplete,\r
- UsbMouseAbsolutePointerDev\r
- );\r
-}\r
-\r
-\r
-/**\r
- Report Status Code in Usb Bot Driver\r
-\r
- @param DevicePath Use this to get Device Path\r
- @param CodeType Status Code Type\r
- @param CodeValue Status Code Value\r
-\r
- @return None\r
-\r
-**/\r
-VOID\r
-MouseAbsolutePointerReportStatusCode (\r
- IN EFI_DEVICE_PATH_PROTOCOL *DevicePath,\r
- IN EFI_STATUS_CODE_TYPE CodeType,\r
- IN EFI_STATUS_CODE_VALUE Value\r
- )\r
-{\r
- REPORT_STATUS_CODE_WITH_DEVICE_PATH (\r
- CodeType,\r
- Value,\r
- DevicePath\r
- );\r
+ UsbIo,\r
+ UsbMouseAbsolutePointerDev->IntEndpointDescriptor.EndpointAddress,\r
+ TRUE,\r
+ UsbMouseAbsolutePointerDev->IntEndpointDescriptor.Interval,\r
+ UsbMouseAbsolutePointerDev->IntEndpointDescriptor.MaxPacketSize,\r
+ OnMouseInterruptComplete,\r
+ UsbMouseAbsolutePointerDev\r
+ );\r
}\r