UART 串口通信

这一章让 ESP32 学会和另一个设备“说话”，哪怕只是先把对方发来的字原样回一句。

UART 是最朴素也最常用的通信方式之一。GPS、蓝牙串口模块、AT 指令模块和很多调试接口都会用 UART。它像设备之间的短信通道，简单，但非常常见。

直觉

UART 像两个人轮流说话：TX 负责发送，RX 负责接收。自己的 TX 要接对方 RX，自己的 RX 要接对方 TX，双方还要约定同样的波特率。

准备工作

准备一个 USB-TTL 模块或另一块开发板作为串口对端。连接 TX、RX 和 GND，不要忘记共地。确认对端电平是 3.3 V TTL，避免把 5 V 信号直接接入 GPIO。

最小例程

对应工程：examples/uart_echo。

uart_driver_install(UART_NUM_1, 512, 0, 0, NULL, 0);
uart_param_config(UART_NUM_1, &uart_config);
uart_set_pin(UART_NUM_1, CONFIG_UART_TX_GPIO, CONFIG_UART_RX_GPIO,
             UART_PIN_NO_CHANGE, UART_PIN_NO_CHANGE);

运行后从对端串口发送任意字节，开发板会原样回传。这个回显实验能帮你确认波特率、TX/RX 交叉和缓冲区收发。

速率与边界

UART 常见波特率有 9600、115200、460800、921600。波特率越高，对线长、电平转换、时钟误差和干扰越敏感。入门调试优先使用 115200，因为工具支持好、问题容易排查。

UART 是字节流，没有天然的“消息边界”。真实协议要自己定义帧头、长度、校验、超时和重发策略。不要以为 read_bytes 一次读到的就是一条完整命令。

应用场景

UART 常用于调试日志、GPS 模块、蜂窝通信模块、蓝牙串口模块、外部 MCU 通信和产测接口。它简单可靠，但不适合多设备共享同一总线，也不适合大量并发节点通信。

常见错误

没有数据时，先检查 TX/RX 是否交叉，GND 是否连接。乱码通常来自波特率不一致。真实项目中，UART 上层还会有协议：帧头、长度、校验和超时都需要单独设计。

官方资料

• UART API 参考

本章提示词

请帮我设计一个 ESP32 UART 回显实验。要求说明 TX/RX/GND 接线、波特率、缓冲区、超时、串口工具设置，并给出从回显走向简单协议解析的下一步练习。