Subversion Repositories DashDisplay

/**

/**

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

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

  * @file    stm32l1xx_hal_opamp.c

  * @file    stm32l1xx_hal_opamp.c

  * @author  MCD Application Team

  * @author  MCD Application Team

  * @brief   OPAMP HAL module driver.

  * @brief   OPAMP HAL module driver.

  *          This file provides firmware functions to manage the following

  *          This file provides firmware functions to manage the following

  *          functionalities of the operational amplifier(s) peripheral:

  *          functionalities of the operational amplifier(s) peripheral:

  *           + OPAMP configuration

  *           + Initialization and de-initialization functions

  *           + OPAMP calibration

  *           + IO operation functions

  *          Thanks to

  *           + Peripheral Control functions

  *           + Initialization and de-initialization functions

  *           + Peripheral State functions

  *           + IO operation functions

  *

  *           + Peripheral Control functions

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

  *           + Peripheral State functions

  * @attention

  *        

  *

  @verbatim

  * Copyright (c) 2017 STMicroelectronics.

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

  * All rights reserved.

          ##### OPAMP Peripheral Features #####

  *

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

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

  [..] The device integrates up to 3 operational amplifiers OPAMP1, OPAMP2,

  * in the root directory of this software component.

       OPAMP3 (OPAMP3 availability depends on device category)

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

  *

       (#) The OPAMP(s) provide(s) several exclusive running modes.

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

       (++) Standalone mode

  @verbatim

       (++) Follower mode

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

          ##### OPAMP Peripheral Features #####

       (#) All OPAMP (same for all OPAMPs) can operate in

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

       (++) Either Low range (VDDA < 2.4V) power supply

  [..] The device integrates up to 3 operational amplifiers OPAMP1, OPAMP2,

       (++) Or High range (VDDA > 2.4V) power supply

       OPAMP3 (OPAMP3 availability depends on device category)

       (#) Each OPAMP(s) can be configured in normal and low power mode.

       (#) The OPAMP(s) provide(s) several exclusive running modes.

       (++) Standalone mode

       (#) The OPAMP(s) provide(s) calibration capabilities.  

       (++) Follower mode

       (++) Calibration aims at correcting some offset for running mode.

       (++) The OPAMP uses either factory calibration settings OR user defined

       (#) All OPAMP (same for all OPAMPs) can operate in

           calibration (trimming) settings (i.e. trimming mode).

       (++) Either Low range (VDDA < 2.4V) power supply

       (++) The user defined settings can be figured out using self calibration

       (++) Or High range (VDDA > 2.4V) power supply

           handled by HAL_OPAMP_SelfCalibrate, HAL_OPAMPEx_SelfCalibrateAll

       (++) HAL_OPAMP_SelfCalibrate:

       (#) Each OPAMP(s) can be configured in normal and low power mode.

       (+++) Runs automatically the calibration in 2 steps: for transistors

            differential pair high (PMOS) or low (NMOS)

       (#) The OPAMP(s) provide(s) calibration capabilities.

       (+++) Enables the user trimming mode

       (++) Calibration aims at correcting some offset for running mode.

       (+++) Updates the init structure with trimming values with fresh calibration

       (++) The OPAMP uses either factory calibration settings OR user defined

            results.

           calibration (trimming) settings (i.e. trimming mode).

            The user may store the calibration results for larger

       (++) The user defined settings can be figured out using self calibration

            (ex monitoring the trimming as a function of temperature

           handled by HAL_OPAMP_SelfCalibrate, HAL_OPAMPEx_SelfCalibrateAll

            for instance)

       (++) HAL_OPAMP_SelfCalibrate:

       (+++) For devices having several OPAMPs, HAL_OPAMPEx_SelfCalibrateAll

       (+++) Runs automatically the calibration in 2 steps: for transistors

            runs calibration of all OPAMPs in parallel to save search time.

            differential pair high (PMOS) or low (NMOS)

       (+++) Enables the user trimming mode

       (#) Running mode: Standalone mode

       (+++) Updates the init structure with trimming values with fresh calibration

       (++) Gain is set externally (gain depends on external loads).

            results.

       (++) Follower mode also possible externally by connecting the inverting input to

            The user may store the calibration results for larger

           the output.

            (ex monitoring the trimming as a function of temperature

            for instance)

       (#) Running mode: Follower mode

       (+++) For devices having several OPAMPs, HAL_OPAMPEx_SelfCalibrateAll

       (++) No Inverting Input is connected.

            runs calibration of all OPAMPs in parallel to save search time.

       (++) The OPAMP(s) output(s) are internally connected to inverting input.

       (#) Running mode: Standalone mode

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

       (++) Gain is set externally (gain depends on external loads).

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

       (++) Follower mode also possible externally by connecting the inverting input to

  [..]

           the output.

    *** Power supply range ***

       (#) Running mode: Follower mode

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

       (++) No Inverting Input is connected.

    [..] To run in low power mode:

       (++) The OPAMP(s) output(s) are internally connected to inverting input.

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

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

      (++) Select OPAMP_POWERSUPPLY_LOW (VDDA lower than 2.4V)

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

      (++) Otherwise select OPAMP_POWERSUPPLY_HIGH (VDDA higher than 2.4V)

  [..]

    *** Low / normal power mode ***

    *** Power supply range ***

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

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

    [..] To run in low power mode:

    [..] To run in low power mode:

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

      (++) Select OPAMP_POWERMODE_LOWPOWER

      (++) Select OPAMP_POWERSUPPLY_LOW (VDDA lower than 2.4V)

      (++) Otherwise select OPAMP_POWERMODE_NORMAL

      (++) Otherwise select OPAMP_POWERSUPPLY_HIGH (VDDA higher than 2.4V)

    *** Calibration ***

    *** Low / normal power mode ***

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

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

    [..] To run the OPAMP calibration self calibration:

    [..] To run in low power mode:

      (#) Start calibration using HAL_OPAMP_SelfCalibrate.

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

           Store the calibration results.

      (++) Select OPAMP_POWERMODE_LOWPOWER

      (++) Otherwise select OPAMP_POWERMODE_NORMAL

    *** Running mode ***

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

    *** Calibration ***

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

    [..] To use the OPAMP, perform the following steps:

    [..] To run the OPAMP calibration self calibration:

      (#) Fill in the HAL_OPAMP_MspInit() to

      (#) Start calibration using HAL_OPAMP_SelfCalibrate.

      (++) Enable the OPAMP Peripheral clock using macro __HAL_RCC_OPAMP_CLK_ENABLE()

           Store the calibration results.

      (++) Configure the OPAMP input AND output in analog mode using

           HAL_GPIO_Init() to map the OPAMP output to the GPIO pin.

    *** Running mode ***

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

      (#) Registrate Callbacks

      (++) The compilation define  USE_HAL_OPAMP_REGISTER_CALLBACKS when set to 1

    [..] To use the OPAMP, perform the following steps:

           allows the user to configure dynamically the driver callbacks.

      (#) Fill in the HAL_OPAMP_MspInit() to

      (++) Use Functions @ref HAL_OPAMP_RegisterCallback() to register a user callback,

      (++) Enable the OPAMP Peripheral clock using macro __HAL_RCC_OPAMP_CLK_ENABLE()

           it allows to register following callbacks:

      (++) Configure the OPAMP input AND output in analog mode using

      (+++) MspInitCallback         : OPAMP MspInit.

           HAL_GPIO_Init() to map the OPAMP output to the GPIO pin.

      (+++) MspDeInitCallback       : OPAMP MspFeInit.

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

      (#) Registrate Callbacks

           and a pointer to the user callback function.

      (++) The compilation define  USE_HAL_OPAMP_REGISTER_CALLBACKS when set to 1

           allows the user to configure dynamically the driver callbacks.

      (++) Use function @ref HAL_OPAMP_UnRegisterCallback() to reset a callback to the default

           weak (surcharged) function. It allows to reset following callbacks:

      (++) Use Functions HAL_OPAMP_RegisterCallback() to register a user callback,

      (+++) MspInitCallback         : OPAMP MspInit.

           it allows to register following callbacks:

      (+++) MspDeInitCallback       : OPAMP MspdeInit.

      (+++) MspInitCallback         : OPAMP MspInit.

      (+++) All Callbacks

      (+++) MspDeInitCallback       : OPAMP MspFeInit.

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

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

           and a pointer to the user callback function.

      (++) Select the mode

      (++) Select the inverting input

      (++) Use function HAL_OPAMP_UnRegisterCallback() to reset a callback to the default

      (++) Select the non-inverting input

           weak (overridden) function. It allows to reset following callbacks:

      (++) Select either factory or user defined trimming mode.

      (+++) MspInitCallback         : OPAMP MspInit.

      (++) If the user-defined trimming mode is enabled, select PMOS & NMOS trimming values

      (+++) MspDeInitCallback       : OPAMP MspdeInit.

          (typically values set by HAL_OPAMP_SelfCalibrate function).

      (+++) All Callbacks

      (#) Enable the OPAMP using HAL_OPAMP_Start() function.

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

      (++) Select the mode

      (#) Disable the OPAMP using HAL_OPAMP_Stop() function.

      (++) Select the inverting input

      (++) Select the non-inverting input

      (#) Lock the OPAMP in running mode using HAL_OPAMP_Lock() function.

      (++) Select either factory or user defined trimming mode.

          Caution: On STM32L1, HAL OPAMP lock is software lock only (not

      (++) If the user-defined trimming mode is enabled, select PMOS & NMOS trimming values

          hardware lock as on some other STM32 devices)

          (typically values set by HAL_OPAMP_SelfCalibrate function).

      (#) If needed, unlock the OPAMP using HAL_OPAMPEx_Unlock() function.

      (#) Enable the OPAMP using HAL_OPAMP_Start() function.

    *** Running mode: change of configuration while OPAMP ON  ***

      (#) Disable the OPAMP using HAL_OPAMP_Stop() function.

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

    [..] To Re-configure OPAMP when OPAMP is ON (change on the fly)

      (#) Lock the OPAMP in running mode using HAL_OPAMP_Lock() function.

      (#) If needed, fill in the HAL_OPAMP_MspInit()

          Caution: On STM32L1, HAL OPAMP lock is software lock only (not

      (++) This is the case for instance if you wish to use new OPAMP I/O

          hardware lock as on some other STM32 devices)

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

      (#) If needed, unlock the OPAMP using HAL_OPAMPEx_Unlock() function.

      (++) As in configure case, select first the parameters you wish to modify.

    *** Running mode: change of configuration while OPAMP ON  ***

      (#) Change from low power mode to normal power mode (& vice versa) requires  

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

          first HAL_OPAMP_DeInit() (force OPAMP OFF) and then HAL_OPAMP_Init().

    [..] To Re-configure OPAMP when OPAMP is ON (change on the fly)

          In other words, of OPAMP is ON, HAL_OPAMP_Init can NOT change power mode

      (#) If needed, fill in the HAL_OPAMP_MspInit()

          alone.

      (++) This is the case for instance if you wish to use new OPAMP I/O

  @endverbatim

      (#) Configure the OPAMP using HAL_OPAMP_Init() function:

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

      (++) As in configure case, select first the parameters you wish to modify.

  * @attention

  *

      (#) Change from low power mode to normal power mode (& vice versa) requires

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

          first HAL_OPAMP_DeInit() (force OPAMP OFF) and then HAL_OPAMP_Init().

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

          In other words, of OPAMP is ON, HAL_OPAMP_Init can NOT change power mode

  *

          alone.

  * 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

  @endverbatim

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

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

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

  */

  *

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

/*

  */

  Additional remark:

    The OPAMPs inverting input can be selected among the list shown by table below.

/*

    The OPAMPs non inverting input can be selected among the list shown by table below.

  Additionnal remark:

    The OPAMPs inverting input can be selected among the list shown by table below.

    Table 1.  OPAMPs inverting/non-inverting inputs for STM32L1 devices:

    The OPAMPs non inverting input can be selected among the list shown by table below.

    +--------------------------------------------------------------------------+

    |                | HAL param  |    OPAMP1    |    OPAMP2    |   OPAMP3(4)  |

    Table 1.  OPAMPs inverting/non-inverting inputs for STM32L1 devices:

    |                |   name     |              |              |              |

    +--------------------------------------------------------------------------+

    |----------------|------------|--------------|--------------|--------------|

    |                | HAL param  |    OPAMP1    |    OPAMP2    |   OPAMP3(4)  |

    |   Inverting    |    VM0     |     PA2      |     PA7      |     PC2      |

    |                |   name     |              |              |              |

    |    input (1)   |    VM1     | VINM pin (2) | VINM pin (2) | VINM pin (2) |

    |----------------|------------|--------------|--------------|--------------|

    |----------------|------------|--------------|--------------|--------------|

    |   Inverting    |    VM0     |     PA2      |     PA7      |     PC2      |

    |  Non Inverting |    VP0     |     PA1      |     PA6      |     PC1      |

    |    input (1)   |    VM1     | VINM pin (2) | VINM pin (2) | VINM pin (2) |

    |    input       | DAC_CH1 (3)|   DAC_CH1    |   DAC_CH1    |     ---      |

    |----------------|------------|--------------|--------------|--------------|

    |                | DAC_CH2 (3)|     ---      |   DAC_CH2    |   DAC_CH2    |

    |  Non Inverting |    VP0     |     PA1      |     PA6      |     PC1      |

    +--------------------------------------------------------------------------+

    |    input       | DAC_CH1 (3)|   DAC_CH1    |   DAC_CH1    |     ---      |

    (1): NA in follower mode.

    |                | DAC_CH2 (3)|     ---      |   DAC_CH2    |   DAC_CH2    |

    (2): OPAMP input OPAMPx_VINM are dedicated OPAMP pins, their availability

    +--------------------------------------------------------------------------+

         depends on device package.

    (1): NA in follower mode.

    (3): DAC channels 1 and 2 are connected internally to OPAMP. Nevertheless,

    (2): OPAMP input OPAMPx_VINM are dedicated OPAMP pins, their availability

         I/O pins connected to DAC can still be used as DAC output (pins PA4

         depends on device package.

         and PA5).

    (3): DAC channels 1 and 2 are connected internally to OPAMP. Nevertheless,

    (4): OPAMP3 availability depends on device category.

         I/O pins connected to DAC can still be used as DAC output (pins PA4

         and PA5).

    Table 2.  OPAMPs outputs for STM32L1 devices:

    (4): OPAMP3 availability depends on device category.

    +--------------------------------------------------------+

    |                 |   OPAMP1   |   OPAMP2   |  OPAMP3(4) |

    Table 2.  OPAMPs outputs for STM32L1 devices:

    |-----------------|------------|------------|------------|

    +--------------------------------------------------------+

    | Output          |    PA3     |    PB0     |    PC3     |

    |                 |   OPAMP1   |   OPAMP2   |  OPAMP3(4) |

    +--------------------------------------------------------+

    |-----------------|------------|------------|------------|

    (4) : OPAMP3 availability depends on device category

    | Output          |    PA3     |    PB0     |    PC3     |

*/

    +--------------------------------------------------------+

    (4) : OPAMP3 availability depends on device category

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

*/

#include "stm32l1xx_hal.h"

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

/** @addtogroup STM32L1xx_HAL_Driver

#include "stm32l1xx_hal.h"

  * @{

  */

/** @addtogroup STM32L1xx_HAL_Driver

  * @{

/** @defgroup OPAMP OPAMP

  */

  * @brief OPAMP module driver

  * @{

/** @defgroup OPAMP OPAMP

  */

  * @brief OPAMP module driver

  * @{

#ifdef HAL_OPAMP_MODULE_ENABLED

  */

#if defined (STM32L151xCA) || defined (STM32L151xD) || defined (STM32L152xCA) || defined (STM32L152xD) || defined (STM32L162xCA) || defined (STM32L162xD) || defined (STM32L151xE) || defined (STM32L151xDX) || defined (STM32L152xE) || defined (STM32L152xDX) || defined (STM32L162xE) || defined (STM32L162xDX) || defined (STM32L162xC) || defined (STM32L152xC) || defined (STM32L151xC)

#ifdef HAL_OPAMP_MODULE_ENABLED

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

#if defined (STM32L151xCA) || defined (STM32L151xD) || defined (STM32L152xCA) || defined (STM32L152xD) || defined (STM32L162xCA) || defined (STM32L162xD) || defined (STM32L151xE) || defined (STM32L151xDX) || defined (STM32L152xE) || defined (STM32L152xDX) || defined (STM32L162xE) || defined (STM32L162xDX) || defined (STM32L162xC) || defined (STM32L152xC) || defined (STM32L151xC)

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

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

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

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

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

/* Private constants ---------------------------------------------------------*/

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

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

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

/* Private functions ---------------------------------------------------------*/

/* Private constants ---------------------------------------------------------*/

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

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

/* Private functions ---------------------------------------------------------*/

/** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions

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

  * @{

  */

/** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions

  * @{

/** @defgroup OPAMP_Exported_Functions_Group1 Initialization and de-initialization functions

  */

 *  @brief    Initialization and Configuration functions

 *

/** @defgroup OPAMP_Exported_Functions_Group1 Initialization and de-initialization functions

@verbatim

 *  @brief    Initialization and Configuration functions

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

 *

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

@verbatim    

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

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

   [..]  This section provides functions allowing to:

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

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

@endverbatim

   [..]  This section provides functions allowing to:

  * @{

  */

@endverbatim

  * @{

/**

  */

  * @brief  Initializes the OPAMP according to the specified

  *         parameters in the OPAMP_InitTypeDef and create the associated handle.

/**

  * @note   If the selected opamp is locked, initialization can't be performed.

  * @brief  Initializes the OPAMP according to the specified

  *         To unlock the configuration, perform a system reset.

  *         parameters in the OPAMP_InitTypeDef and create the associated handle.

  * @param  hopamp OPAMP handle

  * @note   If the selected opamp is locked, initialization can't be performed.

  * @retval HAL status

  *         To unlock the configuration, perform a system reset.

  */

  * @param  hopamp OPAMP handle

HAL_StatusTypeDef HAL_OPAMP_Init(OPAMP_HandleTypeDef* hopamp)

  * @retval HAL status

{

  */

  HAL_StatusTypeDef status = HAL_OK;

HAL_StatusTypeDef HAL_OPAMP_Init(OPAMP_HandleTypeDef* hopamp)

  uint32_t tmp_csr;       /* Temporary variable to update register CSR, except bits ANAWSSELx, S7SEL2, OPA_RANGE, OPAxCALOUT */

{

  HAL_StatusTypeDef status = HAL_OK;

  /* Check the OPAMP handle allocation and lock status */

  uint32_t tmp_csr;       /* Temporary variable to update register CSR, except bits ANAWSSELx, S7SEL2, OPA_RANGE, OPAxCALOUT */

  /* Init not allowed if calibration is ongoing */

  if(hopamp == NULL)

  /* Check the OPAMP handle allocation and lock status */

  {

  /* Init not allowed if calibration is ongoing */

    return HAL_ERROR;

  if(hopamp == NULL)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

    return HAL_ERROR;

  {

  }

    return HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

    return HAL_ERROR;

  {

  }

    return HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

  }

  {

  else

    return HAL_ERROR;

  {

  }

    /* Check the parameter */

  else

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

  {

    /* Check the parameter */

    /* Set OPAMP parameters */

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

    assert_param(IS_OPAMP_POWER_SUPPLY_RANGE(hopamp->Init.PowerSupplyRange));

    assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));

    /* Set OPAMP parameters */

    assert_param(IS_OPAMP_FUNCTIONAL_NORMALMODE(hopamp->Init.Mode));

    assert_param(IS_OPAMP_POWER_SUPPLY_RANGE(hopamp->Init.PowerSupplyRange));

    assert_param(IS_OPAMP_NONINVERTING_INPUT_CHECK_INSTANCE(hopamp, hopamp->Init.NonInvertingInput));

    assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));

    assert_param(IS_OPAMP_TRIMMING(hopamp->Init.UserTrimming));

    assert_param(IS_OPAMP_FUNCTIONAL_NORMALMODE(hopamp->Init.Mode));

    assert_param(IS_OPAMP_NONINVERTING_INPUT_CHECK_INSTANCE(hopamp, hopamp->Init.NonInvertingInput));

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

    assert_param(IS_OPAMP_TRIMMING(hopamp->Init.UserTrimming));

    if(hopamp->State == HAL_OPAMP_STATE_RESET)

    {

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

      if(hopamp->MspInitCallback == NULL)

    if(hopamp->State == HAL_OPAMP_STATE_RESET)

      {

    {

        hopamp->MspInitCallback               = HAL_OPAMP_MspInit;

      if(hopamp->MspInitCallback == NULL)

      }

      {

    }

        hopamp->MspInitCallback               = HAL_OPAMP_MspInit;

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

      }

    }

    if (hopamp->Init.Mode != OPAMP_FOLLOWER_MODE)

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

    {

      assert_param(IS_OPAMP_INVERTING_INPUT(hopamp->Init.InvertingInput));

    if (hopamp->Init.Mode != OPAMP_FOLLOWER_MODE)

    }

    {

      assert_param(IS_OPAMP_INVERTING_INPUT(hopamp->Init.InvertingInput));

    if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

    }

    {

      if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)

    if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

      {

    {

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueP));

      if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueN));

      {

      }

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueP));

      else

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueN));

      {

      }

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValuePLowPower));

      else

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueNLowPower));

      {

      }

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValuePLowPower));

    }

        assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueNLowPower));

      }

    if(hopamp->State == HAL_OPAMP_STATE_RESET)

    }

    {

      /* Allocate lock resource and initialize it */

    if(hopamp->State == HAL_OPAMP_STATE_RESET)

      hopamp->Lock = HAL_UNLOCKED;

    {

    }

      /* Allocate lock resource and initialize it */

      hopamp->Lock = HAL_UNLOCKED;

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

    }

    hopamp->MspInitCallback(hopamp);

#else

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

    /* Call MSP init function */

    hopamp->MspInitCallback(hopamp);    

    HAL_OPAMP_MspInit(hopamp);

#else

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

    /* Call MSP init function */

    HAL_OPAMP_MspInit(hopamp);

    /* Set OPAMP parameters                                                   */

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

    /* - Set internal switches in function of:                                */

    /*   - OPAMP selected mode: standalone or follower.                       */

    /* Set OPAMP parameters                                                   */

    /*   - Non-inverting input connection                                     */

    /* - Set internal switches in function of:                                */

    /*   - Inverting input connection                                         */

    /*   - OPAMP selected mode: standalone or follower.                       */

    /* - Set power supply range                                               */

    /*   - Non-inverting input connection                                     */

    /* - Set power mode and associated calibration parameters                 */

    /*   - Inverting input connection                                         */

    /* - Set power supply range                                               */

    /* Get OPAMP CSR register into temporary variable */

    /* - Set power mode and associated calibration parameters                 */

    /* Note: OPAMP register CSR is written directly, independently of OPAMP   */

    /*       instance, because all OPAMP settings are dispatched in the same  */

    /* Get OPAMP CSR register into temporary variable */

    /*       register.                                                        */

    /* Note: OPAMP register CSR is written directly, independently of OPAMP   */

    /*       Settings of bits for each OPAMP instances are managed case by    */

    /*       instance, because all OPAMP settings are dispatched in the same  */

    /*       case using macro (OPAMP_CSR_S3SELX(), OPAMP_CSR_ANAWSELX(), ...) */

    /*       register.                                                        */

    tmp_csr = OPAMP->CSR;

    /*       Settings of bits for each OPAMP instances are managed case by    */

    /*       case using macro (OPAMP_CSR_S3SELX(), OPAMP_CSR_ANAWSELX(), ...) */

    /* Open all switches on non-inverting input, inverting input and output   */

    tmp_csr = OPAMP->CSR;

    /* feedback.                                                              */

    CLEAR_BIT(tmp_csr, OPAMP_CSR_ALL_SWITCHES(hopamp));

    /* Open all switches on non-inverting input, inverting input and output   */

    /* feedback.                                                              */

    /* Set internal switches in function of OPAMP mode selected: standalone   */

    CLEAR_BIT(tmp_csr, OPAMP_CSR_ALL_SWITCHES(hopamp));

    /* or follower.                                                           */

    /* If follower mode is selected, feedback switch S3 is closed and         */

    /* Set internal switches in function of OPAMP mode selected: standalone   */

    /* inverting inputs switches are let opened.                              */

    /* or follower.                                                           */

    /* If standalone mode is selected, feedback switch S3 is let opened and   */

    /* If follower mode is selected, feedback switch S3 is closed and         */

    /* the selected inverting inputs switch is closed.                        */

    /* inverting inputs switches are let opened.                              */

    if (hopamp->Init.Mode == OPAMP_FOLLOWER_MODE)

    /* If standalone mode is selected, feedback switch S3 is let opened and   */

    {

    /* the selected inverting inputs switch is closed.                        */

      /* Follower mode: Close switches S3 and SanB */

    if (hopamp->Init.Mode == OPAMP_FOLLOWER_MODE)

      SET_BIT(tmp_csr, OPAMP_CSR_S3SELX(hopamp));

    {

    }

      /* Follower mode: Close switches S3 and SanB */

    else

      SET_BIT(tmp_csr, OPAMP_CSR_S3SELX(hopamp));

    {

    }

      /* Set internal switches in function of inverting input selected:       */

    else

      /* Close switch to connect OPAMP inverting input to the selected        */

    {

      /* input: dedicated IO pin or alternative IO pin available on some      */

      /* Set internal switches in function of inverting input selected:       */

      /* device packages.                                                     */

      /* Close switch to connect OPAMP inverting input to the selected        */

      if (hopamp->Init.InvertingInput == OPAMP_INVERTINGINPUT_IO0)

      /* input: dedicated IO pin or alternative IO pin available on some      */

      {

      /* device packages.                                                     */

        /* Close switch to connect OPAMP non-inverting input to               */

      if (hopamp->Init.InvertingInput == OPAMP_INVERTINGINPUT_IO0)

        /* dedicated IO pin low-leakage.                                      */

      {

        SET_BIT(tmp_csr, OPAMP_CSR_S4SELX(hopamp));

        /* Close switch to connect OPAMP non-inverting input to               */

      }

        /* dedicated IO pin low-leakage.                                      */

      else

        SET_BIT(tmp_csr, OPAMP_CSR_S4SELX(hopamp));

      {

      }

        /* Close switch to connect OPAMP inverting input to alternative       */

      else

        /* IO pin available on some device packages.                          */

      {

        SET_BIT(tmp_csr, OPAMP_CSR_ANAWSELX(hopamp));

        /* Close switch to connect OPAMP inverting input to alternative       */

      }

        /* IO pin available on some device packages.                          */

    }

        SET_BIT(tmp_csr, OPAMP_CSR_ANAWSELX(hopamp));

      }

    /* Set internal switches in function of non-inverting input selected:     */

    }

    /* Close switch to connect OPAMP non-inverting input to the selected      */

    /* input: dedicated IO pin or DAC channel.                                */

    /* Set internal switches in function of non-inverting input selected:     */

    if (hopamp->Init.NonInvertingInput == OPAMP_NONINVERTINGINPUT_IO0)

    /* Close switch to connect OPAMP non-inverting input to the selected      */

    {

    /* input: dedicated IO pin or DAC channel.                                */

      /* Close switch to connect OPAMP non-inverting input to                 */

    if (hopamp->Init.NonInvertingInput == OPAMP_NONINVERTINGINPUT_IO0)

      /* dedicated IO pin low-leakage.                                        */

    {

      SET_BIT(tmp_csr, OPAMP_CSR_S5SELX(hopamp));

      /* Close switch to connect OPAMP non-inverting input to                 */

    }

      /* dedicated IO pin low-leakage.                                        */

    else if (hopamp->Init.NonInvertingInput == OPAMP_NONINVERTINGINPUT_DAC_CH1)

      SET_BIT(tmp_csr, OPAMP_CSR_S5SELX(hopamp));

    {

    }

    else if (hopamp->Init.NonInvertingInput == OPAMP_NONINVERTINGINPUT_DAC_CH1)

      /* Particular case for connection to DAC channel 1:                     */

    {

      /* OPAMP_NONINVERTINGINPUT_DAC_CH1 available on OPAMP1 and OPAMP2 only  */

      /* (OPAMP3 availability depends on device category).                    */

      /* Particular case for connection to DAC channel 1:                     */

      if ((hopamp->Instance == OPAMP1) || (hopamp->Instance == OPAMP2))

      /* OPAMP_NONINVERTINGINPUT_DAC_CH1 available on OPAMP1 and OPAMP2 only  */

      {

      /* (OPAMP3 availability depends on device category).                    */

        /* Close switch to connect OPAMP non-inverting input to               */

      if ((hopamp->Instance == OPAMP1) || (hopamp->Instance == OPAMP2))

        /* DAC channel 1.                                                     */

      {

        SET_BIT(tmp_csr, OPAMP_CSR_S6SELX(hopamp));

        /* Close switch to connect OPAMP non-inverting input to               */

      }

        /* DAC channel 1.                                                     */

      else

        SET_BIT(tmp_csr, OPAMP_CSR_S6SELX(hopamp));

      {

      }

        /* Set HAL status to error if another OPAMP instance as OPAMP1 or     */

      else

        /* OPAMP2 is intended to be connected to DAC channel 2.               */

      {

        status = HAL_ERROR;

        /* Set HAL status to error if another OPAMP instance as OPAMP1 or     */

      }

        /* OPAMP2 is intended to be connected to DAC channel 2.               */

    }

        status = HAL_ERROR;

    else /* if (hopamp->Init.NonInvertingInput ==                             */

      }

         /*     OPAMP_NONINVERTINGINPUT_DAC_CH2  )                            */

    }

    {

    else /* if (hopamp->Init.NonInvertingInput ==                             */

      /* Particular case for connection to DAC channel 2:                     */

         /*     OPAMP_NONINVERTINGINPUT_DAC_CH2  )                            */

      /* OPAMP_NONINVERTINGINPUT_DAC_CH2 available on OPAMP2 and OPAMP3 only  */

    {

      /* (OPAMP3 availability depends on device category).                    */

      /* Particular case for connection to DAC channel 2:                     */

      if (hopamp->Instance == OPAMP2)

      /* OPAMP_NONINVERTINGINPUT_DAC_CH2 available on OPAMP2 and OPAMP3 only  */

      {

      /* (OPAMP3 availability depends on device category).                    */

        /* Close switch to connect OPAMP non-inverting input to               */

      if (hopamp->Instance == OPAMP2)

        /* DAC channel 2.                                                     */

      {

        SET_BIT(tmp_csr, OPAMP_CSR_S7SEL2);

        /* Close switch to connect OPAMP non-inverting input to               */

      }

        /* DAC channel 2.                                                     */

      /* If OPAMP3 is selected (if available) */

        SET_BIT(tmp_csr, OPAMP_CSR_S7SEL2);

      else if (hopamp->Instance != OPAMP1)

      }

      {

      /* If OPAMP3 is selected (if available) */

        /* Close switch to connect OPAMP non-inverting input to               */

      else if (hopamp->Instance != OPAMP1)

        /* DAC channel 2.                                                     */

      {

        SET_BIT(tmp_csr, OPAMP_CSR_S6SELX(hopamp));

        /* Close switch to connect OPAMP non-inverting input to               */

      }

        /* DAC channel 2.                                                     */

      else

        SET_BIT(tmp_csr, OPAMP_CSR_S6SELX(hopamp));

      {

      }

        /* Set HAL status to error if another OPAMP instance as OPAMP2 or     */

      else

        /* OPAMP3 (if available) is intended to be connected to DAC channel 2.*/

      {

        status = HAL_ERROR;

        /* Set HAL status to error if another OPAMP instance as OPAMP2 or     */

      }

        /* OPAMP3 (if available) is intended to be connected to DAC channel 2.*/

    }

        status = HAL_ERROR;

      }

    /* Continue OPAMP configuration if settings of switches are correct */

    }

    if (status != HAL_ERROR)

    {

    /* Continue OPAMP configuration if settings of switches are correct */

      /* Set power mode and associated calibration parameters */

    if (status != HAL_ERROR)

      if (hopamp->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)

    {

      {

      /* Set power mode and associated calibration parameters */

        /* Set normal mode */

      if (hopamp->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)

        CLEAR_BIT(tmp_csr, OPAMP_CSR_OPAXLPM(hopamp));

      {

        /* Set normal mode */

        if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

        CLEAR_BIT(tmp_csr, OPAMP_CSR_OPAXLPM(hopamp));

        {

          /* Set calibration mode (factory or user) and values for            */

        if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

          /* transistors differential pair high (PMOS) and low (NMOS) for     */

        {

          /* normal mode.                                                     */

          /* Set calibration mode (factory or user) and values for            */

          MODIFY_REG(OPAMP->OTR, OPAMP_OTR_OT_USER                                                                     |

          /* transistors differential pair high (PMOS) and low (NMOS) for     */

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, OPAMP_TRIM_VALUE_MASK)       |

          /* normal mode.                                                     */

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, OPAMP_TRIM_VALUE_MASK)        ,

          MODIFY_REG(OPAMP->OTR, OPAMP_OTR_OT_USER                                                                     |

                                 hopamp->Init.UserTrimming                                                             |

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, OPAMP_TRIM_VALUE_MASK)       |

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, hopamp->Init.TrimmingValueN) |

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, OPAMP_TRIM_VALUE_MASK)        ,

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, hopamp->Init.TrimmingValueP)  );

                                 hopamp->Init.UserTrimming                                                             |

        }

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, hopamp->Init.TrimmingValueN) |

        else

                                 OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, hopamp->Init.TrimmingValueP)  );

        {

        }

          /* Set calibration mode to factory */

        else

          CLEAR_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

        {

        }

          /* Set calibration mode to factory */

          CLEAR_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

      }

        }

      else

      {

      }

        /* Set low power mode */

      else

        SET_BIT(tmp_csr, OPAMP_CSR_OPAXLPM(hopamp));

      {

        /* Set low power mode */

        if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

        SET_BIT(tmp_csr, OPAMP_CSR_OPAXLPM(hopamp));

        {

          /* Set calibration mode to user trimming */

        if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)

          SET_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

        {

          /* Set calibration mode to user trimming */

          /* Set values for transistors differential pair high (PMOS) and low */

          SET_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

          /* (NMOS) for low power mode.                                       */

          MODIFY_REG(OPAMP->LPOTR, OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, OPAMP_TRIM_VALUE_MASK)               |

          /* Set values for transistors differential pair high (PMOS) and low */

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, OPAMP_TRIM_VALUE_MASK)                ,

          /* (NMOS) for low power mode.                                       */

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, hopamp->Init.TrimmingValueNLowPower) |

          MODIFY_REG(OPAMP->LPOTR, OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, OPAMP_TRIM_VALUE_MASK)               |

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, hopamp->Init.TrimmingValuePLowPower)  );

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, OPAMP_TRIM_VALUE_MASK)                ,

        }

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_N, hopamp->Init.TrimmingValueNLowPower) |

        else

                                   OPAMP_OFFSET_TRIM_SET(hopamp, OPAMP_FACTORYTRIMMING_P, hopamp->Init.TrimmingValuePLowPower)  );

        {

        }

          /* Set calibration mode to factory trimming */

        else

          CLEAR_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

        {

        }

          /* Set calibration mode to factory trimming */

          CLEAR_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

      }

        }

      }

      /* Configure the power supply range */

      MODIFY_REG(tmp_csr, OPAMP_CSR_AOP_RANGE,

                          hopamp->Init.PowerSupplyRange);

      /* Configure the power supply range */

      MODIFY_REG(tmp_csr, OPAMP_CSR_AOP_RANGE,

      /* Set OPAMP CSR register from temporary variable */

                          hopamp->Init.PowerSupplyRange);

      /* This allows to apply all changes on one time, in case of update on   */

      /* the fly with OPAMP previously set and running:                       */

      /* Set OPAMP CSR register from temporary variable */

      /*  - to avoid hazardous transient switches settings (risk of short     */

      /* This allows to apply all changes on one time, in case of update on   */

      /*    circuit)                                                          */

      /* the fly with OPAMP previously set and running:                       */

      /*  - to avoid interruption of input signal                             */

      /*  - to avoid hazardous transient switches settings (risk of short     */

      OPAMP->CSR = tmp_csr;

      /*    circuit)                                                          */

      /*  - to avoid interruption of input signal                             */

      OPAMP->CSR = tmp_csr;

      /* Update the OPAMP state */

      /* If coming from state reset: Update from state RESET to state READY */

      if (hopamp->State == HAL_OPAMP_STATE_RESET)

      /* Update the OPAMP state */

      {

      /* If coming from state reset: Update from state RESET to state READY */

        hopamp->State = HAL_OPAMP_STATE_READY;

      if (hopamp->State == HAL_OPAMP_STATE_RESET)

      }

      {

      /* else: OPAMP state remains READY or BUSY state (no update) */

        hopamp->State = HAL_OPAMP_STATE_READY;

    }

      }

  }

      /* else: OPAMP state remains READY or BUSY state (no update) */

    }

  return status;

  }

}

  return status;

/**

}

  * @brief  DeInitializes the OPAMP peripheral

  * @note   Deinitialization can be performed if the OPAMP configuration is locked.

/**

  *         (the OPAMP lock is SW in STM32L1)

  * @brief  DeInitializes the OPAMP peripheral

  * @param  hopamp OPAMP handle

  * @note   Deinitialization can be performed if the OPAMP configuration is locked.

  * @retval HAL status

  *         (the OPAMP lock is SW in STM32L1)

  */

  * @param  hopamp OPAMP handle

HAL_StatusTypeDef HAL_OPAMP_DeInit(OPAMP_HandleTypeDef* hopamp)

  * @retval HAL status

{

  */

  HAL_StatusTypeDef status = HAL_OK;

HAL_StatusTypeDef HAL_OPAMP_DeInit(OPAMP_HandleTypeDef* hopamp)

{

  /* Check the OPAMP handle allocation */

  HAL_StatusTypeDef status = HAL_OK;

  /* DeInit not allowed if calibration is ongoing */

  if(hopamp == NULL)

  /* Check the OPAMP handle allocation */

  {

  /* DeInit not allowed if calibration is ongoing */

    status = HAL_ERROR;

  if(hopamp == NULL)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

    status = HAL_ERROR;

  {

  }

    status = HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

  }

  {

  else

    status = HAL_ERROR;

  {

  }

    /* Check the parameter */

  else

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

  {

    /* Check the parameter */

    /* Disable the selected opamp */

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

    SET_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

    /* Disable the selected opamp */

    /* Open all switches on non-inverting input, inverting input and output   */

    SET_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

    /* feedback.                                                              */

    /* Note: OPAMP register CSR is written directly, independently of OPAMP   */

    /* Open all switches on non-inverting input, inverting input and output   */

    /*       instance, because all OPAMP settings are dispatched in the same  */

    /* feedback.                                                              */

    /*       register.                                                        */

    /* Note: OPAMP register CSR is written directly, independently of OPAMP   */

    /*       Settings of bits for each OPAMP instances are managed case by    */

    /*       instance, because all OPAMP settings are dispatched in the same  */

    /*       case using macro (OPAMP_CSR_S3SELX(), OPAMP_CSR_ANAWSELX(), ...) */

    /*       register.                                                        */

    CLEAR_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

    /*       Settings of bits for each OPAMP instances are managed case by    */

    /*       case using macro (OPAMP_CSR_S3SELX(), OPAMP_CSR_ANAWSELX(), ...) */

    /* Note: Registers and bits shared with other OPAMP instances are kept    */

    CLEAR_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

    /*       unchanged, to not impact other OPAMP while operating on the      */

    /*       selected OPAMP.                                                  */

    /* Note: Registers and bits shared with other OPAMP instances are kept    */

    /*       Unchanged: bit OPAMP_OTR_OT_USER (parameter "UserTrimming")      */

    /*       unchanged, to not impact other OPAMP while operating on the      */

    /*                  bit OPAMP_CSR_AOP_RANGE (parameter "PowerSupplyRange")*/

    /*       selected OPAMP.                                                  */

    /*       Unchanged: bit OPAMP_OTR_OT_USER (parameter "UserTrimming")      */

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

    /*                  bit OPAMP_CSR_AOP_RANGE (parameter "PowerSupplyRange")*/

  if(hopamp->MspDeInitCallback == NULL)

  {

#if (USE_HAL_OPAMP_REGISTER_CALLBACKS == 1)

    hopamp->MspDeInitCallback = HAL_OPAMP_MspDeInit;

  if(hopamp->MspDeInitCallback == NULL)

  }

  {

  /* DeInit the low level hardware */

    hopamp->MspDeInitCallback = HAL_OPAMP_MspDeInit;

  hopamp->MspDeInitCallback(hopamp);

  }

#else

  /* DeInit the low level hardware */

    /* DeInit the low level hardware: GPIO, CLOCK and NVIC */

  hopamp->MspDeInitCallback(hopamp);

    HAL_OPAMP_MspDeInit(hopamp);

#else

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

    /* DeInit the low level hardware: GPIO, CLOCK and NVIC */

    HAL_OPAMP_MspDeInit(hopamp);

    /* Update the OPAMP state*/

#endif /* USE_HAL_OPAMP_REGISTER_CALLBACKS */

    hopamp->State = HAL_OPAMP_STATE_RESET;

  }

    /* Update the OPAMP state*/

    hopamp->State = HAL_OPAMP_STATE_RESET;

  /* Process unlocked */

  }

  __HAL_UNLOCK(hopamp);

  /* Process unlocked */

  return status;

  __HAL_UNLOCK(hopamp);

}

  return status;

/**

}

  * @brief  Initialize the OPAMP MSP.

  * @param  hopamp OPAMP handle

/**

  * @retval None

  * @brief  Initialize the OPAMP MSP.

  */

  * @param  hopamp OPAMP handle

__weak void HAL_OPAMP_MspInit(OPAMP_HandleTypeDef* hopamp)

  * @retval None

{

  */

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

__weak void HAL_OPAMP_MspInit(OPAMP_HandleTypeDef* hopamp)

  UNUSED(hopamp);

{

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

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

  UNUSED(hopamp);

            the function "HAL_OPAMP_MspInit()" must be implemented in the user file.

  */

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

}

            the function "HAL_OPAMP_MspInit()" must be implemented in the user file.

  */

/**

}

  * @brief  DeInitialize OPAMP MSP.

  * @param  hopamp OPAMP handle

/**

  * @retval None

  * @brief  DeInitialize OPAMP MSP.

  */

  * @param  hopamp OPAMP handle

__weak void HAL_OPAMP_MspDeInit(OPAMP_HandleTypeDef* hopamp)

  * @retval None

{

  */

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

__weak void HAL_OPAMP_MspDeInit(OPAMP_HandleTypeDef* hopamp)

  UNUSED(hopamp);

{

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

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

  UNUSED(hopamp);

            the function "HAL_OPAMP_MspDeInit()" must be implemented in the user file.

  */

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

}

            the function "HAL_OPAMP_MspDeInit()" must be implemented in the user file.

  */

/**

}

  * @}

  */

/**

  * @}

  */

/** @defgroup OPAMP_Exported_Functions_Group2 IO operation functions

  * @brief   IO operation functions

  *

/** @defgroup OPAMP_Exported_Functions_Group2 IO operation functions

@verbatim

  * @brief   IO operation functions

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

  *

                        ##### IO operation functions #####

@verbatim  

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

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

    [..]

                        ##### IO operation functions #####

    This subsection provides a set of functions allowing to manage the OPAMP

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

    start, stop and calibration actions.

    [..]

    This subsection provides a set of functions allowing to manage the OPAMP

@endverbatim

    start, stop and calibration actions.

  * @{

  */

@endverbatim

  * @{

/**

  */

  * @brief  Start the OPAMP.

  * @param  hopamp OPAMP handle

/**

  * @retval HAL status

  * @brief  Start the OPAMP.

  */

  * @param  hopamp OPAMP handle

  * @retval HAL status

HAL_StatusTypeDef HAL_OPAMP_Start(OPAMP_HandleTypeDef* hopamp)

  */

{

  HAL_StatusTypeDef status = HAL_OK;

HAL_StatusTypeDef HAL_OPAMP_Start(OPAMP_HandleTypeDef* hopamp)

{

  /* Check the OPAMP handle allocation */

  HAL_StatusTypeDef status = HAL_OK;

  /* Check if OPAMP locked */

  if(hopamp == NULL)

  /* Check the OPAMP handle allocation */

  {

  /* Check if OPAMP locked */

    status = HAL_ERROR;

  if(hopamp == NULL)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

    status = HAL_ERROR;

  {

  }

    status = HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

  }

  {

  else

    status = HAL_ERROR;

  {

  }

    /* Check the parameter */

  else

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

  {

    /* Check the parameter */

    if(hopamp->State == HAL_OPAMP_STATE_READY)

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

    {

      /* Enable the selected opamp */

    if(hopamp->State == HAL_OPAMP_STATE_READY)

      CLEAR_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

    {

      /* Enable the selected opamp */

      /* Update the OPAMP state */

      CLEAR_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

      /* From HAL_OPAMP_STATE_READY to HAL_OPAMP_STATE_BUSY */

      hopamp->State = HAL_OPAMP_STATE_BUSY;

      /* Update the OPAMP state */

    }

      /* From HAL_OPAMP_STATE_READY to HAL_OPAMP_STATE_BUSY */

    else

      hopamp->State = HAL_OPAMP_STATE_BUSY;  

    {

    }

      status = HAL_ERROR;

    else

    }

    {

      status = HAL_ERROR;

   }

    }

  return status;

}

   }

  return status;

/**

}

  * @brief  Stop the OPAMP.

  * @param  hopamp OPAMP handle

/**

  * @retval HAL status

  * @brief  Stop the OPAMP.

  */

  * @param  hopamp OPAMP handle

HAL_StatusTypeDef HAL_OPAMP_Stop(OPAMP_HandleTypeDef* hopamp)

  * @retval HAL status

{

  */

  HAL_StatusTypeDef status = HAL_OK;

HAL_StatusTypeDef HAL_OPAMP_Stop(OPAMP_HandleTypeDef* hopamp)

{

  /* Check the OPAMP handle allocation */

  HAL_StatusTypeDef status = HAL_OK;

  /* Check if OPAMP locked */

  /* Check if OPAMP calibration ongoing */

  /* Check the OPAMP handle allocation */

  if(hopamp == NULL)

  /* Check if OPAMP locked */

  {

  /* Check if OPAMP calibration ongoing */

    status = HAL_ERROR;

  if(hopamp == NULL)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

    status = HAL_ERROR;

  {

  }

    status = HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

    status = HAL_ERROR;

  {

  }

    status = HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)

  }

  {

  else

    status = HAL_ERROR;

  {

  }

    /* Check the parameter */

  else

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

  {

    /* Check the parameter */

    if(hopamp->State == HAL_OPAMP_STATE_BUSY)

    assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

    {

      /* Disable the selected opamp */

    if(hopamp->State == HAL_OPAMP_STATE_BUSY)

      SET_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

    {

      /* Disable the selected opamp */

      /* Update the OPAMP state*/

      SET_BIT (OPAMP->CSR, OPAMP_CSR_OPAXPD(hopamp));

      /* From  HAL_OPAMP_STATE_BUSY to HAL_OPAMP_STATE_READY*/

      hopamp->State = HAL_OPAMP_STATE_READY;

      /* Update the OPAMP state*/    

    }

      /* From  HAL_OPAMP_STATE_BUSY to HAL_OPAMP_STATE_READY*/

    else

      hopamp->State = HAL_OPAMP_STATE_READY;

    {

    }

      status = HAL_ERROR;

    else

    }

    {

  }

      status = HAL_ERROR;

  return status;

    }

}

  }

  return status;

/**

}

  * @brief  Run the self calibration of one OPAMP.

  * @note   Trimming values (PMOS & NMOS) are updated and user trimming is

/**

  *         enabled if calibration is successful.

  * @brief  Run the self calibration of one OPAMP.

  * @note   Calibration is performed in the mode specified in OPAMP init

  * @note   Trimming values (PMOS & NMOS) are updated and user trimming is

  *         structure (mode normal or low-power). To perform calibration for

  *         enabled if calibration is succesful.

  *         both modes, repeat this function twice after OPAMP init structure

  * @note   Calibration is performed in the mode specified in OPAMP init

  *         accordingly updated.

  *         structure (mode normal or low-power). To perform calibration for

  * @note   Calibration runs about 10 ms.

  *         both modes, repeat this function twice after OPAMP init structure

  * @param  hopamp handle

  *         accordingly updated.

  * @retval Updated offset trimming values (PMOS & NMOS), user trimming is enabled

  * @note   Calibration runs about 10 ms.

  * @retval HAL status

  * @param  hopamp handle

  */

  * @retval Updated offset trimming values (PMOS & NMOS), user trimming is enabled

HAL_StatusTypeDef HAL_OPAMP_SelfCalibrate(OPAMP_HandleTypeDef* hopamp)

  * @retval HAL status

{

  */

  HAL_StatusTypeDef status = HAL_OK;

HAL_StatusTypeDef HAL_OPAMP_SelfCalibrate(OPAMP_HandleTypeDef* hopamp)

{

  uint32_t* opamp_trimmingvalue;

  HAL_StatusTypeDef status = HAL_OK;

  uint32_t opamp_trimmingvaluen = 0;

  uint32_t opamp_trimmingvaluep = 0;

  uint32_t* opamp_trimmingvalue;

  uint32_t opamp_trimmingvaluen = 0;

  uint32_t trimming_diff_pair;               /* Selection of differential transistors pair high or low */

  uint32_t opamp_trimmingvaluep = 0;

  __IO uint32_t* tmp_opamp_reg_trimming;     /* Selection of register of trimming depending on power mode: OTR or LPOTR */

  uint32_t trimming_diff_pair;               /* Selection of differential transistors pair high or low */

  uint32_t tmp_opamp_otr_otuser;             /* Selection of bit OPAMP_OTR_OT_USER depending on trimming register pointed: OTR or LPOTR */

  __IO uint32_t* tmp_opamp_reg_trimming;     /* Selection of register of trimming depending on power mode: OTR or LPOTR */

  uint32_t tmp_Opaxcalout_DefaultSate;       /* Bit OPAMP_CSR_OPAXCALOUT default state when trimming value is 00000b. Used to detect the bit toggling */

  uint32_t tmp_opamp_otr_otuser;             /* Selection of bit OPAMP_OTR_OT_USER depending on trimming register pointed: OTR or LPOTR */

  uint32_t tmp_OpaxSwitchesContextBackup;

  uint32_t tmp_Opaxcalout_DefaultSate;       /* Bit OPAMP_CSR_OPAXCALOUT default state when trimming value is 00000b. Used to detect the bit toggling */

  uint8_t trimming_diff_pair_iteration_count;          /* For calibration loop algorithm: to repeat the calibration loop for both differential transistors pair high and low */

  uint32_t tmp_OpaxSwitchesContextBackup;

  uint8_t delta;                                       /* For calibration loop algorithm: Variable for dichotomy steps value */

  uint8_t final_step_check = 0x0U;                        /* For calibration loop algorithm: Flag for additional check of last trimming step */

  uint8_t trimming_diff_pair_iteration_count;          /* For calibration loop algorithm: to repeat the calibration loop for both differential transistors pair high and low */

  uint8_t delta;                                       /* For calibration loop algorithm: Variable for dichotomy steps value */

  /* Check the OPAMP handle allocation */

  uint8_t final_step_check = 0x0U;                        /* For calibration loop algorithm: Flag for additional check of last trimming step */

  /* Check if OPAMP locked */

  if(hopamp == NULL)

  /* Check the OPAMP handle allocation */

  {

  /* Check if OPAMP locked */

    status = HAL_ERROR;

  if(hopamp == NULL)

  }

  {

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

    status = HAL_ERROR;

  {

  }

    status = HAL_ERROR;

  else if(hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)

  }

  {

  else

    status = HAL_ERROR;

  {

  }

  else

    /* Check if OPAMP in calibration mode and calibration not yet enable */

  {

    if(hopamp->State == HAL_OPAMP_STATE_READY)

    {

    /* Check if OPAMP in calibration mode and calibration not yet enable */

      /* Check the parameter */

    if(hopamp->State == HAL_OPAMP_STATE_READY)

      assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

    {

      assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));

      /* Check the parameter */

      assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));

      /* Update OPAMP state */

      assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));

      hopamp->State = HAL_OPAMP_STATE_CALIBBUSY;

      /* Update OPAMP state */

      /* Backup of switches configuration to restore it at the end of the     */

      hopamp->State = HAL_OPAMP_STATE_CALIBBUSY;

      /* calibration.                                                         */

      tmp_OpaxSwitchesContextBackup = READ_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

      /* Backup of switches configuration to restore it at the end of the     */

      /* calibration.                                                         */

      /* Open all switches on non-inverting input, inverting input and output */

      tmp_OpaxSwitchesContextBackup = READ_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

      /* feedback.                                                            */

      CLEAR_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

      /* Open all switches on non-inverting input, inverting input and output */

      /* feedback.                                                            */

      /* Set calibration mode to user programmed trimming values */

      CLEAR_BIT(OPAMP->CSR, OPAMP_CSR_ALL_SWITCHES(hopamp));

      SET_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

      /* Set calibration mode to user programmed trimming values */

      SET_BIT(OPAMP->OTR, OPAMP_OTR_OT_USER);

      /* Select trimming settings depending on power mode */

      if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)

      {

      /* Select trimming settings depending on power mode */

        tmp_opamp_otr_otuser = OPAMP_OTR_OT_USER;

      if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)

        tmp_opamp_reg_trimming = &OPAMP->OTR;

      {

      }

        tmp_opamp_otr_otuser = OPAMP_OTR_OT_USER;

      else

        tmp_opamp_reg_trimming = &OPAMP->OTR;

      {

      }