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>
3.0 KiB
主机串口接口合同
R01. 使用 tuh_init 初始化主机,经 HCD 接入事件和 tuh_task 执行枚举;设备的地址、描述符、端点及配置由 USB 主机栈管理。已支持的设备应产生一次 CDC mount 和主机 mount 通知,移除后产生 unmount 通知并关闭其端点,之后可以重新接入其他设备。
R02. 本工程启用 CH34x,不启用其他串口芯片、HID 或 HUB。设备采用原 PID 列表中的标识,版本字节为 0x30 至 0xff,vendor interface 0 的两个 bulk 端点位于 interrupt 端点前;bulk IN/OUT 可以互换描述符次序。物理 IN 最大包长 64,OUT 最大包长 64 或 16;配置中的 RX/TX 存储大小保持相等。
R03. line coding 字段依次为每秒位数、停止位枚举、校验枚举和数据位数。普通测试范围包括 9600、19200、38400、57600、115200、230400、307200、460800、921600、1500000 和 2000000 baud,5 至 8 数据位,none/odd/even/mark/space 校验,1 或 2 停止位。枚举初始化采用配置头中的 line coding 与 DTR/RTS。
R04. 控制接口提供 completion callback 时立即返回,并在请求完成后调用一次 callback,保留原 user_data、设备地址、端点地址和传输结果;user_data 可以为 0。传输仍在队列中时,调用者不能观察到已完成结果。callback 可以读取此次成功操作后的本地状态。
R05. 控制接口没有 completion callback 时等待请求完成;user_data 非零时指向 xfer_result_t 并获得实际完成结果,user_data 为 0 时也可完成。同步调用成功返回 true,失败返回 false。设备已经接收的传输随后报告 FAILED、STALLED 或 TIMEOUT 时,应保留该结果;下一次合法操作仍可执行。
R06. 本地 line coding 查询不发起 USB 传输,反映已成功设置的字段;失败的设置不更新失败字段。分别设置 baudrate、data format 和 control line state 时,其余字段保持原值。组合操作已有字段成功、后续字段失败时不要求回滚已完成字段。
R07. CDC 的读写接口按实际接受量返回字节数,零长度操作返回 0。软件 FIFO 与端点流应保持字节内容和顺序,支持短包、分片、容量回压以及重复绕回。USB bulk 以端点最大包长划分数据,完整包尾在无后续数据时可以用零长度包结束;短包本身结束该次传输。
R08. 此冻结版本不承诺 1.5 停止位、5 至 8 位之外的字长、0 或大于 2000000 baud,以及低于 0x30 的设备版本。不支持的异步组合请求可能已提交部分操作而没有最终通知;HCD 在提交时直接拒绝也不增加 callback 保证。这些行为只作诊断。上述边界不扩大到已经提交后收到错误完成的普通合法请求。
来源:原 src/class/cdc/cdc_host.h 的公开 API 和字段定义;WCH CH340DS1 3B §2、§5.4;USB 2.0 §5.5、§5.8.3、§8.5.3、§9。原设备寄存器字节保留为观察,不以未公开的 divisor、prescaler 或特殊写入顺序作为验收值。