跳到主要内容

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. 设备树配置​

  1. 板级设备树路径:

    <Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi
  2. 以 UART6 M0 两线串口为例,新增配置:

    &uart6 {
    pinctrl-names = "default";
    pinctrl-0 = <&uart6m0_xfer_pins>;
    status = "okay";
    };
  3. 编译内核:

    sudo ./build.sh kernel

2.3 查看串口设备​

在 /dev 目录下,每一路 UART 串口对应一个独立的字符设备文件。设备命名一般以 ttyS 搭配串口号生成,例如 /dev/ttyS2 代表第 2 路 UART 串口。

可执行以下命令查看系统内所有串口设备:

root@aura:~# ls /dev/ttyS*
/dev/ttyS2 /dev/ttyS6

2.4 设置串口​

  1. 用stty工具查询其通信参数:
    root@aura:~# stty -F /dev/ttyS6
    speed 9600 baud; line = 0;
    -brkint -imaxbel
  2. 修改波特率,其中ispeed为输入速率,ospeed为输出速率:
    stty -F /dev/ttyS6 ispeed 115200 ospeed 115200
  3. 关闭回显:
    stty -F /dev/ttyS6 -echo

3.与Windows主机通讯​

  1. 将串口转接模块一端连接至电脑 USB 接口,另一端接线接入 LuckFox Aura 开发板,接线如下:

    Luckfox AuraUSB to UART
    32RX
    33TX
    6GND
  2. 打开 MobaXterm 软件,新建串口 (Serial)会话;配置串口波特率,波特率为 115200,可根据实际修改后的串口参数进行调整。

  3. 在开发板上的终端执行以下指令,使用 echo 命令向终端设备文件写入字符串"Hello"和"world !":

    # echo Hello > /dev/ttyS6
    # echo "world !" > /dev/ttyS6
  4. Windows 上的串口调试助手会接收到内容:

4. 串口通信(Python程序)​

  1. 完整代码:

    import serial

    port = 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()
  2. 打开并配置串口:

    port = serial.Serial(
    port="/dev/ttyS6",
    baudrate=115200,
    bytesize=serial.EIGHTBITS,
    parity=serial.PARITY_NONE,
    stopbits=serial.STOPBITS_ONE,
    timeout=3
    )

    打开指定串口,并设置波特率和超时时间。

  3. 发送和接收数据:

    port.write(b"Luckfox Aura UART test\r\n")
    buf = port.read(128)

    通过串口发送测试字符串,并读取一行返回数据。

  4. 运行程序:

    python3 uart.py

    运行结果:

5. 串口通信(C程序)​

  1. 完整代码:

    #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 CRTSCTS
    tty.c_cflag &= ~CRTSCTS;
    #endif
    tty.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;
    }
  2. 打开串口:

    int fd = open("/dev/ttyS6", O_RDWR | O_NOCTTY);

    以读写方式打开串口设备,并避免将该设备作为控制终端。

  3. 配置串口:

    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 CRTSCTS
    tty.c_cflag &= ~CRTSCTS;
    #endif

    tty.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() 将配置立即应用到串口设备。
  4. 发送和接收数据:

    write(fd, message, strlen(message));
    tcdrain(fd);
    ssize_t length = read_line(fd, buffer, sizeof(buffer));

    发送测试字符串,等待数据发送完成,然后读取一行返回数据。读取到换行符时结束;3 秒内没有收到数据时输出 RX: (no data)。

  5. 交叉编译:

    export PATH=<Luckfox_Aura_SDK>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin:$PATH
    aarch64-rockchip1240-linux-gnu-gcc UART.c -o UART