20#ifndef STM32H7xx_HAL_SPI_H
21#define STM32H7xx_HAL_SPI_H
147#if defined(USE_SPI_RELOAD_TRANSFER)
153 const uint8_t *pTxBuffPtr;
203#if defined(USE_SPI_RELOAD_TRANSFER)
205 SPI_ReloadTypeDef Reload;
209#if (USE_HAL_SPI_REGISTER_CALLBACKS == 1UL)
225#if (USE_HAL_SPI_REGISTER_CALLBACKS == 1UL)
231 HAL_SPI_TX_COMPLETE_CB_ID = 0x00UL,
232 HAL_SPI_RX_COMPLETE_CB_ID = 0x01UL,
233 HAL_SPI_TX_RX_COMPLETE_CB_ID = 0x02UL,
234 HAL_SPI_TX_HALF_COMPLETE_CB_ID = 0x03UL,
235 HAL_SPI_RX_HALF_COMPLETE_CB_ID = 0x04UL,
236 HAL_SPI_TX_RX_HALF_COMPLETE_CB_ID = 0x05UL,
237 HAL_SPI_ERROR_CB_ID = 0x06UL,
238 HAL_SPI_ABORT_CB_ID = 0x07UL,
239 HAL_SPI_SUSPEND_CB_ID = 0x08UL,
240 HAL_SPI_MSPINIT_CB_ID = 0x09UL,
241 HAL_SPI_MSPDEINIT_CB_ID = 0x0AUL
243} HAL_SPI_CallbackIDTypeDef;
264#define SPI_LOWEND_FIFO_SIZE 8UL
265#define SPI_HIGHEND_FIFO_SIZE 16UL
273#define HAL_SPI_ERROR_NONE (0x00000000UL)
274#define HAL_SPI_ERROR_MODF (0x00000001UL)
275#define HAL_SPI_ERROR_CRC (0x00000002UL)
276#define HAL_SPI_ERROR_OVR (0x00000004UL)
277#define HAL_SPI_ERROR_FRE (0x00000008UL)
278#define HAL_SPI_ERROR_DMA (0x00000010UL)
279#define HAL_SPI_ERROR_FLAG (0x00000020UL)
280#define HAL_SPI_ERROR_ABORT (0x00000040UL)
281#define HAL_SPI_ERROR_UDR (0x00000080UL)
282#define HAL_SPI_ERROR_TIMEOUT (0x00000100UL)
283#define HAL_SPI_ERROR_UNKNOW (0x00000200UL)
284#define HAL_SPI_ERROR_NOT_SUPPORTED (0x00000400UL)
285#define HAL_SPI_ERROR_RELOAD (0x00000800UL)
286#if (USE_HAL_SPI_REGISTER_CALLBACKS == 1UL)
287#define HAL_SPI_ERROR_INVALID_CALLBACK (0x00001000UL)
296#define SPI_MODE_SLAVE (0x00000000UL)
297#define SPI_MODE_MASTER SPI_CFG2_MASTER
305#define SPI_DIRECTION_2LINES (0x00000000UL)
306#define SPI_DIRECTION_2LINES_TXONLY SPI_CFG2_COMM_0
307#define SPI_DIRECTION_2LINES_RXONLY SPI_CFG2_COMM_1
308#define SPI_DIRECTION_1LINE SPI_CFG2_COMM
316#define SPI_DATASIZE_4BIT (0x00000003UL)
317#define SPI_DATASIZE_5BIT (0x00000004UL)
318#define SPI_DATASIZE_6BIT (0x00000005UL)
319#define SPI_DATASIZE_7BIT (0x00000006UL)
320#define SPI_DATASIZE_8BIT (0x00000007UL)
321#define SPI_DATASIZE_9BIT (0x00000008UL)
322#define SPI_DATASIZE_10BIT (0x00000009UL)
323#define SPI_DATASIZE_11BIT (0x0000000AUL)
324#define SPI_DATASIZE_12BIT (0x0000000BUL)
325#define SPI_DATASIZE_13BIT (0x0000000CUL)
326#define SPI_DATASIZE_14BIT (0x0000000DUL)
327#define SPI_DATASIZE_15BIT (0x0000000EUL)
328#define SPI_DATASIZE_16BIT (0x0000000FUL)
329#define SPI_DATASIZE_17BIT (0x00000010UL)
330#define SPI_DATASIZE_18BIT (0x00000011UL)
331#define SPI_DATASIZE_19BIT (0x00000012UL)
332#define SPI_DATASIZE_20BIT (0x00000013UL)
333#define SPI_DATASIZE_21BIT (0x00000014UL)
334#define SPI_DATASIZE_22BIT (0x00000015UL)
335#define SPI_DATASIZE_23BIT (0x00000016UL)
336#define SPI_DATASIZE_24BIT (0x00000017UL)
337#define SPI_DATASIZE_25BIT (0x00000018UL)
338#define SPI_DATASIZE_26BIT (0x00000019UL)
339#define SPI_DATASIZE_27BIT (0x0000001AUL)
340#define SPI_DATASIZE_28BIT (0x0000001BUL)
341#define SPI_DATASIZE_29BIT (0x0000001CUL)
342#define SPI_DATASIZE_30BIT (0x0000001DUL)
343#define SPI_DATASIZE_31BIT (0x0000001EUL)
344#define SPI_DATASIZE_32BIT (0x0000001FUL)
352#define SPI_POLARITY_LOW (0x00000000UL)
353#define SPI_POLARITY_HIGH SPI_CFG2_CPOL
361#define SPI_PHASE_1EDGE (0x00000000UL)
362#define SPI_PHASE_2EDGE SPI_CFG2_CPHA
370#define SPI_NSS_SOFT SPI_CFG2_SSM
371#define SPI_NSS_HARD_INPUT (0x00000000UL)
372#define SPI_NSS_HARD_OUTPUT SPI_CFG2_SSOE
380#define SPI_NSS_PULSE_DISABLE (0x00000000UL)
381#define SPI_NSS_PULSE_ENABLE SPI_CFG2_SSOM
389#define SPI_BAUDRATEPRESCALER_2 (0x00000000UL)
390#define SPI_BAUDRATEPRESCALER_4 (0x10000000UL)
391#define SPI_BAUDRATEPRESCALER_8 (0x20000000UL)
392#define SPI_BAUDRATEPRESCALER_16 (0x30000000UL)
393#define SPI_BAUDRATEPRESCALER_32 (0x40000000UL)
394#define SPI_BAUDRATEPRESCALER_64 (0x50000000UL)
395#define SPI_BAUDRATEPRESCALER_128 (0x60000000UL)
396#define SPI_BAUDRATEPRESCALER_256 (0x70000000UL)
404#define SPI_FIRSTBIT_MSB (0x00000000UL)
405#define SPI_FIRSTBIT_LSB SPI_CFG2_LSBFRST
413#define SPI_TIMODE_DISABLE (0x00000000UL)
414#define SPI_TIMODE_ENABLE SPI_CFG2_SP_0
422#define SPI_CRCCALCULATION_DISABLE (0x00000000UL)
423#define SPI_CRCCALCULATION_ENABLE SPI_CFG1_CRCEN
431#define SPI_CRC_LENGTH_DATASIZE (0x00000000UL)
432#define SPI_CRC_LENGTH_4BIT (0x00030000UL)
433#define SPI_CRC_LENGTH_5BIT (0x00040000UL)
434#define SPI_CRC_LENGTH_6BIT (0x00050000UL)
435#define SPI_CRC_LENGTH_7BIT (0x00060000UL)
436#define SPI_CRC_LENGTH_8BIT (0x00070000UL)
437#define SPI_CRC_LENGTH_9BIT (0x00080000UL)
438#define SPI_CRC_LENGTH_10BIT (0x00090000UL)
439#define SPI_CRC_LENGTH_11BIT (0x000A0000UL)
440#define SPI_CRC_LENGTH_12BIT (0x000B0000UL)
441#define SPI_CRC_LENGTH_13BIT (0x000C0000UL)
442#define SPI_CRC_LENGTH_14BIT (0x000D0000UL)
443#define SPI_CRC_LENGTH_15BIT (0x000E0000UL)
444#define SPI_CRC_LENGTH_16BIT (0x000F0000UL)
445#define SPI_CRC_LENGTH_17BIT (0x00100000UL)
446#define SPI_CRC_LENGTH_18BIT (0x00110000UL)
447#define SPI_CRC_LENGTH_19BIT (0x00120000UL)
448#define SPI_CRC_LENGTH_20BIT (0x00130000UL)
449#define SPI_CRC_LENGTH_21BIT (0x00140000UL)
450#define SPI_CRC_LENGTH_22BIT (0x00150000UL)
451#define SPI_CRC_LENGTH_23BIT (0x00160000UL)
452#define SPI_CRC_LENGTH_24BIT (0x00170000UL)
453#define SPI_CRC_LENGTH_25BIT (0x00180000UL)
454#define SPI_CRC_LENGTH_26BIT (0x00190000UL)
455#define SPI_CRC_LENGTH_27BIT (0x001A0000UL)
456#define SPI_CRC_LENGTH_28BIT (0x001B0000UL)
457#define SPI_CRC_LENGTH_29BIT (0x001C0000UL)
458#define SPI_CRC_LENGTH_30BIT (0x001D0000UL)
459#define SPI_CRC_LENGTH_31BIT (0x001E0000UL)
460#define SPI_CRC_LENGTH_32BIT (0x001F0000UL)
468#define SPI_FIFO_THRESHOLD_01DATA (0x00000000UL)
469#define SPI_FIFO_THRESHOLD_02DATA (0x00000020UL)
470#define SPI_FIFO_THRESHOLD_03DATA (0x00000040UL)
471#define SPI_FIFO_THRESHOLD_04DATA (0x00000060UL)
472#define SPI_FIFO_THRESHOLD_05DATA (0x00000080UL)
473#define SPI_FIFO_THRESHOLD_06DATA (0x000000A0UL)
474#define SPI_FIFO_THRESHOLD_07DATA (0x000000C0UL)
475#define SPI_FIFO_THRESHOLD_08DATA (0x000000E0UL)
476#define SPI_FIFO_THRESHOLD_09DATA (0x00000100UL)
477#define SPI_FIFO_THRESHOLD_10DATA (0x00000120UL)
478#define SPI_FIFO_THRESHOLD_11DATA (0x00000140UL)
479#define SPI_FIFO_THRESHOLD_12DATA (0x00000160UL)
480#define SPI_FIFO_THRESHOLD_13DATA (0x00000180UL)
481#define SPI_FIFO_THRESHOLD_14DATA (0x000001A0UL)
482#define SPI_FIFO_THRESHOLD_15DATA (0x000001C0UL)
483#define SPI_FIFO_THRESHOLD_16DATA (0x000001E0UL)
491#define SPI_CRC_INITIALIZATION_ALL_ZERO_PATTERN (0x00000000UL)
492#define SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN (0x00000001UL)
500#define SPI_NSS_POLARITY_LOW (0x00000000UL)
501#define SPI_NSS_POLARITY_HIGH SPI_CFG2_SSIOP
509#define SPI_MASTER_KEEP_IO_STATE_DISABLE (0x00000000UL)
510#define SPI_MASTER_KEEP_IO_STATE_ENABLE SPI_CFG2_AFCNTR
518#define SPI_IO_SWAP_DISABLE (0x00000000UL)
519#define SPI_IO_SWAP_ENABLE SPI_CFG2_IOSWP
527#define SPI_MASTER_SS_IDLENESS_00CYCLE (0x00000000UL)
528#define SPI_MASTER_SS_IDLENESS_01CYCLE (0x00000001UL)
529#define SPI_MASTER_SS_IDLENESS_02CYCLE (0x00000002UL)
530#define SPI_MASTER_SS_IDLENESS_03CYCLE (0x00000003UL)
531#define SPI_MASTER_SS_IDLENESS_04CYCLE (0x00000004UL)
532#define SPI_MASTER_SS_IDLENESS_05CYCLE (0x00000005UL)
533#define SPI_MASTER_SS_IDLENESS_06CYCLE (0x00000006UL)
534#define SPI_MASTER_SS_IDLENESS_07CYCLE (0x00000007UL)
535#define SPI_MASTER_SS_IDLENESS_08CYCLE (0x00000008UL)
536#define SPI_MASTER_SS_IDLENESS_09CYCLE (0x00000009UL)
537#define SPI_MASTER_SS_IDLENESS_10CYCLE (0x0000000AUL)
538#define SPI_MASTER_SS_IDLENESS_11CYCLE (0x0000000BUL)
539#define SPI_MASTER_SS_IDLENESS_12CYCLE (0x0000000CUL)
540#define SPI_MASTER_SS_IDLENESS_13CYCLE (0x0000000DUL)
541#define SPI_MASTER_SS_IDLENESS_14CYCLE (0x0000000EUL)
542#define SPI_MASTER_SS_IDLENESS_15CYCLE (0x0000000FUL)
550#define SPI_MASTER_INTERDATA_IDLENESS_00CYCLE (0x00000000UL)
551#define SPI_MASTER_INTERDATA_IDLENESS_01CYCLE (0x00000010UL)
552#define SPI_MASTER_INTERDATA_IDLENESS_02CYCLE (0x00000020UL)
553#define SPI_MASTER_INTERDATA_IDLENESS_03CYCLE (0x00000030UL)
554#define SPI_MASTER_INTERDATA_IDLENESS_04CYCLE (0x00000040UL)
555#define SPI_MASTER_INTERDATA_IDLENESS_05CYCLE (0x00000050UL)
556#define SPI_MASTER_INTERDATA_IDLENESS_06CYCLE (0x00000060UL)
557#define SPI_MASTER_INTERDATA_IDLENESS_07CYCLE (0x00000070UL)
558#define SPI_MASTER_INTERDATA_IDLENESS_08CYCLE (0x00000080UL)
559#define SPI_MASTER_INTERDATA_IDLENESS_09CYCLE (0x00000090UL)
560#define SPI_MASTER_INTERDATA_IDLENESS_10CYCLE (0x000000A0UL)
561#define SPI_MASTER_INTERDATA_IDLENESS_11CYCLE (0x000000B0UL)
562#define SPI_MASTER_INTERDATA_IDLENESS_12CYCLE (0x000000C0UL)
563#define SPI_MASTER_INTERDATA_IDLENESS_13CYCLE (0x000000D0UL)
564#define SPI_MASTER_INTERDATA_IDLENESS_14CYCLE (0x000000E0UL)
565#define SPI_MASTER_INTERDATA_IDLENESS_15CYCLE (0x000000F0UL)
573#define SPI_MASTER_RX_AUTOSUSP_DISABLE (0x00000000UL)
574#define SPI_MASTER_RX_AUTOSUSP_ENABLE SPI_CR1_MASRX
582#define SPI_UNDERRUN_BEHAV_REGISTER_PATTERN (0x00000000UL)
583#define SPI_UNDERRUN_BEHAV_LAST_RECEIVED SPI_CFG1_UDRCFG_0
584#define SPI_UNDERRUN_BEHAV_LAST_TRANSMITTED SPI_CFG1_UDRCFG_1
592#define SPI_UNDERRUN_DETECT_BEGIN_DATA_FRAME (0x00000000UL)
593#define SPI_UNDERRUN_DETECT_END_DATA_FRAME SPI_CFG1_UDRDET_0
594#define SPI_UNDERRUN_DETECT_BEGIN_ACTIVE_NSS SPI_CFG1_UDRDET_1
602#define SPI_IT_RXP SPI_IER_RXPIE
603#define SPI_IT_TXP SPI_IER_TXPIE
604#define SPI_IT_DXP SPI_IER_DXPIE
605#define SPI_IT_EOT SPI_IER_EOTIE
606#define SPI_IT_TXTF SPI_IER_TXTFIE
607#define SPI_IT_UDR SPI_IER_UDRIE
608#define SPI_IT_OVR SPI_IER_OVRIE
609#define SPI_IT_CRCERR SPI_IER_CRCEIE
610#define SPI_IT_FRE SPI_IER_TIFREIE
611#define SPI_IT_MODF SPI_IER_MODFIE
612#define SPI_IT_TSERF SPI_IER_TSERFIE
613#define SPI_IT_ERR (SPI_IT_UDR | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF | SPI_IT_CRCERR)
621#define SPI_FLAG_RXP SPI_SR_RXP
622#define SPI_FLAG_TXP SPI_SR_TXP
623#define SPI_FLAG_DXP SPI_SR_DXP
624#define SPI_FLAG_EOT SPI_SR_EOT
625#define SPI_FLAG_TXTF SPI_SR_TXTF
626#define SPI_FLAG_UDR SPI_SR_UDR
627#define SPI_FLAG_OVR SPI_SR_OVR
628#define SPI_FLAG_CRCERR SPI_SR_CRCE
629#define SPI_FLAG_FRE SPI_SR_TIFRE
630#define SPI_FLAG_MODF SPI_SR_MODF
631#define SPI_FLAG_TSERF SPI_SR_TSERF
632#define SPI_FLAG_SUSP SPI_SR_SUSP
633#define SPI_FLAG_TXC SPI_SR_TXC
634#define SPI_FLAG_FRLVL SPI_SR_RXPLVL
635#define SPI_FLAG_RXWNE SPI_SR_RXWNE
643#define SPI_RX_FIFO_0PACKET (0x00000000UL)
644#define SPI_RX_FIFO_1PACKET (SPI_SR_RXPLVL_0)
645#define SPI_RX_FIFO_2PACKET (SPI_SR_RXPLVL_1)
646#define SPI_RX_FIFO_3PACKET (SPI_SR_RXPLVL_1 | SPI_SR_RXPLVL_0)
665#if (USE_HAL_SPI_REGISTER_CALLBACKS == 1UL)
666#define __HAL_SPI_RESET_HANDLE_STATE(__HANDLE__) do{ \
667 (__HANDLE__)->State = HAL_SPI_STATE_RESET; \
668 (__HANDLE__)->MspInitCallback = NULL; \
669 (__HANDLE__)->MspDeInitCallback = NULL; \
672#define __HAL_SPI_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SPI_STATE_RESET)
694#define __HAL_SPI_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
715#define __HAL_SPI_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= (~(__INTERRUPT__)))
736#define __HAL_SPI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->IER & \
737 (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
761#define __HAL_SPI_GET_FLAG(__HANDLE__, __FLAG__) ((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__))
767#define __HAL_SPI_CLEAR_CRCERRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_CRCEC)
773#define __HAL_SPI_CLEAR_MODFFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , (uint32_t)(SPI_IFCR_MODFC));
779#define __HAL_SPI_CLEAR_OVRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_OVRC)
785#define __HAL_SPI_CLEAR_FREFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_TIFREC)
791#define __HAL_SPI_CLEAR_UDRFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_UDRC)
797#define __HAL_SPI_CLEAR_EOTFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_EOTC)
803#define __HAL_SPI_CLEAR_TXTFFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_TXTFC)
809#define __HAL_SPI_CLEAR_SUSPFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_SUSPC)
815#define __HAL_SPI_CLEAR_TSERFFLAG(__HANDLE__) SET_BIT((__HANDLE__)->Instance->IFCR , SPI_IFCR_TSERFC)
821#define __HAL_SPI_ENABLE(__HANDLE__) SET_BIT((__HANDLE__)->Instance->CR1 , SPI_CR1_SPE)
827#define __HAL_SPI_DISABLE(__HANDLE__) CLEAR_BIT((__HANDLE__)->Instance->CR1 , SPI_CR1_SPE)
852#if (USE_HAL_SPI_REGISTER_CALLBACKS == 1U)
854 pSPI_CallbackTypeDef pCallback);
868 uint16_t Size, uint32_t Timeout);
879#if defined(USE_SPI_RELOAD_TRANSFER)
883 uint8_t *pRxData, uint16_t Size);
933#define SPI_1LINE_TX(__HANDLE__) SET_BIT((__HANDLE__)->Instance->CR1, SPI_CR1_HDDIR)
940#define SPI_1LINE_RX(__HANDLE__) CLEAR_BIT((__HANDLE__)->Instance->CR1, SPI_CR1_HDDIR)
947#define SPI_2LINES_TX(__HANDLE__) MODIFY_REG((__HANDLE__)->Instance->CFG2, SPI_CFG2_COMM, SPI_CFG2_COMM_0)
954#define SPI_2LINES_RX(__HANDLE__) MODIFY_REG((__HANDLE__)->Instance->CFG2, SPI_CFG2_COMM, SPI_CFG2_COMM_1)
961#define SPI_2LINES(__HANDLE__) MODIFY_REG((__HANDLE__)->Instance->CFG2, SPI_CFG2_COMM, 0x00000000UL)
963#define IS_SPI_MODE(MODE) (((MODE) == SPI_MODE_SLAVE) || \
964 ((MODE) == SPI_MODE_MASTER))
966#define IS_SPI_DIRECTION(MODE) (((MODE) == SPI_DIRECTION_2LINES) || \
967 ((MODE) == SPI_DIRECTION_2LINES_RXONLY) || \
968 ((MODE) == SPI_DIRECTION_1LINE) || \
969 ((MODE) == SPI_DIRECTION_2LINES_TXONLY))
971#define IS_SPI_DIRECTION_2LINES(MODE) ((MODE) == SPI_DIRECTION_2LINES)
973#define IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_TXONLY(MODE) (((MODE) == SPI_DIRECTION_2LINES)|| \
974 ((MODE) == SPI_DIRECTION_1LINE) || \
975 ((MODE) == SPI_DIRECTION_2LINES_TXONLY))
977#define IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_RXONLY(MODE) (((MODE) == SPI_DIRECTION_2LINES)|| \
978 ((MODE) == SPI_DIRECTION_1LINE) || \
979 ((MODE) == SPI_DIRECTION_2LINES_RXONLY))
981#define IS_SPI_DATASIZE(DATASIZE) (((DATASIZE) == SPI_DATASIZE_32BIT) || \
982 ((DATASIZE) == SPI_DATASIZE_31BIT) || \
983 ((DATASIZE) == SPI_DATASIZE_30BIT) || \
984 ((DATASIZE) == SPI_DATASIZE_29BIT) || \
985 ((DATASIZE) == SPI_DATASIZE_28BIT) || \
986 ((DATASIZE) == SPI_DATASIZE_27BIT) || \
987 ((DATASIZE) == SPI_DATASIZE_26BIT) || \
988 ((DATASIZE) == SPI_DATASIZE_25BIT) || \
989 ((DATASIZE) == SPI_DATASIZE_24BIT) || \
990 ((DATASIZE) == SPI_DATASIZE_23BIT) || \
991 ((DATASIZE) == SPI_DATASIZE_22BIT) || \
992 ((DATASIZE) == SPI_DATASIZE_21BIT) || \
993 ((DATASIZE) == SPI_DATASIZE_20BIT) || \
994 ((DATASIZE) == SPI_DATASIZE_22BIT) || \
995 ((DATASIZE) == SPI_DATASIZE_19BIT) || \
996 ((DATASIZE) == SPI_DATASIZE_18BIT) || \
997 ((DATASIZE) == SPI_DATASIZE_17BIT) || \
998 ((DATASIZE) == SPI_DATASIZE_16BIT) || \
999 ((DATASIZE) == SPI_DATASIZE_15BIT) || \
1000 ((DATASIZE) == SPI_DATASIZE_14BIT) || \
1001 ((DATASIZE) == SPI_DATASIZE_13BIT) || \
1002 ((DATASIZE) == SPI_DATASIZE_12BIT) || \
1003 ((DATASIZE) == SPI_DATASIZE_11BIT) || \
1004 ((DATASIZE) == SPI_DATASIZE_10BIT) || \
1005 ((DATASIZE) == SPI_DATASIZE_9BIT) || \
1006 ((DATASIZE) == SPI_DATASIZE_8BIT) || \
1007 ((DATASIZE) == SPI_DATASIZE_7BIT) || \
1008 ((DATASIZE) == SPI_DATASIZE_6BIT) || \
1009 ((DATASIZE) == SPI_DATASIZE_5BIT) || \
1010 ((DATASIZE) == SPI_DATASIZE_4BIT))
1012#define IS_SPI_FIFOTHRESHOLD(THRESHOLD) (((THRESHOLD) == SPI_FIFO_THRESHOLD_01DATA) || \
1013 ((THRESHOLD) == SPI_FIFO_THRESHOLD_02DATA) || \
1014 ((THRESHOLD) == SPI_FIFO_THRESHOLD_03DATA) || \
1015 ((THRESHOLD) == SPI_FIFO_THRESHOLD_04DATA) || \
1016 ((THRESHOLD) == SPI_FIFO_THRESHOLD_05DATA) || \
1017 ((THRESHOLD) == SPI_FIFO_THRESHOLD_06DATA) || \
1018 ((THRESHOLD) == SPI_FIFO_THRESHOLD_07DATA) || \
1019 ((THRESHOLD) == SPI_FIFO_THRESHOLD_08DATA) || \
1020 ((THRESHOLD) == SPI_FIFO_THRESHOLD_09DATA) || \
1021 ((THRESHOLD) == SPI_FIFO_THRESHOLD_10DATA) || \
1022 ((THRESHOLD) == SPI_FIFO_THRESHOLD_11DATA) || \
1023 ((THRESHOLD) == SPI_FIFO_THRESHOLD_12DATA) || \
1024 ((THRESHOLD) == SPI_FIFO_THRESHOLD_13DATA) || \
1025 ((THRESHOLD) == SPI_FIFO_THRESHOLD_14DATA) || \
1026 ((THRESHOLD) == SPI_FIFO_THRESHOLD_15DATA) || \
1027 ((THRESHOLD) == SPI_FIFO_THRESHOLD_16DATA))
1029#define IS_SPI_CPOL(CPOL) (((CPOL) == SPI_POLARITY_LOW) || \
1030 ((CPOL) == SPI_POLARITY_HIGH))
1032#define IS_SPI_CPHA(CPHA) (((CPHA) == SPI_PHASE_1EDGE) || \
1033 ((CPHA) == SPI_PHASE_2EDGE))
1035#define IS_SPI_NSS(NSS) (((NSS) == SPI_NSS_SOFT) || \
1036 ((NSS) == SPI_NSS_HARD_INPUT) || \
1037 ((NSS) == SPI_NSS_HARD_OUTPUT))
1039#define IS_SPI_NSSP(NSSP) (((NSSP) == SPI_NSS_PULSE_ENABLE) || \
1040 ((NSSP) == SPI_NSS_PULSE_DISABLE))
1042#define IS_SPI_BAUDRATE_PRESCALER(PRESCALER) (((PRESCALER) == SPI_BAUDRATEPRESCALER_2) || \
1043 ((PRESCALER) == SPI_BAUDRATEPRESCALER_4) || \
1044 ((PRESCALER) == SPI_BAUDRATEPRESCALER_8) || \
1045 ((PRESCALER) == SPI_BAUDRATEPRESCALER_16) || \
1046 ((PRESCALER) == SPI_BAUDRATEPRESCALER_32) || \
1047 ((PRESCALER) == SPI_BAUDRATEPRESCALER_64) || \
1048 ((PRESCALER) == SPI_BAUDRATEPRESCALER_128) || \
1049 ((PRESCALER) == SPI_BAUDRATEPRESCALER_256))
1051#define IS_SPI_FIRST_BIT(BIT) (((BIT) == SPI_FIRSTBIT_MSB) || \
1052 ((BIT) == SPI_FIRSTBIT_LSB))
1054#define IS_SPI_TIMODE(MODE) (((MODE) == SPI_TIMODE_DISABLE) || \
1055 ((MODE) == SPI_TIMODE_ENABLE))
1057#define IS_SPI_CRC_CALCULATION(CALCULATION) (((CALCULATION) == SPI_CRCCALCULATION_DISABLE) || \
1058 ((CALCULATION) == SPI_CRCCALCULATION_ENABLE))
1060#define IS_SPI_CRC_INITIALIZATION_PATTERN(PATTERN) (((PATTERN) == SPI_CRC_INITIALIZATION_ALL_ZERO_PATTERN) || \
1061 ((PATTERN) == SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN))
1063#define IS_SPI_CRC_LENGTH(LENGTH) (((LENGTH) == SPI_CRC_LENGTH_DATASIZE) || \
1064 ((LENGTH) == SPI_CRC_LENGTH_32BIT) || \
1065 ((LENGTH) == SPI_CRC_LENGTH_31BIT) || \
1066 ((LENGTH) == SPI_CRC_LENGTH_30BIT) || \
1067 ((LENGTH) == SPI_CRC_LENGTH_29BIT) || \
1068 ((LENGTH) == SPI_CRC_LENGTH_28BIT) || \
1069 ((LENGTH) == SPI_CRC_LENGTH_27BIT) || \
1070 ((LENGTH) == SPI_CRC_LENGTH_26BIT) || \
1071 ((LENGTH) == SPI_CRC_LENGTH_25BIT) || \
1072 ((LENGTH) == SPI_CRC_LENGTH_24BIT) || \
1073 ((LENGTH) == SPI_CRC_LENGTH_23BIT) || \
1074 ((LENGTH) == SPI_CRC_LENGTH_22BIT) || \
1075 ((LENGTH) == SPI_CRC_LENGTH_21BIT) || \
1076 ((LENGTH) == SPI_CRC_LENGTH_20BIT) || \
1077 ((LENGTH) == SPI_CRC_LENGTH_19BIT) || \
1078 ((LENGTH) == SPI_CRC_LENGTH_18BIT) || \
1079 ((LENGTH) == SPI_CRC_LENGTH_17BIT) || \
1080 ((LENGTH) == SPI_CRC_LENGTH_16BIT) || \
1081 ((LENGTH) == SPI_CRC_LENGTH_15BIT) || \
1082 ((LENGTH) == SPI_CRC_LENGTH_14BIT) || \
1083 ((LENGTH) == SPI_CRC_LENGTH_13BIT) || \
1084 ((LENGTH) == SPI_CRC_LENGTH_12BIT) || \
1085 ((LENGTH) == SPI_CRC_LENGTH_11BIT) || \
1086 ((LENGTH) == SPI_CRC_LENGTH_10BIT) || \
1087 ((LENGTH) == SPI_CRC_LENGTH_9BIT) || \
1088 ((LENGTH) == SPI_CRC_LENGTH_8BIT) || \
1089 ((LENGTH) == SPI_CRC_LENGTH_7BIT) || \
1090 ((LENGTH) == SPI_CRC_LENGTH_6BIT) || \
1091 ((LENGTH) == SPI_CRC_LENGTH_5BIT) || \
1092 ((LENGTH) == SPI_CRC_LENGTH_4BIT))
1095#define IS_SPI_CRC_POLYNOMIAL(POLYNOMIAL) ((POLYNOMIAL) > 0x0UL)
1097#define IS_SPI_CRC_POLYNOMIAL_SIZE(POLYNOM, LENGTH) (((POLYNOM) >> (((LENGTH) >> SPI_CFG1_CRCSIZE_Pos) + 1UL)) == 0UL)
1100#define IS_SPI_UNDERRUN_DETECTION(MODE) (((MODE) == SPI_UNDERRUN_DETECT_BEGIN_DATA_FRAME) || \
1101 ((MODE) == SPI_UNDERRUN_DETECT_END_DATA_FRAME) || \
1102 ((MODE) == SPI_UNDERRUN_DETECT_BEGIN_ACTIVE_NSS))
1104#define IS_SPI_UNDERRUN_BEHAVIOUR(MODE) (((MODE) == SPI_UNDERRUN_BEHAV_REGISTER_PATTERN) || \
1105 ((MODE) == SPI_UNDERRUN_BEHAV_LAST_RECEIVED) || \
1106 ((MODE) == SPI_UNDERRUN_BEHAV_LAST_TRANSMITTED))
1108#define IS_SPI_MASTER_RX_AUTOSUSP(MODE) (((MODE) == SPI_MASTER_RX_AUTOSUSP_DISABLE) || \
1109 ((MODE) == SPI_MASTER_RX_AUTOSUSP_ENABLE))
#define __IO
Defines 'read / write' permissions.
struct __DMA_HandleTypeDef DMA_HandleTypeDef
DMA handle Structure definition.
void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi)
SPI MSP Initialization This function configures the hardware resources used in this example.
HAL_StatusTypeDef HAL_SPI_Init(SPI_HandleTypeDef *hspi)
void HAL_SPI_MspDeInit(SPI_HandleTypeDef *hspi)
SPI MSP De-Initialization This function freeze the hardware resources used in this example.
HAL_StatusTypeDef HAL_SPI_DeInit(SPI_HandleTypeDef *hspi)
void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi)
void HAL_SPI_SuspendCallback(SPI_HandleTypeDef *hspi)
void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_Abort(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(SPI_HandleTypeDef *hspi, const uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
void HAL_SPI_ErrorCallback(SPI_HandleTypeDef *hspi)
void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi)
void HAL_SPI_AbortCpltCallback(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_Receive_DMA(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
HAL_StatusTypeDef HAL_SPI_Abort_IT(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, const uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
void HAL_SPI_TxHalfCpltCallback(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_Transmit_IT(SPI_HandleTypeDef *hspi, const uint8_t *pData, uint16_t Size)
HAL_StatusTypeDef HAL_SPI_Receive_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
void HAL_SPI_TxRxHalfCpltCallback(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_Transmit_DMA(SPI_HandleTypeDef *hspi, const uint8_t *pData, uint16_t Size)
HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, const uint8_t *pData, uint16_t Size, uint32_t Timeout)
void HAL_SPI_RxHalfCpltCallback(SPI_HandleTypeDef *hspi)
void HAL_SPI_IRQHandler(SPI_HandleTypeDef *hspi)
HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(SPI_HandleTypeDef *hspi, const uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout)
HAL_SPI_StateTypeDef HAL_SPI_GetState(const SPI_HandleTypeDef *hspi)
uint32_t HAL_SPI_GetError(const SPI_HandleTypeDef *hspi)
HAL_SPI_StateTypeDef
HAL SPI State structure definition.
struct __SPI_HandleTypeDef SPI_HandleTypeDef
SPI handle Structure definition.
@ HAL_SPI_STATE_BUSY
an internal process is ongoing
@ HAL_SPI_STATE_ABORT
SPI abort is ongoing.
@ HAL_SPI_STATE_ERROR
SPI error state.
@ HAL_SPI_STATE_BUSY_TX
Data Transmission process is ongoing.
@ HAL_SPI_STATE_BUSY_TX_RX
Data Transmission and Reception process is ongoing.
@ HAL_SPI_STATE_READY
Peripheral Initialized and ready for use.
@ HAL_SPI_STATE_RESET
Peripheral not Initialized.
@ HAL_SPI_STATE_BUSY_RX
Data Reception process is ongoing.
This file contains HAL common defines, enumeration, macros and structures definitions.
HAL_StatusTypeDef
HAL Status structures definition.
HAL_LockTypeDef
HAL Lock structures definition.
Header file of SPI HAL Extended module.
SPI Configuration Structure definition.
uint32_t RxCRCInitializationPattern
Specifies the receiver CRC initialization Pattern used for the CRC calculation.
uint32_t MasterReceiverAutoSusp
Control continuous SPI transfer in master receiver mode and automatic management in order to avoid ov...
uint32_t MasterSSIdleness
Specifies an extra delay, expressed in number of SPI clock cycle periods, inserted additionally betwe...
uint32_t BaudRatePrescaler
Specifies the Baud Rate prescaler value which will be used to configure the transmit and receive SCK ...
uint32_t MasterKeepIOState
Control of Alternate function GPIOs state This parameter can be a value of Keep IO State.
uint32_t DataSize
Specifies the SPI data size.
uint32_t CRCCalculation
Specifies if the CRC calculation is enabled or not.
uint32_t Mode
Specifies the SPI operating mode.
uint32_t TIMode
Specifies if the TI mode is enabled or not.
uint32_t FifoThreshold
Specifies the FIFO threshold level.
uint32_t FirstBit
Specifies whether data transfers start from MSB or LSB bit.
uint32_t CLKPolarity
Specifies the serial clock steady state.
uint32_t MasterInterDataIdleness
Specifies minimum time delay (expressed in SPI clock cycles periods) inserted between two consecutive...
uint32_t NSSPMode
Specifies whether the NSSP signal is enabled or not .
uint32_t CLKPhase
Specifies the clock active edge for the bit capture.
uint32_t CRCPolynomial
Specifies the polynomial used for the CRC calculation.
uint32_t TxCRCInitializationPattern
Specifies the transmitter CRC initialization Pattern used for the CRC calculation.
uint32_t CRCLength
Specifies the CRC Length used for the CRC calculation.
uint32_t NSSPolarity
Specifies which level of SS input/output external signal (present on SS pin) is considered as active ...
uint32_t Direction
Specifies the SPI bidirectional mode state.
uint32_t NSS
Specifies whether the NSS signal is managed by hardware (NSS pin) or by software using the SSI bit.
uint32_t IOSwap
Invert MISO/MOSI alternate functions This parameter can be a value of Control SPI IO Swap.
Serial Peripheral Interface.
SPI handle Structure definition.
DMA_HandleTypeDef * hdmarx
SPI Rx DMA Handle parameters.
__IO uint16_t TxXferCount
SPI Tx Transfer Counter.
void(* TxISR)(struct __SPI_HandleTypeDef *hspi)
function pointer on Tx ISR
SPI_InitTypeDef Init
SPI communication parameters.
uint16_t TxXferSize
SPI Tx Transfer size.
void(* RxISR)(struct __SPI_HandleTypeDef *hspi)
function pointer on Rx ISR
__IO uint16_t RxXferCount
SPI Rx Transfer Counter.
SPI_TypeDef * Instance
SPI registers base address.
HAL_LockTypeDef Lock
Locking object.
DMA_HandleTypeDef * hdmatx
SPI Tx DMA Handle parameters.
__IO HAL_SPI_StateTypeDef State
SPI communication state.
uint8_t * pRxBuffPtr
Pointer to SPI Rx transfer Buffer.
const uint8_t * pTxBuffPtr
Pointer to SPI Tx transfer Buffer.
__IO uint32_t ErrorCode
SPI Error code.
uint16_t RxXferSize
SPI Rx Transfer size.
uint32_t CRCSize
SPI CRC size used for the transfer.