mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_opamp.c@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

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