mbed official / mbed

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

Committer:
Anna Bridge
Date:
Fri Jun 22 15:38:59 2018 +0100
Revision:
169:a7c7b631e539
Parent:
168:b9e159c1930a
mbed library. Release version 162

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 156:ff21514d8981 1 /**
AnnaBridge 156:ff21514d8981 2 ******************************************************************************
AnnaBridge 156:ff21514d8981 3 * @file stm32f3xx_hal_opamp.h
AnnaBridge 156:ff21514d8981 4 * @author MCD Application Team
AnnaBridge 156:ff21514d8981 5 * @brief Header file of OPAMP HAL module.
AnnaBridge 156:ff21514d8981 6 ******************************************************************************
AnnaBridge 156:ff21514d8981 7 * @attention
AnnaBridge 156:ff21514d8981 8 *
AnnaBridge 156:ff21514d8981 9 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 156:ff21514d8981 10 *
AnnaBridge 156:ff21514d8981 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 156:ff21514d8981 12 * are permitted provided that the following conditions are met:
AnnaBridge 156:ff21514d8981 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 156:ff21514d8981 14 * this list of conditions and the following disclaimer.
AnnaBridge 156:ff21514d8981 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 156:ff21514d8981 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 156:ff21514d8981 17 * and/or other materials provided with the distribution.
AnnaBridge 156:ff21514d8981 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 156:ff21514d8981 19 * may be used to endorse or promote products derived from this software
AnnaBridge 156:ff21514d8981 20 * without specific prior written permission.
AnnaBridge 156:ff21514d8981 21 *
AnnaBridge 156:ff21514d8981 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 156:ff21514d8981 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 156:ff21514d8981 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 156:ff21514d8981 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 156:ff21514d8981 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 156:ff21514d8981 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 156:ff21514d8981 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 156:ff21514d8981 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 156:ff21514d8981 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 156:ff21514d8981 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 156:ff21514d8981 32 *
AnnaBridge 156:ff21514d8981 33 ******************************************************************************
AnnaBridge 156:ff21514d8981 34 */
AnnaBridge 156:ff21514d8981 35
AnnaBridge 156:ff21514d8981 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 156:ff21514d8981 37 #ifndef __STM32F3xx_HAL_OPAMP_H
AnnaBridge 156:ff21514d8981 38 #define __STM32F3xx_HAL_OPAMP_H
AnnaBridge 156:ff21514d8981 39
AnnaBridge 156:ff21514d8981 40 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 41 extern "C" {
AnnaBridge 156:ff21514d8981 42 #endif
AnnaBridge 156:ff21514d8981 43
AnnaBridge 156:ff21514d8981 44 #if defined(STM32F302xE) || defined(STM32F303xE) || defined(STM32F398xx) || \
AnnaBridge 156:ff21514d8981 45 defined(STM32F302xC) || defined(STM32F303xC) || defined(STM32F358xx) || \
AnnaBridge 156:ff21514d8981 46 defined(STM32F303x8) || defined(STM32F334x8) || defined(STM32F328xx) || \
AnnaBridge 156:ff21514d8981 47 defined(STM32F301x8) || defined(STM32F302x8) || defined(STM32F318xx)
AnnaBridge 156:ff21514d8981 48
AnnaBridge 156:ff21514d8981 49 /* Includes ------------------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 50 #include "stm32f3xx_hal_def.h"
AnnaBridge 156:ff21514d8981 51
AnnaBridge 156:ff21514d8981 52 /** @addtogroup STM32F3xx_HAL_Driver
AnnaBridge 156:ff21514d8981 53 * @{
AnnaBridge 156:ff21514d8981 54 */
AnnaBridge 156:ff21514d8981 55
AnnaBridge 156:ff21514d8981 56 /** @addtogroup OPAMP
AnnaBridge 156:ff21514d8981 57 * @{
AnnaBridge 156:ff21514d8981 58 */
AnnaBridge 156:ff21514d8981 59
AnnaBridge 156:ff21514d8981 60 /* Exported types ------------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 61 /** @defgroup OPAMP_Exported_Types OPAMP Exported Types
AnnaBridge 156:ff21514d8981 62 * @{
AnnaBridge 156:ff21514d8981 63 */
AnnaBridge 156:ff21514d8981 64
AnnaBridge 156:ff21514d8981 65 /**
AnnaBridge 156:ff21514d8981 66 * @brief OPAMP Init structure definition
AnnaBridge 156:ff21514d8981 67 */
AnnaBridge 156:ff21514d8981 68
AnnaBridge 156:ff21514d8981 69 typedef struct
AnnaBridge 156:ff21514d8981 70 {
AnnaBridge 156:ff21514d8981 71 uint32_t Mode; /*!< Specifies the OPAMP mode
AnnaBridge 156:ff21514d8981 72 This parameter must be a value of @ref OPAMP_Mode
AnnaBridge 156:ff21514d8981 73 mode is either Standalone, - Follower or PGA */
AnnaBridge 156:ff21514d8981 74
AnnaBridge 156:ff21514d8981 75 uint32_t InvertingInput; /*!< Specifies the inverting input in Standalone & Pga modes
AnnaBridge 156:ff21514d8981 76 - In Standalone mode: i.e when mode is OPAMP_STANDALONE_MODE
AnnaBridge 156:ff21514d8981 77 This parameter must be a value of @ref OPAMP_InvertingInput
AnnaBridge 156:ff21514d8981 78 InvertingInput is either VM0 or VM1
AnnaBridge 156:ff21514d8981 79 - In PGA mode: i.e when mode is OPAMP_PGA_MODE
AnnaBridge 156:ff21514d8981 80 & in Follower mode i.e when mode is OPAMP_FOLLOWER_MODE
AnnaBridge 156:ff21514d8981 81 This parameter is Not Applicable */
AnnaBridge 156:ff21514d8981 82
AnnaBridge 156:ff21514d8981 83 uint32_t NonInvertingInput; /*!< Specifies the non inverting input of the opamp:
AnnaBridge 156:ff21514d8981 84 This parameter must be a value of @ref OPAMP_NonInvertingInput
AnnaBridge 156:ff21514d8981 85 NonInvertingInput is either VP0, VP1, VP2 or VP3 */
AnnaBridge 156:ff21514d8981 86
AnnaBridge 156:ff21514d8981 87 uint32_t TimerControlledMuxmode; /*!< Specifies if the Timer controlled Mux mode is enabled or disabled
AnnaBridge 156:ff21514d8981 88 This parameter must be a value of @ref OPAMP_TimerControlledMuxmode */
AnnaBridge 156:ff21514d8981 89
AnnaBridge 156:ff21514d8981 90 uint32_t InvertingInputSecondary; /*!< Specifies the inverting input (secondary) of the opamp when
AnnaBridge 156:ff21514d8981 91 TimerControlledMuxmode is enabled
AnnaBridge 156:ff21514d8981 92 i.e. when TimerControlledMuxmode is OPAMP_TIMERCONTROLLEDMUXMODE_ENABLE
AnnaBridge 156:ff21514d8981 93 - In Standalone mode: i.e when mode is OPAMP_STANDALONE_MODE
AnnaBridge 156:ff21514d8981 94 This parameter must be a value of @ref OPAMP_InvertingInputSecondary
AnnaBridge 156:ff21514d8981 95 InvertingInputSecondary is either VM0 or VM1
AnnaBridge 156:ff21514d8981 96 - In PGA mode: i.e when mode is OPAMP_PGA_MODE
AnnaBridge 156:ff21514d8981 97 & in Follower mode i.e when mode is OPAMP_FOLLOWER_MODE
AnnaBridge 156:ff21514d8981 98 This parameter is Not Applicable */
AnnaBridge 156:ff21514d8981 99
AnnaBridge 156:ff21514d8981 100 uint32_t NonInvertingInputSecondary; /*!< Specifies the non inverting input (secondary) of the opamp when
AnnaBridge 156:ff21514d8981 101 TimerControlledMuxmode is enabled
AnnaBridge 156:ff21514d8981 102 i.e. when TimerControlledMuxmode is OPAMP_TIMERCONTROLLEDMUXMODE_ENABLE
AnnaBridge 156:ff21514d8981 103 This parameter must be a value of @ref OPAMP_NonInvertingInputSecondary
AnnaBridge 156:ff21514d8981 104 NonInvertingInput is either VP0, VP1, VP2 or VP3 */
AnnaBridge 156:ff21514d8981 105
AnnaBridge 156:ff21514d8981 106 uint32_t PgaConnect; /*!< Specifies the inverting pin in PGA mode
AnnaBridge 156:ff21514d8981 107 i.e. when mode is OPAMP_PGA_MODE
AnnaBridge 156:ff21514d8981 108 This parameter must be a value of @ref OPAMP_PgaConnect
AnnaBridge 156:ff21514d8981 109 Either: not connected, connected to VM0, connected to VM1
AnnaBridge 156:ff21514d8981 110 (VM0 or VM1 are typically used for external filtering) */
AnnaBridge 156:ff21514d8981 111
AnnaBridge 156:ff21514d8981 112 uint32_t PgaGain; /*!< Specifies the gain in PGA mode
AnnaBridge 156:ff21514d8981 113 i.e. when mode is OPAMP_PGA_MODE.
AnnaBridge 156:ff21514d8981 114 This parameter must be a value of @ref OPAMP_PgaGain (2U, 4U, 8 or 16U ) */
AnnaBridge 156:ff21514d8981 115
AnnaBridge 156:ff21514d8981 116 uint32_t UserTrimming; /*!< Specifies the trimming mode
AnnaBridge 156:ff21514d8981 117 This parameter must be a value of @ref OPAMP_UserTrimming
AnnaBridge 156:ff21514d8981 118 UserTrimming is either factory or user trimming */
AnnaBridge 156:ff21514d8981 119
AnnaBridge 156:ff21514d8981 120 uint32_t TrimmingValueP; /*!< Specifies the offset trimming value (PMOS)
AnnaBridge 156:ff21514d8981 121 i.e. when UserTrimming is OPAMP_TRIMMING_USER.
AnnaBridge 156:ff21514d8981 122 This parameter must be a number between Min_Data = 1 and Max_Data = 31U */
AnnaBridge 156:ff21514d8981 123
AnnaBridge 156:ff21514d8981 124 uint32_t TrimmingValueN; /*!< Specifies the offset trimming value (NMOS)
AnnaBridge 156:ff21514d8981 125 i.e. when UserTrimming is OPAMP_TRIMMING_USER.
AnnaBridge 156:ff21514d8981 126 This parameter must be a number between Min_Data = 1 and Max_Data = 31U */
AnnaBridge 156:ff21514d8981 127
AnnaBridge 156:ff21514d8981 128 }OPAMP_InitTypeDef;
AnnaBridge 156:ff21514d8981 129
AnnaBridge 156:ff21514d8981 130 /**
AnnaBridge 156:ff21514d8981 131 * @brief HAL State structures definition
AnnaBridge 156:ff21514d8981 132 */
AnnaBridge 156:ff21514d8981 133
AnnaBridge 156:ff21514d8981 134 typedef enum
AnnaBridge 156:ff21514d8981 135 {
AnnaBridge 156:ff21514d8981 136 HAL_OPAMP_STATE_RESET = 0x00000000U, /*!< OPMAP is not yet Initialized */
AnnaBridge 156:ff21514d8981 137
AnnaBridge 156:ff21514d8981 138 HAL_OPAMP_STATE_READY = 0x00000001U, /*!< OPAMP is initialized and ready for use */
AnnaBridge 156:ff21514d8981 139 HAL_OPAMP_STATE_CALIBBUSY = 0x00000002U, /*!< OPAMP is enabled in auto calibration mode */
AnnaBridge 156:ff21514d8981 140
AnnaBridge 156:ff21514d8981 141 HAL_OPAMP_STATE_BUSY = 0x00000004U, /*!< OPAMP is enabled and running in normal mode */
AnnaBridge 156:ff21514d8981 142 HAL_OPAMP_STATE_BUSYLOCKED = 0x00000005U, /*!< OPAMP is locked
AnnaBridge 156:ff21514d8981 143 only system reset allows reconfiguring the opamp. */
AnnaBridge 156:ff21514d8981 144
AnnaBridge 156:ff21514d8981 145 }HAL_OPAMP_StateTypeDef;
AnnaBridge 156:ff21514d8981 146
AnnaBridge 156:ff21514d8981 147 /**
AnnaBridge 156:ff21514d8981 148 * @brief OPAMP Handle Structure definition to @brief OPAMP Handle Structure definition
AnnaBridge 156:ff21514d8981 149 */
AnnaBridge 156:ff21514d8981 150 typedef struct
AnnaBridge 156:ff21514d8981 151 {
AnnaBridge 156:ff21514d8981 152 OPAMP_TypeDef *Instance; /*!< OPAMP instance's registers base address */
AnnaBridge 156:ff21514d8981 153 OPAMP_InitTypeDef Init; /*!< OPAMP required parameters */
AnnaBridge 156:ff21514d8981 154 HAL_StatusTypeDef Status; /*!< OPAMP peripheral status */
AnnaBridge 156:ff21514d8981 155 HAL_LockTypeDef Lock; /*!< Locking object */
AnnaBridge 156:ff21514d8981 156 __IO HAL_OPAMP_StateTypeDef State; /*!< OPAMP communication state */
AnnaBridge 156:ff21514d8981 157
AnnaBridge 156:ff21514d8981 158 } OPAMP_HandleTypeDef;
AnnaBridge 156:ff21514d8981 159
AnnaBridge 156:ff21514d8981 160 /**
AnnaBridge 156:ff21514d8981 161 * @brief OPAMP_TrimmingValueTypeDef @brief definition
AnnaBridge 156:ff21514d8981 162 */
AnnaBridge 156:ff21514d8981 163
AnnaBridge 156:ff21514d8981 164 typedef uint32_t OPAMP_TrimmingValueTypeDef;
AnnaBridge 156:ff21514d8981 165 /**
AnnaBridge 156:ff21514d8981 166 * @}
AnnaBridge 156:ff21514d8981 167 */
AnnaBridge 156:ff21514d8981 168
AnnaBridge 156:ff21514d8981 169 /* Exported constants --------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 170 /** @defgroup OPAMP_Exported_Constants OPAMP Exported Constants
AnnaBridge 156:ff21514d8981 171 * @{
AnnaBridge 156:ff21514d8981 172 */
AnnaBridge 156:ff21514d8981 173
AnnaBridge 156:ff21514d8981 174 /** @defgroup OPAMP_CSR_INIT OPAMP CSR init register Mask
AnnaBridge 156:ff21514d8981 175 * @{
AnnaBridge 156:ff21514d8981 176 */
AnnaBridge 156:ff21514d8981 177 /* Used for Init phase */
AnnaBridge 156:ff21514d8981 178 #define OPAMP_CSR_UPDATE_PARAMETERS_INIT_MASK (OPAMP_CSR_TRIMOFFSETN | OPAMP_CSR_TRIMOFFSETP \
AnnaBridge 156:ff21514d8981 179 | OPAMP_CSR_USERTRIM | OPAMP_CSR_PGGAIN | OPAMP_CSR_VPSSEL \
AnnaBridge 156:ff21514d8981 180 | OPAMP_CSR_VMSSEL | OPAMP_CSR_TCMEN | OPAMP_CSR_VPSEL \
AnnaBridge 156:ff21514d8981 181 | OPAMP_CSR_VMSEL | OPAMP_CSR_FORCEVP)
AnnaBridge 156:ff21514d8981 182
AnnaBridge 156:ff21514d8981 183 /**
AnnaBridge 156:ff21514d8981 184 * @}
AnnaBridge 156:ff21514d8981 185 */
AnnaBridge 156:ff21514d8981 186
AnnaBridge 156:ff21514d8981 187 /** @defgroup OPAMP_Mode OPAMP Mode
AnnaBridge 156:ff21514d8981 188 * @{
AnnaBridge 156:ff21514d8981 189 */
AnnaBridge 156:ff21514d8981 190 #define OPAMP_STANDALONE_MODE (0x00000000U) /*!< standalone mode */
AnnaBridge 156:ff21514d8981 191 #define OPAMP_PGA_MODE OPAMP_CSR_VMSEL_1 /*!< PGA mode */
AnnaBridge 156:ff21514d8981 192 #define OPAMP_FOLLOWER_MODE OPAMP_CSR_VMSEL /*!< follower mode */
AnnaBridge 156:ff21514d8981 193
AnnaBridge 156:ff21514d8981 194
AnnaBridge 156:ff21514d8981 195 #define IS_OPAMP_FUNCTIONAL_NORMALMODE(INPUT) (((INPUT) == OPAMP_STANDALONE_MODE) || \
AnnaBridge 156:ff21514d8981 196 ((INPUT) == OPAMP_PGA_MODE) || \
AnnaBridge 156:ff21514d8981 197 ((INPUT) == OPAMP_FOLLOWER_MODE))
AnnaBridge 156:ff21514d8981 198
AnnaBridge 156:ff21514d8981 199 /**
AnnaBridge 156:ff21514d8981 200 * @}
AnnaBridge 156:ff21514d8981 201 */
AnnaBridge 156:ff21514d8981 202
AnnaBridge 156:ff21514d8981 203 /** @defgroup OPAMP_NonInvertingInput OPAMP Non Inverting Input
AnnaBridge 156:ff21514d8981 204 * @{
AnnaBridge 156:ff21514d8981 205 */
AnnaBridge 156:ff21514d8981 206
AnnaBridge 156:ff21514d8981 207 #define OPAMP_NONINVERTINGINPUT_IO0 OPAMP_CSR_VPSEL /*!< VP0 (PA1 for OPAMP1, VP0 PA7 for OPAMP2, VP0 PB0 for OPAMP3, VP0 PB13 for OPAMP4)
AnnaBridge 156:ff21514d8981 208 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 209 #define OPAMP_NONINVERTINGINPUT_IO1 (0x00000000U) /*!< VP1 (PA7 for OPAMP1, VP3 PD14 for OPAMP2, VP1 PB13 for OPAMP3, VP1 PD11 for OPAMP4)
AnnaBridge 156:ff21514d8981 210 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 211 #define OPAMP_NONINVERTINGINPUT_IO2 OPAMP_CSR_VPSEL_1 /*!< VP2 (PA3 for OPAMP1, VP2 PB0 for OPAMP2, VP2 PA1 for OPAMP3, VP3 PA4 for OPAMP4)
AnnaBridge 156:ff21514d8981 212 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 213 #define OPAMP_NONINVERTINGINPUT_IO3 OPAMP_CSR_VPSEL_0 /*!< VP3 (PA5 for OPAMP1, VP1 PB14 for OPAMP2, VP3 PA5 for OPAMP3, VP2 PB11 for OPAMP4)
AnnaBridge 156:ff21514d8981 214 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 215
AnnaBridge 156:ff21514d8981 216 #define IS_OPAMP_NONINVERTING_INPUT(INPUT) (((INPUT) == OPAMP_NONINVERTINGINPUT_IO0) || \
AnnaBridge 156:ff21514d8981 217 ((INPUT) == OPAMP_NONINVERTINGINPUT_IO1) || \
AnnaBridge 156:ff21514d8981 218 ((INPUT) == OPAMP_NONINVERTINGINPUT_IO2) || \
AnnaBridge 156:ff21514d8981 219 ((INPUT) == OPAMP_NONINVERTINGINPUT_IO3))
AnnaBridge 156:ff21514d8981 220
AnnaBridge 156:ff21514d8981 221 /**
AnnaBridge 156:ff21514d8981 222 * @}
AnnaBridge 156:ff21514d8981 223 */
AnnaBridge 156:ff21514d8981 224
AnnaBridge 156:ff21514d8981 225 /** @defgroup OPAMP_InvertingInput OPAMP Inverting Input
AnnaBridge 156:ff21514d8981 226 * @{
AnnaBridge 156:ff21514d8981 227 */
AnnaBridge 156:ff21514d8981 228
AnnaBridge 156:ff21514d8981 229 #define OPAMP_INVERTINGINPUT_IO0 (0x00000000U) /*!< inverting input connected to VM0 */
AnnaBridge 156:ff21514d8981 230 #define OPAMP_INVERTINGINPUT_IO1 OPAMP_CSR_VMSEL_0 /*!< inverting input connected to VM1 */
AnnaBridge 156:ff21514d8981 231
AnnaBridge 156:ff21514d8981 232 #define IS_OPAMP_INVERTING_INPUT(INPUT) (((INPUT) == OPAMP_INVERTINGINPUT_IO0) || \
AnnaBridge 156:ff21514d8981 233 ((INPUT) == OPAMP_INVERTINGINPUT_IO1))
AnnaBridge 156:ff21514d8981 234
AnnaBridge 156:ff21514d8981 235 /**
AnnaBridge 156:ff21514d8981 236 * @}
AnnaBridge 156:ff21514d8981 237 */
AnnaBridge 156:ff21514d8981 238
AnnaBridge 156:ff21514d8981 239 /** @defgroup OPAMP_TimerControlledMuxmode OPAMP Timer Controlled Mux mode
AnnaBridge 156:ff21514d8981 240 * @{
AnnaBridge 156:ff21514d8981 241 */
AnnaBridge 156:ff21514d8981 242 #define OPAMP_TIMERCONTROLLEDMUXMODE_DISABLE (0x00000000U) /*!< Timer controlled Mux mode disabled */
AnnaBridge 156:ff21514d8981 243 #define OPAMP_TIMERCONTROLLEDMUXMODE_ENABLE OPAMP_CSR_TCMEN /*!< Timer controlled Mux mode enabled */
AnnaBridge 156:ff21514d8981 244
AnnaBridge 156:ff21514d8981 245 #define IS_OPAMP_TIMERCONTROLLED_MUXMODE(MUXMODE) (((MUXMODE) == OPAMP_TIMERCONTROLLEDMUXMODE_DISABLE) || \
AnnaBridge 156:ff21514d8981 246 ((MUXMODE) == OPAMP_TIMERCONTROLLEDMUXMODE_ENABLE))
AnnaBridge 156:ff21514d8981 247 /**
AnnaBridge 156:ff21514d8981 248 * @}
AnnaBridge 156:ff21514d8981 249 */
AnnaBridge 156:ff21514d8981 250
AnnaBridge 156:ff21514d8981 251 /** @defgroup OPAMP_NonInvertingInputSecondary OPAMP Non Inverting Input Secondary
AnnaBridge 156:ff21514d8981 252 * @{
AnnaBridge 156:ff21514d8981 253 */
AnnaBridge 156:ff21514d8981 254
AnnaBridge 156:ff21514d8981 255 #define OPAMP_SEC_NONINVERTINGINPUT_IO0 OPAMP_CSR_VPSSEL /*!< VP0 (PA1 for OPAMP1, PA7 for OPAMP2, PB0 for OPAMP3, PB13 for OPAMP4)
AnnaBridge 156:ff21514d8981 256 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 257 #define OPAMP_SEC_NONINVERTINGINPUT_IO1 (0x00000000U) /*!< VP1 (PA7 for OPAMP1, PD14 for OPAMP2, PB13 for OPAMP3, PD11 for OPAMP4)
AnnaBridge 156:ff21514d8981 258 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 259 #define OPAMP_SEC_NONINVERTINGINPUT_IO2 OPAMP_CSR_VPSSEL_1 /*!< VP2 (PA3 for OPAMP1, PB0 for OPAMP2, PA1 for OPAMP3, PA4 for OPAMP4)
AnnaBridge 156:ff21514d8981 260 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 261 #define OPAMP_SEC_NONINVERTINGINPUT_IO3 OPAMP_CSR_VPSSEL_0 /*!< VP3 (PA5 for OPAMP1, PB14 for OPAMP2, PA5 for OPAMP3, PB11 for OPAMP4)
AnnaBridge 156:ff21514d8981 262 connected to OPAMPx non inverting input */
AnnaBridge 156:ff21514d8981 263
AnnaBridge 156:ff21514d8981 264 #define IS_OPAMP_SEC_NONINVERTINGINPUT(INPUT) (((INPUT) == OPAMP_SEC_NONINVERTINGINPUT_IO0) || \
AnnaBridge 156:ff21514d8981 265 ((INPUT) == OPAMP_SEC_NONINVERTINGINPUT_IO1) || \
AnnaBridge 156:ff21514d8981 266 ((INPUT) == OPAMP_SEC_NONINVERTINGINPUT_IO2) || \
AnnaBridge 156:ff21514d8981 267 ((INPUT) == OPAMP_SEC_NONINVERTINGINPUT_IO3))
AnnaBridge 156:ff21514d8981 268
AnnaBridge 156:ff21514d8981 269 /**
AnnaBridge 156:ff21514d8981 270 * @}
AnnaBridge 156:ff21514d8981 271 */
AnnaBridge 156:ff21514d8981 272
AnnaBridge 156:ff21514d8981 273 /** @defgroup OPAMP_InvertingInputSecondary OPAMP Inverting Input Secondary
AnnaBridge 156:ff21514d8981 274 * @{
AnnaBridge 156:ff21514d8981 275 */
AnnaBridge 156:ff21514d8981 276
AnnaBridge 156:ff21514d8981 277 #define OPAMP_SEC_INVERTINGINPUT_IO0 (0x00000000U) /*!< VM0 (PC5 for OPAMP1 and OPAMP2, PB10 for OPAMP3 and OPAMP4)
AnnaBridge 156:ff21514d8981 278 connected to OPAMPx inverting input */
AnnaBridge 156:ff21514d8981 279 #define OPAMP_SEC_INVERTINGINPUT_IO1 OPAMP_CSR_VMSSEL /*!< VM1 (PA3 for OPAMP1, PA5 for OPAMP2, PB2 for OPAMP3, PD8 for OPAMP4)
AnnaBridge 156:ff21514d8981 280 connected to OPAMPx inverting input */
AnnaBridge 156:ff21514d8981 281
AnnaBridge 156:ff21514d8981 282 #define IS_OPAMP_SEC_INVERTINGINPUT(INPUT) (((INPUT) == OPAMP_SEC_INVERTINGINPUT_IO0) || \
AnnaBridge 156:ff21514d8981 283 ((INPUT) == OPAMP_SEC_INVERTINGINPUT_IO1))
AnnaBridge 156:ff21514d8981 284
AnnaBridge 156:ff21514d8981 285 /**
AnnaBridge 156:ff21514d8981 286 * @}
AnnaBridge 156:ff21514d8981 287 */
AnnaBridge 156:ff21514d8981 288
AnnaBridge 156:ff21514d8981 289 /** @defgroup OPAMP_PgaConnect OPAMP Pga Connect
AnnaBridge 156:ff21514d8981 290 * @{
AnnaBridge 156:ff21514d8981 291 */
AnnaBridge 156:ff21514d8981 292
AnnaBridge 156:ff21514d8981 293 #define OPAMP_PGA_CONNECT_INVERTINGINPUT_NO (0x00000000U) /*!< In PGA mode, the non inverting input is not connected */
AnnaBridge 156:ff21514d8981 294 #define OPAMP_PGA_CONNECT_INVERTINGINPUT_IO0 OPAMP_CSR_PGGAIN_3 /*!< In PGA mode, the non inverting input is connected to VM0 */
AnnaBridge 156:ff21514d8981 295 #define OPAMP_PGA_CONNECT_INVERTINGINPUT_IO1 (OPAMP_CSR_PGGAIN_2 | OPAMP_CSR_PGGAIN_3) /*!< In PGA mode, the non inverting input is connected to VM1 */
AnnaBridge 156:ff21514d8981 296
AnnaBridge 156:ff21514d8981 297 #define IS_OPAMP_PGACONNECT(CONNECT) (((CONNECT) == OPAMP_PGA_CONNECT_INVERTINGINPUT_NO) || \
AnnaBridge 156:ff21514d8981 298 ((CONNECT) == OPAMP_PGA_CONNECT_INVERTINGINPUT_IO0) || \
AnnaBridge 156:ff21514d8981 299 ((CONNECT) == OPAMP_PGA_CONNECT_INVERTINGINPUT_IO1))
AnnaBridge 156:ff21514d8981 300 /**
AnnaBridge 156:ff21514d8981 301 * @}
AnnaBridge 156:ff21514d8981 302 */
AnnaBridge 156:ff21514d8981 303
AnnaBridge 156:ff21514d8981 304
AnnaBridge 156:ff21514d8981 305 /** @defgroup OPAMP_PgaGain OPAMP Pga Gain
AnnaBridge 156:ff21514d8981 306 * @{
AnnaBridge 156:ff21514d8981 307 */
AnnaBridge 156:ff21514d8981 308
AnnaBridge 168:b9e159c1930a 309 #define OPAMP_PGA_GAIN_2 (0x00000000U) /*!< PGA gain = 2 */
AnnaBridge 168:b9e159c1930a 310 #define OPAMP_PGA_GAIN_4 OPAMP_CSR_PGGAIN_0 /*!< PGA gain = 4 */
AnnaBridge 168:b9e159c1930a 311 #define OPAMP_PGA_GAIN_8 OPAMP_CSR_PGGAIN_1 /*!< PGA gain = 8 */
AnnaBridge 168:b9e159c1930a 312 #define OPAMP_PGA_GAIN_16 (OPAMP_CSR_PGGAIN_0 | OPAMP_CSR_PGGAIN_1) /*!< PGA gain = 16 */
AnnaBridge 156:ff21514d8981 313
AnnaBridge 156:ff21514d8981 314 #define IS_OPAMP_PGA_GAIN(GAIN) (((GAIN) == OPAMP_PGA_GAIN_2) || \
AnnaBridge 156:ff21514d8981 315 ((GAIN) == OPAMP_PGA_GAIN_4) || \
AnnaBridge 156:ff21514d8981 316 ((GAIN) == OPAMP_PGA_GAIN_8) || \
AnnaBridge 156:ff21514d8981 317 ((GAIN) == OPAMP_PGA_GAIN_16))
AnnaBridge 156:ff21514d8981 318 /**
AnnaBridge 156:ff21514d8981 319 * @}
AnnaBridge 156:ff21514d8981 320 */
AnnaBridge 156:ff21514d8981 321
AnnaBridge 156:ff21514d8981 322 /** @defgroup OPAMP_UserTrimming OPAMP User Trimming
AnnaBridge 156:ff21514d8981 323 * @{
AnnaBridge 156:ff21514d8981 324 */
AnnaBridge 156:ff21514d8981 325
AnnaBridge 156:ff21514d8981 326 #define OPAMP_TRIMMING_FACTORY (0x00000000U) /*!< Factory trimming */
AnnaBridge 156:ff21514d8981 327 #define OPAMP_TRIMMING_USER OPAMP_CSR_USERTRIM /*!< User trimming */
AnnaBridge 156:ff21514d8981 328
AnnaBridge 156:ff21514d8981 329 #define IS_OPAMP_TRIMMING(TRIMMING) (((TRIMMING) == OPAMP_TRIMMING_FACTORY) || \
AnnaBridge 156:ff21514d8981 330 ((TRIMMING) == OPAMP_TRIMMING_USER))
AnnaBridge 156:ff21514d8981 331
AnnaBridge 156:ff21514d8981 332 /** @defgroup OPAMP_FactoryTrimming OPAMP Factory Trimming
AnnaBridge 156:ff21514d8981 333 * @{
AnnaBridge 156:ff21514d8981 334 */
AnnaBridge 156:ff21514d8981 335
AnnaBridge 156:ff21514d8981 336 #define OPAMP_FACTORYTRIMMING_DUMMY (0xFFFFFFFFU) /*!< Dummy trimming value */
AnnaBridge 156:ff21514d8981 337
AnnaBridge 156:ff21514d8981 338 #define OPAMP_FACTORYTRIMMING_N (0x00000000U) /*!< Offset trimming N */
AnnaBridge 156:ff21514d8981 339 #define OPAMP_FACTORYTRIMMING_P (0x00000001U) /*!< Offset trimming P */
AnnaBridge 156:ff21514d8981 340
AnnaBridge 156:ff21514d8981 341 #define IS_OPAMP_FACTORYTRIMMING(TRIMMING) (((TRIMMING) == OPAMP_FACTORYTRIMMING_N) || \
AnnaBridge 156:ff21514d8981 342 ((TRIMMING) == OPAMP_FACTORYTRIMMING_P))
AnnaBridge 156:ff21514d8981 343
AnnaBridge 156:ff21514d8981 344 /**
AnnaBridge 156:ff21514d8981 345 * @}
AnnaBridge 156:ff21514d8981 346 */
AnnaBridge 156:ff21514d8981 347
AnnaBridge 156:ff21514d8981 348
AnnaBridge 156:ff21514d8981 349 /** @defgroup OPAMP_TrimmingValue OPAMP Trimming Value
AnnaBridge 156:ff21514d8981 350 * @{
AnnaBridge 156:ff21514d8981 351 */
AnnaBridge 156:ff21514d8981 352
AnnaBridge 156:ff21514d8981 353 #define IS_OPAMP_TRIMMINGVALUE(TRIMMINGVALUE) ((TRIMMINGVALUE) <= 0x1FU)
AnnaBridge 156:ff21514d8981 354
AnnaBridge 156:ff21514d8981 355
AnnaBridge 156:ff21514d8981 356 /**
AnnaBridge 156:ff21514d8981 357 * @}
AnnaBridge 156:ff21514d8981 358 */
AnnaBridge 156:ff21514d8981 359
AnnaBridge 156:ff21514d8981 360
AnnaBridge 156:ff21514d8981 361 /** @defgroup OPAMP_Input OPAMP Input
AnnaBridge 156:ff21514d8981 362 * @{
AnnaBridge 156:ff21514d8981 363 */
AnnaBridge 156:ff21514d8981 364
AnnaBridge 156:ff21514d8981 365 #define OPAMP_INPUT_INVERTING ( 24U) /*!< Inverting input */
AnnaBridge 156:ff21514d8981 366 #define OPAMP_INPUT_NONINVERTING ( 19U) /*!< Non inverting input */
AnnaBridge 156:ff21514d8981 367
AnnaBridge 156:ff21514d8981 368 #define IS_OPAMP_INPUT(INPUT) (((INPUT) == OPAMP_INPUT_INVERTING) || \
AnnaBridge 156:ff21514d8981 369 ((INPUT) == OPAMP_INPUT_NONINVERTING))
AnnaBridge 156:ff21514d8981 370 /**
AnnaBridge 156:ff21514d8981 371 * @}
AnnaBridge 156:ff21514d8981 372 */
AnnaBridge 156:ff21514d8981 373
AnnaBridge 156:ff21514d8981 374
AnnaBridge 156:ff21514d8981 375 /** @defgroup OPAMP_VREF OPAMP VREF
AnnaBridge 156:ff21514d8981 376 * @{
AnnaBridge 156:ff21514d8981 377 */
AnnaBridge 156:ff21514d8981 378
AnnaBridge 156:ff21514d8981 379 #define OPAMP_VREF_3VDDA (0x00000000U) /*!< OPMAP Vref = 3.3U% VDDA */
AnnaBridge 156:ff21514d8981 380 #define OPAMP_VREF_10VDDA OPAMP_CSR_CALSEL_0 /*!< OPMAP Vref = 10U% VDDA */
AnnaBridge 156:ff21514d8981 381 #define OPAMP_VREF_50VDDA OPAMP_CSR_CALSEL_1 /*!< OPMAP Vref = 50U% VDDA */
AnnaBridge 156:ff21514d8981 382 #define OPAMP_VREF_90VDDA OPAMP_CSR_CALSEL /*!< OPMAP Vref = 90U% VDDA */
AnnaBridge 156:ff21514d8981 383
AnnaBridge 156:ff21514d8981 384 #define IS_OPAMP_VREF(VREF) (((VREF) == OPAMP_VREF_3VDDA) || \
AnnaBridge 156:ff21514d8981 385 ((VREF) == OPAMP_VREF_10VDDA) || \
AnnaBridge 156:ff21514d8981 386 ((VREF) == OPAMP_VREF_50VDDA) || \
AnnaBridge 156:ff21514d8981 387 ((VREF) == OPAMP_VREF_90VDDA))
AnnaBridge 156:ff21514d8981 388
AnnaBridge 156:ff21514d8981 389 /**
AnnaBridge 156:ff21514d8981 390 * @}
AnnaBridge 156:ff21514d8981 391 */
AnnaBridge 156:ff21514d8981 392
AnnaBridge 156:ff21514d8981 393 /** @defgroup OPAMP_Vref2ADCforCalib OPAMP Vref2ADCforCalib
AnnaBridge 156:ff21514d8981 394 */
AnnaBridge 156:ff21514d8981 395
AnnaBridge 156:ff21514d8981 396 #define OPAMP_VREF_NOTCONNECTEDTO_ADC (0x00000000U) /*!< VREF not connected to ADC */
AnnaBridge 156:ff21514d8981 397 #define OPAMP_VREF_CONNECTEDTO_ADC (0x00000001U) /*!< VREF not connected to ADC */
AnnaBridge 156:ff21514d8981 398
AnnaBridge 156:ff21514d8981 399 #define IS_OPAMP_ALLOPAMPVREF_CONNECT(CONNECT) (((CONNECT) == OPAMP_VREF_NOTCONNECTEDTO_ADC) || \
AnnaBridge 156:ff21514d8981 400 ((CONNECT) == OPAMP_VREF_CONNECTEDTO_ADC))
AnnaBridge 156:ff21514d8981 401
AnnaBridge 156:ff21514d8981 402
AnnaBridge 156:ff21514d8981 403 /**
AnnaBridge 156:ff21514d8981 404 * @}
AnnaBridge 156:ff21514d8981 405 */
AnnaBridge 156:ff21514d8981 406
AnnaBridge 156:ff21514d8981 407 /**
AnnaBridge 156:ff21514d8981 408 * @}
AnnaBridge 156:ff21514d8981 409 */
AnnaBridge 156:ff21514d8981 410
AnnaBridge 156:ff21514d8981 411 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 412 /** @defgroup OPAMP_Exported_Macros OPAMP Exported Macros
AnnaBridge 156:ff21514d8981 413 * @{
AnnaBridge 156:ff21514d8981 414 */
AnnaBridge 156:ff21514d8981 415
AnnaBridge 156:ff21514d8981 416 /** @brief Reset OPAMP handle state
AnnaBridge 168:b9e159c1930a 417 * @param __HANDLE__ OPAMP handle.
AnnaBridge 156:ff21514d8981 418 * @retval None
AnnaBridge 156:ff21514d8981 419 */
AnnaBridge 156:ff21514d8981 420 #define __HAL_OPAMP_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_OPAMP_STATE_RESET)
AnnaBridge 156:ff21514d8981 421
AnnaBridge 156:ff21514d8981 422 /**
AnnaBridge 156:ff21514d8981 423 * @}
AnnaBridge 156:ff21514d8981 424 */
AnnaBridge 156:ff21514d8981 425
AnnaBridge 156:ff21514d8981 426 /* Include OPAMP HAL Extended module */
AnnaBridge 156:ff21514d8981 427 #include "stm32f3xx_hal_opamp_ex.h"
AnnaBridge 156:ff21514d8981 428
AnnaBridge 156:ff21514d8981 429 /* Exported functions --------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 430 /** @defgroup OPAMP_Exported_Functions OPAMP Exported Functions
AnnaBridge 156:ff21514d8981 431 * @{
AnnaBridge 156:ff21514d8981 432 */
AnnaBridge 156:ff21514d8981 433
AnnaBridge 156:ff21514d8981 434 /** @defgroup OPAMP_Exported_Functions_Group1 Initialization and de-initialization functions
AnnaBridge 156:ff21514d8981 435 * @{
AnnaBridge 156:ff21514d8981 436 */
AnnaBridge 156:ff21514d8981 437
AnnaBridge 156:ff21514d8981 438 /* Initialization/de-initialization functions **********************************/
AnnaBridge 156:ff21514d8981 439 HAL_StatusTypeDef HAL_OPAMP_Init(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 440 HAL_StatusTypeDef HAL_OPAMP_DeInit (OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 441 void HAL_OPAMP_MspInit(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 442 void HAL_OPAMP_MspDeInit(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 443 /**
AnnaBridge 156:ff21514d8981 444 * @}
AnnaBridge 156:ff21514d8981 445 */
AnnaBridge 156:ff21514d8981 446
AnnaBridge 156:ff21514d8981 447
AnnaBridge 156:ff21514d8981 448 /** @defgroup OPAMP_Exported_Functions_Group2 Input and Output operation functions
AnnaBridge 156:ff21514d8981 449 * @{
AnnaBridge 156:ff21514d8981 450 */
AnnaBridge 156:ff21514d8981 451
AnnaBridge 156:ff21514d8981 452 /* I/O operation functions *****************************************************/
AnnaBridge 156:ff21514d8981 453 HAL_StatusTypeDef HAL_OPAMP_Start(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 454 HAL_StatusTypeDef HAL_OPAMP_Stop(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 455 HAL_StatusTypeDef HAL_OPAMP_SelfCalibrate(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 456
AnnaBridge 156:ff21514d8981 457 /**
AnnaBridge 156:ff21514d8981 458 * @}
AnnaBridge 156:ff21514d8981 459 */
AnnaBridge 156:ff21514d8981 460
AnnaBridge 156:ff21514d8981 461 /** @defgroup OPAMP_Exported_Functions_Group3 Peripheral Control functions
AnnaBridge 156:ff21514d8981 462 * @{
AnnaBridge 156:ff21514d8981 463 */
AnnaBridge 156:ff21514d8981 464
AnnaBridge 156:ff21514d8981 465 /* Peripheral Control functions ************************************************/
AnnaBridge 156:ff21514d8981 466 HAL_StatusTypeDef HAL_OPAMP_Lock(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 467
AnnaBridge 156:ff21514d8981 468 /**
AnnaBridge 156:ff21514d8981 469 * @}
AnnaBridge 156:ff21514d8981 470 */
AnnaBridge 156:ff21514d8981 471
AnnaBridge 156:ff21514d8981 472 /** @defgroup OPAMP_Exported_Functions_Group4 Peripheral State functions
AnnaBridge 156:ff21514d8981 473 * @{
AnnaBridge 156:ff21514d8981 474 */
AnnaBridge 156:ff21514d8981 475
AnnaBridge 156:ff21514d8981 476 /* Peripheral State functions **************************************************/
AnnaBridge 156:ff21514d8981 477 HAL_OPAMP_StateTypeDef HAL_OPAMP_GetState(OPAMP_HandleTypeDef *hopamp);
AnnaBridge 156:ff21514d8981 478 OPAMP_TrimmingValueTypeDef HAL_OPAMP_GetTrimOffset (OPAMP_HandleTypeDef *hopamp, uint32_t trimmingoffset);
AnnaBridge 156:ff21514d8981 479
AnnaBridge 156:ff21514d8981 480 /**
AnnaBridge 156:ff21514d8981 481 * @}
AnnaBridge 156:ff21514d8981 482 */
AnnaBridge 156:ff21514d8981 483
AnnaBridge 156:ff21514d8981 484 /**
AnnaBridge 156:ff21514d8981 485 * @}
AnnaBridge 156:ff21514d8981 486 */
AnnaBridge 156:ff21514d8981 487
AnnaBridge 156:ff21514d8981 488 /**
AnnaBridge 156:ff21514d8981 489 * @}
AnnaBridge 156:ff21514d8981 490 */
AnnaBridge 156:ff21514d8981 491
AnnaBridge 156:ff21514d8981 492 /**
AnnaBridge 156:ff21514d8981 493 * @}
AnnaBridge 156:ff21514d8981 494 */
AnnaBridge 156:ff21514d8981 495
AnnaBridge 156:ff21514d8981 496 #endif /* STM32F302xE || STM32F303xE || STM32F398xx || */
AnnaBridge 156:ff21514d8981 497 /* STM32F302xC || STM32F303xC || STM32F358xx || */
AnnaBridge 156:ff21514d8981 498 /* STM32F303x8 || STM32F334x8 || STM32F328xx || */
AnnaBridge 156:ff21514d8981 499 /* STM32F301x8 || STM32F302x8 || STM32F318xx */
AnnaBridge 156:ff21514d8981 500
AnnaBridge 156:ff21514d8981 501 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 502 }
AnnaBridge 156:ff21514d8981 503 #endif
AnnaBridge 156:ff21514d8981 504
AnnaBridge 156:ff21514d8981 505 #endif /* __STM32F3xx_HAL_OPAMP_H */
AnnaBridge 156:ff21514d8981 506
AnnaBridge 156:ff21514d8981 507 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/