LR1000E2、LR1000E4 这类 A 协议族模块的串口协议只有一句话要记牢:每一帧固定 8 字节,帧头两个字节固定是 55 AA,紧跟一个功能码字节、四个数据字节,最后一个字节是校验和。默认串口参数是 115200bps、8 位数据位。只要按这个结构解析,单次测距、连续测距、停止测距、角度测量这四条指令可以用同一套解帧逻辑处理,不需要为每条指令单独写状态机。
发送帧结构
主机发往模块的一帧,字节顺序是:帧头高字节 55、帧头低字节 AA、功能码、D1、D2、D3、D4、校验和,总长度固定 8 字节,这一结构在协议说明里写作”Frame Header (H) Frame Header (L) Function Code D1 D2 D3 D4 Checksum”。四个常用指令的功能码分别是:单次测距 0x88、连续测距 0x89、停止测距 0x8E、角度测量 0x8A,手册给出的完整发送帧示例分别是 55 AA 88 FF FF FF FF 84、55 AA 89 FF FF FF FF 85、55 AA 8E FF FF FF FF 8A、55 AA 8A FF FF FF FF 86。可以看到数据位 D1 到 D4 在这几条指令里都填 FF,真正区分指令的只是功能码和对应的校验和末字节。
发送校验和怎么算
发送方向的校验和公式是功能码加四个数据字节求和,手册原文写作 SUM(Function Code + DATA1 + … + DATA4)。以单次测距为例:功能码 0x88 加上四个 0xFF,即 0x88 + 0xFF×4 = 0x88 + 0x3FC = 0x484,取低 8 位正好是 0x84,与手册给出的末字节一致;连续测距 0x89、停止测距 0x8E、角度测量 0x8A 按同一公式分别得到 0x85、0x8A、0x86,也和手册帧表一一对应。LR1000E4 这一代在文档里把公式写得更完整:”SUM(Function Code + DATA1 + DATA2 + DATA3 + DATA4), lower 8 bits”,并单独注明发送校验和与应答校验和的计算方式不同,不能混用同一个公式去验两个方向的帧。实际开发时建议按公式算出后再和手册给出的发送帧字节表逐字节核对,差一位校验错误就会被模块直接丢弃。
应答帧与状态位
模块应答帧的结构是帧头、功能码、状态位 STA、保留字节 FF、距离高字节 DIS_H、距离低字节 DIS_L、校验和,应答校验和公式手册写作 SUM(Frame Header (H) + Frame Header (L) + … + DATA4),即连帧头也计入求和范围,这一点和发送方向的校验和公式不一样,是最容易写错的地方。状态位的判定很明确:STA = 1: Measurement successful,其余任何取值都代表本次测量失败,解析代码应该先判 STA 再决定是否读距离字段,不要在 STA 不等于 1 时也去解析 DIS_H/DIS_L,那两个字节在失败帧里没有意义。拿到的距离原始值还要乘以一个比例系数才是真实距离,协议里写作”Reported value = measured value × 10″,即原始整数值要除以 10 才是米数,这一步经常被漏掉导致读数看起来大了十倍。
解帧自检清单
- 先确认帧长固定是 8 字节,收到的字节数不对就直接丢弃重新找帧头,不要尝试补齐。
- 帧头必须是连续的 55 AA 两个字节,只匹配到一个 55 不算,继续往后找。
- 发送校验和与应答校验和公式不同,分别实现,不要共用一套求和逻辑。
- 先判 STA 状态位,STA = 1 才继续解析 DIS_H/DIS_L,否则丢弃本帧。
- 距离原始值要除以比例系数(LR1000E2/LR1000E4 为 10)才是真实距离,单位换算前先确认具体型号的系数。
为什么要分开实现两个方向的校验和
很多第一次写解帧代码的工程师习惯写一个通用的 checksum 函数,两个方向共用,这在 ERDI 的 A 协议族上会直接出问题:发送方向只对功能码和四个数据字节求和,不包含帧头;应答方向却把帧头也计入求和范围,这一点在 LR1000E4 的文档里写得更直白,专门区分了发送校验和与应答校验和两条公式。如果用同一套求和逻辑去验证应答帧,算出来的校验和永远和模块返回的末字节不一致,容易被误判成”模块返回了坏帧”或者”线路有干扰”,实际上只是校验逻辑本身用错了方向。建议在代码里把两个校验函数明确命名区分(比如 checksum_tx 和 checksum_rx),避免后续维护时被不小心合并成一个。
另外要留意,不同型号即便同属 A 协议族,具体的比例系数、测量范围和部分字段的说明也不完全相同,LR1000E4 的通信协议说明虽然帧结构和 LR1000E2 一致,波特率同样默认 115200bps、帧长同样是 8 字节,但不能因为帧结构相同就假设所有数值细节都通用,解析代码里涉及具体数值换算的部分,务必按当前要集成的型号重新核对一遍文档,而不是直接照抄另一个型号已经验证过的参数。
相关资料:LR1000E2 型号参数页、同协议家族的其它型号参数页、905nm UART 模块 OEM 专题。
如需确认具体来料的尾线颜色、针脚方向或协议细节,请联系 ERDI 技术支持:联系我们(tommy@erdimail.com / +86 133 0819 5790)。
常见问题
一帧固定多少字节?
8 字节定长帧:2 字节帧头 55 AA、1 字节功能码、4 字节数据、1 字节校验和。
发送和应答的校验和公式一样吗?
不一样。发送方向只对功能码和四个数据字节求和,应答方向连帧头也计入求和,必须分开实现。
收到的距离数值要不要换算?
要。协议明文”Reported value = measured value × 10″,原始值要除以比例系数才是真实距离,不同型号系数需分别确认。
Category pages: Laser rangefinder module
Models mentioned in this article
- LR1000E4905 nm · up to 1 km · UART · TTL · ≤10 g1 pc $80 · shipping includedSee price & buy
- LR1000E2905 nm · up to 1 km · UART · TTL · ≤10 g1 pc $80 · shipping includedSee price & buy