test / mbed_in_china

来自中国的硬件平台

Dependents:   mbed_in_china_blink_led

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_DISCO_F407VG/stm32f4xx_hal_sai.c@133:d4dda5c437f0, 2014-03-24 (annotated)

Committer:
mbed_official
Date:
Mon Mar 24 17:45:07 2014 +0000
Revision:
133:d4dda5c437f0
Synchronized with git revision 47b961246bed973fe4cb8932781ffc8025b78a61



Full URL: https://github.com/mbedmicro/mbed/commit/47b961246bed973fe4cb8932781ffc8025b78a61/



[STM32F4-Discovery (STM32F407VG)] initial port

Who changed what in which revision?

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