CN / EN

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

接口函数

表 261 DSPI驱动接口函数
API 芯片
GR551x GR5526

app_dspi_init

N

Y

app_dspi_deinit

N

Y

app_dspi_command_transmit_sync

N

Y

app_dspi_command_transmit_async

N

Y

app_dspi_command_sync

N

Y

app_dspi_command_async

N

Y

app_dspi_transmit_sync

N

Y

app_dspi_transmit_async

N

Y

app_dspi_get_handle

N

Y

app_dspi_config_mode

N

Y

app_dspi_config_data_size

N

Y

app_dspi_abort

N

Y

app_dspi_abort_it

N

Y

app_dspi_init

表 262 app_dspi_init接口
函数原型

uint16_t app_dspi_init(app_dspi_params_t *p_params, app_dspi_evt_handler_t evt_handler)
功能说明

初始化DSPI
输入参数
  • p_params：初始化参数的结构体指针
  • evt_handler：用户自己实现的中断回调函数
返回值

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

回调函数形式参照typedef void (*app_dspi_evt_handler_t)(app_dspi_evt_t *p_evt)；

HAL层已经实现中断标志位的清理，用户不用关心中断标志的清理。

app_dspi_deinit

表 263 app_dspi_deinit接口
函数原型

uint16_t app_dspi_deinit(void)
功能说明

反初始化DSPI
返回值

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

app_dspi_command_transmit_sync

表 264 app_dspi_command_transmit_sync接口
函数原型

uint16_t app_dspi_command_transmit_sync(app_dspi_command_t *p_cmd, uint8_t *p_data, uint32_t timeout)
功能说明

DSPI轮询方式（同步）发送数据，带控制命令封装
输入参数
  • p_cmd：命令、数据参数的结构体指针
  • p_data：需要发送的数据，以uint8_t类型数组给出
  • timeout：超时时间（单位：ms），当传输数据时长超过该设定值，接口返回APP_DRV_ERR_TIMEOUT
返回值

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

app_dspi_command_transmit_async

表 265 app_dspi_command_transmit_async接口
函数原型

uint16_t app_dspi_command_transmit_async(app_dspi_command_t *p_cmd, uint8_t *p_data)
功能说明

DSPI中断方式（异步）发送数据，带控制命令封装
输入参数
  • p_cmd：命令、数据参数的结构体指针
  • p_data：需要发送的数据，以uint8_t类型数组给出
返回值

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

app_dspi_command_sync

表 266 app_dspi_command_sync接口
函数原型

uint16_t app_dspi_command_sync(app_dspi_command_t *p_cmd, uint32_t timeout)
功能说明

DSPI轮询方式（同步）发送命令
输入参数
  • p_cmd：命令、数据参数的结构体指针
  • timeout：超时时间（单位：ms），当接收数据时长超过该设定值，接口返回Timeout
返回值

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

app_dspi_command_async

表 267 app_dspi_command_async接口
函数原型

uint16_t app_dspi_command_async (app_dspi_command_t *p_cmd)
功能说明

DSPI中断方式（异步）发送命令
输入参数

p_cmd：命令、数据参数的结构体指针
返回值

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

app_dspi_transmit_sync

表 268 app_dspi_transmit_sync接口
函数原型

uint16_t app_dspi_transmit_sync(uint8_t *p_data, uint32_t length, uint32_t timeout)
功能说明

DSPI轮询方式（同步）发送数据
输入参数
  • p_data：需要发送的数据，以uint8_t类型数组给出
  • length：需要发送的数据长度，以Byte为单位
  • timeout：超时时间（单位：ms），当接收数据时长超过该设定值，接口返回Timeout
返回值

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

app_dspi_transmit_async

表 269 app_dspi_transmit_async接口
函数原型

uint16_t app_dspi_transmit_async(uint8_t *p_data, uint32_t length)
功能说明

DSPI中断方式（异步）发送数据
输入参数
  • p_data：需要发送的数据，以uint8_t类型数组给出
  • length：需要发送的数据长度，以Byte为单位
返回值

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

app_dspi_get_handle

表 270 app_dspi_get_handle接口
函数原型

dspi_handle_t *app_dspi_get_handle(void)
功能说明

获取当前DSPI句柄
返回值

dspi_handle_t：DSPI句柄结构体
备注

app_dspi_config_mode

表 271 app_dspi_config_mode接口
函数原型

uint16_t app_dspi_config_mode(uint32_t mode)
功能说明
DSPI传输方式配置，取值范围如下：
  • DSPI_PROT_MODE_3W1L
  • DSPI_PROT_MODE_4W1L
  • DSPI_PROT_MODE_4W2L
返回值

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

app_dspi_config_data_size

表 272 app_dspi_config_data_size接口
函数原型

uint16_t app_dspi_config_data_size(uint32_t data_size)
功能说明

DSPI配置传输数据的位宽
输入参数

data_size：需要传输的数据位宽，可取（DSPI_DATASIZE_04_BITS ～ DSPI_DATASIZE_32_BITS）参数中的一个
返回值

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

app_dspi_abort

表 273 app_dspi_abort接口
函数原型

uint16_t app_dspi_abort(void)
功能说明

DSPI中止传输（阻塞方式）
返回值

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

app_dspi_abort_it

表 274 app_dspi_abort_it接口
函数原型

uint16_t app_dspi_abort_it(void)
功能说明

DSPI中止传输（非阻塞方式，可根据回调函数获取终止完成的状态）
返回值

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

扫描关注

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