3. 串口通信基础：UART协议原理、ESP32硬件串口资源、Serial库函数详解、串口打印调试信息

各位同学，咱们今天聊串口。说实话，做嵌入式开发这么多年，串口是我打交道最多的外设，没有之一。你想想看，从最早的单片机调试，到现在的ESP32智能门锁，串口就像工程师的“听诊器”——没有它，你根本不知道芯片内部在干什么。

3.1 UART协议原理：说白了就是两根线的事

UART，全称Universal Asynchronous Receiver/Transmitter，通用异步收发器。名字挺唬人，其实原理很简单。

它只需要两根数据线：

  • TXD：发送端（Transmit Data）
  • RXD：接收端（Receive Data）

注意啊，这里有个坑：两个设备的TXD和RXD要交叉连接。也就是A的TXD接B的RXD，A的RXD接B的TXD。我刚开始学的时候，直接TXD接TXD，结果怎么都收不到数据，折腾了半天才发现接反了。嗯，这种低级错误，估计很多人都犯过。

异步通信是什么意思？

说白了，就是没有单独的时钟线。发送方和接收方各自用自己的时钟，但必须约定好相同的“波特率”。波特率就是每秒传输的比特数，常见的有9600、115200等。我个人的习惯是，能用115200就不用9600，因为速度快，调试时响应更及时。

数据帧格式：

UART传输一个字节，通常包含以下部分：

  • 起始位：1位，逻辑0，告诉接收方“我要开始发了”
  • 数据位：5~8位，通常是8位（一个字节）
  • 校验位：可选，奇校验或偶校验，用于简单检错
  • 停止位：1位或2位，逻辑1，表示传输结束

重点记忆：最常用的配置是8N1——8位数据位、无校验、1位停止位。ESP32默认就是这个配置。

3.2 ESP32硬件串口资源：三个串口够用吗？

ESP32内置了3个UART控制器，分别叫UART0、UART1、UART2。每个控制器都可以独立配置波特率、数据位、停止位等参数。

串口编号 默认TX引脚 默认RX引脚 备注
UART0 GPIO1 GPIO3 通常用于串口监视器（与USB转串口芯片相连）
UART1 GPIO10 GPIO9 可自由映射到其他GPIO
UART2 GPIO17 GPIO16 可自由映射到其他GPIO

这里有个重要的事情要提醒大家：UART0默认被USB转串口占用了。你在Arduino IDE里打开串口监视器，看到的就是UART0的数据。所以如果你要用UART0连接其他设备，比如指纹模块，就得小心了——因为串口监视器也在用同一个串口。

避坑指南：我曾经在一个项目里，把指纹模块接在UART0上，结果串口监视器打印乱码，指纹模块也不工作。后来才发现，两个设备抢同一个串口，数据全乱了。解决方案很简单：指纹模块用UART2，UART0留给调试用。

ESP32还有一个很牛的特性：串口引脚可以任意映射。也就是说，你可以把UART2的TX和RX分配到任何空闲的GPIO上。这在我们做智能门锁时特别有用，因为PCB布局时引脚位置可能不太理想，有了这个功能，走线就灵活多了。

3.3 Serial库函数详解：你只需要记住这几个

在Arduino框架下，操作串口主要靠Serial对象。ESP32有三个串口对象：Serial（UART0）、Serial1（UART1）、Serial2（UART2）。

核心函数就这几个：

// 1. 初始化串口
Serial.begin(115200);           // 设置波特率115200
Serial2.begin(9600, SERIAL_8N1, 16, 17);  // UART2: 波特率9600, 8N1, RX=16, TX=17

// 2. 发送数据
Serial.print("Hello");          // 发送字符串，不换行
Serial.println("World");        // 发送字符串，自动换行
Serial.write(0x55);             // 发送一个字节（原始数据）

// 3. 接收数据
if (Serial.available()) {       // 检查是否有数据可读
    char c = Serial.read();     // 读取一个字节
    String s = Serial.readString();  // 读取字符串（直到超时）
}

// 4. 清空缓冲区
Serial.flush();                 // 等待发送完成

我个人最常用的调试方式是这样的：

void setup() {
    Serial.begin(115200);
    Serial.println("系统启动...");
    Serial.printf("芯片频率: %d MHz\n", getCpuFrequencyMhz());
}

void loop() {
    if (Serial.available()) {
        String cmd = Serial.readStringUntil('\n');
        cmd.trim();
        Serial.print("收到命令: ");
        Serial.println(cmd);
        // 根据命令执行不同操作
    }
}

注意Serial.printf()这个函数，它和C语言的printf用法一样，格式化输出特别方便。比如打印变量值、十六进制数等，比用print拼接字符串省事多了。

小技巧：调试时我喜欢用Serial.println(__LINE__)来打印当前行号。这样程序跑到哪一行，一目了然。尤其是代码量大的时候，这个技巧能帮你快速定位问题。

3.4 串口打印调试信息：工程师的“眼睛”

做嵌入式开发，没有调试器是常态。这时候串口打印就是你的“眼睛”。我习惯在每个关键函数入口和出口都加一句打印，比如：

void unlockDoor() {
    Serial.println("[DEBUG] unlockDoor() 开始执行");
    
    // 执行开锁动作
    digitalWrite(relayPin, HIGH);
    delay(500);
    digitalWrite(relayPin, LOW);
    
    Serial.println("[DEBUG] unlockDoor() 执行完毕");
}

int getFingerprintID() {
    Serial.printf("[DEBUG] 开始采集指纹... 缓冲区大小: %d\n", Serial2.available());
    
    // 这里是指纹采集逻辑
    int id = readFingerprint();
    
    Serial.printf("[DEBUG] 指纹识别结果: ID=%d\n", id);
    return id;
}

为什么要加[DEBUG]前缀？因为项目后期你可能要关掉调试信息，用#ifdef DEBUG宏定义控制，这样搜索替换起来很方便。

调试信息的级别：

  • ERROR：严重错误，必须修复
  • WARNING：可能有问题，需要关注
  • INFO：正常流程信息
  • DEBUG：详细调试信息，开发阶段使用

我建议你从一开始就养成好习惯，给打印信息加上级别标签。这样后期代码量大了，你才能快速过滤出有用的信息。

实战建议：在智能门锁项目中，串口调试信息至少包含以下内容：

  • 系统启动时的硬件初始化状态
  • 指纹模块的通信是否正常
  • WiFi连接状态和IP地址
  • 每次开锁/关锁的操作记录
  • 错误码和异常信息

最后说一句：串口调试虽然简单，但它是整个嵌入式开发的基石。你想想看，没有串口打印，你怎么知道指纹模块有没有收到指令？怎么知道WiFi有没有连上？怎么知道继电器有没有动作？所以，把串口玩熟了，后面的开发就顺了。

下一章，咱们开始实战——用ESP32的串口2连接指纹模块，实现指纹数据的读取和识别。到时候你会发现，今天学的这些串口知识，全都能用上。

← 上一章 📖 返回目录 下一章 →