Complete batch 20261016-C-embedded-2: 45 verified GLM/Pi samples, independent regrades and archives; preserve difficulty misses and Salty blockage.
修复 DMA 分段完成与过期回调
原创离线软件练习模拟以下症状:短DMA请求有时正常,跨描述符、部分完成、取消后快速
重用通道、错误之后再提交时,会出现跳过数据区间、重复完成、错误缓存维护或旧回调
结束新请求。当前为完整C11工程,含描述符模块、完成分发、寄存器桩和调试输入生成器。
修复driver.c、descriptor.c、completion.c,保持lab.h签名;其余工程为只读上下文。
只验证软件描述符生命周期/回调与缓存维护调用,不验证真实DMA硬件或CPU缓存一致性。
P1 构建、输入与原始观察
make使用gcc C11、-O2 -Wall -Wextra -Werror,生成hal-demo和traffic。
./hal-demo从stdin逐行读取十进制命令,空行/#注释忽略:
R:静默复位所有驱动、寄存器、token和计数,建立新的回调时间轴。Q id length:提交一次连续缓冲区接收,id=0..1000000、length=0..128。D token amount error:一次DMA完成事件,token=0..1000000、amount=0..128、error=0..255。C id:取消,id=0..1000000。
输入格式正确,最多20000操作,计数和token不溢出;R之前的硬件事件不跨R注入。 同一R周期内会注入已完成/取消/失败描述符的延迟和重复事件。EOF不隐式完成。 构建20秒、程序10秒、评分120秒;正常退出0、格式错误退出2。库不得自行打印。
原始事件E op name a b:PROGRAM token packed(packed=offset*256+chunk);
CACHE offset amount;ABORT token 0;DONE id status;REJECT id 0。
每条命令全部事件后:
S op active_id token offset chunk completed cancelled failed rejected stale。
操作编号op从1递增,R不重置编号;无活动请求时active_id=offset=chunk=0。
缓存区间按字节的offset和amount精确记录,不作对齐/舍入。
P2 提交、token和描述符
合法请求id非零且length=1..64;当前有活动请求时任何Q都拒绝。拒绝仅rejected加1并 REJECT,不改token、进度或正在传输的请求。长度0/65..128用于验证拒绝。 没有等待队列。接受时复制id/length,活动进度offset=0,按以下规则编程第一描述符。
每次PROGRAM先将全局token加1(R后初值0),chunk=min(7,length-offset), 描述符保存此token、offset、chunk和总length,再输出PROGRAM(token,offset*256+chunk)。 每次后续分段或部分完成后重新编程都取得新token,即使继续处理同一请求。 不能按提交次数而忽略中间描述符,不能重用取消/错误撤销的token。
P3 完成事件、缓存与错误优先级
D首先检查是否有活动请求、token是否等于当前描述符token。没有活动请求或token 不匹配时,只stale加1,忽略amount/error,不产生CACHE/ABORT/DONE/PROGRAM, 不能改变当前请求、token或进度。此检查优先于任何完成错误或长度错误。
当前描述符token匹配时,error非零、amount=0、amount>chunk均表示失败: 先ABORT(当前token,0),再将全局token加1使该描述符失效,failed加1, DONE(id,1),清空活动身份与offset/chunk。不得输出CACHE或自动启动新请求。 失败后可提交独立请求;旧描述符的重复事件只能计stale。
匹配且error=0、1<=amount<=chunk时:先CACHE(完成前offset,amount), 再offset+=amount。只维护实际完成字节区间,不把未完成部分当作已完成。 若offset==length,completed加1、DONE(id,0),清空活动身份与offset/chunk; 本次成功完成不额外增加token。否则立即按P2重新PROGRAM剩余区间, 新chunk=min(7,length-新offset),包括amount<上次chunk的部分完成。 事件顺序严格CACHE、可选PROGRAM或DONE,不得重放此前已完成区间。
P4 取消、恢复与模块接口
C只在匹配活动id时生效:ABORT(当前token,0),全局token加1,cancelled加1, DONE(id,3),清空活动身份与offset/chunk。未知或空闲id不产生事件、不改计数。 取消后的下一次Q继续从该全局token再加1;旧回调不能结束新的活动请求。 R不回调,无条件清零token、进度、所有计数和寄存器;完成、失败、取消后均可重用id。
lab.h全部接口指针有效。descriptor_reset清空描述符。descriptor_build在token非零、 1<=total<=64、offset<total时构建P2描述符并返回1,否则返回0且不改输出。 length/offset/token getter只读;invalid描述符的length为0。descriptor_matches检查当前 有效描述符及其token/offset/length/total与驱动对应,并比较给定token;remaining为空闲 时0,否则为length-offset。token_advance只令全局token加1;descriptor_clear仅清空 offset/chunk和描述符;descriptor_advance仅按amount推进offset;descriptor_program遵P2。 completion_valid只校验当前amount/error;completion_classify依P3先区分空闲、过期、 无效完成、合法完成,accept/driver_complete据此处理;driver_finish按结果计数、DONE并 释放活动请求。driver_snapshot仅观察。对模块内部辅助调用,调用方保证已有合法活动状态。
P5 自测与提交
make
printf 'Q 1 8\nD 1 2 0\nD 1 1 0\nD 2 6 0\n' | ./hal-demo
./traffic 17 2 | ./hal-demo
首例PROGRAM(1,7),CACHE(0,2)、PROGRAM(2,518),旧token1仅计stale, 最后CACHE(2,6)、DONE(1,0)。可自行测试6/7/8、14/15、最大64、部分完成多次分段、 取消后重用通道、无效amount、错误完成、过期事件携带错误码、未知取消、重复完成。 最终只冻结三个候选文件,原样上下文重建,不使用新增文件、旧构建产物、网络或隐藏判据。