手把手教你搞定 nRF52 + Zephyr 的 UART 串口通信
你有没有遇到过这样的情况：代码写完，烧录成功，板子也通电了——结果串口助手却一片漆黑？或者输出一堆乱码，像是“烫烫烫”、“锘锘锘”那种？
别急，这几乎是每个在nRF52上跑Zephyr RTOS的开发者都会踩的坑。而问题的核心，往往就出在UART 配置上。
今天我们就来一次讲透：如何从零开始，在 nRF52 系列芯片（比如常见的 nRF52832、nRF52840）上正确配置并使用 UART，并通过 Zephyr 实现稳定可靠的串行通信。
为什么是 UART？它真的还重要吗？
在 BLE 满天飞的今天，你可能会问：“都 2025 年了，我们还需要 UART 吗？”
答案是：非常需要！
尽管蓝牙无线传输很酷，但在开发阶段，UART 依然是调试信息输出、日志追踪和与 PC 交互最直接、最可靠的方式。无论是打印变量值、查看系统状态，还是配合上位机做协议测试，UART 都是你手头那根“救命线”。
尤其是在资源受限的嵌入式系统中，Zephyr 提供了一套简洁高效的驱动模型，让硬件 UART 不仅能用，还能用得聪明——低功耗、高效率、可移植。
先搞清楚：nRF52 的 UART 到底是什么？
nRF52 系列并没有传统意义上的“UART”，而是使用了一个叫UARTE（Universal Asynchronous Receiver/Transmitter with EasyDMA）的增强型外设。
它强在哪？
- 支持高达 1 Mbps 的波特率
- 内建 FIFO 缓冲区
- 最关键的是：支持 EasyDMA—— 数据发送/接收无需 CPU 参与，自动搬运内存 ↔ 外设
- 可配置中断回调机制，实现异步非阻塞通信
- 支持 RTS/CTS 硬件流控，避免数据丢失
这意味着你可以一边发数据，一边处理 BLE 连接或传感器采集，互不干扰。
⚠️ 注意术语：在 Zephyr 中，即使你操作的是 UARTE，API 接口仍然叫做
uart_*，这是为了统一抽象层设计。
第一步：告诉 Zephyr —— 我要用 UART！
Zephyr 是怎么知道你要启用哪个 UART、接哪几个引脚的？靠的就是设备树（Device Tree, DTS）。
很多初学者卡住的地方不是代码，而是这个“看不见摸不着”的.dts文件。
设备树的本质
你可以把它理解为一份“硬件说明书”。它不写逻辑，只描述：
- 哪些外设要启用？
- 引脚怎么连？
- 默认参数是什么？
编译时，Zephyr 会根据这份说明书自动生成底层初始化代码。
如何修改设备树来启用 UART0？
假设你正在使用的是nRF52 DK 开发板（如 PCA10040），想把 UART0 的 TX 接到 P0.06，RX 接到 P0.08。
你需要编辑你的板级设备树文件：
boards/arm/nrf52dk_nrf52832/nrf52dk_nrf52832.dts添加或修改如下内容：
/ { aliases { serial-0 = &uart0; }; }; &uart0 { status = "okay"; current-speed = <115200>; tx-pin = <6>; rx-pin = <8>; };关键点解读：
| 字段 | 说明 |
|---|---|
aliases { serial-0 = &uart0; } | 给 uart0 起个别名，程序里可以用DT_ALIAS_SERIAL_0快速访问 |
status = "okay" | 必须加上！否则这个外设默认是禁用的 |
current-speed | 设置默认波特率，单位 bps |
tx-pin,rx-pin | 指定 GPIO 编号（注意是数字，不是 P0.06 写成 6） |
✅ 小贴士：nRF52 的 GPIO 编号就是 x，P0.x 的 x。所以 P0.06 →
6，P0.08 →8。
编译前必做：清理重建！
改了设备树后，千万记得：
west build -p auto -b nrf52dk_nrf52832加上-p auto是为了强制重新生成构建目录，确保新的 DTS 生效。
否则你会发现改了半天，串口还是没反应——很可能是因为旧配置还在缓存里。
第二步：写代码，让数据“说出去”和“听进来”
现在硬件已经准备好了，接下来就是在main.c里真正调用 API 发送和接收数据。
我们先从最简单的轮询模式开始，适合新手快速验证。
示例：轮询方式发送问候语 + 回显接收字符
#include <zephyr/kernel.h> #include <zephyr/device.h> #include <zephyr/drivers/uart.h> #include <zephyr/sys/printk.h> #define SLEEP_TIME_MS 100 void main(void) { const struct device *uart_dev; // 获取设备句柄（通过别名 serial-0） uart_dev = DEVICE_DT_GET(DT_ALIAS(serial_0)); if (!device_is_ready(uart_dev)) { printk("Error: UART device not ready\n"); return; } char tx_msg[] = "Hello from Zephyr! 🌟\r\n"; uint8_t rx_byte; while (1) { // 发送一串欢迎语 for (int i = 0; i < sizeof(tx_msg) - 1; i++) { uart_poll_out(uart_dev, tx_msg[i]); } // 尝试读一个字节 if (uart_poll_in(uart_dev, &rx_byte) == 0) { // 收到了！回传确认 uart_poll_out(uart_dev, 'Echo: '); uart_poll_out(uart_dev, rx_byte); uart_poll_out(uart_dev, '\r'); uart_poll_out(uart_dev, '\n'); } k_msleep(SLEEP_TIME_MS); } }关键函数解析：
| 函数 | 作用 |
|---|---|
DEVICE_DT_GET(DT_ALIAS(serial_0)) | 根据设备树别名获取设备指针，比硬编码更安全 |
device_is_ready() | 新版推荐检查设备是否已就绪，替代老旧的device_get_binding() |
uart_poll_out() | 轮询发送单字节，阻塞直到完成 |
uart_poll_in() | 轮询尝试接收，无数据立即返回-1 |
📌 这种方式简单直观，但有个缺点：CPU 一直忙等，不适合高速或长时间运行场景。
进阶玩法：用中断 + 回调实现高效通信
如果你要收发大量数据（比如上传传感器数据流），建议切换到中断模式或DMA 模式。
下面是一个典型的中断接收示例：
static uint8_t rx_buffer[64]; static struct k_fifo rx_fifo; void uart_callback(const struct device *dev, struct uart_event *evt, void *user_data) { switch (evt->type) { case UART_RX_RDY: // 有数据到达，放入 fifo k_fifo_put(&rx_fifo, (void *)evt->data.rx.buf); break; case UART_RX_DISABLED: // 如果因超时关闭，重新启用 uart_rx_enable(dev, rx_buffer, sizeof(rx_buffer), 100); break; default: break; } } void main(void) { const struct device *uart_dev = DEVICE_DT_GET(DT_ALIAS(serial_0)); if (!device_is_ready(uart_dev)) { printk("UART not ready\n"); return; } k_fifo_init(&rx_fifo); // 启用异步接收，缓冲区 + 超时（100ms） int err = uart_rx_enable(uart_dev, rx_buffer, sizeof(rx_buffer), 100); if (err) { printk("Failed to enable UART RX: %d\n", err); return; } // 注册回调 uart_callback_set(uart_dev, uart_callback, NULL); while (1) { uint8_t *data = k_fifo_get(&rx_fifo, K_FOREVER); if (data) { // 处理收到的数据包 printk("Received: %c\n", *data); } } }💡 这样做的好处是：CPU 在没有数据时可以去干别的事，只有真正收到数据才会被唤醒处理。
常见问题排查清单（收藏备用）
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 串口无任何输出 | UART 节点未启用 | 检查 DTS 中status = "okay" |
| 输出全是乱码 | 波特率不一致 | PC 端串口工具设置为 115200 8-N-1 |
| TX 有信号但 RX 不工作 | 引脚接反或未使能接收 | 检查 rx-pin 是否正确，调用uart_rx_enable() |
| 编译报错找不到设备 | 别名未定义 | 添加aliases { serial-0 = &uart0; } |
| 使用 J-Link RTT 后串口失效 | 日志输出冲突 | 修改prj.conf，关闭CONFIG_LOG_BACKEND_RTT |
| 引脚功能冲突 | 其他外设占用了 GPIO | 查阅 datasheet，确认该引脚支持 UARTE 功能 |
🔧 推荐调试工具组合：
- 串口助手：Tera Term / PuTTY / CoolTerm
- 波特率：115200
- 数据格式：8N1（8位数据，无校验，1位停止）
- 电平转换：确保连接的是3.3V 逻辑电平 USB-to-UART 模块（如 CP2102、FT232RL）
设计建议：让你的 UART 更健壮
优先使用别名（alias）
不要用&uart0硬编码，用DT_ALIAS(serial_0)提升可移植性。始终检查设备就绪状态
使用device_is_ready()防止空指针崩溃。合理选择通信模式
- 调试打印 → 轮询 +printk
- 小量命令交互 → 中断模式
- 大数据吞吐 → DMA + 环形缓冲结合 Zephyr Logging 子系统
替代裸printk，支持动态日志级别控制：
c #include <zephyr/logging/log.h> LOG_MODULE_REGISTER(my_uart_app, LOG_LEVEL_DBG);
- 低功耗场景注意电源域管理
若进入深度睡眠，需考虑是否保留 UART 供电域（PERIPHPOWER）以维持监听。
总结一下：打通 UART 的关键路径
要让 nRF52 上的 UART 正常工作，只需走通以下三步：
✅第一步：设备树声明
→ 启用uart0，设置引脚和波特率，定义别名
✅第二步：代码获取设备
→ 使用DEVICE_DT_GET(DT_ALIAS(...))获取句柄，检查是否 ready
✅第三步：调用 API 收发数据
→ 轮询、中断或 DMA，按需选择
只要这三个环节都对了，你的串口就不会再“沉默”。
写在最后
UART 看似古老，却是嵌入式世界的基石。它不像 BLE 那样炫酷，也不像 Wi-Fi 那样高速，但它足够简单、足够可靠。
当你第一次看到 “Hello from Zephyr!” 出现在串口助手中时，那种成就感，就像点亮第一个 LED 一样纯粹。
希望这篇教程能帮你少走弯路，快速建立起属于自己的调试通道。
如果你在实践中遇到了其他问题，比如多 UART 实例冲突、DMA 传输异常、或与 SoftDevice 共存问题，欢迎留言讨论，我们一起解决。
Happy coding！🚀
