HARD: Mynewt FCB media results and SPIFFS append truncate space (batch 28 47298b7, after a top-up); TinyUSB CH34x control completion, TLV320 output gain encoding and ArduinoJSON decimal carry (batch 26 f20f11c); NetX Duo PPP buffered burst (batch 28 7f01d64). MEDIUM: RT-Thread ringbuffer DMA peek (batch 28 7f01d64). Task digests match the measured ones. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.6 KiB
dev-tinyusb-ch34x-control-completion
路线 D,family state-machine-timing,语言 C,split group hathach/tinyusb。状态为 CALIBRATED_READY_FOR_ROOT_REVIEW,难度 UNMEASURED,真实 Agent 与硬件未验证。
上游 https://github.com/hathach/tinyusb ,MIT,base 22a12c76689399bd1a67e52531171876e5d88a28,唯一 fix 138567af3e39e08742b3d1edf5b83d27d8526a4a,source oss/hathach/tinyusb@138567af3e39。完整官方改动 75 加/52 删、1 文件、7 hunk,涉及公开控制封装、CH34x 同步/异步完成与枚举回调。单 fix 跨多个函数,属于单真实修复例外,不冒充两个独立缺陷。gold 是整文件官方 blob,SHA256 d506c2058d1672ce765ed3fd2c13abc60be64d2844bc057e7199438b6e8d93fb,没有叠加补丁。
初态保留 25 个完整上游文件,逐文件 SHA/原 blob/tree 见同批 ENV env-tinyusb-ch34x-callback-inventory/evidence/originals.json。原文件为 LICENSE,src/tusb.c、tusb.h、tusb_option.h,以及 src/common/{tusb_common.h,tusb_compiler.h,tusb_debug.h,tusb_fifo.c,tusb_fifo.h,tusb_mcu.h,tusb_private.h,tusb_types.h,tusb_verify.h},src/osal/{osal.h,osal_none.h},src/host/{hcd.h,hub.h,usbh.c,usbh.h,usbh_pvt.h},src/class/cdc/{cdc.h,cdc_host.c,cdc_host.h,serial/ch34x.h},src/class/hid/hid.h。所有原版权/许可头保留,HID/HUB 实现关闭,FTDI/CP210x 关闭,不添加其他 vendor 凑规模。
六个补全文件是 Makefile、port/tusb_config.h、app/observe.c、app/smoke.txt、README.md、docs/host-contract.md。总计 31 个公开文件。配置使用 OS_NONE/MCU_NONE、等长 RX/TX backing、FIFO256、端点 backing64;观察程序仅物理 HCD 与公开应用 API,真实 host/core/FIFO/stream 都运行,不直接调用 cdch/ch34x 私有入口,不构造 class driver,不补用户 callback。
必要独有行沿用 ENV 完整扣旧账和根独审:生产 C 555 行;根额外排诊断分支后保守 552 行,不需计头/宏达到500。该口径排除了旧完整 template token 行与归一窗口复用,不计支撑程序或无关 vendor。依赖闭包已通过 trace6 真实编译链接。
| 判据 | 公开条款 | 独立依据 |
|---|---|---|
| E1/E2 真实枚举、标识、端点顺序/MPS、mount | R01/R02 | 冻结 hcd.h:187-208,cdc_host.h:83-91,190-199;tusb_option.h:480-490,CH34x 原公开设备表/版本支持检查;USB2 §9 |
| C1/C2/C3 普通字段矩阵、同步/异步、NULL userdata、canary、完成缓存 | R03/R04/R05/R06 | 冻结 cdc_host.h:96-102,135-156;cdc.h:187-213;CH340DS1 3B §2、§5.4;冻结 set_function_call 的 NULL 结果缓冲语义 |
| C4/C5/C6 已提交 baud/format 后 FAILED/STALLED/TIMEOUT,回调/结果/恢复 | R04/R05/R06 | cdc_host.h:135-145,common/tusb_types.h:225-229,hcd.h:187-208;USB2 §5.5/§8.5.3;不要求失败时原子回滚 |
| C7/C8/C9 独立 baud/format/state 首次调用及穿插,成功/已提交失败 | R03/R04/R05/R06 | cdc_host.h:92-102,146-156;CH340DS1 §2、§5.4;字段 API 本身及冻结 local cache 公开承诺 |
| S1/S2 零长度、短包/分片、实际接受量、MPS、FIFO回压/绕回、ZLP | R07 | cdc_host.h:106-130;common/tusb_private.h:123-147;USB2 §5.8.3 的短包/ZLP或主机已知期望长度终止规则;原ZLP仅记录、不强制所有实现一致 |
| L1/L2 detach/reuse、非零枚举line state、原池复用 | R01/R03/R04/R06 | cdc_host.h:41-48,83-102,190-199;host/usbh.h 的 mounted API;USB2 §9 |
| B1/B2/D1 不支持输入和 HCD 拒提交诊断 | R08 | 冻结版本的支持检查;原 header 未承诺异步 true 等价整个组合操作完成,也未承诺提交拒绝后的 callback |
公开依据原件保存在同批 ENV:WCH 作者 CH340DS1 3B(SparkFun 原 PDF 镜像 https://docs.sparkfun.com/SparkFun_RTK_Facet_mosaic/assets/component_documentation/CH340DS1.PDF )与 USB-IF 官方 USB2 ZIP https://www.usb.org/sites/default/files/usb_20_20250603.zip 。此任务不下载或 vendor GPL 驱动;原 MIT 文件的寄存器/PID 名称与来源注释原样保留。没有完整独立 vendor 寄存器 oracle,判据不比较精确 divisor/prescaler、特殊寄存器 magic 或请求顺序。错误注入按已提交寄存器作用(baud/format/state)分类,在 status 阶段完成错误,不按第 N 请求。
样例 9 类:gold、valid_explicit_sequence、valid_phase_loop 为 PASS;template、noop、cheat、cheat_read_grader、symptom_mask、partial_sync_only 为 FAIL。两个合法替代保留原异步结构并采用显式同步序列或阶段循环,与官方新增内部完成分派结构不同;单修复的部分负例不称独立 pair。
check.py 是唯一私有 Python 判据,另有压缩的非 Python cases.data/support.data。候选与纯观察 harness 在 UID/GID65534、groups=[] 的子进程编译/运行,完整期望在 root 父独立比较。scratch 由 mkdtemp0700 创建、只 chown65534,首 child 后父无任何 scratch 文件系统操作;所有候选/支撑/观察/输入/展开期望/argv/probe 私有快照和摘要先冻结。正式 verify.py 与 rollout/bos_verify.py 逐字相同。额外 helper /evidence 根本身0700、owner非65534,另作真实 PermissionError 探针;正式平台隔离探针不能代替此探针。
已知边界保持公开:不支持的字长/1.5停止位异步可能第一阶段已提交而无最终通知;HCD 提交拒绝与接受后错误完成分开;不等 RX/TX backing 配置存在继承缺陷,未扩张到不等配置,但物理 IN64/OUT16 必测。所有诊断输入仍保留,不自动作 PASS/FAIL 条件;普通合法输入从未因 gold 行为删减。
原生最终闸门:runs/20261102-D-oss-fix-26/tinyusb-ch34x-control-completion/native-20261105T034930-a7a38a59,每轮1676 case(1663必需+13诊断),完整gold5 PASS/parent5 FAIL(每轮94个普通失败),身份probe和精确cleanup全部通过。旧轮的错误 ZLP 累计长度模型、摘要大小写问题及冻结摘要加强前身份均保留并排除最终准入。native 不等于正式校准、真实模型或硬件验证。
末版 helper-20261105T034930-932c0ce4 为9类各5、全部45符合预期,逐轮1676 raw保留;末版正式 formal-final/calibration-d881a8dcb74b44c293d1f0ac45cc52e5 为45全部符合预期,cleanup confirmed。最终 digest 5ff420e3b72df5dcc81e76b0aa1ea31f5824e63f8bcf881be51269f24500bc86。034145旧native与上一helper/formal因后继before状态放宽而被取代;所有旧数据保留,末版1676输入逐字不变。作者静态/manifest/身份/回执复核通过,241个本作者精确容器名最终inspect全部不存在。根需独立审阅后才能准入;作者不提交、不修改 shared、不运行整库 tests,checkpoint 由 root 负责。