version: V1.0.0

定时器功能说明

• 通过创建定时器，自动按照设定的定时周期定时（单次/循环）调用预先注册的回调函数，可方便的暂停、复位、删除、定时器任务。

• 可根据自己实际需求修改TIMER_MAX_NUM值来减少资源占用

• 通过修改SL_SYS_TICK方便的将模块移植到不同的硬件平台下

• 支持创建紧急定时器对象，回调函数在中断函数中执行。

定时器接口说明

/**
 * @brief 从定时器对象池中返回一个空闲的定时器对象，并设置定时器相关属性
 * 
 * @param timer_id  用于接收生成的定时器对象id
 * @param timer_mode  定时器模式 0: 周期循环  1：单次
 * @param cb        定时时间到触发的回调函数
 * @return sl_err_t 成功返回ERR_OK,  失败返回ERR_FULL, 即没有定时器资源，需要适当增加TIMER_MAX_NUM值
 * @note            用此接口创建的定时任务，回调函数会在主循环中执行，响应速度取决于主循环的实时性，紧急且简短的任务
 *                  建议使用 timer_create_urge 接口函数
 *              
 */
sl_err_t timer_create(sl_uint8_t *timer_id, sl_uint8_t timer_mode, callback cb);


/**
 * @brief 从定时器对象池中返回一个空闲的定时器对象，并设置定时器相关属性
 * 
 * @param timer_id  用于接收生成的定时器对象id
 * @param timer_mode  定时器模式 0: 周期循环  1：单次
 * @param cb        定时时间到触发的回调函数
 * @return sl_err_t 成功返回ERR_OK,  失败返回ERR_FULL, 即没有定时器资源，需要适当增加TIMER_MAX_NUM值
 * @note  此接口和timer_create 接口函数的不同之处是：
 *        用此函数创建的定时器任务对象，回调函数会在中断中执行，所以回调函数应该简短，用于比较紧急的定时任务
 */
sl_err_t timer_create_urge(sl_uint8_t *timer_id, sl_uint8_t timer_mode, callback cb);


/**
 * @brief 删除制定id的定时器对象
 * 
 * @param timer_id 待删除的定时器对象id
 * @return sl_err_t 成功: ERR_OK  失败：ERR_NOT_EXIST --id 不存在
 */
sl_err_t  timer_delete(sl_uint8_t timer_id);


/**
 * @brief 启动指定id 的定时器对象
 * 
 * @param period    定时器定时周期， 单位ms 
 * @param timer_id  待启动的定时器对象id
 * @return sl_err_t 成功: ERR_OK  失败：ERR_NOT_EXIST --id 不存在
 */
sl_err_t timer_start(sl_uint8_t timer_id, sl_uint32_t period);


/**
 * @brief  暂停指定id 的定时器对象
 * 
 * @param timer_id 待暂停的定时器对象id
 * @return sl_err_t 成功: ERR_OK  失败：ERR_NOT_EXIST --id 不存在
 */
sl_err_t timer_stop(sl_uint8_t timer_id);



/**
 * @brief   复位指定id定时器对象的计数值，重新开始计时
 * 
 * @param timer_id 待复位的的定时器对象id
 * @return sl_err_t 成功: ERR_OK  失败：ERR_NOT_EXIST --id 不存在
 */
sl_err_t timer_reset(sl_uint8_t timer_id);


/**
 * @brief 定时器任务时间走时函数，需要放在系统定时器中断中调用
 * 
 */
void  timer_tick(void);

/**
 * @brief 定时器事件监测函数，需要放在主循环中调用，检测定时器超时事件，并
 *        执行响应回调函数
 */
void  timer_task_loop(void);