| /** |
| ****************************************************************************** |
| * @file stm32h7xx_hal_dfsdm.c |
| * @author MCD Application Team |
| * @brief This file provides firmware functions to manage the following |
| * functionalities of the Digital Filter for Sigma-Delta Modulators |
| * (DFSDM) peripherals: |
| * + Initialization and configuration of channels and filters |
| * + Regular channels configuration |
| * + Injected channels configuration |
| * + Regular/Injected Channels DMA Configuration |
| * + Interrupts and flags management |
| * + Analog watchdog feature |
| * + Short-circuit detector feature |
| * + Extremes detector feature |
| * + Clock absence detector feature |
| * + Break generation on analog watchdog or short-circuit event |
| * |
| ****************************************************************************** |
| * @attention |
| * |
| * Copyright (c) 2017 STMicroelectronics. |
| * All rights reserved. |
| * |
| * This software is licensed under terms that can be found in the LICENSE file |
| * in the root directory of this software component. |
| * If no LICENSE file comes with this software, it is provided AS-IS. |
| * |
| ****************************************************************************** |
| @verbatim |
| ============================================================================== |
| ##### How to use this driver ##### |
| ============================================================================== |
| [..] |
| *** Channel initialization *** |
| ============================== |
| [..] |
| (#) User has first to initialize channels (before filters initialization). |
| (#) As prerequisite, fill in the HAL_DFSDM_ChannelMspInit() : |
| (++) Enable DFSDMz clock interface with __HAL_RCC_DFSDMz_CLK_ENABLE(). |
| (++) Enable the clocks for the DFSDMz GPIOS with __HAL_RCC_GPIOx_CLK_ENABLE(). |
| (++) Configure these DFSDMz pins in alternate mode using HAL_GPIO_Init(). |
| (++) If interrupt mode is used, enable and configure DFSDMz_FLT0 global |
| interrupt with HAL_NVIC_SetPriority() and HAL_NVIC_EnableIRQ(). |
| (#) Configure the output clock, input, serial interface, analog watchdog, |
| offset and data right bit shift parameters for this channel using the |
| HAL_DFSDM_ChannelInit() function. |
| |
| *** Channel clock absence detector *** |
| ====================================== |
| [..] |
| (#) Start clock absence detector using HAL_DFSDM_ChannelCkabStart() or |
| HAL_DFSDM_ChannelCkabStart_IT(). |
| (#) In polling mode, use HAL_DFSDM_ChannelPollForCkab() to detect the clock |
| absence. |
| (#) In interrupt mode, HAL_DFSDM_ChannelCkabCallback() will be called if |
| clock absence is detected. |
| (#) Stop clock absence detector using HAL_DFSDM_ChannelCkabStop() or |
| HAL_DFSDM_ChannelCkabStop_IT(). |
| (#) Please note that the same mode (polling or interrupt) has to be used |
| for all channels because the channels are sharing the same interrupt. |
| (#) Please note also that in interrupt mode, if clock absence detector is |
| stopped for one channel, interrupt will be disabled for all channels. |
| |
| *** Channel short circuit detector *** |
| ====================================== |
| [..] |
| (#) Start short circuit detector using HAL_DFSDM_ChannelScdStart() or |
| or HAL_DFSDM_ChannelScdStart_IT(). |
| (#) In polling mode, use HAL_DFSDM_ChannelPollForScd() to detect short |
| circuit. |
| (#) In interrupt mode, HAL_DFSDM_ChannelScdCallback() will be called if |
| short circuit is detected. |
| (#) Stop short circuit detector using HAL_DFSDM_ChannelScdStop() or |
| or HAL_DFSDM_ChannelScdStop_IT(). |
| (#) Please note that the same mode (polling or interrupt) has to be used |
| for all channels because the channels are sharing the same interrupt. |
| (#) Please note also that in interrupt mode, if short circuit detector is |
| stopped for one channel, interrupt will be disabled for all channels. |
| |
| *** Channel analog watchdog value *** |
| ===================================== |
| [..] |
| (#) Get analog watchdog filter value of a channel using |
| HAL_DFSDM_ChannelGetAwdValue(). |
| |
| *** Channel offset value *** |
| ===================================== |
| [..] |
| (#) Modify offset value of a channel using HAL_DFSDM_ChannelModifyOffset(). |
| |
| *** Filter initialization *** |
| ============================= |
| [..] |
| (#) After channel initialization, user has to init filters. |
| (#) As prerequisite, fill in the HAL_DFSDM_FilterMspInit() : |
| (++) If interrupt mode is used , enable and configure DFSDMz_FLTx global |
| interrupt with HAL_NVIC_SetPriority() and HAL_NVIC_EnableIRQ(). |
| Please note that DFSDMz_FLT0 global interrupt could be already |
| enabled if interrupt is used for channel. |
| (++) If DMA mode is used, configure DMA with HAL_DMA_Init() and link it |
| with DFSDMz filter handle using __HAL_LINKDMA(). |
| (#) Configure the regular conversion, injected conversion and filter |
| parameters for this filter using the HAL_DFSDM_FilterInit() function. |
| |
| *** Filter regular channel conversion *** |
| ========================================= |
| [..] |
| (#) Select regular channel and enable/disable continuous mode using |
| HAL_DFSDM_FilterConfigRegChannel(). |
| (#) Start regular conversion using HAL_DFSDM_FilterRegularStart(), |
| HAL_DFSDM_FilterRegularStart_IT(), HAL_DFSDM_FilterRegularStart_DMA() or |
| HAL_DFSDM_FilterRegularMsbStart_DMA(). |
| (#) In polling mode, use HAL_DFSDM_FilterPollForRegConversion() to detect |
| the end of regular conversion. |
| (#) In interrupt mode, HAL_DFSDM_FilterRegConvCpltCallback() will be called |
| at the end of regular conversion. |
| (#) Get value of regular conversion and corresponding channel using |
| HAL_DFSDM_FilterGetRegularValue(). |
| (#) In DMA mode, HAL_DFSDM_FilterRegConvHalfCpltCallback() and |
| HAL_DFSDM_FilterRegConvCpltCallback() will be called respectively at the |
| half transfer and at the transfer complete. Please note that |
| HAL_DFSDM_FilterRegConvHalfCpltCallback() will be called only in DMA |
| circular mode. |
| (#) Stop regular conversion using HAL_DFSDM_FilterRegularStop(), |
| HAL_DFSDM_FilterRegularStop_IT() or HAL_DFSDM_FilterRegularStop_DMA(). |
| |
| *** Filter injected channels conversion *** |
| =========================================== |
| [..] |
| (#) Select injected channels using HAL_DFSDM_FilterConfigInjChannel(). |
| (#) Start injected conversion using HAL_DFSDM_FilterInjectedStart(), |
| HAL_DFSDM_FilterInjectedStart_IT(), HAL_DFSDM_FilterInjectedStart_DMA() or |
| HAL_DFSDM_FilterInjectedMsbStart_DMA(). |
| (#) In polling mode, use HAL_DFSDM_FilterPollForInjConversion() to detect |
| the end of injected conversion. |
| (#) In interrupt mode, HAL_DFSDM_FilterInjConvCpltCallback() will be called |
| at the end of injected conversion. |
| (#) Get value of injected conversion and corresponding channel using |
| HAL_DFSDM_FilterGetInjectedValue(). |
| (#) In DMA mode, HAL_DFSDM_FilterInjConvHalfCpltCallback() and |
| HAL_DFSDM_FilterInjConvCpltCallback() will be called respectively at the |
| half transfer and at the transfer complete. Please note that |
| HAL_DFSDM_FilterInjConvCpltCallback() will be called only in DMA |
| circular mode. |
| (#) Stop injected conversion using HAL_DFSDM_FilterInjectedStop(), |
| HAL_DFSDM_FilterInjectedStop_IT() or HAL_DFSDM_FilterInjectedStop_DMA(). |
| |
| *** Filter analog watchdog *** |
| ============================== |
| [..] |
| (#) Start filter analog watchdog using HAL_DFSDM_FilterAwdStart_IT(). |
| (#) HAL_DFSDM_FilterAwdCallback() will be called if analog watchdog occurs. |
| (#) Stop filter analog watchdog using HAL_DFSDM_FilterAwdStop_IT(). |
| |
| *** Filter extreme detector *** |
| =============================== |
| [..] |
| (#) Start filter extreme detector using HAL_DFSDM_FilterExdStart(). |
| (#) Get extreme detector maximum value using HAL_DFSDM_FilterGetExdMaxValue(). |
| (#) Get extreme detector minimum value using HAL_DFSDM_FilterGetExdMinValue(). |
| (#) Start filter extreme detector using HAL_DFSDM_FilterExdStop(). |
| |
| *** Filter conversion time *** |
| ============================== |
| [..] |
| (#) Get conversion time value using HAL_DFSDM_FilterGetConvTimeValue(). |
| |
| *** Callback registration *** |
| ============================= |
| [..] |
| The compilation define USE_HAL_DFSDM_REGISTER_CALLBACKS when set to 1 |
| allows the user to configure dynamically the driver callbacks. |
| Use functions HAL_DFSDM_Channel_RegisterCallback(), |
| HAL_DFSDM_Filter_RegisterCallback() or |
| HAL_DFSDM_Filter_RegisterAwdCallback() to register a user callback. |
| |
| [..] |
| Function HAL_DFSDM_Channel_RegisterCallback() allows to register |
| following callbacks: |
| (+) CkabCallback : DFSDM channel clock absence detection callback. |
| (+) ScdCallback : DFSDM channel short circuit detection callback. |
| (+) MspInitCallback : DFSDM channel MSP init callback. |
| (+) MspDeInitCallback : DFSDM channel MSP de-init callback. |
| [..] |
| This function takes as parameters the HAL peripheral handle, the Callback ID |
| and a pointer to the user callback function. |
| |
| [..] |
| Function HAL_DFSDM_Filter_RegisterCallback() allows to register |
| following callbacks: |
| (+) RegConvCpltCallback : DFSDM filter regular conversion complete callback. |
| (+) RegConvHalfCpltCallback : DFSDM filter half regular conversion complete callback. |
| (+) InjConvCpltCallback : DFSDM filter injected conversion complete callback. |
| (+) InjConvHalfCpltCallback : DFSDM filter half injected conversion complete callback. |
| (+) ErrorCallback : DFSDM filter error callback. |
| (+) MspInitCallback : DFSDM filter MSP init callback. |
| (+) MspDeInitCallback : DFSDM filter MSP de-init callback. |
| [..] |
| This function takes as parameters the HAL peripheral handle, the Callback ID |
| and a pointer to the user callback function. |
| |
| [..] |
| For specific DFSDM filter analog watchdog callback use dedicated register callback: |
| HAL_DFSDM_Filter_RegisterAwdCallback(). |
| |
| [..] |
| Use functions HAL_DFSDM_Channel_UnRegisterCallback() or |
| HAL_DFSDM_Filter_UnRegisterCallback() to reset a callback to the default |
| weak function. |
| |
| [..] |
| HAL_DFSDM_Channel_UnRegisterCallback() takes as parameters the HAL peripheral handle, |
| and the Callback ID. |
| [..] |
| This function allows to reset following callbacks: |
| (+) CkabCallback : DFSDM channel clock absence detection callback. |
| (+) ScdCallback : DFSDM channel short circuit detection callback. |
| (+) MspInitCallback : DFSDM channel MSP init callback. |
| (+) MspDeInitCallback : DFSDM channel MSP de-init callback. |
| |
| [..] |
| HAL_DFSDM_Filter_UnRegisterCallback() takes as parameters the HAL peripheral handle, |
| and the Callback ID. |
| [..] |
| This function allows to reset following callbacks: |
| (+) RegConvCpltCallback : DFSDM filter regular conversion complete callback. |
| (+) RegConvHalfCpltCallback : DFSDM filter half regular conversion complete callback. |
| (+) InjConvCpltCallback : DFSDM filter injected conversion complete callback. |
| (+) InjConvHalfCpltCallback : DFSDM filter half injected conversion complete callback. |
| (+) ErrorCallback : DFSDM filter error callback. |
| (+) MspInitCallback : DFSDM filter MSP init callback. |
| (+) MspDeInitCallback : DFSDM filter MSP de-init callback. |
| |
| [..] |
| For specific DFSDM filter analog watchdog callback use dedicated unregister callback: |
| HAL_DFSDM_Filter_UnRegisterAwdCallback(). |
| |
| [..] |
| By default, after the call of init function and if the state is RESET |
| all callbacks are reset to the corresponding legacy weak functions: |
| examples HAL_DFSDM_ChannelScdCallback(), HAL_DFSDM_FilterErrorCallback(). |
| Exception done for MspInit and MspDeInit callbacks that are respectively |
| reset to the legacy weak functions in the init and de-init only when these |
| callbacks are null (not registered beforehand). |
| If not, MspInit or MspDeInit are not null, the init and de-init keep and use |
| the user MspInit/MspDeInit callbacks (registered beforehand) |
| |
| [..] |
| Callbacks can be registered/unregistered in READY state only. |
| Exception done for MspInit/MspDeInit callbacks that can be registered/unregistered |
| in READY or RESET state, thus registered (user) MspInit/DeInit callbacks can be used |
| during the init/de-init. |
| In that case first register the MspInit/MspDeInit user callbacks using |
| HAL_DFSDM_Channel_RegisterCallback() or |
| HAL_DFSDM_Filter_RegisterCallback() before calling init or de-init function. |
| |
| [..] |
| When The compilation define USE_HAL_DFSDM_REGISTER_CALLBACKS is set to 0 or |
| not defined, the callback registering feature is not available |
| and weak callbacks are used. |
| |
| @endverbatim |
| ****************************************************************************** |
| */ |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32h7xx_hal.h" |
| |
| /** @addtogroup STM32H7xx_HAL_Driver |
| * @{ |
| */ |
| #ifdef HAL_DFSDM_MODULE_ENABLED |
| |
| /** @defgroup DFSDM DFSDM |
| * @brief DFSDM HAL driver module |
| * @{ |
| */ |
| |
| /* Private typedef -----------------------------------------------------------*/ |
| /* Private define ------------------------------------------------------------*/ |
| /** @defgroup DFSDM_Private_Define DFSDM Private Define |
| * @{ |
| */ |
| #define DFSDM_FLTCR1_MSB_RCH_OFFSET 8 |
| #define DFSDM_MSB_MASK 0xFFFF0000U |
| #define DFSDM_LSB_MASK 0x0000FFFFU |
| #define DFSDM_CKAB_TIMEOUT 5000U |
| #define DFSDM1_CHANNEL_NUMBER 8U |
| #if defined(DFSDM2_Channel0) |
| #define DFSDM2_CHANNEL_NUMBER 2U |
| #endif /* DFSDM2_Channel0 */ |
| /** |
| * @} |
| */ |
| |
| /* Private macro -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /** @defgroup DFSDM_Private_Variables DFSDM Private Variables |
| * @{ |
| */ |
| static __IO uint32_t v_dfsdm1ChannelCounter = 0; |
| static DFSDM_Channel_HandleTypeDef *a_dfsdm1ChannelHandle[DFSDM1_CHANNEL_NUMBER] = {NULL}; |
| #if defined(DFSDM2_Channel0) |
| static __IO uint32_t v_dfsdm2ChannelCounter = 0; |
| static DFSDM_Channel_HandleTypeDef *a_dfsdm2ChannelHandle[DFSDM2_CHANNEL_NUMBER] = {NULL}; |
| #endif /* DFSDM2_Channel0 */ |
| /** |
| * @} |
| */ |
| |
| /* Private function prototypes -----------------------------------------------*/ |
| /** @defgroup DFSDM_Private_Functions DFSDM Private Functions |
| * @{ |
| */ |
| static uint32_t DFSDM_GetInjChannelsNbr(uint32_t Channels); |
| static uint32_t DFSDM_GetChannelFromInstance(const DFSDM_Channel_TypeDef *Instance); |
| static void DFSDM_RegConvStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter); |
| static void DFSDM_RegConvStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter); |
| static void DFSDM_InjConvStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter); |
| static void DFSDM_InjConvStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter); |
| static void DFSDM_DMARegularHalfConvCplt(DMA_HandleTypeDef *hdma); |
| static void DFSDM_DMARegularConvCplt(DMA_HandleTypeDef *hdma); |
| static void DFSDM_DMAInjectedHalfConvCplt(DMA_HandleTypeDef *hdma); |
| static void DFSDM_DMAInjectedConvCplt(DMA_HandleTypeDef *hdma); |
| static void DFSDM_DMAError(DMA_HandleTypeDef *hdma); |
| /** |
| * @} |
| */ |
| |
| /* Exported functions --------------------------------------------------------*/ |
| /** @defgroup DFSDM_Exported_Functions DFSDM Exported Functions |
| * @{ |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group1_Channel Channel initialization and de-initialization functions |
| * @brief Channel initialization and de-initialization functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### Channel initialization and de-initialization functions ##### |
| ============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Initialize the DFSDM channel. |
| (+) De-initialize the DFSDM channel. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Initialize the DFSDM channel according to the specified parameters |
| * in the DFSDM_ChannelInitTypeDef structure and initialize the associated handle. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelInit(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| __IO uint32_t *channelCounterPtr; |
| DFSDM_Channel_HandleTypeDef **channelHandleTable; |
| DFSDM_Channel_TypeDef *channel0Instance; |
| |
| /* Check DFSDM Channel handle */ |
| if(hdfsdm_channel == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| assert_param(IS_FUNCTIONAL_STATE(hdfsdm_channel->Init.OutputClock.Activation)); |
| assert_param(IS_DFSDM_CHANNEL_INPUT(hdfsdm_channel->Init.Input.Multiplexer)); |
| assert_param(IS_DFSDM_CHANNEL_DATA_PACKING(hdfsdm_channel->Init.Input.DataPacking)); |
| assert_param(IS_DFSDM_CHANNEL_INPUT_PINS(hdfsdm_channel->Init.Input.Pins)); |
| assert_param(IS_DFSDM_CHANNEL_SERIAL_INTERFACE_TYPE(hdfsdm_channel->Init.SerialInterface.Type)); |
| assert_param(IS_DFSDM_CHANNEL_SPI_CLOCK(hdfsdm_channel->Init.SerialInterface.SpiClock)); |
| assert_param(IS_DFSDM_CHANNEL_FILTER_ORDER(hdfsdm_channel->Init.Awd.FilterOrder)); |
| assert_param(IS_DFSDM_CHANNEL_FILTER_OVS_RATIO(hdfsdm_channel->Init.Awd.Oversampling)); |
| assert_param(IS_DFSDM_CHANNEL_OFFSET(hdfsdm_channel->Init.Offset)); |
| assert_param(IS_DFSDM_CHANNEL_RIGHT_BIT_SHIFT(hdfsdm_channel->Init.RightBitShift)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| channelCounterPtr = &v_dfsdm1ChannelCounter; |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| channel0Instance = DFSDM1_Channel0; |
| } |
| else |
| { |
| channelCounterPtr = &v_dfsdm2ChannelCounter; |
| channelHandleTable = a_dfsdm2ChannelHandle; |
| channel0Instance = DFSDM2_Channel0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| channelCounterPtr = &v_dfsdm1ChannelCounter; |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| channel0Instance = DFSDM1_Channel0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check that channel has not been already initialized */ |
| if (channelHandleTable[DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance)] != NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| /* Reset callback pointers to the weak predefined callbacks */ |
| hdfsdm_channel->CkabCallback = HAL_DFSDM_ChannelCkabCallback; |
| hdfsdm_channel->ScdCallback = HAL_DFSDM_ChannelScdCallback; |
| |
| /* Call MSP init function */ |
| if(hdfsdm_channel->MspInitCallback == NULL) |
| { |
| hdfsdm_channel->MspInitCallback = HAL_DFSDM_ChannelMspInit; |
| } |
| hdfsdm_channel->MspInitCallback(hdfsdm_channel); |
| #else |
| /* Call MSP init function */ |
| HAL_DFSDM_ChannelMspInit(hdfsdm_channel); |
| #endif |
| |
| /* Update the channel counter */ |
| (*channelCounterPtr)++; |
| |
| /* Configure output serial clock and enable global DFSDM interface only for first channel */ |
| if(*channelCounterPtr == 1U) |
| { |
| assert_param(IS_DFSDM_CHANNEL_OUTPUT_CLOCK(hdfsdm_channel->Init.OutputClock.Selection)); |
| /* Set the output serial clock source */ |
| channel0Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_CKOUTSRC); |
| channel0Instance->CHCFGR1 |= hdfsdm_channel->Init.OutputClock.Selection; |
| |
| /* Reset clock divider */ |
| channel0Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_CKOUTDIV); |
| if(hdfsdm_channel->Init.OutputClock.Activation == ENABLE) |
| { |
| assert_param(IS_DFSDM_CHANNEL_OUTPUT_CLOCK_DIVIDER(hdfsdm_channel->Init.OutputClock.Divider)); |
| /* Set the output clock divider */ |
| channel0Instance->CHCFGR1 |= (uint32_t)((hdfsdm_channel->Init.OutputClock.Divider - 1U) << |
| DFSDM_CHCFGR1_CKOUTDIV_Pos); |
| } |
| |
| /* enable the DFSDM global interface */ |
| channel0Instance->CHCFGR1 |= DFSDM_CHCFGR1_DFSDMEN; |
| } |
| |
| /* Set channel input parameters */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_DATPACK | DFSDM_CHCFGR1_DATMPX | |
| DFSDM_CHCFGR1_CHINSEL); |
| hdfsdm_channel->Instance->CHCFGR1 |= (hdfsdm_channel->Init.Input.Multiplexer | |
| hdfsdm_channel->Init.Input.DataPacking | |
| hdfsdm_channel->Init.Input.Pins); |
| |
| /* Set serial interface parameters */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_SITP | DFSDM_CHCFGR1_SPICKSEL); |
| hdfsdm_channel->Instance->CHCFGR1 |= (hdfsdm_channel->Init.SerialInterface.Type | |
| hdfsdm_channel->Init.SerialInterface.SpiClock); |
| |
| /* Set analog watchdog parameters */ |
| hdfsdm_channel->Instance->CHAWSCDR &= ~(DFSDM_CHAWSCDR_AWFORD | DFSDM_CHAWSCDR_AWFOSR); |
| hdfsdm_channel->Instance->CHAWSCDR |= (hdfsdm_channel->Init.Awd.FilterOrder | |
| ((hdfsdm_channel->Init.Awd.Oversampling - 1U) << DFSDM_CHAWSCDR_AWFOSR_Pos)); |
| |
| /* Set channel offset and right bit shift */ |
| hdfsdm_channel->Instance->CHCFGR2 &= ~(DFSDM_CHCFGR2_OFFSET | DFSDM_CHCFGR2_DTRBS); |
| hdfsdm_channel->Instance->CHCFGR2 |= (((uint32_t) hdfsdm_channel->Init.Offset << DFSDM_CHCFGR2_OFFSET_Pos) | |
| (hdfsdm_channel->Init.RightBitShift << DFSDM_CHCFGR2_DTRBS_Pos)); |
| |
| /* Enable DFSDM channel */ |
| hdfsdm_channel->Instance->CHCFGR1 |= DFSDM_CHCFGR1_CHEN; |
| |
| /* Set DFSDM Channel to ready state */ |
| hdfsdm_channel->State = HAL_DFSDM_CHANNEL_STATE_READY; |
| |
| /* Store channel handle in DFSDM channel handle table */ |
| channelHandleTable[DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance)] = hdfsdm_channel; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief De-initialize the DFSDM channel. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelDeInit(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| __IO uint32_t *channelCounterPtr; |
| DFSDM_Channel_HandleTypeDef **channelHandleTable; |
| DFSDM_Channel_TypeDef *channel0Instance; |
| |
| /* Check DFSDM Channel handle */ |
| if(hdfsdm_channel == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| channelCounterPtr = &v_dfsdm1ChannelCounter; |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| channel0Instance = DFSDM1_Channel0; |
| } |
| else |
| { |
| channelCounterPtr = &v_dfsdm2ChannelCounter; |
| channelHandleTable = a_dfsdm2ChannelHandle; |
| channel0Instance = DFSDM2_Channel0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| channelCounterPtr = &v_dfsdm1ChannelCounter; |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| channel0Instance = DFSDM1_Channel0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check that channel has not been already deinitialized */ |
| if (channelHandleTable[DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance)] == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Disable the DFSDM channel */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_CHEN); |
| |
| /* Update the channel counter */ |
| (*channelCounterPtr)--; |
| |
| /* Disable global DFSDM at deinit of last channel */ |
| if (*channelCounterPtr == 0U) |
| { |
| channel0Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_DFSDMEN); |
| } |
| |
| /* Call MSP deinit function */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| if(hdfsdm_channel->MspDeInitCallback == NULL) |
| { |
| hdfsdm_channel->MspDeInitCallback = HAL_DFSDM_ChannelMspDeInit; |
| } |
| hdfsdm_channel->MspDeInitCallback(hdfsdm_channel); |
| #else |
| HAL_DFSDM_ChannelMspDeInit(hdfsdm_channel); |
| #endif |
| |
| /* Set DFSDM Channel in reset state */ |
| hdfsdm_channel->State = HAL_DFSDM_CHANNEL_STATE_RESET; |
| |
| /* Reset channel handle in DFSDM channel handle table */ |
| channelHandleTable[DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance)] = (DFSDM_Channel_HandleTypeDef *) NULL; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Initialize the DFSDM channel MSP. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_ChannelMspInit(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_channel); |
| |
| /* NOTE : This function should not be modified, when the function is needed, |
| the HAL_DFSDM_ChannelMspInit could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief De-initialize the DFSDM channel MSP. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_ChannelMspDeInit(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_channel); |
| |
| /* NOTE : This function should not be modified, when the function is needed, |
| the HAL_DFSDM_ChannelMspDeInit could be implemented in the user file. |
| */ |
| } |
| |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| /** |
| * @brief Register a user DFSDM channel callback |
| * to be used instead of the weak predefined callback. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param CallbackID ID of the callback to be registered. |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_DFSDM_CHANNEL_CKAB_CB_ID clock absence detection callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_SCD_CB_ID short circuit detection callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_MSPINIT_CB_ID MSP init callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID MSP de-init callback ID. |
| * @param pCallback pointer to the callback function. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Channel_RegisterCallback(DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| HAL_DFSDM_Channel_CallbackIDTypeDef CallbackID, |
| pDFSDM_Channel_CallbackTypeDef pCallback) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(pCallback == NULL) |
| { |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| if(HAL_DFSDM_CHANNEL_STATE_READY == hdfsdm_channel->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_CHANNEL_CKAB_CB_ID : |
| hdfsdm_channel->CkabCallback = pCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_SCD_CB_ID : |
| hdfsdm_channel->ScdCallback = pCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPINIT_CB_ID : |
| hdfsdm_channel->MspInitCallback = pCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID : |
| hdfsdm_channel->MspDeInitCallback = pCallback; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if(HAL_DFSDM_CHANNEL_STATE_RESET == hdfsdm_channel->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_CHANNEL_MSPINIT_CB_ID : |
| hdfsdm_channel->MspInitCallback = pCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID : |
| hdfsdm_channel->MspDeInitCallback = pCallback; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| } |
| return status; |
| } |
| |
| /** |
| * @brief Unregister a user DFSDM channel callback. |
| * DFSDM channel callback is redirected to the weak predefined callback. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param CallbackID ID of the callback to be unregistered. |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_DFSDM_CHANNEL_CKAB_CB_ID clock absence detection callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_SCD_CB_ID short circuit detection callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_MSPINIT_CB_ID MSP init callback ID. |
| * @arg @ref HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID MSP de-init callback ID. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Channel_UnRegisterCallback(DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| HAL_DFSDM_Channel_CallbackIDTypeDef CallbackID) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(HAL_DFSDM_CHANNEL_STATE_READY == hdfsdm_channel->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_CHANNEL_CKAB_CB_ID : |
| hdfsdm_channel->CkabCallback = HAL_DFSDM_ChannelCkabCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_SCD_CB_ID : |
| hdfsdm_channel->ScdCallback = HAL_DFSDM_ChannelScdCallback; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPINIT_CB_ID : |
| hdfsdm_channel->MspInitCallback = HAL_DFSDM_ChannelMspInit; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID : |
| hdfsdm_channel->MspDeInitCallback = HAL_DFSDM_ChannelMspDeInit; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if(HAL_DFSDM_CHANNEL_STATE_RESET == hdfsdm_channel->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_CHANNEL_MSPINIT_CB_ID : |
| hdfsdm_channel->MspInitCallback = HAL_DFSDM_ChannelMspInit; |
| break; |
| case HAL_DFSDM_CHANNEL_MSPDEINIT_CB_ID : |
| hdfsdm_channel->MspDeInitCallback = HAL_DFSDM_ChannelMspDeInit; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| return status; |
| } |
| #endif /* USE_HAL_DFSDM_REGISTER_CALLBACKS */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group2_Channel Channel operation functions |
| * @brief Channel operation functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### 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. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief This function allows to start clock absence detection in polling mode. |
| * @note Same mode has to be used for all channels. |
| * @note 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. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| uint32_t tickstart; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Get channel number from channel instance */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Clear clock absence flag */ |
| while ((((filter0Instance->FLTISR & DFSDM_FLTISR_CKABF) >> (DFSDM_FLTISR_CKABF_Pos + channel)) & 1U) != 0U) |
| { |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| |
| /* Check the Timeout */ |
| if((HAL_GetTick()-tickstart) > DFSDM_CKAB_TIMEOUT) |
| { |
| /* Set timeout status */ |
| status = HAL_TIMEOUT; |
| break; |
| } |
| } |
| |
| if(status == HAL_OK) |
| { |
| /* Start clock absence detection */ |
| hdfsdm_channel->Instance->CHCFGR1 |= DFSDM_CHCFGR1_CKABEN; |
| } |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to poll for the clock absence detection. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param Timeout Timeout value in milliseconds. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelPollForCkab(const DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| uint32_t Timeout) |
| { |
| uint32_t tickstart; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| return HAL_ERROR; |
| } |
| else |
| { |
| /* Get channel number from channel instance */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Wait clock absence detection */ |
| while ((((filter0Instance->FLTISR & DFSDM_FLTISR_CKABF) >> (DFSDM_FLTISR_CKABF_Pos + channel)) & 1U) == 0U) |
| { |
| /* Check the Timeout */ |
| if(Timeout != HAL_MAX_DELAY) |
| { |
| if(((HAL_GetTick()-tickstart) > Timeout) || (Timeout == 0U)) |
| { |
| /* Return timeout status */ |
| return HAL_TIMEOUT; |
| } |
| } |
| } |
| |
| /* Clear clock absence detection flag */ |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| |
| /* Return function status */ |
| return HAL_OK; |
| } |
| } |
| |
| /** |
| * @brief This function allows to stop clock absence detection in polling mode. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop clock absence detection */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_CKABEN); |
| |
| /* Clear clock absence flag */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start clock absence detection in interrupt mode. |
| * @note Same mode has to be used for all channels. |
| * @note 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. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStart_IT(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| uint32_t tickstart; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Get channel number from channel instance */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Clear clock absence flag */ |
| while ((((filter0Instance->FLTISR & DFSDM_FLTISR_CKABF) >> (DFSDM_FLTISR_CKABF_Pos + channel)) & 1U) != 0U) |
| { |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| |
| /* Check the Timeout */ |
| if((HAL_GetTick()-tickstart) > DFSDM_CKAB_TIMEOUT) |
| { |
| /* Set timeout status */ |
| status = HAL_TIMEOUT; |
| break; |
| } |
| } |
| |
| if(status == HAL_OK) |
| { |
| /* Activate clock absence detection interrupt */ |
| filter0Instance->FLTCR2 |= DFSDM_FLTCR2_CKABIE; |
| |
| /* Start clock absence detection */ |
| hdfsdm_channel->Instance->CHCFGR1 |= DFSDM_CHCFGR1_CKABEN; |
| } |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief Clock absence detection callback. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_ChannelCkabCallback(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_channel); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_ChannelCkabCallback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief This function allows to stop clock absence detection in interrupt mode. |
| * @note Interrupt will be disabled for all channels |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelCkabStop_IT(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop clock absence detection */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_CKABEN); |
| |
| /* Clear clock absence flag */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| |
| /* Disable clock absence detection interrupt */ |
| filter0Instance->FLTCR2 &= ~(DFSDM_FLTCR2_CKABIE); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start short circuit detection in polling mode. |
| * @note Same mode has to be used for all channels |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param Threshold Short circuit detector threshold. |
| * This parameter must be a number between Min_Data = 0 and Max_Data = 255. |
| * @param BreakSignal Break signals assigned to short circuit event. |
| * This parameter can be a values combination of @ref DFSDM_BreakSignals. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart(DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| uint32_t Threshold, |
| uint32_t BreakSignal) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| assert_param(IS_DFSDM_CHANNEL_SCD_THRESHOLD(Threshold)); |
| assert_param(IS_DFSDM_BREAK_SIGNALS(BreakSignal)); |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Configure threshold and break signals */ |
| hdfsdm_channel->Instance->CHAWSCDR &= ~(DFSDM_CHAWSCDR_BKSCD | DFSDM_CHAWSCDR_SCDT); |
| hdfsdm_channel->Instance->CHAWSCDR |= ((BreakSignal << DFSDM_CHAWSCDR_BKSCD_Pos) | \ |
| Threshold); |
| |
| /* Start short circuit detection */ |
| hdfsdm_channel->Instance->CHCFGR1 |= DFSDM_CHCFGR1_SCDEN; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to poll for the short circuit detection. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param Timeout Timeout value in milliseconds. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelPollForScd(const DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| uint32_t Timeout) |
| { |
| uint32_t tickstart; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| return HAL_ERROR; |
| } |
| else |
| { |
| /* Get channel number from channel instance */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Wait short circuit detection */ |
| while (((filter0Instance->FLTISR & DFSDM_FLTISR_SCDF) >> (DFSDM_FLTISR_SCDF_Pos + channel)) == 0U) |
| { |
| /* Check the Timeout */ |
| if(Timeout != HAL_MAX_DELAY) |
| { |
| if(((HAL_GetTick()-tickstart) > Timeout) || (Timeout == 0U)) |
| { |
| /* Return timeout status */ |
| return HAL_TIMEOUT; |
| } |
| } |
| } |
| |
| /* Clear short circuit detection flag */ |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRSCDF_Pos + channel)); |
| |
| /* Return function status */ |
| return HAL_OK; |
| } |
| } |
| |
| /** |
| * @brief This function allows to stop short circuit detection in polling mode. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop short circuit detection */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_SCDEN); |
| |
| /* Clear short circuit detection flag */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRSCDF_Pos + channel)); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start short circuit detection in interrupt mode. |
| * @note Same mode has to be used for all channels |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param Threshold Short circuit detector threshold. |
| * This parameter must be a number between Min_Data = 0 and Max_Data = 255. |
| * @param BreakSignal Break signals assigned to short circuit event. |
| * This parameter can be a values combination of @ref DFSDM_BreakSignals. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelScdStart_IT(DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| uint32_t Threshold, |
| uint32_t BreakSignal) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| assert_param(IS_DFSDM_CHANNEL_SCD_THRESHOLD(Threshold)); |
| assert_param(IS_DFSDM_BREAK_SIGNALS(BreakSignal)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Activate short circuit detection interrupt */ |
| filter0Instance->FLTCR2 |= DFSDM_FLTCR2_SCDIE; |
| |
| /* Configure threshold and break signals */ |
| hdfsdm_channel->Instance->CHAWSCDR &= ~(DFSDM_CHAWSCDR_BKSCD | DFSDM_CHAWSCDR_SCDT); |
| hdfsdm_channel->Instance->CHAWSCDR |= ((BreakSignal << DFSDM_CHAWSCDR_BKSCD_Pos) | \ |
| Threshold); |
| |
| /* Start short circuit detection */ |
| hdfsdm_channel->Instance->CHCFGR1 |= DFSDM_CHCFGR1_SCDEN; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief Short circuit detection callback. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_ChannelScdCallback(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_channel); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_ChannelScdCallback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief This function allows to stop short circuit detection in interrupt mode. |
| * @note Interrupt will be disabled for all channels |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelScdStop_IT(DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| uint32_t channel; |
| DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_CHANNEL_INSTANCE(hdfsdm_channel->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop short circuit detection */ |
| hdfsdm_channel->Instance->CHCFGR1 &= ~(DFSDM_CHCFGR1_SCDEN); |
| |
| /* Clear short circuit detection flag */ |
| channel = DFSDM_GetChannelFromInstance(hdfsdm_channel->Instance); |
| filter0Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRSCDF_Pos + channel)); |
| |
| /* Disable short circuit detection interrupt */ |
| filter0Instance->FLTCR2 &= ~(DFSDM_FLTCR2_SCDIE); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to get channel analog watchdog value. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval Channel analog watchdog value. |
| */ |
| int16_t HAL_DFSDM_ChannelGetAwdValue(const DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| return (int16_t) hdfsdm_channel->Instance->CHWDATAR; |
| } |
| |
| /** |
| * @brief This function allows to modify channel offset value. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @param Offset DFSDM channel offset. |
| * This parameter must be a number between Min_Data = -8388608 and Max_Data = 8388607. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_ChannelModifyOffset(DFSDM_Channel_HandleTypeDef *hdfsdm_channel, |
| int32_t Offset) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_CHANNEL_ALL_INSTANCE(hdfsdm_channel->Instance)); |
| assert_param(IS_DFSDM_CHANNEL_OFFSET(Offset)); |
| |
| /* Check DFSDM channel state */ |
| if(hdfsdm_channel->State != HAL_DFSDM_CHANNEL_STATE_READY) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Modify channel offset */ |
| hdfsdm_channel->Instance->CHCFGR2 &= ~(DFSDM_CHCFGR2_OFFSET); |
| hdfsdm_channel->Instance->CHCFGR2 |= ((uint32_t) Offset << DFSDM_CHCFGR2_OFFSET_Pos); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group3_Channel Channel state function |
| * @brief Channel state function |
| * |
| @verbatim |
| ============================================================================== |
| ##### Channel state function ##### |
| ============================================================================== |
| [..] This section provides function allowing to: |
| (+) Get channel handle state. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief This function allows to get the current DFSDM channel handle state. |
| * @param hdfsdm_channel DFSDM channel handle. |
| * @retval DFSDM channel state. |
| */ |
| HAL_DFSDM_Channel_StateTypeDef HAL_DFSDM_ChannelGetState(const DFSDM_Channel_HandleTypeDef *hdfsdm_channel) |
| { |
| /* Return DFSDM channel handle state */ |
| return hdfsdm_channel->State; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group1_Filter Filter initialization and de-initialization functions |
| * @brief Filter initialization and de-initialization functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### Filter initialization and de-initialization functions ##### |
| ============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Initialize the DFSDM filter. |
| (+) De-initialize the DFSDM filter. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Initialize the DFSDM filter according to the specified parameters |
| * in the DFSDM_FilterInitTypeDef structure and initialize the associated handle. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInit(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| const DFSDM_Filter_TypeDef *filter0Instance; |
| |
| /* Check DFSDM Channel handle */ |
| if(hdfsdm_filter == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(IS_DFSDM_FILTER_REG_TRIGGER(hdfsdm_filter->Init.RegularParam.Trigger)); |
| assert_param(IS_FUNCTIONAL_STATE(hdfsdm_filter->Init.RegularParam.FastMode)); |
| assert_param(IS_FUNCTIONAL_STATE(hdfsdm_filter->Init.RegularParam.DmaMode)); |
| assert_param(IS_DFSDM_FILTER_INJ_TRIGGER(hdfsdm_filter->Init.InjectedParam.Trigger)); |
| assert_param(IS_FUNCTIONAL_STATE(hdfsdm_filter->Init.InjectedParam.ScanMode)); |
| assert_param(IS_FUNCTIONAL_STATE(hdfsdm_filter->Init.InjectedParam.DmaMode)); |
| assert_param(IS_DFSDM_FILTER_SINC_ORDER(hdfsdm_filter->Init.FilterParam.SincOrder)); |
| assert_param(IS_DFSDM_FILTER_OVS_RATIO(hdfsdm_filter->Init.FilterParam.Oversampling)); |
| assert_param(IS_DFSDM_FILTER_INTEGRATOR_OVS_RATIO(hdfsdm_filter->Init.FilterParam.IntOversampling)); |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_FILTER_INSTANCE(hdfsdm_filter->Instance)) |
| { |
| filter0Instance = DFSDM1_Filter0; |
| } |
| else |
| { |
| filter0Instance = DFSDM2_Filter0; |
| } |
| #else /* DFSDM2_Channel0 */ |
| filter0Instance = DFSDM1_Filter0; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check parameters compatibility */ |
| if ((hdfsdm_filter->Instance == filter0Instance) && |
| ((hdfsdm_filter->Init.RegularParam.Trigger == DFSDM_FILTER_SYNC_TRIGGER) || |
| (hdfsdm_filter->Init.InjectedParam.Trigger == DFSDM_FILTER_SYNC_TRIGGER))) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Initialize DFSDM filter variables with default values */ |
| hdfsdm_filter->RegularContMode = DFSDM_CONTINUOUS_CONV_OFF; |
| hdfsdm_filter->InjectedChannelsNbr = 1; |
| hdfsdm_filter->InjConvRemaining = 1; |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_NONE; |
| |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| /* Reset callback pointers to the weak predefined callbacks */ |
| hdfsdm_filter->AwdCallback = HAL_DFSDM_FilterAwdCallback; |
| hdfsdm_filter->RegConvCpltCallback = HAL_DFSDM_FilterRegConvCpltCallback; |
| hdfsdm_filter->RegConvHalfCpltCallback = HAL_DFSDM_FilterRegConvHalfCpltCallback; |
| hdfsdm_filter->InjConvCpltCallback = HAL_DFSDM_FilterInjConvCpltCallback; |
| hdfsdm_filter->InjConvHalfCpltCallback = HAL_DFSDM_FilterInjConvHalfCpltCallback; |
| hdfsdm_filter->ErrorCallback = HAL_DFSDM_FilterErrorCallback; |
| |
| /* Call MSP init function */ |
| if(hdfsdm_filter->MspInitCallback == NULL) |
| { |
| hdfsdm_filter->MspInitCallback = HAL_DFSDM_FilterMspInit; |
| } |
| hdfsdm_filter->MspInitCallback(hdfsdm_filter); |
| #else |
| /* Call MSP init function */ |
| HAL_DFSDM_FilterMspInit(hdfsdm_filter); |
| #endif |
| |
| /* Set regular parameters */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_RSYNC); |
| if(hdfsdm_filter->Init.RegularParam.FastMode == ENABLE) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_FAST; |
| } |
| else |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_FAST); |
| } |
| |
| if(hdfsdm_filter->Init.RegularParam.DmaMode == ENABLE) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_RDMAEN; |
| } |
| else |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_RDMAEN); |
| } |
| |
| /* Set injected parameters */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_JSYNC | DFSDM_FLTCR1_JEXTEN | DFSDM_FLTCR1_JEXTSEL); |
| if(hdfsdm_filter->Init.InjectedParam.Trigger == DFSDM_FILTER_EXT_TRIGGER) |
| { |
| assert_param(IS_DFSDM_FILTER_EXT_TRIG(hdfsdm_filter->Init.InjectedParam.ExtTrigger)); |
| assert_param(IS_DFSDM_FILTER_EXT_TRIG_EDGE(hdfsdm_filter->Init.InjectedParam.ExtTriggerEdge)); |
| hdfsdm_filter->Instance->FLTCR1 |= (hdfsdm_filter->Init.InjectedParam.ExtTrigger); |
| } |
| |
| if(hdfsdm_filter->Init.InjectedParam.ScanMode == ENABLE) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JSCAN; |
| } |
| else |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_JSCAN); |
| } |
| |
| if(hdfsdm_filter->Init.InjectedParam.DmaMode == ENABLE) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JDMAEN; |
| } |
| else |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_JDMAEN); |
| } |
| |
| /* Set filter parameters */ |
| hdfsdm_filter->Instance->FLTFCR &= ~(DFSDM_FLTFCR_FORD | DFSDM_FLTFCR_FOSR | DFSDM_FLTFCR_IOSR); |
| hdfsdm_filter->Instance->FLTFCR |= (hdfsdm_filter->Init.FilterParam.SincOrder | |
| ((hdfsdm_filter->Init.FilterParam.Oversampling - 1U) << DFSDM_FLTFCR_FOSR_Pos) | |
| (hdfsdm_filter->Init.FilterParam.IntOversampling - 1U)); |
| |
| /* Store regular and injected triggers and injected scan mode*/ |
| hdfsdm_filter->RegularTrigger = hdfsdm_filter->Init.RegularParam.Trigger; |
| hdfsdm_filter->InjectedTrigger = hdfsdm_filter->Init.InjectedParam.Trigger; |
| hdfsdm_filter->ExtTriggerEdge = hdfsdm_filter->Init.InjectedParam.ExtTriggerEdge; |
| hdfsdm_filter->InjectedScanMode = hdfsdm_filter->Init.InjectedParam.ScanMode; |
| |
| /* Enable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_DFEN; |
| |
| /* Set DFSDM filter to ready state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_READY; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief De-initializes the DFSDM filter. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterDeInit(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Check DFSDM filter handle */ |
| if(hdfsdm_filter == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Disable the DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_DFEN); |
| |
| /* Call MSP deinit function */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| if(hdfsdm_filter->MspDeInitCallback == NULL) |
| { |
| hdfsdm_filter->MspDeInitCallback = HAL_DFSDM_FilterMspDeInit; |
| } |
| hdfsdm_filter->MspDeInitCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterMspDeInit(hdfsdm_filter); |
| #endif |
| |
| /* Set DFSDM filter in reset state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_RESET; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Initializes the DFSDM filter MSP. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterMspInit(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the function is needed, |
| the HAL_DFSDM_FilterMspInit could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief De-initializes the DFSDM filter MSP. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterMspDeInit(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the function is needed, |
| the HAL_DFSDM_FilterMspDeInit could be implemented in the user file. |
| */ |
| } |
| |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| /** |
| * @brief Register a user DFSDM filter callback |
| * to be used instead of the weak predefined callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param CallbackID ID of the callback to be registered. |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_DFSDM_FILTER_REGCONV_COMPLETE_CB_ID regular conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_REGCONV_HALFCOMPLETE_CB_ID half regular conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_INJCONV_COMPLETE_CB_ID injected conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_INJCONV_HALFCOMPLETE_CB_ID half injected conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_ERROR_CB_ID error callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_MSPINIT_CB_ID MSP init callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_MSPDEINIT_CB_ID MSP de-init callback ID. |
| * @param pCallback pointer to the callback function. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Filter_RegisterCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| HAL_DFSDM_Filter_CallbackIDTypeDef CallbackID, |
| pDFSDM_Filter_CallbackTypeDef pCallback) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(pCallback == NULL) |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| if(HAL_DFSDM_FILTER_STATE_READY == hdfsdm_filter->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_FILTER_REGCONV_COMPLETE_CB_ID : |
| hdfsdm_filter->RegConvCpltCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_REGCONV_HALFCOMPLETE_CB_ID : |
| hdfsdm_filter->RegConvHalfCpltCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_INJCONV_COMPLETE_CB_ID : |
| hdfsdm_filter->InjConvCpltCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_INJCONV_HALFCOMPLETE_CB_ID : |
| hdfsdm_filter->InjConvHalfCpltCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_ERROR_CB_ID : |
| hdfsdm_filter->ErrorCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_MSPINIT_CB_ID : |
| hdfsdm_filter->MspInitCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_MSPDEINIT_CB_ID : |
| hdfsdm_filter->MspDeInitCallback = pCallback; |
| break; |
| default : |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if(HAL_DFSDM_FILTER_STATE_RESET == hdfsdm_filter->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_FILTER_MSPINIT_CB_ID : |
| hdfsdm_filter->MspInitCallback = pCallback; |
| break; |
| case HAL_DFSDM_FILTER_MSPDEINIT_CB_ID : |
| hdfsdm_filter->MspDeInitCallback = pCallback; |
| break; |
| default : |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| } |
| return status; |
| } |
| |
| /** |
| * @brief Unregister a user DFSDM filter callback. |
| * DFSDM filter callback is redirected to the weak predefined callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param CallbackID ID of the callback to be unregistered. |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_DFSDM_FILTER_REGCONV_COMPLETE_CB_ID regular conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_REGCONV_HALFCOMPLETE_CB_ID half regular conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_INJCONV_COMPLETE_CB_ID injected conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_INJCONV_HALFCOMPLETE_CB_ID half injected conversion complete callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_ERROR_CB_ID error callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_MSPINIT_CB_ID MSP init callback ID. |
| * @arg @ref HAL_DFSDM_FILTER_MSPDEINIT_CB_ID MSP de-init callback ID. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Filter_UnRegisterCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| HAL_DFSDM_Filter_CallbackIDTypeDef CallbackID) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(HAL_DFSDM_FILTER_STATE_READY == hdfsdm_filter->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_FILTER_REGCONV_COMPLETE_CB_ID : |
| hdfsdm_filter->RegConvCpltCallback = HAL_DFSDM_FilterRegConvCpltCallback; |
| break; |
| case HAL_DFSDM_FILTER_REGCONV_HALFCOMPLETE_CB_ID : |
| hdfsdm_filter->RegConvHalfCpltCallback = HAL_DFSDM_FilterRegConvHalfCpltCallback; |
| break; |
| case HAL_DFSDM_FILTER_INJCONV_COMPLETE_CB_ID : |
| hdfsdm_filter->InjConvCpltCallback = HAL_DFSDM_FilterInjConvCpltCallback; |
| break; |
| case HAL_DFSDM_FILTER_INJCONV_HALFCOMPLETE_CB_ID : |
| hdfsdm_filter->InjConvHalfCpltCallback = HAL_DFSDM_FilterInjConvHalfCpltCallback; |
| break; |
| case HAL_DFSDM_FILTER_ERROR_CB_ID : |
| hdfsdm_filter->ErrorCallback = HAL_DFSDM_FilterErrorCallback; |
| break; |
| case HAL_DFSDM_FILTER_MSPINIT_CB_ID : |
| hdfsdm_filter->MspInitCallback = HAL_DFSDM_FilterMspInit; |
| break; |
| case HAL_DFSDM_FILTER_MSPDEINIT_CB_ID : |
| hdfsdm_filter->MspDeInitCallback = HAL_DFSDM_FilterMspDeInit; |
| break; |
| default : |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if(HAL_DFSDM_FILTER_STATE_RESET == hdfsdm_filter->State) |
| { |
| switch (CallbackID) |
| { |
| case HAL_DFSDM_FILTER_MSPINIT_CB_ID : |
| hdfsdm_filter->MspInitCallback = HAL_DFSDM_FilterMspInit; |
| break; |
| case HAL_DFSDM_FILTER_MSPDEINIT_CB_ID : |
| hdfsdm_filter->MspDeInitCallback = HAL_DFSDM_FilterMspDeInit; |
| break; |
| default : |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| return status; |
| } |
| |
| /** |
| * @brief Register a user DFSDM filter analog watchdog callback |
| * to be used instead of the weak predefined callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param pCallback pointer to the DFSDM filter analog watchdog callback function. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Filter_RegisterAwdCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| pDFSDM_Filter_AwdCallbackTypeDef pCallback) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(pCallback == NULL) |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| if(HAL_DFSDM_FILTER_STATE_READY == hdfsdm_filter->State) |
| { |
| hdfsdm_filter->AwdCallback = pCallback; |
| } |
| else |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| } |
| return status; |
| } |
| |
| /** |
| * @brief Unregister a user DFSDM filter analog watchdog callback. |
| * DFSDM filter AWD callback is redirected to the weak predefined callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status. |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_Filter_UnRegisterAwdCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if(HAL_DFSDM_FILTER_STATE_READY == hdfsdm_filter->State) |
| { |
| hdfsdm_filter->AwdCallback = HAL_DFSDM_FilterAwdCallback; |
| } |
| else |
| { |
| /* update the error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INVALID_CALLBACK; |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| return status; |
| } |
| #endif /* USE_HAL_DFSDM_REGISTER_CALLBACKS */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group2_Filter Filter control functions |
| * @brief Filter control functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### Filter control functions ##### |
| ============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Select channel and enable/disable continuous mode for regular conversion. |
| (+) Select channels for injected conversion. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief This function allows to select channel and to enable/disable |
| * continuous mode for regular conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Channel for regular conversion. |
| * This parameter can be a value of @ref DFSDM_Channel_Selection. |
| * @param ContinuousMode Enable/disable continuous mode for regular conversion. |
| * This parameter can be a value of @ref DFSDM_ContinuousMode. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterConfigRegChannel(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Channel, |
| uint32_t ContinuousMode) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(IS_DFSDM_REGULAR_CHANNEL(Channel)); |
| assert_param(IS_DFSDM_CONTINUOUS_MODE(ContinuousMode)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_RESET) && |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Configure channel and continuous mode for regular conversion */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_RCH | DFSDM_FLTCR1_RCONT); |
| if(ContinuousMode == DFSDM_CONTINUOUS_CONV_ON) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= (uint32_t) (((Channel & DFSDM_MSB_MASK) << DFSDM_FLTCR1_MSB_RCH_OFFSET) | |
| DFSDM_FLTCR1_RCONT); |
| } |
| else |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= (uint32_t) ((Channel & DFSDM_MSB_MASK) << DFSDM_FLTCR1_MSB_RCH_OFFSET); |
| } |
| /* Store continuous mode information */ |
| hdfsdm_filter->RegularContMode = ContinuousMode; |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to select channels for injected conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Channels for injected conversion. |
| * This parameter can be a values combination of @ref DFSDM_Channel_Selection. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterConfigInjChannel(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(IS_DFSDM_INJECTED_CHANNEL(Channel)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_RESET) && |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Configure channel for injected conversion */ |
| hdfsdm_filter->Instance->FLTJCHGR = (uint32_t) (Channel & DFSDM_LSB_MASK); |
| /* Store number of injected channels */ |
| hdfsdm_filter->InjectedChannelsNbr = DFSDM_GetInjChannelsNbr(Channel); |
| /* Update number of injected channels remaining */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group3_Filter Filter operation functions |
| * @brief Filter operation functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### Filter operation functions ##### |
| ============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Start conversion of regular/injected channel. |
| (+) Poll for the end of regular/injected conversion. |
| (+) Stop conversion of regular/injected channel. |
| (+) Start conversion of regular/injected channel and enable interrupt. |
| (+) Call the callback functions at the end of regular/injected conversions. |
| (+) Stop conversion of regular/injected channel and disable interrupt. |
| (+) Start conversion of regular/injected channel and enable DMA transfer. |
| (+) Stop conversion of regular/injected channel and disable DMA transfer. |
| (+) Start analog watchdog and enable interrupt. |
| (+) Call the callback function when analog watchdog occurs. |
| (+) Stop analog watchdog and disable interrupt. |
| (+) Start extreme detector. |
| (+) Stop extreme detector. |
| (+) Get result of regular channel conversion. |
| (+) Get result of injected channel conversion. |
| (+) Get extreme detector maximum and minimum values. |
| (+) Get conversion time. |
| (+) Handle DFSDM interrupt request. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief This function allows to start regular conversion in polling mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ)) |
| { |
| /* Start regular conversion */ |
| DFSDM_RegConvStart(hdfsdm_filter); |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to poll for the end of regular conversion. |
| * @note This function should be called only if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Timeout Timeout value in milliseconds. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterPollForRegConversion(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Timeout) |
| { |
| uint32_t tickstart; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| return HAL_ERROR; |
| } |
| else |
| { |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Wait end of regular conversion */ |
| while((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_REOCF) != DFSDM_FLTISR_REOCF) |
| { |
| /* Check the Timeout */ |
| if(Timeout != HAL_MAX_DELAY) |
| { |
| if(((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0U)) |
| { |
| /* Return timeout status */ |
| return HAL_TIMEOUT; |
| } |
| } |
| } |
| /* Check if overrun occurs */ |
| if((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_ROVRF) == DFSDM_FLTISR_ROVRF) |
| { |
| /* Update error code and call error callback */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_REGULAR_OVERRUN; |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->ErrorCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterErrorCallback(hdfsdm_filter); |
| #endif |
| |
| /* Clear regular overrun flag */ |
| hdfsdm_filter->Instance->FLTICR = DFSDM_FLTICR_CLRROVRF; |
| } |
| /* Update DFSDM filter state only if not continuous conversion and SW trigger */ |
| if((hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER)) |
| { |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_INJ; |
| } |
| /* Return function status */ |
| return HAL_OK; |
| } |
| } |
| |
| /** |
| * @brief This function allows to stop regular conversion in polling mode. |
| * @note This function should be called only if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop regular conversion */ |
| DFSDM_RegConvStop(hdfsdm_filter); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start regular conversion in interrupt mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStart_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ)) |
| { |
| /* Enable interrupts for regular conversions */ |
| hdfsdm_filter->Instance->FLTCR2 |= (DFSDM_FLTCR2_REOCIE | DFSDM_FLTCR2_ROVRIE); |
| |
| /* Start regular conversion */ |
| DFSDM_RegConvStart(hdfsdm_filter); |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop regular conversion in interrupt mode. |
| * @note This function should be called only if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStop_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Disable interrupts for regular conversions */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_REOCIE | DFSDM_FLTCR2_ROVRIE); |
| |
| /* Stop regular conversion */ |
| DFSDM_RegConvStop(hdfsdm_filter); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start regular conversion in DMA mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if injected conversion is ongoing. |
| * Please note that data on buffer will contain signed regular conversion |
| * value on 24 most significant bits and corresponding channel on 3 least |
| * significant bits. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param pData The destination buffer address. |
| * @param Length The length of data to be transferred from DFSDM filter to memory. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStart_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| int32_t *pData, |
| uint32_t Length) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check destination address and length */ |
| if((pData == NULL) || (Length == 0U)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check that DMA is enabled for regular conversion */ |
| else if((hdfsdm_filter->Instance->FLTCR1 & DFSDM_FLTCR1_RDMAEN) != DFSDM_FLTCR1_RDMAEN) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check parameters compatibility */ |
| else if((hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->hdmaReg->Init.Mode == DMA_NORMAL) && \ |
| (Length != 1U)) |
| { |
| status = HAL_ERROR; |
| } |
| else if((hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->hdmaReg->Init.Mode == DMA_CIRCULAR)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check DFSDM filter state */ |
| else if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ)) |
| { |
| /* Set callbacks on DMA handler */ |
| hdfsdm_filter->hdmaReg->XferCpltCallback = DFSDM_DMARegularConvCplt; |
| hdfsdm_filter->hdmaReg->XferErrorCallback = DFSDM_DMAError; |
| hdfsdm_filter->hdmaReg->XferHalfCpltCallback = (hdfsdm_filter->hdmaReg->Init.Mode == DMA_CIRCULAR) ?\ |
| DFSDM_DMARegularHalfConvCplt : NULL; |
| |
| /* Start DMA in interrupt mode */ |
| if(HAL_DMA_Start_IT(hdfsdm_filter->hdmaReg, (uint32_t)&hdfsdm_filter->Instance->FLTRDATAR, \ |
| (uint32_t) pData, Length) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Start regular conversion */ |
| DFSDM_RegConvStart(hdfsdm_filter); |
| } |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start regular conversion in DMA mode and to get |
| * only the 16 most significant bits of conversion. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if injected conversion is ongoing. |
| * Please note that data on buffer will contain signed 16 most significant |
| * bits of regular conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param pData The destination buffer address. |
| * @param Length The length of data to be transferred from DFSDM filter to memory. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularMsbStart_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| int16_t *pData, |
| uint32_t Length) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check destination address and length */ |
| if((pData == NULL) || (Length == 0U)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check that DMA is enabled for regular conversion */ |
| else if((hdfsdm_filter->Instance->FLTCR1 & DFSDM_FLTCR1_RDMAEN) != DFSDM_FLTCR1_RDMAEN) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check parameters compatibility */ |
| else if((hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->hdmaReg->Init.Mode == DMA_NORMAL) && \ |
| (Length != 1U)) |
| { |
| status = HAL_ERROR; |
| } |
| else if((hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->hdmaReg->Init.Mode == DMA_CIRCULAR)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check DFSDM filter state */ |
| else if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ)) |
| { |
| /* Set callbacks on DMA handler */ |
| hdfsdm_filter->hdmaReg->XferCpltCallback = DFSDM_DMARegularConvCplt; |
| hdfsdm_filter->hdmaReg->XferErrorCallback = DFSDM_DMAError; |
| hdfsdm_filter->hdmaReg->XferHalfCpltCallback = (hdfsdm_filter->hdmaReg->Init.Mode == DMA_CIRCULAR) ?\ |
| DFSDM_DMARegularHalfConvCplt : NULL; |
| |
| /* Start DMA in interrupt mode */ |
| if(HAL_DMA_Start_IT(hdfsdm_filter->hdmaReg, (uint32_t)(&hdfsdm_filter->Instance->FLTRDATAR) + 2U, \ |
| (uint32_t) pData, Length) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Start regular conversion */ |
| DFSDM_RegConvStart(hdfsdm_filter); |
| } |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop regular conversion in DMA mode. |
| * @note This function should be called only if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterRegularStop_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop current DMA transfer */ |
| if(HAL_DMA_Abort(hdfsdm_filter->hdmaReg) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop regular conversion */ |
| DFSDM_RegConvStop(hdfsdm_filter); |
| } |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to get regular conversion value. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Corresponding channel of regular conversion. |
| * @retval Regular conversion value |
| */ |
| int32_t HAL_DFSDM_FilterGetRegularValue(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t *Channel) |
| { |
| uint32_t reg; |
| int32_t value; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(Channel != (void *)0); |
| |
| /* Get value of data register for regular channel */ |
| reg = hdfsdm_filter->Instance->FLTRDATAR; |
| |
| /* Extract channel and regular conversion value */ |
| *Channel = (reg & DFSDM_FLTRDATAR_RDATACH); |
| /* Regular conversion value is a signed value located on 24 MSB of register */ |
| /* So after applying a mask on these bits we have to perform a division by 256 (2 raised to the power of 8) */ |
| reg &= DFSDM_FLTRDATAR_RDATA; |
| value = ((int32_t)reg) / 256; |
| |
| /* return regular conversion value */ |
| return value; |
| } |
| |
| /** |
| * @brief This function allows to start injected conversion in polling mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG)) |
| { |
| /* Start injected conversion */ |
| DFSDM_InjConvStart(hdfsdm_filter); |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to poll for the end of injected conversion. |
| * @note This function should be called only if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Timeout Timeout value in milliseconds. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterPollForInjConversion(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Timeout) |
| { |
| uint32_t tickstart; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_INJ) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| return HAL_ERROR; |
| } |
| else |
| { |
| /* Get timeout */ |
| tickstart = HAL_GetTick(); |
| |
| /* Wait end of injected conversions */ |
| while((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_JEOCF) != DFSDM_FLTISR_JEOCF) |
| { |
| /* Check the Timeout */ |
| if(Timeout != HAL_MAX_DELAY) |
| { |
| if(((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0U)) |
| { |
| /* Return timeout status */ |
| return HAL_TIMEOUT; |
| } |
| } |
| } |
| /* Check if overrun occurs */ |
| if((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_JOVRF) == DFSDM_FLTISR_JOVRF) |
| { |
| /* Update error code and call error callback */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INJECTED_OVERRUN; |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->ErrorCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterErrorCallback(hdfsdm_filter); |
| #endif |
| |
| /* Clear injected overrun flag */ |
| hdfsdm_filter->Instance->FLTICR = DFSDM_FLTICR_CLRJOVRF; |
| } |
| |
| /* Update remaining injected conversions */ |
| hdfsdm_filter->InjConvRemaining--; |
| if(hdfsdm_filter->InjConvRemaining == 0U) |
| { |
| /* Update DFSDM filter state only if trigger is software */ |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_REG; |
| } |
| |
| /* end of injected sequence, reset the value */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| } |
| |
| /* Return function status */ |
| return HAL_OK; |
| } |
| } |
| |
| /** |
| * @brief This function allows to stop injected conversion in polling mode. |
| * @note This function should be called only if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_INJ) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop injected conversion */ |
| DFSDM_InjConvStop(hdfsdm_filter); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start injected conversion in interrupt mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if regular conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStart_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG)) |
| { |
| /* Enable interrupts for injected conversions */ |
| hdfsdm_filter->Instance->FLTCR2 |= (DFSDM_FLTCR2_JEOCIE | DFSDM_FLTCR2_JOVRIE); |
| |
| /* Start injected conversion */ |
| DFSDM_InjConvStart(hdfsdm_filter); |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop injected conversion in interrupt mode. |
| * @note This function should be called only if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStop_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_INJ) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Disable interrupts for injected conversions */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_JEOCIE | DFSDM_FLTCR2_JOVRIE); |
| |
| /* Stop injected conversion */ |
| DFSDM_InjConvStop(hdfsdm_filter); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start injected conversion in DMA mode. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if regular conversion is ongoing. |
| * Please note that data on buffer will contain signed injected conversion |
| * value on 24 most significant bits and corresponding channel on 3 least |
| * significant bits. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param pData The destination buffer address. |
| * @param Length The length of data to be transferred from DFSDM filter to memory. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStart_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| int32_t *pData, |
| uint32_t Length) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check destination address and length */ |
| if((pData == NULL) || (Length == 0U)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check that DMA is enabled for injected conversion */ |
| else if((hdfsdm_filter->Instance->FLTCR1 & DFSDM_FLTCR1_JDMAEN) != DFSDM_FLTCR1_JDMAEN) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check parameters compatibility */ |
| else if((hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->hdmaInj->Init.Mode == DMA_NORMAL) && \ |
| (Length > hdfsdm_filter->InjConvRemaining)) |
| { |
| status = HAL_ERROR; |
| } |
| else if((hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->hdmaInj->Init.Mode == DMA_CIRCULAR)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check DFSDM filter state */ |
| else if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG)) |
| { |
| /* Set callbacks on DMA handler */ |
| hdfsdm_filter->hdmaInj->XferCpltCallback = DFSDM_DMAInjectedConvCplt; |
| hdfsdm_filter->hdmaInj->XferErrorCallback = DFSDM_DMAError; |
| hdfsdm_filter->hdmaInj->XferHalfCpltCallback = (hdfsdm_filter->hdmaInj->Init.Mode == DMA_CIRCULAR) ?\ |
| DFSDM_DMAInjectedHalfConvCplt : NULL; |
| |
| /* Start DMA in interrupt mode */ |
| if(HAL_DMA_Start_IT(hdfsdm_filter->hdmaInj, (uint32_t)&hdfsdm_filter->Instance->FLTJDATAR, \ |
| (uint32_t) pData, Length) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Start injected conversion */ |
| DFSDM_InjConvStart(hdfsdm_filter); |
| } |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start injected conversion in DMA mode and to get |
| * only the 16 most significant bits of conversion. |
| * @note This function should be called only when DFSDM filter instance is |
| * in idle state or if regular conversion is ongoing. |
| * Please note that data on buffer will contain signed 16 most significant |
| * bits of injected conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param pData The destination buffer address. |
| * @param Length The length of data to be transferred from DFSDM filter to memory. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedMsbStart_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| int16_t *pData, |
| uint32_t Length) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check destination address and length */ |
| if((pData == NULL) || (Length == 0U)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check that DMA is enabled for injected conversion */ |
| else if((hdfsdm_filter->Instance->FLTCR1 & DFSDM_FLTCR1_JDMAEN) != DFSDM_FLTCR1_JDMAEN) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check parameters compatibility */ |
| else if((hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->hdmaInj->Init.Mode == DMA_NORMAL) && \ |
| (Length > hdfsdm_filter->InjConvRemaining)) |
| { |
| status = HAL_ERROR; |
| } |
| else if((hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) && \ |
| (hdfsdm_filter->hdmaInj->Init.Mode == DMA_CIRCULAR)) |
| { |
| status = HAL_ERROR; |
| } |
| /* Check DFSDM filter state */ |
| else if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG)) |
| { |
| /* Set callbacks on DMA handler */ |
| hdfsdm_filter->hdmaInj->XferCpltCallback = DFSDM_DMAInjectedConvCplt; |
| hdfsdm_filter->hdmaInj->XferErrorCallback = DFSDM_DMAError; |
| hdfsdm_filter->hdmaInj->XferHalfCpltCallback = (hdfsdm_filter->hdmaInj->Init.Mode == DMA_CIRCULAR) ?\ |
| DFSDM_DMAInjectedHalfConvCplt : NULL; |
| |
| /* Start DMA in interrupt mode */ |
| if(HAL_DMA_Start_IT(hdfsdm_filter->hdmaInj, (uint32_t)(&hdfsdm_filter->Instance->FLTJDATAR) + 2U, \ |
| (uint32_t) pData, Length) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Start injected conversion */ |
| DFSDM_InjConvStart(hdfsdm_filter); |
| } |
| } |
| else |
| { |
| status = HAL_ERROR; |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop injected conversion in DMA mode. |
| * @note This function should be called only if injected conversion is ongoing. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterInjectedStop_DMA(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_INJ) && \ |
| (hdfsdm_filter->State != HAL_DFSDM_FILTER_STATE_REG_INJ)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop current DMA transfer */ |
| if(HAL_DMA_Abort(hdfsdm_filter->hdmaInj) != HAL_OK) |
| { |
| /* Set DFSDM filter in error state */ |
| hdfsdm_filter->State = HAL_DFSDM_FILTER_STATE_ERROR; |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Stop regular conversion */ |
| DFSDM_InjConvStop(hdfsdm_filter); |
| } |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to get injected conversion value. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Corresponding channel of injected conversion. |
| * @retval Injected conversion value |
| */ |
| int32_t HAL_DFSDM_FilterGetInjectedValue(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t *Channel) |
| { |
| uint32_t reg; |
| int32_t value; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(Channel != (void *)0); |
| |
| /* Get value of data register for injected channel */ |
| reg = hdfsdm_filter->Instance->FLTJDATAR; |
| |
| /* Extract channel and injected conversion value */ |
| *Channel = (reg & DFSDM_FLTJDATAR_JDATACH); |
| /* Injected conversion value is a signed value located on 24 MSB of register */ |
| /* So after applying a mask on these bits we have to perform a division by 256 (2 raised to the power of 8) */ |
| reg &= DFSDM_FLTJDATAR_JDATA; |
| value = ((int32_t)reg) / 256; |
| |
| /* return regular conversion value */ |
| return value; |
| } |
| |
| /** |
| * @brief This function allows to start filter analog watchdog in interrupt mode. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param awdParam DFSDM filter analog watchdog parameters. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterAwdStart_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| const DFSDM_Filter_AwdParamTypeDef *awdParam) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(IS_DFSDM_FILTER_AWD_DATA_SOURCE(awdParam->DataSource)); |
| assert_param(IS_DFSDM_INJECTED_CHANNEL(awdParam->Channel)); |
| assert_param(IS_DFSDM_FILTER_AWD_THRESHOLD(awdParam->HighThreshold)); |
| assert_param(IS_DFSDM_FILTER_AWD_THRESHOLD(awdParam->LowThreshold)); |
| assert_param(IS_DFSDM_BREAK_SIGNALS(awdParam->HighBreakSignal)); |
| assert_param(IS_DFSDM_BREAK_SIGNALS(awdParam->LowBreakSignal)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_RESET) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Set analog watchdog data source */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_AWFSEL); |
| hdfsdm_filter->Instance->FLTCR1 |= awdParam->DataSource; |
| |
| /* Set thresholds and break signals */ |
| hdfsdm_filter->Instance->FLTAWHTR &= ~(DFSDM_FLTAWHTR_AWHT | DFSDM_FLTAWHTR_BKAWH); |
| hdfsdm_filter->Instance->FLTAWHTR |= (((uint32_t) awdParam->HighThreshold << DFSDM_FLTAWHTR_AWHT_Pos) | \ |
| awdParam->HighBreakSignal); |
| hdfsdm_filter->Instance->FLTAWLTR &= ~(DFSDM_FLTAWLTR_AWLT | DFSDM_FLTAWLTR_BKAWL); |
| hdfsdm_filter->Instance->FLTAWLTR |= (((uint32_t) awdParam->LowThreshold << DFSDM_FLTAWLTR_AWLT_Pos) | \ |
| awdParam->LowBreakSignal); |
| |
| /* Set channels and interrupt for analog watchdog */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_AWDCH); |
| hdfsdm_filter->Instance->FLTCR2 |= (((awdParam->Channel & DFSDM_LSB_MASK) << DFSDM_FLTCR2_AWDCH_Pos) | \ |
| DFSDM_FLTCR2_AWDIE); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop filter analog watchdog in interrupt mode. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterAwdStop_IT(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_RESET) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Reset channels for analog watchdog and deactivate interrupt */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_AWDCH | DFSDM_FLTCR2_AWDIE); |
| |
| /* Clear all analog watchdog flags */ |
| hdfsdm_filter->Instance->FLTAWCFR = (DFSDM_FLTAWCFR_CLRAWHTF | DFSDM_FLTAWCFR_CLRAWLTF); |
| |
| /* Reset thresholds and break signals */ |
| hdfsdm_filter->Instance->FLTAWHTR &= ~(DFSDM_FLTAWHTR_AWHT | DFSDM_FLTAWHTR_BKAWH); |
| hdfsdm_filter->Instance->FLTAWLTR &= ~(DFSDM_FLTAWLTR_AWLT | DFSDM_FLTAWLTR_BKAWL); |
| |
| /* Reset analog watchdog data source */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_AWFSEL); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to start extreme detector feature. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Channels where extreme detector is enabled. |
| * This parameter can be a values combination of @ref DFSDM_Channel_Selection. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterExdStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Channel) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(IS_DFSDM_INJECTED_CHANNEL(Channel)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_RESET) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Set channels for extreme detector */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_EXCH); |
| hdfsdm_filter->Instance->FLTCR2 |= ((Channel & DFSDM_LSB_MASK) << DFSDM_FLTCR2_EXCH_Pos); |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to stop extreme detector feature. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_DFSDM_FilterExdStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| __IO uint32_t reg1; |
| __IO uint32_t reg2; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Check DFSDM filter state */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_RESET) || \ |
| (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_ERROR)) |
| { |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| else |
| { |
| /* Reset channels for extreme detector */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_EXCH); |
| |
| /* Clear extreme detector values */ |
| reg1 = hdfsdm_filter->Instance->FLTEXMAX; |
| reg2 = hdfsdm_filter->Instance->FLTEXMIN; |
| UNUSED(reg1); /* To avoid GCC warning */ |
| UNUSED(reg2); /* To avoid GCC warning */ |
| } |
| /* Return function status */ |
| return status; |
| } |
| |
| /** |
| * @brief This function allows to get extreme detector maximum value. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Corresponding channel. |
| * @retval Extreme detector maximum value |
| * This value is between Min_Data = -8388608 and Max_Data = 8388607. |
| */ |
| int32_t HAL_DFSDM_FilterGetExdMaxValue(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t *Channel) |
| { |
| uint32_t reg; |
| int32_t value; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(Channel != (void *)0); |
| |
| /* Get value of extreme detector maximum register */ |
| reg = hdfsdm_filter->Instance->FLTEXMAX; |
| |
| /* Extract channel and extreme detector maximum value */ |
| *Channel = (reg & DFSDM_FLTEXMAX_EXMAXCH); |
| /* Extreme detector maximum value is a signed value located on 24 MSB of register */ |
| /* So after applying a mask on these bits we have to perform a division by 256 (2 raised to the power of 8) */ |
| reg &= DFSDM_FLTEXMAX_EXMAX; |
| value = ((int32_t)reg) / 256; |
| |
| /* return extreme detector maximum value */ |
| return value; |
| } |
| |
| /** |
| * @brief This function allows to get extreme detector minimum value. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Corresponding channel. |
| * @retval Extreme detector minimum value |
| * This value is between Min_Data = -8388608 and Max_Data = 8388607. |
| */ |
| int32_t HAL_DFSDM_FilterGetExdMinValue(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t *Channel) |
| { |
| uint32_t reg; |
| int32_t value; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| assert_param(Channel != (void *)0); |
| |
| /* Get value of extreme detector minimum register */ |
| reg = hdfsdm_filter->Instance->FLTEXMIN; |
| |
| /* Extract channel and extreme detector minimum value */ |
| *Channel = (reg & DFSDM_FLTEXMIN_EXMINCH); |
| /* Extreme detector minimum value is a signed value located on 24 MSB of register */ |
| /* So after applying a mask on these bits we have to perform a division by 256 (2 raised to the power of 8) */ |
| reg &= DFSDM_FLTEXMIN_EXMIN; |
| value = ((int32_t)reg) / 256; |
| |
| /* return extreme detector minimum value */ |
| return value; |
| } |
| |
| /** |
| * @brief This function allows to get conversion time value. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval Conversion time value |
| * @note To get time in second, this value has to be divided by DFSDM clock frequency. |
| */ |
| uint32_t HAL_DFSDM_FilterGetConvTimeValue(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| uint32_t reg; |
| uint32_t value; |
| |
| /* Check parameters */ |
| assert_param(IS_DFSDM_FILTER_ALL_INSTANCE(hdfsdm_filter->Instance)); |
| |
| /* Get value of conversion timer register */ |
| reg = hdfsdm_filter->Instance->FLTCNVTIMR; |
| |
| /* Extract conversion time value */ |
| value = ((reg & DFSDM_FLTCNVTIMR_CNVCNT) >> DFSDM_FLTCNVTIMR_CNVCNT_Pos); |
| |
| /* return extreme detector minimum value */ |
| return value; |
| } |
| |
| /** |
| * @brief This function handles the DFSDM interrupts. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| void HAL_DFSDM_IRQHandler(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| DFSDM_Channel_HandleTypeDef **channelHandleTable; |
| const DFSDM_Filter_TypeDef *filter0Instance; |
| uint32_t channelNumber; |
| |
| /* Get FTLISR and FLTCR2 register values */ |
| const uint32_t temp_fltisr = hdfsdm_filter->Instance->FLTISR; |
| const uint32_t temp_fltcr2 = hdfsdm_filter->Instance->FLTCR2; |
| |
| #if defined(DFSDM2_Channel0) |
| if (IS_DFSDM1_FILTER_INSTANCE(hdfsdm_filter->Instance)) |
| { |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| filter0Instance = DFSDM1_Filter0; |
| channelNumber = DFSDM1_CHANNEL_NUMBER; |
| } |
| else |
| { |
| channelHandleTable = a_dfsdm2ChannelHandle; |
| filter0Instance = DFSDM2_Filter0; |
| channelNumber = DFSDM2_CHANNEL_NUMBER; |
| } |
| #else /* DFSDM2_Channel0 */ |
| channelHandleTable = a_dfsdm1ChannelHandle; |
| filter0Instance = DFSDM1_Filter0; |
| channelNumber = DFSDM1_CHANNEL_NUMBER; |
| #endif /* DFSDM2_Channel0 */ |
| |
| /* Check if overrun occurs during regular conversion */ |
| if(((temp_fltisr & DFSDM_FLTISR_ROVRF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_ROVRIE) != 0U)) |
| { |
| /* Clear regular overrun flag */ |
| hdfsdm_filter->Instance->FLTICR = DFSDM_FLTICR_CLRROVRF; |
| |
| /* Update error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_REGULAR_OVERRUN; |
| |
| /* Call error callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->ErrorCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterErrorCallback(hdfsdm_filter); |
| #endif |
| } |
| /* Check if overrun occurs during injected conversion */ |
| else if(((temp_fltisr & DFSDM_FLTISR_JOVRF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_JOVRIE) != 0U)) |
| { |
| /* Clear injected overrun flag */ |
| hdfsdm_filter->Instance->FLTICR = DFSDM_FLTICR_CLRJOVRF; |
| |
| /* Update error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_INJECTED_OVERRUN; |
| |
| /* Call error callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->ErrorCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterErrorCallback(hdfsdm_filter); |
| #endif |
| } |
| /* Check if end of regular conversion */ |
| else if(((temp_fltisr & DFSDM_FLTISR_REOCF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_REOCIE) != 0U)) |
| { |
| /* Call regular conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->RegConvCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterRegConvCpltCallback(hdfsdm_filter); |
| #endif |
| |
| /* End of conversion if mode is not continuous and software trigger */ |
| if((hdfsdm_filter->RegularContMode == DFSDM_CONTINUOUS_CONV_OFF) && \ |
| (hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER)) |
| { |
| /* Disable interrupts for regular conversions */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_REOCIE); |
| |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_INJ; |
| } |
| } |
| /* Check if end of injected conversion */ |
| else if(((temp_fltisr & DFSDM_FLTISR_JEOCF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_JEOCIE) != 0U)) |
| { |
| /* Call injected conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->InjConvCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterInjConvCpltCallback(hdfsdm_filter); |
| #endif |
| |
| /* Update remaining injected conversions */ |
| hdfsdm_filter->InjConvRemaining--; |
| if(hdfsdm_filter->InjConvRemaining == 0U) |
| { |
| /* End of conversion if trigger is software */ |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| /* Disable interrupts for injected conversions */ |
| hdfsdm_filter->Instance->FLTCR2 &= ~(DFSDM_FLTCR2_JEOCIE); |
| |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_REG; |
| } |
| /* end of injected sequence, reset the value */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| } |
| } |
| /* Check if analog watchdog occurs */ |
| else if(((temp_fltisr & DFSDM_FLTISR_AWDF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_AWDIE) != 0U)) |
| { |
| uint32_t reg; |
| uint32_t threshold; |
| uint32_t channel = 0; |
| |
| /* Get channel and threshold */ |
| reg = hdfsdm_filter->Instance->FLTAWSR; |
| threshold = ((reg & DFSDM_FLTAWSR_AWLTF) != 0U) ? DFSDM_AWD_LOW_THRESHOLD : DFSDM_AWD_HIGH_THRESHOLD; |
| if(threshold == DFSDM_AWD_HIGH_THRESHOLD) |
| { |
| reg = reg >> DFSDM_FLTAWSR_AWHTF_Pos; |
| } |
| while (((reg & 1U) == 0U) && (channel < (channelNumber - 1U))) |
| { |
| channel++; |
| reg = reg >> 1; |
| } |
| /* Clear analog watchdog flag */ |
| hdfsdm_filter->Instance->FLTAWCFR = (threshold == DFSDM_AWD_HIGH_THRESHOLD) ? \ |
| (1UL << (DFSDM_FLTAWSR_AWHTF_Pos + channel)) : \ |
| (1UL << channel); |
| |
| /* Call analog watchdog callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->AwdCallback(hdfsdm_filter, channel, threshold); |
| #else |
| HAL_DFSDM_FilterAwdCallback(hdfsdm_filter, channel, threshold); |
| #endif |
| } |
| /* Check if clock absence occurs */ |
| else if((hdfsdm_filter->Instance == filter0Instance) && \ |
| ((temp_fltisr & DFSDM_FLTISR_CKABF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_CKABIE) != 0U)) |
| { |
| uint32_t reg; |
| uint32_t channel = 0; |
| |
| reg = ((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_CKABF) >> DFSDM_FLTISR_CKABF_Pos); |
| |
| while (channel < channelNumber) |
| { |
| /* Check if flag is set and corresponding channel is enabled */ |
| if (((reg & 1U) != 0U) && (channelHandleTable[channel] != NULL)) |
| { |
| /* Check clock absence has been enabled for this channel */ |
| if ((channelHandleTable[channel]->Instance->CHCFGR1 & DFSDM_CHCFGR1_CKABEN) != 0U) |
| { |
| /* Clear clock absence flag */ |
| hdfsdm_filter->Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRCKABF_Pos + channel)); |
| |
| /* Call clock absence callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| channelHandleTable[channel]->CkabCallback(channelHandleTable[channel]); |
| #else |
| HAL_DFSDM_ChannelCkabCallback(channelHandleTable[channel]); |
| #endif |
| } |
| } |
| channel++; |
| reg = reg >> 1; |
| } |
| } |
| /* Check if short circuit detection occurs */ |
| else if((hdfsdm_filter->Instance == filter0Instance) && \ |
| ((temp_fltisr & DFSDM_FLTISR_SCDF) != 0U) && \ |
| ((temp_fltcr2 & DFSDM_FLTCR2_SCDIE) != 0U)) |
| { |
| uint32_t reg; |
| uint32_t channel = 0; |
| |
| /* Get channel */ |
| reg = ((hdfsdm_filter->Instance->FLTISR & DFSDM_FLTISR_SCDF) >> DFSDM_FLTISR_SCDF_Pos); |
| while (((reg & 1U) == 0U) && (channel < (channelNumber - 1U))) |
| { |
| channel++; |
| reg = reg >> 1; |
| } |
| |
| /* Clear short circuit detection flag */ |
| hdfsdm_filter->Instance->FLTICR = (1UL << (DFSDM_FLTICR_CLRSCDF_Pos + channel)); |
| |
| /* Call short circuit detection callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| channelHandleTable[channel]->ScdCallback(channelHandleTable[channel]); |
| #else |
| HAL_DFSDM_ChannelScdCallback(channelHandleTable[channel]); |
| #endif |
| } |
| } |
| |
| /** |
| * @brief Regular conversion complete callback. |
| * @note In interrupt mode, user has to read conversion value in this function |
| * using HAL_DFSDM_FilterGetRegularValue. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterRegConvCpltCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterRegConvCpltCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief Half regular conversion complete callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterRegConvHalfCpltCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterRegConvHalfCpltCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief Injected conversion complete callback. |
| * @note In interrupt mode, user has to read conversion value in this function |
| * using HAL_DFSDM_FilterGetInjectedValue. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterInjConvCpltCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterInjConvCpltCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief Half injected conversion complete callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterInjConvHalfCpltCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterInjConvHalfCpltCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief Filter analog watchdog callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @param Channel Corresponding channel. |
| * @param Threshold Low or high threshold has been reached. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterAwdCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter, |
| uint32_t Channel, uint32_t Threshold) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| UNUSED(Channel); |
| UNUSED(Threshold); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterAwdCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @brief Error callback. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| __weak void HAL_DFSDM_FilterErrorCallback(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hdfsdm_filter); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_DFSDM_FilterErrorCallback could be implemented in the user file. |
| */ |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup DFSDM_Exported_Functions_Group4_Filter Filter state functions |
| * @brief Filter state functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### Filter state functions ##### |
| ============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Get the DFSDM filter state. |
| (+) Get the DFSDM filter error. |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief This function allows to get the current DFSDM filter handle state. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval DFSDM filter state. |
| */ |
| HAL_DFSDM_Filter_StateTypeDef HAL_DFSDM_FilterGetState(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Return DFSDM filter handle state */ |
| return hdfsdm_filter->State; |
| } |
| |
| /** |
| * @brief This function allows to get the current DFSDM filter error. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval DFSDM filter error code. |
| */ |
| uint32_t HAL_DFSDM_FilterGetError(const DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| return hdfsdm_filter->ErrorCode; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| /* End of exported functions -------------------------------------------------*/ |
| |
| /* Private functions ---------------------------------------------------------*/ |
| /** @addtogroup DFSDM_Private_Functions DFSDM Private Functions |
| * @{ |
| */ |
| |
| /** |
| * @brief DMA half transfer complete callback for regular conversion. |
| * @param hdma DMA handle. |
| * @retval None |
| */ |
| static void DFSDM_DMARegularHalfConvCplt(DMA_HandleTypeDef *hdma) |
| { |
| /* Get DFSDM filter handle */ |
| DFSDM_Filter_HandleTypeDef *hdfsdm_filter = (DFSDM_Filter_HandleTypeDef*) ((DMA_HandleTypeDef*)hdma)->Parent; |
| |
| /* Call regular half conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->RegConvHalfCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterRegConvHalfCpltCallback(hdfsdm_filter); |
| #endif |
| } |
| |
| /** |
| * @brief DMA transfer complete callback for regular conversion. |
| * @param hdma DMA handle. |
| * @retval None |
| */ |
| static void DFSDM_DMARegularConvCplt(DMA_HandleTypeDef *hdma) |
| { |
| /* Get DFSDM filter handle */ |
| DFSDM_Filter_HandleTypeDef *hdfsdm_filter = (DFSDM_Filter_HandleTypeDef*) ((DMA_HandleTypeDef*)hdma)->Parent; |
| |
| /* Call regular conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->RegConvCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterRegConvCpltCallback(hdfsdm_filter); |
| #endif |
| } |
| |
| /** |
| * @brief DMA half transfer complete callback for injected conversion. |
| * @param hdma DMA handle. |
| * @retval None |
| */ |
| static void DFSDM_DMAInjectedHalfConvCplt(DMA_HandleTypeDef *hdma) |
| { |
| /* Get DFSDM filter handle */ |
| DFSDM_Filter_HandleTypeDef *hdfsdm_filter = (DFSDM_Filter_HandleTypeDef*) ((DMA_HandleTypeDef*)hdma)->Parent; |
| |
| /* Call injected half conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->InjConvHalfCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterInjConvHalfCpltCallback(hdfsdm_filter); |
| #endif |
| } |
| |
| /** |
| * @brief DMA transfer complete callback for injected conversion. |
| * @param hdma DMA handle. |
| * @retval None |
| */ |
| static void DFSDM_DMAInjectedConvCplt(DMA_HandleTypeDef *hdma) |
| { |
| /* Get DFSDM filter handle */ |
| DFSDM_Filter_HandleTypeDef *hdfsdm_filter = (DFSDM_Filter_HandleTypeDef*) ((DMA_HandleTypeDef*)hdma)->Parent; |
| |
| /* Call injected conversion complete callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->InjConvCpltCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterInjConvCpltCallback(hdfsdm_filter); |
| #endif |
| } |
| |
| /** |
| * @brief DMA error callback. |
| * @param hdma DMA handle. |
| * @retval None |
| */ |
| static void DFSDM_DMAError(DMA_HandleTypeDef *hdma) |
| { |
| /* Get DFSDM filter handle */ |
| DFSDM_Filter_HandleTypeDef *hdfsdm_filter = (DFSDM_Filter_HandleTypeDef*) ((DMA_HandleTypeDef*)hdma)->Parent; |
| |
| /* Update error code */ |
| hdfsdm_filter->ErrorCode = DFSDM_FILTER_ERROR_DMA; |
| |
| /* Call error callback */ |
| #if (USE_HAL_DFSDM_REGISTER_CALLBACKS == 1) |
| hdfsdm_filter->ErrorCallback(hdfsdm_filter); |
| #else |
| HAL_DFSDM_FilterErrorCallback(hdfsdm_filter); |
| #endif |
| } |
| |
| /** |
| * @brief This function allows to get the number of injected channels. |
| * @param Channels bitfield of injected channels. |
| * @retval Number of injected channels. |
| */ |
| static uint32_t DFSDM_GetInjChannelsNbr(uint32_t Channels) |
| { |
| uint32_t nbChannels = 0; |
| uint32_t tmp; |
| |
| /* Get the number of channels from bitfield */ |
| tmp = (uint32_t)(Channels & DFSDM_LSB_MASK); |
| while(tmp != 0U) |
| { |
| if((tmp & 1U) != 0U) |
| { |
| nbChannels++; |
| } |
| tmp = (uint32_t)(tmp >> 1); |
| } |
| return nbChannels; |
| } |
| |
| /** |
| * @brief This function allows to get the channel number from channel instance. |
| * @param Instance DFSDM channel instance. |
| * @retval Channel number. |
| */ |
| static uint32_t DFSDM_GetChannelFromInstance(const DFSDM_Channel_TypeDef* Instance) |
| { |
| uint32_t channel; |
| |
| /* Get channel from instance */ |
| if(Instance == DFSDM1_Channel0) |
| { |
| channel = 0; |
| } |
| #if defined(DFSDM2_Channel0) |
| else if (Instance == DFSDM2_Channel0) |
| { |
| channel = 0; |
| } |
| else if (Instance == DFSDM2_Channel1) |
| { |
| channel = 1; |
| } |
| #endif /* DFSDM2_Channel0 */ |
| else if(Instance == DFSDM1_Channel1) |
| { |
| channel = 1; |
| } |
| else if(Instance == DFSDM1_Channel2) |
| { |
| channel = 2; |
| } |
| else if(Instance == DFSDM1_Channel3) |
| { |
| channel = 3; |
| } |
| else if(Instance == DFSDM1_Channel4) |
| { |
| channel = 4; |
| } |
| else if(Instance == DFSDM1_Channel5) |
| { |
| channel = 5; |
| } |
| else if(Instance == DFSDM1_Channel6) |
| { |
| channel = 6; |
| } |
| else /* DFSDM1_Channel7 */ |
| { |
| channel = 7; |
| } |
| |
| return channel; |
| } |
| |
| /** |
| * @brief This function allows to really start regular conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| static void DFSDM_RegConvStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Check regular trigger */ |
| if(hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| /* Software start of regular conversion */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_RSWSTART; |
| } |
| else /* synchronous trigger */ |
| { |
| /* Disable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_DFEN); |
| |
| /* Set RSYNC bit in DFSDM_FLTCR1 register */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_RSYNC; |
| |
| /* Enable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_DFEN; |
| |
| /* If injected conversion was in progress, restart it */ |
| if(hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ) |
| { |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JSWSTART; |
| } |
| /* Update remaining injected conversions */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| } |
| } |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) ? \ |
| HAL_DFSDM_FILTER_STATE_REG : HAL_DFSDM_FILTER_STATE_REG_INJ; |
| } |
| |
| /** |
| * @brief This function allows to really stop regular conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| static void DFSDM_RegConvStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Disable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_DFEN); |
| |
| /* If regular trigger was synchronous, reset RSYNC bit in DFSDM_FLTCR1 register */ |
| if(hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SYNC_TRIGGER) |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_RSYNC); |
| } |
| |
| /* Enable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_DFEN; |
| |
| /* If injected conversion was in progress, restart it */ |
| if(hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG_INJ) |
| { |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JSWSTART; |
| } |
| /* Update remaining injected conversions */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| } |
| |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_INJ; |
| } |
| |
| /** |
| * @brief This function allows to really start injected conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| static void DFSDM_InjConvStart(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Check injected trigger */ |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SW_TRIGGER) |
| { |
| /* Software start of injected conversion */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JSWSTART; |
| } |
| else /* external or synchronous trigger */ |
| { |
| /* Disable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_DFEN); |
| |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SYNC_TRIGGER) |
| { |
| /* Set JSYNC bit in DFSDM_FLTCR1 register */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_JSYNC; |
| } |
| else /* external trigger */ |
| { |
| /* Set JEXTEN[1:0] bits in DFSDM_FLTCR1 register */ |
| hdfsdm_filter->Instance->FLTCR1 |= hdfsdm_filter->ExtTriggerEdge; |
| } |
| |
| /* Enable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_DFEN; |
| |
| /* If regular conversion was in progress, restart it */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG) && \ |
| (hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER)) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_RSWSTART; |
| } |
| } |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_READY) ? \ |
| HAL_DFSDM_FILTER_STATE_INJ : HAL_DFSDM_FILTER_STATE_REG_INJ; |
| } |
| |
| /** |
| * @brief This function allows to really stop injected conversion. |
| * @param hdfsdm_filter DFSDM filter handle. |
| * @retval None |
| */ |
| static void DFSDM_InjConvStop(DFSDM_Filter_HandleTypeDef *hdfsdm_filter) |
| { |
| /* Disable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_DFEN); |
| |
| /* If injected trigger was synchronous, reset JSYNC bit in DFSDM_FLTCR1 register */ |
| if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_SYNC_TRIGGER) |
| { |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_JSYNC); |
| } |
| else if(hdfsdm_filter->InjectedTrigger == DFSDM_FILTER_EXT_TRIGGER) |
| { |
| /* Reset JEXTEN[1:0] bits in DFSDM_FLTCR1 register */ |
| hdfsdm_filter->Instance->FLTCR1 &= ~(DFSDM_FLTCR1_JEXTEN); |
| } |
| else |
| { |
| /* Nothing to do */ |
| } |
| |
| /* Enable DFSDM filter */ |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_DFEN; |
| |
| /* If regular conversion was in progress, restart it */ |
| if((hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_REG_INJ) && \ |
| (hdfsdm_filter->RegularTrigger == DFSDM_FILTER_SW_TRIGGER)) |
| { |
| hdfsdm_filter->Instance->FLTCR1 |= DFSDM_FLTCR1_RSWSTART; |
| } |
| |
| /* Update remaining injected conversions */ |
| hdfsdm_filter->InjConvRemaining = (hdfsdm_filter->InjectedScanMode == ENABLE) ? \ |
| hdfsdm_filter->InjectedChannelsNbr : 1U; |
| |
| /* Update DFSDM filter state */ |
| hdfsdm_filter->State = (hdfsdm_filter->State == HAL_DFSDM_FILTER_STATE_INJ) ? \ |
| HAL_DFSDM_FILTER_STATE_READY : HAL_DFSDM_FILTER_STATE_REG; |
| } |
| |
| /** |
| * @} |
| */ |
| /* End of private functions --------------------------------------------------*/ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* HAL_DFSDM_MODULE_ENABLED */ |
| |
| /** |
| * @} |
| */ |
| |