# 定时器与线程服务 本摘录依据工作区所用版本的 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。移植层为操作数量设置有限上限,以结束无法交还控制权的运行。