SDK Development / mbed-src

mbed SDK library sources

Fork of mbed-src by mbed official

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 librarymbed

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

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_L152RE/stm32l1xx_spi.c@80:66393a7b209d, 2014-01-30 (annotated)

Committer:
mbed_official
Date:
Thu Jan 30 12:15:05 2014 +0000
Revision:
80:66393a7b209d
Parent:
76:aeb1df146756 
Synchronized with git revision dba523f83fe09b7fce11fc1299dd1216e9776359



Full URL: https://github.com/mbedmicro/mbed/commit/dba523f83fe09b7fce11fc1299dd1216e9776359/



Update of I2C, SPI, SLEEP for NUCLEO_F103RB and L152RE

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /**
mbed_official 76:aeb1df146756 2 ******************************************************************************
mbed_official 76:aeb1df146756 3 * @file stm32l1xx_spi.c
mbed_official 76:aeb1df146756 4 * @author MCD Application Team
mbed_official 80:66393a7b209d 5 * @version V1.3.0
mbed_official 80:66393a7b209d 6 * @date 31-January-2014
mbed_official 76:aeb1df146756 7 * @brief This file provides firmware functions to manage the following
mbed_official 76:aeb1df146756 8 * functionalities of the Serial peripheral interface (SPI):
mbed_official 76:aeb1df146756 9 * + Initialization and Configuration
mbed_official 76:aeb1df146756 10 * + Data transfers functions
mbed_official 76:aeb1df146756 11 * + Hardware CRC Calculation
mbed_official 76:aeb1df146756 12 * + DMA transfers management
mbed_official 76:aeb1df146756 13 * + Interrupts and flags management
mbed_official 76:aeb1df146756 14 *
mbed_official 76:aeb1df146756 15 * @verbatim
mbed_official 76:aeb1df146756 16 [..] The I2S feature is not implemented in STM32L1xx Ultra Low Power
mbed_official 76:aeb1df146756 17 Medium-density devices and it's supported only STM32L1xx Ultra Low Power
mbed_official 76:aeb1df146756 18 Medium-density Plus and High-density devices.
mbed_official 76:aeb1df146756 19
mbed_official 76:aeb1df146756 20 ===============================================================================
mbed_official 76:aeb1df146756 21 ##### How to use this driver #####
mbed_official 76:aeb1df146756 22 ===============================================================================
mbed_official 76:aeb1df146756 23 [..]
mbed_official 76:aeb1df146756 24 (#) Enable peripheral clock using RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE)
mbed_official 76:aeb1df146756 25 function for SPI1 or using RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE)
mbed_official 76:aeb1df146756 26 function for SPI2 or using RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE)
mbed_official 76:aeb1df146756 27 for SPI3.
mbed_official 76:aeb1df146756 28
mbed_official 76:aeb1df146756 29 (#) Enable SCK, MOSI, MISO and NSS GPIO clocks using
mbed_official 76:aeb1df146756 30 RCC_AHBPeriphClockCmd() function.
mbed_official 76:aeb1df146756 31
mbed_official 76:aeb1df146756 32 (#) Peripherals alternate function:
mbed_official 76:aeb1df146756 33 (++) Connect the pin to the desired peripherals' Alternate
mbed_official 76:aeb1df146756 34 Function (AF) using GPIO_PinAFConfig() function.
mbed_official 76:aeb1df146756 35 (++) Configure the desired pin in alternate function by:
mbed_official 76:aeb1df146756 36 GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF.
mbed_official 76:aeb1df146756 37 (++) Select the type, pull-up/pull-down and output speed via
mbed_official 76:aeb1df146756 38 GPIO_PuPd, GPIO_OType and GPIO_Speed members.
mbed_official 76:aeb1df146756 39 (++) Call GPIO_Init() function.
mbed_official 76:aeb1df146756 40
mbed_official 76:aeb1df146756 41 (#) Program the Polarity, Phase, First Data, Baud Rate Prescaler, Slave
mbed_official 76:aeb1df146756 42 Management, Peripheral Mode and CRC Polynomial values using the SPI_Init()
mbed_official 76:aeb1df146756 43 function.In I2S mode, program the Mode, Standard, Data Format, MCLK
mbed_official 76:aeb1df146756 44 Output, Audio frequency and Polarity using I2S_Init() function.
mbed_official 76:aeb1df146756 45
mbed_official 76:aeb1df146756 46 (#) Enable the NVIC and the corresponding interrupt using the function
mbed_official 76:aeb1df146756 47 SPI_ITConfig() if you need to use interrupt mode.
mbed_official 76:aeb1df146756 48
mbed_official 76:aeb1df146756 49 (#) When using the DMA mode
mbed_official 76:aeb1df146756 50 (++) Configure the DMA using DMA_Init() function.
mbed_official 76:aeb1df146756 51 (++) Active the needed channel Request using SPI_I2S_DMACmd() function.
mbed_official 76:aeb1df146756 52
mbed_official 76:aeb1df146756 53 (#) Enable the SPI using the SPI_Cmd() function or enable the I2S using
mbed_official 76:aeb1df146756 54 I2S_Cmd().
mbed_official 76:aeb1df146756 55
mbed_official 76:aeb1df146756 56 (#) Enable the DMA using the DMA_Cmd() function when using DMA mode.
mbed_official 76:aeb1df146756 57
mbed_official 76:aeb1df146756 58 (#) Optionally, you can enable/configure the following parameters without
mbed_official 76:aeb1df146756 59 re-initialization (i.e there is no need to call again SPI_Init() function):
mbed_official 76:aeb1df146756 60 (++) When bidirectional mode (SPI_Direction_1Line_Rx or SPI_Direction_1Line_Tx)
mbed_official 76:aeb1df146756 61 is programmed as Data direction parameter using the SPI_Init()
mbed_official 76:aeb1df146756 62 function it can be possible to switch between SPI_Direction_Tx
mbed_official 76:aeb1df146756 63 or SPI_Direction_Rx using the SPI_BiDirectionalLineConfig() function.
mbed_official 76:aeb1df146756 64 (++) When SPI_NSS_Soft is selected as Slave Select Management parameter
mbed_official 76:aeb1df146756 65 using the SPI_Init() function it can be possible to manage the
mbed_official 76:aeb1df146756 66 NSS internal signal using the SPI_NSSInternalSoftwareConfig() function.
mbed_official 76:aeb1df146756 67 (++) Reconfigure the data size using the SPI_DataSizeConfig() function.
mbed_official 76:aeb1df146756 68 (++) Enable or disable the SS output using the SPI_SSOutputCmd() function.
mbed_official 76:aeb1df146756 69
mbed_official 76:aeb1df146756 70 (#) To use the CRC Hardware calculation feature refer to the Peripheral
mbed_official 76:aeb1df146756 71 CRC hardware Calculation subsection.
mbed_official 76:aeb1df146756 72
mbed_official 76:aeb1df146756 73 @endverbatim
mbed_official 76:aeb1df146756 74
mbed_official 76:aeb1df146756 75 ******************************************************************************
mbed_official 76:aeb1df146756 76 * @attention
mbed_official 76:aeb1df146756 77 *
mbed_official 80:66393a7b209d 78 * <h2><center>&copy; COPYRIGHT 2014 STMicroelectronics</center></h2>
mbed_official 76:aeb1df146756 79 *
mbed_official 76:aeb1df146756 80 * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
mbed_official 76:aeb1df146756 81 * You may not use this file except in compliance with the License.
mbed_official 76:aeb1df146756 82 * You may obtain a copy of the License at:
mbed_official 76:aeb1df146756 83 *
mbed_official 76:aeb1df146756 84 * http://www.st.com/software_license_agreement_liberty_v2
mbed_official 76:aeb1df146756 85 *
mbed_official 76:aeb1df146756 86 * Unless required by applicable law or agreed to in writing, software
mbed_official 76:aeb1df146756 87 * distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 76:aeb1df146756 88 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 76:aeb1df146756 89 * See the License for the specific language governing permissions and
mbed_official 76:aeb1df146756 90 * limitations under the License.
mbed_official 76:aeb1df146756 91 *
mbed_official 76:aeb1df146756 92 ******************************************************************************
mbed_official 76:aeb1df146756 93 */
mbed_official 76:aeb1df146756 94
mbed_official 76:aeb1df146756 95 /* Includes ------------------------------------------------------------------*/
mbed_official 76:aeb1df146756 96 #include "stm32l1xx_spi.h"
mbed_official 76:aeb1df146756 97 #include "stm32l1xx_rcc.h"
mbed_official 76:aeb1df146756 98
mbed_official 76:aeb1df146756 99 /** @addtogroup STM32L1xx_StdPeriph_Driver
mbed_official 76:aeb1df146756 100 * @{
mbed_official 76:aeb1df146756 101 */
mbed_official 76:aeb1df146756 102
mbed_official 76:aeb1df146756 103 /** @defgroup SPI
mbed_official 76:aeb1df146756 104 * @brief SPI driver modules
mbed_official 76:aeb1df146756 105 * @{
mbed_official 76:aeb1df146756 106 */
mbed_official 76:aeb1df146756 107
mbed_official 76:aeb1df146756 108 /* Private typedef -----------------------------------------------------------*/
mbed_official 76:aeb1df146756 109 /* Private define ------------------------------------------------------------*/
mbed_official 76:aeb1df146756 110 /* SPI registers Masks */
mbed_official 76:aeb1df146756 111 #define CR1_CLEAR_MASK ((uint16_t)0x3040)
mbed_official 76:aeb1df146756 112 #define I2SCFGR_CLEAR_Mask ((uint16_t)0xF040)
mbed_official 76:aeb1df146756 113
mbed_official 76:aeb1df146756 114 /* Private macro -------------------------------------------------------------*/
mbed_official 76:aeb1df146756 115 /* Private variables ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 116 /* Private function prototypes -----------------------------------------------*/
mbed_official 76:aeb1df146756 117 /* Private functions ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 118
mbed_official 76:aeb1df146756 119 /** @defgroup SPI_Private_Functions
mbed_official 76:aeb1df146756 120 * @{
mbed_official 76:aeb1df146756 121 */
mbed_official 76:aeb1df146756 122
mbed_official 76:aeb1df146756 123 /** @defgroup SPI_Group1 Initialization and Configuration functions
mbed_official 76:aeb1df146756 124 * @brief Initialization and Configuration functions
mbed_official 76:aeb1df146756 125 *
mbed_official 76:aeb1df146756 126 @verbatim
mbed_official 76:aeb1df146756 127 ===============================================================================
mbed_official 76:aeb1df146756 128 ##### Initialization and Configuration functions #####
mbed_official 76:aeb1df146756 129 ===============================================================================
mbed_official 76:aeb1df146756 130 [..] This section provides a set of functions allowing to initialize the SPI
mbed_official 76:aeb1df146756 131 Direction, SPI Mode, SPI Data Size, SPI Polarity, SPI Phase, SPI NSS
mbed_official 76:aeb1df146756 132 Management, SPI Baud Rate Prescaler, SPI First Bit and SPI CRC Polynomial.
mbed_official 76:aeb1df146756 133 [..] The SPI_Init() function follows the SPI configuration procedures for
mbed_official 76:aeb1df146756 134 Master mode and Slave mode (details for these procedures are available
mbed_official 76:aeb1df146756 135 in reference manual (RM0038)).
mbed_official 76:aeb1df146756 136
mbed_official 76:aeb1df146756 137 @endverbatim
mbed_official 76:aeb1df146756 138 * @{
mbed_official 76:aeb1df146756 139 */
mbed_official 76:aeb1df146756 140
mbed_official 76:aeb1df146756 141 /**
mbed_official 76:aeb1df146756 142 * @brief Deinitializes the SPIx peripheral registers to their default
mbed_official 76:aeb1df146756 143 * reset values.
mbed_official 76:aeb1df146756 144 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 145 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 146 * @retval None
mbed_official 76:aeb1df146756 147 */
mbed_official 76:aeb1df146756 148 void SPI_I2S_DeInit(SPI_TypeDef* SPIx)
mbed_official 76:aeb1df146756 149 {
mbed_official 76:aeb1df146756 150 /* Check the parameters */
mbed_official 76:aeb1df146756 151 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 152
mbed_official 76:aeb1df146756 153 if (SPIx == SPI1)
mbed_official 76:aeb1df146756 154 {
mbed_official 76:aeb1df146756 155 /* Enable SPI1 reset state */
mbed_official 76:aeb1df146756 156 RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, ENABLE);
mbed_official 76:aeb1df146756 157 /* Release SPI1 from reset state */
mbed_official 76:aeb1df146756 158 RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, DISABLE);
mbed_official 76:aeb1df146756 159 }
mbed_official 76:aeb1df146756 160 else if (SPIx == SPI2)
mbed_official 76:aeb1df146756 161 {
mbed_official 76:aeb1df146756 162 /* Enable SPI2 reset state */
mbed_official 76:aeb1df146756 163 RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI2, ENABLE);
mbed_official 76:aeb1df146756 164 /* Release SPI2 from reset state */
mbed_official 76:aeb1df146756 165 RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI2, DISABLE);
mbed_official 76:aeb1df146756 166 }
mbed_official 76:aeb1df146756 167 else
mbed_official 76:aeb1df146756 168 {
mbed_official 76:aeb1df146756 169 if (SPIx == SPI3)
mbed_official 76:aeb1df146756 170 {
mbed_official 76:aeb1df146756 171 /* Enable SPI3 reset state */
mbed_official 76:aeb1df146756 172 RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE);
mbed_official 76:aeb1df146756 173 /* Release SPI3 from reset state */
mbed_official 76:aeb1df146756 174 RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, DISABLE);
mbed_official 76:aeb1df146756 175 }
mbed_official 76:aeb1df146756 176 }
mbed_official 76:aeb1df146756 177 }
mbed_official 76:aeb1df146756 178
mbed_official 76:aeb1df146756 179 /**
mbed_official 76:aeb1df146756 180 * @brief Initializes the SPIx peripheral according to the specified
mbed_official 76:aeb1df146756 181 * parameters in the SPI_InitStruct.
mbed_official 76:aeb1df146756 182 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 183 * @param SPI_InitStruct: pointer to a SPI_InitTypeDef structure that
mbed_official 76:aeb1df146756 184 * contains the configuration information for the specified SPI peripheral.
mbed_official 76:aeb1df146756 185 * @retval None
mbed_official 76:aeb1df146756 186 */
mbed_official 76:aeb1df146756 187 void SPI_Init(SPI_TypeDef* SPIx, SPI_InitTypeDef* SPI_InitStruct)
mbed_official 76:aeb1df146756 188 {
mbed_official 76:aeb1df146756 189 uint16_t tmpreg = 0;
mbed_official 76:aeb1df146756 190
mbed_official 76:aeb1df146756 191 /* check the parameters */
mbed_official 76:aeb1df146756 192 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 193
mbed_official 76:aeb1df146756 194 /* Check the SPI parameters */
mbed_official 76:aeb1df146756 195 assert_param(IS_SPI_DIRECTION_MODE(SPI_InitStruct->SPI_Direction));
mbed_official 76:aeb1df146756 196 assert_param(IS_SPI_MODE(SPI_InitStruct->SPI_Mode));
mbed_official 76:aeb1df146756 197 assert_param(IS_SPI_DATASIZE(SPI_InitStruct->SPI_DataSize));
mbed_official 76:aeb1df146756 198 assert_param(IS_SPI_CPOL(SPI_InitStruct->SPI_CPOL));
mbed_official 76:aeb1df146756 199 assert_param(IS_SPI_CPHA(SPI_InitStruct->SPI_CPHA));
mbed_official 76:aeb1df146756 200 assert_param(IS_SPI_NSS(SPI_InitStruct->SPI_NSS));
mbed_official 76:aeb1df146756 201 assert_param(IS_SPI_BAUDRATE_PRESCALER(SPI_InitStruct->SPI_BaudRatePrescaler));
mbed_official 76:aeb1df146756 202 assert_param(IS_SPI_FIRST_BIT(SPI_InitStruct->SPI_FirstBit));
mbed_official 76:aeb1df146756 203 assert_param(IS_SPI_CRC_POLYNOMIAL(SPI_InitStruct->SPI_CRCPolynomial));
mbed_official 76:aeb1df146756 204
mbed_official 76:aeb1df146756 205 /*---------------------------- SPIx CR1 Configuration ------------------------*/
mbed_official 76:aeb1df146756 206 /* Get the SPIx CR1 value */
mbed_official 76:aeb1df146756 207 tmpreg = SPIx->CR1;
mbed_official 76:aeb1df146756 208 /* Clear BIDIMode, BIDIOE, RxONLY, SSM, SSI, LSBFirst, BR, MSTR, CPOL and CPHA bits */
mbed_official 76:aeb1df146756 209 tmpreg &= CR1_CLEAR_MASK;
mbed_official 76:aeb1df146756 210 /* Configure SPIx: direction, NSS management, first transmitted bit, BaudRate prescaler
mbed_official 76:aeb1df146756 211 master/salve mode, CPOL and CPHA */
mbed_official 76:aeb1df146756 212 /* Set BIDImode, BIDIOE and RxONLY bits according to SPI_Direction value */
mbed_official 76:aeb1df146756 213 /* Set SSM, SSI and MSTR bits according to SPI_Mode and SPI_NSS values */
mbed_official 76:aeb1df146756 214 /* Set LSBFirst bit according to SPI_FirstBit value */
mbed_official 76:aeb1df146756 215 /* Set BR bits according to SPI_BaudRatePrescaler value */
mbed_official 76:aeb1df146756 216 /* Set CPOL bit according to SPI_CPOL value */
mbed_official 76:aeb1df146756 217 /* Set CPHA bit according to SPI_CPHA value */
mbed_official 76:aeb1df146756 218 tmpreg |= (uint16_t)((uint32_t)SPI_InitStruct->SPI_Direction | SPI_InitStruct->SPI_Mode |
mbed_official 76:aeb1df146756 219 SPI_InitStruct->SPI_DataSize | SPI_InitStruct->SPI_CPOL |
mbed_official 76:aeb1df146756 220 SPI_InitStruct->SPI_CPHA | SPI_InitStruct->SPI_NSS |
mbed_official 76:aeb1df146756 221 SPI_InitStruct->SPI_BaudRatePrescaler | SPI_InitStruct->SPI_FirstBit);
mbed_official 76:aeb1df146756 222 /* Write to SPIx CR1 */
mbed_official 76:aeb1df146756 223 SPIx->CR1 = tmpreg;
mbed_official 76:aeb1df146756 224
mbed_official 76:aeb1df146756 225 /* Activate the SPI mode (Reset I2SMOD bit in I2SCFGR register) */
mbed_official 76:aeb1df146756 226 SPIx->I2SCFGR &= (uint16_t)~((uint16_t)SPI_I2SCFGR_I2SMOD);
mbed_official 76:aeb1df146756 227 /*---------------------------- SPIx CRCPOLY Configuration --------------------*/
mbed_official 76:aeb1df146756 228 /* Write to SPIx CRCPOLY */
mbed_official 76:aeb1df146756 229 SPIx->CRCPR = SPI_InitStruct->SPI_CRCPolynomial;
mbed_official 76:aeb1df146756 230 }
mbed_official 76:aeb1df146756 231
mbed_official 76:aeb1df146756 232 /**
mbed_official 76:aeb1df146756 233 * @brief Initializes the SPIx peripheral according to the specified
mbed_official 76:aeb1df146756 234 * parameters in the I2S_InitStruct.
mbed_official 76:aeb1df146756 235 * @param SPIx: where x can be 2 or 3 to select the SPI peripheral
mbed_official 76:aeb1df146756 236 * (configured in I2S mode).
mbed_official 76:aeb1df146756 237 * @param I2S_InitStruct: pointer to an I2S_InitTypeDef structure that
mbed_official 76:aeb1df146756 238 * contains the configuration information for the specified SPI peripheral
mbed_official 76:aeb1df146756 239 * configured in I2S mode.
mbed_official 76:aeb1df146756 240 * @note
mbed_official 76:aeb1df146756 241 * The function calculates the optimal prescaler needed to obtain the most
mbed_official 76:aeb1df146756 242 * accurate audio frequency (depending on the I2S clock source, the PLL values
mbed_official 76:aeb1df146756 243 * and the product configuration). But in case the prescaler value is greater
mbed_official 76:aeb1df146756 244 * than 511, the default value (0x02) will be configured instead.
mbed_official 76:aeb1df146756 245 * @retval None
mbed_official 76:aeb1df146756 246 */
mbed_official 76:aeb1df146756 247 void I2S_Init(SPI_TypeDef* SPIx, I2S_InitTypeDef* I2S_InitStruct)
mbed_official 76:aeb1df146756 248 {
mbed_official 76:aeb1df146756 249 uint16_t tmpreg = 0, i2sdiv = 2, i2sodd = 0, packetlength = 1;
mbed_official 76:aeb1df146756 250 uint32_t tmp = 0;
mbed_official 76:aeb1df146756 251 RCC_ClocksTypeDef RCC_Clocks;
mbed_official 76:aeb1df146756 252 uint32_t sourceclock = 0;
mbed_official 76:aeb1df146756 253
mbed_official 76:aeb1df146756 254 /* Check the I2S parameters */
mbed_official 76:aeb1df146756 255 assert_param(IS_SPI_23_PERIPH(SPIx));
mbed_official 76:aeb1df146756 256 assert_param(IS_I2S_MODE(I2S_InitStruct->I2S_Mode));
mbed_official 76:aeb1df146756 257 assert_param(IS_I2S_STANDARD(I2S_InitStruct->I2S_Standard));
mbed_official 76:aeb1df146756 258 assert_param(IS_I2S_DATA_FORMAT(I2S_InitStruct->I2S_DataFormat));
mbed_official 76:aeb1df146756 259 assert_param(IS_I2S_MCLK_OUTPUT(I2S_InitStruct->I2S_MCLKOutput));
mbed_official 76:aeb1df146756 260 assert_param(IS_I2S_AUDIO_FREQ(I2S_InitStruct->I2S_AudioFreq));
mbed_official 76:aeb1df146756 261 assert_param(IS_I2S_CPOL(I2S_InitStruct->I2S_CPOL));
mbed_official 76:aeb1df146756 262
mbed_official 76:aeb1df146756 263 /*----------------------- SPIx I2SCFGR & I2SPR Configuration -----------------*/
mbed_official 76:aeb1df146756 264 /* Clear I2SMOD, I2SE, I2SCFG, PCMSYNC, I2SSTD, CKPOL, DATLEN and CHLEN bits */
mbed_official 76:aeb1df146756 265 SPIx->I2SCFGR &= I2SCFGR_CLEAR_Mask;
mbed_official 76:aeb1df146756 266 SPIx->I2SPR = 0x0002;
mbed_official 76:aeb1df146756 267
mbed_official 76:aeb1df146756 268 /* Get the I2SCFGR register value */
mbed_official 76:aeb1df146756 269 tmpreg = SPIx->I2SCFGR;
mbed_official 76:aeb1df146756 270
mbed_official 76:aeb1df146756 271 /* If the default value has to be written, reinitialize i2sdiv and i2sodd*/
mbed_official 76:aeb1df146756 272 if(I2S_InitStruct->I2S_AudioFreq == I2S_AudioFreq_Default)
mbed_official 76:aeb1df146756 273 {
mbed_official 76:aeb1df146756 274 i2sodd = (uint16_t)0;
mbed_official 76:aeb1df146756 275 i2sdiv = (uint16_t)2;
mbed_official 76:aeb1df146756 276 }
mbed_official 76:aeb1df146756 277 /* If the requested audio frequency is not the default, compute the prescaler */
mbed_official 76:aeb1df146756 278 else
mbed_official 76:aeb1df146756 279 {
mbed_official 76:aeb1df146756 280 /* Check the frame length (For the Prescaler computing) */
mbed_official 76:aeb1df146756 281 if(I2S_InitStruct->I2S_DataFormat == I2S_DataFormat_16b)
mbed_official 76:aeb1df146756 282 {
mbed_official 76:aeb1df146756 283 /* Packet length is 16 bits */
mbed_official 76:aeb1df146756 284 packetlength = 1;
mbed_official 76:aeb1df146756 285 }
mbed_official 76:aeb1df146756 286 else
mbed_official 76:aeb1df146756 287 {
mbed_official 76:aeb1df146756 288 /* Packet length is 32 bits */
mbed_official 76:aeb1df146756 289 packetlength = 2;
mbed_official 76:aeb1df146756 290 }
mbed_official 76:aeb1df146756 291
mbed_official 76:aeb1df146756 292 /* I2S Clock source is System clock: Get System Clock frequency */
mbed_official 76:aeb1df146756 293 RCC_GetClocksFreq(&RCC_Clocks);
mbed_official 76:aeb1df146756 294
mbed_official 76:aeb1df146756 295 /* Get the source clock value: based on System Clock value */
mbed_official 76:aeb1df146756 296 sourceclock = RCC_Clocks.SYSCLK_Frequency;
mbed_official 76:aeb1df146756 297
mbed_official 76:aeb1df146756 298 /* Compute the Real divider depending on the MCLK output state with a flaoting point */
mbed_official 76:aeb1df146756 299 if(I2S_InitStruct->I2S_MCLKOutput == I2S_MCLKOutput_Enable)
mbed_official 76:aeb1df146756 300 {
mbed_official 76:aeb1df146756 301 /* MCLK output is enabled */
mbed_official 76:aeb1df146756 302 tmp = (uint16_t)(((((sourceclock / 256) * 10) / I2S_InitStruct->I2S_AudioFreq)) + 5);
mbed_official 76:aeb1df146756 303 }
mbed_official 76:aeb1df146756 304 else
mbed_official 76:aeb1df146756 305 {
mbed_official 76:aeb1df146756 306 /* MCLK output is disabled */
mbed_official 76:aeb1df146756 307 tmp = (uint16_t)(((((sourceclock / (32 * packetlength)) *10 ) / I2S_InitStruct->I2S_AudioFreq)) + 5);
mbed_official 76:aeb1df146756 308 }
mbed_official 76:aeb1df146756 309
mbed_official 76:aeb1df146756 310 /* Remove the flaoting point */
mbed_official 76:aeb1df146756 311 tmp = tmp / 10;
mbed_official 76:aeb1df146756 312
mbed_official 76:aeb1df146756 313 /* Check the parity of the divider */
mbed_official 76:aeb1df146756 314 i2sodd = (uint16_t)(tmp & (uint16_t)0x0001);
mbed_official 76:aeb1df146756 315
mbed_official 76:aeb1df146756 316 /* Compute the i2sdiv prescaler */
mbed_official 76:aeb1df146756 317 i2sdiv = (uint16_t)((tmp - i2sodd) / 2);
mbed_official 76:aeb1df146756 318
mbed_official 76:aeb1df146756 319 /* Get the Mask for the Odd bit (SPI_I2SPR[8]) register */
mbed_official 76:aeb1df146756 320 i2sodd = (uint16_t) (i2sodd << 8);
mbed_official 76:aeb1df146756 321 }
mbed_official 76:aeb1df146756 322
mbed_official 76:aeb1df146756 323 /* Test if the divider is 1 or 0 or greater than 0xFF */
mbed_official 76:aeb1df146756 324 if ((i2sdiv < 2) || (i2sdiv > 0xFF))
mbed_official 76:aeb1df146756 325 {
mbed_official 76:aeb1df146756 326 /* Set the default values */
mbed_official 76:aeb1df146756 327 i2sdiv = 2;
mbed_official 76:aeb1df146756 328 i2sodd = 0;
mbed_official 76:aeb1df146756 329 }
mbed_official 76:aeb1df146756 330
mbed_official 76:aeb1df146756 331 /* Write to SPIx I2SPR register the computed value */
mbed_official 76:aeb1df146756 332 SPIx->I2SPR = (uint16_t)(i2sdiv | (uint16_t)(i2sodd | (uint16_t)I2S_InitStruct->I2S_MCLKOutput));
mbed_official 76:aeb1df146756 333
mbed_official 76:aeb1df146756 334 /* Configure the I2S with the SPI_InitStruct values */
mbed_official 76:aeb1df146756 335 tmpreg |= (uint16_t)(SPI_I2SCFGR_I2SMOD | (uint16_t)(I2S_InitStruct->I2S_Mode | \
mbed_official 76:aeb1df146756 336 (uint16_t)(I2S_InitStruct->I2S_Standard | (uint16_t)(I2S_InitStruct->I2S_DataFormat | \
mbed_official 76:aeb1df146756 337 (uint16_t)I2S_InitStruct->I2S_CPOL))));
mbed_official 76:aeb1df146756 338
mbed_official 76:aeb1df146756 339 /* Write to SPIx I2SCFGR */
mbed_official 76:aeb1df146756 340 SPIx->I2SCFGR = tmpreg;
mbed_official 76:aeb1df146756 341 }
mbed_official 76:aeb1df146756 342
mbed_official 76:aeb1df146756 343 /**
mbed_official 76:aeb1df146756 344 * @brief Fills each SPI_InitStruct member with its default value.
mbed_official 76:aeb1df146756 345 * @param SPI_InitStruct: pointer to a SPI_InitTypeDef structure which will be initialized.
mbed_official 76:aeb1df146756 346 * @retval None
mbed_official 76:aeb1df146756 347 */
mbed_official 76:aeb1df146756 348 void SPI_StructInit(SPI_InitTypeDef* SPI_InitStruct)
mbed_official 76:aeb1df146756 349 {
mbed_official 76:aeb1df146756 350 /*--------------- Reset SPI init structure parameters values -----------------*/
mbed_official 76:aeb1df146756 351 /* Initialize the SPI_Direction member */
mbed_official 76:aeb1df146756 352 SPI_InitStruct->SPI_Direction = SPI_Direction_2Lines_FullDuplex;
mbed_official 76:aeb1df146756 353 /* initialize the SPI_Mode member */
mbed_official 76:aeb1df146756 354 SPI_InitStruct->SPI_Mode = SPI_Mode_Slave;
mbed_official 76:aeb1df146756 355 /* initialize the SPI_DataSize member */
mbed_official 76:aeb1df146756 356 SPI_InitStruct->SPI_DataSize = SPI_DataSize_8b;
mbed_official 76:aeb1df146756 357 /* Initialize the SPI_CPOL member */
mbed_official 76:aeb1df146756 358 SPI_InitStruct->SPI_CPOL = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 359 /* Initialize the SPI_CPHA member */
mbed_official 76:aeb1df146756 360 SPI_InitStruct->SPI_CPHA = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 361 /* Initialize the SPI_NSS member */
mbed_official 76:aeb1df146756 362 SPI_InitStruct->SPI_NSS = SPI_NSS_Hard;
mbed_official 76:aeb1df146756 363 /* Initialize the SPI_BaudRatePrescaler member */
mbed_official 76:aeb1df146756 364 SPI_InitStruct->SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_2;
mbed_official 76:aeb1df146756 365 /* Initialize the SPI_FirstBit member */
mbed_official 76:aeb1df146756 366 SPI_InitStruct->SPI_FirstBit = SPI_FirstBit_MSB;
mbed_official 76:aeb1df146756 367 /* Initialize the SPI_CRCPolynomial member */
mbed_official 76:aeb1df146756 368 SPI_InitStruct->SPI_CRCPolynomial = 7;
mbed_official 76:aeb1df146756 369 }
mbed_official 76:aeb1df146756 370
mbed_official 76:aeb1df146756 371 /**
mbed_official 76:aeb1df146756 372 * @brief Fills each I2S_InitStruct member with its default value.
mbed_official 76:aeb1df146756 373 * @param I2S_InitStruct: pointer to a I2S_InitTypeDef structure which will be initialized.
mbed_official 76:aeb1df146756 374 * @retval None
mbed_official 76:aeb1df146756 375 */
mbed_official 76:aeb1df146756 376 void I2S_StructInit(I2S_InitTypeDef* I2S_InitStruct)
mbed_official 76:aeb1df146756 377 {
mbed_official 76:aeb1df146756 378 /*--------------- Reset I2S init structure parameters values -----------------*/
mbed_official 76:aeb1df146756 379 /* Initialize the I2S_Mode member */
mbed_official 76:aeb1df146756 380 I2S_InitStruct->I2S_Mode = I2S_Mode_SlaveTx;
mbed_official 76:aeb1df146756 381
mbed_official 76:aeb1df146756 382 /* Initialize the I2S_Standard member */
mbed_official 76:aeb1df146756 383 I2S_InitStruct->I2S_Standard = I2S_Standard_Phillips;
mbed_official 76:aeb1df146756 384
mbed_official 76:aeb1df146756 385 /* Initialize the I2S_DataFormat member */
mbed_official 76:aeb1df146756 386 I2S_InitStruct->I2S_DataFormat = I2S_DataFormat_16b;
mbed_official 76:aeb1df146756 387
mbed_official 76:aeb1df146756 388 /* Initialize the I2S_MCLKOutput member */
mbed_official 76:aeb1df146756 389 I2S_InitStruct->I2S_MCLKOutput = I2S_MCLKOutput_Disable;
mbed_official 76:aeb1df146756 390
mbed_official 76:aeb1df146756 391 /* Initialize the I2S_AudioFreq member */
mbed_official 76:aeb1df146756 392 I2S_InitStruct->I2S_AudioFreq = I2S_AudioFreq_Default;
mbed_official 76:aeb1df146756 393
mbed_official 76:aeb1df146756 394 /* Initialize the I2S_CPOL member */
mbed_official 76:aeb1df146756 395 I2S_InitStruct->I2S_CPOL = I2S_CPOL_Low;
mbed_official 76:aeb1df146756 396 }
mbed_official 76:aeb1df146756 397
mbed_official 76:aeb1df146756 398 /**
mbed_official 76:aeb1df146756 399 * @brief Enables or disables the specified SPI peripheral.
mbed_official 76:aeb1df146756 400 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 401 * @param NewState: new state of the SPIx peripheral.
mbed_official 76:aeb1df146756 402 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 403 * @retval None
mbed_official 76:aeb1df146756 404 */
mbed_official 76:aeb1df146756 405 void SPI_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState)
mbed_official 76:aeb1df146756 406 {
mbed_official 76:aeb1df146756 407 /* Check the parameters */
mbed_official 76:aeb1df146756 408 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 409 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 410 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 411 {
mbed_official 76:aeb1df146756 412 /* Enable the selected SPI peripheral */
mbed_official 76:aeb1df146756 413 SPIx->CR1 |= SPI_CR1_SPE;
mbed_official 76:aeb1df146756 414 }
mbed_official 76:aeb1df146756 415 else
mbed_official 76:aeb1df146756 416 {
mbed_official 76:aeb1df146756 417 /* Disable the selected SPI peripheral */
mbed_official 76:aeb1df146756 418 SPIx->CR1 &= (uint16_t)~((uint16_t)SPI_CR1_SPE);
mbed_official 76:aeb1df146756 419 }
mbed_official 76:aeb1df146756 420 }
mbed_official 76:aeb1df146756 421
mbed_official 76:aeb1df146756 422 /**
mbed_official 76:aeb1df146756 423 * @brief Enables or disables the specified SPI peripheral (in I2S mode).
mbed_official 76:aeb1df146756 424 * @param SPIx: where x can be 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 425 * @param NewState: new state of the SPIx peripheral.
mbed_official 76:aeb1df146756 426 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 427 * @retval None
mbed_official 76:aeb1df146756 428 */
mbed_official 76:aeb1df146756 429 void I2S_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState)
mbed_official 76:aeb1df146756 430 {
mbed_official 76:aeb1df146756 431 /* Check the parameters */
mbed_official 76:aeb1df146756 432 assert_param(IS_SPI_23_PERIPH(SPIx));
mbed_official 76:aeb1df146756 433 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 434
mbed_official 76:aeb1df146756 435 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 436 {
mbed_official 76:aeb1df146756 437 /* Enable the selected SPI peripheral (in I2S mode) */
mbed_official 76:aeb1df146756 438 SPIx->I2SCFGR |= SPI_I2SCFGR_I2SE;
mbed_official 76:aeb1df146756 439 }
mbed_official 76:aeb1df146756 440 else
mbed_official 76:aeb1df146756 441 {
mbed_official 76:aeb1df146756 442 /* Disable the selected SPI peripheral in I2S mode */
mbed_official 76:aeb1df146756 443 SPIx->I2SCFGR &= (uint16_t)~((uint16_t)SPI_I2SCFGR_I2SE);
mbed_official 76:aeb1df146756 444 }
mbed_official 76:aeb1df146756 445 }
mbed_official 76:aeb1df146756 446
mbed_official 76:aeb1df146756 447 /**
mbed_official 76:aeb1df146756 448 * @brief Configures the data size for the selected SPI.
mbed_official 76:aeb1df146756 449 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 450 * @param SPI_DataSize: specifies the SPI data size.
mbed_official 76:aeb1df146756 451 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 452 * @arg SPI_DataSize_16b: Set data frame format to 16bit.
mbed_official 76:aeb1df146756 453 * @arg SPI_DataSize_8b: Set data frame format to 8bit.
mbed_official 76:aeb1df146756 454 * @retval None.
mbed_official 76:aeb1df146756 455 */
mbed_official 76:aeb1df146756 456 void SPI_DataSizeConfig(SPI_TypeDef* SPIx, uint16_t SPI_DataSize)
mbed_official 76:aeb1df146756 457 {
mbed_official 76:aeb1df146756 458 /* Check the parameters */
mbed_official 76:aeb1df146756 459 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 460 assert_param(IS_SPI_DATASIZE(SPI_DataSize));
mbed_official 76:aeb1df146756 461 /* Clear DFF bit */
mbed_official 76:aeb1df146756 462 SPIx->CR1 &= (uint16_t)~SPI_DataSize_16b;
mbed_official 76:aeb1df146756 463 /* Set new DFF bit value */
mbed_official 76:aeb1df146756 464 SPIx->CR1 |= SPI_DataSize;
mbed_official 76:aeb1df146756 465 }
mbed_official 76:aeb1df146756 466
mbed_official 76:aeb1df146756 467 /**
mbed_official 76:aeb1df146756 468 * @brief Selects the data transfer direction in bidirectional mode for the specified SPI.
mbed_official 76:aeb1df146756 469 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 470 * @param SPI_Direction: specifies the data transfer direction in bidirectional mode.
mbed_official 76:aeb1df146756 471 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 472 * @arg SPI_Direction_Tx: Selects Tx transmission direction.
mbed_official 76:aeb1df146756 473 * @arg SPI_Direction_Rx: Selects Rx receive direction.
mbed_official 76:aeb1df146756 474 * @retval None
mbed_official 76:aeb1df146756 475 */
mbed_official 76:aeb1df146756 476 void SPI_BiDirectionalLineConfig(SPI_TypeDef* SPIx, uint16_t SPI_Direction)
mbed_official 76:aeb1df146756 477 {
mbed_official 76:aeb1df146756 478 /* Check the parameters */
mbed_official 76:aeb1df146756 479 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 480 assert_param(IS_SPI_DIRECTION(SPI_Direction));
mbed_official 76:aeb1df146756 481 if (SPI_Direction == SPI_Direction_Tx)
mbed_official 76:aeb1df146756 482 {
mbed_official 76:aeb1df146756 483 /* Set the Tx only mode */
mbed_official 76:aeb1df146756 484 SPIx->CR1 |= SPI_Direction_Tx;
mbed_official 76:aeb1df146756 485 }
mbed_official 76:aeb1df146756 486 else
mbed_official 76:aeb1df146756 487 {
mbed_official 76:aeb1df146756 488 /* Set the Rx only mode */
mbed_official 76:aeb1df146756 489 SPIx->CR1 &= SPI_Direction_Rx;
mbed_official 76:aeb1df146756 490 }
mbed_official 76:aeb1df146756 491 }
mbed_official 76:aeb1df146756 492
mbed_official 76:aeb1df146756 493 /**
mbed_official 76:aeb1df146756 494 * @brief Configures internally by software the NSS pin for the selected SPI.
mbed_official 76:aeb1df146756 495 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 496 * @param SPI_NSSInternalSoft: specifies the SPI NSS internal state.
mbed_official 76:aeb1df146756 497 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 498 * @arg SPI_NSSInternalSoft_Set: Set NSS pin internally.
mbed_official 76:aeb1df146756 499 * @arg SPI_NSSInternalSoft_Reset: Reset NSS pin internally.
mbed_official 76:aeb1df146756 500 * @retval None
mbed_official 76:aeb1df146756 501 */
mbed_official 76:aeb1df146756 502 void SPI_NSSInternalSoftwareConfig(SPI_TypeDef* SPIx, uint16_t SPI_NSSInternalSoft)
mbed_official 76:aeb1df146756 503 {
mbed_official 76:aeb1df146756 504 /* Check the parameters */
mbed_official 76:aeb1df146756 505 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 506 assert_param(IS_SPI_NSS_INTERNAL(SPI_NSSInternalSoft));
mbed_official 76:aeb1df146756 507 if (SPI_NSSInternalSoft != SPI_NSSInternalSoft_Reset)
mbed_official 76:aeb1df146756 508 {
mbed_official 76:aeb1df146756 509 /* Set NSS pin internally by software */
mbed_official 76:aeb1df146756 510 SPIx->CR1 |= SPI_NSSInternalSoft_Set;
mbed_official 76:aeb1df146756 511 }
mbed_official 76:aeb1df146756 512 else
mbed_official 76:aeb1df146756 513 {
mbed_official 76:aeb1df146756 514 /* Reset NSS pin internally by software */
mbed_official 76:aeb1df146756 515 SPIx->CR1 &= SPI_NSSInternalSoft_Reset;
mbed_official 76:aeb1df146756 516 }
mbed_official 76:aeb1df146756 517 }
mbed_official 76:aeb1df146756 518
mbed_official 76:aeb1df146756 519 /**
mbed_official 76:aeb1df146756 520 * @brief Enables or disables the SS output for the selected SPI.
mbed_official 76:aeb1df146756 521 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 522 * @param NewState: new state of the SPIx SS output.
mbed_official 76:aeb1df146756 523 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 524 * @retval None
mbed_official 76:aeb1df146756 525 */
mbed_official 76:aeb1df146756 526 void SPI_SSOutputCmd(SPI_TypeDef* SPIx, FunctionalState NewState)
mbed_official 76:aeb1df146756 527 {
mbed_official 76:aeb1df146756 528 /* Check the parameters */
mbed_official 76:aeb1df146756 529 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 530 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 531 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 532 {
mbed_official 76:aeb1df146756 533 /* Enable the selected SPI SS output */
mbed_official 76:aeb1df146756 534 SPIx->CR2 |= (uint16_t)SPI_CR2_SSOE;
mbed_official 76:aeb1df146756 535 }
mbed_official 76:aeb1df146756 536 else
mbed_official 76:aeb1df146756 537 {
mbed_official 76:aeb1df146756 538 /* Disable the selected SPI SS output */
mbed_official 76:aeb1df146756 539 SPIx->CR2 &= (uint16_t)~((uint16_t)SPI_CR2_SSOE);
mbed_official 76:aeb1df146756 540 }
mbed_official 76:aeb1df146756 541 }
mbed_official 76:aeb1df146756 542
mbed_official 76:aeb1df146756 543 /**
mbed_official 76:aeb1df146756 544 * @}
mbed_official 76:aeb1df146756 545 */
mbed_official 76:aeb1df146756 546
mbed_official 76:aeb1df146756 547 /** @defgroup SPI_Group2 Data transfers functions
mbed_official 76:aeb1df146756 548 * @brief Data transfers functions
mbed_official 76:aeb1df146756 549 *
mbed_official 76:aeb1df146756 550 @verbatim
mbed_official 76:aeb1df146756 551 ===============================================================================
mbed_official 76:aeb1df146756 552 ##### Data transfers functions #####
mbed_official 76:aeb1df146756 553 ===============================================================================
mbed_official 76:aeb1df146756 554 ....[..] This section provides a set of functions allowing to manage the SPI data
mbed_official 76:aeb1df146756 555 transfers.
mbed_official 76:aeb1df146756 556 ....[..] In reception, data are received and then stored into an internal Rx buffer
mbed_official 76:aeb1df146756 557 while In transmission, data are first stored into an internal Tx buffer
mbed_official 76:aeb1df146756 558 before being transmitted.
mbed_official 76:aeb1df146756 559 ....[..] The read access of the SPI_DR register can be done using the
mbed_official 76:aeb1df146756 560 SPI_I2S_ReceiveData() function and returns the Rx buffered value.
mbed_official 76:aeb1df146756 561 Whereas a write access to the SPI_DR can be done using SPI_I2S_SendData()
mbed_official 76:aeb1df146756 562 function and stores the written data into Tx buffer.
mbed_official 76:aeb1df146756 563
mbed_official 76:aeb1df146756 564 @endverbatim
mbed_official 76:aeb1df146756 565 * @{
mbed_official 76:aeb1df146756 566 */
mbed_official 76:aeb1df146756 567
mbed_official 76:aeb1df146756 568 /**
mbed_official 76:aeb1df146756 569 * @brief Returns the most recent received data by the SPIx/I2Sx peripheral.
mbed_official 76:aeb1df146756 570 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 571 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 572 * @retval The value of the received data.
mbed_official 76:aeb1df146756 573 */
mbed_official 76:aeb1df146756 574 uint16_t SPI_I2S_ReceiveData(SPI_TypeDef* SPIx)
mbed_official 76:aeb1df146756 575 {
mbed_official 76:aeb1df146756 576 /* Check the parameters */
mbed_official 76:aeb1df146756 577 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 578
mbed_official 76:aeb1df146756 579 /* Return the data in the DR register */
mbed_official 76:aeb1df146756 580 return SPIx->DR;
mbed_official 76:aeb1df146756 581 }
mbed_official 76:aeb1df146756 582
mbed_official 76:aeb1df146756 583 /**
mbed_official 76:aeb1df146756 584 * @brief Transmits a Data through the SPIx/I2Sx peripheral.
mbed_official 76:aeb1df146756 585 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 586 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 587 * @param Data: Data to be transmitted.
mbed_official 76:aeb1df146756 588 * @retval None
mbed_official 76:aeb1df146756 589 */
mbed_official 76:aeb1df146756 590 void SPI_I2S_SendData(SPI_TypeDef* SPIx, uint16_t Data)
mbed_official 76:aeb1df146756 591 {
mbed_official 76:aeb1df146756 592 /* Check the parameters */
mbed_official 76:aeb1df146756 593 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 594
mbed_official 76:aeb1df146756 595 /* Write in the DR register the data to be sent */
mbed_official 76:aeb1df146756 596 SPIx->DR = Data;
mbed_official 76:aeb1df146756 597 }
mbed_official 76:aeb1df146756 598
mbed_official 76:aeb1df146756 599 /**
mbed_official 76:aeb1df146756 600 * @}
mbed_official 76:aeb1df146756 601 */
mbed_official 76:aeb1df146756 602
mbed_official 76:aeb1df146756 603 /** @defgroup SPI_Group3 Hardware CRC Calculation functions
mbed_official 76:aeb1df146756 604 * @brief Hardware CRC Calculation functions
mbed_official 76:aeb1df146756 605 *
mbed_official 76:aeb1df146756 606 @verbatim
mbed_official 76:aeb1df146756 607 ===============================================================================
mbed_official 76:aeb1df146756 608 ##### Hardware CRC Calculation functions #####
mbed_official 76:aeb1df146756 609 ===============================================================================
mbed_official 76:aeb1df146756 610 [..] This section provides a set of functions allowing to manage the SPI CRC
mbed_official 76:aeb1df146756 611 hardware calculation SPI communication using CRC is possible through
mbed_official 76:aeb1df146756 612 the following procedure:
mbed_official 76:aeb1df146756 613 (#) Program the Data direction, Polarity, Phase, First Data, Baud Rate
mbed_official 76:aeb1df146756 614 Prescaler, Slave Management, Peripheral Mode and CRC Polynomial
mbed_official 76:aeb1df146756 615 values using the SPI_Init() function.
mbed_official 76:aeb1df146756 616 (#) Enable the CRC calculation using the SPI_CalculateCRC() function.
mbed_official 76:aeb1df146756 617 (#) Enable the SPI using the SPI_Cmd() function.
mbed_official 76:aeb1df146756 618 (#) Before writing the last data to the TX buffer, set the CRCNext bit
mbed_official 76:aeb1df146756 619 using the SPI_TransmitCRC() function to indicate that after
mbed_official 76:aeb1df146756 620 transmission of the last data, the CRC should be transmitted.
mbed_official 76:aeb1df146756 621 (#) After transmitting the last data, the SPI transmits the CRC.
mbed_official 76:aeb1df146756 622 The SPI_CR1_CRCNEXT bit is reset. The CRC is also received and
mbed_official 76:aeb1df146756 623 compared against the SPI_RXCRCR value.
mbed_official 76:aeb1df146756 624 If the value does not match, the SPI_FLAG_CRCERR flag is set and an
mbed_official 76:aeb1df146756 625 interrupt can be generated when the SPI_I2S_IT_ERR interrupt is enabled.
mbed_official 76:aeb1df146756 626 -@-
mbed_official 76:aeb1df146756 627 (+@) It is advised to don't read the calculate CRC values during the communication.
mbed_official 76:aeb1df146756 628 (+@) When the SPI is in slave mode, be careful to enable CRC calculation only
mbed_official 76:aeb1df146756 629 when the clock is stable, that is, when the clock is in the steady state.
mbed_official 76:aeb1df146756 630 If not, a wrong CRC calculation may be done. In fact, the CRC is sensitive
mbed_official 76:aeb1df146756 631 to the SCK slave input clock as soon as CRCEN is set, and this, whatever
mbed_official 76:aeb1df146756 632 the value of the SPE bit.
mbed_official 76:aeb1df146756 633 (+@) With high bitrate frequencies, be careful when transmitting the CRC.
mbed_official 76:aeb1df146756 634 As the number of used CPU cycles has to be as low as possible in the CRC
mbed_official 76:aeb1df146756 635 transfer phase, it is forbidden to call software functions in the CRC
mbed_official 76:aeb1df146756 636 transmission sequence to avoid errors in the last data and CRC reception.
mbed_official 76:aeb1df146756 637 In fact, CRCNEXT bit has to be written before the end of the transmission/
mbed_official 76:aeb1df146756 638 reception of the last data.
mbed_official 76:aeb1df146756 639 (+@) For high bit rate frequencies, it is advised to use the DMA mode to avoid the
mbed_official 76:aeb1df146756 640 degradation of the SPI speed performance due to CPU accesses impacting the
mbed_official 76:aeb1df146756 641 SPI bandwidth.
mbed_official 76:aeb1df146756 642 (+@) When the STM32L15xxx are configured as slaves and the NSS hardware mode is
mbed_official 76:aeb1df146756 643 used, the NSS pin needs to be kept low between the data phase and the CRC
mbed_official 76:aeb1df146756 644 phase.
mbed_official 76:aeb1df146756 645 (+@) When the SPI is configured in slave mode with the CRC feature enabled, CRC
mbed_official 76:aeb1df146756 646 calculation takes place even if a high level is applied on the NSS pin.
mbed_official 76:aeb1df146756 647 This may happen for example in case of a multislave environment where the
mbed_official 76:aeb1df146756 648 communication master addresses slaves alternately.
mbed_official 76:aeb1df146756 649 (+@) Between a slave deselection (high level on NSS) and a new slave selection
mbed_official 76:aeb1df146756 650 (low level on NSS), the CRC value should be cleared on both master and slave
mbed_official 76:aeb1df146756 651 sides in order to resynchronize the master and slave for their respective
mbed_official 76:aeb1df146756 652 CRC calculation.
mbed_official 76:aeb1df146756 653 -@- To clear the CRC, follow the procedure below:
mbed_official 76:aeb1df146756 654 (#@) Disable SPI using the SPI_Cmd() function
mbed_official 76:aeb1df146756 655 (#@) Disable the CRC calculation using the SPI_CalculateCRC() function.
mbed_official 76:aeb1df146756 656 (#@) Enable the CRC calculation using the SPI_CalculateCRC() function.
mbed_official 76:aeb1df146756 657 (#@) Enable SPI using the SPI_Cmd() function.
mbed_official 76:aeb1df146756 658
mbed_official 76:aeb1df146756 659 @endverbatim
mbed_official 76:aeb1df146756 660 * @{
mbed_official 76:aeb1df146756 661 */
mbed_official 76:aeb1df146756 662
mbed_official 76:aeb1df146756 663 /**
mbed_official 76:aeb1df146756 664 * @brief Enables or disables the CRC value calculation of the transferred bytes.
mbed_official 76:aeb1df146756 665 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 666 * @param NewState: new state of the SPIx CRC value calculation.
mbed_official 76:aeb1df146756 667 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 668 * @retval None
mbed_official 76:aeb1df146756 669 */
mbed_official 76:aeb1df146756 670 void SPI_CalculateCRC(SPI_TypeDef* SPIx, FunctionalState NewState)
mbed_official 76:aeb1df146756 671 {
mbed_official 76:aeb1df146756 672 /* Check the parameters */
mbed_official 76:aeb1df146756 673 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 674 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 675 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 676 {
mbed_official 76:aeb1df146756 677 /* Enable the selected SPI CRC calculation */
mbed_official 76:aeb1df146756 678 SPIx->CR1 |= SPI_CR1_CRCEN;
mbed_official 76:aeb1df146756 679 }
mbed_official 76:aeb1df146756 680 else
mbed_official 76:aeb1df146756 681 {
mbed_official 76:aeb1df146756 682 /* Disable the selected SPI CRC calculation */
mbed_official 76:aeb1df146756 683 SPIx->CR1 &= (uint16_t)~((uint16_t)SPI_CR1_CRCEN);
mbed_official 76:aeb1df146756 684 }
mbed_official 76:aeb1df146756 685 }
mbed_official 76:aeb1df146756 686
mbed_official 76:aeb1df146756 687 /**
mbed_official 76:aeb1df146756 688 * @brief Transmit the SPIx CRC value.
mbed_official 76:aeb1df146756 689 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 690 * @retval None
mbed_official 76:aeb1df146756 691 */
mbed_official 76:aeb1df146756 692 void SPI_TransmitCRC(SPI_TypeDef* SPIx)
mbed_official 76:aeb1df146756 693 {
mbed_official 76:aeb1df146756 694 /* Check the parameters */
mbed_official 76:aeb1df146756 695 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 696
mbed_official 76:aeb1df146756 697 /* Enable the selected SPI CRC transmission */
mbed_official 76:aeb1df146756 698 SPIx->CR1 |= SPI_CR1_CRCNEXT;
mbed_official 76:aeb1df146756 699 }
mbed_official 76:aeb1df146756 700
mbed_official 76:aeb1df146756 701 /**
mbed_official 76:aeb1df146756 702 * @brief Returns the transmit or the receive CRC register value for the specified SPI.
mbed_official 76:aeb1df146756 703 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 704 * @param SPI_CRC: specifies the CRC register to be read.
mbed_official 76:aeb1df146756 705 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 706 * @arg SPI_CRC_Tx: Selects Tx CRC register.
mbed_official 76:aeb1df146756 707 * @arg SPI_CRC_Rx: Selects Rx CRC register.
mbed_official 76:aeb1df146756 708 * @retval The selected CRC register value.
mbed_official 76:aeb1df146756 709 */
mbed_official 76:aeb1df146756 710 uint16_t SPI_GetCRC(SPI_TypeDef* SPIx, uint8_t SPI_CRC)
mbed_official 76:aeb1df146756 711 {
mbed_official 76:aeb1df146756 712 uint16_t crcreg = 0;
mbed_official 76:aeb1df146756 713 /* Check the parameters */
mbed_official 76:aeb1df146756 714 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 715 assert_param(IS_SPI_CRC(SPI_CRC));
mbed_official 76:aeb1df146756 716 if (SPI_CRC != SPI_CRC_Rx)
mbed_official 76:aeb1df146756 717 {
mbed_official 76:aeb1df146756 718 /* Get the Tx CRC register */
mbed_official 76:aeb1df146756 719 crcreg = SPIx->TXCRCR;
mbed_official 76:aeb1df146756 720 }
mbed_official 76:aeb1df146756 721 else
mbed_official 76:aeb1df146756 722 {
mbed_official 76:aeb1df146756 723 /* Get the Rx CRC register */
mbed_official 76:aeb1df146756 724 crcreg = SPIx->RXCRCR;
mbed_official 76:aeb1df146756 725 }
mbed_official 76:aeb1df146756 726 /* Return the selected CRC register */
mbed_official 76:aeb1df146756 727 return crcreg;
mbed_official 76:aeb1df146756 728 }
mbed_official 76:aeb1df146756 729
mbed_official 76:aeb1df146756 730 /**
mbed_official 76:aeb1df146756 731 * @brief Returns the CRC Polynomial register value for the specified SPI.
mbed_official 76:aeb1df146756 732 * @param SPIx: where x can be 1, 2 or 3 to select the SPI peripheral.
mbed_official 76:aeb1df146756 733 * @retval The CRC Polynomial register value.
mbed_official 76:aeb1df146756 734 */
mbed_official 76:aeb1df146756 735 uint16_t SPI_GetCRCPolynomial(SPI_TypeDef* SPIx)
mbed_official 76:aeb1df146756 736 {
mbed_official 76:aeb1df146756 737 /* Check the parameters */
mbed_official 76:aeb1df146756 738 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 739
mbed_official 76:aeb1df146756 740 /* Return the CRC polynomial register */
mbed_official 76:aeb1df146756 741 return SPIx->CRCPR;
mbed_official 76:aeb1df146756 742 }
mbed_official 76:aeb1df146756 743
mbed_official 76:aeb1df146756 744 /**
mbed_official 76:aeb1df146756 745 * @}
mbed_official 76:aeb1df146756 746 */
mbed_official 76:aeb1df146756 747
mbed_official 76:aeb1df146756 748 /** @defgroup SPI_Group4 DMA transfers management functions
mbed_official 76:aeb1df146756 749 * @brief DMA transfers management functions
mbed_official 76:aeb1df146756 750 *
mbed_official 76:aeb1df146756 751 @verbatim
mbed_official 76:aeb1df146756 752 ===============================================================================
mbed_official 76:aeb1df146756 753 ##### DMA transfers management functions #####
mbed_official 76:aeb1df146756 754 ===============================================================================
mbed_official 76:aeb1df146756 755
mbed_official 76:aeb1df146756 756 @endverbatim
mbed_official 76:aeb1df146756 757 * @{
mbed_official 76:aeb1df146756 758 */
mbed_official 76:aeb1df146756 759
mbed_official 76:aeb1df146756 760 /**
mbed_official 76:aeb1df146756 761 * @brief Enables or disables the SPIx/I2Sx DMA interface.
mbed_official 76:aeb1df146756 762 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 763 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 764 * @param SPI_I2S_DMAReq: specifies the SPI DMA transfer request to be enabled or disabled.
mbed_official 76:aeb1df146756 765 * This parameter can be any combination of the following values:
mbed_official 76:aeb1df146756 766 * @arg SPI_I2S_DMAReq_Tx: Tx buffer DMA transfer request.
mbed_official 76:aeb1df146756 767 * @arg SPI_I2S_DMAReq_Rx: Rx buffer DMA transfer request.
mbed_official 76:aeb1df146756 768 * @param NewState: new state of the selected SPI DMA transfer request.
mbed_official 76:aeb1df146756 769 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 770 * @retval None
mbed_official 76:aeb1df146756 771 */
mbed_official 76:aeb1df146756 772 void SPI_I2S_DMACmd(SPI_TypeDef* SPIx, uint16_t SPI_I2S_DMAReq, FunctionalState NewState)
mbed_official 76:aeb1df146756 773 {
mbed_official 76:aeb1df146756 774 /* Check the parameters */
mbed_official 76:aeb1df146756 775 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 776 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 777 assert_param(IS_SPI_I2S_DMAREQ(SPI_I2S_DMAReq));
mbed_official 76:aeb1df146756 778
mbed_official 76:aeb1df146756 779 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 780 {
mbed_official 76:aeb1df146756 781 /* Enable the selected SPI DMA requests */
mbed_official 76:aeb1df146756 782 SPIx->CR2 |= SPI_I2S_DMAReq;
mbed_official 76:aeb1df146756 783 }
mbed_official 76:aeb1df146756 784 else
mbed_official 76:aeb1df146756 785 {
mbed_official 76:aeb1df146756 786 /* Disable the selected SPI DMA requests */
mbed_official 76:aeb1df146756 787 SPIx->CR2 &= (uint16_t)~SPI_I2S_DMAReq;
mbed_official 76:aeb1df146756 788 }
mbed_official 76:aeb1df146756 789 }
mbed_official 76:aeb1df146756 790
mbed_official 76:aeb1df146756 791 /**
mbed_official 76:aeb1df146756 792 * @}
mbed_official 76:aeb1df146756 793 */
mbed_official 76:aeb1df146756 794
mbed_official 76:aeb1df146756 795 /** @defgroup SPI_Group5 Interrupts and flags management functions
mbed_official 76:aeb1df146756 796 * @brief Interrupts and flags management functions
mbed_official 76:aeb1df146756 797 *
mbed_official 76:aeb1df146756 798 @verbatim
mbed_official 76:aeb1df146756 799 ===============================================================================
mbed_official 76:aeb1df146756 800 ##### Interrupts and flags management functions #####
mbed_official 76:aeb1df146756 801 ===============================================================================
mbed_official 76:aeb1df146756 802 [..] This section provides a set of functions allowing to configure the SPI
mbed_official 76:aeb1df146756 803 Interrupts sources and check or clear the flags or pending bits status.
mbed_official 76:aeb1df146756 804 The user should identify which mode will be used in his application to
mbed_official 76:aeb1df146756 805 manage the communication: Polling mode, Interrupt mode or DMA mode.
mbed_official 76:aeb1df146756 806 *** Polling Mode ***
mbed_official 76:aeb1df146756 807 ====================
mbed_official 76:aeb1df146756 808 [..] In Polling Mode, the SPI/I2S communication can be managed by 9 flags:
mbed_official 76:aeb1df146756 809 (#) SPI_I2S_FLAG_TXE : to indicate the status of the transmit buffer
mbed_official 76:aeb1df146756 810 register.
mbed_official 76:aeb1df146756 811 (#) SPI_I2S_FLAG_RXNE : to indicate the status of the receive buffer
mbed_official 76:aeb1df146756 812 register.
mbed_official 76:aeb1df146756 813 (#) SPI_I2S_FLAG_BSY : to indicate the state of the communication layer
mbed_official 76:aeb1df146756 814 of the SPI.
mbed_official 76:aeb1df146756 815 (#) SPI_FLAG_CRCERR : to indicate if a CRC Calculation error occur.
mbed_official 76:aeb1df146756 816 (#) SPI_FLAG_MODF : to indicate if a Mode Fault error occur.
mbed_official 76:aeb1df146756 817 (#) SPI_I2S_FLAG_OVR : to indicate if an Overrun error occur.
mbed_official 76:aeb1df146756 818 (#) SPI_I2S_FLAG_FRE: to indicate a Frame Format error occurs.
mbed_official 76:aeb1df146756 819 (#) I2S_FLAG_UDR: to indicate an Underrun error occurs.
mbed_official 76:aeb1df146756 820 (#) I2S_FLAG_CHSIDE: to indicate Channel Side.
mbed_official 76:aeb1df146756 821 -@- Do not use the BSY flag to handle each data transmission or reception.
mbed_official 76:aeb1df146756 822 It is better to use the TXE and RXNE flags instead.
mbed_official 76:aeb1df146756 823 [..] In this Mode it is advised to use the following functions:
mbed_official 76:aeb1df146756 824 (+) FlagStatus SPI_I2S_GetFlagStatus(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG).
mbed_official 76:aeb1df146756 825 (+) void SPI_I2S_ClearFlag(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG).
mbed_official 76:aeb1df146756 826
mbed_official 76:aeb1df146756 827 *** Interrupt Mode ***
mbed_official 76:aeb1df146756 828 ======================
mbed_official 76:aeb1df146756 829 [..] In Interrupt Mode, the SPI communication can be managed by 3 interrupt
mbed_official 76:aeb1df146756 830 sources and 7 pending bits:
mbed_official 76:aeb1df146756 831 [..] Pending Bits:
mbed_official 76:aeb1df146756 832 (#) SPI_I2S_IT_TXE : to indicate the status of the transmit buffer register.
mbed_official 76:aeb1df146756 833 (#) SPI_I2S_IT_RXNE : to indicate the status of the receive buffer register.
mbed_official 76:aeb1df146756 834 (#) SPI_IT_CRCERR : to indicate if a CRC Calculation error occur.
mbed_official 76:aeb1df146756 835 (#) SPI_IT_MODF : to indicate if a Mode Fault error occur.
mbed_official 76:aeb1df146756 836 (#) SPI_I2S_IT_OVR : to indicate if an Overrun error occur.
mbed_official 76:aeb1df146756 837 (#) I2S_IT_UDR : to indicate an Underrun Error occurs.
mbed_official 76:aeb1df146756 838 (#) SPI_I2S_FLAG_FRE : to indicate a Frame Format error occurs.
mbed_official 76:aeb1df146756 839 [..] Interrupt Source:
mbed_official 76:aeb1df146756 840 (#) SPI_I2S_IT_TXE: specifies the interrupt source for the Tx buffer empty
mbed_official 76:aeb1df146756 841 interrupt.
mbed_official 76:aeb1df146756 842 (#) SPI_I2S_IT_RXNE : specifies the interrupt source for the Rx buffer not
mbed_official 76:aeb1df146756 843 empty interrupt.
mbed_official 76:aeb1df146756 844 (#) SPI_I2S_IT_ERR : specifies the interrupt source for the errors interrupt.
mbed_official 76:aeb1df146756 845 [..] In this Mode it is advised to use the following functions:
mbed_official 76:aeb1df146756 846 (+) void SPI_I2S_ITConfig(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT,
mbed_official 76:aeb1df146756 847 FunctionalState NewState).
mbed_official 76:aeb1df146756 848 (+) ITStatus SPI_I2S_GetITStatus(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT).
mbed_official 76:aeb1df146756 849 (+) void SPI_I2S_ClearITPendingBit(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT).
mbed_official 76:aeb1df146756 850
mbed_official 76:aeb1df146756 851 *** DMA Mode ***
mbed_official 76:aeb1df146756 852 ================
mbed_official 76:aeb1df146756 853 [..] In DMA Mode, the SPI communication can be managed by 2 DMA Channel
mbed_official 76:aeb1df146756 854 requests:
mbed_official 76:aeb1df146756 855 (#) SPI_I2S_DMAReq_Tx: specifies the Tx buffer DMA transfer request.
mbed_official 76:aeb1df146756 856 (#) SPI_I2S_DMAReq_Rx: specifies the Rx buffer DMA transfer request.
mbed_official 76:aeb1df146756 857
mbed_official 76:aeb1df146756 858 [..] In this Mode it is advised to use the following function:
mbed_official 76:aeb1df146756 859 (+) void SPI_I2S_DMACmd(SPI_TypeDef* SPIx, uint16_t SPI_I2S_DMAReq,
mbed_official 76:aeb1df146756 860 FunctionalState NewState).
mbed_official 76:aeb1df146756 861
mbed_official 76:aeb1df146756 862 @endverbatim
mbed_official 76:aeb1df146756 863 * @{
mbed_official 76:aeb1df146756 864 */
mbed_official 76:aeb1df146756 865
mbed_official 76:aeb1df146756 866 /**
mbed_official 76:aeb1df146756 867 * @brief Enables or disables the specified SPI/I2S interrupts.
mbed_official 76:aeb1df146756 868 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 869 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 870
mbed_official 76:aeb1df146756 871 * @param SPI_I2S_IT: specifies the SPI interrupt source to be enabled or disabled.
mbed_official 76:aeb1df146756 872 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 873 * @arg SPI_I2S_IT_TXE: Tx buffer empty interrupt mask.
mbed_official 76:aeb1df146756 874 * @arg SPI_I2S_IT_RXNE: Rx buffer not empty interrupt mask.
mbed_official 76:aeb1df146756 875 * @arg SPI_I2S_IT_ERR: Error interrupt mask.
mbed_official 76:aeb1df146756 876 * @param NewState: new state of the specified SPI interrupt.
mbed_official 76:aeb1df146756 877 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 878 * @retval None
mbed_official 76:aeb1df146756 879 */
mbed_official 76:aeb1df146756 880 void SPI_I2S_ITConfig(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT, FunctionalState NewState)
mbed_official 76:aeb1df146756 881 {
mbed_official 76:aeb1df146756 882 uint16_t itpos = 0, itmask = 0 ;
mbed_official 76:aeb1df146756 883
mbed_official 76:aeb1df146756 884 /* Check the parameters */
mbed_official 76:aeb1df146756 885 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 886 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 887 assert_param(IS_SPI_I2S_CONFIG_IT(SPI_I2S_IT));
mbed_official 76:aeb1df146756 888
mbed_official 76:aeb1df146756 889 /* Get the SPI IT index */
mbed_official 76:aeb1df146756 890 itpos = SPI_I2S_IT >> 4;
mbed_official 76:aeb1df146756 891
mbed_official 76:aeb1df146756 892 /* Set the IT mask */
mbed_official 76:aeb1df146756 893 itmask = (uint16_t)1 << (uint16_t)itpos;
mbed_official 76:aeb1df146756 894
mbed_official 76:aeb1df146756 895 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 896 {
mbed_official 76:aeb1df146756 897 /* Enable the selected SPI interrupt */
mbed_official 76:aeb1df146756 898 SPIx->CR2 |= itmask;
mbed_official 76:aeb1df146756 899 }
mbed_official 76:aeb1df146756 900 else
mbed_official 76:aeb1df146756 901 {
mbed_official 76:aeb1df146756 902 /* Disable the selected SPI interrupt */
mbed_official 76:aeb1df146756 903 SPIx->CR2 &= (uint16_t)~itmask;
mbed_official 76:aeb1df146756 904 }
mbed_official 76:aeb1df146756 905 }
mbed_official 76:aeb1df146756 906
mbed_official 76:aeb1df146756 907 /**
mbed_official 76:aeb1df146756 908 * @brief Checks whether the specified SPIx/I2Sx flag is set or not.
mbed_official 76:aeb1df146756 909 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 910 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 911
mbed_official 76:aeb1df146756 912 * @param SPI_I2S_FLAG: specifies the SPI flag to check.
mbed_official 76:aeb1df146756 913 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 914 * @arg SPI_I2S_FLAG_TXE: Transmit buffer empty flag.
mbed_official 76:aeb1df146756 915 * @arg SPI_I2S_FLAG_RXNE: Receive buffer not empty flag.
mbed_official 76:aeb1df146756 916 * @arg SPI_I2S_FLAG_BSY: Busy flag.
mbed_official 76:aeb1df146756 917 * @arg SPI_I2S_FLAG_OVR: Overrun flag.
mbed_official 76:aeb1df146756 918 * @arg SPI_FLAG_MODF: Mode Fault flag.
mbed_official 76:aeb1df146756 919 * @arg SPI_FLAG_CRCERR: CRC Error flag.
mbed_official 76:aeb1df146756 920 * @arg SPI_I2S_FLAG_FRE: Format Error.
mbed_official 76:aeb1df146756 921 * @arg I2S_FLAG_UDR: Underrun Error flag.
mbed_official 76:aeb1df146756 922 * @arg I2S_FLAG_CHSIDE: Channel Side flag.
mbed_official 76:aeb1df146756 923 * @retval The new state of SPI_I2S_FLAG (SET or RESET).
mbed_official 76:aeb1df146756 924 */
mbed_official 76:aeb1df146756 925 FlagStatus SPI_I2S_GetFlagStatus(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG)
mbed_official 76:aeb1df146756 926 {
mbed_official 76:aeb1df146756 927 FlagStatus bitstatus = RESET;
mbed_official 76:aeb1df146756 928 /* Check the parameters */
mbed_official 76:aeb1df146756 929 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 930 assert_param(IS_SPI_I2S_GET_FLAG(SPI_I2S_FLAG));
mbed_official 76:aeb1df146756 931
mbed_official 76:aeb1df146756 932 /* Check the status of the specified SPI flag */
mbed_official 76:aeb1df146756 933 if ((SPIx->SR & SPI_I2S_FLAG) != (uint16_t)RESET)
mbed_official 76:aeb1df146756 934 {
mbed_official 76:aeb1df146756 935 /* SPI_I2S_FLAG is set */
mbed_official 76:aeb1df146756 936 bitstatus = SET;
mbed_official 76:aeb1df146756 937 }
mbed_official 76:aeb1df146756 938 else
mbed_official 76:aeb1df146756 939 {
mbed_official 76:aeb1df146756 940 /* SPI_I2S_FLAG is reset */
mbed_official 76:aeb1df146756 941 bitstatus = RESET;
mbed_official 76:aeb1df146756 942 }
mbed_official 76:aeb1df146756 943 /* Return the SPI_I2S_FLAG status */
mbed_official 76:aeb1df146756 944 return bitstatus;
mbed_official 76:aeb1df146756 945 }
mbed_official 76:aeb1df146756 946
mbed_official 76:aeb1df146756 947 /**
mbed_official 76:aeb1df146756 948 * @brief Clears the SPIx CRC Error (CRCERR) flag.
mbed_official 76:aeb1df146756 949 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 950 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 951
mbed_official 76:aeb1df146756 952 * @param SPI_I2S_FLAG: specifies the SPI flag to clear.
mbed_official 76:aeb1df146756 953 * This function clears only CRCERR flag.
mbed_official 76:aeb1df146756 954
mbed_official 76:aeb1df146756 955 * @note OVR (OverRun error) flag is cleared by software sequence: a read
mbed_official 76:aeb1df146756 956 * operation to SPI_DR register (SPI_I2S_ReceiveData()) followed by a read
mbed_official 76:aeb1df146756 957 * operation to SPI_SR register (SPI_I2S_GetFlagStatus()).
mbed_official 76:aeb1df146756 958 * @note UDR (UnderRun error) flag is cleared by a read operation to
mbed_official 76:aeb1df146756 959 * SPI_SR register (SPI_I2S_GetFlagStatus()).
mbed_official 76:aeb1df146756 960 * @note MODF (Mode Fault) flag is cleared by software sequence: a read/write
mbed_official 76:aeb1df146756 961 * operation to SPI_SR register (SPI_I2S_GetFlagStatus()) followed by a
mbed_official 76:aeb1df146756 962 * write operation to SPI_CR1 register (SPI_Cmd() to enable the SPI).
mbed_official 76:aeb1df146756 963 * @retval None
mbed_official 76:aeb1df146756 964 */
mbed_official 76:aeb1df146756 965 void SPI_I2S_ClearFlag(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG)
mbed_official 76:aeb1df146756 966 {
mbed_official 76:aeb1df146756 967 /* Check the parameters */
mbed_official 76:aeb1df146756 968 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 969 assert_param(IS_SPI_I2S_CLEAR_FLAG(SPI_I2S_FLAG));
mbed_official 76:aeb1df146756 970
mbed_official 76:aeb1df146756 971 /* Clear the selected SPI CRC Error (CRCERR) flag */
mbed_official 76:aeb1df146756 972 SPIx->SR = (uint16_t)~SPI_I2S_FLAG;
mbed_official 76:aeb1df146756 973 }
mbed_official 76:aeb1df146756 974
mbed_official 76:aeb1df146756 975 /**
mbed_official 76:aeb1df146756 976 * @brief Checks whether the specified SPIx/I2Sx interrupt has occurred or not.
mbed_official 76:aeb1df146756 977 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 978 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 979
mbed_official 76:aeb1df146756 980 * @param SPI_I2S_IT: specifies the SPI interrupt source to check.
mbed_official 76:aeb1df146756 981 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 982 * @arg SPI_I2S_IT_TXE: Transmit buffer empty interrupt.
mbed_official 76:aeb1df146756 983 * @arg SPI_I2S_IT_RXNE: Receive buffer not empty interrupt.
mbed_official 76:aeb1df146756 984 * @arg SPI_I2S_IT_OVR: Overrun interrupt.
mbed_official 76:aeb1df146756 985 * @arg SPI_IT_MODF: Mode Fault interrupt.
mbed_official 76:aeb1df146756 986 * @arg SPI_IT_CRCERR: CRC Error interrupt.
mbed_official 76:aeb1df146756 987 * @arg I2S_IT_UDR: Underrun interrupt.
mbed_official 76:aeb1df146756 988 * @arg SPI_I2S_IT_FRE: Format Error interrupt.
mbed_official 76:aeb1df146756 989 * @retval The new state of SPI_I2S_IT (SET or RESET).
mbed_official 76:aeb1df146756 990 */
mbed_official 76:aeb1df146756 991 ITStatus SPI_I2S_GetITStatus(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT)
mbed_official 76:aeb1df146756 992 {
mbed_official 76:aeb1df146756 993 ITStatus bitstatus = RESET;
mbed_official 76:aeb1df146756 994 uint16_t itpos = 0, itmask = 0, enablestatus = 0;
mbed_official 76:aeb1df146756 995
mbed_official 76:aeb1df146756 996 /* Check the parameters */
mbed_official 76:aeb1df146756 997 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 998 assert_param(IS_SPI_I2S_GET_IT(SPI_I2S_IT));
mbed_official 76:aeb1df146756 999
mbed_official 76:aeb1df146756 1000 /* Get the SPI_I2S_IT index */
mbed_official 76:aeb1df146756 1001 itpos = 0x01 << (SPI_I2S_IT & 0x0F);
mbed_official 76:aeb1df146756 1002
mbed_official 76:aeb1df146756 1003 /* Get the SPI_I2S_IT IT mask */
mbed_official 76:aeb1df146756 1004 itmask = SPI_I2S_IT >> 4;
mbed_official 76:aeb1df146756 1005
mbed_official 76:aeb1df146756 1006 /* Set the IT mask */
mbed_official 76:aeb1df146756 1007 itmask = 0x01 << itmask;
mbed_official 76:aeb1df146756 1008
mbed_official 76:aeb1df146756 1009 /* Get the SPI_I2S_IT enable bit status */
mbed_official 76:aeb1df146756 1010 enablestatus = (SPIx->CR2 & itmask) ;
mbed_official 76:aeb1df146756 1011
mbed_official 76:aeb1df146756 1012 /* Check the status of the specified SPI interrupt */
mbed_official 76:aeb1df146756 1013 if (((SPIx->SR & itpos) != (uint16_t)RESET) && enablestatus)
mbed_official 76:aeb1df146756 1014 {
mbed_official 76:aeb1df146756 1015 /* SPI_I2S_IT is set */
mbed_official 76:aeb1df146756 1016 bitstatus = SET;
mbed_official 76:aeb1df146756 1017 }
mbed_official 76:aeb1df146756 1018 else
mbed_official 76:aeb1df146756 1019 {
mbed_official 76:aeb1df146756 1020 /* SPI_I2S_IT is reset */
mbed_official 76:aeb1df146756 1021 bitstatus = RESET;
mbed_official 76:aeb1df146756 1022 }
mbed_official 76:aeb1df146756 1023 /* Return the SPI_I2S_IT status */
mbed_official 76:aeb1df146756 1024 return bitstatus;
mbed_official 76:aeb1df146756 1025 }
mbed_official 76:aeb1df146756 1026
mbed_official 76:aeb1df146756 1027 /**
mbed_official 76:aeb1df146756 1028 * @brief Clears the SPIx CRC Error (CRCERR) interrupt pending bit.
mbed_official 76:aeb1df146756 1029 * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2 or 3
mbed_official 76:aeb1df146756 1030 * in SPI mode or 2 or 3 in I2S mode.
mbed_official 76:aeb1df146756 1031
mbed_official 76:aeb1df146756 1032 * @param SPI_I2S_IT: specifies the SPI interrupt pending bit to clear.
mbed_official 76:aeb1df146756 1033 * This function clears only CRCERR interrupt pending bit.
mbed_official 76:aeb1df146756 1034
mbed_official 76:aeb1df146756 1035 * OVR (OverRun Error) interrupt pending bit is cleared by software
mbed_official 76:aeb1df146756 1036 * sequence: a read operation to SPI_DR register (SPI_I2S_ReceiveData())
mbed_official 76:aeb1df146756 1037 * followed by a read operation to SPI_SR register (SPI_I2S_GetITStatus()).
mbed_official 76:aeb1df146756 1038 * @note UDR (UnderRun Error) interrupt pending bit is cleared by a read
mbed_official 76:aeb1df146756 1039 * operation to SPI_SR register (SPI_I2S_GetITStatus()).
mbed_official 76:aeb1df146756 1040 * @note MODF (Mode Fault) interrupt pending bit is cleared by software sequence:
mbed_official 76:aeb1df146756 1041 * a read/write operation to SPI_SR register (SPI_I2S_GetITStatus())
mbed_official 76:aeb1df146756 1042 * followed by a write operation to SPI_CR1 register (SPI_Cmd() to enable
mbed_official 76:aeb1df146756 1043 * the SPI).
mbed_official 76:aeb1df146756 1044 * @retval None
mbed_official 76:aeb1df146756 1045 */
mbed_official 76:aeb1df146756 1046 void SPI_I2S_ClearITPendingBit(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT)
mbed_official 76:aeb1df146756 1047 {
mbed_official 76:aeb1df146756 1048 uint16_t itpos = 0;
mbed_official 76:aeb1df146756 1049 /* Check the parameters */
mbed_official 76:aeb1df146756 1050 assert_param(IS_SPI_ALL_PERIPH(SPIx));
mbed_official 76:aeb1df146756 1051 assert_param(IS_SPI_I2S_CLEAR_IT(SPI_I2S_IT));
mbed_official 76:aeb1df146756 1052
mbed_official 76:aeb1df146756 1053 /* Get the SPI_I2S IT index */
mbed_official 76:aeb1df146756 1054 itpos = 0x01 << (SPI_I2S_IT & 0x0F);
mbed_official 76:aeb1df146756 1055
mbed_official 76:aeb1df146756 1056 /* Clear the selected SPI CRC Error (CRCERR) interrupt pending bit */
mbed_official 76:aeb1df146756 1057 SPIx->SR = (uint16_t)~itpos;
mbed_official 76:aeb1df146756 1058 }
mbed_official 76:aeb1df146756 1059
mbed_official 76:aeb1df146756 1060 /**
mbed_official 76:aeb1df146756 1061 * @}
mbed_official 76:aeb1df146756 1062 */
mbed_official 76:aeb1df146756 1063
mbed_official 76:aeb1df146756 1064 /**
mbed_official 76:aeb1df146756 1065 * @}
mbed_official 76:aeb1df146756 1066 */
mbed_official 76:aeb1df146756 1067
mbed_official 76:aeb1df146756 1068 /**
mbed_official 76:aeb1df146756 1069 * @}
mbed_official 76:aeb1df146756 1070 */
mbed_official 76:aeb1df146756 1071
mbed_official 76:aeb1df146756 1072 /**
mbed_official 76:aeb1df146756 1073 * @}
mbed_official 76:aeb1df146756 1074 */
mbed_official 76:aeb1df146756 1075
mbed_official 76:aeb1df146756 1076 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/