amos 9d633e9e67 Batch 15 (20261023-C-hwe-scale-15): 320 HWE-derived repair tasks
One user-space repair task per eligible HWE debug-diag / compile-deploy base
ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content
filter. Each ships a public spec with a check-to-basis table, at least two
defects with single-fix fixtures, a symptom-masking fixture and an alternative
correct implementation. Claude re-checked all 320: structure, the HWE quality
items and trace6 Docker calibration receipts against current digests
(320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120
ad-hoc family names; the next batch maps them to the canonical list.
The batch's 1,256-line progress log stays in its factory report and the
36-local branch batch15-hwe.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 01:55:56 +08:00

7.0 KiB
Raw Permalink Blame History

接收窗口公开合同(C11)

1. 工程与入口

当前目录用 make 构建 rx-demo;无需下载、板卡或网络。make demo 把 demo.txt 送给程序。make clean 只删除本工程生成物。接收器 ABI 见 rx_window.h,只能提交 rx_window.c;评分会以原始公开的头文件、wire、port 和命令驱动重新构建。任何符合本文全部条款的实现均可。stdout 是命令驱动的观测协议;stderr 允许诊断。

rx_create(port) 新建空接收器;port 由调用方持有且寿命长于接收器。rx_destroy(receiver) 结束并交还该接收器全部活动请求,再释放对象。对空指针 destroy 无操作。rx_outstanding(receiver) 返回接收器持有的槽数;空指针返回 0。正常内存分配成功,不要求故障注入 malloc。

2. 参数与槽位

四个槽 0..3,每槽独立的 256 字节 bank,cache line 是 16 字节。rx_submit(receiver, slot, offset, capacity, tag) 接受 slot<4、capacity 为 1..128、offset<256、offset+capacity<=256;tag 是完整 uint32。无效参数或空 receiver 返回 RX_ARGUMENT=-1,不改变资源。有效参数但槽已被该接收器持有返回 RX_STATE=-2。测试每个 port 只有一个接收器。

成功提交返回 RX_OK=0,获得一个 port 描述符;此槽直到 collect 的终态、cancel 或 destroy 之前保持占用。rx_collect(receiver,slot,out) 的 receiver/out 为空或 slot 超界返回 ARGUMENT;不存在活动请求返回 STATE。上述失败不改变请求和资源。不要求失败时 out 的内容。

3. 完成与收取

设备通过 port_device_complete 显式完成请求,所有状态变化是确定性命令,没有轮询时间预算。未完成 collect 返回 RX_PENDING=1,保留描述符与槽,不读取报文;可重复查询。完成为 PORT_FAILED 时 collect 返回 RX_DEVICE=-3,不读取报文,但必须结束请求并交还描述符。终态后的下一次 collect 返回 STATE。

完成为 PORT_DONE 时,实际接收长度 actual 由 port_completion 给出,范围 0..capacity,可能短于 capacity。接收器只读实际接收窗口 [offset, offset+actual) 的 CPU 字节,验证第 5 节报文和提交 tag。有效报文返回 OK,out 的 tag/flags/size/payload[0:size] 是报文值。payload 的 unused 尾部无要求。无效报文或 tag 不一致返回 RX_FORMAT=-4。不论格式成功与否,均结束请求并交还描述符,不保留占用。所有 uint32 tag(含 0 和 UINT32_MAX)必须保持完整。

成功收取至少通过 CPU port 读取全部实际字节,不能从设备模拟器的内部实现或其他旁路取报文。不得读取 actual 之外的字节,不可在完成前读取。空 actual 是格式错误;无需 cache 操作和字节读取。分段、逐字节或一次性读取均允许。

4. 独立 memory/cache port

port.h 的 CPU 和 device 端口表示不一致的独立视图。创建 port 时 bank 的 device memory 和有效 CPU cache 都初始化为 (seed*17+slot*29+position*7+13) mod 256。设备完成只改 device memory 的实际窗口,不更新 CPU cache。失效只把 cache line 标为无效;下一次 CPU 读取该行才从 device memory 填入。每次新的完成都可能把已有 cache 变旧,旧请求的失效不可代替新请求的失效。

port_invalidate(port,handle,start,length) 使用 bank 内的绝对偏移;start 与 length 必须是 16 的倍数,length>0。只允许 DONE 请求、actual>0,且每个被失效行必须与本请求的实际窗口相交。可以逐行失效,也可合并连续行;可以重复失效。CPU 读取任何实际字节之前,必须失效覆盖该字节的行;应覆盖向下对齐的首行直到向上对齐的末端,不能误失效其他行。没有要求采用某种对齐表达式。

port_cpu_read(port,handle,offset,out,length) 只允许 DONE 请求、非空 out、length>0 且范围在实际窗口内。它返回 CPU cache 字节,绝不隐式失效。port 的 handle 只能由成功 acquire 获得,不能猜测。接口错误时返回 ARGUMENT/STATE 并增加 violations;合法的 pending 查询和合法取消不增加 violations。所有候选调用必须合法,violations 应一直为 0。

5. 报文

报文长度严格为 11+payload_size,payload_size 为 0..96。字节顺序:c3 5a 01 flags tag0 tag1 tag2 tag3 payload_size、payload、CRC 低字节、CRC 高字节。flags 为 0..3;tag 为小端 uint32。CRC16-CCITT 初值 ffff,多项式 1021,非反射,无末异或,覆盖 CRC 之前所有字节。缺字段、额外尾部、错误 magic/version/flags/CRC、长度不一致均无效。wire.h 和 wire.c 提供公开 encode/decode/CRC 例程,可以复用,也可自己实现。

6. 取消、销毁和资源

rx_cancel(receiver,slot) 的 receiver 为空或 slot 超界返回 ARGUMENT;闲槽返回 STATE。活动槽返回 OK,结束并交还请求,不产生结果,不读报文。pending 请求须先 port_abort 再 port_release;已经终态的请求可直接 release。port_abort 对已完成请求合法且无副作用;对 pending 请求转为 CANCELLED,aborted 加一。destroy 对每个活动请求遵守同一规则;必须保留其他槽不受影响。

port acquire 成功则 acquired、live 各加一;设备完成成功(DONE 或 FAILED)则 completed 加一;release 成功则 returned 加一、live 减一,并立即允许同槽重新 acquire。rx_outstanding 必须等于 live,且 acquired-returned=live。设备错误、格式错误、取消、重建以及多槽交错都必须保持此关系。未完成请求不能直接 release;必须先 abort。不得泄漏内存或描述符。

7. 命令驱动和观测

命令每行一条,数字为十进制:R seed 销毁旧接收器并创建新 port/receiver;S slot offset capacity tag 提交;D slot status hex 完成设备请求(status 为 1/DONE 或 2/FAILED,空字节写 -);C slot 收取;X slot 取消;Z 销毁接收器并在同一 port 上新建接收器。DONE 的 hex 长度为 0..capacity;FAILED 无字节。D 不属于候选实现,返回 producer 操作码。stdin 结束会正常销毁对象。

port 的 cpu_distinct 累计每个描述符经合法 CPU read 读过的不同实际字节数,同一字节重复读取只计一次,新描述符重新计数。成功收取须覆盖全部 actual 字节;格式错误允许在确认无效后提前停止读取;pending、设备错误、取消和销毁不读取。

每条命令输出两行原始观测:O step op rc tag flags size payloadhex 和 A step outstanding acquired returned aborted completed live violations cpu_distinct。C 的 result 先以 a6 填充;driver 只打印最多 96 字节 payload,size 为实际原始字段;成功只定义前 size 字节,其余不比较。非 C 命令的 result 字段为占位,无业务语义。测试可用全部公开允许的参数、短接收、异常报文、错误完成、重复操作、多槽并行和同槽复用,不局限 demo。