Complete batch 20261016-C-embedded-2: 45 verified GLM/Pi samples, independent regrades and archives; preserve difficulty misses and Salty blockage.
修复串行下载镜像检查工程
升级接收端在整块下载时能接收镜像,分包、设备切换及某些扩展头组合时却出现丢包或错误放行。请阅读当前工程,修复流式镜像接收与校验,使它满足以下公开合同。该工程为原创的软件问题场景,使用字节流代替板端传输,不要求硬件。
最终仅提交 stream.c、policy.c。其余文件提供只读接口与构建上下文;评分会用原样上下文重建,不采用新文件或构建产物。
P1:接口与运行
接口和结构见 image.h。image_init(stream,board,floor,sink,arg) 初始化独立流,计数和缓存均为零。image_feed 接受任意长度(含零)的字节片段,不修改调用者输入;无完整镜像时等待后续调用。回调只在校验成功后同步调用一次,ImageView 的 payload 仅在该回调期间有效。image_reset(stream,floor) 丢弃缓存、替换防回滚下限,保留 board、回调与累计 accepted。image_pending 返回未决缓存字节数,image_accepted 返回本次 init 后累计交付数(uint64)。输入规模不使计数溢出。
运行 make,或 gcc -std=c11 -O2 -Wall -Wextra -Werror -pedantic main.c codec.c stream.c policy.c -o observe。./observe 从 stdin 读命令,每条一行,十进制无符号数;正常退出 0,命令格式错误退出 2。所有 F/X 输入长度不超过 8192。
I board floor:board 为 0..65535,floor 为 uint32;初始化并打印I board floor。F n b0 ...:n 个 0..255 字节;feed 后先打印输入缓冲区调用后的A crc32,再打印S accepted pending。期间每次成功交付先打印V sequence rollback entry flags payload_size payloadhex,payloadhex 为小写十六进制、无分隔符。X hex:同 F,用偶数长度大小写十六进制,-表示空输入。R floor:reset 后打印 S;Q:只打印 S。C n bytes...:打印C crc32。H n bytes...:打印H hex,零长度为H -;它们不操作流。
P2:镜像容器
所有多字节整数小端,无符号。基本头固定 32 字节:0..3 ASCII FWI2;4 为版本(只能 2);5 为头总长 h(32..96,4 的倍数);6..7 为 flags(只能 1,表示可执行);8..11 为整个镜像长度(必须等于 h+n);12..15 为 sequence;16..17 为 board;18..19 为 TLV 数量;20..23 为 payload 长度 n(1..128);24..27 为 payload CRC32;28..31 为头 CRC32。sequence 只作标识,不表示排序或去重;同一合法镜像重复到达应重复交付。board 必须等于 init 值。
CRC32 使用 IEEE reflected polynomial 0xedb88320,初值 0xffffffff、最终 xor 0xffffffff(等于 Python zlib.crc32)。payload CRC 覆盖 n 个原始 payload 字节;头 CRC 覆盖全部 h 字节,其中 28..31 当作四个零字节。校验不能信任报文声明。
P3:扩展头与安装资格
从偏移 32 起顺序存放恰好 TLV 数量条记录,必须恰好用完 h 字节。每条为 type:u8、属性:u8、value 长度:u16、value、0..3 字节零填充(把 value 长度补到 4 的倍数)。任何越界、非零填充或属性中除 bit0 外的置位均非法。bit0 表示 critical,已知类型允许 bit0 为 0 或 1。
类型 1 为 rollback:u32,类型 2 为 entry:u32,二者必须各出现且仅出现一次;类型 3 为 dependency:u32,可省略,若出现只能一次。三种类型 value 均为 4 字节。未知类型:critical 置位时拒绝,否则忽略 value。rollback 必须大于等于当前 floor;entry 必须 4 字节对齐且严格小于 n;dependency 存在时必须小于等于 rollback。检查失败不得回调、不得增加 accepted。
P4:流、重同步与状态
流可包含任意噪声、无效容器、连续镜像及分片。按从左到右的最早 FWI2 开始:不足 32 字节则等待;收到 32 字节后,若 P2 的 version/h/flags/n/total 维度非法,则只丢弃该 magic 的首字节并继续扫描;维度合法但不足 total 则等待。完整容器未通过 P2/P3 的其余验证时同样只丢弃首字节并继续扫描(其内部也可能含下一个合法镜像)。成功后交付,并消费恰好 total 字节。不应因 feed 的边界丢弃未完成内容。找不到完整 magic 时,只保留流尾部与 FWI2 前缀相同的最长 0..3 字节,其他噪声立即丢弃。pending 必须与上述扫描后残留一致。reset 不交付已缓存部分;之后的输入在新 floor 下开始接收。
可自测:printf 'I 42 0\nF 2 70 87\nQ\nR 3\nQ\n' | ./observe,应见 I、S 0 2、S 0 2、S 0 0、S 0 0。另可自行生成完整头、CRC、分片序列与错误 TLV 验证。验收为软件字节流行为,不代表实板启动或安全启动认证。
评分对单次构建设置20秒超时,对完整有限命令序列的单次程序执行设置12秒超时;使用确定性的输入序列,无需等待真实设备或真实时间。