RTU 时间戳接收器

构建:make(gcc,C11,-O2 -Wall -Wextra -Werror)。运行:./rtu-demo。 所有输入均离线提供,不需要串口、板卡、线程或真实时钟。 评分构建限 15 秒,每个驱动进程最多 20000 个操作、运行限 10 秒。

输入与原始观察

stdin 每行一种操作:R 重置;B <十进制uint32 tick> <两位十六进制字节>; P <十进制uint32 tick> 轮询。均为格式正确输入,R 建立新的时间轴;其余操作的 tick 按模 2^32 前进, 可同 tick,活动期间当前 tick 到最近字节的模差不超过 2^31-1;统计计数不溢出。 EOF 不触发隐式 flush。 每次操作(包括 R)编号从 1 递增,回调先打印 F <操作号> <触发完成的tick> <不含CRC的长度> <逐字节两位小写hex>, 随后打印 S <操作号> <accepted> <bad_crc> <bad_length> <timing_errors> <overflows>。 输出仅由 demo 观察器完成,库函数不得自行打印;正常退出为 0。

接口合同(条款 T1–T9)

T1. 保持 rtu.h 中全部签名。rtu_init 清空正在接收的段和五个计数, 保存回调及 context;rtu_get_stats 仅返回计数,不改变状态。 回调参数中的字节在回调期间有效,传入原 context。

T2. 所有时间单位均为整数 tick,gap = (uint32_t)(now - previous)。 rtu_classify_gap:0..3 为 RTU_CONTINUE;4..6 为 RTU_INTER_GAP; 7..2^31-1 为 RTU_FRAME_BOUNDARY。该分类器两个参数的模差保证在 0..2^31-1 内;必须跨 uint32 回绕工作。

T3. 第一个字节开始一个段。后续字节相对最近字节分类:gap <= 3 继续该段; gap >= 7 先在当前字节的 tick 完成旧段,再用当前字节开始新段。 最后一个字节不能因“看起来已有CRC”而提前完成,段只能由足够长空闲完成。

T4. 活动段收到 gap 为 4..6 的字节时,该整个段作废,timing_errors 只加 1, 当前字节也丢弃;后续字节继续丢弃并更新最近字节 tick,直到 gap >= 7 或 满足 T5 的 poll 才解除丢弃。丢弃期间不再增加 timing_errors,不校验 CRC/长度。

T5. rtu_poll 不代表收到字节,不更新最近字节 tick,也不会因 gap 为 4..6 制造错误。活动段且距最近字节 gap >= 7 时,在 poll 的 tick 完成并清空该段; 否则完全不改变接收状态。空接收器重复 poll 不输出、不计错。

T6. 容量为 64 字节,包括 CRC。收到第 65 个字节时,overflows 只加 1, 整个段进入与 T4 相同的丢弃状态(无需再增加 timing_errors),不保留尾巴; 若该字节已因 T3 开始新段,则不属于旧段溢出。

T7. 完成未丢弃的段时,长度 1..3 仅 bad_length 加 1;长度 4..64 才校验 CRC-16/Modbus(初值 0xffff,逐位右移,多项式 0xa001,无最终异或), CRC 为最后两个字节,低字节在先。CRC 错误仅 bad_crc 加 1。 CRC 正确仅 accepted 加 1,并恰好调用一次回调,移除两个 CRC 字节, 其余字节原序返回。不按地址/功能码过滤任何字节值。

T8. 完成、CRC/长度错误、超时清空、时间污染、溢出后,后续独立有效段都必须 恢复正常;错误计数只按 T4/T6/T7 增加。R 丢弃未完成段而不产生错误。

T9. 最终仅评分 rtu.c 和 rtu_timing.c。其余工程文件为只读上下文。评分会用 原样上下文重新构建、输入更多符合本合同的事件序列;不要依赖持久文件、 网络、隐藏评分器或固定样例输出。

复现与自测

以下帧 CRC 为 40 21,段在最后一次 poll 完成;期望一个 F,随后 accepted=1:

make
printf 'B 100 01\nB 101 03\nB 102 40\nB 103 21\nP 110\n' | ./rtu-demo

还应自行测试 gap 恰好 3/7、uint32 回绕、poll 后继续接收、污染段后连续有效段, 以及最大长度与溢出。