os_timer.h 函数

📚 本节导读

用途: 软件定时器 API 函数声明

来源: kernel/include/os_timer.h:168

一、定时器创建

os_timer_create

os_timer_id os_timer_create(const char *name,
                            void (*func)(void *parameter), void *parameter,
                            os_tick_t time, os_uint8_t flag);

功能: 创建定时器

参数:

• name: 定时器名称
• func: 超时回调函数
• parameter: 回调参数
• time: 超时时间
• flag: 标志
  • OS_TIMER_FLAG_ONE_SHOT: 单次触发
  • OS_TIMER_FLAG_PERIODIC: 周期性触发

os_timer_delete

os_err_t os_timer_delete(os_timer_id timer);

功能: 删除定时器

---

二、定时器控制

os_timer_start

os_err_t os_timer_start(os_timer_id timer);

功能: 启动定时器

os_timer_stop

os_err_t os_timer_stop(os_timer_id timer);

功能: 停止定时器

os_timer_set_time

os_err_t os_timer_set_time(os_timer_id timer, os_tick_t time);

功能: 设置超时时间

os_timer_get_time

os_tick_t os_timer_get_time(os_timer_id timer);

功能: 获取超时时间

os_timer_get_remaining_time

os_tick_t os_timer_get_remaining_time(os_timer_id timer);

功能: 获取剩余时间

---

三、静态定时器管理

OS_TIMER_DEFINE

#define OS_TIMER_DEFINE(name) os_timer_dummy_t name

功能: 静态定义定时器

os_timer_init

os_err_t os_timer_init(os_timer_id timer, const char *name,
                       void (*func)(void *parameter), void *parameter,
                       os_tick_t time, os_uint8_t flag);

功能: 初始化静态定时器

os_timer_deinit

os_err_t os_timer_deinit(os_timer_id timer);

功能: 反初始化静态定时器

---