Linux串口编程

在嵌入式应用领域中,串口是最为常见的一种硬件通信接口。因为其具备协议简单,硬件电路精简等优势使得串口基本成为MCU、计算机或嵌入式产品的标配接口。本文仅介绍在Linux系统下串口编程需要使用的API和一些应用技巧,关于串口的背景知识介绍,以及Windows系统下串口编程读者可以移步至其他文章。

Linux系统下串口的操作主要分为如下部分:

  • 串口打开、关闭
  • 串口参数设置
  • 串口数据发送与接收
  • 串口MODEM信号设置与读取
  • 串口Break信号发送

 

可以熟练掌握并应用以上串口功能已经可以应对Linux系统上串口应用的大多数场景了,针对更高级的串口用法可以阅读《Linux串口编程-进阶篇》,包含Linux系统使用非标准波特率、同步等待Modem信号变化、串口参数VTIME和VMIN的作用、RS485串口功能开关等。为方便用户使用我们将以上串口操作均封装成了独立的函数,可以极大的节约开发时间。

1、串口打开

    /**
     * libtty_open - open tty device
     * @devname: the device name to open
     *
     * In this demo device is opened blocked, you could modify it at will.
     */
    static int libtty_open(const char *devname)
    {
    	int fd = open(devname, O_RDWR | O_NOCTTY | O_NDELAY);
    	int flags = 0;
     
    	if (fd < 0) {
    		perror("open device failed");
    		return -1;
    	}
        /* 恢复串口为阻塞状态 */
    	flags = fcntl(fd, F_GETFL, 0);
    	flags &= ~O_NONBLOCK;
    	if (fcntl(fd, F_SETFL, flags) < 0) {
    		printf("fcntl failed.\n");
    		return -1;
    	}
        /* 测试该设备是否为tty设备 */
    	if (isatty(fd) == 0) {
    		printf("not tty device.\n");
    		return -1;
    	} else
    		printf("tty device test ok.\n");
     
    	return fd;
    }

 

Note:

  • devname 参数为设备绝对路径,如:“/dev/ttyUSB0”
  • O_NOCTTY标志用于通知系统,这个程序不会成为对应这个设备的控制终端。如果没有指定这个标志,那么任何一个输入(如SIGINT等)都将会影响用户的进程;
  • O_NDELAY标志与O_NONBLOCK 等效,但这里不仅仅是设置为非阻塞,还用于通知系统,这个程序不关心 DCD 信号线所处的状态(即与设备相连的另一端是否激活或者停止)。如果用户指定了这一标志,则进程将会一直处在休眠状态,直到 DCD 信号线被激活;

2、串口关闭

    /**
     * libtty_close - close tty device
     * @fd: the device handle
     *
     * The function return 0 if success, others if fail.
     */
    static int libtty_close(int fd)
    {
    	return close(fd);
    }

3、串口设置

    /**
     * libtty_setopt - config tty device
     * @fd: device handle
     * @speed: baud rate to set
     * @databits: data bits to set
     * @stopbits: stop bits to set
     * @parity: parity to set
     * @hardflow: hardflow to set
     *
     * The function return 0 if success, or -1 if fail.
     */
    static int libtty_setopt(int fd, int speed, int databits, int stopbits, char parity, char hardflow)
    {
    	struct termios newtio;
    	struct termios oldtio;
    	int i;
     
    	bzero(&newtio, sizeof(newtio));
    	bzero(&oldtio, sizeof(oldtio));
     
        /* 先保存之前配置,以防后续步骤出错无法恢复 */
    	if (tcgetattr(fd, &oldtio) != 0) {
    		perror("tcgetattr");
    		return -1;
    	}
    	newtio.c_cflag |= CLOCAL | CREAD;
    	newtio.c_cflag &= ~CSIZE;
     
        /* 串口波特率设置*/
        switch (speed): {
        case 1200:
            cfsetspeed(&newtio, B1200);
            break;
        case 2400:
            cfsetspeed(&newtio, B2400);
            break;
        case 4800:
            cfsetspeed(&newtio, B4800);
            break;
        case 9600:
            cfsetspeed(&newtio, B9600);
            break;
        case 19200:
            cfsetspeed(&newtio, B19200);
            break;
        case 38400:
            cfsetspeed(&newtio, B38400);
            break;
        case 57600:
            cfsetspeed(&newtio, B57600);
            break;
        case 115200:
            cfsetspeed(&newtio, B115200);
            break;
        case 230400:
            cfsetspeed(&newtio, B230400);
            break;
        case 460800:
            cfsetspeed(&newtio, B460800);
            break;
        case 921600:
            cfsetspeed(&newtio, B921600);
            break;
        default:
            break;
        }
    	for (i = 0; i < sizeof(speed_arr) / sizeof(int); i++) {
    		if (speed == name_arr[i]) {      
    			cfsetispeed(&newtio, speed_arr[i]); 
    			cfsetospeed(&newtio, speed_arr[i]);   
    		} 
    	}
    	/* 数据位设置 */
    	switch (databits) {
    	case 5:
    		newtio.c_cflag |= CS5;
    		break;
    	case 6:
    		newtio.c_cflag |= CS6;
    		break;
    	case 7:
    		newtio.c_cflag |= CS7;
    		break;
    	case 8:
    		newtio.c_cflag |= CS8;
    		break;
    	default:
    		fprintf(stderr, "unsupported data size\n");
    		return -1;
    	}
     
    	/* 校验位设置 */
    	switch (parity) {
    	case 'n':
    	case 'N':
    		newtio.c_cflag &= ~PARENB;    /* Clear parity enable */
    		newtio.c_iflag &= ~INPCK;     /* Disable input parity check */
    		break;
    	case 'o':
    	case 'O':
    		newtio.c_cflag |= (PARODD | PARENB); /* Odd parity instead of even */
    		newtio.c_iflag |= INPCK;     /* Enable input parity check */
    		break;
    	case 'e':
    	case 'E':
    		newtio.c_cflag |= PARENB;    /* Enable parity */
    		newtio.c_cflag &= ~PARODD;   /* Even parity instead of odd */
    		newtio.c_iflag |= INPCK;     /* Enable input parity check */
    		break;
    	case 'm':
    	case 'M':
    		newtio.c_cflag |= PARENB;    /* Enable parity */
    		newtio.c_cflag |= CMSPAR;    /* Stick parity instead */
    		newtio.c_cflag |= PARODD;    /* Even parity instead of odd */
    		newtio.c_iflag |= INPCK;     /* Enable input parity check */
    		break;
    	case 's':
    	case 'S':
    		newtio.c_cflag |= PARENB;    /* Enable parity */
    		newtio.c_cflag |= CMSPAR;    /* Stick parity instead */
    		newtio.c_cflag &= ~PARODD;   /* Even parity instead of odd */
    		newtio.c_iflag |= INPCK;     /* Enable input parity check */
    		break;
    	default:
    		fprintf(stderr, "unsupported parity\n");
    		return -1;
    	}
     
    	/* 停止位设置 */
    	switch (stopbits) {
    	case 1:
    		newtio.c_cflag &= ~CSTOPB;
    		break;
    	case 2:
    		newtio.c_cflag |= CSTOPB;
    		break;
    	default:
    		perror("unsupported stop bits\n");
    		return -1;
    	}
     
        /* 硬件流控设置 */
    	if (hardflow)
    		newtio.c_cflag |= CRTSCTS;
    	else
    		newtio.c_cflag &= ~CRTSCTS;
     
        /* 串口读操作参数设置 */
    	newtio.c_cc[VTIME] = 10;	/* Time-out value (tenths of a second) [!ICANON]. */
    	newtio.c_cc[VMIN] = 0;	/* Minimum number of bytes read at once [!ICANON]. */
     
        /* 刷新串口缓冲区 */
    	tcflush(fd, TCIOFLUSH);
     
        /* 设置 */
    	if (tcsetattr(fd, TCSANOW, &newtio) != 0) {
    		perror("tcsetattr");
    		return -1;
    	}
     
    	return 0;
    }

常规串口参数的设置均可以通过如上函数进行设定,注释比较详细。

包括串口波特率、数据位、停止位、硬件流控设置等。

4、串口发送

    /**
     * libtty_write - write data to uart
     * @fd: file descriptor of tty device
     * @buf: buffer to write
     * @count: write length
     *
     * The function return the number of bytes written if success, others if fail.
     */
    static int libtty_write(int fd, char *buf, int count)
    {
        return write(fd, buf, count);
    }

5、串口读取

    /**
     * libtty_read - read data from uart
     * @fd: file descriptor of tty device
     * @buf: pointer to read buffer
     * count: read length
     *
     * The function return the number of bytes read if success, others if fail.
     */
    static int libtty_read(int fd, char *buf, int count)
    {
    	return read(fd, buf, count);
    }

6、串口MODEM设置

    /**
     * libtty_tiocmset - modem set
     * @fd: file descriptor of tty device
     * @bDTR: 0 on inactive, other on DTR active
     * @bRTS: 0 on inactive, other on RTS active
     *
     * The function return 0 if success, others if fail.
     */
    static int libtty_tiocmset(int fd, char bDTR, char bRTS)
    {
    	unsigned long controlbits = 0;
     
    	if (bDTR)
    		controlbits |= TIOCM_DTR;
    	if (bRTS)
    		controlbits |= TIOCM_RTS;
     
    	return ioctl(fd, TIOCMSET, &controlbits);
    }

MODEM输出信号包括DTR和RTS信号,这2个信号可以由串口应用进行控制,常用于下载或IO控制等。

针对TTL/CMOS串口,DTR和RTS无效时为高电平,有效时为高电平。

7、串口MODEM读取

    /**
     * libtty_tiocmget - modem get
     * @fd: file descriptor of tty device
     * @modembits: pointer to modem status
     *
     * The function return 0 if success, others if fail.
     */
    static int libtty_tiocmget(int fd, unsigned long *modembits)
    {
    	int ret;
     
    	ret = ioctl(fd, TIOCMGET, modembits);
    	if (ret == 0) {
    		if (*modembits & TIOCM_DSR)
    			printf("DSR Active!\n");
    		if (*modembits & TIOCM_CTS)
    			printf("CTS Active!\n");
    		if (*modembits & TIOCM_CD)
    			printf("DCD Active!\n");
    		if (*modembits & TIOCM_RI)
    			printf("RI Active!\n");
    	}
     
    	return ret;
    }

MODEM输出信号包括DSR、CTS、DCD和RI信号,这4个信号可以由串口应用主动读取其有效状态,常用于状态指示或同步等。

针对TTL/CMOS串口,DSR、CTS、DCD和RI无效时为高电平,有效时为高电平。

8、串口Break信号

    /**
     * libtty_sendbreak - uart send break
     * @fd: file descriptor of tty device
     *
     * Description:
     *  tcsendbreak() transmits a continuous stream of zero-valued bits for a specific duration, if the  termi©\
     *	nal is using asynchronous serial data transmission.  If duration is zero, it transmits zero-valued bits
     *	for at least 0.25 seconds, and not more that 0.5 seconds.  If duration is not zero, it sends  zero-val©\
     *	ued bits for some implementation-defined length of time.
     *
     *  If  the terminal is not using asynchronous serial data transmission, tcsendbreak() returns without tak©\
     *	ing any action.
     */
    static int libtty_sendbreak(int fd)
    {
    	return tcsendbreak(fd, 0);
    }

串口Break信号在一些特定场景下会使用到,针对TTL/CMOS串口而言,串口Break是指串口的TXD保持一定时间的低电平。常见于一些实验仪器需要使用Break信号作为有效的开始信号。需要注意:tcsendbreak的第二个参数填0,表示串口TXD持续低电平0.25s~0.5s,如果参数为非0值,则持续参数中指定的时间。

posted @ 2022-07-25 09:34  WCH_SoftGroup  阅读(1189)  评论(0编辑  收藏  举报