mbed-src - mbed library sources

Users » jaerts » Code » mbed-src

Joris Aerts / mbed-src

mbed library sources

Dependents: Marvino mbot

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F3/stm32f3xx_hal_i2s.c@632:7687fb9c4f91, 2015-09-28 (annotated)

Committer:: mbed_official
Date:: Mon Sep 28 14:00:11 2015 +0100
Revision:: 632:7687fb9c4f91
Parent:: 385:be64abf45658
Child:: 634:ac7d6880524d

Synchronized with git revision f7ce4ed029cc611121464252ff28d5e8beb895b0

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

NUCLEO_F303K8 - add support of the STM32F303K8

Who changed what in which revision?

User	Revision	Line number	New contents of line
mbed_official	237:f3da66175598	1	/**
mbed_official	237:f3da66175598	2	******************************************************************************
mbed_official	237:f3da66175598	3	* @file stm32f3xx_hal_i2s.c
mbed_official	237:f3da66175598	4	* @author MCD Application Team
mbed_official	632:7687fb9c4f91	5	* @version V1.1.1
mbed_official	632:7687fb9c4f91	6	* @date 19-June-2015
mbed_official	237:f3da66175598	7	* @brief I2S HAL module driver.
mbed_official	237:f3da66175598	8	* This file provides firmware functions to manage the following
mbed_official	237:f3da66175598	9	* functionalities of the Integrated Interchip Sound (I2S) peripheral:
mbed_official	237:f3da66175598	10	* + Initialization and de-initialization functions
mbed_official	237:f3da66175598	11	* + IO operation functions
mbed_official	237:f3da66175598	12	* + Peripheral State and Errors functions
mbed_official	237:f3da66175598	13	@verbatim
mbed_official	237:f3da66175598	14	===============================================================================
mbed_official	237:f3da66175598	15	##### How to use this driver #####
mbed_official	237:f3da66175598	16	===============================================================================
mbed_official	237:f3da66175598	17	[..]
mbed_official	237:f3da66175598	18	The I2S HAL driver can be used as follows:
mbed_official	237:f3da66175598	19
mbed_official	237:f3da66175598	20	(#) Declare a I2S_HandleTypeDef handle structure.
mbed_official	237:f3da66175598	21	(#) Initialize the I2S low level resources by implement the HAL_I2S_MspInit() API:
mbed_official	237:f3da66175598	22	(##) Enable the SPIx interface clock.
mbed_official	237:f3da66175598	23	(##) I2S pins configuration:
mbed_official	237:f3da66175598	24	(+++) Enable the clock for the I2S GPIOs.
mbed_official	237:f3da66175598	25	(+++) Configure these I2S pins as alternate function pull-up.
mbed_official	237:f3da66175598	26	(##) NVIC configuration if you need to use interrupt process (HAL_I2S_Transmit_IT()
mbed_official	237:f3da66175598	27	and HAL_I2S_Receive_IT() APIs).
mbed_official	237:f3da66175598	28	(+++) Configure the I2Sx interrupt priority.
mbed_official	237:f3da66175598	29	(+++) Enable the NVIC I2S IRQ handle.
mbed_official	237:f3da66175598	30	(##) DMA Configuration if you need to use DMA process (HAL_I2S_Transmit_DMA()
mbed_official	237:f3da66175598	31	and HAL_I2S_Receive_DMA() APIs:
mbed_official	237:f3da66175598	32	(+++) Declare a DMA handle structure for the Tx/Rx channel.
mbed_official	237:f3da66175598	33	(+++) Enable the DMAx interface clock.
mbed_official	237:f3da66175598	34	(+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
mbed_official	237:f3da66175598	35	(+++) Configure the DMA Tx/Rx Channel.
mbed_official	237:f3da66175598	36	(+++) Associate the initilalized DMA handle to the I2S DMA Tx/Rx handle.
mbed_official	237:f3da66175598	37	(+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the
mbed_official	237:f3da66175598	38	DMA Tx/Rx Channel.
mbed_official	237:f3da66175598	39
mbed_official	237:f3da66175598	40	(#) Program the Mode, Standard, Data Format, MCLK Output, Audio frequency and Polarity
mbed_official	237:f3da66175598	41	using HAL_I2S_Init() function.
mbed_official	237:f3da66175598	42
mbed_official	237:f3da66175598	43	-@- The specific I2S interrupts (Transmission complete interrupt,
mbed_official	237:f3da66175598	44	RXNE interrupt and Error Interrupts) will be managed using the macros
mbed_official	237:f3da66175598	45	__HAL_I2S_ENABLE_IT() and __HAL_I2S_DISABLE_IT() inside the transmit and receive process.
mbed_official	237:f3da66175598	46	-@- Make sure that either:
mbed_official	237:f3da66175598	47	(+@) I2S clock is configured based on SYSCLK or
mbed_official	237:f3da66175598	48	(+@) External clock source is configured after setting correctly
mbed_official	237:f3da66175598	49	the define constant EXTERNAL_CLOCK_VALUE in the stm32f3xx_hal_conf.h file.
mbed_official	237:f3da66175598	50
mbed_official	237:f3da66175598	51	(#) Three mode of operations are available within this driver :
mbed_official	237:f3da66175598	52
mbed_official	237:f3da66175598	53	* Polling mode IO operation *
mbed_official	237:f3da66175598	54	=================================
mbed_official	237:f3da66175598	55	[..]
mbed_official	237:f3da66175598	56	(+) Send an amount of data in blocking mode using HAL_I2S_Transmit()
mbed_official	237:f3da66175598	57	(+) Receive an amount of data in blocking mode using HAL_I2S_Receive()
mbed_official	237:f3da66175598	58
mbed_official	237:f3da66175598	59	* Interrupt mode IO operation *
mbed_official	237:f3da66175598	60	===================================
mbed_official	237:f3da66175598	61	[..]
mbed_official	237:f3da66175598	62	(+) Send an amount of data in non blocking mode using HAL_I2S_Transmit_IT()
mbed_official	237:f3da66175598	63	(+) At transmission end of half transfer HAL_I2S_TxHalfCpltCallback is executed and user can
mbed_official	237:f3da66175598	64	add his own code by customization of function pointer HAL_I2S_TxHalfCpltCallback
mbed_official	237:f3da66175598	65	(+) At transmission end of transfer HAL_I2S_TxCpltCallback is executed and user can
mbed_official	237:f3da66175598	66	add his own code by customization of function pointer HAL_I2S_TxCpltCallback
mbed_official	237:f3da66175598	67	(+) Receive an amount of data in non blocking mode using HAL_I2S_Receive_IT()
mbed_official	237:f3da66175598	68	(+) At reception end of half transfer HAL_I2S_RxHalfCpltCallback is executed and user can
mbed_official	237:f3da66175598	69	add his own code by customization of function pointer HAL_I2S_RxHalfCpltCallback
mbed_official	237:f3da66175598	70	(+) At reception end of transfer HAL_I2S_RxCpltCallback is executed and user can
mbed_official	237:f3da66175598	71	add his own code by customization of function pointer HAL_I2S_RxCpltCallback
mbed_official	237:f3da66175598	72	(+) In case of transfer Error, HAL_I2S_ErrorCallback() function is executed and user can
mbed_official	237:f3da66175598	73	add his own code by customization of function pointer HAL_I2S_ErrorCallback
mbed_official	237:f3da66175598	74
mbed_official	237:f3da66175598	75	* DMA mode IO operation *
mbed_official	237:f3da66175598	76	==============================
mbed_official	237:f3da66175598	77	[..]
mbed_official	237:f3da66175598	78	(+) Send an amount of data in non blocking mode (DMA) using HAL_I2S_Transmit_DMA()
mbed_official	237:f3da66175598	79	(+) At transmission end of half transfer HAL_I2S_TxHalfCpltCallback is executed and user can
mbed_official	237:f3da66175598	80	add his own code by customization of function pointer HAL_I2S_TxHalfCpltCallback
mbed_official	237:f3da66175598	81	(+) At transmission end of transfer HAL_I2S_TxCpltCallback is executed and user can
mbed_official	237:f3da66175598	82	add his own code by customization of function pointer HAL_I2S_TxCpltCallback
mbed_official	237:f3da66175598	83	(+) Receive an amount of data in non blocking mode (DMA) using HAL_I2S_Receive_DMA()
mbed_official	237:f3da66175598	84	(+) At reception end of half transfer HAL_I2S_RxHalfCpltCallback is executed and user can
mbed_official	237:f3da66175598	85	add his own code by customization of function pointer HAL_I2S_RxHalfCpltCallback
mbed_official	237:f3da66175598	86	(+) At reception end of transfer HAL_I2S_RxCpltCallback is executed and user can
mbed_official	237:f3da66175598	87	add his own code by customization of function pointer HAL_I2S_RxCpltCallback
mbed_official	237:f3da66175598	88	(+) In case of transfer Error, HAL_I2S_ErrorCallback() function is executed and user can
mbed_official	237:f3da66175598	89	add his own code by customization of function pointer HAL_I2S_ErrorCallback
mbed_official	237:f3da66175598	90	(+) Pause the DMA Transfer using HAL_I2S_DMAPause()
mbed_official	237:f3da66175598	91	(+) Resume the DMA Transfer using HAL_I2S_DMAResume()
mbed_official	237:f3da66175598	92	(+) Stop the DMA Transfer using HAL_I2S_DMAStop()
mbed_official	237:f3da66175598	93
mbed_official	237:f3da66175598	94	* I2S HAL driver macros list *
mbed_official	237:f3da66175598	95	=============================================
mbed_official	237:f3da66175598	96	[..]
mbed_official	237:f3da66175598	97	Below the list of most used macros in I2S HAL driver.
mbed_official	237:f3da66175598	98
mbed_official	237:f3da66175598	99	(+) __HAL_I2S_ENABLE: Enable the specified SPI peripheral (in I2S mode)
mbed_official	237:f3da66175598	100	(+) __HAL_I2S_DISABLE: Disable the specified SPI peripheral (in I2S mode)
mbed_official	237:f3da66175598	101	(+) __HAL_I2S_ENABLE_IT : Enable the specified I2S interrupts
mbed_official	237:f3da66175598	102	(+) __HAL_I2S_DISABLE_IT : Disable the specified I2S interrupts
mbed_official	237:f3da66175598	103	(+) __HAL_I2S_GET_FLAG: Check whether the specified I2S flag is set or not
mbed_official	237:f3da66175598	104
mbed_official	237:f3da66175598	105	[..]
mbed_official	237:f3da66175598	106	(@) You can refer to the I2S HAL driver header file for more useful macros
mbed_official	237:f3da66175598	107
mbed_official	237:f3da66175598	108	@endverbatim
mbed_official	237:f3da66175598	109	******************************************************************************
mbed_official	237:f3da66175598	110	* @attention
mbed_official	237:f3da66175598	111	*
mbed_official	632:7687fb9c4f91	112	* <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official	237:f3da66175598	113	*
mbed_official	237:f3da66175598	114	* Redistribution and use in source and binary forms, with or without modification,
mbed_official	237:f3da66175598	115	* are permitted provided that the following conditions are met:
mbed_official	237:f3da66175598	116	* 1. Redistributions of source code must retain the above copyright notice,
mbed_official	237:f3da66175598	117	* this list of conditions and the following disclaimer.
mbed_official	237:f3da66175598	118	* 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official	237:f3da66175598	119	* this list of conditions and the following disclaimer in the documentation
mbed_official	237:f3da66175598	120	* and/or other materials provided with the distribution.
mbed_official	237:f3da66175598	121	* 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official	237:f3da66175598	122	* may be used to endorse or promote products derived from this software
mbed_official	237:f3da66175598	123	* without specific prior written permission.
mbed_official	237:f3da66175598	124	*
mbed_official	237:f3da66175598	125	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official	237:f3da66175598	126	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official	237:f3da66175598	127	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official	237:f3da66175598	128	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official	237:f3da66175598	129	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official	237:f3da66175598	130	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official	237:f3da66175598	131	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official	237:f3da66175598	132	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official	237:f3da66175598	133	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official	237:f3da66175598	134	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official	237:f3da66175598	135	*
mbed_official	237:f3da66175598	136	******************************************************************************
mbed_official	237:f3da66175598	137	*/
mbed_official	237:f3da66175598	138
mbed_official	237:f3da66175598	139	/* Includes ------------------------------------------------------------------*/
mbed_official	237:f3da66175598	140	#include "stm32f3xx_hal.h"
mbed_official	237:f3da66175598	141
mbed_official	237:f3da66175598	142	/** @addtogroup STM32F3xx_HAL_Driver
mbed_official	237:f3da66175598	143	* @{
mbed_official	237:f3da66175598	144	*/
mbed_official	237:f3da66175598	145
mbed_official	375:3d36234a1087	146	/** @defgroup I2S I2S HAL module driver
mbed_official	237:f3da66175598	147	* @brief I2S HAL module driver
mbed_official	237:f3da66175598	148	* @{
mbed_official	237:f3da66175598	149	*/
mbed_official	237:f3da66175598	150
mbed_official	237:f3da66175598	151	#ifdef HAL_I2S_MODULE_ENABLED
mbed_official	237:f3da66175598	152
mbed_official	375:3d36234a1087	153	#if defined(STM32F302xE) \|\| defined(STM32F303xE) \|\| defined(STM32F398xx) \|\| \
mbed_official	375:3d36234a1087	154	defined(STM32F302xC) \|\| defined(STM32F303xC) \|\| defined(STM32F358xx) \|\| \
mbed_official	375:3d36234a1087	155	defined(STM32F301x8) \|\| defined(STM32F302x8) \|\| defined(STM32F318xx) \|\| \
mbed_official	375:3d36234a1087	156	defined(STM32F373xC) \|\| defined(STM32F378xx)
mbed_official	237:f3da66175598	157
mbed_official	237:f3da66175598	158	/* Private typedef -----------------------------------------------------------*/
mbed_official	237:f3da66175598	159	/* Private define ------------------------------------------------------------*/
mbed_official	237:f3da66175598	160	/* Private macro -------------------------------------------------------------*/
mbed_official	237:f3da66175598	161	/* Private variables ---------------------------------------------------------*/
mbed_official	237:f3da66175598	162	/* Private function prototypes -----------------------------------------------*/
mbed_official	375:3d36234a1087	163	/** @defgroup I2S_Private_Functions I2S Private Functions
mbed_official	375:3d36234a1087	164	* @{
mbed_official	375:3d36234a1087	165	*/
mbed_official	237:f3da66175598	166	static void I2S_DMATxCplt(DMA_HandleTypeDef *hdma);
mbed_official	237:f3da66175598	167	static void I2S_DMATxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official	237:f3da66175598	168	static void I2S_DMARxCplt(DMA_HandleTypeDef *hdma);
mbed_official	237:f3da66175598	169	static void I2S_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official	237:f3da66175598	170	static void I2S_DMAError(DMA_HandleTypeDef *hdma);
mbed_official	237:f3da66175598	171	static void I2S_Transmit_IT(I2S_HandleTypeDef *hi2s);
mbed_official	237:f3da66175598	172	static void I2S_Receive_IT(I2S_HandleTypeDef *hi2s);
mbed_official	237:f3da66175598	173	static HAL_StatusTypeDef I2S_WaitFlagStateUntilTimeout(I2S_HandleTypeDef *hi2s, uint32_t Flag, uint32_t State, uint32_t Timeout);
mbed_official	375:3d36234a1087	174	/**
mbed_official	375:3d36234a1087	175	* @}
mbed_official	375:3d36234a1087	176	*/
mbed_official	237:f3da66175598	177
mbed_official	375:3d36234a1087	178	/* Exported functions ---------------------------------------------------------*/
mbed_official	237:f3da66175598	179
mbed_official	375:3d36234a1087	180	/** @defgroup I2S_Exported_Functions I2S Exported Functions
mbed_official	237:f3da66175598	181	* @{
mbed_official	237:f3da66175598	182	*/
mbed_official	237:f3da66175598	183
mbed_official	375:3d36234a1087	184	/** @defgroup I2S_Exported_Functions_Group1 Initialization and de-initialization functions
mbed_official	237:f3da66175598	185	* @brief Initialization and Configuration functions
mbed_official	237:f3da66175598	186	*
mbed_official	237:f3da66175598	187	@verbatim
mbed_official	237:f3da66175598	188	===============================================================================
mbed_official	237:f3da66175598	189	##### Initialization and de-initialization functions #####
mbed_official	237:f3da66175598	190	===============================================================================
mbed_official	237:f3da66175598	191	[..] This subsection provides a set of functions allowing to initialize and
mbed_official	237:f3da66175598	192	de-initialiaze the I2Sx peripheral in simplex mode:
mbed_official	237:f3da66175598	193
mbed_official	237:f3da66175598	194	(+) User must Implement HAL_I2S_MspInit() function in which he configures
mbed_official	237:f3da66175598	195	all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC ).
mbed_official	237:f3da66175598	196
mbed_official	237:f3da66175598	197	(+) Call the function HAL_I2S_Init() to configure the selected device with
mbed_official	237:f3da66175598	198	the selected configuration:
mbed_official	237:f3da66175598	199	(++) Mode
mbed_official	237:f3da66175598	200	(++) Standard
mbed_official	237:f3da66175598	201	(++) Data Format
mbed_official	237:f3da66175598	202	(++) MCLK Output
mbed_official	237:f3da66175598	203	(++) Audio frequency
mbed_official	237:f3da66175598	204	(++) Polarity
mbed_official	237:f3da66175598	205	(++) Full duplex mode
mbed_official	237:f3da66175598	206
mbed_official	237:f3da66175598	207	(+) Call the function HAL_I2S_DeInit() to restore the default configuration
mbed_official	237:f3da66175598	208	of the selected I2Sx periperal.
mbed_official	237:f3da66175598	209	@endverbatim
mbed_official	237:f3da66175598	210	* @{
mbed_official	237:f3da66175598	211	*/
mbed_official	237:f3da66175598	212
mbed_official	237:f3da66175598	213	/**
mbed_official	237:f3da66175598	214	* @brief Initializes the I2S according to the specified parameters
mbed_official	237:f3da66175598	215	* in the I2S_InitTypeDef and create the associated handle.
mbed_official	375:3d36234a1087	216	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	217	* the configuration information for I2S module
mbed_official	237:f3da66175598	218	* @retval HAL status
mbed_official	237:f3da66175598	219	*/
mbed_official	237:f3da66175598	220	__weak HAL_StatusTypeDef HAL_I2S_Init(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	221	{
mbed_official	237:f3da66175598	222	/* Note : This function is defined into this file for library reference. */
mbed_official	237:f3da66175598	223	/* Function content is located into file stm32f3xx_hal_i2s_ex.c to */
mbed_official	237:f3da66175598	224	/* handle the possible I2S interfaces defined in STM32F3xx devices */
mbed_official	237:f3da66175598	225
mbed_official	237:f3da66175598	226	/* Return error status as not implemented here */
mbed_official	237:f3da66175598	227	return HAL_ERROR;
mbed_official	237:f3da66175598	228	}
mbed_official	237:f3da66175598	229
mbed_official	237:f3da66175598	230	/**
mbed_official	237:f3da66175598	231	* @brief DeInitializes the I2S peripheral
mbed_official	375:3d36234a1087	232	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	233	* the configuration information for I2S module
mbed_official	237:f3da66175598	234	* @retval HAL status
mbed_official	237:f3da66175598	235	*/
mbed_official	237:f3da66175598	236	HAL_StatusTypeDef HAL_I2S_DeInit(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	237	{
mbed_official	237:f3da66175598	238	/* Check the I2S handle allocation */
mbed_official	632:7687fb9c4f91	239	if(hi2s == NULL)
mbed_official	237:f3da66175598	240	{
mbed_official	237:f3da66175598	241	return HAL_ERROR;
mbed_official	237:f3da66175598	242	}
mbed_official	237:f3da66175598	243
mbed_official	237:f3da66175598	244	/* Check the parameters */
mbed_official	237:f3da66175598	245	assert_param(IS_I2S_ALL_INSTANCE(hi2s->Instance));
mbed_official	237:f3da66175598	246
mbed_official	237:f3da66175598	247	hi2s->State = HAL_I2S_STATE_BUSY;
mbed_official	237:f3da66175598	248
mbed_official	237:f3da66175598	249	/* DeInit the low level hardware: GPIO, CLOCK, NVIC... */
mbed_official	237:f3da66175598	250	HAL_I2S_MspDeInit(hi2s);
mbed_official	237:f3da66175598	251
mbed_official	237:f3da66175598	252	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	253	hi2s->State = HAL_I2S_STATE_RESET;
mbed_official	237:f3da66175598	254
mbed_official	237:f3da66175598	255	/* Release Lock */
mbed_official	237:f3da66175598	256	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	257
mbed_official	237:f3da66175598	258	return HAL_OK;
mbed_official	237:f3da66175598	259	}
mbed_official	237:f3da66175598	260
mbed_official	237:f3da66175598	261	/**
mbed_official	237:f3da66175598	262	* @brief I2S MSP Init
mbed_official	375:3d36234a1087	263	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	264	* the configuration information for I2S module
mbed_official	237:f3da66175598	265	* @retval None
mbed_official	237:f3da66175598	266	*/
mbed_official	237:f3da66175598	267	__weak void HAL_I2S_MspInit(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	268	{
mbed_official	237:f3da66175598	269	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	270	the HAL_I2S_MspInit could be implemented in the user file
mbed_official	237:f3da66175598	271	*/
mbed_official	237:f3da66175598	272	}
mbed_official	237:f3da66175598	273
mbed_official	237:f3da66175598	274	/**
mbed_official	237:f3da66175598	275	* @brief I2S MSP DeInit
mbed_official	375:3d36234a1087	276	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	277	* the configuration information for I2S module
mbed_official	237:f3da66175598	278	* @retval None
mbed_official	237:f3da66175598	279	*/
mbed_official	237:f3da66175598	280	__weak void HAL_I2S_MspDeInit(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	281	{
mbed_official	237:f3da66175598	282	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	283	the HAL_I2S_MspDeInit could be implemented in the user file
mbed_official	237:f3da66175598	284	*/
mbed_official	237:f3da66175598	285	}
mbed_official	237:f3da66175598	286
mbed_official	237:f3da66175598	287	/**
mbed_official	237:f3da66175598	288	* @}
mbed_official	237:f3da66175598	289	*/
mbed_official	237:f3da66175598	290
mbed_official	375:3d36234a1087	291	/** @defgroup I2S_Exported_Functions_Group2 Input and Output operation functions
mbed_official	237:f3da66175598	292	* @brief Data transfers functions
mbed_official	237:f3da66175598	293	*
mbed_official	237:f3da66175598	294	@verbatim
mbed_official	237:f3da66175598	295	===============================================================================
mbed_official	237:f3da66175598	296	##### IO operation functions #####
mbed_official	237:f3da66175598	297	===============================================================================
mbed_official	237:f3da66175598	298	[..]
mbed_official	237:f3da66175598	299	This subsection provides a set of functions allowing to manage the I2S data
mbed_official	237:f3da66175598	300	transfers.
mbed_official	237:f3da66175598	301
mbed_official	375:3d36234a1087	302	(#) There are two modes of transfer:
mbed_official	237:f3da66175598	303	(++) Blocking mode : The communication is performed in the polling mode.
mbed_official	237:f3da66175598	304	The status of all data processing is returned by the same function
mbed_official	237:f3da66175598	305	after finishing transfer.
mbed_official	237:f3da66175598	306	(++) No-Blocking mode : The communication is performed using Interrupts
mbed_official	237:f3da66175598	307	or DMA. These functions return the status of the transfer startup.
mbed_official	237:f3da66175598	308	The end of the data processing will be indicated through the
mbed_official	237:f3da66175598	309	dedicated I2S IRQ when using Interrupt mode or the DMA IRQ when
mbed_official	237:f3da66175598	310	using DMA mode.
mbed_official	237:f3da66175598	311
mbed_official	237:f3da66175598	312	(#) Blocking mode functions are :
mbed_official	237:f3da66175598	313	(++) HAL_I2S_Transmit()
mbed_official	237:f3da66175598	314	(++) HAL_I2S_Receive()
mbed_official	237:f3da66175598	315
mbed_official	237:f3da66175598	316	(#) No-Blocking mode functions with Interrupt are :
mbed_official	237:f3da66175598	317	(++) HAL_I2S_Transmit_IT()
mbed_official	237:f3da66175598	318	(++) HAL_I2S_Receive_IT()
mbed_official	237:f3da66175598	319
mbed_official	237:f3da66175598	320	(#) No-Blocking mode functions with DMA are :
mbed_official	237:f3da66175598	321	(++) HAL_I2S_Transmit_DMA()
mbed_official	237:f3da66175598	322	(++) HAL_I2S_Receive_DMA()
mbed_official	237:f3da66175598	323
mbed_official	375:3d36234a1087	324	(#) A set of Transfer Complete Callbacks are provided in non Blocking mode:
mbed_official	237:f3da66175598	325	(++) HAL_I2S_TxCpltCallback()
mbed_official	237:f3da66175598	326	(++) HAL_I2S_RxCpltCallback()
mbed_official	237:f3da66175598	327	(++) HAL_I2S_ErrorCallback()
mbed_official	237:f3da66175598	328
mbed_official	237:f3da66175598	329	@endverbatim
mbed_official	237:f3da66175598	330	* @{
mbed_official	237:f3da66175598	331	*/
mbed_official	237:f3da66175598	332
mbed_official	237:f3da66175598	333	/**
mbed_official	237:f3da66175598	334	* @brief Transmit an amount of data in blocking mode
mbed_official	375:3d36234a1087	335	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	336	* the configuration information for I2S module
mbed_official	237:f3da66175598	337	* @param pData: a 16-bit pointer to data buffer.
mbed_official	237:f3da66175598	338	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	339	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	340	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	341	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	342	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	343	* @param Timeout: Timeout duration
mbed_official	237:f3da66175598	344	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	345	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	346	* @retval HAL status
mbed_official	237:f3da66175598	347	*/
mbed_official	237:f3da66175598	348	HAL_StatusTypeDef HAL_I2S_Transmit(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size, uint32_t Timeout)
mbed_official	237:f3da66175598	349	{
mbed_official	632:7687fb9c4f91	350	if((pData == NULL ) \|\| (Size == 0))
mbed_official	237:f3da66175598	351	{
mbed_official	237:f3da66175598	352	return HAL_ERROR;
mbed_official	237:f3da66175598	353	}
mbed_official	237:f3da66175598	354
mbed_official	237:f3da66175598	355	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	356	{
mbed_official	237:f3da66175598	357	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	358	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	359	{
mbed_official	237:f3da66175598	360	hi2s->TxXferSize = (Size << 1);
mbed_official	237:f3da66175598	361	hi2s->TxXferCount = (Size << 1);
mbed_official	237:f3da66175598	362	}
mbed_official	237:f3da66175598	363	else
mbed_official	237:f3da66175598	364	{
mbed_official	237:f3da66175598	365	hi2s->TxXferSize = Size;
mbed_official	237:f3da66175598	366	hi2s->TxXferCount = Size;
mbed_official	237:f3da66175598	367	}
mbed_official	237:f3da66175598	368
mbed_official	237:f3da66175598	369	/* Process Locked */
mbed_official	237:f3da66175598	370	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	371
mbed_official	237:f3da66175598	372	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	373	hi2s->State = HAL_I2S_STATE_BUSY_TX;
mbed_official	237:f3da66175598	374
mbed_official	237:f3da66175598	375	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	376	if((hi2s->Instance->I2SCFGR &SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	377	{
mbed_official	237:f3da66175598	378	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	379	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	380	}
mbed_official	237:f3da66175598	381
mbed_official	237:f3da66175598	382	while(hi2s->TxXferCount > 0)
mbed_official	237:f3da66175598	383	{
mbed_official	237:f3da66175598	384	hi2s->Instance->DR = (*pData++);
mbed_official	237:f3da66175598	385	hi2s->TxXferCount--;
mbed_official	237:f3da66175598	386	/* Wait until TXE flag is set */
mbed_official	237:f3da66175598	387	if (I2S_WaitFlagStateUntilTimeout(hi2s, I2S_FLAG_TXE, SET, Timeout) != HAL_OK)
mbed_official	237:f3da66175598	388	{
mbed_official	237:f3da66175598	389	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	390	hi2s->ErrorCode \|= HAL_I2S_ERROR_TIMEOUT;
mbed_official	237:f3da66175598	391	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	392	return HAL_TIMEOUT;
mbed_official	237:f3da66175598	393	}
mbed_official	237:f3da66175598	394
mbed_official	237:f3da66175598	395	/* Check if an underrun occurs */
mbed_official	237:f3da66175598	396	if(__HAL_I2S_GET_FLAG(hi2s, I2S_FLAG_UDR) == SET)
mbed_official	237:f3da66175598	397	{
mbed_official	237:f3da66175598	398	/* Set the I2S State ready */
mbed_official	237:f3da66175598	399	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	400
mbed_official	237:f3da66175598	401	/* Process Unlocked */
mbed_official	237:f3da66175598	402	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	403
mbed_official	237:f3da66175598	404	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	405	hi2s->ErrorCode \|= HAL_I2S_ERROR_UDR;
mbed_official	237:f3da66175598	406	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	407
mbed_official	237:f3da66175598	408	return HAL_ERROR;
mbed_official	237:f3da66175598	409	}
mbed_official	237:f3da66175598	410	}
mbed_official	237:f3da66175598	411
mbed_official	237:f3da66175598	412	/* Wait until Busy flag is reset */
mbed_official	237:f3da66175598	413	if (I2S_WaitFlagStateUntilTimeout(hi2s, I2S_FLAG_BSY, RESET, Timeout) != HAL_OK)
mbed_official	237:f3da66175598	414	{
mbed_official	237:f3da66175598	415	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	416	hi2s->ErrorCode \|= HAL_I2S_ERROR_TIMEOUT;
mbed_official	237:f3da66175598	417	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	418	return HAL_TIMEOUT;
mbed_official	237:f3da66175598	419	}
mbed_official	237:f3da66175598	420
mbed_official	237:f3da66175598	421	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	422
mbed_official	237:f3da66175598	423	/* Process Unlocked */
mbed_official	237:f3da66175598	424	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	425
mbed_official	237:f3da66175598	426	return HAL_OK;
mbed_official	237:f3da66175598	427	}
mbed_official	237:f3da66175598	428	else
mbed_official	237:f3da66175598	429	{
mbed_official	237:f3da66175598	430	return HAL_BUSY;
mbed_official	237:f3da66175598	431	}
mbed_official	237:f3da66175598	432	}
mbed_official	237:f3da66175598	433
mbed_official	237:f3da66175598	434	/**
mbed_official	237:f3da66175598	435	* @brief Receive an amount of data in blocking mode
mbed_official	375:3d36234a1087	436	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	437	* the configuration information for I2S module
mbed_official	237:f3da66175598	438	* @param pData: a 16-bit pointer to data buffer.
mbed_official	237:f3da66175598	439	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	440	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	441	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	442	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	443	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	444	* @param Timeout: Timeout duration
mbed_official	237:f3da66175598	445	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	446	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	447	* @note In I2S Master Receiver mode, just after enabling the peripheral the clock will be generate
mbed_official	237:f3da66175598	448	* in continouse way and as the I2S is not disabled at the end of the I2S transaction.
mbed_official	237:f3da66175598	449	* @retval HAL status
mbed_official	237:f3da66175598	450	*/
mbed_official	237:f3da66175598	451	HAL_StatusTypeDef HAL_I2S_Receive(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size, uint32_t Timeout)
mbed_official	237:f3da66175598	452	{
mbed_official	632:7687fb9c4f91	453	if((pData == NULL ) \|\| (Size == 0))
mbed_official	237:f3da66175598	454	{
mbed_official	237:f3da66175598	455	return HAL_ERROR;
mbed_official	237:f3da66175598	456	}
mbed_official	237:f3da66175598	457
mbed_official	237:f3da66175598	458	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	459	{
mbed_official	237:f3da66175598	460	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	461	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	462	{
mbed_official	237:f3da66175598	463	hi2s->RxXferSize = (Size << 1);
mbed_official	237:f3da66175598	464	hi2s->RxXferCount = (Size << 1);
mbed_official	237:f3da66175598	465	}
mbed_official	237:f3da66175598	466	else
mbed_official	237:f3da66175598	467	{
mbed_official	237:f3da66175598	468	hi2s->RxXferSize = Size;
mbed_official	237:f3da66175598	469	hi2s->RxXferCount = Size;
mbed_official	237:f3da66175598	470	}
mbed_official	237:f3da66175598	471	/* Process Locked */
mbed_official	237:f3da66175598	472	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	473
mbed_official	237:f3da66175598	474	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	475	hi2s->State = HAL_I2S_STATE_BUSY_RX;
mbed_official	237:f3da66175598	476
mbed_official	237:f3da66175598	477	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	478	if((hi2s->Instance->I2SCFGR & SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	479	{
mbed_official	237:f3da66175598	480	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	481	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	482	}
mbed_official	237:f3da66175598	483
mbed_official	237:f3da66175598	484	/* Check if Master Receiver mode is selected */
mbed_official	237:f3da66175598	485	if((hi2s->Instance->I2SCFGR & SPI_I2SCFGR_I2SCFG) == I2S_MODE_MASTER_RX)
mbed_official	237:f3da66175598	486	{
mbed_official	237:f3da66175598	487	/* Clear the Overrun Flag by a read operation on the SPI_DR register followed by a read
mbed_official	237:f3da66175598	488	access to the SPI_SR register. */
mbed_official	237:f3da66175598	489	__HAL_I2S_CLEAR_OVRFLAG(hi2s);
mbed_official	237:f3da66175598	490	}
mbed_official	237:f3da66175598	491
mbed_official	237:f3da66175598	492	/* Receive data */
mbed_official	237:f3da66175598	493	while(hi2s->RxXferCount > 0)
mbed_official	237:f3da66175598	494	{
mbed_official	237:f3da66175598	495	/* Wait until RXNE flag is set */
mbed_official	237:f3da66175598	496	if (I2S_WaitFlagStateUntilTimeout(hi2s, I2S_FLAG_RXNE, SET, Timeout) != HAL_OK)
mbed_official	237:f3da66175598	497	{
mbed_official	237:f3da66175598	498	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	499	hi2s->ErrorCode \|= HAL_I2S_ERROR_TIMEOUT;
mbed_official	237:f3da66175598	500	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	501	return HAL_TIMEOUT;
mbed_official	237:f3da66175598	502	}
mbed_official	237:f3da66175598	503
mbed_official	237:f3da66175598	504	/* Check if an overrun occurs */
mbed_official	237:f3da66175598	505	if(__HAL_I2S_GET_FLAG(hi2s, I2S_FLAG_OVR) == SET)
mbed_official	237:f3da66175598	506	{
mbed_official	237:f3da66175598	507	/* Set the I2S State ready */
mbed_official	237:f3da66175598	508	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	509
mbed_official	237:f3da66175598	510	/* Process Unlocked */
mbed_official	237:f3da66175598	511	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	512
mbed_official	237:f3da66175598	513	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	514	hi2s->ErrorCode \|= HAL_I2S_ERROR_OVR;
mbed_official	237:f3da66175598	515	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	516
mbed_official	237:f3da66175598	517	return HAL_ERROR;
mbed_official	237:f3da66175598	518	}
mbed_official	237:f3da66175598	519
mbed_official	237:f3da66175598	520	(*pData++) = hi2s->Instance->DR;
mbed_official	237:f3da66175598	521	hi2s->RxXferCount--;
mbed_official	237:f3da66175598	522	}
mbed_official	237:f3da66175598	523
mbed_official	237:f3da66175598	524	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	525
mbed_official	237:f3da66175598	526	/* Process Unlocked */
mbed_official	237:f3da66175598	527	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	528
mbed_official	237:f3da66175598	529	return HAL_OK;
mbed_official	237:f3da66175598	530	}
mbed_official	237:f3da66175598	531	else
mbed_official	237:f3da66175598	532	{
mbed_official	237:f3da66175598	533	return HAL_BUSY;
mbed_official	237:f3da66175598	534	}
mbed_official	237:f3da66175598	535	}
mbed_official	237:f3da66175598	536
mbed_official	237:f3da66175598	537	/**
mbed_official	237:f3da66175598	538	* @brief Transmit an amount of data in non-blocking mode with Interrupt
mbed_official	375:3d36234a1087	539	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	540	* the configuration information for I2S module
mbed_official	237:f3da66175598	541	* @param pData: a 16-bit pointer to data buffer.
mbed_official	237:f3da66175598	542	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	543	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	544	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	545	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	546	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	547	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	548	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	549	* @retval HAL status
mbed_official	237:f3da66175598	550	*/
mbed_official	237:f3da66175598	551	HAL_StatusTypeDef HAL_I2S_Transmit_IT(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size)
mbed_official	237:f3da66175598	552	{
mbed_official	237:f3da66175598	553	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	554	{
mbed_official	632:7687fb9c4f91	555	if((pData == NULL) \|\| (Size == 0))
mbed_official	237:f3da66175598	556	{
mbed_official	237:f3da66175598	557	return HAL_ERROR;
mbed_official	237:f3da66175598	558	}
mbed_official	237:f3da66175598	559
mbed_official	237:f3da66175598	560	hi2s->pTxBuffPtr = pData;
mbed_official	237:f3da66175598	561	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	562	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	563	{
mbed_official	237:f3da66175598	564	hi2s->TxXferSize = (Size << 1);
mbed_official	237:f3da66175598	565	hi2s->TxXferCount = (Size << 1);
mbed_official	237:f3da66175598	566	}
mbed_official	237:f3da66175598	567	else
mbed_official	237:f3da66175598	568	{
mbed_official	237:f3da66175598	569	hi2s->TxXferSize = Size;
mbed_official	237:f3da66175598	570	hi2s->TxXferCount = Size;
mbed_official	237:f3da66175598	571	}
mbed_official	237:f3da66175598	572
mbed_official	237:f3da66175598	573	/* Process Locked */
mbed_official	237:f3da66175598	574	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	575
mbed_official	237:f3da66175598	576	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	577	hi2s->State = HAL_I2S_STATE_BUSY_TX;
mbed_official	237:f3da66175598	578
mbed_official	237:f3da66175598	579	/* Enable TXE and ERR interrupt */
mbed_official	237:f3da66175598	580	__HAL_I2S_ENABLE_IT(hi2s, (I2S_IT_TXE \| I2S_IT_ERR));
mbed_official	237:f3da66175598	581
mbed_official	237:f3da66175598	582	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	583	if((hi2s->Instance->I2SCFGR &SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	584	{
mbed_official	237:f3da66175598	585	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	586	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	587	}
mbed_official	237:f3da66175598	588
mbed_official	237:f3da66175598	589	/* Process Unlocked */
mbed_official	237:f3da66175598	590	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	591
mbed_official	237:f3da66175598	592	return HAL_OK;
mbed_official	237:f3da66175598	593	}
mbed_official	237:f3da66175598	594	else
mbed_official	237:f3da66175598	595	{
mbed_official	237:f3da66175598	596	return HAL_BUSY;
mbed_official	237:f3da66175598	597	}
mbed_official	237:f3da66175598	598	}
mbed_official	237:f3da66175598	599
mbed_official	237:f3da66175598	600	/**
mbed_official	237:f3da66175598	601	* @brief Receive an amount of data in non-blocking mode with Interrupt
mbed_official	375:3d36234a1087	602	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	603	* the configuration information for I2S module
mbed_official	237:f3da66175598	604	* @param pData: a 16-bit pointer to the Receive data buffer.
mbed_official	237:f3da66175598	605	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	606	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	607	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	608	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	609	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	610	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	611	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	612	* @note It is recommended to use DMA for the I2S receiver to avoid de-synchronisation
mbed_official	237:f3da66175598	613	* between Master and Slave otherwise the I2S interrupt should be optimized.
mbed_official	237:f3da66175598	614	* @retval HAL status
mbed_official	237:f3da66175598	615	*/
mbed_official	237:f3da66175598	616	HAL_StatusTypeDef HAL_I2S_Receive_IT(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size)
mbed_official	237:f3da66175598	617	{
mbed_official	237:f3da66175598	618	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	619	{
mbed_official	632:7687fb9c4f91	620	if((pData == NULL) \|\| (Size == 0))
mbed_official	237:f3da66175598	621	{
mbed_official	237:f3da66175598	622	return HAL_ERROR;
mbed_official	237:f3da66175598	623	}
mbed_official	237:f3da66175598	624
mbed_official	237:f3da66175598	625	hi2s->pRxBuffPtr = pData;
mbed_official	237:f3da66175598	626	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	627	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	628	{
mbed_official	237:f3da66175598	629	hi2s->RxXferSize = (Size << 1);
mbed_official	237:f3da66175598	630	hi2s->RxXferCount = (Size << 1);
mbed_official	237:f3da66175598	631	}
mbed_official	237:f3da66175598	632	else
mbed_official	237:f3da66175598	633	{
mbed_official	237:f3da66175598	634	hi2s->RxXferSize = Size;
mbed_official	237:f3da66175598	635	hi2s->RxXferCount = Size;
mbed_official	237:f3da66175598	636	}
mbed_official	237:f3da66175598	637	/* Process Locked */
mbed_official	237:f3da66175598	638	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	639
mbed_official	237:f3da66175598	640	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	641	hi2s->State = HAL_I2S_STATE_BUSY_RX;
mbed_official	237:f3da66175598	642
mbed_official	237:f3da66175598	643	/* Enable TXE and ERR interrupt */
mbed_official	237:f3da66175598	644	__HAL_I2S_ENABLE_IT(hi2s, (I2S_IT_RXNE \| I2S_IT_ERR));
mbed_official	237:f3da66175598	645
mbed_official	237:f3da66175598	646	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	647	if((hi2s->Instance->I2SCFGR &SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	648	{
mbed_official	237:f3da66175598	649	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	650	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	651	}
mbed_official	237:f3da66175598	652
mbed_official	237:f3da66175598	653	/* Process Unlocked */
mbed_official	237:f3da66175598	654	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	655
mbed_official	237:f3da66175598	656	return HAL_OK;
mbed_official	237:f3da66175598	657	}
mbed_official	237:f3da66175598	658	else
mbed_official	237:f3da66175598	659	{
mbed_official	237:f3da66175598	660	return HAL_BUSY;
mbed_official	237:f3da66175598	661	}
mbed_official	237:f3da66175598	662	}
mbed_official	237:f3da66175598	663
mbed_official	237:f3da66175598	664	/**
mbed_official	237:f3da66175598	665	* @brief Transmit an amount of data in non-blocking mode with DMA
mbed_official	375:3d36234a1087	666	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	667	* the configuration information for I2S module
mbed_official	237:f3da66175598	668	* @param pData: a 16-bit pointer to the Transmit data buffer.
mbed_official	237:f3da66175598	669	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	670	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	671	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	672	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	673	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	674	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	675	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	676	* @retval HAL status
mbed_official	237:f3da66175598	677	*/
mbed_official	237:f3da66175598	678	HAL_StatusTypeDef HAL_I2S_Transmit_DMA(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size)
mbed_official	237:f3da66175598	679	{
mbed_official	237:f3da66175598	680	uint32_t *tmp;
mbed_official	237:f3da66175598	681
mbed_official	632:7687fb9c4f91	682	if((pData == NULL) \|\| (Size == 0))
mbed_official	237:f3da66175598	683	{
mbed_official	237:f3da66175598	684	return HAL_ERROR;
mbed_official	237:f3da66175598	685	}
mbed_official	237:f3da66175598	686
mbed_official	237:f3da66175598	687	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	688	{
mbed_official	237:f3da66175598	689	hi2s->pTxBuffPtr = pData;
mbed_official	237:f3da66175598	690	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	691	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	692	{
mbed_official	237:f3da66175598	693	hi2s->TxXferSize = (Size << 1);
mbed_official	237:f3da66175598	694	hi2s->TxXferCount = (Size << 1);
mbed_official	237:f3da66175598	695	}
mbed_official	237:f3da66175598	696	else
mbed_official	237:f3da66175598	697	{
mbed_official	237:f3da66175598	698	hi2s->TxXferSize = Size;
mbed_official	237:f3da66175598	699	hi2s->TxXferCount = Size;
mbed_official	237:f3da66175598	700	}
mbed_official	237:f3da66175598	701
mbed_official	237:f3da66175598	702	/* Process Locked */
mbed_official	237:f3da66175598	703	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	704
mbed_official	237:f3da66175598	705	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	706	hi2s->State = HAL_I2S_STATE_BUSY_TX;
mbed_official	237:f3da66175598	707
mbed_official	237:f3da66175598	708	/* Set the I2S Tx DMA Half transfer complete callback */
mbed_official	237:f3da66175598	709	hi2s->hdmatx->XferHalfCpltCallback = I2S_DMATxHalfCplt;
mbed_official	237:f3da66175598	710
mbed_official	237:f3da66175598	711	/* Set the I2S TxDMA transfer complete callback */
mbed_official	237:f3da66175598	712	hi2s->hdmatx->XferCpltCallback = I2S_DMATxCplt;
mbed_official	237:f3da66175598	713
mbed_official	237:f3da66175598	714	/* Set the DMA error callback */
mbed_official	237:f3da66175598	715	hi2s->hdmatx->XferErrorCallback = I2S_DMAError;
mbed_official	237:f3da66175598	716
mbed_official	237:f3da66175598	717	/* Enable the Tx DMA Channel */
mbed_official	237:f3da66175598	718	tmp = (uint32_t*)&pData;
mbed_official	237:f3da66175598	719	HAL_DMA_Start_IT(hi2s->hdmatx, (uint32_t)tmp, (uint32_t)&hi2s->Instance->DR, hi2s->TxXferSize);
mbed_official	237:f3da66175598	720
mbed_official	237:f3da66175598	721	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	722	if((hi2s->Instance->I2SCFGR &SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	723	{
mbed_official	237:f3da66175598	724	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	725	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	726	}
mbed_official	237:f3da66175598	727
mbed_official	237:f3da66175598	728	/* Enable Tx DMA Request */
mbed_official	237:f3da66175598	729	hi2s->Instance->CR2 \|= SPI_CR2_TXDMAEN;
mbed_official	237:f3da66175598	730
mbed_official	237:f3da66175598	731	/* Process Unlocked */
mbed_official	237:f3da66175598	732	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	733
mbed_official	237:f3da66175598	734	return HAL_OK;
mbed_official	237:f3da66175598	735	}
mbed_official	237:f3da66175598	736	else
mbed_official	237:f3da66175598	737	{
mbed_official	237:f3da66175598	738	return HAL_BUSY;
mbed_official	237:f3da66175598	739	}
mbed_official	237:f3da66175598	740	}
mbed_official	237:f3da66175598	741
mbed_official	237:f3da66175598	742	/**
mbed_official	237:f3da66175598	743	* @brief Receive an amount of data in non-blocking mode with DMA
mbed_official	375:3d36234a1087	744	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	745	* the configuration information for I2S module
mbed_official	237:f3da66175598	746	* @param pData: a 16-bit pointer to the Receive data buffer.
mbed_official	237:f3da66175598	747	* @param Size: number of data sample to be sent:
mbed_official	237:f3da66175598	748	* @note When a 16-bit data frame or a 16-bit data frame extended is selected during the I2S
mbed_official	237:f3da66175598	749	* configuration phase, the Size parameter means the number of 16-bit data length
mbed_official	237:f3da66175598	750	* in the transaction and when a 24-bit data frame or a 32-bit data frame is selected
mbed_official	237:f3da66175598	751	* the Size parameter means the number of 16-bit data length.
mbed_official	237:f3da66175598	752	* @note The I2S is kept enabled at the end of transaction to avoid the clock de-synchronization
mbed_official	237:f3da66175598	753	* between Master and Slave(example: audio streaming).
mbed_official	237:f3da66175598	754	* @retval HAL status
mbed_official	237:f3da66175598	755	*/
mbed_official	237:f3da66175598	756	HAL_StatusTypeDef HAL_I2S_Receive_DMA(I2S_HandleTypeDef hi2s, uint16_t pData, uint16_t Size)
mbed_official	237:f3da66175598	757	{
mbed_official	237:f3da66175598	758	uint32_t *tmp;
mbed_official	237:f3da66175598	759
mbed_official	632:7687fb9c4f91	760	if((pData == NULL) \|\| (Size == 0))
mbed_official	237:f3da66175598	761	{
mbed_official	237:f3da66175598	762	return HAL_ERROR;
mbed_official	237:f3da66175598	763	}
mbed_official	237:f3da66175598	764
mbed_official	237:f3da66175598	765	if(hi2s->State == HAL_I2S_STATE_READY)
mbed_official	237:f3da66175598	766	{
mbed_official	237:f3da66175598	767	hi2s->pRxBuffPtr = pData;
mbed_official	237:f3da66175598	768	if(((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_24B)\|\|\
mbed_official	237:f3da66175598	769	((hi2s->Instance->I2SCFGR & (SPI_I2SCFGR_DATLEN \| SPI_I2SCFGR_CHLEN)) == I2S_DATAFORMAT_32B))
mbed_official	237:f3da66175598	770	{
mbed_official	237:f3da66175598	771	hi2s->RxXferSize = (Size << 1);
mbed_official	237:f3da66175598	772	hi2s->RxXferCount = (Size << 1);
mbed_official	237:f3da66175598	773	}
mbed_official	237:f3da66175598	774	else
mbed_official	237:f3da66175598	775	{
mbed_official	237:f3da66175598	776	hi2s->RxXferSize = Size;
mbed_official	237:f3da66175598	777	hi2s->RxXferCount = Size;
mbed_official	237:f3da66175598	778	}
mbed_official	237:f3da66175598	779	/* Process Locked */
mbed_official	237:f3da66175598	780	__HAL_LOCK(hi2s);
mbed_official	237:f3da66175598	781
mbed_official	237:f3da66175598	782	hi2s->ErrorCode = HAL_I2S_ERROR_NONE;
mbed_official	237:f3da66175598	783	hi2s->State = HAL_I2S_STATE_BUSY_RX;
mbed_official	237:f3da66175598	784
mbed_official	237:f3da66175598	785	/* Set the I2S Rx DMA Half transfer complete callback */
mbed_official	237:f3da66175598	786	hi2s->hdmarx->XferHalfCpltCallback = I2S_DMARxHalfCplt;
mbed_official	237:f3da66175598	787
mbed_official	237:f3da66175598	788	/* Set the I2S Rx DMA transfer complete callback */
mbed_official	237:f3da66175598	789	hi2s->hdmarx->XferCpltCallback = I2S_DMARxCplt;
mbed_official	237:f3da66175598	790
mbed_official	237:f3da66175598	791	/* Set the DMA error callback */
mbed_official	237:f3da66175598	792	hi2s->hdmarx->XferErrorCallback = I2S_DMAError;
mbed_official	237:f3da66175598	793
mbed_official	237:f3da66175598	794	/* Check if Master Receiver mode is selected */
mbed_official	237:f3da66175598	795	if((hi2s->Instance->I2SCFGR & SPI_I2SCFGR_I2SCFG) == I2S_MODE_MASTER_RX)
mbed_official	237:f3da66175598	796	{
mbed_official	237:f3da66175598	797	/* Clear the Overrun Flag by a read operation to the SPI_DR register followed by a read
mbed_official	237:f3da66175598	798	access to the SPI_SR register. */
mbed_official	237:f3da66175598	799	__HAL_I2S_CLEAR_OVRFLAG(hi2s);
mbed_official	237:f3da66175598	800	}
mbed_official	237:f3da66175598	801
mbed_official	237:f3da66175598	802	/* Enable the Rx DMA Channel */
mbed_official	237:f3da66175598	803	tmp = (uint32_t*)&pData;
mbed_official	237:f3da66175598	804	HAL_DMA_Start_IT(hi2s->hdmarx, (uint32_t)&hi2s->Instance->DR, (uint32_t)tmp, hi2s->RxXferSize);
mbed_official	237:f3da66175598	805
mbed_official	237:f3da66175598	806	/* Check if the I2S is already enabled */
mbed_official	237:f3da66175598	807	if((hi2s->Instance->I2SCFGR &SPI_I2SCFGR_I2SE) != SPI_I2SCFGR_I2SE)
mbed_official	237:f3da66175598	808	{
mbed_official	237:f3da66175598	809	/* Enable I2S peripheral */
mbed_official	237:f3da66175598	810	__HAL_I2S_ENABLE(hi2s);
mbed_official	237:f3da66175598	811	}
mbed_official	237:f3da66175598	812
mbed_official	237:f3da66175598	813	/* Enable Rx DMA Request */
mbed_official	237:f3da66175598	814	hi2s->Instance->CR2 \|= SPI_CR2_RXDMAEN;
mbed_official	237:f3da66175598	815
mbed_official	237:f3da66175598	816	/* Process Unlocked */
mbed_official	237:f3da66175598	817	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	818
mbed_official	237:f3da66175598	819	return HAL_OK;
mbed_official	237:f3da66175598	820	}
mbed_official	237:f3da66175598	821	else
mbed_official	237:f3da66175598	822	{
mbed_official	237:f3da66175598	823	return HAL_BUSY;
mbed_official	237:f3da66175598	824	}
mbed_official	237:f3da66175598	825	}
mbed_official	237:f3da66175598	826
mbed_official	237:f3da66175598	827	/**
mbed_official	237:f3da66175598	828	* @brief This function handles I2S interrupt request.
mbed_official	375:3d36234a1087	829	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	830	* the configuration information for I2S module
mbed_official	237:f3da66175598	831	* @retval HAL status
mbed_official	237:f3da66175598	832	*/
mbed_official	237:f3da66175598	833	void HAL_I2S_IRQHandler(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	834	{
mbed_official	237:f3da66175598	835	__IO uint32_t i2ssr = hi2s->Instance->SR;
mbed_official	237:f3da66175598	836
mbed_official	237:f3da66175598	837	if(hi2s->State == HAL_I2S_STATE_BUSY_RX)
mbed_official	237:f3da66175598	838	{
mbed_official	237:f3da66175598	839	/* I2S in mode Receiver ----------------------------------------------------*/
mbed_official	237:f3da66175598	840	if(((i2ssr & I2S_FLAG_RXNE) == I2S_FLAG_RXNE) && (__HAL_I2S_GET_IT_SOURCE(hi2s, I2S_IT_RXNE) != RESET))
mbed_official	237:f3da66175598	841	{
mbed_official	237:f3da66175598	842	I2S_Receive_IT(hi2s);
mbed_official	237:f3da66175598	843	}
mbed_official	237:f3da66175598	844
mbed_official	237:f3da66175598	845	/* I2S Overrun error interrupt occured -------------------------------------*/
mbed_official	237:f3da66175598	846	if(((i2ssr & I2S_FLAG_OVR) == I2S_FLAG_OVR) && (__HAL_I2S_GET_IT_SOURCE(hi2s, I2S_IT_ERR) != RESET))
mbed_official	237:f3da66175598	847	{
mbed_official	237:f3da66175598	848	/* Disable RXNE and ERR interrupt */
mbed_official	237:f3da66175598	849	__HAL_I2S_DISABLE_IT(hi2s, (I2S_IT_RXNE \| I2S_IT_ERR));
mbed_official	237:f3da66175598	850
mbed_official	237:f3da66175598	851	/* Set the I2S State ready */
mbed_official	237:f3da66175598	852	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	853
mbed_official	237:f3da66175598	854	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	855	hi2s->ErrorCode \|= HAL_I2S_ERROR_OVR;
mbed_official	237:f3da66175598	856	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	857	}
mbed_official	237:f3da66175598	858	}
mbed_official	237:f3da66175598	859	else if(hi2s->State == HAL_I2S_STATE_BUSY_TX)
mbed_official	237:f3da66175598	860	{
mbed_official	237:f3da66175598	861	/* I2S in mode Tramitter ---------------------------------------------------*/
mbed_official	237:f3da66175598	862	if(((i2ssr & I2S_FLAG_TXE) == I2S_FLAG_TXE) && (__HAL_I2S_GET_IT_SOURCE(hi2s, I2S_IT_TXE) != RESET))
mbed_official	237:f3da66175598	863	{
mbed_official	237:f3da66175598	864	I2S_Transmit_IT(hi2s);
mbed_official	237:f3da66175598	865	}
mbed_official	237:f3da66175598	866
mbed_official	237:f3da66175598	867	/* I2S Underrun error interrupt occured ------------------------------------*/
mbed_official	237:f3da66175598	868	if(((i2ssr & I2S_FLAG_UDR) == I2S_FLAG_UDR) && (__HAL_I2S_GET_IT_SOURCE(hi2s, I2S_IT_ERR) != RESET))
mbed_official	237:f3da66175598	869	{
mbed_official	237:f3da66175598	870	/* Disable TXE and ERR interrupt */
mbed_official	237:f3da66175598	871	__HAL_I2S_DISABLE_IT(hi2s, (I2S_IT_TXE \| I2S_IT_ERR));
mbed_official	237:f3da66175598	872
mbed_official	237:f3da66175598	873	/* Set the I2S State ready */
mbed_official	237:f3da66175598	874	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	875
mbed_official	237:f3da66175598	876	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	877	hi2s->ErrorCode \|= HAL_I2S_ERROR_UDR;
mbed_official	237:f3da66175598	878	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	879	}
mbed_official	237:f3da66175598	880	}
mbed_official	237:f3da66175598	881	}
mbed_official	237:f3da66175598	882
mbed_official	237:f3da66175598	883	/**
mbed_official	375:3d36234a1087	884	* @}
mbed_official	375:3d36234a1087	885	*/
mbed_official	375:3d36234a1087	886
mbed_official	375:3d36234a1087	887	/**
mbed_official	375:3d36234a1087	888	* @}
mbed_official	375:3d36234a1087	889	*/
mbed_official	375:3d36234a1087	890
mbed_official	375:3d36234a1087	891	/** @addtogroup I2S_Private_Functions I2S Private Functions
mbed_official	375:3d36234a1087	892	* @{
mbed_official	375:3d36234a1087	893	*/
mbed_official	375:3d36234a1087	894	/**
mbed_official	237:f3da66175598	895	* @brief This function handles I2S Communication Timeout.
mbed_official	375:3d36234a1087	896	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	897	* the configuration information for I2S module
mbed_official	237:f3da66175598	898	* @param Flag: Flag checked
mbed_official	237:f3da66175598	899	* @param State: Value of the flag expected
mbed_official	237:f3da66175598	900	* @param Timeout: Duration of the timeout
mbed_official	237:f3da66175598	901	* @retval HAL status
mbed_official	237:f3da66175598	902	*/
mbed_official	237:f3da66175598	903	static HAL_StatusTypeDef I2S_WaitFlagStateUntilTimeout(I2S_HandleTypeDef *hi2s, uint32_t Flag,
mbed_official	237:f3da66175598	904	uint32_t State, uint32_t Timeout)
mbed_official	237:f3da66175598	905	{
mbed_official	237:f3da66175598	906	uint32_t tickstart = HAL_GetTick();
mbed_official	237:f3da66175598	907
mbed_official	237:f3da66175598	908	while((__HAL_I2S_GET_FLAG(hi2s, Flag)) != State)
mbed_official	237:f3da66175598	909	{
mbed_official	237:f3da66175598	910	if(Timeout != HAL_MAX_DELAY)
mbed_official	237:f3da66175598	911	{
mbed_official	237:f3da66175598	912	if((Timeout == 0) \|\| ((HAL_GetTick()-tickstart) > Timeout))
mbed_official	237:f3da66175598	913	{
mbed_official	237:f3da66175598	914	/* Set the I2S State ready */
mbed_official	237:f3da66175598	915	hi2s->State= HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	916
mbed_official	237:f3da66175598	917	/* Process Unlocked */
mbed_official	237:f3da66175598	918	__HAL_UNLOCK(hi2s);
mbed_official	237:f3da66175598	919
mbed_official	237:f3da66175598	920	return HAL_TIMEOUT;
mbed_official	237:f3da66175598	921	}
mbed_official	237:f3da66175598	922	}
mbed_official	237:f3da66175598	923	}
mbed_official	237:f3da66175598	924
mbed_official	237:f3da66175598	925	return HAL_OK;
mbed_official	237:f3da66175598	926	}
mbed_official	375:3d36234a1087	927	/**
mbed_official	375:3d36234a1087	928	* @}
mbed_official	375:3d36234a1087	929	*/
mbed_official	237:f3da66175598	930
mbed_official	375:3d36234a1087	931	/** @addtogroup I2S_Exported_Functions I2S Exported Functions
mbed_official	375:3d36234a1087	932	* @{
mbed_official	375:3d36234a1087	933	*/
mbed_official	375:3d36234a1087	934
mbed_official	375:3d36234a1087	935	/** @addtogroup I2S_Exported_Functions_Group2 Input and Output operation functions
mbed_official	375:3d36234a1087	936	* @{
mbed_official	375:3d36234a1087	937	*/
mbed_official	237:f3da66175598	938	/**
mbed_official	237:f3da66175598	939	* @brief Tx Transfer Half completed callbacks
mbed_official	375:3d36234a1087	940	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	941	* the configuration information for I2S module
mbed_official	237:f3da66175598	942	* @retval None
mbed_official	237:f3da66175598	943	*/
mbed_official	237:f3da66175598	944	__weak void HAL_I2S_TxHalfCpltCallback(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	945	{
mbed_official	237:f3da66175598	946	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	947	the HAL_I2S_TxHalfCpltCallback could be implemented in the user file
mbed_official	237:f3da66175598	948	*/
mbed_official	237:f3da66175598	949	}
mbed_official	237:f3da66175598	950
mbed_official	237:f3da66175598	951	/**
mbed_official	237:f3da66175598	952	* @brief Tx Transfer completed callbacks
mbed_official	375:3d36234a1087	953	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	954	* the configuration information for I2S module
mbed_official	237:f3da66175598	955	* @retval None
mbed_official	237:f3da66175598	956	*/
mbed_official	237:f3da66175598	957	__weak void HAL_I2S_TxCpltCallback(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	958	{
mbed_official	237:f3da66175598	959	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	960	the HAL_I2S_TxCpltCallback could be implemented in the user file
mbed_official	237:f3da66175598	961	*/
mbed_official	237:f3da66175598	962	}
mbed_official	237:f3da66175598	963
mbed_official	237:f3da66175598	964	/**
mbed_official	237:f3da66175598	965	* @brief Rx Transfer half completed callbacks
mbed_official	375:3d36234a1087	966	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	967	* the configuration information for I2S module
mbed_official	237:f3da66175598	968	* @retval None
mbed_official	237:f3da66175598	969	*/
mbed_official	237:f3da66175598	970	__weak void HAL_I2S_RxHalfCpltCallback(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	971	{
mbed_official	237:f3da66175598	972	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	973	the HAL_I2S_RxCpltCallback could be implemented in the user file
mbed_official	237:f3da66175598	974	*/
mbed_official	237:f3da66175598	975	}
mbed_official	237:f3da66175598	976
mbed_official	237:f3da66175598	977	/**
mbed_official	237:f3da66175598	978	* @brief Rx Transfer completed callbacks
mbed_official	375:3d36234a1087	979	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	980	* the configuration information for I2S module
mbed_official	237:f3da66175598	981	* @retval None
mbed_official	237:f3da66175598	982	*/
mbed_official	237:f3da66175598	983	__weak void HAL_I2S_RxCpltCallback(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	984	{
mbed_official	237:f3da66175598	985	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	986	the HAL_I2S_RxCpltCallback could be implemented in the user file
mbed_official	237:f3da66175598	987	*/
mbed_official	237:f3da66175598	988	}
mbed_official	237:f3da66175598	989
mbed_official	237:f3da66175598	990	/**
mbed_official	237:f3da66175598	991	* @brief I2S error callbacks
mbed_official	375:3d36234a1087	992	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	993	* the configuration information for I2S module
mbed_official	237:f3da66175598	994	* @retval None
mbed_official	237:f3da66175598	995	*/
mbed_official	237:f3da66175598	996	__weak void HAL_I2S_ErrorCallback(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	997	{
mbed_official	237:f3da66175598	998	/* NOTE : This function Should not be modified, when the callback is needed,
mbed_official	237:f3da66175598	999	the HAL_I2S_ErrorCallback could be implemented in the user file
mbed_official	237:f3da66175598	1000	*/
mbed_official	237:f3da66175598	1001	}
mbed_official	237:f3da66175598	1002
mbed_official	237:f3da66175598	1003	/**
mbed_official	237:f3da66175598	1004	* @}
mbed_official	237:f3da66175598	1005	*/
mbed_official	237:f3da66175598	1006
mbed_official	375:3d36234a1087	1007	/** @defgroup I2S_Exported_Functions_Group3 Peripheral State and Errors functions
mbed_official	237:f3da66175598	1008	* @brief Peripheral State functions
mbed_official	237:f3da66175598	1009	*
mbed_official	237:f3da66175598	1010	@verbatim
mbed_official	237:f3da66175598	1011	===============================================================================
mbed_official	237:f3da66175598	1012	##### Peripheral State and Errors functions #####
mbed_official	237:f3da66175598	1013	===============================================================================
mbed_official	237:f3da66175598	1014	[..]
mbed_official	375:3d36234a1087	1015	This subsection permits to get in run-time the status of the peripheral
mbed_official	237:f3da66175598	1016	and the data flow.
mbed_official	237:f3da66175598	1017
mbed_official	237:f3da66175598	1018	@endverbatim
mbed_official	237:f3da66175598	1019	* @{
mbed_official	237:f3da66175598	1020	*/
mbed_official	237:f3da66175598	1021
mbed_official	237:f3da66175598	1022	/**
mbed_official	237:f3da66175598	1023	* @brief Return the I2S state
mbed_official	375:3d36234a1087	1024	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1025	* the configuration information for I2S module
mbed_official	237:f3da66175598	1026	* @retval HAL state
mbed_official	237:f3da66175598	1027	*/
mbed_official	237:f3da66175598	1028	HAL_I2S_StateTypeDef HAL_I2S_GetState(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	1029	{
mbed_official	237:f3da66175598	1030	return hi2s->State;
mbed_official	237:f3da66175598	1031	}
mbed_official	237:f3da66175598	1032
mbed_official	237:f3da66175598	1033	/**
mbed_official	237:f3da66175598	1034	* @brief Return the I2S error code
mbed_official	375:3d36234a1087	1035	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1036	* the configuration information for I2S module
mbed_official	237:f3da66175598	1037	* @retval I2S Error Code
mbed_official	237:f3da66175598	1038	*/
mbed_official	237:f3da66175598	1039	HAL_I2S_ErrorTypeDef HAL_I2S_GetError(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	1040	{
mbed_official	237:f3da66175598	1041	return hi2s->ErrorCode;
mbed_official	237:f3da66175598	1042	}
mbed_official	237:f3da66175598	1043	/**
mbed_official	237:f3da66175598	1044	* @}
mbed_official	237:f3da66175598	1045	*/
mbed_official	237:f3da66175598	1046
mbed_official	237:f3da66175598	1047	/**
mbed_official	237:f3da66175598	1048	* @}
mbed_official	237:f3da66175598	1049	*/
mbed_official	237:f3da66175598	1050
mbed_official	375:3d36234a1087	1051	/** @addtogroup I2S_Private_Functions I2S Private Functions
mbed_official	375:3d36234a1087	1052	* @{
mbed_official	375:3d36234a1087	1053	*/
mbed_official	237:f3da66175598	1054	/**
mbed_official	237:f3da66175598	1055	* @brief DMA I2S transmit process complete callback
mbed_official	375:3d36234a1087	1056	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1057	* the configuration information for the specified DMA module.
mbed_official	237:f3da66175598	1058	* @retval None
mbed_official	237:f3da66175598	1059	*/
mbed_official	237:f3da66175598	1060	static void I2S_DMATxCplt(DMA_HandleTypeDef *hdma)
mbed_official	237:f3da66175598	1061	{
mbed_official	237:f3da66175598	1062	I2S_HandleTypeDef* hi2s = ( I2S_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official	237:f3da66175598	1063
mbed_official	237:f3da66175598	1064	/* Disable Tx DMA Request */
mbed_official	237:f3da66175598	1065	hi2s->Instance->CR2 &= (uint32_t)(~SPI_CR2_TXDMAEN);
mbed_official	237:f3da66175598	1066
mbed_official	237:f3da66175598	1067	hi2s->TxXferCount = 0;
mbed_official	237:f3da66175598	1068	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	1069
mbed_official	237:f3da66175598	1070	HAL_I2S_TxCpltCallback(hi2s);
mbed_official	237:f3da66175598	1071	}
mbed_official	237:f3da66175598	1072
mbed_official	237:f3da66175598	1073	/**
mbed_official	237:f3da66175598	1074	* @brief DMA I2S transmit process half complete callback
mbed_official	375:3d36234a1087	1075	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1076	* the configuration information for the specified DMA module.
mbed_official	237:f3da66175598	1077	* @retval None
mbed_official	237:f3da66175598	1078	*/
mbed_official	237:f3da66175598	1079	static void I2S_DMATxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official	237:f3da66175598	1080	{
mbed_official	237:f3da66175598	1081	I2S_HandleTypeDef* hi2s = (I2S_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
mbed_official	237:f3da66175598	1082
mbed_official	237:f3da66175598	1083	HAL_I2S_TxHalfCpltCallback(hi2s);
mbed_official	237:f3da66175598	1084	}
mbed_official	237:f3da66175598	1085
mbed_official	237:f3da66175598	1086	/**
mbed_official	237:f3da66175598	1087	* @brief DMA I2S receive process complete callback
mbed_official	375:3d36234a1087	1088	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1089	* the configuration information for the specified DMA module.
mbed_official	237:f3da66175598	1090	* @retval None
mbed_official	237:f3da66175598	1091	*/
mbed_official	237:f3da66175598	1092	static void I2S_DMARxCplt(DMA_HandleTypeDef *hdma)
mbed_official	237:f3da66175598	1093	{
mbed_official	237:f3da66175598	1094	I2S_HandleTypeDef* hi2s = ( I2S_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official	237:f3da66175598	1095
mbed_official	237:f3da66175598	1096	/* Disable Rx DMA Request */
mbed_official	237:f3da66175598	1097	hi2s->Instance->CR2 &= (uint32_t)(~SPI_CR2_RXDMAEN);
mbed_official	237:f3da66175598	1098	hi2s->RxXferCount = 0;
mbed_official	237:f3da66175598	1099
mbed_official	237:f3da66175598	1100	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	1101	HAL_I2S_RxCpltCallback(hi2s);
mbed_official	237:f3da66175598	1102	}
mbed_official	237:f3da66175598	1103
mbed_official	237:f3da66175598	1104	/**
mbed_official	237:f3da66175598	1105	* @brief DMA I2S receive process half complete callback
mbed_official	375:3d36234a1087	1106	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1107	* the configuration information for the specified DMA module.
mbed_official	237:f3da66175598	1108	* @retval None
mbed_official	237:f3da66175598	1109	*/
mbed_official	237:f3da66175598	1110	static void I2S_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official	237:f3da66175598	1111	{
mbed_official	237:f3da66175598	1112	I2S_HandleTypeDef* hi2s = (I2S_HandleTypeDef)((DMA_HandleTypeDef)hdma)->Parent;
mbed_official	237:f3da66175598	1113
mbed_official	237:f3da66175598	1114	HAL_I2S_RxHalfCpltCallback(hi2s);
mbed_official	237:f3da66175598	1115	}
mbed_official	237:f3da66175598	1116
mbed_official	237:f3da66175598	1117	/**
mbed_official	237:f3da66175598	1118	* @brief DMA I2S communication error callback
mbed_official	375:3d36234a1087	1119	* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1120	* the configuration information for the specified DMA module.
mbed_official	237:f3da66175598	1121	* @retval None
mbed_official	237:f3da66175598	1122	*/
mbed_official	237:f3da66175598	1123	static void I2S_DMAError(DMA_HandleTypeDef *hdma)
mbed_official	237:f3da66175598	1124	{
mbed_official	237:f3da66175598	1125	I2S_HandleTypeDef* hi2s = ( I2S_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official	237:f3da66175598	1126
mbed_official	237:f3da66175598	1127	/* Disable Rx and Tx DMA Request */
mbed_official	237:f3da66175598	1128	hi2s->Instance->CR2 &= (uint32_t)(~(SPI_CR2_RXDMAEN \| SPI_CR2_TXDMAEN));
mbed_official	237:f3da66175598	1129	hi2s->TxXferCount = 0;
mbed_official	237:f3da66175598	1130	hi2s->RxXferCount = 0;
mbed_official	237:f3da66175598	1131
mbed_official	237:f3da66175598	1132	hi2s->State= HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	1133
mbed_official	237:f3da66175598	1134	/* Set the error code and execute error callback*/
mbed_official	237:f3da66175598	1135	hi2s->ErrorCode \|= HAL_I2S_ERROR_DMA;
mbed_official	237:f3da66175598	1136	HAL_I2S_ErrorCallback(hi2s);
mbed_official	237:f3da66175598	1137	}
mbed_official	237:f3da66175598	1138
mbed_official	237:f3da66175598	1139	/**
mbed_official	237:f3da66175598	1140	* @brief Transmit an amount of data in non-blocking mode with Interrupt
mbed_official	375:3d36234a1087	1141	* @param hi2s: pointer to a I2S_HandleTypeDef structure that contains
mbed_official	375:3d36234a1087	1142	* the configuration information for I2S module
mbed_official	237:f3da66175598	1143	* @retval None
mbed_official	237:f3da66175598	1144	*/
mbed_official	237:f3da66175598	1145	static void I2S_Transmit_IT(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	1146	{
mbed_official	237:f3da66175598	1147	/* Transmit data */
mbed_official	237:f3da66175598	1148	hi2s->Instance->DR = (*hi2s->pTxBuffPtr++);
mbed_official	237:f3da66175598	1149	hi2s->TxXferCount--;
mbed_official	237:f3da66175598	1150
mbed_official	237:f3da66175598	1151	if(hi2s->TxXferCount == 0)
mbed_official	237:f3da66175598	1152	{
mbed_official	237:f3da66175598	1153	/* Disable TXE and ERR interrupt */
mbed_official	237:f3da66175598	1154	__HAL_I2S_DISABLE_IT(hi2s, (I2S_IT_TXE \| I2S_IT_ERR));
mbed_official	375:3d36234a1087	1155
mbed_official	237:f3da66175598	1156	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	1157	HAL_I2S_TxCpltCallback(hi2s);
mbed_official	237:f3da66175598	1158	}
mbed_official	237:f3da66175598	1159	}
mbed_official	237:f3da66175598	1160
mbed_official	237:f3da66175598	1161	/**
mbed_official	237:f3da66175598	1162	* @brief Receive an amount of data in non-blocking mode with Interrupt
mbed_official	237:f3da66175598	1163	* @param hi2s: I2S handle
mbed_official	237:f3da66175598	1164	* @retval None
mbed_official	237:f3da66175598	1165	*/
mbed_official	237:f3da66175598	1166	static void I2S_Receive_IT(I2S_HandleTypeDef *hi2s)
mbed_official	237:f3da66175598	1167	{
mbed_official	237:f3da66175598	1168	/* Receive data */
mbed_official	237:f3da66175598	1169	(*hi2s->pRxBuffPtr++) = hi2s->Instance->DR;
mbed_official	237:f3da66175598	1170	hi2s->RxXferCount--;
mbed_official	237:f3da66175598	1171
mbed_official	237:f3da66175598	1172	if(hi2s->RxXferCount == 0)
mbed_official	237:f3da66175598	1173	{
mbed_official	237:f3da66175598	1174	/* Disable RXNE and ERR interrupt */
mbed_official	237:f3da66175598	1175	__HAL_I2S_DISABLE_IT(hi2s, (I2S_IT_RXNE \| I2S_IT_ERR));
mbed_official	375:3d36234a1087	1176
mbed_official	237:f3da66175598	1177	hi2s->State = HAL_I2S_STATE_READY;
mbed_official	237:f3da66175598	1178	HAL_I2S_RxCpltCallback(hi2s);
mbed_official	237:f3da66175598	1179	}
mbed_official	237:f3da66175598	1180	}
mbed_official	375:3d36234a1087	1181	/**
mbed_official	375:3d36234a1087	1182	* @}
mbed_official	375:3d36234a1087	1183	*/
mbed_official	237:f3da66175598	1184
mbed_official	375:3d36234a1087	1185	#endif /* STM32F302xE \|\| STM32F303xE \|\| STM32F398xx \|\| */
mbed_official	375:3d36234a1087	1186	/* STM32F302xC \|\| STM32F303xC \|\| STM32F358xx \|\| */
mbed_official	375:3d36234a1087	1187	/* STM32F301x8 \|\| STM32F302x8 \|\| STM32F318xx \|\| */
mbed_official	375:3d36234a1087	1188	/* STM32F373xC \|\| STM32F378xx */
mbed_official	237:f3da66175598	1189
mbed_official	237:f3da66175598	1190	#endif /* HAL_I2S_MODULE_ENABLED */
mbed_official	237:f3da66175598	1191	/**
mbed_official	237:f3da66175598	1192	* @}
mbed_official	237:f3da66175598	1193	*/
mbed_official	237:f3da66175598	1194
mbed_official	237:f3da66175598	1195	/**
mbed_official	237:f3da66175598	1196	* @}
mbed_official	237:f3da66175598	1197	*/
mbed_official	237:f3da66175598	1198
mbed_official	237:f3da66175598	1199	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	26 Nov 2015
Imports:	17
Forks:	0
Commits:	638
Dependents:	1
Dependencies:	0
Followers:	1

targets/cmsis/TARGET_STM/TARGET_STM32F3/stm32f3xx_hal_i2s.c@632:7687fb9c4f91, 2015-09-28 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning