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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 172:65be27845400 1 /**
AnnaBridge 172:65be27845400 2 ******************************************************************************
AnnaBridge 172:65be27845400 3 * @file stm32h7xx_ll_comp.h
AnnaBridge 172:65be27845400 4 * @author MCD Application Team
AnnaBridge 172:65be27845400 5 * @brief Header file of COMP LL module.
AnnaBridge 172:65be27845400 6 ******************************************************************************
AnnaBridge 172:65be27845400 7 * @attention
AnnaBridge 172:65be27845400 8 *
AnnaBridge 172:65be27845400 9 * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
AnnaBridge 172:65be27845400 10 * All rights reserved.</center></h2>
AnnaBridge 172:65be27845400 11 *
AnnaBridge 172:65be27845400 12 * This software component is licensed by ST under BSD 3-Clause license,
AnnaBridge 172:65be27845400 13 * the "License"; You may not use this file except in compliance with the
AnnaBridge 172:65be27845400 14 * License. You may obtain a copy of the License at:
AnnaBridge 172:65be27845400 15 * opensource.org/licenses/BSD-3-Clause
AnnaBridge 172:65be27845400 16 *
AnnaBridge 172:65be27845400 17 ******************************************************************************
AnnaBridge 172:65be27845400 18 */
AnnaBridge 172:65be27845400 19
AnnaBridge 172:65be27845400 20 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 172:65be27845400 21 #ifndef __STM32H7xx_LL_COMP_H
AnnaBridge 172:65be27845400 22 #define __STM32H7xx_LL_COMP_H
AnnaBridge 172:65be27845400 23
AnnaBridge 172:65be27845400 24 #ifdef __cplusplus
AnnaBridge 172:65be27845400 25 extern "C" {
AnnaBridge 172:65be27845400 26 #endif
AnnaBridge 172:65be27845400 27
AnnaBridge 172:65be27845400 28 /* Includes ------------------------------------------------------------------*/
AnnaBridge 172:65be27845400 29 #include "stm32h7xx.h"
AnnaBridge 172:65be27845400 30
AnnaBridge 172:65be27845400 31 /** @addtogroup STM32H7xx_LL_Driver
AnnaBridge 172:65be27845400 32 * @{
AnnaBridge 172:65be27845400 33 */
AnnaBridge 172:65be27845400 34
AnnaBridge 172:65be27845400 35 #if defined (COMP1) || defined (COMP2)
AnnaBridge 172:65be27845400 36
AnnaBridge 172:65be27845400 37 /** @defgroup COMP_LL COMP
AnnaBridge 172:65be27845400 38 * @{
AnnaBridge 172:65be27845400 39 */
AnnaBridge 172:65be27845400 40
AnnaBridge 172:65be27845400 41 /* Private types -------------------------------------------------------------*/
AnnaBridge 172:65be27845400 42 /* Private variables ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 43 /* Private constants ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 44 /** @defgroup COMP_LL_Private_Constants COMP Private Constants
AnnaBridge 172:65be27845400 45 * @{
AnnaBridge 172:65be27845400 46 */
AnnaBridge 172:65be27845400 47
AnnaBridge 172:65be27845400 48 /* COMP registers bits positions */
AnnaBridge 172:65be27845400 49 #define LL_COMP_OUTPUT_LEVEL_BITOFFSET_POS (30U) /* Value equivalent to POSITION_VAL(COMP_CSR_VALUE) */
AnnaBridge 172:65be27845400 50
AnnaBridge 172:65be27845400 51 /**
AnnaBridge 172:65be27845400 52 * @}
AnnaBridge 172:65be27845400 53 */
AnnaBridge 172:65be27845400 54
AnnaBridge 172:65be27845400 55 /* Private macros ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 56 /* Exported types ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 57 #if defined(USE_FULL_LL_DRIVER)
AnnaBridge 172:65be27845400 58 /** @defgroup COMP_LL_ES_INIT COMP Exported Init structure
AnnaBridge 172:65be27845400 59 * @{
AnnaBridge 172:65be27845400 60 */
AnnaBridge 172:65be27845400 61
AnnaBridge 172:65be27845400 62 /**
AnnaBridge 172:65be27845400 63 * @brief Structure definition of some features of COMP instance.
AnnaBridge 172:65be27845400 64 */
AnnaBridge 172:65be27845400 65 typedef struct
AnnaBridge 172:65be27845400 66 {
AnnaBridge 172:65be27845400 67 uint32_t PowerMode; /*!< Set comparator operating mode to adjust power and speed.
AnnaBridge 172:65be27845400 68 This parameter can be a value of @ref COMP_LL_EC_POWERMODE
AnnaBridge 172:65be27845400 69
AnnaBridge 172:65be27845400 70 This feature can be modified afterwards using unitary function @ref LL_COMP_SetPowerMode(). */
AnnaBridge 172:65be27845400 71
AnnaBridge 172:65be27845400 72 uint32_t InputPlus; /*!< Set comparator input plus (non-inverting input).
AnnaBridge 172:65be27845400 73 This parameter can be a value of @ref COMP_LL_EC_INPUT_PLUS
AnnaBridge 172:65be27845400 74
AnnaBridge 172:65be27845400 75 This feature can be modified afterwards using unitary function @ref LL_COMP_SetInputPlus(). */
AnnaBridge 172:65be27845400 76
AnnaBridge 172:65be27845400 77 uint32_t InputMinus; /*!< Set comparator input minus (inverting input).
AnnaBridge 172:65be27845400 78 This parameter can be a value of @ref COMP_LL_EC_INPUT_MINUS
AnnaBridge 172:65be27845400 79
AnnaBridge 172:65be27845400 80 This feature can be modified afterwards using unitary function @ref LL_COMP_SetInputMinus(). */
AnnaBridge 172:65be27845400 81
AnnaBridge 172:65be27845400 82 uint32_t InputHysteresis; /*!< Set comparator hysteresis mode of the input minus.
AnnaBridge 172:65be27845400 83 This parameter can be a value of @ref COMP_LL_EC_INPUT_HYSTERESIS
AnnaBridge 172:65be27845400 84
AnnaBridge 172:65be27845400 85 This feature can be modified afterwards using unitary function @ref LL_COMP_SetInputHysteresis(). */
AnnaBridge 172:65be27845400 86
AnnaBridge 172:65be27845400 87 uint32_t OutputPolarity; /*!< Set comparator output polarity.
AnnaBridge 172:65be27845400 88 This parameter can be a value of @ref COMP_LL_EC_OUTPUT_POLARITY
AnnaBridge 172:65be27845400 89
AnnaBridge 172:65be27845400 90 This feature can be modified afterwards using unitary function @ref LL_COMP_SetOutputPolarity(). */
AnnaBridge 172:65be27845400 91
AnnaBridge 172:65be27845400 92 uint32_t OutputBlankingSource; /*!< Set comparator blanking source.
AnnaBridge 172:65be27845400 93 This parameter can be a value of @ref COMP_LL_EC_OUTPUT_BLANKING_SOURCE
AnnaBridge 172:65be27845400 94
AnnaBridge 172:65be27845400 95 This feature can be modified afterwards using unitary function @ref LL_COMP_SetOutputBlankingSource(). */
AnnaBridge 172:65be27845400 96
AnnaBridge 172:65be27845400 97 } LL_COMP_InitTypeDef;
AnnaBridge 172:65be27845400 98
AnnaBridge 172:65be27845400 99 /**
AnnaBridge 172:65be27845400 100 * @}
AnnaBridge 172:65be27845400 101 */
AnnaBridge 172:65be27845400 102 #endif /* USE_FULL_LL_DRIVER */
AnnaBridge 172:65be27845400 103
AnnaBridge 172:65be27845400 104 /* Exported constants --------------------------------------------------------*/
AnnaBridge 172:65be27845400 105 /** @defgroup COMP_LL_Exported_Constants COMP Exported Constants
AnnaBridge 172:65be27845400 106 * @{
AnnaBridge 172:65be27845400 107 */
AnnaBridge 172:65be27845400 108
AnnaBridge 172:65be27845400 109 /** @defgroup COMP_LL_EC_COMMON_WINDOWMODE Comparator common modes - Window mode
AnnaBridge 172:65be27845400 110 * @{
AnnaBridge 172:65be27845400 111 */
AnnaBridge 172:65be27845400 112 #define LL_COMP_WINDOWMODE_DISABLE (0x00000000UL) /*!< Window mode disable: Comparators 1 and 2 are independent */
AnnaBridge 172:65be27845400 113 #define LL_COMP_WINDOWMODE_COMP1_INPUT_PLUS_COMMON (COMP_CFGRx_WINMODE) /*!< Window mode enable: Comparators instances pair COMP1 and COMP2 have their input plus connected together. The common input is COMP1 input plus (COMP2 input plus is no more accessible). */
AnnaBridge 172:65be27845400 114 /**
AnnaBridge 172:65be27845400 115 * @}
AnnaBridge 172:65be27845400 116 */
AnnaBridge 172:65be27845400 117
AnnaBridge 172:65be27845400 118 /** @defgroup COMP_LL_EC_POWERMODE Comparator modes - Power mode
AnnaBridge 172:65be27845400 119 * @{
AnnaBridge 172:65be27845400 120 */
AnnaBridge 172:65be27845400 121 #define LL_COMP_POWERMODE_HIGHSPEED (0x00000000UL) /*!< COMP power mode to high speed */
AnnaBridge 172:65be27845400 122 #define LL_COMP_POWERMODE_MEDIUMSPEED (COMP_CFGRx_PWRMODE_0) /*!< COMP power mode to medium speed */
AnnaBridge 172:65be27845400 123 #define LL_COMP_POWERMODE_ULTRALOWPOWER (COMP_CFGRx_PWRMODE_1 | COMP_CFGRx_PWRMODE_0) /*!< COMP power mode to ultra-low power */
AnnaBridge 172:65be27845400 124 /**
AnnaBridge 172:65be27845400 125 * @}
AnnaBridge 172:65be27845400 126 */
AnnaBridge 172:65be27845400 127
AnnaBridge 172:65be27845400 128 /** @defgroup COMP_LL_EC_INPUT_PLUS Comparator inputs - Input plus (input non-inverting) selection
AnnaBridge 172:65be27845400 129 * @{
AnnaBridge 172:65be27845400 130 */
AnnaBridge 172:65be27845400 131 #define LL_COMP_INPUT_PLUS_IO1 (0x00000000UL) /*!< Comparator input plus connected to IO1 (pin PB0 for COMP1, pin PE9 for COMP2) */
AnnaBridge 172:65be27845400 132 #define LL_COMP_INPUT_PLUS_IO2 (COMP_CFGRx_INPSEL) /*!< Comparator input plus connected to IO2 (pin PB2 for COMP1, pin PE11 for COMP2) */
AnnaBridge 172:65be27845400 133 /**
AnnaBridge 172:65be27845400 134 * @}
AnnaBridge 172:65be27845400 135 */
AnnaBridge 172:65be27845400 136
AnnaBridge 172:65be27845400 137 /** @defgroup COMP_LL_EC_INPUT_MINUS Comparator inputs - Input minus (input inverting) selection
AnnaBridge 172:65be27845400 138 * @{
AnnaBridge 172:65be27845400 139 */
AnnaBridge 172:65be27845400 140 #define LL_COMP_INPUT_MINUS_1_4VREFINT ( COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN) /*!< Comparator input minus connected to 1/4 VrefInt */
AnnaBridge 172:65be27845400 141 #define LL_COMP_INPUT_MINUS_1_2VREFINT ( COMP_CFGRx_INMSEL_0 | COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN) /*!< Comparator input minus connected to 1/2 VrefInt */
AnnaBridge 172:65be27845400 142 #define LL_COMP_INPUT_MINUS_3_4VREFINT ( COMP_CFGRx_INMSEL_1 | COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN) /*!< Comparator input minus connected to 3/4 VrefInt */
AnnaBridge 172:65be27845400 143 #define LL_COMP_INPUT_MINUS_VREFINT ( COMP_CFGRx_INMSEL_1 | COMP_CFGRx_INMSEL_0 | COMP_CFGRx_SCALEN ) /*!< Comparator input minus connected to VrefInt */
AnnaBridge 172:65be27845400 144 #define LL_COMP_INPUT_MINUS_DAC1_CH1 (COMP_CFGRx_INMSEL_2 ) /*!< Comparator input minus connected to DAC1 channel 1 (DAC_OUT1) */
AnnaBridge 172:65be27845400 145 #define LL_COMP_INPUT_MINUS_DAC1_CH2 (COMP_CFGRx_INMSEL_2 | COMP_CFGRx_INMSEL_0) /*!< Comparator input minus connected to DAC1 channel 2 (DAC_OUT2) */
AnnaBridge 172:65be27845400 146 #define LL_COMP_INPUT_MINUS_IO1 (COMP_CFGRx_INMSEL_2 | COMP_CFGRx_INMSEL_1 ) /*!< Comparator input minus connected to IO1 (pin PB1 for COMP1, pin PE10 for COMP2) */
AnnaBridge 172:65be27845400 147 #define LL_COMP_INPUT_MINUS_IO2 (COMP_CFGRx_INMSEL_2 | COMP_CFGRx_INMSEL_1 | COMP_CFGRx_INMSEL_0) /*!< Comparator input minus connected to IO2 (pin PC4 for COMP1, pin PE7 for COMP2) */
AnnaBridge 172:65be27845400 148 /**
AnnaBridge 172:65be27845400 149 * @}
AnnaBridge 172:65be27845400 150 */
AnnaBridge 172:65be27845400 151
AnnaBridge 172:65be27845400 152 /** @defgroup COMP_LL_EC_INPUT_HYSTERESIS Comparator input - Hysteresis
AnnaBridge 172:65be27845400 153 * @{
AnnaBridge 172:65be27845400 154 */
AnnaBridge 172:65be27845400 155 #define LL_COMP_HYSTERESIS_NONE (0x00000000UL) /*!< No hysteresis */
AnnaBridge 172:65be27845400 156 #define LL_COMP_HYSTERESIS_LOW ( COMP_CFGRx_HYST_0) /*!< Hysteresis level low */
AnnaBridge 172:65be27845400 157 #define LL_COMP_HYSTERESIS_MEDIUM (COMP_CFGRx_HYST_1 ) /*!< Hysteresis level medium */
AnnaBridge 172:65be27845400 158 #define LL_COMP_HYSTERESIS_HIGH (COMP_CFGRx_HYST_1 | COMP_CFGRx_HYST_0) /*!< Hysteresis level high */
AnnaBridge 172:65be27845400 159 /**
AnnaBridge 172:65be27845400 160 * @}
AnnaBridge 172:65be27845400 161 */
AnnaBridge 172:65be27845400 162
AnnaBridge 172:65be27845400 163 /** @defgroup COMP_LL_EC_OUTPUT_POLARITY Comparator output - Output polarity
AnnaBridge 172:65be27845400 164 * @{
AnnaBridge 172:65be27845400 165 */
AnnaBridge 172:65be27845400 166 #define LL_COMP_OUTPUTPOL_NONINVERTED (0x00000000UL) /*!< COMP output polarity is not inverted: comparator output is high when the plus (non-inverting) input is at a higher voltage than the minus (inverting) input */
AnnaBridge 172:65be27845400 167 #define LL_COMP_OUTPUTPOL_INVERTED (COMP_CFGRx_POLARITY) /*!< COMP output polarity is inverted: comparator output is low when the plus (non-inverting) input is at a lower voltage than the minus (inverting) input */
AnnaBridge 172:65be27845400 168 /**
AnnaBridge 172:65be27845400 169 * @}
AnnaBridge 172:65be27845400 170 */
AnnaBridge 172:65be27845400 171
AnnaBridge 172:65be27845400 172 /** @defgroup COMP_LL_EC_OUTPUT_BLANKING_SOURCE Comparator output - Blanking source
AnnaBridge 172:65be27845400 173 * @{
AnnaBridge 172:65be27845400 174 */
AnnaBridge 172:65be27845400 175 #define LL_COMP_BLANKINGSRC_NONE (0x00000000UL) /*!<Comparator output without blanking */
AnnaBridge 172:65be27845400 176 #define LL_COMP_BLANKINGSRC_TIM1_OC5 (COMP_CFGRx_BLANKING_0) /*!< Comparator output blanking source TIM1 OC5 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 177 #define LL_COMP_BLANKINGSRC_TIM2_OC3 (COMP_CFGRx_BLANKING_1) /*!< Comparator output blanking source TIM2 OC3 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 178 #define LL_COMP_BLANKINGSRC_TIM3_OC3 (COMP_CFGRx_BLANKING_0 |COMP_CFGRx_BLANKING_1) /*!< Comparator output blanking source TIM3 OC3 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 179 #define LL_COMP_BLANKINGSRC_TIM3_OC4 (COMP_CFGRx_BLANKING_2) /*!< Comparator output blanking source TIM3 OC4 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 180 #define LL_COMP_BLANKINGSRC_TIM8_OC5 (COMP_CFGRx_BLANKING_2|COMP_CFGRx_BLANKING_0) /*!< Comparator output blanking source TIM8 OC5 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 181 #define LL_COMP_BLANKINGSRC_TIM15_OC1 (COMP_CFGRx_BLANKING_2|COMP_CFGRx_BLANKING_1) /*!< Comparator output blanking source TIM15 OC1 (common to all COMP instances: COMP1, COMP2) */
AnnaBridge 172:65be27845400 182 /**
AnnaBridge 172:65be27845400 183 * @}
AnnaBridge 172:65be27845400 184 */
AnnaBridge 172:65be27845400 185
AnnaBridge 172:65be27845400 186 /** @defgroup COMP_LL_EC_OUTPUT_LEVEL Comparator output - Output level
AnnaBridge 172:65be27845400 187 * @{
AnnaBridge 172:65be27845400 188 */
AnnaBridge 172:65be27845400 189 #define LL_COMP_OUTPUT_LEVEL_LOW (0x00000000UL) /*!< Comparator output level low (if the polarity is not inverted, otherwise to be complemented) */
AnnaBridge 172:65be27845400 190 #define LL_COMP_OUTPUT_LEVEL_HIGH (0x00000001UL) /*!< Comparator output level high (if the polarity is not inverted, otherwise to be complemented) */
AnnaBridge 172:65be27845400 191 /**
AnnaBridge 172:65be27845400 192 * @}
AnnaBridge 172:65be27845400 193 */
AnnaBridge 172:65be27845400 194
AnnaBridge 172:65be27845400 195 /** @defgroup COMP_LL_EC_HW_DELAYS Definitions of COMP hardware constraints delays
AnnaBridge 172:65be27845400 196 * @note Only COMP IP HW delays are defined in COMP LL driver driver,
AnnaBridge 172:65be27845400 197 * not timeout values.
AnnaBridge 172:65be27845400 198 * For details on delays values, refer to descriptions in source code
AnnaBridge 172:65be27845400 199 * above each literal definition.
AnnaBridge 172:65be27845400 200 * @{
AnnaBridge 172:65be27845400 201 */
AnnaBridge 172:65be27845400 202
AnnaBridge 172:65be27845400 203 /* Delay for comparator startup time. */
AnnaBridge 172:65be27845400 204 /* Note: Delay required to reach propagation delay specification. */
AnnaBridge 172:65be27845400 205 /* Literal set to maximum value (refer to device datasheet, */
AnnaBridge 172:65be27845400 206 /* parameter "tSTART"). */
AnnaBridge 172:65be27845400 207 /* Unit: us */
AnnaBridge 172:65be27845400 208 #define LL_COMP_DELAY_STARTUP_US ( 80UL) /*!< Delay for COMP startup time */
AnnaBridge 172:65be27845400 209
AnnaBridge 172:65be27845400 210 /* Delay for comparator voltage scaler stabilization time. */
AnnaBridge 172:65be27845400 211 /* Note: Voltage scaler is used when selecting comparator input */
AnnaBridge 172:65be27845400 212 /* based on VrefInt: VrefInt or subdivision of VrefInt. */
AnnaBridge 172:65be27845400 213 /* Literal set to maximum value (refer to device datasheet, */
AnnaBridge 172:65be27845400 214 /* parameter "tSTART_SCALER"). */
AnnaBridge 172:65be27845400 215 /* Unit: us */
AnnaBridge 172:65be27845400 216 #define LL_COMP_DELAY_VOLTAGE_SCALER_STAB_US ( 200UL) /*!< Delay for COMP voltage scaler stabilization time */
AnnaBridge 172:65be27845400 217
AnnaBridge 172:65be27845400 218 /**
AnnaBridge 172:65be27845400 219 * @}
AnnaBridge 172:65be27845400 220 */
AnnaBridge 172:65be27845400 221
AnnaBridge 172:65be27845400 222 /**
AnnaBridge 172:65be27845400 223 * @}
AnnaBridge 172:65be27845400 224 */
AnnaBridge 172:65be27845400 225
AnnaBridge 172:65be27845400 226 /* Exported macro ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 227 /** @defgroup COMP_LL_Exported_Macros COMP Exported Macros
AnnaBridge 172:65be27845400 228 * @{
AnnaBridge 172:65be27845400 229 */
AnnaBridge 172:65be27845400 230 /** @defgroup COMP_LL_EM_WRITE_READ Common write and read registers macro
AnnaBridge 172:65be27845400 231 * @{
AnnaBridge 172:65be27845400 232 */
AnnaBridge 172:65be27845400 233
AnnaBridge 172:65be27845400 234 /**
AnnaBridge 172:65be27845400 235 * @brief Write a value in COMP register
AnnaBridge 172:65be27845400 236 * @param __INSTANCE__ comparator instance
AnnaBridge 172:65be27845400 237 * @param __REG__ Register to be written
AnnaBridge 172:65be27845400 238 * @param __VALUE__ Value to be written in the register
AnnaBridge 172:65be27845400 239 * @retval None
AnnaBridge 172:65be27845400 240 */
AnnaBridge 172:65be27845400 241 #define LL_COMP_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
AnnaBridge 172:65be27845400 242
AnnaBridge 172:65be27845400 243 /**
AnnaBridge 172:65be27845400 244 * @brief Read a value in COMP register
AnnaBridge 172:65be27845400 245 * @param __INSTANCE__ comparator instance
AnnaBridge 172:65be27845400 246 * @param __REG__ Register to be read
AnnaBridge 172:65be27845400 247 * @retval Register value
AnnaBridge 172:65be27845400 248 */
AnnaBridge 172:65be27845400 249 #define LL_COMP_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
AnnaBridge 172:65be27845400 250 /**
AnnaBridge 172:65be27845400 251 * @}
AnnaBridge 172:65be27845400 252 */
AnnaBridge 172:65be27845400 253
AnnaBridge 172:65be27845400 254 /** @defgroup COMP_LL_EM_HELPER_MACRO COMP helper macro
AnnaBridge 172:65be27845400 255 * @{
AnnaBridge 172:65be27845400 256 */
AnnaBridge 172:65be27845400 257
AnnaBridge 172:65be27845400 258 /**
AnnaBridge 172:65be27845400 259 * @brief Helper macro to select the COMP common instance
AnnaBridge 172:65be27845400 260 * to which is belonging the selected COMP instance.
AnnaBridge 172:65be27845400 261 * @note COMP common register instance can be used to
AnnaBridge 172:65be27845400 262 * set parameters common to several COMP instances.
AnnaBridge 172:65be27845400 263 * Refer to functions having argument "COMPxy_COMMON" as parameter.
AnnaBridge 172:65be27845400 264 * @param __COMPx__ COMP instance
AnnaBridge 172:65be27845400 265 * @retval COMP common instance or value "0" if there is no COMP common instance.
AnnaBridge 172:65be27845400 266 */
AnnaBridge 172:65be27845400 267 #define __LL_COMP_COMMON_INSTANCE(__COMPx__) \
AnnaBridge 172:65be27845400 268 (COMP12_COMMON)
AnnaBridge 172:65be27845400 269
AnnaBridge 172:65be27845400 270 /**
AnnaBridge 172:65be27845400 271 * @}
AnnaBridge 172:65be27845400 272 */
AnnaBridge 172:65be27845400 273
AnnaBridge 172:65be27845400 274 /**
AnnaBridge 172:65be27845400 275 * @}
AnnaBridge 172:65be27845400 276 */
AnnaBridge 172:65be27845400 277
AnnaBridge 172:65be27845400 278 /* Exported functions --------------------------------------------------------*/
AnnaBridge 172:65be27845400 279 /** @defgroup COMP_LL_Exported_Functions COMP Exported Functions
AnnaBridge 172:65be27845400 280 * @{
AnnaBridge 172:65be27845400 281 */
AnnaBridge 172:65be27845400 282
AnnaBridge 172:65be27845400 283 /** @defgroup COMP_LL_EF_Configuration_comparator_common Configuration of COMP hierarchical scope: common to several COMP instances
AnnaBridge 172:65be27845400 284 * @{
AnnaBridge 172:65be27845400 285 */
AnnaBridge 172:65be27845400 286
AnnaBridge 172:65be27845400 287 /**
AnnaBridge 172:65be27845400 288 * @brief Set window mode of a pair of comparators instances
AnnaBridge 172:65be27845400 289 * (2 consecutive COMP instances odd and even COMP<x> and COMP<x+1>).
AnnaBridge 172:65be27845400 290 * @rmtoll CFGRx WINMODE LL_COMP_SetCommonWindowMode
AnnaBridge 172:65be27845400 291 * @param COMPxy_COMMON Comparator common instance
AnnaBridge 172:65be27845400 292 * (can be set directly from CMSIS definition or by using helper macro @ref __LL_COMP_COMMON_INSTANCE() )
AnnaBridge 172:65be27845400 293 * @param WindowMode This parameter can be one of the following values:
AnnaBridge 172:65be27845400 294 * @arg @ref LL_COMP_WINDOWMODE_DISABLE
AnnaBridge 172:65be27845400 295 * @arg @ref LL_COMP_WINDOWMODE_COMP1_INPUT_PLUS_COMMON
AnnaBridge 172:65be27845400 296 * @retval None
AnnaBridge 172:65be27845400 297 */
AnnaBridge 172:65be27845400 298 __STATIC_INLINE void LL_COMP_SetCommonWindowMode(COMP_Common_TypeDef *COMPxy_COMMON, uint32_t WindowMode)
AnnaBridge 172:65be27845400 299 {
AnnaBridge 172:65be27845400 300 /* Note: On this STM32 serie, window mode can be set only */
AnnaBridge 172:65be27845400 301 /* from COMP instance: COMP2. */
AnnaBridge 172:65be27845400 302 MODIFY_REG(COMPxy_COMMON->CFGR, COMP_CFGRx_WINMODE, WindowMode);
AnnaBridge 172:65be27845400 303 }
AnnaBridge 172:65be27845400 304
AnnaBridge 172:65be27845400 305 /**
AnnaBridge 172:65be27845400 306 * @brief Get window mode of a pair of comparators instances
AnnaBridge 172:65be27845400 307 * (2 consecutive COMP instances odd and even COMP<x> and COMP<x+1>).
AnnaBridge 172:65be27845400 308 * @rmtoll CFGRx WINMODE LL_COMP_GetCommonWindowMode
AnnaBridge 172:65be27845400 309 * @param COMPxy_COMMON Comparator common instance
AnnaBridge 172:65be27845400 310 * (can be set directly from CMSIS definition or by using helper macro @ref __LL_COMP_COMMON_INSTANCE() )
AnnaBridge 172:65be27845400 311 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 312 * @arg @ref LL_COMP_WINDOWMODE_DISABLE
AnnaBridge 172:65be27845400 313 * @arg @ref LL_COMP_WINDOWMODE_COMP1_INPUT_PLUS_COMMON
AnnaBridge 172:65be27845400 314 */
AnnaBridge 172:65be27845400 315 __STATIC_INLINE uint32_t LL_COMP_GetCommonWindowMode(COMP_Common_TypeDef *COMPxy_COMMON)
AnnaBridge 172:65be27845400 316 {
AnnaBridge 172:65be27845400 317 return (uint32_t)(READ_BIT(COMPxy_COMMON->CFGR, COMP_CFGRx_WINMODE));
AnnaBridge 172:65be27845400 318 }
AnnaBridge 172:65be27845400 319
AnnaBridge 172:65be27845400 320 /**
AnnaBridge 172:65be27845400 321 * @}
AnnaBridge 172:65be27845400 322 */
AnnaBridge 172:65be27845400 323
AnnaBridge 172:65be27845400 324 /** @defgroup COMP_LL_EF_Configuration_comparator_modes Configuration of comparator modes
AnnaBridge 172:65be27845400 325 * @{
AnnaBridge 172:65be27845400 326 */
AnnaBridge 172:65be27845400 327
AnnaBridge 172:65be27845400 328 /**
AnnaBridge 172:65be27845400 329 * @brief Set comparator instance operating mode to adjust power and speed.
AnnaBridge 172:65be27845400 330 * @rmtoll CFGRx PWRMODE LL_COMP_SetPowerMode
AnnaBridge 172:65be27845400 331 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 332 * @param PowerMode This parameter can be one of the following values:
AnnaBridge 172:65be27845400 333 * @arg @ref LL_COMP_POWERMODE_HIGHSPEED
AnnaBridge 172:65be27845400 334 * @arg @ref LL_COMP_POWERMODE_MEDIUMSPEED
AnnaBridge 172:65be27845400 335 * @arg @ref LL_COMP_POWERMODE_ULTRALOWPOWER
AnnaBridge 172:65be27845400 336 * @retval None
AnnaBridge 172:65be27845400 337 */
AnnaBridge 172:65be27845400 338 __STATIC_INLINE void LL_COMP_SetPowerMode(COMP_TypeDef *COMPx, uint32_t PowerMode)
AnnaBridge 172:65be27845400 339 {
AnnaBridge 172:65be27845400 340 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_PWRMODE, PowerMode);
AnnaBridge 172:65be27845400 341 }
AnnaBridge 172:65be27845400 342
AnnaBridge 172:65be27845400 343 /**
AnnaBridge 172:65be27845400 344 * @brief Get comparator instance operating mode to adjust power and speed.
AnnaBridge 172:65be27845400 345 * @rmtoll CFGRx PWRMODE LL_COMP_GetPowerMode
AnnaBridge 172:65be27845400 346 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 347 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 348 * @arg @ref LL_COMP_POWERMODE_HIGHSPEED
AnnaBridge 172:65be27845400 349 * @arg @ref LL_COMP_POWERMODE_MEDIUMSPEED
AnnaBridge 172:65be27845400 350 * @arg @ref LL_COMP_POWERMODE_ULTRALOWPOWER
AnnaBridge 172:65be27845400 351 */
AnnaBridge 172:65be27845400 352 __STATIC_INLINE uint32_t LL_COMP_GetPowerMode(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 353 {
AnnaBridge 172:65be27845400 354 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_PWRMODE));
AnnaBridge 172:65be27845400 355 }
AnnaBridge 172:65be27845400 356
AnnaBridge 172:65be27845400 357 /**
AnnaBridge 172:65be27845400 358 * @}
AnnaBridge 172:65be27845400 359 */
AnnaBridge 172:65be27845400 360
AnnaBridge 172:65be27845400 361 /** @defgroup COMP_LL_EF_Configuration_comparator_inputs Configuration of comparator inputs
AnnaBridge 172:65be27845400 362 * @{
AnnaBridge 172:65be27845400 363 */
AnnaBridge 172:65be27845400 364
AnnaBridge 172:65be27845400 365 /**
AnnaBridge 172:65be27845400 366 * @brief Set comparator inputs minus (inverting) and plus (non-inverting).
AnnaBridge 172:65be27845400 367 * @note In case of comparator input selected to be connected to IO:
AnnaBridge 172:65be27845400 368 * GPIO pins are specific to each comparator instance.
AnnaBridge 172:65be27845400 369 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 370 * @note On this STM32 serie, scaler bridge is configurable:
AnnaBridge 172:65be27845400 371 * to optimize power consumption, this function enables the
AnnaBridge 172:65be27845400 372 * voltage scaler bridge only when required
AnnaBridge 172:65be27845400 373 * (when selecting comparator input based on VrefInt: VrefInt or
AnnaBridge 172:65be27845400 374 * subdivision of VrefInt).
AnnaBridge 172:65be27845400 375 * - For scaler bridge power consumption values,
AnnaBridge 172:65be27845400 376 * refer to device datasheet, parameter "IDDA(SCALER)".
AnnaBridge 172:65be27845400 377 * - Voltage scaler requires a delay for voltage stabilization.
AnnaBridge 172:65be27845400 378 * Refer to device datasheet, parameter "tSTART_SCALER".
AnnaBridge 172:65be27845400 379 * - Scaler bridge is common for all comparator instances,
AnnaBridge 172:65be27845400 380 * therefore if at least one of the comparator instance
AnnaBridge 172:65be27845400 381 * is requiring the scaler bridge, it remains enabled.
AnnaBridge 172:65be27845400 382 * @rmtoll CFGRx INMSEL LL_COMP_ConfigInputs\n
AnnaBridge 172:65be27845400 383 * CFGRx INPSEL LL_COMP_ConfigInputs\n
AnnaBridge 172:65be27845400 384 * CFGRx BRGEN LL_COMP_ConfigInputs\n
AnnaBridge 172:65be27845400 385 * CFGRx SCALEN LL_COMP_ConfigInputs
AnnaBridge 172:65be27845400 386 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 387 * @param InputMinus This parameter can be one of the following values:
AnnaBridge 172:65be27845400 388 * @arg @ref LL_COMP_INPUT_MINUS_1_4VREFINT
AnnaBridge 172:65be27845400 389 * @arg @ref LL_COMP_INPUT_MINUS_1_2VREFINT
AnnaBridge 172:65be27845400 390 * @arg @ref LL_COMP_INPUT_MINUS_3_4VREFINT
AnnaBridge 172:65be27845400 391 * @arg @ref LL_COMP_INPUT_MINUS_VREFINT
AnnaBridge 172:65be27845400 392 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH1
AnnaBridge 172:65be27845400 393 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH2
AnnaBridge 172:65be27845400 394 * @arg @ref LL_COMP_INPUT_MINUS_IO1
AnnaBridge 172:65be27845400 395 * @arg @ref LL_COMP_INPUT_MINUS_IO2
AnnaBridge 172:65be27845400 396 * @param InputPlus This parameter can be one of the following values:
AnnaBridge 172:65be27845400 397 * @arg @ref LL_COMP_INPUT_PLUS_IO1
AnnaBridge 172:65be27845400 398 * @arg @ref LL_COMP_INPUT_PLUS_IO2
AnnaBridge 172:65be27845400 399 * @retval None
AnnaBridge 172:65be27845400 400 */
AnnaBridge 172:65be27845400 401 __STATIC_INLINE void LL_COMP_ConfigInputs(COMP_TypeDef *COMPx, uint32_t InputMinus, uint32_t InputPlus)
AnnaBridge 172:65be27845400 402 {
AnnaBridge 172:65be27845400 403 MODIFY_REG(COMPx->CFGR,
AnnaBridge 172:65be27845400 404 COMP_CFGRx_INMSEL | COMP_CFGRx_INPSEL | COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN,
AnnaBridge 172:65be27845400 405 InputMinus | InputPlus);
AnnaBridge 172:65be27845400 406 }
AnnaBridge 172:65be27845400 407
AnnaBridge 172:65be27845400 408 /**
AnnaBridge 172:65be27845400 409 * @brief Set comparator input plus (non-inverting).
AnnaBridge 172:65be27845400 410 * @note In case of comparator input selected to be connected to IO:
AnnaBridge 172:65be27845400 411 * GPIO pins are specific to each comparator instance.
AnnaBridge 172:65be27845400 412 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 413 * @rmtoll CFGRx INPSEL LL_COMP_SetInputPlus
AnnaBridge 172:65be27845400 414 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 415 * @param InputPlus This parameter can be one of the following values:
AnnaBridge 172:65be27845400 416 * @arg @ref LL_COMP_INPUT_PLUS_IO1
AnnaBridge 172:65be27845400 417 * @arg @ref LL_COMP_INPUT_PLUS_IO2
AnnaBridge 172:65be27845400 418 * @retval None
AnnaBridge 172:65be27845400 419 */
AnnaBridge 172:65be27845400 420 __STATIC_INLINE void LL_COMP_SetInputPlus(COMP_TypeDef *COMPx, uint32_t InputPlus)
AnnaBridge 172:65be27845400 421 {
AnnaBridge 172:65be27845400 422 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_INPSEL, InputPlus);
AnnaBridge 172:65be27845400 423 }
AnnaBridge 172:65be27845400 424
AnnaBridge 172:65be27845400 425 /**
AnnaBridge 172:65be27845400 426 * @brief Get comparator input plus (non-inverting).
AnnaBridge 172:65be27845400 427 * @note In case of comparator input selected to be connected to IO:
AnnaBridge 172:65be27845400 428 * GPIO pins are specific to each comparator instance.
AnnaBridge 172:65be27845400 429 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 430 * @rmtoll CFGRx INPSEL LL_COMP_GetInputPlus
AnnaBridge 172:65be27845400 431 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 432 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 433 * @arg @ref LL_COMP_INPUT_PLUS_IO1
AnnaBridge 172:65be27845400 434 * @arg @ref LL_COMP_INPUT_PLUS_IO2
AnnaBridge 172:65be27845400 435 */
AnnaBridge 172:65be27845400 436 __STATIC_INLINE uint32_t LL_COMP_GetInputPlus(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 437 {
AnnaBridge 172:65be27845400 438 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_INPSEL));
AnnaBridge 172:65be27845400 439 }
AnnaBridge 172:65be27845400 440
AnnaBridge 172:65be27845400 441 /**
AnnaBridge 172:65be27845400 442 * @brief Set comparator input minus (inverting).
AnnaBridge 172:65be27845400 443 * @note In case of comparator input selected to be connected to IO:
AnnaBridge 172:65be27845400 444 * GPIO pins are specific to each comparator instance.
AnnaBridge 172:65be27845400 445 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 446 * @note On this STM32 serie, scaler bridge is configurable:
AnnaBridge 172:65be27845400 447 * to optimize power consumption, this function enables the
AnnaBridge 172:65be27845400 448 * voltage scaler bridge only when required
AnnaBridge 172:65be27845400 449 * (when selecting comparator input based on VrefInt: VrefInt or
AnnaBridge 172:65be27845400 450 * subdivision of VrefInt).
AnnaBridge 172:65be27845400 451 * - For scaler bridge power consumption values,
AnnaBridge 172:65be27845400 452 * refer to device datasheet, parameter "IDDA(SCALER)".
AnnaBridge 172:65be27845400 453 * - Voltage scaler requires a delay for voltage stabilization.
AnnaBridge 172:65be27845400 454 * Refer to device datasheet, parameter "tSTART_SCALER".
AnnaBridge 172:65be27845400 455 * - Scaler bridge is common for all comparator instances,
AnnaBridge 172:65be27845400 456 * therefore if at least one of the comparator instance
AnnaBridge 172:65be27845400 457 * is requiring the scaler bridge, it remains enabled.
AnnaBridge 172:65be27845400 458 * @rmtoll CFGRx INMSEL LL_COMP_SetInputMinus\n
AnnaBridge 172:65be27845400 459 * CFGRx BRGEN LL_COMP_SetInputMinus\n
AnnaBridge 172:65be27845400 460 * CFGRx SCALEN LL_COMP_SetInputMinus
AnnaBridge 172:65be27845400 461 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 462 * @param InputMinus This parameter can be one of the following values:
AnnaBridge 172:65be27845400 463 * @arg @ref LL_COMP_INPUT_MINUS_1_4VREFINT
AnnaBridge 172:65be27845400 464 * @arg @ref LL_COMP_INPUT_MINUS_1_2VREFINT
AnnaBridge 172:65be27845400 465 * @arg @ref LL_COMP_INPUT_MINUS_3_4VREFINT
AnnaBridge 172:65be27845400 466 * @arg @ref LL_COMP_INPUT_MINUS_VREFINT
AnnaBridge 172:65be27845400 467 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH1
AnnaBridge 172:65be27845400 468 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH2
AnnaBridge 172:65be27845400 469 * @arg @ref LL_COMP_INPUT_MINUS_IO1
AnnaBridge 172:65be27845400 470 * @arg @ref LL_COMP_INPUT_MINUS_IO2
AnnaBridge 172:65be27845400 471 * @retval None
AnnaBridge 172:65be27845400 472 */
AnnaBridge 172:65be27845400 473 __STATIC_INLINE void LL_COMP_SetInputMinus(COMP_TypeDef *COMPx, uint32_t InputMinus)
AnnaBridge 172:65be27845400 474 {
AnnaBridge 172:65be27845400 475 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_INMSEL | COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN, InputMinus);
AnnaBridge 172:65be27845400 476 }
AnnaBridge 172:65be27845400 477
AnnaBridge 172:65be27845400 478 /**
AnnaBridge 172:65be27845400 479 * @brief Get comparator input minus (inverting).
AnnaBridge 172:65be27845400 480 * @note In case of comparator input selected to be connected to IO:
AnnaBridge 172:65be27845400 481 * GPIO pins are specific to each comparator instance.
AnnaBridge 172:65be27845400 482 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 483 * @rmtoll CFGRx INMSEL LL_COMP_GetInputMinus\n
AnnaBridge 172:65be27845400 484 * CFGRx BRGEN LL_COMP_GetInputMinus\n
AnnaBridge 172:65be27845400 485 * CFGRx SCALEN LL_COMP_GetInputMinus
AnnaBridge 172:65be27845400 486 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 487 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 488 * @arg @ref LL_COMP_INPUT_MINUS_1_4VREFINT
AnnaBridge 172:65be27845400 489 * @arg @ref LL_COMP_INPUT_MINUS_1_2VREFINT
AnnaBridge 172:65be27845400 490 * @arg @ref LL_COMP_INPUT_MINUS_3_4VREFINT
AnnaBridge 172:65be27845400 491 * @arg @ref LL_COMP_INPUT_MINUS_VREFINT
AnnaBridge 172:65be27845400 492 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH1
AnnaBridge 172:65be27845400 493 * @arg @ref LL_COMP_INPUT_MINUS_DAC1_CH2
AnnaBridge 172:65be27845400 494 * @arg @ref LL_COMP_INPUT_MINUS_IO1
AnnaBridge 172:65be27845400 495 * @arg @ref LL_COMP_INPUT_MINUS_IO2
AnnaBridge 172:65be27845400 496 */
AnnaBridge 172:65be27845400 497 __STATIC_INLINE uint32_t LL_COMP_GetInputMinus(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 498 {
AnnaBridge 172:65be27845400 499 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_INMSEL | COMP_CFGRx_SCALEN | COMP_CFGRx_BRGEN));
AnnaBridge 172:65be27845400 500 }
AnnaBridge 172:65be27845400 501
AnnaBridge 172:65be27845400 502 /**
AnnaBridge 172:65be27845400 503 * @brief Set comparator instance hysteresis mode of the input minus (inverting input).
AnnaBridge 172:65be27845400 504 * @rmtoll CFGRx HYST LL_COMP_SetInputHysteresis
AnnaBridge 172:65be27845400 505 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 506 * @param InputHysteresis This parameter can be one of the following values:
AnnaBridge 172:65be27845400 507 * @arg @ref LL_COMP_HYSTERESIS_NONE
AnnaBridge 172:65be27845400 508 * @arg @ref LL_COMP_HYSTERESIS_LOW
AnnaBridge 172:65be27845400 509 * @arg @ref LL_COMP_HYSTERESIS_MEDIUM
AnnaBridge 172:65be27845400 510 * @arg @ref LL_COMP_HYSTERESIS_HIGH
AnnaBridge 172:65be27845400 511 * @retval None
AnnaBridge 172:65be27845400 512 */
AnnaBridge 172:65be27845400 513 __STATIC_INLINE void LL_COMP_SetInputHysteresis(COMP_TypeDef *COMPx, uint32_t InputHysteresis)
AnnaBridge 172:65be27845400 514 {
AnnaBridge 172:65be27845400 515 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_HYST, InputHysteresis);
AnnaBridge 172:65be27845400 516 }
AnnaBridge 172:65be27845400 517
AnnaBridge 172:65be27845400 518 /**
AnnaBridge 172:65be27845400 519 * @brief Get comparator instance hysteresis mode of the minus (inverting) input.
AnnaBridge 172:65be27845400 520 * @rmtoll CSR HYST LL_COMP_GetInputHysteresis
AnnaBridge 172:65be27845400 521 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 522 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 523 * @arg @ref LL_COMP_HYSTERESIS_NONE
AnnaBridge 172:65be27845400 524 * @arg @ref LL_COMP_HYSTERESIS_LOW
AnnaBridge 172:65be27845400 525 * @arg @ref LL_COMP_HYSTERESIS_MEDIUM
AnnaBridge 172:65be27845400 526 * @arg @ref LL_COMP_HYSTERESIS_HIGH
AnnaBridge 172:65be27845400 527 */
AnnaBridge 172:65be27845400 528 __STATIC_INLINE uint32_t LL_COMP_GetInputHysteresis(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 529 {
AnnaBridge 172:65be27845400 530 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_HYST));
AnnaBridge 172:65be27845400 531 }
AnnaBridge 172:65be27845400 532
AnnaBridge 172:65be27845400 533 /**
AnnaBridge 172:65be27845400 534 * @}
AnnaBridge 172:65be27845400 535 */
AnnaBridge 172:65be27845400 536
AnnaBridge 172:65be27845400 537 /** @defgroup COMP_LL_EF_Configuration_comparator_output Configuration of comparator output
AnnaBridge 172:65be27845400 538 * @{
AnnaBridge 172:65be27845400 539 */
AnnaBridge 172:65be27845400 540
AnnaBridge 172:65be27845400 541 /**
AnnaBridge 172:65be27845400 542 * @brief Set comparator instance output polarity.
AnnaBridge 172:65be27845400 543 * @rmtoll CFGRx POLARITY LL_COMP_SetOutputPolarity
AnnaBridge 172:65be27845400 544 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 545 * @param OutputPolarity This parameter can be one of the following values:
AnnaBridge 172:65be27845400 546 * @arg @ref LL_COMP_OUTPUTPOL_NONINVERTED
AnnaBridge 172:65be27845400 547 * @arg @ref LL_COMP_OUTPUTPOL_INVERTED
AnnaBridge 172:65be27845400 548 * @retval None
AnnaBridge 172:65be27845400 549 */
AnnaBridge 172:65be27845400 550 __STATIC_INLINE void LL_COMP_SetOutputPolarity(COMP_TypeDef *COMPx, uint32_t OutputPolarity)
AnnaBridge 172:65be27845400 551 {
AnnaBridge 172:65be27845400 552 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_POLARITY, OutputPolarity);
AnnaBridge 172:65be27845400 553 }
AnnaBridge 172:65be27845400 554
AnnaBridge 172:65be27845400 555 /**
AnnaBridge 172:65be27845400 556 * @brief Get comparator instance output polarity.
AnnaBridge 172:65be27845400 557 * @rmtoll CFGRx POLARITY LL_COMP_GetOutputPolarity
AnnaBridge 172:65be27845400 558 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 559 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 560 * @arg @ref LL_COMP_OUTPUTPOL_NONINVERTED
AnnaBridge 172:65be27845400 561 * @arg @ref LL_COMP_OUTPUTPOL_INVERTED
AnnaBridge 172:65be27845400 562 */
AnnaBridge 172:65be27845400 563 __STATIC_INLINE uint32_t LL_COMP_GetOutputPolarity(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 564 {
AnnaBridge 172:65be27845400 565 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_POLARITY));
AnnaBridge 172:65be27845400 566 }
AnnaBridge 172:65be27845400 567
AnnaBridge 172:65be27845400 568 /**
AnnaBridge 172:65be27845400 569 * @brief Set comparator instance blanking source.
AnnaBridge 172:65be27845400 570 * @note Blanking source may be specific to each comparator instance.
AnnaBridge 172:65be27845400 571 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 572 * @note Availability of parameters of blanking source from timer
AnnaBridge 172:65be27845400 573 * depends on timers availability on the selected device.
AnnaBridge 172:65be27845400 574 * @rmtoll CFGR BLANKING LL_COMP_SetOutputBlankingSource
AnnaBridge 172:65be27845400 575 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 576 * @param BlankingSource This parameter can be one of the following values:
AnnaBridge 172:65be27845400 577 * @arg @ref LL_COMP_BLANKINGSRC_NONE
AnnaBridge 172:65be27845400 578 * @arg @ref LL_COMP_BLANKINGSRC_TIM1_OC5
AnnaBridge 172:65be27845400 579 * @arg @ref LL_COMP_BLANKINGSRC_TIM2_OC3
AnnaBridge 172:65be27845400 580 * @arg @ref LL_COMP_BLANKINGSRC_TIM3_OC3
AnnaBridge 172:65be27845400 581 * @arg @ref LL_COMP_BLANKINGSRC_TIM3_OC4
AnnaBridge 172:65be27845400 582 * @arg @ref LL_COMP_BLANKINGSRC_TIM8_OC5
AnnaBridge 172:65be27845400 583 * @arg @ref LL_COMP_BLANKINGSRC_TIM15_OC1
AnnaBridge 172:65be27845400 584 * @retval None
AnnaBridge 172:65be27845400 585 */
AnnaBridge 172:65be27845400 586 __STATIC_INLINE void LL_COMP_SetOutputBlankingSource(COMP_TypeDef *COMPx, uint32_t BlankingSource)
AnnaBridge 172:65be27845400 587 {
AnnaBridge 172:65be27845400 588 MODIFY_REG(COMPx->CFGR, COMP_CFGRx_BLANKING, BlankingSource);
AnnaBridge 172:65be27845400 589 }
AnnaBridge 172:65be27845400 590
AnnaBridge 172:65be27845400 591 /**
AnnaBridge 172:65be27845400 592 * @brief Get comparator instance blanking source.
AnnaBridge 172:65be27845400 593 * @note Availability of parameters of blanking source from timer
AnnaBridge 172:65be27845400 594 * depends on timers availability on the selected device.
AnnaBridge 172:65be27845400 595 * @note Blanking source may be specific to each comparator instance.
AnnaBridge 172:65be27845400 596 * Refer to description of parameters or to reference manual.
AnnaBridge 172:65be27845400 597 * @rmtoll CFGR BLANKING LL_COMP_GetOutputBlankingSource
AnnaBridge 172:65be27845400 598 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 599 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 600 * @arg @ref LL_COMP_BLANKINGSRC_NONE
AnnaBridge 172:65be27845400 601 * @arg @ref LL_COMP_BLANKINGSRC_TIM1_OC5
AnnaBridge 172:65be27845400 602 * @arg @ref LL_COMP_BLANKINGSRC_TIM2_OC3
AnnaBridge 172:65be27845400 603 * @arg @ref LL_COMP_BLANKINGSRC_TIM3_OC3
AnnaBridge 172:65be27845400 604 * @arg @ref LL_COMP_BLANKINGSRC_TIM3_OC4
AnnaBridge 172:65be27845400 605 * @arg @ref LL_COMP_BLANKINGSRC_TIM8_OC5
AnnaBridge 172:65be27845400 606 * @arg @ref LL_COMP_BLANKINGSRC_TIM15_OC1
AnnaBridge 172:65be27845400 607 */
AnnaBridge 172:65be27845400 608 __STATIC_INLINE uint32_t LL_COMP_GetOutputBlankingSource(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 609 {
AnnaBridge 172:65be27845400 610 return (uint32_t)(READ_BIT(COMPx->CFGR, COMP_CFGRx_BLANKING));
AnnaBridge 172:65be27845400 611 }
AnnaBridge 172:65be27845400 612
AnnaBridge 172:65be27845400 613 /**
AnnaBridge 172:65be27845400 614 * @}
AnnaBridge 172:65be27845400 615 */
AnnaBridge 172:65be27845400 616
AnnaBridge 172:65be27845400 617 /** @defgroup COMP_LL_EF_Operation Operation on comparator instance
AnnaBridge 172:65be27845400 618 * @{
AnnaBridge 172:65be27845400 619 */
AnnaBridge 172:65be27845400 620
AnnaBridge 172:65be27845400 621 /**
AnnaBridge 172:65be27845400 622 * @brief Enable comparator instance.
AnnaBridge 172:65be27845400 623 * @note After enable from off state, comparator requires a delay
AnnaBridge 172:65be27845400 624 * to reach reach propagation delay specification.
AnnaBridge 172:65be27845400 625 * Refer to device datasheet, parameter "tSTART".
AnnaBridge 172:65be27845400 626 * @rmtoll CFGR EN LL_COMP_Enable
AnnaBridge 172:65be27845400 627 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 628 * @retval None
AnnaBridge 172:65be27845400 629 */
AnnaBridge 172:65be27845400 630 __STATIC_INLINE void LL_COMP_Enable(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 631 {
AnnaBridge 172:65be27845400 632 SET_BIT(COMPx->CFGR, COMP_CFGRx_EN);
AnnaBridge 172:65be27845400 633 }
AnnaBridge 172:65be27845400 634
AnnaBridge 172:65be27845400 635 /**
AnnaBridge 172:65be27845400 636 * @brief Disable comparator instance.
AnnaBridge 172:65be27845400 637 * @rmtoll CFGR EN LL_COMP_Disable
AnnaBridge 172:65be27845400 638 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 639 * @retval None
AnnaBridge 172:65be27845400 640 */
AnnaBridge 172:65be27845400 641 __STATIC_INLINE void LL_COMP_Disable(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 642 {
AnnaBridge 172:65be27845400 643 CLEAR_BIT(COMPx->CFGR, COMP_CFGRx_EN);
AnnaBridge 172:65be27845400 644 }
AnnaBridge 172:65be27845400 645
AnnaBridge 172:65be27845400 646 /**
AnnaBridge 172:65be27845400 647 * @brief Get comparator enable state
AnnaBridge 172:65be27845400 648 * (0: COMP is disabled, 1: COMP is enabled)
AnnaBridge 172:65be27845400 649 * @rmtoll CFGR EN LL_COMP_IsEnabled
AnnaBridge 172:65be27845400 650 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 651 * @retval State of bit (1 or 0).
AnnaBridge 172:65be27845400 652 */
AnnaBridge 172:65be27845400 653 __STATIC_INLINE uint32_t LL_COMP_IsEnabled(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 654 {
AnnaBridge 172:65be27845400 655 return ((READ_BIT(COMPx->CFGR, COMP_CFGRx_EN) == (COMP_CFGRx_EN)) ? 1UL : 0UL);
AnnaBridge 172:65be27845400 656 }
AnnaBridge 172:65be27845400 657
AnnaBridge 172:65be27845400 658 /**
AnnaBridge 172:65be27845400 659 * @brief Lock comparator instance.
AnnaBridge 172:65be27845400 660 * @note Once locked, comparator configuration can be accessed in read-only.
AnnaBridge 172:65be27845400 661 * @note The only way to unlock the comparator is a device hardware reset.
AnnaBridge 172:65be27845400 662 * @rmtoll CFGR LOCK LL_COMP_Lock
AnnaBridge 172:65be27845400 663 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 664 * @retval None
AnnaBridge 172:65be27845400 665 */
AnnaBridge 172:65be27845400 666 __STATIC_INLINE void LL_COMP_Lock(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 667 {
AnnaBridge 172:65be27845400 668 SET_BIT(COMPx->CFGR, COMP_CFGRx_LOCK);
AnnaBridge 172:65be27845400 669 }
AnnaBridge 172:65be27845400 670
AnnaBridge 172:65be27845400 671 /**
AnnaBridge 172:65be27845400 672 * @brief Get comparator lock state
AnnaBridge 172:65be27845400 673 * (0: COMP is unlocked, 1: COMP is locked).
AnnaBridge 172:65be27845400 674 * @note Once locked, comparator configuration can be accessed in read-only.
AnnaBridge 172:65be27845400 675 * @note The only way to unlock the comparator is a device hardware reset.
AnnaBridge 172:65be27845400 676 * @rmtoll CFGR LOCK LL_COMP_IsLocked
AnnaBridge 172:65be27845400 677 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 678 * @retval State of bit (1 or 0).
AnnaBridge 172:65be27845400 679 */
AnnaBridge 172:65be27845400 680 __STATIC_INLINE uint32_t LL_COMP_IsLocked(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 681 {
AnnaBridge 172:65be27845400 682 return ((READ_BIT(COMPx->CFGR, COMP_CFGRx_LOCK) == (COMP_CFGRx_LOCK)) ? 1UL : 0UL);
AnnaBridge 172:65be27845400 683 }
AnnaBridge 172:65be27845400 684
AnnaBridge 172:65be27845400 685 /**
AnnaBridge 172:65be27845400 686 * @brief Read comparator instance output level.
AnnaBridge 172:65be27845400 687 * @note The comparator output level depends on the selected polarity
AnnaBridge 172:65be27845400 688 * (Refer to function @ref LL_COMP_SetOutputPolarity()).
AnnaBridge 172:65be27845400 689 * If the comparator polarity is not inverted:
AnnaBridge 172:65be27845400 690 * - Comparator output is low when the input plus
AnnaBridge 172:65be27845400 691 * is at a lower voltage than the input minus
AnnaBridge 172:65be27845400 692 * - Comparator output is high when the input plus
AnnaBridge 172:65be27845400 693 * is at a higher voltage than the input minus
AnnaBridge 172:65be27845400 694 * If the comparator polarity is inverted:
AnnaBridge 172:65be27845400 695 * - Comparator output is high when the input plus
AnnaBridge 172:65be27845400 696 * is at a lower voltage than the input minus
AnnaBridge 172:65be27845400 697 * - Comparator output is low when the input plus
AnnaBridge 172:65be27845400 698 * is at a higher voltage than the input minus
AnnaBridge 172:65be27845400 699 * @rmtoll CFGR VALUE LL_COMP_ReadOutputLevel
AnnaBridge 172:65be27845400 700 * @param COMPx Comparator instance
AnnaBridge 172:65be27845400 701 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 702 * @arg @ref LL_COMP_OUTPUT_LEVEL_LOW
AnnaBridge 172:65be27845400 703 * @arg @ref LL_COMP_OUTPUT_LEVEL_HIGH
AnnaBridge 172:65be27845400 704 */
AnnaBridge 172:65be27845400 705 __STATIC_INLINE uint32_t LL_COMP_ReadOutputLevel(COMP_TypeDef *COMPx)
AnnaBridge 172:65be27845400 706 {
AnnaBridge 172:65be27845400 707 if (COMPx == COMP1)
AnnaBridge 172:65be27845400 708 {
AnnaBridge 172:65be27845400 709 return (uint32_t)(READ_BIT(COMP12->SR, COMP_SR_C1VAL));
AnnaBridge 172:65be27845400 710 }
AnnaBridge 172:65be27845400 711 else
AnnaBridge 172:65be27845400 712 {
AnnaBridge 172:65be27845400 713 return (uint32_t)((READ_BIT(COMP12->SR, COMP_SR_C2VAL))>> 1);
AnnaBridge 172:65be27845400 714 }
AnnaBridge 172:65be27845400 715 }
AnnaBridge 172:65be27845400 716
AnnaBridge 172:65be27845400 717 /**
AnnaBridge 172:65be27845400 718 * @}
AnnaBridge 172:65be27845400 719 */
AnnaBridge 172:65be27845400 720
AnnaBridge 172:65be27845400 721 #if defined(USE_FULL_LL_DRIVER)
AnnaBridge 172:65be27845400 722 /** @defgroup COMP_LL_EF_Init Initialization and de-initialization functions
AnnaBridge 172:65be27845400 723 * @{
AnnaBridge 172:65be27845400 724 */
AnnaBridge 172:65be27845400 725
AnnaBridge 172:65be27845400 726 ErrorStatus LL_COMP_DeInit(COMP_TypeDef *COMPx);
AnnaBridge 172:65be27845400 727 ErrorStatus LL_COMP_Init(COMP_TypeDef *COMPx, LL_COMP_InitTypeDef *COMP_InitStruct);
AnnaBridge 172:65be27845400 728 void LL_COMP_StructInit(LL_COMP_InitTypeDef *COMP_InitStruct);
AnnaBridge 172:65be27845400 729
AnnaBridge 172:65be27845400 730 /**
AnnaBridge 172:65be27845400 731 * @}
AnnaBridge 172:65be27845400 732 */
AnnaBridge 172:65be27845400 733 #endif /* USE_FULL_LL_DRIVER */
AnnaBridge 172:65be27845400 734
AnnaBridge 172:65be27845400 735 /**
AnnaBridge 172:65be27845400 736 * @}
AnnaBridge 172:65be27845400 737 */
AnnaBridge 172:65be27845400 738
AnnaBridge 172:65be27845400 739 /**
AnnaBridge 172:65be27845400 740 * @}
AnnaBridge 172:65be27845400 741 */
AnnaBridge 172:65be27845400 742
AnnaBridge 172:65be27845400 743 #endif /* COMP1 || COMP2 */
AnnaBridge 172:65be27845400 744
AnnaBridge 172:65be27845400 745 /**
AnnaBridge 172:65be27845400 746 * @}
AnnaBridge 172:65be27845400 747 */
AnnaBridge 172:65be27845400 748
AnnaBridge 172:65be27845400 749 #ifdef __cplusplus
AnnaBridge 172:65be27845400 750 }
AnnaBridge 172:65be27845400 751 #endif
AnnaBridge 172:65be27845400 752
AnnaBridge 172:65be27845400 753 #endif /* __STM32H7xx_LL_COMP_H */
AnnaBridge 172:65be27845400 754
AnnaBridge 172:65be27845400 755 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/