mirror of https://github.com/acidanthera/audk.git
1168 lines
35 KiB
C
1168 lines
35 KiB
C
/** @file
|
|
Header file for Terminal driver.
|
|
|
|
Copyright (c) 2006 - 2008, Intel Corporation. <BR>
|
|
All rights reserved. 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.
|
|
|
|
**/
|
|
|
|
#ifndef _TERMINAL_H_
|
|
#define _TERMINAL_H_
|
|
|
|
|
|
#include <PiDxe.h>
|
|
#include <Protocol/SimpleTextOut.h>
|
|
#include <Protocol/SerialIo.h>
|
|
#include <Guid/GlobalVariable.h>
|
|
#include <Protocol/DevicePath.h>
|
|
#include <Protocol/SimpleTextIn.h>
|
|
#include <Protocol/SimpleTextInEx.h>
|
|
#include <Guid/HotPlugDevice.h>
|
|
#include <Guid/PcAnsi.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/UefiDriverEntryPoint.h>
|
|
#include <Library/UefiLib.h>
|
|
#include <Library/ReportStatusCodeLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/MemoryAllocationLib.h>
|
|
#include <Library/UefiBootServicesTableLib.h>
|
|
#include <Library/UefiRuntimeServicesTableLib.h>
|
|
#include <Library/DevicePathLib.h>
|
|
#include <Library/PcdLib.h>
|
|
#include <Library/BaseLib.h>
|
|
|
|
|
|
#define RAW_FIFO_MAX_NUMBER 256
|
|
#define FIFO_MAX_NUMBER 128
|
|
|
|
typedef struct {
|
|
UINT8 Head;
|
|
UINT8 Tail;
|
|
UINT8 Data[RAW_FIFO_MAX_NUMBER + 1];
|
|
} RAW_DATA_FIFO;
|
|
|
|
typedef struct {
|
|
UINT8 Head;
|
|
UINT8 Tail;
|
|
UINT16 Data[FIFO_MAX_NUMBER + 1];
|
|
} UNICODE_FIFO;
|
|
|
|
typedef struct {
|
|
UINT8 Head;
|
|
UINT8 Tail;
|
|
EFI_INPUT_KEY Data[FIFO_MAX_NUMBER + 1];
|
|
} EFI_KEY_FIFO;
|
|
|
|
#define TERMINAL_DEV_SIGNATURE EFI_SIGNATURE_32 ('t', 'm', 'n', 'l')
|
|
|
|
#define TERMINAL_CONSOLE_IN_EX_NOTIFY_SIGNATURE EFI_SIGNATURE_32 ('t', 'm', 'e', 'n')
|
|
|
|
typedef struct _TERMINAL_CONSOLE_IN_EX_NOTIFY {
|
|
UINTN Signature;
|
|
EFI_HANDLE NotifyHandle;
|
|
EFI_KEY_DATA KeyData;
|
|
EFI_KEY_NOTIFY_FUNCTION KeyNotificationFn;
|
|
LIST_ENTRY NotifyEntry;
|
|
} TERMINAL_CONSOLE_IN_EX_NOTIFY;
|
|
typedef struct {
|
|
UINTN Signature;
|
|
EFI_HANDLE Handle;
|
|
UINT8 TerminalType;
|
|
EFI_SERIAL_IO_PROTOCOL *SerialIo;
|
|
EFI_DEVICE_PATH_PROTOCOL *DevicePath;
|
|
EFI_SIMPLE_TEXT_INPUT_PROTOCOL SimpleInput;
|
|
EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL SimpleTextOutput;
|
|
EFI_SIMPLE_TEXT_OUTPUT_MODE SimpleTextOutputMode;
|
|
UINTN SerialInTimeOut;
|
|
RAW_DATA_FIFO RawFiFo;
|
|
UNICODE_FIFO UnicodeFiFo;
|
|
EFI_KEY_FIFO EfiKeyFiFo;
|
|
EFI_UNICODE_STRING_TABLE *ControllerNameTable;
|
|
EFI_EVENT TwoSecondTimeOut;
|
|
UINT32 InputState;
|
|
UINT32 ResetState;
|
|
|
|
//
|
|
// Esc could not be output to the screen by user,
|
|
// but the terminal driver need to output it to
|
|
// the terminal emulation software to send control sequence.
|
|
// This boolean is used by the terminal driver only
|
|
// to indicate whether the Esc could be sent or not.
|
|
//
|
|
BOOLEAN OutputEscChar;
|
|
EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL SimpleInputEx;
|
|
LIST_ENTRY NotifyList;
|
|
} TERMINAL_DEV;
|
|
|
|
#define INPUT_STATE_DEFAULT 0x00
|
|
#define INPUT_STATE_ESC 0x01
|
|
#define INPUT_STATE_CSI 0x02
|
|
#define INPUT_STATE_LEFTOPENBRACKET 0x04
|
|
#define INPUT_STATE_O 0x08
|
|
#define INPUT_STATE_2 0x10
|
|
|
|
#define RESET_STATE_DEFAULT 0x00
|
|
#define RESET_STATE_ESC_R 0x01
|
|
#define RESET_STATE_ESC_R_ESC_r 0x02
|
|
|
|
#define TERMINAL_CON_IN_DEV_FROM_THIS(a) CR (a, TERMINAL_DEV, SimpleInput, TERMINAL_DEV_SIGNATURE)
|
|
#define TERMINAL_CON_OUT_DEV_FROM_THIS(a) CR (a, TERMINAL_DEV, SimpleTextOutput, TERMINAL_DEV_SIGNATURE)
|
|
#define TERMINAL_CON_IN_EX_DEV_FROM_THIS(a) CR (a, TERMINAL_DEV, SimpleInputEx, TERMINAL_DEV_SIGNATURE)
|
|
|
|
typedef union {
|
|
UINT8 Utf8_1;
|
|
UINT8 Utf8_2[2];
|
|
UINT8 Utf8_3[3];
|
|
} UTF8_CHAR;
|
|
|
|
#define PCANSITYPE 0
|
|
#define VT100TYPE 1
|
|
#define VT100PLUSTYPE 2
|
|
#define VTUTF8TYPE 3
|
|
|
|
#define LEFTOPENBRACKET 0x5b // '['
|
|
#define ACAP 0x41
|
|
#define BCAP 0x42
|
|
#define CCAP 0x43
|
|
#define DCAP 0x44
|
|
|
|
#define MODE0_COLUMN_COUNT 80
|
|
#define MODE0_ROW_COUNT 25
|
|
|
|
#define MODE1_COLUMN_COUNT 80
|
|
#define MODE1_ROW_COUNT 50
|
|
|
|
#define MODE2_COLUMN_COUNT 100
|
|
#define MODE2_ROW_COUNT 31
|
|
|
|
#define BACKSPACE 8
|
|
#define ESC 27
|
|
#define CSI 0x9B
|
|
#define DEL 127
|
|
#define BRIGHT_CONTROL_OFFSET 2
|
|
#define FOREGROUND_CONTROL_OFFSET 6
|
|
#define BACKGROUND_CONTROL_OFFSET 11
|
|
#define ROW_OFFSET 2
|
|
#define COLUMN_OFFSET 5
|
|
|
|
typedef struct {
|
|
UINT16 Unicode;
|
|
CHAR8 PcAnsi;
|
|
CHAR8 Ascii;
|
|
} UNICODE_TO_CHAR;
|
|
|
|
//
|
|
// Global Variables
|
|
//
|
|
extern EFI_DRIVER_BINDING_PROTOCOL gTerminalDriverBinding;
|
|
extern EFI_COMPONENT_NAME_PROTOCOL gTerminalComponentName;
|
|
extern EFI_COMPONENT_NAME2_PROTOCOL gTerminalComponentName2;
|
|
|
|
extern EFI_GUID gSimpleTextInExNotifyGuid;
|
|
|
|
/**
|
|
The user Entry Point for module Terminal. The user code starts with this function.
|
|
|
|
@param[in] ImageHandle The firmware allocated handle for the EFI image.
|
|
@param[in] SystemTable A pointer to the EFI System Table.
|
|
|
|
@retval EFI_SUCCESS The entry point is executed successfully.
|
|
@retval other Some error occurs when executing this entry point.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
InitializeTerminal (
|
|
IN EFI_HANDLE ImageHandle,
|
|
IN EFI_SYSTEM_TABLE *SystemTable
|
|
)
|
|
;
|
|
|
|
/**
|
|
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.
|
|
|
|
@return EFI_SUCCESS
|
|
@return The reset operation succeeds.
|
|
@return EFI_DEVICE_ERROR
|
|
@return The dependent serial port reset fails.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInReset (
|
|
IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
|
|
IN BOOLEAN ExtendedVerification
|
|
)
|
|
;
|
|
|
|
|
|
/**
|
|
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.
|
|
|
|
@return EFI_SUCCESS
|
|
@return The keystroke information is returned successfully.
|
|
@return EFI_NOT_READY
|
|
@return There is no keystroke data available.
|
|
@return EFI_DEVICE_ERROR
|
|
@return The dependent serial device encounters error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInReadKeyStroke (
|
|
IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This,
|
|
OUT EFI_INPUT_KEY *Key
|
|
)
|
|
;
|
|
|
|
|
|
/**
|
|
|
|
@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 FLASE Match failed.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsKeyRegistered (
|
|
IN EFI_KEY_DATA *RegsiteredData,
|
|
IN EFI_KEY_DATA *InputData
|
|
)
|
|
;
|
|
|
|
/**
|
|
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.
|
|
|
|
@return none.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
TerminalConInWaitForKeyEx (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
;
|
|
|
|
//
|
|
// Simple Text Input Ex protocol prototypes
|
|
//
|
|
|
|
/**
|
|
Reset the input device and optionaly 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
|
|
)
|
|
;
|
|
|
|
/**
|
|
Reads the next keystroke from the input device. The WaitForKey Event can
|
|
be used to test for existance 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 availiable.
|
|
@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
|
|
)
|
|
;
|
|
|
|
/**
|
|
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
|
|
)
|
|
;
|
|
|
|
/**
|
|
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 data for the key that was
|
|
pressed.
|
|
@param KeyNotificationFunction Points to the function to be called when the key
|
|
sequence is typed specified by KeyData.
|
|
@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 necesssary 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 EFI_HANDLE *NotifyHandle
|
|
)
|
|
;
|
|
|
|
/**
|
|
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.
|
|
@retval EFI_NOT_FOUND Can not find the matching entry in database.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConInUnregisterKeyNotify (
|
|
IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,
|
|
IN EFI_HANDLE NotificationHandle
|
|
)
|
|
;
|
|
|
|
/**
|
|
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.
|
|
|
|
@return None
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
TerminalConInWaitForKey (
|
|
IN EFI_EVENT Event,
|
|
IN VOID *Context
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.Reset().
|
|
If ExtendeVerification is TRUE, then perform dependent serial device reset,
|
|
and set display mode to mode 0.
|
|
If ExtendedVerification is FALSE, only set display mode to mode 0.
|
|
|
|
@param This Indicates the calling context.
|
|
@param ExtendedVerification Indicates that the driver may perform a more
|
|
exhaustive verification operation of the device
|
|
during reset.
|
|
|
|
@return EFI_SUCCESS
|
|
@return The reset operation succeeds.
|
|
@return EFI_DEVICE_ERROR
|
|
@return The terminal is not functioning correctly or the serial port reset fails.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutReset (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN BOOLEAN ExtendedVerification
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.OutputString().
|
|
The Unicode string will be converted to terminal expressible data stream
|
|
and send to terminal via serial port.
|
|
|
|
@param This Indicates the calling context.
|
|
@param WString The Null-terminated Unicode string to be displayed
|
|
on the terminal screen.
|
|
|
|
@return EFI_SUCCESS The string is output successfully.
|
|
@return EFI_DEVICE_ERROR The serial port fails to send the string out.
|
|
@return EFI_WARN_UNKNOWN_GLYPH Indicates that some of the characters in the Unicode string could not
|
|
be rendered and are skipped.
|
|
@return EFI_UNSUPPORTED
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutOutputString (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN CHAR16 *WString
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.TestString().
|
|
If one of the characters in the *Wstring is
|
|
neither valid Unicode drawing characters,
|
|
not ASCII code, then this function will return
|
|
EFI_UNSUPPORTED.
|
|
|
|
@param This Indicates the calling context.
|
|
@param WString The Null-terminated Unicode string to be tested.
|
|
|
|
@return EFI_SUCCESS The terminal is capable of rendering the output string.
|
|
@return EFI_UNSUPPORTED Some of the characters in the Unicode string cannot be rendered.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutTestString (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN CHAR16 *WString
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.QueryMode().
|
|
It returns information for an available text mode
|
|
that the terminal supports.
|
|
In this driver, we support text mode 80x25 (mode 0),
|
|
80x50 (mode 1), 100x31 (mode 2).
|
|
|
|
@param This Indicates the calling context.
|
|
@param ModeNumber The mode number to return information on.
|
|
@param Columns The returned columns of the requested mode.
|
|
@param Rows The returned rows of the requested mode.
|
|
|
|
@return EFI_SUCCESS The requested mode information is returned.
|
|
@return EFI_UNSUPPORTED The mode number is not valid.
|
|
@return EFI_DEVICE_ERROR
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutQueryMode (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN UINTN ModeNumber,
|
|
OUT UINTN *Columns,
|
|
OUT UINTN *Rows
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUT.SetMode().
|
|
Set the terminal to a specified display mode.
|
|
In this driver, we only support mode 0.
|
|
|
|
@param This Indicates the calling context.
|
|
@param ModeNumber The text mode to set.
|
|
|
|
@return EFI_SUCCESS The requested text mode is set.
|
|
@return EFI_DEVICE_ERROR The requested text mode cannot be set
|
|
because of serial device error.
|
|
@return EFI_UNSUPPORTED The text mode number is not valid.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutSetMode (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN UINTN ModeNumber
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetAttribute().
|
|
|
|
@param This Indicates the calling context.
|
|
@param Attribute The attribute to set. Only bit0..6 are valid, all other bits
|
|
are undefined and must be zero.
|
|
|
|
@return EFI_SUCCESS The requested attribute is set.
|
|
@return EFI_DEVICE_ERROR The requested attribute cannot be set due to serial port error.
|
|
@return EFI_UNSUPPORTED The attribute requested is not defined by EFI spec.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutSetAttribute (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN UINTN Attribute
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.ClearScreen().
|
|
It clears the ANSI terminal's display to the
|
|
currently selected background color.
|
|
|
|
@param This Indicates the calling context.
|
|
|
|
@return EFI_SUCCESS The operation completed successfully.
|
|
@return EFI_DEVICE_ERROR The terminal screen cannot be cleared due to serial port error.
|
|
@return EFI_UNSUPPORTED The terminal is not in a valid display mode.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutClearScreen (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.SetCursorPosition().
|
|
|
|
@param This Indicates the calling context.
|
|
@param Column The row to set cursor to.
|
|
@param Row The column to set cursor to.
|
|
|
|
@return EFI_SUCCESS The operation completed successfully.
|
|
@return EFI_DEVICE_ERROR The request fails due to serial port error.
|
|
@return EFI_UNSUPPORTED The terminal is not in a valid text mode, or the cursor position
|
|
is invalid for current mode.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutSetCursorPosition (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN UINTN Column,
|
|
IN UINTN Row
|
|
)
|
|
;
|
|
|
|
/**
|
|
Implements SIMPLE_TEXT_OUTPUT.EnableCursor().
|
|
In this driver, the cursor cannot be hidden.
|
|
|
|
@param This Indicates the calling context.
|
|
@param Visible If TRUE, the cursor is set to be visible,
|
|
If FALSE, the cursor is set to be invisible.
|
|
|
|
@return EFI_SUCCESS The request is valid.
|
|
@return EFI_UNSUPPORTED The terminal does not support cursor hidden.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalConOutEnableCursor (
|
|
IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *This,
|
|
IN BOOLEAN Visible
|
|
)
|
|
;
|
|
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalDriverBindingSupported (
|
|
IN EFI_DRIVER_BINDING_PROTOCOL *This,
|
|
IN EFI_HANDLE Controller,
|
|
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
|
|
);
|
|
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalDriverBindingStart (
|
|
IN EFI_DRIVER_BINDING_PROTOCOL *This,
|
|
IN EFI_HANDLE Controller,
|
|
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
|
|
);
|
|
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalDriverBindingStop (
|
|
IN EFI_DRIVER_BINDING_PROTOCOL *This,
|
|
IN EFI_HANDLE Controller,
|
|
IN UINTN NumberOfChildren,
|
|
IN EFI_HANDLE *ChildHandleBuffer
|
|
);
|
|
|
|
/**
|
|
Retrieves a Unicode string that is the user readable name of the driver.
|
|
|
|
This function retrieves the user readable name of a driver in the form of a
|
|
Unicode string. If the driver specified by This has a user readable name in
|
|
the language specified by Language, then a pointer to the driver name is
|
|
returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
|
|
by This does not support the language specified by Language,
|
|
then EFI_UNSUPPORTED is returned.
|
|
|
|
@param This[in] A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
|
|
EFI_COMPONENT_NAME_PROTOCOL instance.
|
|
|
|
@param Language[in] A pointer to a Null-terminated ASCII string
|
|
array indicating the language. This is the
|
|
language of the driver name that the caller is
|
|
requesting, and it must match one of the
|
|
languages specified in SupportedLanguages. The
|
|
number of languages supported by a driver is up
|
|
to the driver writer. Language is specified
|
|
in RFC 3066 or ISO 639-2 language code format.
|
|
|
|
@param DriverName[out] A pointer to the Unicode string to return.
|
|
This Unicode string is the name of the
|
|
driver specified by This in the language
|
|
specified by Language.
|
|
|
|
@retval EFI_SUCCESS The Unicode string for the Driver specified by
|
|
This and the language specified by Language was
|
|
returned in DriverName.
|
|
|
|
@retval EFI_INVALID_PARAMETER Language is NULL.
|
|
|
|
@retval EFI_INVALID_PARAMETER DriverName is NULL.
|
|
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support
|
|
the language specified by Language.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalComponentNameGetDriverName (
|
|
IN EFI_COMPONENT_NAME_PROTOCOL *This,
|
|
IN CHAR8 *Language,
|
|
OUT CHAR16 **DriverName
|
|
);
|
|
|
|
|
|
/**
|
|
Retrieves a Unicode string that is the user readable name of the controller
|
|
that is being managed by a driver.
|
|
|
|
This function retrieves the user readable name of the controller specified by
|
|
ControllerHandle and ChildHandle in the form of a Unicode string. If the
|
|
driver specified by This has a user readable name in the language specified by
|
|
Language, then a pointer to the controller name is returned in ControllerName,
|
|
and EFI_SUCCESS is returned. If the driver specified by This is not currently
|
|
managing the controller specified by ControllerHandle and ChildHandle,
|
|
then EFI_UNSUPPORTED is returned. If the driver specified by This does not
|
|
support the language specified by Language, then EFI_UNSUPPORTED is returned.
|
|
|
|
@param This[in] A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
|
|
EFI_COMPONENT_NAME_PROTOCOL instance.
|
|
|
|
@param ControllerHandle[in] The handle of a controller that the driver
|
|
specified by This is managing. This handle
|
|
specifies the controller whose name is to be
|
|
returned.
|
|
|
|
@param ChildHandle[in] The handle of the child controller to retrieve
|
|
the name of. This is an optional parameter that
|
|
may be NULL. It will be NULL for device
|
|
drivers. It will also be NULL for a bus drivers
|
|
that wish to retrieve the name of the bus
|
|
controller. It will not be NULL for a bus
|
|
driver that wishes to retrieve the name of a
|
|
child controller.
|
|
|
|
@param Language[in] A pointer to a Null-terminated ASCII string
|
|
array indicating the language. This is the
|
|
language of the driver name that the caller is
|
|
requesting, and it must match one of the
|
|
languages specified in SupportedLanguages. The
|
|
number of languages supported by a driver is up
|
|
to the driver writer. Language is specified in
|
|
RFC 3066 or ISO 639-2 language code format.
|
|
|
|
@param ControllerName[out] A pointer to the Unicode string to return.
|
|
This Unicode string is the name of the
|
|
controller specified by ControllerHandle and
|
|
ChildHandle in the language specified by
|
|
Language from the point of view of the driver
|
|
specified by This.
|
|
|
|
@retval EFI_SUCCESS The Unicode string for the user readable name in
|
|
the language specified by Language for the
|
|
driver specified by This was returned in
|
|
DriverName.
|
|
|
|
@retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.
|
|
|
|
@retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
|
|
EFI_HANDLE.
|
|
|
|
@retval EFI_INVALID_PARAMETER Language is NULL.
|
|
|
|
@retval EFI_INVALID_PARAMETER ControllerName is NULL.
|
|
|
|
@retval EFI_UNSUPPORTED The driver specified by This is not currently
|
|
managing the controller specified by
|
|
ControllerHandle and ChildHandle.
|
|
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support
|
|
the language specified by Language.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
TerminalComponentNameGetControllerName (
|
|
IN EFI_COMPONENT_NAME_PROTOCOL *This,
|
|
IN EFI_HANDLE ControllerHandle,
|
|
IN EFI_HANDLE ChildHandle OPTIONAL,
|
|
IN CHAR8 *Language,
|
|
OUT CHAR16 **ControllerName
|
|
);
|
|
|
|
|
|
//
|
|
// internal functions
|
|
//
|
|
|
|
/**
|
|
Check for a pending key in the Efi Key FIFO or Serial device buffer.
|
|
|
|
@param This Indicates the calling context.
|
|
|
|
@return EFI_SUCCESS
|
|
@return There is key pending.
|
|
@return EFI_NOT_READY
|
|
@return There is no key pending.
|
|
@return EFI_DEVICE_ERROR
|
|
|
|
**/
|
|
EFI_STATUS
|
|
TerminalConInCheckForKey (
|
|
IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL *This
|
|
)
|
|
;
|
|
|
|
VOID
|
|
TerminalUpdateConsoleDevVariable (
|
|
IN CHAR16 *VariableName,
|
|
IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath
|
|
)
|
|
;
|
|
|
|
/**
|
|
Remove console device variable.
|
|
|
|
@param VariableName A pointer to the variable name.
|
|
@param ParentDevicePath A pointer to the parent device path.
|
|
|
|
@return None.
|
|
|
|
**/
|
|
VOID
|
|
TerminalRemoveConsoleDevVariable (
|
|
IN CHAR16 *VariableName,
|
|
IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath
|
|
)
|
|
;
|
|
|
|
/**
|
|
Read the EFI variable (VendorGuid/Name) and return a dynamically allocated
|
|
buffer, and the size of the buffer. On failure return NULL.
|
|
|
|
@param Name String part of EFI variable name
|
|
@param VendorGuid GUID part of EFI variable name
|
|
@param VariableSize Returns the size of the EFI variable that was read
|
|
|
|
@return Dynamically allocated memory that contains a copy of the EFI variable.
|
|
@return Caller is repsoncible freeing the buffer.
|
|
@retval NULL Variable was not read
|
|
|
|
**/
|
|
VOID *
|
|
TerminalGetVariableAndSize (
|
|
IN CHAR16 *Name,
|
|
IN EFI_GUID *VendorGuid,
|
|
OUT UINTN *VariableSize
|
|
)
|
|
;
|
|
|
|
EFI_STATUS
|
|
SetTerminalDevicePath (
|
|
IN UINT8 TerminalType,
|
|
IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath,
|
|
OUT EFI_DEVICE_PATH_PROTOCOL **TerminalDevicePath
|
|
)
|
|
;
|
|
|
|
VOID
|
|
InitializeRawFiFo (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
VOID
|
|
InitializeUnicodeFiFo (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
VOID
|
|
InitializeEfiKeyFiFo (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Get one key out of serial buffer.
|
|
|
|
@param SerialIo Serial I/O protocl attached to the serial device.
|
|
@param Input The fetched key.
|
|
|
|
@return EFI_NOT_READY If serial buffer is empty.
|
|
@return EFI_DEVICE_ERROR If reading serial buffer encounter error.
|
|
@return EFI_SUCCESS If reading serial buffer successfully, put
|
|
the fetched key to the parameter output.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
GetOneKeyFromSerial (
|
|
EFI_SERIAL_IO_PROTOCOL *SerialIo,
|
|
UINT8 *Input
|
|
)
|
|
;
|
|
|
|
/**
|
|
Insert one byte raw data into the Raw Data FIFO.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Input The key will be input.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If Raw Data buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
RawFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT8 Input
|
|
)
|
|
;
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the Raw Data FIFO.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If Raw Data FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
RawFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT8 *Output
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether Raw Data FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If Raw Data FIFO buffer is empty.
|
|
@return FLASE If Raw Data FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsRawFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether Raw Data FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If Raw Data FIFO buffer is full.
|
|
@return FLASE If Raw Data FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsRawFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Insert one pre-fetched key into the FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Key The key will be input.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If FIFO buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
EFI_INPUT_KEY Key
|
|
)
|
|
;
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EfiKeyFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
EFI_INPUT_KEY *Output
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If FIFO buffer is empty.
|
|
@return FLASE If FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If FIFO buffer is full.
|
|
@return FLASE If FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsEfiKeyFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Insert one pre-fetched key into the Unicode FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Input The key will be input.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If Unicode FIFO buffer is full before key insertion,
|
|
and the key is lost.
|
|
|
|
**/
|
|
BOOLEAN
|
|
UnicodeFiFoInsertOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT16 Input
|
|
)
|
|
;
|
|
|
|
/**
|
|
Remove one pre-fetched key out of the Unicode FIFO buffer.
|
|
|
|
@param TerminalDevice Terminal driver private structure.
|
|
@param Output The key will be removed.
|
|
|
|
@return TRUE If insert successfully.
|
|
@return FLASE If Unicode FIFO buffer is empty before remove operation.
|
|
|
|
**/
|
|
BOOLEAN
|
|
UnicodeFiFoRemoveOneKey (
|
|
TERMINAL_DEV *TerminalDevice,
|
|
UINT16 *Output
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether Unicode FIFO buffer is empty.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If Unicode FIFO buffer is empty.
|
|
@return FLASE If Unicode FIFO buffer is not empty.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsUnicodeFiFoEmpty (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
/**
|
|
Clarify whether Unicode FIFO buffer is full.
|
|
|
|
@param TerminalDevice Terminal driver private structure
|
|
|
|
@return TRUE If Unicode FIFO buffer is full.
|
|
@return FLASE If Unicode FIFO buffer is not full.
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsUnicodeFiFoFull (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
UINT8
|
|
UnicodeFiFoGetKeyCount (
|
|
TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
VOID
|
|
TranslateRawDataToEfiKey (
|
|
IN TERMINAL_DEV *TerminalDevice
|
|
)
|
|
;
|
|
|
|
//
|
|
// internal functions for PC ANSI
|
|
//
|
|
VOID
|
|
AnsiRawDataToUnicode (
|
|
IN TERMINAL_DEV *PcAnsiDevice
|
|
)
|
|
;
|
|
|
|
VOID
|
|
UnicodeToEfiKey (
|
|
IN TERMINAL_DEV *PcAnsiDevice
|
|
)
|
|
;
|
|
|
|
EFI_STATUS
|
|
AnsiTestString (
|
|
IN TERMINAL_DEV *TerminalDevice,
|
|
IN CHAR16 *WString
|
|
)
|
|
;
|
|
|
|
//
|
|
// internal functions for VTUTF8
|
|
//
|
|
VOID
|
|
VTUTF8RawDataToUnicode (
|
|
IN TERMINAL_DEV *VtUtf8Device
|
|
)
|
|
;
|
|
|
|
EFI_STATUS
|
|
VTUTF8TestString (
|
|
IN TERMINAL_DEV *TerminalDevice,
|
|
IN CHAR16 *WString
|
|
)
|
|
;
|
|
|
|
VOID
|
|
UnicodeToUtf8 (
|
|
IN CHAR16 Unicode,
|
|
OUT UTF8_CHAR *Utf8Char,
|
|
OUT UINT8 *ValidBytes
|
|
)
|
|
;
|
|
|
|
VOID
|
|
GetOneValidUtf8Char (
|
|
IN TERMINAL_DEV *Utf8Device,
|
|
OUT UTF8_CHAR *Utf8Char,
|
|
OUT UINT8 *ValidBytes
|
|
)
|
|
;
|
|
|
|
VOID
|
|
Utf8ToUnicode (
|
|
IN UTF8_CHAR Utf8Char,
|
|
IN UINT8 ValidBytes,
|
|
OUT CHAR16 *UnicodeChar
|
|
)
|
|
;
|
|
|
|
//
|
|
// functions for boxdraw unicode
|
|
//
|
|
BOOLEAN
|
|
TerminalIsValidTextGraphics (
|
|
IN CHAR16 Graphic,
|
|
OUT CHAR8 *PcAnsi, OPTIONAL
|
|
OUT CHAR8 *Ascii OPTIONAL
|
|
)
|
|
;
|
|
|
|
BOOLEAN
|
|
TerminalIsValidAscii (
|
|
IN CHAR16 Ascii
|
|
)
|
|
;
|
|
|
|
BOOLEAN
|
|
TerminalIsValidEfiCntlChar (
|
|
IN CHAR16 CharC
|
|
)
|
|
;
|
|
|
|
#endif
|