CN / EN

全部 创新产品 应用与设计 文档中心 工具与软件 开发者社区 关于汇顶
文档反馈
感谢关注汇顶文档，期待您的宝贵建议！
感谢您的反馈，祝您愉快！
无匹配项 共计114个匹配页面
文档中心 > GR5xx APP驱动用户手册/ APP驱动接口/ APP DUAL_TIM驱动/ 接口函数 Copy URL

接口函数

表 103 DUAL_TIMER驱动接口函数
API 芯片
GR551x GR5526 GR5x25 GR533x

app_dual_tim_init

Y

Y

 Y Y

app_dual_tim_deinit

Y

Y

 Y Y

app_dual_tim_start

Y

Y

 Y Y

app_dual_tim_stop

Y

Y

 Y Y

app_dual_tim_set_params

Y

Y

 Y Y

app_dual_tim_set_background_reload

Y

Y

 Y Y

app_dual_tim_get_handle

Y

Y

 Y Y
app_dual_tim_set_onetime_reload N N N Y
app_dual_tim_io_crtl_config N N N Y
app_dual_tim_set_period_count N N N Y

app_dual_tim_init

表 104 app_dual_tim_init接口
函数原型

uint16_t app_dual_tim_init(app_dual_tim_params_t *p_params, app_dual_tim_evt_handler_t evt_handler)
功能说明

初始化DUAL TIMER
输入参数

  • p_params：初始化参数的结构体指针

  • evt_handler：用户自己实现的中断回调函数
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

回调函数形式参照typedef void (*app_dual_tim_evt_handler_t)(app_dual_tim_evt_t *p_evt)；

HAL层已经实现中断标志位的清理，用户不用关心中断标志的清理，回调函数根据返回事件类型进行相应的处理即可。

app_dual_tim_deinit

表 105 app_dual_tim_deinit接口
函数原型

uint16_t app_dual_tim_deinit(app_dual_tim_id_t id)
功能说明

反初始化DUAL TIMER
输入参数

id：DUAL TIMER模块ID
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

app_dual_tim_start

表 106 app_dual_tim_start接口
函数原型

uint16_t app_dual_tim_start(app_dual_tim_id_t id)
功能说明

开启DUAL TIMER，使能中断并开始向下计数
输入参数

id：DUAL TIMER模块ID
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

app_dual_tim_stop

表 107 app_dual_tim_stop接口
函数原型

uint16_t app_dual_tim_stop(app_dual_tim_id_t id)
功能说明

关闭DUAL TIMER，停止计数
输入参数

id：DUAL TIMER模块ID
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

app_dual_tim_set_params

表 108 app_dual_tim_set_params接口
函数原型

uint16_t app_dual_tim_set_params(app_dual_tim_params_t *p_params, app_dual_tim_id_t id)
功能说明

运行过程中修改DUAL TIMER参数
输入参数

  • id：DUAL TIMER模块ID

  • p_params：需要修改参数的结构体指针
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

app_dual_tim_set_background_reload

表 109 app_dual_tim_set_background_reload接口
函数原型

uint16_t app_dual_tim_set_background_reload(app_dual_tim_id_t id, uint32_t reload_value)
功能说明

设置自动装载值（下一周期生效）
输入参数

  • id：DUAL TIMER模块ID

  • reload_value：自动装载值
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注

app_dual_tim_get_handle

表 110 app_dual_tim_get_handle接口
函数原型

dual_timer_handle_t *app_dual_tim_get_handle(app_dual_tim_id_t id)
功能说明

获取DUAL TIMER句柄
输入参数

id：DUAL TIMER模块ID
返回值

Timer句柄：详见SDK_Folder\drivers\inc\hal\gr55xx_hal_dual_tim.h结构体
备注

app_dual_tim_set_onetime_reload

表 111 app_dual_tim_set_onetime_reload接口
函数原型

uint16_t app_dual_tim_set_onetime_reload(app_dual_tim_id_t id, uint32_t reload_value)
功能说明

设置一次性装载值
输入参数
  • id：Dual Timer模块ID
  • reload_value：自动装载值
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注
  • 一次性重载值仅在下一个周期生效；它比设置自动装载值（下一周期生效）具有更高的优先级。
  • 仅适用于GR533x

app_dual_tim_io_crtl_config

表 112 app_dual_tim_io_crtl_config接口
函数原型 uint16_t app_dual_tim_io_crtl_config(app_dual_tim_params_t *p_params, app_dual_tim_id_t id, app_dual_tim_io_crtl_params_t *io_crtl_params)
功能说明

配置Dual Timer I/O控制功能
输入参数
  • p_params：初始化参数结构体指针
  • id：DUAL TIMER模块ID
  • io_crtl_params：I/O控制参数（参考代码中的app_dual_tim_io_crtl_params_t）
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注
  • 该函数调用必须在app_dual_tim_init之后
  • 重新配置IO控制需要重新初始化Dual Timer
  • 仅适用于GR533x

app_dual_tim_set_period_count

表 113 app_dual_tim_set_period_count接口
函数原型 uint16_t app_dual_tim_set_period_count(app_dual_tim_id_t id, uint32_t count_value)
功能说明

设置周期数功能
输入参数
  • id：DUAL TIMER模块ID
  • count_value：周期数值（需大于1）
返回值

APP_DRV_xxx：详见SDK_Folder\drivers\inc\app_drv_error.h宏定义
备注
  • 该函数仅在带I/O控制的周期/循环模式下可用；函数调用必须在app_dual_tim_io_crtl_config之后
  • 该函数将强制开启停止事件中断
  • 如果当前计数值不是初始的周期值，可能会导致第一个周期缩短
  • 仅适用于GR533x

扫描关注

打开微信，使用“扫一扫”即可关注。