接口描述

4 接口描述

UART 驱动会注册生成串口设备/dev/ttySx，应用层的使用只需遵循 Linux 系统中的标准串口编程方法即可。

4.1 打开/关闭串口

使用标准的文件打开函数：

int open(const char *pathname, int flags);
int close(int fd);

需要引用头文件：

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>

4.2 读/写串口

同样使用标准的文件读写函数：

ssize_t read(int fd, void *buf, size_t count);
ssize_t write(int fd, const void *buf, size_t count);

需要引用头文件：

#include <unistd.h>

4.3 设置串口属性

串口属性包括波特率、数据位、停止位、校验位、流控等，这部分是串口设备特有的接口。串口属性的数据结构 termios 定义如下：（terminos.h）。

#define NCCS 19
struct termios {
    tcflag_t c_iflag;  /* input mode flags */
    tcflag_t c_oflag;  /* output mode flags */
    tcflag_t c_cflag;  /* control mode flags */
    tcflag_t c_lflag;  /* local mode flags */
    cc_t c_line;       /* line discipline */
    cc_t c_cc[NCCS];   /* control characters */
};

其中，c_iflag 的标志常量定义如下：

c_oflag 的标志常量定义如下：

c_cflag 的标志常量定义如下：

c_lflag 的标志常量定义如下：

c_cc 数组定义了特殊的控制字符。符号下标 (初始值) 和意义为：

4.3.1 tcgetattr

• 作用：获取串口设备的属性。

• 参数：

​ • fd，串口设备的文件描述符。

​ • termios_p，用于保存串口属性。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码。

4.3.2 tcsetattr

• 作用：设置串口设备的属性。

• 参数：

​ • fd，串口设备的文件描述符。

​ • optional_actions，本次设置什么时候生效。

​ • termios_p，指向要设置的属性结构。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码

说明

其中，optional_actions的取值有：

TCSANOW：会立即生效。

TCSADRAIN：当前的输出数据完成传输后生效，适用于修改了输出相关的参数。

TCSAFLUSH：当前的输出数据完成传输，如果输入有数据可读但没有读就会被丢弃。

4.3.3 cfgetispeed

• 作用：返回串口属性中的输入波特率。

• 参数：

​ • termios_p，指向保存有串口属性的结构。

• 返回：

​ • 成功，返回波特率，取值是一组宏，定义在 terminos.h。

​ • 失败，返回-1，errnor 给出具体错误码。

说明

波特率定义如下所示：

#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

4.3.4 cfgetospeed

• 作用：返回串口属性中的输出波特率。

• 参数：

​ • termios_p，指向保存有串口属性的结构。

• 返回：

​ • 成功，返回波特率，取值是一组宏，定义在 terminos.h，见 4.3.3

​ • 失败，返回-1，errnor 给出具体错误码。

4.3.5 cfsetispeed

• 作用：设置输入波特率到属性结构中。

• 参数：

​ • termios_p，指向保存有串口属性的结构。

​ • speed，波特率，取值同 4.3.3。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码

4.3.6 cfsetospeed

• 作用：设置输出波特率到属性结构中。

• 参数：

​ • termios_p，指向保存有串口属性的结构。

​ • speed，波特率，取值同 4.3.3。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码

4.3.7 cfsetspeed

• 作用：同时设置输入和输出波特率到属性结构中。

• 参数：

​ • termios_p，指向保存有串口属性的结构。

​ • speed，波特率，取值同 4.3.3。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码

4.3.8 tcflush

• 作用：清空输出缓冲区、或输入缓冲区的数据，具体取决于参数 queue_selector。

• 参数：

​ • fd，串口设备的文件描述符。

​ • queue_selector，清空数据的操作。

• 返回：

​ • 成功，返回 0。

​ • 失败，返回-1，errnor 给出具体错误码。

说明

参数 queue_selector 的取值有三个：

TCIFLUSH：清空输入缓冲区的数据。

TCOFLUSH：清空输出缓冲区的数据。

TCIOFLUSH：同时清空输入/输出缓冲区的数据。