/** @file
"Terminal" Control functions for Interactive IO.
Copyright (c) 2012, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at
http://opensource.org/licenses/bsd-license.
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
#include
#include
#include
#include
#include
#include
/** Get input baud rate.
Extracts the input baud rate from the termios structure pointed to by the
pTermios argument.
@param[in] pTermios A pointer to the termios structure from which to extract
the input baud rate.
@return The value of the input speed is returned exactly as it is contained
in the termios structure, without interpretation.
**/
speed_t
cfgetispeed (
const struct termios *pTermios
)
{
return pTermios->c_ispeed;
}
/** Get output baud rate.
Extracts the output baud rate from the termios structure pointed to by the
pTermios argument.
@param[in] pTermios A pointer to the termios structure from which to extract
the output baud rate.
@return The value of the output speed is returned exactly as it is contained
in the termios structure, without interpretation.
**/
speed_t
cfgetospeed (
const struct termios *pTermios
)
{
return pTermios->c_ospeed;
}
/** Set input baud rate.
Replaces the input baud rate, in the termios structure pointed to by the
pTermios argument, with the value of NewSpeed.
@param[out] pTermios A pointer to the termios structure into which to set
the input baud rate.
@param[in] NewSpeed The new input baud rate.
@retval 0 The operation completed successfully.
@retval -1 An error occured and errno is set to indicate the error.
* EINVAL - The value of NewSpeed is outside the range of
possible speed values as specified in .
**/
int
cfsetispeed (
struct termios *pTermios,
speed_t NewSpeed
)
{
int RetVal;
if(NewSpeed < B921600) {
pTermios->c_ispeed = NewSpeed;
RetVal = 0;
}
else {
RetVal = -1;
errno = EINVAL;
}
return RetVal;
}
/** Set output baud rate.
Replaces the output baud rate, in the termios structure pointed to by the
pTermios argument, with the value of NewSpeed.
@param[out] pTermios A pointer to the termios structure into which to set
the output baud rate.
@param[in] NewSpeed The new output baud rate.
@retval 0 The operation completed successfully.
@retval -1 An error occured and errno is set to indicate the error.
* EINVAL - The value of NewSpeed is outside the range of
possible speed values as specified in .
**/
int
cfsetospeed (
struct termios *pTermios,
speed_t NewSpeed
)
{
int RetVal;
if(NewSpeed < B921600) {
pTermios->c_ospeed = NewSpeed;
RetVal = 0;
}
else {
RetVal = -1;
errno = EINVAL;
}
return RetVal;
}
/** Get the parameters associated with an interactive IO device.
Get the parameters associated with the device referred to by
fd and store them into the termios structure referenced by pTermios.
@param[in] fd The file descriptor for an open interactive IO device.
@param[out] pTermios A pointer to a termios structure into which to store
attributes of the interactive IO device.
@retval 0 The operation completed successfully.
@retval -1 An error occured and errno is set to indicate the error.
* EBADF - The fd argument is not a valid file descriptor.
* ENOTTY - The file associated with fd is not an interactive IO device.
**/
int
tcgetattr (
int fd,
struct termios *pTermios
)
{
cIIO *IIO;
int RetVal;
struct __filedes *filp;
struct termios *Termio;
RetVal = 0;
if(ValidateFD( fd, VALID_OPEN)) {
filp = &gMD->fdarray[fd];
if((filp->f_iflags & _S_ITTY) != 0) {
// fd is for a TTY or "Interactive IO" device
IIO = (cIIO *)filp->devdata;
Termio = &IIO->Termio;
(void)CopyMem((void *)pTermios, (const void *)Termio, sizeof(struct termios));
}
else {
errno = ENOTTY;
RetVal = -1;
}
}
else {
errno = EBADF;
RetVal = -1;
}
return RetVal;
}
/** Set the parameters associated with an interactive IO device.
Set the parameters associated with the device referred to by
fd to the values in the termios structure referenced by pTermios.
Behavior is modified by the value of the OptAct parameter:
* TCSANOW: The change shall occur immediately.
* TCSADRAIN: The change shall occur after all output written to fd is
transmitted. This action should be used when changing parameters which
affect output.
* TCSAFLUSH: The change shall occur after all output written to fd is
transmitted, and all input so far received but not read shall be
discarded before the change is made.
@param[in] fd The file descriptor for an open interactive IO device.
@param[in] OptAct Currently has no effect.
@param[in] pTermios A pointer to a termios structure into which to retrieve
attributes to set in the interactive IO device.
@retval 0 The operation completed successfully.
@retval -1 An error occured and errno is set to indicate the error.
* EBADF - The fd argument is not a valid file descriptor.
* ENOTTY - The file associated with fd is not an interactive IO device.
**/
int
tcsetattr (
int fd,
int OptAct, // Currently ignored
const struct termios *pTermios
)
{
cIIO *IIO;
int RetVal;
struct __filedes *filp;
struct termios *Termio;
RetVal = 0;
if(ValidateFD( fd, VALID_OPEN)) {
filp = &gMD->fdarray[fd];
if((filp->f_iflags & _S_ITTY) != 0) {
// fd is for a TTY or "Interactive IO" device
IIO = (cIIO *)filp->devdata;
Termio = &IIO->Termio;
(void)CopyMem((void *)Termio, (const void *)pTermios, sizeof(struct termios));
}
else {
errno = ENOTTY;
RetVal = -1;
}
}
else {
errno = EBADF;
RetVal = -1;
}
return RetVal;
}
/** Transmit pending output.
Function is not yet implemented for UEFI.
@param[in] fd Ignored
@retval -1 This function is not yet supported. errno is set to ENOTSUP.
**/
int
tcdrain (int fd)
{
errno = ENOTSUP;
return -1;
}
/** Suspend or restart the transmission or reception of data.
This function will suspend or resume transmission or reception of data on
the file referred to by fd, depending on the value of Action.
Function is not yet implemented for UEFI.
@param[in] fd Ignored
@param[in] Action Ignored
@retval -1 This function is not yet supported. errno is set to ENOTSUP.
**/
int
tcflow (
int fd,
int Action)
{
errno = ENOTSUP;
return -1;
}
/** Discard non-transmitted output data, non-read input data, or both.
Function is not yet implemented for UEFI.
@param[in] fd Ignored
@param[in] QueueSelector Ignored
@retval -1 This function is not yet supported. errno is set to ENOTSUP.
**/
int
tcflush (
int fd,
int QueueSelector)
{
errno = ENOTSUP;
return -1;
}