STM3210E_EVAL BSP User Manual: STM3210E EVAL AUDIO OUT Exported Functions

STM3210E_EVAL BSP

previous page next page
STM3210E_EVAL BSP User Manual
Functions
STM3210E EVAL AUDIO OUT Exported Functions
STM3210E EVAL AUDIO

Functions

uint8_t BSP_AUDIO_OUT_Init (uint16_t OutputDevice, uint8_t Volume, uint32_t AudioFreq)
 Configure the audio peripherals.
void BSP_AUDIO_OUT_DeInit (void)
 De-initialize 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)
 Update the audio frequency.
__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)
 De-Initializes BSP_AUDIO_OUT MSP.
void HAL_I2S_TxCpltCallback (I2S_HandleTypeDef *hi2s)
 Tx Transfer completed callbacks.
void HAL_I2S_TxHalfCpltCallback (I2S_HandleTypeDef *hi2s)
 Tx Transfer Half 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.
static void I2SOUT_Init (uint32_t AudioFreq)
 Initializes the Audio Codec audio interface (I2S)
static uint8_t I2SOUT_SendDummyData_Start (uint16_t *pBuffer, uint32_t Size)
 Starts sending dummy data as audio stream: function used to generate I2S master clock MCK for audio codec device.
static uint8_t I2SOUT_SendDummyData_Stop (void)
 Stops sending dummy data as audio stream: function used to stop to generate I2S master clock MCK for audio codec device.

Function Documentation

void BSP_AUDIO_OUT_ChangeBuffer ( uint16_t *  pData,
uint16_t  Size 
)

Sends n-Bytes on the I2S interface.

Parameters:
pData,:pointer on data address
Size,:number of data to be written

Definition at line 307 of file stm3210e_eval_audio.c.

References hAudioOutI2s.

void BSP_AUDIO_OUT_DeInit ( void  )

De-initialize the audio peripherals.

Definition at line 273 of file stm3210e_eval_audio.c.

References BSP_AUDIO_OUT_MspDeInit(), hAudioOutI2s, and I2SOUT_DeInit().

void BSP_AUDIO_OUT_Error_CallBack ( void  )

Manages the DMA FIFO error event.

Definition at line 627 of file stm3210e_eval_audio.c.

Referenced by HAL_I2S_ErrorCallback().

void BSP_AUDIO_OUT_HalfTransfer_CallBack ( void  )

Manages the DMA Half Transfer complete event.

Definition at line 620 of file stm3210e_eval_audio.c.

Referenced by HAL_I2S_TxHalfCpltCallback().

uint8_t BSP_AUDIO_OUT_Init ( uint16_t  OutputDevice,
uint8_t  Volume,
uint32_t  AudioFreq 
)

Configure the audio peripherals.

Parameters:
OutputDevice,:OUTPUT_DEVICE_SPEAKER, OUTPUT_DEVICE_HEADPHONE, OUTPUT_DEVICE_BOTH.
Volume,:Initial volume level (from 0 (Mute) to 100 (Max))
AudioFreq,:Audio frequency used to play the audio stream.
Return values:
0if correct communication, else wrong communication

Definition at line 197 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, audio_sample_SendDummyData, AUDIO_SAMPLE_SENDDUMMYDATA_SIZE, BSP_AUDIO_OUT_MspInit(), hAudioOutI2s, I2SOUT, I2SOUT_DeInit(), I2SOUT_Init(), I2SOUT_SendDummyData_Start(), I2SOUT_SendDummyData_Stop(), pAudioDrv, and SendDummyData.

void BSP_AUDIO_OUT_MspDeInit ( I2S_HandleTypeDef *  hi2s,
void *  Params 
)

De-Initializes BSP_AUDIO_OUT MSP.

Parameters:
hi2s,:I2S handle
Params

Definition at line 544 of file stm3210e_eval_audio.c.

References I2SOUT_CLK_DISABLE, I2SOUT_MCK_GPIO_PORT, I2SOUT_MCK_PIN, I2SOUT_SCK_PIN, I2SOUT_SCK_SD_GPIO_PORT, I2SOUT_SD_PIN, and I2SOUT_WS_PIN.

Referenced by BSP_AUDIO_OUT_DeInit().

void BSP_AUDIO_OUT_MspInit ( I2S_HandleTypeDef *  hi2s,
void *  Params 
)

Initializes BSP_AUDIO_OUT MSP.

Parameters:
hi2s,:I2S handle
Params

Definition at line 472 of file stm3210e_eval_audio.c.

References AUDIO_OUT_IRQ_PREPRIO, I2SOUT, I2SOUT_CLK_ENABLE, I2SOUT_DMAx_CHANNEL, I2SOUT_DMAx_CLK_ENABLE, I2SOUT_DMAx_IRQ, I2SOUT_DMAx_MEM_DATA_SIZE, I2SOUT_DMAx_PERIPH_DATA_SIZE, I2SOUT_MCK_CLK_ENABLE, I2SOUT_MCK_GPIO_PORT, I2SOUT_MCK_PIN, I2SOUT_SCK_PIN, I2SOUT_SCK_SD_CLK_ENABLE, I2SOUT_SCK_SD_GPIO_PORT, I2SOUT_SD_PIN, I2SOUT_WS_CLK_ENABLE, I2SOUT_WS_GPIO_PORT, I2SOUT_WS_PIN, and SendDummyData.

Referenced by BSP_AUDIO_OUT_Init().

uint8_t BSP_AUDIO_OUT_Pause ( void  )

This function Pauses the audio file stream.

In case of using DMA, the DMA Pause feature is used.

Note:
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).
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 320 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, hAudioOutI2s, and pAudioDrv.

uint8_t BSP_AUDIO_OUT_Play ( uint16_t *  pBuffer,
uint32_t  Size 
)

Starts playing audio stream from a data buffer for a determined size.

Parameters:
pBuffer,:Pointer to the buffer
Size,:Number of audio data BYTES.
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 286 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, DMA_MAX, hAudioOutI2s, and pAudioDrv.

uint8_t BSP_AUDIO_OUT_Resume ( void  )

This function Resumes the audio file stream.

Note:
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).
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 344 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, hAudioOutI2s, and pAudioDrv.

void BSP_AUDIO_OUT_SetFrequency ( uint32_t  AudioFreq)

Update the audio frequency.

Parameters:
AudioFreq,:Audio frequency used to play the audio stream.
Return values:
None
Note:
This API should be called after the BSP_AUDIO_OUT_Init() to adjust the audio frequency.

Definition at line 461 of file stm3210e_eval_audio.c.

References I2SOUT_Init().

uint8_t BSP_AUDIO_OUT_SetMute ( uint32_t  Cmd)

Enables or disables the MUTE mode by software.

Parameters:
Cmd,:could be AUDIO_MUTE_ON to mute sound or AUDIO_MUTE_OFF to unmute the codec and restore previous volume level.
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 419 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, and pAudioDrv.

uint8_t BSP_AUDIO_OUT_SetOutputMode ( uint8_t  Output)

Switch dynamically (while audio file is played) the output target (speaker or headphone).

Parameters:
Output,:specifies the audio output target: OUTPUT_DEVICE_SPEAKER, OUTPUT_DEVICE_HEADPHONE, OUTPUT_DEVICE_BOTH
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 440 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, and pAudioDrv.

uint8_t BSP_AUDIO_OUT_SetVolume ( uint8_t  Volume)

Controls the current audio 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_OKif correct communication, else wrong communication

Definition at line 399 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, and pAudioDrv.

uint8_t BSP_AUDIO_OUT_Stop ( uint32_t  Option)

Stops audio playing and Power down the Audio Codec.

Parameters:
Option,:could be one of the following parameters
  • CODEC_PDWN_HW: completely shut down the codec (physically). Then need to reconfigure the Codec after power on.
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 367 of file stm3210e_eval_audio.c.

References AUDIO_ERROR, AUDIO_I2C_ADDRESS, AUDIO_OK, AUDIO_RESET_GPIO, AUDIO_RESET_PIN, hAudioOutI2s, and pAudioDrv.

void BSP_AUDIO_OUT_TransferComplete_CallBack ( void  )

Manages the DMA full Transfer complete event.

Definition at line 613 of file stm3210e_eval_audio.c.

Referenced by HAL_I2S_TxCpltCallback().

void HAL_I2S_ErrorCallback ( I2S_HandleTypeDef *  hi2s)

I2S error callbacks.

Parameters:
hi2s,:I2S handle

Definition at line 600 of file stm3210e_eval_audio.c.

References BSP_AUDIO_OUT_Error_CallBack(), and I2SOUT.

void HAL_I2S_TxCpltCallback ( I2S_HandleTypeDef *  hi2s)

Tx Transfer completed callbacks.

Parameters:
hi2s,:I2S handle

Definition at line 564 of file stm3210e_eval_audio.c.

References BSP_AUDIO_OUT_TransferComplete_CallBack(), I2SOUT, and SendDummyData.

void HAL_I2S_TxHalfCpltCallback ( I2S_HandleTypeDef *  hi2s)

Tx Transfer Half completed callbacks.

Parameters:
hi2s,:I2S handle

Definition at line 586 of file stm3210e_eval_audio.c.

References BSP_AUDIO_OUT_HalfTransfer_CallBack(), and I2SOUT.

static void I2SOUT_Init ( uint32_t  AudioFreq) [static]

Initializes the Audio Codec audio interface (I2S)

Parameters:
AudioFreq,:Audio frequency to be configured for the I2S peripheral.

Definition at line 639 of file stm3210e_eval_audio.c.

References hAudioOutI2s, and I2SOUT.

Referenced by BSP_AUDIO_OUT_Init(), and BSP_AUDIO_OUT_SetFrequency().

static uint8_t I2SOUT_SendDummyData_Start ( uint16_t *  pBuffer,
uint32_t  Size 
) [static]

Starts sending dummy data as audio stream: function used to generate I2S master clock MCK for audio codec device.

Parameters:
pBuffer,:Pointer to the buffer
Size,:Number of audio data BYTES.
Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 681 of file stm3210e_eval_audio.c.

References AUDIO_OK, DMA_MAX, and hAudioOutI2s.

Referenced by BSP_AUDIO_OUT_Init().

static uint8_t I2SOUT_SendDummyData_Stop ( void  ) [static]

Stops sending dummy data as audio stream: function used to stop to generate I2S master clock MCK for audio codec device.

Return values:
AUDIO_OKif correct communication, else wrong communication

Definition at line 695 of file stm3210e_eval_audio.c.

References AUDIO_OK, and hAudioOutI2s.

Referenced by BSP_AUDIO_OUT_Init().

Generated on Fri Feb 24 2017 17:15:12 for STM3210E_EVAL BSP User Manual by   doxygen 1.7.6.1
previous page start next page