mbed-src - mbed library sources

Users » mbed_official » Code » mbed-src

mbed library sources

Dependents: Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import library mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_spi.h@610:813dcc80987e, 2015-08-14 (annotated)

Committer:: mbed_official
Date:: Fri Aug 14 13:15:17 2015 +0100
Revision:: 610:813dcc80987e
Parent:: 573:ad23fe03a082

Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599

Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/

DISCO_F746NG - Improvements

Who changed what in which revision?

User	Revision	Line number	New contents of line
mbed_official	573:ad23fe03a082	1	/**
mbed_official	573:ad23fe03a082	2	******************************************************************************
mbed_official	573:ad23fe03a082	3	* @file stm32f7xx_hal_spi.h
mbed_official	573:ad23fe03a082	4	* @author MCD Application Team
mbed_official	610:813dcc80987e	5	* @version V1.0.1
mbed_official	610:813dcc80987e	6	* @date 25-June-2015
mbed_official	573:ad23fe03a082	7	* @brief Header file of SPI HAL module.
mbed_official	573:ad23fe03a082	8	******************************************************************************
mbed_official	573:ad23fe03a082	9	* @attention
mbed_official	573:ad23fe03a082	10	*
mbed_official	573:ad23fe03a082	11	* <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official	573:ad23fe03a082	12	*
mbed_official	573:ad23fe03a082	13	* Redistribution and use in source and binary forms, with or without modification,
mbed_official	573:ad23fe03a082	14	* are permitted provided that the following conditions are met:
mbed_official	573:ad23fe03a082	15	* 1. Redistributions of source code must retain the above copyright notice,
mbed_official	573:ad23fe03a082	16	* this list of conditions and the following disclaimer.
mbed_official	573:ad23fe03a082	17	* 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official	573:ad23fe03a082	18	* this list of conditions and the following disclaimer in the documentation
mbed_official	573:ad23fe03a082	19	* and/or other materials provided with the distribution.
mbed_official	573:ad23fe03a082	20	* 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official	573:ad23fe03a082	21	* may be used to endorse or promote products derived from this software
mbed_official	573:ad23fe03a082	22	* without specific prior written permission.
mbed_official	573:ad23fe03a082	23	*
mbed_official	573:ad23fe03a082	24	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official	573:ad23fe03a082	25	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official	573:ad23fe03a082	26	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official	573:ad23fe03a082	27	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official	573:ad23fe03a082	28	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official	573:ad23fe03a082	29	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official	573:ad23fe03a082	30	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official	573:ad23fe03a082	31	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official	573:ad23fe03a082	32	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official	573:ad23fe03a082	33	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official	573:ad23fe03a082	34	*
mbed_official	573:ad23fe03a082	35	******************************************************************************
mbed_official	573:ad23fe03a082	36	*/
mbed_official	573:ad23fe03a082	37
mbed_official	573:ad23fe03a082	38	/* Define to prevent recursive inclusion -------------------------------------*/
mbed_official	573:ad23fe03a082	39	#ifndef __STM32F7xx_HAL_SPI_H
mbed_official	573:ad23fe03a082	40	#define __STM32F7xx_HAL_SPI_H
mbed_official	573:ad23fe03a082	41
mbed_official	573:ad23fe03a082	42	#ifdef __cplusplus
mbed_official	573:ad23fe03a082	43	extern "C" {
mbed_official	573:ad23fe03a082	44	#endif
mbed_official	573:ad23fe03a082	45
mbed_official	573:ad23fe03a082	46	/* Includes ------------------------------------------------------------------*/
mbed_official	573:ad23fe03a082	47	#include "stm32f7xx_hal_def.h"
mbed_official	573:ad23fe03a082	48
mbed_official	573:ad23fe03a082	49	/** @addtogroup STM32F7xx_HAL_Driver
mbed_official	573:ad23fe03a082	50	* @{
mbed_official	573:ad23fe03a082	51	*/
mbed_official	573:ad23fe03a082	52
mbed_official	573:ad23fe03a082	53	/** @addtogroup SPI
mbed_official	573:ad23fe03a082	54	* @{
mbed_official	573:ad23fe03a082	55	*/
mbed_official	573:ad23fe03a082	56
mbed_official	573:ad23fe03a082	57	/* Exported types ------------------------------------------------------------*/
mbed_official	573:ad23fe03a082	58	/** @defgroup SPI_Exported_Types SPI Exported Types
mbed_official	573:ad23fe03a082	59	* @{
mbed_official	573:ad23fe03a082	60	*/
mbed_official	573:ad23fe03a082	61
mbed_official	573:ad23fe03a082	62	/**
mbed_official	573:ad23fe03a082	63	* @brief SPI Configuration Structure definition
mbed_official	573:ad23fe03a082	64	*/
mbed_official	573:ad23fe03a082	65	typedef struct
mbed_official	573:ad23fe03a082	66	{
mbed_official	573:ad23fe03a082	67	uint32_t Mode; /*!< Specifies the SPI operating mode.
mbed_official	573:ad23fe03a082	68	This parameter can be a value of @ref SPI_Mode */
mbed_official	573:ad23fe03a082	69
mbed_official	573:ad23fe03a082	70	uint32_t Direction; /*!< Specifies the SPI bidirectional mode state.
mbed_official	573:ad23fe03a082	71	This parameter can be a value of @ref SPI_Direction */
mbed_official	573:ad23fe03a082	72
mbed_official	573:ad23fe03a082	73	uint32_t DataSize; /*!< Specifies the SPI data size.
mbed_official	573:ad23fe03a082	74	This parameter can be a value of @ref SPI_Data_Size */
mbed_official	573:ad23fe03a082	75
mbed_official	573:ad23fe03a082	76	uint32_t CLKPolarity; /*!< Specifies the serial clock steady state.
mbed_official	573:ad23fe03a082	77	This parameter can be a value of @ref SPI_Clock_Polarity */
mbed_official	573:ad23fe03a082	78
mbed_official	573:ad23fe03a082	79	uint32_t CLKPhase; /*!< Specifies the clock active edge for the bit capture.
mbed_official	573:ad23fe03a082	80	This parameter can be a value of @ref SPI_Clock_Phase */
mbed_official	573:ad23fe03a082	81
mbed_official	573:ad23fe03a082	82	uint32_t NSS; /*!< Specifies whether the NSS signal is managed by
mbed_official	573:ad23fe03a082	83	hardware (NSS pin) or by software using the SSI bit.
mbed_official	573:ad23fe03a082	84	This parameter can be a value of @ref SPI_Slave_Select_management */
mbed_official	573:ad23fe03a082	85
mbed_official	573:ad23fe03a082	86	uint32_t BaudRatePrescaler; /*!< Specifies the Baud Rate prescaler value which will be
mbed_official	573:ad23fe03a082	87	used to configure the transmit and receive SCK clock.
mbed_official	573:ad23fe03a082	88	This parameter can be a value of @ref SPI_BaudRate_Prescaler
mbed_official	573:ad23fe03a082	89	@note The communication clock is derived from the master
mbed_official	573:ad23fe03a082	90	clock. The slave clock does not need to be set. */
mbed_official	573:ad23fe03a082	91
mbed_official	573:ad23fe03a082	92	uint32_t FirstBit; /*!< Specifies whether data transfers start from MSB or LSB bit.
mbed_official	573:ad23fe03a082	93	This parameter can be a value of @ref SPI_MSB_LSB_transmission */
mbed_official	573:ad23fe03a082	94
mbed_official	573:ad23fe03a082	95	uint32_t TIMode; /*!< Specifies if the TI mode is enabled or not .
mbed_official	573:ad23fe03a082	96	This parameter can be a value of @ref SPI_TI_mode */
mbed_official	573:ad23fe03a082	97
mbed_official	573:ad23fe03a082	98	uint32_t CRCCalculation; /*!< Specifies if the CRC calculation is enabled or not.
mbed_official	573:ad23fe03a082	99	This parameter can be a value of @ref SPI_CRC_Calculation */
mbed_official	573:ad23fe03a082	100
mbed_official	573:ad23fe03a082	101	uint32_t CRCPolynomial; /*!< Specifies the polynomial used for the CRC calculation.
mbed_official	573:ad23fe03a082	102	This parameter must be a number between Min_Data = 0 and Max_Data = 65535 */
mbed_official	573:ad23fe03a082	103
mbed_official	573:ad23fe03a082	104	uint32_t CRCLength; /*!< Specifies the CRC Length used for the CRC calculation.
mbed_official	573:ad23fe03a082	105	CRC Length is only used with Data8 and Data16, not other data size
mbed_official	573:ad23fe03a082	106	This parameter can be a value of @ref SPI_CRC_length */
mbed_official	573:ad23fe03a082	107
mbed_official	573:ad23fe03a082	108	uint32_t NSSPMode; /*!< Specifies whether the NSSP signal is enabled or not .
mbed_official	573:ad23fe03a082	109	This parameter can be a value of @ref SPI_NSSP_Mode
mbed_official	573:ad23fe03a082	110	This mode is activated by the NSSP bit in the SPIx_CR2 register and
mbed_official	573:ad23fe03a082	111	it takes effect only if the SPI interface is configured as Motorola SPI
mbed_official	573:ad23fe03a082	112	master (FRF=0) with capture on the first edge (SPIx_CR1 CPHA = 0,
mbed_official	573:ad23fe03a082	113	CPOL setting is ignored).. */
mbed_official	573:ad23fe03a082	114	} SPI_InitTypeDef;
mbed_official	573:ad23fe03a082	115
mbed_official	573:ad23fe03a082	116	/**
mbed_official	573:ad23fe03a082	117	* @brief HAL State structures definition
mbed_official	573:ad23fe03a082	118	*/
mbed_official	573:ad23fe03a082	119	typedef enum
mbed_official	573:ad23fe03a082	120	{
mbed_official	573:ad23fe03a082	121	HAL_SPI_STATE_RESET = 0x00, /!< Peripheral not Initialized /
mbed_official	573:ad23fe03a082	122	HAL_SPI_STATE_READY = 0x01, /!< Peripheral Initialized and ready for use /
mbed_official	573:ad23fe03a082	123	HAL_SPI_STATE_BUSY = 0x02, /!< an internal process is ongoing /
mbed_official	573:ad23fe03a082	124	HAL_SPI_STATE_BUSY_TX = 0x03, /!< Data Transmission process is ongoing /
mbed_official	573:ad23fe03a082	125	HAL_SPI_STATE_BUSY_RX = 0x04, /!< Data Reception process is ongoing /
mbed_official	573:ad23fe03a082	126	HAL_SPI_STATE_BUSY_TX_RX = 0x05, /!< Data Transmission and Reception process is ongoing/
mbed_official	573:ad23fe03a082	127	HAL_SPI_STATE_ERROR = 0x06 /!< SPI error state /
mbed_official	573:ad23fe03a082	128	}HAL_SPI_StateTypeDef;
mbed_official	573:ad23fe03a082	129
mbed_official	573:ad23fe03a082	130	/**
mbed_official	573:ad23fe03a082	131	* @brief SPI handle Structure definition
mbed_official	573:ad23fe03a082	132	*/
mbed_official	573:ad23fe03a082	133	typedef struct __SPI_HandleTypeDef
mbed_official	573:ad23fe03a082	134	{
mbed_official	573:ad23fe03a082	135	SPI_TypeDef Instance; / SPI registers base address */
mbed_official	573:ad23fe03a082	136
mbed_official	573:ad23fe03a082	137	SPI_InitTypeDef Init; /* SPI communication parameters */
mbed_official	573:ad23fe03a082	138
mbed_official	573:ad23fe03a082	139	uint8_t pTxBuffPtr; / Pointer to SPI Tx transfer Buffer */
mbed_official	573:ad23fe03a082	140
mbed_official	573:ad23fe03a082	141	uint16_t TxXferSize; /* SPI Tx Transfer size */
mbed_official	573:ad23fe03a082	142
mbed_official	573:ad23fe03a082	143	uint16_t TxXferCount; /* SPI Tx Transfer Counter */
mbed_official	573:ad23fe03a082	144
mbed_official	573:ad23fe03a082	145	uint8_t pRxBuffPtr; / Pointer to SPI Rx transfer Buffer */
mbed_official	573:ad23fe03a082	146
mbed_official	573:ad23fe03a082	147	uint16_t RxXferSize; /* SPI Rx Transfer size */
mbed_official	573:ad23fe03a082	148
mbed_official	573:ad23fe03a082	149	uint16_t RxXferCount; /* SPI Rx Transfer Counter */
mbed_official	573:ad23fe03a082	150
mbed_official	573:ad23fe03a082	151	uint32_t CRCSize; /* SPI CRC size used for the transfer */
mbed_official	573:ad23fe03a082	152
mbed_official	573:ad23fe03a082	153	void (RxISR)(struct __SPI_HandleTypeDef hspi); /* function pointer on Rx IRQ handler */
mbed_official	573:ad23fe03a082	154
mbed_official	573:ad23fe03a082	155	void (TxISR)(struct __SPI_HandleTypeDef hspi); /* function pointer on Tx IRQ handler */
mbed_official	573:ad23fe03a082	156
mbed_official	573:ad23fe03a082	157	DMA_HandleTypeDef hdmatx; / SPI Tx DMA Handle parameters */
mbed_official	573:ad23fe03a082	158
mbed_official	573:ad23fe03a082	159	DMA_HandleTypeDef hdmarx; / SPI Rx DMA Handle parameters */
mbed_official	573:ad23fe03a082	160
mbed_official	573:ad23fe03a082	161	HAL_LockTypeDef Lock; /* Locking object */
mbed_official	573:ad23fe03a082	162
mbed_official	573:ad23fe03a082	163	HAL_SPI_StateTypeDef State; /* SPI communication state */
mbed_official	573:ad23fe03a082	164
mbed_official	573:ad23fe03a082	165	uint32_t ErrorCode; /* SPI Error code */
mbed_official	573:ad23fe03a082	166
mbed_official	573:ad23fe03a082	167	}SPI_HandleTypeDef;
mbed_official	573:ad23fe03a082	168
mbed_official	573:ad23fe03a082	169	/**
mbed_official	573:ad23fe03a082	170	* @}
mbed_official	573:ad23fe03a082	171	*/
mbed_official	573:ad23fe03a082	172
mbed_official	573:ad23fe03a082	173	/* Exported constants --------------------------------------------------------*/
mbed_official	573:ad23fe03a082	174
mbed_official	573:ad23fe03a082	175	/** @defgroup SPI_Exported_Constants SPI Exported Constants
mbed_official	573:ad23fe03a082	176	* @{
mbed_official	573:ad23fe03a082	177	*/
mbed_official	573:ad23fe03a082	178
mbed_official	573:ad23fe03a082	179	/** @defgroup SPI_Error_Code SPI Error Code
mbed_official	573:ad23fe03a082	180	* @{
mbed_official	573:ad23fe03a082	181	*/
mbed_official	573:ad23fe03a082	182	#define HAL_SPI_ERROR_NONE (uint32_t)0x00000000 /!< No error /
mbed_official	573:ad23fe03a082	183	#define HAL_SPI_ERROR_MODF (uint32_t)0x00000001 /!< MODF error /
mbed_official	573:ad23fe03a082	184	#define HAL_SPI_ERROR_CRC (uint32_t)0x00000002 /!< CRC error /
mbed_official	573:ad23fe03a082	185	#define HAL_SPI_ERROR_OVR (uint32_t)0x00000004 /!< OVR error /
mbed_official	573:ad23fe03a082	186	#define HAL_SPI_ERROR_FRE (uint32_t)0x00000008 /!< FRE error /
mbed_official	573:ad23fe03a082	187	#define HAL_SPI_ERROR_DMA (uint32_t)0x00000010 /!< DMA transfer error /
mbed_official	573:ad23fe03a082	188	#define HAL_SPI_ERROR_FLAG (uint32_t)0x00000020 /!< Error on BSY/TXE/FTLVL/FRLVL Flag /
mbed_official	573:ad23fe03a082	189	#define HAL_SPI_ERROR_UNKNOW (uint32_t)0x00000040 /!< Unknow Error error /
mbed_official	573:ad23fe03a082	190	/**
mbed_official	573:ad23fe03a082	191	* @}
mbed_official	573:ad23fe03a082	192	*/
mbed_official	573:ad23fe03a082	193
mbed_official	573:ad23fe03a082	194
mbed_official	573:ad23fe03a082	195	/** @defgroup SPI_Mode SPI Mode
mbed_official	573:ad23fe03a082	196	* @{
mbed_official	573:ad23fe03a082	197	*/
mbed_official	573:ad23fe03a082	198	#define SPI_MODE_SLAVE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	199	#define SPI_MODE_MASTER (SPI_CR1_MSTR \| SPI_CR1_SSI)
mbed_official	573:ad23fe03a082	200	/**
mbed_official	573:ad23fe03a082	201	* @}
mbed_official	573:ad23fe03a082	202	*/
mbed_official	573:ad23fe03a082	203
mbed_official	573:ad23fe03a082	204	/** @defgroup SPI_Direction SPI Direction Mode
mbed_official	573:ad23fe03a082	205	* @{
mbed_official	573:ad23fe03a082	206	*/
mbed_official	573:ad23fe03a082	207	#define SPI_DIRECTION_2LINES ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	208	#define SPI_DIRECTION_2LINES_RXONLY SPI_CR1_RXONLY
mbed_official	573:ad23fe03a082	209	#define SPI_DIRECTION_1LINE SPI_CR1_BIDIMODE
mbed_official	573:ad23fe03a082	210	/**
mbed_official	573:ad23fe03a082	211	* @}
mbed_official	573:ad23fe03a082	212	*/
mbed_official	573:ad23fe03a082	213
mbed_official	573:ad23fe03a082	214	/** @defgroup SPI_Data_Size SPI Data Size
mbed_official	573:ad23fe03a082	215	* @{
mbed_official	573:ad23fe03a082	216	*/
mbed_official	573:ad23fe03a082	217	#define SPI_DATASIZE_4BIT ((uint32_t)0x0300)
mbed_official	573:ad23fe03a082	218	#define SPI_DATASIZE_5BIT ((uint32_t)0x0400)
mbed_official	573:ad23fe03a082	219	#define SPI_DATASIZE_6BIT ((uint32_t)0x0500)
mbed_official	573:ad23fe03a082	220	#define SPI_DATASIZE_7BIT ((uint32_t)0x0600)
mbed_official	573:ad23fe03a082	221	#define SPI_DATASIZE_8BIT ((uint32_t)0x0700)
mbed_official	573:ad23fe03a082	222	#define SPI_DATASIZE_9BIT ((uint32_t)0x0800)
mbed_official	573:ad23fe03a082	223	#define SPI_DATASIZE_10BIT ((uint32_t)0x0900)
mbed_official	573:ad23fe03a082	224	#define SPI_DATASIZE_11BIT ((uint32_t)0x0A00)
mbed_official	573:ad23fe03a082	225	#define SPI_DATASIZE_12BIT ((uint32_t)0x0B00)
mbed_official	573:ad23fe03a082	226	#define SPI_DATASIZE_13BIT ((uint32_t)0x0C00)
mbed_official	573:ad23fe03a082	227	#define SPI_DATASIZE_14BIT ((uint32_t)0x0D00)
mbed_official	573:ad23fe03a082	228	#define SPI_DATASIZE_15BIT ((uint32_t)0x0E00)
mbed_official	573:ad23fe03a082	229	#define SPI_DATASIZE_16BIT ((uint32_t)0x0F00)
mbed_official	573:ad23fe03a082	230	/**
mbed_official	573:ad23fe03a082	231	* @}
mbed_official	573:ad23fe03a082	232	*/
mbed_official	573:ad23fe03a082	233
mbed_official	573:ad23fe03a082	234	/** @defgroup SPI_Clock_Polarity SPI Clock Polarity
mbed_official	573:ad23fe03a082	235	* @{
mbed_official	573:ad23fe03a082	236	*/
mbed_official	573:ad23fe03a082	237	#define SPI_POLARITY_LOW ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	238	#define SPI_POLARITY_HIGH SPI_CR1_CPOL
mbed_official	573:ad23fe03a082	239	/**
mbed_official	573:ad23fe03a082	240	* @}
mbed_official	573:ad23fe03a082	241	*/
mbed_official	573:ad23fe03a082	242
mbed_official	573:ad23fe03a082	243	/** @defgroup SPI_Clock_Phase SPI Clock Phase
mbed_official	573:ad23fe03a082	244	* @{
mbed_official	573:ad23fe03a082	245	*/
mbed_official	573:ad23fe03a082	246	#define SPI_PHASE_1EDGE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	247	#define SPI_PHASE_2EDGE SPI_CR1_CPHA
mbed_official	573:ad23fe03a082	248	/**
mbed_official	573:ad23fe03a082	249	* @}
mbed_official	573:ad23fe03a082	250	*/
mbed_official	573:ad23fe03a082	251
mbed_official	573:ad23fe03a082	252	/** @defgroup SPI_Slave_Select_management SPI Slave Select management
mbed_official	573:ad23fe03a082	253	* @{
mbed_official	573:ad23fe03a082	254	*/
mbed_official	573:ad23fe03a082	255	#define SPI_NSS_SOFT SPI_CR1_SSM
mbed_official	573:ad23fe03a082	256	#define SPI_NSS_HARD_INPUT ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	257	#define SPI_NSS_HARD_OUTPUT ((uint32_t)0x00040000)
mbed_official	573:ad23fe03a082	258	/**
mbed_official	573:ad23fe03a082	259	* @}
mbed_official	573:ad23fe03a082	260	*/
mbed_official	573:ad23fe03a082	261
mbed_official	573:ad23fe03a082	262	/** @defgroup SPI_NSSP_Mode SPI NSS Pulse Mode
mbed_official	573:ad23fe03a082	263	* @{
mbed_official	573:ad23fe03a082	264	*/
mbed_official	573:ad23fe03a082	265	#define SPI_NSS_PULSE_ENABLE SPI_CR2_NSSP
mbed_official	573:ad23fe03a082	266	#define SPI_NSS_PULSE_DISABLE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	267	/**
mbed_official	573:ad23fe03a082	268	* @}
mbed_official	573:ad23fe03a082	269	*/
mbed_official	573:ad23fe03a082	270
mbed_official	573:ad23fe03a082	271	/** @defgroup SPI_BaudRate_Prescaler SPI BaudRate Prescaler
mbed_official	573:ad23fe03a082	272	* @{
mbed_official	573:ad23fe03a082	273	*/
mbed_official	573:ad23fe03a082	274	#define SPI_BAUDRATEPRESCALER_2 ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	275	#define SPI_BAUDRATEPRESCALER_4 ((uint32_t)0x00000008)
mbed_official	573:ad23fe03a082	276	#define SPI_BAUDRATEPRESCALER_8 ((uint32_t)0x00000010)
mbed_official	573:ad23fe03a082	277	#define SPI_BAUDRATEPRESCALER_16 ((uint32_t)0x00000018)
mbed_official	573:ad23fe03a082	278	#define SPI_BAUDRATEPRESCALER_32 ((uint32_t)0x00000020)
mbed_official	573:ad23fe03a082	279	#define SPI_BAUDRATEPRESCALER_64 ((uint32_t)0x00000028)
mbed_official	573:ad23fe03a082	280	#define SPI_BAUDRATEPRESCALER_128 ((uint32_t)0x00000030)
mbed_official	573:ad23fe03a082	281	#define SPI_BAUDRATEPRESCALER_256 ((uint32_t)0x00000038)
mbed_official	573:ad23fe03a082	282	/**
mbed_official	573:ad23fe03a082	283	* @}
mbed_official	573:ad23fe03a082	284	*/
mbed_official	573:ad23fe03a082	285
mbed_official	573:ad23fe03a082	286	/** @defgroup SPI_MSB_LSB_transmission SPI MSB LSB transmission
mbed_official	573:ad23fe03a082	287	* @{
mbed_official	573:ad23fe03a082	288	*/
mbed_official	573:ad23fe03a082	289	#define SPI_FIRSTBIT_MSB ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	290	#define SPI_FIRSTBIT_LSB SPI_CR1_LSBFIRST
mbed_official	573:ad23fe03a082	291	/**
mbed_official	573:ad23fe03a082	292	* @}
mbed_official	573:ad23fe03a082	293	*/
mbed_official	573:ad23fe03a082	294
mbed_official	573:ad23fe03a082	295	/** @defgroup SPI_TI_mode SPI TI mode
mbed_official	573:ad23fe03a082	296	* @{
mbed_official	573:ad23fe03a082	297	*/
mbed_official	573:ad23fe03a082	298	#define SPI_TIMODE_DISABLE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	299	#define SPI_TIMODE_ENABLE SPI_CR2_FRF
mbed_official	573:ad23fe03a082	300	/**
mbed_official	573:ad23fe03a082	301	* @}
mbed_official	573:ad23fe03a082	302	*/
mbed_official	573:ad23fe03a082	303
mbed_official	573:ad23fe03a082	304	/** @defgroup SPI_CRC_Calculation SPI CRC Calculation
mbed_official	573:ad23fe03a082	305	* @{
mbed_official	573:ad23fe03a082	306	*/
mbed_official	573:ad23fe03a082	307	#define SPI_CRCCALCULATION_DISABLE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	308	#define SPI_CRCCALCULATION_ENABLE SPI_CR1_CRCEN
mbed_official	573:ad23fe03a082	309	/**
mbed_official	573:ad23fe03a082	310	* @}
mbed_official	573:ad23fe03a082	311	*/
mbed_official	573:ad23fe03a082	312
mbed_official	573:ad23fe03a082	313	/** @defgroup SPI_CRC_length SPI CRC Length
mbed_official	573:ad23fe03a082	314	* @{
mbed_official	573:ad23fe03a082	315	* This parameter can be one of the following values:
mbed_official	573:ad23fe03a082	316	* SPI_CRC_LENGTH_DATASIZE: aligned with the data size
mbed_official	573:ad23fe03a082	317	* SPI_CRC_LENGTH_8BIT : CRC 8bit
mbed_official	573:ad23fe03a082	318	* SPI_CRC_LENGTH_16BIT : CRC 16bit
mbed_official	573:ad23fe03a082	319	*/
mbed_official	573:ad23fe03a082	320	#define SPI_CRC_LENGTH_DATASIZE ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	321	#define SPI_CRC_LENGTH_8BIT ((uint32_t)0x00000001)
mbed_official	573:ad23fe03a082	322	#define SPI_CRC_LENGTH_16BIT ((uint32_t)0x00000002)
mbed_official	573:ad23fe03a082	323	/**
mbed_official	573:ad23fe03a082	324	* @}
mbed_official	573:ad23fe03a082	325	*/
mbed_official	573:ad23fe03a082	326
mbed_official	573:ad23fe03a082	327	/** @defgroup SPI_FIFO_reception_threshold SPI FIFO Reception Threshold
mbed_official	573:ad23fe03a082	328	* @{
mbed_official	573:ad23fe03a082	329	* This parameter can be one of the following values:
mbed_official	573:ad23fe03a082	330	* SPI_RXFIFO_THRESHOLD or SPI_RXFIFO_THRESHOLD_QF :
mbed_official	573:ad23fe03a082	331	* RXNE event is generated if the FIFO
mbed_official	573:ad23fe03a082	332	* level is greater or equal to 1/2(16-bits).
mbed_official	573:ad23fe03a082	333	* SPI_RXFIFO_THRESHOLD_HF: RXNE event is generated if the FIFO
mbed_official	573:ad23fe03a082	334	* level is greater or equal to 1/4(8 bits). */
mbed_official	573:ad23fe03a082	335	#define SPI_RXFIFO_THRESHOLD SPI_CR2_FRXTH
mbed_official	573:ad23fe03a082	336	#define SPI_RXFIFO_THRESHOLD_QF SPI_CR2_FRXTH
mbed_official	573:ad23fe03a082	337	#define SPI_RXFIFO_THRESHOLD_HF ((uint32_t)0x00000000)
mbed_official	573:ad23fe03a082	338
mbed_official	573:ad23fe03a082	339	/**
mbed_official	573:ad23fe03a082	340	* @}
mbed_official	573:ad23fe03a082	341	*/
mbed_official	573:ad23fe03a082	342
mbed_official	573:ad23fe03a082	343	/** @defgroup SPI_Interrupt_configuration_definition SPI Interrupt configuration definition
mbed_official	573:ad23fe03a082	344	* @brief SPI Interrupt definition
mbed_official	573:ad23fe03a082	345	* Elements values convention: 0xXXXXXXXX
mbed_official	573:ad23fe03a082	346	* - XXXXXXXX : Interrupt control mask
mbed_official	573:ad23fe03a082	347	* @{
mbed_official	573:ad23fe03a082	348	*/
mbed_official	573:ad23fe03a082	349	#define SPI_IT_TXE SPI_CR2_TXEIE
mbed_official	573:ad23fe03a082	350	#define SPI_IT_RXNE SPI_CR2_RXNEIE
mbed_official	573:ad23fe03a082	351	#define SPI_IT_ERR SPI_CR2_ERRIE
mbed_official	573:ad23fe03a082	352	/**
mbed_official	573:ad23fe03a082	353	* @}
mbed_official	573:ad23fe03a082	354	*/
mbed_official	573:ad23fe03a082	355
mbed_official	573:ad23fe03a082	356
mbed_official	573:ad23fe03a082	357	/** @defgroup SPI_Flag_definition SPI Flag definition
mbed_official	573:ad23fe03a082	358	* @brief Flag definition
mbed_official	573:ad23fe03a082	359	* Elements values convention: 0xXXXXYYYY
mbed_official	573:ad23fe03a082	360	* - XXXX : Flag register Index
mbed_official	573:ad23fe03a082	361	* - YYYY : Flag mask
mbed_official	573:ad23fe03a082	362	* @{
mbed_official	573:ad23fe03a082	363	*/
mbed_official	573:ad23fe03a082	364	#define SPI_FLAG_RXNE SPI_SR_RXNE /* SPI status flag: Rx buffer not empty flag */
mbed_official	573:ad23fe03a082	365	#define SPI_FLAG_TXE SPI_SR_TXE /* SPI status flag: Tx buffer empty flag */
mbed_official	573:ad23fe03a082	366	#define SPI_FLAG_BSY SPI_SR_BSY /* SPI status flag: Busy flag */
mbed_official	573:ad23fe03a082	367	#define SPI_FLAG_CRCERR SPI_SR_CRCERR /* SPI Error flag: CRC error flag */
mbed_official	573:ad23fe03a082	368	#define SPI_FLAG_MODF SPI_SR_MODF /* SPI Error flag: Mode fault flag */
mbed_official	573:ad23fe03a082	369	#define SPI_FLAG_OVR SPI_SR_OVR /* SPI Error flag: Overrun flag */
mbed_official	573:ad23fe03a082	370	#define SPI_FLAG_FRE SPI_SR_FRE /* SPI Error flag: TI mode frame format error flag */
mbed_official	573:ad23fe03a082	371	#define SPI_FLAG_FTLVL SPI_SR_FTLVL /* SPI fifo transmission level */
mbed_official	573:ad23fe03a082	372	#define SPI_FLAG_FRLVL SPI_SR_FRLVL /* SPI fifo reception level */
mbed_official	573:ad23fe03a082	373	/**
mbed_official	573:ad23fe03a082	374	* @}
mbed_official	573:ad23fe03a082	375	*/
mbed_official	573:ad23fe03a082	376
mbed_official	573:ad23fe03a082	377	/** @defgroup SPI_transmission_fifo_status_level SPI Transmission FIFO Status Level
mbed_official	573:ad23fe03a082	378	* @{
mbed_official	573:ad23fe03a082	379	*/
mbed_official	573:ad23fe03a082	380	#define SPI_FTLVL_EMPTY ((uint32_t)0x0000)
mbed_official	573:ad23fe03a082	381	#define SPI_FTLVL_QUARTER_FULL ((uint32_t)0x0800)
mbed_official	573:ad23fe03a082	382	#define SPI_FTLVL_HALF_FULL ((uint32_t)0x1000)
mbed_official	573:ad23fe03a082	383	#define SPI_FTLVL_FULL ((uint32_t)0x1800)
mbed_official	573:ad23fe03a082	384
mbed_official	573:ad23fe03a082	385	/**
mbed_official	573:ad23fe03a082	386	* @}
mbed_official	573:ad23fe03a082	387	*/
mbed_official	573:ad23fe03a082	388
mbed_official	573:ad23fe03a082	389	/** @defgroup SPI_reception_fifo_status_level SPI Reception FIFO Status Level
mbed_official	573:ad23fe03a082	390	* @{
mbed_official	573:ad23fe03a082	391	*/
mbed_official	573:ad23fe03a082	392	#define SPI_FRLVL_EMPTY ((uint32_t)0x0000)
mbed_official	573:ad23fe03a082	393	#define SPI_FRLVL_QUARTER_FULL ((uint32_t)0x0200)
mbed_official	573:ad23fe03a082	394	#define SPI_FRLVL_HALF_FULL ((uint32_t)0x0400)
mbed_official	573:ad23fe03a082	395	#define SPI_FRLVL_FULL ((uint32_t)0x0600)
mbed_official	573:ad23fe03a082	396	/**
mbed_official	573:ad23fe03a082	397	* @}
mbed_official	573:ad23fe03a082	398	*/
mbed_official	573:ad23fe03a082	399
mbed_official	573:ad23fe03a082	400	/**
mbed_official	573:ad23fe03a082	401	* @}
mbed_official	573:ad23fe03a082	402	*/
mbed_official	573:ad23fe03a082	403
mbed_official	573:ad23fe03a082	404	/* Exported macros ------------------------------------------------------------*/
mbed_official	573:ad23fe03a082	405	/** @defgroup SPI_Exported_Macros SPI Exported Macros
mbed_official	573:ad23fe03a082	406	* @{
mbed_official	573:ad23fe03a082	407	*/
mbed_official	573:ad23fe03a082	408
mbed_official	573:ad23fe03a082	409	/** @brief Reset SPI handle state
mbed_official	573:ad23fe03a082	410	* @param __HANDLE__: SPI handle.
mbed_official	573:ad23fe03a082	411	* @retval None
mbed_official	573:ad23fe03a082	412	*/
mbed_official	573:ad23fe03a082	413	#define __HAL_SPI_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SPI_STATE_RESET)
mbed_official	573:ad23fe03a082	414
mbed_official	573:ad23fe03a082	415	/** @brief Enables or disables the specified SPI interrupts.
mbed_official	573:ad23fe03a082	416	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	417	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	418	* @param __INTERRUPT__ : specifies the interrupt source to enable or disable.
mbed_official	573:ad23fe03a082	419	* This parameter can be one of the following values:
mbed_official	573:ad23fe03a082	420	* @arg SPI_IT_TXE: Tx buffer empty interrupt enable
mbed_official	573:ad23fe03a082	421	* @arg SPI_IT_RXNE: RX buffer not empty interrupt enable
mbed_official	573:ad23fe03a082	422	* @arg SPI_IT_ERR: Error interrupt enable
mbed_official	573:ad23fe03a082	423	* @retval None
mbed_official	573:ad23fe03a082	424	*/
mbed_official	573:ad23fe03a082	425	#define __HAL_SPI_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR2 \|= (__INTERRUPT__))
mbed_official	573:ad23fe03a082	426	#define __HAL_SPI_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR2 &= (~(__INTERRUPT__)))
mbed_official	573:ad23fe03a082	427
mbed_official	573:ad23fe03a082	428	/** @brief Checks if the specified SPI interrupt source is enabled or disabled.
mbed_official	573:ad23fe03a082	429	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	430	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	431	* @param __INTERRUPT__ : specifies the SPI interrupt source to check.
mbed_official	573:ad23fe03a082	432	* This parameter can be one of the following values:
mbed_official	573:ad23fe03a082	433	* @arg SPI_IT_TXE: Tx buffer empty interrupt enable
mbed_official	573:ad23fe03a082	434	* @arg SPI_IT_RXNE: RX buffer not empty interrupt enable
mbed_official	573:ad23fe03a082	435	* @arg SPI_IT_ERR: Error interrupt enable
mbed_official	573:ad23fe03a082	436	* @retval The new state of __IT__ (TRUE or FALSE).
mbed_official	573:ad23fe03a082	437	*/
mbed_official	573:ad23fe03a082	438	#define __HAL_SPI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR2 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
mbed_official	573:ad23fe03a082	439
mbed_official	573:ad23fe03a082	440	/** @brief Checks whether the specified SPI flag is set or not.
mbed_official	573:ad23fe03a082	441	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	442	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	443	* @param __FLAG__ : specifies the flag to check.
mbed_official	573:ad23fe03a082	444	* This parameter can be one of the following values:
mbed_official	573:ad23fe03a082	445	* @arg SPI_FLAG_RXNE: Receive buffer not empty flag
mbed_official	573:ad23fe03a082	446	* @arg SPI_FLAG_TXE: Transmit buffer empty flag
mbed_official	573:ad23fe03a082	447	* @arg SPI_FLAG_CRCERR: CRC error flag
mbed_official	573:ad23fe03a082	448	* @arg SPI_FLAG_MODF: Mode fault flag
mbed_official	573:ad23fe03a082	449	* @arg SPI_FLAG_OVR: Overrun flag
mbed_official	573:ad23fe03a082	450	* @arg SPI_FLAG_BSY: Busy flag
mbed_official	573:ad23fe03a082	451	* @arg SPI_FLAG_FRE: Frame format error flag
mbed_official	573:ad23fe03a082	452	* @arg SPI_FLAG_FTLVL: SPI fifo transmission level
mbed_official	573:ad23fe03a082	453	* @arg SPI_FLAG_FRLVL: SPI fifo reception level
mbed_official	573:ad23fe03a082	454	* @retval The new state of __FLAG__ (TRUE or FALSE).
mbed_official	573:ad23fe03a082	455	*/
mbed_official	573:ad23fe03a082	456	#define __HAL_SPI_GET_FLAG(__HANDLE__, __FLAG__) ((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__))
mbed_official	573:ad23fe03a082	457
mbed_official	573:ad23fe03a082	458	/** @brief Clears the SPI CRCERR pending flag.
mbed_official	573:ad23fe03a082	459	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	460	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	461	* @retval None
mbed_official	573:ad23fe03a082	462	*/
mbed_official	573:ad23fe03a082	463	#define __HAL_SPI_CLEAR_CRCERRFLAG(__HANDLE__) ((__HANDLE__)->Instance->SR = (uint16_t)(~SPI_FLAG_CRCERR))
mbed_official	573:ad23fe03a082	464
mbed_official	573:ad23fe03a082	465	/** @brief Clears the SPI MODF pending flag.
mbed_official	573:ad23fe03a082	466	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	467	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	468	*
mbed_official	573:ad23fe03a082	469	* @retval None
mbed_official	573:ad23fe03a082	470	*/
mbed_official	573:ad23fe03a082	471	#define __HAL_SPI_CLEAR_MODFFLAG(__HANDLE__) \
mbed_official	573:ad23fe03a082	472	do{ \
mbed_official	573:ad23fe03a082	473	__IO uint32_t tmpreg; \
mbed_official	573:ad23fe03a082	474	tmpreg = (__HANDLE__)->Instance->SR; \
mbed_official	573:ad23fe03a082	475	(__HANDLE__)->Instance->CR1 &= (~SPI_CR1_SPE); \
mbed_official	573:ad23fe03a082	476	UNUSED(tmpreg); \
mbed_official	573:ad23fe03a082	477	} while(0)
mbed_official	573:ad23fe03a082	478
mbed_official	573:ad23fe03a082	479	/** @brief Clears the SPI OVR pending flag.
mbed_official	573:ad23fe03a082	480	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	481	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	482	*
mbed_official	573:ad23fe03a082	483	* @retval None
mbed_official	573:ad23fe03a082	484	*/
mbed_official	573:ad23fe03a082	485	#define __HAL_SPI_CLEAR_OVRFLAG(__HANDLE__) \
mbed_official	573:ad23fe03a082	486	do{ \
mbed_official	573:ad23fe03a082	487	__IO uint32_t tmpreg; \
mbed_official	573:ad23fe03a082	488	tmpreg = (__HANDLE__)->Instance->DR; \
mbed_official	573:ad23fe03a082	489	tmpreg = (__HANDLE__)->Instance->SR; \
mbed_official	573:ad23fe03a082	490	UNUSED(tmpreg); \
mbed_official	573:ad23fe03a082	491	} while(0)
mbed_official	573:ad23fe03a082	492
mbed_official	573:ad23fe03a082	493	/** @brief Clears the SPI FRE pending flag.
mbed_official	573:ad23fe03a082	494	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	495	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	496	*
mbed_official	573:ad23fe03a082	497	* @retval None
mbed_official	573:ad23fe03a082	498	*/
mbed_official	573:ad23fe03a082	499	#define __HAL_SPI_CLEAR_FREFLAG(__HANDLE__) \
mbed_official	573:ad23fe03a082	500	do{ \
mbed_official	573:ad23fe03a082	501	__IO uint32_t tmpreg; \
mbed_official	573:ad23fe03a082	502	tmpreg = (__HANDLE__)->Instance->SR; \
mbed_official	573:ad23fe03a082	503	UNUSED(tmpreg); \
mbed_official	573:ad23fe03a082	504	} while(0)
mbed_official	573:ad23fe03a082	505
mbed_official	573:ad23fe03a082	506	/** @brief Enables the SPI.
mbed_official	573:ad23fe03a082	507	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	508	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	509	* @retval None
mbed_official	573:ad23fe03a082	510	*/
mbed_official	573:ad23fe03a082	511	#define __HAL_SPI_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 \|= SPI_CR1_SPE)
mbed_official	573:ad23fe03a082	512
mbed_official	573:ad23fe03a082	513	/** @brief Disables the SPI.
mbed_official	573:ad23fe03a082	514	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	515	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	516	* @retval None
mbed_official	573:ad23fe03a082	517	*/
mbed_official	573:ad23fe03a082	518	#define __HAL_SPI_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 &= (~SPI_CR1_SPE))
mbed_official	573:ad23fe03a082	519
mbed_official	573:ad23fe03a082	520	/**
mbed_official	573:ad23fe03a082	521	* @}
mbed_official	573:ad23fe03a082	522	*/
mbed_official	573:ad23fe03a082	523
mbed_official	573:ad23fe03a082	524	/* Private macros --------------------------------------------------------*/
mbed_official	573:ad23fe03a082	525	/** @defgroup SPI_Private_Macros SPI Private Macros
mbed_official	573:ad23fe03a082	526	* @{
mbed_official	573:ad23fe03a082	527	*/
mbed_official	573:ad23fe03a082	528
mbed_official	573:ad23fe03a082	529	/** @brief Sets the SPI transmit-only mode.
mbed_official	573:ad23fe03a082	530	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	531	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	532	* @retval None
mbed_official	573:ad23fe03a082	533	*/
mbed_official	573:ad23fe03a082	534	#define SPI_1LINE_TX(__HANDLE__) ((__HANDLE__)->Instance->CR1 \|= SPI_CR1_BIDIOE)
mbed_official	573:ad23fe03a082	535
mbed_official	573:ad23fe03a082	536	/** @brief Sets the SPI receive-only mode.
mbed_official	573:ad23fe03a082	537	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	538	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	539	* @retval None
mbed_official	573:ad23fe03a082	540	*/
mbed_official	573:ad23fe03a082	541	#define SPI_1LINE_RX(__HANDLE__) ((__HANDLE__)->Instance->CR1 &= (~SPI_CR1_BIDIOE))
mbed_official	573:ad23fe03a082	542
mbed_official	573:ad23fe03a082	543	/** @brief Resets the CRC calculation of the SPI.
mbed_official	573:ad23fe03a082	544	* @param __HANDLE__ : specifies the SPI Handle.
mbed_official	573:ad23fe03a082	545	* This parameter can be SPI where x: 1, 2, or 3 to select the SPI peripheral.
mbed_official	573:ad23fe03a082	546	* @retval None
mbed_official	573:ad23fe03a082	547	*/
mbed_official	573:ad23fe03a082	548	#define SPI_RESET_CRC(__HANDLE__) do{(__HANDLE__)->Instance->CR1 &= (uint16_t)(~SPI_CR1_CRCEN);\
mbed_official	573:ad23fe03a082	549	(__HANDLE__)->Instance->CR1 \|= SPI_CR1_CRCEN;}while(0)
mbed_official	573:ad23fe03a082	550
mbed_official	573:ad23fe03a082	551	#define IS_SPI_MODE(MODE) (((MODE) == SPI_MODE_SLAVE) \|\| \
mbed_official	573:ad23fe03a082	552	((MODE) == SPI_MODE_MASTER))
mbed_official	573:ad23fe03a082	553
mbed_official	573:ad23fe03a082	554	#define IS_SPI_DIRECTION(MODE) (((MODE) == SPI_DIRECTION_2LINES) \|\| \
mbed_official	573:ad23fe03a082	555	((MODE) == SPI_DIRECTION_2LINES_RXONLY) \|\|\
mbed_official	573:ad23fe03a082	556	((MODE) == SPI_DIRECTION_1LINE))
mbed_official	573:ad23fe03a082	557
mbed_official	573:ad23fe03a082	558	#define IS_SPI_DIRECTION_2LINES(MODE) ((MODE) == SPI_DIRECTION_2LINES)
mbed_official	573:ad23fe03a082	559
mbed_official	573:ad23fe03a082	560	#define IS_SPI_DIRECTION_2LINES_OR_1LINE(MODE) (((MODE) == SPI_DIRECTION_2LINES)\|\| \
mbed_official	573:ad23fe03a082	561	((MODE) == SPI_DIRECTION_1LINE))
mbed_official	573:ad23fe03a082	562
mbed_official	573:ad23fe03a082	563	#define IS_SPI_DATASIZE(DATASIZE) (((DATASIZE) == SPI_DATASIZE_16BIT) \|\| \
mbed_official	573:ad23fe03a082	564	((DATASIZE) == SPI_DATASIZE_15BIT) \|\| \
mbed_official	573:ad23fe03a082	565	((DATASIZE) == SPI_DATASIZE_14BIT) \|\| \
mbed_official	573:ad23fe03a082	566	((DATASIZE) == SPI_DATASIZE_13BIT) \|\| \
mbed_official	573:ad23fe03a082	567	((DATASIZE) == SPI_DATASIZE_12BIT) \|\| \
mbed_official	573:ad23fe03a082	568	((DATASIZE) == SPI_DATASIZE_11BIT) \|\| \
mbed_official	573:ad23fe03a082	569	((DATASIZE) == SPI_DATASIZE_10BIT) \|\| \
mbed_official	573:ad23fe03a082	570	((DATASIZE) == SPI_DATASIZE_9BIT) \|\| \
mbed_official	573:ad23fe03a082	571	((DATASIZE) == SPI_DATASIZE_8BIT) \|\| \
mbed_official	573:ad23fe03a082	572	((DATASIZE) == SPI_DATASIZE_7BIT) \|\| \
mbed_official	573:ad23fe03a082	573	((DATASIZE) == SPI_DATASIZE_6BIT) \|\| \
mbed_official	573:ad23fe03a082	574	((DATASIZE) == SPI_DATASIZE_5BIT) \|\| \
mbed_official	573:ad23fe03a082	575	((DATASIZE) == SPI_DATASIZE_4BIT))
mbed_official	573:ad23fe03a082	576
mbed_official	573:ad23fe03a082	577	#define IS_SPI_CPOL(CPOL) (((CPOL) == SPI_POLARITY_LOW) \|\| \
mbed_official	573:ad23fe03a082	578	((CPOL) == SPI_POLARITY_HIGH))
mbed_official	573:ad23fe03a082	579
mbed_official	573:ad23fe03a082	580	#define IS_SPI_CPHA(CPHA) (((CPHA) == SPI_PHASE_1EDGE) \|\| \
mbed_official	573:ad23fe03a082	581	((CPHA) == SPI_PHASE_2EDGE))
mbed_official	573:ad23fe03a082	582
mbed_official	573:ad23fe03a082	583	#define IS_SPI_NSS(NSS) (((NSS) == SPI_NSS_SOFT) \|\| \
mbed_official	573:ad23fe03a082	584	((NSS) == SPI_NSS_HARD_INPUT) \|\| \
mbed_official	573:ad23fe03a082	585	((NSS) == SPI_NSS_HARD_OUTPUT))
mbed_official	573:ad23fe03a082	586
mbed_official	573:ad23fe03a082	587	#define IS_SPI_NSSP(NSSP) (((NSSP) == SPI_NSS_PULSE_ENABLE) \|\| \
mbed_official	573:ad23fe03a082	588	((NSSP) == SPI_NSS_PULSE_DISABLE))
mbed_official	573:ad23fe03a082	589
mbed_official	573:ad23fe03a082	590	#define IS_SPI_BAUDRATE_PRESCALER(PRESCALER) (((PRESCALER) == SPI_BAUDRATEPRESCALER_2) \|\| \
mbed_official	573:ad23fe03a082	591	((PRESCALER) == SPI_BAUDRATEPRESCALER_4) \|\| \
mbed_official	573:ad23fe03a082	592	((PRESCALER) == SPI_BAUDRATEPRESCALER_8) \|\| \
mbed_official	573:ad23fe03a082	593	((PRESCALER) == SPI_BAUDRATEPRESCALER_16) \|\| \
mbed_official	573:ad23fe03a082	594	((PRESCALER) == SPI_BAUDRATEPRESCALER_32) \|\| \
mbed_official	573:ad23fe03a082	595	((PRESCALER) == SPI_BAUDRATEPRESCALER_64) \|\| \
mbed_official	573:ad23fe03a082	596	((PRESCALER) == SPI_BAUDRATEPRESCALER_128) \|\| \
mbed_official	573:ad23fe03a082	597	((PRESCALER) == SPI_BAUDRATEPRESCALER_256))
mbed_official	573:ad23fe03a082	598
mbed_official	573:ad23fe03a082	599	#define IS_SPI_FIRST_BIT(BIT) (((BIT) == SPI_FIRSTBIT_MSB) \|\| \
mbed_official	573:ad23fe03a082	600	((BIT) == SPI_FIRSTBIT_LSB))
mbed_official	573:ad23fe03a082	601
mbed_official	573:ad23fe03a082	602	#define IS_SPI_TIMODE(MODE) (((MODE) == SPI_TIMODE_DISABLE) \|\| \
mbed_official	573:ad23fe03a082	603	((MODE) == SPI_TIMODE_ENABLE))
mbed_official	573:ad23fe03a082	604
mbed_official	573:ad23fe03a082	605	#define IS_SPI_CRC_CALCULATION(CALCULATION) (((CALCULATION) == SPI_CRCCALCULATION_DISABLE) \|\| \
mbed_official	573:ad23fe03a082	606	((CALCULATION) == SPI_CRCCALCULATION_ENABLE))
mbed_official	573:ad23fe03a082	607
mbed_official	573:ad23fe03a082	608	#define IS_SPI_CRC_LENGTH(LENGTH) (((LENGTH) == SPI_CRC_LENGTH_DATASIZE) \|\|\
mbed_official	573:ad23fe03a082	609	((LENGTH) == SPI_CRC_LENGTH_8BIT) \|\| \
mbed_official	573:ad23fe03a082	610	((LENGTH) == SPI_CRC_LENGTH_16BIT))
mbed_official	573:ad23fe03a082	611
mbed_official	573:ad23fe03a082	612	#define IS_SPI_CRC_POLYNOMIAL(POLYNOMIAL) (((POLYNOMIAL) >= 0x1) && ((POLYNOMIAL) <= 0xFFFF))
mbed_official	573:ad23fe03a082	613
mbed_official	573:ad23fe03a082	614
mbed_official	573:ad23fe03a082	615	/**
mbed_official	573:ad23fe03a082	616	* @}
mbed_official	573:ad23fe03a082	617	*/
mbed_official	573:ad23fe03a082	618
mbed_official	573:ad23fe03a082	619	/* Exported functions --------------------------------------------------------*/
mbed_official	573:ad23fe03a082	620	/** @addtogroup SPI_Exported_Functions SPI Exported Functions
mbed_official	573:ad23fe03a082	621	* @{
mbed_official	573:ad23fe03a082	622	*/
mbed_official	573:ad23fe03a082	623
mbed_official	573:ad23fe03a082	624	/** @addtogroup SPI_Exported_Functions_Group1 Initialization and de-initialization functions
mbed_official	573:ad23fe03a082	625	* @{
mbed_official	573:ad23fe03a082	626	*/
mbed_official	573:ad23fe03a082	627
mbed_official	573:ad23fe03a082	628	/* Initialization and de-initialization functions ****************************/
mbed_official	573:ad23fe03a082	629	HAL_StatusTypeDef HAL_SPI_Init(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	630	HAL_StatusTypeDef HAL_SPI_DeInit (SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	631	void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	632	void HAL_SPI_MspDeInit(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	633	/**
mbed_official	573:ad23fe03a082	634	* @}
mbed_official	573:ad23fe03a082	635	*/
mbed_official	573:ad23fe03a082	636
mbed_official	573:ad23fe03a082	637	/** @addtogroup SPI_Exported_Functions_Group2 IO operation functions
mbed_official	573:ad23fe03a082	638	* @{
mbed_official	573:ad23fe03a082	639	*/
mbed_official	573:ad23fe03a082	640
mbed_official	573:ad23fe03a082	641	/* IO operation functions *****************************************************/
mbed_official	573:ad23fe03a082	642	HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size, uint32_t Timeout);
mbed_official	573:ad23fe03a082	643	HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size, uint32_t Timeout);
mbed_official	573:ad23fe03a082	644	HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef hspi, uint8_t pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);
mbed_official	573:ad23fe03a082	645	HAL_StatusTypeDef HAL_SPI_Transmit_IT(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size);
mbed_official	573:ad23fe03a082	646	HAL_StatusTypeDef HAL_SPI_Receive_IT(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size);
mbed_official	573:ad23fe03a082	647	HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(SPI_HandleTypeDef hspi, uint8_t pTxData, uint8_t *pRxData, uint16_t Size);
mbed_official	573:ad23fe03a082	648	HAL_StatusTypeDef HAL_SPI_Transmit_DMA(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size);
mbed_official	573:ad23fe03a082	649	HAL_StatusTypeDef HAL_SPI_Receive_DMA(SPI_HandleTypeDef hspi, uint8_t pData, uint16_t Size);
mbed_official	573:ad23fe03a082	650	HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(SPI_HandleTypeDef hspi, uint8_t pTxData, uint8_t *pRxData, uint16_t Size);
mbed_official	573:ad23fe03a082	651	HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	652	HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	653	HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	654
mbed_official	573:ad23fe03a082	655	void HAL_SPI_IRQHandler(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	656	void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	657	void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	658	void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	659	void HAL_SPI_TxHalfCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	660	void HAL_SPI_RxHalfCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	661	void HAL_SPI_TxRxHalfCpltCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	662	void HAL_SPI_ErrorCallback(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	663	/**
mbed_official	573:ad23fe03a082	664	* @}
mbed_official	573:ad23fe03a082	665	*/
mbed_official	573:ad23fe03a082	666
mbed_official	573:ad23fe03a082	667	/** @addtogroup SPI_Exported_Functions_Group3 Peripheral State and Errors functions
mbed_official	573:ad23fe03a082	668	* @{
mbed_official	573:ad23fe03a082	669	*/
mbed_official	573:ad23fe03a082	670
mbed_official	573:ad23fe03a082	671	/* Peripheral State and Error functions ***************************************/
mbed_official	573:ad23fe03a082	672	HAL_SPI_StateTypeDef HAL_SPI_GetState(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	673	uint32_t HAL_SPI_GetError(SPI_HandleTypeDef *hspi);
mbed_official	573:ad23fe03a082	674	/**
mbed_official	573:ad23fe03a082	675	* @}
mbed_official	573:ad23fe03a082	676	*/
mbed_official	573:ad23fe03a082	677
mbed_official	573:ad23fe03a082	678	/**
mbed_official	573:ad23fe03a082	679	* @}
mbed_official	573:ad23fe03a082	680	*/
mbed_official	573:ad23fe03a082	681
mbed_official	573:ad23fe03a082	682	/**
mbed_official	573:ad23fe03a082	683	* @}
mbed_official	573:ad23fe03a082	684	*/
mbed_official	573:ad23fe03a082	685
mbed_official	573:ad23fe03a082	686	/**
mbed_official	573:ad23fe03a082	687	* @}
mbed_official	573:ad23fe03a082	688	*/
mbed_official	573:ad23fe03a082	689
mbed_official	573:ad23fe03a082	690	#ifdef __cplusplus
mbed_official	573:ad23fe03a082	691	}
mbed_official	573:ad23fe03a082	692	#endif
mbed_official	573:ad23fe03a082	693
mbed_official	573:ad23fe03a082	694	#endif /* __STM32F7xx_HAL_SPI_H */
mbed_official	573:ad23fe03a082	695
mbed_official	573:ad23fe03a082	696	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/