stm32469i_discovery_audio.h File Reference

This file contains the common defines and functions prototypes for the stm32469i_discovery_audio.c driver. More...

#include <stdlib.h>
#include "../Components/cs43l22/cs43l22.h"
#include "stm32469i_discovery.h"
#include "../../../Middlewares/ST/STM32_Audio/Addons/PDM/Inc/pdm2pcm_glo.h"

Include dependency graph for stm32469i_discovery_audio.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	AUDIO_ERROR   ((uint8_t)1)
#define	AUDIO_I2Sx   SPI3
#define	AUDIO_I2Sx_CLK_DISABLE()   __HAL_RCC_SPI3_CLK_DISABLE()
#define	AUDIO_I2Sx_CLK_ENABLE()   __HAL_RCC_SPI3_CLK_ENABLE()
#define	AUDIO_I2Sx_DMAx_CHANNEL   DMA_CHANNEL_0
#define	AUDIO_I2Sx_DMAx_CLK_DISABLE()   __HAL_RCC_DMA1_CLK_DISABLE()
#define	AUDIO_I2Sx_DMAx_CLK_ENABLE()   __HAL_RCC_DMA1_CLK_ENABLE()
#define	AUDIO_I2Sx_DMAx_IRQ   DMA1_Stream2_IRQn
#define	AUDIO_I2Sx_DMAx_IRQHandler   DMA1_Stream2_IRQHandler
#define	AUDIO_I2Sx_DMAx_MEM_DATA_SIZE   DMA_MDATAALIGN_HALFWORD
#define	AUDIO_I2Sx_DMAx_PERIPH_DATA_SIZE   DMA_PDATAALIGN_HALFWORD
#define	AUDIO_I2Sx_DMAx_STREAM   DMA1_Stream2
#define	AUDIO_I2Sx_SCK_AF   GPIO_AF6_SPI3
#define	AUDIO_I2Sx_SCK_GPIO_CLK_DISABLE()   __HAL_RCC_GPIOB_CLK_DISABLE()
#define	AUDIO_I2Sx_SCK_GPIO_CLK_ENABLE()   __HAL_RCC_GPIOB_CLK_ENABLE()
#define	AUDIO_I2Sx_SCK_GPIO_PORT   GPIOB
#define	AUDIO_I2Sx_SCK_PIN   GPIO_PIN_3
#define	AUDIO_I2Sx_SD_AF   GPIO_AF5_I2S3ext
#define	AUDIO_I2Sx_SD_GPIO_CLK_DISABLE()   __HAL_RCC_GPIOD_CLK_DISABLE()
#define	AUDIO_I2Sx_SD_GPIO_CLK_ENABLE()   __HAL_RCC_GPIOD_CLK_ENABLE()
#define	AUDIO_I2Sx_SD_GPIO_PORT   GPIOD
#define	AUDIO_I2Sx_SD_PIN   GPIO_PIN_6
#define	AUDIO_IN_IRQ_PREPRIO   ((uint32_t)6) /* Select the preemption priority level(0 is the highest) */
#define	AUDIO_OK   ((uint8_t)0)
#define	AUDIO_OUT_IRQ_PREPRIO   5 /* Select the preemption priority level(0 is the highest) */
#define	AUDIO_RESET_DISABLE()   __HAL_RCC_GPIOE_CLK_DISABLE()
#define	AUDIO_RESET_ENABLE()   __HAL_RCC_GPIOE_CLK_ENABLE()
#define	AUDIO_RESET_GPIO_PORT   GPIOE
#define	AUDIO_RESET_PIN   GPIO_PIN_2
#define	AUDIO_SAIx   SAI1_Block_A
#define	AUDIO_SAIx_CLK_DISABLE()   __HAL_RCC_SAI1_CLK_DISABLE()
#define	AUDIO_SAIx_CLK_ENABLE()   __HAL_RCC_SAI1_CLK_ENABLE()
#define	AUDIO_SAIx_DMAx_CHANNEL   DMA_CHANNEL_0
#define	AUDIO_SAIx_DMAx_CLK_DISABLE()   __HAL_RCC_DMA2_CLK_DISABLE()
#define	AUDIO_SAIx_DMAx_CLK_ENABLE()   __HAL_RCC_DMA2_CLK_ENABLE()
#define	AUDIO_SAIx_DMAx_IRQ   DMA2_Stream3_IRQn
#define	AUDIO_SAIx_DMAx_IRQHandler   DMA2_Stream3_IRQHandler
#define	AUDIO_SAIx_DMAx_MEM_DATA_SIZE   DMA_MDATAALIGN_HALFWORD
#define	AUDIO_SAIx_DMAx_PERIPH_DATA_SIZE   DMA_PDATAALIGN_HALFWORD
#define	AUDIO_SAIx_DMAx_STREAM   DMA2_Stream3
#define	AUDIO_SAIx_FS_PIN   GPIO_PIN_4
#define	AUDIO_SAIx_MCK_PIN   GPIO_PIN_7
#define	AUDIO_SAIx_MCLK_DISABLE()   __HAL_RCC_GPIOG_CLK_DISABLE()
#define	AUDIO_SAIx_MCLK_ENABLE()   __HAL_RCC_GPIOG_CLK_ENABLE()
#define	AUDIO_SAIx_MCLK_GPIO_PORT   GPIOG
#define	AUDIO_SAIx_MCLK_SCK_SD_FS_AF   GPIO_AF6_SAI1
#define	AUDIO_SAIx_PLL_DISABLE()   HAL_RCCEx_DisablePLLSAI1()
#define	AUDIO_SAIx_SCK_PIN   GPIO_PIN_5
#define	AUDIO_SAIx_SCK_SD_FS_DISABLE()   __HAL_RCC_GPIOE_CLK_DISABLE()
#define	AUDIO_SAIx_SCK_SD_FS_ENABLE()   __HAL_RCC_GPIOE_CLK_ENABLE()
#define	AUDIO_SAIx_SCK_SD_FS_GPIO_PORT   GPIOE
#define	AUDIO_SAIx_SD_PIN   GPIO_PIN_6
#define	AUDIO_TIMEOUT   ((uint8_t)2)
#define	AUDIO_TIMx   TIM4
#define	AUDIO_TIMx_AF   GPIO_AF2_TIM4
#define	AUDIO_TIMx_CLK_DISABLE()   __HAL_RCC_TIM4_CLK_DISABLE()
#define	AUDIO_TIMx_CLK_ENABLE()   __HAL_RCC_TIM4_CLK_ENABLE()
#define	AUDIO_TIMx_GPIO_CLK_DISABLE()   __HAL_RCC_GPIOD_CLK_DISABLE()
#define	AUDIO_TIMx_GPIO_CLK_ENABLE()   __HAL_RCC_GPIOD_CLK_ENABLE()
#define	AUDIO_TIMx_GPIO_PORT   GPIOD
#define	AUDIO_TIMx_IN_CHANNEL   TIM_CHANNEL_1
#define	AUDIO_TIMx_IN_GPIO_PIN   GPIO_PIN_12
#define	AUDIO_TIMx_OUT_CHANNEL   TIM_CHANNEL_2 /* Select channel 2 as output */
#define	AUDIO_TIMx_OUT_GPIO_PIN   GPIO_PIN_13
#define	AUDIODATA_SIZE   2 /* 16-bits audio data size */
#define	BSP_AUDIO_OUT_CIRCULARMODE   ((uint32_t)0x00000001) /* BUFFER CIRCULAR MODE */
#define	BSP_AUDIO_OUT_MONOMODE   ((uint32_t)0x00000008) /* MONO MODE */
#define	BSP_AUDIO_OUT_NORMALMODE   ((uint32_t)0x00000002) /* BUFFER NORMAL MODE */
#define	BSP_AUDIO_OUT_STEREOMODE   ((uint32_t)0x00000004) /* STEREO MODE */
#define	CHANNEL_DEMUX_MASK   ((uint8_t)0x55)
#define	CODEC_AUDIOFRAME_SLOT_0123   SAI_SLOTACTIVE_0 | SAI_SLOTACTIVE_1 | SAI_SLOTACTIVE_2 | SAI_SLOTACTIVE_3
#define	CODEC_AUDIOFRAME_SLOT_02   SAI_SLOTACTIVE_0 | SAI_SLOTACTIVE_2
#define	CODEC_AUDIOFRAME_SLOT_13   SAI_SLOTACTIVE_1 | SAI_SLOTACTIVE_3
#define	CODEC_RESET_DELAY   ((uint8_t)5)
#define	DEFAULT_AUDIO_IN_BIT_RESOLUTION   ((uint8_t)16)
#define	DEFAULT_AUDIO_IN_CHANNEL_NBR   ((uint8_t)2) /* Mono = 1, Stereo = 2 */
#define	DEFAULT_AUDIO_IN_FREQ   I2S_AUDIOFREQ_16K
#define	DEFAULT_AUDIO_IN_VOLUME   ((uint16_t)64)
#define	DMA_MAX(x)   (((x) <= DMA_MAX_SZE)? (x):DMA_MAX_SZE)
#define	DMA_MAX_SZE   0xFFFF
#define	INTERNAL_BUFF_SIZE   (128*DEFAULT_AUDIO_IN_FREQ/16000*DEFAULT_AUDIO_IN_CHANNEL_NBR)
#define	PCM_OUT_SIZE   (DEFAULT_AUDIO_IN_FREQ/1000*DEFAULT_AUDIO_IN_CHANNEL_NBR)

Functions
void	BSP_AUDIO_IN_ClockConfig (I2S_HandleTypeDef *hi2s, void *Params)
	Clock Config. More...
void	BSP_AUDIO_IN_DeInit (void)
	Deinit the audio IN peripherals. More...
void	BSP_AUDIO_IN_Error_Callback (void)
	Audio IN Error callback function. More...
void	BSP_AUDIO_IN_HalfTransfer_CallBack (void)
	Manages the DMA Half Transfer complete event. More...
uint8_t	BSP_AUDIO_IN_Init (uint32_t AudioFreq, uint32_t BitRes, uint32_t ChnlNbr)
	Initializes wave recording. More...
void	BSP_AUDIO_IN_MspDeInit (I2S_HandleTypeDef *hi2s, void *Params)
	DeInitializes BSP_AUDIO_IN MSP. More...
void	BSP_AUDIO_IN_MspInit (I2S_HandleTypeDef *hi2s, void *Params)
	BSP AUDIO IN MSP Init. More...
uint8_t	BSP_AUDIO_IN_Pause (void)
	Pauses the audio file stream. More...
uint8_t	BSP_AUDIO_IN_PDMToPCM (uint16_t *PDMBuf, uint16_t *PCMBuf)
	Converts audio format from PDM to PCM. More...
uint8_t	BSP_AUDIO_IN_Record (uint16_t *pData, uint32_t Size)
	Starts audio recording. More...
uint8_t	BSP_AUDIO_IN_Resume (void)
	Resumes the audio file stream. More...
uint8_t	BSP_AUDIO_IN_SetVolume (uint8_t Volume)
	Controls the audio in volume level. More...
uint8_t	BSP_AUDIO_IN_Stop (void)
	Stops audio recording. More...
void	BSP_AUDIO_IN_TransferComplete_CallBack (void)
	User callback when record buffer is filled. More...
void	BSP_AUDIO_OUT_ChangeBuffer (uint16_t *pData, uint16_t Size)
	Sends n-Bytes on the I2S interface. More...
void	BSP_AUDIO_OUT_ClockConfig (SAI_HandleTypeDef *hsai, uint32_t AudioFreq, void *Params)
	Clock Config. More...
void	BSP_AUDIO_OUT_DeInit (void)
	Deinit the audio peripherals. More...
void	BSP_AUDIO_OUT_Error_CallBack (void)
	Manages the DMA FIFO error event. More...
void	BSP_AUDIO_OUT_HalfTransfer_CallBack (void)
	Manages the DMA Half Transfer complete event. More...
uint8_t	BSP_AUDIO_OUT_Init (uint16_t OutputDevice, uint8_t Volume, uint32_t AudioFreq)
	Configures the audio peripherals. More...
void	BSP_AUDIO_OUT_MspDeInit (SAI_HandleTypeDef *hsai, void *Params)
	Deinitializes BSP_AUDIO_OUT MSP. More...
void	BSP_AUDIO_OUT_MspInit (SAI_HandleTypeDef *hsai, void *Params)
	Initializes BSP_AUDIO_OUT MSP. More...
uint8_t	BSP_AUDIO_OUT_Pause (void)
	Pauses the audio file stream. In case of using DMA, the DMA Pause feature is used. WARNING: When calling BSP_AUDIO_OUT_Pause() function for pause, only the BSP_AUDIO_OUT_Resume() function should be called for resume (use of BSP_AUDIO_OUT_Play() function for resume could lead to unexpected behavior). More...
uint8_t	BSP_AUDIO_OUT_Play (uint16_t *pBuffer, uint32_t Size)
	Starts playing audio stream from a data buffer for a determined size. More...
uint8_t	BSP_AUDIO_OUT_Resume (void)
	Resumes the audio file streaming. WARNING: When calling BSP_AUDIO_OUT_Pause() function for pause, only BSP_AUDIO_OUT_Resume() function should be called for resume (use of BSP_AUDIO_OUT_Play() function for resume could lead to unexpected behavior). More...
void	BSP_AUDIO_OUT_SetAudioFrameSlot (uint32_t AudioFrameSlot)
	Updates the Audio frame slot configuration. More...
void	BSP_AUDIO_OUT_SetFrequency (uint32_t AudioFreq)
	Update the audio frequency. More...
uint8_t	BSP_AUDIO_OUT_SetMute (uint32_t Cmd)
	Enables or disables the MUTE mode by software. More...
uint8_t	BSP_AUDIO_OUT_SetOutputMode (uint8_t Output)
	Switch dynamically (while audio file is played) the output target (speaker or headphone). More...
uint8_t	BSP_AUDIO_OUT_SetVolume (uint8_t Volume)
	Controls the current audio volume level. More...
uint8_t	BSP_AUDIO_OUT_Stop (uint32_t Option)
	Stops audio playing and Power down the Audio Codec. More...
void	BSP_AUDIO_OUT_TransferComplete_CallBack (void)
	Manages the DMA full Transfer complete event. More...

Variables
__IO uint16_t	AudioInVolume

Detailed Description

This file contains the common defines and functions prototypes for the stm32469i_discovery_audio.c driver.

Author

MCD Application Team

Version

V2.0.0

Date

27-January-2017

Attention

© COPYRIGHT(c) 2017 STMicroelectronics

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Definition in file stm32469i_discovery_audio.h.