串口操作函数.docx
《串口操作函数.docx》由会员分享,可在线阅读,更多相关《串口操作函数.docx(38页珍藏版)》请在冰豆网上搜索。
![串口操作函数.docx](https://file1.bdocx.com/fileroot1/2023-1/28/a110db8d-7ac3-436f-8c7f-6a4746d964f3/a110db8d-7ac3-436f-8c7f-6a4746d964f31.gif)
串口操作函数
cfmakeraw中文man页面
(1)
NAME
termios,tcgetattr,tcsetattr,tcsendbreak,tcdrain,tcflush,tcflow,cfmakeraw,cfgetospeed,cfgetispeed,cfsetispeed,cfsetospeed-获取和设置终端属性,行控制,获取和设置波特率
SYNOPSIS总览
#include
#include fd,structtermios*termios_p);
inttcgetattr(int
inttcsetattr(int fd,int optional_actions,structtermios*termios_p);
inttcsendbreak(int fd,int duration);
inttcdrain(int fd);
inttcflush(int fd,int queue_selector);
inttcflow(int fd,int action);
intcfmakeraw(structtermios*termios_p);
speed_tcfgetispeed(structtermios*termios_p);
speed_tcfgetospeed(structtermios*termios_p);
intcfsetispeed(structtermios*termios_p,speed_t speed);
intcfsetospeed(structtermios*termios_p,speed_t speed);
DESCRIPTION描述
termios函数族提供了一个常规的终端接口,用于控制非同步通信端口。
这里描述的大部分属性有一个 termios_p 类型的参数,它是指向一个 termios 结构的指针。
这个结构包含了至少下列成员:
tcflag_tc_iflag;/*输入模式*/
tcflag_tc_oflag;/*输出模式*/
tcflag_tc_cflag;/*控制模式*/
tcflag_tc_lflag;/*本地模式*/
cc_tc_cc[NCCS];/*控制字符*/
c_iflag 标志常量:
IGNBRK
忽略输入中的BREAK状态。
BRKINT
如果设置了 IGNBRK,将忽略BREAK。
如果没有设置,但是设置了 BRKINT,那么BREAK将使得输入和输出队列被刷新,如果终端是一个前台进程组的控制终端,这个进程组中所有进程将收到SIGINT 信号。
如果既未设置 IGNBRK 也未设置 BRKINT,BREAK将视为与NUL字符同义,除非设置了 PARMRK,这种情况下它被视为序列\377\0\0。
IGNPAR
忽略桢错误和奇偶校验错。
PARMRK
如果没有设置 IGNPAR,在有奇偶校验错或桢错误的字符前插入\377\0。
如果既没有设置IGNPAR 也没有设置 PARMRK,将有奇偶校验错或桢错误的字符视为\0。
INPCK
启用输入奇偶检测。
ISTRIP
去掉第八位。
INLCR
将输入中的NL翻译为CR。
IGNCR
忽略输入中的回车。
ICRNL
将输入中的回车翻译为新行(除非设置了 IGNCR)。
IUCLC
(不属于POSIX)将输入中的大写字母映射为小写字母。
IXON
启用输出的XON/XOFF流控制。
IXANY
(不属于POSIX.1;XSI)允许任何字符来重新开始输出。
(?
)
IXOFF
启用输入的XON/XOFF流控制。
IMAXBEL
(不属于POSIX)当输入队列满时响零。
Linux没有实现这一位,总是将它视为已设置。
POSIX.1中定义的 c_oflag 标志常量:
OPOST
启用具体实现自行定义的输出处理。
其余 c_oflag 标志常量定义在POSIX1003.1-2001中,除非另外说明。
OLCUC
(不属于POSIX)将输出中的小写字母映射为大写字母。
ONLCR
(XSI)将输出中的新行符映射为回车-换行。
OCRNL
将输出中的回车映射为新行符
ONOCR
不在第0列输出回车。
ONLRET
不输出回车。
OFILL
发送填充字符作为延时,而不是使用定时来延时。
OFDEL
(不属于POSIX)填充字符是ASCIIDEL(0177)。
如果不设置,填充字符则是ASCIINUL。
NLDLY
新行延时掩码。
取值为 NL0 和 NL1。
CRDLY
回车延时掩码。
取值为 CR0, CR1, CR2,或 CR3。
TABDLY
水平跳格延时掩码。
取值为 TAB0, TAB1, TAB2, TAB3 (或 XTABS)。
取值为TAB3,即XTABS,将扩展跳格为空格(每个跳格符填充8个空格)。
(?
)
BSDLY
回退延时掩码。
取值为 BS0 或 BS1。
(从来没有被实现过)
VTDLY
竖直跳格延时掩码。
取值为 VT0 或 VT1。
FFDLY
进表延时掩码。
取值为 FF0 或 FF1。
c_cflag 标志常量:
CBAUD
(不属于POSIX)波特率掩码(4+1位)。
CBAUDEX
(不属于POSIX)扩展的波特率掩码(1位),包含在CBAUD中。
(POSIX规定波特率存储在termios结构中,并未精确指定它的位置,而是提供了函数cfgetispeed() 和 cfsetispeed() 来存取它。
一些系统使用 c_cflag 中CBAUD选择的位,其他系统使用单独的变量,例如 sg_ispeed 和 sg_ospeed 。
)
CSIZE
字符长度掩码。
取值为 CS5, CS6, CS7,或 CS8。
CSTOPB
设置两个停止位,而不是一个。
CREAD
打开接受者。
PARENB
允许输出产生奇偶信息以及输入的奇偶校验。
PARODD
输入和输出是奇校验。
HUPCL
在最后一个进程关闭设备后,降低modem控制线(挂断)。
(?
)
CLOCAL
忽略modem控制线。
LOBLK
(不属于POSIX)从非当前shell层阻塞输出(用于 shl )。
(?
)
CIBAUD
(不属于POSIX)输入速度的掩码。
CIBAUD各位的值与CBAUD各位相同,左移了IBSHIFT位。
CRTSCTS
(不属于POSIX)启用RTS/CTS(硬件)流控制。
c_lflag 标志常量:
ISIG
当接受到字符INTR,QUIT,SUSP,或DSUSP时,产生相应的信号。
ICANON
启用标准模式(canonicalmode)。
允许使用特殊字符EOF,EOL,EOL2,ERASE,KILL,LNEXT,REPRINT,STATUS,和WERASE,以及按行的缓冲。
XCASE
(不属于POSIX;Linux下不被支持)如果同时设置了 ICANON,终端只有大写。
输入被转换为小写,除了以\前缀的字符。
输出时,大写字符被前缀\,小写字符被转换成大写。
ECHO
回显输入字符。
ECHOE
如果同时设置了 ICANON,字符ERASE擦除前一个输入字符,WERASE擦除前一个词。
ECHOK
如果同时设置了 ICANON,字符KILL删除当前行。
ECHONL
如果同时设置了 ICANON,回显字符NL,即使没有设置ECHO。
ECHOCTL
(不属于POSIX)如果同时设置了 ECHO,除了TAB,NL,START,和STOP之外的ASCII控制信号被回显为^X,这里X是比控制信号大0x40的ASCII码。
例如,字符0x08(BS)被回显为^H。
ECHOPRT
(不属于POSIX)如果同时设置了 ICANON 和 IECHO,字符在删除的同时被打印。
ECHOKE
(不属于POSIX)如果同时设置了 ICANON,回显KILL时将删除一行中的每个字符,如同指定了ECHOE 和 ECHOPRT 一样。
DEFECHO
(不属于POSIX)只在一个进程读的时候回显。
FLUSHO
(不属于POSIX;Linux下不被支持)输出被刷新。
这个标志可以通过键入字符DISCARD来开关。
NOFLSH
禁止在产生SIGINT,SIGQUIT和SIGSUSP信号时刷新输入和输出队列。
TOSTOP
向试图写控制终端的后台进程组发送SIGTTOU信号。
PENDIN
(不属于POSIX;Linux下不被支持)在读入下一个字符时,输入队列中所有字符被重新输出。
(bash 用它来处理typeahead)
IEXTEN
启用实现自定义的输入处理。
这个标志必须与 ICANON 同时使用,才能解释特殊字符EOL2,LNEXT,REPRINT和WERASE,IUCLC 标志才有效。
c_cc 数组定义了特殊的控制字符。
符号下标(初始值)和意义为:
VINTR
(003,ETX,Ctrl-C,oralso0177,DEL,rubout)中断字符。
发出SIGINT信号。
当设置ISIG时可被识别,不再作为输入传递。
VQUIT
(034,FS,Ctrl-\)退出字符。
发出SIGQUIT信号。
当设置ISIG时可被识别,不再作为输入传递。
VERASE
(0177,DEL,rubout,or010,BS,Ctrl-H,oralso#)删除字符。
删除上一个还没有删掉的字符,但不删除上一个EOF或行首。
当设置ICANON时可被识别,不再作为输入传递。
VKILL
(025,NAK,Ctrl-U,orCtrl-X,oralso@)终止字符。
删除自上一个EOF或行首以来的输入。
当设置ICANON时可被识别,不再作为输入传递。
VEOF
(004,EOT,Ctrl-D)文件尾字符。
更精确地说,这个字符使得tty缓冲中的内容被送到等待输入的用户程序中,而不必等到EOL。
如果它是一行的第一个字符,那么用户程序的 read() 将返回0,指示读到了EOF。
当设置ICANON时可被识别,不再作为输入传递。
VMIN
非canonical模式读的最小字符数。
VEOL
(0,NUL)附加的行尾字符。
当设置ICANON时可被识别。
VTIME
非canonical模式读时的延时,以十分之一秒为单位。
VEOL2
(notinPOSIX;0,NUL)另一个行尾字符。
当设置ICANON时可被识别。
VSWTCH
(notinPOSIX;notsupportedunderLinux;0,NUL)开关字符。
(只为 shl 所用。
)
VSTART
(021,DC1,Ctrl-Q)开始字符。
重新开始被Stop字符中止的输出。
当设置IXON时可被识别,不再作为输入传递。
VSTOP
(023,DC3,Ctrl-S)停止字符。
停止输出,直到键入Start字符。
当设置IXON时可被识别,不再作为输入传递。
VSUSP
(032,SUB,Ctrl-Z)挂起字符。
发送SIGTSTP信号。
当设置ISIG时可被识别,不再作为输入传递。
VDSUSP
(notinPOSIX;notsupportedunderLinux;031,EM,Ctrl-Y)延时挂起信号。
当用户程序读到这个字符时,发送SIGTSTP信号。
当设置IEXTEN和ISIG,并且系统支持作业管理时可被识别,不再作为输入传递。
VLNEXT
(notinPOSIX;026,SYN,Ctrl-V)字面上的下一个。
引用下一个输入字符,取消它的任何特殊含义。
当设置IEXTEN时可被识别,不再作为输入传递。
VWERASE
(notinPOSIX;027,ETB,Ctrl-W)删除词。
当设置ICANON和IEXTEN时可被识别,不再作为输入传递。
VREPRINT
(notinPOSIX;022,DC2,Ctrl-R)重新输出未读的字符。
当设置ICANON和IEXTEN时可被识别,不再作为输入传递。
VDISCARD
(notinPOSIX;notsupportedunderLinux;017,SI,Ctrl-O)开关:
开始/结束丢弃未完成的输出。
当设置IEXTEN时可被识别,不再作为输入传递。
VSTATUS
(notinPOSIX;notsupportedunderLinux;statusrequest:
024,DC4,Ctrl-T).
这些符号下标值是互不相同的,除了VTIME,VMIN的值可能分别与VEOL,VEOF相同。
(在non-canonical模式下,特殊字符的含义更改为延时含义。
MIN表示应当被读入的最小字符数。
TIME是以十分之一秒为单位的计时器。
如果同时设置了它们,read将等待直到至少读入一个字符,一旦读入MIN个字符或者从上次读入字符开始经过了TIME时间就立即返回。
如果只设置了MIN,read在读入MIN个字符之前不会返回。
如果只设置了TIME,read将在至少读入一个字符,或者计时器超时的时候立即返回。
如果都没有设置,read将立即返回,只给出当前准备好的字符。
)(?
)
tcgetattr() 得到与 fd 指向的对象相关的参数,将它们保存于 termios_p 引用的termios 结构中。
函数可以从后台进程中调用;但是,终端属性可能被后来的前台进程所改变。
tcsetattr() 设置与终端相关的参数(除非需要底层支持却无法满足),使用 termios_p引用的 termios 结构。
optional_actions 指定了什么时候改变会起作用:
TCSANOW
改变立即发生
TCSADRAIN
改变在所有写入 fd 的输出都被传输后生效。
这个函数应当用于修改影响输出的参数时使用。
TCSAFLUSH
改变在所有写入 fd 引用的对象的输出都被传输后生效,所有已接受但未读入的输入都在改变发生前丢弃。
tcsendbreak() 传送连续的0值比特流,持续一段时间,如果终端使用异步串行数据传输的话。
如果 duration 是0,它至少传输0.25秒,不会超过0.5秒。
如果 duration 非零,它发送的时间长度由实现定义。
如果终端并非使用异步串行数据传输,tcsendbreak() 什么都不做。
tcdrain() 等待直到所有写入 fd 引用的对象的输出都被传输。
tcflush() 丢弃要写入引用的对象,但是尚未传输的数据,或者收到但是尚未读取的数据,取决于 queue_selector 的值:
TCIFLUSH
刷新收到的数据但是不读
TCOFLUSH
刷新写入的数据但是不传送
TCIOFLUSH
同时刷新收到的数据但是不读,并且刷新写入的数据但是不传送
tcflow() 挂起 fd 引用的对象上的数据传输或接收,取决于 action 的值:
TCOOFF
挂起输出
TCOON
重新开始被挂起的输出
TCIOFF
发送一个STOP字符,停止终端设备向系统传送数据
TCION
发送一个START字符,使终端设备向系统传输数据
打开一个终端设备时的默认设置是输入和输出都没有挂起。
波特率函数被用来获取和设置 termios 结构中,输入和输出波特率的值。
新值不会马上生效,直到成功调用了 tcsetattr() 函数。
设置速度为 B0 使得modem"挂机"。
与 B38400 相应的实际比特率可以用 setserial(8)调整。
输入和输出波特率被保存于 termios 结构中。
cfmakeraw 设置终端属性如下:
termios_p->c_iflag&=~(IGNBRK|BRKINT|PARMRK|ISTRIP
|INLCR|IGNCR|ICRNL|IXON);
termios_p->c_oflag&=~OPOST;
termios_p->c_lflag&=~(ECHO|ECHONL|ICANON|ISIG|IEXTEN);
termios_p->c_cflag&=~(CSIZE|PARENB);
termios_p->c_cflag|=CS8;
cfgetospeed() 返回 termios_p 指向的 termios 结构中存储的输出波特率
cfsetospeed() 设置 termios_p 指向的 termios 结构中存储的输出波特率为 speed。
取值必须是以下常量之一:
B0
B50
B75
B110
B134
B150
B200
B300
B600
B1200
B1800
B2400
B4800
B9600
B19200
B38400
B57600
B115200
B230400
零值 B0 用来中断连接。
如果指定了B0,不应当再假定存在连接。
通常,这样将断开连接。
CBAUDEX 是一个掩码,指示高于POSIX.1定义的速度的那一些(57600及以上)。
因此,B57600 & CBAUDEX 为非零。
cfgetispeed() 返回 termios 结构中存储的输入波特率。
cfsetispeed() 设置 termios 结构中存储的输入波特率为 speed。
如果输入波特率被设为0,实际输入波特率将等于输出波特率。
RETURNVALUE返回值
cfgetispeed() 返回 termios 结构中存储的输入波特率。
cfgetospeed() 返回 termios 结构中存储的输出波特率。
其他函数返回:
0
成功
-1
失败,并且为 errno 置值来指示错误。
注意 tcsetattr() 返回成功,如果任何所要求的修改可以实现的话。
因此,当进行多重修改时,应当在这个函数之后再次调用 tcgetattr() 来检测是否所有修改都成功实现。
NOTES注意
UnixV7以及很多后来的系统有一个波特率的列表,在十四个值B0,...,B9600之后可以看到两个常数EXTA,EXTB("ExternalA"and"ExternalB")。
很多系统将这个列表扩展为更高的波特率。
tcsendbreak 中非零的 duration 有不同的效果。
SunOS指定中断 duration*N 秒,其中N 至少为0.25,不高于0.5。
Linux,AIX,DU,Tru64发送 duration 微秒的break。
FreeBSD,NetBSD,HP-UX以及MacOS忽略 duration 的值。
在Solaris和Unixware中,tcsendbreak 搭配非零的 duration 效果类似于 tcdrain。
SEEALSO参见
stty
(1), setserial(8)
LINUX使用tcgetattr函数与tcsetattr函数控制终端
分类:
嵌入式2010-04-0615:
50 998人阅读 评论(0) 收藏 举报
linux终端structcharactercinput
为了便于通过程序来获得和修改终端参数,Linux还提供了tcgetattr函数和tcsetattr函数。
tcgetattr用于获取终端的相关参数,而tcsetattr函数用于设置终端参数。
这两个函数的具体信息如表6.2所示。
表6.2tcgetattr函数和tcsetattr函数
头文件
函数形式
inttcgetattr(intfd,structtermios*termios_p);
inttcsetattr(intfd,intoptional_actions,conststructtermios*termios_p);
返回值
成功
失败
是否设置errno
0
−1
是
说明:
tcgetattr函数用于获取与终端相关的参数。
参数fd为终端的文件描述符,返回的结果保存在termios结构体中,该结构体一般包括如下的成员:
tcflag_tc_iflag;
tcflag_tc_oflag;
tcflag_tc_cflag;
tcflag_tc_lflag;
cc_t c_cc[NCCS];
其具体意义如下。
c_iflag:
输入模式标志,控制终端输入方式,具体参数如表6.3所示。
表6.3c_iflag参数表
键 值
说 明
IGNBRK
忽略BREAK键输入
BRKINT
如果设置了IGNBRK,BREAK键的输入将被忽略,如果设置了BRKINT ,将产生SIGINT中断
IGNPAR
忽略奇偶校验错误
PARMRK
标识奇偶校验错误
INPCK
允许输入奇偶校验
ISTRIP
去除字符的第8个比特
INLCR
将输入的NL(换行)转换成CR(回车)
IGNCR
忽略输入的回车
ICRNL
将输入的回车转化成换行(如果IGNCR未设置的情况下)
IUCLC
将输入的大写字符转换成小写字符(非POSIX)
IXON
允许输入时对XON/XOFF流进行控制
IXANY
输入任何字符将重启停止的输出
IXOFF
允许输入时对XON/XOFF流进行控制
IMAXBEL
当输入队列满的时候开始响铃,Linux在使用该参数而是认为该参数总是已经设置
c_oflag:
输出模式标志,控制终端输出方式,具体参数如表6.4所示。
表6.4c_oflag参数
键 值
说 明
OPOST
处理后输出
OLCUC
将输入的小写字符转换成大写字符(非POSIX)
ONLCR
将输入的NL(换行)转换成CR(回车)及NL(换行)
OCRNL
将输入的CR(回车)转换成NL(换行)
ONOCR
第一行不输出回车符
ONLRET
不输出回车符
OFILL
发送填充字符以延迟终端输出
OFDEL
以ASCII码的DEL作为填充字符,如果未设置该参数,填充字符将是NUL(‘/0’)(非POSIX)
NLDLY
换行输出延时,可以取NL0(不延迟)或NL1(延迟0.1s)
CRDLY
回车延迟,取值范围为:
CR0、CR1、CR2和 CR3
TABDLY
水平制表符输出延迟,取值范围为:
TAB0、TAB1、TAB2和TAB3
BSDLY
空格输出延迟,可以取BS0或BS1
VT