4、串口通信基础：UART协议、Arduino串口函数（Serial.begin、Serial.print、Serial.println）的用法与注意事项

在TinyML调试中，串口（UART）是最基础也最关键的调试通道。无论是打印张量形状、输出推理置信度，还是查看传感器原始数值，串口都是模型与开发者之间的“眼睛”。本章将系统讲解UART协议的工作原理、Arduino串口函数的核心用法，以及在实际调试中容易踩中的陷阱。

4.1 UART协议核心原理

UART（Universal Asynchronous Receiver/Transmitter，通用异步收发器）是一种全双工、异步的串行通信协议。所谓“异步”，意味着通信双方不需要共享时钟信号，而是通过预先约定好的波特率（Baud Rate）来同步数据采样时刻。每个数据帧由起始位、数据位、校验位（可选）和停止位组成。

在Arduino Uno等AVR系列板卡上，硬件UART通过Pin 0（RX）和Pin 1（TX）与USB转串口芯片（如ATmega16U2）相连，因此Serial对象直接映射到USB虚拟串口。对于ESP32、STM32等更复杂的MCU，可能有多个UART外设，需要指定不同的引脚映射。

UART帧格式通常为：1位起始位（低电平）、8位数据位（LSB先行）、1位停止位（高电平）。无校验位时，帧长度为10位。波特率决定了每秒传输的位数，例如115200波特率下，每秒可传输11520字节（约11.25KB/s），足以满足TinyML调试中打印浮点数、数组和日志的需求。

4.2 Arduino串口函数详解

Arduino的Serial库提供了简洁的API，但每个函数都有其适用场景和潜在陷阱。以下是三个核心函数的深入解析：

4.2.1 Serial.begin(baud)

该函数在setup()中调用，用于初始化串口通信。参数baud指定波特率，必须与串口监视器或上位机软件保持一致。常见误区包括：

• 波特率不匹配：如果板卡设置为115200，而串口监视器选择9600，输出将显示为乱码。
• 重复调用：在loop()中调用begin()会导致串口重新初始化，可能丢失缓冲数据。
• ESP32特殊用法：ESP32的Serial.begin(baud, SERIAL_8N1, RX_PIN, TX_PIN)允许自定义引脚，但默认使用GPIO1（TX）和GPIO3（RX）。

4.2.2 Serial.print(value, format)

print()将数据转换为可读文本并发送，但不添加换行符。第二个参数format可选，用于控制输出格式：

float confidence = 0.8765;
Serial.print(confidence, 4);      // 输出：0.8765（保留4位小数）
Serial.print(confidence, HEX);    // 输出：3F60624D（十六进制浮点表示）
Serial.print(confidence, BIN);    // 输出：二进制表示
Serial.print("Conf: ");           // 输出字符串

在TinyML调试中，推荐使用print(value, 4)保留足够精度，避免因默认2位小数丢失关键信息。

4.2.3 Serial.println(value, format)

println()与print()功能相同，但会在末尾自动追加\r\n（回车换行）。这使得输出在串口监视器中逐行显示，便于阅读。注意：println()在传输大量数据时会增加约2字节的开销，对于高频日志可能影响实时性。

4.3 串口调试实战：TinyML推理结果验证

假设我们正在调试一个基于Arduino Nano 33 BLE Sense的语音关键词识别模型。模型输入为40维MFCC特征，输出为3个类别的置信度。我们需要验证推理结果是否正确，并监控推理耗时。

4.3.1 场景设定与初始现象

初始代码中，开发者使用Serial.println(confidence)输出置信度，但串口监视器显示乱码。初步排查发现，板卡默认波特率为115200，而监视器设置为9600。修正后，输出正常，但发现置信度数值始终为0.00，怀疑模型推理失败。

4.3.2 关键输入数据与调试过程

我们决定增加更详细的日志输出，包括输入特征的前5个值、模型输出的原始logits以及softmax后的概率：

void loop() {
  // 采集MFCC特征
  float features[40];
  extractMFCC(features);
  
  // 打印前5个特征值
  Serial.print("Feat[0-4]: ");
  for (int i = 0; i < 5; i++) {
    Serial.print(features[i], 4);
    Serial.print(" ");
  }
  Serial.println();
  
  // 运行推理
  unsigned long start = millis();
  float logits[3];
  model.predict(features, logits);
  unsigned long elapsed = millis() - start;
  
  // 打印原始logits
  Serial.print("Logits: ");
  for (int i = 0; i < 3; i++) {
    Serial.print(logits[i], 4);
    Serial.print(" ");
  }
  Serial.println();
  
  // 计算softmax
  float maxLogit = logits[0];
  for (int i = 1; i < 3; i++) {
    if (logits[i] > maxLogit) maxLogit = logits[i];
  }
  float sumExp = 0;
  for (int i = 0; i < 3; i++) {
    sumExp += exp(logits[i] - maxLogit);
  }
  Serial.print("Prob: ");
  for (int i = 0; i < 3; i++) {
    float prob = exp(logits[i] - maxLogit) / sumExp;
    Serial.print(prob, 4);
    Serial.print(" ");
  }
  Serial.println();
  
  Serial.print("Inference time: ");
  Serial.print(elapsed);
  Serial.println(" ms");
  delay(500);
}

4.3.3 分析判断与结果对比

运行后，串口输出显示：

Feat[0-4]: 0.1234 0.5678 0.9012 0.3456 0.7890
Logits: -1.2345 2.3456 -0.5678
Prob: 0.0245 0.9123 0.0632
Inference time: 87 ms

特征值正常，logits分布合理，softmax概率总和为1.0000，推理耗时87ms。这说明模型工作正常，之前的0.00问题是因为println()默认只输出2位小数，而实际置信度小于0.01。通过增加精度参数println(prob, 4)解决了问题。

4.4 常见误区与总结复盘

通过上述案例，我们总结了串口调试中的高频错误和应对策略：

总结复盘：串口调试是TinyML开发中最直接的反馈手段，但需要系统性地设计日志格式。建议在项目初期就定义统一的调试输出规范，例如使用[INFO]、[WARN]、[ERROR]前缀，并包含时间戳。对于复杂模型，可以输出JSON格式的数据，便于上位机解析和可视化。最后，务必在发布版本中禁用调试输出，避免串口成为性能瓶颈。