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

24 lines
4.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 扫描控制台与总线端口合同
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+3*bus+seed)%11==0决定,值为(17*seed+257*bus+31*address)&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起,按实际扫描顺序对每个有应答地址执行(digest*131+address*65536+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
```