当前文档版本为 v0.9.1，您可以访问当前页面的 开发中 版本以获取最近可能的更新。

Driver: UART FIFO

1 功能概述

本例程演示了 Zephyr UART (Serial) Driver 的基本使用方法。

2 环境要求

  • PAN1080 EVB 一块

  • USB-TypeC 线一条（用于供电和查看串口打印 Log）

  • 硬件接线：

    • 使用 USB 线，将 PC USB 与 EVB USB-TypeC（USB->UART）相连

    • 根据 EVB 核心板芯片的封装不同，使用杜邦线将 EVB 底板上的:

      • TX0 与 P00 相连， RX0 与 P01 相连（若 EVB 板芯片为 QFN32 或 LQFP64 封装）

      • TX0 与 P30 相连， RX0 与 P31 相连（若 EVB 板芯片为 QFN48 封装）

    • 另准备一个 USB 转串口模块，将其：

      • RX 连到芯片 P06 (UART1-Tx) 引脚，TX 连到芯片 P07 (UART1-Rx) 引脚（若 EVB 板芯片为 QFN32 或 LQFP64 封装）

      • RX 连到芯片 P14 (UART1-Tx) 引脚，TX 连到芯片 P15 (UART1-Rx) 引脚（若 EVB 板芯片为 QFN48 封装）

  • PC 软件: 串口调试助手（UartAssist）或终端工具（SecureCRT）

3 编译和烧录

例程位置：zephyr\samples_panchip\drivers\uart\uart_fifo

使用 ZAL 工具可以对其进行编译、烧录、打开 VS Code 调试等操作。关于 ZAL 工具的详细介绍请参考：Zephyr APP Launcher 工具介绍。

4 演示说明

  1. 首先在 PC 上打开 2 个串口终端：

    • 第一个选择与芯片 P00/P01 (UART0) 相连的串口号，波特率配置为 921600，用于显示 Log 打印

    • 第二个选择与芯片 P06/P07 (UART1) 相连的串口号，波特率配置为 115200，用作待测 UART 交互

  2. 成功编译烧录程序后，按 EVB 板上的复位按钮，执行芯片复位，可以看到第一个串口终端打印了如下的 Log：

    *** Booting Zephyr OS build zephyr-v2.7.0  ***
Start uart fifo demo..
UART configure done, exit main thread.

  3. 然后向第二个串口终端发送 1234567890asdfghjklzxcvbnm\n 并回车，可以看到接收界面随后显示了 1234567890asdfghjklzxcvbnm，说明例程成功从 UART1 Rx 引脚接收到了数据，并转发到 UART1 Tx 引脚，最终发送到 PC 终端。

    image

    UART FIFO 例程演示

5 开发说明

5.1 使能 UART Driver

  • 确认 CONFIG_UART=y，以将 UART Driver 正确加入编译

  • 确认 Devicetree 或 DTS Overlay 配置文件中 UART 模块的：

    • status 属性值为 okay，以确保系统在启动阶段能正确初始化 UART 模块

    • pinctrl-0 属性中正确配置了 pinmux 引脚参数

    /* pan108xxb5_evb.dts */
...
&uart0 {
	current-speed = <921600>;
	pinctrl-0 = <&p0_0_uart0_tx &p0_1_uart0_rx>;
	status = "okay";
};

&uart1 {
	current-speed = <115200>;
	pinctrl-0 = <&p0_6_uart1_tx &p0_7_uart1_rx>;
	status = "okay";
};
...

5.2 确认 UART 初始化成功

const struct device *uart0 = DEVICE_DT_GET(DT_NODELABEL(uart0));

if (!device_is_ready(uart0)) {
    printk("uart devices not ready\n");
    return;
}

5.3 配置 UART 通信参数

  • 配置串口的波特率、校验位、停止位、数据位和流控：

    #define BAUDRATE			115200

const struct uart_config uart_cfg = {
	.baudrate = BAUDRATE,
	.parity = UART_CFG_PARITY_NONE,
	.stop_bits = UART_CFG_STOP_BITS_1,
	.data_bits = UART_CFG_DATA_BITS_8,
	.flow_ctrl = UART_CFG_FLOW_CTRL_NONE
};

  • 串口配置读取与设置：

    uart_config_get(uart0, &uart_cfg_check);
if(uart_cfg_check.baudrate != BAUDRATE) {
    uart_configure(uart0, &uart_cfg);
}

5.4 UART中断回调和使能

  • 中断回调注册：

    uart_irq_callback_set(uart0, uart_fifo_callback);

  • 使能UART TRX：

    uart_irq_tx_enable(uart0);
uart_irq_rx_enable(uart0);

  • TX的逻辑处理：

    static void tx_isr(const struct device *dev)
{
	static uint8_t tx_index = 0;
	int len;

	if(tx_index >= data_len) {
		uart_irq_tx_disable(dev);
		uart_irq_rx_enable(dev);
		tx_index = 0;
	} else {
		len = uart_fifo_fill(dev, fifo_data + tx_index, (data_len - tx_index));
		tx_index += len;
		if(tx_index >= BUFFER_SIze) {
			tx_index = 0;
		}
	}
}

    将tx的数据写到fifo中，直到所有的数据都写完，然后关闭tx，使能rx，等待数据接收。fifo的最大深度为16。

  • RX的逻辑处理：

    static void rx_isr(const struct device *dev)
{
	static uint8_t rx_index = 0;

	uart_fifo_read(dev, fifo_data + rx_index, 1);
	if ((fifo_data[rx_index] == '\n') || (fifo_data[rx_index] == '\r')) {
		uart_irq_rx_disable(dev);
		data_len = rx_index + 1;
		rx_index = 0;
		uart_irq_tx_enable(dev);
	} else {
		rx_index ++;
		if(rx_index >= BUFFER_SIze) {
			rx_index = 0;
		}
	}
}

    将串口工具发过来的数据保存到“fifo_data”，每次接收一个数据，直到出现换行符，停止接收。然后将接收的数据原封不动的发送给串口工具。

6 RAM/Flash资源使用情况

Memory region         Used Size  Region Size  %age Used
FLASH:       19084 B       256 KB      7.28%
SRAM:        4232 B        64 KB      6.46%

7 Uart全功能测试case

Uart全功能测试case及测试流程请参考文档：03_MCU/mcu_samples_doc/PAN1080 UART 例程说明.pdf