1 /**
2   ******************************************************************************
3   * @file    stm32l1xx_ll_spi.c
4   * @author  MCD Application Team
5   * @brief   SPI LL module driver.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2016 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 #if defined(USE_FULL_LL_DRIVER)
19 
20 /* Includes ------------------------------------------------------------------*/
21 #include "stm32l1xx_ll_spi.h"
22 #include "stm32l1xx_ll_bus.h"
23 #include "stm32l1xx_ll_rcc.h"
24 
25 #ifdef  USE_FULL_ASSERT
26 #include "stm32_assert.h"
27 #else
28 #define assert_param(expr) ((void)0U)
29 #endif /* USE_FULL_ASSERT */
30 
31 /** @addtogroup STM32L1xx_LL_Driver
32   * @{
33   */
34 
35 #if defined (SPI1) || defined (SPI2) || defined (SPI3)
36 
37 /** @addtogroup SPI_LL
38   * @{
39   */
40 
41 /* Private types -------------------------------------------------------------*/
42 /* Private variables ---------------------------------------------------------*/
43 
44 /* Private constants ---------------------------------------------------------*/
45 /** @defgroup SPI_LL_Private_Constants SPI Private Constants
46   * @{
47   */
48 /* SPI registers Masks */
49 #define SPI_CR1_CLEAR_MASK                 (SPI_CR1_CPHA    | SPI_CR1_CPOL     | SPI_CR1_MSTR   | \
50                                             SPI_CR1_BR      | SPI_CR1_LSBFIRST | SPI_CR1_SSI    | \
51                                             SPI_CR1_SSM     | SPI_CR1_RXONLY   | SPI_CR1_DFF    | \
52                                             SPI_CR1_CRCNEXT | SPI_CR1_CRCEN    | SPI_CR1_BIDIOE | \
53                                             SPI_CR1_BIDIMODE)
54 /**
55   * @}
56   */
57 
58 /* Private macros ------------------------------------------------------------*/
59 /** @defgroup SPI_LL_Private_Macros SPI Private Macros
60   * @{
61   */
62 #define IS_LL_SPI_TRANSFER_DIRECTION(__VALUE__) (((__VALUE__) == LL_SPI_FULL_DUPLEX)       \
63                                                  || ((__VALUE__) == LL_SPI_SIMPLEX_RX)     \
64                                                  || ((__VALUE__) == LL_SPI_HALF_DUPLEX_RX) \
65                                                  || ((__VALUE__) == LL_SPI_HALF_DUPLEX_TX))
66 
67 #define IS_LL_SPI_MODE(__VALUE__) (((__VALUE__) == LL_SPI_MODE_MASTER) \
68                                    || ((__VALUE__) == LL_SPI_MODE_SLAVE))
69 
70 #define IS_LL_SPI_DATAWIDTH(__VALUE__) (((__VALUE__) == LL_SPI_DATAWIDTH_8BIT)  \
71                                         || ((__VALUE__) == LL_SPI_DATAWIDTH_16BIT))
72 
73 #define IS_LL_SPI_POLARITY(__VALUE__) (((__VALUE__) == LL_SPI_POLARITY_LOW) \
74                                        || ((__VALUE__) == LL_SPI_POLARITY_HIGH))
75 
76 #define IS_LL_SPI_PHASE(__VALUE__) (((__VALUE__) == LL_SPI_PHASE_1EDGE) \
77                                     || ((__VALUE__) == LL_SPI_PHASE_2EDGE))
78 
79 #define IS_LL_SPI_NSS(__VALUE__) (((__VALUE__) == LL_SPI_NSS_SOFT)          \
80                                   || ((__VALUE__) == LL_SPI_NSS_HARD_INPUT) \
81                                   || ((__VALUE__) == LL_SPI_NSS_HARD_OUTPUT))
82 
83 #define IS_LL_SPI_BAUDRATE(__VALUE__) (((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV2)      \
84                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV4)   \
85                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV8)   \
86                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV16)  \
87                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV32)  \
88                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV64)  \
89                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV128) \
90                                        || ((__VALUE__) == LL_SPI_BAUDRATEPRESCALER_DIV256))
91 
92 #define IS_LL_SPI_BITORDER(__VALUE__) (((__VALUE__) == LL_SPI_LSB_FIRST) \
93                                        || ((__VALUE__) == LL_SPI_MSB_FIRST))
94 
95 #define IS_LL_SPI_CRCCALCULATION(__VALUE__) (((__VALUE__) == LL_SPI_CRCCALCULATION_ENABLE) \
96                                              || ((__VALUE__) == LL_SPI_CRCCALCULATION_DISABLE))
97 
98 #define IS_LL_SPI_CRC_POLYNOMIAL(__VALUE__) ((__VALUE__) >= 0x1U)
99 
100 /**
101   * @}
102   */
103 
104 /* Private function prototypes -----------------------------------------------*/
105 
106 /* Exported functions --------------------------------------------------------*/
107 /** @addtogroup SPI_LL_Exported_Functions
108   * @{
109   */
110 
111 /** @addtogroup SPI_LL_EF_Init
112   * @{
113   */
114 
115 /**
116   * @brief  De-initialize the SPI registers to their default reset values.
117   * @param  SPIx SPI Instance
118   * @retval An ErrorStatus enumeration value:
119   *          - SUCCESS: SPI registers are de-initialized
120   *          - ERROR: SPI registers are not de-initialized
121   */
LL_SPI_DeInit(SPI_TypeDef * SPIx)122 ErrorStatus LL_SPI_DeInit(SPI_TypeDef *SPIx)
123 {
124   ErrorStatus status = ERROR;
125 
126   /* Check the parameters */
127   assert_param(IS_SPI_ALL_INSTANCE(SPIx));
128 
129 #if defined(SPI1)
130   if (SPIx == SPI1)
131   {
132     /* Force reset of SPI clock */
133     LL_APB2_GRP1_ForceReset(LL_APB2_GRP1_PERIPH_SPI1);
134 
135     /* Release reset of SPI clock */
136     LL_APB2_GRP1_ReleaseReset(LL_APB2_GRP1_PERIPH_SPI1);
137 
138     status = SUCCESS;
139   }
140 #endif /* SPI1 */
141 #if defined(SPI2)
142   if (SPIx == SPI2)
143   {
144     /* Force reset of SPI clock */
145     LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_SPI2);
146 
147     /* Release reset of SPI clock */
148     LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_SPI2);
149 
150     status = SUCCESS;
151   }
152 #endif /* SPI2 */
153 #if defined(SPI3)
154   if (SPIx == SPI3)
155   {
156     /* Force reset of SPI clock */
157     LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_SPI3);
158 
159     /* Release reset of SPI clock */
160     LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_SPI3);
161 
162     status = SUCCESS;
163   }
164 #endif /* SPI3 */
165 
166   return status;
167 }
168 
169 /**
170   * @brief  Initialize the SPI registers according to the specified parameters in SPI_InitStruct.
171   * @note   As some bits in SPI configuration registers can only be written when the SPI is disabled (SPI_CR1_SPE bit =0),
172   *         SPI peripheral should be in disabled state prior calling this function. Otherwise, ERROR result will be returned.
173   * @param  SPIx SPI Instance
174   * @param  SPI_InitStruct pointer to a @ref LL_SPI_InitTypeDef structure
175   * @retval An ErrorStatus enumeration value. (Return always SUCCESS)
176   */
LL_SPI_Init(SPI_TypeDef * SPIx,LL_SPI_InitTypeDef * SPI_InitStruct)177 ErrorStatus LL_SPI_Init(SPI_TypeDef *SPIx, LL_SPI_InitTypeDef *SPI_InitStruct)
178 {
179   ErrorStatus status = ERROR;
180 
181   /* Check the SPI Instance SPIx*/
182   assert_param(IS_SPI_ALL_INSTANCE(SPIx));
183 
184   /* Check the SPI parameters from SPI_InitStruct*/
185   assert_param(IS_LL_SPI_TRANSFER_DIRECTION(SPI_InitStruct->TransferDirection));
186   assert_param(IS_LL_SPI_MODE(SPI_InitStruct->Mode));
187   assert_param(IS_LL_SPI_DATAWIDTH(SPI_InitStruct->DataWidth));
188   assert_param(IS_LL_SPI_POLARITY(SPI_InitStruct->ClockPolarity));
189   assert_param(IS_LL_SPI_PHASE(SPI_InitStruct->ClockPhase));
190   assert_param(IS_LL_SPI_NSS(SPI_InitStruct->NSS));
191   assert_param(IS_LL_SPI_BAUDRATE(SPI_InitStruct->BaudRate));
192   assert_param(IS_LL_SPI_BITORDER(SPI_InitStruct->BitOrder));
193   assert_param(IS_LL_SPI_CRCCALCULATION(SPI_InitStruct->CRCCalculation));
194 
195   if (LL_SPI_IsEnabled(SPIx) == 0x00000000U)
196   {
197     /*---------------------------- SPIx CR1 Configuration ------------------------
198      * Configure SPIx CR1 with parameters:
199      * - TransferDirection:  SPI_CR1_BIDIMODE, SPI_CR1_BIDIOE and SPI_CR1_RXONLY bits
200      * - Master/Slave Mode:  SPI_CR1_MSTR bit
201      * - DataWidth:          SPI_CR1_DFF bit
202      * - ClockPolarity:      SPI_CR1_CPOL bit
203      * - ClockPhase:         SPI_CR1_CPHA bit
204      * - NSS management:     SPI_CR1_SSM bit
205      * - BaudRate prescaler: SPI_CR1_BR[2:0] bits
206      * - BitOrder:           SPI_CR1_LSBFIRST bit
207      * - CRCCalculation:     SPI_CR1_CRCEN bit
208      */
209     MODIFY_REG(SPIx->CR1,
210                SPI_CR1_CLEAR_MASK,
211                SPI_InitStruct->TransferDirection | SPI_InitStruct->Mode | SPI_InitStruct->DataWidth |
212                SPI_InitStruct->ClockPolarity | SPI_InitStruct->ClockPhase |
213                SPI_InitStruct->NSS | SPI_InitStruct->BaudRate |
214                SPI_InitStruct->BitOrder | SPI_InitStruct->CRCCalculation);
215 
216     /*---------------------------- SPIx CR2 Configuration ------------------------
217      * Configure SPIx CR2 with parameters:
218      * - NSS management:     SSOE bit
219      */
220     MODIFY_REG(SPIx->CR2, SPI_CR2_SSOE, (SPI_InitStruct->NSS >> 16U));
221 
222     /*---------------------------- SPIx CRCPR Configuration ----------------------
223      * Configure SPIx CRCPR with parameters:
224      * - CRCPoly:            CRCPOLY[15:0] bits
225      */
226     if (SPI_InitStruct->CRCCalculation == LL_SPI_CRCCALCULATION_ENABLE)
227     {
228       assert_param(IS_LL_SPI_CRC_POLYNOMIAL(SPI_InitStruct->CRCPoly));
229       LL_SPI_SetCRCPolynomial(SPIx, SPI_InitStruct->CRCPoly);
230     }
231     status = SUCCESS;
232   }
233 
234 #if defined (SPI_I2S_SUPPORT)
235   /* Activate the SPI mode (Reset I2SMOD bit in I2SCFGR register) */
236   CLEAR_BIT(SPIx->I2SCFGR, SPI_I2SCFGR_I2SMOD);
237 #endif /* SPI_I2S_SUPPORT */
238   return status;
239 }
240 
241 /**
242   * @brief  Set each @ref LL_SPI_InitTypeDef field to default value.
243   * @param  SPI_InitStruct pointer to a @ref LL_SPI_InitTypeDef structure
244   * whose fields will be set to default values.
245   * @retval None
246   */
LL_SPI_StructInit(LL_SPI_InitTypeDef * SPI_InitStruct)247 void LL_SPI_StructInit(LL_SPI_InitTypeDef *SPI_InitStruct)
248 {
249   /* Set SPI_InitStruct fields to default values */
250   SPI_InitStruct->TransferDirection = LL_SPI_FULL_DUPLEX;
251   SPI_InitStruct->Mode              = LL_SPI_MODE_SLAVE;
252   SPI_InitStruct->DataWidth         = LL_SPI_DATAWIDTH_8BIT;
253   SPI_InitStruct->ClockPolarity     = LL_SPI_POLARITY_LOW;
254   SPI_InitStruct->ClockPhase        = LL_SPI_PHASE_1EDGE;
255   SPI_InitStruct->NSS               = LL_SPI_NSS_HARD_INPUT;
256   SPI_InitStruct->BaudRate          = LL_SPI_BAUDRATEPRESCALER_DIV2;
257   SPI_InitStruct->BitOrder          = LL_SPI_MSB_FIRST;
258   SPI_InitStruct->CRCCalculation    = LL_SPI_CRCCALCULATION_DISABLE;
259   SPI_InitStruct->CRCPoly           = 7U;
260 }
261 
262 /**
263   * @}
264   */
265 
266 /**
267   * @}
268   */
269 
270 /**
271   * @}
272   */
273 
274 #if defined(SPI_I2S_SUPPORT)
275 /** @addtogroup I2S_LL
276   * @{
277   */
278 
279 /* Private types -------------------------------------------------------------*/
280 /* Private variables ---------------------------------------------------------*/
281 /* Private constants ---------------------------------------------------------*/
282 /** @defgroup I2S_LL_Private_Constants I2S Private Constants
283   * @{
284   */
285 /* I2S registers Masks */
286 #define I2S_I2SCFGR_CLEAR_MASK             (SPI_I2SCFGR_CHLEN   | SPI_I2SCFGR_DATLEN | \
287                                             SPI_I2SCFGR_CKPOL   | SPI_I2SCFGR_I2SSTD | \
288                                             SPI_I2SCFGR_I2SCFG  | SPI_I2SCFGR_I2SMOD )
289 
290 #define I2S_I2SPR_CLEAR_MASK               0x0002U
291 /**
292   * @}
293   */
294 /* Private macros ------------------------------------------------------------*/
295 /** @defgroup I2S_LL_Private_Macros I2S Private Macros
296   * @{
297   */
298 
299 #define IS_LL_I2S_DATAFORMAT(__VALUE__)  (((__VALUE__) == LL_I2S_DATAFORMAT_16B)             \
300                                           || ((__VALUE__) == LL_I2S_DATAFORMAT_16B_EXTENDED) \
301                                           || ((__VALUE__) == LL_I2S_DATAFORMAT_24B)          \
302                                           || ((__VALUE__) == LL_I2S_DATAFORMAT_32B))
303 
304 #define IS_LL_I2S_CPOL(__VALUE__)        (((__VALUE__) == LL_I2S_POLARITY_LOW)  \
305                                           || ((__VALUE__) == LL_I2S_POLARITY_HIGH))
306 
307 #define IS_LL_I2S_STANDARD(__VALUE__)    (((__VALUE__) == LL_I2S_STANDARD_PHILIPS)      \
308                                           || ((__VALUE__) == LL_I2S_STANDARD_MSB)       \
309                                           || ((__VALUE__) == LL_I2S_STANDARD_LSB)       \
310                                           || ((__VALUE__) == LL_I2S_STANDARD_PCM_SHORT) \
311                                           || ((__VALUE__) == LL_I2S_STANDARD_PCM_LONG))
312 
313 #define IS_LL_I2S_MODE(__VALUE__)        (((__VALUE__) == LL_I2S_MODE_SLAVE_TX)     \
314                                           || ((__VALUE__) == LL_I2S_MODE_SLAVE_RX)  \
315                                           || ((__VALUE__) == LL_I2S_MODE_MASTER_TX) \
316                                           || ((__VALUE__) == LL_I2S_MODE_MASTER_RX))
317 
318 #define IS_LL_I2S_MCLK_OUTPUT(__VALUE__) (((__VALUE__) == LL_I2S_MCLK_OUTPUT_ENABLE) \
319                                           || ((__VALUE__) == LL_I2S_MCLK_OUTPUT_DISABLE))
320 
321 #define IS_LL_I2S_AUDIO_FREQ(__VALUE__) ((((__VALUE__) >= LL_I2S_AUDIOFREQ_8K)       \
322                                           && ((__VALUE__) <= LL_I2S_AUDIOFREQ_192K)) \
323                                          || ((__VALUE__) == LL_I2S_AUDIOFREQ_DEFAULT))
324 
325 #define IS_LL_I2S_PRESCALER_LINEAR(__VALUE__)  ((__VALUE__) >= 0x2U)
326 
327 #define IS_LL_I2S_PRESCALER_PARITY(__VALUE__) (((__VALUE__) == LL_I2S_PRESCALER_PARITY_EVEN) \
328                                                || ((__VALUE__) == LL_I2S_PRESCALER_PARITY_ODD))
329 /**
330   * @}
331   */
332 
333 /* Private function prototypes -----------------------------------------------*/
334 
335 /* Exported functions --------------------------------------------------------*/
336 /** @addtogroup I2S_LL_Exported_Functions
337   * @{
338   */
339 
340 /** @addtogroup I2S_LL_EF_Init
341   * @{
342   */
343 
344 /**
345   * @brief  De-initialize the SPI/I2S registers to their default reset values.
346   * @param  SPIx SPI Instance
347   * @retval An ErrorStatus enumeration value:
348   *          - SUCCESS: SPI registers are de-initialized
349   *          - ERROR: SPI registers are not de-initialized
350   */
LL_I2S_DeInit(SPI_TypeDef * SPIx)351 ErrorStatus LL_I2S_DeInit(SPI_TypeDef *SPIx)
352 {
353   return LL_SPI_DeInit(SPIx);
354 }
355 
356 /**
357   * @brief  Initializes the SPI/I2S registers according to the specified parameters in I2S_InitStruct.
358   * @note   As some bits in SPI configuration registers can only be written when the SPI is disabled (SPI_CR1_SPE bit =0),
359   *         SPI peripheral should be in disabled state prior calling this function. Otherwise, ERROR result will be returned.
360   * @param  SPIx SPI Instance
361   * @param  I2S_InitStruct pointer to a @ref LL_I2S_InitTypeDef structure
362   * @retval An ErrorStatus enumeration value:
363   *          - SUCCESS: SPI registers are Initialized
364   *          - ERROR: SPI registers are not Initialized
365   */
LL_I2S_Init(SPI_TypeDef * SPIx,LL_I2S_InitTypeDef * I2S_InitStruct)366 ErrorStatus LL_I2S_Init(SPI_TypeDef *SPIx, LL_I2S_InitTypeDef *I2S_InitStruct)
367 {
368   uint32_t i2sdiv = 2U;
369   uint32_t i2sodd = 0U;
370   uint32_t packetlength = 1U;
371   uint32_t tmp;
372   LL_RCC_ClocksTypeDef rcc_clocks;
373   uint32_t sourceclock;
374   ErrorStatus status = ERROR;
375 
376   /* Check the I2S parameters */
377   assert_param(IS_I2S_ALL_INSTANCE(SPIx));
378   assert_param(IS_LL_I2S_MODE(I2S_InitStruct->Mode));
379   assert_param(IS_LL_I2S_STANDARD(I2S_InitStruct->Standard));
380   assert_param(IS_LL_I2S_DATAFORMAT(I2S_InitStruct->DataFormat));
381   assert_param(IS_LL_I2S_MCLK_OUTPUT(I2S_InitStruct->MCLKOutput));
382   assert_param(IS_LL_I2S_AUDIO_FREQ(I2S_InitStruct->AudioFreq));
383   assert_param(IS_LL_I2S_CPOL(I2S_InitStruct->ClockPolarity));
384 
385   if (LL_I2S_IsEnabled(SPIx) == 0x00000000U)
386   {
387     /*---------------------------- SPIx I2SCFGR Configuration --------------------
388      * Configure SPIx I2SCFGR with parameters:
389      * - Mode:          SPI_I2SCFGR_I2SCFG[1:0] bit
390      * - Standard:      SPI_I2SCFGR_I2SSTD[1:0] and SPI_I2SCFGR_PCMSYNC bits
391      * - DataFormat:    SPI_I2SCFGR_CHLEN and SPI_I2SCFGR_DATLEN bits
392      * - ClockPolarity: SPI_I2SCFGR_CKPOL bit
393      */
394 
395     /* Write to SPIx I2SCFGR */
396     MODIFY_REG(SPIx->I2SCFGR,
397                I2S_I2SCFGR_CLEAR_MASK,
398                I2S_InitStruct->Mode | I2S_InitStruct->Standard |
399                I2S_InitStruct->DataFormat | I2S_InitStruct->ClockPolarity |
400                SPI_I2SCFGR_I2SMOD);
401 
402     /*---------------------------- SPIx I2SPR Configuration ----------------------
403      * Configure SPIx I2SPR with parameters:
404      * - MCLKOutput:    SPI_I2SPR_MCKOE bit
405      * - AudioFreq:     SPI_I2SPR_I2SDIV[7:0] and SPI_I2SPR_ODD bits
406      */
407 
408     /* If the requested audio frequency is not the default, compute the prescaler (i2sodd, i2sdiv)
409      * else, default values are used:  i2sodd = 0U, i2sdiv = 2U.
410      */
411     if (I2S_InitStruct->AudioFreq != LL_I2S_AUDIOFREQ_DEFAULT)
412     {
413       /* Check the frame length (For the Prescaler computing)
414        * Default value: LL_I2S_DATAFORMAT_16B (packetlength = 1U).
415        */
416       if (I2S_InitStruct->DataFormat != LL_I2S_DATAFORMAT_16B)
417       {
418         /* Packet length is 32 bits */
419         packetlength = 2U;
420       }
421 
422       /* I2S Clock source is System clock: Get System Clock frequency */
423       LL_RCC_GetSystemClocksFreq(&rcc_clocks);
424 
425       /* Get the source clock value: based on System Clock value */
426       sourceclock = rcc_clocks.SYSCLK_Frequency;
427 
428       /* Compute the Real divider depending on the MCLK output state with a floating point */
429       if (I2S_InitStruct->MCLKOutput == LL_I2S_MCLK_OUTPUT_ENABLE)
430       {
431         /* MCLK output is enabled */
432         tmp = (((((sourceclock / 256U) * 10U) / I2S_InitStruct->AudioFreq)) + 5U);
433       }
434       else
435       {
436         /* MCLK output is disabled */
437         tmp = (((((sourceclock / (32U * packetlength)) * 10U) / I2S_InitStruct->AudioFreq)) + 5U);
438       }
439 
440       /* Remove the floating point */
441       tmp = tmp / 10U;
442 
443       /* Check the parity of the divider */
444       i2sodd = (tmp & (uint16_t)0x0001U);
445 
446       /* Compute the i2sdiv prescaler */
447       i2sdiv = ((tmp - i2sodd) / 2U);
448 
449       /* Get the Mask for the Odd bit (SPI_I2SPR[8]) register */
450       i2sodd = (i2sodd << 8U);
451     }
452 
453     /* Test if the divider is 1 or 0 or greater than 0xFF */
454     if ((i2sdiv < 2U) || (i2sdiv > 0xFFU))
455     {
456       /* Set the default values */
457       i2sdiv = 2U;
458       i2sodd = 0U;
459     }
460 
461     /* Write to SPIx I2SPR register the computed value */
462     WRITE_REG(SPIx->I2SPR, i2sdiv | i2sodd | I2S_InitStruct->MCLKOutput);
463 
464     status = SUCCESS;
465   }
466   return status;
467 }
468 
469 /**
470   * @brief  Set each @ref LL_I2S_InitTypeDef field to default value.
471   * @param  I2S_InitStruct pointer to a @ref LL_I2S_InitTypeDef structure
472   *         whose fields will be set to default values.
473   * @retval None
474   */
LL_I2S_StructInit(LL_I2S_InitTypeDef * I2S_InitStruct)475 void LL_I2S_StructInit(LL_I2S_InitTypeDef *I2S_InitStruct)
476 {
477   /*--------------- Reset I2S init structure parameters values -----------------*/
478   I2S_InitStruct->Mode              = LL_I2S_MODE_SLAVE_TX;
479   I2S_InitStruct->Standard          = LL_I2S_STANDARD_PHILIPS;
480   I2S_InitStruct->DataFormat        = LL_I2S_DATAFORMAT_16B;
481   I2S_InitStruct->MCLKOutput        = LL_I2S_MCLK_OUTPUT_DISABLE;
482   I2S_InitStruct->AudioFreq         = LL_I2S_AUDIOFREQ_DEFAULT;
483   I2S_InitStruct->ClockPolarity     = LL_I2S_POLARITY_LOW;
484 }
485 
486 /**
487   * @brief  Set linear and parity prescaler.
488   * @note   To calculate value of PrescalerLinear(I2SDIV[7:0] bits) and PrescalerParity(ODD bit)\n
489   *         Check Audio frequency table and formulas inside Reference Manual (SPI/I2S).
490   * @param  SPIx SPI Instance
491   * @param  PrescalerLinear value Min_Data=0x02 and Max_Data=0xFF.
492   * @param  PrescalerParity This parameter can be one of the following values:
493   *         @arg @ref LL_I2S_PRESCALER_PARITY_EVEN
494   *         @arg @ref LL_I2S_PRESCALER_PARITY_ODD
495   * @retval None
496   */
LL_I2S_ConfigPrescaler(SPI_TypeDef * SPIx,uint32_t PrescalerLinear,uint32_t PrescalerParity)497 void LL_I2S_ConfigPrescaler(SPI_TypeDef *SPIx, uint32_t PrescalerLinear, uint32_t PrescalerParity)
498 {
499   /* Check the I2S parameters */
500   assert_param(IS_I2S_ALL_INSTANCE(SPIx));
501   assert_param(IS_LL_I2S_PRESCALER_LINEAR(PrescalerLinear));
502   assert_param(IS_LL_I2S_PRESCALER_PARITY(PrescalerParity));
503 
504   /* Write to SPIx I2SPR */
505   MODIFY_REG(SPIx->I2SPR, SPI_I2SPR_I2SDIV | SPI_I2SPR_ODD, PrescalerLinear | (PrescalerParity << 8U));
506 }
507 
508 /**
509   * @}
510   */
511 
512 /**
513   * @}
514   */
515 
516 /**
517   * @}
518   */
519 #endif /* SPI_I2S_SUPPORT */
520 
521 #endif /* defined (SPI1) || defined (SPI2) || defined (SPI3) */
522 
523 /**
524   * @}
525   */
526 
527 #endif /* USE_FULL_LL_DRIVER */
528 
529