CN / EN

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

结构体

app_dspi_pin_t

结构体定义如下：

表 251 app_dspi_pin_t结构体成员
成员 描述 取值

ap_io_type_t type

设置IO类型

同app_io_evt_t中描述

app_io_mux_t mux

设置IO映射功能

参考app_io_init_t结构体，具体映射模式根据芯片Datasheet中的Pin Mux进行选择

uint32_t pin

设置IO引脚

参考app_io_init_t结构体，具体根据芯片Datasheet中DSPI资源进行选择

app_io_pull_t pull

设置IO上拉/下拉/浮空
该参数的取值可以是下列值中的任意一个：
  • APP_IO_NOPULL（浮空）
  • APP_IO_PULLUP（上拉）
  • APP_IO_PULLDOWN（下拉）

uin8_t enable

开启或关闭PIN
该参数的取值可以是下列值中的任意一个：
  • APP_DSPI_PIN_ENABLE（开启PIN）
  • APP_DSPI_PIN_DISABLE（关闭PIN）

详细信息请参考文件：SDK_Folder\drivers\inc\app_dspi.h。

app_dspi_pin_cfg_t

结构体定义如下：

表 252 app_dspi_pin_cfg_t结构体成员
成员 描述 取值

app_dspi_pin_t cs

DSPI CS引脚配置

参考app_dspi_pin_t结构体

app_dspi_pin_t clk

DSPI CLOCK引脚配置

参考app_dspi_pin_t结构体

app_dspi_pin_t mosi

DSPI MOSI引脚配置

参考app_dspi_pin_t结构体

app_dspi_pin_t miso

DSPI MISO引脚配置

参考app_dspi_pin_t结构体

app_dspi_pin_t dcx

DSPI DCX引脚配置

参考app_dspi_pin_t结构体

详细信息请参考文件：SDK_Folder\drivers\inc\app_dspi.h。

dspi_init_t

结构体定义如下：

表 253 dspi_init_t结构体成员
成员 描述 取值

uint32_t data_size

DSPI数据宽度

该参数的取值可以是下列值中的任意一个：
  • DSPI_DATASIZE_04_BITS（4 bits）
  • DSPI_DATASIZE_05_BITS（5 bits）
  • DSPI_DATASIZE_06_BITS（6 bits）
  • DSPI_DATASIZE_07_BITS（7 bits）
  • DSPI_DATASIZE_08_BITS（8 bits）
  • DSPI_DATASIZE_09_BITS（9 bits）
  • DSPI_DATASIZE_10_BITS（10 bits）
  • DSPI_DATASIZE_11_BITS（11 bits）
  • DSPI_DATASIZE_12_BITS（12 bits）
  • DSPI_DATASIZE_13_BITS（13 bits）
  • DSPI_DATASIZE_14_BITS（14 bits）
  • DSPI_DATASIZE_15_BITS（15 bits）
  • DSPI_DATASIZE_16_BITS（16 bits）
  • DSPI_DATASIZE_17_BITS（17 bits）
  • DSPI_DATASIZE_18_BITS（18 bits）
  • DSPI_DATASIZE_19_BITS（19 bits）
  • DSPI_DATASIZE_20_BITS（20 bits）
  • DSPI_DATASIZE_21_BITS（21 bits）
  • DSPI_DATASIZE_22_BITS（22 bits）
  • DSPI_DATASIZE_23_BITS（23 bits）
  • DSPI_DATASIZE_24_BITS（24 bits）
  • DSPI_DATASIZE_25_BITS（25 bits）
  • DSPI_DATASIZE_26_BITS（26 bits）
  • DSPI_DATASIZE_27_BITS（27 bits）
  • DSPI_DATASIZE_28_BITS（28 bits）
  • DSPI_DATASIZE_29_BITS（29 bits）
  • DSPI_DATASIZE_30_BITS（30 bits）
  • DSPI_DATASIZE_31_BITS（31 bits）
  • DSPI_DATASIZE_32_BITS（32 bits）

uint32_t baud_rate

DSPI波特率预分频器值，该值将用于配置发送和接收SCK时钟

该参数的取值可以是下列值中的任意一个：

  • DSPI_BAUD_RATE_2P1PCLK（外设串行时钟频率/2）
  • DSPI_BAUD_RATE_4P1PCLK（外设串行时钟频率/4）
  • DSPI_BAUD_RATE_8P1PCLK（外设串行时钟频率/8）
  • DSPI_BAUD_RATE_16P1PCLK（外设串行时钟频率/16）
  • DSPI_BAUD_RATE_32P1PCLK（外设串行时钟频率/32）
  • DSPI_BAUD_RATE_64P1PCLK（外设串行时钟频率/64）
  • DSPI_BAUD_RATE_128P1PCLK（外设串行时钟频率/128）
  • DSPI_BAUD_RATE_256P1PCLK（外设串行时钟频率/256）

说明：

GR5526外设串行时钟频率为96 MHz

uint32_t dspi_mode

DSPI接口模式
该参数的取值可以是下列值中的任意一个：
  • DSPI_PROT_MODE_3W1L（3线1 lane）
  • DSPI_PROT_MODE_4W1L（4线1 lane）
  • DSPI_PROT_MODE_4W2L（4线2 lane）

详细信息请参考文件：SDK_Folder\drivers\inc\hal\gr55xx_hal_dspi.h。

app_dspi_dma_cfg_t

结构体定义如下：

表 254 app_dspi_dma_cfg_t结构体成员
成员 描述 取值
dma_channel_t channel DSPI DMA传输通道 同app_dma_params_t中通道描述

详细信息请参考文件：SDK_Folder\drivers\inc\app_dspi.h。

app_dspi_params_t

结构体定义如下：

表 255 app_dspi_params_t结构体成员
成员 描述 取值

app_dspi_pin_cfg_t pin_cfg

DSPI引脚功能设置

参考app_dspi_pin_cfg_t结构体

app_dspi_dma_cfg_t dma_cfg

DSPI传输方式选择

参考app_dspi_dma_cfg_t结构体

dspi_init_t init

DSPI初始化参数配置

参考dspi_init_t结构体

bool is_soft_cs

是否通过软件控制CS片选引脚
  • true：软件控制片选引脚
  • false：不通过软件控制片选引脚

dspi_env_t dspi_env

仅用于记录初始化设备的句柄、相关参数和信号量等，不需要配置

详细信息请参考文件：SDK_Folder\drivers\inc\app_dspi.h。

app_dspi_evt_t

结构体定义如下：

表 256 app_dspi_evt_t结构体成员
成员 描述 取值

app_dspi_evt_type_t type

串口事件类型
该参数的取值可以是下列值中的任意一个：
  • APP_DSPI_EVT_ERROR（DSPI 发送错误）
  • APP_DSPI_EVT_TX_CPLT（DSPI发送完成）
  • APP_DSPI_EVT_ABORT（DSPI中止传输）

union

{

uint32_t error_code;

uint16_t size;

}data;
  • uint32_t error_code：发送事件返回的错误ID
  • uint16_t size：DSPI已发送的数据长度

说明：

若事件类型为传输错误，此处返回错误ID； 若事件类型为发送完成，此处显示已传输的数据大小
DSPI错误ID及对应含义如下：
  • HAL_DSPI_ERROR_NONE（无错误）
  • HAL_DSPI_ERROR_TIMEOUT（超时）
  • HAL_DSPI_ERROR_TRANSFER（传输错误）
  • HAL_DSPI_ERROR_DMA（DMA传输错误）
  • HAL_DSPI_ERROR_INVALID_PARAM（无效参数）

详细信息请参考文件：SDK_Folder\drivers\inc\app_dspi.h。

app_dspi_command_t

结构体定义如下：

表 257 app_dspi_command_t结构体成员
成员 描述 取值

uint32_t instruction

DSPI指令

需要发送的命令数据

uint32_t instruction_size

DSPI指令位宽
需要发送的命令数据位宽，一般取值为：
  • DSPI_INSTSIZE_08_BITS（8 bits）
  • DSPI_INSTSIZE_16_BITS（16 bits）
  • DSPI_INSTSIZE_32_BITS（32 bits）

uint32_t data_size

DSPI数据位宽
需要发送的数据位宽，一般取值为：
  • DSPI_INSTSIZE_08_BITS（8 bits）
  • DSPI_INSTSIZE_16_BITS（16 bits）
  • DSPI_INSTSIZE_32_BITS（32 bits）

uint32_t length

DSPI发送的数据长度，单位：字节

0x0 ～ 0xFFFFFFFF

详细信息请参考文件：SDK_Folder\drivers\inc\hal\gr55xx_hal_dspi.h。

扫描关注

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