incubator-nuttx/include/nuttx/serial/tioctl.h

245 lines
9.9 KiB
C

/****************************************************************************
* include/nuttx/serial/tioctl.h
*
* SPDX-License-Identifier: Apache-2.0
*
* 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.
*
****************************************************************************/
/* This function should not be included directly.
* Rather, it should be included indirectly via include/nuttx/fs/ioctl.h.
*/
#ifndef __INCLUDE_NUTTX_SERIAL_TIOCTL_H
#define __INCLUDE_NUTTX_SERIAL_TIOCTL_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/fs/ioctl.h>
#include <stdint.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* Get and Set Terminal Attributes (see termios.h) */
#define TCGETS _TIOC(0x0001) /* Get serial port settings: FAR struct termios* */
#define TCSETS _TIOC(0x0002) /* Set serial port settings: FAR const struct termios* */
#define TCSETSW _TIOC(0x0003) /* Drain output and set serial port settings: FAR const struct termios* */
#define TCSETSF _TIOC(0x0004) /* Drain output, discard input, and set serial port settings: FAR const struct termios* */
#define TCGETA _TIOC(0x0005) /* See TCGETS: FAR struct termio* */
#define TCSETA _TIOC(0x0006) /* See TCSETS: FAR const struct termio* */
#define TCSETAW _TIOC(0x0007) /* See TCSETSF: FAR const struct termio* */
#define TCSETAF _TIOC(0x0008) /* See TCSETSF: FAR const struct termio* */
/* Locking the termios structure */
#define TIOCGLCKTRMIOS _TIOC(0x0009) /* Get termios lock status: FAR struct termios* */
#define TIOCSLCKTRMIOS _TIOC(0x000a) /* Set termios lock status: FAR const struct termios* */
/* Get and Set Window Size */
#define TIOCGWINSZ _TIOC(0x000b) /* Get window size: FAR struct winsize */
#define TIOCSWINSZ _TIOC(0x000c) /* Set window size: FAR const struct winsize */
/* Send a break */
#define TCSBRK _TIOC(0x000d) /* Send a break: int */
#define TCSBRKP _TIOC(0x000e) /* Send a POSIX break: int */
#define TIOCSBRK _TIOC(0x000f) /* Turn break on: void */
#define TIOCCBRK _TIOC(0x0010) /* Turn break off: void */
/* Software flow control */
#define TCXONC _TIOC(0x0011) /* Control flow control: int */
/* Buffer count and flushing */
#define TIOCINQ _TIOC(0x0012) /* Bytes in input buffer: int */
#define TIOCOUTQ _TIOC(0x0013) /* Bytes in output buffer: int */
#define TCFLSH _TIOC(0x0014) /* Flush: int */
#define TCDRN _TIOC(0x0015) /* Drain: void */
/* Faking input */
#define TIOCSTI _TIOC(0x0016) /* Insert into input: const char */
/* Re-directing console output */
#define TIOCCONS _TIOC(0x0017) /* Re-direct console output to device: void */
/* Controlling TTY */
#define TIOCSCTTY _TIOC(0x0018) /* Make controlling TTY: int */
#define TIOCNOTTY _TIOC(0x0019) /* Give up controllinog TTY: void */
/* Exclusive mode */
#define TIOCEXCL _TIOC(0x001a) /* Put TTY in exclusive mode: void */
#define TIOCNXCL _TIOC(0x001b) /* Disable exclusive mode: void */
/* Line discipline */
#define TIOCGETD _TIOC(0x001c) /* Get line discipline: FAR int */
#define TIOCSETD _TIOC(0x001d) /* Set line discipline: FAR const int */
/* Packet mode */
#define TIOCPKT _TIOC(0x001e) /* Control packet mode: FAR const int */
# define TIOCPKT_FLUSHREAD (1 << 0) /* The read queue for the terminal is flushed */
# define TIOCPKT_FLUSHWRITE (1 << 1) /* The write queue for the terminal is flushed */
# define TIOCPKT_STOP (1 << 2) /* Output to the terminal is stopped */
# define TIOCPKT_START (1 << 3) /* Output to the terminal is restarted */
# define TIOCPKT_DOSTOP (1 << 4) /* t_stopc is '^S' and t_startc is '^Q' */
# define TIOCPKT_NOSTOP (1 << 5) /* The start and stop characters are not '^S/^Q' */
/* Modem control */
#define TIOCMGET _TIOC(0x001f) /* Get modem status bits: FAR int */
#define TIOCMSET _TIOC(0x0020) /* Set modem status bits: FAR const int */
#define TIOCMBIC _TIOC(0x0021) /* Clear modem bits: FAR const int */
#define TIOCMBIS _TIOC(0x0022) /* Set modem bits: FAR const int */
# define TIOCM_LE (1 << 0) /* DSR (data set ready/line enable) */
# define TIOCM_DTR (1 << 1) /* DTR (data terminal ready) */
# define TIOCM_RTS (1 << 2) /* RTS (request to send) */
# define TIOCM_ST (1 << 3) /* Secondary TXD (transmit) */
# define TIOCM_SR (1 << 4) /* Secondary RXD (receive) */
# define TIOCM_CTS (1 << 5) /* CTS (clear to send) */
# define TIOCM_CAR (1 << 6) /* DCD (data carrier detect) */
# define TIOCM_CD TIOCM_CAR
# define TIOCM_RNG (1 << 7) /* RNG (ring) */
# define TIOCM_RI TIOCM_RNG
# define TIOCM_DSR (1 << 8) /* DSR (data set ready) */
/* TTY shutdown */
#define TIOCVHANGUP _TIOC(0x0023) /* Shutdown TTY: void */
/* Marking a line as local */
#define TIOCGSOFTCAR _TIOC(0x0024) /* Get software carrier flag: FAR int* */
#define TIOCSSOFTCAR _TIOC(0x0025) /* Set software carrier flag: FAR const int */
/* Get/set serial line info */
#define TIOCGSERIAL _TIOC(0x0026) /* Get serial line info: FAR struct serial_struct */
#define TIOCSSERIAL _TIOC(0x0027) /* Set serial line info: FAR const struct serial_struct */
#define TIOCSERGETLSR _TIOC(0x0028) /* Get line status register: FAR int */
/* Serial events */
#define TIOCMIWAIT _TIOC(0x0029) /* Wait for a change on serial input line(s): void */
#define TIOCGICOUNT _TIOC(0x002a) /* Read serial port interrupt count: FAR struct serial_icounter_struct */
/* Pseudo-terminals */
#define TIOCGPTN _TIOC(0x002b) /* Get Pty Number (of pty-mux device): FAR int* */
#define TIOCSPTLCK _TIOC(0x002c) /* Lock/unlock Pty: int */
#define TIOCGPTLCK _TIOC(0x002d) /* Get Pty lock state: FAR int* */
/* RS-485 Support */
#define TIOCSRS485 _TIOC(0x002e) /* Set RS485 mode, arg: pointer to struct serial_rs485 */
#define TIOCGRS485 _TIOC(0x002f) /* Get RS485 mode, arg: pointer to struct serial_rs485 */
/* Definitions for flags used in struct serial_rs485 (Linux compatible) */
# define SER_RS485_ENABLED (1 << 0) /* Enable/disable RS-485 support */
# define SER_RS485_RTS_ON_SEND (1 << 1) /* Logic level for RTS pin when sending */
# define SER_RS485_RTS_AFTER_SEND (1 << 2) /* Logic level for RTS pin after sent */
# define SER_RS485_RX_DURING_TX (1 << 4)
/* Single-wire UART support */
#define TIOCSSINGLEWIRE _TIOC(0x0030) /* Set single-wire mode */
#define TIOCGSINGLEWIRE _TIOC(0x0031) /* Get single-wire mode */
# define SER_SINGLEWIRE_ENABLED (1 << 0) /* Enable/disable single-wire support */
# define SER_SINGLEWIRE_PULL_SHIFT (1) /* RX/TX Line Pullup/down control */
# define SER_SINGLEWIRE_PULL_MASK (3 << SER_SINGLEWIRE_PULL_SHIFT)
# define SER_SINGLEWIRE_PULL_DISABLE (0 << SER_SINGLEWIRE_PULL_SHIFT) /* Float RX/TX Line */
# define SER_SINGLEWIRE_PULLUP (1 << SER_SINGLEWIRE_PULL_SHIFT) /* Enable Pull up the RX/TX Line */
# define SER_SINGLEWIRE_PULLDOWN (2 << SER_SINGLEWIRE_PULL_SHIFT) /* Enable Pull down the RX/TX Line */
# define SER_SINGLEWIRE_PUSHPULL (1 << 3) /* Use PUSH/PULL not Open Drain with Single wire */
/* Debugging */
#define TIOCSERGSTRUCT _TIOC(0x0032) /* Get device TTY structure */
/* Inversion Support */
#define TIOCSINVERT _TIOC(0x0033) /* Set Signal Inversion */
#define TIOCGINVERT _TIOC(0x0034) /* Get Signal Inversion */
#define SER_INVERT_ENABLED_RX (1 << 0) /* Enable/disable signal inversion for RX */
#define SER_INVERT_ENABLED_TX (1 << 1) /* Enable/disable signal inversion for TX */
/* RX/TX Swap Support */
#define TIOCSSWAP _TIOC(0x0035) /* Set RX/TX Swap */
#define TIOCGSWAP _TIOC(0x0036) /* Get RX/TX Swap */
#define SER_SWAP_ENABLED (1 << 0) /* Enable/disable RX/TX swap */
/****************************************************************************
* Public Type Definitions
****************************************************************************/
/* Used with TTY ioctls */
struct winsize
{
uint16_t ws_row;
uint16_t ws_col;
uint16_t ws_xpixel; /* unused */
uint16_t ws_ypixel; /* unused */
};
/* Structure used with TIOCSRS485 and TIOCGRS485 (Linux compatible) */
struct serial_rs485
{
uint32_t flags; /* See SER_RS485_* definitions */
uint32_t delay_rts_before_send; /* Delay before send (milliseconds) */
uint32_t delay_rts_after_send; /* Delay after send (milliseconds) */
};
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
#ifdef __cplusplus
#define EXTERN extern "C"
extern "C"
{
#else
#define EXTERN extern
#endif
#undef EXTERN
#ifdef __cplusplus
}
#endif
#endif /* __INCLUDE_NUTTX_SERIAL_TIOCTL_H */