mbed official / mbed-dev

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

Committer:
<>
Date:
Fri Sep 16 16:24:25 2016 +0100
Revision:
147:30b64687e01f
Parent:
144:ef7eb2e8f9f7
This updates the lib to the mbed lib v126

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32l4xx_hal_comp.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.5.1
<> 144:ef7eb2e8f9f7 6 * @date 31-May-2016
<> 144:ef7eb2e8f9f7 7 * @brief COMP HAL module driver.
<> 144:ef7eb2e8f9f7 8 * This file provides firmware functions to manage the following
<> 144:ef7eb2e8f9f7 9 * functionalities of the COMP peripheral:
<> 144:ef7eb2e8f9f7 10 * + Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 11 * + Start/Stop operation functions in polling mode
<> 144:ef7eb2e8f9f7 12 * + Start/Stop operation functions in interrupt mode (through EXTI interrupt)
<> 144:ef7eb2e8f9f7 13 * + Peripheral control functions
<> 144:ef7eb2e8f9f7 14 * + Peripheral state functions
<> 144:ef7eb2e8f9f7 15 *
<> 144:ef7eb2e8f9f7 16 @verbatim
<> 144:ef7eb2e8f9f7 17 ================================================================================
<> 144:ef7eb2e8f9f7 18 ##### COMP Peripheral features #####
<> 144:ef7eb2e8f9f7 19 ================================================================================
<> 144:ef7eb2e8f9f7 20
<> 144:ef7eb2e8f9f7 21 [..]
<> 144:ef7eb2e8f9f7 22 The STM32L4xx device family integrates two analog comparators instances
<> 144:ef7eb2e8f9f7 23 COMP1 and COMP2:
<> 144:ef7eb2e8f9f7 24 (#) The COMP input minus (inverting input) and input plus (non inverting input)
<> 144:ef7eb2e8f9f7 25 can be set to internal references or to GPIO pins
<> 144:ef7eb2e8f9f7 26 (refer to GPIO list in reference manual).
<> 144:ef7eb2e8f9f7 27
<> 144:ef7eb2e8f9f7 28 (#) The COMP output level is available using HAL_COMP_GetOutputLevel()
<> 144:ef7eb2e8f9f7 29 and can be redirected to other peripherals: GPIO pins (in mode
<> 144:ef7eb2e8f9f7 30 alternate functions for comparator), timers.
<> 144:ef7eb2e8f9f7 31 (refer to GPIO list in reference manual).
<> 144:ef7eb2e8f9f7 32
<> 144:ef7eb2e8f9f7 33 (#) Pairs of comparators instances can be combined in window mode
<> 144:ef7eb2e8f9f7 34 (2 consecutive instances odd and even COMP<x> and COMP<x+1>).
<> 144:ef7eb2e8f9f7 35
<> 144:ef7eb2e8f9f7 36 (#) The comparators have interrupt capability through the EXTI controller
<> 144:ef7eb2e8f9f7 37 with wake-up from sleep and stop modes:
<> 144:ef7eb2e8f9f7 38 (++) COMP1 is internally connected to EXTI Line 21
<> 144:ef7eb2e8f9f7 39 (++) COMP2 is internally connected to EXTI Line 22
<> 144:ef7eb2e8f9f7 40
<> 144:ef7eb2e8f9f7 41 From the corresponding IRQ handler, the right interrupt source can be retrieved
<> 144:ef7eb2e8f9f7 42 using macro __HAL_COMP_COMP1_EXTI_GET_FLAG() and __HAL_COMP_COMP2_EXTI_GET_FLAG().
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 ##### How to use this driver #####
<> 144:ef7eb2e8f9f7 45 ================================================================================
<> 144:ef7eb2e8f9f7 46 [..]
<> 144:ef7eb2e8f9f7 47 This driver provides functions to configure and program the comparator instances
<> 144:ef7eb2e8f9f7 48 of STM32L4xx devices.
<> 144:ef7eb2e8f9f7 49
<> 144:ef7eb2e8f9f7 50 To use the comparator, perform the following steps:
<> 144:ef7eb2e8f9f7 51
<> 144:ef7eb2e8f9f7 52 (#) Initialize the COMP low level resources by implementing the HAL_COMP_MspInit():
<> 144:ef7eb2e8f9f7 53 (++) Configure the GPIO connected to comparator inputs plus and minus in analog mode
<> 144:ef7eb2e8f9f7 54 using HAL_GPIO_Init().
<> 144:ef7eb2e8f9f7 55 (++) If needed, configure the GPIO connected to comparator output in alternate function mode
<> 144:ef7eb2e8f9f7 56 using HAL_GPIO_Init().
<> 144:ef7eb2e8f9f7 57 (++) If required enable the COMP interrupt by configuring and enabling EXTI line in Interrupt mode and
<> 144:ef7eb2e8f9f7 58 selecting the desired sensitivity level using HAL_GPIO_Init() function. After that enable the comparator
<> 144:ef7eb2e8f9f7 59 interrupt vector using HAL_NVIC_EnableIRQ() function.
<> 144:ef7eb2e8f9f7 60
<> 144:ef7eb2e8f9f7 61 (#) Configure the comparator using HAL_COMP_Init() function:
<> 144:ef7eb2e8f9f7 62 (++) Select the input minus (inverting input)
<> 144:ef7eb2e8f9f7 63 (++) Select the input plus (non-inverting input)
<> 144:ef7eb2e8f9f7 64 (++) Select the hysteresis
<> 144:ef7eb2e8f9f7 65 (++) Select the blanking source
<> 144:ef7eb2e8f9f7 66 (++) Select the output polarity
<> 144:ef7eb2e8f9f7 67 (++) Select the power mode
<> 144:ef7eb2e8f9f7 68 (++) Select the window mode
<> 144:ef7eb2e8f9f7 69
<> 144:ef7eb2e8f9f7 70 -@@- HAL_COMP_Init() calls internally __HAL_RCC_SYSCFG_CLK_ENABLE()
<> 144:ef7eb2e8f9f7 71 to enable internal control clock of the comparators.
<> 144:ef7eb2e8f9f7 72 However, this is a legacy strategy. In future STM32 families,
<> 144:ef7eb2e8f9f7 73 COMP clock enable must be implemented by user in "HAL_COMP_MspInit()".
<> 144:ef7eb2e8f9f7 74 Therefore, for compatibility anticipation, it is recommended to
<> 144:ef7eb2e8f9f7 75 implement __HAL_RCC_SYSCFG_CLK_ENABLE() in "HAL_COMP_MspInit()".
<> 144:ef7eb2e8f9f7 76
<> 144:ef7eb2e8f9f7 77 (#) Reconfiguration on-the-fly of comparator can be done by calling again
<> 144:ef7eb2e8f9f7 78 function HAL_COMP_Init() with new input structure parameters values.
<> 144:ef7eb2e8f9f7 79
<> 144:ef7eb2e8f9f7 80 (#) Enable the comparator using HAL_COMP_Start() function.
<> 144:ef7eb2e8f9f7 81
<> 144:ef7eb2e8f9f7 82 (#) Use HAL_COMP_TriggerCallback() or HAL_COMP_GetOutputLevel() functions
<> 144:ef7eb2e8f9f7 83 to manage comparator outputs (events and output level).
<> 144:ef7eb2e8f9f7 84
<> 144:ef7eb2e8f9f7 85 (#) Disable the comparator using HAL_COMP_Stop() function.
<> 144:ef7eb2e8f9f7 86
<> 144:ef7eb2e8f9f7 87 (#) De-initialize the comparator using HAL_COMP_DeInit() function.
<> 144:ef7eb2e8f9f7 88
<> 144:ef7eb2e8f9f7 89 (#) For safety purpose, comparator configuration can be locked using HAL_COMP_Lock() function.
<> 144:ef7eb2e8f9f7 90 The only way to unlock the comparator is a device hardware reset.
<> 144:ef7eb2e8f9f7 91
<> 144:ef7eb2e8f9f7 92 @endverbatim
<> 144:ef7eb2e8f9f7 93 ******************************************************************************
<> 144:ef7eb2e8f9f7 94
<> 144:ef7eb2e8f9f7 95 Table 1. COMP inputs and output for STM32L4xx devices
<> 144:ef7eb2e8f9f7 96 +---------------------------------------------------------+
<> 144:ef7eb2e8f9f7 97 | | | COMP1 | COMP2 |
<> 144:ef7eb2e8f9f7 98 |----------------|----------------|-----------|-----------|
<> 144:ef7eb2e8f9f7 99 | | IO1 | PC5 | PB4 |
<> 144:ef7eb2e8f9f7 100 | Input plus | IO2 | PB2 | PB6 |
<> 144:ef7eb2e8f9f7 101 | | IO3 (3) | PA1 | PA3 |
<> 144:ef7eb2e8f9f7 102 |----------------|----------------|-----------------------|
<> 144:ef7eb2e8f9f7 103 | | 1/4 VrefInt | Available | Available |
<> 144:ef7eb2e8f9f7 104 | | 1/2 VrefInt | Available | Available |
<> 144:ef7eb2e8f9f7 105 | | 3/4 VrefInt | Available | Available |
<> 144:ef7eb2e8f9f7 106 | Input minus | VrefInt | Available | Available |
<> 144:ef7eb2e8f9f7 107 | | DAC1 channel 1 | Available | Available |
<> 144:ef7eb2e8f9f7 108 | | DAC1 channel 2 | Available | Available |
<> 144:ef7eb2e8f9f7 109 | | IO1 | PB1 | PB3 |
<> 144:ef7eb2e8f9f7 110 | | IO2 | PC4 | PB7 |
<> 144:ef7eb2e8f9f7 111 | | IO3 (3) | PA0 | PA2 |
<> 144:ef7eb2e8f9f7 112 | | IO4 (3) | PA4 | PA4 |
<> 144:ef7eb2e8f9f7 113 | | IO5 (3) | PA5 | PA5 |
<> 144:ef7eb2e8f9f7 114 +---------------------------------------------------------+
<> 144:ef7eb2e8f9f7 115 | Output | | PB0 (1) | PB5 (1) |
<> 144:ef7eb2e8f9f7 116 | | | PB10 (1) | PB11 (1) |
<> 144:ef7eb2e8f9f7 117 | | | TIM (2) | TIM (2) |
<> 144:ef7eb2e8f9f7 118 +---------------------------------------------------------+
<> 144:ef7eb2e8f9f7 119 (1) GPIO must be set to alternate function for comparator
<> 144:ef7eb2e8f9f7 120 (2) Comparators output to timers is set in timers instances.
<> 144:ef7eb2e8f9f7 121 (3) Only STM32L43x/L44x
<> 144:ef7eb2e8f9f7 122
<> 144:ef7eb2e8f9f7 123 ******************************************************************************
<> 144:ef7eb2e8f9f7 124 * @attention
<> 144:ef7eb2e8f9f7 125 *
<> 144:ef7eb2e8f9f7 126 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 127 *
<> 144:ef7eb2e8f9f7 128 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 129 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 130 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 131 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 132 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 133 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 134 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 135 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 136 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 137 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 138 *
<> 144:ef7eb2e8f9f7 139 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 140 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 141 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 142 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 143 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 144 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 145 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 146 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 147 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 148 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 149 *
<> 144:ef7eb2e8f9f7 150 ******************************************************************************
<> 144:ef7eb2e8f9f7 151 */
<> 144:ef7eb2e8f9f7 152
<> 144:ef7eb2e8f9f7 153 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 154 #include "stm32l4xx_hal.h"
<> 144:ef7eb2e8f9f7 155
<> 144:ef7eb2e8f9f7 156 /** @addtogroup STM32L4xx_HAL_Driver
<> 144:ef7eb2e8f9f7 157 * @{
<> 144:ef7eb2e8f9f7 158 */
<> 144:ef7eb2e8f9f7 159
<> 144:ef7eb2e8f9f7 160 /** @defgroup COMP COMP
<> 144:ef7eb2e8f9f7 161 * @brief COMP HAL module driver
<> 144:ef7eb2e8f9f7 162 * @{
<> 144:ef7eb2e8f9f7 163 */
<> 144:ef7eb2e8f9f7 164
<> 144:ef7eb2e8f9f7 165 #ifdef HAL_COMP_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 166
<> 144:ef7eb2e8f9f7 167 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 168 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 169 /** @addtogroup COMP_Private_Constants
<> 144:ef7eb2e8f9f7 170 * @{
<> 144:ef7eb2e8f9f7 171 */
<> 144:ef7eb2e8f9f7 172
<> 144:ef7eb2e8f9f7 173 /* Delay for COMP startup time. */
<> 144:ef7eb2e8f9f7 174 /* Note: Delay required to reach propagation delay specification. */
<> 144:ef7eb2e8f9f7 175 /* Literal set to maximum value (refer to device datasheet, */
<> 144:ef7eb2e8f9f7 176 /* parameter "tSTART"). */
<> 144:ef7eb2e8f9f7 177 /* Unit: us */
<> 144:ef7eb2e8f9f7 178 #define COMP_DELAY_STARTUP_US ((uint32_t) 80U) /*!< Delay for COMP startup time */
<> 144:ef7eb2e8f9f7 179
<> 144:ef7eb2e8f9f7 180 /* Delay for COMP voltage scaler stabilization time. */
<> 144:ef7eb2e8f9f7 181 /* Literal set to maximum value (refer to device datasheet, */
<> 144:ef7eb2e8f9f7 182 /* parameter "tSTART_SCALER"). */
<> 144:ef7eb2e8f9f7 183 /* Unit: us */
<> 144:ef7eb2e8f9f7 184 #define COMP_DELAY_VOLTAGE_SCALER_STAB_US ((uint32_t) 200U) /*!< Delay for COMP voltage scaler stabilization time */
<> 144:ef7eb2e8f9f7 185
<> 144:ef7eb2e8f9f7 186 #define COMP_OUTPUT_LEVEL_BITOFFSET_POS ((uint32_t) 30U)
<> 144:ef7eb2e8f9f7 187
<> 144:ef7eb2e8f9f7 188 /**
<> 144:ef7eb2e8f9f7 189 * @}
<> 144:ef7eb2e8f9f7 190 */
<> 144:ef7eb2e8f9f7 191
<> 144:ef7eb2e8f9f7 192 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 193 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 194 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 195 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 196
<> 144:ef7eb2e8f9f7 197 /** @defgroup COMP_Exported_Functions COMP Exported Functions
<> 144:ef7eb2e8f9f7 198 * @{
<> 144:ef7eb2e8f9f7 199 */
<> 144:ef7eb2e8f9f7 200
<> 144:ef7eb2e8f9f7 201 /** @defgroup COMP_Exported_Functions_Group1 Initialization/de-initialization functions
<> 144:ef7eb2e8f9f7 202 * @brief Initialization and de-initialization functions.
<> 144:ef7eb2e8f9f7 203 *
<> 144:ef7eb2e8f9f7 204 @verbatim
<> 144:ef7eb2e8f9f7 205 ===============================================================================
<> 144:ef7eb2e8f9f7 206 ##### Initialization and de-initialization functions #####
<> 144:ef7eb2e8f9f7 207 ===============================================================================
<> 144:ef7eb2e8f9f7 208 [..] This section provides functions to initialize and de-initialize comparators
<> 144:ef7eb2e8f9f7 209
<> 144:ef7eb2e8f9f7 210 @endverbatim
<> 144:ef7eb2e8f9f7 211 * @{
<> 144:ef7eb2e8f9f7 212 */
<> 144:ef7eb2e8f9f7 213
<> 144:ef7eb2e8f9f7 214 /**
<> 144:ef7eb2e8f9f7 215 * @brief Initialize the COMP according to the specified
<> 144:ef7eb2e8f9f7 216 * parameters in the COMP_InitTypeDef and initialize the associated handle.
<> 144:ef7eb2e8f9f7 217 * @note If the selected comparator is locked, initialization can't be performed.
<> 144:ef7eb2e8f9f7 218 * To unlock the configuration, perform a system reset.
<> 144:ef7eb2e8f9f7 219 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 220 * @retval HAL status
<> 144:ef7eb2e8f9f7 221 */
<> 144:ef7eb2e8f9f7 222 HAL_StatusTypeDef HAL_COMP_Init(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 223 {
<> 144:ef7eb2e8f9f7 224 uint32_t tmp_csr = 0;
<> 144:ef7eb2e8f9f7 225 uint32_t exti_line = 0;
<> 144:ef7eb2e8f9f7 226 uint32_t comp_voltage_scaler_not_initialized = 0;
<> 144:ef7eb2e8f9f7 227 __IO uint32_t wait_loop_index = 0;
<> 144:ef7eb2e8f9f7 228 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230 /* Check the COMP handle allocation and lock status */
<> 144:ef7eb2e8f9f7 231 if((hcomp == NULL) || (__HAL_COMP_IS_LOCKED(hcomp)))
<> 144:ef7eb2e8f9f7 232 {
<> 144:ef7eb2e8f9f7 233 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 234 }
<> 144:ef7eb2e8f9f7 235 else
<> 144:ef7eb2e8f9f7 236 {
<> 144:ef7eb2e8f9f7 237 /* Check the parameters */
<> 144:ef7eb2e8f9f7 238 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 239 assert_param(IS_COMP_INPUT_PLUS(hcomp->Instance, hcomp->Init.NonInvertingInput));
<> 144:ef7eb2e8f9f7 240 assert_param(IS_COMP_INPUT_MINUS(hcomp->Instance, hcomp->Init.InvertingInput));
<> 144:ef7eb2e8f9f7 241 assert_param(IS_COMP_OUTPUTPOL(hcomp->Init.OutputPol));
<> 144:ef7eb2e8f9f7 242 assert_param(IS_COMP_POWERMODE(hcomp->Init.Mode));
<> 144:ef7eb2e8f9f7 243 assert_param(IS_COMP_HYSTERESIS(hcomp->Init.Hysteresis));
<> 144:ef7eb2e8f9f7 244 assert_param(IS_COMP_BLANKINGSRC_INSTANCE(hcomp->Instance, hcomp->Init.BlankingSrce));
<> 144:ef7eb2e8f9f7 245 assert_param(IS_COMP_TRIGGERMODE(hcomp->Init.TriggerMode));
<> 144:ef7eb2e8f9f7 246 assert_param(IS_COMP_WINDOWMODE(hcomp->Init.WindowMode));
<> 144:ef7eb2e8f9f7 247
<> 144:ef7eb2e8f9f7 248 if(hcomp->State == HAL_COMP_STATE_RESET)
<> 144:ef7eb2e8f9f7 249 {
<> 144:ef7eb2e8f9f7 250 /* Allocate lock resource and initialize it */
<> 144:ef7eb2e8f9f7 251 hcomp->Lock = HAL_UNLOCKED;
<> 144:ef7eb2e8f9f7 252
<> 144:ef7eb2e8f9f7 253 /* Init SYSCFG and the low level hardware to access comparators */
<> 144:ef7eb2e8f9f7 254 /* Note: HAL_COMP_Init() calls __HAL_RCC_SYSCFG_CLK_ENABLE() */
<> 144:ef7eb2e8f9f7 255 /* to enable internal control clock of the comparators. */
<> 144:ef7eb2e8f9f7 256 /* However, this is a legacy strategy. In future STM32 families, */
<> 144:ef7eb2e8f9f7 257 /* COMP clock enable must be implemented by user */
<> 144:ef7eb2e8f9f7 258 /* in "HAL_COMP_MspInit()". */
<> 144:ef7eb2e8f9f7 259 /* Therefore, for compatibility anticipation, it is recommended */
<> 144:ef7eb2e8f9f7 260 /* to implement __HAL_RCC_SYSCFG_CLK_ENABLE() */
<> 144:ef7eb2e8f9f7 261 /* in "HAL_COMP_MspInit()". */
<> 144:ef7eb2e8f9f7 262 __HAL_RCC_SYSCFG_CLK_ENABLE();
<> 144:ef7eb2e8f9f7 263
<> 144:ef7eb2e8f9f7 264 /* Init the low level hardware */
<> 144:ef7eb2e8f9f7 265 HAL_COMP_MspInit(hcomp);
<> 144:ef7eb2e8f9f7 266 }
<> 144:ef7eb2e8f9f7 267
<> 144:ef7eb2e8f9f7 268 /* Memorize voltage scaler state before initialization */
<> 144:ef7eb2e8f9f7 269 comp_voltage_scaler_not_initialized = (READ_BIT(hcomp->Instance->CSR, COMP_CSR_SCALEN) == 0);
<> 144:ef7eb2e8f9f7 270
<> 144:ef7eb2e8f9f7 271 /* Set COMP parameters */
<> 144:ef7eb2e8f9f7 272 tmp_csr = (hcomp->Init.InvertingInput |
<> 144:ef7eb2e8f9f7 273 hcomp->Init.NonInvertingInput |
<> 144:ef7eb2e8f9f7 274 hcomp->Init.BlankingSrce |
<> 144:ef7eb2e8f9f7 275 hcomp->Init.Hysteresis |
<> 144:ef7eb2e8f9f7 276 hcomp->Init.OutputPol |
<> 144:ef7eb2e8f9f7 277 hcomp->Init.Mode );
<> 144:ef7eb2e8f9f7 278
<> 144:ef7eb2e8f9f7 279 /* Set parameters in COMP register */
<> 144:ef7eb2e8f9f7 280 /* Note: Update all bits except read-only, lock and enable bits */
<> 144:ef7eb2e8f9f7 281 #if defined (COMP_CSR_INMESEL)
<> 144:ef7eb2e8f9f7 282 MODIFY_REG(hcomp->Instance->CSR,
<> 144:ef7eb2e8f9f7 283 COMP_CSR_PWRMODE | COMP_CSR_INMSEL | COMP_CSR_INPSEL |
<> 144:ef7eb2e8f9f7 284 COMP_CSR_WINMODE | COMP_CSR_POLARITY | COMP_CSR_HYST |
<> 144:ef7eb2e8f9f7 285 COMP_CSR_BLANKING | COMP_CSR_BRGEN | COMP_CSR_SCALEN | COMP_CSR_INMESEL,
<> 144:ef7eb2e8f9f7 286 tmp_csr
<> 144:ef7eb2e8f9f7 287 );
<> 144:ef7eb2e8f9f7 288 #else
<> 144:ef7eb2e8f9f7 289 MODIFY_REG(hcomp->Instance->CSR,
<> 144:ef7eb2e8f9f7 290 COMP_CSR_PWRMODE | COMP_CSR_INMSEL | COMP_CSR_INPSEL |
<> 144:ef7eb2e8f9f7 291 COMP_CSR_WINMODE | COMP_CSR_POLARITY | COMP_CSR_HYST |
<> 144:ef7eb2e8f9f7 292 COMP_CSR_BLANKING | COMP_CSR_BRGEN | COMP_CSR_SCALEN,
<> 144:ef7eb2e8f9f7 293 tmp_csr
<> 144:ef7eb2e8f9f7 294 );
<> 144:ef7eb2e8f9f7 295 #endif
<> 144:ef7eb2e8f9f7 296
<> 144:ef7eb2e8f9f7 297 /* Set window mode */
<> 144:ef7eb2e8f9f7 298 /* Note: Window mode bit is located into 1 out of the 2 pairs of COMP */
<> 144:ef7eb2e8f9f7 299 /* instances. Therefore, this function can update another COMP */
<> 144:ef7eb2e8f9f7 300 /* instance that the one currently selected. */
<> 144:ef7eb2e8f9f7 301 if(hcomp->Init.WindowMode == COMP_WINDOWMODE_COMP1_INPUT_PLUS_COMMON)
<> 144:ef7eb2e8f9f7 302 {
<> 144:ef7eb2e8f9f7 303 SET_BIT(COMP12_COMMON->CSR, COMP_CSR_WINMODE);
<> 144:ef7eb2e8f9f7 304 }
<> 144:ef7eb2e8f9f7 305 else
<> 144:ef7eb2e8f9f7 306 {
<> 144:ef7eb2e8f9f7 307 CLEAR_BIT(COMP12_COMMON->CSR, COMP_CSR_WINMODE);
<> 144:ef7eb2e8f9f7 308 }
<> 144:ef7eb2e8f9f7 309
<> 144:ef7eb2e8f9f7 310 /* Delay for COMP scaler bridge voltage stabilization */
<> 144:ef7eb2e8f9f7 311 /* Apply the delay if voltage scaler bridge is enabled for the first time */
<> 144:ef7eb2e8f9f7 312 if ((READ_BIT(hcomp->Instance->CSR, COMP_CSR_SCALEN) != 0) &&
<> 144:ef7eb2e8f9f7 313 (comp_voltage_scaler_not_initialized != 0) )
<> 144:ef7eb2e8f9f7 314 {
<> 144:ef7eb2e8f9f7 315 /* Wait loop initialization and execution */
<> 144:ef7eb2e8f9f7 316 /* Note: Variable divided by 2 to compensate partially */
<> 144:ef7eb2e8f9f7 317 /* CPU processing cycles. */
<> 144:ef7eb2e8f9f7 318 wait_loop_index = (COMP_DELAY_VOLTAGE_SCALER_STAB_US * (SystemCoreClock / (1000000 * 2)));
<> 144:ef7eb2e8f9f7 319 while(wait_loop_index != 0)
<> 144:ef7eb2e8f9f7 320 {
<> 144:ef7eb2e8f9f7 321 wait_loop_index--;
<> 144:ef7eb2e8f9f7 322 }
<> 144:ef7eb2e8f9f7 323 }
<> 144:ef7eb2e8f9f7 324
<> 144:ef7eb2e8f9f7 325 /* Get the EXTI line corresponding to the selected COMP instance */
<> 144:ef7eb2e8f9f7 326 exti_line = COMP_GET_EXTI_LINE(hcomp->Instance);
<> 144:ef7eb2e8f9f7 327
<> 144:ef7eb2e8f9f7 328 /* Manage EXTI settings */
<> 144:ef7eb2e8f9f7 329 if((hcomp->Init.TriggerMode & (COMP_EXTI_IT | COMP_EXTI_EVENT)) != RESET)
<> 144:ef7eb2e8f9f7 330 {
<> 144:ef7eb2e8f9f7 331 /* Configure EXTI rising edge */
<> 144:ef7eb2e8f9f7 332 if((hcomp->Init.TriggerMode & COMP_EXTI_RISING) != RESET)
<> 144:ef7eb2e8f9f7 333 {
<> 144:ef7eb2e8f9f7 334 SET_BIT(EXTI->RTSR1, exti_line);
<> 144:ef7eb2e8f9f7 335 }
<> 144:ef7eb2e8f9f7 336 else
<> 144:ef7eb2e8f9f7 337 {
<> 144:ef7eb2e8f9f7 338 CLEAR_BIT(EXTI->RTSR1, exti_line);
<> 144:ef7eb2e8f9f7 339 }
<> 144:ef7eb2e8f9f7 340
<> 144:ef7eb2e8f9f7 341 /* Configure EXTI falling edge */
<> 144:ef7eb2e8f9f7 342 if((hcomp->Init.TriggerMode & COMP_EXTI_FALLING) != RESET)
<> 144:ef7eb2e8f9f7 343 {
<> 144:ef7eb2e8f9f7 344 SET_BIT(EXTI->FTSR1, exti_line);
<> 144:ef7eb2e8f9f7 345 }
<> 144:ef7eb2e8f9f7 346 else
<> 144:ef7eb2e8f9f7 347 {
<> 144:ef7eb2e8f9f7 348 CLEAR_BIT(EXTI->FTSR1, exti_line);
<> 144:ef7eb2e8f9f7 349 }
<> 144:ef7eb2e8f9f7 350
<> 144:ef7eb2e8f9f7 351 /* Clear COMP EXTI pending bit (if any) */
<> 144:ef7eb2e8f9f7 352 WRITE_REG(EXTI->PR1, exti_line);
<> 144:ef7eb2e8f9f7 353
<> 144:ef7eb2e8f9f7 354 /* Configure EXTI event mode */
<> 144:ef7eb2e8f9f7 355 if((hcomp->Init.TriggerMode & COMP_EXTI_EVENT) != RESET)
<> 144:ef7eb2e8f9f7 356 {
<> 144:ef7eb2e8f9f7 357 SET_BIT(EXTI->EMR1, exti_line);
<> 144:ef7eb2e8f9f7 358 }
<> 144:ef7eb2e8f9f7 359 else
<> 144:ef7eb2e8f9f7 360 {
<> 144:ef7eb2e8f9f7 361 CLEAR_BIT(EXTI->EMR1, exti_line);
<> 144:ef7eb2e8f9f7 362 }
<> 144:ef7eb2e8f9f7 363
<> 144:ef7eb2e8f9f7 364 /* Configure EXTI interrupt mode */
<> 144:ef7eb2e8f9f7 365 if((hcomp->Init.TriggerMode & COMP_EXTI_IT) != RESET)
<> 144:ef7eb2e8f9f7 366 {
<> 144:ef7eb2e8f9f7 367 SET_BIT(EXTI->IMR1, exti_line);
<> 144:ef7eb2e8f9f7 368 }
<> 144:ef7eb2e8f9f7 369 else
<> 144:ef7eb2e8f9f7 370 {
<> 144:ef7eb2e8f9f7 371 CLEAR_BIT(EXTI->IMR1, exti_line);
<> 144:ef7eb2e8f9f7 372 }
<> 144:ef7eb2e8f9f7 373 }
<> 144:ef7eb2e8f9f7 374 else
<> 144:ef7eb2e8f9f7 375 {
<> 144:ef7eb2e8f9f7 376 /* Disable EXTI event mode */
<> 144:ef7eb2e8f9f7 377 CLEAR_BIT(EXTI->EMR1, exti_line);
<> 144:ef7eb2e8f9f7 378
<> 144:ef7eb2e8f9f7 379 /* Disable EXTI interrupt mode */
<> 144:ef7eb2e8f9f7 380 CLEAR_BIT(EXTI->IMR1, exti_line);
<> 144:ef7eb2e8f9f7 381 }
<> 144:ef7eb2e8f9f7 382
<> 144:ef7eb2e8f9f7 383 /* Set HAL COMP handle state */
<> 144:ef7eb2e8f9f7 384 /* Note: Transition from state reset to state ready, */
<> 144:ef7eb2e8f9f7 385 /* otherwise (coming from state ready or busy) no state update. */
<> 144:ef7eb2e8f9f7 386 if (hcomp->State == HAL_COMP_STATE_RESET)
<> 144:ef7eb2e8f9f7 387 {
<> 144:ef7eb2e8f9f7 388 hcomp->State = HAL_COMP_STATE_READY;
<> 144:ef7eb2e8f9f7 389 }
<> 144:ef7eb2e8f9f7 390 }
<> 144:ef7eb2e8f9f7 391
<> 144:ef7eb2e8f9f7 392 return status;
<> 144:ef7eb2e8f9f7 393 }
<> 144:ef7eb2e8f9f7 394
<> 144:ef7eb2e8f9f7 395 /**
<> 144:ef7eb2e8f9f7 396 * @brief DeInitialize the COMP peripheral.
<> 144:ef7eb2e8f9f7 397 * @note Deinitialization cannot be performed if the COMP configuration is locked.
<> 144:ef7eb2e8f9f7 398 * To unlock the configuration, perform a system reset.
<> 144:ef7eb2e8f9f7 399 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 400 * @retval HAL status
<> 144:ef7eb2e8f9f7 401 */
<> 144:ef7eb2e8f9f7 402 HAL_StatusTypeDef HAL_COMP_DeInit(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 403 {
<> 144:ef7eb2e8f9f7 404 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 405
<> 144:ef7eb2e8f9f7 406 /* Check the COMP handle allocation and lock status */
<> 144:ef7eb2e8f9f7 407 if((hcomp == NULL) || (__HAL_COMP_IS_LOCKED(hcomp)))
<> 144:ef7eb2e8f9f7 408 {
<> 144:ef7eb2e8f9f7 409 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 410 }
<> 144:ef7eb2e8f9f7 411 else
<> 144:ef7eb2e8f9f7 412 {
<> 144:ef7eb2e8f9f7 413 /* Check the parameter */
<> 144:ef7eb2e8f9f7 414 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 415
<> 144:ef7eb2e8f9f7 416 /* Set COMP_CSR register to reset value */
<> 144:ef7eb2e8f9f7 417 WRITE_REG(hcomp->Instance->CSR, 0x00000000);
<> 144:ef7eb2e8f9f7 418
<> 144:ef7eb2e8f9f7 419 /* DeInit the low level hardware: SYSCFG, GPIO, CLOCK and NVIC */
<> 144:ef7eb2e8f9f7 420 HAL_COMP_MspDeInit(hcomp);
<> 144:ef7eb2e8f9f7 421
<> 144:ef7eb2e8f9f7 422 /* Set HAL COMP handle state */
<> 144:ef7eb2e8f9f7 423 hcomp->State = HAL_COMP_STATE_RESET;
<> 144:ef7eb2e8f9f7 424
<> 144:ef7eb2e8f9f7 425 /* Release Lock */
<> 144:ef7eb2e8f9f7 426 __HAL_UNLOCK(hcomp);
<> 144:ef7eb2e8f9f7 427 }
<> 144:ef7eb2e8f9f7 428
<> 144:ef7eb2e8f9f7 429 return status;
<> 144:ef7eb2e8f9f7 430 }
<> 144:ef7eb2e8f9f7 431
<> 144:ef7eb2e8f9f7 432 /**
<> 144:ef7eb2e8f9f7 433 * @brief Initialize the COMP MSP.
<> 144:ef7eb2e8f9f7 434 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 435 * @retval None
<> 144:ef7eb2e8f9f7 436 */
<> 144:ef7eb2e8f9f7 437 __weak void HAL_COMP_MspInit(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 438 {
<> 144:ef7eb2e8f9f7 439 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 440 UNUSED(hcomp);
<> 144:ef7eb2e8f9f7 441
<> 144:ef7eb2e8f9f7 442 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 443 the HAL_COMP_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 444 */
<> 144:ef7eb2e8f9f7 445 }
<> 144:ef7eb2e8f9f7 446
<> 144:ef7eb2e8f9f7 447 /**
<> 144:ef7eb2e8f9f7 448 * @brief DeInitialize the COMP MSP.
<> 144:ef7eb2e8f9f7 449 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 450 * @retval None
<> 144:ef7eb2e8f9f7 451 */
<> 144:ef7eb2e8f9f7 452 __weak void HAL_COMP_MspDeInit(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 453 {
<> 144:ef7eb2e8f9f7 454 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 455 UNUSED(hcomp);
<> 144:ef7eb2e8f9f7 456
<> 144:ef7eb2e8f9f7 457 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 458 the HAL_COMP_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 459 */
<> 144:ef7eb2e8f9f7 460 }
<> 144:ef7eb2e8f9f7 461
<> 144:ef7eb2e8f9f7 462 /**
<> 144:ef7eb2e8f9f7 463 * @}
<> 144:ef7eb2e8f9f7 464 */
<> 144:ef7eb2e8f9f7 465
<> 144:ef7eb2e8f9f7 466 /** @defgroup COMP_Exported_Functions_Group2 Start-Stop operation functions
<> 144:ef7eb2e8f9f7 467 * @brief Start-Stop operation functions.
<> 144:ef7eb2e8f9f7 468 *
<> 144:ef7eb2e8f9f7 469 @verbatim
<> 144:ef7eb2e8f9f7 470 ===============================================================================
<> 144:ef7eb2e8f9f7 471 ##### IO operation functions #####
<> 144:ef7eb2e8f9f7 472 ===============================================================================
<> 144:ef7eb2e8f9f7 473 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 474 (+) Start a comparator instance.
<> 144:ef7eb2e8f9f7 475 (+) Stop a comparator instance.
<> 144:ef7eb2e8f9f7 476
<> 144:ef7eb2e8f9f7 477 @endverbatim
<> 144:ef7eb2e8f9f7 478 * @{
<> 144:ef7eb2e8f9f7 479 */
<> 144:ef7eb2e8f9f7 480
<> 144:ef7eb2e8f9f7 481 /**
<> 144:ef7eb2e8f9f7 482 * @brief Start the comparator.
<> 144:ef7eb2e8f9f7 483 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 484 * @retval HAL status
<> 144:ef7eb2e8f9f7 485 */
<> 144:ef7eb2e8f9f7 486 HAL_StatusTypeDef HAL_COMP_Start(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 487 {
<> 144:ef7eb2e8f9f7 488 __IO uint32_t wait_loop_index = 0;
<> 144:ef7eb2e8f9f7 489 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 490
<> 144:ef7eb2e8f9f7 491 /* Check the COMP handle allocation and lock status */
<> 144:ef7eb2e8f9f7 492 if((hcomp == NULL) || (__HAL_COMP_IS_LOCKED(hcomp)))
<> 144:ef7eb2e8f9f7 493 {
<> 144:ef7eb2e8f9f7 494 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 495 }
<> 144:ef7eb2e8f9f7 496 else
<> 144:ef7eb2e8f9f7 497 {
<> 144:ef7eb2e8f9f7 498 /* Check the parameter */
<> 144:ef7eb2e8f9f7 499 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 500
<> 144:ef7eb2e8f9f7 501 if(hcomp->State == HAL_COMP_STATE_READY)
<> 144:ef7eb2e8f9f7 502 {
<> 144:ef7eb2e8f9f7 503 /* Enable the selected comparator */
<> 144:ef7eb2e8f9f7 504 SET_BIT(hcomp->Instance->CSR, COMP_CSR_EN);
<> 144:ef7eb2e8f9f7 505
<> 144:ef7eb2e8f9f7 506 /* Set HAL COMP handle state */
<> 144:ef7eb2e8f9f7 507 hcomp->State = HAL_COMP_STATE_BUSY;
<> 144:ef7eb2e8f9f7 508
<> 144:ef7eb2e8f9f7 509 /* Delay for COMP startup time */
<> 144:ef7eb2e8f9f7 510 /* Wait loop initialization and execution */
<> 144:ef7eb2e8f9f7 511 /* Note: Variable divided by 2 to compensate partially */
<> 144:ef7eb2e8f9f7 512 /* CPU processing cycles. */
<> 144:ef7eb2e8f9f7 513 wait_loop_index = (COMP_DELAY_STARTUP_US * (SystemCoreClock / (1000000 * 2)));
<> 144:ef7eb2e8f9f7 514 while(wait_loop_index != 0)
<> 144:ef7eb2e8f9f7 515 {
<> 144:ef7eb2e8f9f7 516 wait_loop_index--;
<> 144:ef7eb2e8f9f7 517 }
<> 144:ef7eb2e8f9f7 518 }
<> 144:ef7eb2e8f9f7 519 else
<> 144:ef7eb2e8f9f7 520 {
<> 144:ef7eb2e8f9f7 521 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 522 }
<> 144:ef7eb2e8f9f7 523 }
<> 144:ef7eb2e8f9f7 524
<> 144:ef7eb2e8f9f7 525 return status;
<> 144:ef7eb2e8f9f7 526 }
<> 144:ef7eb2e8f9f7 527
<> 144:ef7eb2e8f9f7 528 /**
<> 144:ef7eb2e8f9f7 529 * @brief Stop the comparator.
<> 144:ef7eb2e8f9f7 530 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 531 * @retval HAL status
<> 144:ef7eb2e8f9f7 532 */
<> 144:ef7eb2e8f9f7 533 HAL_StatusTypeDef HAL_COMP_Stop(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 534 {
<> 144:ef7eb2e8f9f7 535 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 536
<> 144:ef7eb2e8f9f7 537 /* Check the COMP handle allocation and lock status */
<> 144:ef7eb2e8f9f7 538 if((hcomp == NULL) || (__HAL_COMP_IS_LOCKED(hcomp)))
<> 144:ef7eb2e8f9f7 539 {
<> 144:ef7eb2e8f9f7 540 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 541 }
<> 144:ef7eb2e8f9f7 542 else
<> 144:ef7eb2e8f9f7 543 {
<> 144:ef7eb2e8f9f7 544 /* Check the parameter */
<> 144:ef7eb2e8f9f7 545 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 546
<> 144:ef7eb2e8f9f7 547 if((hcomp->State == HAL_COMP_STATE_BUSY) ||
<> 144:ef7eb2e8f9f7 548 (hcomp->State == HAL_COMP_STATE_READY) )
<> 144:ef7eb2e8f9f7 549 {
<> 144:ef7eb2e8f9f7 550 /* Disable the selected comparator */
<> 144:ef7eb2e8f9f7 551 CLEAR_BIT(hcomp->Instance->CSR, COMP_CSR_EN);
<> 144:ef7eb2e8f9f7 552
<> 144:ef7eb2e8f9f7 553 /* Set HAL COMP handle state */
<> 144:ef7eb2e8f9f7 554 hcomp->State = HAL_COMP_STATE_READY;
<> 144:ef7eb2e8f9f7 555 }
<> 144:ef7eb2e8f9f7 556 else
<> 144:ef7eb2e8f9f7 557 {
<> 144:ef7eb2e8f9f7 558 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 559 }
<> 144:ef7eb2e8f9f7 560 }
<> 144:ef7eb2e8f9f7 561
<> 144:ef7eb2e8f9f7 562 return status;
<> 144:ef7eb2e8f9f7 563 }
<> 144:ef7eb2e8f9f7 564
<> 144:ef7eb2e8f9f7 565 /**
<> 144:ef7eb2e8f9f7 566 * @brief Comparator IRQ handler.
<> 144:ef7eb2e8f9f7 567 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 568 * @retval None
<> 144:ef7eb2e8f9f7 569 */
<> 144:ef7eb2e8f9f7 570 void HAL_COMP_IRQHandler(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 571 {
<> 144:ef7eb2e8f9f7 572 /* Get the EXTI line corresponding to the selected COMP instance */
<> 144:ef7eb2e8f9f7 573 uint32_t exti_line = COMP_GET_EXTI_LINE(hcomp->Instance);
<> 144:ef7eb2e8f9f7 574
<> 144:ef7eb2e8f9f7 575 /* Check COMP EXTI flag */
<> 144:ef7eb2e8f9f7 576 if(READ_BIT(EXTI->PR1, exti_line) != RESET)
<> 144:ef7eb2e8f9f7 577 {
<> 144:ef7eb2e8f9f7 578 /* Check whether comparator is in independent or window mode */
<> 144:ef7eb2e8f9f7 579 if(READ_BIT(COMP12_COMMON->CSR, COMP_CSR_WINMODE) != RESET)
<> 144:ef7eb2e8f9f7 580 {
<> 144:ef7eb2e8f9f7 581 /* Clear COMP EXTI line pending bit of the pair of comparators */
<> 144:ef7eb2e8f9f7 582 /* in window mode. */
<> 144:ef7eb2e8f9f7 583 /* Note: Pair of comparators in window mode can both trig IRQ when */
<> 144:ef7eb2e8f9f7 584 /* input voltage is changing from "out of window" area */
<> 144:ef7eb2e8f9f7 585 /* (low or high ) to the other "out of window" area (high or low).*/
<> 144:ef7eb2e8f9f7 586 /* Both flags must be cleared to call comparator trigger */
<> 144:ef7eb2e8f9f7 587 /* callback is called once. */
<> 144:ef7eb2e8f9f7 588 WRITE_REG(EXTI->PR1, (COMP_EXTI_LINE_COMP1 | COMP_EXTI_LINE_COMP2));
<> 144:ef7eb2e8f9f7 589 }
<> 144:ef7eb2e8f9f7 590 else
<> 144:ef7eb2e8f9f7 591 {
<> 144:ef7eb2e8f9f7 592 /* Clear COMP EXTI line pending bit */
<> 144:ef7eb2e8f9f7 593 WRITE_REG(EXTI->PR1, exti_line);
<> 144:ef7eb2e8f9f7 594 }
<> 144:ef7eb2e8f9f7 595
<> 144:ef7eb2e8f9f7 596 /* COMP trigger user callback */
<> 144:ef7eb2e8f9f7 597 HAL_COMP_TriggerCallback(hcomp);
<> 144:ef7eb2e8f9f7 598 }
<> 144:ef7eb2e8f9f7 599 }
<> 144:ef7eb2e8f9f7 600
<> 144:ef7eb2e8f9f7 601 /**
<> 144:ef7eb2e8f9f7 602 * @}
<> 144:ef7eb2e8f9f7 603 */
<> 144:ef7eb2e8f9f7 604
<> 144:ef7eb2e8f9f7 605 /** @defgroup COMP_Exported_Functions_Group3 Peripheral Control functions
<> 144:ef7eb2e8f9f7 606 * @brief Management functions.
<> 144:ef7eb2e8f9f7 607 *
<> 144:ef7eb2e8f9f7 608 @verbatim
<> 144:ef7eb2e8f9f7 609 ===============================================================================
<> 144:ef7eb2e8f9f7 610 ##### Peripheral Control functions #####
<> 144:ef7eb2e8f9f7 611 ===============================================================================
<> 144:ef7eb2e8f9f7 612 [..]
<> 144:ef7eb2e8f9f7 613 This subsection provides a set of functions allowing to control the comparators.
<> 144:ef7eb2e8f9f7 614
<> 144:ef7eb2e8f9f7 615 @endverbatim
<> 144:ef7eb2e8f9f7 616 * @{
<> 144:ef7eb2e8f9f7 617 */
<> 144:ef7eb2e8f9f7 618
<> 144:ef7eb2e8f9f7 619 /**
<> 144:ef7eb2e8f9f7 620 * @brief Lock the selected comparator configuration.
<> 144:ef7eb2e8f9f7 621 * @note A system reset is required to unlock the comparator configuration.
<> 144:ef7eb2e8f9f7 622 * @note Locking the comparator from reset state is possible
<> 144:ef7eb2e8f9f7 623 * if __HAL_RCC_SYSCFG_CLK_ENABLE() is being called before.
<> 144:ef7eb2e8f9f7 624 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 625 * @retval HAL status
<> 144:ef7eb2e8f9f7 626 */
<> 144:ef7eb2e8f9f7 627 HAL_StatusTypeDef HAL_COMP_Lock(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 628 {
<> 144:ef7eb2e8f9f7 629 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 630
<> 144:ef7eb2e8f9f7 631 /* Check the COMP handle allocation and lock status */
<> 144:ef7eb2e8f9f7 632 if((hcomp == NULL) || (__HAL_COMP_IS_LOCKED(hcomp)))
<> 144:ef7eb2e8f9f7 633 {
<> 144:ef7eb2e8f9f7 634 status = HAL_ERROR;
<> 144:ef7eb2e8f9f7 635 }
<> 144:ef7eb2e8f9f7 636 else
<> 144:ef7eb2e8f9f7 637 {
<> 144:ef7eb2e8f9f7 638 /* Check the parameter */
<> 144:ef7eb2e8f9f7 639 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 640
<> 144:ef7eb2e8f9f7 641 /* Set HAL COMP handle state */
<> 144:ef7eb2e8f9f7 642 hcomp->State = ((HAL_COMP_StateTypeDef)(hcomp->State | COMP_STATE_BITFIELD_LOCK));
<> 144:ef7eb2e8f9f7 643 }
<> 144:ef7eb2e8f9f7 644
<> 144:ef7eb2e8f9f7 645 if(status == HAL_OK)
<> 144:ef7eb2e8f9f7 646 {
<> 144:ef7eb2e8f9f7 647 /* Set the lock bit corresponding to selected comparator */
<> 144:ef7eb2e8f9f7 648 __HAL_COMP_LOCK(hcomp);
<> 144:ef7eb2e8f9f7 649 }
<> 144:ef7eb2e8f9f7 650
<> 144:ef7eb2e8f9f7 651 return status;
<> 144:ef7eb2e8f9f7 652 }
<> 144:ef7eb2e8f9f7 653
<> 144:ef7eb2e8f9f7 654 /**
<> 144:ef7eb2e8f9f7 655 * @brief Return the output level (high or low) of the selected comparator.
<> 144:ef7eb2e8f9f7 656 * The output level depends on the selected polarity.
<> 144:ef7eb2e8f9f7 657 * If the polarity is not inverted:
<> 144:ef7eb2e8f9f7 658 * - Comparator output is low when the input plus is at a lower
<> 144:ef7eb2e8f9f7 659 * voltage than the input minus
<> 144:ef7eb2e8f9f7 660 * - Comparator output is high when the input plus is at a higher
<> 144:ef7eb2e8f9f7 661 * voltage than the input minus
<> 144:ef7eb2e8f9f7 662 * If the polarity is inverted:
<> 144:ef7eb2e8f9f7 663 * - Comparator output is high when the input plus is at a lower
<> 144:ef7eb2e8f9f7 664 * voltage than the input minus
<> 144:ef7eb2e8f9f7 665 * - Comparator output is low when the input plus is at a higher
<> 144:ef7eb2e8f9f7 666 * voltage than the input minus
<> 144:ef7eb2e8f9f7 667 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 668 * @retval Returns the selected comparator output level:
<> 144:ef7eb2e8f9f7 669 * @arg @ref COMP_OUTPUT_LEVEL_LOW
<> 144:ef7eb2e8f9f7 670 * @arg @ref COMP_OUTPUT_LEVEL_HIGH
<> 144:ef7eb2e8f9f7 671 *
<> 144:ef7eb2e8f9f7 672 */
<> 144:ef7eb2e8f9f7 673 uint32_t HAL_COMP_GetOutputLevel(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 674 {
<> 144:ef7eb2e8f9f7 675 /* Check the parameter */
<> 144:ef7eb2e8f9f7 676 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 677
<> 144:ef7eb2e8f9f7 678 return (uint32_t)(READ_BIT(hcomp->Instance->CSR, COMP_CSR_VALUE)
<> 144:ef7eb2e8f9f7 679 >> COMP_OUTPUT_LEVEL_BITOFFSET_POS);
<> 144:ef7eb2e8f9f7 680 }
<> 144:ef7eb2e8f9f7 681
<> 144:ef7eb2e8f9f7 682 /**
<> 144:ef7eb2e8f9f7 683 * @brief Comparator callback.
<> 144:ef7eb2e8f9f7 684 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 685 * @retval None
<> 144:ef7eb2e8f9f7 686 */
<> 144:ef7eb2e8f9f7 687 __weak void HAL_COMP_TriggerCallback(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 688 {
<> 144:ef7eb2e8f9f7 689 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 690 UNUSED(hcomp);
<> 144:ef7eb2e8f9f7 691
<> 144:ef7eb2e8f9f7 692 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 693 the HAL_COMP_TriggerCallback should be implemented in the user file
<> 144:ef7eb2e8f9f7 694 */
<> 144:ef7eb2e8f9f7 695 }
<> 144:ef7eb2e8f9f7 696
<> 144:ef7eb2e8f9f7 697
<> 144:ef7eb2e8f9f7 698 /**
<> 144:ef7eb2e8f9f7 699 * @}
<> 144:ef7eb2e8f9f7 700 */
<> 144:ef7eb2e8f9f7 701
<> 144:ef7eb2e8f9f7 702 /** @defgroup COMP_Exported_Functions_Group4 Peripheral State functions
<> 144:ef7eb2e8f9f7 703 * @brief Peripheral State functions.
<> 144:ef7eb2e8f9f7 704 *
<> 144:ef7eb2e8f9f7 705 @verbatim
<> 144:ef7eb2e8f9f7 706 ===============================================================================
<> 144:ef7eb2e8f9f7 707 ##### Peripheral State functions #####
<> 144:ef7eb2e8f9f7 708 ===============================================================================
<> 144:ef7eb2e8f9f7 709 [..]
<> 144:ef7eb2e8f9f7 710 This subsection permit to get in run-time the status of the peripheral.
<> 144:ef7eb2e8f9f7 711
<> 144:ef7eb2e8f9f7 712 @endverbatim
<> 144:ef7eb2e8f9f7 713 * @{
<> 144:ef7eb2e8f9f7 714 */
<> 144:ef7eb2e8f9f7 715
<> 144:ef7eb2e8f9f7 716 /**
<> 144:ef7eb2e8f9f7 717 * @brief Return the COMP handle state.
<> 144:ef7eb2e8f9f7 718 * @param hcomp COMP handle
<> 144:ef7eb2e8f9f7 719 * @retval HAL state
<> 144:ef7eb2e8f9f7 720 */
<> 144:ef7eb2e8f9f7 721 HAL_COMP_StateTypeDef HAL_COMP_GetState(COMP_HandleTypeDef *hcomp)
<> 144:ef7eb2e8f9f7 722 {
<> 144:ef7eb2e8f9f7 723 /* Check the COMP handle allocation */
<> 144:ef7eb2e8f9f7 724 if(hcomp == NULL)
<> 144:ef7eb2e8f9f7 725 {
<> 144:ef7eb2e8f9f7 726 return HAL_COMP_STATE_RESET;
<> 144:ef7eb2e8f9f7 727 }
<> 144:ef7eb2e8f9f7 728
<> 144:ef7eb2e8f9f7 729 /* Check the parameter */
<> 144:ef7eb2e8f9f7 730 assert_param(IS_COMP_ALL_INSTANCE(hcomp->Instance));
<> 144:ef7eb2e8f9f7 731
<> 144:ef7eb2e8f9f7 732 /* Return HAL COMP handle state */
<> 144:ef7eb2e8f9f7 733 return hcomp->State;
<> 144:ef7eb2e8f9f7 734 }
<> 144:ef7eb2e8f9f7 735
<> 144:ef7eb2e8f9f7 736 /**
<> 144:ef7eb2e8f9f7 737 * @}
<> 144:ef7eb2e8f9f7 738 */
<> 144:ef7eb2e8f9f7 739
<> 144:ef7eb2e8f9f7 740 /**
<> 144:ef7eb2e8f9f7 741 * @}
<> 144:ef7eb2e8f9f7 742 */
<> 144:ef7eb2e8f9f7 743
<> 144:ef7eb2e8f9f7 744 #endif /* HAL_COMP_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 745 /**
<> 144:ef7eb2e8f9f7 746 * @}
<> 144:ef7eb2e8f9f7 747 */
<> 144:ef7eb2e8f9f7 748
<> 144:ef7eb2e8f9f7 749 /**
<> 144:ef7eb2e8f9f7 750 * @}
<> 144:ef7eb2e8f9f7 751 */
<> 144:ef7eb2e8f9f7 752
<> 144:ef7eb2e8f9f7 753 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/