STM32F4 DISCOVERY AUDIO IN Exported Functions

Collaboration diagram for STM32F4 DISCOVERY AUDIO IN Exported Functions:

Functions
void	BSP_AUDIO_IN_ClockConfig (I2S_HandleTypeDef *hi2s, uint32_t AudioFreq, void *Params)
	Audio In Clock Config. 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...

Detailed Description

Function Documentation

BSP_AUDIO_IN_ClockConfig()

void BSP_AUDIO_IN_ClockConfig	(	I2S_HandleTypeDef *	hi2s,
		uint32_t	AudioFreq,
		void *	Params
	)

Audio In Clock Config.

Parameters

hi2s	I2S handle
AudioFreq	Audio frequency used to record the audio stream.
Params	: pointer on additional configuration parameters, can be NULL.

Note

This API is called by BSP_AUDIO_IN_Init() Being __weak it can be overwritten by the application

Definition at line 869 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Error_Callback()

void BSP_AUDIO_IN_Error_Callback

(

void

)

Audio IN Error callback function.

Definition at line 1021 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_HalfTransfer_CallBack()

void BSP_AUDIO_IN_HalfTransfer_CallBack

(

void

)

Manages the DMA Half Transfer complete event.

Return values

None

Definition at line 1011 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Init()

uint8_t BSP_AUDIO_IN_Init	(	uint32_t	AudioFreq,
		uint32_t	BitRes,
		uint32_t	ChnlNbr
	)

Initializes wave recording.

Parameters

AudioFreq	Audio frequency to be configured for the I2S peripheral.
BitRes	Audio frequency to be configured for the I2S peripheral.
ChnlNbr	Audio frequency to be configured for the I2S peripheral.

Return values

AUDIO_OK

if correct communication, else wrong communication

Parameters

AudioFreq	Audio frequency to be configured for the I2S peripheral.
BitRes	Audio Bit resolution.
ChnlNbr	Audio Channel number.

Return values

AUDIO_OK

if correct communication, else wrong communication

Note

This function assumes that the I2S input clock (through PLL_R in Devices RevA/Z and through dedicated PLLI2S_R in Devices RevB/Y) is already configured and ready to be used.

Parameters

AudioFreq	Audio frequency to be configured for the I2S peripheral.
BitRes	Audio frequency to be configured for the I2S peripheral.
ChnlNbr	Audio frequency to be configured for the I2S peripheral.

Return values

AUDIO_OK

if correct communication, else wrong communication

Initializes wave recording.

Parameters

AudioFreq	Audio frequency to be configured for the DFSDM peripheral.
BitRes	Audio frequency to be configured for the DFSDM peripheral.
ChnlNbr	Audio frequency to be configured for the DFSDM peripheral.

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 705 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_MspDeInit()

void BSP_AUDIO_IN_MspDeInit	(	I2S_HandleTypeDef *	hi2s,
		void *	Params
	)

DeInitializes BSP_AUDIO_IN MSP.

Parameters

hi2s	I2S handle
Params	: pointer on additional configuration parameters, can be NULL.

Definition at line 969 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_MspInit()

void BSP_AUDIO_IN_MspInit	(	I2S_HandleTypeDef *	hi2s,
		void *	Params
	)

BSP AUDIO IN MSP Init.

Parameters

hi2s	I2S handle
Params	: pointer on additional configuration parameters, can be NULL.

Definition at line 903 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Pause()

uint8_t BSP_AUDIO_IN_Pause

(

void

)

Pauses the audio file stream.

Return values

AUDIO_OK

if correct communication, else wrong communication

Pauses the audio file stream.

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 771 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_PDMToPCM()

uint8_t BSP_AUDIO_IN_PDMToPCM	(	uint16_t *	PDMBuf,
		uint16_t *	PCMBuf
	)

Converts audio format from PDM to PCM.

Parameters

PDMBuf	Pointer to data PDM buffer
PCMBuf	Pointer to data PCM buffer

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 814 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Record()

uint8_t BSP_AUDIO_IN_Record	(	uint16_t *	pbuf,
		uint32_t	size
	)

Starts audio recording.

Parameters

pbuf	Main buffer pointer for the recorded data storing
size	Current size of the recorded buffer

Return values

AUDIO_OK

if correct communication, else wrong communication

Parameters

pbuf	Main buffer pointer for the recorded data storing
size	Current size of the recorded buffer

Return values

AUDIO_OK

if correct communication, else wrong communication

Starts audio recording.

Parameters

pbuf	Main buffer pointer for the recorded data storing
size	Current size of the recorded buffer

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 737 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Resume()

uint8_t BSP_AUDIO_IN_Resume

(

void

)

Resumes the audio file stream.

Return values

AUDIO_OK

if correct communication, else wrong communication

Resumes the audio file stream.

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 784 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_SetVolume()

uint8_t BSP_AUDIO_IN_SetVolume

(

uint8_t

Volume

)

Controls the audio in volume level.

Parameters

Volume

Volume level to be set in percentage from 0% to 100% (0 for Mute and 100 for Max volume level).

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 799 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_Stop()

uint8_t BSP_AUDIO_IN_Stop

(

void

)

Stops audio recording.

Return values

AUDIO_OK

if correct communication, else wrong communication

Stops audio recording.

Return values

AUDIO_OK

if correct communication, else wrong communication

Definition at line 754 of file stm32f4_discovery_audio.c.

BSP_AUDIO_IN_TransferComplete_CallBack()

void BSP_AUDIO_IN_TransferComplete_CallBack

(

void

)

User callback when record buffer is filled.

Return values

None

Definition at line 1001 of file stm32f4_discovery_audio.c.