mirror of https://github.com/acidanthera/audk.git
1873 lines
53 KiB
C
1873 lines
53 KiB
C
/** @file
|
|
Implementation for EFI_SIMPLE_TEXT_INPUT_PROTOCOL protocol.
|
|
|
|
(C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>
|
|
Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>
|
|
Copyright (C) 2016 Silicon Graphics, Inc. All rights reserved.<BR>
|
|
This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#include "Terminal.h"
|
|
|
|
|
|
/**
|
|
Reads the next keystroke from the input device. The WaitForKey Event can
|
|
be used to test for existence of a keystroke via WaitForEvent () call.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
@param KeyData A pointer to a buffer that is filled in with the
|
|
keystroke state data for the key that was
|
|
pressed.
|
|
|
|
@retval EFI_SUCCESS The keystroke information was returned.
|
|
@retval EFI_NOT_READY There was no keystroke data available.
|
|
@retval EFI_INVALID_PARAMETER KeyData is NULL.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ReadKeyStrokeWorker (
|
|
IN TERMINAL_DEV *TerminalDevice,
|
|
OUT EFI_KEY_DATA *KeyData
|
|
)
|
|
{
|
|
if (KeyData == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
if (!EfiKeyFiFoRemoveOneKey (TerminalDevice, &KeyData->Key)) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
KeyData->KeyState.KeyShiftState = 0;
|
|
KeyData->KeyState.KeyToggleState = 0;
|
|
|
|
|
|
return EFI_SUCCESS;
|
|
|
|
}
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_INPUT_PROTOCOL.Reset().
|
|
This driver only perform dependent serial device reset regardless of
|
|
the value of ExtendeVerification
|
|
|
|
@param This Indicates the calling context.
|
|
@param ExtendedVerification Skip by this driver.
|
|
|
|
@retval EFI_SUCCESS The reset operation succeeds.
|
|
@retval EFI_DEVICE_ERROR The dependent serial port reset fails.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInReset (
|
|
IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
|
|
IN BOOLEAN ExtendedVerification
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
TERMINAL_DEV *TerminalDevice;
|
|
|
|
TerminalDevice = TERMINAL_CON_IN_DEV_FROM_THIS (This);
|
|
|
|
//
|
|
// Report progress code here
|
|
//
|
|
REPORT_STATUS_CODE_WITH_DEVICE_PATH (
|
|
EFI_PROGRESS_CODE,
|
|
(EFI_PERIPHERAL_REMOTE_CONSOLE | EFI_P_PC_RESET),
|
|
TerminalDevice->DevicePath
|
|
);
|
|
|
|
Status = TerminalDevice->SerialIo->Reset (TerminalDevice->SerialIo);
|
|
|
|
//
|
|
// Make all the internal buffer empty for keys
|
|
//
|
|
TerminalDevice->RawFiFo->Head = TerminalDevice->RawFiFo->Tail;
|
|
TerminalDevice->UnicodeFiFo->Head = TerminalDevice->UnicodeFiFo->Tail;
|
|
TerminalDevice->EfiKeyFiFo->Head = TerminalDevice->EfiKeyFiFo->Tail;
|
|
TerminalDevice->EfiKeyFiFoForNotify->Head = TerminalDevice->EfiKeyFiFoForNotify->Tail;
|
|
|
|
if (EFI_ERROR (Status)) {
|
|
REPORT_STATUS_CODE_WITH_DEVICE_PATH (
|
|
EFI_ERROR_CODE | EFI_ERROR_MINOR,
|
|
(EFI_PERIPHERAL_REMOTE_CONSOLE | EFI_P_EC_CONTROLLER_ERROR),
|
|
TerminalDevice->DevicePath
|
|
);
|
|
}
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_INPUT_PROTOCOL.ReadKeyStroke().
|
|
|
|
@param This Indicates the calling context.
|
|
@param Key A pointer to a buffer that is filled in with the
|
|
keystroke information for the key that was sent
|
|
from terminal.
|
|
|
|
@retval EFI_SUCCESS The keystroke information is returned successfully.
|
|
@retval EFI_NOT_READY There is no keystroke data available.
|
|
@retval EFI_DEVICE_ERROR The dependent serial device encounters error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInReadKeyStroke (
|
|
IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
|
|
OUT EFI_INPUT_KEY *Key
|
|
)
|
|
{
|
|
TERMINAL_DEV *TerminalDevice;
|
|
EFI_STATUS Status;
|
|
EFI_KEY_DATA KeyData;
|
|
|
|
//
|
|
// get TERMINAL_DEV from "This" parameter.
|
|
//
|
|
TerminalDevice = TERMINAL_CON_IN_DEV_FROM_THIS (This);
|
|
|
|
Status = ReadKeyStrokeWorker (TerminalDevice, &KeyData);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
CopyMem (Key, &KeyData.Key, sizeof (EFI_INPUT_KEY));
|
|
|
|
return EFI_SUCCESS;
|
|
|
|
}
|
|
|
|
/**
|
|
Check if the key already has been registered.
|
|
|
|
If both RegsiteredData and InputData is NULL, then ASSERT().
|
|
|
|
@param RegsiteredData A pointer to a buffer that is filled in with the
|
|
keystroke state data for the key that was
|
|
registered.
|
|
@param InputData A pointer to a buffer that is filled in with the
|
|
keystroke state data for the key that was
|
|
pressed.
|
|
|
|
@retval TRUE Key be pressed matches a registered key.
|
|
@retval FALSE Match failed.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsKeyRegistered (
|
|
IN EFI_KEY_DATA *RegsiteredData,
|
|
IN EFI_KEY_DATA *InputData
|
|
)
|
|
{
|
|
ASSERT (RegsiteredData != NULL && InputData != NULL);
|
|
|
|
if ((RegsiteredData->Key.ScanCode != InputData->Key.ScanCode) ||
|
|
(RegsiteredData->Key.UnicodeChar != InputData->Key.UnicodeChar)) {
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
Event notification function for EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL.WaitForKeyEx event
|
|
Signal the event if there is key available
|
|
|
|
@param Event Indicates the event that invoke this function.
|
|
@param Context Indicates the calling context.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
TerminalConInWaitForKeyEx (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
{
|
|
TerminalConInWaitForKey (Event, Context);
|
|
}
|
|
|
|
//
|
|
// Simple Text Input Ex protocol functions
|
|
//
|
|
|
|
/**
|
|
Reset the input device and optionally run diagnostics
|
|
|
|
@param This Protocol instance pointer.
|
|
@param ExtendedVerification Driver may perform diagnostics on reset.
|
|
|
|
@retval EFI_SUCCESS The device was reset.
|
|
@retval EFI_DEVICE_ERROR The device is not functioning properly and could
|
|
not be reset.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInResetEx (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
IN BOOLEAN ExtendedVerification
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
TERMINAL_DEV *TerminalDevice;
|
|
|
|
TerminalDevice = TERMINAL_CON_IN_EX_DEV_FROM_THIS (This);
|
|
|
|
Status = TerminalDevice->SimpleInput.Reset (&TerminalDevice->SimpleInput, ExtendedVerification);
|
|
if (EFI_ERROR (Status)) {
|
|
return EFI_DEVICE_ERROR;
|
|
}
|
|
|
|
return EFI_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
/**
|
|
Reads the next keystroke from the input device. The WaitForKey Event can
|
|
be used to test for existence of a keystroke via WaitForEvent () call.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param KeyData A pointer to a buffer that is filled in with the
|
|
keystroke state data for the key that was
|
|
pressed.
|
|
|
|
@retval EFI_SUCCESS The keystroke information was returned.
|
|
@retval EFI_NOT_READY There was no keystroke data available.
|
|
@retval EFI_DEVICE_ERROR The keystroke information was not returned due
|
|
to hardware errors.
|
|
@retval EFI_INVALID_PARAMETER KeyData is NULL.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInReadKeyStrokeEx (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
OUT EFI_KEY_DATA *KeyData
|
|
)
|
|
{
|
|
TERMINAL_DEV *TerminalDevice;
|
|
|
|
if (KeyData == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
TerminalDevice = TERMINAL_CON_IN_EX_DEV_FROM_THIS (This);
|
|
|
|
return ReadKeyStrokeWorker (TerminalDevice, KeyData);
|
|
|
|
}
|
|
|
|
|
|
/**
|
|
Set certain state for the input device.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param KeyToggleState A pointer to the EFI_KEY_TOGGLE_STATE to set the
|
|
state for the input device.
|
|
|
|
@retval EFI_SUCCESS The device state was set successfully.
|
|
@retval EFI_DEVICE_ERROR The device is not functioning correctly and
|
|
could not have the setting adjusted.
|
|
@retval EFI_UNSUPPORTED The device does not have the ability to set its
|
|
state.
|
|
@retval EFI_INVALID_PARAMETER KeyToggleState is NULL.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInSetState (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
IN EFI_KEY_TOGGLE_STATE *KeyToggleState
|
|
)
|
|
{
|
|
if (KeyToggleState == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
if ((*KeyToggleState & EFI_TOGGLE_STATE_VALID) != EFI_TOGGLE_STATE_VALID) {
|
|
return EFI_UNSUPPORTED;
|
|
}
|
|
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
|
|
/**
|
|
Register a notification function for a particular keystroke for the input device.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param KeyData A pointer to a buffer that is filled in with
|
|
the keystroke information for the key that was
|
|
pressed. If KeyData.Key, KeyData.KeyState.KeyToggleState
|
|
and KeyData.KeyState.KeyShiftState are 0, then any incomplete
|
|
keystroke will trigger a notification of the KeyNotificationFunction.
|
|
@param KeyNotificationFunction Points to the function to be called when the key
|
|
sequence is typed specified by KeyData. This notification function
|
|
should be called at <=TPL_CALLBACK.
|
|
@param NotifyHandle Points to the unique handle assigned to the
|
|
registered notification.
|
|
|
|
@retval EFI_SUCCESS The notification function was registered
|
|
successfully.
|
|
@retval EFI_OUT_OF_RESOURCES Unable to allocate resources for necessary data
|
|
structures.
|
|
@retval EFI_INVALID_PARAMETER KeyData or NotifyHandle is NULL.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInRegisterKeyNotify (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
IN EFI_KEY_DATA *KeyData,
|
|
IN EFI_KEY_NOTIFY_FUNCTION KeyNotificationFunction,
|
|
OUT VOID **NotifyHandle
|
|
)
|
|
{
|
|
TERMINAL_DEV *TerminalDevice;
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY *NewNotify;
|
|
LIST_ENTRY *Link;
|
|
LIST_ENTRY *NotifyList;
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY *CurrentNotify;
|
|
|
|
if (KeyData == NULL || NotifyHandle == NULL || KeyNotificationFunction == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
TerminalDevice = TERMINAL_CON_IN_EX_DEV_FROM_THIS (This);
|
|
|
|
//
|
|
// Return EFI_SUCCESS if the (KeyData, NotificationFunction) is already registered.
|
|
//
|
|
NotifyList = &TerminalDevice->NotifyList;
|
|
for (Link = GetFirstNode (NotifyList); !IsNull (NotifyList,Link); Link = GetNextNode (NotifyList,Link)) {
|
|
CurrentNotify = CR (
|
|
Link,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY,
|
|
NotifyEntry,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE
|
|
);
|
|
if (IsKeyRegistered (&CurrentNotify->KeyData, KeyData)) {
|
|
if (CurrentNotify->KeyNotificationFn == KeyNotificationFunction) {
|
|
*NotifyHandle = CurrentNotify;
|
|
return EFI_SUCCESS;
|
|
}
|
|
}
|
|
}
|
|
|
|
//
|
|
// Allocate resource to save the notification function
|
|
//
|
|
NewNotify = (TERMINAL_CONSOLE_IN_EX_NOTIFY *) AllocateZeroPool (sizeof (TERMINAL_CONSOLE_IN_EX_NOTIFY));
|
|
if (NewNotify == NULL) {
|
|
return EFI_OUT_OF_RESOURCES;
|
|
}
|
|
|
|
NewNotify->Signature = TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE;
|
|
NewNotify->KeyNotificationFn = KeyNotificationFunction;
|
|
CopyMem (&NewNotify->KeyData, KeyData, sizeof (EFI_KEY_DATA));
|
|
InsertTailList (&TerminalDevice->NotifyList, &NewNotify->NotifyEntry);
|
|
|
|
*NotifyHandle = NewNotify;
|
|
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
|
|
/**
|
|
Remove a registered notification function from a particular keystroke.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param NotificationHandle The handle of the notification function being
|
|
unregistered.
|
|
|
|
@retval EFI_SUCCESS The notification function was unregistered
|
|
successfully.
|
|
@retval EFI_INVALID_PARAMETER The NotificationHandle is invalid.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInUnregisterKeyNotify (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
IN VOID *NotificationHandle
|
|
)
|
|
{
|
|
TERMINAL_DEV *TerminalDevice;
|
|
LIST_ENTRY *Link;
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY *CurrentNotify;
|
|
LIST_ENTRY *NotifyList;
|
|
|
|
if (NotificationHandle == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
TerminalDevice = TERMINAL_CON_IN_EX_DEV_FROM_THIS (This);
|
|
|
|
NotifyList = &TerminalDevice->NotifyList;
|
|
for (Link = GetFirstNode (NotifyList); !IsNull (NotifyList,Link); Link = GetNextNode (NotifyList,Link)) {
|
|
CurrentNotify = CR (
|
|
Link,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY,
|
|
NotifyEntry,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE
|
|
);
|
|
if (CurrentNotify == NotificationHandle) {
|
|
//
|
|
// Remove the notification function from NotifyList and free resources
|
|
//
|
|
RemoveEntryList (&CurrentNotify->NotifyEntry);
|
|
|
|
gBS->FreePool (CurrentNotify);
|
|
return EFI_SUCCESS;
|
|
}
|
|
}
|
|
|
|
//
|
|
// Can not find the matching entry in database.
|
|
//
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
/**
|
|
Translate raw data into Unicode (according to different encode), and
|
|
translate Unicode into key information. (according to different standard).
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
|
|
**/
|
|
VOID
|
|
TranslateRawDataToEfiKey (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
switch (TerminalDevice->TerminalType) {
|
|
|
|
case TerminalTypePcAnsi:
|
|
case TerminalTypeVt100:
|
|
case TerminalTypeVt100Plus:
|
|
case TerminalTypeTtyTerm:
|
|
AnsiRawDataToUnicode (TerminalDevice);
|
|
UnicodeToEfiKey (TerminalDevice);
|
|
break;
|
|
|
|
case TerminalTypeVtUtf8:
|
|
//
|
|
// Process all the raw data in the RawFIFO,
|
|
// put the processed key into UnicodeFIFO.
|
|
//
|
|
VTUTF8RawDataToUnicode (TerminalDevice);
|
|
|
|
//
|
|
// Translate all the Unicode data in the UnicodeFIFO to Efi key,
|
|
// then put into EfiKeyFIFO.
|
|
//
|
|
UnicodeToEfiKey (TerminalDevice);
|
|
|
|
break;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Event notification function for EFI_SIMPLE_TEXT_INPUT_PROTOCOL.WaitForKey event
|
|
Signal the event if there is key available
|
|
|
|
@param Event Indicates the event that invoke this function.
|
|
@param Context Indicates the calling context.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
TerminalConInWaitForKey (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
{
|
|
//
|
|
// Someone is waiting on the keystroke event, if there's
|
|
// a key pending, signal the event
|
|
//
|
|
if (!IsEfiKeyFiFoEmpty ((TERMINAL_DEV *) Context)) {
|
|
|
|
gBS->SignalEvent (Event);
|
|
}
|
|
}
|
|
|
|
/**
|
|
Timer handler to poll the key from serial.
|
|
|
|
@param Event Indicates the event that invoke this function.
|
|
@param Context Indicates the calling context.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
TerminalConInTimerHandler (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
TERMINAL_DEV *TerminalDevice;
|
|
UINT32 Control;
|
|
UINT8 Input;
|
|
EFI_SERIAL_IO_MODE *Mode;
|
|
EFI_SERIAL_IO_PROTOCOL *SerialIo;
|
|
UINTN SerialInTimeOut;
|
|
|
|
TerminalDevice = (TERMINAL_DEV *) Context;
|
|
|
|
SerialIo = TerminalDevice->SerialIo;
|
|
if (SerialIo == NULL) {
|
|
return ;
|
|
}
|
|
//
|
|
// if current timeout value for serial device is not identical with
|
|
// the value saved in TERMINAL_DEV structure, then recalculate the
|
|
// timeout value again and set serial attribute according to this value.
|
|
//
|
|
Mode = SerialIo->Mode;
|
|
if (Mode->Timeout != TerminalDevice->SerialInTimeOut) {
|
|
|
|
SerialInTimeOut = 0;
|
|
if (Mode->BaudRate != 0) {
|
|
//
|
|
// According to BAUD rate to calculate the timeout value.
|
|
//
|
|
SerialInTimeOut = (1 + Mode->DataBits + Mode->StopBits) * 2 * 1000000 / (UINTN) Mode->BaudRate;
|
|
}
|
|
|
|
Status = SerialIo->SetAttributes (
|
|
SerialIo,
|
|
Mode->BaudRate,
|
|
Mode->ReceiveFifoDepth,
|
|
(UINT32) SerialInTimeOut,
|
|
(EFI_PARITY_TYPE) (Mode->Parity),
|
|
(UINT8) Mode->DataBits,
|
|
(EFI_STOP_BITS_TYPE) (Mode->StopBits)
|
|
);
|
|
|
|
if (EFI_ERROR (Status)) {
|
|
TerminalDevice->SerialInTimeOut = 0;
|
|
} else {
|
|
TerminalDevice->SerialInTimeOut = SerialInTimeOut;
|
|
}
|
|
}
|
|
//
|
|
// Check whether serial buffer is empty.
|
|
// Skip the key transfer loop only if the SerialIo protocol instance
|
|
// successfully reports EFI_SERIAL_INPUT_BUFFER_EMPTY.
|
|
//
|
|
Status = SerialIo->GetControl (SerialIo, &Control);
|
|
if (EFI_ERROR (Status) || ((Control & EFI_SERIAL_INPUT_BUFFER_EMPTY) == 0)) {
|
|
//
|
|
// Fetch all the keys in the serial buffer,
|
|
// and insert the byte stream into RawFIFO.
|
|
//
|
|
while (!IsRawFiFoFull (TerminalDevice)) {
|
|
|
|
Status = GetOneKeyFromSerial (TerminalDevice->SerialIo, &Input);
|
|
|
|
if (EFI_ERROR (Status)) {
|
|
if (Status == EFI_DEVICE_ERROR) {
|
|
REPORT_STATUS_CODE_WITH_DEVICE_PATH (
|
|
EFI_ERROR_CODE | EFI_ERROR_MINOR,
|
|
(EFI_PERIPHERAL_REMOTE_CONSOLE | EFI_P_EC_INPUT_ERROR),
|
|
TerminalDevice->DevicePath
|
|
);
|
|
}
|
|
break;
|
|
}
|
|
|
|
RawFiFoInsertOneKey (TerminalDevice, Input);
|
|
}
|
|
}
|
|
|
|
//
|
|
// Translate all the raw data in RawFIFO into EFI Key,
|
|
// according to different terminal type supported.
|
|
//
|
|
TranslateRawDataToEfiKey (TerminalDevice);
|
|
}
|
|
|
|
/**
|
|
Process key notify.
|
|
|
|
@param Event Indicates the event that invoke this function.
|
|
@param Context Indicates the calling context.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
KeyNotifyProcessHandler (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
{
|
|
BOOLEAN HasKey;
|
|
TERMINAL_DEV *TerminalDevice;
|
|
EFI_INPUT_KEY Key;
|
|
EFI_KEY_DATA KeyData;
|
|
LIST_ENTRY *Link;
|
|
LIST_ENTRY *NotifyList;
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY *CurrentNotify;
|
|
EFI_TPL OldTpl;
|
|
|
|
TerminalDevice = (TERMINAL_DEV *) Context;
|
|
|
|
//
|
|
// Invoke notification functions.
|
|
//
|
|
NotifyList = &TerminalDevice->NotifyList;
|
|
while (TRUE) {
|
|
//
|
|
// Enter critical section
|
|
//
|
|
OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
|
|
HasKey = EfiKeyFiFoForNotifyRemoveOneKey (TerminalDevice->EfiKeyFiFoForNotify, &Key);
|
|
CopyMem (&KeyData.Key, &Key, sizeof (EFI_INPUT_KEY));
|
|
KeyData.KeyState.KeyShiftState = 0;
|
|
KeyData.KeyState.KeyToggleState = 0;
|
|
//
|
|
// Leave critical section
|
|
//
|
|
gBS->RestoreTPL (OldTpl);
|
|
if (!HasKey) {
|
|
break;
|
|
}
|
|
for (Link = GetFirstNode (NotifyList); !IsNull (NotifyList, Link); Link = GetNextNode (NotifyList, Link)) {
|
|
CurrentNotify = CR (Link, TERMINAL_CONSOLE_IN_EX_NOTIFY, NotifyEntry, TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE);
|
|
if (IsKeyRegistered (&CurrentNotify->KeyData, &KeyData)) {
|
|
CurrentNotify->KeyNotificationFn (&KeyData);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
Get one key out of serial buffer.
|
|
|
|
@param SerialIo Serial I/O protocol attached to the serial device.
|
|
@param Output The fetched key.
|
|
|
|
@retval EFI_NOT_READY If serial buffer is empty.
|
|
@retval EFI_DEVICE_ERROR If reading serial buffer encounter error.
|
|
@retval EFI_SUCCESS If reading serial buffer successfully, put
|
|
the fetched key to the parameter output.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
GetOneKeyFromSerial (
|
|
EFI_SERIAL_IO_PROTOCOL *SerialIo,
|
|
UINT8 *Output
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
UINTN Size;
|
|
|
|
Size = 1;
|
|
*Output = 0;
|
|
|
|
//
|
|
// Read one key from serial I/O device.
|
|
//
|
|
Status = SerialIo->Read (SerialIo, &Size, Output);
|
|
|
|
if (EFI_ERROR (Status)) {
|
|
|
|
if (Status == EFI_TIMEOUT) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
return EFI_DEVICE_ERROR;
|
|
|
|
}
|
|
|
|
if (*Output == 0) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
Insert one byte raw data into the Raw Data FIFO.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Input The key will be input.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If Raw Data buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
RawFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT8 Input
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
|
|
Tail = TerminalDevice->RawFiFo->Tail;
|
|
|
|
if (IsRawFiFoFull (TerminalDevice)) {
|
|
//
|
|
// Raw FIFO is full
|
|
//
|
|
return FALSE;
|
|
}
|
|
|
|
TerminalDevice->RawFiFo->Data[Tail] = Input;
|
|
|
|
TerminalDevice->RawFiFo->Tail = (UINT8) ((Tail + 1) % (RAW_FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the Raw Data FIFO.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If Raw Data FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
RawFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT8 *Output
|
|
)
|
|
{
|
|
UINT8 Head;
|
|
|
|
Head = TerminalDevice->RawFiFo->Head;
|
|
|
|
if (IsRawFiFoEmpty (TerminalDevice)) {
|
|
//
|
|
// FIFO is empty
|
|
//
|
|
*Output = 0;
|
|
return FALSE;
|
|
}
|
|
|
|
*Output = TerminalDevice->RawFiFo->Data[Head];
|
|
|
|
TerminalDevice->RawFiFo->Head = (UINT8) ((Head + 1) % (RAW_FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Clarify whether Raw Data FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If Raw Data FIFO buffer is empty.
|
|
@retval FALSE If Raw Data FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsRawFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
if (TerminalDevice->RawFiFo->Head == TerminalDevice->RawFiFo->Tail) {
|
|
return TRUE;
|
|
} else {
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Clarify whether Raw Data FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If Raw Data FIFO buffer is full.
|
|
@retval FALSE If Raw Data FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsRawFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
UINT8 Head;
|
|
|
|
Tail = TerminalDevice->RawFiFo->Tail;
|
|
Head = TerminalDevice->RawFiFo->Head;
|
|
|
|
if (((Tail + 1) % (RAW_FIFO_MAX_NUMBER + 1)) == Head) {
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
Insert one pre-fetched key into the FIFO buffer.
|
|
|
|
@param EfiKeyFiFo Pointer to instance of EFI_KEY_FIFO.
|
|
@param Input The key will be input.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If FIFO buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoForNotifyInsertOneKey (
|
|
EFI_KEY_FIFO *EfiKeyFiFo,
|
|
EFI_INPUT_KEY *Input
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
|
|
Tail = EfiKeyFiFo->Tail;
|
|
|
|
if (IsEfiKeyFiFoForNotifyFull (EfiKeyFiFo)) {
|
|
//
|
|
// FIFO is full
|
|
//
|
|
return FALSE;
|
|
}
|
|
|
|
CopyMem (&EfiKeyFiFo->Data[Tail], Input, sizeof (EFI_INPUT_KEY));
|
|
|
|
EfiKeyFiFo->Tail = (UINT8) ((Tail + 1) % (FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the FIFO buffer.
|
|
|
|
@param EfiKeyFiFo Pointer to instance of EFI_KEY_FIFO.
|
|
@param Output The key will be removed.
|
|
|
|
@retval TRUE If remove successfully.
|
|
@retval FALSE If FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoForNotifyRemoveOneKey (
|
|
EFI_KEY_FIFO *EfiKeyFiFo,
|
|
EFI_INPUT_KEY *Output
|
|
)
|
|
{
|
|
UINT8 Head;
|
|
|
|
Head = EfiKeyFiFo->Head;
|
|
ASSERT (Head < FIFO_MAX_NUMBER + 1);
|
|
|
|
if (IsEfiKeyFiFoForNotifyEmpty (EfiKeyFiFo)) {
|
|
//
|
|
// FIFO is empty
|
|
//
|
|
Output->ScanCode = SCAN_NULL;
|
|
Output->UnicodeChar = 0;
|
|
return FALSE;
|
|
}
|
|
|
|
CopyMem (Output, &EfiKeyFiFo->Data[Head], sizeof (EFI_INPUT_KEY));
|
|
|
|
EfiKeyFiFo->Head = (UINT8) ((Head + 1) % (FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is empty.
|
|
|
|
@param EfiKeyFiFo Pointer to instance of EFI_KEY_FIFO.
|
|
|
|
@retval TRUE If FIFO buffer is empty.
|
|
@retval FALSE If FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoForNotifyEmpty (
|
|
EFI_KEY_FIFO *EfiKeyFiFo
|
|
)
|
|
{
|
|
if (EfiKeyFiFo->Head == EfiKeyFiFo->Tail) {
|
|
return TRUE;
|
|
} else {
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is full.
|
|
|
|
@param EfiKeyFiFo Pointer to instance of EFI_KEY_FIFO.
|
|
|
|
@retval TRUE If FIFO buffer is full.
|
|
@retval FALSE If FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoForNotifyFull (
|
|
EFI_KEY_FIFO *EfiKeyFiFo
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
UINT8 Head;
|
|
|
|
Tail = EfiKeyFiFo->Tail;
|
|
Head = EfiKeyFiFo->Head;
|
|
|
|
if (((Tail + 1) % (FIFO_MAX_NUMBER + 1)) == Head) {
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
Insert one pre-fetched key into the FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Key The key will be input.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If FIFO buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
EFI_INPUT_KEY *Key
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
LIST_ENTRY *Link;
|
|
LIST_ENTRY *NotifyList;
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY *CurrentNotify;
|
|
EFI_KEY_DATA KeyData;
|
|
|
|
Tail = TerminalDevice->EfiKeyFiFo->Tail;
|
|
|
|
CopyMem (&KeyData.Key, Key, sizeof (EFI_INPUT_KEY));
|
|
KeyData.KeyState.KeyShiftState = 0;
|
|
KeyData.KeyState.KeyToggleState = 0;
|
|
|
|
//
|
|
// Signal KeyNotify process event if this key pressed matches any key registered.
|
|
//
|
|
NotifyList = &TerminalDevice->NotifyList;
|
|
for (Link = GetFirstNode (NotifyList); !IsNull (NotifyList,Link); Link = GetNextNode (NotifyList,Link)) {
|
|
CurrentNotify = CR (
|
|
Link,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY,
|
|
NotifyEntry,
|
|
TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE
|
|
);
|
|
if (IsKeyRegistered (&CurrentNotify->KeyData, &KeyData)) {
|
|
//
|
|
// The key notification function needs to run at TPL_CALLBACK
|
|
// while current TPL is TPL_NOTIFY. It will be invoked in
|
|
// KeyNotifyProcessHandler() which runs at TPL_CALLBACK.
|
|
//
|
|
EfiKeyFiFoForNotifyInsertOneKey (TerminalDevice->EfiKeyFiFoForNotify, Key);
|
|
gBS->SignalEvent (TerminalDevice->KeyNotifyProcessEvent);
|
|
}
|
|
}
|
|
if (IsEfiKeyFiFoFull (TerminalDevice)) {
|
|
//
|
|
// Efi Key FIFO is full
|
|
//
|
|
return FALSE;
|
|
}
|
|
|
|
CopyMem (&TerminalDevice->EfiKeyFiFo->Data[Tail], Key, sizeof (EFI_INPUT_KEY));
|
|
|
|
TerminalDevice->EfiKeyFiFo->Tail = (UINT8) ((Tail + 1) % (FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
EFI_INPUT_KEY *Output
|
|
)
|
|
{
|
|
UINT8 Head;
|
|
|
|
Head = TerminalDevice->EfiKeyFiFo->Head;
|
|
ASSERT (Head < FIFO_MAX_NUMBER + 1);
|
|
|
|
if (IsEfiKeyFiFoEmpty (TerminalDevice)) {
|
|
//
|
|
// FIFO is empty
|
|
//
|
|
Output->ScanCode = SCAN_NULL;
|
|
Output->UnicodeChar = 0;
|
|
return FALSE;
|
|
}
|
|
|
|
CopyMem (Output, &TerminalDevice->EfiKeyFiFo->Data[Head], sizeof (EFI_INPUT_KEY));
|
|
|
|
TerminalDevice->EfiKeyFiFo->Head = (UINT8) ((Head + 1) % (FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If FIFO buffer is empty.
|
|
@retval FALSE If FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
if (TerminalDevice->EfiKeyFiFo->Head == TerminalDevice->EfiKeyFiFo->Tail) {
|
|
return TRUE;
|
|
} else {
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If FIFO buffer is full.
|
|
@retval FALSE If FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
UINT8 Head;
|
|
|
|
Tail = TerminalDevice->EfiKeyFiFo->Tail;
|
|
Head = TerminalDevice->EfiKeyFiFo->Head;
|
|
|
|
if (((Tail + 1) % (FIFO_MAX_NUMBER + 1)) == Head) {
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
Insert one pre-fetched key into the Unicode FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Input The key will be input.
|
|
|
|
@retval TRUE If insert successfully.
|
|
@retval FALSE If Unicode FIFO buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
UnicodeFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT16 Input
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
|
|
Tail = TerminalDevice->UnicodeFiFo->Tail;
|
|
ASSERT (Tail < FIFO_MAX_NUMBER + 1);
|
|
|
|
|
|
if (IsUnicodeFiFoFull (TerminalDevice)) {
|
|
//
|
|
// Unicode FIFO is full
|
|
//
|
|
return FALSE;
|
|
}
|
|
|
|
TerminalDevice->UnicodeFiFo->Data[Tail] = Input;
|
|
|
|
TerminalDevice->UnicodeFiFo->Tail = (UINT8) ((Tail + 1) % (FIFO_MAX_NUMBER + 1));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the Unicode FIFO buffer.
|
|
The caller should guarantee that Unicode FIFO buffer is not empty
|
|
by IsUnicodeFiFoEmpty ().
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
**/
|
|
VOID
|
|
UnicodeFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT16 *Output
|
|
)
|
|
{
|
|
UINT8 Head;
|
|
|
|
Head = TerminalDevice->UnicodeFiFo->Head;
|
|
ASSERT (Head < FIFO_MAX_NUMBER + 1);
|
|
|
|
*Output = TerminalDevice->UnicodeFiFo->Data[Head];
|
|
|
|
TerminalDevice->UnicodeFiFo->Head = (UINT8) ((Head + 1) % (FIFO_MAX_NUMBER + 1));
|
|
}
|
|
|
|
/**
|
|
Clarify whether Unicode FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If Unicode FIFO buffer is empty.
|
|
@retval FALSE If Unicode FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsUnicodeFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
if (TerminalDevice->UnicodeFiFo->Head == TerminalDevice->UnicodeFiFo->Tail) {
|
|
return TRUE;
|
|
} else {
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Clarify whether Unicode FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@retval TRUE If Unicode FIFO buffer is full.
|
|
@retval FALSE If Unicode FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsUnicodeFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
UINT8 Head;
|
|
|
|
Tail = TerminalDevice->UnicodeFiFo->Tail;
|
|
Head = TerminalDevice->UnicodeFiFo->Head;
|
|
|
|
if (((Tail + 1) % (FIFO_MAX_NUMBER + 1)) == Head) {
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
Count Unicode FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return The count in bytes of Unicode FIFO.
|
|
|
|
**/
|
|
UINT8
|
|
UnicodeFiFoGetKeyCount (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
UINT8 Tail;
|
|
UINT8 Head;
|
|
|
|
Tail = TerminalDevice->UnicodeFiFo->Tail;
|
|
Head = TerminalDevice->UnicodeFiFo->Head;
|
|
|
|
if (Tail >= Head) {
|
|
return (UINT8) (Tail - Head);
|
|
} else {
|
|
return (UINT8) (Tail + FIFO_MAX_NUMBER + 1 - Head);
|
|
}
|
|
}
|
|
|
|
/**
|
|
Update the Unicode characters from a terminal input device into EFI Keys FIFO.
|
|
|
|
@param TerminalDevice The terminal device to use to translate raw input into EFI Keys
|
|
|
|
**/
|
|
VOID
|
|
UnicodeToEfiKeyFlushState (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
EFI_INPUT_KEY Key;
|
|
UINT32 InputState;
|
|
|
|
InputState = TerminalDevice->InputState;
|
|
|
|
if (IsEfiKeyFiFoFull (TerminalDevice)) {
|
|
return;
|
|
}
|
|
|
|
if ((InputState & INPUT_STATE_ESC) != 0) {
|
|
Key.ScanCode = SCAN_ESC;
|
|
Key.UnicodeChar = 0;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
|
|
if ((InputState & INPUT_STATE_CSI) != 0) {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = CSI;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
|
|
if ((InputState & INPUT_STATE_LEFTOPENBRACKET) != 0) {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = LEFTOPENBRACKET;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
|
|
if ((InputState & INPUT_STATE_O) != 0) {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = 'O';
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
|
|
if ((InputState & INPUT_STATE_2) != 0) {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = '2';
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
|
|
//
|
|
// Cancel the timer.
|
|
//
|
|
gBS->SetTimer (
|
|
TerminalDevice->TwoSecondTimeOut,
|
|
TimerCancel,
|
|
0
|
|
);
|
|
|
|
TerminalDevice->InputState = INPUT_STATE_DEFAULT;
|
|
}
|
|
|
|
|
|
/**
|
|
Converts a stream of Unicode characters from a terminal input device into EFI Keys that
|
|
can be read through the Simple Input Protocol.
|
|
|
|
The table below shows the keyboard input mappings that this function supports.
|
|
If the ESC sequence listed in one of the columns is presented, then it is translated
|
|
into the corresponding EFI Scan Code. If a matching sequence is not found, then the raw
|
|
key strokes are converted into EFI Keys.
|
|
|
|
2 seconds are allowed for an ESC sequence to be completed. If the ESC sequence is not
|
|
completed in 2 seconds, then the raw key strokes of the partial ESC sequence are
|
|
converted into EFI Keys.
|
|
There is one special input sequence that will force the system to reset.
|
|
This is ESC R ESC r ESC R.
|
|
|
|
Note: current implementation support terminal types include: PC ANSI, VT100+/VTUTF8, VT100.
|
|
The table below is not same with UEFI Spec 2.3 Appendix B Table 201(not support ANSI X3.64 /
|
|
DEC VT200-500 and extra support PC ANSI, VT100)since UEFI Table 201 is just an example.
|
|
|
|
Symbols used in table below
|
|
===========================
|
|
ESC = 0x1B
|
|
CSI = 0x9B
|
|
DEL = 0x7f
|
|
^ = CTRL
|
|
|
|
+=========+======+===========+==========+==========+
|
|
| | EFI | UEFI 2.0 | | |
|
|
| | Scan | | VT100+ | |
|
|
| KEY | Code | PC ANSI | VTUTF8 | VT100 |
|
|
+=========+======+===========+==========+==========+
|
|
| NULL | 0x00 | | | |
|
|
| UP | 0x01 | ESC [ A | ESC [ A | ESC [ A |
|
|
| DOWN | 0x02 | ESC [ B | ESC [ B | ESC [ B |
|
|
| RIGHT | 0x03 | ESC [ C | ESC [ C | ESC [ C |
|
|
| LEFT | 0x04 | ESC [ D | ESC [ D | ESC [ D |
|
|
| HOME | 0x05 | ESC [ H | ESC h | ESC [ H |
|
|
| END | 0x06 | ESC [ F | ESC k | ESC [ K |
|
|
| INSERT | 0x07 | ESC [ @ | ESC + | ESC [ @ |
|
|
| | | ESC [ L | | ESC [ L |
|
|
| DELETE | 0x08 | ESC [ X | ESC - | ESC [ P |
|
|
| PG UP | 0x09 | ESC [ I | ESC ? | ESC [ V |
|
|
| | | | | ESC [ ? |
|
|
| PG DOWN | 0x0A | ESC [ G | ESC / | ESC [ U |
|
|
| | | | | ESC [ / |
|
|
| F1 | 0x0B | ESC [ M | ESC 1 | ESC O P |
|
|
| F2 | 0x0C | ESC [ N | ESC 2 | ESC O Q |
|
|
| F3 | 0x0D | ESC [ O | ESC 3 | ESC O w |
|
|
| F4 | 0x0E | ESC [ P | ESC 4 | ESC O x |
|
|
| F5 | 0x0F | ESC [ Q | ESC 5 | ESC O t |
|
|
| F6 | 0x10 | ESC [ R | ESC 6 | ESC O u |
|
|
| F7 | 0x11 | ESC [ S | ESC 7 | ESC O q |
|
|
| F8 | 0x12 | ESC [ T | ESC 8 | ESC O r |
|
|
| F9 | 0x13 | ESC [ U | ESC 9 | ESC O p |
|
|
| F10 | 0x14 | ESC [ V | ESC 0 | ESC O M |
|
|
| Escape | 0x17 | ESC | ESC | ESC |
|
|
| F11 | 0x15 | | ESC ! | |
|
|
| F12 | 0x16 | | ESC @ | |
|
|
+=========+======+===========+==========+==========+
|
|
|
|
Special Mappings
|
|
================
|
|
ESC R ESC r ESC R = Reset System
|
|
|
|
@param TerminalDevice The terminal device to use to translate raw input into EFI Keys
|
|
|
|
**/
|
|
VOID
|
|
UnicodeToEfiKey (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
EFI_STATUS TimerStatus;
|
|
UINT16 UnicodeChar;
|
|
EFI_INPUT_KEY Key;
|
|
BOOLEAN SetDefaultResetState;
|
|
|
|
TimerStatus = gBS->CheckEvent (TerminalDevice->TwoSecondTimeOut);
|
|
|
|
if (!EFI_ERROR (TimerStatus)) {
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
}
|
|
|
|
while (!IsUnicodeFiFoEmpty (TerminalDevice) && !IsEfiKeyFiFoFull (TerminalDevice)) {
|
|
|
|
if (TerminalDevice->InputState != INPUT_STATE_DEFAULT) {
|
|
//
|
|
// Check to see if the 2 seconds timer has expired
|
|
//
|
|
TimerStatus = gBS->CheckEvent (TerminalDevice->TwoSecondTimeOut);
|
|
if (!EFI_ERROR (TimerStatus)) {
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
}
|
|
}
|
|
|
|
//
|
|
// Fetch one Unicode character from the Unicode FIFO
|
|
//
|
|
UnicodeFiFoRemoveOneKey (TerminalDevice, &UnicodeChar);
|
|
|
|
SetDefaultResetState = TRUE;
|
|
|
|
switch (TerminalDevice->InputState) {
|
|
case INPUT_STATE_DEFAULT:
|
|
|
|
break;
|
|
|
|
case INPUT_STATE_ESC:
|
|
|
|
if (UnicodeChar == LEFTOPENBRACKET) {
|
|
TerminalDevice->InputState |= INPUT_STATE_LEFTOPENBRACKET;
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
continue;
|
|
}
|
|
|
|
if (UnicodeChar == 'O' && (TerminalDevice->TerminalType == TerminalTypeVt100 ||
|
|
TerminalDevice->TerminalType == TerminalTypeTtyTerm)) {
|
|
TerminalDevice->InputState |= INPUT_STATE_O;
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
continue;
|
|
}
|
|
|
|
Key.ScanCode = SCAN_NULL;
|
|
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100Plus ||
|
|
TerminalDevice->TerminalType == TerminalTypeVtUtf8) {
|
|
switch (UnicodeChar) {
|
|
case '1':
|
|
Key.ScanCode = SCAN_F1;
|
|
break;
|
|
case '2':
|
|
Key.ScanCode = SCAN_F2;
|
|
break;
|
|
case '3':
|
|
Key.ScanCode = SCAN_F3;
|
|
break;
|
|
case '4':
|
|
Key.ScanCode = SCAN_F4;
|
|
break;
|
|
case '5':
|
|
Key.ScanCode = SCAN_F5;
|
|
break;
|
|
case '6':
|
|
Key.ScanCode = SCAN_F6;
|
|
break;
|
|
case '7':
|
|
Key.ScanCode = SCAN_F7;
|
|
break;
|
|
case '8':
|
|
Key.ScanCode = SCAN_F8;
|
|
break;
|
|
case '9':
|
|
Key.ScanCode = SCAN_F9;
|
|
break;
|
|
case '0':
|
|
Key.ScanCode = SCAN_F10;
|
|
break;
|
|
case '!':
|
|
Key.ScanCode = SCAN_F11;
|
|
break;
|
|
case '@':
|
|
Key.ScanCode = SCAN_F12;
|
|
break;
|
|
case 'h':
|
|
Key.ScanCode = SCAN_HOME;
|
|
break;
|
|
case 'k':
|
|
Key.ScanCode = SCAN_END;
|
|
break;
|
|
case '+':
|
|
Key.ScanCode = SCAN_INSERT;
|
|
break;
|
|
case '-':
|
|
Key.ScanCode = SCAN_DELETE;
|
|
break;
|
|
case '/':
|
|
Key.ScanCode = SCAN_PAGE_DOWN;
|
|
break;
|
|
case '?':
|
|
Key.ScanCode = SCAN_PAGE_UP;
|
|
break;
|
|
default :
|
|
break;
|
|
}
|
|
}
|
|
|
|
switch (UnicodeChar) {
|
|
case 'R':
|
|
if (TerminalDevice->ResetState == RESET_STATE_DEFAULT) {
|
|
TerminalDevice->ResetState = RESET_STATE_ESC_R;
|
|
SetDefaultResetState = FALSE;
|
|
} else if (TerminalDevice->ResetState == RESET_STATE_ESC_R_ESC_R) {
|
|
gRT->ResetSystem (EfiResetWarm, EFI_SUCCESS, 0, NULL);
|
|
}
|
|
Key.ScanCode = SCAN_NULL;
|
|
break;
|
|
case 'r':
|
|
if (TerminalDevice->ResetState == RESET_STATE_ESC_R) {
|
|
TerminalDevice->ResetState = RESET_STATE_ESC_R_ESC_R;
|
|
SetDefaultResetState = FALSE;
|
|
}
|
|
Key.ScanCode = SCAN_NULL;
|
|
break;
|
|
default :
|
|
break;
|
|
}
|
|
|
|
if (SetDefaultResetState) {
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
}
|
|
|
|
if (Key.ScanCode != SCAN_NULL) {
|
|
Key.UnicodeChar = 0;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
TerminalDevice->InputState = INPUT_STATE_DEFAULT;
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
continue;
|
|
}
|
|
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
|
|
break;
|
|
|
|
case INPUT_STATE_ESC | INPUT_STATE_O:
|
|
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
|
|
Key.ScanCode = SCAN_NULL;
|
|
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
switch (UnicodeChar) {
|
|
case 'P':
|
|
Key.ScanCode = SCAN_F1;
|
|
break;
|
|
case 'Q':
|
|
Key.ScanCode = SCAN_F2;
|
|
break;
|
|
case 'w':
|
|
Key.ScanCode = SCAN_F3;
|
|
break;
|
|
case 'x':
|
|
Key.ScanCode = SCAN_F4;
|
|
break;
|
|
case 't':
|
|
Key.ScanCode = SCAN_F5;
|
|
break;
|
|
case 'u':
|
|
Key.ScanCode = SCAN_F6;
|
|
break;
|
|
case 'q':
|
|
Key.ScanCode = SCAN_F7;
|
|
break;
|
|
case 'r':
|
|
Key.ScanCode = SCAN_F8;
|
|
break;
|
|
case 'p':
|
|
Key.ScanCode = SCAN_F9;
|
|
break;
|
|
case 'M':
|
|
Key.ScanCode = SCAN_F10;
|
|
break;
|
|
default :
|
|
break;
|
|
}
|
|
} else if (TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
/* Also accept VT100 escape codes for F1-F4, HOME and END for TTY term */
|
|
switch (UnicodeChar) {
|
|
case 'P':
|
|
Key.ScanCode = SCAN_F1;
|
|
break;
|
|
case 'Q':
|
|
Key.ScanCode = SCAN_F2;
|
|
break;
|
|
case 'R':
|
|
Key.ScanCode = SCAN_F3;
|
|
break;
|
|
case 'S':
|
|
Key.ScanCode = SCAN_F4;
|
|
break;
|
|
case 'H':
|
|
Key.ScanCode = SCAN_HOME;
|
|
break;
|
|
case 'F':
|
|
Key.ScanCode = SCAN_END;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (Key.ScanCode != SCAN_NULL) {
|
|
Key.UnicodeChar = 0;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
TerminalDevice->InputState = INPUT_STATE_DEFAULT;
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
continue;
|
|
}
|
|
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
|
|
break;
|
|
|
|
case INPUT_STATE_ESC | INPUT_STATE_LEFTOPENBRACKET:
|
|
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
|
|
Key.ScanCode = SCAN_NULL;
|
|
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi ||
|
|
TerminalDevice->TerminalType == TerminalTypeVt100 ||
|
|
TerminalDevice->TerminalType == TerminalTypeVt100Plus ||
|
|
TerminalDevice->TerminalType == TerminalTypeVtUtf8 ||
|
|
TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
switch (UnicodeChar) {
|
|
case 'A':
|
|
Key.ScanCode = SCAN_UP;
|
|
break;
|
|
case 'B':
|
|
Key.ScanCode = SCAN_DOWN;
|
|
break;
|
|
case 'C':
|
|
Key.ScanCode = SCAN_RIGHT;
|
|
break;
|
|
case 'D':
|
|
Key.ScanCode = SCAN_LEFT;
|
|
break;
|
|
case 'H':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi ||
|
|
TerminalDevice->TerminalType == TerminalTypeVt100 ||
|
|
TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
Key.ScanCode = SCAN_HOME;
|
|
}
|
|
break;
|
|
case 'F':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi ||
|
|
TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
Key.ScanCode = SCAN_END;
|
|
}
|
|
break;
|
|
case 'K':
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
Key.ScanCode = SCAN_END;
|
|
}
|
|
break;
|
|
case 'L':
|
|
case '@':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi ||
|
|
TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
Key.ScanCode = SCAN_INSERT;
|
|
}
|
|
break;
|
|
case 'X':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_DELETE;
|
|
}
|
|
break;
|
|
case 'P':
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
Key.ScanCode = SCAN_DELETE;
|
|
} else if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F4;
|
|
}
|
|
break;
|
|
case 'I':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_PAGE_UP;
|
|
}
|
|
break;
|
|
case 'V':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F10;
|
|
}
|
|
break;
|
|
case '?':
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
Key.ScanCode = SCAN_PAGE_UP;
|
|
}
|
|
break;
|
|
case 'G':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_PAGE_DOWN;
|
|
}
|
|
break;
|
|
case 'U':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F9;
|
|
}
|
|
break;
|
|
case '/':
|
|
if (TerminalDevice->TerminalType == TerminalTypeVt100) {
|
|
Key.ScanCode = SCAN_PAGE_DOWN;
|
|
}
|
|
break;
|
|
case 'M':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F1;
|
|
}
|
|
break;
|
|
case 'N':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F2;
|
|
}
|
|
break;
|
|
case 'O':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F3;
|
|
}
|
|
break;
|
|
case 'Q':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F5;
|
|
}
|
|
break;
|
|
case 'R':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F6;
|
|
}
|
|
break;
|
|
case 'S':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F7;
|
|
}
|
|
break;
|
|
case 'T':
|
|
if (TerminalDevice->TerminalType == TerminalTypePcAnsi) {
|
|
Key.ScanCode = SCAN_F8;
|
|
}
|
|
break;
|
|
default :
|
|
break;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* The VT220 escape codes that the TTY terminal accepts all have
|
|
* numeric codes, and there are no ambiguous prefixes shared with
|
|
* other terminal types.
|
|
*/
|
|
if (TerminalDevice->TerminalType == TerminalTypeTtyTerm &&
|
|
Key.ScanCode == SCAN_NULL &&
|
|
UnicodeChar >= '0' &&
|
|
UnicodeChar <= '9') {
|
|
TerminalDevice->TtyEscapeStr[0] = UnicodeChar;
|
|
TerminalDevice->TtyEscapeIndex = 1;
|
|
TerminalDevice->InputState |= INPUT_STATE_LEFTOPENBRACKET_2;
|
|
continue;
|
|
}
|
|
|
|
if (Key.ScanCode != SCAN_NULL) {
|
|
Key.UnicodeChar = 0;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
TerminalDevice->InputState = INPUT_STATE_DEFAULT;
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
continue;
|
|
}
|
|
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
|
|
break;
|
|
|
|
|
|
case INPUT_STATE_ESC | INPUT_STATE_LEFTOPENBRACKET | INPUT_STATE_LEFTOPENBRACKET_2:
|
|
/*
|
|
* Here we handle the VT220 escape codes that we accept. This
|
|
* state is only used by the TTY terminal type.
|
|
*/
|
|
Key.ScanCode = SCAN_NULL;
|
|
if (TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
|
|
if (UnicodeChar == '~' && TerminalDevice->TtyEscapeIndex <= 2) {
|
|
UINT16 EscCode;
|
|
TerminalDevice->TtyEscapeStr[TerminalDevice->TtyEscapeIndex] = 0; /* Terminate string */
|
|
EscCode = (UINT16) StrDecimalToUintn(TerminalDevice->TtyEscapeStr);
|
|
switch (EscCode) {
|
|
case 2:
|
|
Key.ScanCode = SCAN_INSERT;
|
|
break;
|
|
case 3:
|
|
Key.ScanCode = SCAN_DELETE;
|
|
break;
|
|
case 5:
|
|
Key.ScanCode = SCAN_PAGE_UP;
|
|
break;
|
|
case 6:
|
|
Key.ScanCode = SCAN_PAGE_DOWN;
|
|
break;
|
|
case 11:
|
|
case 12:
|
|
case 13:
|
|
case 14:
|
|
case 15:
|
|
Key.ScanCode = SCAN_F1 + EscCode - 11;
|
|
break;
|
|
case 17:
|
|
case 18:
|
|
case 19:
|
|
case 20:
|
|
case 21:
|
|
Key.ScanCode = SCAN_F6 + EscCode - 17;
|
|
break;
|
|
case 23:
|
|
case 24:
|
|
Key.ScanCode = SCAN_F11 + EscCode - 23;
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
} else if (TerminalDevice->TtyEscapeIndex == 1){
|
|
/* 2 character escape code */
|
|
TerminalDevice->TtyEscapeStr[TerminalDevice->TtyEscapeIndex++] = UnicodeChar;
|
|
continue;
|
|
}
|
|
else {
|
|
DEBUG ((EFI_D_ERROR, "Unexpected state in escape2\n"));
|
|
}
|
|
}
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
|
|
if (Key.ScanCode != SCAN_NULL) {
|
|
Key.UnicodeChar = 0;
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
TerminalDevice->InputState = INPUT_STATE_DEFAULT;
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
continue;
|
|
}
|
|
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
break;
|
|
|
|
default:
|
|
//
|
|
// Invalid state. This should never happen.
|
|
//
|
|
ASSERT (FALSE);
|
|
|
|
UnicodeToEfiKeyFlushState (TerminalDevice);
|
|
|
|
break;
|
|
}
|
|
|
|
if (UnicodeChar == ESC) {
|
|
TerminalDevice->InputState = INPUT_STATE_ESC;
|
|
}
|
|
|
|
if (UnicodeChar == CSI) {
|
|
TerminalDevice->InputState = INPUT_STATE_CSI;
|
|
}
|
|
|
|
if (TerminalDevice->InputState != INPUT_STATE_DEFAULT) {
|
|
Status = gBS->SetTimer(
|
|
TerminalDevice->TwoSecondTimeOut,
|
|
TimerRelative,
|
|
(UINT64)20000000
|
|
);
|
|
ASSERT_EFI_ERROR (Status);
|
|
continue;
|
|
}
|
|
|
|
if (SetDefaultResetState) {
|
|
TerminalDevice->ResetState = RESET_STATE_DEFAULT;
|
|
}
|
|
|
|
if (UnicodeChar == DEL) {
|
|
if (TerminalDevice->TerminalType == TerminalTypeTtyTerm) {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = CHAR_BACKSPACE;
|
|
}
|
|
else {
|
|
Key.ScanCode = SCAN_DELETE;
|
|
Key.UnicodeChar = 0;
|
|
}
|
|
} else {
|
|
Key.ScanCode = SCAN_NULL;
|
|
Key.UnicodeChar = UnicodeChar;
|
|
}
|
|
|
|
EfiKeyFiFoInsertOneKey (TerminalDevice, &Key);
|
|
}
|
|
}
|