stm32f413h_discovery_audio.c File Reference

This file provides the Audio driver for the STM32F413H-DISCOVERY board. More...

#include "stm32f413h_discovery_audio.h"

Go to the source code of this file.

Defines
#define	DFSDM_OVER_SAMPLING(__FREQUENCY__)
#define	DFSDM_CLOCK_DIVIDER(__FREQUENCY__)
#define	DFSDM_FILTER_ORDER(__FREQUENCY__)
#define	DFSDM_MIC_BIT_SHIFT(__FREQUENCY__)
#define	SaturaLH(N, L, H)   (((N)<(L))?(L):(((N)>(H))?(H):(N)))
Functions
static void	I2Sx_In_Init (uint32_t AudioFreq)
	Initializes the Audio Codec audio interface (I2S)
static void	I2Sx_In_DeInit (void)
	Deinitializes the Audio Codec audio interface (I2S).
static void	I2Sx_In_MspInit (void)
	Initializes the I2S MSP.
static void	I2Sx_In_MspDeInit (void)
	De-Initializes the I2S MSP.
static void	I2Sx_Out_Init (uint32_t AudioFreq)
	Initializes the Audio Codec audio interface (I2S)
static void	I2Sx_Out_DeInit (void)
	Deinitializes the Audio Codec audio interface (I2S).
static uint8_t	DFSDMx_DeInit (void)
	De-initializes the Digital Filter for Sigma-Delta Modulators interface (DFSDM).
static void	DFSDMx_ChannelMspInit (void)
	Initializes the DFSDM channel MSP.
static void	DFSDMx_ChannelMspDeInit (void)
	DeInitializes the DFSDM channel MSP.
static void	DFSDMx_FilterMspInit (void)
	Initializes the DFSDM filter MSP.
static void	DFSDMx_FilterMspDeInit (void)
	DeInitializes the DFSDM filter MSP.
uint8_t	BSP_AUDIO_OUT_Init (uint16_t OutputDevice, uint8_t Volume, uint32_t AudioFreq)
	Configures the audio peripherals.
uint8_t	BSP_AUDIO_OUT_Play (uint16_t *pBuffer, uint32_t Size)
	Starts playing audio stream from a data buffer for a determined size.
void	BSP_AUDIO_OUT_ChangeBuffer (uint16_t *pData, uint16_t Size)
	Sends n-Bytes on the I2S interface.
uint8_t	BSP_AUDIO_OUT_Pause (void)
	This function Pauses the audio file stream.
uint8_t	BSP_AUDIO_OUT_Resume (void)
	This function Resumes the audio file stream.
uint8_t	BSP_AUDIO_OUT_Stop (uint32_t Option)
	Stops audio playing and Power down the Audio Codec.
uint8_t	BSP_AUDIO_OUT_SetVolume (uint8_t Volume)
	Controls the current audio volume level.
uint8_t	BSP_AUDIO_OUT_SetMute (uint32_t Cmd)
	Enables or disables the MUTE mode by software.
uint8_t	BSP_AUDIO_OUT_SetOutputMode (uint8_t Output)
	Switch dynamically (while audio file is played) the output target (speaker or headphone).
void	BSP_AUDIO_OUT_SetFrequency (uint32_t AudioFreq)
	Updates the audio frequency.
void	BSP_AUDIO_OUT_DeInit (void)
	Deinit the audio peripherals.
void	HAL_I2S_TxCpltCallback (I2S_HandleTypeDef *hi2s)
	Tx Transfer completed callbacks.
void	HAL_I2S_TxHalfCpltCallback (I2S_HandleTypeDef *hi2s)
	Tx Half Transfer completed callbacks.
void	HAL_I2S_ErrorCallback (I2S_HandleTypeDef *hi2s)
	I2S error callbacks.
__weak void	BSP_AUDIO_OUT_TransferComplete_CallBack (void)
	Manages the DMA full Transfer complete event.
__weak void	BSP_AUDIO_OUT_HalfTransfer_CallBack (void)
	Manages the DMA Half Transfer complete event.
__weak void	BSP_AUDIO_OUT_Error_CallBack (void)
	Manages the DMA FIFO error event.
__weak void	BSP_AUDIO_OUT_MspInit (I2S_HandleTypeDef *hi2s, void *Params)
	Initializes BSP_AUDIO_OUT MSP.
__weak void	BSP_AUDIO_OUT_MspDeInit (I2S_HandleTypeDef *hi2s, void *Params)
	Deinitializes I2S MSP.
__weak void	BSP_AUDIO_OUT_ClockConfig (I2S_HandleTypeDef *hi2s, uint32_t AudioFreq, void *Params)
	Clock Config.
uint8_t	BSP_AUDIO_IN_Init (uint32_t AudioFreq, uint32_t BitRes, uint32_t ChnlNbr)
	Initializes wave recording.
uint8_t	BSP_AUDIO_IN_InitEx (uint32_t InputDevice, uint32_t AudioFreq, uint32_t BitRes, uint32_t ChnlNbr)
	Initializes wave recording.
void	BSP_AUDIO_IN_DeInit (void)
	DeInitializes the audio peripheral.
uint8_t	BSP_AUDIO_IN_ConfigMicDefault (uint32_t InputDevice)
	Initializes default configuration of the Digital Filter for Sigma-Delta Modulators interface (DFSDM).
__weak uint8_t	BSP_AUDIO_IN_ConfigDigitalMic (uint32_t InputDevice, void *Params)
	Initializes the Digital Filter for Sigma-Delta Modulators interface (DFSDM).
uint8_t	BSP_AUDIO_IN_AllocScratch (int32_t *pScratch, uint32_t size)
	Allocate channel buffer scratch.
uint8_t	BSP_AUDIO_IN_Record (uint16_t *pBuf, uint32_t size)
	Starts audio recording.
uint8_t	BSP_AUDIO_IN_RecordEx (uint32_t *pBuf, uint32_t size)
	Starts audio recording.
__weak void	BSP_AUDIO_IN_MspInit (void *Params)
	Initializes BSP_AUDIO_IN MSP.
__weak void	BSP_AUDIO_IN_MspDeInit (void *Params)
	De-Initializes BSP_AUDIO_IN MSP.
__weak uint8_t	BSP_AUDIO_IN_ClockConfig (uint32_t AudioFreq, void *Params)
	Clock Config.
void	HAL_DFSDM_FilterRegConvCpltCallback (DFSDM_Filter_HandleTypeDef *hdfsdm_filter)
	Regular conversion complete callback.
void	HAL_DFSDM_FilterRegConvHalfCpltCallback (DFSDM_Filter_HandleTypeDef *hdfsdm_filter)
	Half regular conversion complete callback.
void	HAL_I2S_RxHalfCpltCallback (I2S_HandleTypeDef *hi2s)
	Half reception complete callback.
void	HAL_I2S_RxCpltCallback (I2S_HandleTypeDef *hi2s)
	Reception complete callback.
uint8_t	BSP_AUDIO_IN_Stop (void)
	Stops audio recording.
uint8_t	BSP_AUDIO_IN_StopEx (uint32_t InputDevice)
	Stops audio recording.
uint8_t	BSP_AUDIO_IN_Pause (void)
	Pauses the audio file stream.
uint8_t	BSP_AUDIO_IN_PauseEx (uint32_t InputDevice)
	Pauses the audio file stream.
uint8_t	BSP_AUDIO_IN_Resume (void)
	Resumes the audio file stream.
uint8_t	BSP_AUDIO_IN_ResumeEx (uint32_t *pBuf, uint32_t InputDevice)
	Resumes the audio file stream.
uint8_t	BSP_AUDIO_IN_SetVolume (uint8_t Volume)
	Controls the audio in volume level.
__weak void	BSP_AUDIO_IN_TransferComplete_CallBack (void)
	User callback when record buffer is filled.
__weak void	BSP_AUDIO_IN_HalfTransfer_CallBack (void)
	Manages the DMA Half Transfer complete event.
__weak void	BSP_AUDIO_IN_TransferComplete_CallBackEx (uint32_t InputDevice)
	User callback when record buffer is filled.
__weak void	BSP_AUDIO_IN_HalfTransfer_CallBackEx (uint32_t InputDevice)
	User callback when record buffer is filled.
__weak void	BSP_AUDIO_IN_Error_Callback (void)
	Audio IN Error callback function.
Variables
AUDIO_DrvTypeDef *	audio_drv
I2S_HandleTypeDef	haudio_i2s
I2S_HandleTypeDef	haudio_in_i2sext
AUDIOIN_ContextTypeDef	hAudioIn
DFSDM_Channel_HandleTypeDef	hAudioInDfsdmChannel [DFSDM_MIC_NUMBER]
DFSDM_Filter_HandleTypeDef	hAudioInDfsdmFilter [DFSDM_MIC_NUMBER]
DMA_HandleTypeDef	hDmaDfsdm [DFSDM_MIC_NUMBER]
int32_t *	pScratchBuff [DEFAULT_AUDIO_IN_CHANNEL_NBR]
int32_t	ScratchSize
uint32_t	DmaRecHalfBuffCplt [DFSDM_MIC_NUMBER] = {0}
uint32_t	DmaRecBuffCplt [DFSDM_MIC_NUMBER] = {0}
__IO uint32_t	AppBuffTrigger = 0
__IO uint32_t	AppBuffHalf = 0
__IO uint32_t	MicBuff [DFSDM_MIC_NUMBER] = {0}
__IO uint16_t	AudioInVolume = DEFAULT_AUDIO_IN_VOLUME

---

Detailed Description

This file provides the Audio driver for the STM32F413H-DISCOVERY board.

Author:

MCD Application Team

Version:

V1.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 stm32f413h_discovery_audio.c.