stm32h7xx_hal_spi.h 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972
  1. /**
  2. ******************************************************************************
  3. * @file stm32h7xx_hal_spi.h
  4. * @author MCD Application Team
  5. * @version V1.0.0
  6. * @date 21-April-2017
  7. * @brief Header file of SPI HAL module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32H7xx_HAL_SPI_H
  39. #define __STM32H7xx_HAL_SPI_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #include "stm32h7xx_hal_def.h"
  45. /** @addtogroup STM32H7xx_HAL_Driver
  46. * @{
  47. */
  48. /** @addtogroup SPI
  49. * @{
  50. */
  51. /* Exported types ------------------------------------------------------------*/
  52. /** @defgroup SPI_Exported_Types SPI Exported Types
  53. * @{
  54. */
  55. /**
  56. * @brief SPI Configuration Structure definition
  57. */
  58. typedef struct
  59. {
  60. uint32_t Mode; /*!< Specifies the SPI operating mode.
  61. This parameter can be a value of @ref SPI_Mode */
  62. uint32_t Direction; /*!< Specifies the SPI bidirectional mode state.
  63. This parameter can be a value of @ref SPI_Direction */
  64. uint32_t DataSize; /*!< Specifies the SPI data size.
  65. This parameter can be a value of @ref SPI_Data_Size */
  66. uint32_t CLKPolarity; /*!< Specifies the serial clock steady state.
  67. This parameter can be a value of @ref SPI_Clock_Polarity */
  68. uint32_t CLKPhase; /*!< Specifies the clock active edge for the bit capture.
  69. This parameter can be a value of @ref SPI_Clock_Phase */
  70. uint32_t NSS; /*!< Specifies whether the NSS signal is managed by
  71. hardware (NSS pin) or by software using the SSI bit.
  72. This parameter can be a value of @ref SPI_Slave_Select_Management */
  73. uint32_t BaudRatePrescaler; /*!< Specifies the Baud Rate prescaler value which will be
  74. used to configure the transmit and receive SCK clock.
  75. This parameter can be a value of @ref SPI_BaudRate_Prescaler
  76. @note The communication clock is derived from the master
  77. clock. The slave clock does not need to be set. */
  78. uint32_t FirstBit; /*!< Specifies whether data transfers start from MSB or LSB bit.
  79. This parameter can be a value of @ref SPI_MSB_LSB_Transmission */
  80. uint32_t TIMode; /*!< Specifies if the TI mode is enabled or not.
  81. This parameter can be a value of @ref SPI_TI_Mode */
  82. uint32_t CRCCalculation; /*!< Specifies if the CRC calculation is enabled or not.
  83. This parameter can be a value of @ref SPI_CRC_Calculation */
  84. uint32_t CRCPolynomial; /*!< Specifies the polynomial used for the CRC calculation.
  85. This parameter must be an odd number between Min_Data = 0 and Max_Data = 65535 */
  86. uint32_t CRCLength; /*!< Specifies the CRC Length used for the CRC calculation.
  87. CRC Length is only used with Data8 and Data16, not other data size
  88. This parameter can be a value of @ref SPI_CRC_length */
  89. uint32_t NSSPMode; /*!< Specifies whether the NSSP signal is enabled or not .
  90. This parameter can be a value of @ref SPI_NSSP_Mode
  91. This mode is activated by the NSSP bit in the SPIx_CR2 register and
  92. it takes effect only if the SPI interface is configured as Motorola SPI
  93. master (FRF=0) with capture on the first edge (SPIx_CR1 CPHA = 0,
  94. CPOL setting is ignored). */
  95. uint32_t NSSPolarity; /*!< Specifies which level of SS input/output external signal (present on SS pin) is
  96. considered as active one.
  97. This parameter can be a value of @ref SPI_NSS_Polarity */
  98. uint32_t FifoThreshold; /*!< Specifies the FIFO threshold level.
  99. This parameter can be a value of @ref SPI_Fifo_Threshold */
  100. uint32_t TxCRCInitializationPattern; /*!< Specifies the transmitter CRC initialization Pattern used for the CRC calculation.
  101. This parameter can be a value of @ref SPI_CRC_Calculation_Initialization_Pattern */
  102. uint32_t RxCRCInitializationPattern; /*!< Specifies the receiver CRC initialization Pattern used for the CRC calculation.
  103. This parameter can be a value of @ref SPI_CRC_Calculation_Initialization_Pattern */
  104. uint32_t MasterSSIdleness; /*!< Specifies an extra delay, expressed in number of SPI clock cycle periods, inserted
  105. additionally between active edge of SS and first data transaction start in master mode.
  106. This parameter can be a value of @ref SPI_Master_SS_Idleness */
  107. uint32_t MasterInterDataIdleness; /*!< Specifies minimum time delay (expressed in SPI clock cycles periods) inserted between
  108. two consecutive data frames in master mode
  109. This parameter can be a value of @ref SPI_Master_InterData_Idleness */
  110. uint32_t MasterReceiverAutoSusp; /*!< Control continuous SPI transfer in master receiver mode and automatic management
  111. in order to avoid overrun condition.
  112. This parameter can be a value of @ref SPI_Master_RX_AutoSuspend*/
  113. uint32_t MasterKeepIOState; /*!< Control of Alternate function GPIOs state
  114. This parameter can be a value of @ref SPI_Master_Keep_IO_State */
  115. uint32_t IOSwap; /*!< Invert MISO/MOSI alternate functions
  116. This parameter can be a value of @ref SPI_IO_Swap */
  117. } SPI_InitTypeDef;
  118. /**
  119. * @brief HAL SPI State structure definition
  120. */
  121. typedef enum
  122. {
  123. HAL_SPI_STATE_RESET = 0x00U, /*!< Peripheral not Initialized */
  124. HAL_SPI_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  125. HAL_SPI_STATE_BUSY = 0x02U, /*!< an internal process is ongoing */
  126. HAL_SPI_STATE_BUSY_TX = 0x03U, /*!< Data Transmission process is ongoing */
  127. HAL_SPI_STATE_BUSY_RX = 0x04U, /*!< Data Reception process is ongoing */
  128. HAL_SPI_STATE_BUSY_TX_RX = 0x05U, /*!< Data Transmission and Reception process is ongoing */
  129. HAL_SPI_STATE_ERROR = 0x06U, /*!< SPI error state */
  130. HAL_SPI_STATE_ABORT = 0x07U /*!< SPI abort is ongoing */
  131. } HAL_SPI_StateTypeDef;
  132. /**
  133. * @brief SPI handle Structure definition
  134. */
  135. typedef struct __SPI_HandleTypeDef
  136. {
  137. SPI_TypeDef *Instance; /*!< SPI registers base address */
  138. SPI_InitTypeDef Init; /*!< SPI communication parameters */
  139. uint8_t *pTxBuffPtr; /*!< Pointer to SPI Tx transfer Buffer */
  140. uint16_t TxXferSize; /*!< SPI Tx Transfer size */
  141. __IO uint16_t TxXferCount; /*!< SPI Tx Transfer Counter */
  142. uint8_t *pRxBuffPtr; /*!< Pointer to SPI Rx transfer Buffer */
  143. uint16_t RxXferSize; /*!< SPI Rx Transfer size */
  144. __IO uint16_t RxXferCount; /*!< SPI Rx Transfer Counter */
  145. uint32_t CRCSize; /*!< SPI CRC size used for the transfer */
  146. void (*RxISR)(struct __SPI_HandleTypeDef *hspi); /*!< function pointer on Rx ISR */
  147. void (*TxISR)(struct __SPI_HandleTypeDef *hspi); /*!< function pointer on Tx ISR */
  148. DMA_HandleTypeDef *hdmatx; /*!< SPI Tx DMA Handle parameters */
  149. DMA_HandleTypeDef *hdmarx; /*!< SPI Rx DMA Handle parameters */
  150. HAL_LockTypeDef Lock; /*!< Locking object */
  151. __IO HAL_SPI_StateTypeDef State; /*!< SPI communication state */
  152. __IO uint32_t ErrorCode; /*!< SPI Error code */
  153. } SPI_HandleTypeDef;
  154. /**
  155. * @}
  156. */
  157. /* Exported constants --------------------------------------------------------*/
  158. /** @defgroup SPI_Exported_Constants SPI Exported Constants
  159. * @{
  160. */
  161. /** @defgroup SPI_FIFO_Type SPI FIFO Type
  162. * @{
  163. */
  164. #define SPI_LOWEND_FIFO_SIZE 8U
  165. #define SPI_HIGHEND_FIFO_SIZE 16U
  166. /**
  167. * @}
  168. */
  169. /** @defgroup SPI_Error_Code SPI Error Codes
  170. * @{
  171. */
  172. #define HAL_SPI_ERROR_NONE (0x00000000U) /*!< No error */
  173. #define HAL_SPI_ERROR_MODF (0x00000001U) /*!< MODF error */
  174. #define HAL_SPI_ERROR_CRC (0x00000002U) /*!< CRC error */
  175. #define HAL_SPI_ERROR_OVR (0x00000004U) /*!< OVR error */
  176. #define HAL_SPI_ERROR_FRE (0x00000008U) /*!< FRE error */
  177. #define HAL_SPI_ERROR_DMA (0x00000010U) /*!< DMA transfer error */
  178. #define HAL_SPI_ERROR_FLAG (0x00000020U) /*!< Error on RXNE/TXE/BSY/FTLVL/FRLVL Flag */
  179. #define HAL_SPI_ERROR_ABORT (0x00000040U) /*!< Error during SPI Abort procedure */
  180. #define HAL_SPI_ERROR_UDR (0x00000080U) /*!< Underrun error */
  181. #define HAL_SPI_ERROR_TIMEOUT (0x00000100U) /*!< Timeout error */
  182. #define HAL_SPI_ERROR_UNKNOW (0x00000200U) /*!< Unknow error */
  183. /**
  184. * @}
  185. */
  186. /** @defgroup SPI_Mode SPI Mode
  187. * @{
  188. */
  189. #define SPI_MODE_SLAVE (0x00000000U)
  190. #define SPI_MODE_MASTER SPI_CFG2_MASTER
  191. /**
  192. * @}
  193. */
  194. /** @defgroup SPI_Direction SPI Direction Mode
  195. * @{
  196. */
  197. #define SPI_DIRECTION_2LINES (0x00000000U)
  198. #define SPI_DIRECTION_2LINES_TXONLY SPI_CFG2_COMM_0
  199. #define SPI_DIRECTION_2LINES_RXONLY SPI_CFG2_COMM_1
  200. #define SPI_DIRECTION_1LINE SPI_CFG2_COMM
  201. /**
  202. * @}
  203. */
  204. /** @defgroup SPI_Data_Size SPI Data Size
  205. * @{
  206. */
  207. #define SPI_DATASIZE_4BIT (0x00000003U)
  208. #define SPI_DATASIZE_5BIT (0x00000004U)
  209. #define SPI_DATASIZE_6BIT (0x00000005U)
  210. #define SPI_DATASIZE_7BIT (0x00000006U)
  211. #define SPI_DATASIZE_8BIT (0x00000007U)
  212. #define SPI_DATASIZE_9BIT (0x00000008U)
  213. #define SPI_DATASIZE_10BIT (0x00000009U)
  214. #define SPI_DATASIZE_11BIT (0x0000000AU)
  215. #define SPI_DATASIZE_12BIT (0x0000000BU)
  216. #define SPI_DATASIZE_13BIT (0x0000000CU)
  217. #define SPI_DATASIZE_14BIT (0x0000000DU)
  218. #define SPI_DATASIZE_15BIT (0x0000000EU)
  219. #define SPI_DATASIZE_16BIT (0x0000000FU)
  220. #define SPI_DATASIZE_17BIT (0x00000010U)
  221. #define SPI_DATASIZE_18BIT (0x00000011U)
  222. #define SPI_DATASIZE_19BIT (0x00000012U)
  223. #define SPI_DATASIZE_20BIT (0x00000013U)
  224. #define SPI_DATASIZE_21BIT (0x00000014U)
  225. #define SPI_DATASIZE_22BIT (0x00000015U)
  226. #define SPI_DATASIZE_23BIT (0x00000016U)
  227. #define SPI_DATASIZE_24BIT (0x00000017U)
  228. #define SPI_DATASIZE_25BIT (0x00000018U)
  229. #define SPI_DATASIZE_26BIT (0x00000019U)
  230. #define SPI_DATASIZE_27BIT (0x0000001AU)
  231. #define SPI_DATASIZE_28BIT (0x0000001BU)
  232. #define SPI_DATASIZE_29BIT (0x0000001CU)
  233. #define SPI_DATASIZE_30BIT (0x0000001DU)
  234. #define SPI_DATASIZE_31BIT (0x0000001EU)
  235. #define SPI_DATASIZE_32BIT (0x0000001FU)
  236. /**
  237. * @}
  238. */
  239. /** @defgroup SPI_Clock_Polarity SPI Clock Polarity
  240. * @{
  241. */
  242. #define SPI_POLARITY_LOW (0x00000000U)
  243. #define SPI_POLARITY_HIGH SPI_CFG2_CPOL
  244. /**
  245. * @}
  246. */
  247. /** @defgroup SPI_Clock_Phase SPI Clock Phase
  248. * @{
  249. */
  250. #define SPI_PHASE_1EDGE (0x00000000U)
  251. #define SPI_PHASE_2EDGE SPI_CFG2_CPHA
  252. /**
  253. * @}
  254. */
  255. /** @defgroup SPI_Slave_Select_Management SPI Slave Select Management
  256. * @{
  257. */
  258. #define SPI_NSS_SOFT SPI_CFG2_SSM
  259. #define SPI_NSS_HARD_INPUT (0x00000000U)
  260. #define SPI_NSS_HARD_OUTPUT SPI_CFG2_SSOE
  261. /**
  262. * @}
  263. */
  264. /** @defgroup SPI_NSSP_Mode SPI NSS Pulse Mode
  265. * @{
  266. */
  267. #define SPI_NSS_PULSE_DISABLE (0x00000000U)
  268. #define SPI_NSS_PULSE_ENABLE SPI_CFG2_SSOM
  269. /**
  270. * @}
  271. */
  272. /** @defgroup SPI_BaudRate_Prescaler SPI BaudRate Prescaler
  273. * @{
  274. */
  275. #define SPI_BAUDRATEPRESCALER_2 (0x00000000U)
  276. #define SPI_BAUDRATEPRESCALER_4 (0x10000000U)
  277. #define SPI_BAUDRATEPRESCALER_8 (0x20000000U)
  278. #define SPI_BAUDRATEPRESCALER_16 (0x30000000U)
  279. #define SPI_BAUDRATEPRESCALER_32 (0x40000000U)
  280. #define SPI_BAUDRATEPRESCALER_64 (0x50000000U)
  281. #define SPI_BAUDRATEPRESCALER_128 (0x60000000U)
  282. #define SPI_BAUDRATEPRESCALER_256 (0x70000000U)
  283. /**
  284. * @}
  285. */
  286. /** @defgroup SPI_MSB_LSB_Transmission SPI MSB LSB Transmission
  287. * @{
  288. */
  289. #define SPI_FIRSTBIT_MSB (0x00000000U)
  290. #define SPI_FIRSTBIT_LSB SPI_CFG2_LSBFRST
  291. /**
  292. * @}
  293. */
  294. /** @defgroup SPI_TI_Mode SPI TI Mode
  295. * @{
  296. */
  297. #define SPI_TIMODE_DISABLE (0x00000000U)
  298. #define SPI_TIMODE_ENABLE SPI_CFG2_SP_0
  299. /**
  300. * @}
  301. */
  302. /** @defgroup SPI_CRC_Calculation SPI CRC Calculation
  303. * @{
  304. */
  305. #define SPI_CRCCALCULATION_DISABLE (0x00000000U)
  306. #define SPI_CRCCALCULATION_ENABLE SPI_CFG1_CRCEN
  307. /**
  308. * @}
  309. */
  310. /** @defgroup SPI_CRC_length SPI CRC Length
  311. * @{
  312. */
  313. #define SPI_CRC_LENGTH_DATASIZE (0x00000000U)
  314. #define SPI_CRC_LENGTH_4BIT (0x00030000U)
  315. #define SPI_CRC_LENGTH_5BIT (0x00040000U)
  316. #define SPI_CRC_LENGTH_6BIT (0x00050000U)
  317. #define SPI_CRC_LENGTH_7BIT (0x00060000U)
  318. #define SPI_CRC_LENGTH_8BIT (0x00070000U)
  319. #define SPI_CRC_LENGTH_9BIT (0x00080000U)
  320. #define SPI_CRC_LENGTH_10BIT (0x00090000U)
  321. #define SPI_CRC_LENGTH_11BIT (0x000A0000U)
  322. #define SPI_CRC_LENGTH_12BIT (0x000B0000U)
  323. #define SPI_CRC_LENGTH_13BIT (0x000C0000U)
  324. #define SPI_CRC_LENGTH_14BIT (0x000D0000U)
  325. #define SPI_CRC_LENGTH_15BIT (0x000E0000U)
  326. #define SPI_CRC_LENGTH_16BIT (0x000F0000U)
  327. #define SPI_CRC_LENGTH_17BIT (0x00100000U)
  328. #define SPI_CRC_LENGTH_18BIT (0x00110000U)
  329. #define SPI_CRC_LENGTH_19BIT (0x00120000U)
  330. #define SPI_CRC_LENGTH_20BIT (0x00130000U)
  331. #define SPI_CRC_LENGTH_21BIT (0x00140000U)
  332. #define SPI_CRC_LENGTH_22BIT (0x00150000U)
  333. #define SPI_CRC_LENGTH_23BIT (0x00160000U)
  334. #define SPI_CRC_LENGTH_24BIT (0x00170000U)
  335. #define SPI_CRC_LENGTH_25BIT (0x00180000U)
  336. #define SPI_CRC_LENGTH_26BIT (0x00190000U)
  337. #define SPI_CRC_LENGTH_27BIT (0x001A0000U)
  338. #define SPI_CRC_LENGTH_28BIT (0x001B0000U)
  339. #define SPI_CRC_LENGTH_29BIT (0x001C0000U)
  340. #define SPI_CRC_LENGTH_30BIT (0x001D0000U)
  341. #define SPI_CRC_LENGTH_31BIT (0x001E0000U)
  342. #define SPI_CRC_LENGTH_32BIT (0x001F0000U)
  343. /**
  344. * @}
  345. */
  346. /** @defgroup SPI_Fifo_Threshold SPI Fifo Threshold
  347. * @{
  348. */
  349. #define SPI_FIFO_THRESHOLD_01DATA (0x00000000U)
  350. #define SPI_FIFO_THRESHOLD_02DATA (0x00000020U)
  351. #define SPI_FIFO_THRESHOLD_03DATA (0x00000040U)
  352. #define SPI_FIFO_THRESHOLD_04DATA (0x00000060U)
  353. #define SPI_FIFO_THRESHOLD_05DATA (0x00000080U)
  354. #define SPI_FIFO_THRESHOLD_06DATA (0x000000A0U)
  355. #define SPI_FIFO_THRESHOLD_07DATA (0x000000C0U)
  356. #define SPI_FIFO_THRESHOLD_08DATA (0x000000E0U)
  357. #define SPI_FIFO_THRESHOLD_09DATA (0x00000100U)
  358. #define SPI_FIFO_THRESHOLD_10DATA (0x00000120U)
  359. #define SPI_FIFO_THRESHOLD_11DATA (0x00000140U)
  360. #define SPI_FIFO_THRESHOLD_12DATA (0x00000160U)
  361. #define SPI_FIFO_THRESHOLD_13DATA (0x00000180U)
  362. #define SPI_FIFO_THRESHOLD_14DATA (0x000001A0U)
  363. #define SPI_FIFO_THRESHOLD_15DATA (0x000001C0U)
  364. #define SPI_FIFO_THRESHOLD_16DATA (0x000001E0U)
  365. /**
  366. * @}
  367. */
  368. /** @defgroup SPI_CRC_Calculation_Initialization_Pattern SPI CRC Calculation Initialization Pattern
  369. * @{
  370. */
  371. #define SPI_CRC_INITIALIZATION_ALL_ZERO_PATTERN (0x00000000U)
  372. #define SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN (0x00000001U)
  373. /**
  374. * @}
  375. */
  376. /** @defgroup SPI_NSS_Polarity SPI NSS Polarity
  377. * @{
  378. */
  379. #define SPI_NSS_POLARITY_LOW (0x00000000U)
  380. #define SPI_NSS_POLARITY_HIGH SPI_CFG2_SSIOP
  381. /**
  382. * @}
  383. */
  384. /** @defgroup SPI_Master_Keep_IO_State Keep IO State
  385. * @{
  386. */
  387. #define SPI_MASTER_KEEP_IO_STATE_DISABLE (0x00000000U)
  388. #define SPI_MASTER_KEEP_IO_STATE_ENABLE SPI_CFG2_AFCNTR
  389. /**
  390. * @}
  391. */
  392. /** @defgroup SPI_IO_Swap Control SPI IO Swap
  393. * @{
  394. */
  395. #define SPI_IO_SWAP_DISABLE (0x00000000U)
  396. #define SPI_IO_SWAP_ENABLE SPI_CFG2_IOSWP
  397. /**
  398. * @}
  399. */
  400. /** @defgroup SPI_Master_SS_Idleness SPI Master SS Ideleness
  401. * @{
  402. */
  403. #define SPI_MASTER_SS_IDLENESS_00CYCLE (0x00000000U)
  404. #define SPI_MASTER_SS_IDLENESS_01CYCLE (0x00000001U)
  405. #define SPI_MASTER_SS_IDLENESS_02CYCLE (0x00000002U)
  406. #define SPI_MASTER_SS_IDLENESS_03CYCLE (0x00000003U)
  407. #define SPI_MASTER_SS_IDLENESS_04CYCLE (0x00000004U)
  408. #define SPI_MASTER_SS_IDLENESS_05CYCLE (0x00000005U)
  409. #define SPI_MASTER_SS_IDLENESS_06CYCLE (0x00000006U)
  410. #define SPI_MASTER_SS_IDLENESS_07CYCLE (0x00000007U)
  411. #define SPI_MASTER_SS_IDLENESS_08CYCLE (0x00000008U)
  412. #define SPI_MASTER_SS_IDLENESS_09CYCLE (0x00000009U)
  413. #define SPI_MASTER_SS_IDLENESS_10CYCLE (0x0000000AU)
  414. #define SPI_MASTER_SS_IDLENESS_11CYCLE (0x0000000BU)
  415. #define SPI_MASTER_SS_IDLENESS_12CYCLE (0x0000000CU)
  416. #define SPI_MASTER_SS_IDLENESS_13CYCLE (0x0000000DU)
  417. #define SPI_MASTER_SS_IDLENESS_14CYCLE (0x0000000EU)
  418. #define SPI_MASTER_SS_IDLENESS_15CYCLE (0x0000000FU)
  419. /**
  420. * @}
  421. */
  422. /** @defgroup SPI_Master_InterData_Idleness SPI Master Inter-Data Ideleness
  423. * @{
  424. */
  425. #define SPI_MASTER_INTERDATA_IDLENESS_00CYCLE (0x00000000U)
  426. #define SPI_MASTER_INTERDATA_IDLENESS_01CYCLE (0x00000001U)
  427. #define SPI_MASTER_INTERDATA_IDLENESS_02CYCLE (0x00000002U)
  428. #define SPI_MASTER_INTERDATA_IDLENESS_03CYCLE (0x00000003U)
  429. #define SPI_MASTER_INTERDATA_IDLENESS_04CYCLE (0x00000004U)
  430. #define SPI_MASTER_INTERDATA_IDLENESS_05CYCLE (0x00000005U)
  431. #define SPI_MASTER_INTERDATA_IDLENESS_06CYCLE (0x00000006U)
  432. #define SPI_MASTER_INTERDATA_IDLENESS_07CYCLE (0x00000007U)
  433. #define SPI_MASTER_INTERDATA_IDLENESS_08CYCLE (0x00000008U)
  434. #define SPI_MASTER_INTERDATA_IDLENESS_09CYCLE (0x00000009U)
  435. #define SPI_MASTER_INTERDATA_IDLENESS_10CYCLE (0x0000000AU)
  436. #define SPI_MASTER_INTERDATA_IDLENESS_11CYCLE (0x0000000BU)
  437. #define SPI_MASTER_INTERDATA_IDLENESS_12CYCLE (0x0000000CU)
  438. #define SPI_MASTER_INTERDATA_IDLENESS_13CYCLE (0x0000000DU)
  439. #define SPI_MASTER_INTERDATA_IDLENESS_14CYCLE (0x0000000EU)
  440. #define SPI_MASTER_INTERDATA_IDLENESS_15CYCLE (0x0000000FU)
  441. /**
  442. * @}
  443. */
  444. /** @defgroup SPI_Master_RX_AutoSuspend SPI Master Receiver AutoSuspend
  445. * @{
  446. */
  447. #define SPI_MASTER_RX_AUTOSUSP_DISABLE (0x00000000U)
  448. #define SPI_MASTER_RX_AUTOSUSP_ENABLE SPI_CR1_MASRX
  449. /**
  450. * @}
  451. */
  452. /** @defgroup SPI_Underrun_Detection SPI Underrun Detection
  453. * @{
  454. */
  455. #define SPI_UNDERRUN_DETECT_BEGIN_DATA_FRAME (0x00000000U)
  456. #define SPI_UNDERRUN_DETECT_END_DATA_FRAME SPI_CFG1_UDRDET_0
  457. #define SPI_UNDERRUN_DETECT_BEGIN_ACTIVE_NSS SPI_CFG1_UDRDET_1
  458. /**
  459. * @}
  460. */
  461. /** @defgroup SPI_Underrun_Behaviour SPI Underrun Behaviour
  462. * @{
  463. */
  464. #define SPI_UNDERRUN_BEHAV_REGISTER_PATTERN (0x00000000U)
  465. #define SPI_UNDERRUN_BEHAV_LAST_RECEIVED SPI_CFG1_UDRCFG_0
  466. #define SPI_UNDERRUN_BEHAV_LAST_TRANSMITTED SPI_CFG1_UDRCFG_1
  467. /**
  468. * @}
  469. */
  470. /** @defgroup SPI_Interrupt_definition SPI Interrupt Definition
  471. * @{
  472. */
  473. #define SPI_IT_TXE SPI_IER_TXPIE
  474. #define SPI_IT_RXNE SPI_IER_RXPIE
  475. #define SPI_IT_EOT SPI_IER_EOTIE
  476. #define SPI_IT_TXTF SPI_IER_TXTFIE
  477. #define SPI_IT_ERR (SPI_IER_UDRIE | SPI_IER_OVRIE | SPI_IER_TIFREIE | SPI_IER_MODFIE)
  478. /**
  479. * @}
  480. */
  481. /** @defgroup SPI_Flags_definition SPI Flags Definition
  482. * @{
  483. */
  484. #define SPI_FLAG_TXE SPI_SR_TXP /* SPI status flag: Tx buffer empty flag */
  485. #define SPI_FLAG_RXNE SPI_SR_RXP /* SPI status flag: Rx buffer not empty flag */
  486. #define SPI_FLAG_UDR SPI_SR_UDR /* SPI Error flag: Underrun flag */
  487. #define SPI_FLAG_OVR SPI_SR_OVR /* SPI Error flag: Overrun flag */
  488. #define SPI_FLAG_FRE SPI_SR_TIFRE /* SPI Error flag: TI mode frame format error flag */
  489. #define SPI_FLAG_CRCERR SPI_SR_CRCE /* SPI Error flag: CRC error flag */
  490. #define SPI_FLAG_MODF SPI_SR_MODF /* SPI Error flag: Mode fault flag */
  491. #define SPI_FLAG_FRLVL SPI_SR_RXPLVL /* SPI fifo reception level */
  492. #define SPI_FLAG_RXWNE SPI_SR_RXWNE /* SPI RxFIFO Word Not Empty */
  493. #define SPI_FLAG_TXTF SPI_SR_TXTF /* SPI Transmission Transfer Filled flag */
  494. #define SPI_FLAG_EOT SPI_SR_EOT /* SPI fifo transmision complete */
  495. /**
  496. * @}
  497. */
  498. /** @defgroup SPI_reception_fifo_status_level SPI Reception FIFO Status Level
  499. * @{
  500. */
  501. #define SPI_FRLVL_EMPTY (0x00000000U)
  502. #define SPI_FRLVL_QUARTER_FULL (0x00002000U)
  503. #define SPI_FRLVL_HALF_FULL (0x00004000U)
  504. #define SPI_FRLVL_FULL (0x00006000U)
  505. /**
  506. * @}
  507. */
  508. /**
  509. * @}
  510. */
  511. /* Exported macros -----------------------------------------------------------*/
  512. /** @defgroup SPI_Exported_Macros SPI Exported Macros
  513. * @{
  514. */
  515. /** @brief Reset SPI handle state.
  516. * @param __HANDLE__: specifies the SPI Handle.
  517. * This parameter can be SPI where x: 1, 2, 3, 4, 5 or 6 to select the SPI peripheral.
  518. * @retval None
  519. */
  520. #define __HAL_SPI_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SPI_STATE_RESET)
  521. /** @brief Enable the specified SPI interrupts.
  522. * @param __HANDLE__: specifies the SPI Handle.
  523. * This parameter can be SPI where x: 1, 2, 3, 4, 5 or 6 to select the SPI peripheral.
  524. * @param __INTERRUPT__: specifies the interrupt source to enable or disable.
  525. * This parameter can be one of the following values:
  526. * @arg SPI_IT_TXE: Tx buffer empty interrupt enable
  527. * @arg SPI_IT_RXNE: RX buffer not empty interrupt enable
  528. * @arg SPI_IT_ERR: Error interrupt enable
  529. * @retval None
  530. */
  531. #define __HAL_SPI_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
  532. /** @brief Disable the specified SPI interrupts.
  533. * @param __HANDLE__: specifies the SPI Handle.
  534. * This parameter can be SPI where x: 1, 2, 3, 4, 5 or 6 to select the SPI peripheral.
  535. * @param __INTERRUPT__: specifies the interrupt source to enable or disable.
  536. * This parameter can be one of the following values:
  537. * @arg SPI_IT_TXE: Tx buffer empty interrupt enable
  538. * @arg SPI_IT_RXNE: RX buffer not empty interrupt enable
  539. * @arg SPI_IT_ERR: Error interrupt enable
  540. * @retval None
  541. */
  542. #define __HAL_SPI_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= (~(__INTERRUPT__)))
  543. /** @brief Check whether the specified SPI interrupt source is enabled or not.
  544. * @param __HANDLE__: specifies the SPI Handle.
  545. * This parameter can be SPI where x: 1, 2, 3, 4, 5 or 6 to select the SPI peripheral.
  546. * @param __INTERRUPT__: specifies the SPI interrupt source to check.
  547. * This parameter can be one of the following values:
  548. * @arg SPI_IT_TXE: Tx buffer empty interrupt enable
  549. * @arg SPI_IT_RXNE: RX buffer not empty interrupt enable
  550. * @arg SPI_IT_ERR: Error interrupt enable
  551. * @retval The new state of __IT__ (TRUE or FALSE).
  552. */
  553. #define __HAL_SPI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->IER & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
  554. /** @brief Check whether the specified SPI flag is set or not.
  555. * @param __HANDLE__: specifies the SPI Handle.
  556. * This parameter can be SPI where x: 1, 2, 3, 4, 5 or 6 to select the SPI peripheral.
  557. * @param __FLAG__: specifies the flag to check.
  558. * This parameter can be one of the following values:
  559. * @arg SPI_FLAG_TXE : Tx buffer empty flag
  560. * @arg SPI_FLAG_RXNE : Rx buffer not empty flag
  561. * @arg SPI_FLAG_UDR : Underrun flag
  562. * @arg SPI_FLAG_OVR : Overrun flag
  563. * @arg SPI_FLAG_FRE : TI mode frame format error flag
  564. * @arg SPI_FLAG_CRCERR: CRC error flag
  565. * @arg SPI_FLAG_MODF : Mode fault flag
  566. * @arg SPI_FLAG_FRLVL : fifo reception level
  567. * @arg SPI_FLAG_RXWNE : RxFIFO Word Not Empty
  568. * @arg SPI_FLAG_TXTF : Transmission Transfer Filled flag
  569. * @arg SPI_FLAG_EOT : fifo transmision complete
  570. * @retval The new state of __FLAG__ (TRUE or FALSE).
  571. */
  572. #define __HAL_SPI_GET_FLAG(__HANDLE__, __FLAG__) ((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__))
  573. /** @brief Clear the SPI CRCERR pending flag.
  574. * @param __HANDLE__: specifies the SPI Handle.
  575. * @retval None
  576. */
  577. #define __HAL_SPI_CLEAR_CRCERRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_CRCEC)
  578. /** @brief Clear the SPI MODF pending flag.
  579. * @param __HANDLE__: specifies the SPI Handle.
  580. * @retval None
  581. */
  582. #define __HAL_SPI_CLEAR_MODFFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , (uint32_t)(SPI_IFCR_MODFC));
  583. /** @brief Clear the SPI OVR pending flag.
  584. * @param __HANDLE__: specifies the SPI Handle.
  585. * @retval None
  586. */
  587. #define __HAL_SPI_CLEAR_OVRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_OVRC)
  588. /** @brief Clear the SPI FRE pending flag.
  589. * @param __HANDLE__: specifies the SPI Handle.
  590. * @retval None
  591. */
  592. #define __HAL_SPI_CLEAR_FREFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_TIFREC)
  593. /** @brief Clear the SPI UDR pending flag.
  594. * @param __HANDLE__: specifies the SPI Handle.
  595. * @retval None
  596. */
  597. #define __HAL_SPI_CLEAR_UDRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_UDRC)
  598. /** @brief Clear the SPI EOT pending flag.
  599. * @param __HANDLE__: specifies the SPI Handle.
  600. * @retval None
  601. */
  602. #define __HAL_SPI_CLEAR_EOTFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_EOTC)
  603. /** @brief Clear the SPI UDR pending flag.
  604. * @param __HANDLE__: specifies the SPI Handle.
  605. * @retval None
  606. */
  607. #define __HAL_SPI_CLEAR_TXTFFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_TXTFC)
  608. /** @brief Enable the SPI peripheral.
  609. * @param __HANDLE__: specifies the SPI Handle.
  610. * @retval None
  611. */
  612. #define __HAL_SPI_ENABLE(__HANDLE__) SET_BIT((__HANDLE__)->Instance->CR1 , SPI_CR1_SPE)
  613. /** @brief Disable the SPI peripheral.
  614. * @param __HANDLE__: specifies the SPI Handle.
  615. * @retval None
  616. */
  617. #define __HAL_SPI_DISABLE(__HANDLE__) CLEAR_BIT((__HANDLE__)->Instance->CR1 , SPI_CR1_SPE)
  618. /**
  619. * @}
  620. */
  621. /* Include SPI HAL Extension module */
  622. #include "stm32h7xx_hal_spi_ex.h"
  623. /* Exported functions --------------------------------------------------------*/
  624. /** @addtogroup SPI_Exported_Functions
  625. * @{
  626. */
  627. /** @addtogroup SPI_Exported_Functions_Group1 Initialization and de-initialization functions
  628. * @{
  629. */
  630. /* Initialization/de-initialization functions ********************************/
  631. HAL_StatusTypeDef HAL_SPI_Init(SPI_HandleTypeDef *hspi);
  632. HAL_StatusTypeDef HAL_SPI_DeInit(SPI_HandleTypeDef *hspi);
  633. void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi);
  634. void HAL_SPI_MspDeInit(SPI_HandleTypeDef *hspi);
  635. /**
  636. * @}
  637. */
  638. /** @addtogroup SPI_Exported_Functions_Group2 IO operation functions
  639. * @{
  640. */
  641. /* I/O operation functions ***************************************************/
  642. HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  643. HAL_StatusTypeDef HAL_SPI_Receive (SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  644. HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size,
  645. uint32_t Timeout);
  646. HAL_StatusTypeDef HAL_SPI_Transmit_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size);
  647. HAL_StatusTypeDef HAL_SPI_Receive_IT (SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size);
  648. HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData,
  649. uint16_t Size);
  650. HAL_StatusTypeDef HAL_SPI_Transmit_DMA(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size);
  651. HAL_StatusTypeDef HAL_SPI_Receive_DMA (SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size);
  652. HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData,
  653. uint16_t Size);
  654. HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi);
  655. HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi);
  656. HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi);
  657. /* Transfer Abort functions */
  658. HAL_StatusTypeDef HAL_SPI_Abort(SPI_HandleTypeDef *hspi);
  659. HAL_StatusTypeDef HAL_SPI_Abort_IT(SPI_HandleTypeDef *hspi);
  660. void HAL_SPI_IRQHandler(SPI_HandleTypeDef *hspi);
  661. void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi);
  662. void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi);
  663. void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi);
  664. void HAL_SPI_TxHalfCpltCallback(SPI_HandleTypeDef *hspi);
  665. void HAL_SPI_RxHalfCpltCallback(SPI_HandleTypeDef *hspi);
  666. void HAL_SPI_TxRxHalfCpltCallback(SPI_HandleTypeDef *hspi);
  667. void HAL_SPI_ErrorCallback(SPI_HandleTypeDef *hspi);
  668. void HAL_SPI_AbortCpltCallback(SPI_HandleTypeDef *hspi);
  669. /**
  670. * @}
  671. */
  672. /** @addtogroup SPI_Exported_Functions_Group3 Peripheral State and Errors functions
  673. * @{
  674. */
  675. /* Peripheral State and Error functions ***************************************/
  676. HAL_SPI_StateTypeDef HAL_SPI_GetState(SPI_HandleTypeDef *hspi);
  677. uint32_t HAL_SPI_GetError(SPI_HandleTypeDef *hspi);
  678. /**
  679. * @}
  680. */
  681. /**
  682. * @}
  683. */
  684. /* Private macros ------------------------------------------------------------*/
  685. /** @defgroup SPI_Private_Macros SPI Private Macros
  686. * @{
  687. */
  688. /** @brief Set the SPI transmit-only mode.
  689. * @param __HANDLE__: specifies the SPI Handle.
  690. * This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
  691. * @retval None
  692. */
  693. #define SPI_1LINE_TX(__HANDLE__) SET_BIT((__HANDLE__)->Instance->CR1 , SPI_CR1_HDDIR)
  694. /** @brief Set the SPI receive-only mode.
  695. * @param __HANDLE__: specifies the SPI Handle.
  696. * This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
  697. * @retval None
  698. */
  699. #define SPI_1LINE_RX(__HANDLE__) CLEAR_BIT((__HANDLE__)->Instance->CR1 ,SPI_CR1_HDDIR)
  700. #define IS_SPI_MODE(MODE) (((MODE) == SPI_MODE_SLAVE) || \
  701. ((MODE) == SPI_MODE_MASTER))
  702. #define IS_SPI_DIRECTION(MODE) (((MODE) == SPI_DIRECTION_2LINES) || \
  703. ((MODE) == SPI_DIRECTION_2LINES_RXONLY) || \
  704. ((MODE) == SPI_DIRECTION_1LINE) || \
  705. ((MODE) == SPI_DIRECTION_2LINES_TXONLY))
  706. #define IS_SPI_DIRECTION_2LINES(MODE) ((MODE) == SPI_DIRECTION_2LINES)
  707. #define IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_TXONLY(MODE) ( \
  708. ((MODE) == SPI_DIRECTION_2LINES)|| \
  709. ((MODE) == SPI_DIRECTION_1LINE) || \
  710. ((MODE) == SPI_DIRECTION_2LINES_TXONLY))
  711. #define IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_RXONLY(MODE) ( \
  712. ((MODE) == SPI_DIRECTION_2LINES)|| \
  713. ((MODE) == SPI_DIRECTION_1LINE) || \
  714. ((MODE) == SPI_DIRECTION_2LINES_RXONLY))
  715. #define IS_SPI_DATASIZE(DATASIZE) (((DATASIZE) == SPI_DATASIZE_32BIT) || \
  716. ((DATASIZE) == SPI_DATASIZE_31BIT) || \
  717. ((DATASIZE) == SPI_DATASIZE_30BIT) || \
  718. ((DATASIZE) == SPI_DATASIZE_29BIT) || \
  719. ((DATASIZE) == SPI_DATASIZE_28BIT) || \
  720. ((DATASIZE) == SPI_DATASIZE_27BIT) || \
  721. ((DATASIZE) == SPI_DATASIZE_26BIT) || \
  722. ((DATASIZE) == SPI_DATASIZE_25BIT) || \
  723. ((DATASIZE) == SPI_DATASIZE_24BIT) || \
  724. ((DATASIZE) == SPI_DATASIZE_23BIT) || \
  725. ((DATASIZE) == SPI_DATASIZE_22BIT) || \
  726. ((DATASIZE) == SPI_DATASIZE_21BIT) || \
  727. ((DATASIZE) == SPI_DATASIZE_20BIT) || \
  728. ((DATASIZE) == SPI_DATASIZE_22BIT) || \
  729. ((DATASIZE) == SPI_DATASIZE_19BIT) || \
  730. ((DATASIZE) == SPI_DATASIZE_18BIT) || \
  731. ((DATASIZE) == SPI_DATASIZE_17BIT) || \
  732. ((DATASIZE) == SPI_DATASIZE_16BIT) || \
  733. ((DATASIZE) == SPI_DATASIZE_15BIT) || \
  734. ((DATASIZE) == SPI_DATASIZE_14BIT) || \
  735. ((DATASIZE) == SPI_DATASIZE_13BIT) || \
  736. ((DATASIZE) == SPI_DATASIZE_12BIT) || \
  737. ((DATASIZE) == SPI_DATASIZE_11BIT) || \
  738. ((DATASIZE) == SPI_DATASIZE_10BIT) || \
  739. ((DATASIZE) == SPI_DATASIZE_9BIT) || \
  740. ((DATASIZE) == SPI_DATASIZE_8BIT) || \
  741. ((DATASIZE) == SPI_DATASIZE_7BIT) || \
  742. ((DATASIZE) == SPI_DATASIZE_6BIT) || \
  743. ((DATASIZE) == SPI_DATASIZE_5BIT) || \
  744. ((DATASIZE) == SPI_DATASIZE_4BIT))
  745. #define IS_SPI_FIFOTHRESHOLD(THRESHOLD) (((THRESHOLD) == SPI_FIFO_THRESHOLD_01DATA) || \
  746. ((THRESHOLD) == SPI_FIFO_THRESHOLD_02DATA) || \
  747. ((THRESHOLD) == SPI_FIFO_THRESHOLD_03DATA) || \
  748. ((THRESHOLD) == SPI_FIFO_THRESHOLD_04DATA) || \
  749. ((THRESHOLD) == SPI_FIFO_THRESHOLD_05DATA) || \
  750. ((THRESHOLD) == SPI_FIFO_THRESHOLD_06DATA) || \
  751. ((THRESHOLD) == SPI_FIFO_THRESHOLD_07DATA) || \
  752. ((THRESHOLD) == SPI_FIFO_THRESHOLD_08DATA) || \
  753. ((THRESHOLD) == SPI_FIFO_THRESHOLD_09DATA) || \
  754. ((THRESHOLD) == SPI_FIFO_THRESHOLD_10DATA) || \
  755. ((THRESHOLD) == SPI_FIFO_THRESHOLD_11DATA) || \
  756. ((THRESHOLD) == SPI_FIFO_THRESHOLD_12DATA) || \
  757. ((THRESHOLD) == SPI_FIFO_THRESHOLD_13DATA) || \
  758. ((THRESHOLD) == SPI_FIFO_THRESHOLD_14DATA) || \
  759. ((THRESHOLD) == SPI_FIFO_THRESHOLD_15DATA) || \
  760. ((THRESHOLD) == SPI_FIFO_THRESHOLD_16DATA))
  761. #define IS_SPI_CPOL(CPOL) (((CPOL) == SPI_POLARITY_LOW) || \
  762. ((CPOL) == SPI_POLARITY_HIGH))
  763. #define IS_SPI_CPHA(CPHA) (((CPHA) == SPI_PHASE_1EDGE) || \
  764. ((CPHA) == SPI_PHASE_2EDGE))
  765. #define IS_SPI_NSS(NSS) (((NSS) == SPI_NSS_SOFT) || \
  766. ((NSS) == SPI_NSS_HARD_INPUT) || \
  767. ((NSS) == SPI_NSS_HARD_OUTPUT))
  768. #define IS_SPI_NSSP(NSSP) (((NSSP) == SPI_NSS_PULSE_ENABLE) || \
  769. ((NSSP) == SPI_NSS_PULSE_DISABLE))
  770. #define IS_SPI_BAUDRATE_PRESCALER(PRESCALER) (((PRESCALER) == SPI_BAUDRATEPRESCALER_2) || \
  771. ((PRESCALER) == SPI_BAUDRATEPRESCALER_4) || \
  772. ((PRESCALER) == SPI_BAUDRATEPRESCALER_8) || \
  773. ((PRESCALER) == SPI_BAUDRATEPRESCALER_16) || \
  774. ((PRESCALER) == SPI_BAUDRATEPRESCALER_32) || \
  775. ((PRESCALER) == SPI_BAUDRATEPRESCALER_64) || \
  776. ((PRESCALER) == SPI_BAUDRATEPRESCALER_128) || \
  777. ((PRESCALER) == SPI_BAUDRATEPRESCALER_256))
  778. #define IS_SPI_FIRST_BIT(BIT) (((BIT) == SPI_FIRSTBIT_MSB) || \
  779. ((BIT) == SPI_FIRSTBIT_LSB))
  780. #define IS_SPI_TIMODE(MODE) (((MODE) == SPI_TIMODE_DISABLE) || \
  781. ((MODE) == SPI_TIMODE_ENABLE))
  782. #define IS_SPI_CRC_CALCULATION(CALCULATION) (((CALCULATION) == SPI_CRCCALCULATION_DISABLE) || \
  783. ((CALCULATION) == SPI_CRCCALCULATION_ENABLE))
  784. #define IS_SPI_CRC_INITIALIZATION_PATTERN(PATTERN) (((PATTERN) == SPI_CRC_INITIALIZATION_ALL_ZERO_PATTERN) || \
  785. ((PATTERN) == SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN))
  786. #define IS_SPI_CRC_LENGTH(LENGTH) (((LENGTH) == SPI_CRC_LENGTH_DATASIZE) ||\
  787. ((LENGTH) == SPI_CRC_LENGTH_32BIT) ||\
  788. ((LENGTH) == SPI_CRC_LENGTH_31BIT) ||\
  789. ((LENGTH) == SPI_CRC_LENGTH_30BIT) ||\
  790. ((LENGTH) == SPI_CRC_LENGTH_29BIT) ||\
  791. ((LENGTH) == SPI_CRC_LENGTH_28BIT) ||\
  792. ((LENGTH) == SPI_CRC_LENGTH_27BIT) ||\
  793. ((LENGTH) == SPI_CRC_LENGTH_26BIT) ||\
  794. ((LENGTH) == SPI_CRC_LENGTH_25BIT) ||\
  795. ((LENGTH) == SPI_CRC_LENGTH_24BIT) ||\
  796. ((LENGTH) == SPI_CRC_LENGTH_23BIT) ||\
  797. ((LENGTH) == SPI_CRC_LENGTH_22BIT) ||\
  798. ((LENGTH) == SPI_CRC_LENGTH_21BIT) ||\
  799. ((LENGTH) == SPI_CRC_LENGTH_20BIT) ||\
  800. ((LENGTH) == SPI_CRC_LENGTH_19BIT) ||\
  801. ((LENGTH) == SPI_CRC_LENGTH_18BIT) ||\
  802. ((LENGTH) == SPI_CRC_LENGTH_17BIT) ||\
  803. ((LENGTH) == SPI_CRC_LENGTH_16BIT) ||\
  804. ((LENGTH) == SPI_CRC_LENGTH_15BIT) ||\
  805. ((LENGTH) == SPI_CRC_LENGTH_14BIT) ||\
  806. ((LENGTH) == SPI_CRC_LENGTH_13BIT) ||\
  807. ((LENGTH) == SPI_CRC_LENGTH_12BIT) ||\
  808. ((LENGTH) == SPI_CRC_LENGTH_11BIT) ||\
  809. ((LENGTH) == SPI_CRC_LENGTH_10BIT) ||\
  810. ((LENGTH) == SPI_CRC_LENGTH_9BIT) ||\
  811. ((LENGTH) == SPI_CRC_LENGTH_8BIT) ||\
  812. ((LENGTH) == SPI_CRC_LENGTH_7BIT) ||\
  813. ((LENGTH) == SPI_CRC_LENGTH_6BIT) ||\
  814. ((LENGTH) == SPI_CRC_LENGTH_5BIT) ||\
  815. ((LENGTH) == SPI_CRC_LENGTH_4BIT))
  816. #define IS_SPI_CRC_POLYNOMIAL(POLYNOMIAL) (((POLYNOMIAL) >= 0x1) && ((POLYNOMIAL) <= 0xFFFFFFFF))
  817. #define IS_SPI_UNDERRUN_DETECTION(MODE) (((MODE) == SPI_UNDERRUN_DETECT_BEGIN_DATA_FRAME) || \
  818. ((MODE) == SPI_UNDERRUN_DETECT_END_DATA_FRAME) || \
  819. ((MODE) == SPI_UNDERRUN_DETECT_BEGIN_ACTIVE_NSS))
  820. #define IS_SPI_UNDERRUN_BEHAVIOUR(MODE) (((MODE) == SPI_UNDERRUN_BEHAV_REGISTER_PATTERN) || \
  821. ((MODE) == SPI_UNDERRUN_BEHAV_LAST_RECEIVED) || \
  822. ((MODE) == SPI_UNDERRUN_BEHAV_LAST_TRANSMITTED))
  823. /**
  824. * @}
  825. */
  826. /**
  827. * @}
  828. */
  829. /**
  830. * @}
  831. */
  832. #ifdef __cplusplus
  833. }
  834. #endif
  835. #endif /* __STM32H7xx_HAL_SPI_H */
  836. /**
  837. * @}
  838. */
  839. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/