Arduino M5 Stamp串口收发固定长度HEX报文方案问询

基础信息 #

• 开发硬件：M5 Stamp Pico，基于Arduino框架开发
• Tx报文示例：0x55 0xCD 0x47 0x00 0x00 0x00 0x00 0x00 0x00 0x01 0x69 0x0D 0x0A
• Rx报文规则：固定长度40字节（二进制HEX格式），帧头为0xAA，帧尾为0x0D 0x0A，示例报文：0xAA 0x00 0x00 0x00 0x00 0x02 0xDA 0x00 0x00 0x03 0x32 0x08 0x8E 0x18 0xF6 0x00 0x03 0x00 0x00 0x00 0x2A 0x00 0x0C 0x00 0x04 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x47 0x03 0xE3 0x0D 0x0A

现有实现问题 #

你当前逐字节计数存数组的逻辑存在两个明显缺陷：

1. 无帧校验逻辑：一旦串口出现丢字节、毛刺干扰，字节计数错位后，后续所有报文都会解析错误，无法自动恢复同步
2. 尝试Serial.readString()失效是必然结果：该方法为纯文本场景设计，一方面遇到二进制报文中的0x00空字节会直接判定为字符串终止提前截断，另一方面依赖默认1秒的串口超时判定，字节传输间隔稍长就会提前返回，根本无法凑齐完整40字节报文。

需要明确：接收固定长度二进制报文必须要有一块连续内存暂存数据，不存在完全不用数组（缓冲区）的实现方式，但可以不用手动写逐字节读取、计数的循环，直接调用Arduino硬件串口封装的原生方法实现。

优化实现代码 #

使用Serial.readBytes()方法直接读取指定长度字节到缓冲区，同时补充帧头帧尾校验解决错位问题，适配FreeRTOS任务调度（M5Stamp的Arduino核心默认运行FreeRTOS，独立任务函数需要主动让出CPU避免占满核心）：

#include <Arduino.h>

// 报文常量定义
constexpr uint8_t RX_FRAME_LENGTH = 40;
constexpr uint8_t FRAME_HEADER = 0xAA;
constexpr uint8_t FRAME_TAIL_CR = 0x0D;
constexpr uint8_t FRAME_TAIL_LF = 0x0A;

void receivemsgloop(void *pvParam)
{
  Serial.println("receivemsgloop start");
  uint8_t rxBuffer[RX_FRAME_LENGTH]; // 接收缓冲区

  while (1)
  {
    // 第一步：对齐帧头，丢弃所有错位的无效字节
    while (Serial2.available() > 0 && Serial2.peek() != FRAME_HEADER)
    {
      Serial2.read();
    }

    // 第二步：等缓冲区凑够完整帧长度再读取，避免无效阻塞
    if (Serial2.available() >= RX_FRAME_LENGTH)
    {
      // 直接读取固定长度字节到缓冲区，无需手动逐字节赋值计数
      size_t actualReadLen = Serial2.readBytes(rxBuffer, RX_FRAME_LENGTH);

      // 第三步：校验帧长度、帧尾，确认报文有效
      if (actualReadLen == RX_FRAME_LENGTH 
          && rxBuffer[RX_FRAME_LENGTH - 2] == FRAME_TAIL_CR 
          && rxBuffer[RX_FRAME_LENGTH - 1] == FRAME_TAIL_LF)
      {
        Serial.print("s2 received valid msg: ");
        // 此处仅做打印示例，业务逻辑可以直接通过偏移读取rxBuffer的字段，无需遍历整个数组
        for (uint8_t i = 0; i < RX_FRAME_LENGTH; i++)
        {
          // 单字节HEX补前导零，格式对齐
          if (rxBuffer[i] < 0x10)
          {
            Serial.print('0');
          }
          Serial.print(rxBuffer[i], HEX);
          Serial.print(' ');
        }
        Serial.println();
      }
      else
      {
        // 校验失败清空串口残留，避免影响下一帧同步
        while (Serial2.available() > 0) Serial2.read();
      }
    }

    // 任务小延时让出CPU，避免占满核心影响其他任务运行
    vTaskDelay(1 / portTICK_PERIOD_MS);
  }

  // 任务循环内不会走到这里
  Serial.println("receivemsgloop end");
  vTaskDelete(NULL);
}

补充说明 #

• 所有二进制串口通信场景都不要用String类型做接收存储，空字节截断、内存碎片问题都会导致功能异常
• 如果后续需要解析报文内的具体字段，不需要遍历整个数组，直接按字节偏移取值即可，例如读取第6、7字节组成的16位无符号整数：uint16_t sensorVal = (rxBuffer[5] << 8) | rxBuffer[6];
• 帧头校验是固定长度串口报文解析的必要逻辑，没有同步机制的计数接收在外设通信场景下几乎必然会出现错位问题。

内容的提问来源于stack exchange，提问作者Samuel