amos 63bdf4c8bb Add 3 HARD tasks from batch 28: RT-Thread mutex ceilings, LVGL repeat, soft timers
Batch 28 commit ca63702 gave RT-Thread mutex priority ceilings (1 of 3
passed), LVGL repeat cadence and RT-Thread soft-timer wakeup (0 of 3) as
HARD. Each task comes from the commit Qwen measured, its digest matches,
and it is still present at the batch branch head.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 22:20:12 +08:00

28 lines
2.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 定时器与线程服务
本摘录依据工作区所用版本的 RT-Thread《Clock Management》《Thread Management》和相应公开接口注释整理。移植层提供离散 tick 和可重放的线程调度,时间不会自行流逝。
R01. 定时器以 tick 为单位。初始化后处于未启动状态;本工作区使用静态定时器,延迟范围为 0 到 RT_TICK_MAX/2-1,周期定时器的周期大于 0。
R02. rt_timer_start 成功返回 RT_EOK,将对象设为活动状态,以当前 tick 加配置时长作为截止时间。再次启动会替换该对象原有的排期,每个对象只保留一次有效排期。
R03. 软件定时器的回调在系统定时器线程上下文执行。回调不得早于截止时间;到期且服务线程获得运行机会时,回调应得到处理。所有已成功启动的对象均遵守这项约定,已有对象和服务的当前状态不改变其他对象的截止时间。
R04. 一次定时器只回调一次,然后不再活动。同一截止时间的对象按最近一次启动的先后顺序处理。
R05. 周期定时器在到期后继续活动,下一次截止时间为本次处理时的当前 tick 加配置周期,不补发已错过的周期。回调可以停止自身;已停止的周期定时器不再重新排期。
R06. rt_timer_stop 将活动对象从排期中移除并返回 RT_EOK;对已经不活动的对象返回 -RT_ERROR。停止后的对象不会因旧排期而回调,仍可再次启动。
R07. RT_TIMER_CTRL_SET_TIME 设置下一次启动使用的时长,不单独重新启动对象。RT_TIMER_CTRL_GET_TIME 返回配置时长;RT_TIMER_CTRL_GET_STATE 返回 RT_TIMER_FLAG_ACTIVATED 或 RT_TIMER_FLAG_DEACTIVATED。
R08. rt_thread_resume 将挂起线程重新放入就绪队列并返回 RT_EOK;非挂起线程返回 -RT_ERROR,原状态和就绪队列保持有效。线程被恢复后,不再受恢复前的线程等待超时影响。
R09. 同一线程上的恢复调用应等价于某个串行执行次序;同一挂起阶段只发生一次成功的恢复,就绪队列中同一线程只占一个位置。
R10. 本工作区的移植接口见 port/controlled.h。port_pump 给予就绪的定时器线程运行机会,直到该线程挂起;port_advance 设置当前 tick、执行系统硬定时器检查,再给予服务线程运行机会。移植层不自行扫描软件定时器或为其生成通知。
R11. port_capture_lock 记录下一次锁获取所用的地址。port_after_unlock 与 port_before_lock 在指定锁的下一次释放后或获取前执行一次应用侧回调,回调执行时该锁未被持有。它们用于重放另一执行主体在内核操作边界发起的公开接口调用,不表示流逝了额外 tick。
R12. 持续占用处理器而不挂起的线程不能完成一次 port_pump。移植层为操作数量设置有限上限,以结束无法交还控制权的运行。