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_ex.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_ex.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 Extended 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)(OPAMP1, OPAMP2 etc)
mbed_official 610:813dcc80987e 10 * peripheral:
mbed_official 610:813dcc80987e 11 * + Extended Initialization and de-initialization functions
mbed_official 610:813dcc80987e 12 * + Extended Peripheral Control functions
mbed_official 610:813dcc80987e 13 *
mbed_official 610:813dcc80987e 14 @verbatim
mbed_official 610:813dcc80987e 15 ******************************************************************************
mbed_official 610:813dcc80987e 16 * @attention
mbed_official 610:813dcc80987e 17 *
mbed_official 610:813dcc80987e 18 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 610:813dcc80987e 19 *
mbed_official 610:813dcc80987e 20 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 610:813dcc80987e 21 * are permitted provided that the following conditions are met:
mbed_official 610:813dcc80987e 22 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 610:813dcc80987e 23 * this list of conditions and the following disclaimer.
mbed_official 610:813dcc80987e 24 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 610:813dcc80987e 25 * this list of conditions and the following disclaimer in the documentation
mbed_official 610:813dcc80987e 26 * and/or other materials provided with the distribution.
mbed_official 610:813dcc80987e 27 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 610:813dcc80987e 28 * may be used to endorse or promote products derived from this software
mbed_official 610:813dcc80987e 29 * without specific prior written permission.
mbed_official 610:813dcc80987e 30 *
mbed_official 610:813dcc80987e 31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 610:813dcc80987e 32 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 610:813dcc80987e 33 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 610:813dcc80987e 34 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 610:813dcc80987e 35 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 610:813dcc80987e 36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 610:813dcc80987e 37 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 610:813dcc80987e 38 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 610:813dcc80987e 39 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 610:813dcc80987e 40 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 610:813dcc80987e 41 *
mbed_official 610:813dcc80987e 42 ******************************************************************************
mbed_official 610:813dcc80987e 43 */
mbed_official 610:813dcc80987e 44
mbed_official 610:813dcc80987e 45 /* Includes ------------------------------------------------------------------*/
mbed_official 610:813dcc80987e 46 #include "stm32l4xx_hal.h"
mbed_official 610:813dcc80987e 47
mbed_official 610:813dcc80987e 48 /** @addtogroup STM32L4xx_HAL_Driver
mbed_official 610:813dcc80987e 49 * @{
mbed_official 610:813dcc80987e 50 */
mbed_official 610:813dcc80987e 51
mbed_official 610:813dcc80987e 52 /** @defgroup OPAMPEx OPAMPEx
mbed_official 610:813dcc80987e 53 * @brief OPAMP Extended HAL module driver
mbed_official 610:813dcc80987e 54 * @{
mbed_official 610:813dcc80987e 55 */
mbed_official 610:813dcc80987e 56
mbed_official 610:813dcc80987e 57 #ifdef HAL_OPAMP_MODULE_ENABLED
mbed_official 610:813dcc80987e 58
mbed_official 610:813dcc80987e 59 /* Private typedef -----------------------------------------------------------*/
mbed_official 610:813dcc80987e 60 /* Private define ------------------------------------------------------------*/
mbed_official 610:813dcc80987e 61 /* Private macro -------------------------------------------------------------*/
mbed_official 610:813dcc80987e 62 /* Private variables ---------------------------------------------------------*/
mbed_official 610:813dcc80987e 63 /* Private function prototypes -----------------------------------------------*/
mbed_official 610:813dcc80987e 64 /* Exported functions --------------------------------------------------------*/
mbed_official 610:813dcc80987e 65
mbed_official 610:813dcc80987e 66 /** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions
mbed_official 610:813dcc80987e 67 * @{
mbed_official 610:813dcc80987e 68 */
mbed_official 610:813dcc80987e 69
mbed_official 610:813dcc80987e 70 /** @addtogroup OPAMPEx_Exported_Functions_Group1
mbed_official 610:813dcc80987e 71 * @brief Extended operation functions
mbed_official 610:813dcc80987e 72 *
mbed_official 610:813dcc80987e 73 @verbatim
mbed_official 610:813dcc80987e 74 ===============================================================================
mbed_official 610:813dcc80987e 75 ##### Extended IO operation functions #####
mbed_official 610:813dcc80987e 76 ===============================================================================
mbed_official 610:813dcc80987e 77 [..]
mbed_official 610:813dcc80987e 78 (+) OPAMP Self calibration.
mbed_official 610:813dcc80987e 79
mbed_official 610:813dcc80987e 80 @endverbatim
mbed_official 610:813dcc80987e 81 * @{
mbed_official 610:813dcc80987e 82 */
mbed_official 610:813dcc80987e 83
mbed_official 610:813dcc80987e 84 /* 2 OPAMPS available */
mbed_official 610:813dcc80987e 85 /* 2 OPAMPS can be calibrated in parallel */
mbed_official 610:813dcc80987e 86
mbed_official 610:813dcc80987e 87 /**
mbed_official 610:813dcc80987e 88 * @brief Run the self calibration of the 2 OPAMPs in parallel.
mbed_official 610:813dcc80987e 89 * @note Trimming values (PMOS & NMOS) are updated and user trimming is
mbed_official 610:813dcc80987e 90 * enabled is calibration is successful.
mbed_official 610:813dcc80987e 91 * @note Calibration is performed in the mode specified in OPAMP init
mbed_official 610:813dcc80987e 92 * structure (mode normal or low-power). To perform calibration for
mbed_official 610:813dcc80987e 93 * both modes, repeat this function twice after OPAMP init structure
mbed_official 610:813dcc80987e 94 * accordingly updated.
mbed_official 610:813dcc80987e 95 * @note Calibration runs about 10 ms (5 dichotomy steps, repeated for P
mbed_official 610:813dcc80987e 96 * and N transistors: 10 steps with 1 ms for each step).
mbed_official 610:813dcc80987e 97 * @param hopamp1 handle
mbed_official 610:813dcc80987e 98 * @param hopamp2 handle
mbed_official 610:813dcc80987e 99 * @retval HAL status
mbed_official 610:813dcc80987e 100 */
mbed_official 610:813dcc80987e 101
mbed_official 610:813dcc80987e 102 HAL_StatusTypeDef HAL_OPAMPEx_SelfCalibrateAll(OPAMP_HandleTypeDef *hopamp1, OPAMP_HandleTypeDef *hopamp2)
mbed_official 610:813dcc80987e 103 {
mbed_official 610:813dcc80987e 104 HAL_StatusTypeDef status = HAL_OK;
mbed_official 610:813dcc80987e 105
mbed_official 610:813dcc80987e 106 uint32_t trimmingvaluen1 = 0;
mbed_official 610:813dcc80987e 107 uint32_t trimmingvaluep1 = 0;
mbed_official 610:813dcc80987e 108 uint32_t trimmingvaluen2 = 0;
mbed_official 610:813dcc80987e 109 uint32_t trimmingvaluep2 = 0;
mbed_official 610:813dcc80987e 110
mbed_official 610:813dcc80987e 111 /* Selection of register of trimming depending on power mode: OTR or LPOTR */
mbed_official 610:813dcc80987e 112 __IO uint32_t* tmp_opamp1_reg_trimming;
mbed_official 610:813dcc80987e 113 __IO uint32_t* tmp_opamp2_reg_trimming;
mbed_official 610:813dcc80987e 114
mbed_official 610:813dcc80987e 115 uint32_t delta;
mbed_official 610:813dcc80987e 116
mbed_official 610:813dcc80987e 117 if((hopamp1 == NULL) || (hopamp1->State == HAL_OPAMP_STATE_BUSYLOCKED) || \
mbed_official 610:813dcc80987e 118 (hopamp2 == NULL) || (hopamp2->State == HAL_OPAMP_STATE_BUSYLOCKED))
mbed_official 610:813dcc80987e 119 {
mbed_official 610:813dcc80987e 120 status = HAL_ERROR;
mbed_official 610:813dcc80987e 121 }
mbed_official 610:813dcc80987e 122 else
mbed_official 610:813dcc80987e 123 {
mbed_official 610:813dcc80987e 124 /* Check if OPAMP in calibration mode and calibration not yet enable */
mbed_official 610:813dcc80987e 125 if((hopamp1->State == HAL_OPAMP_STATE_READY) && (hopamp2->State == HAL_OPAMP_STATE_READY))
mbed_official 610:813dcc80987e 126 {
mbed_official 610:813dcc80987e 127 /* Check the parameter */
mbed_official 610:813dcc80987e 128 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp1->Instance));
mbed_official 610:813dcc80987e 129 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp2->Instance));
mbed_official 610:813dcc80987e 130
mbed_official 610:813dcc80987e 131 assert_param(IS_OPAMP_POWERMODE(hopamp1->Init.PowerMode));
mbed_official 610:813dcc80987e 132 assert_param(IS_OPAMP_POWERMODE(hopamp2->Init.PowerMode));
mbed_official 610:813dcc80987e 133
mbed_official 610:813dcc80987e 134 /* user trimming values are used for offset calibration */
mbed_official 610:813dcc80987e 135 SET_BIT(hopamp1->Instance->CSR, OPAMP_CSR_USERTRIM);
mbed_official 610:813dcc80987e 136 SET_BIT(hopamp2->Instance->CSR, OPAMP_CSR_USERTRIM);
mbed_official 610:813dcc80987e 137
mbed_official 610:813dcc80987e 138 /* Select trimming settings depending on power mode */
mbed_official 610:813dcc80987e 139 if (hopamp1->Init.PowerMode == OPAMP_POWERMODE_NORMAL)
mbed_official 610:813dcc80987e 140 {
mbed_official 610:813dcc80987e 141 tmp_opamp1_reg_trimming = &OPAMP1->OTR;
mbed_official 610:813dcc80987e 142 }
mbed_official 610:813dcc80987e 143 else
mbed_official 610:813dcc80987e 144 {
mbed_official 610:813dcc80987e 145 tmp_opamp1_reg_trimming = &OPAMP1->LPOTR;
mbed_official 610:813dcc80987e 146 }
mbed_official 610:813dcc80987e 147
mbed_official 610:813dcc80987e 148 if (hopamp2->Init.PowerMode == OPAMP_POWERMODE_NORMAL)
mbed_official 610:813dcc80987e 149 {
mbed_official 610:813dcc80987e 150 tmp_opamp2_reg_trimming = &OPAMP2->OTR;
mbed_official 610:813dcc80987e 151 }
mbed_official 610:813dcc80987e 152 else
mbed_official 610:813dcc80987e 153 {
mbed_official 610:813dcc80987e 154 tmp_opamp2_reg_trimming = &OPAMP2->LPOTR;
mbed_official 610:813dcc80987e 155 }
mbed_official 610:813dcc80987e 156
mbed_official 610:813dcc80987e 157 /* Enable calibration */
mbed_official 610:813dcc80987e 158 SET_BIT (hopamp1->Instance->CSR, OPAMP_CSR_CALON);
mbed_official 610:813dcc80987e 159 SET_BIT (hopamp2->Instance->CSR, OPAMP_CSR_CALON);
mbed_official 610:813dcc80987e 160
mbed_official 610:813dcc80987e 161 /* 1st calibration - N */
mbed_official 610:813dcc80987e 162 CLEAR_BIT (hopamp1->Instance->CSR, OPAMP_CSR_CALSEL);
mbed_official 610:813dcc80987e 163 CLEAR_BIT (hopamp2->Instance->CSR, OPAMP_CSR_CALSEL);
mbed_official 610:813dcc80987e 164
mbed_official 610:813dcc80987e 165 /* Enable the selected opamp */
mbed_official 610:813dcc80987e 166 SET_BIT (hopamp1->Instance->CSR, OPAMP_CSR_OPAMPxEN);
mbed_official 610:813dcc80987e 167 SET_BIT (hopamp2->Instance->CSR, OPAMP_CSR_OPAMPxEN);
mbed_official 610:813dcc80987e 168
mbed_official 610:813dcc80987e 169 /* Init trimming counter */
mbed_official 610:813dcc80987e 170 /* Medium value */
mbed_official 610:813dcc80987e 171 trimmingvaluen1 = 16;
mbed_official 610:813dcc80987e 172 trimmingvaluen2 = 16;
mbed_official 610:813dcc80987e 173 delta = 8;
mbed_official 610:813dcc80987e 174
mbed_official 610:813dcc80987e 175 while (delta != 0)
mbed_official 610:813dcc80987e 176 {
mbed_official 610:813dcc80987e 177 /* Set candidate trimming */
mbed_official 610:813dcc80987e 178 /* OPAMP_POWERMODE_NORMAL */
mbed_official 610:813dcc80987e 179 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen1);
mbed_official 610:813dcc80987e 180 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen2);
mbed_official 610:813dcc80987e 181
mbed_official 610:813dcc80987e 182 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
mbed_official 610:813dcc80987e 183 /* Offset trim time: during calibration, minimum time needed between */
mbed_official 610:813dcc80987e 184 /* two steps to have 1 mV accuracy */
mbed_official 610:813dcc80987e 185 HAL_Delay(OPAMP_TRIMMING_DELAY);
mbed_official 610:813dcc80987e 186
mbed_official 610:813dcc80987e 187 if (READ_BIT(hopamp1->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 188 {
mbed_official 610:813dcc80987e 189 /* OPAMP_CSR_CALOUT is HIGH try lower trimming */
mbed_official 610:813dcc80987e 190 trimmingvaluen1 -= delta;
mbed_official 610:813dcc80987e 191 }
mbed_official 610:813dcc80987e 192 else
mbed_official 610:813dcc80987e 193 {
mbed_official 610:813dcc80987e 194 /* OPAMP_CSR_CALOUT is LOW try higher trimming */
mbed_official 610:813dcc80987e 195 trimmingvaluen1 += delta;
mbed_official 610:813dcc80987e 196 }
mbed_official 610:813dcc80987e 197
mbed_official 610:813dcc80987e 198 if (READ_BIT(hopamp2->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 199 {
mbed_official 610:813dcc80987e 200 /* OPAMP_CSR_CALOUT is HIGH try lower trimming */
mbed_official 610:813dcc80987e 201 trimmingvaluen2 -= delta;
mbed_official 610:813dcc80987e 202 }
mbed_official 610:813dcc80987e 203 else
mbed_official 610:813dcc80987e 204 {
mbed_official 610:813dcc80987e 205 /* OPAMP_CSR_CALOUT is LOW try higher trimming */
mbed_official 610:813dcc80987e 206 trimmingvaluen2 += delta;
mbed_official 610:813dcc80987e 207 }
mbed_official 610:813dcc80987e 208 /* Divide range by 2 to continue dichotomy sweep */
mbed_official 610:813dcc80987e 209 delta >>= 1;
mbed_official 610:813dcc80987e 210 }
mbed_official 610:813dcc80987e 211
mbed_official 610:813dcc80987e 212 /* Still need to check if right calibration is current value or one step below */
mbed_official 610:813dcc80987e 213 /* Indeed the first value that causes the OUTCAL bit to change from 0 to 1 */
mbed_official 610:813dcc80987e 214 /* Set candidate trimming */
mbed_official 610:813dcc80987e 215 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen1);
mbed_official 610:813dcc80987e 216 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen2);
mbed_official 610:813dcc80987e 217
mbed_official 610:813dcc80987e 218 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
mbed_official 610:813dcc80987e 219 /* Offset trim time: during calibration, minimum time needed between */
mbed_official 610:813dcc80987e 220 /* two steps to have 1 mV accuracy */
mbed_official 610:813dcc80987e 221 HAL_Delay(OPAMP_TRIMMING_DELAY);
mbed_official 610:813dcc80987e 222
mbed_official 610:813dcc80987e 223 if ((READ_BIT(hopamp1->Instance->CSR, OPAMP_CSR_CALOUT)) == 0)
mbed_official 610:813dcc80987e 224 {
mbed_official 610:813dcc80987e 225 /* Trimming value is actually one value more */
mbed_official 610:813dcc80987e 226 trimmingvaluen1++;
mbed_official 610:813dcc80987e 227 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen1);
mbed_official 610:813dcc80987e 228 }
mbed_official 610:813dcc80987e 229
mbed_official 610:813dcc80987e 230 if ((READ_BIT(hopamp2->Instance->CSR, OPAMP_CSR_CALOUT)) == 0)
mbed_official 610:813dcc80987e 231 {
mbed_official 610:813dcc80987e 232 /* Trimming value is actually one value more */
mbed_official 610:813dcc80987e 233 trimmingvaluen2++;
mbed_official 610:813dcc80987e 234 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETN, trimmingvaluen2);
mbed_official 610:813dcc80987e 235 }
mbed_official 610:813dcc80987e 236
mbed_official 610:813dcc80987e 237 /* 2nd calibration - P */
mbed_official 610:813dcc80987e 238 SET_BIT (hopamp1->Instance->CSR, OPAMP_CSR_CALSEL);
mbed_official 610:813dcc80987e 239 SET_BIT (hopamp2->Instance->CSR, OPAMP_CSR_CALSEL);
mbed_official 610:813dcc80987e 240
mbed_official 610:813dcc80987e 241 /* Init trimming counter */
mbed_official 610:813dcc80987e 242 /* Medium value */
mbed_official 610:813dcc80987e 243 trimmingvaluep1 = 16;
mbed_official 610:813dcc80987e 244 trimmingvaluep2 = 16;
mbed_official 610:813dcc80987e 245 delta = 8;
mbed_official 610:813dcc80987e 246
mbed_official 610:813dcc80987e 247 while (delta != 0)
mbed_official 610:813dcc80987e 248 {
mbed_official 610:813dcc80987e 249 /* Set candidate trimming */
mbed_official 610:813dcc80987e 250 /* OPAMP_POWERMODE_NORMAL */
mbed_official 610:813dcc80987e 251 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep1<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 252 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep2<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 253
mbed_official 610:813dcc80987e 254 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
mbed_official 610:813dcc80987e 255 /* Offset trim time: during calibration, minimum time needed between */
mbed_official 610:813dcc80987e 256 /* two steps to have 1 mV accuracy */
mbed_official 610:813dcc80987e 257 HAL_Delay(OPAMP_TRIMMING_DELAY);
mbed_official 610:813dcc80987e 258
mbed_official 610:813dcc80987e 259 if (READ_BIT(hopamp1->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 260 {
mbed_official 610:813dcc80987e 261 /* OPAMP_CSR_CALOUT is HIGH try higher trimming */
mbed_official 610:813dcc80987e 262 trimmingvaluep1 += delta;
mbed_official 610:813dcc80987e 263 }
mbed_official 610:813dcc80987e 264 else
mbed_official 610:813dcc80987e 265 {
mbed_official 610:813dcc80987e 266 /* OPAMP_CSR_CALOUT is HIGH try lower trimming */
mbed_official 610:813dcc80987e 267 trimmingvaluep1 -= delta;
mbed_official 610:813dcc80987e 268 }
mbed_official 610:813dcc80987e 269
mbed_official 610:813dcc80987e 270 if (READ_BIT(hopamp2->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 271 {
mbed_official 610:813dcc80987e 272 /* OPAMP_CSR_CALOUT is HIGH try higher trimming */
mbed_official 610:813dcc80987e 273 trimmingvaluep2 += delta;
mbed_official 610:813dcc80987e 274 }
mbed_official 610:813dcc80987e 275 else
mbed_official 610:813dcc80987e 276 {
mbed_official 610:813dcc80987e 277 /* OPAMP_CSR_CALOUT is LOW try lower trimming */
mbed_official 610:813dcc80987e 278 trimmingvaluep2 -= delta;
mbed_official 610:813dcc80987e 279 }
mbed_official 610:813dcc80987e 280 /* Divide range by 2 to continue dichotomy sweep */
mbed_official 610:813dcc80987e 281 delta >>= 1;
mbed_official 610:813dcc80987e 282 }
mbed_official 610:813dcc80987e 283
mbed_official 610:813dcc80987e 284 /* Still need to check if right calibration is current value or one step below */
mbed_official 610:813dcc80987e 285 /* Indeed the first value that causes the OUTCAL bit to change from 1 to 0 */
mbed_official 610:813dcc80987e 286 /* Set candidate trimming */
mbed_official 610:813dcc80987e 287 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep1<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 288 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep2<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 289
mbed_official 610:813dcc80987e 290 /* OFFTRIMmax delay 1 ms as per datasheet (electrical characteristics */
mbed_official 610:813dcc80987e 291 /* Offset trim time: during calibration, minimum time needed between */
mbed_official 610:813dcc80987e 292 /* two steps to have 1 mV accuracy */
mbed_official 610:813dcc80987e 293 HAL_Delay(OPAMP_TRIMMING_DELAY);
mbed_official 610:813dcc80987e 294
mbed_official 610:813dcc80987e 295 if (READ_BIT(hopamp1->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 296 {
mbed_official 610:813dcc80987e 297 /* Trimming value is actually one value more */
mbed_official 610:813dcc80987e 298 trimmingvaluep1++;
mbed_official 610:813dcc80987e 299 MODIFY_REG(*tmp_opamp1_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep1<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 300 }
mbed_official 610:813dcc80987e 301
mbed_official 610:813dcc80987e 302 if (READ_BIT(hopamp2->Instance->CSR, OPAMP_CSR_CALOUT) != RESET)
mbed_official 610:813dcc80987e 303 {
mbed_official 610:813dcc80987e 304 /* Trimming value is actually one value more */
mbed_official 610:813dcc80987e 305 trimmingvaluep2++;
mbed_official 610:813dcc80987e 306 MODIFY_REG(*tmp_opamp2_reg_trimming, OPAMP_OTR_TRIMOFFSETP, (trimmingvaluep2<<OPAMP_INPUT_NONINVERTING));
mbed_official 610:813dcc80987e 307 }
mbed_official 610:813dcc80987e 308
mbed_official 610:813dcc80987e 309 /* Disable the OPAMPs */
mbed_official 610:813dcc80987e 310 CLEAR_BIT (hopamp1->Instance->CSR, OPAMP_CSR_OPAMPxEN);
mbed_official 610:813dcc80987e 311 CLEAR_BIT (hopamp2->Instance->CSR, OPAMP_CSR_OPAMPxEN);
mbed_official 610:813dcc80987e 312
mbed_official 610:813dcc80987e 313 /* Disable calibration & set normal mode (operating mode) */
mbed_official 610:813dcc80987e 314 CLEAR_BIT (hopamp1->Instance->CSR, OPAMP_CSR_CALON);
mbed_official 610:813dcc80987e 315 CLEAR_BIT (hopamp2->Instance->CSR, OPAMP_CSR_CALON);
mbed_official 610:813dcc80987e 316
mbed_official 610:813dcc80987e 317 /* Self calibration is successful */
mbed_official 610:813dcc80987e 318 /* Store calibration (user trimming) results in init structure. */
mbed_official 610:813dcc80987e 319
mbed_official 610:813dcc80987e 320 /* Set user trimming mode */
mbed_official 610:813dcc80987e 321 hopamp1->Init.UserTrimming = OPAMP_TRIMMING_USER;
mbed_official 610:813dcc80987e 322 hopamp2->Init.UserTrimming = OPAMP_TRIMMING_USER;
mbed_official 610:813dcc80987e 323
mbed_official 610:813dcc80987e 324 /* Affect calibration parameters depending on mode normal/low power */
mbed_official 610:813dcc80987e 325 if (hopamp1->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)
mbed_official 610:813dcc80987e 326 {
mbed_official 610:813dcc80987e 327 /* Write calibration result N */
mbed_official 610:813dcc80987e 328 hopamp1->Init.TrimmingValueN = trimmingvaluen1;
mbed_official 610:813dcc80987e 329 /* Write calibration result P */
mbed_official 610:813dcc80987e 330 hopamp1->Init.TrimmingValueP = trimmingvaluep1;
mbed_official 610:813dcc80987e 331 }
mbed_official 610:813dcc80987e 332 else
mbed_official 610:813dcc80987e 333 {
mbed_official 610:813dcc80987e 334 /* Write calibration result N */
mbed_official 610:813dcc80987e 335 hopamp1->Init.TrimmingValueNLowPower = trimmingvaluen1;
mbed_official 610:813dcc80987e 336 /* Write calibration result P */
mbed_official 610:813dcc80987e 337 hopamp1->Init.TrimmingValuePLowPower = trimmingvaluep1;
mbed_official 610:813dcc80987e 338 }
mbed_official 610:813dcc80987e 339
mbed_official 610:813dcc80987e 340 if (hopamp2->Init.PowerMode != OPAMP_POWERMODE_LOWPOWER)
mbed_official 610:813dcc80987e 341 {
mbed_official 610:813dcc80987e 342 /* Write calibration result N */
mbed_official 610:813dcc80987e 343 hopamp2->Init.TrimmingValueN = trimmingvaluen2;
mbed_official 610:813dcc80987e 344 /* Write calibration result P */
mbed_official 610:813dcc80987e 345 hopamp2->Init.TrimmingValueP = trimmingvaluep2;
mbed_official 610:813dcc80987e 346 }
mbed_official 610:813dcc80987e 347 else
mbed_official 610:813dcc80987e 348 {
mbed_official 610:813dcc80987e 349 /* Write calibration result N */
mbed_official 610:813dcc80987e 350 hopamp2->Init.TrimmingValueNLowPower = trimmingvaluen2;
mbed_official 610:813dcc80987e 351 /* Write calibration result P */
mbed_official 610:813dcc80987e 352 hopamp2->Init.TrimmingValuePLowPower = trimmingvaluep2;
mbed_official 610:813dcc80987e 353 }
mbed_official 610:813dcc80987e 354
mbed_official 610:813dcc80987e 355 /* Update OPAMP state */
mbed_official 610:813dcc80987e 356 hopamp1->State = HAL_OPAMP_STATE_READY;
mbed_official 610:813dcc80987e 357 hopamp2->State = HAL_OPAMP_STATE_READY;
mbed_official 610:813dcc80987e 358
mbed_official 610:813dcc80987e 359 }
mbed_official 610:813dcc80987e 360
mbed_official 610:813dcc80987e 361 else
mbed_official 610:813dcc80987e 362 {
mbed_official 610:813dcc80987e 363 /* At least one OPAMP can not be calibrated */
mbed_official 610:813dcc80987e 364 status = HAL_ERROR;
mbed_official 610:813dcc80987e 365 }
mbed_official 610:813dcc80987e 366 }
mbed_official 610:813dcc80987e 367 return status;
mbed_official 610:813dcc80987e 368 }
mbed_official 610:813dcc80987e 369
mbed_official 610:813dcc80987e 370 /**
mbed_official 610:813dcc80987e 371 * @}
mbed_official 610:813dcc80987e 372 */
mbed_official 610:813dcc80987e 373
mbed_official 610:813dcc80987e 374 /** @defgroup OPAMPEx_Exported_Functions_Group2 Peripheral Control functions
mbed_official 610:813dcc80987e 375 * @brief Peripheral Control functions
mbed_official 610:813dcc80987e 376 *
mbed_official 610:813dcc80987e 377 @verbatim
mbed_official 610:813dcc80987e 378 ===============================================================================
mbed_official 610:813dcc80987e 379 ##### Peripheral Control functions #####
mbed_official 610:813dcc80987e 380 ===============================================================================
mbed_official 610:813dcc80987e 381 [..]
mbed_official 610:813dcc80987e 382 (+) OPAMP unlock.
mbed_official 610:813dcc80987e 383
mbed_official 610:813dcc80987e 384 @endverbatim
mbed_official 610:813dcc80987e 385 * @{
mbed_official 610:813dcc80987e 386 */
mbed_official 610:813dcc80987e 387
mbed_official 610:813dcc80987e 388 /**
mbed_official 610:813dcc80987e 389 * @brief Unlock the selected OPAMP configuration.
mbed_official 610:813dcc80987e 390 * @note This function must be called only when OPAMP is in state "locked".
mbed_official 610:813dcc80987e 391 * @param hopamp: OPAMP handle
mbed_official 610:813dcc80987e 392 * @retval HAL status
mbed_official 610:813dcc80987e 393 */
mbed_official 610:813dcc80987e 394 HAL_StatusTypeDef HAL_OPAMPEx_Unlock(OPAMP_HandleTypeDef* hopamp)
mbed_official 610:813dcc80987e 395 {
mbed_official 610:813dcc80987e 396 HAL_StatusTypeDef status = HAL_OK;
mbed_official 610:813dcc80987e 397
mbed_official 610:813dcc80987e 398 /* Check the OPAMP handle allocation */
mbed_official 610:813dcc80987e 399 /* Check if OPAMP locked */
mbed_official 610:813dcc80987e 400 if((hopamp == NULL) || (hopamp->State == HAL_OPAMP_STATE_RESET)
mbed_official 610:813dcc80987e 401 || (hopamp->State == HAL_OPAMP_STATE_READY)
mbed_official 610:813dcc80987e 402 || (hopamp->State == HAL_OPAMP_STATE_CALIBBUSY)
mbed_official 610:813dcc80987e 403 || (hopamp->State == HAL_OPAMP_STATE_BUSY))
mbed_official 610:813dcc80987e 404
mbed_official 610:813dcc80987e 405 {
mbed_official 610:813dcc80987e 406 status = HAL_ERROR;
mbed_official 610:813dcc80987e 407 }
mbed_official 610:813dcc80987e 408 else
mbed_official 610:813dcc80987e 409 {
mbed_official 610:813dcc80987e 410 /* Check the parameter */
mbed_official 610:813dcc80987e 411 assert_param(IS_OPAMP_ALL_INSTANCE(hopamp->Instance));
mbed_official 610:813dcc80987e 412
mbed_official 610:813dcc80987e 413 /* OPAMP state changed to locked */
mbed_official 610:813dcc80987e 414 hopamp->State = HAL_OPAMP_STATE_BUSY;
mbed_official 610:813dcc80987e 415 }
mbed_official 610:813dcc80987e 416 return status;
mbed_official 610:813dcc80987e 417 }
mbed_official 610:813dcc80987e 418
mbed_official 610:813dcc80987e 419 /**
mbed_official 610:813dcc80987e 420 * @}
mbed_official 610:813dcc80987e 421 */
mbed_official 610:813dcc80987e 422
mbed_official 610:813dcc80987e 423 /**
mbed_official 610:813dcc80987e 424 * @}
mbed_official 610:813dcc80987e 425 */
mbed_official 610:813dcc80987e 426
mbed_official 610:813dcc80987e 427 #endif /* HAL_OPAMP_MODULE_ENABLED */
mbed_official 610:813dcc80987e 428 /**
mbed_official 610:813dcc80987e 429 * @}
mbed_official 610:813dcc80987e 430 */
mbed_official 610:813dcc80987e 431
mbed_official 610:813dcc80987e 432 /**
mbed_official 610:813dcc80987e 433 * @}
mbed_official 610:813dcc80987e 434 */
mbed_official 610:813dcc80987e 435
mbed_official 610:813dcc80987e 436 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/