tkl_timer | Timer 驱动

简要说明

timer 是微处理器中用来进行时间计量的片上外设。根据实际配置要求，通常有不同的定时精度，如 16 位、32 位等，实际使用时通常需要配置的参数有定时周期、计数方式、中断服务程序等。

API 说明

tkl_timer_init

OPERATE_RET tkl_timer_init(TUYA_TIMER_NUM_E timer_id, TUYA_TIMER_BASE_CFG_T *cfg);

功能：通过端口号和基础配置初始化对应的 timer 实例，返回初始化结果。
参数：
- timer_id：端口号。
- cfg：timer 基础配置，包含定时方式、回调函数、回调函数参数。
```
typedef struct {
    TKL_TIMER_MODE_E    mode;
    TKL_TIMER_ISR_CB    cb;
    void                    *args;
} TUYA_TIMER_BASE_CFG_T;
```
  TKL_TIMER_MODE_E：
  
  名字定义
  TKL_TIMER_MODE_ONCE 单次定时
  TKL_TIMER_MODE_PERIOD 周期定时
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

名字	定义
TKL_TIMER_MODE_ONCE	单次定时
TKL_TIMER_MODE_PERIOD	周期定时

tkl_timer_deinit

OPERATE_RET tkl_timer_deinit(TUYA_TIMER_NUM_E timer_id);

功能：
- timer 实例反初始化。
- 该接口会停止 timer，并且释放 timer 相关的软硬件资源。
参数：timer_id，端口号。
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

tkl_timer_start

OPERATE_RET tkl_timer_start(TUYA_TIMER_NUM_E timer_id, uint32_t us);

功能：启动 timer。
参数：
- timer_id：端口号。
- us：timer 的定时间隔。
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

tkl_timer_stop

OPERATE_RET tkl_timer_stop(TKL_TIMER_PORT_E port);

功能描述：停止 timer。
参数：port，端口号。
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

tkl_timer_get

OPERATE_RET tkl_timer_get(TKL_TIMER_PORT_E port, uint32_t *us);

功能描述：获取 timer 定时间隔。
参数：
- port：端口号。
- us：定时间隔值，单位 us，对应 tkl_timer_start 设置的值。
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

tkl_timer_get_current_value

OPERATE_RET tkl_timer_get_current_value(TUYA_TIMER_NUM_E timer_id, uint32_t *us);

功能描述：获取 timer 当前计数值。
参数：
- timer_id：端口号。
- us：当前计数值，单位 us。
返回值：OPRT_OK 表示成功，其他值则表示发生错误。详细错误代码请参考 tuya_error_code.h。

示例

static void tkl_timer_isr_cb_fun(void *args)
{
	PR_NOTICE("hw_timer test");
}

void tuya_timer_test(void)
{
    OPERATE_RET ret;
 	TUYA_TIMER_BASE_CFG_T cfg;
    uint32_t interval_us;
    uint32_t get_us；

    cfg.mode = TUYA_TIMER_MODE_PERIOD;
    cfg.cb = tkl_timer_isr_cb_fun;
    cfg.arg = NULL;

    ret = tkl_timer_init(TUYA_TIMER_NUM_0, &cfg);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
    ret = tkl_timer_start(TUYA_TIMER_NUM_0, 1000);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
    tkl_system_delay(5000);
    ret = tkl_timer_stop(TUYA_TIMER_NUM_0);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
    ret = tkl_timer_get(TUYA_TIMER_NUM_0, &interval_us);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
	if(interval_us != 2000){
        interval_us = 2000;
    }
    ret = tkl_timer_start(TUYA_TIMER_NUM_0, interval_us);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
    tkl_system_delay(1000);
    ret = tkl_timer_get_current_value(TUYA_TIMER_NUM_0, &get_us);
    if (ret != OPRT_OK) {
        //fail
        return;
    }
    PR_DEBUG("current run time:%d us", get_us);
    tkl_system_delay(5000);
    //uninitialize iic
    ret = tkl_timer_deinit(TUYA_TIMER_NUM_0);
    if (ret != 0) {
       //failed
    }
}