Subversion Repositories DashDisplay

/**

/**

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

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

  * @file    stm32l1xx_hal_adc.c

  * @file    stm32l1xx_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.

  *          "stm32l1xx_hal_adc_ex.c".

  *           + Control functions

  *

  *             ++ Channels configuration on regular group

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

  *             ++ Channels configuration on injected group

  * @attention

  *             ++ Analog Watchdog configuration

  *

  *           + State functions

  * Copyright (c) 2017 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

  *          "stm32l1xx_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, 10-bit, 8-bit or 6-bit configurable resolution

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

  [..]

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

  (+) 12-bit, 10-bit, 8-bit or 6-bit configurable 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) with configurable polarity

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

      for both regular and injected groups.

  (+) External trigger (timer or EXTI) with configurable polarity

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

      for both regular and injected groups.

  (+) ADC offset on injected channels

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

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

  (+) ADC offset on injected channels

      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 STM32L1, ADC clock frequency max is 16MHz (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 STM32L1, ADC clock frequency max is 16MHz (refer

                    function of ADC clock source frequency to remain below

                    to device datasheet).

                    this maximum frequency.

                    Therefore, ADC clock prescaler must be configured in

                    function of ADC clock source frequency to remain below

        (++) Two clock settings are mandatory:

                    this maximum frequency.

             (+++) ADC clock (core clock).

             (+++) ADC clock (conversions clock).

        (++) Two clock settings are mandatory:

                   Only one possible clock source: derived from HSI RC 16MHz oscillator

             (+++) ADC clock (core clock).

                   (HSI).

             (+++) ADC clock (conversions clock).

                   ADC is connected directly to HSI RC 16MHz oscillator.

                   Only one possible clock source: derived from HSI RC 16MHz oscillator

                   Therefore, RCC PLL setting has no impact on ADC.

                   (HSI).

                   PLL can be disabled (".PLL.PLLState = RCC_PLL_NONE") or

                   ADC is connected directly to HSI RC 16MHz oscillator.

                   enabled with HSI16 as clock source

                   Therefore, RCC PLL setting has no impact on ADC.

                   (".PLL.PLLSource = RCC_PLLSOURCE_HSI") to be used as device

                   PLL can be disabled (".PLL.PLLState = RCC_PLL_NONE") or

                   main clock source SYSCLK.

                   enabled with HSI16 as clock source

                   The only mandatory setting is ".HSIState = RCC_HSI_ON"

                   (".PLL.PLLSource = RCC_PLLSOURCE_HSI") to be used as device

                   main clock source SYSCLK.

             (+++) Example:

                   The only mandatory setting is ".HSIState = RCC_HSI_ON"

                   Into HAL_ADC_MspInit() (recommended code location) or with

                   other device clock parameters configuration:

             (+++) Example:

               (+++) __HAL_RCC_ADC1_CLK_ENABLE();

                   Into HAL_ADC_MspInit() (recommended code location) or with

                   other device clock parameters configuration:

               (+++) HAL_RCC_GetOscConfig(&RCC_OscInitStructure);

               (+++) __HAL_RCC_ADC1_CLK_ENABLE();

               (+++) RCC_OscInitStructure.OscillatorType = (... | RCC_OSCILLATORTYPE_HSI);

               (+++) RCC_OscInitStructure.HSIState = RCC_HSI_ON;

               (+++) HAL_RCC_GetOscConfig(&RCC_OscInitStructure);

               (+++) RCC_OscInitStructure.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;

               (+++) RCC_OscInitStructure.OscillatorType = (... | RCC_OSCILLATORTYPE_HSI);

               (+++) RCC_OscInitStructure.PLL.PLLState = RCC_PLL_NONE;

               (+++) RCC_OscInitStructure.HSIState = RCC_HSI_ON;

               (+++) RCC_OscInitStructure.PLL.PLLSource = ...

               (+++) RCC_OscInitStructure.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;

               (+++) RCC_OscInitStructure.PLL...

               (+++) RCC_OscInitStructure.PLL.PLLState = RCC_PLL_NONE;

               (+++) HAL_RCC_OscConfig(&RCC_OscInitStructure);

               (+++) RCC_OscInitStructure.PLL.PLLSource = ...

               (+++) RCC_OscInitStructure.PLL...

        (++) ADC clock prescaler is configured at ADC level with

               (+++) HAL_RCC_OscConfig(&RCC_OscInitStructure);

             parameter "ClockPrescaler" using function HAL_ADC_Init().

        (++) ADC clock prescaler is configured at ADC level with

    (#) ADC pins configuration

             parameter "ClockPrescaler" using function HAL_ADC_Init().

         (++) 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 ***

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

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

     [..]

        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:

               (+++) HAL_RCC_GetOscConfig(&RCC_OscInitStructure);

                   Into HAL_ADC_MspDeInit() (recommended code location) or with

               (+++) RCC_OscInitStructure.OscillatorType = RCC_OSCILLATORTYPE_HSI;

                   other device clock parameters configuration:

               (+++) RCC_OscInitStructure.HSIState = RCC_HSI_OFF; (if not used for system clock)

               (+++) HAL_RCC_GetOscConfig(&RCC_OscInitStructure);

               (+++) HAL_RCC_OscConfig(&RCC_OscInitStructure);

               (+++) RCC_OscInitStructure.OscillatorType = RCC_OSCILLATORTYPE_HSI;

               (+++) RCC_OscInitStructure.HSIState = RCC_HSI_OFF; (if not used for system clock)

    (#) ADC pins configuration

               (+++) HAL_RCC_OscConfig(&RCC_OscInitStructure);

         (++) 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) 2017 STMicroelectronics.

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

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

  *

#include "stm32l1xx_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 STM32L1xx_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 "stm32l1xx_hal.h"

#ifdef HAL_ADC_MODULE_ENABLED

/** @addtogroup STM32L1xx_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 7.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               (3U)

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

  /* prescaler 4, sampling time 7.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               (3U)

/* 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)

  * @{

  */

/**

static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma);

  * @}

static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma);

  */

static void ADC_DMAError(DMA_HandleTypeDef *hdma);

/**

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

  * @}

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

  */

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

/** @defgroup ADC_Private_Functions ADC Private Functions

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

  * @{

  */

/** @defgroup ADC_Exported_Functions ADC Exported Functions

static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma);

  * @{

static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma);

  */

static void ADC_DMAError(DMA_HandleTypeDef *hdma);

/**

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

  * @}

  * @brief    ADC 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 ADC Initialization/de-initialization functions

@endverbatim

  * @brief    ADC Initialization and Configuration functions

  * @{

  *

  */

@verbatim    

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

/**

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

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

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

  *         parameters specified in structure "ADC_InitTypeDef".

    [..]  This section provides functions allowing to:

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

      (+) Initialize and configure the ADC.

  *         (clock source APB2).

      (+) De-initialize the ADC.

  *         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 = 0;

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

  uint32_t tmp_cr2 = 0;

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

  *         of structure "ADC_InitTypeDef".

  /* Check ADC handle */

  * @param  hadc ADC handle

  if(hadc == NULL)

  * @retval HAL status

  {

  */

    return HAL_ERROR;

HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc)

  }

{

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  /* Check the parameters */

  uint32_t tmp_cr1 = 0;

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

  uint32_t tmp_cr2 = 0;

  assert_param(IS_ADC_CLOCKPRESCALER(hadc->Init.ClockPrescaler));

  assert_param(IS_ADC_RESOLUTION(hadc->Init.Resolution));

  /* Check ADC handle */

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

  if(hadc == NULL)

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

  {

  assert_param(IS_ADC_EOC_SELECTION(hadc->Init.EOCSelection));

    return HAL_ERROR;

  assert_param(IS_ADC_AUTOWAIT(hadc->Init.LowPowerAutoWait));

  }

  assert_param(IS_ADC_AUTOPOWEROFF(hadc->Init.LowPowerAutoPowerOff));

  assert_param(IS_ADC_CHANNELSBANK(hadc->Init.ChannelsBank));

  /* Check the parameters */

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

  assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));

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

  assert_param(IS_ADC_CLOCKPRESCALER(hadc->Init.ClockPrescaler));

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

  assert_param(IS_ADC_RESOLUTION(hadc->Init.Resolution));

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

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

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

  {

  assert_param(IS_ADC_EOC_SELECTION(hadc->Init.EOCSelection));

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

  assert_param(IS_ADC_AUTOWAIT(hadc->Init.LowPowerAutoWait));

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

  assert_param(IS_ADC_AUTOPOWEROFF(hadc->Init.LowPowerAutoPowerOff));

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

  assert_param(IS_ADC_CHANNELSBANK(hadc->Init.ChannelsBank));

    {

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

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

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

    }

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

  }

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

  if(hadc->Init.ExternalTrigConv != ADC_SOFTWARE_START)

  {

  {

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

    assert_param(IS_ADC_EXTTRIG_EDGE(hadc->Init.ExternalTrigConvEdge));

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

  }

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

    {

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

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

    }

  /* at RCC top level.                                                        */

  }

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

  /* procedure.                                                               */

  if(hadc->Init.ExternalTrigConv != ADC_SOFTWARE_START)

  {

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

    assert_param(IS_ADC_EXTTRIG_EDGE(hadc->Init.ExternalTrigConvEdge));

  /* - 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:                */

    /* Enable SYSCFG clock to control the routing Interface (RI) */

  /* - Initialization of ADC MSP                                              */

    __HAL_RCC_SYSCFG_CLK_ENABLE();

  if (hadc->State == HAL_ADC_STATE_RESET)

  {

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

    /* Initialize ADC error code */

    /* Init the ADC Callback settings */

    ADC_CLEAR_ERRORCODE(hadc);

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

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

    /* Allocate lock resource and initialize it */

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

    hadc->Lock = HAL_UNLOCKED;

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

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

    /* Enable SYSCFG clock to control the routing Interface (RI) */

    __HAL_RCC_SYSCFG_CLK_ENABLE();

    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  */

    }

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

  /* correctly completed.                                                     */

    /* Init the low level hardware */

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

    hadc->MspInitCallback(hadc);

  {

#else

    /* Set ADC state */

    /* Init the low level hardware */

    ADC_STATE_CLR_SET(hadc->State,

    HAL_ADC_MspInit(hadc);

                      HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY,

#endif /* USE_HAL_ADC_REGISTER_CALLBACKS */

                      HAL_ADC_STATE_BUSY_INTERNAL);

  }

    /* Set ADC parameters */

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

  /* correctly completed.                                                     */

    /* Configuration of common ADC clock: clock source HSI with selectable    */

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

    /* prescaler                                                              */

  {

    MODIFY_REG(ADC->CCR                 ,

    /* Set ADC state */

               ADC_CCR_ADCPRE           ,

    ADC_STATE_CLR_SET(hadc->State,

               hadc->Init.ClockPrescaler );

                      HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY,

                      HAL_ADC_STATE_BUSY_INTERNAL);

    /* Configuration of ADC:                                                  */

    /*  - external trigger polarity                                           */

    /* Set ADC parameters */

    /*  - End of conversion selection                                         */

    /*  - DMA continuous request                                              */

    /* Configuration of common ADC clock: clock source HSI with selectable    */

    /*  - Channels bank (Banks availability depends on devices categories)    */

    /* prescaler                                                              */

    /*  - continuous conversion mode                                          */

    MODIFY_REG(ADC->CCR                 ,

    tmp_cr2 |= (hadc->Init.DataAlign                                           |

               ADC_CCR_ADCPRE           ,

                hadc->Init.EOCSelection                                        |

               hadc->Init.ClockPrescaler );

                ADC_CR2_DMACONTREQ((uint32_t)hadc->Init.DMAContinuousRequests) |

                hadc->Init.ChannelsBank                                        |

    /* Configuration of ADC:                                                  */

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

    /*  - external trigger polarity                                           */

    /*  - End of conversion selection                                         */

    /* Enable external trigger if trigger selection is different of software  */

    /*  - DMA continuous request                                              */

    /* start.                                                                 */

    /*  - Channels bank (Banks availability depends on devices categories)    */

    /* Note: This configuration keeps the hardware feature of parameter       */

    /*  - continuous conversion mode                                          */

    /*       ExternalTrigConvEdge "trigger edge none" equivalent to           */

    tmp_cr2 |= (hadc->Init.DataAlign                                           |

    /*       software start.                                                  */

                hadc->Init.EOCSelection                                        |

    if (hadc->Init.ExternalTrigConv != ADC_SOFTWARE_START)

                ADC_CR2_DMACONTREQ((uint32_t)hadc->Init.DMAContinuousRequests) |

    {

                hadc->Init.ChannelsBank                                        |

      tmp_cr2 |= ( hadc->Init.ExternalTrigConv    |

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

                  hadc->Init.ExternalTrigConvEdge );

    }

    /* Enable external trigger if trigger selection is different of software  */

    /* start.                                                                 */

    /* Parameters update conditioned to ADC state:                            */

    /* Note: This configuration keeps the hardware feature of parameter       */

    /* Parameters that can be updated only when ADC is disabled:              */

    /*       ExternalTrigConvEdge "trigger edge none" equivalent to           */

    /*  - delay selection (LowPowerAutoWait mode)                             */

    /*       software start.                                                  */

    /*  - resolution                                                          */

    if (hadc->Init.ExternalTrigConv != ADC_SOFTWARE_START)

    /*  - auto power off (LowPowerAutoPowerOff mode)                          */

    {

    /*  - scan mode                                                           */

      tmp_cr2 |= ( hadc->Init.ExternalTrigConv    |

    /*  - discontinuous mode disable/enable                                   */

                  hadc->Init.ExternalTrigConvEdge );

    /*  - discontinuous mode number of conversions                            */

    }

    if ((ADC_IS_ENABLE(hadc) == RESET))

    {

    /* Parameters update conditioned to ADC state:                            */

      tmp_cr2 |= hadc->Init.LowPowerAutoWait;

    /* Parameters that can be updated only when ADC is disabled:              */

    /*  - delay selection (LowPowerAutoWait mode)                             */

      tmp_cr1 |= (hadc->Init.Resolution                     |

    /*  - resolution                                                          */

                  hadc->Init.LowPowerAutoPowerOff           |

    /*  - auto power off (LowPowerAutoPowerOff mode)                          */

                  ADC_CR1_SCAN_SET(hadc->Init.ScanConvMode)  );

    /*  - scan mode                                                           */

    /*  - discontinuous mode disable/enable                                   */

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

    /*  - discontinuous mode number of conversions                            */

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

    if ((ADC_IS_ENABLE(hadc) == RESET))

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

    {

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

      tmp_cr2 |= hadc->Init.LowPowerAutoWait;

      {

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

      tmp_cr1 |= (hadc->Init.Resolution                     |

        {

                  hadc->Init.LowPowerAutoPowerOff           |

          /* Enable the selected ADC regular discontinuous mode */

                  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 has 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_RES     |

          SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG);

                   ADC_CR1_PDI     |

                   ADC_CR1_PDD     |

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

                   ADC_CR1_DISCNUM |

          SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

                   ADC_CR1_DISCEN  |

        }

                   ADC_CR1_SCAN     ,

      }

                   tmp_cr1           );

    }

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

        MODIFY_REG(hadc->Instance->CR1,

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

                   ADC_CR1_RES     |

    MODIFY_REG(hadc->Instance->CR2    ,

                   ADC_CR1_PDI     |

               ADC_CR2_MASK_ADCINIT() ,

                   ADC_CR1_PDD     |

               tmp_cr2                 );

                   ADC_CR1_DISCNUM |

                   ADC_CR1_DISCEN  |

    /* Configuration of regular group sequencer:                              */

                   ADC_CR1_SCAN     ,

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

                   tmp_cr1           );

    /*   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        */

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

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

    MODIFY_REG(hadc->Instance->CR2    ,

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

               ADC_CR2_MASK_ADCINIT() ,

    /* - 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 */

      MODIFY_REG(hadc->Instance->SQR1                         ,

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

                 ADC_SQR1_L                                   ,

    /*   Parameter "NbrOfConversion" is discarded.                            */

                 ADC_SQR1_L_SHIFT(hadc->Init.NbrOfConversion)  );

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

    }

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

    else

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

    {

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

      MODIFY_REG(hadc->Instance->SQR1,

    /*   parameter "NbrOfConversion"                                          */

                 ADC_SQR1_L          ,

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

                 0x00000000           );

    {

    }

      MODIFY_REG(hadc->Instance->SQR1                         ,

                 ADC_SQR1_L                                   ,

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

                 ADC_SQR1_L_SHIFT(hadc->Init.NbrOfConversion)  );

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

    }

    /* Check through register CR2 (excluding execution control bits ADON,     */

    else

    /* JSWSTART, SWSTART and injected trigger bits JEXTEN and JEXTSEL).       */

    {

    if ((READ_REG(hadc->Instance->CR2) & ~(ADC_CR2_ADON |

      MODIFY_REG(hadc->Instance->SQR1,

                                           ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

                 ADC_SQR1_L          ,

                                           ADC_CR2_JEXTEN  | ADC_CR2_JEXTSEL   ))

                 0x00000000           );

         == tmp_cr2)

    }

    {

      /* Set ADC error code to none */

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

      ADC_CLEAR_ERRORCODE(hadc);

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

    /* Check through register CR2 (excluding execution control bits ADON,     */

      /* Set the ADC state */

    /* JSWSTART, SWSTART and injected trigger bits JEXTEN and JEXTSEL).       */

      ADC_STATE_CLR_SET(hadc->State,

    if ((READ_REG(hadc->Instance->CR2) & ~(ADC_CR2_ADON |

                        HAL_ADC_STATE_BUSY_INTERNAL,

                                           ADC_CR2_SWSTART | ADC_CR2_JSWSTART |

                        HAL_ADC_STATE_READY);

                                           ADC_CR2_JEXTEN  | ADC_CR2_JEXTSEL   ))

    }

         == 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);

  {

    tmp_hal_status = HAL_ERROR;

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

  }

      SET_BIT(hadc->ErrorCode, HAL_ADC_ERROR_INTERNAL);

  /* Return function status */

      tmp_hal_status = HAL_ERROR;

  return tmp_hal_status;

    }

}

  }

/**

  else

  * @brief  Deinitialize the ADC peripheral registers to its default reset values.

  {

  * @note   To not impact other ADCs, reset of common ADC registers have been

    tmp_hal_status = HAL_ERROR;

  *         left commented below.

  }

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

  *         function HAL_ADC_MspDeInit().

  /* Return function status */

  * @param  hadc ADC handle

  return tmp_hal_status;

  * @retval HAL status

}

  */

HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef* hadc)

/**

{

  * @brief  Deinitialize the ADC peripheral registers to its default reset values.

  HAL_StatusTypeDef tmp_hal_status = HAL_OK;

  * @note   To not impact other ADCs, reset of common ADC registers have been

  *         left commented below.

  /* 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 */

    /* Reset register SR */

  /* Disable ADC peripheral */

    __HAL_ADC_CLEAR_FLAG(hadc, (ADC_FLAG_AWD | ADC_FLAG_JEOC | ADC_FLAG_EOC |

  tmp_hal_status = ADC_ConversionStop_Disable(hadc);

                                ADC_FLAG_JSTRT | ADC_FLAG_STRT));

    /* Reset register CR1 */

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

    CLEAR_BIT(hadc->Instance->CR1, (ADC_CR1_OVRIE   | ADC_CR1_RES     | ADC_CR1_AWDEN  |

  /* correctly completed.                                                     */

                                    ADC_CR1_JAWDEN  | ADC_CR1_PDI     | ADC_CR1_PDD    |

  if (tmp_hal_status == HAL_OK)

                                    ADC_CR1_DISCNUM | ADC_CR1_JDISCEN | ADC_CR1_DISCEN |

  {

                                    ADC_CR1_JAUTO   | ADC_CR1_AWDSGL  | ADC_CR1_SCAN   |

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

                                    ADC_CR1_JEOCIE  | ADC_CR1_AWDIE   | ADC_CR1_EOCIE  |

    /* Reset register SR */

                                    ADC_CR1_AWDCH                                       ));

    __HAL_ADC_CLEAR_FLAG(hadc, (ADC_FLAG_AWD | ADC_FLAG_JEOC | ADC_FLAG_EOC |

                                ADC_FLAG_JSTRT | ADC_FLAG_STRT));

    /* Reset register CR2 */

    ADC_CR2_CLEAR(hadc);

    /* Reset register CR1 */

    CLEAR_BIT(hadc->Instance->CR1, (ADC_CR1_OVRIE   | ADC_CR1_RES     | ADC_CR1_AWDEN  |

    /* Reset register SMPR0 */

                                    ADC_CR1_JAWDEN  | ADC_CR1_PDI     | ADC_CR1_PDD    |

    ADC_SMPR0_CLEAR(hadc);

                                    ADC_CR1_DISCNUM | ADC_CR1_JDISCEN | ADC_CR1_DISCEN |

                                    ADC_CR1_JAUTO   | ADC_CR1_AWDSGL  | ADC_CR1_SCAN   |

    /* Reset register SMPR1 */

                                    ADC_CR1_JEOCIE  | ADC_CR1_AWDIE   | ADC_CR1_EOCIE  |

    ADC_SMPR1_CLEAR(hadc);

                                    ADC_CR1_AWDCH                                       ));

    /* Reset register SMPR2 */

    /* Reset register CR2 */

    CLEAR_BIT(hadc->Instance->SMPR2, (ADC_SMPR2_SMP19 | ADC_SMPR2_SMP18 | ADC_SMPR2_SMP17 |

    ADC_CR2_CLEAR(hadc);

                                      ADC_SMPR2_SMP16 | ADC_SMPR2_SMP15 | ADC_SMPR2_SMP14 |

                                      ADC_SMPR2_SMP13 | ADC_SMPR2_SMP12 | ADC_SMPR2_SMP11 |

    /* Reset register SMPR0 */

                                      ADC_SMPR2_SMP10                                      ));

    ADC_SMPR0_CLEAR(hadc);

    /* Reset register SMPR3 */

    /* Reset register SMPR1 */

    CLEAR_BIT(hadc->Instance->SMPR3, (ADC_SMPR3_SMP9 | ADC_SMPR3_SMP8 | ADC_SMPR3_SMP7 |

    ADC_SMPR1_CLEAR(hadc);

                                      ADC_SMPR3_SMP6 | ADC_SMPR3_SMP5 | ADC_SMPR3_SMP4 |

                                      ADC_SMPR3_SMP3 | ADC_SMPR3_SMP2 | ADC_SMPR3_SMP1 |

    /* Reset register SMPR2 */

                                      ADC_SMPR3_SMP0                                    ));

    CLEAR_BIT(hadc->Instance->SMPR2, (ADC_SMPR2_SMP19 | ADC_SMPR2_SMP18 | ADC_SMPR2_SMP17 |

                                      ADC_SMPR2_SMP16 | ADC_SMPR2_SMP15 | ADC_SMPR2_SMP14 |

    /* Reset register JOFR1 */

                                      ADC_SMPR2_SMP13 | ADC_SMPR2_SMP12 | ADC_SMPR2_SMP11 |

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

                                      ADC_SMPR2_SMP10                                      ));

    /* Reset register JOFR2 */

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

    /* Reset register SMPR3 */

    /* Reset register JOFR3 */

    CLEAR_BIT(hadc->Instance->SMPR3, (ADC_SMPR3_SMP9 | ADC_SMPR3_SMP8 | ADC_SMPR3_SMP7 |

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

                                      ADC_SMPR3_SMP6 | ADC_SMPR3_SMP5 | ADC_SMPR3_SMP4 |

    /* Reset register JOFR4 */

                                      ADC_SMPR3_SMP3 | ADC_SMPR3_SMP2 | ADC_SMPR3_SMP1 |

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

                                      ADC_SMPR3_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 | __ADC_SQR1_SQXX));

    /* Reset register JOFR4 */

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

    /* Reset register SQR2 */

    CLEAR_BIT(hadc->Instance->SQR2, (ADC_SQR2_SQ24 | ADC_SQR2_SQ23 | ADC_SQR2_SQ22 |

    /* Reset register HTR */

                                     ADC_SQR2_SQ21 | ADC_SQR2_SQ20 | ADC_SQR2_SQ19  ));

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

    /* Reset register LTR */

    /* Reset register SQR3 */

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

    CLEAR_BIT(hadc->Instance->SQR3, (ADC_SQR3_SQ18 | ADC_SQR3_SQ17 | ADC_SQR3_SQ16 |

                                     ADC_SQR3_SQ15 | ADC_SQR3_SQ14 | ADC_SQR3_SQ13  ));

    /* Reset register SQR1 */

    CLEAR_BIT(hadc->Instance->SQR1, (ADC_SQR1_L | __ADC_SQR1_SQXX));

    /* Reset register SQR4 */

    CLEAR_BIT(hadc->Instance->SQR4, (ADC_SQR4_SQ12 | ADC_SQR4_SQ11 | ADC_SQR4_SQ10 |

    /* Reset register SQR2 */

                                     ADC_SQR4_SQ9  | ADC_SQR4_SQ8  | ADC_SQR4_SQ7   ));

    CLEAR_BIT(hadc->Instance->SQR2, (ADC_SQR2_SQ24 | ADC_SQR2_SQ23 | ADC_SQR2_SQ22 |

                                     ADC_SQR2_SQ21 | ADC_SQR2_SQ20 | ADC_SQR2_SQ19  ));

    /* Reset register SQR5 */

    CLEAR_BIT(hadc->Instance->SQR5, (ADC_SQR5_SQ6 | ADC_SQR5_SQ5 | ADC_SQR5_SQ4 |

    /* Reset register SQR3 */

                                     ADC_SQR5_SQ3 | ADC_SQR5_SQ2 | ADC_SQR5_SQ1  ));

    CLEAR_BIT(hadc->Instance->SQR3, (ADC_SQR3_SQ18 | ADC_SQR3_SQ17 | ADC_SQR3_SQ16 |

                                     ADC_SQR3_SQ15 | ADC_SQR3_SQ14 | ADC_SQR3_SQ13  ));

    /* Reset register JSQR */

    /* Reset register SQR4 */

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

    CLEAR_BIT(hadc->Instance->SQR4, (ADC_SQR4_SQ12 | ADC_SQR4_SQ11 | ADC_SQR4_SQ10 |

                                     ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

                                     ADC_SQR4_SQ9  | ADC_SQR4_SQ8  | ADC_SQR4_SQ7   ));

                                     ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  ));

    /* Reset register SQR5 */

    /* Reset register DR */

    CLEAR_BIT(hadc->Instance->SQR5, (ADC_SQR5_SQ6 | ADC_SQR5_SQ5 | ADC_SQR5_SQ4 |

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

                                     ADC_SQR5_SQ3 | ADC_SQR5_SQ2 | ADC_SQR5_SQ1  ));

    /* 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 |

    /* Reset register CCR */

                                     ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3 |

    CLEAR_BIT(ADC->CCR, ADC_CCR_TSVREFE);  

                                     ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1  ));

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

    /* Reset register DR */

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

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

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

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

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

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

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

    /*                                                                        */

    /*  __HAL_RCC_ADC1_FORCE_RESET()                                          */

    /* Reset register CCR */

    /*  __HAL_RCC_ADC1_RELEASE_RESET()                                        */

    CLEAR_BIT(ADC->CCR, ADC_CCR_TSVREFE);  

#if (USE_HAL_ADC_REGISTER_CALLBACKS == 1)

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