STM32L486xx HAL User Manual
Functions
Channel operation functions
DFSDM Exported Functions

Channel operation functions. More...

Functions

HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to start clock absence detection in polling mode.
HAL_StatusTypeDef HAL_DFSDM_ChannelPollForCkab (DFSDM_Channel_HandleTypeDef *hdfsdm_channel, uint32_t Timeout)
 This function allows to poll for the clock absence detection.
HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to stop clock absence detection in polling mode.
HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart_IT (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to start clock absence detection in interrupt mode.
__weak void HAL_DFSDM_ChannelCkabCallback (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 Clock absence detection callback.
HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop_IT (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to stop clock absence detection in interrupt mode.
HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart (DFSDM_Channel_HandleTypeDef *hdfsdm_channel, uint32_t Threshold, uint32_t BreakSignal)
 This function allows to start short circuit detection in polling mode.
HAL_StatusTypeDef HAL_DFSDM_ChannelPollForScd (DFSDM_Channel_HandleTypeDef *hdfsdm_channel, uint32_t Timeout)
 This function allows to poll for the short circuit detection.
HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to stop short circuit detection in polling mode.
HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart_IT (DFSDM_Channel_HandleTypeDef *hdfsdm_channel, uint32_t Threshold, uint32_t BreakSignal)
 This function allows to start short circuit detection in interrupt mode.
__weak void HAL_DFSDM_ChannelScdCallback (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 Short circuit detection callback.
HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop_IT (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to stop short circuit detection in interrupt mode.
int16_t HAL_DFSDM_ChannelGetAwdValue (DFSDM_Channel_HandleTypeDef *hdfsdm_channel)
 This function allows to get channel analog watchdog value.
HAL_StatusTypeDef HAL_DFSDM_ChannelModifyOffset (DFSDM_Channel_HandleTypeDef *hdfsdm_channel, int32_t Offset)
 This function allows to modify channel offset value.

Detailed Description

Channel operation functions.

  ==============================================================================
                   ##### Channel operation functions #####
  ==============================================================================
    [..]  This section provides functions allowing to:
      (+) Manage clock absence detector feature.
      (+) Manage short circuit detector feature.
      (+) Get analog watchdog value.
      (+) Modify offset value.

Function Documentation

Clock absence detection callback.

Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
None

Definition at line 907 of file stm32l4xx_hal_dfsdm.c.

Referenced by HAL_DFSDM_Channel_UnRegisterCallback(), HAL_DFSDM_ChannelInit(), and HAL_DFSDM_IRQHandler().

HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to start clock absence detection in polling mode.

Note:
Same mode has to be used for all channels.
If clock is not available on this channel during 5 seconds, clock absence detection will not be activated and function will return HAL_TIMEOUT error.
Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 713 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_CKAB_TIMEOUT, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, HAL_GetTick(), __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart_IT ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to start clock absence detection in interrupt mode.

Note:
Same mode has to be used for all channels.
If clock is not available on this channel during 5 seconds, clock absence detection will not be activated and function will return HAL_TIMEOUT error.
Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 852 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_CKAB_TIMEOUT, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, HAL_GetTick(), __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to stop clock absence detection in polling mode.

Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 816 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop_IT ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to stop clock absence detection in interrupt mode.

Note:
Interrupt will be disabled for all channels
Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 923 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

This function allows to get channel analog watchdog value.

Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
Channelanalog watchdog value.

Definition at line 1177 of file stm32l4xx_hal_dfsdm.c.

References __DFSDM_Channel_HandleTypeDef::Instance.

HAL_StatusTypeDef HAL_DFSDM_ChannelModifyOffset ( DFSDM_Channel_HandleTypeDef hdfsdm_channel,
int32_t  Offset 
)

This function allows to modify channel offset value.

Parameters:
hdfsdm_channelDFSDM channel handle.
OffsetDFSDM channel offset. This parameter must be a number between Min_Data = -8388608 and Max_Data = 8388607.
Return values:
HALstatus.

Definition at line 1189 of file stm32l4xx_hal_dfsdm.c.

References assert_param, HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, IS_DFSDM_CHANNEL_OFFSET, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelPollForCkab ( DFSDM_Channel_HandleTypeDef hdfsdm_channel,
uint32_t  Timeout 
)

This function allows to poll for the clock absence detection.

Parameters:
hdfsdm_channelDFSDM channel handle.
TimeoutTimeout value in milliseconds.
Return values:
HALstatus

Definition at line 766 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, HAL_GetTick(), __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelPollForScd ( DFSDM_Channel_HandleTypeDef hdfsdm_channel,
uint32_t  Timeout 
)

This function allows to poll for the short circuit detection.

Parameters:
hdfsdm_channelDFSDM channel handle.
TimeoutTimeout value in milliseconds.
Return values:
HALstatus

Definition at line 1000 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, HAL_GetTick(), __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

Short circuit detection callback.

Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
None

Definition at line 1126 of file stm32l4xx_hal_dfsdm.c.

Referenced by HAL_DFSDM_Channel_UnRegisterCallback(), HAL_DFSDM_ChannelInit(), and HAL_DFSDM_IRQHandler().

HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart ( DFSDM_Channel_HandleTypeDef hdfsdm_channel,
uint32_t  Threshold,
uint32_t  BreakSignal 
)

This function allows to start short circuit detection in polling mode.

Note:
Same mode has to be used for all channels
Parameters:
hdfsdm_channelDFSDM channel handle.
ThresholdShort circuit detector threshold. This parameter must be a number between Min_Data = 0 and Max_Data = 255.
BreakSignalBreak signals assigned to short circuit event. This parameter can be a values combination of DFSDM break signals.
Return values:
HALstatus

Definition at line 963 of file stm32l4xx_hal_dfsdm.c.

References assert_param, HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, IS_DFSDM_BREAK_SIGNALS, IS_DFSDM_CHANNEL_SCD_THRESHOLD, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart_IT ( DFSDM_Channel_HandleTypeDef hdfsdm_channel,
uint32_t  Threshold,
uint32_t  BreakSignal 
)

This function allows to start short circuit detection in interrupt mode.

Note:
Same mode has to be used for all channels
Parameters:
hdfsdm_channelDFSDM channel handle.
ThresholdShort circuit detector threshold. This parameter must be a number between Min_Data = 0 and Max_Data = 255.
BreakSignalBreak signals assigned to short circuit event. This parameter can be a values combination of DFSDM break signals.
Return values:
HALstatus

Definition at line 1087 of file stm32l4xx_hal_dfsdm.c.

References assert_param, HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, IS_DFSDM_BREAK_SIGNALS, IS_DFSDM_CHANNEL_SCD_THRESHOLD, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to stop short circuit detection in polling mode.

Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 1050 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop_IT ( DFSDM_Channel_HandleTypeDef hdfsdm_channel)

This function allows to stop short circuit detection in interrupt mode.

Note:
Interrupt will be disabled for all channels
Parameters:
hdfsdm_channelDFSDM channel handle.
Return values:
HALstatus

Definition at line 1142 of file stm32l4xx_hal_dfsdm.c.

References assert_param, DFSDM_GetChannelFromInstance(), HAL_DFSDM_CHANNEL_STATE_READY, __DFSDM_Channel_HandleTypeDef::Instance, and __DFSDM_Channel_HandleTypeDef::State.