stm32g4xx_ll_spi.h

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_ll_spi.h
  * @author  MCD Application Team
  * @brief   SPI LL 模块的头文件。
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */

/* 定义以防止递归包含 -------------------------------------*/
#ifndef STM32G4xx_LL_SPI_H
#define STM32G4xx_LL_SPI_H

#ifdef __cplusplus
extern "C" {
#endif

/* 包含 ------------------------------------------------------------------*/
#include "stm32g4xx.h"

/** @addtogroup STM32G4xx_LL_Driver
  * @{
  */

#if defined (SPI1) || defined (SPI2) || defined (SPI3) || defined (SPI4)

/** @defgroup SPI_LL SPI
  * @{
  */

/* 私有类型 -------------------------------------------------------------*/
/* 私有变量 ---------------------------------------------------------*/
/* 私有宏 ------------------------------------------------------------*/

/* 导出的类型 ------------------------------------------------------------*/
#if defined(USE_FULL_LL_DRIVER)
/** @defgroup SPI_LL_ES_INIT SPI 导出的初始化结构体
  * @{
  */

/**
  * @brief  SPI 初始化结构体定义
  */
typedef struct
{
  uint32_t TransferDirection;       /*!< 指定 SPI 单向或双向数据模式。
                                         此参数可以是 @ref SPI_LL_EC_TRANSFER_MODE 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetTransferDirection() 进行修改。*/

  uint32_t Mode;                    /*!< 指定 SPI 模式（主/从）。
                                         此参数可以是 @ref SPI_LL_EC_MODE 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetMode() 进行修改。*/

  uint32_t DataWidth;               /*!< 指定 SPI 数据宽度。
                                         此参数可以是 @ref SPI_LL_EC_DATAWIDTH 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetDataWidth() 进行修改。*/

  uint32_t ClockPolarity;           /*!< 指定串行时钟稳态。
                                         此参数可以是 @ref SPI_LL_EC_POLARITY 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetClockPolarity() 进行修改。*/

  uint32_t ClockPhase;              /*!< 指定用于位捕获的时钟有效边沿。
                                         此参数可以是 @ref SPI_LL_EC_PHASE 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetClockPhase() 进行修改。*/

  uint32_t NSS;                     /*!< 指定 NSS 信号是由硬件（NSS 引脚）
                                         还是通过 SSI 位由软件管理。
                                         此参数可以是 @ref SPI_LL_EC_NSS_MODE 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetNSSMode() 进行修改。*/

  uint32_t BaudRate;                /*!< 指定用于配置发送和接收 SCK 时钟的波特率预分频器值。
                                         此参数可以是 @ref SPI_LL_EC_BAUDRATEPRESCALER 的值。
                                         @note 通信时钟来自主时钟。
                                               从机时钟无需设置。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetBaudRatePrescaler() 进行修改。*/


  uint32_t BitOrder;                /*!< 指定数据传输是从 MSB 还是 LSB 位开始。
                                         此参数可以是 @ref SPI_LL_EC_BIT_ORDER 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetTransferBitOrder() 进行修改。*/

  uint32_t CRCCalculation;          /*!< 指定是否启用 CRC 计算。
                                         此参数可以是 @ref SPI_LL_EC_CRC_CALCULATION 的值。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_EnableCRC() 和 @ref LL_SPI_DisableCRC() 进行修改。*/

  uint32_t CRCPoly;                 /*!< 指定用于 CRC 计算的多项式。
                                         此参数必须是 Min_Data = 0x00 和 Max_Data = 0xFFFF 之间的数字。

                                         此功能可以使用单元函数
                                         @ref LL_SPI_SetCRCPolynomial() 进行修改。*/

} LL_SPI_InitTypeDef;

/**
  * @}
  */
#endif /* USE_FULL_LL_DRIVER */

/* 导出的常量 --------------------------------------------------------*/
/** @defgroup SPI_LL_Exported_Constants SPI 导出的常量
  * @{
  */

/** @defgroup SPI_LL_EC_GET_FLAG 获取标志位定义
  * @brief    可与 LL_SPI_ReadReg 函数一起使用的标志位定义
  * @{
  */
#define LL_SPI_SR_RXNE                     SPI_SR_RXNE               /*!< 接收缓冲区非空标志         */
#define LL_SPI_SR_TXE                      SPI_SR_TXE                /*!< 发送缓冲区空标志             */
#define LL_SPI_SR_BSY                      SPI_SR_BSY                /*!< 忙标志                        */
#define LL_SPI_SR_CRCERR                   SPI_SR_CRCERR             /*!< CRC 错误标志                   */
#define LL_SPI_SR_MODF                     SPI_SR_MODF               /*!< 模式故障标志                  */
#define LL_SPI_SR_OVR                      SPI_SR_OVR                /*!< 溢出标志                     */
#define LL_SPI_SR_FRE                      SPI_SR_FRE                /*!< TI 模式帧格式错误标志  */
/**
  * @}
  */

/** @defgroup SPI_LL_EC_IT 中断定义
  * @brief    可与 LL_SPI_ReadReg 和 LL_SPI_WriteReg 函数一起使用的中断定义
  * @{
  */
#define LL_SPI_CR2_RXNEIE                  SPI_CR2_RXNEIE            /*!< 接收缓冲区非空中断使能 */
#define LL_SPI_CR2_TXEIE                   SPI_CR2_TXEIE             /*!< 发送缓冲区空中断使能     */
#define LL_SPI_CR2_ERRIE                   SPI_CR2_ERRIE             /*!< 错误中断使能               */
/**
  * @}
  */

/** @defgroup SPI_LL_EC_MODE 操作模式
  * @{
  */
#define LL_SPI_MODE_MASTER                 (SPI_CR1_MSTR | SPI_CR1_SSI)    /*!< 主机配置  */
#define LL_SPI_MODE_SLAVE                  0x