mbed-src - mbed library sources

test » Code » mbed-src

test / mbed-src

mbed library sources

Dependents: bare

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_sai.c@87:085cde657901, 2014-02-08 (annotated)

Committer:: mbed_official
Date:: Sat Feb 08 19:45:06 2014 +0000
Revision:: 87:085cde657901
Child:: 106:ced8cbb51063

Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2

Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/

Add NUCLEO_F401RE, improvements

Who changed what in which revision?

User	Revision	Line number	New contents of line
mbed_official	87:085cde657901	1	/**
mbed_official	87:085cde657901	2	******************************************************************************
mbed_official	87:085cde657901	3	* @file stm32f4xx_hal_sai.c
mbed_official	87:085cde657901	4	* @author MCD Application Team
mbed_official	87:085cde657901	5	* @version V1.0.0RC2
mbed_official	87:085cde657901	6	* @date 04-February-2014
mbed_official	87:085cde657901	7	* @brief SAI HAL module driver.
mbed_official	87:085cde657901	8	* This file provides firmware functions to manage the following
mbed_official	87:085cde657901	9	* functionalities of the Serial Audio Interface (SAI) peripheral:
mbed_official	87:085cde657901	10	* + Initialization/de-initialization functions
mbed_official	87:085cde657901	11	* + I/O operation functions
mbed_official	87:085cde657901	12	* + Peripheral Control functions
mbed_official	87:085cde657901	13	* + Peripheral State functions
mbed_official	87:085cde657901	14	*
mbed_official	87:085cde657901	15	@verbatim
mbed_official	87:085cde657901	16	==============================================================================
mbed_official	87:085cde657901	17	##### How to use this driver #####
mbed_official	87:085cde657901	18	==============================================================================
mbed_official	87:085cde657901	19
mbed_official	87:085cde657901	20	[..]
mbed_official	87:085cde657901	21	The SAI HAL driver can be used as follow:
mbed_official	87:085cde657901	22
mbed_official	87:085cde657901	23	(#) Declare a SAI_HandleTypeDef handle structure.
mbed_official	87:085cde657901	24	(#) Initialize the SAI low level resources by implement the HAL_SAI_MspInit() API:
mbed_official	87:085cde657901	25	(##) Enable the SAI interface clock.
mbed_official	87:085cde657901	26	(##) SAI pins configuration:
mbed_official	87:085cde657901	27	(+++) Enable the clock for the SAI GPIOs.
mbed_official	87:085cde657901	28	(+++) Configure these SAI pins as alternate function pull-up.
mbed_official	87:085cde657901	29	(##) NVIC configuration if you need to use interrupt process (HAL_SAI_Transmit_IT()
mbed_official	87:085cde657901	30	and HAL_SAI_Receive_IT() APIs):
mbed_official	87:085cde657901	31	(+++) Configure the SAI interrupt priority.
mbed_official	87:085cde657901	32	(+++) Enable the NVIC SAI IRQ handle.
mbed_official	87:085cde657901	33
mbed_official	87:085cde657901	34	(##) DMA Configuration if you need to use DMA process (HAL_SAI_Transmit_DMA()
mbed_official	87:085cde657901	35	and HAL_SAI_Receive_DMA() APIs):
mbed_official	87:085cde657901	36	(+++) Declare a DMA handle structure for the Tx/Rx stream.
mbed_official	87:085cde657901	37	(+++) Enable the DMAx interface clock.
mbed_official	87:085cde657901	38	(+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
mbed_official	87:085cde657901	39	(+++) Configure the DMA Tx/Rx Stream.
mbed_official	87:085cde657901	40	(+++) Associate the initialized DMA handle to the SAI DMA Tx/Rx handle.
mbed_official	87:085cde657901	41	(+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the
mbed_official	87:085cde657901	42	DMA Tx/Rx Stream.
mbed_official	87:085cde657901	43
mbed_official	87:085cde657901	44	(#) Program the SAI Mode, Standard, Data Format, MCLK Output, Audio frequency and Polarity
mbed_official	87:085cde657901	45	using HAL_SAI_Init() function.
mbed_official	87:085cde657901	46
mbed_official	87:085cde657901	47	-@- The specific SAI interrupts (FIFO request and Overrun underrun interrupt)
mbed_official	87:085cde657901	48	will be managed using the macros __SAI_ENABLE_IT() and __SAI_DISABLE_IT()
mbed_official	87:085cde657901	49	inside the transmit and receive process.
mbed_official	87:085cde657901	50
mbed_official	87:085cde657901	51	[..]
mbed_official	87:085cde657901	52	(@) Make sure that either:
mbed_official	87:085cde657901	53	(+@) I2S PLL is configured or
mbed_official	87:085cde657901	54	(+@) SAI PLL is configured or
mbed_official	87:085cde657901	55	(+@) External clock source is configured after setting correctly
mbed_official	87:085cde657901	56	the define constant EXTERNAL_CLOCK_VALUE in the stm32f4xx_hal_conf.h file.
mbed_official	87:085cde657901	57
mbed_official	87:085cde657901	58	[..]
mbed_official	87:085cde657901	59	(@) In master TX mode: enabling the audio block immediately generates the bit clock
mbed_official	87:085cde657901	60	for the external slaves even if there is no data in the FIFO, However FS signal
mbed_official	87:085cde657901	61	generation is conditioned by the presence of data in the FIFO.
mbed_official	87:085cde657901	62
mbed_official	87:085cde657901	63	[..]
mbed_official	87:085cde657901	64	(@) In master RX mode: enabling the audio block immediately generates the bit clock
mbed_official	87:085cde657901	65	and FS signal for the external slaves.
mbed_official	87:085cde657901	66
mbed_official	87:085cde657901	67	[..]
mbed_official	87:085cde657901	68	(@) It is mandatory to respect the following conditions in order to avoid bad SAI behavior:
mbed_official	87:085cde657901	69	(+@) First bit Offset <= (SLOT size - Data size)
mbed_official	87:085cde657901	70	(+@) Data size <= SLOT size
mbed_official	87:085cde657901	71	(+@) Number of SLOT x SLOT size = Frame length
mbed_official	87:085cde657901	72	(+@) The number of slots should be even when SAI_FS_CHANNEL_IDENTIFICATION is selected.
mbed_official	87:085cde657901	73
mbed_official	87:085cde657901	74	[..]
mbed_official	87:085cde657901	75	Three mode of operations are available within this driver :
mbed_official	87:085cde657901	76
mbed_official	87:085cde657901	77	* Polling mode IO operation *
mbed_official	87:085cde657901	78	=================================
mbed_official	87:085cde657901	79	[..]
mbed_official	87:085cde657901	80	(+) Send an amount of data in blocking mode using HAL_SAI_Transmit()
mbed_official	87:085cde657901	81	(+) Receive an amount of data in blocking mode using HAL_SAI_Receive()
mbed_official	87:085cde657901	82
mbed_official	87:085cde657901	83	* Interrupt mode IO operation *
mbed_official	87:085cde657901	84	===================================
mbed_official	87:085cde657901	85	[..]
mbed_official	87:085cde657901	86	(+) Send an amount of data in non blocking mode using HAL_SAI_Transmit_IT()
mbed_official	87:085cde657901	87	(+) At transmission end of transfer HAL_SAI_TxCpltCallback is executed and user can
mbed_official	87:085cde657901	88	add his own code by customization of function pointer HAL_SAI_TxCpltCallback
mbed_official	87:085cde657901	89	(+) Receive an amount of data in non blocking mode using HAL_SAI_Receive_IT()
mbed_official	87:085cde657901	90	(+) At reception end of transfer HAL_SAI_RxCpltCallback is executed and user can
mbed_official	87:085cde657901	91	add his own code by customization of function pointer HAL_SAI_RxCpltCallback
mbed_official	87:085cde657901	92	(+) In case of transfer Error, HAL_SAI_ErrorCallback() function is executed and user can
mbed_official	87:085cde657901	93	add his own code by customization of function pointer HAL_SAI_ErrorCallback
mbed_official	87:085cde657901	94
mbed_official	87:085cde657901	95	* DMA mode IO operation *
mbed_official	87:085cde657901	96	==============================
mbed_official	87:085cde657901	97	[..]
mbed_official	87:085cde657901	98	(+) Send an amount of data in non blocking mode (DMA) using HAL_SAI_Transmit_DMA()
mbed_official	87:085cde657901	99	(+) At transmission end of transfer HAL_SAI_TxCpltCallback is executed and user can
mbed_official	87:085cde657901	100	add his own code by customization of function pointer HAL_SAI_TxCpltCallback
mbed_official	87:085cde657901	101	(+) Receive an amount of data in non blocking mode (DMA) using HAL_SAI_Receive_DMA()
mbed_official	87:085cde657901	102	(+) At reception end of transfer HAL_SAI_RxCpltCallback is executed and user can
mbed_official	87:085cde657901	103	add his own code by customization of function pointer HAL_SAI_RxCpltCallback
mbed_official	87:085cde657901	104	(+) In case of transfer Error, HAL_SAI_ErrorCallback() function is executed and user can
mbed_official	87:085cde657901	105	add his own code by customization of function pointer HAL_SAI_ErrorCallback
mbed_official	87:085cde657901	106	(+) Pause the DMA Transfer using HAL_SAI_DMAPause()
mbed_official	87:085cde657901	107	(+) Resume the DMA Transfer using HAL_SAI_DMAResume()
mbed_official	87:085cde657901	108	(+) Stop the DMA Transfer using HAL_SAI_DMAStop()
mbed_official	87:085cde657901	109
mbed_official	87:085cde657901	110	* SAI HAL driver macros list *
mbed_official	87:085cde657901	111	=============================================
mbed_official	87:085cde657901	112	[..]
mbed_official	87:085cde657901	113	Below the list of most used macros in USART HAL driver.
mbed_official	87:085cde657901	114
mbed_official	87:085cde657901	115	(+) __HAL_SAI_ENABLE: Enable the SAI peripheral
mbed_official	87:085cde657901	116	(+) __HAL_SAI_DISABLE: Disable the SAI peripheral
mbed_official	87:085cde657901	117	(+) __HAL_SAI_ENABLE_IT : Enable the specified SAI interrupts
mbed_official	87:085cde657901	118	(+) __HAL_SAI_DISABLE_IT : Disable the specified SAI interrupts
mbed_official	87:085cde657901	119	(+) __HAL_SAI_GET_IT_SOURCE: Check if the specified SAI interrupt source is
mbed_official	87:085cde657901	120	enabled or disabled
mbed_official	87:085cde657901	121	(+) __HAL_SAI_GET_FLAG: Check whether the specified SAI flag is set or not
mbed_official	87:085cde657901	122
mbed_official	87:085cde657901	123	@endverbatim
mbed_official	87:085cde657901	124	******************************************************************************
mbed_official	87:085cde657901	125	* @attention
mbed_official	87:085cde657901	126	*
mbed_official	87:085cde657901	127	* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official	87:085cde657901	128	*
mbed_official	87:085cde657901	129	* Redistribution and use in source and binary forms, with or without modification,
mbed_official	87:085cde657901	130	* are permitted provided that the following conditions are met:
mbed_official	87:085cde657901	131	* 1. Redistributions of source code must retain the above copyright notice,
mbed_official	87:085cde657901	132	* this list of conditions and the following disclaimer.
mbed_official	87:085cde657901	133	* 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official	87:085cde657901	134	* this list of conditions and the following disclaimer in the documentation
mbed_official	87:085cde657901	135	* and/or other materials provided with the distribution.
mbed_official	87:085cde657901	136	* 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official	87:085cde657901	137	* may be used to endorse or promote products derived from this software
mbed_official	87:085cde657901	138	* without specific prior written permission.
mbed_official	87:085cde657901	139	*
mbed_official	87:085cde657901	140	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official	87:085cde657901	141	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official	87:085cde657901	142	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official	87:085cde657901	143	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official	87:085cde657901	144	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official	87:085cde657901	145	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official	87:085cde657901	146	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official	87:085cde657901	147	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official	87:085cde657901	148	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official	87:085cde657901	149	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official	87:085cde657901	150	*
mbed_official	87:085cde657901	151	******************************************************************************
mbed_official	87:085cde657901	152	*/
mbed_official	87:085cde657901	153
mbed_official	87:085cde657901	154	/* Includes ------------------------------------------------------------------*/
mbed_official	87:085cde657901	155	#include "stm32f4xx_hal.h"
mbed_official	87:085cde657901	156
mbed_official	87:085cde657901	157	/** @addtogroup STM32F4xx_HAL_Driver
mbed_official	87:085cde657901	158	* @{
mbed_official	87:085cde657901	159	*/
mbed_official	87:085cde657901	160
mbed_official	87:085cde657901	161	/** @defgroup SAI
mbed_official	87:085cde657901	162	* @brief SAI HAL module driver
mbed_official	87:085cde657901	163	* @{
mbed_official	87:085cde657901	164	*/
mbed_official	87:085cde657901	165
mbed_official	87:085cde657901	166	#ifdef HAL_SAI_MODULE_ENABLED
mbed_official	87:085cde657901	167
mbed_official	87:085cde657901	168	#if defined(STM32F427xx) \|\| defined(STM32F437xx) \|\| defined(STM32F429xx) \|\| defined(STM32F439xx)
mbed_official	87:085cde657901	169
mbed_official	87:085cde657901	170	/* Private typedef -----------------------------------------------------------*/
mbed_official	87:085cde657901	171	/* Private define ------------------------------------------------------------*/
mbed_official	87:085cde657901	172	/* SAI registers Masks */
mbed_official	87:085cde657901	173	#define CR1_CLEAR_MASK ((uint32_t)0xFF07C010)
mbed_official	87:085cde657901	174	#define FRCR_CLEAR_MASK ((uint32_t)0xFFF88000)
mbed_official	87:085cde657901	175	#define SLOTR_CLEAR_MASK ((uint32_t)0x0000F020)
mbed_official	87:085cde657901	176
mbed_official	87:085cde657901	177	/* Private macro -------------------------------------------------------------*/
mbed_official	87:085cde657901	178	/* Private variables ---------------------------------------------------------*/
mbed_official	87:085cde657901	179	/* Private function prototypes -----------------------------------------------*/
mbed_official	87:085cde657901	180	static void SAI_DMATxCplt(DMA_HandleTypeDef *hdma);
mbed_official	87:085cde657901	181	static void SAI_DMATxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official	87:085cde657901	182	static void SAI_DMARxCplt(DMA_HandleTypeDef *hdma);
mbed_official	87:085cde657901	183	static void SAI_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official	87:085cde657901	184	static void SAI_DMAError(DMA_HandleTypeDef *hdma);
mbed_official	87:085cde657901	185
mbed_official	87:085cde657901	186	/* Private functions ---------------------------------------------------------*/
mbed_official	87:085cde657901	187
mbed_official	87:085cde657901	188	/** @defgroup SAI_Private_Functions
mbed_official	87:085cde657901	189	* @{
mbed_official	87:085cde657901	190	*/
mbed_official	87:085cde657901	191
mbed_official	87:085cde657901	192	/** @defgroup SAI_Group1 Initialization and de-initialization functions
mbed_official	87:085cde657901	193	* @brief Initialization and Configuration functions
mbed_official	87:085cde657901	194	*
mbed_official	87:085cde657901	195	@verbatim
mbed_official	87:085cde657901	196	===============================================================================
mbed_official	87:085cde657901	197	##### Initialization and de-initialization functions #####
mbed_official	87:085cde657901	198	===============================================================================
mbed_official	87:085cde657901	199	[..] This subsection provides a set of functions allowing to initialize and
mbed_official	87:085cde657901	200	de-initialize the SAIx peripheral:
mbed_official	87:085cde657901	201
mbed_official	87:085cde657901	202	(+) User must Implement HAL_SAI_MspInit() function in which he configures
mbed_official	87:085cde657901	203	all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC ).
mbed_official	87:085cde657901	204
mbed_official	87:085cde657901	205	(+) Call the function HAL_SAI_Init() to configure the selected device with
mbed_official	87:085cde657901	206	the selected configuration:
mbed_official	87:085cde657901	207	(++) Mode (Master/slave TX/RX)
mbed_official	87:085cde657901	208	(++) Protocol
mbed_official	87:085cde657901	209	(++) Data Size
mbed_official	87:085cde657901	210	(++) MCLK Output
mbed_official	87:085cde657901	211	(++) Audio frequency
mbed_official	87:085cde657901	212	(++) FIFO Threshold
mbed_official	87:085cde657901	213	(++) Frame Config
mbed_official	87:085cde657901	214	(++) Slot Config
mbed_official	87:085cde657901	215
mbed_official	87:085cde657901	216	(+) Call the function HAL_SAI_DeInit() to restore the default configuration
mbed_official	87:085cde657901	217	of the selected SAI peripheral.
mbed_official	87:085cde657901	218
mbed_official	87:085cde657901	219	@endverbatim
mbed_official	87:085cde657901	220	* @{
mbed_official	87:085cde657901	221	*/
mbed_official	87:085cde657901	222
mbed_official	87:085cde657901	223	/**
mbed_official	87:085cde657901	224	* @brief Initializes the SAI according to the specified parameters
mbed_official	87:085cde657901	225	* in the SAI_InitTypeDef and create the associated handle.
mbed_official	87:085cde657901	226	* @param hsai: SAI handle
mbed_official	87:085cde657901	227	* @retval HAL status
mbed_official	87:085cde657901	228	*/
mbed_official	87:085cde657901	229	HAL_StatusTypeDef HAL_SAI_Init(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	230	{
mbed_official	87:085cde657901	231	uint32_t tmpreg = 0;
mbed_official	87:085cde657901	232	uint32_t tmpclock = 0, tmp2clock = 0;
mbed_official	87:085cde657901	233	/* This variable used to store the VCO Input (value in Hz) */
mbed_official	87:085cde657901	234	uint32_t vcoinput = 0;
mbed_official	87:085cde657901	235	/* This variable used to store the SAI_CK_x (value in Hz) */
mbed_official	87:085cde657901	236	uint32_t saiclocksource = 0;
mbed_official	87:085cde657901	237
mbed_official	87:085cde657901	238	/* Check the SAI handle allocation */
mbed_official	87:085cde657901	239	if(hsai == NULL)
mbed_official	87:085cde657901	240	{
mbed_official	87:085cde657901	241	return HAL_ERROR;
mbed_official	87:085cde657901	242	}
mbed_official	87:085cde657901	243
mbed_official	87:085cde657901	244	/* Check the SAI Block parameters */
mbed_official	87:085cde657901	245	assert_param(IS_SAI_BLOCK_PROTOCOL(hsai->Init.Protocol));
mbed_official	87:085cde657901	246	assert_param(IS_SAI_BLOCK_MODE(hsai->Init.AudioMode));
mbed_official	87:085cde657901	247	assert_param(IS_SAI_BLOCK_DATASIZE(hsai->Init.DataSize));
mbed_official	87:085cde657901	248	assert_param(IS_SAI_BLOCK_FIRST_BIT(hsai->Init.FirstBit));
mbed_official	87:085cde657901	249	assert_param(IS_SAI_BLOCK_CLOCK_STROBING(hsai->Init.ClockStrobing));
mbed_official	87:085cde657901	250	assert_param(IS_SAI_BLOCK_SYNCHRO(hsai->Init.Synchro));
mbed_official	87:085cde657901	251	assert_param(IS_SAI_BLOCK_OUTPUT_DRIVE(hsai->Init.OutputDrive));
mbed_official	87:085cde657901	252	assert_param(IS_SAI_BLOCK_NODIVIDER(hsai->Init.NoDivider));
mbed_official	87:085cde657901	253	assert_param(IS_SAI_BLOCK_FIFO_THRESHOLD(hsai->Init.FIFOThreshold));
mbed_official	87:085cde657901	254	assert_param(IS_SAI_AUDIO_FREQUENCY(hsai->Init.AudioFrequency));
mbed_official	87:085cde657901	255
mbed_official	87:085cde657901	256	/* Check the SAI Block Frame parameters */
mbed_official	87:085cde657901	257	assert_param(IS_SAI_BLOCK_FRAME_LENGTH(hsai->FrameInit.FrameLength));
mbed_official	87:085cde657901	258	assert_param(IS_SAI_BLOCK_ACTIVE_FRAME(hsai->FrameInit.ActiveFrameLength));
mbed_official	87:085cde657901	259	assert_param(IS_SAI_BLOCK_FS_DEFINITION(hsai->FrameInit.FSDefinition));
mbed_official	87:085cde657901	260	assert_param(IS_SAI_BLOCK_FS_POLARITY(hsai->FrameInit.FSPolarity));
mbed_official	87:085cde657901	261	assert_param(IS_SAI_BLOCK_FS_OFFSET(hsai->FrameInit.FSOffset));
mbed_official	87:085cde657901	262
mbed_official	87:085cde657901	263	/* Check the SAI Block Slot parameters */
mbed_official	87:085cde657901	264	assert_param(IS_SAI_BLOCK_FIRSTBIT_OFFSET(hsai->SlotInit.FirstBitOffset));
mbed_official	87:085cde657901	265	assert_param(IS_SAI_BLOCK_SLOT_SIZE(hsai->SlotInit.SlotSize));
mbed_official	87:085cde657901	266	assert_param(IS_SAI_BLOCK_SLOT_NUMBER(hsai->SlotInit.SlotNumber));
mbed_official	87:085cde657901	267	assert_param(IS_SAI_SLOT_ACTIVE(hsai->SlotInit.SlotActive));
mbed_official	87:085cde657901	268
mbed_official	87:085cde657901	269	if(hsai->State == HAL_SAI_STATE_RESET)
mbed_official	87:085cde657901	270	{
mbed_official	87:085cde657901	271	/* Init the low level hardware : GPIO, CLOCK, NVIC and DMA */
mbed_official	87:085cde657901	272	HAL_SAI_MspInit(hsai);
mbed_official	87:085cde657901	273	}
mbed_official	87:085cde657901	274
mbed_official	87:085cde657901	275	hsai->State = HAL_SAI_STATE_BUSY;
mbed_official	87:085cde657901	276
mbed_official	87:085cde657901	277	/* Disable the selected SAI peripheral */
mbed_official	87:085cde657901	278	__HAL_SAI_DISABLE(hsai);
mbed_official	87:085cde657901	279
mbed_official	87:085cde657901	280	/* SAI Block Configuration ------------------------------------------------------------*/
mbed_official	87:085cde657901	281	/* SAI Block_x CR1 Configuration */
mbed_official	87:085cde657901	282	/* Get the SAI Block_x CR1 value */
mbed_official	87:085cde657901	283	tmpreg = hsai->Instance->CR1;
mbed_official	87:085cde657901	284	/* Clear MODE, PRTCFG, DS, LSBFIRST, CKSTR, SYNCEN, OUTDRIV, NODIV, and MCKDIV bits */
mbed_official	87:085cde657901	285	tmpreg &= CR1_CLEAR_MASK;
mbed_official	87:085cde657901	286	/* Configure SAI_Block_x: Audio Protocol, Data Size, first transmitted bit, Clock strobing
mbed_official	87:085cde657901	287	edge, Synchronization mode, Output drive, Master Divider and FIFO level */
mbed_official	87:085cde657901	288	/* Set PRTCFG bits according to Protocol value */
mbed_official	87:085cde657901	289	/* Set DS bits according to DataSize value */
mbed_official	87:085cde657901	290	/* Set LSBFIRST bit according to FirstBit value */
mbed_official	87:085cde657901	291	/* Set CKSTR bit according to ClockStrobing value */
mbed_official	87:085cde657901	292	/* Set SYNCEN bit according to Synchro value */
mbed_official	87:085cde657901	293	/* Set OUTDRIV bit according to OutputDrive value */
mbed_official	87:085cde657901	294	/* Set NODIV bit according to NoDivider value */
mbed_official	87:085cde657901	295	tmpreg \|= (uint32_t)(hsai->Init.Protocol \|
mbed_official	87:085cde657901	296	hsai->Init.AudioMode \|
mbed_official	87:085cde657901	297	hsai->Init.DataSize \|
mbed_official	87:085cde657901	298	hsai->Init.FirstBit \|
mbed_official	87:085cde657901	299	hsai->Init.ClockStrobing \|
mbed_official	87:085cde657901	300	hsai->Init.Synchro \|
mbed_official	87:085cde657901	301	hsai->Init.OutputDrive \|
mbed_official	87:085cde657901	302	hsai->Init.NoDivider);
mbed_official	87:085cde657901	303	/* Write to SAI_Block_x CR1 */
mbed_official	87:085cde657901	304	hsai->Instance->CR1 = tmpreg;
mbed_official	87:085cde657901	305
mbed_official	87:085cde657901	306	/* SAI Block_x CR2 Configuration */
mbed_official	87:085cde657901	307	/* Get the SAIBlock_x CR2 value */
mbed_official	87:085cde657901	308	tmpreg = hsai->Instance->CR2;
mbed_official	87:085cde657901	309	/* Clear FTH bits */
mbed_official	87:085cde657901	310	tmpreg &= ~(SAI_xCR2_FTH);
mbed_official	87:085cde657901	311	/* Configure the FIFO Level */
mbed_official	87:085cde657901	312	/* Set FTH bits according to SAI_FIFOThreshold value */
mbed_official	87:085cde657901	313	tmpreg \|= (uint32_t)(hsai->Init.FIFOThreshold);
mbed_official	87:085cde657901	314	/* Write to SAI_Block_x CR2 */
mbed_official	87:085cde657901	315	hsai->Instance->CR2 = tmpreg;
mbed_official	87:085cde657901	316
mbed_official	87:085cde657901	317	/* SAI Block_x Frame Configuration -----------------------------------------*/
mbed_official	87:085cde657901	318	/* Get the SAI Block_x FRCR value */
mbed_official	87:085cde657901	319	tmpreg = hsai->Instance->FRCR;
mbed_official	87:085cde657901	320	/* Clear FRL, FSALL, FSDEF, FSPOL, FSOFF bits */
mbed_official	87:085cde657901	321	tmpreg &= FRCR_CLEAR_MASK;
mbed_official	87:085cde657901	322	/* Configure SAI_Block_x Frame: Frame Length, Active Frame Length, Frame Synchronization
mbed_official	87:085cde657901	323	Definition, Frame Synchronization Polarity and Frame Synchronization Polarity */
mbed_official	87:085cde657901	324	/* Set FRL bits according to SAI_FrameLength value */
mbed_official	87:085cde657901	325	/* Set FSALL bits according to SAI_ActiveFrameLength value */
mbed_official	87:085cde657901	326	/* Set FSDEF bit according to SAI_FSDefinition value */
mbed_official	87:085cde657901	327	/* Set FSPOL bit according to SAI_FSPolarity value */
mbed_official	87:085cde657901	328	/* Set FSOFF bit according to SAI_FSOffset value */
mbed_official	87:085cde657901	329	tmpreg \|= (uint32_t)((uint32_t)(hsai->FrameInit.FrameLength - 1) \|
mbed_official	87:085cde657901	330	hsai->FrameInit.FSOffset \|
mbed_official	87:085cde657901	331	hsai->FrameInit.FSDefinition \|
mbed_official	87:085cde657901	332	hsai->FrameInit.FSPolarity \|
mbed_official	87:085cde657901	333	(uint32_t)((hsai->FrameInit.ActiveFrameLength - 1) << 8));
mbed_official	87:085cde657901	334
mbed_official	87:085cde657901	335	/* Write to SAI_Block_x FRCR */
mbed_official	87:085cde657901	336	hsai->Instance->FRCR = tmpreg;
mbed_official	87:085cde657901	337
mbed_official	87:085cde657901	338	/* SAI Block_x SLOT Configuration ------------------------------------------*/
mbed_official	87:085cde657901	339	/* Get the SAI Block_x SLOTR value */
mbed_official	87:085cde657901	340	tmpreg = hsai->Instance->SLOTR;
mbed_official	87:085cde657901	341	/* Clear FBOFF, SLOTSZ, NBSLOT, SLOTEN bits */
mbed_official	87:085cde657901	342	tmpreg &= SLOTR_CLEAR_MASK;
mbed_official	87:085cde657901	343	/* Configure SAI_Block_x Slot: First bit offset, Slot size, Number of Slot in
mbed_official	87:085cde657901	344	audio frame and slots activated in audio frame */
mbed_official	87:085cde657901	345	/* Set FBOFF bits according to SAI_FirstBitOffset value */
mbed_official	87:085cde657901	346	/* Set SLOTSZ bits according to SAI_SlotSize value */
mbed_official	87:085cde657901	347	/* Set NBSLOT bits according to SAI_SlotNumber value */
mbed_official	87:085cde657901	348	/* Set SLOTEN bits according to SAI_SlotActive value */
mbed_official	87:085cde657901	349	tmpreg \|= (uint32_t)(hsai->SlotInit.FirstBitOffset \|
mbed_official	87:085cde657901	350	hsai->SlotInit.SlotSize \|
mbed_official	87:085cde657901	351	hsai->SlotInit.SlotActive \|
mbed_official	87:085cde657901	352	(uint32_t)((hsai->SlotInit.SlotNumber - 1) << 8));
mbed_official	87:085cde657901	353
mbed_official	87:085cde657901	354	/* Write to SAI_Block_x SLOTR */
mbed_official	87:085cde657901	355	hsai->Instance->SLOTR = tmpreg;
mbed_official	87:085cde657901	356
mbed_official	87:085cde657901	357	/* SAI Block_x Clock Configuration -----------------------------------------*/
mbed_official	87:085cde657901	358	/* Check the Clock parameters */
mbed_official	87:085cde657901	359	assert_param(IS_SAI_CLK_SOURCE(hsai->Init.ClockSource));
mbed_official	87:085cde657901	360
mbed_official	87:085cde657901	361	/* SAI Block clock source selection */
mbed_official	87:085cde657901	362	if(hsai->Instance == SAI1_Block_A)
mbed_official	87:085cde657901	363	{
mbed_official	87:085cde657901	364	__HAL_RCC_SAI_BLOCKACLKSOURCE_CONFIG(hsai->Init.ClockSource);
mbed_official	87:085cde657901	365	}
mbed_official	87:085cde657901	366	else
mbed_official	87:085cde657901	367	{
mbed_official	87:085cde657901	368	__HAL_RCC_SAI_BLOCKBCLKSOURCE_CONFIG((uint32_t)(hsai->Init.ClockSource << 2));
mbed_official	87:085cde657901	369	}
mbed_official	87:085cde657901	370
mbed_official	87:085cde657901	371	/* VCO Input Clock value calculation */
mbed_official	87:085cde657901	372	if((RCC->PLLCFGR & RCC_PLLCFGR_PLLSRC) == RCC_PLLSOURCE_HSI)
mbed_official	87:085cde657901	373	{
mbed_official	87:085cde657901	374	/* In Case the PLL Source is HSI (Internal Clock) */
mbed_official	87:085cde657901	375	vcoinput = (HSI_VALUE / (uint32_t)(RCC->PLLCFGR & RCC_PLLCFGR_PLLM));
mbed_official	87:085cde657901	376	}
mbed_official	87:085cde657901	377	else
mbed_official	87:085cde657901	378	{
mbed_official	87:085cde657901	379	/* In Case the PLL Source is HSE (External Clock) */
mbed_official	87:085cde657901	380	vcoinput = ((HSE_VALUE / (uint32_t)(RCC->PLLCFGR & RCC_PLLCFGR_PLLM)));
mbed_official	87:085cde657901	381	}
mbed_official	87:085cde657901	382
mbed_official	87:085cde657901	383	/* SAI_CLK_x : SAI Block Clock configuration for different clock sources selected */
mbed_official	87:085cde657901	384	if(hsai->Init.ClockSource == SAI_CLKSOURCE_PLLSAI)
mbed_official	87:085cde657901	385	{
mbed_official	87:085cde657901	386	/* Configure the PLLI2S division factor */
mbed_official	87:085cde657901	387	/* PLLSAI_VCO Input = PLL_SOURCE/PLLM */
mbed_official	87:085cde657901	388	/* PLLSAI_VCO Output = PLLSAI_VCO Input * PLLSAIN */
mbed_official	87:085cde657901	389	/* SAI_CLK(first level) = PLLSAI_VCO Output/PLLSAIQ */
mbed_official	87:085cde657901	390	tmpreg = (RCC->PLLSAICFGR & RCC_PLLSAICFGR_PLLSAIQ) >> 24;
mbed_official	87:085cde657901	391	saiclocksource = (vcoinput * ((RCC->PLLSAICFGR & RCC_PLLSAICFGR_PLLSAIN) >> 6))/(tmpreg);
mbed_official	87:085cde657901	392
mbed_official	87:085cde657901	393	/* SAI_CLK_x = SAI_CLK(first level)/PLLSAIDIVQ */
mbed_official	87:085cde657901	394	tmpreg = (((RCC->DCKCFGR & RCC_DCKCFGR_PLLSAIDIVQ) >> 8) + 1);
mbed_official	87:085cde657901	395	saiclocksource = saiclocksource/(tmpreg);
mbed_official	87:085cde657901	396
mbed_official	87:085cde657901	397	}
mbed_official	87:085cde657901	398	else if(hsai->Init.ClockSource == SAI_CLKSOURCE_PLLI2S)
mbed_official	87:085cde657901	399	{
mbed_official	87:085cde657901	400	/* Configure the PLLI2S division factor */
mbed_official	87:085cde657901	401	/* PLLI2S_VCO Input = PLL_SOURCE/PLLM */
mbed_official	87:085cde657901	402	/* PLLI2S_VCO Output = PLLI2S_VCO Input * PLLI2SN */
mbed_official	87:085cde657901	403	/* SAI_CLK(first level) = PLLI2S_VCO Output/PLLI2SQ */
mbed_official	87:085cde657901	404	tmpreg = (RCC->PLLI2SCFGR & RCC_PLLI2SCFGR_PLLI2SQ) >> 24;
mbed_official	87:085cde657901	405	saiclocksource = (vcoinput * ((RCC->PLLI2SCFGR & RCC_PLLI2SCFGR_PLLI2SN) >> 6))/(tmpreg);
mbed_official	87:085cde657901	406
mbed_official	87:085cde657901	407	/* SAI_CLK_x = SAI_CLK(first level)/PLLI2SDIVQ */
mbed_official	87:085cde657901	408	tmpreg = ((RCC->DCKCFGR & RCC_DCKCFGR_PLLI2SDIVQ) + 1);
mbed_official	87:085cde657901	409	saiclocksource = saiclocksource/(tmpreg);
mbed_official	87:085cde657901	410	}
mbed_official	87:085cde657901	411	else /* sConfig->ClockSource == SAI_CLKSource_Ext */
mbed_official	87:085cde657901	412	{
mbed_official	87:085cde657901	413	/* Enable the External Clock selection */
mbed_official	87:085cde657901	414	__HAL_RCC_I2SCLK(RCC_I2SCLKSOURCE_EXT);
mbed_official	87:085cde657901	415
mbed_official	87:085cde657901	416	saiclocksource = EXTERNAL_CLOCK_VALUE;
mbed_official	87:085cde657901	417	}
mbed_official	87:085cde657901	418
mbed_official	87:085cde657901	419	/* Configure Master Clock using the following formula :
mbed_official	87:085cde657901	420	MCLK_x = SAI_CK_x / (MCKDIV[3:0] * 2) with MCLK_x = 256 * FS
mbed_official	87:085cde657901	421	FS = SAI_CK_x / (MCKDIV[3:0] * 2) * 256
mbed_official	87:085cde657901	422	MCKDIV[3:0] = SAI_CK_x / FS * 512 */
mbed_official	87:085cde657901	423	if(hsai->Init.NoDivider == SAI_MASTERDIVIDER_ENABLED)
mbed_official	87:085cde657901	424	{
mbed_official	87:085cde657901	425	/* (saiclocksource x 10) to keep Significant digits */
mbed_official	87:085cde657901	426	tmpclock = (((saiclocksource * 10) / ((hsai->Init.AudioFrequency) * 512)));
mbed_official	87:085cde657901	427
mbed_official	87:085cde657901	428	/* Get the result of modulo division */
mbed_official	87:085cde657901	429	tmp2clock = (tmpclock % 10);
mbed_official	87:085cde657901	430
mbed_official	87:085cde657901	431	/* Round result to the nearest integer*/
mbed_official	87:085cde657901	432	if (tmp2clock > 8)
mbed_official	87:085cde657901	433	{
mbed_official	87:085cde657901	434	tmpclock = ((tmpclock / 10) + 1);
mbed_official	87:085cde657901	435	}
mbed_official	87:085cde657901	436	else
mbed_official	87:085cde657901	437	{
mbed_official	87:085cde657901	438	tmpclock = (tmpclock / 10);
mbed_official	87:085cde657901	439	}
mbed_official	87:085cde657901	440	/Set MCKDIV value in CR1 register/
mbed_official	87:085cde657901	441	hsai->Instance->CR1 \|= (tmpclock << 20);
mbed_official	87:085cde657901	442
mbed_official	87:085cde657901	443	}
mbed_official	87:085cde657901	444
mbed_official	87:085cde657901	445	/* Initialise the error code */
mbed_official	87:085cde657901	446	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
mbed_official	87:085cde657901	447
mbed_official	87:085cde657901	448	/* Initialize the SAI state */
mbed_official	87:085cde657901	449	hsai->State= HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	450
mbed_official	87:085cde657901	451	return HAL_OK;
mbed_official	87:085cde657901	452	}
mbed_official	87:085cde657901	453
mbed_official	87:085cde657901	454	/**
mbed_official	87:085cde657901	455	* @brief DeInitializes the SAI peripheral.
mbed_official	87:085cde657901	456	* @param hsai: SAI handle
mbed_official	87:085cde657901	457	* @retval HAL status
mbed_official	87:085cde657901	458	*/
mbed_official	87:085cde657901	459	HAL_StatusTypeDef HAL_SAI_DeInit(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	460	{
mbed_official	87:085cde657901	461	/* Check the SAI handle allocation */
mbed_official	87:085cde657901	462	if(hsai == NULL)
mbed_official	87:085cde657901	463	{
mbed_official	87:085cde657901	464	return HAL_ERROR;
mbed_official	87:085cde657901	465	}
mbed_official	87:085cde657901	466
mbed_official	87:085cde657901	467	hsai->State = HAL_SAI_STATE_BUSY;
mbed_official	87:085cde657901	468
mbed_official	87:085cde657901	469	/* DeInit the low level hardware: GPIO, CLOCK, NVIC and DMA */
mbed_official	87:085cde657901	470	HAL_SAI_MspDeInit(hsai);
mbed_official	87:085cde657901	471
mbed_official	87:085cde657901	472	/* Initialize the error code */
mbed_official	87:085cde657901	473	hsai->ErrorCode = HAL_SAI_ERROR_NONE;
mbed_official	87:085cde657901	474
mbed_official	87:085cde657901	475	/* Initialize the SAI state */
mbed_official	87:085cde657901	476	hsai->State = HAL_SAI_STATE_RESET;
mbed_official	87:085cde657901	477
mbed_official	87:085cde657901	478	return HAL_OK;
mbed_official	87:085cde657901	479	}
mbed_official	87:085cde657901	480
mbed_official	87:085cde657901	481	/**
mbed_official	87:085cde657901	482	* @brief SAI MSP Init.
mbed_official	87:085cde657901	483	* @param hsai: SAI handle
mbed_official	87:085cde657901	484	* @retval None
mbed_official	87:085cde657901	485	*/
mbed_official	87:085cde657901	486	__weak void HAL_SAI_MspInit(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	487	{
mbed_official	87:085cde657901	488	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	489	the HAL_SAI_MspInit could be implemented in the user file
mbed_official	87:085cde657901	490	*/
mbed_official	87:085cde657901	491	}
mbed_official	87:085cde657901	492
mbed_official	87:085cde657901	493	/**
mbed_official	87:085cde657901	494	* @brief SAI MSP DeInit.
mbed_official	87:085cde657901	495	* @param hsai: SAI handle
mbed_official	87:085cde657901	496	* @retval None
mbed_official	87:085cde657901	497	*/
mbed_official	87:085cde657901	498	__weak void HAL_SAI_MspDeInit(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	499	{
mbed_official	87:085cde657901	500	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	501	the HAL_SAI_MspDeInit could be implemented in the user file
mbed_official	87:085cde657901	502	*/
mbed_official	87:085cde657901	503	}
mbed_official	87:085cde657901	504
mbed_official	87:085cde657901	505	/**
mbed_official	87:085cde657901	506	* @}
mbed_official	87:085cde657901	507	*/
mbed_official	87:085cde657901	508
mbed_official	87:085cde657901	509	/** @defgroup SAI_Group2 IO operation functions
mbed_official	87:085cde657901	510	* @brief Data transfers functions
mbed_official	87:085cde657901	511	*
mbed_official	87:085cde657901	512	@verbatim
mbed_official	87:085cde657901	513	===============================================================================
mbed_official	87:085cde657901	514	##### IO operation functions #####
mbed_official	87:085cde657901	515	===============================================================================
mbed_official	87:085cde657901	516	[..]
mbed_official	87:085cde657901	517	This subsection provides a set of functions allowing to manage the SAI data
mbed_official	87:085cde657901	518	transfers.
mbed_official	87:085cde657901	519
mbed_official	87:085cde657901	520	(+) There is two mode of transfer:
mbed_official	87:085cde657901	521	(++) Blocking mode : The communication is performed in the polling mode.
mbed_official	87:085cde657901	522	The status of all data processing is returned by the same function
mbed_official	87:085cde657901	523	after finishing transfer.
mbed_official	87:085cde657901	524	(++) No-Blocking mode : The communication is performed using Interrupts
mbed_official	87:085cde657901	525	or DMA. These functions return the status of the transfer startup.
mbed_official	87:085cde657901	526	The end of the data processing will be indicated through the
mbed_official	87:085cde657901	527	dedicated SAI IRQ when using Interrupt mode or the DMA IRQ when
mbed_official	87:085cde657901	528	using DMA mode.
mbed_official	87:085cde657901	529
mbed_official	87:085cde657901	530	(+) Blocking mode functions are :
mbed_official	87:085cde657901	531	(++) HAL_SAI_Transmit()
mbed_official	87:085cde657901	532	(++) HAL_SAI_Receive()
mbed_official	87:085cde657901	533	(++) HAL_SAI_TransmitReceive()
mbed_official	87:085cde657901	534
mbed_official	87:085cde657901	535	(+) No-Blocking mode functions with Interrupt are :
mbed_official	87:085cde657901	536	(++) HAL_SAI_Transmit_IT()
mbed_official	87:085cde657901	537	(++) HAL_SAI_Receive_IT()
mbed_official	87:085cde657901	538	(++) HAL_SAI_TransmitReceive_IT()
mbed_official	87:085cde657901	539
mbed_official	87:085cde657901	540	(+) No-Blocking mode functions with DMA are :
mbed_official	87:085cde657901	541	(++) HAL_SAI_Transmit_DMA()
mbed_official	87:085cde657901	542	(++) HAL_SAI_Receive_DMA()
mbed_official	87:085cde657901	543	(++) HAL_SAI_TransmitReceive_DMA()
mbed_official	87:085cde657901	544
mbed_official	87:085cde657901	545	(+) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
mbed_official	87:085cde657901	546	(++) HAL_SAI_TxCpltCallback()
mbed_official	87:085cde657901	547	(++) HAL_SAI_RxCpltCallback()
mbed_official	87:085cde657901	548	(++) HAL_SAI_ErrorCallback()
mbed_official	87:085cde657901	549
mbed_official	87:085cde657901	550	@endverbatim
mbed_official	87:085cde657901	551	* @{
mbed_official	87:085cde657901	552	*/
mbed_official	87:085cde657901	553
mbed_official	87:085cde657901	554	/**
mbed_official	87:085cde657901	555	* @brief Transmits an amount of data in blocking mode.
mbed_official	87:085cde657901	556	* @param hsai: SAI handle
mbed_official	87:085cde657901	557	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	558	* @param Size: Amount of data to be sent
mbed_official	87:085cde657901	559	* @param Timeout: Timeout duration
mbed_official	87:085cde657901	560	* @retval HAL status
mbed_official	87:085cde657901	561	*/
mbed_official	87:085cde657901	562	HAL_StatusTypeDef HAL_SAI_Transmit(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size, uint32_t Timeout)
mbed_official	87:085cde657901	563	{
mbed_official	87:085cde657901	564	uint32_t timeout = 0x00;
mbed_official	87:085cde657901	565
mbed_official	87:085cde657901	566	if((pData == NULL ) \|\| (Size == 0))
mbed_official	87:085cde657901	567	{
mbed_official	87:085cde657901	568	return HAL_ERROR;
mbed_official	87:085cde657901	569	}
mbed_official	87:085cde657901	570
mbed_official	87:085cde657901	571	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	572	{
mbed_official	87:085cde657901	573	/* Process Locked */
mbed_official	87:085cde657901	574	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	575
mbed_official	87:085cde657901	576	hsai->State = HAL_SAI_STATE_BUSY_TX;
mbed_official	87:085cde657901	577
mbed_official	87:085cde657901	578	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	579	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	580	{
mbed_official	87:085cde657901	581	/* Enable SAI peripheral */
mbed_official	87:085cde657901	582	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	583	}
mbed_official	87:085cde657901	584
mbed_official	87:085cde657901	585	while(Size > 0)
mbed_official	87:085cde657901	586	{
mbed_official	87:085cde657901	587	/* Wait the FIFO to be empty */
mbed_official	87:085cde657901	588	/* Get timeout */
mbed_official	87:085cde657901	589	timeout = HAL_GetTick() + Timeout;
mbed_official	87:085cde657901	590	while(__HAL_SAI_GET_FLAG(hsai, SAI_xSR_FREQ) == RESET)
mbed_official	87:085cde657901	591	{
mbed_official	87:085cde657901	592	/* Check for the Timeout */
mbed_official	87:085cde657901	593	if(Timeout != HAL_MAX_DELAY)
mbed_official	87:085cde657901	594	{
mbed_official	87:085cde657901	595	if(HAL_GetTick() >= timeout)
mbed_official	87:085cde657901	596	{
mbed_official	87:085cde657901	597
mbed_official	87:085cde657901	598	/* Update error code */
mbed_official	87:085cde657901	599	hsai->ErrorCode \|= HAL_SAI_ERROR_TIMEOUT;
mbed_official	87:085cde657901	600
mbed_official	87:085cde657901	601	/* Process Unlocked */
mbed_official	87:085cde657901	602	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	603
mbed_official	87:085cde657901	604	/* Change the SAI state */
mbed_official	87:085cde657901	605	hsai->State = HAL_SAI_STATE_TIMEOUT;
mbed_official	87:085cde657901	606
mbed_official	87:085cde657901	607	return HAL_TIMEOUT;
mbed_official	87:085cde657901	608	}
mbed_official	87:085cde657901	609	}
mbed_official	87:085cde657901	610	}
mbed_official	87:085cde657901	611	hsai->Instance->DR = (*pData++);
mbed_official	87:085cde657901	612	Size--;
mbed_official	87:085cde657901	613	}
mbed_official	87:085cde657901	614
mbed_official	87:085cde657901	615	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	616
mbed_official	87:085cde657901	617	/* Process Unlocked */
mbed_official	87:085cde657901	618	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	619
mbed_official	87:085cde657901	620	return HAL_OK;
mbed_official	87:085cde657901	621	}
mbed_official	87:085cde657901	622	else
mbed_official	87:085cde657901	623	{
mbed_official	87:085cde657901	624	return HAL_BUSY;
mbed_official	87:085cde657901	625	}
mbed_official	87:085cde657901	626	}
mbed_official	87:085cde657901	627
mbed_official	87:085cde657901	628	/**
mbed_official	87:085cde657901	629	* @brief Receives an amount of data in blocking mode.
mbed_official	87:085cde657901	630	* @param hsai: SAI handle
mbed_official	87:085cde657901	631	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	632	* @param Size: Amount of data to be received
mbed_official	87:085cde657901	633	* @param Timeout: Timeout duration
mbed_official	87:085cde657901	634	* @retval HAL status
mbed_official	87:085cde657901	635	*/
mbed_official	87:085cde657901	636	HAL_StatusTypeDef HAL_SAI_Receive(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size, uint32_t Timeout)
mbed_official	87:085cde657901	637	{
mbed_official	87:085cde657901	638	uint32_t timeout = 0x00;
mbed_official	87:085cde657901	639
mbed_official	87:085cde657901	640	if((pData == NULL ) \|\| (Size == 0))
mbed_official	87:085cde657901	641	{
mbed_official	87:085cde657901	642	return HAL_ERROR;
mbed_official	87:085cde657901	643	}
mbed_official	87:085cde657901	644
mbed_official	87:085cde657901	645	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	646	{
mbed_official	87:085cde657901	647	/* Process Locked */
mbed_official	87:085cde657901	648	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	649
mbed_official	87:085cde657901	650	hsai->State = HAL_SAI_STATE_BUSY_RX;
mbed_official	87:085cde657901	651
mbed_official	87:085cde657901	652	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	653	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	654	{
mbed_official	87:085cde657901	655	/* Enable SAI peripheral */
mbed_official	87:085cde657901	656	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	657	}
mbed_official	87:085cde657901	658
mbed_official	87:085cde657901	659	/* Receive data */
mbed_official	87:085cde657901	660	while(Size > 0)
mbed_official	87:085cde657901	661	{
mbed_official	87:085cde657901	662	/* Wait until RXNE flag is set */
mbed_official	87:085cde657901	663	/* Get timeout */
mbed_official	87:085cde657901	664	timeout = HAL_GetTick() + Timeout;
mbed_official	87:085cde657901	665
mbed_official	87:085cde657901	666	while(__HAL_SAI_GET_FLAG(hsai, SAI_xSR_FREQ) == RESET)
mbed_official	87:085cde657901	667	{
mbed_official	87:085cde657901	668	/* Check for the Timeout */
mbed_official	87:085cde657901	669	if(Timeout != HAL_MAX_DELAY)
mbed_official	87:085cde657901	670	{
mbed_official	87:085cde657901	671	if(HAL_GetTick() >= timeout)
mbed_official	87:085cde657901	672	{
mbed_official	87:085cde657901	673
mbed_official	87:085cde657901	674	/* Update error code */
mbed_official	87:085cde657901	675	hsai->ErrorCode \|= HAL_SAI_ERROR_TIMEOUT;
mbed_official	87:085cde657901	676
mbed_official	87:085cde657901	677	/* Process Unlocked */
mbed_official	87:085cde657901	678	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	679
mbed_official	87:085cde657901	680	/* Change the SAI state */
mbed_official	87:085cde657901	681	hsai->State = HAL_SAI_STATE_TIMEOUT;
mbed_official	87:085cde657901	682
mbed_official	87:085cde657901	683	return HAL_TIMEOUT;
mbed_official	87:085cde657901	684	}
mbed_official	87:085cde657901	685	}
mbed_official	87:085cde657901	686	}
mbed_official	87:085cde657901	687
mbed_official	87:085cde657901	688	(*pData++) = hsai->Instance->DR;
mbed_official	87:085cde657901	689	Size--;
mbed_official	87:085cde657901	690	}
mbed_official	87:085cde657901	691
mbed_official	87:085cde657901	692	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	693
mbed_official	87:085cde657901	694	/* Process Unlocked */
mbed_official	87:085cde657901	695	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	696
mbed_official	87:085cde657901	697	return HAL_OK;
mbed_official	87:085cde657901	698	}
mbed_official	87:085cde657901	699	else
mbed_official	87:085cde657901	700	{
mbed_official	87:085cde657901	701	return HAL_BUSY;
mbed_official	87:085cde657901	702	}
mbed_official	87:085cde657901	703	}
mbed_official	87:085cde657901	704
mbed_official	87:085cde657901	705	/**
mbed_official	87:085cde657901	706	* @brief Transmits an amount of data in no-blocking mode with Interrupt.
mbed_official	87:085cde657901	707	* @param hsai: SAI handle
mbed_official	87:085cde657901	708	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	709	* @param Size: Amount of data to be sent
mbed_official	87:085cde657901	710	* @retval HAL status
mbed_official	87:085cde657901	711	*/
mbed_official	87:085cde657901	712	HAL_StatusTypeDef HAL_SAI_Transmit_IT(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size)
mbed_official	87:085cde657901	713	{
mbed_official	87:085cde657901	714	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	715	{
mbed_official	87:085cde657901	716	if((pData == NULL) \|\| (Size == 0))
mbed_official	87:085cde657901	717	{
mbed_official	87:085cde657901	718	return HAL_ERROR;
mbed_official	87:085cde657901	719	}
mbed_official	87:085cde657901	720
mbed_official	87:085cde657901	721	hsai->pTxBuffPtr = pData;
mbed_official	87:085cde657901	722	hsai->TxXferSize = Size;
mbed_official	87:085cde657901	723	hsai->TxXferCount = Size;
mbed_official	87:085cde657901	724
mbed_official	87:085cde657901	725	/* Process Locked */
mbed_official	87:085cde657901	726	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	727
mbed_official	87:085cde657901	728	hsai->State = HAL_SAI_STATE_BUSY_TX;
mbed_official	87:085cde657901	729
mbed_official	87:085cde657901	730	/* Transmit data */
mbed_official	87:085cde657901	731	hsai->Instance->DR = (*hsai->pTxBuffPtr++);
mbed_official	87:085cde657901	732	hsai->TxXferCount--;
mbed_official	87:085cde657901	733
mbed_official	87:085cde657901	734	/* Process Unlocked */
mbed_official	87:085cde657901	735	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	736
mbed_official	87:085cde657901	737	/* Enable FRQ and OVRUDR interrupts */
mbed_official	87:085cde657901	738	__HAL_SAI_ENABLE_IT(hsai, (SAI_IT_FREQ \| SAI_IT_OVRUDR));
mbed_official	87:085cde657901	739
mbed_official	87:085cde657901	740	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	741	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	742	{
mbed_official	87:085cde657901	743	/* Enable SAI peripheral */
mbed_official	87:085cde657901	744	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	745	}
mbed_official	87:085cde657901	746
mbed_official	87:085cde657901	747
mbed_official	87:085cde657901	748	return HAL_OK;
mbed_official	87:085cde657901	749	}
mbed_official	87:085cde657901	750	else if(hsai->State == HAL_SAI_STATE_BUSY_TX)
mbed_official	87:085cde657901	751	{
mbed_official	87:085cde657901	752	/* Process Locked */
mbed_official	87:085cde657901	753	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	754
mbed_official	87:085cde657901	755	/* Transmit data */
mbed_official	87:085cde657901	756	hsai->Instance->DR = (*hsai->pTxBuffPtr++);
mbed_official	87:085cde657901	757
mbed_official	87:085cde657901	758	hsai->TxXferCount--;
mbed_official	87:085cde657901	759
mbed_official	87:085cde657901	760	if(hsai->TxXferCount == 0)
mbed_official	87:085cde657901	761	{
mbed_official	87:085cde657901	762	/* Disable FREQ and OVRUDR interrupts */
mbed_official	87:085cde657901	763	__HAL_SAI_DISABLE_IT(hsai, (SAI_IT_FREQ \| SAI_IT_OVRUDR));
mbed_official	87:085cde657901	764
mbed_official	87:085cde657901	765	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	766
mbed_official	87:085cde657901	767	HAL_SAI_TxCpltCallback(hsai);
mbed_official	87:085cde657901	768	}
mbed_official	87:085cde657901	769
mbed_official	87:085cde657901	770	/* Process Unlocked */
mbed_official	87:085cde657901	771	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	772
mbed_official	87:085cde657901	773	return HAL_OK;
mbed_official	87:085cde657901	774	}
mbed_official	87:085cde657901	775
mbed_official	87:085cde657901	776	else
mbed_official	87:085cde657901	777	{
mbed_official	87:085cde657901	778	return HAL_BUSY;
mbed_official	87:085cde657901	779	}
mbed_official	87:085cde657901	780	}
mbed_official	87:085cde657901	781
mbed_official	87:085cde657901	782	/**
mbed_official	87:085cde657901	783	* @brief Receives an amount of data in no-blocking mode with Interrupt.
mbed_official	87:085cde657901	784	* @param hsai: SAI handle
mbed_official	87:085cde657901	785	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	786	* @param Size: Amount of data to be received
mbed_official	87:085cde657901	787	* @retval HAL status
mbed_official	87:085cde657901	788	*/
mbed_official	87:085cde657901	789	HAL_StatusTypeDef HAL_SAI_Receive_IT(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size)
mbed_official	87:085cde657901	790	{
mbed_official	87:085cde657901	791	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	792	{
mbed_official	87:085cde657901	793	if((pData == NULL) \|\| (Size == 0))
mbed_official	87:085cde657901	794	{
mbed_official	87:085cde657901	795	return HAL_ERROR;
mbed_official	87:085cde657901	796	}
mbed_official	87:085cde657901	797
mbed_official	87:085cde657901	798	hsai->pRxBuffPtr = pData;
mbed_official	87:085cde657901	799	hsai->RxXferSize = Size;
mbed_official	87:085cde657901	800	hsai->RxXferCount = Size;
mbed_official	87:085cde657901	801
mbed_official	87:085cde657901	802	/* Process Locked */
mbed_official	87:085cde657901	803	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	804
mbed_official	87:085cde657901	805	hsai->State = HAL_SAI_STATE_BUSY_RX;
mbed_official	87:085cde657901	806
mbed_official	87:085cde657901	807	/* Enable TXE and OVRUDR interrupts */
mbed_official	87:085cde657901	808	__HAL_SAI_ENABLE_IT(hsai, (SAI_IT_FREQ \| SAI_IT_OVRUDR));
mbed_official	87:085cde657901	809
mbed_official	87:085cde657901	810	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	811	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	812	{
mbed_official	87:085cde657901	813	/* Enable SAI peripheral */
mbed_official	87:085cde657901	814	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	815	}
mbed_official	87:085cde657901	816
mbed_official	87:085cde657901	817	/* Process Unlocked */
mbed_official	87:085cde657901	818	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	819
mbed_official	87:085cde657901	820	return HAL_OK;
mbed_official	87:085cde657901	821	}
mbed_official	87:085cde657901	822	else if(hsai->State == HAL_SAI_STATE_BUSY_RX)
mbed_official	87:085cde657901	823	{
mbed_official	87:085cde657901	824	/* Process Locked */
mbed_official	87:085cde657901	825	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	826
mbed_official	87:085cde657901	827	/* Receive data */
mbed_official	87:085cde657901	828	(*hsai->pRxBuffPtr++) = hsai->Instance->DR;
mbed_official	87:085cde657901	829
mbed_official	87:085cde657901	830	hsai->RxXferCount--;
mbed_official	87:085cde657901	831
mbed_official	87:085cde657901	832	if(hsai->RxXferCount == 0)
mbed_official	87:085cde657901	833	{
mbed_official	87:085cde657901	834	/* Disable TXE and OVRUDR interrupts */
mbed_official	87:085cde657901	835	__HAL_SAI_DISABLE_IT(hsai, (SAI_IT_FREQ \| SAI_IT_OVRUDR));
mbed_official	87:085cde657901	836
mbed_official	87:085cde657901	837	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	838	HAL_SAI_RxCpltCallback(hsai);
mbed_official	87:085cde657901	839	}
mbed_official	87:085cde657901	840
mbed_official	87:085cde657901	841	/* Process Unlocked */
mbed_official	87:085cde657901	842	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	843
mbed_official	87:085cde657901	844	return HAL_OK;
mbed_official	87:085cde657901	845	}
mbed_official	87:085cde657901	846
mbed_official	87:085cde657901	847	else
mbed_official	87:085cde657901	848	{
mbed_official	87:085cde657901	849	return HAL_BUSY;
mbed_official	87:085cde657901	850	}
mbed_official	87:085cde657901	851	}
mbed_official	87:085cde657901	852
mbed_official	87:085cde657901	853	/**
mbed_official	87:085cde657901	854	* @brief Pauses the audio stream playing from the Media.
mbed_official	87:085cde657901	855	* @param hsai: SAI handle
mbed_official	87:085cde657901	856	* @retval None
mbed_official	87:085cde657901	857	*/
mbed_official	87:085cde657901	858	HAL_StatusTypeDef HAL_SAI_DMAPause(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	859	{
mbed_official	87:085cde657901	860	/* Process Locked */
mbed_official	87:085cde657901	861	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	862
mbed_official	87:085cde657901	863	/* Pause the audio file playing by disabling the SAI DMA requests */
mbed_official	87:085cde657901	864	hsai->Instance->CR1 &= ~SAI_xCR1_DMAEN;
mbed_official	87:085cde657901	865
mbed_official	87:085cde657901	866
mbed_official	87:085cde657901	867	/* Process Unlocked */
mbed_official	87:085cde657901	868	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	869
mbed_official	87:085cde657901	870	return HAL_OK;
mbed_official	87:085cde657901	871	}
mbed_official	87:085cde657901	872
mbed_official	87:085cde657901	873	/**
mbed_official	87:085cde657901	874	* @brief Resumes the audio stream playing from the Media.
mbed_official	87:085cde657901	875	* @param hsai: SAI handle
mbed_official	87:085cde657901	876	* @retval None
mbed_official	87:085cde657901	877	*/
mbed_official	87:085cde657901	878	HAL_StatusTypeDef HAL_SAI_DMAResume(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	879	{
mbed_official	87:085cde657901	880	/* Process Locked */
mbed_official	87:085cde657901	881	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	882
mbed_official	87:085cde657901	883	/* Enable the SAI DMA requests */
mbed_official	87:085cde657901	884	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
mbed_official	87:085cde657901	885
mbed_official	87:085cde657901	886
mbed_official	87:085cde657901	887	/* If the SAI peripheral is still not enabled, enable it */
mbed_official	87:085cde657901	888	if ((hsai->Instance->CR1 & SAI_xCR1_SAIEN) == 0)
mbed_official	87:085cde657901	889	{
mbed_official	87:085cde657901	890	/* Enable SAI peripheral */
mbed_official	87:085cde657901	891	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	892	}
mbed_official	87:085cde657901	893
mbed_official	87:085cde657901	894	/* Process Unlocked */
mbed_official	87:085cde657901	895	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	896
mbed_official	87:085cde657901	897	return HAL_OK;
mbed_official	87:085cde657901	898	}
mbed_official	87:085cde657901	899
mbed_official	87:085cde657901	900	/**
mbed_official	87:085cde657901	901	* @brief Resumes the audio stream playing from the Media.
mbed_official	87:085cde657901	902	* @param hsai: SAI handle
mbed_official	87:085cde657901	903	* @retval None
mbed_official	87:085cde657901	904	*/
mbed_official	87:085cde657901	905	HAL_StatusTypeDef HAL_SAI_DMAStop(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	906	{
mbed_official	87:085cde657901	907	/* Process Locked */
mbed_official	87:085cde657901	908	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	909
mbed_official	87:085cde657901	910	/* Disable the SAI DMA request */
mbed_official	87:085cde657901	911	hsai->Instance->CR1 &= ~SAI_xCR1_DMAEN;
mbed_official	87:085cde657901	912
mbed_official	87:085cde657901	913	/* Disable the SAI DMA Stream */
mbed_official	87:085cde657901	914	__HAL_DMA_DISABLE(hsai->hdmatx);
mbed_official	87:085cde657901	915	__HAL_DMA_DISABLE(hsai->hdmarx);
mbed_official	87:085cde657901	916
mbed_official	87:085cde657901	917	/* Disable SAI peripheral */
mbed_official	87:085cde657901	918	__HAL_SAI_DISABLE(hsai);
mbed_official	87:085cde657901	919
mbed_official	87:085cde657901	920	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	921
mbed_official	87:085cde657901	922	/* Process Unlocked */
mbed_official	87:085cde657901	923	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	924
mbed_official	87:085cde657901	925	return HAL_OK;
mbed_official	87:085cde657901	926	}
mbed_official	87:085cde657901	927	/**
mbed_official	87:085cde657901	928	* @brief Transmits an amount of data in no-blocking mode with DMA.
mbed_official	87:085cde657901	929	* @param hsai: SAI handle
mbed_official	87:085cde657901	930	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	931	* @param Size: Amount of data to be sent
mbed_official	87:085cde657901	932	* @retval HAL status
mbed_official	87:085cde657901	933	*/
mbed_official	87:085cde657901	934	HAL_StatusTypeDef HAL_SAI_Transmit_DMA(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size)
mbed_official	87:085cde657901	935	{
mbed_official	87:085cde657901	936	uint32_t *tmp;
mbed_official	87:085cde657901	937
mbed_official	87:085cde657901	938	if((pData == NULL) \|\| (Size == 0))
mbed_official	87:085cde657901	939	{
mbed_official	87:085cde657901	940	return HAL_ERROR;
mbed_official	87:085cde657901	941	}
mbed_official	87:085cde657901	942
mbed_official	87:085cde657901	943	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	944	{
mbed_official	87:085cde657901	945	hsai->pTxBuffPtr = pData;
mbed_official	87:085cde657901	946	hsai->TxXferSize = Size;
mbed_official	87:085cde657901	947	hsai->TxXferCount = Size;
mbed_official	87:085cde657901	948
mbed_official	87:085cde657901	949	/* Process Locked */
mbed_official	87:085cde657901	950	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	951
mbed_official	87:085cde657901	952	hsai->State = HAL_SAI_STATE_BUSY_TX;
mbed_official	87:085cde657901	953
mbed_official	87:085cde657901	954	/* Set the SAI Tx DMA Half transfert complete callback */
mbed_official	87:085cde657901	955	hsai->hdmatx->XferHalfCpltCallback = SAI_DMATxHalfCplt;
mbed_official	87:085cde657901	956
mbed_official	87:085cde657901	957	/* Set the SAI TxDMA transfer complete callback */
mbed_official	87:085cde657901	958	hsai->hdmatx->XferCpltCallback = SAI_DMATxCplt;
mbed_official	87:085cde657901	959
mbed_official	87:085cde657901	960	/* Set the DMA error callback */
mbed_official	87:085cde657901	961	hsai->hdmatx->XferErrorCallback = SAI_DMAError;
mbed_official	87:085cde657901	962
mbed_official	87:085cde657901	963	/* Enable the Tx DMA Stream */
mbed_official	87:085cde657901	964	tmp = (uint32_t*)&pData;
mbed_official	87:085cde657901	965	HAL_DMA_Start_IT(hsai->hdmatx, (uint32_t)tmp, (uint32_t)&hsai->Instance->DR, hsai->TxXferSize);
mbed_official	87:085cde657901	966
mbed_official	87:085cde657901	967	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	968	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	969	{
mbed_official	87:085cde657901	970	/* Enable SAI peripheral */
mbed_official	87:085cde657901	971	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	972	}
mbed_official	87:085cde657901	973
mbed_official	87:085cde657901	974	/* Enable SAI Tx DMA Request */
mbed_official	87:085cde657901	975	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
mbed_official	87:085cde657901	976
mbed_official	87:085cde657901	977	/* Process Unlocked */
mbed_official	87:085cde657901	978	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	979
mbed_official	87:085cde657901	980	return HAL_OK;
mbed_official	87:085cde657901	981	}
mbed_official	87:085cde657901	982	else
mbed_official	87:085cde657901	983	{
mbed_official	87:085cde657901	984	return HAL_BUSY;
mbed_official	87:085cde657901	985	}
mbed_official	87:085cde657901	986	}
mbed_official	87:085cde657901	987
mbed_official	87:085cde657901	988	/**
mbed_official	87:085cde657901	989	* @brief Receive an amount of data in no-blocking mode with DMA.
mbed_official	87:085cde657901	990	* @param hsai: SAI handle
mbed_official	87:085cde657901	991	* @param pData: Pointer to data buffer
mbed_official	87:085cde657901	992	* @param Size: Amount of data to be received
mbed_official	87:085cde657901	993	* @retval HAL status
mbed_official	87:085cde657901	994	*/
mbed_official	87:085cde657901	995	HAL_StatusTypeDef HAL_SAI_Receive_DMA(SAI_HandleTypeDef hsai, uint16_t pData, uint16_t Size)
mbed_official	87:085cde657901	996	{
mbed_official	87:085cde657901	997	uint32_t *tmp;
mbed_official	87:085cde657901	998
mbed_official	87:085cde657901	999	if((pData == NULL) \|\| (Size == 0))
mbed_official	87:085cde657901	1000	{
mbed_official	87:085cde657901	1001	return HAL_ERROR;
mbed_official	87:085cde657901	1002	}
mbed_official	87:085cde657901	1003
mbed_official	87:085cde657901	1004	if(hsai->State == HAL_SAI_STATE_READY)
mbed_official	87:085cde657901	1005	{
mbed_official	87:085cde657901	1006	hsai->pRxBuffPtr = pData;
mbed_official	87:085cde657901	1007	hsai->RxXferSize = Size;
mbed_official	87:085cde657901	1008	hsai->RxXferCount = Size;
mbed_official	87:085cde657901	1009
mbed_official	87:085cde657901	1010	/* Process Locked */
mbed_official	87:085cde657901	1011	__HAL_LOCK(hsai);
mbed_official	87:085cde657901	1012
mbed_official	87:085cde657901	1013	hsai->State = HAL_SAI_STATE_BUSY_RX;
mbed_official	87:085cde657901	1014
mbed_official	87:085cde657901	1015	/* Set the SAI Rx DMA Half transfert complete callback */
mbed_official	87:085cde657901	1016	hsai->hdmarx->XferHalfCpltCallback = SAI_DMARxHalfCplt;
mbed_official	87:085cde657901	1017
mbed_official	87:085cde657901	1018	/* Set the SAI Rx DMA transfert complete callback */
mbed_official	87:085cde657901	1019	hsai->hdmarx->XferCpltCallback = SAI_DMARxCplt;
mbed_official	87:085cde657901	1020
mbed_official	87:085cde657901	1021	/* Set the DMA error callback */
mbed_official	87:085cde657901	1022	hsai->hdmarx->XferErrorCallback = SAI_DMAError;
mbed_official	87:085cde657901	1023
mbed_official	87:085cde657901	1024	/* Enable the Rx DMA Stream */
mbed_official	87:085cde657901	1025	tmp = (uint32_t*)&pData;
mbed_official	87:085cde657901	1026	HAL_DMA_Start_IT(hsai->hdmarx, (uint32_t)&hsai->Instance->DR, (uint32_t)tmp, hsai->RxXferSize);
mbed_official	87:085cde657901	1027
mbed_official	87:085cde657901	1028	/* Check if the SAI is already enabled */
mbed_official	87:085cde657901	1029	if((hsai->Instance->CR1 & SAI_xCR1_SAIEN) != SAI_xCR1_SAIEN)
mbed_official	87:085cde657901	1030	{
mbed_official	87:085cde657901	1031	/* Enable SAI peripheral */
mbed_official	87:085cde657901	1032	__HAL_SAI_ENABLE(hsai);
mbed_official	87:085cde657901	1033	}
mbed_official	87:085cde657901	1034
mbed_official	87:085cde657901	1035	/* Enable SAI Rx DMA Request */
mbed_official	87:085cde657901	1036	hsai->Instance->CR1 \|= SAI_xCR1_DMAEN;
mbed_official	87:085cde657901	1037
mbed_official	87:085cde657901	1038	/* Process Unlocked */
mbed_official	87:085cde657901	1039	__HAL_UNLOCK(hsai);
mbed_official	87:085cde657901	1040
mbed_official	87:085cde657901	1041	return HAL_OK;
mbed_official	87:085cde657901	1042	}
mbed_official	87:085cde657901	1043	else
mbed_official	87:085cde657901	1044	{
mbed_official	87:085cde657901	1045	return HAL_BUSY;
mbed_official	87:085cde657901	1046	}
mbed_official	87:085cde657901	1047	}
mbed_official	87:085cde657901	1048
mbed_official	87:085cde657901	1049	/**
mbed_official	87:085cde657901	1050	* @brief This function handles SAI interrupt request.
mbed_official	87:085cde657901	1051	* @param hsai: SAI handle
mbed_official	87:085cde657901	1052	* @retval HAL status
mbed_official	87:085cde657901	1053	*/
mbed_official	87:085cde657901	1054	void HAL_SAI_IRQHandler(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1055	{
mbed_official	87:085cde657901	1056	uint32_t tmp1 = 0, tmp2 = 0;
mbed_official	87:085cde657901	1057
mbed_official	87:085cde657901	1058	if(hsai->State == HAL_SAI_STATE_BUSY_RX)
mbed_official	87:085cde657901	1059	{
mbed_official	87:085cde657901	1060	tmp1 = __HAL_SAI_GET_FLAG(hsai, SAI_xSR_FREQ);
mbed_official	87:085cde657901	1061	tmp2 = __HAL_SAI_GET_IT_SOURCE(hsai, SAI_IT_FREQ);
mbed_official	87:085cde657901	1062	/* SAI in mode Receiver --------------------------------------------------*/
mbed_official	87:085cde657901	1063	if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official	87:085cde657901	1064	{
mbed_official	87:085cde657901	1065	HAL_SAI_Receive_IT(hsai, NULL, 0);
mbed_official	87:085cde657901	1066	}
mbed_official	87:085cde657901	1067
mbed_official	87:085cde657901	1068	tmp1 = __HAL_SAI_GET_FLAG(hsai, SAI_FLAG_OVRUDR);
mbed_official	87:085cde657901	1069	tmp2 = __HAL_SAI_GET_IT_SOURCE(hsai, SAI_IT_OVRUDR);
mbed_official	87:085cde657901	1070	/* SAI Overrun error interrupt occurred ----------------------------------*/
mbed_official	87:085cde657901	1071	if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official	87:085cde657901	1072	{
mbed_official	87:085cde657901	1073	/* Change the SAI error code */
mbed_official	87:085cde657901	1074	hsai->ErrorCode = HAL_SAI_ERROR_OVR;
mbed_official	87:085cde657901	1075
mbed_official	87:085cde657901	1076	/* Clear the SAI Overrun flag */
mbed_official	87:085cde657901	1077	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
mbed_official	87:085cde657901	1078	/* Set the SAI state ready to be able to start again the process */
mbed_official	87:085cde657901	1079	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	1080	HAL_SAI_ErrorCallback(hsai);
mbed_official	87:085cde657901	1081	}
mbed_official	87:085cde657901	1082	}
mbed_official	87:085cde657901	1083
mbed_official	87:085cde657901	1084	if(hsai->State == HAL_SAI_STATE_BUSY_TX)
mbed_official	87:085cde657901	1085	{
mbed_official	87:085cde657901	1086	tmp1 = __HAL_SAI_GET_FLAG(hsai, SAI_xSR_FREQ);
mbed_official	87:085cde657901	1087	tmp2 = __HAL_SAI_GET_IT_SOURCE(hsai, SAI_IT_FREQ);
mbed_official	87:085cde657901	1088	/* SAI in mode Transmitter -----------------------------------------------*/
mbed_official	87:085cde657901	1089	if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official	87:085cde657901	1090	{
mbed_official	87:085cde657901	1091	HAL_SAI_Transmit_IT(hsai, NULL, 0);
mbed_official	87:085cde657901	1092	}
mbed_official	87:085cde657901	1093
mbed_official	87:085cde657901	1094	tmp1 = __HAL_SAI_GET_FLAG(hsai, SAI_FLAG_OVRUDR);
mbed_official	87:085cde657901	1095	tmp2 = __HAL_SAI_GET_IT_SOURCE(hsai, SAI_IT_OVRUDR);
mbed_official	87:085cde657901	1096	/* SAI Underrun error interrupt occurred ---------------------------------*/
mbed_official	87:085cde657901	1097	if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official	87:085cde657901	1098	{
mbed_official	87:085cde657901	1099	/* Change the SAI error code */
mbed_official	87:085cde657901	1100	hsai->ErrorCode = HAL_SAI_ERROR_UDR;
mbed_official	87:085cde657901	1101
mbed_official	87:085cde657901	1102	/* Clear the SAI Underrun flag */
mbed_official	87:085cde657901	1103	__HAL_SAI_CLEAR_FLAG(hsai, SAI_FLAG_OVRUDR);
mbed_official	87:085cde657901	1104	/* Set the SAI state ready to be able to start again the process */
mbed_official	87:085cde657901	1105	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	1106	HAL_SAI_ErrorCallback(hsai);
mbed_official	87:085cde657901	1107	}
mbed_official	87:085cde657901	1108	}
mbed_official	87:085cde657901	1109	}
mbed_official	87:085cde657901	1110
mbed_official	87:085cde657901	1111	/**
mbed_official	87:085cde657901	1112	* @brief Tx Transfer completed callbacks.
mbed_official	87:085cde657901	1113	* @param hsai: SAI handle
mbed_official	87:085cde657901	1114	* @retval None
mbed_official	87:085cde657901	1115	*/
mbed_official	87:085cde657901	1116	__weak void HAL_SAI_TxCpltCallback(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1117	{
mbed_official	87:085cde657901	1118	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	1119	the HAL_SAI_TxCpltCallback could be implemented in the user file
mbed_official	87:085cde657901	1120	*/
mbed_official	87:085cde657901	1121	}
mbed_official	87:085cde657901	1122
mbed_official	87:085cde657901	1123	/**
mbed_official	87:085cde657901	1124	* @brief Tx Transfer Half completed callbacks
mbed_official	87:085cde657901	1125	* @param hsai: SAI handle
mbed_official	87:085cde657901	1126	* @retval None
mbed_official	87:085cde657901	1127	*/
mbed_official	87:085cde657901	1128	__weak void HAL_SAI_TxHalfCpltCallback(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1129	{
mbed_official	87:085cde657901	1130	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	1131	the HAL_SAI_TxHalfCpltCallback could be implenetd in the user file
mbed_official	87:085cde657901	1132	*/
mbed_official	87:085cde657901	1133	}
mbed_official	87:085cde657901	1134
mbed_official	87:085cde657901	1135	/**
mbed_official	87:085cde657901	1136	* @brief Rx Transfer completed callbacks.
mbed_official	87:085cde657901	1137	* @param hsai: SAI handle
mbed_official	87:085cde657901	1138	* @retval None
mbed_official	87:085cde657901	1139	*/
mbed_official	87:085cde657901	1140	__weak void HAL_SAI_RxCpltCallback(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1141	{
mbed_official	87:085cde657901	1142	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	1143	the HAL_SAI_RxCpltCallback could be implemented in the user file
mbed_official	87:085cde657901	1144	*/
mbed_official	87:085cde657901	1145	}
mbed_official	87:085cde657901	1146
mbed_official	87:085cde657901	1147	/**
mbed_official	87:085cde657901	1148	* @brief Rx Transfer half completed callbacks
mbed_official	87:085cde657901	1149	* @param hsai: SAI handle
mbed_official	87:085cde657901	1150	* @retval None
mbed_official	87:085cde657901	1151	*/
mbed_official	87:085cde657901	1152	__weak void HAL_SAI_RxHalfCpltCallback(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1153	{
mbed_official	87:085cde657901	1154	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	1155	the HAL_SAI_RxCpltCallback could be implenetd in the user file
mbed_official	87:085cde657901	1156	*/
mbed_official	87:085cde657901	1157	}
mbed_official	87:085cde657901	1158
mbed_official	87:085cde657901	1159	/**
mbed_official	87:085cde657901	1160	* @brief SAI error callbacks.
mbed_official	87:085cde657901	1161	* @param hsai: SAI handle
mbed_official	87:085cde657901	1162	* @retval None
mbed_official	87:085cde657901	1163	*/
mbed_official	87:085cde657901	1164	__weak void HAL_SAI_ErrorCallback(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1165	{
mbed_official	87:085cde657901	1166	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	87:085cde657901	1167	the HAL_SAI_ErrorCallback could be implemented in the user file
mbed_official	87:085cde657901	1168	*/
mbed_official	87:085cde657901	1169	}
mbed_official	87:085cde657901	1170
mbed_official	87:085cde657901	1171	/**
mbed_official	87:085cde657901	1172	* @}
mbed_official	87:085cde657901	1173	*/
mbed_official	87:085cde657901	1174
mbed_official	87:085cde657901	1175
mbed_official	87:085cde657901	1176	/** @defgroup SAI_Group3 Peripheral State functions
mbed_official	87:085cde657901	1177	* @brief Peripheral State functions
mbed_official	87:085cde657901	1178	*
mbed_official	87:085cde657901	1179	@verbatim
mbed_official	87:085cde657901	1180	===============================================================================
mbed_official	87:085cde657901	1181	##### Peripheral State and Errors functions #####
mbed_official	87:085cde657901	1182	===============================================================================
mbed_official	87:085cde657901	1183	[..]
mbed_official	87:085cde657901	1184	This subsection permit to get in run-time the status of the peripheral
mbed_official	87:085cde657901	1185	and the data flow.
mbed_official	87:085cde657901	1186
mbed_official	87:085cde657901	1187	@endverbatim
mbed_official	87:085cde657901	1188	* @{
mbed_official	87:085cde657901	1189	*/
mbed_official	87:085cde657901	1190
mbed_official	87:085cde657901	1191	/**
mbed_official	87:085cde657901	1192	* @brief Returns the SAI state.
mbed_official	87:085cde657901	1193	* @param hsai: SAI handle
mbed_official	87:085cde657901	1194	* @retval HAL state
mbed_official	87:085cde657901	1195	*/
mbed_official	87:085cde657901	1196	HAL_SAI_StateTypeDef HAL_SAI_GetState(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1197	{
mbed_official	87:085cde657901	1198	return hsai->State;
mbed_official	87:085cde657901	1199	}
mbed_official	87:085cde657901	1200
mbed_official	87:085cde657901	1201	/**
mbed_official	87:085cde657901	1202	* @brief Return the SAI error code
mbed_official	87:085cde657901	1203	* @param hsai : pointer to a SAI_HandleTypeDef structure that contains
mbed_official	87:085cde657901	1204	* the configuration information for the specified SAI Block.
mbed_official	87:085cde657901	1205	* @retval SAI Error Code
mbed_official	87:085cde657901	1206	*/
mbed_official	87:085cde657901	1207	uint32_t HAL_SAI_GetError(SAI_HandleTypeDef *hsai)
mbed_official	87:085cde657901	1208	{
mbed_official	87:085cde657901	1209	return hsai->ErrorCode;
mbed_official	87:085cde657901	1210	}
mbed_official	87:085cde657901	1211	/**
mbed_official	87:085cde657901	1212	* @}
mbed_official	87:085cde657901	1213	*/
mbed_official	87:085cde657901	1214
mbed_official	87:085cde657901	1215	/**
mbed_official	87:085cde657901	1216	* @brief DMA SAI transmit process complete callback.
mbed_official	87:085cde657901	1217	* @param hdma: DMA handle
mbed_official	87:085cde657901	1218	* @retval None
mbed_official	87:085cde657901	1219	*/
mbed_official	87:085cde657901	1220	static void SAI_DMATxCplt(DMA_HandleTypeDef *hdma)
mbed_official	87:085cde657901	1221	{
mbed_official	87:085cde657901	1222	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef )hdma)->Parent;
mbed_official	87:085cde657901	1223
mbed_official	87:085cde657901	1224	hsai->TxXferCount = 0;
mbed_official	87:085cde657901	1225	hsai->RxXferCount = 0;
mbed_official	87:085cde657901	1226
mbed_official	87:085cde657901	1227	/* Disable SAI Tx DMA Request */
mbed_official	87:085cde657901	1228	hsai->Instance->CR1 &= (uint32_t)(~SAI_xCR1_DMAEN);
mbed_official	87:085cde657901	1229
mbed_official	87:085cde657901	1230	/* Flush Fifo*/
mbed_official	87:085cde657901	1231	hsai->Instance->CR2 \|= SAI_xCR2_FFLUSH;
mbed_official	87:085cde657901	1232
mbed_official	87:085cde657901	1233	hsai->State= HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	1234
mbed_official	87:085cde657901	1235	HAL_SAI_TxCpltCallback(hsai);
mbed_official	87:085cde657901	1236	}
mbed_official	87:085cde657901	1237
mbed_official	87:085cde657901	1238	/**
mbed_official	87:085cde657901	1239	* @brief DMA SAI transmit process half complete callback
mbed_official	87:085cde657901	1240	* @param hdma : DMA handle
mbed_official	87:085cde657901	1241	* @retval None
mbed_official	87:085cde657901	1242	*/
mbed_official	87:085cde657901	1243	static void SAI_DMATxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official	87:085cde657901	1244	{
mbed_official	87:085cde657901	1245	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
mbed_official	87:085cde657901	1246
mbed_official	87:085cde657901	1247	HAL_SAI_TxHalfCpltCallback(hsai);
mbed_official	87:085cde657901	1248	}
mbed_official	87:085cde657901	1249
mbed_official	87:085cde657901	1250	/**
mbed_official	87:085cde657901	1251	* @brief DMA SAI receive process complete callback.
mbed_official	87:085cde657901	1252	* @param hdma: DMA handle
mbed_official	87:085cde657901	1253	* @retval None
mbed_official	87:085cde657901	1254	*/
mbed_official	87:085cde657901	1255	static void SAI_DMARxCplt(DMA_HandleTypeDef *hdma)
mbed_official	87:085cde657901	1256	{
mbed_official	87:085cde657901	1257	SAI_HandleTypeDef* hsai = ( SAI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official	87:085cde657901	1258
mbed_official	87:085cde657901	1259	/* Disable Rx DMA Request */
mbed_official	87:085cde657901	1260	hsai->Instance->CR1 &= (uint32_t)(~SAI_xCR1_DMAEN);
mbed_official	87:085cde657901	1261	hsai->RxXferCount = 0;
mbed_official	87:085cde657901	1262
mbed_official	87:085cde657901	1263	hsai->State = HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	1264	HAL_SAI_RxCpltCallback(hsai);
mbed_official	87:085cde657901	1265	}
mbed_official	87:085cde657901	1266
mbed_official	87:085cde657901	1267	/**
mbed_official	87:085cde657901	1268	* @brief DMA SAI receive process half complete callback
mbed_official	87:085cde657901	1269	* @param hdma : DMA handle
mbed_official	87:085cde657901	1270	* @retval None
mbed_official	87:085cde657901	1271	*/
mbed_official	87:085cde657901	1272	static void SAI_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official	87:085cde657901	1273	{
mbed_official	87:085cde657901	1274	SAI_HandleTypeDef* hsai = (SAI_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
mbed_official	87:085cde657901	1275
mbed_official	87:085cde657901	1276	HAL_SAI_RxHalfCpltCallback(hsai);
mbed_official	87:085cde657901	1277	}
mbed_official	87:085cde657901	1278	/**
mbed_official	87:085cde657901	1279	* @brief DMA SAI communication error callback.
mbed_official	87:085cde657901	1280	* @param hdma: DMA handle
mbed_official	87:085cde657901	1281	* @retval None
mbed_official	87:085cde657901	1282	*/
mbed_official	87:085cde657901	1283	static void SAI_DMAError(DMA_HandleTypeDef *hdma)
mbed_official	87:085cde657901	1284	{
mbed_official	87:085cde657901	1285	SAI_HandleTypeDef* hsai = ( SAI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official	87:085cde657901	1286	/* Set the SAI state ready to be able to start again the process */
mbed_official	87:085cde657901	1287	hsai->State= HAL_SAI_STATE_READY;
mbed_official	87:085cde657901	1288	HAL_SAI_ErrorCallback(hsai);
mbed_official	87:085cde657901	1289
mbed_official	87:085cde657901	1290	hsai->TxXferCount = 0;
mbed_official	87:085cde657901	1291	hsai->RxXferCount = 0;
mbed_official	87:085cde657901	1292	}
mbed_official	87:085cde657901	1293
mbed_official	87:085cde657901	1294	/**
mbed_official	87:085cde657901	1295	* @}
mbed_official	87:085cde657901	1296	*/
mbed_official	87:085cde657901	1297
mbed_official	87:085cde657901	1298	#endif /* STM32F427xx \|\| STM32F437xx \|\| STM32F429xx \|\| STM32F439xx */
mbed_official	87:085cde657901	1299	#endif /* HAL_SAI_MODULE_ENABLED */
mbed_official	87:085cde657901	1300	/**
mbed_official	87:085cde657901	1301	* @}
mbed_official	87:085cde657901	1302	*/
mbed_official	87:085cde657901	1303
mbed_official	87:085cde657901	1304	/**
mbed_official	87:085cde657901	1305	* @}
mbed_official	87:085cde657901	1306	*/
mbed_official	87:085cde657901	1307
mbed_official	87:085cde657901	1308	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	29 Jun 2014
Imports:	3
Forks:	0
Commits:	135
Dependents:	1
Dependencies:	0
Followers:	3

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_sai.c@87:085cde657901, 2014-02-08 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning