Senior Design: Sound Monitor / STM32L4xx_HAL_Driver

L4 HAL Drivers

Src/stm32l4xx_hal_opamp_ex.c@0:80ee8f3b695e, 2015-11-02 (annotated)

Committer:
EricLew
Date:
Mon Nov 02 19:37:23 2015 +0000
Revision:
0:80ee8f3b695e
Errors are with definitions of LCD and QSPI functions. I believe all .h and .c files are  uploaded, but there may need to be certain functions called.

Who changed what in which revision?

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