05｜JY901S 串口驱动：11 字节帧、校准与数据新鲜度

JY901S 在模块内部完成姿态融合，主控面对的是连续到达的 UART 字节流。要把这些字节安全地送进控制器，需要解决帧同步、校验、单位、时间戳和并发读取问题。

模块与主控如何分工

JY901S 模块内部完成姿态融合，主控接收加速度、角速度和角度等串口帧。主控侧驱动负责通信、解析、缓存和本地校准，不包含模块内部融合算法。

UART 单字节中断 → 帧状态机 → 校验
                → 单位换算 → 最新数据与时间戳

解析器逐字节等待 0x55 帧头，再读取数据类型、8 字节载荷和最后一个校验字节，总长度为 11 字节。

使用状态机的好处是无需等待整包一次到达。遇到错误时应重新寻找帧头，而不是让后续字节永久错位。

有效帧按类型更新对应结构。只有已支持的数据类型才会进入换算，未知类型应被安全丢弃并计入统计。

驱动对前 10 字节累加，和最后一字节比较。校验失败时不应更新输出，否则上层可能使用被破坏的数据。

UART 错误回调会重置解析状态并重新启动接收。这能恢复噪声导致的错位，但还应区分溢出、帧错误和 DMA/中断未重启等不同故障。

驱动没有包含串口外设初始化，因此波特率、引脚和中断优先级仍需由目标工程提供。

载荷通常由两个字节组成有符号 16 位量，再按不同满量程换算为加速度、角速度或角度。

主控必须明确模块配置与驱动换算是否一致。若模块量程被修改，而换算常量仍使用旧配置，数值会成比例错误但看起来仍然平滑。

还要统一坐标系：模块 XYZ、车辆前后左右和控制器正方向可能不同。安装旋转必须显式映射，不能通过“调负号直到能跑”替代记录。

驱动为不同数据类型维护有效标志、时间戳、包计数和错误计数。这比只保存三组浮点数更适合可靠系统。

控制任务应检查：本次需要的数据类型是否都有效、各自时间戳是否足够新、它们是否来自相近时刻。只看到一个全局“有数据”标志还不够。

JY901S_GetDataRate() 根据距离最近一帧的时间求倒数。它反映的是最新帧间隔估计，不是滑动窗口平均频率；短时抖动会直接放大到结果中。

本地校准在加速度和角度都曾有效后，累计 100 次并求偏移。但每收到任意一种帧，都可能重复使用上一组加速度或角度。

这意味着 100 次循环不一定对应 100 组独立同步样本。更可靠的条件是：只有相关数据类型都更新过，并且时间戳差在允许范围内，才接受一组校准样本。

代码还把静止时 Z 轴重力平均为“零点偏移”。若应用需要保留重力向量，这会改变物理意义。应区分传感器零偏、安装零位和重力分量。

UART 中断应只完成收字节、状态推进和必要的轻量换算。日志打印、坐标转换和控制计算放到周期任务中。

周期任务读取数据时，应采用短临界区或快照接口，避免中断恰好更新一半结构。若数据超时，控制器应降级或停机，不能继续复用陈旧姿态。

不要只看姿态曲线是否平滑。应统计有效帧数、校验失败数、序号间断、最长接收间隔和解析任务耗时，并在串口干扰或模块重启时观察能否重新同步。

若需要复用第三方实现，还应回到真实上游核对版本与许可证。技术可用性和代码授权是两个独立问题。