PHung Tung / SRC_STM32F7

SPKT

Dependents:   WAV

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_sai_ex.c@0:e87aa4c49e95, 2019-06-04 (annotated)

Committer:
phungductung
Date:
Tue Jun 04 21:51:46 2019 +0000
Revision:
0:e87aa4c49e95
libray

Who changed what in which revision?

UserRevisionLine numberNew contents of line
phungductung 0:e87aa4c49e95 1 /**
phungductung 0:e87aa4c49e95 2 ******************************************************************************
phungductung 0:e87aa4c49e95 3 * @file stm32f7xx_hal_sai_ex.c
phungductung 0:e87aa4c49e95 4 * @author MCD Application Team
phungductung 0:e87aa4c49e95 5 * @version V1.0.4
phungductung 0:e87aa4c49e95 6 * @date 09-December-2015
phungductung 0:e87aa4c49e95 7 * @brief SAI Extension HAL module driver.
phungductung 0:e87aa4c49e95 8 * This file provides firmware functions to manage the following
phungductung 0:e87aa4c49e95 9 * functionalities of SAI extension peripheral:
phungductung 0:e87aa4c49e95 10 * + Extension features functions
phungductung 0:e87aa4c49e95 11 *
phungductung 0:e87aa4c49e95 12 @verbatim
phungductung 0:e87aa4c49e95 13 ==============================================================================
phungductung 0:e87aa4c49e95 14 ##### SAI peripheral extension features #####
phungductung 0:e87aa4c49e95 15 ==============================================================================
phungductung 0:e87aa4c49e95 16
phungductung 0:e87aa4c49e95 17 ##### How to use this driver #####
phungductung 0:e87aa4c49e95 18 ==============================================================================
phungductung 0:e87aa4c49e95 19 [..] This driver provides functions to manage several sources to clock SAI
phungductung 0:e87aa4c49e95 20
phungductung 0:e87aa4c49e95 21 @endverbatim
phungductung 0:e87aa4c49e95 22 ******************************************************************************
phungductung 0:e87aa4c49e95 23 * @attention
phungductung 0:e87aa4c49e95 24 *
phungductung 0:e87aa4c49e95 25 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
phungductung 0:e87aa4c49e95 26 *
phungductung 0:e87aa4c49e95 27 * Redistribution and use in source and binary forms, with or without modification,
phungductung 0:e87aa4c49e95 28 * are permitted provided that the following conditions are met:
phungductung 0:e87aa4c49e95 29 * 1. Redistributions of source code must retain the above copyright notice,
phungductung 0:e87aa4c49e95 30 * this list of conditions and the following disclaimer.
phungductung 0:e87aa4c49e95 31 * 2. Redistributions in binary form must reproduce the above copyright notice,
phungductung 0:e87aa4c49e95 32 * this list of conditions and the following disclaimer in the documentation
phungductung 0:e87aa4c49e95 33 * and/or other materials provided with the distribution.
phungductung 0:e87aa4c49e95 34 * 3. Neither the name of STMicroelectronics nor the names of its contributors
phungductung 0:e87aa4c49e95 35 * may be used to endorse or promote products derived from this software
phungductung 0:e87aa4c49e95 36 * without specific prior written permission.
phungductung 0:e87aa4c49e95 37 *
phungductung 0:e87aa4c49e95 38 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
phungductung 0:e87aa4c49e95 39 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
phungductung 0:e87aa4c49e95 40 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
phungductung 0:e87aa4c49e95 41 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
phungductung 0:e87aa4c49e95 42 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
phungductung 0:e87aa4c49e95 43 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
phungductung 0:e87aa4c49e95 44 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
phungductung 0:e87aa4c49e95 45 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
phungductung 0:e87aa4c49e95 46 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
phungductung 0:e87aa4c49e95 47 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
phungductung 0:e87aa4c49e95 48 *
phungductung 0:e87aa4c49e95 49 ******************************************************************************
phungductung 0:e87aa4c49e95 50 */
phungductung 0:e87aa4c49e95 51
phungductung 0:e87aa4c49e95 52 /* Includes ------------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 53 #include "stm32f7xx_hal.h"
phungductung 0:e87aa4c49e95 54
phungductung 0:e87aa4c49e95 55 /** @addtogroup STM32F7xx_HAL_Driver
phungductung 0:e87aa4c49e95 56 * @{
phungductung 0:e87aa4c49e95 57 */
phungductung 0:e87aa4c49e95 58
phungductung 0:e87aa4c49e95 59 /** @defgroup SAIEx SAIEx
phungductung 0:e87aa4c49e95 60 * @brief SAI Extension HAL module driver
phungductung 0:e87aa4c49e95 61 * @{
phungductung 0:e87aa4c49e95 62 */
phungductung 0:e87aa4c49e95 63
phungductung 0:e87aa4c49e95 64 #ifdef HAL_SAI_MODULE_ENABLED
phungductung 0:e87aa4c49e95 65
phungductung 0:e87aa4c49e95 66 /* Private typedef -----------------------------------------------------------*/
phungductung 0:e87aa4c49e95 67 /* Private define ------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 68 /* SAI registers Masks */
phungductung 0:e87aa4c49e95 69 /* Private macro -------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 70 /* Private variables ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 71 /* Private function prototypes -----------------------------------------------*/
phungductung 0:e87aa4c49e95 72 /* Private functions ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 73
phungductung 0:e87aa4c49e95 74 /** @defgroup SAI_Private_Functions SAI Private Functions
phungductung 0:e87aa4c49e95 75 * @{
phungductung 0:e87aa4c49e95 76 */
phungductung 0:e87aa4c49e95 77 /**
phungductung 0:e87aa4c49e95 78 * @}
phungductung 0:e87aa4c49e95 79 */
phungductung 0:e87aa4c49e95 80
phungductung 0:e87aa4c49e95 81 /* Exported functions --------------------------------------------------------*/
phungductung 0:e87aa4c49e95 82 /** @defgroup SAIEx_Exported_Functions SAI Extended Exported Functions
phungductung 0:e87aa4c49e95 83 * @{
phungductung 0:e87aa4c49e95 84 */
phungductung 0:e87aa4c49e95 85
phungductung 0:e87aa4c49e95 86 /** @defgroup SAIEx_Exported_Functions_Group1 Extension features functions
phungductung 0:e87aa4c49e95 87 * @brief Extension features functions
phungductung 0:e87aa4c49e95 88 *
phungductung 0:e87aa4c49e95 89 @verbatim
phungductung 0:e87aa4c49e95 90 ===============================================================================
phungductung 0:e87aa4c49e95 91 ##### Extension features Functions #####
phungductung 0:e87aa4c49e95 92 ===============================================================================
phungductung 0:e87aa4c49e95 93 [..]
phungductung 0:e87aa4c49e95 94 This subsection provides a set of functions allowing to manage the possible
phungductung 0:e87aa4c49e95 95 SAI clock sources.
phungductung 0:e87aa4c49e95 96
phungductung 0:e87aa4c49e95 97 @endverbatim
phungductung 0:e87aa4c49e95 98 * @{
phungductung 0:e87aa4c49e95 99 */
phungductung 0:e87aa4c49e95 100
phungductung 0:e87aa4c49e95 101 /**
phungductung 0:e87aa4c49e95 102 * @brief Configure SAI Block synchronization mode
phungductung 0:e87aa4c49e95 103 * @param hsai: pointer to a SAI_HandleTypeDef structure that contains
phungductung 0:e87aa4c49e95 104 * the configuration information for SAI module.
phungductung 0:e87aa4c49e95 105 * @retval SAI Clock Input
phungductung 0:e87aa4c49e95 106 */
phungductung 0:e87aa4c49e95 107 void SAI_BlockSynchroConfig(SAI_HandleTypeDef *hsai)
phungductung 0:e87aa4c49e95 108 {
phungductung 0:e87aa4c49e95 109 uint32_t tmpregisterGCR = 0;
phungductung 0:e87aa4c49e95 110
phungductung 0:e87aa4c49e95 111 /* This setting must be done with both audio block (A & B) disabled */
phungductung 0:e87aa4c49e95 112 switch(hsai->Init.SynchroExt)
phungductung 0:e87aa4c49e95 113 {
phungductung 0:e87aa4c49e95 114 case SAI_SYNCEXT_DISABLE :
phungductung 0:e87aa4c49e95 115 tmpregisterGCR = 0;
phungductung 0:e87aa4c49e95 116 break;
phungductung 0:e87aa4c49e95 117 case SAI_SYNCEXT_OUTBLOCKA_ENABLE :
phungductung 0:e87aa4c49e95 118 tmpregisterGCR = SAI_GCR_SYNCOUT_0;
phungductung 0:e87aa4c49e95 119 break;
phungductung 0:e87aa4c49e95 120 case SAI_SYNCEXT_OUTBLOCKB_ENABLE :
phungductung 0:e87aa4c49e95 121 tmpregisterGCR = SAI_GCR_SYNCOUT_1;
phungductung 0:e87aa4c49e95 122 break;
phungductung 0:e87aa4c49e95 123 default:
phungductung 0:e87aa4c49e95 124 tmpregisterGCR = 0;
phungductung 0:e87aa4c49e95 125 break;
phungductung 0:e87aa4c49e95 126 }
phungductung 0:e87aa4c49e95 127
phungductung 0:e87aa4c49e95 128 if((hsai->Init.Synchro) == SAI_SYNCHRONOUS_EXT_SAI2)
phungductung 0:e87aa4c49e95 129 {
phungductung 0:e87aa4c49e95 130 tmpregisterGCR |= SAI_GCR_SYNCIN_0;
phungductung 0:e87aa4c49e95 131 }
phungductung 0:e87aa4c49e95 132
phungductung 0:e87aa4c49e95 133 if((hsai->Instance == SAI1_Block_A) || (hsai->Instance == SAI1_Block_B))
phungductung 0:e87aa4c49e95 134 {
phungductung 0:e87aa4c49e95 135 SAI1->GCR = tmpregisterGCR;
phungductung 0:e87aa4c49e95 136 }
phungductung 0:e87aa4c49e95 137 else
phungductung 0:e87aa4c49e95 138 {
phungductung 0:e87aa4c49e95 139 SAI2->GCR = tmpregisterGCR;
phungductung 0:e87aa4c49e95 140 }
phungductung 0:e87aa4c49e95 141 }
phungductung 0:e87aa4c49e95 142 /**
phungductung 0:e87aa4c49e95 143 * @brief Get SAI Input Clock based on SAI source clock selection
phungductung 0:e87aa4c49e95 144 * @param hsai: pointer to a SAI_HandleTypeDef structure that contains
phungductung 0:e87aa4c49e95 145 * the configuration information for SAI module.
phungductung 0:e87aa4c49e95 146 * @retval SAI Clock Input
phungductung 0:e87aa4c49e95 147 */
phungductung 0:e87aa4c49e95 148 uint32_t SAI_GetInputClock(SAI_HandleTypeDef *hsai)
phungductung 0:e87aa4c49e95 149 {
phungductung 0:e87aa4c49e95 150 /* This variable used to store the SAI_CK_x (value in Hz) */
phungductung 0:e87aa4c49e95 151 uint32_t saiclocksource = 0;
phungductung 0:e87aa4c49e95 152
phungductung 0:e87aa4c49e95 153 if ((hsai->Instance == SAI1_Block_A) || (hsai->Instance == SAI1_Block_B))
phungductung 0:e87aa4c49e95 154 {
phungductung 0:e87aa4c49e95 155 saiclocksource = HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_SAI1);
phungductung 0:e87aa4c49e95 156 }
phungductung 0:e87aa4c49e95 157 else /* SAI2_Block_A || SAI2_Block_B*/
phungductung 0:e87aa4c49e95 158 {
phungductung 0:e87aa4c49e95 159 saiclocksource = HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_SAI2);
phungductung 0:e87aa4c49e95 160 }
phungductung 0:e87aa4c49e95 161 /* the return result is the value of SAI clock */
phungductung 0:e87aa4c49e95 162 return saiclocksource;
phungductung 0:e87aa4c49e95 163 }
phungductung 0:e87aa4c49e95 164
phungductung 0:e87aa4c49e95 165 /**
phungductung 0:e87aa4c49e95 166 * @}
phungductung 0:e87aa4c49e95 167 */
phungductung 0:e87aa4c49e95 168
phungductung 0:e87aa4c49e95 169 /**
phungductung 0:e87aa4c49e95 170 * @}
phungductung 0:e87aa4c49e95 171 */
phungductung 0:e87aa4c49e95 172
phungductung 0:e87aa4c49e95 173 #endif /* HAL_SAI_MODULE_ENABLED */
phungductung 0:e87aa4c49e95 174 /**
phungductung 0:e87aa4c49e95 175 * @}
phungductung 0:e87aa4c49e95 176 */
phungductung 0:e87aa4c49e95 177
phungductung 0:e87aa4c49e95 178 /**
phungductung 0:e87aa4c49e95 179 * @}
phungductung 0:e87aa4c49e95 180 */
phungductung 0:e87aa4c49e95 181
phungductung 0:e87aa4c49e95 182 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/