mbed-dev - added prescaler for 16 bit pwm in LPC1347 target

Users » JojoS » Code » mbed-dev

added prescaler for 16 bit pwm in LPC1347 target

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

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

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

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	10 Sep 2016
Imports:	1
Forks:	0
Commits:	148
Dependents:	0
Dependencies:	0
Followers:	1

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_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