注意

这是最新开发分支配套的文档，可能包含已发布版本中尚未提供的功能。如果您要查看特定版本的文档，请使用左侧的下拉菜单并选择所需要的版本。

UART 使用教程

目录

UART 使用教程#

什么是 UART？#

UART（通用异步收发传输器） 是一种常见的串口通信协议，用于在设备间通过串行方式发送与接收数据。广泛用于：

串口终端调试
与传感器或外部模块通信（如 GPS、GSM 模块）
主从设备之间的数据交换

K230 UART 特性#

特性	描述
支持通道数量	5 路 UART：UART0 ~ UART4
可用通道说明	UART0被系统调试占用，UART1、2、3、4 可用
可配置参数	波特率、数据位、停止位、校验位等
引脚复用	支持通过 IOMUX 设置任意 IO 为 UART 功能
数据操作方式	支持 `write()`、`read()`、`readline()`、`readinto()` 等方法

应用示例：串口收发测试#

以下示例展示如何初始化 UART1 接口，进行数据的发送与接收操作。

示例代码#

from machine import UART

# ========== 初始化 UART1 ==========
u1 = UART(
    UART.UART1,           # UART1 通道
    baudrate=115200,      # 波特率 115200
    bits=UART.EIGHTBITS,  # 数据位 8 位
    parity=UART.PARITY_NONE,  # 无校验
    stop=UART.STOPBITS_ONE    # 停止位 1 位
)

# ========== 发送数据 ==========
u1.write("UART1 test")  # 发送字符串

# ========== 读取数据 ==========
r = u1.read()            # 读取接收到的字节数据（可能为 None）
r = u1.readline()        # 读取一整行数据（以换行符结尾）
b = bytearray(8)
u1.readinto(b)           # 将接收到的数据填充到 bytearray 中

# ========== 释放资源 ==========
u1.deinit()

接口说明#

方法名	说明
`UART()`	创建 UART 对象，指定通道号和通信参数
`write(data)`	向串口写入字符串或字节数据
`read()`	读取所有可用数据，返回字节对象或 None
`readline()`	读取一行数据，以换行符 `\n` 结尾
`readinto(buf)`	将数据读入指定的缓冲区（如 `bytearray`）
`deinit()`	停止串口并释放资源

应用场景举例#

串口调试输出：替代 print()，便于外部设备监听日志
与串口模块通信：如蓝牙、LoRa、4G 模块
多串口并发任务处理：通过 UART1/2/4 连接多个外设

常见问题排查#

问题	排查建议
无法接收到数据	检查波特率设置、IO 映射是否正确
接收数据乱码	确认两端的通信参数一致（波特率、数据位等）
读取结果为 None	串口缓冲区中没有可读数据
无法使用 UART0/UART3	这两个通道为系统占用，建议使用 UART1/2/4

延伸阅读#