mirror of https://github.com/rene-dev/stmbl.git
923 lines
33 KiB
C
923 lines
33 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32f3xx_hal_opamp.c
|
|
* @author MCD Application Team
|
|
* @brief OPAMP HAL module driver.
|
|
* This file provides firmware functions to manage the following
|
|
* functionalities of the operational amplifiers (OPAMP1,...OPAMP4)
|
|
* peripheral:
|
|
* + OPAMP Configuration
|
|
* + OPAMP calibration
|
|
* Thanks to
|
|
* + Initialization/de-initialization functions
|
|
* + I/O operation functions
|
|
* + Peripheral Control functions
|
|
* + Peripheral State functions
|
|
*
|
|
@verbatim
|
|
================================================================================
|
|
##### OPAMP Peripheral Features #####
|
|
================================================================================
|
|
|
|
[..] The device integrates up to 4 operational amplifiers OPAMP1, OPAMP2,
|
|
OPAMP3 and OPAMP4:
|
|
|
|
(#) The OPAMP(s) provides several exclusive running modes.
|
|
(++) Standalone mode
|
|
(++) Programmable Gain Amplifier (PGA) mode (Resistor feedback output)
|
|
(++) Follower mode
|
|
|
|
(#) The OPAMP(s) provide(s) calibration capabilities.
|
|
(++) Calibration aims at correcting some offset for running mode.
|
|
(++) The OPAMP uses either factory calibration settings OR user defined
|
|
calibration (trimming) settings (i.e. trimming mode).
|
|
(++) The user defined settings can be figured out using self calibration
|
|
handled by HAL_OPAMP_SelfCalibrate, HAL_OPAMPEx_SelfCalibrateAll
|
|
(++) HAL_OPAMP_SelfCalibrate:
|
|
(++) Runs automatically the calibration in 2 steps.
|
|
(90U% of VDDA for NMOS transistors, 10U% of VDDA for PMOS transistors).
|
|
(As OPAMP is Rail-to-rail input/output, these 2 steps calibration is
|
|
appropriate and enough in most cases).
|
|
(++) Enables the user trimming mode
|
|
(++) Updates the init structure with trimming values with fresh calibration
|
|
results.
|
|
The user may store the calibration results for larger
|
|
(ex monitoring the trimming as a function of temperature
|
|
for instance)
|
|
(++) for STM32F3 devices having 2 or 4 OPAMPs
|
|
HAL_OPAMPEx_SelfCalibrateAll
|
|
runs calibration of 2 or 4 OPAMPs in parallel.
|
|
|
|
(#) For any running mode, an additional Timer-controlled Mux (multiplexer)
|
|
mode can be set on top.
|
|
(++) Timer-controlled Mux mode allows Automatic switching between inverting
|
|
and non-inverting input.
|
|
(++) Hence on top of defaults (primary) inverting and non-inverting inputs,
|
|
the user shall select secondary inverting and non inverting inputs.
|
|
(++) TIM1 CC6 provides the alternate switching tempo between defaults
|
|
(primary) and secondary inputs.
|
|
|
|
(#) Running mode: Standalone mode
|
|
(++) Gain is set externally (gain depends on external loads).
|
|
(++) Follower mode also possible externally by connecting the inverting input to
|
|
the output.
|
|
|
|
(#) Running mode: Follower mode
|
|
(++) No Inverting Input is connected.
|
|
|
|
(#) Running mode: Programmable Gain Amplifier (PGA) mode
|
|
(Resistor feedback output)
|
|
(++) The OPAMP(s) output(s) can be internally connected to resistor feedback
|
|
output.
|
|
(++) OPAMP gain is either 2U, 4U, 8 or 16.
|
|
|
|
|
|
##### How to use this driver #####
|
|
================================================================================
|
|
[..]
|
|
*** Calibration ***
|
|
============================================
|
|
[..]
|
|
To run the opamp calibration self calibration:
|
|
|
|
(#) Start calibration using HAL_OPAMP_SelfCalibrate.
|
|
Store the calibration results.
|
|
|
|
*** Running mode ***
|
|
============================================
|
|
[..]
|
|
To use the opamp, perform the following steps:
|
|
|
|
(#) Fill in the HAL_OPAMP_MspInit() to
|
|
(++) Configure the opamp input AND output in analog mode using
|
|
HAL_GPIO_Init() to map the opamp output to the GPIO pin.
|
|
|
|
(#) Configure the opamp using HAL_OPAMP_Init() function:
|
|
(++) Select the mode
|
|
(++) Select the inverting input
|
|
(++) Select the non-inverting input
|
|
(++) Select if the Timer controlled Mux mode is enabled/disabled
|
|
(++) If the Timer controlled Mux mode is enabled, select the secondary inverting input
|
|
(++) If the Timer controlled Mux mode is enabled, Select the secondary non-inverting input
|
|
(++) If PGA mode is enabled, Select if inverting input is connected.
|
|
(++) Select either factory or user defined trimming mode.
|
|
(++) If the user defined trimming mode is enabled, select PMOS & NMOS trimming values
|
|
(typ. settings returned by HAL_OPAMP_SelfCalibrate function).
|
|
|
|
(#) Enable the opamp using HAL_OPAMP_Start() function.
|
|
|
|
(#) Disable the opamp using HAL_OPAMP_Stop() function.
|
|
|
|
(#) Lock the opamp in running mode using HAL_OPAMP_Lock() function. From then The configuration
|
|
can be modified
|
|
(++) After HW reset
|
|
(++) OR thanks to HAL_OPAMP_MspDeInit called (user defined) from HAL_OPAMP_DeInit.
|
|
|
|
*** Running mode: change of configuration while OPAMP ON ***
|
|
============================================
|
|
[..]
|
|
To Re-configure OPAMP when OPAMP is ON (change on the fly)
|
|
(#) If needed, Fill in the HAL_OPAMP_MspInit()
|
|
(++) This is the case for instance if you wish to use new OPAMP I/O
|
|
|
|
(#) Configure the opamp using HAL_OPAMP_Init() function:
|
|
(++) As in configure case, selects first the parameters you wish to modify.
|
|
|
|
@endverbatim
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted provided that the following conditions are met:
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of STMicroelectronics nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/*
|
|
Additional Tables:
|
|
The OPAMPs non inverting input (both default and secondary) can be
|
|
selected among the list shown by table below.
|
|
|
|
The OPAMPs non inverting input (both default and secondary) can be
|
|
selected among the list shown by table below.
|
|
|
|
Table 1. OPAMPs inverting/non-inverting inputs for the STM32F3 devices:
|
|
+--------------------------------------------------------------+
|
|
| | | OPAMP1 | OPAMP2 | OPAMP3 | OPAMP4 |
|
|
|-----------------|--------|--------|--------|--------|--------|
|
|
| | No conn| X | X | X | X |
|
|
| Inverting Input | VM0 | PC5 | PC5 | PB10 | PB10 |
|
|
| (1) | VM1 | PA3 | PA5 | PB2 | PD8 |
|
|
|-----------------|--------|--------|--------|--------|--------|
|
|
| | VP0 | PA1 | PA7 | PB0 | PB13 |
|
|
| Non Inverting | VP1 | PA7 | PD14 | PB13 | PD11 |
|
|
| Input | VP2 | PA3 | PB0 | PA1 | PA4 |
|
|
| | VP3 | PA5 | PB14 | PA5 | PB11 |
|
|
+--------------------------------------------------------------+
|
|
(1): NA in follower mode.
|
|
|
|
Table 2. OPAMPs outputs for the STM32F3 devices:
|
|
+--------------------------------------------------------------+
|
|
| | | OPAMP1 | OPAMP2 | OPAMP3 | OPAMP4 |
|
|
|-----------------|--------|--------|--------|--------|--------|
|
|
| Output | | PA2 | PA6 | PB1 | PB12 |
|
|
|-----------------|--------|--------|--------|--------|--------|
|
|
|
|
*/
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32f3xx_hal.h"
|
|
|
|
/** @addtogroup STM32F3xx_HAL_Driver
|
|
* @{
|
|
*/
|
|
|
|
#ifdef HAL_OPAMP_MODULE_ENABLED
|
|
|
|
#if defined(STM32F302xE) || defined(STM32F303xE) || defined(STM32F398xx) || \
|
|
defined(STM32F302xC) || defined(STM32F303xC) || defined(STM32F358xx) || \
|
|
defined(STM32F303x8) || defined(STM32F334x8) || defined(STM32F328xx) || \
|
|
defined(STM32F301x8) || defined(STM32F302x8) || defined(STM32F318xx)
|
|
|
|
/** @defgroup OPAMP OPAMP
|
|
* @brief OPAMP HAL module driver
|
|
* @{
|
|
*/
|
|
|
|
/* Private typedef -----------------------------------------------------------*/
|
|
/* Private define ------------------------------------------------------------*/
|
|
/** @defgroup OPAMP_Private_Define OPAMP Private Define
|
|
* @{
|
|
*/
|
|
/* CSR register reset value */
|
|
#define OPAMP_CSR_RESET_VALUE (0x00000000U)
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Private macro -------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
/* Exported functions ---------------------------------------------------------*/
|
|
|
|
/** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions
|
|
* @{
|
|
*/
|
|
|
|
/** @defgroup OPAMP_Exported_Functions_Group1 Initialization and de-initialization functions
|
|
* @brief Initialization and Configuration functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### Initialization and de-initialization functions #####
|
|
===============================================================================
|
|
[..] 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.
|
|
* To unlock the configuration, perform a system reset.
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL status
|
|
*/
|
|
HAL_StatusTypeDef HAL_OPAMP_Init(OPAMP_HandleTypeDef *hopamp)
|
|
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
/* Check the OPAMP handle allocation and lock status */
|
|
/* Init not allowed if calibration is ongoing */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
/* Set OPAMP parameters */
|
|
assert_param(IS_OPAMP_FUNCTIONAL_NORMALMODE(hopamp->Init.Mode));
|
|
assert_param(IS_OPAMP_NONINVERTING_INPUT(hopamp->Init.NonInvertingInput));
|
|
if ((hopamp->Init.Mode) == OPAMP_STANDALONE_MODE)
|
|
{
|
|
assert_param(IS_OPAMP_INVERTING_INPUT(hopamp->Init.InvertingInput));
|
|
}
|
|
|
|
assert_param(IS_OPAMP_TIMERCONTROLLED_MUXMODE(hopamp->Init.TimerControlledMuxmode));
|
|
|
|
if ((hopamp->Init.TimerControlledMuxmode) == OPAMP_TIMERCONTROLLEDMUXMODE_ENABLE)
|
|
{
|
|
assert_param(IS_OPAMP_SEC_NONINVERTINGINPUT(hopamp->Init.NonInvertingInputSecondary));
|
|
if ((hopamp->Init.Mode) == OPAMP_STANDALONE_MODE)
|
|
{
|
|
assert_param(IS_OPAMP_SEC_INVERTINGINPUT(hopamp->Init.InvertingInputSecondary));
|
|
}
|
|
}
|
|
|
|
if ((hopamp->Init.Mode) == OPAMP_PGA_MODE)
|
|
{
|
|
assert_param(IS_OPAMP_PGACONNECT(hopamp->Init.PgaConnect));
|
|
assert_param(IS_OPAMP_PGA_GAIN(hopamp->Init.PgaGain));
|
|
}
|
|
|
|
assert_param(IS_OPAMP_TRIMMING(hopamp->Init.UserTrimming));
|
|
if ((hopamp->Init.UserTrimming) == OPAMP_TRIMMING_USER)
|
|
{
|
|
assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueP));
|
|
assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueN));
|
|
}
|
|
|
|
/* Init SYSCFG and the low level hardware to access opamp */
|
|
__HAL_RCC_SYSCFG_CLK_ENABLE();
|
|
|
|
if(hopamp->State == HAL_OPAMP_STATE_RESET)
|
|
{
|
|
/* Allocate lock resource and initialize it */
|
|
hopamp->Lock = HAL_UNLOCKED;
|
|
}
|
|
|
|
/* Call MSP init function */
|
|
HAL_OPAMP_MspInit(hopamp);
|
|
|
|
/* Set OPAMP parameters */
|
|
/* Set bits according to hopamp->hopamp->Init.Mode value */
|
|
/* Set bits according to hopamp->hopamp->Init.InvertingInput value */
|
|
/* Set bits according to hopamp->hopamp->Init.NonInvertingInput value */
|
|
/* Set bits according to hopamp->hopamp->Init.TimerControlledMuxmode value */
|
|
/* Set bits according to hopamp->hopamp->Init.InvertingInputSecondary value */
|
|
/* Set bits according to hopamp->hopamp->Init.NonInvertingInputSecondary value */
|
|
/* Set bits according to hopamp->hopamp->Init.PgaConnect value */
|
|
/* Set bits according to hopamp->hopamp->Init.PgaGain value */
|
|
/* Set bits according to hopamp->hopamp->Init.UserTrimming value */
|
|
/* Set bits according to hopamp->hopamp->Init.TrimmingValueP value */
|
|
/* Set bits according to hopamp->hopamp->Init.TrimmingValueN value */
|
|
|
|
|
|
/* check if OPAMP_PGA_MODE & in Follower mode */
|
|
/* - InvertingInput */
|
|
/* - InvertingInputSecondary */
|
|
/* are Not Applicable */
|
|
|
|
if ((hopamp->Init.Mode == OPAMP_PGA_MODE) || (hopamp->Init.Mode == OPAMP_FOLLOWER_MODE))
|
|
{
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_UPDATE_PARAMETERS_INIT_MASK, \
|
|
hopamp->Init.Mode | \
|
|
hopamp->Init.NonInvertingInput | \
|
|
hopamp->Init.TimerControlledMuxmode | \
|
|
hopamp->Init.NonInvertingInputSecondary | \
|
|
hopamp->Init.PgaConnect | \
|
|
hopamp->Init.PgaGain | \
|
|
hopamp->Init.UserTrimming | \
|
|
(hopamp->Init.TrimmingValueP << OPAMP_INPUT_NONINVERTING) | \
|
|
(hopamp->Init.TrimmingValueN << OPAMP_INPUT_INVERTING));
|
|
|
|
}
|
|
else /* OPAMP_STANDALONE_MODE */
|
|
{
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_UPDATE_PARAMETERS_INIT_MASK, \
|
|
hopamp->Init.Mode | \
|
|
hopamp->Init.InvertingInput | \
|
|
hopamp->Init.NonInvertingInput | \
|
|
hopamp->Init.TimerControlledMuxmode | \
|
|
hopamp->Init.InvertingInputSecondary | \
|
|
hopamp->Init.NonInvertingInputSecondary | \
|
|
hopamp->Init.PgaConnect | \
|
|
hopamp->Init.PgaGain | \
|
|
hopamp->Init.UserTrimming | \
|
|
(hopamp->Init.TrimmingValueP << OPAMP_INPUT_NONINVERTING) | \
|
|
(hopamp->Init.TrimmingValueN << OPAMP_INPUT_INVERTING));
|
|
}
|
|
|
|
/* Update the OPAMP state*/
|
|
if (hopamp->State == HAL_OPAMP_STATE_RESET)
|
|
{
|
|
/* From RESET state to READY State */
|
|
hopamp->State = HAL_OPAMP_STATE_READY;
|
|
}
|
|
/* else: remain in READY or BUSY state (no update) */
|
|
|
|
return status;
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* @brief DeInitializes the OPAMP peripheral
|
|
* @note Deinitialization can't be performed if the OPAMP configuration is locked.
|
|
* To unlock the configuration, perform a system reset.
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL status
|
|
*/
|
|
HAL_StatusTypeDef HAL_OPAMP_DeInit(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* DeInit not allowed if calibration is ongoing */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
/* Set OPAMP_CSR register to reset value */
|
|
WRITE_REG(hopamp->Instance->CSR, OPAMP_CSR_RESET_VALUE);
|
|
|
|
/* DeInit the low level hardware: GPIO, CLOCK and NVIC */
|
|
/* When OPAMP is locked, unlocking can be achieved thanks to */
|
|
/* __HAL_RCC_SYSCFG_CLK_DISABLE() call within HAL_OPAMP_MspDeInit */
|
|
/* Note that __HAL_RCC_SYSCFG_CLK_DISABLE() also disables comparator */
|
|
HAL_OPAMP_MspDeInit(hopamp);
|
|
|
|
if (OPAMP_CSR_RESET_VALUE == hopamp->Instance->CSR)
|
|
{
|
|
/* Update the OPAMP state */
|
|
hopamp->State = HAL_OPAMP_STATE_RESET;
|
|
}
|
|
else /* RESET STATE */
|
|
{
|
|
/* DeInit not complete */
|
|
/* It can be the case if OPAMP was formerly locked */
|
|
status = HAL_ERROR;
|
|
|
|
/* The OPAMP state is NOT updated */
|
|
}
|
|
|
|
/* Process unlocked */
|
|
__HAL_UNLOCK(hopamp);
|
|
}
|
|
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @brief Initializes the OPAMP MSP.
|
|
* @param hopamp OPAMP handle
|
|
* @retval None
|
|
*/
|
|
__weak void HAL_OPAMP_MspInit(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
/* Prevent unused argument(s) compilation warning */
|
|
UNUSED(hopamp);
|
|
|
|
/* NOTE : This function should not be modified, when the callback is needed,
|
|
the HAL_OPAMP_MspInit could be implemented in the user file
|
|
*/
|
|
|
|
/* Example */
|
|
}
|
|
|
|
/**
|
|
* @brief DeInitializes OPAMP MSP.
|
|
* @param hopamp OPAMP handle
|
|
* @retval None
|
|
*/
|
|
__weak void HAL_OPAMP_MspDeInit(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
/* Prevent unused argument(s) compilation warning */
|
|
UNUSED(hopamp);
|
|
|
|
/* NOTE : This function should not be modified, when the callback is needed,
|
|
the HAL_OPAMP_MspDeInit could be implemented in the user file
|
|
*/
|
|
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/** @defgroup OPAMP_Exported_Functions_Group2 Input and Output operation functions
|
|
* @brief Data transfers functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### IO operation functions #####
|
|
===============================================================================
|
|
[..]
|
|
This subsection provides a set of functions allowing to manage the OPAMP data
|
|
transfers.
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Start the opamp
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL status
|
|
*/
|
|
|
|
HAL_StatusTypeDef HAL_OPAMP_Start(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* Check if OPAMP locked */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
|
|
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
if(hopamp->State == HAL_OPAMP_STATE_READY)
|
|
{
|
|
/* Enable the selected opamp */
|
|
SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
|
|
|
|
/* Update the OPAMP state*/
|
|
/* From HAL_OPAMP_STATE_READY to HAL_OPAMP_STATE_BUSY */
|
|
hopamp->State = HAL_OPAMP_STATE_BUSY;
|
|
}
|
|
else
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
|
|
|
|
}
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @brief Stop the opamp
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL status
|
|
*/
|
|
HAL_StatusTypeDef HAL_OPAMP_Stop(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* Check if OPAMP locked */
|
|
/* Check if OPAMP calibration ongoing */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
if(hopamp->State == HAL_OPAMP_STATE_BUSY)
|
|
{
|
|
/* Disable the selected opamp */
|
|
CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
|
|
|
|
/* Update the OPAMP state*/
|
|
/* From HAL_OPAMP_STATE_BUSY to HAL_OPAMP_STATE_READY*/
|
|
hopamp->State = HAL_OPAMP_STATE_READY;
|
|
}
|
|
else
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
}
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @brief Run the self calibration of one OPAMP
|
|
* @param hopamp handle
|
|
* @retval Updated offset trimming values (PMOS & NMOS), user trimming is enabled
|
|
* @retval HAL status
|
|
* @note Calibration runs about 25 ms.
|
|
*/
|
|
|
|
HAL_StatusTypeDef HAL_OPAMP_SelfCalibrate(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
uint32_t trimmingvaluen = 0U;
|
|
uint32_t trimmingvaluep = 0U;
|
|
uint32_t delta;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* Check if OPAMP locked */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
|
|
/* Check if OPAMP in calibration mode and calibration not yet enable */
|
|
if(hopamp->State == HAL_OPAMP_STATE_READY)
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
/* Set Calibration mode */
|
|
/* Non-inverting input connected to calibration reference voltage. */
|
|
SET_BIT(hopamp->Instance->CSR, OPAMP_CSR_FORCEVP);
|
|
|
|
/* user trimming values are used for offset calibration */
|
|
SET_BIT(hopamp->Instance->CSR, OPAMP_CSR_USERTRIM);
|
|
|
|
/* Enable calibration */
|
|
SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALON);
|
|
|
|
/* 1st calibration - N */
|
|
/* Select 90U% VREF */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_CALSEL, OPAMP_VREF_90VDDA);
|
|
|
|
/* Enable the selected opamp */
|
|
SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
|
|
|
|
/* Init trimming counter */
|
|
/* Medium value */
|
|
trimmingvaluen = 16U;
|
|
delta = 8U;
|
|
|
|
while (delta != 0U)
|
|
{
|
|
/* Set candidate trimming */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETN, trimmingvaluen<<OPAMP_INPUT_INVERTING);
|
|
|
|
/* OFFTRIMmax delay 2 ms as per datasheet (electrical characteristics */
|
|
/* Offset trim time: during calibration, minimum time needed between */
|
|
/* two steps to have 1 mV accuracy */
|
|
HAL_Delay(2U);
|
|
|
|
if ((hopamp->Instance->CSR & OPAMP_CSR_OUTCAL) != RESET)
|
|
{
|
|
/* OPAMP_CSR_OUTCAL is HIGH try higher trimming */
|
|
trimmingvaluen += delta;
|
|
}
|
|
else
|
|
{
|
|
/* OPAMP_CSR_OUTCAL is LOW try lower trimming */
|
|
trimmingvaluen -= delta;
|
|
}
|
|
|
|
delta >>= 1U;
|
|
}
|
|
|
|
/* Still need to check if righ calibration is current value or un step below */
|
|
/* Indeed the first value that causes the OUTCAL bit to change from 1 to 0 */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETN, trimmingvaluen<<OPAMP_INPUT_INVERTING);
|
|
|
|
/* OFFTRIMmax delay 2 ms as per datasheet (electrical characteristics */
|
|
/* Offset trim time: during calibration, minimum time needed between */
|
|
/* two steps to have 1 mV accuracy */
|
|
HAL_Delay(2U);
|
|
|
|
if ((hopamp->Instance->CSR & OPAMP_CSR_OUTCAL) != RESET)
|
|
{
|
|
/* OPAMP_CSR_OUTCAL is actually one value more */
|
|
trimmingvaluen++;
|
|
/* Set right trimming */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETN, trimmingvaluen<<OPAMP_INPUT_INVERTING);
|
|
}
|
|
|
|
/* 2nd calibration - P */
|
|
/* Select 10U% VREF */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_CALSEL, OPAMP_VREF_10VDDA);
|
|
|
|
/* Init trimming counter */
|
|
/* Medium value */
|
|
trimmingvaluep = 16U;
|
|
delta = 8U;
|
|
|
|
while (delta != 0U)
|
|
{
|
|
/* Set candidate trimming */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETP, trimmingvaluep<<OPAMP_INPUT_NONINVERTING);
|
|
|
|
/* OFFTRIMmax delay 2 ms as per datasheet (electrical characteristics */
|
|
/* Offset trim time: during calibration, minimum time needed between */
|
|
/* two steps to have 1 mV accuracy */
|
|
HAL_Delay(2U);
|
|
|
|
if ((hopamp->Instance->CSR & OPAMP_CSR_OUTCAL) != RESET)
|
|
{
|
|
/* OPAMP_CSR_OUTCAL is HIGH try higher trimming */
|
|
trimmingvaluep += delta;
|
|
}
|
|
else
|
|
{
|
|
trimmingvaluep -= delta;
|
|
}
|
|
|
|
delta >>= 1U;
|
|
}
|
|
|
|
/* Still need to check if righ calibration is current value or un step below */
|
|
/* Indeed the first value that causes the OUTCAL bit to change from 1 to 0U */
|
|
/* Set candidate trimming */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETP, trimmingvaluep<<OPAMP_INPUT_NONINVERTING);
|
|
|
|
/* OFFTRIMmax delay 2 ms as per datasheet (electrical characteristics */
|
|
/* Offset trim time: during calibration, minimum time needed between */
|
|
/* two steps to have 1 mV accuracy */
|
|
HAL_Delay(2U);
|
|
|
|
if ((hopamp->Instance->CSR & OPAMP_CSR_OUTCAL) != RESET)
|
|
{
|
|
/* OPAMP_CSR_OUTCAL is actually one value more */
|
|
trimmingvaluep++;
|
|
/* Set right trimming */
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETP, trimmingvaluep<<OPAMP_INPUT_NONINVERTING);
|
|
}
|
|
|
|
/* Disable calibration */
|
|
CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALON);
|
|
|
|
/* Disable the OPAMP */
|
|
CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
|
|
|
|
/* Set operating mode */
|
|
/* Non-inverting input connected to calibration reference voltage. */
|
|
CLEAR_BIT(hopamp->Instance->CSR, OPAMP_CSR_FORCEVP);
|
|
|
|
/* Self calibration is successful */
|
|
/* Store calibration(user timming) results in init structure. */
|
|
|
|
/* Write calibration result N */
|
|
hopamp->Init.TrimmingValueN = trimmingvaluen;
|
|
|
|
/* Write calibration result P */
|
|
hopamp->Init.TrimmingValueP = trimmingvaluep;
|
|
|
|
/* Select user timming mode */
|
|
/* And updated with calibrated settings */
|
|
hopamp->Init.UserTrimming = OPAMP_TRIMMING_USER;
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETP, trimmingvaluep<<OPAMP_INPUT_NONINVERTING);
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETN, trimmingvaluen<<OPAMP_INPUT_INVERTING);
|
|
}
|
|
|
|
else
|
|
{
|
|
/* OPAMP can not be calibrated from this mode */
|
|
status = HAL_ERROR;
|
|
}
|
|
}
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup OPAMP_Exported_Functions_Group3 Peripheral Control functions
|
|
* @brief management functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### Peripheral Control functions #####
|
|
===============================================================================
|
|
[..]
|
|
This subsection provides a set of functions allowing to control the OPAMP data
|
|
transfers.
|
|
|
|
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Lock the selected opamp configuration.
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL status
|
|
*/
|
|
HAL_StatusTypeDef HAL_OPAMP_Lock(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* Check if OPAMP locked */
|
|
/* OPAMP can be locked when enabled and running in normal mode */
|
|
/* It is meaningless otherwise */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_RESET) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_READY) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)\
|
|
|| (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
|
|
|
|
{
|
|
status = HAL_ERROR;
|
|
}
|
|
|
|
else
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
/* Lock OPAMP */
|
|
SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_LOCK);
|
|
|
|
/* OPAMP state changed to locked */
|
|
hopamp->State = HAL_OPAMP_STATE_BUSYLOCKED;
|
|
}
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup OPAMP_Exported_Functions_Group4 Peripheral State functions
|
|
* @brief Peripheral State functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### Peripheral State functions #####
|
|
===============================================================================
|
|
[..]
|
|
This subsection permit to get in run-time the status of the peripheral
|
|
and the data flow.
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Return the OPAMP state
|
|
* @param hopamp OPAMP handle
|
|
* @retval HAL state
|
|
*/
|
|
HAL_OPAMP_StateTypeDef HAL_OPAMP_GetState(OPAMP_HandleTypeDef *hopamp)
|
|
{
|
|
/* Check the OPAMP handle allocation */
|
|
if(hopamp == NULL)
|
|
{
|
|
return HAL_OPAMP_STATE_RESET;
|
|
}
|
|
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
|
|
return hopamp->State;
|
|
}
|
|
|
|
/**
|
|
* @brief Return the OPAMP factory trimming value
|
|
* @param hopamp OPAMP handle
|
|
* @param trimmingoffset Trimming offset (P or N)
|
|
* @retval Trimming value (P or N): range: 0->31
|
|
* or OPAMP_FACTORYTRIMMING_DUMMY if trimming value is not available
|
|
*/
|
|
|
|
OPAMP_TrimmingValueTypeDef HAL_OPAMP_GetTrimOffset (OPAMP_HandleTypeDef *hopamp, uint32_t trimmingoffset)
|
|
{
|
|
uint32_t oldusertrimming = 0U;
|
|
OPAMP_TrimmingValueTypeDef oldtrimmingvaluep = 0U, oldtrimmingvaluen = 0U, trimmingvalue = 0U;
|
|
|
|
/* Check the OPAMP handle allocation */
|
|
/* Value can be retrieved in HAL_OPAMP_STATE_READY state */
|
|
if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_RESET) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_BUSY) \
|
|
|| (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)\
|
|
|| (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
|
|
{
|
|
return OPAMP_FACTORYTRIMMING_DUMMY;
|
|
}
|
|
else
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
|
|
assert_param(IS_OPAMP_FACTORYTRIMMING(trimmingoffset));
|
|
|
|
/* Check the trimming mode */
|
|
if ((READ_BIT(hopamp->Instance->CSR,OPAMP_CSR_USERTRIM)) != RESET)
|
|
{
|
|
/* User trimming is used */
|
|
oldusertrimming = OPAMP_TRIMMING_USER;
|
|
/* Store the TrimmingValueP & TrimmingValueN */
|
|
oldtrimmingvaluep = (hopamp->Instance->CSR & OPAMP_CSR_TRIMOFFSETP) >> OPAMP_INPUT_NONINVERTING;
|
|
oldtrimmingvaluen = (hopamp->Instance->CSR & OPAMP_CSR_TRIMOFFSETN) >> OPAMP_INPUT_INVERTING;
|
|
}
|
|
|
|
/* Set factory timming mode */
|
|
CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_USERTRIM);
|
|
|
|
/* Get factory trimming */
|
|
if (trimmingoffset == OPAMP_FACTORYTRIMMING_P)
|
|
{
|
|
/* Return TrimOffsetP */
|
|
trimmingvalue = ((hopamp->Instance->CSR & OPAMP_CSR_TRIMOFFSETP) >> OPAMP_INPUT_NONINVERTING);
|
|
}
|
|
else
|
|
{
|
|
/* Return TrimOffsetN */
|
|
trimmingvalue = ((hopamp->Instance->CSR & OPAMP_CSR_TRIMOFFSETN) >> OPAMP_INPUT_INVERTING);
|
|
}
|
|
|
|
/* Restore user trimming configuration if it was formerly set */
|
|
/* Check if user trimming was used */
|
|
if (oldusertrimming == OPAMP_TRIMMING_USER)
|
|
{
|
|
/* Restore user trimming */
|
|
SET_BIT(hopamp->Instance->CSR,OPAMP_CSR_USERTRIM);
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETP, oldtrimmingvaluep<<OPAMP_INPUT_NONINVERTING);
|
|
MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_TRIMOFFSETN, oldtrimmingvaluen<<OPAMP_INPUT_INVERTING);
|
|
}
|
|
}
|
|
return trimmingvalue;
|
|
}
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* STM32F302xE || STM32F303xE || STM32F398xx || */
|
|
/* STM32F302xC || STM32F303xC || STM32F358xx || */
|
|
/* STM32F303x8 || STM32F334x8 || STM32F328xx || */
|
|
/* STM32F301x8 || STM32F302x8 || STM32F318xx */
|
|
|
|
#endif /* HAL_OPAMP_MODULE_ENABLED */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|