en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_opamp.c@129:2e517c56bcfb, 2016-05-16 (annotated)

Committer:
nameless129
Date:
Mon May 16 16:50:30 2016 +0000
Revision:
129:2e517c56bcfb
Parent:
0:9b334a45a8ff 
PWM Fix:Duty 0%??H???????????????

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32l4xx_hal_opamp.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.0.0
bogdanm 0:9b334a45a8ff 6 * @date 26-June-2015
bogdanm 0:9b334a45a8ff 7 * @brief OPAMP HAL module driver.
bogdanm 0:9b334a45a8ff 8 * This file provides firmware functions to manage the following
bogdanm 0:9b334a45a8ff 9 * functionalities of the operational amplifier(s) peripheral:
bogdanm 0:9b334a45a8ff 10 * + OPAMP configuration
bogdanm 0:9b334a45a8ff 11 * + OPAMP calibration
bogdanm 0:9b334a45a8ff 12 * Thanks to
bogdanm 0:9b334a45a8ff 13 * + Initialization and de-initialization functions
bogdanm 0:9b334a45a8ff 14 * + IO operation functions
bogdanm 0:9b334a45a8ff 15 * + Peripheral Control functions
bogdanm 0:9b334a45a8ff 16 * + Peripheral State functions
bogdanm 0:9b334a45a8ff 17 *
bogdanm 0:9b334a45a8ff 18 @verbatim
bogdanm 0:9b334a45a8ff 19 ================================================================================
bogdanm 0:9b334a45a8ff 20 ##### OPAMP Peripheral Features #####
bogdanm 0:9b334a45a8ff 21 ================================================================================
bogdanm 0:9b334a45a8ff 22
bogdanm 0:9b334a45a8ff 23 [..] The device integrates 2 operational amplifiers OPAMP1 & OPAMP2
bogdanm 0:9b334a45a8ff 24
bogdanm 0:9b334a45a8ff 25 (#) The OPAMP(s) provide(s) several exclusive running modes.
bogdanm 0:9b334a45a8ff 26 (++) Standalone mode
bogdanm 0:9b334a45a8ff 27 (++) Programmable Gain Amplifier (PGA) mode (Resistor feedback output)
bogdanm 0:9b334a45a8ff 28 (++) Follower mode
bogdanm 0:9b334a45a8ff 29
bogdanm 0:9b334a45a8ff 30 (#) All OPAMP (same for all OPAMPs) can operate in
bogdanm 0:9b334a45a8ff 31 (++) Either Low range (VDDA < 2.4V) power supply
bogdanm 0:9b334a45a8ff 32 (++) Or High range (VDDA > 2.4V) power supply
bogdanm 0:9b334a45a8ff 33
bogdanm 0:9b334a45a8ff 34 (#) Each OPAMP(s) can be configured in normal and low power mode.
bogdanm 0:9b334a45a8ff 35
bogdanm 0:9b334a45a8ff 36 (#) The OPAMP(s) provide(s) calibration capabilities.
bogdanm 0:9b334a45a8ff 37 (++) Calibration aims at correcting some offset for running mode.
bogdanm 0:9b334a45a8ff 38 (++) The OPAMP uses either factory calibration settings OR user defined
bogdanm 0:9b334a45a8ff 39 calibration (trimming) settings (i.e. trimming mode).
bogdanm 0:9b334a45a8ff 40 (++) The user defined settings can be figured out using self calibration
bogdanm 0:9b334a45a8ff 41 handled by HAL_OPAMP_SelfCalibrate, HAL_OPAMPEx_SelfCalibrateAll
bogdanm 0:9b334a45a8ff 42 (++) HAL_OPAMP_SelfCalibrate:
bogdanm 0:9b334a45a8ff 43 (+++) Runs automatically the calibration.
bogdanm 0:9b334a45a8ff 44 (+++) Enables the user trimming mode
bogdanm 0:9b334a45a8ff 45 (+++) Updates the init structure with trimming values with fresh calibration
bogdanm 0:9b334a45a8ff 46 results.
bogdanm 0:9b334a45a8ff 47 The user may store the calibration results for larger
bogdanm 0:9b334a45a8ff 48 (ex monitoring the trimming as a function of temperature
bogdanm 0:9b334a45a8ff 49 for instance)
bogdanm 0:9b334a45a8ff 50 (+++) HAL_OPAMPEx_SelfCalibrateAll
bogdanm 0:9b334a45a8ff 51 runs calibration of all OPAMPs in parallel to save search time.
bogdanm 0:9b334a45a8ff 52
bogdanm 0:9b334a45a8ff 53 (#) Running mode: Standalone mode
bogdanm 0:9b334a45a8ff 54 (++) Gain is set externally (gain depends on external loads).
bogdanm 0:9b334a45a8ff 55 (++) Follower mode also possible externally by connecting the inverting input to
bogdanm 0:9b334a45a8ff 56 the output.
bogdanm 0:9b334a45a8ff 57
bogdanm 0:9b334a45a8ff 58 (#) Running mode: Follower mode
bogdanm 0:9b334a45a8ff 59 (++) No Inverting Input is connected.
bogdanm 0:9b334a45a8ff 60
bogdanm 0:9b334a45a8ff 61 (#) Running mode: Programmable Gain Amplifier (PGA) mode
bogdanm 0:9b334a45a8ff 62 (Resistor feedback output)
bogdanm 0:9b334a45a8ff 63 (++) The OPAMP(s) output(s) can be internally connected to resistor feedback
bogdanm 0:9b334a45a8ff 64 output.
bogdanm 0:9b334a45a8ff 65 (++) OPAMP gain is either 2, 4, 8 or 16.
bogdanm 0:9b334a45a8ff 66
bogdanm 0:9b334a45a8ff 67 (#) The OPAMPs inverting input can be
bogdanm 0:9b334a45a8ff 68 selected among the list shown by table below.
bogdanm 0:9b334a45a8ff 69
bogdanm 0:9b334a45a8ff 70 (#) The OPAMPs non inverting input can be
bogdanm 0:9b334a45a8ff 71 selected among the list shown by table below.
bogdanm 0:9b334a45a8ff 72
bogdanm 0:9b334a45a8ff 73 [..] Table 1. OPAMPs inverting/non-inverting inputs for the STM32L4 devices:
bogdanm 0:9b334a45a8ff 74
bogdanm 0:9b334a45a8ff 75 (+) +------------------------------------------------------------------------|
bogdanm 0:9b334a45a8ff 76 (+) | | | OPAMP1 | OPAMP2 |
bogdanm 0:9b334a45a8ff 77 (+) |-----------------|---------|----------------------|---------------------|
bogdanm 0:9b334a45a8ff 78 (+) | Inverting Input | VM_SEL | | |
bogdanm 0:9b334a45a8ff 79 (+) | | | IO0-> PA1 | IO0-> PA7 |
bogdanm 0:9b334a45a8ff 80 (+) | | | LOW LEAKAGE IO (2) | LOW LEAKAGE IO (2) |
bogdanm 0:9b334a45a8ff 81 (+) | | | Not connected | Not connected |
bogdanm 0:9b334a45a8ff 82 (+) | (1) | | PGA mode only | PGA mode only |
bogdanm 0:9b334a45a8ff 83 (+) |-----------------|---------|----------------------|---------------------|
bogdanm 0:9b334a45a8ff 84 (+) | Non Inverting | VM_SEL | | |
bogdanm 0:9b334a45a8ff 85 (+) | | | IO0-> PA0 (GPIO) | IO0-> PA6 (GPIO) |
bogdanm 0:9b334a45a8ff 86 (+) | Input | | DAC1_OUT1 internal | DAC1_OUT2 internal |
bogdanm 0:9b334a45a8ff 87 (+) +------------------------------------------------------------------------|
bogdanm 0:9b334a45a8ff 88 [..] (1): NA in follower mode.
bogdanm 0:9b334a45a8ff 89 [..](2): Available on some package only (ex. BGA132).
bogdanm 0:9b334a45a8ff 90
bogdanm 0:9b334a45a8ff 91 [..] Table 2. OPAMPs outputs for the STM32L4 devices:
bogdanm 0:9b334a45a8ff 92
bogdanm 0:9b334a45a8ff 93 (+) +-------------------------------------------------------------------------
bogdanm 0:9b334a45a8ff 94 (+) | | | OPAMP1 | OPAMP2 |
bogdanm 0:9b334a45a8ff 95 (+) |-----------------|--------|-----------------------|---------------------|
bogdanm 0:9b334a45a8ff 96 (+) | Output | VOUT | PA3 | PB0 |
bogdanm 0:9b334a45a8ff 97 (+) | | | & (2) ADC12_IN if | & (2) ADC12_IN if |
bogdanm 0:9b334a45a8ff 98 (+) | | | connected internally | connected internally|
bogdanm 0:9b334a45a8ff 99 (+) |-----------------|--------|-----------------------|---------------------|
bogdanm 0:9b334a45a8ff 100 [..] (2): ADC1 or ADC2 shall select IN15.
bogdanm 0:9b334a45a8ff 101
bogdanm 0:9b334a45a8ff 102 ##### How to use this driver #####
bogdanm 0:9b334a45a8ff 103 ================================================================================
bogdanm 0:9b334a45a8ff 104 [..]
bogdanm 0:9b334a45a8ff 105
bogdanm 0:9b334a45a8ff 106 *** Power supply range ***
bogdanm 0:9b334a45a8ff 107 ============================================
bogdanm 0:9b334a45a8ff 108 [..] To run in low power mode:
bogdanm 0:9b334a45a8ff 109
bogdanm 0:9b334a45a8ff 110 (#) Configure the OPAMP using HAL_OPAMP_Init() function:
bogdanm 0:9b334a45a8ff 111 (++) Select OPAMP_POWERSUPPLY_LOW (VDDA lower than 2.4V)
bogdanm 0:9b334a45a8ff 112 (++) Otherwise select OPAMP_POWERSUPPLY_HIGH (VDDA higher than 2.4V)
bogdanm 0:9b334a45a8ff 113
bogdanm 0:9b334a45a8ff 114 *** Low / normal power mode ***
bogdanm 0:9b334a45a8ff 115 ============================================
bogdanm 0:9b334a45a8ff 116 [..] To run in low power mode:
bogdanm 0:9b334a45a8ff 117
bogdanm 0:9b334a45a8ff 118 (#) Configure the OPAMP using HAL_OPAMP_Init() function:
bogdanm 0:9b334a45a8ff 119 (++) Select OPAMP_POWERMODE_LOWPOWER
bogdanm 0:9b334a45a8ff 120 (++) Otherwise select OPAMP_POWERMODE_NORMAL
bogdanm 0:9b334a45a8ff 121
bogdanm 0:9b334a45a8ff 122 *** Calibration ***
bogdanm 0:9b334a45a8ff 123 ============================================
bogdanm 0:9b334a45a8ff 124 [..] To run the OPAMP calibration self calibration:
bogdanm 0:9b334a45a8ff 125
bogdanm 0:9b334a45a8ff 126 (#) Start calibration using HAL_OPAMP_SelfCalibrate.
bogdanm 0:9b334a45a8ff 127 Store the calibration results.
bogdanm 0:9b334a45a8ff 128
bogdanm 0:9b334a45a8ff 129 *** Running mode ***
bogdanm 0:9b334a45a8ff 130 ============================================
bogdanm 0:9b334a45a8ff 131
bogdanm 0:9b334a45a8ff 132 [..] To use the OPAMP, perform the following steps:
bogdanm 0:9b334a45a8ff 133
bogdanm 0:9b334a45a8ff 134 (#) Fill in the HAL_OPAMP_MspInit() to
bogdanm 0:9b334a45a8ff 135 (++) Enable the OPAMP Peripheral clock using macro __HAL_RCC_OPAMP_CLK_ENABLE()
bogdanm 0:9b334a45a8ff 136 (++) Configure the OPAMP input AND output in analog mode using
bogdanm 0:9b334a45a8ff 137 HAL_GPIO_Init() to map the OPAMP output to the GPIO pin.
bogdanm 0:9b334a45a8ff 138
bogdanm 0:9b334a45a8ff 139 (#) Configure the OPAMP using HAL_OPAMP_Init() function:
bogdanm 0:9b334a45a8ff 140 (++) Select the mode
bogdanm 0:9b334a45a8ff 141 (++) Select the inverting input
bogdanm 0:9b334a45a8ff 142 (++) Select the non-inverting input
bogdanm 0:9b334a45a8ff 143 (++) If PGA mode is enabled, Select if inverting input is connected.
bogdanm 0:9b334a45a8ff 144 (++) Select either factory or user defined trimming mode.
bogdanm 0:9b334a45a8ff 145 (++) If the user-defined trimming mode is enabled, select PMOS & NMOS trimming values
bogdanm 0:9b334a45a8ff 146 (typically values set by HAL_OPAMP_SelfCalibrate function).
bogdanm 0:9b334a45a8ff 147
bogdanm 0:9b334a45a8ff 148 (#) Enable the OPAMP using HAL_OPAMP_Start() function.
bogdanm 0:9b334a45a8ff 149
bogdanm 0:9b334a45a8ff 150 (#) Disable the OPAMP using HAL_OPAMP_Stop() function.
bogdanm 0:9b334a45a8ff 151
bogdanm 0:9b334a45a8ff 152 (#) Lock the OPAMP in running mode using HAL_OPAMP_Lock() function.
bogdanm 0:9b334a45a8ff 153 Caution: On STM32L4, HAL OPAMP lock is software lock only (not
bogdanm 0:9b334a45a8ff 154 hardware lock as on some other STM32 devices)
bogdanm 0:9b334a45a8ff 155
bogdanm 0:9b334a45a8ff 156 (#) If needed, unlock the OPAMP using HAL_OPAMPEx_Unlock() function.
bogdanm 0:9b334a45a8ff 157
bogdanm 0:9b334a45a8ff 158 *** Running mode: change of configuration while OPAMP ON ***
bogdanm 0:9b334a45a8ff 159 ============================================
bogdanm 0:9b334a45a8ff 160 [..] To Re-configure OPAMP when OPAMP is ON (change on the fly)
bogdanm 0:9b334a45a8ff 161 (#) If needed, fill in the HAL_OPAMP_MspInit()
bogdanm 0:9b334a45a8ff 162 (++) This is the case for instance if you wish to use new OPAMP I/O
bogdanm 0:9b334a45a8ff 163
bogdanm 0:9b334a45a8ff 164 (#) Configure the OPAMP using HAL_OPAMP_Init() function:
bogdanm 0:9b334a45a8ff 165 (++) As in configure case, select first the parameters you wish to modify.
bogdanm 0:9b334a45a8ff 166
bogdanm 0:9b334a45a8ff 167 (#) Change from low power mode to normal power mode (& vice versa) requires
bogdanm 0:9b334a45a8ff 168 first HAL_OPAMP_DeInit() (force OPAMP OFF) and then HAL_OPAMP_Init().
bogdanm 0:9b334a45a8ff 169 In other words, of OPAMP is ON, HAL_OPAMP_Init can NOT change power mode
bogdanm 0:9b334a45a8ff 170 alone.
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 @endverbatim
bogdanm 0:9b334a45a8ff 173 ******************************************************************************
bogdanm 0:9b334a45a8ff 174 * @attention
bogdanm 0:9b334a45a8ff 175 *
bogdanm 0:9b334a45a8ff 176 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bogdanm 0:9b334a45a8ff 177 *
bogdanm 0:9b334a45a8ff 178 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 0:9b334a45a8ff 179 * are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 180 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 181 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 182 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 183 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 184 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 185 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 186 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 187 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 188 *
bogdanm 0:9b334a45a8ff 189 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 190 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 191 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 192 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 193 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 194 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 195 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 196 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 197 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 198 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 199 *
bogdanm 0:9b334a45a8ff 200 ******************************************************************************
bogdanm 0:9b334a45a8ff 201 */
bogdanm 0:9b334a45a8ff 202
bogdanm 0:9b334a45a8ff 203 /* Includes ------------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 204 #include "stm32l4xx_hal.h"
bogdanm 0:9b334a45a8ff 205
bogdanm 0:9b334a45a8ff 206 /** @addtogroup STM32L4xx_HAL_Driver
bogdanm 0:9b334a45a8ff 207 * @{
bogdanm 0:9b334a45a8ff 208 */
bogdanm 0:9b334a45a8ff 209
bogdanm 0:9b334a45a8ff 210 /** @defgroup OPAMP OPAMP
bogdanm 0:9b334a45a8ff 211 * @brief OPAMP module driver
bogdanm 0:9b334a45a8ff 212 * @{
bogdanm 0:9b334a45a8ff 213 */
bogdanm 0:9b334a45a8ff 214
bogdanm 0:9b334a45a8ff 215 #ifdef HAL_OPAMP_MODULE_ENABLED
bogdanm 0:9b334a45a8ff 216
bogdanm 0:9b334a45a8ff 217 /* Private types -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 218 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 219 /* Private constants ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 220 /** @addtogroup OPAMP_Private_Constants
bogdanm 0:9b334a45a8ff 221 * @{
bogdanm 0:9b334a45a8ff 222 */
bogdanm 0:9b334a45a8ff 223
bogdanm 0:9b334a45a8ff 224 /* CSR register reset value */
bogdanm 0:9b334a45a8ff 225 #define OPAMP_CSR_RESET_VALUE ((uint32_t)0x00000000)
bogdanm 0:9b334a45a8ff 226
bogdanm 0:9b334a45a8ff 227 #define OPAMP_CSR_RESET_BITS (OPAMP_CSR_OPAMPxEN | OPAMP_CSR_OPALPM | OPAMP_CSR_OPAMODE \
bogdanm 0:9b334a45a8ff 228 | OPAMP_CSR_PGGAIN | OPAMP_CSR_VMSEL | OPAMP_CSR_VPSEL \
bogdanm 0:9b334a45a8ff 229 | OPAMP_CSR_CALON | OPAMP_CSR_USERTRIM)
bogdanm 0:9b334a45a8ff 230
bogdanm 0:9b334a45a8ff 231 /* CSR Init masks */
bogdanm 0:9b334a45a8ff 232 #define OPAMP_CSR_INIT_MASK_PGA (OPAMP_CSR_OPALPM | OPAMP_CSR_OPAMODE| OPAMP_CSR_PGGAIN \
bogdanm 0:9b334a45a8ff 233 | OPAMP_CSR_VMSEL | OPAMP_CSR_VPSEL | OPAMP_CSR_USERTRIM)
bogdanm 0:9b334a45a8ff 234
bogdanm 0:9b334a45a8ff 235 #define OPAMP_CSR_INIT_MASK_FOLLOWER (OPAMP_CSR_OPALPM | OPAMP_CSR_OPAMODE| OPAMP_CSR_VPSEL \
bogdanm 0:9b334a45a8ff 236 | OPAMP_CSR_USERTRIM)
bogdanm 0:9b334a45a8ff 237
bogdanm 0:9b334a45a8ff 238 #define OPAMP_CSR_INIT_MASK_STANDALONE (OPAMP_CSR_OPALPM | OPAMP_CSR_OPAMODE| OPAMP_CSR_VPSEL \
bogdanm 0:9b334a45a8ff 239 | OPAMP_CSR_VMSEL | OPAMP_CSR_USERTRIM)
bogdanm 0:9b334a45a8ff 240
bogdanm 0:9b334a45a8ff 241
bogdanm 0:9b334a45a8ff 242 /**
bogdanm 0:9b334a45a8ff 243 * @}
bogdanm 0:9b334a45a8ff 244 */
bogdanm 0:9b334a45a8ff 245
bogdanm 0:9b334a45a8ff 246 /* Private macros ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 247 /* Private functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 248 /* Exported functions --------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 249
bogdanm 0:9b334a45a8ff 250 /** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions
bogdanm 0:9b334a45a8ff 251 * @{
bogdanm 0:9b334a45a8ff 252 */
bogdanm 0:9b334a45a8ff 253
bogdanm 0:9b334a45a8ff 254 /** @defgroup OPAMP_Exported_Functions_Group1 Initialization and de-initialization functions
bogdanm 0:9b334a45a8ff 255 * @brief Initialization and Configuration functions
bogdanm 0:9b334a45a8ff 256 *
bogdanm 0:9b334a45a8ff 257 @verbatim
bogdanm 0:9b334a45a8ff 258 ==============================================================================
bogdanm 0:9b334a45a8ff 259 ##### Initialization and de-initialization functions #####
bogdanm 0:9b334a45a8ff 260 ==============================================================================
bogdanm 0:9b334a45a8ff 261
bogdanm 0:9b334a45a8ff 262 @endverbatim
bogdanm 0:9b334a45a8ff 263 * @{
bogdanm 0:9b334a45a8ff 264 */
bogdanm 0:9b334a45a8ff 265
bogdanm 0:9b334a45a8ff 266 /**
bogdanm 0:9b334a45a8ff 267 * @brief Initializes the OPAMP according to the specified
bogdanm 0:9b334a45a8ff 268 * parameters in the OPAMP_InitTypeDef and initialize the associated handle.
bogdanm 0:9b334a45a8ff 269 * @note If the selected opamp is locked, initialization can't be performed.
bogdanm 0:9b334a45a8ff 270 * To unlock the configuration, perform a system reset.
bogdanm 0:9b334a45a8ff 271 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 272 * @retval HAL status
bogdanm 0:9b334a45a8ff 273 */
bogdanm 0:9b334a45a8ff 274 HAL_StatusTypeDef HAL_OPAMP_Init(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 275 {
bogdanm 0:9b334a45a8ff 276 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 277 uint32_t updateotrlpotr = 0;
bogdanm 0:9b334a45a8ff 278
bogdanm 0:9b334a45a8ff 279 /* Check the OPAMP handle allocation and lock status */
bogdanm 0:9b334a45a8ff 280 /* Init not allowed if calibration is ongoing */
bogdanm 0:9b334a45a8ff 281 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED)
bogdanm 0:9b334a45a8ff 282 || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
bogdanm 0:9b334a45a8ff 283 {
bogdanm 0:9b334a45a8ff 284 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 285 }
bogdanm 0:9b334a45a8ff 286 else
bogdanm 0:9b334a45a8ff 287 {
bogdanm 0:9b334a45a8ff 288 /* Check the parameter */
bogdanm 0:9b334a45a8ff 289 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 290
bogdanm 0:9b334a45a8ff 291 /* Set OPAMP parameters */
bogdanm 0:9b334a45a8ff 292 assert_param(IS_OPAMP_POWER_SUPPLY_RANGE(hopamp->Init.PowerSupplyRange));
bogdanm 0:9b334a45a8ff 293 assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));
bogdanm 0:9b334a45a8ff 294 assert_param(IS_OPAMP_FUNCTIONAL_NORMALMODE(hopamp->Init.Mode));
bogdanm 0:9b334a45a8ff 295 assert_param(IS_OPAMP_NONINVERTING_INPUT(hopamp->Init.NonInvertingInput));
bogdanm 0:9b334a45a8ff 296
bogdanm 0:9b334a45a8ff 297 if ((hopamp->Init.Mode) == OPAMP_STANDALONE_MODE)
bogdanm 0:9b334a45a8ff 298 {
bogdanm 0:9b334a45a8ff 299 assert_param(IS_OPAMP_INVERTING_INPUT_STANDALONE(hopamp->Init.InvertingInput));
bogdanm 0:9b334a45a8ff 300 }
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 if ((hopamp->Init.Mode) == OPAMP_PGA_MODE)
bogdanm 0:9b334a45a8ff 303 {
bogdanm 0:9b334a45a8ff 304 assert_param(IS_OPAMP_INVERTING_INPUT_PGA(hopamp->Init.InvertingInput));
bogdanm 0:9b334a45a8ff 305 }
bogdanm 0:9b334a45a8ff 306
bogdanm 0:9b334a45a8ff 307 if ((hopamp->Init.Mode) == OPAMP_PGA_MODE)
bogdanm 0:9b334a45a8ff 308 {
bogdanm 0:9b334a45a8ff 309 assert_param(IS_OPAMP_PGA_GAIN(hopamp->Init.PgaGain));
bogdanm 0:9b334a45a8ff 310 }
bogdanm 0:9b334a45a8ff 311
bogdanm 0:9b334a45a8ff 312 assert_param(IS_OPAMP_TRIMMING(hopamp->Init.UserTrimming));
bogdanm 0:9b334a45a8ff 313 if ((hopamp->Init.UserTrimming) == OPAMP_TRIMMING_USER)
bogdanm 0:9b334a45a8ff 314 {
bogdanm 0:9b334a45a8ff 315 if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)
bogdanm 0:9b334a45a8ff 316 {
bogdanm 0:9b334a45a8ff 317 assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueP));
bogdanm 0:9b334a45a8ff 318 assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueN));
bogdanm 0:9b334a45a8ff 319 }
bogdanm 0:9b334a45a8ff 320 else
bogdanm 0:9b334a45a8ff 321 {
bogdanm 0:9b334a45a8ff 322 assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValuePLowPower));
bogdanm 0:9b334a45a8ff 323 assert_param(IS_OPAMP_TRIMMINGVALUE(hopamp->Init.TrimmingValueNLowPower));
bogdanm 0:9b334a45a8ff 324 }
bogdanm 0:9b334a45a8ff 325 }
bogdanm 0:9b334a45a8ff 326
bogdanm 0:9b334a45a8ff 327 if(hopamp->State == HAL_OPAMP_STATE_RESET)
bogdanm 0:9b334a45a8ff 328 {
bogdanm 0:9b334a45a8ff 329 /* Allocate lock resource and initialize it */
bogdanm 0:9b334a45a8ff 330 hopamp->Lock = HAL_UNLOCKED;
bogdanm 0:9b334a45a8ff 331 }
bogdanm 0:9b334a45a8ff 332
bogdanm 0:9b334a45a8ff 333 /* Call MSP init function */
bogdanm 0:9b334a45a8ff 334 HAL_OPAMP_MspInit(hopamp);
bogdanm 0:9b334a45a8ff 335
bogdanm 0:9b334a45a8ff 336 /* Set operating mode */
bogdanm 0:9b334a45a8ff 337 CLEAR_BIT(hopamp->Instance->CSR, OPAMP_CSR_CALON);
bogdanm 0:9b334a45a8ff 338
bogdanm 0:9b334a45a8ff 339 if (hopamp->Init.Mode == OPAMP_PGA_MODE)
bogdanm 0:9b334a45a8ff 340 {
bogdanm 0:9b334a45a8ff 341 MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_INIT_MASK_PGA, \
bogdanm 0:9b334a45a8ff 342 hopamp->Init.PowerMode | \
bogdanm 0:9b334a45a8ff 343 hopamp->Init.Mode | \
bogdanm 0:9b334a45a8ff 344 hopamp->Init.PgaGain | \
bogdanm 0:9b334a45a8ff 345 hopamp->Init.InvertingInput | \
bogdanm 0:9b334a45a8ff 346 hopamp->Init.NonInvertingInput | \
bogdanm 0:9b334a45a8ff 347 hopamp->Init.UserTrimming);
bogdanm 0:9b334a45a8ff 348 }
bogdanm 0:9b334a45a8ff 349
bogdanm 0:9b334a45a8ff 350 if (hopamp->Init.Mode == OPAMP_FOLLOWER_MODE)
bogdanm 0:9b334a45a8ff 351 {
bogdanm 0:9b334a45a8ff 352 /* In Follower mode InvertingInput is Not Applicable */
bogdanm 0:9b334a45a8ff 353 MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_INIT_MASK_FOLLOWER, \
bogdanm 0:9b334a45a8ff 354 hopamp->Init.PowerMode | \
bogdanm 0:9b334a45a8ff 355 hopamp->Init.Mode | \
bogdanm 0:9b334a45a8ff 356 hopamp->Init.NonInvertingInput | \
bogdanm 0:9b334a45a8ff 357 hopamp->Init.UserTrimming);
bogdanm 0:9b334a45a8ff 358 }
bogdanm 0:9b334a45a8ff 359
bogdanm 0:9b334a45a8ff 360 if (hopamp->Init.Mode == OPAMP_STANDALONE_MODE)
bogdanm 0:9b334a45a8ff 361 {
bogdanm 0:9b334a45a8ff 362 MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_INIT_MASK_STANDALONE, \
bogdanm 0:9b334a45a8ff 363 hopamp->Init.PowerMode | \
bogdanm 0:9b334a45a8ff 364 hopamp->Init.Mode | \
bogdanm 0:9b334a45a8ff 365 hopamp->Init.InvertingInput | \
bogdanm 0:9b334a45a8ff 366 hopamp->Init.NonInvertingInput | \
bogdanm 0:9b334a45a8ff 367 hopamp->Init.UserTrimming);
bogdanm 0:9b334a45a8ff 368 }
bogdanm 0:9b334a45a8ff 369
bogdanm 0:9b334a45a8ff 370 if (hopamp->Init.UserTrimming == OPAMP_TRIMMING_USER)
bogdanm 0:9b334a45a8ff 371 {
bogdanm 0:9b334a45a8ff 372 /* Set power mode and associated calibration parameters */
bogdanm 0:9b334a45a8ff 373 if (hopamp->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)
bogdanm 0:9b334a45a8ff 374 {
bogdanm 0:9b334a45a8ff 375 /* OPAMP_POWERMODE_NORMAL */
bogdanm 0:9b334a45a8ff 376 /* Set calibration mode (factory or user) and values for */
bogdanm 0:9b334a45a8ff 377 /* transistors differential pair high (PMOS) and low (NMOS) for */
bogdanm 0:9b334a45a8ff 378 /* normal mode. */
bogdanm 0:9b334a45a8ff 379 updateotrlpotr = (((hopamp->Init.TrimmingValueP) << (OPAMP_INPUT_NONINVERTING)) \
bogdanm 0:9b334a45a8ff 380 | (hopamp->Init.TrimmingValueN));
bogdanm 0:9b334a45a8ff 381 MODIFY_REG(hopamp->Instance->OTR, OPAMP_OTR_TRIMOFFSETN | OPAMP_OTR_TRIMOFFSETP, updateotrlpotr);
bogdanm 0:9b334a45a8ff 382 }
bogdanm 0:9b334a45a8ff 383 else
bogdanm 0:9b334a45a8ff 384 {
bogdanm 0:9b334a45a8ff 385 /* OPAMP_POWERMODE_LOWPOWER */
bogdanm 0:9b334a45a8ff 386 /* transistors differential pair high (PMOS) and low (NMOS) for */
bogdanm 0:9b334a45a8ff 387 /* low power mode. */
bogdanm 0:9b334a45a8ff 388 updateotrlpotr = (((hopamp->Init.TrimmingValuePLowPower) << (OPAMP_INPUT_NONINVERTING)) \
bogdanm 0:9b334a45a8ff 389 | (hopamp->Init.TrimmingValueNLowPower));
bogdanm 0:9b334a45a8ff 390 MODIFY_REG(hopamp->Instance->LPOTR, OPAMP_OTR_TRIMOFFSETN | OPAMP_OTR_TRIMOFFSETP, updateotrlpotr);
bogdanm 0:9b334a45a8ff 391 }
bogdanm 0:9b334a45a8ff 392 }
bogdanm 0:9b334a45a8ff 393
bogdanm 0:9b334a45a8ff 394 /* Configure the power supply range */
bogdanm 0:9b334a45a8ff 395 /* The OPAMP_CSR_OPARANGE is common configuration for all OPAMPs */
bogdanm 0:9b334a45a8ff 396 /* bit OPAMP1_CSR_OPARANGE is used for both OPAMPs */
bogdanm 0:9b334a45a8ff 397 MODIFY_REG(OPAMP1->CSR, OPAMP1_CSR_OPARANGE, hopamp->Init.PowerSupplyRange);
bogdanm 0:9b334a45a8ff 398
bogdanm 0:9b334a45a8ff 399 /* Update the OPAMP state*/
bogdanm 0:9b334a45a8ff 400 if (hopamp->State == HAL_OPAMP_STATE_RESET)
bogdanm 0:9b334a45a8ff 401 {
bogdanm 0:9b334a45a8ff 402 /* From RESET state to READY State */
bogdanm 0:9b334a45a8ff 403 hopamp->State = HAL_OPAMP_STATE_READY;
bogdanm 0:9b334a45a8ff 404 }
bogdanm 0:9b334a45a8ff 405 /* else: remain in READY or BUSY state (no update) */
bogdanm 0:9b334a45a8ff 406 return status;
bogdanm 0:9b334a45a8ff 407 }
bogdanm 0:9b334a45a8ff 408 }
bogdanm 0:9b334a45a8ff 409
bogdanm 0:9b334a45a8ff 410 /**
bogdanm 0:9b334a45a8ff 411 * @brief DeInitialize the OPAMP peripheral.
bogdanm 0:9b334a45a8ff 412 * @note Deinitialization can be performed if the OPAMP configuration is locked.
bogdanm 0:9b334a45a8ff 413 * (the lock is SW in L4)
bogdanm 0:9b334a45a8ff 414 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 415 * @retval HAL status
bogdanm 0:9b334a45a8ff 416 */
bogdanm 0:9b334a45a8ff 417 HAL_StatusTypeDef HAL_OPAMP_DeInit(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 418 {
bogdanm 0:9b334a45a8ff 419 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 420
bogdanm 0:9b334a45a8ff 421 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 422 /* DeInit not allowed if calibration is ongoing */
bogdanm 0:9b334a45a8ff 423 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
bogdanm 0:9b334a45a8ff 424 {
bogdanm 0:9b334a45a8ff 425 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 426 }
bogdanm 0:9b334a45a8ff 427 else
bogdanm 0:9b334a45a8ff 428 {
bogdanm 0:9b334a45a8ff 429 /* Check the parameter */
bogdanm 0:9b334a45a8ff 430 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 431
bogdanm 0:9b334a45a8ff 432 /* Set OPAMP_CSR register to reset value */
bogdanm 0:9b334a45a8ff 433 /* Mind that OPAMP1_CSR_OPARANGE of CSR of OPAMP1 remains unchanged (applies to both OPAMPs) */
bogdanm 0:9b334a45a8ff 434 /* OPAMP shall be disabled first separately */
bogdanm 0:9b334a45a8ff 435 CLEAR_BIT(hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
bogdanm 0:9b334a45a8ff 436 MODIFY_REG(hopamp->Instance->CSR, OPAMP_CSR_RESET_BITS, OPAMP_CSR_RESET_VALUE);
bogdanm 0:9b334a45a8ff 437
bogdanm 0:9b334a45a8ff 438 /* DeInit the low level hardware: GPIO, CLOCK and NVIC */
bogdanm 0:9b334a45a8ff 439 HAL_OPAMP_MspDeInit(hopamp);
bogdanm 0:9b334a45a8ff 440
bogdanm 0:9b334a45a8ff 441 /* Update the OPAMP state*/
bogdanm 0:9b334a45a8ff 442 hopamp->State = HAL_OPAMP_STATE_RESET;
bogdanm 0:9b334a45a8ff 443 }
bogdanm 0:9b334a45a8ff 444
bogdanm 0:9b334a45a8ff 445 /* Process unlocked */
bogdanm 0:9b334a45a8ff 446 __HAL_UNLOCK(hopamp);
bogdanm 0:9b334a45a8ff 447
bogdanm 0:9b334a45a8ff 448 return status;
bogdanm 0:9b334a45a8ff 449 }
bogdanm 0:9b334a45a8ff 450
bogdanm 0:9b334a45a8ff 451
bogdanm 0:9b334a45a8ff 452 /**
bogdanm 0:9b334a45a8ff 453 * @brief Initialize the OPAMP MSP.
bogdanm 0:9b334a45a8ff 454 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 455 * @retval None
bogdanm 0:9b334a45a8ff 456 */
bogdanm 0:9b334a45a8ff 457 __weak void HAL_OPAMP_MspInit(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 458 {
bogdanm 0:9b334a45a8ff 459 /* NOTE : This function should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 460 the function "HAL_OPAMP_MspInit()" must be implemented in the user file.
bogdanm 0:9b334a45a8ff 461 */
bogdanm 0:9b334a45a8ff 462 }
bogdanm 0:9b334a45a8ff 463
bogdanm 0:9b334a45a8ff 464 /**
bogdanm 0:9b334a45a8ff 465 * @brief DeInitialize OPAMP MSP.
bogdanm 0:9b334a45a8ff 466 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 467 * @retval None
bogdanm 0:9b334a45a8ff 468 */
bogdanm 0:9b334a45a8ff 469 __weak void HAL_OPAMP_MspDeInit(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 470 {
bogdanm 0:9b334a45a8ff 471 /* NOTE : This function should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 472 the function "HAL_OPAMP_MspDeInit()" must be implemented in the user file.
bogdanm 0:9b334a45a8ff 473 */
bogdanm 0:9b334a45a8ff 474 }
bogdanm 0:9b334a45a8ff 475
bogdanm 0:9b334a45a8ff 476 /**
bogdanm 0:9b334a45a8ff 477 * @}
bogdanm 0:9b334a45a8ff 478 */
bogdanm 0:9b334a45a8ff 479
bogdanm 0:9b334a45a8ff 480
bogdanm 0:9b334a45a8ff 481 /** @defgroup OPAMP_Exported_Functions_Group2 IO operation functions
bogdanm 0:9b334a45a8ff 482 * @brief IO operation functions
bogdanm 0:9b334a45a8ff 483 *
bogdanm 0:9b334a45a8ff 484 @verbatim
bogdanm 0:9b334a45a8ff 485 ===============================================================================
bogdanm 0:9b334a45a8ff 486 ##### IO operation functions #####
bogdanm 0:9b334a45a8ff 487 ===============================================================================
bogdanm 0:9b334a45a8ff 488 [..]
bogdanm 0:9b334a45a8ff 489 This subsection provides a set of functions allowing to manage the OPAMP
bogdanm 0:9b334a45a8ff 490 start, stop and calibration actions.
bogdanm 0:9b334a45a8ff 491
bogdanm 0:9b334a45a8ff 492 @endverbatim
bogdanm 0:9b334a45a8ff 493 * @{
bogdanm 0:9b334a45a8ff 494 */
bogdanm 0:9b334a45a8ff 495
bogdanm 0:9b334a45a8ff 496 /**
bogdanm 0:9b334a45a8ff 497 * @brief Start the OPAMP.
bogdanm 0:9b334a45a8ff 498 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 499 * @retval HAL status
bogdanm 0:9b334a45a8ff 500 */
bogdanm 0:9b334a45a8ff 501
bogdanm 0:9b334a45a8ff 502 HAL_StatusTypeDef HAL_OPAMP_Start(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 503 {
bogdanm 0:9b334a45a8ff 504 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 505
bogdanm 0:9b334a45a8ff 506 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 507 /* Check if OPAMP locked */
bogdanm 0:9b334a45a8ff 508 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
bogdanm 0:9b334a45a8ff 509 {
bogdanm 0:9b334a45a8ff 510 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 511 }
bogdanm 0:9b334a45a8ff 512 else
bogdanm 0:9b334a45a8ff 513 {
bogdanm 0:9b334a45a8ff 514 /* Check the parameter */
bogdanm 0:9b334a45a8ff 515 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 516
bogdanm 0:9b334a45a8ff 517 if(hopamp->State == HAL_OPAMP_STATE_READY)
bogdanm 0:9b334a45a8ff 518 {
bogdanm 0:9b334a45a8ff 519 /* Enable the selected opamp */
bogdanm 0:9b334a45a8ff 520 SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
bogdanm 0:9b334a45a8ff 521
bogdanm 0:9b334a45a8ff 522 /* Update the OPAMP state*/
bogdanm 0:9b334a45a8ff 523 /* From HAL_OPAMP_STATE_READY to HAL_OPAMP_STATE_BUSY */
bogdanm 0:9b334a45a8ff 524 hopamp->State = HAL_OPAMP_STATE_BUSY;
bogdanm 0:9b334a45a8ff 525 }
bogdanm 0:9b334a45a8ff 526 else
bogdanm 0:9b334a45a8ff 527 {
bogdanm 0:9b334a45a8ff 528 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 529 }
bogdanm 0:9b334a45a8ff 530
bogdanm 0:9b334a45a8ff 531 }
bogdanm 0:9b334a45a8ff 532 return status;
bogdanm 0:9b334a45a8ff 533 }
bogdanm 0:9b334a45a8ff 534
bogdanm 0:9b334a45a8ff 535 /**
bogdanm 0:9b334a45a8ff 536 * @brief Stop the OPAMP.
bogdanm 0:9b334a45a8ff 537 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 538 * @retval HAL status
bogdanm 0:9b334a45a8ff 539 */
bogdanm 0:9b334a45a8ff 540 HAL_StatusTypeDef HAL_OPAMP_Stop(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 541 {
bogdanm 0:9b334a45a8ff 542 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 543
bogdanm 0:9b334a45a8ff 544 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 545 /* Check if OPAMP locked */
bogdanm 0:9b334a45a8ff 546 /* Check if OPAMP calibration ongoing */
bogdanm 0:9b334a45a8ff 547 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED) \
bogdanm 0:9b334a45a8ff 548 || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY))
bogdanm 0:9b334a45a8ff 549 {
bogdanm 0:9b334a45a8ff 550 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 551 }
bogdanm 0:9b334a45a8ff 552 else
bogdanm 0:9b334a45a8ff 553 {
bogdanm 0:9b334a45a8ff 554 /* Check the parameter */
bogdanm 0:9b334a45a8ff 555 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 556
bogdanm 0:9b334a45a8ff 557 if(hopamp->State == HAL_OPAMP_STATE_BUSY)
bogdanm 0:9b334a45a8ff 558 {
bogdanm 0:9b334a45a8ff 559 /* Disable the selected opamp */
bogdanm 0:9b334a45a8ff 560 CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
bogdanm 0:9b334a45a8ff 561
bogdanm 0:9b334a45a8ff 562 /* Update the OPAMP state*/
bogdanm 0:9b334a45a8ff 563 /* From HAL_OPAMP_STATE_BUSY to HAL_OPAMP_STATE_READY*/
bogdanm 0:9b334a45a8ff 564 hopamp->State = HAL_OPAMP_STATE_READY;
bogdanm 0:9b334a45a8ff 565 }
bogdanm 0:9b334a45a8ff 566 else
bogdanm 0:9b334a45a8ff 567 {
bogdanm 0:9b334a45a8ff 568 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 569 }
bogdanm 0:9b334a45a8ff 570 }
bogdanm 0:9b334a45a8ff 571 return status;
bogdanm 0:9b334a45a8ff 572 }
bogdanm 0:9b334a45a8ff 573
bogdanm 0:9b334a45a8ff 574 /**
bogdanm 0:9b334a45a8ff 575 * @brief Run the self calibration of one OPAMP.
bogdanm 0:9b334a45a8ff 576 * @note Calibration is performed in the mode specified in OPAMP init
bogdanm 0:9b334a45a8ff 577 * structure (mode normal or low-power). To perform calibration for
bogdanm 0:9b334a45a8ff 578 * both modes, repeat this function twice after OPAMP init structure
bogdanm 0:9b334a45a8ff 579 * accordingly updated.
bogdanm 0:9b334a45a8ff 580 * @note Calibration runs about 10 ms.
bogdanm 0:9b334a45a8ff 581 * @param hopamp handle
bogdanm 0:9b334a45a8ff 582 * @retval Updated offset trimming values (PMOS & NMOS), user trimming is enabled
bogdanm 0:9b334a45a8ff 583 * @retval HAL status
bogdanm 0:9b334a45a8ff 584
bogdanm 0:9b334a45a8ff 585 */
bogdanm 0:9b334a45a8ff 586
bogdanm 0:9b334a45a8ff 587 HAL_StatusTypeDef HAL_OPAMP_SelfCalibrate(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 588 {
bogdanm 0:9b334a45a8ff 589
bogdanm 0:9b334a45a8ff 590 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 591
bogdanm 0:9b334a45a8ff 592 uint32_t trimmingvaluen = 0;
bogdanm 0:9b334a45a8ff 593 uint32_t trimmingvaluep = 0;
bogdanm 0:9b334a45a8ff 594 uint32_t delta;
bogdanm 0:9b334a45a8ff 595
bogdanm 0:9b334a45a8ff 596 __IO uint32_t* tmp_opamp_reg_trimming; /* Selection of register of trimming depending on power mode: OTR or LPOTR */
bogdanm 0:9b334a45a8ff 597
bogdanm 0:9b334a45a8ff 598 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 599 /* Check if OPAMP locked */
bogdanm 0:9b334a45a8ff 600 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
bogdanm 0:9b334a45a8ff 601 {
bogdanm 0:9b334a45a8ff 602 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 603 }
bogdanm 0:9b334a45a8ff 604 else
bogdanm 0:9b334a45a8ff 605 {
bogdanm 0:9b334a45a8ff 606
bogdanm 0:9b334a45a8ff 607 /* Check if OPAMP in calibration mode and calibration not yet enable */
bogdanm 0:9b334a45a8ff 608 if(hopamp->State == HAL_OPAMP_STATE_READY)
bogdanm 0:9b334a45a8ff 609 {
bogdanm 0:9b334a45a8ff 610 /* Check the parameter */
bogdanm 0:9b334a45a8ff 611 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 612 assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));
bogdanm 0:9b334a45a8ff 613
bogdanm 0:9b334a45a8ff 614 /* user trimming values are used for offset calibration */
bogdanm 0:9b334a45a8ff 615 SET_BIT(hopamp->Instance->CSR, OPAMP_CSR_USERTRIM);
bogdanm 0:9b334a45a8ff 616
bogdanm 0:9b334a45a8ff 617 /* Select trimming settings depending on power mode */
bogdanm 0:9b334a45a8ff 618 if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)
bogdanm 0:9b334a45a8ff 619 {
bogdanm 0:9b334a45a8ff 620 tmp_opamp_reg_trimming = &hopamp->Instance->OTR;
bogdanm 0:9b334a45a8ff 621 }
bogdanm 0:9b334a45a8ff 622 else
bogdanm 0:9b334a45a8ff 623 {
bogdanm 0:9b334a45a8ff 624 tmp_opamp_reg_trimming = &hopamp->Instance->LPOTR;
bogdanm 0:9b334a45a8ff 625 }
bogdanm 0:9b334a45a8ff 626
bogdanm 0:9b334a45a8ff 627 /* Enable calibration */
bogdanm 0:9b334a45a8ff 628 SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALON);
bogdanm 0:9b334a45a8ff 629
bogdanm 0:9b334a45a8ff 630 /* 1st calibration - N */
bogdanm 0:9b334a45a8ff 631 CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALSEL);
bogdanm 0:9b334a45a8ff 632
bogdanm 0:9b334a45a8ff 633 /* Enable the selected opamp */
bogdanm 0:9b334a45a8ff 634 SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
bogdanm 0:9b334a45a8ff 635
bogdanm 0:9b334a45a8ff 636 /* Init trimming counter */
bogdanm 0:9b334a45a8ff 637 /* Medium value */
bogdanm 0:9b334a45a8ff 638 trimmingvaluen = 16;
bogdanm 0:9b334a45a8ff 639 delta = 8;
bogdanm 0:9b334a45a8ff 640
bogdanm 0:9b334a45a8ff 641 while (delta != 0)
bogdanm 0:9b334a45a8ff 642 {
bogdanm 0:9b334a45a8ff 643 /* Set candidate trimming */
bogdanm 0:9b334a45a8ff 644 /* OPAMP_POWERMODE_NORMAL */
bogdanm 0:9b334a45a8ff 645 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen);
bogdanm 0:9b334a45a8ff 646
bogdanm 0:9b334a45a8ff 647 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
bogdanm 0:9b334a45a8ff 648 /* Offset trim time: during calibration, minimum time needed between */
bogdanm 0:9b334a45a8ff 649 /* two steps to have 1 mV accuracy */
bogdanm 0:9b334a45a8ff 650 HAL_Delay(OPAMP_TRIMMING_DELAY);
bogdanm 0:9b334a45a8ff 651
bogdanm 0:9b334a45a8ff 652 if (READ_BIT(hopamp->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
bogdanm 0:9b334a45a8ff 653 {
bogdanm 0:9b334a45a8ff 654 /* OPAMP_CSR_CALOUT is HIGH try higher trimming */
bogdanm 0:9b334a45a8ff 655 trimmingvaluen -= delta;
bogdanm 0:9b334a45a8ff 656 }
bogdanm 0:9b334a45a8ff 657 else
bogdanm 0:9b334a45a8ff 658 {
bogdanm 0:9b334a45a8ff 659 /* OPAMP_CSR_CALOUT is LOW try lower trimming */
bogdanm 0:9b334a45a8ff 660 trimmingvaluen += delta;
bogdanm 0:9b334a45a8ff 661 }
bogdanm 0:9b334a45a8ff 662 /* Divide range by 2 to continue dichotomy sweep */
bogdanm 0:9b334a45a8ff 663 delta >>= 1;
bogdanm 0:9b334a45a8ff 664 }
bogdanm 0:9b334a45a8ff 665
bogdanm 0:9b334a45a8ff 666 /* Still need to check if right calibration is current value or one step below */
bogdanm 0:9b334a45a8ff 667 /* Indeed the first value that causes the OUTCAL bit to change from 0 to 1 */
bogdanm 0:9b334a45a8ff 668 /* Set candidate trimming */
bogdanm 0:9b334a45a8ff 669 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen);
bogdanm 0:9b334a45a8ff 670
bogdanm 0:9b334a45a8ff 671 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
bogdanm 0:9b334a45a8ff 672 /* Offset trim time: during calibration, minimum time needed between */
bogdanm 0:9b334a45a8ff 673 /* two steps to have 1 mV accuracy */
bogdanm 0:9b334a45a8ff 674 HAL_Delay(OPAMP_TRIMMING_DELAY);
bogdanm 0:9b334a45a8ff 675
bogdanm 0:9b334a45a8ff 676 if ((READ_BIT(hopamp->Instance->CSR, OPAMP_CSR_CALOUT)) == 0)
bogdanm 0:9b334a45a8ff 677 {
bogdanm 0:9b334a45a8ff 678 /* Trimming value is actually one value more */
bogdanm 0:9b334a45a8ff 679 trimmingvaluen++;
bogdanm 0:9b334a45a8ff 680 /* Set right trimming */
bogdanm 0:9b334a45a8ff 681 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen);
bogdanm 0:9b334a45a8ff 682 }
bogdanm 0:9b334a45a8ff 683
bogdanm 0:9b334a45a8ff 684 /* 2nd calibration - P */
bogdanm 0:9b334a45a8ff 685 SET_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALSEL);
bogdanm 0:9b334a45a8ff 686
bogdanm 0:9b334a45a8ff 687 /* Init trimming counter */
bogdanm 0:9b334a45a8ff 688 /* Medium value */
bogdanm 0:9b334a45a8ff 689 trimmingvaluep = 16;
bogdanm 0:9b334a45a8ff 690 delta = 8;
bogdanm 0:9b334a45a8ff 691
bogdanm 0:9b334a45a8ff 692 while (delta != 0)
bogdanm 0:9b334a45a8ff 693 {
bogdanm 0:9b334a45a8ff 694 /* Set candidate trimming */
bogdanm 0:9b334a45a8ff 695 /* OPAMP_POWERMODE_NORMAL */
bogdanm 0:9b334a45a8ff 696 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep<<OPAMP_INPUT_NONINVERTING));
bogdanm 0:9b334a45a8ff 697
bogdanm 0:9b334a45a8ff 698 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
bogdanm 0:9b334a45a8ff 699 /* Offset trim time: during calibration, minimum time needed between */
bogdanm 0:9b334a45a8ff 700 /* two steps to have 1 mV accuracy */
bogdanm 0:9b334a45a8ff 701 HAL_Delay(OPAMP_TRIMMING_DELAY);
bogdanm 0:9b334a45a8ff 702
bogdanm 0:9b334a45a8ff 703 if (READ_BIT(hopamp->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
bogdanm 0:9b334a45a8ff 704 {
bogdanm 0:9b334a45a8ff 705 /* OPAMP_CSR_CALOUT is HIGH try higher trimming */
bogdanm 0:9b334a45a8ff 706 trimmingvaluep += delta;
bogdanm 0:9b334a45a8ff 707 }
bogdanm 0:9b334a45a8ff 708 else
bogdanm 0:9b334a45a8ff 709 {
bogdanm 0:9b334a45a8ff 710 /* OPAMP_CSR_CALOUT is LOW try lower trimming */
bogdanm 0:9b334a45a8ff 711 trimmingvaluep -= delta;
bogdanm 0:9b334a45a8ff 712 }
bogdanm 0:9b334a45a8ff 713
bogdanm 0:9b334a45a8ff 714 /* Divide range by 2 to continue dichotomy sweep */
bogdanm 0:9b334a45a8ff 715 delta >>= 1;
bogdanm 0:9b334a45a8ff 716 }
bogdanm 0:9b334a45a8ff 717
bogdanm 0:9b334a45a8ff 718 /* Still need to check if right calibration is current value or one step below */
bogdanm 0:9b334a45a8ff 719 /* Indeed the first value that causes the OUTCAL bit to change from 1 to 0 */
bogdanm 0:9b334a45a8ff 720 /* Set candidate trimming */
bogdanm 0:9b334a45a8ff 721 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep<<OPAMP_INPUT_NONINVERTING));
bogdanm 0:9b334a45a8ff 722
bogdanm 0:9b334a45a8ff 723 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
bogdanm 0:9b334a45a8ff 724 /* Offset trim time: during calibration, minimum time needed between */
bogdanm 0:9b334a45a8ff 725 /* two steps to have 1 mV accuracy */
bogdanm 0:9b334a45a8ff 726 HAL_Delay(OPAMP_TRIMMING_DELAY);
bogdanm 0:9b334a45a8ff 727
bogdanm 0:9b334a45a8ff 728 if (READ_BIT(hopamp->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
bogdanm 0:9b334a45a8ff 729 {
bogdanm 0:9b334a45a8ff 730 /* Trimming value is actually one value more */
bogdanm 0:9b334a45a8ff 731 trimmingvaluep++;
bogdanm 0:9b334a45a8ff 732 MODIFY_REG(*tmp_opamp_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep<<OPAMP_INPUT_NONINVERTING));
bogdanm 0:9b334a45a8ff 733 }
bogdanm 0:9b334a45a8ff 734
bogdanm 0:9b334a45a8ff 735 /* Disable the OPAMP */
bogdanm 0:9b334a45a8ff 736 CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_OPAMPxEN);
bogdanm 0:9b334a45a8ff 737
bogdanm 0:9b334a45a8ff 738 /* Disable calibration & set normal mode (operating mode) */
bogdanm 0:9b334a45a8ff 739 CLEAR_BIT (hopamp->Instance->CSR, OPAMP_CSR_CALON);
bogdanm 0:9b334a45a8ff 740
bogdanm 0:9b334a45a8ff 741 /* Self calibration is successful */
bogdanm 0:9b334a45a8ff 742 /* Store calibration(user trimming) results in init structure. */
bogdanm 0:9b334a45a8ff 743
bogdanm 0:9b334a45a8ff 744 /* Set user trimming mode */
bogdanm 0:9b334a45a8ff 745 hopamp->Init.UserTrimming = OPAMP_TRIMMING_USER;
bogdanm 0:9b334a45a8ff 746
bogdanm 0:9b334a45a8ff 747 /* Affect calibration parameters depending on mode normal/low power */
bogdanm 0:9b334a45a8ff 748 if (hopamp->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)
bogdanm 0:9b334a45a8ff 749 {
bogdanm 0:9b334a45a8ff 750 /* Write calibration result N */
bogdanm 0:9b334a45a8ff 751 hopamp->Init.TrimmingValueN = trimmingvaluen;
bogdanm 0:9b334a45a8ff 752 /* Write calibration result P */
bogdanm 0:9b334a45a8ff 753 hopamp->Init.TrimmingValueP = trimmingvaluep;
bogdanm 0:9b334a45a8ff 754 }
bogdanm 0:9b334a45a8ff 755 else
bogdanm 0:9b334a45a8ff 756 {
bogdanm 0:9b334a45a8ff 757 /* Write calibration result N */
bogdanm 0:9b334a45a8ff 758 hopamp->Init.TrimmingValueNLowPower = trimmingvaluen;
bogdanm 0:9b334a45a8ff 759 /* Write calibration result P */
bogdanm 0:9b334a45a8ff 760 hopamp->Init.TrimmingValuePLowPower = trimmingvaluep;
bogdanm 0:9b334a45a8ff 761 }
bogdanm 0:9b334a45a8ff 762 }
bogdanm 0:9b334a45a8ff 763
bogdanm 0:9b334a45a8ff 764 else
bogdanm 0:9b334a45a8ff 765 {
bogdanm 0:9b334a45a8ff 766 /* OPAMP can not be calibrated from this mode */
bogdanm 0:9b334a45a8ff 767 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 768 }
bogdanm 0:9b334a45a8ff 769 }
bogdanm 0:9b334a45a8ff 770 return status;
bogdanm 0:9b334a45a8ff 771 }
bogdanm 0:9b334a45a8ff 772
bogdanm 0:9b334a45a8ff 773 /**
bogdanm 0:9b334a45a8ff 774 * @}
bogdanm 0:9b334a45a8ff 775 */
bogdanm 0:9b334a45a8ff 776
bogdanm 0:9b334a45a8ff 777 /** @defgroup OPAMP_Exported_Functions_Group3 Peripheral Control functions
bogdanm 0:9b334a45a8ff 778 * @brief Peripheral Control functions
bogdanm 0:9b334a45a8ff 779 *
bogdanm 0:9b334a45a8ff 780 @verbatim
bogdanm 0:9b334a45a8ff 781 ===============================================================================
bogdanm 0:9b334a45a8ff 782 ##### Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 783 ===============================================================================
bogdanm 0:9b334a45a8ff 784 [..]
bogdanm 0:9b334a45a8ff 785 This subsection provides a set of functions allowing to control the OPAMP data
bogdanm 0:9b334a45a8ff 786 transfers.
bogdanm 0:9b334a45a8ff 787
bogdanm 0:9b334a45a8ff 788
bogdanm 0:9b334a45a8ff 789
bogdanm 0:9b334a45a8ff 790 @endverbatim
bogdanm 0:9b334a45a8ff 791 * @{
bogdanm 0:9b334a45a8ff 792 */
bogdanm 0:9b334a45a8ff 793
bogdanm 0:9b334a45a8ff 794 /**
bogdanm 0:9b334a45a8ff 795 * @brief Lock the selected OPAMP configuration.
bogdanm 0:9b334a45a8ff 796 * @note On STM32L4, HAL OPAMP lock is software lock only (in
bogdanm 0:9b334a45a8ff 797 * contrast of hardware lock available on some other STM32
bogdanm 0:9b334a45a8ff 798 * devices).
bogdanm 0:9b334a45a8ff 799 * @param hopamp: OPAMP handle
bogdanm 0:9b334a45a8ff 800 * @retval HAL status
bogdanm 0:9b334a45a8ff 801 */
bogdanm 0:9b334a45a8ff 802 HAL_StatusTypeDef HAL_OPAMP_Lock(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 803 {
bogdanm 0:9b334a45a8ff 804 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 805
bogdanm 0:9b334a45a8ff 806 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 807 /* Check if OPAMP locked */
bogdanm 0:9b334a45a8ff 808 /* OPAMP can be locked when enabled and running in normal mode */
bogdanm 0:9b334a45a8ff 809 /* It is meaningless otherwise */
bogdanm 0:9b334a45a8ff 810 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_RESET) \
bogdanm 0:9b334a45a8ff 811 || (hopamp->State == HAL_OPAMP_STATE_READY) \
bogdanm 0:9b334a45a8ff 812 || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)\
bogdanm 0:9b334a45a8ff 813 || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
bogdanm 0:9b334a45a8ff 814
bogdanm 0:9b334a45a8ff 815 {
bogdanm 0:9b334a45a8ff 816 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 817 }
bogdanm 0:9b334a45a8ff 818
bogdanm 0:9b334a45a8ff 819 else
bogdanm 0:9b334a45a8ff 820 {
bogdanm 0:9b334a45a8ff 821 /* Check the parameter */
bogdanm 0:9b334a45a8ff 822 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 823
bogdanm 0:9b334a45a8ff 824 /* OPAMP state changed to locked */
bogdanm 0:9b334a45a8ff 825 hopamp->State = HAL_OPAMP_STATE_BUSYLOCKED;
bogdanm 0:9b334a45a8ff 826 }
bogdanm 0:9b334a45a8ff 827 return status;
bogdanm 0:9b334a45a8ff 828 }
bogdanm 0:9b334a45a8ff 829
bogdanm 0:9b334a45a8ff 830 /**
bogdanm 0:9b334a45a8ff 831 * @brief Return the OPAMP factory trimming value.
bogdanm 0:9b334a45a8ff 832 * @note On STM32L4 OPAMP, user can retrieve factory trimming if
bogdanm 0:9b334a45a8ff 833 * OPAMP has never been set to user trimming before.
bogdanm 0:9b334a45a8ff 834 * Therefore, this function must be called when OPAMP init
bogdanm 0:9b334a45a8ff 835 * parameter "UserTrimming" is set to trimming factory,
bogdanm 0:9b334a45a8ff 836 * and before OPAMP calibration (function
bogdanm 0:9b334a45a8ff 837 * "HAL_OPAMP_SelfCalibrate()").
bogdanm 0:9b334a45a8ff 838 * Otherwise, factory trimming value cannot be retrieved and
bogdanm 0:9b334a45a8ff 839 * error status is returned.
bogdanm 0:9b334a45a8ff 840 * @param hopamp : OPAMP handle
bogdanm 0:9b334a45a8ff 841 * @param trimmingoffset : Trimming offset (P or N)
bogdanm 0:9b334a45a8ff 842 * This parameter must be a value of @ref OPAMP_FactoryTrimming
bogdanm 0:9b334a45a8ff 843 * @note Calibration parameter retrieved is corresponding to the mode
bogdanm 0:9b334a45a8ff 844 * specified in OPAMP init structure (mode normal or low-power).
bogdanm 0:9b334a45a8ff 845 * To retrieve calibration parameters for both modes, repeat this
bogdanm 0:9b334a45a8ff 846 * function after OPAMP init structure accordingly updated.
bogdanm 0:9b334a45a8ff 847 * @retval Trimming value (P or N): range: 0->31
bogdanm 0:9b334a45a8ff 848 * or OPAMP_FACTORYTRIMMING_DUMMY if trimming value is not available
bogdanm 0:9b334a45a8ff 849 *
bogdanm 0:9b334a45a8ff 850 */
bogdanm 0:9b334a45a8ff 851
bogdanm 0:9b334a45a8ff 852 HAL_OPAMP_TrimmingValueTypeDef HAL_OPAMP_GetTrimOffset (OPAMP_HandleTypeDef *hopamp, uint32_t trimmingoffset)
bogdanm 0:9b334a45a8ff 853 {
bogdanm 0:9b334a45a8ff 854 HAL_OPAMP_TrimmingValueTypeDef trimmingvalue;
bogdanm 0:9b334a45a8ff 855 __IO uint32_t* tmp_opamp_reg_trimming; /* Selection of register of trimming depending on power mode: OTR or LPOTR */
bogdanm 0:9b334a45a8ff 856
bogdanm 0:9b334a45a8ff 857 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 858 /* Value can be retrieved in HAL_OPAMP_STATE_READY state */
bogdanm 0:9b334a45a8ff 859 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_RESET) \
bogdanm 0:9b334a45a8ff 860 || (hopamp->State == HAL_OPAMP_STATE_BUSY) \
bogdanm 0:9b334a45a8ff 861 || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)\
bogdanm 0:9b334a45a8ff 862 || (hopamp->State == HAL_OPAMP_STATE_BUSYLOCKED))
bogdanm 0:9b334a45a8ff 863 {
bogdanm 0:9b334a45a8ff 864 return OPAMP_FACTORYTRIMMING_DUMMY;
bogdanm 0:9b334a45a8ff 865 }
bogdanm 0:9b334a45a8ff 866 else
bogdanm 0:9b334a45a8ff 867 {
bogdanm 0:9b334a45a8ff 868 /* Check the parameter */
bogdanm 0:9b334a45a8ff 869 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 870 assert_param(IS_OPAMP_FACTORYTRIMMING(trimmingoffset));
bogdanm 0:9b334a45a8ff 871 assert_param(IS_OPAMP_POWERMODE(hopamp->Init.PowerMode));
bogdanm 0:9b334a45a8ff 872
bogdanm 0:9b334a45a8ff 873 /* Check the trimming mode */
bogdanm 0:9b334a45a8ff 874 if (READ_BIT(hopamp->Instance->CSR,OPAMP_CSR_USERTRIM) != RESET)
bogdanm 0:9b334a45a8ff 875 {
bogdanm 0:9b334a45a8ff 876 /* This function must called when OPAMP init parameter "UserTrimming" */
bogdanm 0:9b334a45a8ff 877 /* is set to trimming factory, and before OPAMP calibration (function */
bogdanm 0:9b334a45a8ff 878 /* "HAL_OPAMP_SelfCalibrate()"). */
bogdanm 0:9b334a45a8ff 879 /* Otherwise, factory trimming value cannot be retrieved and error */
bogdanm 0:9b334a45a8ff 880 /* status is returned. */
bogdanm 0:9b334a45a8ff 881 trimmingvalue = OPAMP_FACTORYTRIMMING_DUMMY;
bogdanm 0:9b334a45a8ff 882 }
bogdanm 0:9b334a45a8ff 883 else
bogdanm 0:9b334a45a8ff 884 {
bogdanm 0:9b334a45a8ff 885 /* Select trimming settings depending on power mode */
bogdanm 0:9b334a45a8ff 886 if (hopamp->Init.PowerMode == OPAMP_POWERMODE_NORMAL)
bogdanm 0:9b334a45a8ff 887 {
bogdanm 0:9b334a45a8ff 888 tmp_opamp_reg_trimming = &OPAMP->OTR;
bogdanm 0:9b334a45a8ff 889 }
bogdanm 0:9b334a45a8ff 890 else
bogdanm 0:9b334a45a8ff 891 {
bogdanm 0:9b334a45a8ff 892 tmp_opamp_reg_trimming = &OPAMP->LPOTR;
bogdanm 0:9b334a45a8ff 893 }
bogdanm 0:9b334a45a8ff 894
bogdanm 0:9b334a45a8ff 895 /* Get factory trimming */
bogdanm 0:9b334a45a8ff 896 if (trimmingoffset == OPAMP_FACTORYTRIMMING_P)
bogdanm 0:9b334a45a8ff 897 {
bogdanm 0:9b334a45a8ff 898 /* OPAMP_FACTORYTRIMMING_P */
bogdanm 0:9b334a45a8ff 899 trimmingvalue = ((*tmp_opamp_reg_trimming) & OPAMP_OTR_TRIMOFFSETP) >> OPAMP_INPUT_NONINVERTING;
bogdanm 0:9b334a45a8ff 900 }
bogdanm 0:9b334a45a8ff 901 else
bogdanm 0:9b334a45a8ff 902 {
bogdanm 0:9b334a45a8ff 903 /* OPAMP_FACTORYTRIMMING_N */
bogdanm 0:9b334a45a8ff 904 trimmingvalue = (*tmp_opamp_reg_trimming) & OPAMP_OTR_TRIMOFFSETN;
bogdanm 0:9b334a45a8ff 905 }
bogdanm 0:9b334a45a8ff 906 }
bogdanm 0:9b334a45a8ff 907 }
bogdanm 0:9b334a45a8ff 908 return trimmingvalue;
bogdanm 0:9b334a45a8ff 909 }
bogdanm 0:9b334a45a8ff 910
bogdanm 0:9b334a45a8ff 911 /**
bogdanm 0:9b334a45a8ff 912 * @}
bogdanm 0:9b334a45a8ff 913 */
bogdanm 0:9b334a45a8ff 914
bogdanm 0:9b334a45a8ff 915
bogdanm 0:9b334a45a8ff 916 /** @defgroup OPAMP_Exported_Functions_Group4 Peripheral State functions
bogdanm 0:9b334a45a8ff 917 * @brief Peripheral State functions
bogdanm 0:9b334a45a8ff 918 *
bogdanm 0:9b334a45a8ff 919 @verbatim
bogdanm 0:9b334a45a8ff 920 ===============================================================================
bogdanm 0:9b334a45a8ff 921 ##### Peripheral State functions #####
bogdanm 0:9b334a45a8ff 922 ===============================================================================
bogdanm 0:9b334a45a8ff 923 [..]
bogdanm 0:9b334a45a8ff 924 This subsection permits to get in run-time the status of the peripheral.
bogdanm 0:9b334a45a8ff 925
bogdanm 0:9b334a45a8ff 926 @endverbatim
bogdanm 0:9b334a45a8ff 927 * @{
bogdanm 0:9b334a45a8ff 928 */
bogdanm 0:9b334a45a8ff 929
bogdanm 0:9b334a45a8ff 930 /**
bogdanm 0:9b334a45a8ff 931 * @brief Return the OPAMP handle state.
bogdanm 0:9b334a45a8ff 932 * @param hopamp : OPAMP handle
bogdanm 0:9b334a45a8ff 933 * @retval HAL state
bogdanm 0:9b334a45a8ff 934 */
bogdanm 0:9b334a45a8ff 935 HAL_OPAMP_StateTypeDef HAL_OPAMP_GetState(OPAMP_HandleTypeDef *hopamp)
bogdanm 0:9b334a45a8ff 936 {
bogdanm 0:9b334a45a8ff 937 /* Check the OPAMP handle allocation */
bogdanm 0:9b334a45a8ff 938 if(hopamp == NULL)
bogdanm 0:9b334a45a8ff 939 {
bogdanm 0:9b334a45a8ff 940 return HAL_OPAMP_STATE_RESET;
bogdanm 0:9b334a45a8ff 941 }
bogdanm 0:9b334a45a8ff 942
bogdanm 0:9b334a45a8ff 943 /* Check the parameter */
bogdanm 0:9b334a45a8ff 944 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
bogdanm 0:9b334a45a8ff 945
bogdanm 0:9b334a45a8ff 946 /* Return OPAMP handle state */
bogdanm 0:9b334a45a8ff 947 return hopamp->State;
bogdanm 0:9b334a45a8ff 948 }
bogdanm 0:9b334a45a8ff 949
bogdanm 0:9b334a45a8ff 950 /**
bogdanm 0:9b334a45a8ff 951 * @}
bogdanm 0:9b334a45a8ff 952 */
bogdanm 0:9b334a45a8ff 953
bogdanm 0:9b334a45a8ff 954 /**
bogdanm 0:9b334a45a8ff 955 * @}
bogdanm 0:9b334a45a8ff 956 */
bogdanm 0:9b334a45a8ff 957
bogdanm 0:9b334a45a8ff 958 /**
bogdanm 0:9b334a45a8ff 959 * @}
bogdanm 0:9b334a45a8ff 960 */
bogdanm 0:9b334a45a8ff 961
bogdanm 0:9b334a45a8ff 962 #endif /* HAL_OPAMP_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 963 /**
bogdanm 0:9b334a45a8ff 964 * @}
bogdanm 0:9b334a45a8ff 965 */
bogdanm 0:9b334a45a8ff 966
bogdanm 0:9b334a45a8ff 967 /**
bogdanm 0:9b334a45a8ff 968 * @}
bogdanm 0:9b334a45a8ff 969 */
bogdanm 0:9b334a45a8ff 970
bogdanm 0:9b334a45a8ff 971 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/