324 lines
14 KiB
C
324 lines
14 KiB
C
/****************************************************************************
|
|
* include/termios.h
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __INCLUDE_TERMIOS_H
|
|
#define __INCLUDE_TERMIOS_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
#include <sys/types.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef CONFIG_SERIAL_TERMIOS
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* Terminal input modes (c_iflag in the termios structure) */
|
|
|
|
#define IGNBRK (1 << 0) /* Bit 0: Ignore break condition */
|
|
#define BRKINT (1 << 1) /* Bit 1: Signal interrupt on break */
|
|
#define IGNPAR (1 << 2) /* Bit 2: Ignore characters with parity errors */
|
|
#define PARMRK (1 << 3) /* Bit 3: Mark parity errors */
|
|
#define INPCK (1 << 4) /* Bit 4: Enable input parity check */
|
|
#define ISTRIP (1 << 5) /* Bit 5: Strip character */
|
|
#define INLCR (1 << 6) /* Bit 6: Map NL to CR on input */
|
|
#define IGNCR (1 << 7) /* Bit 7: Ignore CR */
|
|
#define ICRNL (1 << 8) /* Bit 8: Map CR to NL on input */
|
|
#define IUCLC (1 << 9) /* Bit 9: Map upper-case to lower-case on input (LEGACY) */
|
|
#define IXON (1 << 10) /* Bit 10: Enable start/stop output control */
|
|
#define IXANY (1 << 11) /* Bit 11: Enable any character to restart output */
|
|
#define IXOFF (1 << 12) /* Bit 12: Enable start/stop input control */
|
|
|
|
/* Terminal output modes (c_oflag in the termios structure) */
|
|
|
|
#define OPOST (1 << 0) /* Bit 0: Post-process output */
|
|
#define OLCUC (1 << 1) /* Bit 1: Map lower-case to upper-case on output (LEGACY) */
|
|
#define ONLCR (1 << 2) /* Bit 2: Map NL to CR-NL on output */
|
|
#define OCRNL (1 << 3) /* Bit 3: Map CR to NL on output */
|
|
#define ONOCR (1 << 4) /* Bit 4: No CR output at column 0 */
|
|
#define ONLRET (1 << 5) /* Bit 5: NL performs CR function */
|
|
#define OFILL (1 << 6) /* Bit 6: Use fill characters for delay */
|
|
#define NLDLY (1 << 8) /* Bit 8: Select newline delays: */
|
|
# define NL0 (0 << 8) /* Newline character type 0 */
|
|
# define NL1 (1 << 8) /* Newline character type 1 */
|
|
#define CRDLY (3 << 9) /* Bits 9-10: Select carriage-return delays: */
|
|
# define CR0 (0 << 9) /* Carriage-return delay type 0 */
|
|
# define CR1 (1 << 9) /* Carriage-return delay type 1 */
|
|
# define CR2 (2 << 9) /* Carriage-return delay type 2 */
|
|
# define CR3 (3 << 9) /* Carriage-return delay type 3 */
|
|
#define TABDLY (3 << 11) /* Bits 11-12: Select horizontal-tab delays: */
|
|
# define TAB0 (0 << 11) /* Horizontal-tab delay type 0 */
|
|
# define TAB1 (1 << 11) /* Horizontal-tab delay type 1 */
|
|
# define TAB2 (2 << 11) /* Horizontal-tab delay type 2 */
|
|
# define TAB3 (3 << 11) /* Expand tabs to spaces */
|
|
#define BSDLY (1 << 13) /* Bit 13: Select backspace delays: */
|
|
# define BS0 (0 << 13) /* Backspace-delay type 0 */
|
|
# define BS1 (1 << 13) /* Backspace-delay type 1 */
|
|
#define VTDLY (1 << 14) /* Bit 14: Select vertical-tab delays: */
|
|
# define VT0 (0 << 14) /* Vertical-tab delay type 0 */
|
|
# define VT1 (1 << 14) /* Vertical-tab delay type 1 */
|
|
#define FFDLY (1 << 15) /* Bit 15: Select form-feed delays: */
|
|
# define FF0 (0 << 15) /* Form-feed delay type 0 */
|
|
# define FF1 (1 << 15) /* Form-feed delay type 1 */
|
|
|
|
/* Control Modes (c_cflag in the termios structure) */
|
|
|
|
#define CSIZE (3 << 4) /* Bits 4-5: Character size: */
|
|
# define CS5 (0 << 4) /* 5 bits */
|
|
# define CS6 (1 << 4) /* 6 bits */
|
|
# define CS7 (2 << 4) /* 7 bits */
|
|
# define CS8 (3 << 4) /* 8 bits */
|
|
#define CSTOPB (1 << 6) /* Bit 6: Send two stop bits, else one */
|
|
#define CREAD (1 << 7) /* Bit 7: Enable receiver */
|
|
#define PARENB (1 << 8) /* Bit 8: Parity enable */
|
|
#define PARODD (1 << 9) /* Bit 9: Odd parity, else even */
|
|
#define HUPCL (1 << 10) /* Bit 10: Hang up on last close */
|
|
#define CLOCAL (1 << 11) /* Bit 11: Ignore modem status lines */
|
|
#define CCTS_OFLOW (1 << 29) /* Bit 29: CTS flow control of output */
|
|
#define CRTS_IFLOW (1u << 31) /* Bit 31: RTS flow control of input */
|
|
#define CRTSCTS (CCTS_OFLOW | CRTS_IFLOW)
|
|
|
|
/* Local Modes (c_lflag in the termios structure) */
|
|
|
|
#define ISIG (1 << 0) /* Bit 0: Enable signals */
|
|
#define ICANON (1 << 1) /* Bit 1: Canonical input (erase and kill processing) */
|
|
#define XCASE (1 << 2) /* Bit 2: Canonical upper/lower presentation (LEGACY) */
|
|
#define ECHO (1 << 3) /* Bit 3: Enable echo */
|
|
#define ECHOE (1 << 4) /* Bit 4: Echo erase character as error correcting backspace */
|
|
#define ECHOK (1 << 5) /* Bit 5: Echo KILL */
|
|
#define ECHONL (1 << 6) /* Bit 6: Echo NL */
|
|
#define NOFLSH (1 << 7) /* Bit 7: Disable flush after interrupt or quit */
|
|
#define TOSTOP (1 << 8) /* Bit 8: Send SIGTTOU for background output */
|
|
#define IEXTEN (1 << 15) /* Bit 15: Enable extended input character processing */
|
|
|
|
/* The following are subscript names for the termios c_cc array.
|
|
*
|
|
* Common characters: VINTR, VQUIT, VSTART, VSTOP, VSUSP
|
|
*
|
|
* VINTR: Interrupt character (Default ETX, Control-C)
|
|
* VQUIT: Quit character (Default FS, Control-\)
|
|
* VSTART: Start character (Default DC1, Control-Q)
|
|
* VSTOP: Stop character (Default DC3, Control-S)
|
|
* VSUSP: Suspend character (Default SUB, Control-Z)
|
|
*
|
|
* Canonical mode: Adds VEOF, VEOL, VERASE, VKILL
|
|
*
|
|
* VEOL: End-of-file character (Default SUB, Control-Z)
|
|
* VEOF: End-of-line character (Default NUL)
|
|
* VERASE: Erase character (Default DEL or BS, Control-H)
|
|
* VKILL: Kill character (Default NAK or BS, Control-U)
|
|
*
|
|
* Non-canonical mode: Adds VMIN, VTIME
|
|
*
|
|
* VMIN: Minimum number of characters for non-canonical read
|
|
* VTIME: Timeout in deciseconds for non-canonical read
|
|
*/
|
|
|
|
#define VINTR 0 /* Bit 0: INTR character */
|
|
#define VQUIT 1 /* Bit 1: QUIT character */
|
|
#define VERASE 2 /* Bit 2: ERASE character (canonical mode) */
|
|
#define VKILL 3 /* Bit 3: KILL character (canonical mode) */
|
|
#define VEOF 4 /* Bit 4: EOF character (canonical mode) */
|
|
#define VTIME 5 /* Bit 5: TIME value (non-canonical mode) */
|
|
#define VMIN 6 /* Bit 6: MIN value (non-canonical mode) */
|
|
#define VSTART 8 /* Bit 8: START character */
|
|
#define VSTOP 9 /* Bit 9: STOP character */
|
|
#define VSUSP 10 /* Bit 10: SUSP character */
|
|
#define VEOL 11 /* Bit 11: EOL character (canonical mode) */
|
|
#define NCCS 12 /* Bit 12: Size of the array c_cc for control characters */
|
|
|
|
/* Baud Rate Selection. These are instances of type speed_t. Values of
|
|
* 38400 and below are specified by POSIX; values above 38400 are sometimes
|
|
* referred to as extended values and most values appear in most termios.h
|
|
* implementations.
|
|
*/
|
|
|
|
#define B0 0000000 /* Hang up */
|
|
#define B50 0000001 /* 50 baud */
|
|
#define B75 0000002 /* 75 baud */
|
|
#define B110 0000003 /* 110 baud */
|
|
#define B134 0000004 /* 134.5 baud */
|
|
#define B150 0000005 /* 150 baud */
|
|
#define B200 0000006 /* 200 baud */
|
|
#define B300 0000007 /* 300 baud */
|
|
#define B600 0000010 /* 600 baud */
|
|
#define B1200 0000011 /* 1,200 baud */
|
|
#define B1800 0000012 /* 1,800 baud */
|
|
#define B2400 0000013 /* 2,400 baud */
|
|
#define B4800 0000014 /* 4,800 baud */
|
|
#define B9600 0000015 /* 9,600 baud */
|
|
#define B19200 0000016 /* 19,200 baud */
|
|
#define B38400 0000017 /* 38,400 baud */
|
|
|
|
#define B57600 0010001 /* 57,600 baud */
|
|
#define B115200 0010002 /* 115,200 baud */
|
|
#define B230400 0010003 /* 230,400 baud */
|
|
#define B460800 0010004 /* 460,800 baud */
|
|
#define B500000 0010005 /* 500,000 baud */
|
|
#define B576000 0010006 /* 576,000 baud */
|
|
#define B921600 0010007 /* 921,600 baud */
|
|
#define B1000000 0010010 /* 1,000,000 baud */
|
|
#define B1152000 0010011 /* 1,152,000 baud */
|
|
#define B1500000 0010012 /* 1,500,000 baud */
|
|
#define B2000000 0010013 /* 2,000,000 baud */
|
|
#define B2500000 0010014 /* 2,500,000 baud */
|
|
#define B3000000 0010015 /* 3,000,000 baud */
|
|
#define B3500000 0010016 /* 3,500,000 baud */
|
|
#define B4000000 0010017 /* 4,000,000 baud */
|
|
|
|
/* Attribute Selection (used with tcsetattr()) */
|
|
|
|
#define TCSANOW 0 /* Change attributes immediately */
|
|
#define TCSADRAIN 1 /* Change attributes when output has drained */
|
|
#define TCSAFLUSH 2 /* Change attributes when output has drained;
|
|
* also flush pending input */
|
|
|
|
/* Line Control (used with tcflush()) */
|
|
|
|
#define TCIFLUSH 0 /* Flush pending input */
|
|
#define TCOFLUSH 1 /* Flush untransmitted output */
|
|
#define TCIOFLUSH 2 /* Flush both pending input and untransmitted
|
|
* output */
|
|
|
|
/* Constants for use with tcflow() */
|
|
|
|
#define TCOOFF 0 /* Suspend output */
|
|
#define TCOON 1 /* Restart output */
|
|
#define TCIOFF 2 /* Transmit a STOP character, intended to
|
|
* suspend input data */
|
|
#define TCION 3 /* Transmit a START character, intended to
|
|
* restart input data */
|
|
|
|
/****************************************************************************
|
|
* Public Type Definitions
|
|
****************************************************************************/
|
|
|
|
/* Baud rate selection */
|
|
|
|
typedef unsigned int speed_t; /* Used for terminal baud rates */
|
|
|
|
/* Types used within the termios structure */
|
|
|
|
typedef unsigned int tcflag_t; /* Used for terminal modes */
|
|
typedef unsigned char cc_t; /* Used for terminal special characters */
|
|
|
|
/* The termios structure */
|
|
|
|
struct termios
|
|
{
|
|
/* Exposed fields defined by POSIX */
|
|
|
|
tcflag_t c_iflag; /* Input modes */
|
|
tcflag_t c_oflag; /* Output modes */
|
|
tcflag_t c_cflag; /* Control modes */
|
|
tcflag_t c_lflag; /* Local modes */
|
|
cc_t c_cc[NCCS]; /* Control chars */
|
|
|
|
/* Implementation specific fields. For portability reasons, these fields
|
|
* should not be accessed directly, but rather through only through the
|
|
* cf[set|get][o|i]speed() POSIX interfaces.
|
|
*/
|
|
|
|
speed_t c_speed; /* Input/output speed (non-POSIX) */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Public Function Prototypes
|
|
****************************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
/* The cfgetspeed() function is a non-POSIX function will extract the baud
|
|
* from the termios structure to which the termiosp argument points. NuttX
|
|
* does not control input/output baud independently. Both must be the same.
|
|
* The POSIX standard interfaces, cfigetispeed() and cfigetospeed() are
|
|
* supported by simply defining them to be cfgetspeed().
|
|
* The return value is baud value(9600).
|
|
*/
|
|
|
|
speed_t cfgetspeed(FAR const struct termios *termiosp);
|
|
#define cfgetispeed(termiosp) cfgetspeed(termiosp)
|
|
#define cfgetospeed(termiosp) cfgetspeed(termiosp)
|
|
|
|
/* The cfsetspeed() function is a non-POSIX function that sets the baud
|
|
* stored in the structure pointed to by termiosp to speed. NuttX does
|
|
* not control input/output baud independently. Both must be the same.
|
|
* The POSIX standard interfaces, cfigetispeed() and cfigetospeed() are
|
|
* supported by simply defining them to be cfsetspeed().
|
|
* Speed could be baud value(9600) or could be baud mask(B9600).
|
|
*/
|
|
|
|
int cfsetspeed(FAR struct termios *termiosp, speed_t speed);
|
|
#define cfsetispeed(termiosp,speed) cfsetspeed(termiosp,speed)
|
|
#define cfsetospeed(termiosp,speed) cfsetspeed(termiosp,speed)
|
|
|
|
/* The cfmakeraw() function is a non-POSIX function that sets the terminal
|
|
* to something like the "raw" mode.
|
|
*/
|
|
|
|
void cfmakeraw(FAR struct termios *termiosp);
|
|
|
|
/* Wait for transmission of output */
|
|
|
|
int tcdrain(int fd);
|
|
|
|
/* Suspend or restart the transmission or reception of data */
|
|
|
|
int tcflow(int fd, int action);
|
|
|
|
/* Flush non-transmitted output data, non-read input data or both */
|
|
|
|
int tcflush(int fd, int cmd);
|
|
|
|
/* Get the parameters associated with the terminal */
|
|
|
|
int tcgetattr(int fd, FAR struct termios *termiosp);
|
|
|
|
/* Get process group ID for session leader for controlling terminal */
|
|
|
|
pid_t tcgetsid(int fd);
|
|
|
|
/* Send a "break" for a specific duration */
|
|
|
|
int tcsendbreak(int fd, int duration);
|
|
|
|
/* Set the parameters associated with the terminal */
|
|
|
|
int tcsetattr(int fd, int options, FAR const struct termios *termiosp);
|
|
|
|
#undef EXTERN
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* CONFIG_SERIAL_TERMIOS */
|
|
#endif /* __INCLUDE_TERMIOS_H */
|