GD32F425片上外设标准库SPI函数和标志位整理

因为笔者用到了SPI，AI又经常乱写函数和标志位，整理了标准库函数和一些标志位。

SPI标准库函数

函数	参数	返回值	功能
spi_i2s_deinit	SPIx(x=0,1,2,3,4,5)	无	关闭SPIx的时钟反初始化
spi_struct_para_init	对应的数据指针(spi_parameter_struct)	无	使用默认值初始化SPI参数结构体
spi_init	1.SPIx(x=0,1,2,3,4,5) 2. spi_parameter_struct	无	初始化SPI
spi_enable	SPIx(x=0,1,2,3,4,5)	无	使能SPI
spi_disable	SPIx(x=0,1,2,3,4,5)	无	关闭SPI
i2s_init
i2s_psc_config
i2s_enable
i2s_disable
spi_nss_output_enable	SPIx(x=0,1,2,3,4,5)	无	nss输出使能
spi_nss_output_disable	SPIx(x=0,1,2,3,4,5)	无	关闭nss输出使能
spi_nss_internal_high	SPIx(x=0,1,2,3,4,5)	无	内部虚拟的NSS置位高
spi_nss_internal_low	SPIx(x=0,1,2,3,4,5)	无	内部虚拟的NSS置位低
spi_dma_enable	1.SPIx(x=0,1,2,3,4,5) 2.DMA_mode	无	使能SPI_DMA发送或接受
spi_dma_disable	1.SPIx(x=0,1,2,3,4,5) 2.DMA_mode	无	关闭SPI_DMA发送或接受
spi_i2s_data_frame_format_config	1.SPIx(x=0,1,2,3,4,5) 2.数据位宽（8/16位）	无	设置单次传输的数据位宽
spi_i2s_data_transmit	1.SPIx(x=0,1,2,3,4,5) 2.16位数据	无	发送十六位的数据
spi_i2s_data_receive	SPIx(x=0,1,2,3,4,5)	十六位的返回值	接收十六位的数据
spi_bidirectional_transfer_config	1.SPIx(x=0,1,2,3,4,5) 2.模式	无	配置 SPI 工作在「双向单线模式」下的单向传输方向
i2s_full_duplex_mode_config
spi_i2s_format_error_clear	1.SPIx(x=0,1,2,3,4,5) 2.错误标志位	无	清除 SPI 或 I2S 模式下的「帧格式错误标志位」
spi_crc_polynomial_set	1.SPIx(x=0,1,2,3,4,5) 2.CRC多项式值	无	为 SPI 外设的「硬件 CRC 校验功能」设置CRC 多项式
spi_crc_polynomial_get	SPIx(x=0,1,2,3,4,5)	16位CRC的值	获取CRC多项式的值
spi_crc_on	SPIx(x=0,1,2,3,4,5)	无	启动CRC
spi_crc_off	SPIx(x=0,1,2,3,4,5)	无	关闭CRC
spi_crc_next	SPIx(x=0,1,2,3,4,5)	无	下次传输是CRC校验值
spi_crc_get	1.SPIx(x=0,1,2,3,4,5) 2.选择读取类型	16位CRC的值	读取 SPI 外设硬件 CRC
spi_crc_error_clear	SPIx(x=0,1,2,3,4,5)	无	CRC错误标志位状态清空
spi_ti_mode_enable	SPIx(x=0,1,2,3,4,5)	无	启用 SPI 的 TI 模式
pi_ti_mode_disable	SPIx(x=0,1,2,3,4,5)	无	关闭 SPI 的 TI 模式
spi_quad_enable	SPIx(x=0,1,2,3,4,5)	无	启用四线 SPI 模式
spi_quad_disable	SPIx(x=0,1,2,3,4,5)	无	禁用四线 SPI 模式
spi_quad_write_enable	SPIx(x=0,1,2,3,4,5)	无	启用四线 SPI 写模式
spi_quad_read_enable	SPIx(x=0,1,2,3,4,5)	无	启用四线 SPI 读模式
spi_quad_io23_output_enable	SPIx(x=0,1,2,3,4,5)	无	启用Quad SPI 模式下 IO2 和 IO3 引脚的输出驱动功能
spi_quad_io23_output_disable	SPIx(x=0,1,2,3,4,5)	无	禁用Quad SPI 模式下 IO2 和 IO3 引脚的输出驱动功能
spi_i2s_flag_get	1.SPIx(x=0,1,2,3,4,5) 2.标志位	FlagStatus	获取标志位状态
spi_i2s_interrupt_enable	1.SPIx(x=0,1,2,3,4,5) 2.中断	无	使能中断
spi_i2s_interrupt_disable	1.SPIx(x=0,1,2,3,4,5) 2.中断	无	关闭中断
spi_i2s_interrupt_flag_get	1.SPIx(x=0,1,2,3,4,5) 2.中断	FlagStatus	获取中断标志位状态

中断标志位整理

中断标志位
SPI_I2S_INT_FLAG_TBE	发送缓冲区空中断标志
SPI_I2S_INT_FLAG_RBNE	接收缓冲区非空中断标志
SPI_I2S_INT_FLAG_RXORERR	溢出错中断标志
SPI_INT_FLAG_CONFERR	配置错误中断标志
SPI_INT_FLAG_CRCERR	CRC 错误中断标志
I2S_INT_FLAG_TXURERR	欠载错中断标志
SPI_I2S_INT_FLAG_FERR	SPI/I2S 帧格式错误中断标志

标志位整理

标志位
SPI_FLAG_TBE	SPI 发送缓冲区空标志
SPI_FLAG_RBNE	SPI 接收缓冲区非空标志
SPI_FLAG_TRANS	SPI 传输进行中标志
SPI_FLAG_RXORERR	SPI 接收溢出错误标志
SPI_FLAG_CONFERR	SPI 模式配置错误标志
SPI_FLAG_CRCERR	SPI CRC 错误标志
SPI_FLAG_FERR	SPI 帧格式错误标志
I2S_FLAG_TBE	I2S 发送缓冲区空标志
I2S_FLAG_RBNE	I2S 接收缓冲区非空标志
I2S_FLAG_TRANS	I2S 传输进行中标志
I2S_FLAG_RXORERR	I2S 接收溢出错误标志
I2S_FLAG_TXURERR	I2S 发送欠载错误标志
I2S_FLAG_CH	I2S 声道状态标志
I2S_FLAG_FERR	I2S 帧格式错误标志