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

3.4 KiB
Raw Permalink Blame History

Pin bringup contract

  1. 本程序是软件 GPIO 工作台。每个 B 行创建独立空总线,按请求建立配置后调用 pin_bringup;不同 B 行互不影响。库 API 见 pin.h。有效调用保证 bus/results 非空、count<=16、budget 在 1..8,请求合法且 pin 不重复;count=0 合法。函数填满 count 个 result,不修改请求。
  2. 输入一行:B budget count [pin value ready_delay export_busy direction_busy value_busy fatal_stage]...,后面恰好 count 组7字段。pin=0..31,value=0或1,各 delay/busy=0..8,fatal_stage=0..4。每个数字必须完整 ASCII 十进制非负 token;前导零合法,不接受符号、下划线、后缀、NUL 或其他非 ASCII 字节。空格/Tab/CR 分隔,LF 分行,最后一行无 LF 也执行。空行、额外字段、不合法 token、重复 pin、超过4096字节的行输出 REJECT sequence,不执行请求。sequence 从1逐行加1。
  3. 每个 pin 的唯一成功流程为 export -> ready -> direction(out) -> value。每阶段先调用一次,返回 PIN_AGAIN(-11) 时重试,总调用数最多 budget。budget 对每 pin 每阶段独立,包括最后一次调用;第 budget 次仍 AGAIN 则结果为 PIN_TIMEOUT(-110)。不能跳过阶段、重复成功阶段、或在阶段成功后再调用它。跨 pin 的调度顺序不限制。
  4. 每阶段 backend 先核因果前提,再检查 fatal_stage:等于当前阶段时立即返回 PIN_IO(-5),不消耗 busy/delay;否则消耗一个该阶段 busy/delay 并返回 AGAIN,耗尽后成功。export 成功才 exported=1;ready 成功才 ready=1,即使 ready_delay=0 也需成功调用;direction 需要 ready 并使 output=1;value 需要 output,将实际 value 设为请求值。因果前提错误返回 PIN_PROTOCOL(-71) 并增加 illegal;每次调用无论成败都增加对应计数。初值和计数全0。
  5. 任意阶段非 AGAIN 错误立即结束该 pin,不重试错误,不执行后续阶段;若该 pin 曾成功 export,必须且只需调用一次 release;export 未成功时不 release。release 清 exported/ready/output/value,不清计数,成功无额外失败;未 export 的 release 也计数且增加 illegal。失败后继续处理全部其他 pin,不回滚已成功 pin。
  6. 每 pin result.rc 为0或停止该 pin 的错误(预算耗尽使用 TIMEOUT),result.stage 成功为0,失败为1(export)/2(ready)/3(direction)/4(value)。总函数返回全部成功时0,存在失败时-1。空批返回0。
  7. 原始 stdout:每有效行先 R sequence return_code completed failed,再按输入请求顺序每 pin 一行 P sequence pin result.rc result.stage exported ready output value exports waits directions values releases illegal。数值以 ASCII 十进制输出;正值可有前导零,非负值可用+前缀,0可用-0,字段间1个或多个空格/Tab,行尾可有空格/Tab/CR。REJECT 同理。不得输出额外 stdout 行;stderr 可含任意诊断字节与任意长度,不参与业务判定。程序读到 EOF 正常退出0,输入错误为 REJECT 不终止进程。
  8. 输出使用 pin_observe 的实际设备状态,不以候选自述的状态替代。sim.c 对外只暴露 opaque bus,各 backend 函数行为在本文件及公开源码中完整定义。pin_print_observation 只打印观测;正式评分同样用公开 console/sim,重新构建,不使用工作区旧二进制。