Code has been reviewed with spec

[mirror_edk2.git] / MdeModulePkg / Bus / Usb / UsbKbDxe / KeyBoard.h

/** @file\r
\r
  Function prototype for USB Keyboard Driver.\r
\r
Copyright (c) 2004 - 2008, 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
**/\r
\r
#ifndef _EFI_KEYBOARD_H_\r
#define _EFI_KEYBOARD_H_\r
\r
\r
#include "EfiKey.h"\r
\r
/**\r
  Uses USB I/O to check whether the device is a USB Keyboard device.\r
\r
  @param  UsbIo    Points to a USB I/O protocol instance.\r
  @retval None\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
IsUSBKeyboard (\r
  IN  EFI_USB_IO_PROTOCOL       *UsbIo\r
  );\r
\r
/**\r
  Initialize USB Keyboard device and all private data structures.\r
\r
  @param  UsbKeyboardDevice  The USB_KB_DEV instance.\r
\r
  @retval EFI_SUCCESS        Initialization is successful.\r
  @retval EFI_DEVICE_ERROR   Configure hardware failed.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
InitUSBKeyboard (\r
  IN USB_KB_DEV   *UsbKeyboardDevice\r
  );\r
\r
/**\r
  Initialize USB Keyboard layout.\r
\r
  @param  UsbKeyboardDevice      The USB_KB_DEV instance.\r
\r
  @retval EFI_SUCCESS            Initialization Success.\r
  @retval Other                  Keyboard layout initial failed.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
InitKeyboardLayout (\r
  IN USB_KB_DEV   *UsbKeyboardDevice\r
  );\r
\r
/**\r
  Destroy resources for Keyboard layout.\r
\r
  @param  UsbKeyboardDevice    The USB_KB_DEV instance.\r
\r
**/\r
VOID\r
EFIAPI\r
ReleaseKeyboardLayoutResources (\r
  IN USB_KB_DEV  *UsbKeyboardDevice\r
  );\r
\r
/**\r
  Handler function for USB Keyboard's asynchronous interrupt transfer.\r
\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      Handler is successful.\r
  @retval EFI_DEVICE_ERROR Hardware Error\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
KeyboardHandler (\r
  IN  VOID          *Data,\r
  IN  UINTN         DataLength,\r
  IN  VOID          *Context,\r
  IN  UINT32        Result\r
  );\r
\r
/**\r
  Timer handler for Delayed Recovery timer.\r
\r
  @param  Event              The Delayed Recovery event.\r
  @param  Context            Points to the USB_KB_DEV instance.\r
\r
\r
**/\r
VOID\r
EFIAPI\r
USBKeyboardRecoveryHandler (\r
  IN    EFI_EVENT    Event,\r
  IN    VOID         *Context\r
  );\r
\r
/**\r
  Retrieves a key character after parsing the raw data in keyboard buffer.\r
\r
  @param  UsbKeyboardDevice    The USB_KB_DEV instance.\r
  @param  KeyChar              Points to the Key character after key parsing.\r
\r
  @retval EFI_SUCCESS          Parse key is successful.\r
  @retval EFI_NOT_READY        Device is not ready.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
USBParseKey (\r
  IN OUT  USB_KB_DEV  *UsbKeyboardDevice,\r
  OUT     UINT8       *KeyChar\r
  );\r
\r
/**\r
  Converts USB Keyboard code to EFI Scan Code.\r
\r
  @param  UsbKeyboardDevice    The USB_KB_DEV instance.\r
  @param  KeyChar              Indicates the key code that will be interpreted.\r
  @param  Key                  A pointer to a buffer that is filled in with\r
                               the keystroke information for the key that\r
                               was pressed.\r
\r
  @retval EFI_NOT_READY        Device is not ready\r
  @retval EFI_SUCCESS          Success.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
USBKeyCodeToEFIScanCode (\r
  IN  USB_KB_DEV      *UsbKeyboardDevice,\r
  IN  UINT8           KeyChar,\r
  OUT EFI_INPUT_KEY   *Key\r
  );\r
\r
/**\r
  Resets USB Keyboard Buffer.\r
\r
  @param  KeyboardBuffer     Points to the USB Keyboard Buffer.\r
\r
  @retval EFI_SUCCESS        Init key buffer successfully.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
InitUSBKeyBuffer (\r
  IN OUT  USB_KB_BUFFER   *KeyboardBuffer\r
  );\r
\r
/**\r
  Check whether USB Keyboard buffer is empty.\r
\r
  @param  KeyboardBuffer     USB Keyboard Buffer.\r
\r
  @retval TRUE               Key buffer is empty.\r
  @retval FALSE              Key buffer is not empty.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
IsUSBKeyboardBufferEmpty (\r
  IN  USB_KB_BUFFER   *KeyboardBuffer\r
  );\r
\r
/**\r
  Check whether USB Keyboard buffer is full.\r
\r
  @param  KeyboardBuffer     USB Keyboard Buffer.\r
\r
  @retval TRUE               Key buffer is full.\r
  @retval FALSE              Key buffer is not full.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
IsUSBKeyboardBufferFull (\r
  IN  USB_KB_BUFFER   *KeyboardBuffer\r
  );\r
\r
/**\r
  Inserts a key code into keyboard buffer.\r
\r
  @param  KeyboardBuffer     Points to the USB Keyboard Buffer.\r
  @param  Key                Key code\r
  @param  Down               Special key\r
\r
  @retval EFI_SUCCESS        Success\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
InsertKeyCode (\r
  IN OUT  USB_KB_BUFFER *KeyboardBuffer,\r
  IN      UINT8         Key,\r
  IN      UINT8         Down\r
  );\r
\r
/**\r
  Pops a key code off from keyboard buffer.\r
\r
  @param  KeyboardBuffer     Points to the USB Keyboard Buffer.\r
  @param  UsbKey             Points to the buffer that contains a usb key code.\r
\r
  @retval EFI_SUCCESS        Success\r
  @retval EFI_DEVICE_ERROR   Hardware Error\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
RemoveKeyCode (\r
  IN OUT  USB_KB_BUFFER *KeyboardBuffer,\r
  OUT     USB_KEY       *UsbKey\r
  );\r
\r
/**\r
  Timer handler for Repeat Key timer.\r
\r
  @param  Event              The Repeat Key event.\r
  @param  Context            Points to the USB_KB_DEV instance.\r
\r
\r
**/\r
VOID\r
EFIAPI\r
USBKeyboardRepeatHandler (\r
  IN    EFI_EVENT    Event,\r
  IN    VOID         *Context\r
  );\r
\r
/**\r
  Sets USB Keyboard LED state.\r
\r
  @param  UsbKeyboardDevice  The USB_KB_DEV instance.\r
\r
  @retval EFI_SUCCESS        Success\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
SetKeyLED (\r
  IN  USB_KB_DEV    *UsbKeyboardDevice\r
  );\r
\r
#endif\r