en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_comp.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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