text: /**
    ******************************************************************************
    * @file    stm32f3xx_hal_sdadc.h
    * @author  MCD Application Team
    * @brief   This file contains all the functions prototypes for the SDADC
    *          firmware library.
    ******************************************************************************
    * @attention
    *
    * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
    *
    * Redistribution and use in source and binary forms, with or without modification,
    * are permitted provided that the following conditions are met:
    *   1. Redistributions of source code must retain the above copyright notice,
    *      this list of conditions and the following disclaimer.
    *   2. Redistributions in binary form must reproduce the above copyright notice,
    *      this list of conditions and the following disclaimer in the documentation
    *      and/or other materials provided with the distribution.
    *   3. Neither the name of STMicroelectronics nor the names of its contributors
    *      may be used to endorse or promote products derived from this software
    *      without specific prior written permission.
    *
    * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
    * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
    * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    *
    ******************************************************************************
    */
  
  /* Define to prevent recursive inclusion -------------------------------------*/
  #ifndef __STM32F3xx_SDADC_H
  #define __STM32F3xx_SDADC_H
  
  #ifdef __cplusplus
   extern "C" {
  #endif
  
  #if defined(STM32F373xC) || defined(STM32F378xx)
  
  /* Includes ------------------------------------------------------------------*/
  #include "stm32f3xx_hal_def.h"
  
  /** @addtogroup STM32F3xx_HAL_Driver
    * @{
    */
  
  /** @addtogroup SDADC
    * @{
    */ 
  
  /* Exported types ------------------------------------------------------------*/
  /** @defgroup SDADC_Exported_Types SDADC Exported Types
    * @{
    */
  
  
  /** 
    * @brief  HAL SDADC States definition  
    */ 
  typedef enum
  {
    HAL_SDADC_STATE_RESET                   = 0x00U,    /*!< SDADC not initialized */
    HAL_SDADC_STATE_READY                   = 0x01U,    /*!< SDADC initialized and ready for use */
    HAL_SDADC_STATE_CALIB                   = 0x02U,    /*!< SDADC calibration in progress */
    HAL_SDADC_STATE_REG                     = 0x03U,    /*!< SDADC regular conversion in progress */
    HAL_SDADC_STATE_INJ                     = 0x04U,    /*!< SDADC injected conversion in progress */
    HAL_SDADC_STATE_REG_INJ                 = 0x05U,    /*!< SDADC regular and injected conversions in progress */
    HAL_SDADC_STATE_ERROR                   = 0xFFU,    /*!< SDADC state error */
  }HAL_SDADC_StateTypeDef;
     
  /** 
    * @brief SDADC Init Structure definition  
    */ 
  typedef struct
  {
    uint32_t IdleLowPowerMode;        /*!< Specifies if SDADC can enter in power down or standby when idle.
                                           This parameter can be a value of @ref SDADC_Idle_Low_Power_Mode */
    uint32_t FastConversionMode;      /*!< Specifies if Fast conversion mode is enabled or not. 
                                           This parameter can be a value of @ref SDADC_Fast_Conv_Mode */
    uint32_t SlowClockMode;           /*!< Specifies if slow clock mode is enabled or not. 
                                           This parameter can be a value of @ref SDADC_Slow_Clock_Mode */
    uint32_t ReferenceVoltage;        /*!< Specifies the reference voltage.
                                           Note: This parameter is common to all SDADC instances.
                                           This parameter can be a value of @ref SDADC_Reference_Voltage */
  }SDADC_InitTypeDef;
  
  /** 
    * @brief  SDADC handle Structure definition  
    */  
  typedef struct
  {
    SDADC_TypeDef            *Instance;           /*!< SDADC registers base address */
    SDADC_InitTypeDef        Init;                /*!< SDADC init parameters        */
    DMA_HandleTypeDef        *hdma;               /*!< SDADC DMA Handle parameters  */
    uint32_t                 RegularContMode;     /*!< Regular conversion continuous mode */
    uint32_t                 InjectedContMode;    /*!< Injected conversion continuous mode */
    uint32_t                 InjectedChannelsNbr; /*!< Number of channels in injected sequence */
    uint32_t                 InjConvRemaining;    /*!< Injected conversion remaining */
    uint32_t                 RegularTrigger;      /*!< Current trigger used for regular conversion */
    uint32_t                 InjectedTrigger;     /*!< Current trigger used for injected conversion */
    uint32_t                 ExtTriggerEdge;      /*!< Rising, falling or both edges selected */
    uint32_t                 RegularMultimode;    /*!< current type of regular multimode */
    uint32_t                 InjectedMultimode;   /*!< Current type of injected multimode */
    HAL_SDADC_StateTypeDef   State;               /*!< SDADC state */
    uint32_t                 ErrorCode;           /*!< SDADC Error code */
  }SDADC_HandleTypeDef;
  
  /** 
    * @brief  SDADC Configuration Register Parameter Structure 
    */
  typedef struct
  {
    uint32_t InputMode;      /*!< Specifies the input mode (single ended, differential...)
                                  This parameter can be any value of @ref SDADC_InputMode */
    uint32_t Gain;           /*!< Specifies the gain setting.
                                  This parameter can be any value of @ref SDADC_Gain */
    uint32_t CommonMode;     /*!< Specifies the common mode setting (VSSA, VDDA, VDDA/2U).
                                  This parameter can be any value of @ref SDADC_CommonMode */
    uint32_t Offset;         /*!< Specifies the 12-bit offset value.
                                  This parameter can be any value lower or equal to 0x00000FFFU */
  }SDADC_ConfParamTypeDef;
  
  /**
    * @}
    */
  
  /* Exported constants --------------------------------------------------------*/
  
  /** @defgroup SDADC_Exported_Constants SDADC Exported Constants
    * @{
    */
  
  /** @defgroup SDADC_Idle_Low_Power_Mode SDADC Idle Low Power Mode
    * @{
    */
  #define SDADC_LOWPOWER_NONE                  (0x00000000UL)
  #define SDADC_LOWPOWER_POWERDOWN             SDADC_CR1_PDI
  #define SDADC_LOWPOWER_STANDBY               SDADC_CR1_SBI
  /**
    * @}
    */
  
  /** @defgroup SDADC_Fast_Conv_Mode SDADC Fast Conversion Mode
    * @{
    */
  #define SDADC_FAST_CONV_DISABLE              (0x00000000UL)
  #define SDADC_FAST_CONV_ENABLE               SDADC_CR2_FAST
  /**
    * @}
    */
  
  /** @defgroup SDADC_Slow_Clock_Mode SDADC Slow Clock Mode
    * @{
    */
  #define SDADC_SLOW_CLOCK_DISABLE             (0x00000000UL)
  #define SDADC_SLOW_CLOCK_ENABLE              SDADC_CR1_SLOWCK
  /**
    * @}
    */
  
  /** @defgroup SDADC_Reference_Voltage SDADC Reference Voltage
    * @{
    */
  #define SDADC_VREF_EXT                       (0x00000000UL) /*!< The reference voltage is forced externally using VREF pin */
  #define SDADC_VREF_VREFINT1                  SDADC_CR1_REFV_0       /*!< The reference voltage is forced internally to 1.22V VREFINT */
  #define SDADC_VREF_VREFINT2                  SDADC_CR1_REFV_1       /*!< The reference voltage is forced internally to 1.8V VREFINT */
  #define SDADC_VREF_VDDA                      SDADC_CR1_REFV         /*!< The reference voltage is forced internally to VDDA */
  /**
    * @}
    */
  
  /** @defgroup SDADC_ConfIndex SDADC Configuration Index
    * @{
    */
    
  #define SDADC_CONF_INDEX_0                     (0x00000000UL) /*!< Configuration 0 Register selected */
  #define SDADC_CONF_INDEX_1                     (0x00000001U) /*!< Configuration 1 Register selected */
  #define SDADC_CONF_INDEX_2                     (0x00000002U) /*!< Configuration 2 Register selected */
  /**
    * @}
    */
  
  /** @defgroup SDADC_InputMode SDADC Input Mode
    * @{
    */
  #define SDADC_INPUT_MODE_DIFF                (0x00000000UL) /*!< Conversions are executed in differential mode */
  #define SDADC_INPUT_MODE_SE_OFFSET           SDADC_CONF0R_SE0_0     /*!< Conversions are executed in single ended offset mode */
  #define SDADC_INPUT_MODE_SE_ZERO_REFERENCE   SDADC_CONF0R_SE0       /*!< Conversions are executed in single ended zero-volt reference mode */
  /**
    * @}
    */
  
  /** @defgroup SDADC_Gain SDADC Gain
    * @{
    */
  #define SDADC_GAIN_1                         (0x00000000UL)  /*!< Gain equal to 1U */
  #define SDADC_GAIN_2                         SDADC_CONF0R_GAIN0_0    /*!< Gain equal to 2U */
  #define SDADC_GAIN_4                         SDADC_CONF0R_GAIN0_1    /*!< Gain equal to 4U */
  #define SDADC_GAIN_8                         (0x00300000U)  /*!< Gain equal to 8U */
  #define SDADC_GAIN_16                        SDADC_CONF0R_GAIN0_2    /*!< Gain equal to 16U */
  #define SDADC_GAIN_32                        (0x00500000U)  /*!< Gain equal to 32U */
  #define SDADC_GAIN_1_2                       SDADC_CONF0R_GAIN0      /*!< Gain equal to 1U/2U */
  /**
    * @}
    */
  
  /** @defgroup SDADC_CommonMode SDADC Common Mode
    * @{
    */
  #define SDADC_COMMON_MODE_VSSA               (0x00000000UL) /*!< Select SDADC VSSA as common mode */
  #define SDADC_COMMON_MODE_VDDA_2             SDADC_CONF0R_COMMON0_0 /*!< Select SDADC VDDA/2 as common mode */
  #define SDADC_COMMON_MODE_VDDA               SDADC_CONF0R_COMMON0_1 /*!< Select SDADC VDDA as common mode */
  /**
    * @}
    */
  
  
  
  /** @defgroup SDADC_Channel_Selection SDADC Channel Selection
    * @{
    */
  
  /* SDADC Channels ------------------------------------------------------------*/
  /* The SDADC channels are defined as follows:
     - in 16-bit LSB the channel mask is set
     - in 16-bit MSB the channel number is set 
     e.g. for channel 5 definition:  
          - the channel mask is 0x00000020 (bit 5 is set) 
          - the channel number 5 is 0x00050000 
          --> Consequently, channel 5 definition is 0x00000020 | 0x00050000 = 0x00050020 */
  #define SDADC_CHANNEL_0                              (0x00000001UL)
  #define SDADC_CHANNEL_1                              (0x00010002UL)
  #define SDADC_CHANNEL_2                              (0x00020004UL)
  #define SDADC_CHANNEL_3                              (0x00030008UL)
  #define SDADC_CHANNEL_4                              (0x00040010UL)
  #define SDADC_CHANNEL_5                              (0x00050020UL)
  #define SDADC_CHANNEL_6                              (0x00060040UL)
  #define SDADC_CHANNEL_7                              (0x00070080UL)
  #define SDADC_CHANNEL_8                              (0x00080100UL)
  /**
    * @}
    */
  
  /** @defgroup SDADC_CalibrationSequence SDADC Calibration Sequence
    * @{
    */ 
  #define SDADC_CALIBRATION_SEQ_1                   (0x00000000UL) /*!< One calibration sequence to calculate offset of conf0 (OFFSET0[11:0]) */
  #define SDADC_CALIBRATION_SEQ_2                   SDADC_CR2_CALIBCNT_0   /*!< Two calibration sequences to calculate offset of conf0 and conf1 (OFFSET0[11:0] and OFFSET1[11:0]) */
  #define SDADC_CALIBRATION_SEQ_3                   SDADC_CR2_CALIBCNT_1   /*!< Three calibration sequences to calculate offset of conf0, conf1 and conf2 (OFFSET0[11:0], OFFSET1[11:0], and OFFSET2[11:0]) */
  /**
    * @}
    */
  
  /** @defgroup SDADC_ContinuousMode SDADC Continuous Mode
    * @{
    */ 
  #define SDADC_CONTINUOUS_CONV_OFF            (0x00000000UL) /*!< Conversion are not continuous */
  #define SDADC_CONTINUOUS_CONV_ON             (0x00000001UL) /*!< Conversion are continuous */
  /**
    * @}
    */
  
  /** @defgroup SDADC_Trigger SDADC Trigger
    * @{
    */ 
  #define SDADC_SOFTWARE_TRIGGER               (0x00000000UL) /*!< Software trigger */
  #define SDADC_SYNCHRONOUS_TRIGGER            (0x00000001UL) /*!< Synchronous with SDADC1 (only for SDADC2 and SDADC3) */
  #define SDADC_EXTERNAL_TRIGGER               (0x00000002UL) /*!< External trigger */
  /**
    * @}
    */
  
  /** @defgroup SDADC_InjectedExtTrigger SDADC Injected External Trigger
    * @{
    */ 
  #define SDADC_EXT_TRIG_TIM13_CC1             (0x00000000UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM14_CC1             (0x00000100UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM16_CC1             (0x00000000UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_TIM17_CC1             (0x00000000UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM12_CC1             (0x00000100UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM12_CC2             (0x00000100UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_TIM15_CC2             (0x00000200UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM2_CC3              (0x00000200UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM2_CC4              (0x00000200UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_TIM3_CC1              (0x00000300UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM3_CC2              (0x00000300UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM3_CC3              (0x00000300UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_TIM4_CC1              (0x00000400UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM4_CC2              (0x00000400UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM4_CC3              (0x00000400UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_TIM19_CC2             (0x00000500UL) /*!< Trigger source for SDADC1 */
  #define SDADC_EXT_TRIG_TIM19_CC3             (0x00000500UL) /*!< Trigger source for SDADC2 */
  #define SDADC_EXT_TRIG_TIM19_CC4             (0x00000500UL) /*!< Trigger source for SDADC3 */
  #define SDADC_EXT_TRIG_EXTI11                (0x00000700UL) /*!< Trigger source for SDADC1, SDADC2 and SDADC3 */
  #define SDADC_EXT_TRIG_EXTI15                (0x00000600UL) /*!< Trigger source for SDADC1, SDADC2 and SDADC3 */
  /**
    * @}
    */
  
  /** @defgroup SDADC_ExtTriggerEdge SDADC External Trigger Edge
    * @{
    */ 
  #define SDADC_EXT_TRIG_RISING_EDGE           SDADC_CR2_JEXTEN_0     /*!< External rising edge */
  #define SDADC_EXT_TRIG_FALLING_EDGE          SDADC_CR2_JEXTEN_1     /*!< External falling edge */
  #define SDADC_EXT_TRIG_BOTH_EDGES            SDADC_CR2_JEXTEN       /*!< External rising and falling edges */
  /**
    * @}
    */
  
  /** @defgroup SDADC_InjectedDelay SDADC Injected Conversion Delay
    * @{
    */ 
  #define SDADC_INJECTED_DELAY_NONE            (0x00000000UL) /*!< No delay on injected conversion */
  #define SDADC_INJECTED_DELAY                 SDADC_CR2_JDS          /*!< Delay on injected conversion */
  /**
    * @}
    */
  
  /** @defgroup SDADC_MultimodeType SDADC Multimode Type
    * @{
    */ 
  #define SDADC_MULTIMODE_SDADC1_SDADC2        (0x00000000UL) /*!< Get conversion values for SDADC1 and SDADC2 */
  #define SDADC_MULTIMODE_SDADC1_SDADC3        (0x00000001U) /*!< Get conversion values for SDADC1 and SDADC3 */
  /**
    * @}
    */
  
  /** @defgroup SDADC_ErrorCode SDADC Error Code
    * @{
    */ 
  #define SDADC_ERROR_NONE                     (0x00000000UL) /*!< No error */
  #define SDADC_ERROR_REGULAR_OVERRUN          (0x00000001UL) /*!< Overrun occurs during regular conversion */
  #define SDADC_ERROR_INJECTED_OVERRUN         (0x00000002UL) /*!< Overrun occurs during injected conversion */
  #define SDADC_ERROR_DMA                      (0x00000003UL) /*!< DMA error occurs */
  /**
    * @}
    */
  
  /** @defgroup SDADC_interrupts_definition SDADC interrupts definition
    * @{
    */
  #define  SDADC_IT_EOCAL     SDADC_CR1_EOCALIE   /*!< End of calibration interrupt enable */
  #define  SDADC_IT_JEOC      SDADC_CR1_JEOCIE    /*!< Injected end of conversion interrupt enable */
  #define  SDADC_IT_JOVR      SDADC_CR1_JOVRIE    /*!< Injected data overrun interrupt enable */
  #define  SDADC_IT_REOC      SDADC_CR1_REOCIE    /*!< Regular end of conversion interrupt enable */
  #define  SDADC_IT_ROVR      SDADC_CR1_ROVRIE    /*!< Regular data overrun interrupt enable */
  /**
    * @}
    */
  
  /** @defgroup SDADC_flags_definition SDADC flags definition
    * @{
    */
  #define SDADC_FLAG_EOCAL    SDADC_ISR_EOCALF    /*!< End of calibration flag */
  #define SDADC_FLAG_JEOC     SDADC_ISR_JEOCF     /*!< End of injected conversion flag */
  #define SDADC_FLAG_JOVR     SDADC_ISR_JOVRF     /*!< Injected conversion overrun flag */
  #define SDADC_FLAG_REOC     SDADC_ISR_REOCF     /*!< End of regular conversion flag */
  #define SDADC_FLAG_ROVR     SDADC_ISR_ROVRF     /*!< Regular conversion overrun flag */
  /**
    * @}
    */
  
  /**
    * @}
    */
  
  /* Exported macros -----------------------------------------------------------*/  
  /** @defgroup SDADC_Exported_Macros SDADC Exported Macros
   * @{
   */
  
  /* Macro for internal HAL driver usage, and possibly can be used into code of */
  /* final user.                                                                */    
         
  /** @brief Enable the ADC end of conversion interrupt.
    * @param __HANDLE__ ADC handle
    * @param __INTERRUPT__ ADC Interrupt
    *          This parameter can be any combination of the following values:
    *            @arg SDADC_IT_EOCAL: End of calibration interrupt enable
    *            @arg SDADC_IT_JEOC: Injected end of conversion interrupt enable
    *            @arg SDADC_IT_JOVR: Injected data overrun interrupt enable
    *            @arg SDADC_IT_REOC: Regular end of conversion interrupt enable
    *            @arg SDADC_IT_ROVR: Regular data overrun interrupt enable
    * @retval None
    */
  #define __HAL_SDADC_ENABLE_IT(__HANDLE__, __INTERRUPT__)                       \
    (SET_BIT((__HANDLE__)->Instance->CR1, (__INTERRUPT__)))
      
  /** @brief Disable the ADC end of conversion interrupt.
    * @param __HANDLE__ ADC handle
    * @param __INTERRUPT__ ADC Interrupt
    *          This parameter can be any combination of the following values:
    *            @arg SDADC_IT_EOCAL: End of calibration interrupt enable
    *            @arg SDADC_IT_JEOC: Injected end of conversion interrupt enable
    *            @arg SDADC_IT_JOVR: Injected data overrun interrupt enable
    *            @arg SDADC_IT_REOC: Regular end of conversion interrupt enable
    *            @arg SDADC_IT_ROVR: Regular data overrun interrupt enable
    * @retval None
    */
  #define __HAL_SDADC_DISABLE_IT(__HANDLE__, __INTERRUPT__)                      \
    (CLEAR_BIT((__HANDLE__)->Instance->CR1, (__INTERRUPT__)))
  
  /** @brief  Checks if the specified ADC interrupt source is enabled or disabled.
    * @param __HANDLE__ ADC handle
    * @param __INTERRUPT__ ADC interrupt source to check
    *          This parameter can be any combination of the following values:
    *            @arg SDADC_IT_EOCAL: End of calibration interrupt enable
    *            @arg SDADC_IT_JEOC: Injected end of conversion interrupt enable
    *            @arg SDADC_IT_JOVR: Injected data overrun interrupt enable
    *            @arg SDADC_IT_REOC: Regular end of conversion interrupt enable
    *            @arg SDADC_IT_ROVR: Regular data overrun interrupt enable
    * @retval State of interruption (SET or RESET)
    */
  #define __HAL_SDADC_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)                   \
    (((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__))
  
  /** @brief Get the selected ADC's flag status.
    * @param __HANDLE__ ADC handle
    * @param __FLAG__ ADC flag
    *          This parameter can be any combination of the following values:
    *            @arg SDADC_FLAG_EOCAL: End of calibration flag
    *            @arg SDADC_FLAG_JEOC: End of injected conversion flag
    *            @arg SDADC_FLAG_JOVR: Injected conversion overrun flag
    *            @arg SDADC_FLAG_REOC: End of regular conversion flag
    *            @arg SDADC_FLAG_ROVR: Regular conversion overrun flag
    * @retval None
    */
  #define __HAL_SDADC_GET_FLAG(__HANDLE__, __FLAG__)                             \
    ((((__HANDLE__)->Instance->ISR) & (__FLAG__)) == (__FLAG__))
      
  /** @brief Clear the ADC's pending flags
    * @param __HANDLE__ ADC handle
    * @param __FLAG__ ADC flag
    *          This parameter can be any combination of the following values:
    *            @arg SDADC_FLAG_EOCAL: End of calibration flag
    *            @arg SDADC_FLAG_JEOC: End of injected conversion flag
    *            @arg SDADC_FLAG_JOVR: Injected conversion overrun flag
    *            @arg SDADC_FLAG_REOC: End of regular conversion flag
    *            @arg SDADC_FLAG_ROVR: Regular conversion overrun flag
    * @retval None
    */
  #define __HAL_SDADC_CLEAR_FLAG(__HANDLE__, __FLAG__)                           \
    (CLEAR_BIT((__HANDLE__)->Instance->ISR, (__FLAG__)))
  
  /** @brief  Reset SDADC handle state
    * @param  __HANDLE__ SDADC handle.
    * @retval None
    */
  #define __HAL_SDADC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SDADC_STATE_RESET)
  
  /**
    * @}
    */
  
  /* Private macros ------------------------------------------------------------*/  
  /** @defgroup SDADC_Private_Macros SDADC Private Macros
   * @{
   */
  
  #define IS_SDADC_LOWPOWER_MODE(LOWPOWER)     (((LOWPOWER) == SDADC_LOWPOWER_NONE)      || \
                                                ((LOWPOWER) == SDADC_LOWPOWER_POWERDOWN) || \
                                                ((LOWPOWER) == SDADC_LOWPOWER_STANDBY))
  
  #define IS_SDADC_FAST_CONV_MODE(FAST)        (((FAST) == SDADC_FAST_CONV_DISABLE) || \
                                                ((FAST) == SDADC_FAST_CONV_ENABLE))
  
  #define IS_SDADC_SLOW_CLOCK_MODE(MODE)       (((MODE) == SDADC_SLOW_CLOCK_DISABLE) || \
                                                ((MODE) == SDADC_SLOW_CLOCK_ENABLE))
  
  #define IS_SDADC_VREF(VREF)                  (((VREF) == SDADC_VREF_EXT)      || \
                                                ((VREF) == SDADC_VREF_VREFINT1) || \
                                                ((VREF) == SDADC_VREF_VREFINT2) || \
                                                ((VREF) == SDADC_VREF_VDDA))
  
  #define IS_SDADC_CONF_INDEX(CONF) (((CONF) == SDADC_CONF_INDEX_0)  || \
                                     ((CONF) == SDADC_CONF_INDEX_1)  || \
                                     ((CONF) == SDADC_CONF_INDEX_2))
  
  #define IS_SDADC_INPUT_MODE(MODE) (((MODE) == SDADC_INPUT_MODE_DIFF)     || \
                                     ((MODE) == SDADC_INPUT_MODE_SE_OFFSET) || \
                                     ((MODE) == SDADC_INPUT_MODE_SE_ZERO_REFERENCE))
  
  #define IS_SDADC_GAIN(GAIN) (((GAIN) == SDADC_GAIN_1)  || \
                               ((GAIN) == SDADC_GAIN_2)  || \
                               ((GAIN) == SDADC_GAIN_4)  || \
                               ((GAIN) == SDADC_GAIN_8)  || \
                               ((GAIN) == SDADC_GAIN_16)  || \
                               ((GAIN) == SDADC_GAIN_32)  || \
                               ((GAIN) == SDADC_GAIN_1_2))
  
  #define IS_SDADC_COMMON_MODE(MODE) (((MODE) == SDADC_COMMON_MODE_VSSA)   || \
                                      ((MODE) == SDADC_COMMON_MODE_VDDA_2) || \
                                      ((MODE) == SDADC_COMMON_MODE_VDDA))
  
  #define IS_SDADC_OFFSET_VALUE(VALUE) ((VALUE) <= 0x00000FFFU)
  
  /* Just one channel of the 9 channels can be selected for regular conversion */
  #define IS_SDADC_REGULAR_CHANNEL(CHANNEL) (((CHANNEL) == SDADC_CHANNEL_0)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_1)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_2)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_3)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_4)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_5)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_6)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_7)  || \
                                             ((CHANNEL) == SDADC_CHANNEL_8))
  
  /* Any or all of the 9 channels can be selected for injected conversion */
  #define IS_SDADC_INJECTED_CHANNEL(CHANNEL) (((CHANNEL) != 0U) && ((CHANNEL) <= 0x000F01FFU))
  
  
  #define IS_SDADC_CALIB_SEQUENCE(SEQUENCE)  (((SEQUENCE) == SDADC_CALIBRATION_SEQ_1)  || \
                                              ((SEQUENCE) == SDADC_CALIBRATION_SEQ_2)  || \
                                              ((SEQUENCE) == SDADC_CALIBRATION_SEQ_3))
  
  #define IS_SDADC_CONTINUOUS_MODE(MODE)       (((MODE) == SDADC_CONTINUOUS_CONV_OFF)  || \
                                               ((MODE) == SDADC_CONTINUOUS_CONV_ON))
  
  
  #define IS_SDADC_REGULAR_TRIGGER(TRIGGER)    (((TRIGGER) == SDADC_SOFTWARE_TRIGGER)  || \
                                               ((TRIGGER) == SDADC_SYNCHRONOUS_TRIGGER))
  
  #define IS_SDADC_INJECTED_TRIGGER(TRIGGER)   (((TRIGGER) == SDADC_SOFTWARE_TRIGGER)  || \
                                               ((TRIGGER) == SDADC_SYNCHRONOUS_TRIGGER)  || \
                                               ((TRIGGER) == SDADC_EXTERNAL_TRIGGER))
  
  
  #define IS_SDADC_EXT_INJEC_TRIG(INJTRIG) (((INJTRIG) == SDADC_EXT_TRIG_TIM13_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM14_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM16_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM17_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM12_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM12_CC2)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM15_CC2)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM2_CC3)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM2_CC4)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM3_CC1)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM3_CC2)  || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM3_CC3) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM4_CC1) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM4_CC2) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM4_CC3) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM19_CC2) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM19_CC3) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_TIM19_CC4) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_EXTI11) || \
                                            ((INJTRIG) == SDADC_EXT_TRIG_EXTI15))
  
  #define IS_SDADC_EXT_TRIG_EDGE(TRIGGER)      (((TRIGGER) == SDADC_EXT_TRIG_RISING_EDGE)  || \
                                               ((TRIGGER) == SDADC_EXT_TRIG_FALLING_EDGE)  || \
                                               ((TRIGGER) == SDADC_EXT_TRIG_BOTH_EDGES))
  
  
  #define IS_SDADC_INJECTED_DELAY(DELAY)       (((DELAY) == SDADC_INJECTED_DELAY_NONE) || \
                                               ((DELAY) == SDADC_INJECTED_DELAY))
  
  #define IS_SDADC_MULTIMODE_TYPE(TYPE)        (((TYPE) == SDADC_MULTIMODE_SDADC1_SDADC2) || \
                                               ((TYPE) == SDADC_MULTIMODE_SDADC1_SDADC3))
  /**
    * @}
    */
  
  /* Exported functions --------------------------------------------------------*/  
  /** @addtogroup SDADC_Exported_Functions SDADC Exported Functions
    * @{
    */
  
  /** @addtogroup SDADC_Exported_Functions_Group1 Initialization and de-initialization functions
    * @{
    */
  
  /* Initialization and de-initialization functions *****************************/
  HAL_StatusTypeDef HAL_SDADC_Init(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_DeInit(SDADC_HandleTypeDef *hsdadc);
  void HAL_SDADC_MspInit(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_MspDeInit(SDADC_HandleTypeDef* hsdadc);
  
  /**
    * @}
    */
  
  /** @addtogroup SDADC_Exported_Functions_Group2 peripheral control functions
    * @{
    */
  
  /* Peripheral Control functions ***********************************************/
  HAL_StatusTypeDef HAL_SDADC_PrepareChannelConfig(SDADC_HandleTypeDef *hsdadc, 
                                                   uint32_t ConfIndex, 
                                                   SDADC_ConfParamTypeDef* ConfParamStruct);
  HAL_StatusTypeDef HAL_SDADC_AssociateChannelConfig(SDADC_HandleTypeDef *hsdadc,
                                                     uint32_t Channel,
                                                     uint32_t ConfIndex);
  HAL_StatusTypeDef HAL_SDADC_ConfigChannel(SDADC_HandleTypeDef *hsdadc,
                                            uint32_t Channel,
                                            uint32_t ContinuousMode);
  HAL_StatusTypeDef HAL_SDADC_InjectedConfigChannel(SDADC_HandleTypeDef *hsdadc,
                                                    uint32_t Channel,
                                                    uint32_t ContinuousMode);
  HAL_StatusTypeDef HAL_SDADC_SelectInjectedExtTrigger(SDADC_HandleTypeDef *hsdadc,
                                                       uint32_t InjectedExtTrigger,
                                                       uint32_t ExtTriggerEdge);
  HAL_StatusTypeDef HAL_SDADC_SelectInjectedDelay(SDADC_HandleTypeDef *hsdadc,
                                                  uint32_t InjectedDelay);
  HAL_StatusTypeDef HAL_SDADC_SelectRegularTrigger(SDADC_HandleTypeDef *hsdadc, uint32_t Trigger);
  HAL_StatusTypeDef HAL_SDADC_SelectInjectedTrigger(SDADC_HandleTypeDef *hsdadc, uint32_t Trigger);
  HAL_StatusTypeDef HAL_SDADC_MultiModeConfigChannel(SDADC_HandleTypeDef* hsdadc, uint32_t MultimodeType);
  HAL_StatusTypeDef HAL_SDADC_InjectedMultiModeConfigChannel(SDADC_HandleTypeDef* hsdadc, uint32_t MultimodeType);
  
  /**
    * @}
    */
  
  /** @addtogroup SDADC_Exported_Functions_Group3 Input and Output operation functions
    * @{
    */
  
  /* IO operation functions *****************************************************/
  HAL_StatusTypeDef HAL_SDADC_CalibrationStart(SDADC_HandleTypeDef *hsdadc, uint32_t CalibrationSequence);
  HAL_StatusTypeDef HAL_SDADC_CalibrationStart_IT(SDADC_HandleTypeDef *hsdadc, uint32_t CalibrationSequence);
  
  HAL_StatusTypeDef HAL_SDADC_Start(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_Start_IT(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_Start_DMA(SDADC_HandleTypeDef *hsdadc, uint32_t *pData, uint32_t Length);
  HAL_StatusTypeDef HAL_SDADC_Stop(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_Stop_IT(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_Stop_DMA(SDADC_HandleTypeDef *hsdadc);
  
  HAL_StatusTypeDef HAL_SDADC_InjectedStart(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_InjectedStart_IT(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_InjectedStart_DMA(SDADC_HandleTypeDef *hsdadc, uint32_t *pData, uint32_t Length);
  HAL_StatusTypeDef HAL_SDADC_InjectedStop(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_InjectedStop_IT(SDADC_HandleTypeDef *hsdadc);
  HAL_StatusTypeDef HAL_SDADC_InjectedStop_DMA(SDADC_HandleTypeDef *hsdadc);
  
  HAL_StatusTypeDef HAL_SDADC_MultiModeStart_DMA(SDADC_HandleTypeDef* hsdadc, uint32_t* pData, uint32_t Length);
  HAL_StatusTypeDef HAL_SDADC_MultiModeStop_DMA(SDADC_HandleTypeDef* hsdadc);
  HAL_StatusTypeDef HAL_SDADC_InjectedMultiModeStart_DMA(SDADC_HandleTypeDef* hsdadc, uint32_t* pData, uint32_t Length);
  HAL_StatusTypeDef HAL_SDADC_InjectedMultiModeStop_DMA(SDADC_HandleTypeDef* hsdadc);
  
  uint32_t HAL_SDADC_GetValue(SDADC_HandleTypeDef *hsdadc);
  uint32_t HAL_SDADC_InjectedGetValue(SDADC_HandleTypeDef *hsdadc, uint32_t* Channel);
  uint32_t HAL_SDADC_MultiModeGetValue(SDADC_HandleTypeDef* hsdadc);
  uint32_t HAL_SDADC_InjectedMultiModeGetValue(SDADC_HandleTypeDef* hsdadc);
                                                 
  void HAL_SDADC_IRQHandler(SDADC_HandleTypeDef* hsdadc);
  
  HAL_StatusTypeDef HAL_SDADC_PollForCalibEvent(SDADC_HandleTypeDef* hsdadc, uint32_t Timeout);
  HAL_StatusTypeDef HAL_SDADC_PollForConversion(SDADC_HandleTypeDef* hsdadc, uint32_t Timeout);
  HAL_StatusTypeDef HAL_SDADC_PollForInjectedConversion(SDADC_HandleTypeDef* hsdadc, uint32_t Timeout);
  
  void HAL_SDADC_CalibrationCpltCallback(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_ConvHalfCpltCallback(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_ConvCpltCallback(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_InjectedConvHalfCpltCallback(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_InjectedConvCpltCallback(SDADC_HandleTypeDef* hsdadc);
  void HAL_SDADC_ErrorCallback(SDADC_HandleTypeDef* hsdadc);
  
  /**
    * @}
    */
  
  /** @defgroup SDADC_Exported_Functions_Group4 Peripheral State functions
    * @{
    */
  
  /* Peripheral State and Error functions ***************************************/
  HAL_SDADC_StateTypeDef HAL_SDADC_GetState(SDADC_HandleTypeDef* hsdadc);
  uint32_t               HAL_SDADC_GetError(SDADC_HandleTypeDef* hsdadc);
  
  /* Private functions ---------------------------------------------------------*/  
  
  /**
    * @}
    */
  
  /**
    * @}
    */
  
  /**
    * @}
    */ 
  
  /**
    * @}
    */
  
  #endif /* defined(STM32F373xC) || defined(STM32F378xx) */
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif /*__STM32F3xx_SDADC_H */
  
  
  /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
  