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

4.7 KiB
Raw Permalink Blame History

扫描控制台与总线端口合同

  1. 工程为 C11 软件可靠性演练。make 构建 scan-console;./scan-console --demo 连续24轮扫bus0的3..119,初始容量8、seed1。无参数从stdin逐行读命令。没有真实设备、网络或时钟依赖。
  2. 地址范围3..119(含端点,共117地址),总线0..3,会话槽0..3。容量1..16,seed0..65535。十进制整数;行以ASCII空白分词;空行、首个词以#开始的行忽略;整数前允许+或-,其余字符必须完整构成int。命令参数数量须精确。未知命令、语法错、超长行或输入错误退出2;正常EOF退出0。允许任意stderr诊断。公开console.c定义语法细节。
  3. 启动时等同 R 8 1。R capacity seed 重置设备、故障、统计和会话;非法范围返回R -22且不改状态。重置前释放会话持有资源。D bus address value 设置应答,value为-1表示无设备,0..65535表示设备值;非法返回-22不改状态。默认应答由(address+3bus+seed)%11==0决定,值为(17seed+257bus+31address)&65535。
  4. F bus kind address count 设置该总线唯一故障规则,覆盖旧规则。kind0清除、kind1选址故障、kind2读取故障、kind3打开故障。count0..64,每次匹配消耗一次;kind0/3要求address=-1,kind1/2要求合法地址。非法返回-22且不改变规则。规则影响其所在真实总线。打开故障返回-6;选址/读取故障返回-5并毒化句柄,直到关闭。清除规则不能消除现存毒化状态。
  5. S slot bus low high reverse 运行一轮闭区间扫描。low/high均在3..119且low<=high,reverse为0升序或1降序,slot/bus合法;不合法时返回-22、空结果且不碰会话/端口。每个地址必须先选择,再读取一次,选址不表示应答。读取0表示无设备,1表示有设备。不得把NACK作为致命错误。
  6. 每个槽保留恰好一个自己的总线句柄,成功完成后保留供后续同总线扫描复用。相同总线的下一轮不能重新打开;换总线必须先关闭旧句柄,再打开新总线。会话之间独立,不共享句柄。端口总是分配最低空闲编号(10..10+capacity-1);满时-24。只成功打开增加opens/live/peak;成功关闭增加closes并减少live。
  7. 首次打开或换总线打开失败时保留空会话(handle=-1,bus=-1),立即返回错误;不重试、不探测。选址或读取失败立即停止本轮并关闭当前会话句柄,保留失败前的结果前缀;下一次S从新请求重新开始,可恢复。选址失败不计visited;读取尝试无论结果均计visited。失败轮不更新会话sweeps/discoveries;成功轮sweeps加1,discoveries加本轮found。
  8. ScanResult每次调用先清空;visited为读取尝试数,found为成功应答数。seen和values仅在seen为1的地址有效;未使用values不作要求。digest从0起,按实际扫描顺序对每个有应答地址执行(digest131+address65536+value+1)模2^64。结果输出S rc visited found digest,然后按地址升序输出D address value,只输出seen地址。负错误码如上。
  9. X slot 关闭该槽,槽非法返回-22;空槽返回0。关闭后handle/bus=-1;累计计数保留。Z关闭全部槽并输出R 0,正常/错误EOF也关闭全部槽。不准用清空端口统计或隐藏句柄替代关闭。
  10. Q输出全部四槽Q slot handle bus sweeps discoveries;再输出P opens closes selects reads errors live peak及所有活动句柄H handle bus selected poisoned。Q不改变任何状态,输出为原始观测。初始/刚打开selected=-1,选址成功后为该地址;选址故障清为-1,读取故障保留该地址。
  11. selects对有效活动句柄与合法地址的每次选址加1,reads对有效活动句柄的每次读取加1。每个注入故障、容量耗尽、毒化选址/读取或未选址读取增加errors一次;无应答不增加errors。计数是uint64;公开测试流不会使其溢出。无效descriptor返回-9且不增加计数,端口配置非法返回-22。
  12. 端口实现port.c与公开观察器console.c固定,评分重建时使用相同字节。scan.c可改变内部算法,只须满足上述接口与行为,不要求某种补丁。输入流可组合合法、非法范围命令、重复扫描、并行槽、换总线、故障及恢复;支持正反向、单地址、完整117地址。无需模拟物理I2C电气或内核fd。
  13. 公开观察协议使用ASCII空白分隔、十进制数;允许等价空白和整数表示,不允许多余/缺失字段或行。扫描结果只比较定义的seen范围,不检查无效尾部。控制台没有隐藏断言或期望结果。

公开复现示例:

make
./scan-console --demo
printf 'R 2 3\nS 0 0 3 119 0\nQ\nS 0 1 3 119 1\nQ\nZ\nQ\n' | ./scan-console