STM3210C_EVAL BSP User Manual: stm3210c_eval_audio.h Source File

STM3210C EVAL BSP Drivers

stm3210c_eval_audio.h
Go to the documentation of this file.
00001 /**
00002   ******************************************************************************
00003   * @file    stm3210c_eval_audio.h
00004   * @author  MCD Application Team
00005   * @version V6.0.1
00006   * @date    18-December-2015
00007   * @brief   This file contains the common defines and functions prototypes for
00008   *          stm3210c_eval_audio.c driver.
00009   ******************************************************************************
00010   * @attention
00011   *
00012   * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
00013   *
00014   * Redistribution and use in source and binary forms, with or without modification,
00015   * are permitted provided that the following conditions are met:
00016   *   1. Redistributions of source code must retain the above copyright notice,
00017   *      this list of conditions and the following disclaimer.
00018   *   2. Redistributions in binary form must reproduce the above copyright notice,
00019   *      this list of conditions and the following disclaimer in the documentation
00020   *      and/or other materials provided with the distribution.
00021   *   3. Neither the name of STMicroelectronics nor the names of its contributors
00022   *      may be used to endorse or promote products derived from this software
00023   *      without specific prior written permission.
00024   *
00025   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00026   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00027   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00028   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
00029   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00030   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
00031   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00032   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00033   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
00034   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00035   *
00036   ******************************************************************************
00037   */ 
00038 
00039 /* Define to prevent recursive inclusion -------------------------------------*/
00040 #ifndef __STM3210C_EVAL_AUDIO_H
00041 #define __STM3210C_EVAL_AUDIO_H
00042 
00043 #ifdef __cplusplus
00044  extern "C" {
00045 #endif 
00046 
00047 /* Includes ------------------------------------------------------------------*/
00048 /* Include audio component Driver */
00049 #include "../Components/cs43l22/cs43l22.h"
00050 #include "stm3210c_eval.h"
00051 
00052 /** @addtogroup BSP
00053   * @{
00054   */
00055 
00056 /** @addtogroup STM3210C_EVAL
00057   * @{
00058   */
00059     
00060 /** @addtogroup STM3210C_EVAL_AUDIO
00061   * @{
00062   */    
00063 
00064 
00065 /** @defgroup STM3210C_EVAL_AUDIO_Exported_Types AUDIO_Exported_Types 
00066   * @{
00067   */
00068 
00069 /**
00070   * @}
00071   */ 
00072 
00073 /** @defgroup STM3210C_EVAL_AUDIO_OUT_Exported_Constants AUDIO_OUT_Exported_Constants 
00074   * @{
00075   */ 
00076 
00077 
00078 /*------------------------------------------------------------------------------
00079              AUDIO OUT CONFIGURATION
00080 ------------------------------------------------------------------------------*/
00081 
00082 /* I2S peripheral configuration defines */
00083 #define I2SOUT                          SPI2
00084 #define I2SOUT_CLK_ENABLE()             __HAL_RCC_SPI2_CLK_ENABLE()
00085 #define I2SOUT_SCK_SD_CLK_ENABLE()      __HAL_RCC_GPIOB_CLK_ENABLE()
00086 #define I2SOUT_MCK_CLK_ENABLE()         __HAL_RCC_GPIOC_CLK_ENABLE()
00087 #define I2SOUT_WS_CLK_ENABLE()          __HAL_RCC_GPIOB_CLK_ENABLE()
00088 #define I2SOUT_WS_PIN                   GPIO_PIN_12             /* PB.12*/
00089 #define I2SOUT_SCK_PIN                  GPIO_PIN_13             /* PB.13*/
00090 #define I2SOUT_SD_PIN                   GPIO_PIN_15             /* PB.15*/
00091 #define I2SOUT_MCK_PIN                  GPIO_PIN_6              /* PC.06*/
00092 #define I2SOUT_SCK_SD_GPIO_PORT         GPIOB
00093 #define I2SOUT_WS_GPIO_PORT             GPIOB
00094 #define I2SOUT_MCK_GPIO_PORT            GPIOC
00095 
00096 /* I2S DMA Channel definitions */
00097 #define I2SOUT_DMAx_CLK_ENABLE()        __HAL_RCC_DMA1_CLK_ENABLE()
00098 #define I2SOUT_DMAx_CHANNEL             DMA1_Channel5
00099 #define I2SOUT_DMAx_IRQ                 DMA1_Channel5_IRQn
00100 #define I2SOUT_DMAx_PERIPH_DATA_SIZE    DMA_PDATAALIGN_HALFWORD
00101 #define I2SOUT_DMAx_MEM_DATA_SIZE       DMA_MDATAALIGN_HALFWORD
00102 #define DMA_MAX_SZE                     0xFFFF
00103 
00104 #define I2SOUT_IRQHandler               DMA1_Channel5_IRQHandler
00105 
00106 /* Select the interrupt preemption priority and subpriority for the DMA interrupt */
00107 #define AUDIO_OUT_IRQ_PREPRIO         5   /* Select the preemption priority level(0 is the highest) */
00108 
00109 /*------------------------------------------------------------------------------
00110              CONFIGURATION: Audio Driver Configuration parameters
00111 ------------------------------------------------------------------------------*/
00112 
00113 /* Audio status definition */     
00114 #define AUDIO_OK                              0
00115 #define AUDIO_ERROR                           1
00116 #define AUDIO_TIMEOUT                         2
00117 
00118 /* PDM buffer input size */
00119 #define INTERNAL_BUFF_SIZE                    128*DEFAULT_AUDIO_IN_FREQ/16000*DEFAULT_AUDIO_IN_CHANNEL_NBR
00120    
00121 /*------------------------------------------------------------------------------
00122                     OPTIONAL Configuration defines parameters
00123 ------------------------------------------------------------------------------*/
00124 
00125 
00126 /**
00127   * @}
00128   */ 
00129 
00130 /** @defgroup STM3210C_EVAL_AUDIO_Exported_Macros AUDIO_Exported_Macros
00131   * @{
00132   */
00133 #define DMA_MAX(_X_)                (((_X_) <= DMA_MAX_SZE)? (_X_):DMA_MAX_SZE)
00134 
00135 /**
00136   * @}
00137   */
00138 
00139 /** @addtogroup STM3210C_EVAL_AUDIO_OUT_Exported_Functions 
00140   * @{
00141   */ 
00142 uint8_t BSP_AUDIO_OUT_Init(uint16_t OutputDevice, uint8_t Volume, uint32_t AudioFreq);
00143 uint8_t BSP_AUDIO_OUT_Play(uint16_t* pBuffer, uint32_t Size);
00144 void    BSP_AUDIO_OUT_ChangeBuffer(uint16_t *pData, uint16_t Size);
00145 uint8_t BSP_AUDIO_OUT_Pause(void);
00146 uint8_t BSP_AUDIO_OUT_Resume(void);
00147 uint8_t BSP_AUDIO_OUT_Stop(uint32_t Option);
00148 uint8_t BSP_AUDIO_OUT_SetVolume(uint8_t Volume);
00149 void    BSP_AUDIO_OUT_SetFrequency(uint32_t AudioFreq);
00150 uint8_t BSP_AUDIO_OUT_SetMute(uint32_t Command);
00151 uint8_t BSP_AUDIO_OUT_SetOutputMode(uint8_t Output);
00152 
00153 /* User Callbacks: user has to implement these functions in his code if they are needed. */
00154 /* This function is called when the requested data has been completely transferred.*/
00155 void    BSP_AUDIO_OUT_TransferComplete_CallBack(void);
00156 
00157 /* This function is called when half of the requested buffer has been transferred. */
00158 void    BSP_AUDIO_OUT_HalfTransfer_CallBack(void);
00159 
00160 /* This function is called when an Interrupt due to transfer error on or peripheral
00161    error occurs. */
00162 void    BSP_AUDIO_OUT_Error_CallBack(void);
00163 
00164 /**
00165   * @}
00166   */
00167 
00168 
00169 
00170 /**
00171   * @}
00172   */ 
00173 
00174 /**
00175   * @}
00176   */
00177 
00178 /**
00179   * @}
00180   */ 
00181 
00182 #ifdef __cplusplus
00183 }
00184 #endif
00185    
00186 #endif /* __STM3210C_EVAL_AUDIO_H */
00187 
00188 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Generated on Thu Dec 10 2015 17:13:52 for STM3210C_EVAL BSP User Manual by   doxygen 1.7.6.1