mbed-dev - fix LPC812 PWM

Users » nameless129 » Code » mbed-dev

fix LPC812 PWM

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_sai.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:: bogdanm
Date:: Thu Oct 01 15:25:22 2015 +0300
Revision:: 0:9b334a45a8ff

Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

User	Revision	Line number	New contents of line
bogdanm	0:9b334a45a8ff	1	/**
bogdanm	0:9b334a45a8ff	2	******************************************************************************
bogdanm	0:9b334a45a8ff	3	* @file stm32l4xx_hal_sai.c
bogdanm	0:9b334a45a8ff	4	* @author MCD Application Team
bogdanm	0:9b334a45a8ff	5	* @version V1.0.0
bogdanm	0:9b334a45a8ff	6	* @date 26-June-2015
bogdanm	0:9b334a45a8ff	7	* @brief SAI HAL module driver.
bogdanm	0:9b334a45a8ff	8	* This file provides firmware functions to manage the following
bogdanm	0:9b334a45a8ff	9	* functionalities of the Serial Audio Interface (SAI) peripheral:
bogdanm	0:9b334a45a8ff	10	* + Initialization/de-initialization functions
bogdanm	0:9b334a45a8ff	11	* + I/O operation functions
bogdanm	0:9b334a45a8ff	12	* + Peripheral Control functions
bogdanm	0:9b334a45a8ff	13	* + Peripheral State functions
bogdanm	0:9b334a45a8ff	14	*
bogdanm	0:9b334a45a8ff	15	@verbatim
bogdanm	0:9b334a45a8ff	16	==============================================================================
bogdanm	0:9b334a45a8ff	17	##### How to use this driver #####
bogdanm	0:9b334a45a8ff	18	==============================================================================
bogdanm	0:9b334a45a8ff	19	[..]
bogdanm	0:9b334a45a8ff	20	The SAI HAL driver can be used as follows:
bogdanm	0:9b334a45a8ff	21
bogdanm	0:9b334a45a8ff	22	(#) Declare a SAI_HandleTypeDef handle structure (eg. SAI_HandleTypeDef hsai).
bogdanm	0:9b334a45a8ff	23	(#) Initialize the SAI low level resources by implementing the HAL_SAI_MspInit() API:
bogdanm	0:9b334a45a8ff	24	(##) Enable the SAI interface clock.
bogdanm	0:9b334a45a8ff	25	(##) SAI pins configuration:
bogdanm	0:9b334a45a8ff	26	(+++) Enable the clock for the SAI GPIOs.
bogdanm	0:9b334a45a8ff	27	(+++) Configure these SAI pins as alternate function pull-up.
bogdanm	0:9b334a45a8ff	28	(##) NVIC configuration if you need to use interrupt process (HAL_SAI_Transmit_IT()
bogdanm	0:9b334a45a8ff	29	and HAL_SAI_Receive_IT() APIs):
bogdanm	0:9b334a45a8ff	30	(+++) Configure the SAI interrupt priority.
bogdanm	0:9b334a45a8ff	31	(+++) Enable the NVIC SAI IRQ handle.
bogdanm	0:9b334a45a8ff	32
bogdanm	0:9b334a45a8ff	33	(##) DMA Configuration if you need to use DMA process (HAL_SAI_Transmit_DMA()
bogdanm	0:9b334a45a8ff	34	and HAL_SAI_Receive_DMA() APIs):
bogdanm	0:9b334a45a8ff	35	(+++) Declare a DMA handle structure for the Tx/Rx channel.
bogdanm	0:9b334a45a8ff	36	(+++) Enable the DMAx interface clock.
bogdanm	0:9b334a45a8ff	37	(+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
bogdanm	0:9b334a45a8ff	38	(+++) Configure the DMA Tx/Rx Channel.
bogdanm	0:9b334a45a8ff	39	(+++) Associate the initialized DMA handle to the SAI DMA Tx/Rx handle.
bogdanm	0:9b334a45a8ff	40	(+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the
bogdanm	0:9b334a45a8ff	41	DMA Tx/Rx Channel.
bogdanm	0:9b334a45a8ff	42
bogdanm	0:9b334a45a8ff	43	(#) The initialization can be done by two ways
bogdanm	0:9b334a45a8ff	44	(##) Expert mode : Initialize the structures Init, FrameInit and SlotInit and call HAL_SAI_Init().
bogdanm	0:9b334a45a8ff	45	(##) Simplified mode : Initialize the high part of Init Structure and call HAL_SAI_InitProtocol().
bogdanm	0:9b334a45a8ff	46
bogdanm	0:9b334a45a8ff	47	[..]
bogdanm	0:9b334a45a8ff	48	(@) The specific SAI interrupts (FIFO request and Overrun underrun interrupt)
bogdanm	0:9b334a45a8ff	49	will be managed using the macros __HAL_SAI_ENABLE_IT() and __HAL_SAI_DISABLE_IT()
bogdanm	0:9b334a45a8ff	50	inside the transmit and receive process.
bogdanm	0:9b334a45a8ff	51
bogdanm	0:9b334a45a8ff	52	[..]
bogdanm	0:9b334a45a8ff	53	(@) Make sure that either:
bogdanm	0:9b334a45a8ff	54	(+@) PLLSAI1CLK output is configured or
bogdanm	0:9b334a45a8ff	55	(+@) PLLSAI2CLK output is configured or
bogdanm	0:9b334a45a8ff	56	(+@) PLLSAI3CLK output is configured or
bogdanm	0:9b334a45a8ff	57	(+@) External clock source is configured after setting correctly
bogdanm	0:9b334a45a8ff	58	the define constant EXTERNAL_SAI1_CLOCK_VALUE or EXTERNAL_SAI2_CLOCK_VALUE in the stm32l4xx_hal_conf.h file.
bogdanm	0:9b334a45a8ff	59
bogdanm	0:9b334a45a8ff	60	[..]
bogdanm	0:9b334a45a8ff	61	(@) In master Tx mode: enabling the audio block immediately generates the bit clock
bogdanm	0:9b334a45a8ff	62	for the external slaves even if there is no data in the FIFO, However FS signal
bogdanm	0:9b334a45a8ff	63	generation is conditioned by the presence of data in the FIFO.
bogdanm	0:9b334a45a8ff	64
bogdanm	0:9b334a45a8ff	65	[..]
bogdanm	0:9b334a45a8ff	66	(@) In master Rx mode: enabling the audio block immediately generates the bit clock
bogdanm	0:9b334a45a8ff	67	and FS signal for the external slaves.
bogdanm	0:9b334a45a8ff	68
bogdanm	0:9b334a45a8ff	69	[..]
bogdanm	0:9b334a45a8ff	70	(@) It is mandatory to respect the following conditions in order to avoid bad SAI behavior:
bogdanm	0:9b334a45a8ff	71	(+@) First bit Offset <= (SLOT size - Data size)
bogdanm	0:9b334a45a8ff	72	(+@) Data size <= SLOT size
bogdanm	0:9b334a45a8ff	73	(+@) Number of SLOT x SLOT size = Frame length
bogdanm	0:9b334a45a8ff	74	(+@) The number of slots should be even when SAI_FS_CHANNEL_IDENTIFICATION is selected.
bogdanm	0:9b334a45a8ff	75
bogdanm	0:9b334a45a8ff	76	[..]
bogdanm	0:9b334a45a8ff	77	Three operation modes are available within this driver :
bogdanm	0:9b334a45a8ff	78
bogdanm	0:9b334a45a8ff	79	* Polling mode IO operation *
bogdanm	0:9b334a45a8ff	80	=================================
bogdanm	0:9b334a45a8ff	81	[..]
bogdanm	0:9b334a45a8ff	82	(+) Send an amount of data in blocking mode using HAL_SAI_Transmit()
bogdanm	0:9b334a45a8ff	83	(+) Receive an amount of data in blocking mode using HAL_SAI_Receive()
bogdanm	0:9b334a45a8ff	84
bogdanm	0:9b334a45a8ff	85	* Interrupt mode IO operation *
bogdanm	0:9b334a45a8ff	86	===================================
bogdanm	0:9b334a45a8ff	87	[..]
bogdanm	0:9b334a45a8ff	88	(+) Send an amount of data in non-blocking mode using HAL_SAI_Transmit_IT()
bogdanm	0:9b334a45a8ff	89	(+) At transmission end of transfer HAL_SAI_TxCpltCallback() is executed and user can
bogdanm	0:9b334a45a8ff	90	add his own code by customization of function pointer HAL_SAI_TxCpltCallback()
bogdanm	0:9b334a45a8ff	91	(+) Receive an amount of data in non-blocking mode using HAL_SAI_Receive_IT()
bogdanm	0:9b334a45a8ff	92	(+) At reception end of transfer HAL_SAI_RxCpltCallback() is executed and user can
bogdanm	0:9b334a45a8ff	93	add his own code by customization of function pointer HAL_SAI_RxCpltCallback()
bogdanm	0:9b334a45a8ff	94	(+) In case of flag error, HAL_SAI_ErrorCallback() function is executed and user can
bogdanm	0:9b334a45a8ff	95	add his own code by customization of function pointer HAL_SAI_ErrorCallback()
bogdanm	0:9b334a45a8ff	96
bogdanm	0:9b334a45a8ff	97	* DMA mode IO operation *
bogdanm	0:9b334a45a8ff	98	==============================
bogdanm	0:9b334a45a8ff	99	[..]
bogdanm	0:9b334a45a8ff	100	(+) Send an amount of data in non-blocking mode (DMA) using HAL_SAI_Transmit_DMA()
bogdanm	0:9b334a45a8ff	101	(+) At transmission end of transfer HAL_SAI_TxCpltCallback() is executed and user can
bogdanm	0:9b334a45a8ff	102	add his own code by customization of function pointer HAL_SAI_TxCpltCallback()
bogdanm	0:9b334a45a8ff	103	(+) Receive an amount of data in non-blocking mode (DMA) using HAL_SAI_Receive_DMA()
bogdanm	0:9b334a45a8ff	104	(+) At reception end of transfer HAL_SAI_RxCpltCallback() is executed and user can
bogdanm	0:9b334a45a8ff	105	add his own code by customization of function pointer HAL_SAI_RxCpltCallback()
bogdanm	0:9b334a45a8ff	106	(+) In case of flag error, HAL_SAI_ErrorCallback() function is executed and user can
bogdanm	0:9b334a45a8ff	107	add his own code by customization of function pointer HAL_SAI_ErrorCallback()
bogdanm	0:9b334a45a8ff	108	(+) Pause the DMA Transfer using HAL_SAI_DMAPause()
bogdanm	0:9b334a45a8ff	109	(+) Resume the DMA Transfer using HAL_SAI_DMAResume()
bogdanm	0:9b334a45a8ff	110	(+) Stop the DMA Transfer using HAL_SAI_DMAStop()
bogdanm	0:9b334a45a8ff	111
bogdanm	0:9b334a45a8ff	112	* SAI HAL driver additional function list *
bogdanm	0:9b334a45a8ff	113	=================================================
bogdanm	0:9b334a45a8ff	114	[..]
bogdanm	0:9b334a45a8ff	115	Below the list the others API available SAI HAL driver :
bogdanm	0:9b334a45a8ff	116
bogdanm	0:9b334a45a8ff	117	(+) HAL_SAI_EnableTxMuteMode(): Enable the mute in tx mode
bogdanm	0:9b334a45a8ff	118	(+) HAL_SAI_DisableTxMuteMode(): Disable the mute in tx mode
bogdanm	0:9b334a45a8ff	119	(+) HAL_SAI_EnableRxMuteMode(): Enable the mute in Rx mode
bogdanm	0:9b334a45a8ff	120	(+) HAL_SAI_DisableRxMuteMode(): Disable the mute in Rx mode
bogdanm	0:9b334a45a8ff	121	(+) HAL_SAI_FlushRxFifo(): Flush the rx fifo.
bogdanm	0:9b334a45a8ff	122	(+) HAL_SAI_Abort(): Abort the current transfer
bogdanm	0:9b334a45a8ff	123
bogdanm	0:9b334a45a8ff	124	* SAI HAL driver macros list *
bogdanm	0:9b334a45a8ff	125	=============================================
bogdanm	0:9b334a45a8ff	126	[..]
bogdanm	0:9b334a45a8ff	127	Below the list of most used macros in SAI HAL driver :
bogdanm	0:9b334a45a8ff	128
bogdanm	0:9b334a45a8ff	129	(+) __HAL_SAI_ENABLE(): Enable the SAI peripheral
bogdanm	0:9b334a45a8ff	130	(+) __HAL_SAI_DISABLE(): Disable the SAI peripheral
bogdanm	0:9b334a45a8ff	131	(+) __HAL_SAI_ENABLE_IT(): Enable the specified SAI interrupts
bogdanm	0:9b334a45a8ff	132	(+) __HAL_SAI_DISABLE_IT(): Disable the specified SAI interrupts
bogdanm	0:9b334a45a8ff	133	(+) __HAL_SAI_GET_IT_SOURCE(): Check if the specified SAI interrupt source is
bogdanm	0:9b334a45a8ff	134	enabled or disabled
bogdanm	0:9b334a45a8ff	135	(+) __HAL_SAI_GET_FLAG(): Check whether the specified SAI flag is set or not
bogdanm	0:9b334a45a8ff	136
bogdanm	0:9b334a45a8ff	137	@endverbatim
bogdanm	0:9b334a45a8ff	138	******************************************************************************
bogdanm	0:9b334a45a8ff	139	* @attention
bogdanm	0:9b334a45a8ff	140	*
bogdanm	0:9b334a45a8ff	141	* <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bogdanm	0:9b334a45a8ff	142	*
bogdanm	0:9b334a45a8ff	143	* Redistribution and use in source and binary forms, with or without modification,
bogdanm	0:9b334a45a8ff	144	* are permitted provided that the following conditions are met:
bogdanm	0:9b334a45a8ff	145	* 1. Redistributions of source code must retain the above copyright notice,
bogdanm	0:9b334a45a8ff	146	* this list of conditions and the following disclaimer.
bogdanm	0:9b334a45a8ff	147	* 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm	0:9b334a45a8ff	148	* this list of conditions and the following disclaimer in the documentation
bogdanm	0:9b334a45a8ff	149	* and/or other materials provided with the distribution.
bogdanm	0:9b334a45a8ff	150	* 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm	0:9b334a45a8ff	151	* may be used to endorse or promote products derived from this software
bogdanm	0:9b334a45a8ff	152	* without specific prior written permission.
bogdanm	0:9b334a45a8ff	153	*
bogdanm	0:9b334a45a8ff	154	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm	0:9b334a45a8ff	155	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm	0:9b334a45a8ff	156	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm	0:9b334a45a8ff	157	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm	0:9b334a45a8ff	158	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm	0:9b334a45a8ff	159	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm	0:9b334a45a8ff	160	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm	0:9b334a45a8ff	161	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm	0:9b334a45a8ff	162	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm	0:9b334a45a8ff	163	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm	0:9b334a45a8ff	164	*
bogdanm	0:9b334a45a8ff	165	******************************************************************************
bogdanm	0:9b334a45a8ff	166	*/
bogdanm	0:9b334a45a8ff	167
bogdanm	0:9b334a45a8ff	168	/* Includes ------------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	169	#include "stm32l4xx_hal.h"
bogdanm	0:9b334a45a8ff	170
bogdanm	0:9b334a45a8ff	171	/** @addtogroup STM32L4xx_HAL_Driver
bogdanm	0:9b334a45a8ff	172	* @{
bogdanm	0:9b334a45a8ff	173	*/
bogdanm	0:9b334a45a8ff	174
bogdanm	0:9b334a45a8ff	175	/** @defgroup SAI SAI
bogdanm	0:9b334a45a8ff	176	* @brief SAI HAL module driver
bogdanm	0:9b334a45a8ff	177	* @{
bogdanm	0:9b334a45a8ff	178	*/
bogdanm	0:9b334a45a8ff	179
bogdanm	0:9b334a45a8ff	180	#ifdef HAL_SAI_MODULE_ENABLED
bogdanm	0:9b334a45a8ff	181
bogdanm	0:9b334a45a8ff	182	/* Private typedef -----------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	183	/** @defgroup SAI_Private_Typedefs SAI Private Typedefs
bogdanm	0:9b334a45a8ff	184	* @{
bogdanm	0:9b334a45a8ff	185	*/
bogdanm	0:9b334a45a8ff	186	typedef enum {
bogdanm	0:9b334a45a8ff	187	SAI_MODE_DMA,
bogdanm	0:9b334a45a8ff	188	SAI_MODE_IT
bogdanm	0:9b334a45a8ff	189	}SAI_ModeTypedef;
bogdanm	0:9b334a45a8ff	190	/**
bogdanm	0:9b334a45a8ff	191	* @}
bogdanm	0:9b334a45a8ff	192	*/
bogdanm	0:9b334a45a8ff	193
bogdanm	0:9b334a45a8ff	194	/* Private define ------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	195	/** @defgroup SAI_Private_Constants SAI Private Constants
bogdanm	0:9b334a45a8ff	196	* @{
bogdanm	0:9b334a45a8ff	197	*/
bogdanm	0:9b334a45a8ff	198	#define SAI_FIFO_SIZE 8
bogdanm	0:9b334a45a8ff	199	#define SAI_DEFAULT_TIMEOUT 4
bogdanm	0:9b334a45a8ff	200	/**
bogdanm	0:9b334a45a8ff	201	* @}
bogdanm	0:9b334a45a8ff	202	*/
bogdanm	0:9b334a45a8ff	203
bogdanm	0:9b334a45a8ff	204	/* Private macro -------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	205	/* Private variables ---------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	206	/* Private function prototypes -----------------------------------------------*/
bogdanm	0:9b334a45a8ff	207	/** @defgroup SAI_Private_Functions SAI Private Functions
bogdanm	0:9b334a45a8ff	208	* @{
bogdanm	0:9b334a45a8ff	209	*/
bogdanm	0:9b334a45a8ff	210	static void SAI_FillFifo(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	211	static int32_t SAI_InterruptFlag(SAI_HandleTypeDef *hsai, uint32_t mode);
bogdanm	0:9b334a45a8ff	212	static HAL_StatusTypeDef SAI_InitI2S(SAI_HandleTypeDef *hsai, uint32_t protocol, uint32_t datasize, uint32_t nbslot);
bogdanm	0:9b334a45a8ff	213	static HAL_StatusTypeDef SAI_InitPCM(SAI_HandleTypeDef *hsai, uint32_t protocol, uint32_t datasize, uint32_t nbslot);
bogdanm	0:9b334a45a8ff	214
bogdanm	0:9b334a45a8ff	215	static HAL_StatusTypeDef SAI_Disable(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	216	static void SAI_Transmit_IT8Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	217	static void SAI_Transmit_IT16Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	218	static void SAI_Transmit_IT32Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	219	static void SAI_Receive_IT8Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	220	static void SAI_Receive_IT16Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	221	static void SAI_Receive_IT32Bit(SAI_HandleTypeDef *hsai);
bogdanm	0:9b334a45a8ff	222	static void SAI_DMATxCplt(DMA_HandleTypeDef *hdma);
bogdanm	0:9b334a45a8ff	223	static void SAI_DMATxHalfCplt(DMA_HandleTypeDef *hdma);
bogdanm	0:9b334a45a8ff	224	static void SAI_DMARxCplt(DMA_HandleTypeDef *hdma);
bogdanm	0:9b334a45a8ff	225	static void SAI_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
bogdanm	0:9b334a45a8ff	226	static void SAI_DMAError(DMA_HandleTypeDef *hdma);
bogdanm	0:9b334a45a8ff	227	/**
bogdanm	0:9b334a45a8ff	228	* @}
bogdanm	0:9b334a45a8ff	229	*/
bogdanm	0:9b334a45a8ff	230
bogdanm	0:9b334a45a8ff	231	/* Exported functions --------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	232
bogdanm	0:9b334a45a8ff	233	/** @defgroup SAI_Exported_Functions SAI Exported Functions
bogdanm	0:9b334a45a8ff	234	* @{
bogdanm	0:9b334a45a8ff	235	*/
bogdanm	0:9b334a45a8ff	236
bogdanm	0:9b334a45a8ff	237	/** @defgroup SAI_Exported_Functions_Group1 Initialization and de-initialization functions
bogdanm	0:9b334a45a8ff	238	* @brief Initialization and Configuration functions
bogdanm	0:9b334a45a8ff	239	*
bogdanm	0:9b334a45a8ff	240	@verbatim
bogdanm	0:9b334a45a8ff	241	===============================================================================
bogdanm	0:9b334a45a8ff	242	##### Initialization and de-initialization functions #####
bogdanm	0:9b334a45a8ff	243	===============================================================================
bogdanm	0:9b334a45a8ff	244	[..] This subsection provides a set of functions allowing to initialize and
bogdanm	0:9b334a45a8ff	245	de-initialize the SAIx peripheral:
bogdanm	0:9b334a45a8ff	246
bogdanm	0:9b334a45a8ff	247	(+) User must implement HAL_SAI_MspInit() function in which he configures
bogdanm	0:9b334a45a8ff	248	all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC ).
bogdanm	0:9b334a45a8ff	249
bogdanm	0:9b334a45a8ff	250	(+) Call the function HAL_SAI_Init() to configure the selected device with
bogdanm	0:9b334a45a8ff	251	the selected configuration:
bogdanm	0:9b334a45a8ff	252	(++) Mode (Master/slave TX/RX)
bogdanm	0:9b334a45a8ff	253	(++) Protocol
bogdanm	0:9b334a45a8ff	254	(++) Data Size
bogdanm	0:9b334a45a8ff	255	(++) MCLK Output
bogdanm	0:9b334a45a8ff	256	(++) Audio frequency
bogdanm	0:9b334a45a8ff	257	(++) FIFO Threshold
bogdanm	0:9b334a45a8ff	258	(++) Frame Config
bogdanm	0:9b334a45a8ff	259	(++) Slot Config
bogdanm	0:9b334a45a8ff	260
bogdanm	0:9b334a45a8ff	261	(+) Call the function HAL_SAI_DeInit() to restore the default configuration
bogdanm	0:9b334a45a8ff	262	of the selected SAI peripheral.
bogdanm	0:9b334a45a8ff	263
bogdanm	0:9b334a45a8ff	264	@endverbatim
bogdanm	0:9b334a45a8ff	265	* @{
bogdanm	0:9b334a45a8ff	266	*/
bogdanm	0:9b334a45a8ff	267
bogdanm	0:9b334a45a8ff	268	/**
bogdanm	0:9b334a45a8ff	269	* @brief Initialize the structure FrameInit, SlotInit and the low part of
bogdanm	0:9b334a45a8ff	270	* Init according to the specified parameters and call the function
bogdanm	0:9b334a45a8ff	271	* HAL_SAI_Init to initialize the SAI block.
bogdanm	0:9b334a45a8ff	272	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	273	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	274	* @param protocol: one of the supported protocol @ref SAI_Protocol
bogdanm	0:9b334a45a8ff	275	* @param datasize: one of the supported datasize @ref SAI_Protocol_DataSize
bogdanm	0:9b334a45a8ff	276	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	277	* @param nbslot: Number of slot.
bogdanm	0:9b334a45a8ff	278	* @retval HAL status
bogdanm	0:9b334a45a8ff	279	*/
bogdanm	0:9b334a45a8ff	280	HAL_StatusTypeDef HAL_SAI_InitProtocol(SAI_HandleTypeDef *hsai, uint32_t protocol, uint32_t datasize, uint32_t nbslot)
bogdanm	0:9b334a45a8ff	281	{
bogdanm	0:9b334a45a8ff	282	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	283
bogdanm	0:9b334a45a8ff	284	switch(protocol)
bogdanm	0:9b334a45a8ff	285	{
bogdanm	0:9b334a45a8ff	286	case SAI_I2S_STANDARD :
bogdanm	0:9b334a45a8ff	287	case SAI_I2S_MSBJUSTIFIED :
bogdanm	0:9b334a45a8ff	288	case SAI_I2S_LSBJUSTIFIED :
bogdanm	0:9b334a45a8ff	289	errorcode = SAI_InitI2S(hsai, protocol, datasize, nbslot);
bogdanm	0:9b334a45a8ff	290	break;
bogdanm	0:9b334a45a8ff	291	case SAI_PCM_LONG :
bogdanm	0:9b334a45a8ff	292	case SAI_PCM_SHORT :
bogdanm	0:9b334a45a8ff	293	errorcode = SAI_InitPCM(hsai, protocol, datasize, nbslot);
bogdanm	0:9b334a45a8ff	294	break;
bogdanm	0:9b334a45a8ff	295	default :
bogdanm	0:9b334a45a8ff	296	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	297	break;
bogdanm	0:9b334a45a8ff	298	}
bogdanm	0:9b334a45a8ff	299
bogdanm	0:9b334a45a8ff	300	if(errorcode == HAL_OK)
bogdanm	0:9b334a45a8ff	301	{
bogdanm	0:9b334a45a8ff	302	errorcode = HAL_SAI_Init(hsai);
bogdanm	0:9b334a45a8ff	303	}
bogdanm	0:9b334a45a8ff	304
bogdanm	0:9b334a45a8ff	305	return errorcode;
bogdanm	0:9b334a45a8ff	306	}
bogdanm	0:9b334a45a8ff	307
bogdanm	0:9b334a45a8ff	308	/**
bogdanm	0:9b334a45a8ff	309	* @brief Initialize the SAI according to the specified parameters
bogdanm	0:9b334a45a8ff	310	* in the SAI_InitTypeDef structure and initialize the associated handle.
bogdanm	0:9b334a45a8ff	311	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	312	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	313	* @retval HAL status
bogdanm	0:9b334a45a8ff	314	*/
bogdanm	0:9b334a45a8ff	315	HAL_StatusTypeDef HAL_SAI_Init(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	316	{
bogdanm	0:9b334a45a8ff	317	uint32_t tmpregisterGCR = 0;
bogdanm	0:9b334a45a8ff	318
bogdanm	0:9b334a45a8ff	319	/* Check the SAI handle allocation */
bogdanm	0:9b334a45a8ff	320	if(hsai == NULL)
bogdanm	0:9b334a45a8ff	321	{
bogdanm	0:9b334a45a8ff	322	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	323	}
bogdanm	0:9b334a45a8ff	324
bogdanm	0:9b334a45a8ff	325	/* check the instance */
bogdanm	0:9b334a45a8ff	326	assert_param(IS_SAI_ALL_INSTANCE(hsai->Instance));
bogdanm	0:9b334a45a8ff	327
bogdanm	0:9b334a45a8ff	328	/* Check the SAI Block parameters */
bogdanm	0:9b334a45a8ff	329	assert_param(IS_SAI_AUDIO_FREQUENCY(hsai->Init.AudioFrequency));
bogdanm	0:9b334a45a8ff	330	assert_param(IS_SAI_BLOCK_PROTOCOL(hsai->Init.Protocol));
bogdanm	0:9b334a45a8ff	331	assert_param(IS_SAI_BLOCK_MODE(hsai->Init.AudioMode));
bogdanm	0:9b334a45a8ff	332	assert_param(IS_SAI_BLOCK_DATASIZE(hsai->Init.DataSize));
bogdanm	0:9b334a45a8ff	333	assert_param(IS_SAI_BLOCK_FIRST_BIT(hsai->Init.FirstBit));
bogdanm	0:9b334a45a8ff	334	assert_param(IS_SAI_BLOCK_CLOCK_STROBING(hsai->Init.ClockStrobing));
bogdanm	0:9b334a45a8ff	335	assert_param(IS_SAI_BLOCK_SYNCHRO(hsai->Init.Synchro));
bogdanm	0:9b334a45a8ff	336	assert_param(IS_SAI_BLOCK_OUTPUT_DRIVE(hsai->Init.OutputDrive));
bogdanm	0:9b334a45a8ff	337	assert_param(IS_SAI_BLOCK_NODIVIDER(hsai->Init.NoDivider));
bogdanm	0:9b334a45a8ff	338	assert_param(IS_SAI_BLOCK_FIFO_THRESHOLD(hsai->Init.FIFOThreshold));
bogdanm	0:9b334a45a8ff	339	assert_param(IS_SAI_MONOSTEREO_MODE(hsai->Init.MonoStereoMode));
bogdanm	0:9b334a45a8ff	340	assert_param(IS_SAI_BLOCK_COMPANDING_MODE(hsai->Init.CompandingMode));
bogdanm	0:9b334a45a8ff	341	assert_param(IS_SAI_BLOCK_TRISTATE_MANAGEMENT(hsai->Init.TriState));
bogdanm	0:9b334a45a8ff	342	assert_param(IS_SAI_BLOCK_SYNCEXT(hsai->Init.SynchroExt));
bogdanm	0:9b334a45a8ff	343
bogdanm	0:9b334a45a8ff	344	/* Check the SAI Block Frame parameters */
bogdanm	0:9b334a45a8ff	345	assert_param(IS_SAI_BLOCK_FRAME_LENGTH(hsai->FrameInit.FrameLength));
bogdanm	0:9b334a45a8ff	346	assert_param(IS_SAI_BLOCK_ACTIVE_FRAME(hsai->FrameInit.ActiveFrameLength));
bogdanm	0:9b334a45a8ff	347	assert_param(IS_SAI_BLOCK_FS_DEFINITION(hsai->FrameInit.FSDefinition));
bogdanm	0:9b334a45a8ff	348	assert_param(IS_SAI_BLOCK_FS_POLARITY(hsai->FrameInit.FSPolarity));
bogdanm	0:9b334a45a8ff	349	assert_param(IS_SAI_BLOCK_FS_OFFSET(hsai->FrameInit.FSOffset));
bogdanm	0:9b334a45a8ff	350
bogdanm	0:9b334a45a8ff	351	/* Check the SAI Block Slot parameters */
bogdanm	0:9b334a45a8ff	352	assert_param(IS_SAI_BLOCK_FIRSTBIT_OFFSET(hsai->SlotInit.FirstBitOffset));
bogdanm	0:9b334a45a8ff	353	assert_param(IS_SAI_BLOCK_SLOT_SIZE(hsai->SlotInit.SlotSize));
bogdanm	0:9b334a45a8ff	354	assert_param(IS_SAI_BLOCK_SLOT_NUMBER(hsai->SlotInit.SlotNumber));
bogdanm	0:9b334a45a8ff	355	assert_param(IS_SAI_SLOT_ACTIVE(hsai->SlotInit.SlotActive));
bogdanm	0:9b334a45a8ff	356
bogdanm	0:9b334a45a8ff	357	if(hsai->State == HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	358	{
bogdanm	0:9b334a45a8ff	359	/* Allocate lock resource and initialize it */
bogdanm	0:9b334a45a8ff	360	hsai->Lock = HAL_UNLOCKED;
bogdanm	0:9b334a45a8ff	361
bogdanm	0:9b334a45a8ff	362	/* Init the low level hardware : GPIO, CLOCK, NVIC and DMA */
bogdanm	0:9b334a45a8ff	363	HAL_SAI_MspInit(hsai);
bogdanm	0:9b334a45a8ff	364	}
bogdanm	0:9b334a45a8ff	365
bogdanm	0:9b334a45a8ff	366	hsai->State = HAL_SAI_STATE_BUSY;
bogdanm	0:9b334a45a8ff	367
bogdanm	0:9b334a45a8ff	368	/* Disable the selected SAI peripheral */
bogdanm	0:9b334a45a8ff	369	SAI_Disable(hsai);
bogdanm	0:9b334a45a8ff	370
bogdanm	0:9b334a45a8ff	371	/* SAI Block Synchro Configuration ---------------------------------------------------*/
bogdanm	0:9b334a45a8ff	372	/* This setting must be done with both audio block (A & B) disabled */
bogdanm	0:9b334a45a8ff	373	switch(hsai->Init.SynchroExt)
bogdanm	0:9b334a45a8ff	374	{
bogdanm	0:9b334a45a8ff	375	case SAI_SYNCEXT_IN_ENABLE :
bogdanm	0:9b334a45a8ff	376	tmpregisterGCR = SAI_GCR_SYNCIN_0;
bogdanm	0:9b334a45a8ff	377	break;
bogdanm	0:9b334a45a8ff	378	case SAI_SYNCEXT_OUTBLOCKA_ENABLE :
bogdanm	0:9b334a45a8ff	379	tmpregisterGCR = SAI_GCR_SYNCOUT_0;
bogdanm	0:9b334a45a8ff	380	break;
bogdanm	0:9b334a45a8ff	381	case SAI_SYNCEXT_OUTBLOCKB_ENABLE :
bogdanm	0:9b334a45a8ff	382	tmpregisterGCR = SAI_GCR_SYNCOUT_1;
bogdanm	0:9b334a45a8ff	383	break;
bogdanm	0:9b334a45a8ff	384	case SAI_SYNCEXT_DISABLE :
bogdanm	0:9b334a45a8ff	385	default:
bogdanm	0:9b334a45a8ff	386	tmpregisterGCR = 0;
bogdanm	0:9b334a45a8ff	387	break;
bogdanm	0:9b334a45a8ff	388	}
bogdanm	0:9b334a45a8ff	389
bogdanm	0:9b334a45a8ff	390	if((hsai->Instance == SAI1_Block_A) \|\| (hsai->Instance == SAI1_Block_B))
bogdanm	0:9b334a45a8ff	391	{
bogdanm	0:9b334a45a8ff	392	SAI1->GCR = tmpregisterGCR;
bogdanm	0:9b334a45a8ff	393	}
bogdanm	0:9b334a45a8ff	394	else
bogdanm	0:9b334a45a8ff	395	{
bogdanm	0:9b334a45a8ff	396	SAI2->GCR = tmpregisterGCR;
bogdanm	0:9b334a45a8ff	397	}
bogdanm	0:9b334a45a8ff	398
bogdanm	0:9b334a45a8ff	399	if(hsai->Init.AudioFrequency != SAI_AUDIO_FREQUENCY_MCKDIV)
bogdanm	0:9b334a45a8ff	400	{
bogdanm	0:9b334a45a8ff	401	uint32_t freq = 0;
bogdanm	0:9b334a45a8ff	402	uint32_t tmpval;
bogdanm	0:9b334a45a8ff	403	/* In this case, the MCKDIV value is calculated to get AudioFrequency */
bogdanm	0:9b334a45a8ff	404	if((hsai->Instance == SAI1_Block_A ) \|\| (hsai->Instance == SAI1_Block_B ))
bogdanm	0:9b334a45a8ff	405	{
bogdanm	0:9b334a45a8ff	406	freq = HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_SAI1);
bogdanm	0:9b334a45a8ff	407	}
bogdanm	0:9b334a45a8ff	408	if((hsai->Instance == SAI2_Block_A ) \|\| (hsai->Instance == SAI2_Block_B ))
bogdanm	0:9b334a45a8ff	409	{
bogdanm	0:9b334a45a8ff	410	freq = HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_SAI2);
bogdanm	0:9b334a45a8ff	411	}
bogdanm	0:9b334a45a8ff	412
bogdanm	0:9b334a45a8ff	413	/* Configure Master Clock using the following formula :
bogdanm	0:9b334a45a8ff	414	MCLK_x = SAI_CK_x / (MCKDIV[3:0] * 2) with MCLK_x = 256 * FS
bogdanm	0:9b334a45a8ff	415	FS = SAI_CK_x / (MCKDIV[3:0] * 2) * 256
bogdanm	0:9b334a45a8ff	416	MCKDIV[3:0] = SAI_CK_x / FS * 512 */
bogdanm	0:9b334a45a8ff	417	/* (freq x 10) to keep Significant digits */
bogdanm	0:9b334a45a8ff	418	tmpval = (freq * 10) / (hsai->Init.AudioFrequency * 2 * 256);
bogdanm	0:9b334a45a8ff	419	hsai->Init.Mckdiv = tmpval / 10;
bogdanm	0:9b334a45a8ff	420
bogdanm	0:9b334a45a8ff	421	/* Round result to the nearest integer */
bogdanm	0:9b334a45a8ff	422	if((tmpval % 10) > 8)
bogdanm	0:9b334a45a8ff	423	{
bogdanm	0:9b334a45a8ff	424	hsai->Init.Mckdiv+= 1;
bogdanm	0:9b334a45a8ff	425	}
bogdanm	0:9b334a45a8ff	426	}
bogdanm	0:9b334a45a8ff	427
bogdanm	0:9b334a45a8ff	428	/* SAI Block Configuration ------------------------------------------------------------*/
bogdanm	0:9b334a45a8ff	429	/* SAI CR1 Configuration */
bogdanm	0:9b334a45a8ff	430	hsai->Instance->CR1&=~(SAI_xCR1_MODE \| SAI_xCR1_PRTCFG \| SAI_xCR1_DS \| \
bogdanm	0:9b334a45a8ff	431	SAI_xCR1_LSBFIRST \| SAI_xCR1_CKSTR \| SAI_xCR1_SYNCEN \|\
bogdanm	0:9b334a45a8ff	432	SAI_xCR1_MONO \| SAI_xCR1_OUTDRIV \| SAI_xCR1_DMAEN \| \
bogdanm	0:9b334a45a8ff	433	SAI_xCR1_NODIV \| SAI_xCR1_MCKDIV);
bogdanm	0:9b334a45a8ff	434
bogdanm	0:9b334a45a8ff	435	hsai->Instance->CR1\|=(hsai->Init.AudioMode \| hsai->Init.Protocol \| \
bogdanm	0:9b334a45a8ff	436	hsai->Init.DataSize \| hsai->Init.FirstBit \| \
bogdanm	0:9b334a45a8ff	437	hsai->Init.ClockStrobing \| hsai->Init.Synchro \| \
bogdanm	0:9b334a45a8ff	438	hsai->Init.MonoStereoMode \| hsai->Init.OutputDrive \| \
bogdanm	0:9b334a45a8ff	439	hsai->Init.NoDivider \| (hsai->Init.Mckdiv << 20) \| hsai->Init.CompandingMode);
bogdanm	0:9b334a45a8ff	440
bogdanm	0:9b334a45a8ff	441	/* SAI CR2 Configuration */
bogdanm	0:9b334a45a8ff	442	hsai->Instance->CR2&= ~(SAI_xCR2_FTH \| SAI_xCR2_FFLUSH \| SAI_xCR2_COMP);
bogdanm	0:9b334a45a8ff	443	hsai->Instance->CR2\|= (hsai->Init.FIFOThreshold \| hsai->Init.CompandingMode \| hsai->Init.TriState);
bogdanm	0:9b334a45a8ff	444
bogdanm	0:9b334a45a8ff	445
bogdanm	0:9b334a45a8ff	446	/* SAI Frame Configuration -----------------------------------------*/
bogdanm	0:9b334a45a8ff	447	hsai->Instance->FRCR&=(~(SAI_xFRCR_FRL \| SAI_xFRCR_FSALL \| SAI_xFRCR_FSDEF \| \
bogdanm	0:9b334a45a8ff	448	SAI_xFRCR_FSPO \| SAI_xFRCR_FSOFF));
bogdanm	0:9b334a45a8ff	449	hsai->Instance->FRCR\|=((hsai->FrameInit.FrameLength - 1) \|
bogdanm	0:9b334a45a8ff	450	hsai->FrameInit.FSOffset \|
bogdanm	0:9b334a45a8ff	451	hsai->FrameInit.FSDefinition \|
bogdanm	0:9b334a45a8ff	452	hsai->FrameInit.FSPolarity \|
bogdanm	0:9b334a45a8ff	453	((hsai->FrameInit.ActiveFrameLength - 1) << 8));
bogdanm	0:9b334a45a8ff	454
bogdanm	0:9b334a45a8ff	455	/* SAI Block_x SLOT Configuration ------------------------------------------*/
bogdanm	0:9b334a45a8ff	456	/* This register has no meaning in AC 97 and SPDIF audio protocol */
bogdanm	0:9b334a45a8ff	457	hsai->Instance->SLOTR&= (~(SAI_xSLOTR_FBOFF \| SAI_xSLOTR_SLOTSZ \| \
bogdanm	0:9b334a45a8ff	458	SAI_xSLOTR_NBSLOT \| SAI_xSLOTR_SLOTEN ));
bogdanm	0:9b334a45a8ff	459
bogdanm	0:9b334a45a8ff	460	hsai->Instance->SLOTR\|= hsai->SlotInit.FirstBitOffset \| hsai->SlotInit.SlotSize
bogdanm	0:9b334a45a8ff	461	\| hsai->SlotInit.SlotActive \| ((hsai->SlotInit.SlotNumber - 1) << 8);
bogdanm	0:9b334a45a8ff	462
bogdanm	0:9b334a45a8ff	463	/* Initialize the error code */
bogdanm	0:9b334a45a8ff	464	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	465
bogdanm	0:9b334a45a8ff	466	/* Initialize the SAI state */
bogdanm	0:9b334a45a8ff	467	hsai->State= HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	468
bogdanm	0:9b334a45a8ff	469	/* Release Lock */
bogdanm	0:9b334a45a8ff	470	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	471
bogdanm	0:9b334a45a8ff	472	return HAL_OK;
bogdanm	0:9b334a45a8ff	473	}
bogdanm	0:9b334a45a8ff	474
bogdanm	0:9b334a45a8ff	475	/**
bogdanm	0:9b334a45a8ff	476	* @brief DeInitialize the SAI peripheral.
bogdanm	0:9b334a45a8ff	477	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	478	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	479	* @retval HAL status
bogdanm	0:9b334a45a8ff	480	*/
bogdanm	0:9b334a45a8ff	481	HAL_StatusTypeDef HAL_SAI_DeInit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	482	{
bogdanm	0:9b334a45a8ff	483	/* Check the SAI handle allocation */
bogdanm	0:9b334a45a8ff	484	if(hsai == NULL)
bogdanm	0:9b334a45a8ff	485	{
bogdanm	0:9b334a45a8ff	486	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	487	}
bogdanm	0:9b334a45a8ff	488
bogdanm	0:9b334a45a8ff	489	hsai->State = HAL_SAI_STATE_BUSY;
bogdanm	0:9b334a45a8ff	490
bogdanm	0:9b334a45a8ff	491	/* Disabled All interrupt and clear all the flag */
bogdanm	0:9b334a45a8ff	492	hsai->Instance->IMR = 0;
bogdanm	0:9b334a45a8ff	493	hsai->Instance->CLRFR = 0xFFFFFFFF;
bogdanm	0:9b334a45a8ff	494
bogdanm	0:9b334a45a8ff	495	/* Disable the SAI */
bogdanm	0:9b334a45a8ff	496	SAI_Disable(hsai);
bogdanm	0:9b334a45a8ff	497
bogdanm	0:9b334a45a8ff	498	/* Flush the fifo */
bogdanm	0:9b334a45a8ff	499	SET_BIT(hsai->Instance->CR2, SAI_xCR2_FFLUSH);
bogdanm	0:9b334a45a8ff	500
bogdanm	0:9b334a45a8ff	501	/* DeInit the low level hardware: GPIO, CLOCK, NVIC and DMA */
bogdanm	0:9b334a45a8ff	502	HAL_SAI_MspDeInit(hsai);
bogdanm	0:9b334a45a8ff	503
bogdanm	0:9b334a45a8ff	504	/* Initialize the error code */
bogdanm	0:9b334a45a8ff	505	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	506
bogdanm	0:9b334a45a8ff	507	/* Initialize the SAI state */
bogdanm	0:9b334a45a8ff	508	hsai->State = HAL_SAI_STATE_RESET;
bogdanm	0:9b334a45a8ff	509
bogdanm	0:9b334a45a8ff	510	return HAL_OK;
bogdanm	0:9b334a45a8ff	511	}
bogdanm	0:9b334a45a8ff	512
bogdanm	0:9b334a45a8ff	513	/**
bogdanm	0:9b334a45a8ff	514	* @brief Initialize the SAI MSP.
bogdanm	0:9b334a45a8ff	515	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	516	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	517	* @retval None
bogdanm	0:9b334a45a8ff	518	*/
bogdanm	0:9b334a45a8ff	519	__weak void HAL_SAI_MspInit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	520	{
bogdanm	0:9b334a45a8ff	521	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	522	the HAL_SAI_MspInit could be implemented in the user file
bogdanm	0:9b334a45a8ff	523	*/
bogdanm	0:9b334a45a8ff	524	}
bogdanm	0:9b334a45a8ff	525
bogdanm	0:9b334a45a8ff	526	/**
bogdanm	0:9b334a45a8ff	527	* @brief DeInitialize the SAI MSP.
bogdanm	0:9b334a45a8ff	528	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	529	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	530	* @retval None
bogdanm	0:9b334a45a8ff	531	*/
bogdanm	0:9b334a45a8ff	532	__weak void HAL_SAI_MspDeInit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	533	{
bogdanm	0:9b334a45a8ff	534	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	535	the HAL_SAI_MspDeInit could be implemented in the user file
bogdanm	0:9b334a45a8ff	536	*/
bogdanm	0:9b334a45a8ff	537	}
bogdanm	0:9b334a45a8ff	538
bogdanm	0:9b334a45a8ff	539	/**
bogdanm	0:9b334a45a8ff	540	* @}
bogdanm	0:9b334a45a8ff	541	*/
bogdanm	0:9b334a45a8ff	542
bogdanm	0:9b334a45a8ff	543	/** @defgroup SAI_Exported_Functions_Group2 IO operation functions
bogdanm	0:9b334a45a8ff	544	* @brief Data transfers functions
bogdanm	0:9b334a45a8ff	545	*
bogdanm	0:9b334a45a8ff	546	@verbatim
bogdanm	0:9b334a45a8ff	547	===============================================================================
bogdanm	0:9b334a45a8ff	548	##### IO operation functions #####
bogdanm	0:9b334a45a8ff	549	===============================================================================
bogdanm	0:9b334a45a8ff	550	[..]
bogdanm	0:9b334a45a8ff	551	This subsection provides a set of functions allowing to manage the SAI data
bogdanm	0:9b334a45a8ff	552	transfers.
bogdanm	0:9b334a45a8ff	553
bogdanm	0:9b334a45a8ff	554	(+) There are two modes of transfer:
bogdanm	0:9b334a45a8ff	555	(++) Blocking mode : The communication is performed in the polling mode.
bogdanm	0:9b334a45a8ff	556	The status of all data processing is returned by the same function
bogdanm	0:9b334a45a8ff	557	after finishing transfer.
bogdanm	0:9b334a45a8ff	558	(++) No-Blocking mode : The communication is performed using Interrupts
bogdanm	0:9b334a45a8ff	559	or DMA. These functions return the status of the transfer startup.
bogdanm	0:9b334a45a8ff	560	The end of the data processing will be indicated through the
bogdanm	0:9b334a45a8ff	561	dedicated SAI IRQ when using Interrupt mode or the DMA IRQ when
bogdanm	0:9b334a45a8ff	562	using DMA mode.
bogdanm	0:9b334a45a8ff	563
bogdanm	0:9b334a45a8ff	564	(+) Blocking mode functions are :
bogdanm	0:9b334a45a8ff	565	(++) HAL_SAI_Transmit()
bogdanm	0:9b334a45a8ff	566	(++) HAL_SAI_Receive()
bogdanm	0:9b334a45a8ff	567	(++) HAL_SAI_TransmitReceive()
bogdanm	0:9b334a45a8ff	568
bogdanm	0:9b334a45a8ff	569	(+) Non Blocking mode functions with Interrupt are :
bogdanm	0:9b334a45a8ff	570	(++) HAL_SAI_Transmit_IT()
bogdanm	0:9b334a45a8ff	571	(++) HAL_SAI_Receive_IT()
bogdanm	0:9b334a45a8ff	572	(++) HAL_SAI_TransmitReceive_IT()
bogdanm	0:9b334a45a8ff	573
bogdanm	0:9b334a45a8ff	574	(+) Non Blocking mode functions with DMA are :
bogdanm	0:9b334a45a8ff	575	(++) HAL_SAI_Transmit_DMA()
bogdanm	0:9b334a45a8ff	576	(++) HAL_SAI_Receive_DMA()
bogdanm	0:9b334a45a8ff	577	(++) HAL_SAI_TransmitReceive_DMA()
bogdanm	0:9b334a45a8ff	578
bogdanm	0:9b334a45a8ff	579	(+) A set of Transfer Complete Callbacks are provided in non Blocking mode:
bogdanm	0:9b334a45a8ff	580	(++) HAL_SAI_TxCpltCallback()
bogdanm	0:9b334a45a8ff	581	(++) HAL_SAI_RxCpltCallback()
bogdanm	0:9b334a45a8ff	582	(++) HAL_SAI_ErrorCallback()
bogdanm	0:9b334a45a8ff	583
bogdanm	0:9b334a45a8ff	584	@endverbatim
bogdanm	0:9b334a45a8ff	585	* @{
bogdanm	0:9b334a45a8ff	586	*/
bogdanm	0:9b334a45a8ff	587
bogdanm	0:9b334a45a8ff	588	/**
bogdanm	0:9b334a45a8ff	589	* @brief Transmit an amount of data in blocking mode.
bogdanm	0:9b334a45a8ff	590	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	591	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	592	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	593	* @param Size: Amount of data to be sent
bogdanm	0:9b334a45a8ff	594	* @param Timeout: Timeout duration
bogdanm	0:9b334a45a8ff	595	* @retval HAL status
bogdanm	0:9b334a45a8ff	596	*/
bogdanm	0:9b334a45a8ff	597	HAL_StatusTypeDef HAL_SAI_Transmit(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size, uint32_t Timeout)
bogdanm	0:9b334a45a8ff	598	{
bogdanm	0:9b334a45a8ff	599	uint32_t tickstart = HAL_GetTick();
bogdanm	0:9b334a45a8ff	600	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	601
bogdanm	0:9b334a45a8ff	602	/* Process Locked */
bogdanm	0:9b334a45a8ff	603	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	604
bogdanm	0:9b334a45a8ff	605	if((pData == NULL ) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	606	{
bogdanm	0:9b334a45a8ff	607	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	608	goto error;
bogdanm	0:9b334a45a8ff	609	}
bogdanm	0:9b334a45a8ff	610
bogdanm	0:9b334a45a8ff	611	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	612	{
bogdanm	0:9b334a45a8ff	613	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	614	goto error;
bogdanm	0:9b334a45a8ff	615	}
bogdanm	0:9b334a45a8ff	616
bogdanm	0:9b334a45a8ff	617	hsai->State = HAL_SAI_STATE_BUSY_TX;
bogdanm	0:9b334a45a8ff	618	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	619	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	620	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	621	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	622
bogdanm	0:9b334a45a8ff	623	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	624	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	625	{
bogdanm	0:9b334a45a8ff	626	/* fill the fifo with data before to enabled the SAI */
bogdanm	0:9b334a45a8ff	627	SAI_FillFifo(hsai);
bogdanm	0:9b334a45a8ff	628	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	629	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	630	}
bogdanm	0:9b334a45a8ff	631
bogdanm	0:9b334a45a8ff	632	do
bogdanm	0:9b334a45a8ff	633	{
bogdanm	0:9b334a45a8ff	634	/* Write data if the FIFO is not full */
bogdanm	0:9b334a45a8ff	635	if((hsai->Instance->SR & SAI_xSR_FLVL) != SAI_FIFOSTATUS_FULL)
bogdanm	0:9b334a45a8ff	636	{
bogdanm	0:9b334a45a8ff	637	if((hsai->Init.DataSize == SAI_DATASIZE_8) && (hsai->Init.CompandingMode == SAI_NOCOMPANDING))
bogdanm	0:9b334a45a8ff	638	{
bogdanm	0:9b334a45a8ff	639	hsai->Instance->DR = (*hsai->pBuffPtr++);
bogdanm	0:9b334a45a8ff	640	}
bogdanm	0:9b334a45a8ff	641	else if(hsai->Init.DataSize <= SAI_DATASIZE_16)
bogdanm	0:9b334a45a8ff	642	{
bogdanm	0:9b334a45a8ff	643	(uint16_t )&hsai->Instance->DR = ((uint16_t )hsai->pBuffPtr);
bogdanm	0:9b334a45a8ff	644	hsai->pBuffPtr+= 2;
bogdanm	0:9b334a45a8ff	645	}
bogdanm	0:9b334a45a8ff	646	else
bogdanm	0:9b334a45a8ff	647	{
bogdanm	0:9b334a45a8ff	648	hsai->Instance->DR = ((uint32_t )hsai->pBuffPtr);
bogdanm	0:9b334a45a8ff	649	hsai->pBuffPtr+= 4;
bogdanm	0:9b334a45a8ff	650	}
bogdanm	0:9b334a45a8ff	651	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	652	}
bogdanm	0:9b334a45a8ff	653	else
bogdanm	0:9b334a45a8ff	654	{
bogdanm	0:9b334a45a8ff	655	/* Check for the Timeout */
bogdanm	0:9b334a45a8ff	656	if((Timeout != HAL_MAX_DELAY) && ((Timeout == 0)\|\|((HAL_GetTick() - tickstart ) > Timeout)))
bogdanm	0:9b334a45a8ff	657	{
bogdanm	0:9b334a45a8ff	658	errorcode = HAL_TIMEOUT;
bogdanm	0:9b334a45a8ff	659	goto error;
bogdanm	0:9b334a45a8ff	660	}
bogdanm	0:9b334a45a8ff	661	}
bogdanm	0:9b334a45a8ff	662	}
bogdanm	0:9b334a45a8ff	663	while(0 != hsai->XferCount);
bogdanm	0:9b334a45a8ff	664
bogdanm	0:9b334a45a8ff	665	error :
bogdanm	0:9b334a45a8ff	666	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	667	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	668	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	669	return errorcode;
bogdanm	0:9b334a45a8ff	670	}
bogdanm	0:9b334a45a8ff	671
bogdanm	0:9b334a45a8ff	672	/**
bogdanm	0:9b334a45a8ff	673	* @brief Receive an amount of data in blocking mode.
bogdanm	0:9b334a45a8ff	674	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	675	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	676	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	677	* @param Size: Amount of data to be received
bogdanm	0:9b334a45a8ff	678	* @param Timeout: Timeout duration
bogdanm	0:9b334a45a8ff	679	* @retval HAL status
bogdanm	0:9b334a45a8ff	680	*/
bogdanm	0:9b334a45a8ff	681	HAL_StatusTypeDef HAL_SAI_Receive(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size, uint32_t Timeout)
bogdanm	0:9b334a45a8ff	682	{
bogdanm	0:9b334a45a8ff	683	uint32_t tickstart = HAL_GetTick();
bogdanm	0:9b334a45a8ff	684	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	685
bogdanm	0:9b334a45a8ff	686	/* Process Locked */
bogdanm	0:9b334a45a8ff	687	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	688
bogdanm	0:9b334a45a8ff	689	if((pData == NULL ) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	690	{
bogdanm	0:9b334a45a8ff	691	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	692	goto error;
bogdanm	0:9b334a45a8ff	693	}
bogdanm	0:9b334a45a8ff	694
bogdanm	0:9b334a45a8ff	695	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	696	{
bogdanm	0:9b334a45a8ff	697	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	698	goto error;
bogdanm	0:9b334a45a8ff	699	}
bogdanm	0:9b334a45a8ff	700
bogdanm	0:9b334a45a8ff	701	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	702	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	703	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	704	hsai->State = HAL_SAI_STATE_BUSY_RX;
bogdanm	0:9b334a45a8ff	705	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	706
bogdanm	0:9b334a45a8ff	707	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	708	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	709	{
bogdanm	0:9b334a45a8ff	710	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	711	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	712	}
bogdanm	0:9b334a45a8ff	713
bogdanm	0:9b334a45a8ff	714	/* Receive data */
bogdanm	0:9b334a45a8ff	715	do
bogdanm	0:9b334a45a8ff	716	{
bogdanm	0:9b334a45a8ff	717	/* Wait until RXNE flag is set */
bogdanm	0:9b334a45a8ff	718	if((hsai->Instance->SR & SAI_xSR_FLVL) != SAI_FIFOSTATUS_EMPTY)
bogdanm	0:9b334a45a8ff	719	{
bogdanm	0:9b334a45a8ff	720	if((hsai->Init.DataSize == SAI_DATASIZE_8) && (hsai->Init.CompandingMode == SAI_NOCOMPANDING))
bogdanm	0:9b334a45a8ff	721	{
bogdanm	0:9b334a45a8ff	722	(*hsai->pBuffPtr++) = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	723	}
bogdanm	0:9b334a45a8ff	724	else if(hsai->Init.DataSize <= SAI_DATASIZE_16)
bogdanm	0:9b334a45a8ff	725	{
bogdanm	0:9b334a45a8ff	726	((uint16_t)hsai->pBuffPtr) = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	727	hsai->pBuffPtr+= 2;
bogdanm	0:9b334a45a8ff	728	}
bogdanm	0:9b334a45a8ff	729	else
bogdanm	0:9b334a45a8ff	730	{
bogdanm	0:9b334a45a8ff	731	((uint32_t)hsai->pBuffPtr) = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	732	hsai->pBuffPtr+= 4;
bogdanm	0:9b334a45a8ff	733	}
bogdanm	0:9b334a45a8ff	734	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	735	}
bogdanm	0:9b334a45a8ff	736	else
bogdanm	0:9b334a45a8ff	737	{
bogdanm	0:9b334a45a8ff	738	/* Check for the Timeout */
bogdanm	0:9b334a45a8ff	739	if((Timeout != HAL_MAX_DELAY) && ((Timeout == 0)\|\|((HAL_GetTick() - tickstart ) > Timeout)))
bogdanm	0:9b334a45a8ff	740	{
bogdanm	0:9b334a45a8ff	741	errorcode = HAL_TIMEOUT;
bogdanm	0:9b334a45a8ff	742	goto error;
bogdanm	0:9b334a45a8ff	743	}
bogdanm	0:9b334a45a8ff	744	}
bogdanm	0:9b334a45a8ff	745	}
bogdanm	0:9b334a45a8ff	746	while(0 != hsai->XferCount);
bogdanm	0:9b334a45a8ff	747
bogdanm	0:9b334a45a8ff	748	error :
bogdanm	0:9b334a45a8ff	749	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	750	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	751	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	752	return errorcode;
bogdanm	0:9b334a45a8ff	753	}
bogdanm	0:9b334a45a8ff	754
bogdanm	0:9b334a45a8ff	755	/**
bogdanm	0:9b334a45a8ff	756	* @brief Transmit an amount of data in non-blocking mode with Interrupt.
bogdanm	0:9b334a45a8ff	757	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	758	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	759	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	760	* @param Size: Amount of data to be sent
bogdanm	0:9b334a45a8ff	761	* @retval HAL status
bogdanm	0:9b334a45a8ff	762	*/
bogdanm	0:9b334a45a8ff	763	HAL_StatusTypeDef HAL_SAI_Transmit_IT(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size)
bogdanm	0:9b334a45a8ff	764	{
bogdanm	0:9b334a45a8ff	765	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	766
bogdanm	0:9b334a45a8ff	767	/* Process Locked */
bogdanm	0:9b334a45a8ff	768	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	769
bogdanm	0:9b334a45a8ff	770	if((pData == NULL) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	771	{
bogdanm	0:9b334a45a8ff	772	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	773	goto error;
bogdanm	0:9b334a45a8ff	774	}
bogdanm	0:9b334a45a8ff	775
bogdanm	0:9b334a45a8ff	776	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	777	{
bogdanm	0:9b334a45a8ff	778	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	779	goto error;
bogdanm	0:9b334a45a8ff	780	}
bogdanm	0:9b334a45a8ff	781
bogdanm	0:9b334a45a8ff	782	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	783	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	784	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	785	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	786	hsai->State = HAL_SAI_STATE_BUSY_TX;
bogdanm	0:9b334a45a8ff	787	if((hsai->Init.DataSize == SAI_DATASIZE_8) && (hsai->Init.CompandingMode == SAI_NOCOMPANDING))
bogdanm	0:9b334a45a8ff	788	{
bogdanm	0:9b334a45a8ff	789	hsai->InterruptServiceRoutine = SAI_Transmit_IT8Bit;
bogdanm	0:9b334a45a8ff	790	}
bogdanm	0:9b334a45a8ff	791	else if(hsai->Init.DataSize <= SAI_DATASIZE_16)
bogdanm	0:9b334a45a8ff	792	{
bogdanm	0:9b334a45a8ff	793	hsai->InterruptServiceRoutine = SAI_Transmit_IT16Bit;
bogdanm	0:9b334a45a8ff	794	}
bogdanm	0:9b334a45a8ff	795	else
bogdanm	0:9b334a45a8ff	796	{
bogdanm	0:9b334a45a8ff	797	hsai->InterruptServiceRoutine = SAI_Transmit_IT32Bit;
bogdanm	0:9b334a45a8ff	798	}
bogdanm	0:9b334a45a8ff	799
bogdanm	0:9b334a45a8ff	800	/* Enable FRQ and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	801	__HAL_SAI_ENABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	802
bogdanm	0:9b334a45a8ff	803	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	804	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	805	{
bogdanm	0:9b334a45a8ff	806	/* Fill the fifo before starting the communication */
bogdanm	0:9b334a45a8ff	807	SAI_FillFifo(hsai);
bogdanm	0:9b334a45a8ff	808	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	809	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	810	}
bogdanm	0:9b334a45a8ff	811
bogdanm	0:9b334a45a8ff	812	error :
bogdanm	0:9b334a45a8ff	813	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	814	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	815	return errorcode;
bogdanm	0:9b334a45a8ff	816	}
bogdanm	0:9b334a45a8ff	817
bogdanm	0:9b334a45a8ff	818	/**
bogdanm	0:9b334a45a8ff	819	* @brief Receive an amount of data in non-blocking mode with Interrupt.
bogdanm	0:9b334a45a8ff	820	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	821	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	822	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	823	* @param Size: Amount of data to be received
bogdanm	0:9b334a45a8ff	824	* @retval HAL status
bogdanm	0:9b334a45a8ff	825	*/
bogdanm	0:9b334a45a8ff	826	HAL_StatusTypeDef HAL_SAI_Receive_IT(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size)
bogdanm	0:9b334a45a8ff	827	{
bogdanm	0:9b334a45a8ff	828	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	829
bogdanm	0:9b334a45a8ff	830	/* Process Locked */
bogdanm	0:9b334a45a8ff	831	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	832
bogdanm	0:9b334a45a8ff	833	if((pData == NULL) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	834	{
bogdanm	0:9b334a45a8ff	835	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	836	goto error;
bogdanm	0:9b334a45a8ff	837	}
bogdanm	0:9b334a45a8ff	838
bogdanm	0:9b334a45a8ff	839	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	840	{
bogdanm	0:9b334a45a8ff	841	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	842	goto error;
bogdanm	0:9b334a45a8ff	843	}
bogdanm	0:9b334a45a8ff	844
bogdanm	0:9b334a45a8ff	845	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	846	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	847	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	848	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	849	hsai->State = HAL_SAI_STATE_BUSY_RX;
bogdanm	0:9b334a45a8ff	850	if((hsai->Init.DataSize == SAI_DATASIZE_8) && (hsai->Init.CompandingMode == SAI_NOCOMPANDING))
bogdanm	0:9b334a45a8ff	851	{
bogdanm	0:9b334a45a8ff	852	hsai->InterruptServiceRoutine = SAI_Receive_IT8Bit;
bogdanm	0:9b334a45a8ff	853	}
bogdanm	0:9b334a45a8ff	854	else if(hsai->Init.DataSize <= SAI_DATASIZE_16)
bogdanm	0:9b334a45a8ff	855	{
bogdanm	0:9b334a45a8ff	856	hsai->InterruptServiceRoutine = SAI_Receive_IT16Bit;
bogdanm	0:9b334a45a8ff	857	}
bogdanm	0:9b334a45a8ff	858	else
bogdanm	0:9b334a45a8ff	859	{
bogdanm	0:9b334a45a8ff	860	hsai->InterruptServiceRoutine = SAI_Receive_IT32Bit;
bogdanm	0:9b334a45a8ff	861	}
bogdanm	0:9b334a45a8ff	862
bogdanm	0:9b334a45a8ff	863	/* Enable the interrupts */
bogdanm	0:9b334a45a8ff	864	__HAL_SAI_ENABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	865
bogdanm	0:9b334a45a8ff	866	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	867	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	868	{
bogdanm	0:9b334a45a8ff	869	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	870	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	871	}
bogdanm	0:9b334a45a8ff	872
bogdanm	0:9b334a45a8ff	873	error :
bogdanm	0:9b334a45a8ff	874	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	875	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	876	return errorcode;
bogdanm	0:9b334a45a8ff	877	}
bogdanm	0:9b334a45a8ff	878
bogdanm	0:9b334a45a8ff	879	/**
bogdanm	0:9b334a45a8ff	880	* @brief Pause the audio stream playing from the Media.
bogdanm	0:9b334a45a8ff	881	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	882	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	883	* @retval HAL status
bogdanm	0:9b334a45a8ff	884	*/
bogdanm	0:9b334a45a8ff	885	HAL_StatusTypeDef HAL_SAI_DMAPause(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	886	{
bogdanm	0:9b334a45a8ff	887	/* Process Locked */
bogdanm	0:9b334a45a8ff	888	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	889
bogdanm	0:9b334a45a8ff	890	/* Pause the audio file playing by disabling the SAI DMA requests */
bogdanm	0:9b334a45a8ff	891	hsai->Instance->CR1 &= ~SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	892
bogdanm	0:9b334a45a8ff	893	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	894	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	895
bogdanm	0:9b334a45a8ff	896	return HAL_OK;
bogdanm	0:9b334a45a8ff	897	}
bogdanm	0:9b334a45a8ff	898
bogdanm	0:9b334a45a8ff	899	/**
bogdanm	0:9b334a45a8ff	900	* @brief Resume the audio stream playing from the Media.
bogdanm	0:9b334a45a8ff	901	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	902	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	903	* @retval HAL status
bogdanm	0:9b334a45a8ff	904	*/
bogdanm	0:9b334a45a8ff	905	HAL_StatusTypeDef HAL_SAI_DMAResume(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	906	{
bogdanm	0:9b334a45a8ff	907	/* Process Locked */
bogdanm	0:9b334a45a8ff	908	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	909
bogdanm	0:9b334a45a8ff	910	/* Enable the SAI DMA requests */
bogdanm	0:9b334a45a8ff	911	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	912
bogdanm	0:9b334a45a8ff	913	/* If the SAI peripheral is still not enabled, enable it */
bogdanm	0:9b334a45a8ff	914	if ((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	915	{
bogdanm	0:9b334a45a8ff	916	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	917	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	918	}
bogdanm	0:9b334a45a8ff	919
bogdanm	0:9b334a45a8ff	920	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	921	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	922
bogdanm	0:9b334a45a8ff	923	return HAL_OK;
bogdanm	0:9b334a45a8ff	924	}
bogdanm	0:9b334a45a8ff	925
bogdanm	0:9b334a45a8ff	926	/**
bogdanm	0:9b334a45a8ff	927	* @brief Stop the audio stream playing from the Media.
bogdanm	0:9b334a45a8ff	928	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	929	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	930	* @retval HAL status
bogdanm	0:9b334a45a8ff	931	*/
bogdanm	0:9b334a45a8ff	932	HAL_StatusTypeDef HAL_SAI_DMAStop(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	933	{
bogdanm	0:9b334a45a8ff	934	/* Process Locked */
bogdanm	0:9b334a45a8ff	935	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	936
bogdanm	0:9b334a45a8ff	937	/* Disable the SAI DMA request */
bogdanm	0:9b334a45a8ff	938	hsai->Instance->CR1 &= ~SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	939
bogdanm	0:9b334a45a8ff	940	/* Abort the SAI DMA Channel */
bogdanm	0:9b334a45a8ff	941	if(hsai->hdmatx != NULL)
bogdanm	0:9b334a45a8ff	942	{
bogdanm	0:9b334a45a8ff	943	HAL_DMA_Abort(hsai->hdmatx);
bogdanm	0:9b334a45a8ff	944	}
bogdanm	0:9b334a45a8ff	945
bogdanm	0:9b334a45a8ff	946	if(hsai->hdmarx != NULL)
bogdanm	0:9b334a45a8ff	947	{
bogdanm	0:9b334a45a8ff	948	HAL_DMA_Abort(hsai->hdmarx);
bogdanm	0:9b334a45a8ff	949	}
bogdanm	0:9b334a45a8ff	950
bogdanm	0:9b334a45a8ff	951	/* Disable SAI peripheral */
bogdanm	0:9b334a45a8ff	952	SAI_Disable(hsai);
bogdanm	0:9b334a45a8ff	953
bogdanm	0:9b334a45a8ff	954	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	955
bogdanm	0:9b334a45a8ff	956	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	957	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	958
bogdanm	0:9b334a45a8ff	959	return HAL_OK;
bogdanm	0:9b334a45a8ff	960	}
bogdanm	0:9b334a45a8ff	961
bogdanm	0:9b334a45a8ff	962	/**
bogdanm	0:9b334a45a8ff	963	* @brief Abort the current transfer and disable the SAI.
bogdanm	0:9b334a45a8ff	964	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	965	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	966	* @retval HAL status
bogdanm	0:9b334a45a8ff	967	*/
bogdanm	0:9b334a45a8ff	968	HAL_StatusTypeDef HAL_SAI_Abort(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	969	{
bogdanm	0:9b334a45a8ff	970	/* Disable the SAI DMA request */
bogdanm	0:9b334a45a8ff	971	hsai->Instance->CR1 &= ~SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	972
bogdanm	0:9b334a45a8ff	973	/* Abort the SAI DMA Channel */
bogdanm	0:9b334a45a8ff	974	if(hsai->hdmatx != NULL)
bogdanm	0:9b334a45a8ff	975	{
bogdanm	0:9b334a45a8ff	976	HAL_DMA_Abort(hsai->hdmatx);
bogdanm	0:9b334a45a8ff	977	}
bogdanm	0:9b334a45a8ff	978
bogdanm	0:9b334a45a8ff	979	if(hsai->hdmarx != NULL)
bogdanm	0:9b334a45a8ff	980	{
bogdanm	0:9b334a45a8ff	981	HAL_DMA_Abort(hsai->hdmarx);
bogdanm	0:9b334a45a8ff	982	}
bogdanm	0:9b334a45a8ff	983
bogdanm	0:9b334a45a8ff	984	/* Disabled All interrupt and clear all the flag */
bogdanm	0:9b334a45a8ff	985	hsai->Instance->IMR = 0;
bogdanm	0:9b334a45a8ff	986	hsai->Instance->CLRFR = 0xFFFFFFFF;
bogdanm	0:9b334a45a8ff	987
bogdanm	0:9b334a45a8ff	988	/* Disable SAI peripheral */
bogdanm	0:9b334a45a8ff	989	SAI_Disable(hsai);
bogdanm	0:9b334a45a8ff	990
bogdanm	0:9b334a45a8ff	991	/* Flush the fifo */
bogdanm	0:9b334a45a8ff	992	SET_BIT(hsai->Instance->CR2, SAI_xCR2_FFLUSH);
bogdanm	0:9b334a45a8ff	993
bogdanm	0:9b334a45a8ff	994	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	995
bogdanm	0:9b334a45a8ff	996	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	997	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	998
bogdanm	0:9b334a45a8ff	999	return HAL_OK;
bogdanm	0:9b334a45a8ff	1000	}
bogdanm	0:9b334a45a8ff	1001
bogdanm	0:9b334a45a8ff	1002	/**
bogdanm	0:9b334a45a8ff	1003	* @brief Transmit an amount of data in non-blocking mode with DMA.
bogdanm	0:9b334a45a8ff	1004	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1005	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1006	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	1007	* @param Size: Amount of data to be sent
bogdanm	0:9b334a45a8ff	1008	* @retval HAL status
bogdanm	0:9b334a45a8ff	1009	*/
bogdanm	0:9b334a45a8ff	1010	HAL_StatusTypeDef HAL_SAI_Transmit_DMA(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size)
bogdanm	0:9b334a45a8ff	1011	{
bogdanm	0:9b334a45a8ff	1012	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	1013
bogdanm	0:9b334a45a8ff	1014	/* Process Locked */
bogdanm	0:9b334a45a8ff	1015	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	1016
bogdanm	0:9b334a45a8ff	1017	if((pData == NULL) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	1018	{
bogdanm	0:9b334a45a8ff	1019	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	1020	goto error;
bogdanm	0:9b334a45a8ff	1021	}
bogdanm	0:9b334a45a8ff	1022
bogdanm	0:9b334a45a8ff	1023	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	1024	{
bogdanm	0:9b334a45a8ff	1025	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	1026	goto error;
bogdanm	0:9b334a45a8ff	1027	}
bogdanm	0:9b334a45a8ff	1028
bogdanm	0:9b334a45a8ff	1029	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	1030	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	1031	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	1032	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	1033	hsai->State = HAL_SAI_STATE_BUSY_TX;
bogdanm	0:9b334a45a8ff	1034
bogdanm	0:9b334a45a8ff	1035	/* Set the SAI Tx DMA Half transfer complete callback */
bogdanm	0:9b334a45a8ff	1036	hsai->hdmatx->XferHalfCpltCallback = SAI_DMATxHalfCplt;
bogdanm	0:9b334a45a8ff	1037
bogdanm	0:9b334a45a8ff	1038	/* Set the SAI TxDMA transfer complete callback */
bogdanm	0:9b334a45a8ff	1039	hsai->hdmatx->XferCpltCallback = SAI_DMATxCplt;
bogdanm	0:9b334a45a8ff	1040
bogdanm	0:9b334a45a8ff	1041	/* Set the DMA error callback */
bogdanm	0:9b334a45a8ff	1042	hsai->hdmatx->XferErrorCallback = SAI_DMAError;
bogdanm	0:9b334a45a8ff	1043
bogdanm	0:9b334a45a8ff	1044	/* Enable the Tx DMA Channel */
bogdanm	0:9b334a45a8ff	1045	HAL_DMA_Start_IT(hsai->hdmatx, (uint32_t)hsai->pBuffPtr, (uint32_t)&hsai->Instance->DR, hsai->XferSize);
bogdanm	0:9b334a45a8ff	1046
bogdanm	0:9b334a45a8ff	1047	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	1048	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	1049	{
bogdanm	0:9b334a45a8ff	1050	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	1051	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	1052	}
bogdanm	0:9b334a45a8ff	1053
bogdanm	0:9b334a45a8ff	1054	/* Enable the interrupts for error handling */
bogdanm	0:9b334a45a8ff	1055	__HAL_SAI_ENABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_DMA));
bogdanm	0:9b334a45a8ff	1056
bogdanm	0:9b334a45a8ff	1057	/* Enable SAI Tx DMA Request */
bogdanm	0:9b334a45a8ff	1058	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	1059
bogdanm	0:9b334a45a8ff	1060	error :
bogdanm	0:9b334a45a8ff	1061	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	1062	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	1063	return errorcode;
bogdanm	0:9b334a45a8ff	1064	}
bogdanm	0:9b334a45a8ff	1065
bogdanm	0:9b334a45a8ff	1066	/**
bogdanm	0:9b334a45a8ff	1067	* @brief Receive an amount of data in non-blocking mode with DMA.
bogdanm	0:9b334a45a8ff	1068	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1069	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1070	* @param pData: Pointer to data buffer
bogdanm	0:9b334a45a8ff	1071	* @param Size: Amount of data to be received
bogdanm	0:9b334a45a8ff	1072	* @retval HAL status
bogdanm	0:9b334a45a8ff	1073	*/
bogdanm	0:9b334a45a8ff	1074	HAL_StatusTypeDef HAL_SAI_Receive_DMA(SAI_HandleTypeDef hsai, uint8_t pData, uint16_t Size)
bogdanm	0:9b334a45a8ff	1075	{
bogdanm	0:9b334a45a8ff	1076	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	1077
bogdanm	0:9b334a45a8ff	1078	/* Process Locked */
bogdanm	0:9b334a45a8ff	1079	__HAL_LOCK(hsai);
bogdanm	0:9b334a45a8ff	1080
bogdanm	0:9b334a45a8ff	1081	if((pData == NULL) \|\| (Size == 0))
bogdanm	0:9b334a45a8ff	1082	{
bogdanm	0:9b334a45a8ff	1083	errorcode = HAL_ERROR;
bogdanm	0:9b334a45a8ff	1084	goto error;
bogdanm	0:9b334a45a8ff	1085	}
bogdanm	0:9b334a45a8ff	1086
bogdanm	0:9b334a45a8ff	1087	if(hsai->State != HAL_SAI_STATE_READY)
bogdanm	0:9b334a45a8ff	1088	{
bogdanm	0:9b334a45a8ff	1089	errorcode = HAL_BUSY;
bogdanm	0:9b334a45a8ff	1090	goto error;
bogdanm	0:9b334a45a8ff	1091	}
bogdanm	0:9b334a45a8ff	1092	hsai->pBuffPtr = pData;
bogdanm	0:9b334a45a8ff	1093	hsai->XferSize = Size;
bogdanm	0:9b334a45a8ff	1094	hsai->XferCount = Size;
bogdanm	0:9b334a45a8ff	1095	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
bogdanm	0:9b334a45a8ff	1096	hsai->State = HAL_SAI_STATE_BUSY_RX;
bogdanm	0:9b334a45a8ff	1097
bogdanm	0:9b334a45a8ff	1098	/* Set the SAI Rx DMA Half transfer complete callback */
bogdanm	0:9b334a45a8ff	1099	hsai->hdmarx->XferHalfCpltCallback = SAI_DMARxHalfCplt;
bogdanm	0:9b334a45a8ff	1100
bogdanm	0:9b334a45a8ff	1101	/* Set the SAI Rx DMA transfer complete callback */
bogdanm	0:9b334a45a8ff	1102	hsai->hdmarx->XferCpltCallback = SAI_DMARxCplt;
bogdanm	0:9b334a45a8ff	1103
bogdanm	0:9b334a45a8ff	1104	/* Set the DMA error callback */
bogdanm	0:9b334a45a8ff	1105	hsai->hdmarx->XferErrorCallback = SAI_DMAError;
bogdanm	0:9b334a45a8ff	1106
bogdanm	0:9b334a45a8ff	1107	/* Enable the Rx DMA Channel */
bogdanm	0:9b334a45a8ff	1108	HAL_DMA_Start_IT(hsai->hdmarx, (uint32_t)&hsai->Instance->DR, (uint32_t)hsai->pBuffPtr, hsai->XferSize);
bogdanm	0:9b334a45a8ff	1109
bogdanm	0:9b334a45a8ff	1110	/* Check if the SAI is already enabled */
bogdanm	0:9b334a45a8ff	1111	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == RESET)
bogdanm	0:9b334a45a8ff	1112	{
bogdanm	0:9b334a45a8ff	1113	/* Enable SAI peripheral */
bogdanm	0:9b334a45a8ff	1114	__HAL_SAI_ENABLE(hsai);
bogdanm	0:9b334a45a8ff	1115	}
bogdanm	0:9b334a45a8ff	1116
bogdanm	0:9b334a45a8ff	1117	/* Enable the interrupts for error handling */
bogdanm	0:9b334a45a8ff	1118	__HAL_SAI_ENABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_DMA));
bogdanm	0:9b334a45a8ff	1119
bogdanm	0:9b334a45a8ff	1120	/* Enable SAI Rx DMA Request */
bogdanm	0:9b334a45a8ff	1121	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
bogdanm	0:9b334a45a8ff	1122
bogdanm	0:9b334a45a8ff	1123	error :
bogdanm	0:9b334a45a8ff	1124	/* Process Unlocked */
bogdanm	0:9b334a45a8ff	1125	__HAL_UNLOCK(hsai);
bogdanm	0:9b334a45a8ff	1126	return errorcode;
bogdanm	0:9b334a45a8ff	1127	}
bogdanm	0:9b334a45a8ff	1128
bogdanm	0:9b334a45a8ff	1129	/**
bogdanm	0:9b334a45a8ff	1130	* @brief Enable the Tx mute mode.
bogdanm	0:9b334a45a8ff	1131	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1132	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1133	* @param val: value sent during the mute @ref SAI_Block_Mute_Value
bogdanm	0:9b334a45a8ff	1134	* @retval HAL status
bogdanm	0:9b334a45a8ff	1135	*/
bogdanm	0:9b334a45a8ff	1136	HAL_StatusTypeDef HAL_SAI_EnableTxMuteMode(SAI_HandleTypeDef *hsai, uint16_t val)
bogdanm	0:9b334a45a8ff	1137	{
bogdanm	0:9b334a45a8ff	1138	assert_param(IS_SAI_BLOCK_MUTE_VALUE(val));
bogdanm	0:9b334a45a8ff	1139
bogdanm	0:9b334a45a8ff	1140	if(hsai->State != HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	1141	{
bogdanm	0:9b334a45a8ff	1142	CLEAR_BIT(hsai->Instance->CR2, SAI_xCR2_MUTEVAL \| SAI_xCR2_MUTE);
bogdanm	0:9b334a45a8ff	1143	SET_BIT(hsai->Instance->CR2, SAI_xCR2_MUTE \| val);
bogdanm	0:9b334a45a8ff	1144	return HAL_OK;
bogdanm	0:9b334a45a8ff	1145	}
bogdanm	0:9b334a45a8ff	1146	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1147	}
bogdanm	0:9b334a45a8ff	1148
bogdanm	0:9b334a45a8ff	1149	/**
bogdanm	0:9b334a45a8ff	1150	* @brief Disable the Tx mute mode.
bogdanm	0:9b334a45a8ff	1151	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1152	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1153	* @retval HAL status
bogdanm	0:9b334a45a8ff	1154	*/
bogdanm	0:9b334a45a8ff	1155	HAL_StatusTypeDef HAL_SAI_DisableTxMuteMode(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1156	{
bogdanm	0:9b334a45a8ff	1157	if(hsai->State != HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	1158	{
bogdanm	0:9b334a45a8ff	1159	CLEAR_BIT(hsai->Instance->CR2, SAI_xCR2_MUTEVAL \| SAI_xCR2_MUTE);
bogdanm	0:9b334a45a8ff	1160	return HAL_OK;
bogdanm	0:9b334a45a8ff	1161	}
bogdanm	0:9b334a45a8ff	1162	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1163	}
bogdanm	0:9b334a45a8ff	1164
bogdanm	0:9b334a45a8ff	1165	/**
bogdanm	0:9b334a45a8ff	1166	* @brief Enable the Rx mute detection.
bogdanm	0:9b334a45a8ff	1167	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1168	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1169	* @param callback: function called when the mute is detected
bogdanm	0:9b334a45a8ff	1170	* @param counter: number a data before mute detection max 63.
bogdanm	0:9b334a45a8ff	1171	* @retval HAL status
bogdanm	0:9b334a45a8ff	1172	*/
bogdanm	0:9b334a45a8ff	1173	HAL_StatusTypeDef HAL_SAI_EnableRxMuteMode(SAI_HandleTypeDef *hsai, SAIcallback callback, uint16_t counter)
bogdanm	0:9b334a45a8ff	1174	{
bogdanm	0:9b334a45a8ff	1175	assert_param(IS_SAI_BLOCK_MUTE_COUNTER(counter));
bogdanm	0:9b334a45a8ff	1176
bogdanm	0:9b334a45a8ff	1177	if(hsai->State != HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	1178	{
bogdanm	0:9b334a45a8ff	1179	/* set the mute counter */
bogdanm	0:9b334a45a8ff	1180	CLEAR_BIT(hsai->Instance->CR2, SAI_xCR2_MUTECNT);
bogdanm	0:9b334a45a8ff	1181	SET_BIT(hsai->Instance->CR2, ((uint32_t)counter << 6));
bogdanm	0:9b334a45a8ff	1182	hsai->mutecallback = callback;
bogdanm	0:9b334a45a8ff	1183	/* enable the IT interrupt */
bogdanm	0:9b334a45a8ff	1184	__HAL_SAI_ENABLE_IT(hsai, SAI_IT_MUTEDET);
bogdanm	0:9b334a45a8ff	1185	return HAL_OK;
bogdanm	0:9b334a45a8ff	1186	}
bogdanm	0:9b334a45a8ff	1187	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1188	}
bogdanm	0:9b334a45a8ff	1189
bogdanm	0:9b334a45a8ff	1190	/**
bogdanm	0:9b334a45a8ff	1191	* @brief Disable the Rx mute detection.
bogdanm	0:9b334a45a8ff	1192	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1193	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1194	* @retval HAL status
bogdanm	0:9b334a45a8ff	1195	*/
bogdanm	0:9b334a45a8ff	1196	HAL_StatusTypeDef HAL_SAI_DisableRxMuteMode(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1197	{
bogdanm	0:9b334a45a8ff	1198	if(hsai->State != HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	1199	{
bogdanm	0:9b334a45a8ff	1200	/* set the mutecallback to NULL */
bogdanm	0:9b334a45a8ff	1201	hsai->mutecallback = (SAIcallback)NULL;
bogdanm	0:9b334a45a8ff	1202	/* enable the IT interrupt */
bogdanm	0:9b334a45a8ff	1203	__HAL_SAI_DISABLE_IT(hsai, SAI_IT_MUTEDET);
bogdanm	0:9b334a45a8ff	1204	return HAL_OK;
bogdanm	0:9b334a45a8ff	1205	}
bogdanm	0:9b334a45a8ff	1206	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1207	}
bogdanm	0:9b334a45a8ff	1208
bogdanm	0:9b334a45a8ff	1209	/**
bogdanm	0:9b334a45a8ff	1210	* @brief Handle SAI interrupt request.
bogdanm	0:9b334a45a8ff	1211	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1212	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1213	* @retval None
bogdanm	0:9b334a45a8ff	1214	*/
bogdanm	0:9b334a45a8ff	1215	void HAL_SAI_IRQHandler(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1216	{
bogdanm	0:9b334a45a8ff	1217	if(hsai->State != HAL_SAI_STATE_RESET)
bogdanm	0:9b334a45a8ff	1218	{
bogdanm	0:9b334a45a8ff	1219	__IO uint32_t tmpFlag = hsai->Instance->SR;
bogdanm	0:9b334a45a8ff	1220	__IO uint32_t tmpItSource = hsai->Instance->IMR;
bogdanm	0:9b334a45a8ff	1221
bogdanm	0:9b334a45a8ff	1222	if(((tmpFlag & SAI_xSR_FREQ) == SAI_xSR_FREQ) && ((tmpItSource & SAI_IT_FREQ) == SAI_IT_FREQ))
bogdanm	0:9b334a45a8ff	1223	{
bogdanm	0:9b334a45a8ff	1224	hsai->InterruptServiceRoutine(hsai);
bogdanm	0:9b334a45a8ff	1225	goto exit;
bogdanm	0:9b334a45a8ff	1226	}
bogdanm	0:9b334a45a8ff	1227
bogdanm	0:9b334a45a8ff	1228	/* check the flag only if one of them is set */
bogdanm	0:9b334a45a8ff	1229	if(tmpFlag != 0x00000000)
bogdanm	0:9b334a45a8ff	1230	{
bogdanm	0:9b334a45a8ff	1231	/* SAI Overrun error interrupt occurred ----------------------------------*/
bogdanm	0:9b334a45a8ff	1232	if(((tmpFlag & SAI_FLAG_OVRUDR) == SAI_FLAG_OVRUDR) && ((tmpItSource & SAI_IT_OVRUDR) == SAI_IT_OVRUDR))
bogdanm	0:9b334a45a8ff	1233	{
bogdanm	0:9b334a45a8ff	1234	/* Clear the SAI Overrun flag */
bogdanm	0:9b334a45a8ff	1235	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
bogdanm	0:9b334a45a8ff	1236	/* Change the SAI error code */
bogdanm	0:9b334a45a8ff	1237	hsai->ErrorCode = ((hsai->State == HAL_SAI_STATE_BUSY_RX) ? HAL_SAI_ERROR_OVR : HAL_SAI_ERROR_UDR);
bogdanm	0:9b334a45a8ff	1238	/* the transfer is not stopped, we will forward the information to the user and we let the user decide what needs to be done */
bogdanm	0:9b334a45a8ff	1239	HAL_SAI_ErrorCallback(hsai);
bogdanm	0:9b334a45a8ff	1240	goto exit;
bogdanm	0:9b334a45a8ff	1241	}
bogdanm	0:9b334a45a8ff	1242
bogdanm	0:9b334a45a8ff	1243	/* SAI mutedet interrupt occurred ----------------------------------*/
bogdanm	0:9b334a45a8ff	1244	if(((tmpFlag & SAI_FLAG_MUTEDET) == SAI_FLAG_MUTEDET) && ((tmpItSource & SAI_IT_MUTEDET) == SAI_IT_MUTEDET))
bogdanm	0:9b334a45a8ff	1245	{
bogdanm	0:9b334a45a8ff	1246	/* Clear the SAI mutedet flag */
bogdanm	0:9b334a45a8ff	1247	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_MUTEDET);
bogdanm	0:9b334a45a8ff	1248	/* call the call back function */
bogdanm	0:9b334a45a8ff	1249	if(hsai->mutecallback != (SAIcallback)NULL)
bogdanm	0:9b334a45a8ff	1250	{
bogdanm	0:9b334a45a8ff	1251	/* inform the user that an RX mute event has been detected */
bogdanm	0:9b334a45a8ff	1252	hsai->mutecallback();
bogdanm	0:9b334a45a8ff	1253	}
bogdanm	0:9b334a45a8ff	1254	goto exit;
bogdanm	0:9b334a45a8ff	1255	}
bogdanm	0:9b334a45a8ff	1256
bogdanm	0:9b334a45a8ff	1257	/* SAI AFSDET interrupt occurred ----------------------------------*/
bogdanm	0:9b334a45a8ff	1258	if(((tmpFlag & SAI_FLAG_AFSDET) == SAI_FLAG_AFSDET) && ((tmpItSource & SAI_IT_AFSDET) == SAI_IT_AFSDET))
bogdanm	0:9b334a45a8ff	1259	{
bogdanm	0:9b334a45a8ff	1260	/* Change the SAI error code */
bogdanm	0:9b334a45a8ff	1261	hsai->ErrorCode = HAL_SAI_ERROR_AFSDET;
bogdanm	0:9b334a45a8ff	1262	goto error;
bogdanm	0:9b334a45a8ff	1263	}
bogdanm	0:9b334a45a8ff	1264
bogdanm	0:9b334a45a8ff	1265	/* SAI LFSDET interrupt occurred ----------------------------------*/
bogdanm	0:9b334a45a8ff	1266	if(((tmpFlag & SAI_FLAG_LFSDET) == SAI_FLAG_LFSDET) && ((tmpItSource & SAI_IT_LFSDET) == SAI_IT_LFSDET))
bogdanm	0:9b334a45a8ff	1267	{
bogdanm	0:9b334a45a8ff	1268	/* Change the SAI error code */
bogdanm	0:9b334a45a8ff	1269	hsai->ErrorCode = HAL_SAI_ERROR_LFSDET;
bogdanm	0:9b334a45a8ff	1270	goto error;
bogdanm	0:9b334a45a8ff	1271	}
bogdanm	0:9b334a45a8ff	1272
bogdanm	0:9b334a45a8ff	1273	/* SAI WCKCFG interrupt occurred ----------------------------------*/
bogdanm	0:9b334a45a8ff	1274	if(((tmpFlag & SAI_FLAG_WCKCFG) == SAI_FLAG_WCKCFG) && ((tmpItSource & SAI_IT_WCKCFG) == SAI_IT_WCKCFG))
bogdanm	0:9b334a45a8ff	1275	{
bogdanm	0:9b334a45a8ff	1276	/* Change the SAI error code */
bogdanm	0:9b334a45a8ff	1277	hsai->ErrorCode = HAL_SAI_ERROR_WCKCFG;
bogdanm	0:9b334a45a8ff	1278	goto error;
bogdanm	0:9b334a45a8ff	1279	}
bogdanm	0:9b334a45a8ff	1280	}
bogdanm	0:9b334a45a8ff	1281	}
bogdanm	0:9b334a45a8ff	1282
bogdanm	0:9b334a45a8ff	1283	exit :
bogdanm	0:9b334a45a8ff	1284	return;
bogdanm	0:9b334a45a8ff	1285	error :
bogdanm	0:9b334a45a8ff	1286	/* Abort the current communication, disable the SAI block, and clear all the flags */
bogdanm	0:9b334a45a8ff	1287	HAL_SAI_Abort(hsai);
bogdanm	0:9b334a45a8ff	1288	HAL_SAI_ErrorCallback(hsai);
bogdanm	0:9b334a45a8ff	1289	return;
bogdanm	0:9b334a45a8ff	1290	}
bogdanm	0:9b334a45a8ff	1291
bogdanm	0:9b334a45a8ff	1292	/**
bogdanm	0:9b334a45a8ff	1293	* @brief Tx Transfer completed callback.
bogdanm	0:9b334a45a8ff	1294	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1295	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1296	* @retval None
bogdanm	0:9b334a45a8ff	1297	*/
bogdanm	0:9b334a45a8ff	1298	__weak void HAL_SAI_TxCpltCallback(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1299	{
bogdanm	0:9b334a45a8ff	1300	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	1301	the HAL_SAI_TxCpltCallback could be implemented in the user file
bogdanm	0:9b334a45a8ff	1302	*/
bogdanm	0:9b334a45a8ff	1303	}
bogdanm	0:9b334a45a8ff	1304
bogdanm	0:9b334a45a8ff	1305	/**
bogdanm	0:9b334a45a8ff	1306	* @brief Tx Transfer Half completed callback.
bogdanm	0:9b334a45a8ff	1307	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1308	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1309	* @retval None
bogdanm	0:9b334a45a8ff	1310	*/
bogdanm	0:9b334a45a8ff	1311	__weak void HAL_SAI_TxHalfCpltCallback(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1312	{
bogdanm	0:9b334a45a8ff	1313	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	1314	the HAL_SAI_TxHalfCpltCallback could be implemented in the user file
bogdanm	0:9b334a45a8ff	1315	*/
bogdanm	0:9b334a45a8ff	1316	}
bogdanm	0:9b334a45a8ff	1317
bogdanm	0:9b334a45a8ff	1318	/**
bogdanm	0:9b334a45a8ff	1319	* @brief Rx Transfer completed callback.
bogdanm	0:9b334a45a8ff	1320	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1321	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1322	* @retval None
bogdanm	0:9b334a45a8ff	1323	*/
bogdanm	0:9b334a45a8ff	1324	__weak void HAL_SAI_RxCpltCallback(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1325	{
bogdanm	0:9b334a45a8ff	1326	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	1327	the HAL_SAI_RxCpltCallback could be implemented in the user file
bogdanm	0:9b334a45a8ff	1328	*/
bogdanm	0:9b334a45a8ff	1329	}
bogdanm	0:9b334a45a8ff	1330
bogdanm	0:9b334a45a8ff	1331	/**
bogdanm	0:9b334a45a8ff	1332	* @brief Rx Transfer half completed callback.
bogdanm	0:9b334a45a8ff	1333	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1334	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1335	* @retval None
bogdanm	0:9b334a45a8ff	1336	*/
bogdanm	0:9b334a45a8ff	1337	__weak void HAL_SAI_RxHalfCpltCallback(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1338	{
bogdanm	0:9b334a45a8ff	1339	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	1340	the HAL_SAI_RxCpltCallback could be implemented in the user file
bogdanm	0:9b334a45a8ff	1341	*/
bogdanm	0:9b334a45a8ff	1342	}
bogdanm	0:9b334a45a8ff	1343
bogdanm	0:9b334a45a8ff	1344	/**
bogdanm	0:9b334a45a8ff	1345	* @brief SAI error callback.
bogdanm	0:9b334a45a8ff	1346	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1347	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1348	* @retval None
bogdanm	0:9b334a45a8ff	1349	*/
bogdanm	0:9b334a45a8ff	1350	__weak void HAL_SAI_ErrorCallback(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1351	{
bogdanm	0:9b334a45a8ff	1352	/* NOTE : This function should not be modified, when the callback is needed,
bogdanm	0:9b334a45a8ff	1353	the HAL_SAI_ErrorCallback could be implemented in the user file
bogdanm	0:9b334a45a8ff	1354	*/
bogdanm	0:9b334a45a8ff	1355	}
bogdanm	0:9b334a45a8ff	1356
bogdanm	0:9b334a45a8ff	1357	/**
bogdanm	0:9b334a45a8ff	1358	* @}
bogdanm	0:9b334a45a8ff	1359	*/
bogdanm	0:9b334a45a8ff	1360
bogdanm	0:9b334a45a8ff	1361
bogdanm	0:9b334a45a8ff	1362	/** @defgroup SAI_Exported_Functions_Group3 Peripheral State functions
bogdanm	0:9b334a45a8ff	1363	* @brief Peripheral State functions
bogdanm	0:9b334a45a8ff	1364	*
bogdanm	0:9b334a45a8ff	1365	@verbatim
bogdanm	0:9b334a45a8ff	1366	===============================================================================
bogdanm	0:9b334a45a8ff	1367	##### Peripheral State and Errors functions #####
bogdanm	0:9b334a45a8ff	1368	===============================================================================
bogdanm	0:9b334a45a8ff	1369	[..]
bogdanm	0:9b334a45a8ff	1370	This subsection permits to get in run-time the status of the peripheral
bogdanm	0:9b334a45a8ff	1371	and the data flow.
bogdanm	0:9b334a45a8ff	1372
bogdanm	0:9b334a45a8ff	1373	@endverbatim
bogdanm	0:9b334a45a8ff	1374	* @{
bogdanm	0:9b334a45a8ff	1375	*/
bogdanm	0:9b334a45a8ff	1376
bogdanm	0:9b334a45a8ff	1377	/**
bogdanm	0:9b334a45a8ff	1378	* @brief Return the SAI handle state.
bogdanm	0:9b334a45a8ff	1379	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1380	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1381	* @retval HAL state
bogdanm	0:9b334a45a8ff	1382	*/
bogdanm	0:9b334a45a8ff	1383	HAL_SAI_StateTypeDef HAL_SAI_GetState(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1384	{
bogdanm	0:9b334a45a8ff	1385	/* Return SAI handle state */
bogdanm	0:9b334a45a8ff	1386	return hsai->State;
bogdanm	0:9b334a45a8ff	1387	}
bogdanm	0:9b334a45a8ff	1388
bogdanm	0:9b334a45a8ff	1389	/**
bogdanm	0:9b334a45a8ff	1390	* @brief Return the SAI error code.
bogdanm	0:9b334a45a8ff	1391	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1392	* the configuration information for the specified SAI Block.
bogdanm	0:9b334a45a8ff	1393	* @retval SAI Error Code
bogdanm	0:9b334a45a8ff	1394	*/
bogdanm	0:9b334a45a8ff	1395	uint32_t HAL_SAI_GetError(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1396	{
bogdanm	0:9b334a45a8ff	1397	return hsai->ErrorCode;
bogdanm	0:9b334a45a8ff	1398	}
bogdanm	0:9b334a45a8ff	1399	/**
bogdanm	0:9b334a45a8ff	1400	* @}
bogdanm	0:9b334a45a8ff	1401	*/
bogdanm	0:9b334a45a8ff	1402
bogdanm	0:9b334a45a8ff	1403	/**
bogdanm	0:9b334a45a8ff	1404	* @}
bogdanm	0:9b334a45a8ff	1405	*/
bogdanm	0:9b334a45a8ff	1406
bogdanm	0:9b334a45a8ff	1407	/** @addtogroup SAI_Private_Functions
bogdanm	0:9b334a45a8ff	1408	* @brief Private functions
bogdanm	0:9b334a45a8ff	1409	* @{
bogdanm	0:9b334a45a8ff	1410	*/
bogdanm	0:9b334a45a8ff	1411	/**
bogdanm	0:9b334a45a8ff	1412	* @brief Initialize the SAI I2S protocol according to the specified parameters
bogdanm	0:9b334a45a8ff	1413	* in the SAI_InitTypeDef and create the associated handle.
bogdanm	0:9b334a45a8ff	1414	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1415	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1416	* @param protocol: one of the supported protocol
bogdanm	0:9b334a45a8ff	1417	* @param datasize: one of the supported datasize @ref SAI_Protocol_DataSize
bogdanm	0:9b334a45a8ff	1418	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1419	* @param nbslot: number of slot minimum value is 2 and max is 16.
bogdanm	0:9b334a45a8ff	1420	* the value must be a multiple of 2.
bogdanm	0:9b334a45a8ff	1421	* @retval HAL status
bogdanm	0:9b334a45a8ff	1422	*/
bogdanm	0:9b334a45a8ff	1423	static HAL_StatusTypeDef SAI_InitI2S(SAI_HandleTypeDef *hsai, uint32_t protocol, uint32_t datasize, uint32_t nbslot)
bogdanm	0:9b334a45a8ff	1424	{
bogdanm	0:9b334a45a8ff	1425	hsai->Init.Protocol = SAI_FREE_PROTOCOL;
bogdanm	0:9b334a45a8ff	1426	hsai->Init.FirstBit = SAI_FIRSTBIT_MSB;
bogdanm	0:9b334a45a8ff	1427	hsai->Init.ClockStrobing = SAI_CLOCKSTROBING_FALLINGEDGE;
bogdanm	0:9b334a45a8ff	1428	hsai->FrameInit.FSDefinition = SAI_FS_CHANNEL_IDENTIFICATION;
bogdanm	0:9b334a45a8ff	1429	hsai->SlotInit.SlotActive = SAI_SLOTACTIVE_ALL;
bogdanm	0:9b334a45a8ff	1430	hsai->SlotInit.FirstBitOffset = 0;
bogdanm	0:9b334a45a8ff	1431	hsai->SlotInit.SlotNumber = nbslot;
bogdanm	0:9b334a45a8ff	1432
bogdanm	0:9b334a45a8ff	1433	/* in IS2 the number of slot must be even */
bogdanm	0:9b334a45a8ff	1434	if((nbslot & 0x1) != 0 )
bogdanm	0:9b334a45a8ff	1435	{
bogdanm	0:9b334a45a8ff	1436	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1437	}
bogdanm	0:9b334a45a8ff	1438
bogdanm	0:9b334a45a8ff	1439	switch(protocol)
bogdanm	0:9b334a45a8ff	1440	{
bogdanm	0:9b334a45a8ff	1441	case SAI_I2S_STANDARD :
bogdanm	0:9b334a45a8ff	1442	hsai->FrameInit.FSPolarity = SAI_FS_ACTIVE_LOW;
bogdanm	0:9b334a45a8ff	1443	hsai->FrameInit.FSOffset = SAI_FS_BEFOREFIRSTBIT;
bogdanm	0:9b334a45a8ff	1444	break;
bogdanm	0:9b334a45a8ff	1445	case SAI_I2S_MSBJUSTIFIED :
bogdanm	0:9b334a45a8ff	1446	case SAI_I2S_LSBJUSTIFIED :
bogdanm	0:9b334a45a8ff	1447	hsai->FrameInit.FSPolarity = SAI_FS_ACTIVE_HIGH;
bogdanm	0:9b334a45a8ff	1448	hsai->FrameInit.FSOffset = SAI_FS_FIRSTBIT;
bogdanm	0:9b334a45a8ff	1449	break;
bogdanm	0:9b334a45a8ff	1450	default :
bogdanm	0:9b334a45a8ff	1451	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1452	}
bogdanm	0:9b334a45a8ff	1453
bogdanm	0:9b334a45a8ff	1454	/* Frame definition */
bogdanm	0:9b334a45a8ff	1455	hsai->Init.DataSize = 0xFFFFFFFF;
bogdanm	0:9b334a45a8ff	1456	switch(datasize)
bogdanm	0:9b334a45a8ff	1457	{
bogdanm	0:9b334a45a8ff	1458	case SAI_PROTOCOL_DATASIZE_16BIT:
bogdanm	0:9b334a45a8ff	1459	hsai->Init.DataSize = SAI_DATASIZE_16;
bogdanm	0:9b334a45a8ff	1460	hsai->FrameInit.FrameLength = 32*(nbslot/2);
bogdanm	0:9b334a45a8ff	1461	hsai->FrameInit.ActiveFrameLength = 16*(nbslot/2);
bogdanm	0:9b334a45a8ff	1462	hsai->SlotInit.SlotSize = SAI_SLOTSIZE_16B;
bogdanm	0:9b334a45a8ff	1463	break;
bogdanm	0:9b334a45a8ff	1464	case SAI_PROTOCOL_DATASIZE_16BITEXTENDED :
bogdanm	0:9b334a45a8ff	1465	if (hsai->Init.DataSize == 0xFFFFFFFF)
bogdanm	0:9b334a45a8ff	1466	{
bogdanm	0:9b334a45a8ff	1467	hsai->Init.DataSize = SAI_DATASIZE_16;
bogdanm	0:9b334a45a8ff	1468	}
bogdanm	0:9b334a45a8ff	1469	/* Fall thru next statement */
bogdanm	0:9b334a45a8ff	1470	case SAI_PROTOCOL_DATASIZE_24BIT:
bogdanm	0:9b334a45a8ff	1471	if (hsai->Init.DataSize == 0xFFFFFFFF)
bogdanm	0:9b334a45a8ff	1472	{
bogdanm	0:9b334a45a8ff	1473	hsai->Init.DataSize = SAI_DATASIZE_24;
bogdanm	0:9b334a45a8ff	1474	}
bogdanm	0:9b334a45a8ff	1475	/* Fall thru next statement */
bogdanm	0:9b334a45a8ff	1476	case SAI_PROTOCOL_DATASIZE_32BIT:
bogdanm	0:9b334a45a8ff	1477	if (hsai->Init.DataSize == 0xFFFFFFFF)
bogdanm	0:9b334a45a8ff	1478	{
bogdanm	0:9b334a45a8ff	1479	hsai->Init.DataSize = SAI_DATASIZE_32;
bogdanm	0:9b334a45a8ff	1480	}
bogdanm	0:9b334a45a8ff	1481
bogdanm	0:9b334a45a8ff	1482	hsai->FrameInit.FrameLength = 64*(nbslot/2);
bogdanm	0:9b334a45a8ff	1483	hsai->FrameInit.ActiveFrameLength = 32*(nbslot/2);
bogdanm	0:9b334a45a8ff	1484	hsai->SlotInit.SlotSize = SAI_SLOTSIZE_32B;
bogdanm	0:9b334a45a8ff	1485
bogdanm	0:9b334a45a8ff	1486	if(protocol == SAI_I2S_LSBJUSTIFIED)
bogdanm	0:9b334a45a8ff	1487	{
bogdanm	0:9b334a45a8ff	1488	if (datasize == SAI_PROTOCOL_DATASIZE_16BITEXTENDED)
bogdanm	0:9b334a45a8ff	1489	{
bogdanm	0:9b334a45a8ff	1490	hsai->SlotInit.FirstBitOffset = 16;
bogdanm	0:9b334a45a8ff	1491	}
bogdanm	0:9b334a45a8ff	1492	if (datasize == SAI_PROTOCOL_DATASIZE_24BIT)
bogdanm	0:9b334a45a8ff	1493	{
bogdanm	0:9b334a45a8ff	1494	hsai->SlotInit.FirstBitOffset = 8;
bogdanm	0:9b334a45a8ff	1495	}
bogdanm	0:9b334a45a8ff	1496	}
bogdanm	0:9b334a45a8ff	1497	break;
bogdanm	0:9b334a45a8ff	1498	default :
bogdanm	0:9b334a45a8ff	1499	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1500	}
bogdanm	0:9b334a45a8ff	1501
bogdanm	0:9b334a45a8ff	1502	return HAL_OK;
bogdanm	0:9b334a45a8ff	1503	}
bogdanm	0:9b334a45a8ff	1504
bogdanm	0:9b334a45a8ff	1505	/**
bogdanm	0:9b334a45a8ff	1506	* @brief Initialize the SAI PCM protocol according to the specified parameters
bogdanm	0:9b334a45a8ff	1507	* in the SAI_InitTypeDef and create the associated handle.
bogdanm	0:9b334a45a8ff	1508	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1509	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1510	* @param protocol: one of the supported protocol
bogdanm	0:9b334a45a8ff	1511	* @param datasize: one of the supported datasize @ref SAI_Protocol_DataSize
bogdanm	0:9b334a45a8ff	1512	* @param nbslot: number of slot minimum value is 1 and the max is 16.
bogdanm	0:9b334a45a8ff	1513	* @retval HAL status
bogdanm	0:9b334a45a8ff	1514	*/
bogdanm	0:9b334a45a8ff	1515	static HAL_StatusTypeDef SAI_InitPCM(SAI_HandleTypeDef *hsai, uint32_t protocol, uint32_t datasize, uint32_t nbslot)
bogdanm	0:9b334a45a8ff	1516	{
bogdanm	0:9b334a45a8ff	1517	hsai->Init.Protocol = SAI_FREE_PROTOCOL;
bogdanm	0:9b334a45a8ff	1518	hsai->Init.FirstBit = SAI_FIRSTBIT_MSB;
bogdanm	0:9b334a45a8ff	1519	hsai->Init.ClockStrobing = SAI_CLOCKSTROBING_FALLINGEDGE;
bogdanm	0:9b334a45a8ff	1520	hsai->FrameInit.FSDefinition = SAI_FS_STARTFRAME;
bogdanm	0:9b334a45a8ff	1521	hsai->FrameInit.FSPolarity = SAI_FS_ACTIVE_HIGH;
bogdanm	0:9b334a45a8ff	1522	hsai->FrameInit.FSOffset = SAI_FS_BEFOREFIRSTBIT;
bogdanm	0:9b334a45a8ff	1523	hsai->SlotInit.FirstBitOffset = 0;
bogdanm	0:9b334a45a8ff	1524	hsai->SlotInit.SlotNumber = nbslot;
bogdanm	0:9b334a45a8ff	1525	hsai->SlotInit.SlotActive = SAI_SLOTACTIVE_ALL;
bogdanm	0:9b334a45a8ff	1526
bogdanm	0:9b334a45a8ff	1527	switch(protocol)
bogdanm	0:9b334a45a8ff	1528	{
bogdanm	0:9b334a45a8ff	1529	case SAI_PCM_SHORT :
bogdanm	0:9b334a45a8ff	1530	hsai->FrameInit.ActiveFrameLength = 1;
bogdanm	0:9b334a45a8ff	1531	break;
bogdanm	0:9b334a45a8ff	1532	case SAI_PCM_LONG :
bogdanm	0:9b334a45a8ff	1533	hsai->FrameInit.ActiveFrameLength = 13;
bogdanm	0:9b334a45a8ff	1534	break;
bogdanm	0:9b334a45a8ff	1535	default :
bogdanm	0:9b334a45a8ff	1536	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1537	}
bogdanm	0:9b334a45a8ff	1538
bogdanm	0:9b334a45a8ff	1539	switch(datasize)
bogdanm	0:9b334a45a8ff	1540	{
bogdanm	0:9b334a45a8ff	1541	case SAI_PROTOCOL_DATASIZE_16BIT:
bogdanm	0:9b334a45a8ff	1542	hsai->Init.DataSize = SAI_DATASIZE_16;
bogdanm	0:9b334a45a8ff	1543	hsai->FrameInit.FrameLength = 16 * nbslot;
bogdanm	0:9b334a45a8ff	1544	hsai->SlotInit.SlotSize = SAI_SLOTSIZE_16B;
bogdanm	0:9b334a45a8ff	1545	break;
bogdanm	0:9b334a45a8ff	1546	case SAI_PROTOCOL_DATASIZE_16BITEXTENDED :
bogdanm	0:9b334a45a8ff	1547	hsai->Init.DataSize = SAI_DATASIZE_16;
bogdanm	0:9b334a45a8ff	1548	hsai->FrameInit.FrameLength = 32 * nbslot;
bogdanm	0:9b334a45a8ff	1549	hsai->SlotInit.SlotSize = SAI_SLOTSIZE_32B;
bogdanm	0:9b334a45a8ff	1550	break;
bogdanm	0:9b334a45a8ff	1551
bogdanm	0:9b334a45a8ff	1552	case SAI_PROTOCOL_DATASIZE_32BIT:
bogdanm	0:9b334a45a8ff	1553	hsai->Init.DataSize = SAI_DATASIZE_32;
bogdanm	0:9b334a45a8ff	1554	hsai->FrameInit.FrameLength = 32 * nbslot;
bogdanm	0:9b334a45a8ff	1555	hsai->SlotInit.SlotSize = SAI_SLOTSIZE_32B;
bogdanm	0:9b334a45a8ff	1556	break;
bogdanm	0:9b334a45a8ff	1557	default :
bogdanm	0:9b334a45a8ff	1558	return HAL_ERROR;
bogdanm	0:9b334a45a8ff	1559	}
bogdanm	0:9b334a45a8ff	1560
bogdanm	0:9b334a45a8ff	1561	return HAL_OK;
bogdanm	0:9b334a45a8ff	1562	}
bogdanm	0:9b334a45a8ff	1563
bogdanm	0:9b334a45a8ff	1564	/**
bogdanm	0:9b334a45a8ff	1565	* @brief Fill the fifo.
bogdanm	0:9b334a45a8ff	1566	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1567	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1568	* @retval None
bogdanm	0:9b334a45a8ff	1569	*/
bogdanm	0:9b334a45a8ff	1570	static void SAI_FillFifo(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1571	{
bogdanm	0:9b334a45a8ff	1572	/* fill the fifo with data before to enabled the SAI */
bogdanm	0:9b334a45a8ff	1573	while((hsai->Instance->SR & SAI_xSR_FLVL) != SAI_FIFOSTATUS_FULL)
bogdanm	0:9b334a45a8ff	1574	{
bogdanm	0:9b334a45a8ff	1575	if((hsai->Init.DataSize == SAI_DATASIZE_8) && (hsai->Init.CompandingMode == SAI_NOCOMPANDING))
bogdanm	0:9b334a45a8ff	1576	{
bogdanm	0:9b334a45a8ff	1577	hsai->Instance->DR = (*hsai->pBuffPtr++);
bogdanm	0:9b334a45a8ff	1578	}
bogdanm	0:9b334a45a8ff	1579	else if(hsai->Init.DataSize <= SAI_DATASIZE_16)
bogdanm	0:9b334a45a8ff	1580	{
bogdanm	0:9b334a45a8ff	1581	hsai->Instance->DR = ((uint32_t )hsai->pBuffPtr);
bogdanm	0:9b334a45a8ff	1582	hsai->pBuffPtr+= 2;
bogdanm	0:9b334a45a8ff	1583	}
bogdanm	0:9b334a45a8ff	1584	else
bogdanm	0:9b334a45a8ff	1585	{
bogdanm	0:9b334a45a8ff	1586	hsai->Instance->DR = ((uint32_t )hsai->pBuffPtr);
bogdanm	0:9b334a45a8ff	1587	hsai->pBuffPtr+= 4;
bogdanm	0:9b334a45a8ff	1588	}
bogdanm	0:9b334a45a8ff	1589	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1590	}
bogdanm	0:9b334a45a8ff	1591	}
bogdanm	0:9b334a45a8ff	1592
bogdanm	0:9b334a45a8ff	1593	/**
bogdanm	0:9b334a45a8ff	1594	* @brief Return the interrupt flag to set according the SAI setup.
bogdanm	0:9b334a45a8ff	1595	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1596	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1597	* @param mode: SAI_MODE_DMA or SAI_MODE_IT
bogdanm	0:9b334a45a8ff	1598	* @retval the list of the IT flag to enable
bogdanm	0:9b334a45a8ff	1599	*/
bogdanm	0:9b334a45a8ff	1600	static int32_t SAI_InterruptFlag(SAI_HandleTypeDef *hsai, uint32_t mode)
bogdanm	0:9b334a45a8ff	1601	{
bogdanm	0:9b334a45a8ff	1602	int32_t tmpIT = SAI_IT_OVRUDR;
bogdanm	0:9b334a45a8ff	1603
bogdanm	0:9b334a45a8ff	1604	if(mode == SAI_MODE_IT)
bogdanm	0:9b334a45a8ff	1605	{
bogdanm	0:9b334a45a8ff	1606	tmpIT\|= SAI_IT_FREQ;
bogdanm	0:9b334a45a8ff	1607	}
bogdanm	0:9b334a45a8ff	1608
bogdanm	0:9b334a45a8ff	1609	if((hsai->Init.AudioMode == SAI_MODESLAVE_RX) \|\| (hsai->Init.AudioMode == SAI_MODESLAVE_TX))
bogdanm	0:9b334a45a8ff	1610	{
bogdanm	0:9b334a45a8ff	1611	tmpIT\|= SAI_IT_AFSDET \| SAI_IT_LFSDET;
bogdanm	0:9b334a45a8ff	1612	}
bogdanm	0:9b334a45a8ff	1613	else
bogdanm	0:9b334a45a8ff	1614	{
bogdanm	0:9b334a45a8ff	1615	/* hsai has been configured in master mode */
bogdanm	0:9b334a45a8ff	1616	tmpIT\|= SAI_IT_WCKCFG;
bogdanm	0:9b334a45a8ff	1617	}
bogdanm	0:9b334a45a8ff	1618	return tmpIT;
bogdanm	0:9b334a45a8ff	1619	}
bogdanm	0:9b334a45a8ff	1620
bogdanm	0:9b334a45a8ff	1621	/**
bogdanm	0:9b334a45a8ff	1622	* @brief Disable the SAI and wait for the disabling.
bogdanm	0:9b334a45a8ff	1623	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1624	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1625	* @retval None
bogdanm	0:9b334a45a8ff	1626	*/
bogdanm	0:9b334a45a8ff	1627	static HAL_StatusTypeDef SAI_Disable(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1628	{
bogdanm	0:9b334a45a8ff	1629	uint32_t tickstart = HAL_GetTick();
bogdanm	0:9b334a45a8ff	1630	HAL_StatusTypeDef errorcode = HAL_OK;
bogdanm	0:9b334a45a8ff	1631
bogdanm	0:9b334a45a8ff	1632	__HAL_SAI_DISABLE(hsai);
bogdanm	0:9b334a45a8ff	1633	while((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != RESET)
bogdanm	0:9b334a45a8ff	1634	{
bogdanm	0:9b334a45a8ff	1635	/* Check for the Timeout */
bogdanm	0:9b334a45a8ff	1636	if((HAL_GetTick() - tickstart) > SAI_DEFAULT_TIMEOUT)
bogdanm	0:9b334a45a8ff	1637	{
bogdanm	0:9b334a45a8ff	1638	errorcode = HAL_TIMEOUT;
bogdanm	0:9b334a45a8ff	1639	goto error;
bogdanm	0:9b334a45a8ff	1640	}
bogdanm	0:9b334a45a8ff	1641	}
bogdanm	0:9b334a45a8ff	1642	error:
bogdanm	0:9b334a45a8ff	1643	return errorcode;
bogdanm	0:9b334a45a8ff	1644	}
bogdanm	0:9b334a45a8ff	1645
bogdanm	0:9b334a45a8ff	1646	/**
bogdanm	0:9b334a45a8ff	1647	* @brief Tx Handler for Transmit in Interrupt mode 8-bit transfer.
bogdanm	0:9b334a45a8ff	1648	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1649	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1650	* @retval None
bogdanm	0:9b334a45a8ff	1651	*/
bogdanm	0:9b334a45a8ff	1652	static void SAI_Transmit_IT8Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1653	{
bogdanm	0:9b334a45a8ff	1654	/* Write data on DR register */
bogdanm	0:9b334a45a8ff	1655	hsai->Instance->DR = (*hsai->pBuffPtr++);
bogdanm	0:9b334a45a8ff	1656	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1657
bogdanm	0:9b334a45a8ff	1658	/* Handle the end of the transmission */
bogdanm	0:9b334a45a8ff	1659	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1660	{
bogdanm	0:9b334a45a8ff	1661	/* Disable FREQ and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1662	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1663	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1664	HAL_SAI_TxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1665	}
bogdanm	0:9b334a45a8ff	1666	}
bogdanm	0:9b334a45a8ff	1667
bogdanm	0:9b334a45a8ff	1668	/**
bogdanm	0:9b334a45a8ff	1669	* @brief Tx Handler for Transmit in Interrupt mode for 16-bit transfer.
bogdanm	0:9b334a45a8ff	1670	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1671	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1672	* @retval None
bogdanm	0:9b334a45a8ff	1673	*/
bogdanm	0:9b334a45a8ff	1674	static void SAI_Transmit_IT16Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1675	{
bogdanm	0:9b334a45a8ff	1676	/* Write data on DR register */
bogdanm	0:9b334a45a8ff	1677	hsai->Instance->DR = (uint16_t )hsai->pBuffPtr;
bogdanm	0:9b334a45a8ff	1678	hsai->pBuffPtr+=2;
bogdanm	0:9b334a45a8ff	1679	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1680
bogdanm	0:9b334a45a8ff	1681	/* Handle the end of the transmission */
bogdanm	0:9b334a45a8ff	1682	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1683	{
bogdanm	0:9b334a45a8ff	1684	/* Disable FREQ and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1685	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1686	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1687	HAL_SAI_TxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1688	}
bogdanm	0:9b334a45a8ff	1689	}
bogdanm	0:9b334a45a8ff	1690
bogdanm	0:9b334a45a8ff	1691	/**
bogdanm	0:9b334a45a8ff	1692	* @brief Tx Handler for Transmit in Interrupt mode for 32-bit transfer.
bogdanm	0:9b334a45a8ff	1693	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1694	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1695	* @retval None
bogdanm	0:9b334a45a8ff	1696	*/
bogdanm	0:9b334a45a8ff	1697	static void SAI_Transmit_IT32Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1698	{
bogdanm	0:9b334a45a8ff	1699	/* Write data on DR register */
bogdanm	0:9b334a45a8ff	1700	hsai->Instance->DR = (uint32_t )hsai->pBuffPtr;
bogdanm	0:9b334a45a8ff	1701	hsai->pBuffPtr+=4;
bogdanm	0:9b334a45a8ff	1702	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1703
bogdanm	0:9b334a45a8ff	1704	/* Handle the end of the transmission */
bogdanm	0:9b334a45a8ff	1705	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1706	{
bogdanm	0:9b334a45a8ff	1707	/* Disable FREQ and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1708	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1709	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1710	HAL_SAI_TxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1711	}
bogdanm	0:9b334a45a8ff	1712	}
bogdanm	0:9b334a45a8ff	1713
bogdanm	0:9b334a45a8ff	1714	/**
bogdanm	0:9b334a45a8ff	1715	* @brief Rx Handler for Receive in Interrupt mode 8-bit transfer.
bogdanm	0:9b334a45a8ff	1716	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1717	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1718	* @retval None
bogdanm	0:9b334a45a8ff	1719	*/
bogdanm	0:9b334a45a8ff	1720	static void SAI_Receive_IT8Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1721	{
bogdanm	0:9b334a45a8ff	1722	/* Receive data */
bogdanm	0:9b334a45a8ff	1723	(*hsai->pBuffPtr++) = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	1724	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1725
bogdanm	0:9b334a45a8ff	1726	/* Check end of the transfer */
bogdanm	0:9b334a45a8ff	1727	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1728	{
bogdanm	0:9b334a45a8ff	1729	/* Disable TXE and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1730	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1731
bogdanm	0:9b334a45a8ff	1732	/* Clear the SAI Overrun flag */
bogdanm	0:9b334a45a8ff	1733	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
bogdanm	0:9b334a45a8ff	1734
bogdanm	0:9b334a45a8ff	1735	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1736	HAL_SAI_RxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1737	}
bogdanm	0:9b334a45a8ff	1738	}
bogdanm	0:9b334a45a8ff	1739
bogdanm	0:9b334a45a8ff	1740	/**
bogdanm	0:9b334a45a8ff	1741	* @brief Rx Handler for Receive in Interrupt mode for 16-bit transfer.
bogdanm	0:9b334a45a8ff	1742	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1743	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1744	* @retval None
bogdanm	0:9b334a45a8ff	1745	*/
bogdanm	0:9b334a45a8ff	1746	static void SAI_Receive_IT16Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1747	{
bogdanm	0:9b334a45a8ff	1748	/* Receive data */
bogdanm	0:9b334a45a8ff	1749	(uint16_t)hsai->pBuffPtr = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	1750	hsai->pBuffPtr+=2;
bogdanm	0:9b334a45a8ff	1751	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1752
bogdanm	0:9b334a45a8ff	1753	/* Check end of the transfer */
bogdanm	0:9b334a45a8ff	1754	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1755	{
bogdanm	0:9b334a45a8ff	1756	/* Disable TXE and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1757	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1758
bogdanm	0:9b334a45a8ff	1759	/* Clear the SAI Overrun flag */
bogdanm	0:9b334a45a8ff	1760	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
bogdanm	0:9b334a45a8ff	1761
bogdanm	0:9b334a45a8ff	1762	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1763	HAL_SAI_RxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1764	}
bogdanm	0:9b334a45a8ff	1765	}
bogdanm	0:9b334a45a8ff	1766	/**
bogdanm	0:9b334a45a8ff	1767	* @brief Rx Handler for Receive in Interrupt mode for 32-bit transfer.
bogdanm	0:9b334a45a8ff	1768	* @param hsai: pointer to a SAI_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1769	* the configuration information for SAI module.
bogdanm	0:9b334a45a8ff	1770	* @retval None
bogdanm	0:9b334a45a8ff	1771	*/
bogdanm	0:9b334a45a8ff	1772	static void SAI_Receive_IT32Bit(SAI_HandleTypeDef *hsai)
bogdanm	0:9b334a45a8ff	1773	{
bogdanm	0:9b334a45a8ff	1774	/* Receive data */
bogdanm	0:9b334a45a8ff	1775	(uint32_t)hsai->pBuffPtr = hsai->Instance->DR;
bogdanm	0:9b334a45a8ff	1776	hsai->pBuffPtr+=4;
bogdanm	0:9b334a45a8ff	1777	hsai->XferCount--;
bogdanm	0:9b334a45a8ff	1778
bogdanm	0:9b334a45a8ff	1779	/* Check end of the transfer */
bogdanm	0:9b334a45a8ff	1780	if(hsai->XferCount == 0)
bogdanm	0:9b334a45a8ff	1781	{
bogdanm	0:9b334a45a8ff	1782	/* Disable TXE and OVRUDR interrupts */
bogdanm	0:9b334a45a8ff	1783	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_IT));
bogdanm	0:9b334a45a8ff	1784
bogdanm	0:9b334a45a8ff	1785	/* Clear the SAI Overrun flag */
bogdanm	0:9b334a45a8ff	1786	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
bogdanm	0:9b334a45a8ff	1787
bogdanm	0:9b334a45a8ff	1788	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1789	HAL_SAI_RxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1790	}
bogdanm	0:9b334a45a8ff	1791	}
bogdanm	0:9b334a45a8ff	1792	/**
bogdanm	0:9b334a45a8ff	1793	* @brief DMA SAI transmit process complete callback.
bogdanm	0:9b334a45a8ff	1794	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1795	* the configuration information for the specified DMA module.
bogdanm	0:9b334a45a8ff	1796	* @retval None
bogdanm	0:9b334a45a8ff	1797	*/
bogdanm	0:9b334a45a8ff	1798	static void SAI_DMATxCplt(DMA_HandleTypeDef *hdma)
bogdanm	0:9b334a45a8ff	1799	{
bogdanm	0:9b334a45a8ff	1800	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef )hdma)->Parent;
bogdanm	0:9b334a45a8ff	1801
bogdanm	0:9b334a45a8ff	1802	if((hdma->Instance->CCR & DMA_CCR_CIRC) == 0)
bogdanm	0:9b334a45a8ff	1803	{
bogdanm	0:9b334a45a8ff	1804	hsai->XferCount = 0;
bogdanm	0:9b334a45a8ff	1805
bogdanm	0:9b334a45a8ff	1806	/* Disable SAI Tx DMA Request */
bogdanm	0:9b334a45a8ff	1807	hsai->Instance->CR1 &= (uint32_t)(~SAI_xCR1_DMAEN);
bogdanm	0:9b334a45a8ff	1808
bogdanm	0:9b334a45a8ff	1809	/* Stop the interrupts error handling */
bogdanm	0:9b334a45a8ff	1810	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_DMA));
bogdanm	0:9b334a45a8ff	1811
bogdanm	0:9b334a45a8ff	1812	hsai->State= HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1813	}
bogdanm	0:9b334a45a8ff	1814	HAL_SAI_TxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1815	}
bogdanm	0:9b334a45a8ff	1816
bogdanm	0:9b334a45a8ff	1817	/**
bogdanm	0:9b334a45a8ff	1818	* @brief DMA SAI transmit process half complete callback.
bogdanm	0:9b334a45a8ff	1819	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1820	* the configuration information for the specified DMA module.
bogdanm	0:9b334a45a8ff	1821	* @retval None
bogdanm	0:9b334a45a8ff	1822	*/
bogdanm	0:9b334a45a8ff	1823	static void SAI_DMATxHalfCplt(DMA_HandleTypeDef *hdma)
bogdanm	0:9b334a45a8ff	1824	{
bogdanm	0:9b334a45a8ff	1825	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
bogdanm	0:9b334a45a8ff	1826
bogdanm	0:9b334a45a8ff	1827	HAL_SAI_TxHalfCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1828	}
bogdanm	0:9b334a45a8ff	1829
bogdanm	0:9b334a45a8ff	1830	/**
bogdanm	0:9b334a45a8ff	1831	* @brief DMA SAI receive process complete callback.
bogdanm	0:9b334a45a8ff	1832	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1833	* the configuration information for the specified DMA module.
bogdanm	0:9b334a45a8ff	1834	* @retval None
bogdanm	0:9b334a45a8ff	1835	*/
bogdanm	0:9b334a45a8ff	1836	static void SAI_DMARxCplt(DMA_HandleTypeDef *hdma)
bogdanm	0:9b334a45a8ff	1837	{
bogdanm	0:9b334a45a8ff	1838	SAI_HandleTypeDef* hsai = ( SAI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm	0:9b334a45a8ff	1839	if((hdma->Instance->CCR & DMA_CCR_CIRC) == 0)
bogdanm	0:9b334a45a8ff	1840	{
bogdanm	0:9b334a45a8ff	1841	/* Disable Rx DMA Request */
bogdanm	0:9b334a45a8ff	1842	hsai->Instance->CR1 &= (uint32_t)(~SAI_xCR1_DMAEN);
bogdanm	0:9b334a45a8ff	1843	hsai->XferCount = 0;
bogdanm	0:9b334a45a8ff	1844
bogdanm	0:9b334a45a8ff	1845	/* Stop the interrupts error handling */
bogdanm	0:9b334a45a8ff	1846	__HAL_SAI_DISABLE_IT(hsai, SAI_InterruptFlag(hsai, SAI_MODE_DMA));
bogdanm	0:9b334a45a8ff	1847
bogdanm	0:9b334a45a8ff	1848	hsai->State = HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1849	}
bogdanm	0:9b334a45a8ff	1850	HAL_SAI_RxCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1851	}
bogdanm	0:9b334a45a8ff	1852
bogdanm	0:9b334a45a8ff	1853	/**
bogdanm	0:9b334a45a8ff	1854	* @brief DMA SAI receive process half complete callback.
bogdanm	0:9b334a45a8ff	1855	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1856	* the configuration information for the specified DMA module.
bogdanm	0:9b334a45a8ff	1857	* @retval None
bogdanm	0:9b334a45a8ff	1858	*/
bogdanm	0:9b334a45a8ff	1859	static void SAI_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
bogdanm	0:9b334a45a8ff	1860	{
bogdanm	0:9b334a45a8ff	1861	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
bogdanm	0:9b334a45a8ff	1862
bogdanm	0:9b334a45a8ff	1863	HAL_SAI_RxHalfCpltCallback(hsai);
bogdanm	0:9b334a45a8ff	1864	}
bogdanm	0:9b334a45a8ff	1865	/**
bogdanm	0:9b334a45a8ff	1866	* @brief DMA SAI communication error callback.
bogdanm	0:9b334a45a8ff	1867	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm	0:9b334a45a8ff	1868	* the configuration information for the specified DMA module.
bogdanm	0:9b334a45a8ff	1869	* @retval None
bogdanm	0:9b334a45a8ff	1870	*/
bogdanm	0:9b334a45a8ff	1871	static void SAI_DMAError(DMA_HandleTypeDef *hdma)
bogdanm	0:9b334a45a8ff	1872	{
bogdanm	0:9b334a45a8ff	1873	SAI_HandleTypeDef* hsai = ( SAI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm	0:9b334a45a8ff	1874
bogdanm	0:9b334a45a8ff	1875	/* Stop the DMA transfer */
bogdanm	0:9b334a45a8ff	1876	HAL_SAI_DMAStop(hsai);
bogdanm	0:9b334a45a8ff	1877
bogdanm	0:9b334a45a8ff	1878	/* Set the SAI state ready to be able to start again the process */
bogdanm	0:9b334a45a8ff	1879	hsai->State= HAL_SAI_STATE_READY;
bogdanm	0:9b334a45a8ff	1880	HAL_SAI_ErrorCallback(hsai);
bogdanm	0:9b334a45a8ff	1881	hsai->XferCount = 0;
bogdanm	0:9b334a45a8ff	1882	}
bogdanm	0:9b334a45a8ff	1883
bogdanm	0:9b334a45a8ff	1884	/**
bogdanm	0:9b334a45a8ff	1885	* @}
bogdanm	0:9b334a45a8ff	1886	*/
bogdanm	0:9b334a45a8ff	1887
bogdanm	0:9b334a45a8ff	1888	#endif /* HAL_SAI_MODULE_ENABLED */
bogdanm	0:9b334a45a8ff	1889	/**
bogdanm	0:9b334a45a8ff	1890	* @}
bogdanm	0:9b334a45a8ff	1891	*/
bogdanm	0:9b334a45a8ff	1892
bogdanm	0:9b334a45a8ff	1893	/**
bogdanm	0:9b334a45a8ff	1894	* @}
bogdanm	0:9b334a45a8ff	1895	*/
bogdanm	0:9b334a45a8ff	1896
bogdanm	0:9b334a45a8ff	1897	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	16 May 2016
Imports:	1
Forks:	0
Commits:	130
Dependents:	1
Dependencies:	0
Followers:	1

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_sai.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning