amos a98d336f62 Add 6 HARD and 1 MEDIUM tasks from batches 26 and 28
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>
2026-11-07 01:25:49 +08:00

4.4 KiB
Raw Permalink Blame History

serial-rtthread-ringbuffer-peek-dma 规格

  • 路线:D,开源项目真实修复。来源:https://github.com/RT-Thread/rt-thread。
  • 修复前:f610f18a3c796ba1bc404c886b408b01ca814cef;修复:ffcd1cb3160b18ba789c6ae620b5e1c5d76052bc。
  • 许可证:仓库冻结的 LICENSE 是 Apache-2.0,冻结 C 和头文件 SPDX 也是 Apache-2.0。未发现根目录 NOTICE。
  • 来源组:RT-Thread/rt-thread;族:memory-buffers;语言:C。根因属于零拷贝缓冲视图与读取游标语义。
  • 缺陷:原 rt_ringbuffer_peek 在返回连续可读段时推进读索引,与公开文档的只观察语义相违。原 Serial v2 DMA 路径依赖该消费副作用,修复观察语义时必须同步保留 DMA 数据的一次交付。该上游修复跨三个候选文件,涉及缓冲与串口两个入口。
  • 替身测试:在固定 trace6 无网容器,使用原版 ringbuffer.c 及 dev_serial_v2.c,设备底座与 DMA 事件受控;不依赖外设、时间或联网。预制普通对照见 factory/20261103-D-oss-fix-28/subagents/rtthread-ringbuffer-peek-dma/preflight/。

原件与补全

模板路径 来源
LICENSE 上游修复前原件
components/drivers/include/ipc/ringbuffer.h 上游修复前原件,候选
components/drivers/ipc/ringbuffer.c 上游修复前原件,候选
components/drivers/serial/dev_serial_v2.c 上游修复前原件,候选
components/drivers/include/drivers/dev_serial_v2.h 上游修复前原件,完整保留
support/rtconfig.h、support/rtdef.h、support/rtthread.h、support/rtdevice.h、support/rthw.h、support/rtdbg.h Linux 用户态设备底座桩;不实现环形缓冲或 ISR
Makefile、smoke.c、README.md、docs/behavior.md 补全:构建、正常路径自检、说明和公开约定

gold/ 仅将三个候选文件逐字替换为上游修复对应文件。valid_alt/ 用另一个只观察实现和串口内已有的读索引推进辅助函数,不增加新公开函数。所有样例仅含三个候选文件。评分侧 grade_support/dev_serial_v2.h 与模板内的冻结原头逐字相同;因为评分容器只接收三个候选文件,它由受保护附件提供,未裁剪或替换类型定义。

修复前独立依据

RT-Thread 用户于 2025-11-06 提交的 issue #10901 在修复提交前公开引用文档中心的环形缓冲约定,明确 peek 为“读数据但不取出数据”;同一 issue 记录实际读索引推进的偏差。冻结版 ringbuffer.c 的函数注释及结构注释给出首个可读地址、空状态和镜像回卷模型。冻结版 dev_serial_v2.h 的 UART DMA 示例从接收回调读出该段字节;RT-Thread 官方 UART 文档说明 DMA 接收、回调与设备读取流程。新增 get_direct 名字和精确实现不是公开验收条件。

判据与依据

判据观察 公开依据
普通写入/读取返回字节、FIFO 顺序与可读长度 template/docs/behavior.md:3;冻结 ringbuffer.c 的 put/get/data_len 注释
空缓冲观察返回 0、空指针、状态不动 template/docs/behavior.md:5;冻结 ringbuffer.c 的空缓冲路径
非空、满缓冲和回卷时只返回连续可读段及正确字节 template/docs/behavior.md:7;冻结 ringbuffer.c 的地址和分段逻辑
连续观察前后读索引、镜像、可读长度不变,后续普通读取仍得到原数据 template/docs/behavior.md:9;修复前 issue #10901 所引文档
Serial v2 ISR 中 DMA 接收字节按序、一次交付、回卷后处理尽 template/docs/behavior.md:11;冻结 dev_serial_v2.h 示例与官方 UART 文档
两种缓冲策略的无溢出交付一致 template/docs/behavior.md:13;冻结 dev_serial_v2.c 两条 DMA 路径

样例与验证边界

gold 为上游修复;template 为冻结缺陷;noop 关闭观察;cheat 只修观察、保留串口旧调用;symptom_only 仅对一种短段特殊处理;cheat_read_grader 用于判据隔离;valid_alt 是不同写法的合法修复。私有 probe.c 仅打印运行身份、索引和字节,check.py 独立计算期望。评分只编译和运行三个候选文件、原公开头和补全设备底座,不能证明实板 DMA 时序、完整 RT-Thread 内核构建或真实 Agent 难度。