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>
4.4 KiB
4.4 KiB
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 难度。