通用异步收发器（UART）

概述

Zephyr 提供三种访问 UART 外设的方式。根据所选方式，使用的 API 函数也有所不同，具体参见以下各节：

轮询是访问 UART 外设最基本的方式。读取函数 uart_poll_in() 是非阻塞函数，会返回一个字符；没有有效数据时，返回 -1 。写入函数 uart_poll_out() 是阻塞函数，线程会等待，直到给定字符发送完毕。

使用中断驱动 API 时，可能较慢的通信可以在后台进行，而线程可以继续执行其他任务。内核的数据传递功能可用于线程与 UART 驱动之间的通信。

异步 API 允许使用 DMA 在后台读写数据，完全无需中断 MCU。不过，其配置比其他方式更复杂。

警告

对于同一个硬件外设，不应同时使用中断驱动 API 和异步 API，因为这两种 API 都需要硬件中断才能正常工作。同时使用这两种 API 的回调会导致相互干扰。CONFIG_UART_EXCLUSIVE_API_CALLBACKS 默认启用，以确保同一时刻只有一种 API 的回调处于活动状态。

最重要的是，Kconfig 选项决定了是否可以使用轮询 API（默认）、中断驱动 API 或异步 API。为尽量减少内存占用，请仅启用所需的功能。

Related code samples

802.15.4 "serial-radio"Implement a slip-radio device for Contiki-based border routers.
AT Command ClientCreate a bidirectional UART bridge between console and modem for AT command communication.
Console over USB CDC ACMOutput "Hello World!" to the console over USB CDC ACM.
HCI 3-wire (H:5)Expose a Bluetooth controller to another device or CPU over H5:HCI transport.
HCI UARTExpose a Bluetooth controller to another device or CPU over UART.
HCI UART asyncExpose a Bluetooth controller to another device or CPU over asynchronous UART.
Legacy USB CDC ACM UART sampleUse USB CDC ACM UART driver to implement a serial port echo.
Native TTY UARTUse native TTY driver to send and receive data between two UART-to-USB bridge dongles.
Single-wire UARTUse single-wire/half-duplex UART functionality of STM32 devices.
UART ASYNC APIDemonstrate the use of the asynchronous API
UART circular modeRead data from the console and echo it back using a circular DMA configuration.
UART echoRead data from the console and echo it back.
UART PassthroughPass data directly between the console and another UART interface.
USB CDC ACM UART sampleUse USB CDC ACM UART driver to implement a serial port echo.
USB CDC-ACM bridgeUse USB CDC-ACM driver to implement a serial port bridge.