Subversion Repositories canSerial

/**

/**

  ******************************************************************************

  ******************************************************************************

  * @file    stm32f1xx_hal_adc.c

  * @file    stm32f1xx_hal_adc.c

  * @author  MCD Application Team

  * @author  MCD Application Team

  * @brief   This file provides firmware functions to manage the following

  * @brief   This file provides firmware functions to manage the following

  *          functionalities of the Analog to Digital Convertor (ADC)

  *          functionalities of the Analog to Digital Convertor (ADC)

  *          peripheral:

  *          peripheral:

  *           + Initialization and de-initialization functions

  *           + Initialization and de-initialization functions

  *             ++ Initialization and Configuration of ADC

  *           + Peripheral Control functions

  *           + Operation functions

  *           + Peripheral State functions

  *             ++ Start, stop, get result of conversions of regular

  *          Other functions (extended functions) are available in file

  *                group, using 3 possible modes: polling, interruption or DMA.

  *          "stm32f1xx_hal_adc_ex.c".

  *           + Control functions

  *

  *             ++ Channels configuration on regular group

  ******************************************************************************

  *             ++ Channels configuration on injected group

  * @attention

  *             ++ Analog Watchdog configuration

  *

  *           + State functions

  * Copyright (c) 2016 STMicroelectronics.

  *             ++ ADC state machine management

  * All rights reserved.

  *             ++ Interrupts and flags management

  *

  *          Other functions (extended functions) are available in file

  * This software is licensed under terms that can be found in the LICENSE file

  *          "stm32f1xx_hal_adc_ex.c".

  * in the root directory of this software component.

  *

  * If no LICENSE file comes with this software, it is provided AS-IS.

  @verbatim

  *

  ==============================================================================

  ******************************************************************************

                     ##### ADC peripheral features #####

  @verbatim

  ==============================================================================

  ==============================================================================

  [..]

                     ##### ADC peripheral features #####

  (+) 12-bit resolution

  ==============================================================================

  [..]

  (+) Interrupt generation at the end of regular conversion, end of injected

  (+) 12-bit resolution

      conversion, and in case of analog watchdog or overrun events.

  (+) Interrupt generation at the end of regular conversion, end of injected

  (+) Single and continuous conversion modes.

      conversion, and in case of analog watchdog or overrun events.

  (+) Scan mode for conversion of several channels sequentially.

  (+) Single and continuous conversion modes.

  (+) Data alignment with in-built data coherency.

  (+) Scan mode for conversion of several channels sequentially.

  (+) Programmable sampling time (channel wise)

  (+) Data alignment with in-built data coherency.

  (+) ADC conversion of regular group and injected group.

  (+) Programmable sampling time (channel wise)

  (+) External trigger (timer or EXTI)

  (+) ADC conversion of regular group and injected group.

      for both regular and injected groups.

  (+) External trigger (timer or EXTI)

  (+) DMA request generation for transfer of conversions data of regular group.

      for both regular and injected groups.

  (+) Multimode Dual mode (available on devices with 2 ADCs or more).

  (+) DMA request generation for transfer of conversions data of regular group.

  (+) Configurable DMA data storage in Multimode Dual mode (available on devices

  (+) Multimode Dual mode (available on devices with 2 ADCs or more).

      with 2 DCs or more).

  (+) Configurable DMA data storage in Multimode Dual mode (available on devices

  (+) Configurable delay between conversions in Dual interleaved mode (available

      with 2 DCs or more).

      on devices with 2 DCs or more).

  (+) Configurable delay between conversions in Dual interleaved mode (available

  (+) ADC calibration

      on devices with 2 DCs or more).

  (+) ADC supply requirements: 2.4 V to 3.6 V at full speed and down to 1.8 V at

  (+) ADC calibration

      slower speed.

  (+) ADC supply requirements: 2.4 V to 3.6 V at full speed and down to 1.8 V at

  (+) ADC input range: from Vref- (connected to Vssa) to Vref+ (connected to

      slower speed.

      Vdda or to an external voltage reference).

  (+) ADC input range: from Vref- (connected to Vssa) to Vref+ (connected to

      Vdda or to an external voltage reference).

                     ##### How to use this driver #####

  ==============================================================================

    [..]

                     ##### How to use this driver #####

  ==============================================================================

     *** Configuration of top level parameters related to ADC ***

    [..]

     ============================================================

     [..]

     *** Configuration of top level parameters related to ADC ***

     ============================================================

    (#) Enable the ADC interface

     [..]

      (++) As prerequisite, ADC clock must be configured at RCC top level.

           Caution: On STM32F1, ADC clock frequency max is 14MHz (refer

    (#) Enable the ADC interface

                    to device datasheet).

      (++) As prerequisite, ADC clock must be configured at RCC top level.

                    Therefore, ADC clock prescaler must be configured in

           Caution: On STM32F1, ADC clock frequency max is 14MHz (refer

                    function of ADC clock source frequency to remain below

                    to device datasheet).

                    this maximum frequency.

                    Therefore, ADC clock prescaler must be configured in

        (++) One clock setting is mandatory:

                    function of ADC clock source frequency to remain below

             ADC clock (core clock, also possibly conversion clock).

                    this maximum frequency.

             (+++) Example:

        (++) One clock setting is mandatory:

                   Into HAL_ADC_MspInit() (recommended code location) or with

             ADC clock (core clock, also possibly conversion clock).

                   other device clock parameters configuration:

             (+++) Example:

               (+++) RCC_PeriphCLKInitTypeDef  PeriphClkInit;

                   Into HAL_ADC_MspInit() (recommended code location) or with

               (+++) __ADC1_CLK_ENABLE();

                   other device clock parameters configuration:

               (+++) PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC;

               (+++) RCC_PeriphCLKInitTypeDef  PeriphClkInit;

               (+++) PeriphClkInit.AdcClockSelection = RCC_ADCPCLK2_DIV2;

               (+++) __ADC1_CLK_ENABLE();

               (+++) HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit);

               (+++) PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC;

               (+++) PeriphClkInit.AdcClockSelection = RCC_ADCPCLK2_DIV2;

    (#) ADC pins configuration

               (+++) HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit);

         (++) Enable the clock for the ADC GPIOs

              using macro __HAL_RCC_GPIOx_CLK_ENABLE()

    (#) ADC pins configuration

         (++) Configure these ADC pins in analog mode

         (++) Enable the clock for the ADC GPIOs

              using function HAL_GPIO_Init()

              using macro __HAL_RCC_GPIOx_CLK_ENABLE()

         (++) Configure these ADC pins in analog mode

    (#) Optionally, in case of usage of ADC with interruptions:

              using function HAL_GPIO_Init()

         (++) Configure the NVIC for ADC

              using function HAL_NVIC_EnableIRQ(ADCx_IRQn)

    (#) Optionally, in case of usage of ADC with interruptions:

         (++) Insert the ADC interruption handler function HAL_ADC_IRQHandler()

         (++) Configure the NVIC for ADC

              into the function of corresponding ADC interruption vector

              using function HAL_NVIC_EnableIRQ(ADCx_IRQn)

              ADCx_IRQHandler().

         (++) Insert the ADC interruption handler function HAL_ADC_IRQHandler()

              into the function of corresponding ADC interruption vector

    (#) Optionally, in case of usage of DMA:

              ADCx_IRQHandler().

         (++) Configure the DMA (DMA channel, mode normal or circular, ...)

              using function HAL_DMA_Init().

    (#) Optionally, in case of usage of DMA:

         (++) Configure the NVIC for DMA

         (++) Configure the DMA (DMA channel, mode normal or circular, ...)

              using function HAL_NVIC_EnableIRQ(DMAx_Channelx_IRQn)

              using function HAL_DMA_Init().

         (++) Insert the ADC interruption handler function HAL_ADC_IRQHandler()

         (++) Configure the NVIC for DMA

              into the function of corresponding DMA interruption vector

              using function HAL_NVIC_EnableIRQ(DMAx_Channelx_IRQn)

              DMAx_Channelx_IRQHandler().

         (++) Insert the ADC interruption handler function HAL_ADC_IRQHandler()

              into the function of corresponding DMA interruption vector

     *** Configuration of ADC, groups regular/injected, channels parameters ***

              DMAx_Channelx_IRQHandler().

     ==========================================================================

     [..]

     *** Configuration of ADC, groups regular/injected, channels parameters ***

     ==========================================================================

    (#) Configure the ADC parameters (resolution, data alignment, ...)

     [..]

        and regular group parameters (conversion trigger, sequencer, ...)

        using function HAL_ADC_Init().

    (#) Configure the ADC parameters (resolution, data alignment, ...)

        and regular group parameters (conversion trigger, sequencer, ...)

    (#) Configure the channels for regular group parameters (channel number,

        using function HAL_ADC_Init().

        channel rank into sequencer, ..., into regular group)

        using function HAL_ADC_ConfigChannel().

    (#) Configure the channels for regular group parameters (channel number,

        channel rank into sequencer, ..., into regular group)

    (#) Optionally, configure the injected group parameters (conversion trigger,

        using function HAL_ADC_ConfigChannel().

        sequencer, ..., of injected group)

        and the channels for injected group parameters (channel number,

    (#) Optionally, configure the injected group parameters (conversion trigger,

        channel rank into sequencer, ..., into injected group)

        sequencer, ..., of injected group)

        using function HAL_ADCEx_InjectedConfigChannel().

        and the channels for injected group parameters (channel number,

        channel rank into sequencer, ..., into injected group)

    (#) Optionally, configure the analog watchdog parameters (channels

        using function HAL_ADCEx_InjectedConfigChannel().

        monitored, thresholds, ...)

        using function HAL_ADC_AnalogWDGConfig().

    (#) Optionally, configure the analog watchdog parameters (channels

        monitored, thresholds, ...)

    (#) Optionally, for devices with several ADC instances: configure the

        using function HAL_ADC_AnalogWDGConfig().

        multimode parameters

        using function HAL_ADCEx_MultiModeConfigChannel().

    (#) Optionally, for devices with several ADC instances: configure the

        multimode parameters

     *** Execution of ADC conversions ***

        using function HAL_ADCEx_MultiModeConfigChannel().

     ====================================

     [..]

     *** Execution of ADC conversions ***

     ====================================

    (#) Optionally, perform an automatic ADC calibration to improve the

     [..]

        conversion accuracy

        using function HAL_ADCEx_Calibration_Start().

    (#) Optionally, perform an automatic ADC calibration to improve the

        conversion accuracy

    (#) ADC driver can be used among three modes: polling, interruption,

        using function HAL_ADCEx_Calibration_Start().

        transfer by DMA.

    (#) ADC driver can be used among three modes: polling, interruption,

        (++) ADC conversion by polling:

        transfer by DMA.

          (+++) Activate the ADC peripheral and start conversions

                using function HAL_ADC_Start()

        (++) ADC conversion by polling:

          (+++) Wait for ADC conversion completion

          (+++) Activate the ADC peripheral and start conversions

                using function HAL_ADC_PollForConversion()

                using function HAL_ADC_Start()

                (or for injected group: HAL_ADCEx_InjectedPollForConversion() )

          (+++) Wait for ADC conversion completion

          (+++) Retrieve conversion results

                using function HAL_ADC_PollForConversion()

                using function HAL_ADC_GetValue()

                (or for injected group: HAL_ADCEx_InjectedPollForConversion() )

                (or for injected group: HAL_ADCEx_InjectedGetValue() )

          (+++) Retrieve conversion results

          (+++) Stop conversion and disable the ADC peripheral

                using function HAL_ADC_GetValue()

                using function HAL_ADC_Stop()

                (or for injected group: HAL_ADCEx_InjectedGetValue() )

          (+++) Stop conversion and disable the ADC peripheral

        (++) ADC conversion by interruption:

                using function HAL_ADC_Stop()

          (+++) Activate the ADC peripheral and start conversions

                using function HAL_ADC_Start_IT()

        (++) ADC conversion by interruption:

          (+++) Wait for ADC conversion completion by call of function

          (+++) Activate the ADC peripheral and start conversions

                HAL_ADC_ConvCpltCallback()

                using function HAL_ADC_Start_IT()

                (this function must be implemented in user program)

          (+++) Wait for ADC conversion completion by call of function

                (or for injected group: HAL_ADCEx_InjectedConvCpltCallback() )

                HAL_ADC_ConvCpltCallback()

          (+++) Retrieve conversion results

                (this function must be implemented in user program)

                using function HAL_ADC_GetValue()

                (or for injected group: HAL_ADCEx_InjectedConvCpltCallback() )

                (or for injected group: HAL_ADCEx_InjectedGetValue() )

          (+++) Retrieve conversion results

          (+++) Stop conversion and disable the ADC peripheral

                using function HAL_ADC_GetValue()

                using function HAL_ADC_Stop_IT()

                (or for injected group: HAL_ADCEx_InjectedGetValue() )

          (+++) Stop conversion and disable the ADC peripheral

        (++) ADC conversion with transfer by DMA:

                using function HAL_ADC_Stop_IT()

          (+++) Activate the ADC peripheral and start conversions

                using function HAL_ADC_Start_DMA()

        (++) ADC conversion with transfer by DMA:

          (+++) Wait for ADC conversion completion by call of function

          (+++) Activate the ADC peripheral and start conversions

                HAL_ADC_ConvCpltCallback() or HAL_ADC_ConvHalfCpltCallback()

                using function HAL_ADC_Start_DMA()

                (these functions must be implemented in user program)

          (+++) Wait for ADC conversion completion by call of function

          (+++) Conversion results are automatically transferred by DMA into

                HAL_ADC_ConvCpltCallback() or HAL_ADC_ConvHalfCpltCallback()

                destination variable address.

                (these functions must be implemented in user program)

          (+++) Stop conversion and disable the ADC peripheral

          (+++) Conversion results are automatically transferred by DMA into

                using function HAL_ADC_Stop_DMA()

                destination variable address.

          (+++) Stop conversion and disable the ADC peripheral

        (++) For devices with several ADCs: ADC multimode conversion

                using function HAL_ADC_Stop_DMA()

             with transfer by DMA:

          (+++) Activate the ADC peripheral (slave) and start conversions

        (++) For devices with several ADCs: ADC multimode conversion

                using function HAL_ADC_Start()

             with transfer by DMA:

          (+++) Activate the ADC peripheral (master) and start conversions

          (+++) Activate the ADC peripheral (slave) and start conversions

                using function HAL_ADCEx_MultiModeStart_DMA()

                using function HAL_ADC_Start()

          (+++) Wait for ADC conversion completion by call of function

          (+++) Activate the ADC peripheral (master) and start conversions

                HAL_ADC_ConvCpltCallback() or HAL_ADC_ConvHalfCpltCallback()

                using function HAL_ADCEx_MultiModeStart_DMA()

                (these functions must be implemented in user program)

          (+++) Wait for ADC conversion completion by call of function

          (+++) Conversion results are automatically transferred by DMA into

                HAL_ADC_ConvCpltCallback() or HAL_ADC_ConvHalfCpltCallback()

                destination variable address.

                (these functions must be implemented in user program)

          (+++) Stop conversion and disable the ADC peripheral (master)

          (+++) Conversion results are automatically transferred by DMA into

                using function HAL_ADCEx_MultiModeStop_DMA()

                destination variable address.

          (+++) Stop conversion and disable the ADC peripheral (slave)

          (+++) Stop conversion and disable the ADC peripheral (master)

                using function HAL_ADC_Stop_IT()

                using function HAL_ADCEx_MultiModeStop_DMA()

          (+++) Stop conversion and disable the ADC peripheral (slave)

     [..]

                using function HAL_ADC_Stop_IT()

    (@) Callback functions must be implemented in user program:

     [..]

      (+@) HAL_ADC_ErrorCallback()

      (+@) HAL_ADC_LevelOutOfWindowCallback() (callback of analog watchdog)

    (@) Callback functions must be implemented in user program:

      (+@) HAL_ADC_ConvCpltCallback()

      (+@) HAL_ADC_ErrorCallback()

      (+@) HAL_ADC_ConvHalfCpltCallback

      (+@) HAL_ADC_LevelOutOfWindowCallback() (callback of analog watchdog)

      (+@) HAL_ADCEx_InjectedConvCpltCallback()

      (+@) HAL_ADC_ConvCpltCallback()

      (+@) HAL_ADC_ConvHalfCpltCallback

     *** Deinitialization of ADC ***

      (+@) HAL_ADCEx_InjectedConvCpltCallback()

     ============================================================

     [..]

     *** Deinitialization of ADC ***

     ============================================================

    (#) Disable the ADC interface

     [..]

      (++) ADC clock can be hard reset and disabled at RCC top level.

        (++) Hard reset of ADC peripherals

    (#) Disable the ADC interface

             using macro __ADCx_FORCE_RESET(), __ADCx_RELEASE_RESET().

      (++) ADC clock can be hard reset and disabled at RCC top level.

        (++) ADC clock disable

        (++) Hard reset of ADC peripherals

             using the equivalent macro/functions as configuration step.

             using macro __ADCx_FORCE_RESET(), __ADCx_RELEASE_RESET().

             (+++) Example:

        (++) ADC clock disable

                   Into HAL_ADC_MspDeInit() (recommended code location) or with

             using the equivalent macro/functions as configuration step.

                   other device clock parameters configuration:

             (+++) Example:

               (+++) PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC

                   Into HAL_ADC_MspDeInit() (recommended code location) or with

               (+++) PeriphClkInit.AdcClockSelection = RCC_ADCPLLCLK2_OFF

                   other device clock parameters configuration:

               (+++) HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit)

               (+++) PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC

               (+++) PeriphClkInit.AdcClockSelection = RCC_ADCPLLCLK2_OFF

    (#) ADC pins configuration

               (+++) HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit)

         (++) Disable the clock for the ADC GPIOs

              using macro __HAL_RCC_GPIOx_CLK_DISABLE()

    (#) ADC pins configuration

         (++) Disable the clock for the ADC GPIOs

    (#) Optionally, in case of usage of ADC with interruptions:

              using macro __HAL_RCC_GPIOx_CLK_DISABLE()

         (++) Disable the NVIC for ADC

              using function HAL_NVIC_EnableIRQ(ADCx_IRQn)

    (#) Optionally, in case of usage of ADC with interruptions:

         (++) Disable the NVIC for ADC

    (#) Optionally, in case of usage of DMA:

              using function HAL_NVIC_EnableIRQ(ADCx_IRQn)

         (++) Deinitialize the DMA

              using function HAL_DMA_Init().

    (#) Optionally, in case of usage of DMA:

         (++) Disable the NVIC for DMA

         (++) Deinitialize the DMA

              using function HAL_NVIC_EnableIRQ(DMAx_Channelx_IRQn)

              using function HAL_DMA_Init().

         (++) Disable the NVIC for DMA

    [..]

              using function HAL_NVIC_EnableIRQ(DMAx_Channelx_IRQn)

    *** Callback registration ***

    [..]

    =============================================

    [..]

    *** Callback registration ***

    =============================================

     The compilation flag USE_HAL_ADC_REGISTER_CALLBACKS, when set to 1,

    [..]

     allows the user to configure dynamically the driver callbacks.

     Use Functions @ref HAL_ADC_RegisterCallback()

     The compilation flag USE_HAL_ADC_REGISTER_CALLBACKS, when set to 1,

     to register an interrupt callback.

     allows the user to configure dynamically the driver callbacks.

    [..]

     Use Functions HAL_ADC_RegisterCallback()

     to register an interrupt callback.

     Function @ref HAL_ADC_RegisterCallback() allows to register following callbacks:

    [..]

       (+) ConvCpltCallback               : ADC conversion complete callback

       (+) ConvHalfCpltCallback           : ADC conversion DMA half-transfer callback

     Function HAL_ADC_RegisterCallback() allows to register following callbacks:

       (+) LevelOutOfWindowCallback       : ADC analog watchdog 1 callback

       (+) ConvCpltCallback               : ADC conversion complete callback

       (+) ErrorCallback                  : ADC error callback

       (+) ConvHalfCpltCallback           : ADC conversion DMA half-transfer callback

       (+) InjectedConvCpltCallback       : ADC group injected conversion complete callback

       (+) LevelOutOfWindowCallback       : ADC analog watchdog 1 callback

       (+) MspInitCallback                : ADC Msp Init callback

       (+) ErrorCallback                  : ADC error callback

       (+) MspDeInitCallback              : ADC Msp DeInit callback

       (+) InjectedConvCpltCallback       : ADC group injected conversion complete callback

     This function takes as parameters the HAL peripheral handle, the Callback ID

       (+) MspInitCallback                : ADC Msp Init callback

     and a pointer to the user callback function.

       (+) MspDeInitCallback              : ADC Msp DeInit callback

    [..]

     This function takes as parameters the HAL peripheral handle, the Callback ID

     and a pointer to the user callback function.

     Use function @ref HAL_ADC_UnRegisterCallback to reset a callback to the default

    [..]

     weak function.

    [..]

     Use function HAL_ADC_UnRegisterCallback to reset a callback to the default

     weak function.

     @ref HAL_ADC_UnRegisterCallback takes as parameters the HAL peripheral handle,

    [..]

     and the Callback ID.

     This function allows to reset following callbacks:

     HAL_ADC_UnRegisterCallback takes as parameters the HAL peripheral handle,

       (+) ConvCpltCallback               : ADC conversion complete callback

     and the Callback ID.

       (+) ConvHalfCpltCallback           : ADC conversion DMA half-transfer callback

     This function allows to reset following callbacks:

       (+) LevelOutOfWindowCallback       : ADC analog watchdog 1 callback

       (+) ConvCpltCallback               : ADC conversion complete callback

       (+) ErrorCallback                  : ADC error callback

       (+) ConvHalfCpltCallback           : ADC conversion DMA half-transfer callback

       (+) InjectedConvCpltCallback       : ADC group injected conversion complete callback

       (+) LevelOutOfWindowCallback       : ADC analog watchdog 1 callback

       (+) MspInitCallback                : ADC Msp Init callback

       (+) ErrorCallback                  : ADC error callback

       (+) MspDeInitCallback              : ADC Msp DeInit callback

       (+) InjectedConvCpltCallback       : ADC group injected conversion complete callback

     [..]

       (+) MspInitCallback                : ADC Msp Init callback

       (+) MspDeInitCallback              : ADC Msp DeInit callback

     By default, after the @ref HAL_ADC_Init() and when the state is @ref HAL_ADC_STATE_RESET

     [..]

     all callbacks are set to the corresponding weak functions:

     examples @ref HAL_ADC_ConvCpltCallback(), @ref HAL_ADC_ErrorCallback().

     By default, after the HAL_ADC_Init() and when the state is HAL_ADC_STATE_RESET

     Exception done for MspInit and MspDeInit functions that are

     all callbacks are set to the corresponding weak functions:

     reset to the legacy weak functions in the @ref HAL_ADC_Init()/ @ref HAL_ADC_DeInit() only when

     examples HAL_ADC_ConvCpltCallback(), HAL_ADC_ErrorCallback().

     these callbacks are null (not registered beforehand).

     Exception done for MspInit and MspDeInit functions that are

    [..]

     reset to the legacy weak functions in the HAL_ADC_Init()/ HAL_ADC_DeInit() only when

     these callbacks are null (not registered beforehand).

     If MspInit or MspDeInit are not null, the @ref HAL_ADC_Init()/ @ref HAL_ADC_DeInit()

    [..]

     keep and use the user MspInit/MspDeInit callbacks (registered beforehand) whatever the state.

     [..]

     If MspInit or MspDeInit are not null, the HAL_ADC_Init()/ HAL_ADC_DeInit()

     keep and use the user MspInit/MspDeInit callbacks (registered beforehand) whatever the state.

     Callbacks can be registered/unregistered in @ref HAL_ADC_STATE_READY state only.

     [..]

     Exception done MspInit/MspDeInit functions that can be registered/unregistered

     in @ref HAL_ADC_STATE_READY or @ref HAL_ADC_STATE_RESET state,

     Callbacks can be registered/unregistered in HAL_ADC_STATE_READY state only.

     thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.

     Exception done MspInit/MspDeInit functions that can be registered/unregistered

    [..]

     in HAL_ADC_STATE_READY or HAL_ADC_STATE_RESET state,

     thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.

     Then, the user first registers the MspInit/MspDeInit user callbacks

    [..]

     using @ref HAL_ADC_RegisterCallback() before calling @ref HAL_ADC_DeInit()

     or @ref HAL_ADC_Init() function.

     Then, the user first registers the MspInit/MspDeInit user callbacks

     [..]

     using HAL_ADC_RegisterCallback() before calling HAL_ADC_DeInit()

     or HAL_ADC_Init() function.

     When the compilation flag USE_HAL_ADC_REGISTER_CALLBACKS is set to 0 or

     [..]

     not defined, the callback registration feature is not available and all callbacks

     are set to the corresponding weak functions.

     When the compilation flag USE_HAL_ADC_REGISTER_CALLBACKS is set to 0 or

     not defined, the callback registration feature is not available and all callbacks

  @endverbatim

     are set to the corresponding weak functions.

  ******************************************************************************

  * @attention

  @endverbatim

  *

  */

  * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.

  * All rights reserved.</center></h2>

/* Includes ------------------------------------------------------------------*/

  *

#include "stm32f1xx_hal.h"

  * This software component is licensed by ST under BSD 3-Clause license,

  * the "License"; You may not use this file except in compliance with the

/** @addtogroup STM32F1xx_HAL_Driver

  * License. You may obtain a copy of the License at:

  * @{

  *                        opensource.org/licenses/BSD-3-Clause

  */

  *

  ******************************************************************************

/** @defgroup ADC ADC

  */

  * @brief ADC HAL module driver

  * @{

/* Includes ------------------------------------------------------------------*/

  */

#include "stm32f1xx_hal.h"

#ifdef HAL_ADC_MODULE_ENABLED

/** @addtogroup STM32F1xx_HAL_Driver

  * @{

/* Private typedef -----------------------------------------------------------*/

  */

/* Private define ------------------------------------------------------------*/

/** @defgroup ADC_Private_Constants ADC Private Constants

/** @defgroup ADC ADC

  * @{

  * @brief ADC HAL module driver

  */

  * @{

  */

  /* Timeout values for ADC enable and disable settling time.                 */

  /* Values defined to be higher than worst cases: low clocks freq,           */

#ifdef HAL_ADC_MODULE_ENABLED

  /* maximum prescaler.                                                       */

  /* Ex of profile low frequency : Clock source at 0.1 MHz, ADC clock         */

/* Private typedef -----------------------------------------------------------*/

  /* prescaler 4, sampling time 12.5 ADC clock cycles, resolution 12 bits.    */

/* Private define ------------------------------------------------------------*/

  /* Unit: ms                                                                 */

/** @defgroup ADC_Private_Constants ADC Private Constants

  #define ADC_ENABLE_TIMEOUT              2U

  * @{

  #define ADC_DISABLE_TIMEOUT             2U

  */

  /* Delay for ADC stabilization time.                                        */

  /* Timeout values for ADC enable and disable settling time.                 */

  /* Maximum delay is 1us (refer to device datasheet, parameter tSTAB).       */

  /* Values defined to be higher than worst cases: low clocks freq,           */

  /* Unit: us                                                                 */

  /* maximum prescaler.                                                       */

  #define ADC_STAB_DELAY_US               1U

  /* Ex of profile low frequency : Clock source at 0.1 MHz, ADC clock         */

  /* prescaler 4, sampling time 12.5 ADC clock cycles, resolution 12 bits.    */

  /* Delay for temperature sensor stabilization time.                         */

  /* Unit: ms                                                                 */

  /* Maximum delay is 10us (refer to device datasheet, parameter tSTART).     */

  #define ADC_ENABLE_TIMEOUT              2U

  /* Unit: us                                                                 */

  #define ADC_DISABLE_TIMEOUT             2U

  #define ADC_TEMPSENSOR_DELAY_US         10U

  /* Delay for ADC stabilization time.                                        */

/**

  /* Maximum delay is 1us (refer to device datasheet, parameter tSTAB).       */

  * @}

  /* Unit: us                                                                 */

  */

  #define ADC_STAB_DELAY_US               1U

/* Private macro -------------------------------------------------------------*/

  /* Delay for temperature sensor stabilization time.                         */

/* Private variables ---------------------------------------------------------*/

  /* Maximum delay is 10us (refer to device datasheet, parameter tSTART).     */

/* Private function prototypes -----------------------------------------------*/

  /* Unit: us                                                                 */

/** @defgroup ADC_Private_Functions ADC Private Functions

  #define ADC_TEMPSENSOR_DELAY_US         10U

  * @{

  */

/**

/**

  * @}

  * @}

  */

  */

/* Private macro -------------------------------------------------------------*/

/* Exported functions --------------------------------------------------------*/

/* Private variables ---------------------------------------------------------*/

/* Private function prototypes -----------------------------------------------*/

/** @defgroup ADC_Exported_Functions ADC Exported Functions

/** @defgroup ADC_Private_Functions ADC Private Functions

  * @{

  * @{

  */

  */

/**

/** @defgroup ADC_Exported_Functions_Group1 Initialization/de-initialization functions

  * @}

  * @brief    Initialization and Configuration functions

  */

  *

@verbatim    

/* Exported functions --------------------------------------------------------*/

 ===============================================================================

              ##### Initialization and de-initialization functions #####

/** @defgroup ADC_Exported_Functions ADC Exported Functions

 ===============================================================================

  * @{

    [..]  This section provides functions allowing to:

  */

      (+) Initialize and configure the ADC.

      (+) De-initialize the ADC.

/** @defgroup ADC_Exported_Functions_Group1 Initialization/de-initialization functions

  * @brief    Initialization and Configuration functions

@endverbatim

  *

  * @{

@verbatim    

  */

 ===============================================================================

              ##### Initialization and de-initialization functions #####

/**

 ===============================================================================

  * @brief  Initializes the ADC peripheral and regular group according to  

    [..]  This section provides functions allowing to:

  *         parameters specified in structure "ADC_InitTypeDef".

      (+) Initialize and configure the ADC.

  * @note   As prerequisite, ADC clock must be configured at RCC top level

      (+) De-initialize the ADC.

  *         (clock source APB2).

  *         See commented example code below that can be copied and uncommented

@endverbatim

  *         into HAL_ADC_MspInit().

  * @{

  * @note   Possibility to update parameters on the fly:

  */

  *         This function initializes the ADC MSP (HAL_ADC_MspInit()) only when

  *         coming from ADC state reset. Following calls to this function can

/**

  *         be used to reconfigure some parameters of ADC_InitTypeDef  

  * @brief  Initializes the ADC peripheral and regular group according to  

  *         structure on the fly, without modifying MSP configuration. If ADC  

  *         parameters specified in structure "ADC_InitTypeDef".

  *         MSP has to be modified again, HAL_ADC_DeInit() must be called

  * @note   As prerequisite, ADC clock must be configured at RCC top level

  *         before HAL_ADC_Init().

  *         (clock source APB2).

  *         The setting of these parameters is conditioned to ADC state.

  *         See commented example code below that can be copied and uncommented

  *         For parameters constraints, see comments of structure

  *         into HAL_ADC_MspInit().

  *         "ADC_InitTypeDef".

  * @note   Possibility to update parameters on the fly:

  * @note   This function configures the ADC within 2 scopes: scope of entire

  *         This function initializes the ADC MSP (HAL_ADC_MspInit()) only when

  *         ADC and scope of regular group. For parameters details, see comments

  *         coming from ADC state reset. Following calls to this function can

  *         of structure "ADC_InitTypeDef".

  *         be used to reconfigure some parameters of ADC_InitTypeDef  

  * @param  hadc: ADC handle

  *         structure on the fly, without modifying MSP configuration. If ADC  

  * @retval HAL status

  *         MSP has to be modified again, HAL_ADC_DeInit() must be called

  */

  *         before HAL_ADC_Init().

HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc)

  *         The setting of these parameters is conditioned to ADC state.

{

  *         For parameters constraints, see comments of structure

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  *         "ADC_InitTypeDef".

  uint32_t tmp_cr1 = 0U;

  * @note   This function configures the ADC within 2 scopes: scope of entire

  uint32_t tmp_cr2 = 0U;

  *         ADC and scope of regular group. For parameters details, see comments

  uint32_t tmp_sqr1 = 0U;

  *         of structure "ADC_InitTypeDef".

  * @param  hadc: ADC handle

  /* Check ADC handle */

  * @retval HAL status

  if(hadc == NULL)

  */

  {

HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc)

    return HAL_ERROR;

{

  }

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  uint32_t tmp_cr1 = 0U;

  /* Check the parameters */

  uint32_t tmp_cr2 = 0U;

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

  uint32_t tmp_sqr1 = 0U;

  assert_param(IS_ADC_DATA_ALIGN(hadc->Init.DataAlign));

  assert_param(IS_ADC_SCAN_MODE(hadc->Init.ScanConvMode));

  /* Check ADC handle */

  assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));

  if(hadc == NULL)

  assert_param(IS_ADC_EXTTRIG(hadc->Init.ExternalTrigConv));

  {

    return HAL_ERROR;

  if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE)

  }

  {

    assert_param(IS_ADC_REGULAR_NB_CONV(hadc->Init.NbrOfConversion));

  /* Check the parameters */

    assert_param(IS_FUNCTIONAL_STATE(hadc->Init.DiscontinuousConvMode));

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

    if(hadc->Init.DiscontinuousConvMode != DISABLE)

  assert_param(IS_ADC_DATA_ALIGN(hadc->Init.DataAlign));

    {

  assert_param(IS_ADC_SCAN_MODE(hadc->Init.ScanConvMode));

      assert_param(IS_ADC_REGULAR_DISCONT_NUMBER(hadc->Init.NbrOfDiscConversion));

  assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));

    }

  assert_param(IS_ADC_EXTTRIG(hadc->Init.ExternalTrigConv));

  }

  if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE)

  /* As prerequisite, into HAL_ADC_MspInit(), ADC clock must be configured    */

  {

  /* at RCC top level.                                                        */

    assert_param(IS_ADC_REGULAR_NB_CONV(hadc->Init.NbrOfConversion));

  /* Refer to header of this file for more details on clock enabling          */

    assert_param(IS_FUNCTIONAL_STATE(hadc->Init.DiscontinuousConvMode));

  /* procedure.                                                               */

    if(hadc->Init.DiscontinuousConvMode != DISABLE)

    {

  /* Actions performed only if ADC is coming from state reset:                */

      assert_param(IS_ADC_REGULAR_DISCONT_NUMBER(hadc->Init.NbrOfDiscConversion));

  /* - Initialization of ADC MSP                                              */

    }

  if (hadc->State == HAL_ADC_STATE_RESET)

  }

  {

    /* Initialize ADC error code */

  /* As prerequisite, into HAL_ADC_MspInit(), ADC clock must be configured    */

    ADC_CLEAR_ERRORCODE(hadc);

  /* at RCC top level.                                                        */

  /* Refer to header of this file for more details on clock enabling          */

    /* Allocate lock resource and initialize it */

  /* procedure.                                                               */

    hadc->Lock = HAL_UNLOCKED;

  /* Actions performed only if ADC is coming from state reset:                */

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

  /* - Initialization of ADC MSP                                              */

    /* Init the ADC Callback settings */

  if (hadc->State == HAL_ADC_STATE_RESET)

    hadc->ConvCpltCallback              = HAL_ADC_ConvCpltCallback;                 /* Legacy weak callback */

  {

    hadc->ConvHalfCpltCallback          = HAL_ADC_ConvHalfCpltCallback;             /* Legacy weak callback */

    /* Initialize ADC error code */

    hadc->LevelOutOfWindowCallback      = HAL_ADC_LevelOutOfWindowCallback;         /* Legacy weak callback */

    ADC_CLEAR_ERRORCODE(hadc);

    hadc->ErrorCallback                 = HAL_ADC_ErrorCallback;                    /* Legacy weak callback */

    hadc->InjectedConvCpltCallback      = HAL_ADCEx_InjectedConvCpltCallback;       /* Legacy weak callback */

    /* Allocate lock resource and initialize it */

    hadc->Lock = HAL_UNLOCKED;

    if (hadc->MspInitCallback == NULL)

    {

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

      hadc->MspInitCallback = HAL_ADC_MspInit; /* Legacy weak MspInit  */

    /* Init the ADC Callback settings */

    }

    hadc->ConvCpltCallback              = HAL_ADC_ConvCpltCallback;                 /* Legacy weak callback */

    hadc->ConvHalfCpltCallback          = HAL_ADC_ConvHalfCpltCallback;             /* Legacy weak callback */

    /* Init the low level hardware */

    hadc->LevelOutOfWindowCallback      = HAL_ADC_LevelOutOfWindowCallback;         /* Legacy weak callback */

    hadc->MspInitCallback(hadc);

    hadc->ErrorCallback                 = HAL_ADC_ErrorCallback;                    /* Legacy weak callback */

#else

    hadc->InjectedConvCpltCallback      = HAL_ADCEx_InjectedConvCpltCallback;       /* Legacy weak callback */

    /* Init the low level hardware */

    HAL_ADC_MspInit(hadc);

    if (hadc->MspInitCallback == NULL)

#endif /* USE_HAL_ADC_REGISTER_CALLBACKS */

    {

  }

      hadc->MspInitCallback = HAL_ADC_MspInit; /* Legacy weak MspInit  */

    }

  /* Stop potential conversion on going, on regular and injected groups */

  /* Disable ADC peripheral */

    /* Init the low level hardware */

  /* Note: In case of ADC already enabled, precaution to not launch an        */

    hadc->MspInitCallback(hadc);

  /*       unwanted conversion while modifying register CR2 by writing 1 to   */

#else

  /*       bit ADON.                                                          */

    /* Init the low level hardware */

  tmp_hal_status = ADC_ConversionStop_Disable(hadc);

    HAL_ADC_MspInit(hadc);

#endif /* USE_HAL_ADC_REGISTER_CALLBACKS */

  }

  /* Configuration of ADC parameters if previous preliminary actions are      */

  /* correctly completed.                                                     */

  /* Stop potential conversion on going, on regular and injected groups */

  if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL) &&

  /* Disable ADC peripheral */

      (tmp_hal_status == HAL_OK)                                  )

  /* Note: In case of ADC already enabled, precaution to not launch an        */

  {

  /*       unwanted conversion while modifying register CR2 by writing 1 to   */

    /* Set ADC state */

  /*       bit ADON.                                                          */

    ADC_STATE_CLR_SET(hadc->State,

  tmp_hal_status = ADC_ConversionStop_Disable(hadc);

                      HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY,

                      HAL_ADC_STATE_BUSY_INTERNAL);

  /* Configuration of ADC parameters if previous preliminary actions are      */

    /* Set ADC parameters */

  /* correctly completed.                                                     */

  if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL) &&

    /* Configuration of ADC:                                                  */

      (tmp_hal_status == HAL_OK)                                  )

    /*  - data alignment                                                      */

  {

    /*  - external trigger to start conversion                                */

    /* Set ADC state */

    /*  - external trigger polarity (always set to 1, because needed for all  */

    ADC_STATE_CLR_SET(hadc->State,

    /*    triggers: external trigger of SW start)                             */

                      HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY,

    /*  - continuous conversion mode                                          */

                      HAL_ADC_STATE_BUSY_INTERNAL);

    /* Note: External trigger polarity (ADC_CR2_EXTTRIG) is set into          */

    /*       HAL_ADC_Start_xxx functions because if set in this function,     */

    /* Set ADC parameters */

    /*       a conversion on injected group would start a conversion also on  */

    /*       regular group after ADC enabling.                                */

    /* Configuration of ADC:                                                  */

    tmp_cr2 |= (hadc->Init.DataAlign                                          |

    /*  - data alignment                                                      */

                ADC_CFGR_EXTSEL(hadc, hadc->Init.ExternalTrigConv)            |

    /*  - external trigger to start conversion                                */

                ADC_CR2_CONTINUOUS((uint32_t)hadc->Init.ContinuousConvMode)   );

    /*  - external trigger polarity (always set to 1, because needed for all  */

    /*    triggers: external trigger of SW start)                             */

    /* Configuration of ADC:                                                  */

    /*  - continuous conversion mode                                          */

    /*  - scan mode                                                           */

    /* Note: External trigger polarity (ADC_CR2_EXTTRIG) is set into          */

    /*  - discontinuous mode disable/enable                                   */

    /*       HAL_ADC_Start_xxx functions because if set in this function,     */

    /*  - discontinuous mode number of conversions                            */

    /*       a conversion on injected group would start a conversion also on  */

    tmp_cr1 |= (ADC_CR1_SCAN_SET(hadc->Init.ScanConvMode));

    /*       regular group after ADC enabling.                                */

    tmp_cr2 |= (hadc->Init.DataAlign                                          |

    /* Enable discontinuous mode only if continuous mode is disabled */

                ADC_CFGR_EXTSEL(hadc, hadc->Init.ExternalTrigConv)            |

    /* Note: If parameter "Init.ScanConvMode" is set to disable, parameter    */

                ADC_CR2_CONTINUOUS((uint32_t)hadc->Init.ContinuousConvMode)   );

    /*       discontinuous is set anyway, but will have no effect on ADC HW.  */

    if (hadc->Init.DiscontinuousConvMode == ENABLE)

    /* Configuration of ADC:                                                  */

    {

    /*  - scan mode                                                           */

      if (hadc->Init.ContinuousConvMode == DISABLE)

    /*  - discontinuous mode disable/enable                                   */

      {

    /*  - discontinuous mode number of conversions                            */

        /* Enable the selected ADC regular discontinuous mode */

    tmp_cr1 |= (ADC_CR1_SCAN_SET(hadc->Init.ScanConvMode));

        /* Set the number of channels to be converted in discontinuous mode */

        SET_BIT(tmp_cr1, ADC_CR1_DISCEN                                            |

    /* Enable discontinuous mode only if continuous mode is disabled */

                         ADC_CR1_DISCONTINUOUS_NUM(hadc->Init.NbrOfDiscConversion)  );

    /* Note: If parameter "Init.ScanConvMode" is set to disable, parameter    */

      }

    /*       discontinuous is set anyway, but will have no effect on ADC HW.  */

      else

    if (hadc->Init.DiscontinuousConvMode == ENABLE)

      {

    {

        /* ADC regular group settings continuous and sequencer discontinuous*/

      if (hadc->Init.ContinuousConvMode == DISABLE)

        /* cannot be enabled simultaneously.                                */

      {

        /* Enable the selected ADC regular discontinuous mode */

        /* Update ADC state machine to error */

        /* Set the number of channels to be converted in discontinuous mode */

        SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG);

        SET_BIT(tmp_cr1, ADC_CR1_DISCEN                                            |

                         ADC_CR1_DISCONTINUOUS_NUM(hadc->Init.NbrOfDiscConversion)  );

        /* Set ADC error code to ADC IP internal error */

      }

        SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

      else

      }

      {

    }

        /* ADC regular group settings continuous and sequencer discontinuous*/

        /* cannot be enabled simultaneously.                                */

    /* Update ADC configuration register CR1 with previous settings */

      MODIFY_REG(hadc->Instance->CR1,

        /* Update ADC state machine to error */

                 ADC_CR1_SCAN    |

        SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG);

                 ADC_CR1_DISCEN  |

                 ADC_CR1_DISCNUM    ,

        /* Set ADC error code to ADC IP internal error */

                 tmp_cr1             );

        SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

      }

    /* Update ADC configuration register CR2 with previous settings */

    }

      MODIFY_REG(hadc->Instance->CR2,

                 ADC_CR2_ALIGN   |

    /* Update ADC configuration register CR1 with previous settings */

                 ADC_CR2_EXTSEL  |

      MODIFY_REG(hadc->Instance->CR1,

                 ADC_CR2_EXTTRIG |

                 ADC_CR1_SCAN    |

                 ADC_CR2_CONT       ,

                 ADC_CR1_DISCEN  |

                 tmp_cr2             );

                 ADC_CR1_DISCNUM    ,

                 tmp_cr1             );

    /* Configuration of regular group sequencer:                              */

    /* - if scan mode is disabled, regular channels sequence length is set to */

    /* Update ADC configuration register CR2 with previous settings */

    /*   0x00: 1 channel converted (channel on regular rank 1)                */

      MODIFY_REG(hadc->Instance->CR2,

    /*   Parameter "NbrOfConversion" is discarded.                            */

                 ADC_CR2_ALIGN   |

    /*   Note: Scan mode is present by hardware on this device and, if        */

                 ADC_CR2_EXTSEL  |

    /*   disabled, discards automatically nb of conversions. Anyway, nb of    */

                 ADC_CR2_EXTTRIG |

    /*   conversions is forced to 0x00 for alignment over all STM32 devices.  */

                 ADC_CR2_CONT       ,

    /* - if scan mode is enabled, regular channels sequence length is set to  */

                 tmp_cr2             );

    /*   parameter "NbrOfConversion"                                          */

    if (ADC_CR1_SCAN_SET(hadc->Init.ScanConvMode) == ADC_SCAN_ENABLE)

    /* Configuration of regular group sequencer:                              */

    {

    /* - if scan mode is disabled, regular channels sequence length is set to */

      tmp_sqr1 = ADC_SQR1_L_SHIFT(hadc->Init.NbrOfConversion);

    /*   0x00: 1 channel converted (channel on regular rank 1)                */

    }

    /*   Parameter "NbrOfConversion" is discarded.                            */

    /*   Note: Scan mode is present by hardware on this device and, if        */

    MODIFY_REG(hadc->Instance->SQR1,

    /*   disabled, discards automatically nb of conversions. Anyway, nb of    */

               ADC_SQR1_L          ,

    /*   conversions is forced to 0x00 for alignment over all STM32 devices.  */

               tmp_sqr1             );

    /* - if scan mode is enabled, regular channels sequence length is set to  */

    /*   parameter "NbrOfConversion"                                          */

    /* Check back that ADC registers have effectively been configured to      */

    if (ADC_CR1_SCAN_SET(hadc->Init.ScanConvMode) == ADC_SCAN_ENABLE)

    /* ensure of no potential problem of ADC core IP clocking.                */

    {

    /* Check through register CR2 (excluding bits set in other functions:     */

      tmp_sqr1 = ADC_SQR1_L_SHIFT(hadc->Init.NbrOfConversion);

    /* execution control bits (ADON, JSWSTART, SWSTART), regular group bits   */

    }

    /* (DMA), injected group bits (JEXTTRIG and JEXTSEL), channel internal    */

    /* measurement path bit (TSVREFE).                                        */

    MODIFY_REG(hadc->Instance->SQR1,

    if (READ_BIT(hadc->Instance->CR2, ~(ADC_CR2_ADON | ADC_CR2_DMA |

               ADC_SQR1_L          ,

                                        ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

               tmp_sqr1             );

                                        ADC_CR2_JEXTTRIG | ADC_CR2_JEXTSEL |

                                        ADC_CR2_TSVREFE                     ))

    /* Check back that ADC registers have effectively been configured to      */

         == tmp_cr2)

    /* ensure of no potential problem of ADC core IP clocking.                */

    {

    /* Check through register CR2 (excluding bits set in other functions:     */

      /* Set ADC error code to none */

    /* execution control bits (ADON, JSWSTART, SWSTART), regular group bits   */

      ADC_CLEAR_ERRORCODE(hadc);

    /* (DMA), injected group bits (JEXTTRIG and JEXTSEL), channel internal    */

    /* measurement path bit (TSVREFE).                                        */

      /* Set the ADC state */

    if (READ_BIT(hadc->Instance->CR2, ~(ADC_CR2_ADON | ADC_CR2_DMA |

      ADC_STATE_CLR_SET(hadc->State,

                                        ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

                        HAL_ADC_STATE_BUSY_INTERNAL,

                                        ADC_CR2_JEXTTRIG | ADC_CR2_JEXTSEL |

                        HAL_ADC_STATE_READY);

                                        ADC_CR2_TSVREFE                     ))

    }

         == tmp_cr2)

    else

    {

    {

      /* Set ADC error code to none */

      /* Update ADC state machine to error */

      ADC_CLEAR_ERRORCODE(hadc);

      ADC_STATE_CLR_SET(hadc->State,

                        HAL_ADC_STATE_BUSY_INTERNAL,

      /* Set the ADC state */

                        HAL_ADC_STATE_ERROR_INTERNAL);

      ADC_STATE_CLR_SET(hadc->State,

                        HAL_ADC_STATE_BUSY_INTERNAL,

      /* Set ADC error code to ADC IP internal error */

                        HAL_ADC_STATE_READY);

      SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

    }

    else

      tmp_hal_status = HAL_ERROR;

    {

    }

      /* Update ADC state machine to error */

      ADC_STATE_CLR_SET(hadc->State,

  }

                        HAL_ADC_STATE_BUSY_INTERNAL,

  else

                        HAL_ADC_STATE_ERROR_INTERNAL);

  {

    /* Update ADC state machine to error */

      /* Set ADC error code to ADC IP internal error */

    SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL);

      SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

    tmp_hal_status = HAL_ERROR;

      tmp_hal_status = HAL_ERROR;

  }

    }

  /* Return function status */

  }

  return tmp_hal_status;

  else

}

  {

    /* Update ADC state machine to error */

/**

    SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL);

  * @brief  Deinitialize the ADC peripheral registers to their default reset

  *         values, with deinitialization of the ADC MSP.

    tmp_hal_status = HAL_ERROR;

  *         If needed, the example code can be copied and uncommented into

  }

  *         function HAL_ADC_MspDeInit().

  * @param  hadc: ADC handle

  /* Return function status */

  * @retval HAL status

  return tmp_hal_status;

  */

}

HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef* hadc)

{

/**

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  * @brief  Deinitialize the ADC peripheral registers to their default reset

  *         values, with deinitialization of the ADC MSP.

  /* Check ADC handle */

  *         If needed, the example code can be copied and uncommented into

  if(hadc == NULL)

  *         function HAL_ADC_MspDeInit().

  {

  * @param  hadc: ADC handle

     return HAL_ERROR;

  * @retval HAL status

  }

  */

HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef* hadc)

  /* Check the parameters */

{

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  /* Set ADC state */

  /* Check ADC handle */

  SET_BIT(hadc->State, HAL_ADC_STATE_BUSY_INTERNAL);

  if(hadc == NULL)

  {

  /* Stop potential conversion on going, on regular and injected groups */

     return HAL_ERROR;

  /* Disable ADC peripheral */

  }

  tmp_hal_status = ADC_ConversionStop_Disable(hadc);

  /* Check the parameters */

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

  /* Configuration of ADC parameters if previous preliminary actions are      */

  /* correctly completed.                                                     */

  /* Set ADC state */

  if (tmp_hal_status == HAL_OK)

  SET_BIT(hadc->State, HAL_ADC_STATE_BUSY_INTERNAL);

  {

    /* ========== Reset ADC registers ========== */

  /* Stop potential conversion on going, on regular and injected groups */

  /* Disable ADC peripheral */

  tmp_hal_status = ADC_ConversionStop_Disable(hadc);

    /* Reset register SR */

  /* Configuration of ADC parameters if previous preliminary actions are      */

    __HAL_ADC_CLEAR_FLAG(hadc, (ADC_FLAG_AWD | ADC_FLAG_JEOC | ADC_FLAG_EOC |

  /* correctly completed.                                                     */

                                ADC_FLAG_JSTRT | ADC_FLAG_STRT));

  if (tmp_hal_status == HAL_OK)

  {

    /* Reset register CR1 */

    /* ========== Reset ADC registers ========== */

    CLEAR_BIT(hadc->Instance->CR1, (ADC_CR1_AWDEN   | ADC_CR1_JAWDEN | ADC_CR1_DISCNUM |

                                    ADC_CR1_JDISCEN | ADC_CR1_DISCEN | ADC_CR1_JAUTO   |

                                    ADC_CR1_AWDSGL  | ADC_CR1_SCAN   | ADC_CR1_JEOCIE  |  

                                    ADC_CR1_AWDIE   | ADC_CR1_EOCIE  | ADC_CR1_AWDCH    ));

    /* Reset register SR */

    /* Reset register CR2 */

    __HAL_ADC_CLEAR_FLAG(hadc, (ADC_FLAG_AWD | ADC_FLAG_JEOC | ADC_FLAG_EOC |

    CLEAR_BIT(hadc->Instance->CR2, (ADC_CR2_TSVREFE | ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

                                ADC_FLAG_JSTRT | ADC_FLAG_STRT));

                                    ADC_CR2_EXTTRIG | ADC_CR2_EXTSEL  | ADC_CR2_JEXTTRIG |  

                                    ADC_CR2_JEXTSEL | ADC_CR2_ALIGN   | ADC_CR2_DMA      |        

    /* Reset register CR1 */

                                    ADC_CR2_RSTCAL  | ADC_CR2_CAL     | ADC_CR2_CONT     |          

    CLEAR_BIT(hadc->Instance->CR1, (ADC_CR1_AWDEN   | ADC_CR1_JAWDEN | ADC_CR1_DISCNUM |

                                    ADC_CR2_ADON                                          ));

                                    ADC_CR1_JDISCEN | ADC_CR1_DISCEN | ADC_CR1_JAUTO   |

                                    ADC_CR1_AWDSGL  | ADC_CR1_SCAN   | ADC_CR1_JEOCIE  |  

    /* Reset register SMPR1 */

                                    ADC_CR1_AWDIE   | ADC_CR1_EOCIE  | ADC_CR1_AWDCH    ));

    CLEAR_BIT(hadc->Instance->SMPR1, (ADC_SMPR1_SMP17 | ADC_SMPR1_SMP16 | ADC_SMPR1_SMP15 |

                                      ADC_SMPR1_SMP14 | ADC_SMPR1_SMP13 | ADC_SMPR1_SMP12 |

    /* Reset register CR2 */

                                      ADC_SMPR1_SMP11 | ADC_SMPR1_SMP10                    ));

    CLEAR_BIT(hadc->Instance->CR2, (ADC_CR2_TSVREFE | ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

                                    ADC_CR2_EXTTRIG | ADC_CR2_EXTSEL  | ADC_CR2_JEXTTRIG |  

    /* Reset register SMPR2 */

                                    ADC_CR2_JEXTSEL | ADC_CR2_ALIGN   | ADC_CR2_DMA      |        

    CLEAR_BIT(hadc->Instance->SMPR2, (ADC_SMPR2_SMP9 | ADC_SMPR2_SMP8 | ADC_SMPR2_SMP7 |

                                    ADC_CR2_RSTCAL  | ADC_CR2_CAL     | ADC_CR2_CONT     |          

                                      ADC_SMPR2_SMP6 | ADC_SMPR2_SMP5 | ADC_SMPR2_SMP4 |

                                    ADC_CR2_ADON                                          ));

                                      ADC_SMPR2_SMP3 | ADC_SMPR2_SMP2 | ADC_SMPR2_SMP1 |

                                      ADC_SMPR2_SMP0                                    ));

    /* Reset register SMPR1 */

    CLEAR_BIT(hadc->Instance->SMPR1, (ADC_SMPR1_SMP17 | ADC_SMPR1_SMP16 | ADC_SMPR1_SMP15 |

    /* Reset register JOFR1 */

                                      ADC_SMPR1_SMP14 | ADC_SMPR1_SMP13 | ADC_SMPR1_SMP12 |

    CLEAR_BIT(hadc->Instance->JOFR1, ADC_JOFR1_JOFFSET1);

                                      ADC_SMPR1_SMP11 | ADC_SMPR1_SMP10                    ));

    /* Reset register JOFR2 */

    CLEAR_BIT(hadc->Instance->JOFR2, ADC_JOFR2_JOFFSET2);

    /* Reset register SMPR2 */

    /* Reset register JOFR3 */

    CLEAR_BIT(hadc->Instance->SMPR2, (ADC_SMPR2_SMP9 | ADC_SMPR2_SMP8 | ADC_SMPR2_SMP7 |

    CLEAR_BIT(hadc->Instance->JOFR3, ADC_JOFR3_JOFFSET3);

                                      ADC_SMPR2_SMP6 | ADC_SMPR2_SMP5 | ADC_SMPR2_SMP4 |

    /* Reset register JOFR4 */

                                      ADC_SMPR2_SMP3 | ADC_SMPR2_SMP2 | ADC_SMPR2_SMP1 |

    CLEAR_BIT(hadc->Instance->JOFR4, ADC_JOFR4_JOFFSET4);

                                      ADC_SMPR2_SMP0                                    ));

    /* Reset register HTR */

    /* Reset register JOFR1 */

    CLEAR_BIT(hadc->Instance->HTR, ADC_HTR_HT);

    CLEAR_BIT(hadc->Instance->JOFR1, ADC_JOFR1_JOFFSET1);

    /* Reset register LTR */

    /* Reset register JOFR2 */

    CLEAR_BIT(hadc->Instance->LTR, ADC_LTR_LT);

    CLEAR_BIT(hadc->Instance->JOFR2, ADC_JOFR2_JOFFSET2);

    /* Reset register JOFR3 */

    /* Reset register SQR1 */

    CLEAR_BIT(hadc->Instance->JOFR3, ADC_JOFR3_JOFFSET3);

    CLEAR_BIT(hadc->Instance->SQR1, ADC_SQR1_L    |

    /* Reset register JOFR4 */

                                    ADC_SQR1_SQ16 | ADC_SQR1_SQ15 |

    CLEAR_BIT(hadc->Instance->JOFR4, ADC_JOFR4_JOFFSET4);

                                    ADC_SQR1_SQ14 | ADC_SQR1_SQ13  );

    /* Reset register HTR */

    /* Reset register SQR1 */

    CLEAR_BIT(hadc->Instance->HTR, ADC_HTR_HT);

    CLEAR_BIT(hadc->Instance->SQR1, ADC_SQR1_L    |

    /* Reset register LTR */

                                    ADC_SQR1_SQ16 | ADC_SQR1_SQ15 |

    CLEAR_BIT(hadc->Instance->LTR, ADC_LTR_LT);

                                    ADC_SQR1_SQ14 | ADC_SQR1_SQ13  );

    /* Reset register SQR1 */

    /* Reset register SQR2 */

    CLEAR_BIT(hadc->Instance->SQR1, ADC_SQR1_L    |

    CLEAR_BIT(hadc->Instance->SQR2, ADC_SQR2_SQ12 | ADC_SQR2_SQ11 | ADC_SQR2_SQ10 |

                                    ADC_SQR1_SQ16 | ADC_SQR1_SQ15 |

                                    ADC_SQR2_SQ9  | ADC_SQR2_SQ8  | ADC_SQR2_SQ7   );

                                    ADC_SQR1_SQ14 | ADC_SQR1_SQ13  );

    /* Reset register SQR3 */

    /* Reset register SQR1 */

    CLEAR_BIT(hadc->Instance->SQR3, ADC_SQR3_SQ6 | ADC_SQR3_SQ5 | ADC_SQR3_SQ4 |

    CLEAR_BIT(hadc->Instance->SQR1, ADC_SQR1_L    |

                                    ADC_SQR3_SQ3 | ADC_SQR3_SQ2 | ADC_SQR3_SQ1  );

                                    ADC_SQR1_SQ16 | ADC_SQR1_SQ15 |

                                    ADC_SQR1_SQ14 | ADC_SQR1_SQ13  );

    /* Reset register JSQR */

    CLEAR_BIT(hadc->Instance->JSQR, ADC_JSQR_JL |

    /* Reset register SQR2 */

                                    ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

    CLEAR_BIT(hadc->Instance->SQR2, ADC_SQR2_SQ12 | ADC_SQR2_SQ11 | ADC_SQR2_SQ10 |

                                    ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  );

                                    ADC_SQR2_SQ9  | ADC_SQR2_SQ8  | ADC_SQR2_SQ7   );

    /* Reset register JSQR */

    /* Reset register SQR3 */

    CLEAR_BIT(hadc->Instance->JSQR, ADC_JSQR_JL |

    CLEAR_BIT(hadc->Instance->SQR3, ADC_SQR3_SQ6 | ADC_SQR3_SQ5 | ADC_SQR3_SQ4 |

                                    ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

                                    ADC_SQR3_SQ3 | ADC_SQR3_SQ2 | ADC_SQR3_SQ1  );

                                    ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  );

    /* Reset register JSQR */

    /* Reset register DR */

    CLEAR_BIT(hadc->Instance->JSQR, ADC_JSQR_JL |

    /* bits in access mode read only, no direct reset applicable*/

                                    ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

                                    ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  );

    /* Reset registers JDR1, JDR2, JDR3, JDR4 */

    /* bits in access mode read only, no direct reset applicable*/

    /* Reset register JSQR */

    CLEAR_BIT(hadc->Instance->JSQR, ADC_JSQR_JL |

    /* ========== Hard reset ADC peripheral ========== */

                                    ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

    /* Performs a global reset of the entire ADC peripheral: ADC state is     */

                                    ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  );

    /* forced to a similar state after device power-on.                       */

    /* If needed, copy-paste and uncomment the following reset code into      */

    /* Reset register DR */

    /* function "void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)":              */

    /* bits in access mode read only, no direct reset applicable*/

    /*                                                                        */

    /*  __HAL_RCC_ADC1_FORCE_RESET()                                          */

    /* Reset registers JDR1, JDR2, JDR3, JDR4 */

    /*  __HAL_RCC_ADC1_RELEASE_RESET()                                        */

    /* bits in access mode read only, no direct reset applicable*/

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

    /* ========== Hard reset ADC peripheral ========== */

    if (hadc->MspDeInitCallback == NULL)

    /* Performs a global reset of the entire ADC peripheral: ADC state is     */

    {

    /* forced to a similar state after device power-on.                       */

      hadc->MspDeInitCallback = HAL_ADC_MspDeInit; /* Legacy weak MspDeInit  */

    /* If needed, copy-paste and uncomment the following reset code into      */

    }

    /* function "void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)":              */

    /*                                                                        */

    /* DeInit the low level hardware */

    /*  __HAL_RCC_ADC1_FORCE_RESET()                                          */

    hadc->MspDeInitCallback(hadc);

    /*  __HAL_RCC_ADC1_RELEASE_RESET()                                        */

#else

    /* DeInit the low level hardware */

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

    HAL_ADC_MspDeInit(hadc);

    if (hadc->MspDeInitCallback == NULL)

#endif /* USE_HAL_ADC_REGISTER_CALLBACKS */

    {

      hadc->MspDeInitCallback = HAL_ADC_MspDeInit; /* Legacy weak MspDeInit  */

    /* Set ADC error code to none */

    }

    ADC_CLEAR_ERRORCODE(hadc);

    /* DeInit the low level hardware */

    /* Set ADC state */

    hadc->MspDeInitCallback(hadc);

    hadc->State = HAL_ADC_STATE_RESET;

#else

    /* DeInit the low level hardware */

  }

    HAL_ADC_MspDeInit(hadc);

#endif /* USE_HAL_ADC_REGISTER_CALLBACKS */

  /* Process unlocked */

  __HAL_UNLOCK(hadc);

    /* Set ADC error code to none */

    ADC_CLEAR_ERRORCODE(hadc);

  /* Return function status */

  return tmp_hal_status;

    /* Set ADC state */

}

    hadc->State = HAL_ADC_STATE_RESET;

/**

  }

  * @brief  Initializes the ADC MSP.

  * @param  hadc: ADC handle

  /* Process unlocked */

  * @retval None

  __HAL_UNLOCK(hadc);

  */

__weak void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)

  /* Return function status */

{

  return tmp_hal_status;

  /* Prevent unused argument(s) compilation warning */

}

  UNUSED(hadc);

  /* NOTE : This function should not be modified. When the callback is needed,

/**

            function HAL_ADC_MspInit must be implemented in the user file.

  * @brief  Initializes the ADC MSP.

   */

  * @param  hadc: ADC handle

}

  * @retval None

  */

/**

__weak void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)

  * @brief  DeInitializes the ADC MSP.

{

  * @param  hadc: ADC handle

  /* Prevent unused argument(s) compilation warning */

  * @retval None

  UNUSED(hadc);

  */

  /* NOTE : This function should not be modified. When the callback is needed,

__weak void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc)

            function HAL_ADC_MspInit must be implemented in the user file.

{

   */

  /* Prevent unused argument(s) compilation warning */

}

  UNUSED(hadc);

  /* NOTE : This function should not be modified. When the callback is needed,

/**

            function HAL_ADC_MspDeInit must be implemented in the user file.

  * @brief  DeInitializes the ADC MSP.

   */

  * @param  hadc: ADC handle

}

  * @retval None

  */

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

__weak void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc)

/**

{

  * @brief  Register a User ADC Callback

  /* Prevent unused argument(s) compilation warning */

  *         To be used instead of the weak predefined callback

  UNUSED(hadc);

  * @param  hadc Pointer to a ADC_HandleTypeDef structure that contains

  /* NOTE : This function should not be modified. When the callback is needed,

  *                the configuration information for the specified ADC.

            function HAL_ADC_MspDeInit must be implemented in the user file.

  * @param  CallbackID ID of the callback to be registered

   */

  *         This parameter can be one of the following values:

}

  *          @arg @ref HAL_ADC_CONVERSION_COMPLETE_CB_ID      ADC conversion complete callback ID

  *          @arg @ref HAL_ADC_CONVERSION_HALF_CB_ID          ADC conversion complete callback ID

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

  *          @arg @ref HAL_ADC_LEVEL_OUT_OF_WINDOW_1_CB_ID    ADC analog watchdog 1 callback ID