james/SumProject
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

first

Browse Source
This commit is contained in:
james
2024-08-05 20:57:09 +08:00
commit 46d9ee7795
3020 changed files with 1725767 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
rt-thread/components/libc/posix/io/termios/SConscript Normal file
View File

@@ -0,0 +1,11 @@
# RT-Thread building script for component
from building import *
cwd = GetCurrentDir()
src = ['termios.c']
CPPPATH = [cwd]
group = DefineGroup('POSIX', src, depend = ['RT_USING_POSIX_TERMIOS'], CPPPATH = CPPPATH)
Return('group')

273
rt-thread/components/libc/posix/io/termios/termios.c Normal file
View File

@@ -0,0 +1,273 @@
/*
* Copyright (c) 2006-2021, RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2017-08-30 Bernard The first version
* 2024-04-26 TroyMitchell Add comments for all functions
*/
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/errno.h>
#include "termios.h"
#include <rtthread.h>
/**
* @brief Gets the current attributes of a terminal device.
* @param fd File descriptor of the terminal device.
* @param tio Pointer to a struct termios where the attributes will be stored.
* @return Upon successful completion, returns 0; otherwise, returns -1.
*
* @note This function retrieves the current attributes of a terminal device specified by the file descriptor fd.
* It uses the ioctl system call with the TCGETA command to obtain the attributes and stores them in the
* struct termios pointed to by tio.
* If the ioctl operation fails, the function returns -1 to indicate an error.
*/
int tcgetattr(int fd, struct termios *tio)
{
/* Get the current serial port settings. */
if (ioctl(fd, TCGETA, tio))
return -1;
return 0;
}
/**
* @brief Sets the attributes of a terminal device.
* @param fd File descriptor of the terminal device.
* @param act Action to be taken for the attribute change (TCSANOW, TCSADRAIN, or TCSAFLUSH).
* @param tio Pointer to a struct termios containing the new attributes.
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function sets the attributes of a terminal device specified by the file descriptor fd.
* The act parameter determines when the attribute change takes effect:
* - TCSANOW: Make the change immediately.
* - TCSADRAIN: Make the change after all currently written data has been transmitted.
* - TCSAFLUSH: Make the change after all currently written data has been transmitted, and discard
* any received but unread data.
* The new attributes are specified in the struct termios pointed to by tio.
* The ioctl system call is used to set the attributes based on the value of act.
* If the ioctl operation fails or an invalid action is specified, errno is set to indicate the error,
* and the function returns -1.
*/
int tcsetattr(int fd, int act, const struct termios *tio)
{
switch (act)
{
case TCSANOW:
/* make the change immediately */
return (ioctl(fd, TCSETA, (void*)tio));
case TCSADRAIN:
/*
* Don't make the change until all currently written data
* has been transmitted.
*/
return (ioctl(fd, TCSETAW, (void*)tio));
case TCSAFLUSH:
/* Don't make the change until all currently written data
* has been transmitted, at which point any received but
* unread data is also discarded.
*/
return (ioctl(fd, TCSETAF, (void*)tio));
default:
errno = EINVAL;
return (-1);
}
}
/**
* @brief Gets the session ID of a terminal.
* @param fd File descriptor of the terminal device.
* @return Always returns 0.
*
* @note This function is a stub and always returns 0.
* In POSIX systems, tcgetsid() is used to get the session ID of the terminal associated with the file descriptor fd.
* However, this function does not provide this functionality and simply returns 0 as a placeholder.
*/
pid_t tcgetsid(int fd)
{
return 0;
}
/**
* @brief Gets the output baud rate from a termios structure.
* @param tio Pointer to a struct termios containing the terminal attributes.
* @return Output baud rate extracted from the terminal attributes.
*
* @note This function extracts the output baud rate from the termios structure pointed to by tio.
* It retrieves the baud rate from the c_cflag member of the termios structure using the CBAUD mask.
* The output baud rate is returned as a speed_t type.
*/
speed_t cfgetospeed(const struct termios *tio)
{
return tio->c_cflag & CBAUD;
}
/**
* @brief Gets the input baud rate from a termios structure.
* @param tio Pointer to a struct termios containing the terminal attributes.
* @return Input baud rate extracted from the terminal attributes.
*
* @note This function is a wrapper for the cfgetospeed() function.
* It returns the input baud rate by calling cfgetospeed() with the termios structure pointer tio.
*/
speed_t cfgetispeed(const struct termios *tio)
{
return cfgetospeed(tio);
}
/**
* @brief Sets the output baud rate in a termios structure.
* @param tio Pointer to a struct termios where the output baud rate will be set.
* @param speed Output baud rate to be set.
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function sets the output baud rate in the termios structure pointed to by tio.
* The speed parameter specifies the baud rate to be set.
* If the specified speed exceeds the CBAUD mask, indicating an invalid baud rate value,
* errno is set to EINVAL, and the function returns -1.
* Otherwise, the function clears the CBAUD bits in the c_cflag member of the termios structure
* and sets them to the specified speed value. It then returns 0 to indicate success.
*/
int cfsetospeed(struct termios *tio, speed_t speed)
{
if (speed & ~CBAUD)
{
errno = EINVAL;
return -1;
}
tio->c_cflag &= ~CBAUD;
tio->c_cflag |= speed;
return 0;
}
/**
* @brief Sets the input baud rate in a termios structure.
* @param tio Pointer to a struct termios where the input baud rate will be set.
* @param speed Input baud rate to be set.
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function sets the input baud rate in the termios structure pointed to by tio.
* The speed parameter specifies the input baud rate to be set.
* If the speed parameter is non-zero, indicating a valid baud rate, the function calls
* cfsetospeed() to set both the input and output baud rates to the specified value.
* If speed is zero, indicating that no baud rate needs to be set for input, the function returns 0
* without making any changes to the termios structure.
*/
int cfsetispeed(struct termios *tio, speed_t speed)
{
return speed ? cfsetospeed(tio, speed) : 0;
}
/**
* @brief Sends a break signal on a terminal.
* @param fd File descriptor of the terminal device.
* @param dur Duration of the break signal (ignored).
* @return Always returns 0.
*
* @note This function is a stub and does not send an actual break signal.
* Sending a break signal with a nonzero duration is implementation-defined,
* so this function ignores the duration parameter and always returns 0.
*/
int tcsendbreak(int fd, int dur)
{
/* nonzero duration is implementation-defined, so ignore it */
return 0;
}
/**
* @brief Flushes data from a terminal input or output queue.
* @param fd File descriptor of the terminal device.
* @param queue Queue to be flushed (TCIFLUSH, TCOFLUSH, or TCIOFLUSH).
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function flushes data from the input or output queue of the terminal device specified by the file descriptor fd.
* The queue parameter specifies which queue to flush:
* - TCIFLUSH: Flushes data from the input queue.
* - TCOFLUSH: Flushes data from the output queue.
* - TCIOFLUSH: Flushes data from both the input and output queues.
* The ioctl system call is used with the TCFLSH command to perform the flush operation.
* If the ioctl operation fails, errno is set to indicate the error, and the function returns -1.
*/
int tcflush(int fd, int queue)
{
return ioctl(fd, TCFLSH, (void*)(rt_ubase_t)queue);
}
/**
* @brief Controls the terminal flow control.
* @param fd File descriptor of the terminal device.
* @param action Action to be taken for flow control (TCOOFF, TCOON, TCIOFF, or TCION).
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function controls the flow of data on the terminal device specified by the file descriptor fd.
* The action parameter determines the flow control action to be taken:
* - TCOOFF: Suspends output transmission.
* - TCOON: Restarts output transmission.
* - TCIOFF: Suspends input transmission.
* - TCION: Restarts input transmission.
* The ioctl system call is used with the TCXONC command to perform the flow control operation.
* If the ioctl operation fails, errno is set to indicate the error, and the function returns -1.
*/
int tcflow(int fd, int action)
{
return ioctl(fd, TCXONC, (void*)(rt_ubase_t)action);
}
/**
* @brief Waits until all output written to the terminal is transmitted.
* @param fd File descriptor of the terminal device.
* @return Always returns 0.
*
* @note This function is a stub and does not perform any action.
* In POSIX systems, tcdrain() is used to wait until all output written to the terminal
* is transmitted, but this function does not provide this functionality and simply returns 0 as a placeholder.
*/
int tcdrain(int fd)
{
return 0;
}
/**
* @brief Sets the terminal attributes to raw mode.
* @param t Pointer to a struct termios where the terminal attributes will be set.
*
* @note This function sets the terminal attributes pointed to by t to raw mode.
* Raw mode disables special input and output processing features, making the terminal behave more like a data stream.
* The following modifications are made to the termios structure:
* - Input flags (c_iflag) are cleared of various processing flags.
* - Output flags (c_oflag) are cleared to disable output processing.
* - Local flags (c_lflag) are cleared to disable canonical mode, echoing, and signal handling.
* - Control flags (c_cflag) are modified to set character size to 8 bits and disable parity.
* - The VMIN and VTIME control characters are set to 1 and 0, respectively, for non-blocking read behavior.
*/
void cfmakeraw(struct termios *t)
{
t->c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP|INLCR|IGNCR|ICRNL|IXON);
t->c_oflag &= ~OPOST;
t->c_lflag &= ~(ECHO|ECHONL|ICANON|ISIG|IEXTEN);
t->c_cflag &= ~(CSIZE|PARENB);
t->c_cflag |= CS8;
t->c_cc[VMIN] = 1;
t->c_cc[VTIME] = 0;
}
/**
* @brief Sets the input and output baud rates in a termios structure.
* @param tio Pointer to a struct termios where the input and output baud rates will be set.
* @param speed Baud rate to be set for both input and output.
* @return Upon successful completion, returns 0; otherwise, returns -1 and sets errno to indicate the error.
*
* @note This function is a wrapper for the cfsetospeed() function.
* It sets both the input and output baud rates in the termios structure pointed to by tio to the specified speed.
* The function returns the result of cfsetospeed(), which sets the baud rate for both input and output.
*/
int cfsetspeed(struct termios *tio, speed_t speed)
{
return cfsetospeed(tio, speed);
}

248
rt-thread/components/libc/posix/io/termios/termios.h Normal file
View File

@@ -0,0 +1,248 @@
/*
* Copyright (c) 2006-2021, RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2017/08/30 Bernard The first version
* 2021/12/10 linzhenxing put tty system
*/
#ifndef __TERMIOS_H__
#define __TERMIOS_H__
#include <sys/types.h>
#include <sys/ioctl.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef unsigned char cc_t;
typedef unsigned int speed_t;
typedef unsigned int tcflag_t;
#define NCCS 32
struct termios {
tcflag_t c_iflag;
tcflag_t c_oflag;
tcflag_t c_cflag;
tcflag_t c_lflag;
cc_t c_line;
cc_t c_cc[NCCS];
speed_t __c_ispeed;
speed_t __c_ospeed;
};
#ifndef NCC
#define NCC 8
struct termio
{
unsigned short c_iflag; /* input mode flags */
unsigned short c_oflag; /* output mode flags */
unsigned short c_cflag; /* control mode flags */
unsigned short c_lflag; /* local mode flags */
unsigned char c_line; /* line discipline */
unsigned char c_cc[NCC]; /* control characters */
};
#endif
/* c_cc characters */
#define VINTR 0
#define VQUIT 1
#define VERASE 2
#define VKILL 3
#define VEOF 4
#define VTIME 5
#define VMIN 6
#define VSWTC 7
#define VSTART 8
#define VSTOP 9
#define VSUSP 10
#define VEOL 11
#define VREPRINT 12
#define VDISCARD 13
#define VWERASE 14
#define VLNEXT 15
#define VEOL2 16
/* c_iflag bits */
#define IGNBRK 0000001
#define BRKINT 0000002
#define IGNPAR 0000004
#define PARMRK 0000010
#define INPCK 0000020
#define ISTRIP 0000040
#define INLCR 0000100
#define IGNCR 0000200
#define ICRNL 0000400
#define IUCLC 0001000
#define IXON 0002000
#define IXANY 0004000
#define IXOFF 0010000
#define IMAXBEL 0020000
#define IUTF8 0040000
/* c_oflag bits */
#define OPOST 0000001
#define OLCUC 0000002
#define ONLCR 0000004
#define OCRNL 0000010
#define ONOCR 0000020
#define ONLRET 0000040
#define OFILL 00000100
#define OFDEL 00000200
#define NLDLY 00001400
#define NL0 00000000
#define NL1 00000400
#define NL2 00001000
#define NL3 00001400
#define TABDLY 00006000
#define TAB0 00000000
#define TAB1 00002000
#define TAB2 00004000
#define TAB3 00006000
#define CRDLY 00030000
#define KCR0 00000000
#define KCR1 00010000
#define KCR2 00020000
#define KCR3 00030000
#define FFDLY 00040000
#define FF0 00000000
#define FF1 00040000
#define BSDLY 00100000
#define BS0 00000000
#define BS1 00100000
#define VTDLY 00200000
#define VT0 00000000
#define VT1 00200000
#define XTABS 01000000
#define B0 0000000
#define B50 0000001
#define B75 0000002
#define B110 0000003
#define B134 0000004
#define B150 0000005
#define B200 0000006
#define B300 0000007
#define B600 0000010
#define B1200 0000011
#define B1800 0000012
#define B2400 0000013
#define B4800 0000014
#define B9600 0000015
#define B19200 0000016
#define B38400 0000017
#define B57600 0010001
#define B115200 0010002
#define B230400 0010003
#define B460800 0010004
#define B500000 0010005
#define B576000 0010006
#define B921600 0010007
#define B1000000 0010010
#define B1152000 0010011
#define B1500000 0010012
#define B2000000 0010013
#define B2500000 0010014
#define B3000000 0010015
#define B3500000 0010016
#define B4000000 0010017
#define CSIZE 0000060
#define CS5 0000000
#define CS6 0000020
#define CS7 0000040
#define CS8 0000060
#define CSTOPB 0000100
#define CREAD 0000200
#define PARENB 0000400
#define PARODD 0001000
#define HUPCL 0002000
#define CLOCAL 0004000
/* c_lflag bits */
#define ISIG 0000001
#define ICANON 0000002
#define XCASE 0000004
#define ECHO 0000010
#define ECHOE 0000020
#define ECHOK 0000040
#define ECHONL 0000100
#define NOFLSH 0000200
#define TOSTOP 0000400
#define ECHOCTL 0001000
#define ECHOPRT 0002000
#define ECHOKE 0004000
#define FLUSHO 0010000
#define PENDIN 0040000
#define IEXTEN 0100000
#define EXTPROC 0200000
#define TCOOFF 0
#define TCOON 1
#define TCIOFF 2
#define TCION 3
#define TCIFLUSH 0
#define TCOFLUSH 1
#define TCIOFLUSH 2
#define TCSANOW 0
#define TCSADRAIN 1
#define TCSAFLUSH 2
#define EXTA 0000016
#define EXTB 0000017
#define CBAUD 0010017
#define CBAUDEX 0010000
#define CIBAUD 002003600000
#define CMSPAR 010000000000
#define CRTSCTS 020000000000
#define XCASE 0000004
#define ECHOCTL 0001000
#define ECHOPRT 0002000
#define ECHOKE 0004000
#define FLUSHO 0010000
#define PENDIN 0040000
#define EXTPROC 0200000
/* intr=^C quit=^| erase=del kill=^U
eof=^D vtime=\0 vmin=\1 sxtc=\0
start=^Q stop=^S susp=^Z eol=\0
reprint=^R discard=^U werase=^W lnext=^V
eol2=\0
*/
#define INIT_C_CC "\003\034\177\025\004\0\1\0\021\023\032\0\022\017\027\026\0"
speed_t cfgetospeed (const struct termios *);
speed_t cfgetispeed (const struct termios *);
int cfsetospeed (struct termios *, speed_t);
int cfsetispeed (struct termios *, speed_t);
int tcgetattr (int, struct termios *);
int tcsetattr (int, int, const struct termios *);
int tcsendbreak (int, int);
int tcdrain (int);
int tcflush (int, int);
int tcflow (int, int);
pid_t tcgetsid (int);
void cfmakeraw(struct termios *);
int cfsetspeed(struct termios *, speed_t);
#ifdef __cplusplus
}
#endif
#endif