UART
1. UART 简介
UART(Universal Asynchronous Receiver‑Transmitter,通用异步收发器)是嵌入式领域广泛使用的串行通信协议。UART 采用异步传输机制,收发双方不需要共用时钟信号,数据以逐位串行的方式进行传输,非常适用于短距离、低速率外设之间的数据交互。
在 Linux 操作系统中,UART 外设一般被注册为串口终端设备;串口设备文件通常以 /dev/tty* 或 /dev/serial/* 的路径命名,具体设备节点名称由硬件电路与内核驱动配置决定。
2. 串口测试(Shell)
2.1 串口引脚图
Luckfox Aura板载调试串口使用独立接口,启动参数中设备为 ttyFIQ0,默认波特率为 1500000。

2.2. 设备树配置
-
板级设备树路径:
<Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi -
以 UART6 M0 两线串口为例,新增配置:
&uart6 {pinctrl-names = "default";pinctrl-0 = <&uart6m0_xfer_pins>;status = "okay";}; -
编译内核:
sudo ./build.sh kernel
2.3 查看串口设备
在 /dev 目录下,每一路 UART 串口对应一个独立的字符设备文件。设备命名一般以 ttyS 搭配串口号生成,例如 /dev/ttyS2 代表第 2 路 UART 串口。
可执行以下命令查看系统内所有串口设备:
root@aura:~# ls /dev/ttyS*
/dev/ttyS2 /dev/ttyS6
2.4 设置串口
- 用stty工具查询其通信参数:
root@aura:~# stty -F /dev/ttyS6speed 9600 baud; line = 0;-brkint -imaxbel
- 修改波特率,其中ispeed为输入速率,ospeed为输出速率:
stty -F /dev/ttyS6 ispeed 115200 ospeed 115200
- 关闭回显:
stty -F /dev/ttyS6 -echo
3.与Windows主机通讯
-
将串口转接模块一端连接至电脑 USB 接口,另一端接线接入 LuckFox Aura 开发板,接线如下:
Luckfox Aura USB to UART 32 RX 33 TX 6 GND -
打开 MobaXterm 软件,新建串口 (Serial)会话;配置串口波特率,波特率为 115200,可根据实际修改后的串口参数进行调整。

-
在开发板上的终端执行以下指令,使用 echo 命令向终端设备文件写入字符串"Hello"和"world !":
# echo Hello > /dev/ttyS6# echo "world !" > /dev/ttyS6 -
Windows 上的串口调试助手会接收到内容:
4. 串口通信(Python程序)
-
完整代码:
import serialport = serial.Serial(port="/dev/ttyS6",baudrate=115200,bytesize=serial.EIGHTBITS,parity=serial.PARITY_NONE,stopbits=serial.STOPBITS_ONE,timeout=3)try:port.write(b"Luckfox Aura UART test\r\n")buf = port.read(128)if buf:date = buf.decode("utf-8")print(f"Read {len(buf)} bytes:\n{date}")else:print("No data received (timeout)")finally:port.close() -
打开并配置串口:
port = serial.Serial(port="/dev/ttyS6",baudrate=115200,bytesize=serial.EIGHTBITS,parity=serial.PARITY_NONE,stopbits=serial.STOPBITS_ONE,timeout=3)打开指定串口,并设置波特率和超时时间。
-
发送和接收数据:
port.write(b"Luckfox Aura UART test\r\n")buf = port.read(128)通过串口发送测试字符串,并读取一行返回数据。
-
运行程序:
python3 uart.py运行结果:
5. 串口通信(C程序)
-
完整代码:
#include <errno.h>#include <fcntl.h>#include <stdio.h>#include <string.h>#include <termios.h>#include <unistd.h>static ssize_t read_line(int fd, char *buffer, size_t size){size_t length = 0;while (length + 1 < size) {ssize_t result = read(fd, &buffer[length], 1);if (result < 0) {if (errno == EINTR)continue;return -1;}if (result == 0)break;if (buffer[length++] == '\n')break;}buffer[length] = '\0';return (ssize_t)length;}int main(void){int fd = open("/dev/ttyS6", O_RDWR | O_NOCTTY);if (fd < 0) {perror("open");return 1;}struct termios tty;if (tcgetattr(fd, &tty) < 0) {perror("tcgetattr");close(fd);return 1;}cfmakeraw(&tty);cfsetispeed(&tty, B115200);cfsetospeed(&tty, B115200);tty.c_cflag &= ~(CSIZE | PARENB | CSTOPB);tty.c_cflag |= CS8 | CLOCAL | CREAD;#ifdef CRTSCTStty.c_cflag &= ~CRTSCTS;#endiftty.c_cc[VMIN] = 0;tty.c_cc[VTIME] = 30;if (tcsetattr(fd, TCSANOW, &tty) < 0) {perror("tcsetattr");close(fd);return 1;}const char *message = "Luckfox Aura UART test\r\n";if (write(fd, message, strlen(message)) < 0) {perror("write");close(fd);return 1;}tcdrain(fd);char buffer[128] = {0};ssize_t length = read_line(fd, buffer, sizeof(buffer));if (length < 0) {perror("read");close(fd);return 1;}if (length > 0) {printf("RX: ");fwrite(buffer, 1, (size_t)length, stdout);if (buffer[length - 1] != '\n')putchar('\n');} else {printf("RX: (no data)\n");}close(fd);return 0;} -
打开串口:
int fd = open("/dev/ttyS6", O_RDWR | O_NOCTTY);以读写方式打开串口设备,并避免将该设备作为控制终端。
-
配置串口:
struct termios tty;tcgetattr(fd, &tty);cfmakeraw(&tty);cfsetispeed(&tty, B115200);cfsetospeed(&tty, B115200);tty.c_cflag &= ~(CSIZE | PARENB | CSTOPB);tty.c_cflag |= CS8 | CLOCAL | CREAD;#ifdef CRTSCTStty.c_cflag &= ~CRTSCTS;#endiftty.c_cc[VMIN] = 0;tty.c_cc[VTIME] = 30;tcsetattr(fd, TCSANOW, &tty);cfmakeraw()将串口设置为原始数据传输模式;cfsetispeed()和cfsetospeed()将输入、输出波特率设置为 115200;CS8配置 8 个数据位,清除PARENB和CSTOPB后使用无校验、1 个停止位,即 8N1;CLOCAL | CREAD忽略调制解调器控制线并启用数据接收,清除CRTSCTS后关闭 RTS/CTS 硬件流控;VMIN = 0、VTIME = 30表示读取操作最多等待 3 秒,没有收到数据时返回;tcsetattr()将配置立即应用到串口设备。
-
发送和接收数据:
write(fd, message, strlen(message));tcdrain(fd);ssize_t length = read_line(fd, buffer, sizeof(buffer));发送测试字符串,等待数据发送完成,然后读取一行返回数据。读取到换行符时结束;3 秒内没有收到数据时输出
RX: (no data)。 -
交叉编译:
export PATH=<Luckfox_Aura_SDK>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin:$PATHaarch64-rockchip1240-linux-gnu-gcc UART.c -o UART