STM32F4xx HAL Documentation
Hardware Abstraction Layer for STM32F4 familiy
Loading...
Searching...
No Matches
SAI Exported Macros

macros to handle interrupts and specific configurations More...

Collaboration diagram for SAI Exported Macros:

Macros

#define __HAL_SAI_RESET_HANDLE_STATE(__HANDLE__)
 Reset SAI handle state.
 
#define __HAL_SAI_ENABLE_IT(__HANDLE__, __INTERRUPT__)
 Enable or disable the specified SAI interrupts.
 
#define __HAL_SAI_DISABLE_IT(__HANDLE__, __INTERRUPT__)
 
#define __HAL_SAI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)
 Check if the specified SAI interrupt source is enabled or disabled.
 
#define __HAL_SAI_GET_FLAG(__HANDLE__, __FLAG__)
 Check whether the specified SAI flag is set or not.
 
#define __HAL_SAI_CLEAR_FLAG(__HANDLE__, __FLAG__)
 Clear the specified SAI pending flag.
 
#define __HAL_SAI_ENABLE(__HANDLE__)
 Enable SAI.
 
#define __HAL_SAI_DISABLE(__HANDLE__)
 Disable SAI.
 

Detailed Description

macros to handle interrupts and specific configurations

Macro Definition Documentation

◆ __HAL_SAI_RESET_HANDLE_STATE

#define __HAL_SAI_RESET_HANDLE_STATE ( __HANDLE__)

#include <stm32f4xx_hal_sai.h>

Value:
((__HANDLE__)->State = HAL_SAI_STATE_RESET)
@ HAL_SAI_STATE_RESET

Reset SAI handle state.

Parameters
__HANDLE__specifies the SAI Handle.
Return values
None

Definition at line 597 of file stm32f4xx_hal_sai.h.

◆ __HAL_SAI_ENABLE_IT

#define __HAL_SAI_ENABLE_IT ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sai.h>

Value:
((__HANDLE__)->Instance->IMR |= (__INTERRUPT__))

Enable or disable the specified SAI interrupts.

Parameters
__HANDLE__specifies the SAI Handle.
__INTERRUPT__specifies the interrupt source to enable or disable. This parameter can be one of the following values:
  • SAI_IT_OVRUDR: Overrun underrun interrupt enable
  • SAI_IT_MUTEDET: Mute detection interrupt enable
  • SAI_IT_WCKCFG: Wrong Clock Configuration interrupt enable
  • SAI_IT_FREQ: FIFO request interrupt enable
  • SAI_IT_CNRDY: Codec not ready interrupt enable
  • SAI_IT_AFSDET: Anticipated frame synchronization detection interrupt enable
  • SAI_IT_LFSDET: Late frame synchronization detection interrupt enable
Return values
None

Definition at line 613 of file stm32f4xx_hal_sai.h.

Referenced by HAL_SAI_EnableRxMuteMode(), HAL_SAI_Receive_DMA(), HAL_SAI_Receive_IT(), HAL_SAI_Transmit_DMA(), and HAL_SAI_Transmit_IT().

◆ __HAL_SAI_DISABLE_IT

#define __HAL_SAI_DISABLE_IT ( __HANDLE__,
__INTERRUPT__ )

◆ __HAL_SAI_GET_IT_SOURCE

#define __HAL_SAI_GET_IT_SOURCE ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sai.h>

Value:
((((__HANDLE__)->Instance->IMR & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)

Check if the specified SAI interrupt source is enabled or disabled.

Parameters
__HANDLE__specifies the SAI Handle. This parameter can be SAI where x: 1, 2, or 3 to select the SAI peripheral.
__INTERRUPT__specifies the SAI interrupt source to check. This parameter can be one of the following values:
  • SAI_IT_OVRUDR: Overrun underrun interrupt enable
  • SAI_IT_MUTEDET: Mute detection interrupt enable
  • SAI_IT_WCKCFG: Wrong Clock Configuration interrupt enable
  • SAI_IT_FREQ: FIFO request interrupt enable
  • SAI_IT_CNRDY: Codec not ready interrupt enable
  • SAI_IT_AFSDET: Anticipated frame synchronization detection interrupt enable
  • SAI_IT_LFSDET: Late frame synchronization detection interrupt enable
Return values
Thenew state of INTERRUPT (TRUE or FALSE).

Definition at line 630 of file stm32f4xx_hal_sai.h.

◆ __HAL_SAI_GET_FLAG

#define __HAL_SAI_GET_FLAG ( __HANDLE__,
__FLAG__ )

#include <stm32f4xx_hal_sai.h>

Value:
((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__))

Check whether the specified SAI flag is set or not.

Parameters
__HANDLE__specifies the SAI Handle.
__FLAG__specifies the flag to check. This parameter can be one of the following values:
  • SAI_FLAG_OVRUDR: Overrun underrun flag.
  • SAI_FLAG_MUTEDET: Mute detection flag.
  • SAI_FLAG_WCKCFG: Wrong Clock Configuration flag.
  • SAI_FLAG_FREQ: FIFO request flag.
  • SAI_FLAG_CNRDY: Codec not ready flag.
  • SAI_FLAG_AFSDET: Anticipated frame synchronization detection flag.
  • SAI_FLAG_LFSDET: Late frame synchronization detection flag.
Return values
Thenew state of FLAG (TRUE or FALSE).

Definition at line 645 of file stm32f4xx_hal_sai.h.

◆ __HAL_SAI_CLEAR_FLAG

#define __HAL_SAI_CLEAR_FLAG ( __HANDLE__,
__FLAG__ )

#include <stm32f4xx_hal_sai.h>

Value:
((__HANDLE__)->Instance->CLRFR = (__FLAG__))

Clear the specified SAI pending flag.

Parameters
__HANDLE__specifies the SAI Handle.
__FLAG__specifies the flag to check. This parameter can be any combination of the following values:
  • SAI_FLAG_OVRUDR: Clear Overrun underrun
  • SAI_FLAG_MUTEDET: Clear Mute detection
  • SAI_FLAG_WCKCFG: Clear Wrong Clock Configuration
  • SAI_FLAG_FREQ: Clear FIFO request
  • SAI_FLAG_CNRDY: Clear Codec not ready
  • SAI_FLAG_AFSDET: Clear Anticipated frame synchronization detection
  • SAI_FLAG_LFSDET: Clear Late frame synchronization detection
Return values
None

Definition at line 660 of file stm32f4xx_hal_sai.h.

Referenced by HAL_SAI_IRQHandler(), SAI_Receive_IT16Bit(), SAI_Receive_IT32Bit(), and SAI_Receive_IT8Bit().

◆ __HAL_SAI_ENABLE

#define __HAL_SAI_ENABLE ( __HANDLE__)

#include <stm32f4xx_hal_sai.h>

Value:
((__HANDLE__)->Instance->CR1 |= SAI_xCR1_SAIEN)

Enable SAI.

Parameters
__HANDLE__specifies the SAI Handle.
Return values
None

Definition at line 666 of file stm32f4xx_hal_sai.h.

Referenced by HAL_SAI_DMAResume(), HAL_SAI_Receive(), HAL_SAI_Receive_DMA(), HAL_SAI_Receive_IT(), HAL_SAI_Transmit(), HAL_SAI_Transmit_DMA(), and HAL_SAI_Transmit_IT().

◆ __HAL_SAI_DISABLE

#define __HAL_SAI_DISABLE ( __HANDLE__)

#include <stm32f4xx_hal_sai.h>

Value:
((__HANDLE__)->Instance->CR1 &= ~SAI_xCR1_SAIEN)

Disable SAI.

Parameters
__HANDLE__specifies the SAI Handle.
Return values
None

Definition at line 672 of file stm32f4xx_hal_sai.h.

Referenced by SAI_Disable().