合并受阻
欢迎来到 openUBMC 社区
Hey @chenshengfan , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅机器人自助配置使用手册。
联系指引
有疑问可以联系 SIG: sig-framework ,
维护者是: @WeliveWelove, @zjp99 ,


关联 Issue 通知
@chenshengfan , 提交的PR需要关联issue,指导链接:https://forum.openubmc.cn/t/topic/208
如果已经关联了issue, 但是needs-issue标签仍然存在,你可以在评论 /check-issue 来移除它。


AI Declaration Check Failed
@chenshengfan, AI declaration compliance check failed, please try again later. ❌


CI已开始运行,查看流水线详情:流水线链接


/ai review


代码审查
审查结论
各变更文件审阅结果
- CHANGELOG:无问题。新增
1.140.3条目与mds/service.json的版本号一致,日期(2026-10-27 晚于 2026-10-23)顺序正确,描述与本次改动范围相符。 - mds/service.json:无问题。仅
version由1.140.2改为1.140.3,JSON 键名拼写、结构均正确(新引入的utils.vos依赖未在此声明的问题已在下方 finding 中合并说明)。 - src/lualib/driver/canbus_chip.lua:发现 4 处问题(3 个 P2、1 个 P3),见下。
问题清单
| # | 优先级 | 位置 | 问题 |
|---|---|---|---|
| 1 | P2 | canbus_chip.lua:89-91 | 计时器返回 0 时退化为满额预算且不重锚定,总时限保护完全关闭,本 PR 要修的两种活锁在该场景下依旧存在 |
| 2 | P2 | canbus_chip.lua:178-185 | 硬编码 1000ms 总预算与可配置 ReadTmout 脱钩,覆盖"初始帧重试 + 全部多帧",可能把原本合法的长多帧读取误判为超时(对外行为回归) |
| 3 | P2 | canbus_chip.lua:17 | 新增 require('utils.vos'):仓库内无该模块、全仓无 tick_get 引用,service.json 未提高 libmc4lua 最低版本;若依赖包不提供,driver/driver.lua:23 的 eager require 会让整个驱动注册表加载失败 |
| 4 | P3 | canbus_chip.lua:86-97 | 新增的计时/回绕/remain <= 0 多分支无任何测试覆盖,回绕锚定写反或 read_tmout 被收敛到 0 这类回归无法被拦截 |
补充说明(不单独立项):calc_remaining 的计时源读取位于每次帧读取之前,属于热路径上的一次额外读取,但相对 CAN 总线 I/O 开销可忽略,未作为独立性能问题上报。
总体风险评估
改动方向正确(为两处无界循环补上了终止条件),但关键防护在最需要它的异常时基场景下会被关掉(finding 1),且总时限的取值未与既有的可配置读超时/实际帧数对齐,存在误报超时的功能回归风险(finding 2);再加上新增外部依赖未经版本约束确认(finding 3),风险等级为中等偏高。建议合入前至少确认 utils.vos.vos_tick_get 的实际提供方与返回值单位,并给出 now == 0 时的兜底终止条件;PR 自述未上板验证,建议补充上述两项后做一次硬件回归。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 0 |
| 🟡 建议 | 4 |
💬 仅评论


🟡 Medium Priority
变更行(src/lualib/driver/canbus_chip.lua:21 新增 CAN_READ_TOTAL_TIMEOUT = 1000,178-185 在多帧循环里用它判定超时并把 read_input.read_tmout 收敛为 min(self.read_tmout, remain))。
影响链路:ctor(105 行)允许 self.read_tmout = object.ReadTmout,且没有上限约束;read()(173 行)在进入 multi_read 之前就取 start_tick,因此这 1000ms 是“初始帧 ID 匹配重试 + 后续所有多帧 + 每帧等待”的共享预算。
失败模式:只要板级配置把 ReadTmout 配成 > 1000(合法配置,代码不校验),仅一次合法的单帧等待就可能耗尽或超过总预算,改造前能成功返回的读取现在会抛 request error, multi-frame read timeout(或 read can_id mismatch);同理,多帧响应帧数较多、帧间有延迟(每帧最多 ReadTmout)时总耗时超过 1s 也会被判超时。这是对外可见的行为回归,且 PR 自述“未上板做硬件回归”,该风险未被验证。
建议:让总时限可配置且不小于单次读超时,例如在 ctor 中读取 object.TotalTmout 并做 math.max(total, self.read_tmout) 保底;或改为仅对“连续无进展的重试”计时,避免合法但耗时超过 1s 的多帧响应被误判超时。


🟡 Medium Priority
变更行(src/lualib/driver/canbus_chip.lua:17):新增 local vos = require('utils.vos'),并在 87、112、173、218 行调用 vos.vos_tick_get()。
证据:仓库 src/lualib 下不存在 utils 目录(仅有 driver/stream/mux/protocol/config),全仓范围内 tick_get 无其它引用,utils.* 目前只有 spi_flash.lua 使用 utils.core,说明 utils.* 来自外部包 libmc4lua;而 mds/service.json 只声明 libmc4lua/[>=0.0.70 <1.150.0],没有为本 PR 新引入的 utils.vos / vos_tick_get 提高最低版本约束。
失败模式:若部署环境的 libmc4lua 版本不提供 utils.vos,require 在模块加载期就抛错;而 src/lualib/driver/driver.lua:23 是 eager CanbusChip = require('driver.canbus_chip'),会连带使整个 driver 注册表加载失败,故障面远大于 CAN 本身(I2C/CPLD 等全部驱动不可用),而不是只有 CAN 读失败。
建议:核实 utils.vos.vos_tick_get 由 libmc4lua 提供并在 mds/service.json 中提升 libmc4lua 的最低版本要求;或用 pcall(require, 'utils.vos') 并在失败时回退到本地时基,避免模块加载期硬失败。


🔵 Low Priority
变更行(src/lualib/driver/canbus_chip.lua:86-97 新增 calc_remaining,115-133 与 177-189 重写为带时限的循环)。这里引入了多分支高风险控制流:now == 0、start_tick == 0、now < start_tick(回绕/回退)、remain <= 0,以及预算向 read_tmout 的收敛(127、185);PR 自述“单元测试通过:未勾选”,本次 diff 也未新增任何测试。
未被捕获的具体回归:① 计时器回绕/回落时重新锚定逻辑若写反(例如应 now < start_tick 写成 <= 或锚定到错误一侧),正常读取会被立刻误判超时,而现有用例无法暴露;② math.min(self.read_tmout, remain) 若把 read_tmout 收敛到 0,会在真实总线上表现为“总是读超时”,同样无测试可拦。锚定到超时分支的测试(mock vos.vos_tick_get 按序返回 t、t+500、t+1001 与 0)成本很低。
建议:补充单元测试:mock vos.vos_tick_get 返回序列覆盖 tick 正常递增、超出 1000ms、持续返回 0、回绕(now < start_tick)四种情况,断言 multi_read / read 在超时后抛出预期错误且不再无限循环,同时验证正常多帧读取的返回内容与长度不变。


🟡 Medium Priority
变更行(src/lualib/driver/canbus_chip.lua:89-91):calc_remaining() 在 now == 0 时直接 return CAN_READ_TOTAL_TIMEOUT, start_tick,即“返回满额预算且不重新锚定”。
影响链路:multi_read(115-133)与 read 的多帧循环(177-189)都用该返回值做 remain <= 0 判定,并用 math.min(self.read_tmout, remain) 收敛读超时。只要计时源持续返回 0,每次迭代 remain 恒为 1000 → remain <= 0 永远不成立 → 两个循环都没有任何超时出口。
失败模式:注释本身承认计时器可能读失败(“/dev/sys_info 异常返回 0”)。在该环境下:① 总线持续返回非预期 CAN ID 时 multi_read 仍会无上限重试;② 设备始终不返回 cnt=0 结束帧时 while read_can_id & CAN_ID_CNT_MASK ~= 0 仍会无限循环。这正是本 PR 声称要修复的两个活锁,等于是“修复在唯一需要它兜底的场景下被关闭”。此外若计时器长时间失效后又恢复,start_tick 未重锚定会让 now - start_tick 巨大,反而立即误报超时,与注释“不会误判超时”的承诺相反。
建议:在 now == 0(计时器不可用)时不要退化为无限预算:改用本地兜底时基(如 os.clock()*1000)计算已耗时,或引入一个与时间无关的重试/帧数上限常量,使循环在任何情况下都有终止条件;同时该分支应重锚定 start_tick 或返回一个由兜底时基算出的剩余值。


💡 建议:回绕/回退时重新锚定会重置整个剩余预算
now < start_tick(回绕或时钟回退)时返回完整 CAN_READ_TOTAL_TIMEOUT 并重新锚定起始 tick,会把“总时限”从严格 1000ms 放宽到最多 +1000ms。若窗口末尾发生一次回绕,整体执行可被延长近一倍。
修复建议:若希望时限更保守,可在重新锚定时以 self.read_tmout 兜底(math.min(CAN_READ_TOTAL_TIMEOUT, self.read_tmout))而不是给满 1000ms,或至少确认回绕周期远大于 1000ms。PR 描述已说明此策略,此处仅为提示可考虑更严格的边界。


人工检视报告
感谢 @chenshengfan 的贡献!为 CAN 多帧读取增加 1000ms 总时限保护的思路清晰,有效解决了持续收到非预期 CAN ID 或不返回结束帧时的活锁问题,整体方案合理,建议合入前进一步明确边界情况下的行为。
📋 检视概览
| 项目 | 详情 |
|---|---|
| 评级 | 一般 |
| 严重问题 | 0 |
| 警告 | 2 |
| 建议 | 2 |
需关注的问题(已关联代码行)
| # | 文件 | 行 | 级别 | 说明 |
|---|---|---|---|---|
| 1 | src/lualib/driver/canbus_chip.lua |
89 | 警告 | vos_tick_get() 返回 0 时总时限保护被绕过,活锁可能侧复现 |
| 2 | src/lualib/driver/canbus_chip.lua |
96 | 警告 | (now - start_tick) 时间单位需确认是否为毫秒 |
| 3 | src/lualib/driver/canbus_chip.lua |
93 | 建议 | 回绕/回退重新锚定会重置完整预算,时限不严格 |
| 4 | src/lualib/driver/canbus_chip.lua |
127 | 建议 | 修改调用方共享的 input.read_tmout 表 |
代码已确认无问题的部分
- 版本号升级一致:
mds/service.json1.140.2 → 1.140.3 与 CHANGELOG 新增条目匹配。 - 多帧读取循环与
multi_read复用同一 1000ms 预算,超时前重置 ID 掩码再报错,资源释放逻辑正确。
总结
本 PR 目标明确、实现严谨,主要关注点在于计时器异常与回绕下的边界行为(作者在 PR 描述中已说明“重新锚定”策略,但建议明确时间单位约定,并为 vos_tick_get()==0 的端到失败场景补一个有界降级,以确保总时限保护在异常路径上也能生效)。建议修复两项警告后合入。


| 任务名称 | 结果 |
|---|---|
| pre-commit检查 | ✅ SUCCESS |
| PR描述检查 | ✅ SUCCESS |
| 防投毒检查 | ✅ SUCCESS |
| 开源合规检查 | ✅ SUCCESS |
| 编译构建 | ✅ SUCCESS |
| UT测试 | ✅ SUCCESS |
| IT测试 | ✅ SUCCESS |
| 代码覆盖率 | ❌ FAILED |
| 修改行数检查 | ✅ SUCCESS |
| 头文件检查 | ✅ SUCCESS |
| AI Review | ✅ SUCCESS |


[P2] 将扩展读的写请求也纳入同一总时限
这里仅缩短 read_tmout,但 multi_read 使用扩展读取模式,driver.read 最终进入 stream/can.lua:extend_read,先按未缩短的 input.write_tmout 写请求,再按写之前算出的 read_tmout 读取。比如 WriteTmout=2000、ReadTmout=100 时,写请求合法等待1200ms,随后1ms内收到匹配的结束帧,就会直接在131行成功返回;以原始 Lua 调用链和受控时钟/I/O 桩验证,模拟总耗时为1201ms,1000ms总时限没有生效。即使写时间较短,也会额外消费这一次读所用的剩余预算。建议把截止时刻传到扩展读写层,写前和写后分别更新剩余预算,并在成功收帧后检查截止条件,避免成功分支绕过总时限。


当前PR是否有AI参与:
PR功能描述 / 为什么需要这个合入:
本 PR 从
fix/canbus-multi-read-timeout分支合并到main,包含 1 个提交,修改 3 个文件。CAN 驱动
multi_read在成功读到帧但 CAN ID 与预期不一致时会无条件重试,且多帧接收循环以 ID 中的 cnt 位为结束条件;当总线持续收到非预期 ID 帧、或设备始终不返回结束帧时,会无限循环并持续占用总线。本 PR 增加总时限保护,避免此类活锁。变更类型
修改方案:
multi_read改为按vos_tick_get()计算已耗时,超过CAN_READ_TOTAL_TIMEOUT(1000ms)即报错退出,不再无上限重试;每次读取将read_tmout收敛为min(read_tmout, 剩余时间)。while cnt ~= 0循环复用同一 1000ms 预算,超时前先复位 ID 掩码再抛错。calc_remaining()处理计时器读取失败返回 0、回绕/回退等异常,避免数值反转导致误判超时。bit_read同步传入起始 tick。验证方案:
luac5.4 -p语法检查通过。luacheck检查通过(0 warning / 0 error)。测试建议:
read can_id mismatch,不再无限重试。multi-frame read timeout。自验证报告:
补充:已完成
luac5.4 -p语法检查与luacheck(0 warning / 0 error)、pre-commit 的 Stylua/Luacheck 通过;本次未上板做硬件回归。该PR关联的issue
(格式为 fixes #<issue号>, 或者resolves #<issue号>): 无(本次暂不关联 issue)
希望检视人员了解: