mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F302R8/stm32f30x_comp.c@125:23cc3068a9e4, 2014-03-19 (annotated)

Committer:
mbed_official
Date:
Wed Mar 19 10:15:22 2014 +0000
Revision:
125:23cc3068a9e4
Synchronized with git revision ace35dfba3748c7cdc102eb38ec6b9e1067c3252



Full URL: https://github.com/mbedmicro/mbed/commit/ace35dfba3748c7cdc102eb38ec6b9e1067c3252/



[NUCLEO_F302R8] Add cmsis and hal files + change F401RE clock to 84MHz

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 125:23cc3068a9e4 1 /**
mbed_official 125:23cc3068a9e4 2 ******************************************************************************
mbed_official 125:23cc3068a9e4 3 * @file stm32f30x_comp.c
mbed_official 125:23cc3068a9e4 4 * @author MCD Application Team
mbed_official 125:23cc3068a9e4 5 * @version V1.1.0
mbed_official 125:23cc3068a9e4 6 * @date 27-February-2014
mbed_official 125:23cc3068a9e4 7 * @brief This file provides firmware functions to manage the following
mbed_official 125:23cc3068a9e4 8 * functionalities of the 7 analog comparators (COMP1, COMP2...COMP7) peripheral:
mbed_official 125:23cc3068a9e4 9 * + Comparators configuration
mbed_official 125:23cc3068a9e4 10 * + Window mode control
mbed_official 125:23cc3068a9e4 11 *
mbed_official 125:23cc3068a9e4 12 @verbatim
mbed_official 125:23cc3068a9e4 13
mbed_official 125:23cc3068a9e4 14 ==============================================================================
mbed_official 125:23cc3068a9e4 15 ##### COMP Peripheral features #####
mbed_official 125:23cc3068a9e4 16 ==============================================================================
mbed_official 125:23cc3068a9e4 17 [..]
mbed_official 125:23cc3068a9e4 18 The device integrates 7 analog comparators COMP1, COMP2...COMP7:
mbed_official 125:23cc3068a9e4 19 (#) The non inverting input and inverting input can be set to GPIO pins
mbed_official 125:23cc3068a9e4 20 as shown in table1. COMP Inputs below.
mbed_official 125:23cc3068a9e4 21
mbed_official 125:23cc3068a9e4 22 (#) The COMP output is internally is available using COMP_GetOutputLevel()
mbed_official 125:23cc3068a9e4 23 and can be set on GPIO pins. Refer to table 2. COMP Outputs below.
mbed_official 125:23cc3068a9e4 24
mbed_official 125:23cc3068a9e4 25 (#) The COMP output can be redirected to embedded timers (TIM1, TIM2, TIM3...)
mbed_official 125:23cc3068a9e4 26 Refer to table 3. COMP Outputs redirection to embedded timers below.
mbed_official 125:23cc3068a9e4 27
mbed_official 125:23cc3068a9e4 28 (#) The comparators COMP1 and COMP2, COMP3 and COMP4, COMP5 and COMP6 can be combined in window
mbed_official 125:23cc3068a9e4 29 mode and only COMP1, COMP3 and COMP5 non inverting input can be used as non-inverting input.
mbed_official 125:23cc3068a9e4 30
mbed_official 125:23cc3068a9e4 31 (#) The seven comparators have interrupt capability with wake-up
mbed_official 125:23cc3068a9e4 32 from Sleep and Stop modes (through the EXTI controller):
mbed_official 125:23cc3068a9e4 33 (++) COMP1 is internally connected to EXTI Line 21
mbed_official 125:23cc3068a9e4 34 (++) COMP2 is internally connected to EXTI Line 22
mbed_official 125:23cc3068a9e4 35 (++) COMP3 is internally connected to EXTI Line 29
mbed_official 125:23cc3068a9e4 36 (++) COMP4 is internally connected to EXTI Line 30
mbed_official 125:23cc3068a9e4 37 (++) COMP5 is internally connected to EXTI Line 31
mbed_official 125:23cc3068a9e4 38 (++) COMP6 is internally connected to EXTI Line 32
mbed_official 125:23cc3068a9e4 39 (++) COMP7 is internally connected to EXTI Line 33
mbed_official 125:23cc3068a9e4 40
mbed_official 125:23cc3068a9e4 41 [..] Table 1. COMP Inputs
mbed_official 125:23cc3068a9e4 42 +------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 43 | | | COMP1 | COMP2 | COMP3 | COMP4 | COMP5 | COMP6 | COMP7 |
mbed_official 125:23cc3068a9e4 44 |-----------------|----------------|---------------|---------------------------------------|
mbed_official 125:23cc3068a9e4 45 | | 1/4 VREFINT | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 46 | | 1/2 VREFINT | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 47 | | 3/4 VREFINT | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 48 | Inverting Input | VREFINT | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 49 | | DAC1 OUT1(PA4) | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 50 | | DAC1 OUT2(PA5) | OK | OK | OK | OK | OK | OK | OK |
mbed_official 125:23cc3068a9e4 51 | | IO1 | PA0 | PA2 | PD15 | PE8 | PD13 | PD10 | PC0 |
mbed_official 125:23cc3068a9e4 52 | | IO2 | --- | --- | PB12 | PB2 | PB10 | PB15 | --- |
mbed_official 125:23cc3068a9e4 53 | | DAC2 OUT1(PA6) | --- | OK | --- | OK | --- | OK | --- |
mbed_official 125:23cc3068a9e4 54 |-----------------|----------------|-------|-------|-------|-------|-------|-------|-------|
mbed_official 125:23cc3068a9e4 55 | Non Inverting | IO1 | PA1 | PA7 | PB14 | PB0 | PD12 | PD11 | PA0 |
mbed_official 125:23cc3068a9e4 56 | Input | IO2 | --- | PA3 | PD14 | PE7 | PB13 | PB11 | PC1 |
mbed_official 125:23cc3068a9e4 57 +------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 58
mbed_official 125:23cc3068a9e4 59 [..] Table 2. COMP Outputs
mbed_official 125:23cc3068a9e4 60 +-------------------------------------------------------+
mbed_official 125:23cc3068a9e4 61 | COMP1 | COMP2 | COMP3 | COMP4 | COMP5 | COMP6 | COMP7 |
mbed_official 125:23cc3068a9e4 62 |-------|-------|-------|-------|-------|-------|-------|
mbed_official 125:23cc3068a9e4 63 | PA0 | PA2 | PB1 | PC8 | PC7 | PA10 | PC2 |
mbed_official 125:23cc3068a9e4 64 | PF4 | PA7 | --- | PA8 | PA9 | PC6 | --- |
mbed_official 125:23cc3068a9e4 65 | PA6 | PA12 | --- | --- | --- | --- | --- |
mbed_official 125:23cc3068a9e4 66 | PA11 | PB9 | --- | --- | --- | --- | --- |
mbed_official 125:23cc3068a9e4 67 | PB8 | --- | --- | --- | --- | --- | --- |
mbed_official 125:23cc3068a9e4 68 +-------------------------------------------------------+
mbed_official 125:23cc3068a9e4 69
mbed_official 125:23cc3068a9e4 70 [..] Table 3. COMP Outputs redirection to embedded timers
mbed_official 125:23cc3068a9e4 71 +----------------------------------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 72 | COMP1 | COMP2 | COMP3 | COMP4 | COMP5 | COMP6 | COMP7 |
mbed_official 125:23cc3068a9e4 73 |----------------|----------------|----------------|----------------|----------------|----------------|----------------|
mbed_official 125:23cc3068a9e4 74 | TIM1 BKIN | TIM1 BKIN | TIM1 BKIN | TIM1 BKIN | TIM1 BKIN | TIM1 BKIN | TIM1 BKIN |
mbed_official 125:23cc3068a9e4 75 | | | | | | | |
mbed_official 125:23cc3068a9e4 76 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 |
mbed_official 125:23cc3068a9e4 77 | | | | | | | |
mbed_official 125:23cc3068a9e4 78 | TIM8 BKIN | TIM8 BKIN | TIM8 BKIN | TIM8 BKIN | TIM8 BKIN | TIM8 BKIN | TIM8 BKIN |
mbed_official 125:23cc3068a9e4 79 | | | | | | | |
mbed_official 125:23cc3068a9e4 80 | TIM8 BKIN2 | TIM8 BKIN2 | TIM8 BKIN2 | TIM8 BKIN2 | TIM8 BKIN2 | TIM8 BKIN2 | TIM8 BKIN2 |
mbed_official 125:23cc3068a9e4 81 | | | | | | | |
mbed_official 125:23cc3068a9e4 82 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 | TIM1 BKIN2 |
mbed_official 125:23cc3068a9e4 83 | + | + | + | + | + | + | + |
mbed_official 125:23cc3068a9e4 84 | TIM8BKIN2 | TIM8BKIN2 | TIM8BKIN2 | TIM8BKIN2 | TIM8BKIN2 | TIM8BKIN2 | TIM8BKIN2 |
mbed_official 125:23cc3068a9e4 85 | | | | | | | |
mbed_official 125:23cc3068a9e4 86 | TIM1 OCREFCLR | TIM1 OCREFCLR | TIM1 OCREFCLR | TIM8 OCREFCLR | TIM8 OCREFCLR | TIM8 OCREFCLR | TIM1 OCREFCLR |
mbed_official 125:23cc3068a9e4 87 | | | | | | | |
mbed_official 125:23cc3068a9e4 88 | TIM1 IC1 | TIM1 IC1 | TIM2 OCREFCLR | TIM3 IC3 | TIM2 IC1 | TIM2 IC2 | TIM8 OCREFCLR |
mbed_official 125:23cc3068a9e4 89 | | | | | | | |
mbed_official 125:23cc3068a9e4 90 | TIM2 IC4 | TIM2 IC4 | TIM3 IC2 | TIM3 OCREFCLR | TIM3 OCREFCLR | TIM2 OCREFCLR | TIM2 IC3 |
mbed_official 125:23cc3068a9e4 91 | | | | | | | |
mbed_official 125:23cc3068a9e4 92 | TIM2 OCREFCLR | TIM2 OCREFCLR | TIM4 IC1 | TIM4 IC2 | TIM4 IC3 | TIM16 OCREFCLR| TIM1 IC2 |
mbed_official 125:23cc3068a9e4 93 | | | | | | | |
mbed_official 125:23cc3068a9e4 94 | TIM3 IC1 | TIM3 IC1 | TIM15 IC1 | TIM15 OCREFCLR| TIM16 BKIN | TIM16 IC1 | TIM17 OCREFCLR|
mbed_official 125:23cc3068a9e4 95 | | | | | | | |
mbed_official 125:23cc3068a9e4 96 | TIM3 OCREFCLR | TIM3 OCREFCLR | TIM15 BKIN | TIM15 IC2 | TIM17 IC1 | TIM4 IC4 | TIM17 BKIN |
mbed_official 125:23cc3068a9e4 97 +----------------------------------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 98
mbed_official 125:23cc3068a9e4 99 [..] Table 4. COMP Outputs blanking sources
mbed_official 125:23cc3068a9e4 100 +----------------------------------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 101 | COMP1 | COMP2 | COMP3 | COMP4 | COMP5 | COMP6 | COMP7 |
mbed_official 125:23cc3068a9e4 102 |----------------|----------------|----------------|----------------|----------------|----------------|----------------|
mbed_official 125:23cc3068a9e4 103 | TIM1 OC5 | TIM1 OC5 | TIM1 OC5 | TIM3 OC4 | TIM3 OC3 | TIM2 OC4 | TIM1 OC5 |
mbed_official 125:23cc3068a9e4 104 | | | | | | | |
mbed_official 125:23cc3068a9e4 105 | TIM2 OC3 | TIM2 OC3 | -------- | TIM8 OC5 | TIM8 OC5 | TIM8 OC5 | TIM8 OC5 |
mbed_official 125:23cc3068a9e4 106 | | | | | | | |
mbed_official 125:23cc3068a9e4 107 | TIM3 OC3 | TIM3 OC3 | TIM2 OC4 | TIM15 OC1 | TIM8 BKIN | TIM15 OC2 | TIM15 OC2 |
mbed_official 125:23cc3068a9e4 108 | | | | | | | |
mbed_official 125:23cc3068a9e4 109 +----------------------------------------------------------------------------------------------------------------------+
mbed_official 125:23cc3068a9e4 110
mbed_official 125:23cc3068a9e4 111
mbed_official 125:23cc3068a9e4 112 ##### How to use this driver #####
mbed_official 125:23cc3068a9e4 113 ==============================================================================
mbed_official 125:23cc3068a9e4 114 [..]
mbed_official 125:23cc3068a9e4 115 This driver provides functions to configure and program the Comparators
mbed_official 125:23cc3068a9e4 116 of all STM32F30x devices.
mbed_official 125:23cc3068a9e4 117
mbed_official 125:23cc3068a9e4 118 To use the comparator, perform the following steps:
mbed_official 125:23cc3068a9e4 119
mbed_official 125:23cc3068a9e4 120 (#) Enable the SYSCFG APB clock to get write access to comparator
mbed_official 125:23cc3068a9e4 121 register using RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE);
mbed_official 125:23cc3068a9e4 122
mbed_official 125:23cc3068a9e4 123 (#) Configure the comparator input in analog mode using GPIO_Init()
mbed_official 125:23cc3068a9e4 124
mbed_official 125:23cc3068a9e4 125 (#) Configure the comparator output in alternate function mode
mbed_official 125:23cc3068a9e4 126 using GPIO_Init() and use GPIO_PinAFConfig() function to map the
mbed_official 125:23cc3068a9e4 127 comparator output to the GPIO pin
mbed_official 125:23cc3068a9e4 128
mbed_official 125:23cc3068a9e4 129 (#) Configure the comparator using COMP_Init() function:
mbed_official 125:23cc3068a9e4 130 (++) Select the inverting input
mbed_official 125:23cc3068a9e4 131 (++) Select the non-inverting input
mbed_official 125:23cc3068a9e4 132 (++) Select the output polarity
mbed_official 125:23cc3068a9e4 133 (++) Select the output redirection
mbed_official 125:23cc3068a9e4 134 (++) Select the hysteresis level
mbed_official 125:23cc3068a9e4 135 (++) Select the power mode
mbed_official 125:23cc3068a9e4 136
mbed_official 125:23cc3068a9e4 137 (#) Enable the comparator using COMP_Cmd() function
mbed_official 125:23cc3068a9e4 138
mbed_official 125:23cc3068a9e4 139 (#) If required enable the COMP interrupt by configuring and enabling
mbed_official 125:23cc3068a9e4 140 EXTI line in Interrupt mode and selecting the desired sensitivity
mbed_official 125:23cc3068a9e4 141 level using EXTI_Init() function. After that enable the comparator
mbed_official 125:23cc3068a9e4 142 interrupt vector using NVIC_Init() function.
mbed_official 125:23cc3068a9e4 143
mbed_official 125:23cc3068a9e4 144 @endverbatim
mbed_official 125:23cc3068a9e4 145 *
mbed_official 125:23cc3068a9e4 146 ******************************************************************************
mbed_official 125:23cc3068a9e4 147 * @attention
mbed_official 125:23cc3068a9e4 148 *
mbed_official 125:23cc3068a9e4 149 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 125:23cc3068a9e4 150 *
mbed_official 125:23cc3068a9e4 151 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 125:23cc3068a9e4 152 * are permitted provided that the following conditions are met:
mbed_official 125:23cc3068a9e4 153 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 125:23cc3068a9e4 154 * this list of conditions and the following disclaimer.
mbed_official 125:23cc3068a9e4 155 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 125:23cc3068a9e4 156 * this list of conditions and the following disclaimer in the documentation
mbed_official 125:23cc3068a9e4 157 * and/or other materials provided with the distribution.
mbed_official 125:23cc3068a9e4 158 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 125:23cc3068a9e4 159 * may be used to endorse or promote products derived from this software
mbed_official 125:23cc3068a9e4 160 * without specific prior written permission.
mbed_official 125:23cc3068a9e4 161 *
mbed_official 125:23cc3068a9e4 162 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 125:23cc3068a9e4 163 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 125:23cc3068a9e4 164 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 125:23cc3068a9e4 165 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 125:23cc3068a9e4 166 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 125:23cc3068a9e4 167 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 125:23cc3068a9e4 168 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 125:23cc3068a9e4 169 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 125:23cc3068a9e4 170 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 125:23cc3068a9e4 171 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 125:23cc3068a9e4 172 *
mbed_official 125:23cc3068a9e4 173 ******************************************************************************
mbed_official 125:23cc3068a9e4 174 */
mbed_official 125:23cc3068a9e4 175
mbed_official 125:23cc3068a9e4 176 /* Includes ------------------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 177 #include "stm32f30x_comp.h"
mbed_official 125:23cc3068a9e4 178
mbed_official 125:23cc3068a9e4 179 /** @addtogroup STM32F30x_StdPeriph_Driver
mbed_official 125:23cc3068a9e4 180 * @{
mbed_official 125:23cc3068a9e4 181 */
mbed_official 125:23cc3068a9e4 182
mbed_official 125:23cc3068a9e4 183 /** @defgroup COMP
mbed_official 125:23cc3068a9e4 184 * @brief COMP driver modules
mbed_official 125:23cc3068a9e4 185 * @{
mbed_official 125:23cc3068a9e4 186 */
mbed_official 125:23cc3068a9e4 187
mbed_official 125:23cc3068a9e4 188 /* Private typedef -----------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 189 /* Private define ------------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 190 /* CSR register Mask */
mbed_official 125:23cc3068a9e4 191 #define COMP_CSR_CLEAR_MASK ((uint32_t)0x00000003)
mbed_official 125:23cc3068a9e4 192
mbed_official 125:23cc3068a9e4 193 /* Private macro -------------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 194 /* Private variables ---------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 195 /* Private function prototypes -----------------------------------------------*/
mbed_official 125:23cc3068a9e4 196 /* Private functions ---------------------------------------------------------*/
mbed_official 125:23cc3068a9e4 197
mbed_official 125:23cc3068a9e4 198 /** @defgroup COMP_Private_Functions
mbed_official 125:23cc3068a9e4 199 * @{
mbed_official 125:23cc3068a9e4 200 */
mbed_official 125:23cc3068a9e4 201
mbed_official 125:23cc3068a9e4 202 /** @defgroup COMP_Group1 Initialization and Configuration functions
mbed_official 125:23cc3068a9e4 203 * @brief Initialization and Configuration functions
mbed_official 125:23cc3068a9e4 204 *
mbed_official 125:23cc3068a9e4 205 @verbatim
mbed_official 125:23cc3068a9e4 206 ===============================================================================
mbed_official 125:23cc3068a9e4 207 ##### Initialization and Configuration functions #####
mbed_official 125:23cc3068a9e4 208 ===============================================================================
mbed_official 125:23cc3068a9e4 209
mbed_official 125:23cc3068a9e4 210 @endverbatim
mbed_official 125:23cc3068a9e4 211 * @{
mbed_official 125:23cc3068a9e4 212 */
mbed_official 125:23cc3068a9e4 213
mbed_official 125:23cc3068a9e4 214 /**
mbed_official 125:23cc3068a9e4 215 * @brief Deinitializes COMP peripheral registers to their default reset values.
mbed_official 125:23cc3068a9e4 216 * @note Deinitialization can't be performed if the COMP configuration is locked.
mbed_official 125:23cc3068a9e4 217 * To unlock the configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 218 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 219 * This parameter can be COMP_Selection_COMPx where x can be 1 to 7
mbed_official 125:23cc3068a9e4 220 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 221 * @param None
mbed_official 125:23cc3068a9e4 222 * @retval None
mbed_official 125:23cc3068a9e4 223 */
mbed_official 125:23cc3068a9e4 224 void COMP_DeInit(uint32_t COMP_Selection)
mbed_official 125:23cc3068a9e4 225 {
mbed_official 125:23cc3068a9e4 226 /*!< Set COMP_CSR register to reset value */
mbed_official 125:23cc3068a9e4 227 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) = ((uint32_t)0x00000000);
mbed_official 125:23cc3068a9e4 228 }
mbed_official 125:23cc3068a9e4 229
mbed_official 125:23cc3068a9e4 230 /**
mbed_official 125:23cc3068a9e4 231 * @brief Initializes the COMP peripheral according to the specified parameters
mbed_official 125:23cc3068a9e4 232 * in COMP_InitStruct
mbed_official 125:23cc3068a9e4 233 * @note If the selected comparator is locked, initialization can't be performed.
mbed_official 125:23cc3068a9e4 234 * To unlock the configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 235 * @note By default, PA1 is selected as COMP1 non inverting input.
mbed_official 125:23cc3068a9e4 236 * To use PA4 as COMP1 non inverting input call COMP_SwitchCmd() after COMP_Init()
mbed_official 125:23cc3068a9e4 237 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 238 * This parameter can be COMP_Selection_COMPx where x can be 1 to 7
mbed_official 125:23cc3068a9e4 239 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 240 * @param COMP_InitStruct: pointer to an COMP_InitTypeDef structure that contains
mbed_official 125:23cc3068a9e4 241 * the configuration information for the specified COMP peripheral.
mbed_official 125:23cc3068a9e4 242 * - COMP_InvertingInput specifies the inverting input of COMP
mbed_official 125:23cc3068a9e4 243 * - COMP_NonInvertingInput specifies the non inverting input of COMP
mbed_official 125:23cc3068a9e4 244 * - COMP_Output connect COMP output to selected timer
mbed_official 125:23cc3068a9e4 245 * input (Input capture / Output Compare Reference Clear / Break Input)
mbed_official 125:23cc3068a9e4 246 * - COMP_BlankingSrce specifies the blanking source of COMP
mbed_official 125:23cc3068a9e4 247 * - COMP_OutputPol select output polarity
mbed_official 125:23cc3068a9e4 248 * - COMP_Hysteresis configures COMP hysteresis value
mbed_official 125:23cc3068a9e4 249 * - COMP_Mode configures COMP power mode
mbed_official 125:23cc3068a9e4 250 * @retval None
mbed_official 125:23cc3068a9e4 251 */
mbed_official 125:23cc3068a9e4 252 void COMP_Init(uint32_t COMP_Selection, COMP_InitTypeDef* COMP_InitStruct)
mbed_official 125:23cc3068a9e4 253 {
mbed_official 125:23cc3068a9e4 254 uint32_t tmpreg = 0;
mbed_official 125:23cc3068a9e4 255
mbed_official 125:23cc3068a9e4 256 /* Check the parameters */
mbed_official 125:23cc3068a9e4 257 assert_param(IS_COMP_ALL_PERIPH(COMP_Selection));
mbed_official 125:23cc3068a9e4 258 assert_param(IS_COMP_INVERTING_INPUT(COMP_InitStruct->COMP_InvertingInput));
mbed_official 125:23cc3068a9e4 259 assert_param(IS_COMP_NONINVERTING_INPUT(COMP_InitStruct->COMP_NonInvertingInput));
mbed_official 125:23cc3068a9e4 260 assert_param(IS_COMP_OUTPUT(COMP_InitStruct->COMP_Output));
mbed_official 125:23cc3068a9e4 261 assert_param(IS_COMP_BLANKING_SOURCE(COMP_InitStruct->COMP_BlankingSrce));
mbed_official 125:23cc3068a9e4 262 assert_param(IS_COMP_OUTPUT_POL(COMP_InitStruct->COMP_OutputPol));
mbed_official 125:23cc3068a9e4 263 assert_param(IS_COMP_HYSTERESIS(COMP_InitStruct->COMP_Hysteresis));
mbed_official 125:23cc3068a9e4 264 assert_param(IS_COMP_MODE(COMP_InitStruct->COMP_Mode));
mbed_official 125:23cc3068a9e4 265
mbed_official 125:23cc3068a9e4 266 /*!< Get the COMPx_CSR register value */
mbed_official 125:23cc3068a9e4 267 tmpreg = *(__IO uint32_t *) (COMP_BASE + COMP_Selection);
mbed_official 125:23cc3068a9e4 268
mbed_official 125:23cc3068a9e4 269 /*!< Clear the COMP1SW1, COMPxINSEL, COMPxOUTSEL, COMPxPOL, COMPxHYST and COMPxMODE bits */
mbed_official 125:23cc3068a9e4 270 tmpreg &= (uint32_t) (COMP_CSR_CLEAR_MASK);
mbed_official 125:23cc3068a9e4 271
mbed_official 125:23cc3068a9e4 272 /*!< Configure COMP: inverting input, output redirection, hysteresis value and power mode */
mbed_official 125:23cc3068a9e4 273 /*!< Set COMPxINSEL bits according to COMP_InitStruct->COMP_InvertingInput value */
mbed_official 125:23cc3068a9e4 274 /*!< Set COMPxNONINSEL bits according to COMP_InitStruct->COMP_NonInvertingInput value */
mbed_official 125:23cc3068a9e4 275 /*!< Set COMPxBLANKING bits according to COMP_InitStruct->COMP_BlankingSrce value */
mbed_official 125:23cc3068a9e4 276 /*!< Set COMPxOUTSEL bits according to COMP_InitStruct->COMP_Output value */
mbed_official 125:23cc3068a9e4 277 /*!< Set COMPxPOL bit according to COMP_InitStruct->COMP_OutputPol value */
mbed_official 125:23cc3068a9e4 278 /*!< Set COMPxHYST bits according to COMP_InitStruct->COMP_Hysteresis value */
mbed_official 125:23cc3068a9e4 279 /*!< Set COMPxMODE bits according to COMP_InitStruct->COMP_Mode value */
mbed_official 125:23cc3068a9e4 280 tmpreg |= (uint32_t)(COMP_InitStruct->COMP_InvertingInput | COMP_InitStruct->COMP_NonInvertingInput |
mbed_official 125:23cc3068a9e4 281 COMP_InitStruct->COMP_Output | COMP_InitStruct->COMP_OutputPol | COMP_InitStruct->COMP_BlankingSrce |
mbed_official 125:23cc3068a9e4 282 COMP_InitStruct->COMP_Hysteresis | COMP_InitStruct->COMP_Mode);
mbed_official 125:23cc3068a9e4 283
mbed_official 125:23cc3068a9e4 284 /*!< Write to COMPx_CSR register */
mbed_official 125:23cc3068a9e4 285 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) = tmpreg;
mbed_official 125:23cc3068a9e4 286 }
mbed_official 125:23cc3068a9e4 287
mbed_official 125:23cc3068a9e4 288 /**
mbed_official 125:23cc3068a9e4 289 * @brief Fills each COMP_InitStruct member with its default value.
mbed_official 125:23cc3068a9e4 290 * @param COMP_InitStruct: pointer to an COMP_InitTypeDef structure which will
mbed_official 125:23cc3068a9e4 291 * be initialized.
mbed_official 125:23cc3068a9e4 292 * @retval None
mbed_official 125:23cc3068a9e4 293 */
mbed_official 125:23cc3068a9e4 294 void COMP_StructInit(COMP_InitTypeDef* COMP_InitStruct)
mbed_official 125:23cc3068a9e4 295 {
mbed_official 125:23cc3068a9e4 296 COMP_InitStruct->COMP_InvertingInput = COMP_InvertingInput_1_4VREFINT;
mbed_official 125:23cc3068a9e4 297 COMP_InitStruct->COMP_NonInvertingInput = COMP_NonInvertingInput_IO1;
mbed_official 125:23cc3068a9e4 298 COMP_InitStruct->COMP_Output = COMP_Output_None;
mbed_official 125:23cc3068a9e4 299 COMP_InitStruct->COMP_BlankingSrce = COMP_BlankingSrce_None;
mbed_official 125:23cc3068a9e4 300 COMP_InitStruct->COMP_OutputPol = COMP_OutputPol_NonInverted;
mbed_official 125:23cc3068a9e4 301 COMP_InitStruct->COMP_Hysteresis = COMP_Hysteresis_No;
mbed_official 125:23cc3068a9e4 302 COMP_InitStruct->COMP_Mode = COMP_Mode_UltraLowPower;
mbed_official 125:23cc3068a9e4 303 }
mbed_official 125:23cc3068a9e4 304
mbed_official 125:23cc3068a9e4 305 /**
mbed_official 125:23cc3068a9e4 306 * @brief Enable or disable the COMP peripheral.
mbed_official 125:23cc3068a9e4 307 * @note If the selected comparator is locked, enable/disable can't be performed.
mbed_official 125:23cc3068a9e4 308 * To unlock the configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 309 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 310 * This parameter can be COMP_Selection_COMPx where x can be 1 to 7
mbed_official 125:23cc3068a9e4 311 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 312 * @param NewState: new state of the COMP peripheral.
mbed_official 125:23cc3068a9e4 313 * This parameter can be: ENABLE or DISABLE.
mbed_official 125:23cc3068a9e4 314 * When enabled, the comparator compares the non inverting input with
mbed_official 125:23cc3068a9e4 315 * the inverting input and the comparison result is available
mbed_official 125:23cc3068a9e4 316 * on comparator output.
mbed_official 125:23cc3068a9e4 317 * When disabled, the comparator doesn't perform comparison and the
mbed_official 125:23cc3068a9e4 318 * output level is low.
mbed_official 125:23cc3068a9e4 319 * @retval None
mbed_official 125:23cc3068a9e4 320 */
mbed_official 125:23cc3068a9e4 321 void COMP_Cmd(uint32_t COMP_Selection, FunctionalState NewState)
mbed_official 125:23cc3068a9e4 322 {
mbed_official 125:23cc3068a9e4 323 /* Check the parameters */
mbed_official 125:23cc3068a9e4 324 assert_param(IS_COMP_ALL_PERIPH(COMP_Selection));
mbed_official 125:23cc3068a9e4 325 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 125:23cc3068a9e4 326
mbed_official 125:23cc3068a9e4 327 if (NewState != DISABLE)
mbed_official 125:23cc3068a9e4 328 {
mbed_official 125:23cc3068a9e4 329 /* Enable the selected COMPx peripheral */
mbed_official 125:23cc3068a9e4 330 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) |= (uint32_t) (COMP_CSR_COMPxEN);
mbed_official 125:23cc3068a9e4 331 }
mbed_official 125:23cc3068a9e4 332 else
mbed_official 125:23cc3068a9e4 333 {
mbed_official 125:23cc3068a9e4 334 /* Disable the selected COMP peripheral */
mbed_official 125:23cc3068a9e4 335 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) &= (uint32_t)(~COMP_CSR_COMPxEN);
mbed_official 125:23cc3068a9e4 336 }
mbed_official 125:23cc3068a9e4 337 }
mbed_official 125:23cc3068a9e4 338
mbed_official 125:23cc3068a9e4 339 /**
mbed_official 125:23cc3068a9e4 340 * @brief Close or Open the SW1 switch.
mbed_official 125:23cc3068a9e4 341 * @note If the COMP1 is locked, Close/Open the SW1 switch can't be performed.
mbed_official 125:23cc3068a9e4 342 * To unlock the configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 343 * @note This switch is solely intended to redirect signals onto high
mbed_official 125:23cc3068a9e4 344 * impedance input, such as COMP1 non-inverting input (highly resistive switch)
mbed_official 125:23cc3068a9e4 345 * @param NewState: New state of the analog switch.
mbed_official 125:23cc3068a9e4 346 * This parameter can be
mbed_official 125:23cc3068a9e4 347 * ENABLE so the SW1 is closed; PA1 is connected to PA4
mbed_official 125:23cc3068a9e4 348 * or DISABLE so the SW1 switch is open; PA1 is disconnected from PA4
mbed_official 125:23cc3068a9e4 349 * @retval None
mbed_official 125:23cc3068a9e4 350 */
mbed_official 125:23cc3068a9e4 351 void COMP_SwitchCmd(uint32_t COMP_Selection, FunctionalState NewState)
mbed_official 125:23cc3068a9e4 352 {
mbed_official 125:23cc3068a9e4 353 /* Check the parameter */
mbed_official 125:23cc3068a9e4 354 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 125:23cc3068a9e4 355
mbed_official 125:23cc3068a9e4 356 if (NewState != DISABLE)
mbed_official 125:23cc3068a9e4 357 {
mbed_official 125:23cc3068a9e4 358 /* Close SW1 switch */
mbed_official 125:23cc3068a9e4 359 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) |= (uint32_t) (COMP_CSR_COMP1SW1);
mbed_official 125:23cc3068a9e4 360 }
mbed_official 125:23cc3068a9e4 361 else
mbed_official 125:23cc3068a9e4 362 {
mbed_official 125:23cc3068a9e4 363 /* Open SW1 switch */
mbed_official 125:23cc3068a9e4 364 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) &= (uint32_t)(~COMP_CSR_COMP1SW1);
mbed_official 125:23cc3068a9e4 365 }
mbed_official 125:23cc3068a9e4 366 }
mbed_official 125:23cc3068a9e4 367
mbed_official 125:23cc3068a9e4 368 /**
mbed_official 125:23cc3068a9e4 369 * @brief Return the output level (high or low) of the selected comparator.
mbed_official 125:23cc3068a9e4 370 * The output level depends on the selected polarity.
mbed_official 125:23cc3068a9e4 371 * If the polarity is not inverted:
mbed_official 125:23cc3068a9e4 372 * - Comparator output is low when the non-inverting input is at a lower
mbed_official 125:23cc3068a9e4 373 * voltage than the inverting input
mbed_official 125:23cc3068a9e4 374 * - Comparator output is high when the non-inverting input is at a higher
mbed_official 125:23cc3068a9e4 375 * voltage than the inverting input
mbed_official 125:23cc3068a9e4 376 * If the polarity is inverted:
mbed_official 125:23cc3068a9e4 377 * - Comparator output is high when the non-inverting input is at a lower
mbed_official 125:23cc3068a9e4 378 * voltage than the inverting input
mbed_official 125:23cc3068a9e4 379 * - Comparator output is low when the non-inverting input is at a higher
mbed_official 125:23cc3068a9e4 380 * voltage than the inverting input
mbed_official 125:23cc3068a9e4 381 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 382 * This parameter can be COMP_Selection_COMPx where x can be 1 to 7
mbed_official 125:23cc3068a9e4 383 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 384 * @retval Returns the selected comparator output level: low or high.
mbed_official 125:23cc3068a9e4 385 *
mbed_official 125:23cc3068a9e4 386 */
mbed_official 125:23cc3068a9e4 387 uint32_t COMP_GetOutputLevel(uint32_t COMP_Selection)
mbed_official 125:23cc3068a9e4 388 {
mbed_official 125:23cc3068a9e4 389 uint32_t compout = 0x0;
mbed_official 125:23cc3068a9e4 390
mbed_official 125:23cc3068a9e4 391 /* Check the parameters */
mbed_official 125:23cc3068a9e4 392 assert_param(IS_COMP_ALL_PERIPH(COMP_Selection));
mbed_official 125:23cc3068a9e4 393
mbed_official 125:23cc3068a9e4 394 /* Check if selected comparator output is high */
mbed_official 125:23cc3068a9e4 395 if ((*(__IO uint32_t *) (COMP_BASE + COMP_Selection) & (COMP_CSR_COMPxOUT)) != 0)
mbed_official 125:23cc3068a9e4 396 {
mbed_official 125:23cc3068a9e4 397 compout = COMP_OutputLevel_High;
mbed_official 125:23cc3068a9e4 398 }
mbed_official 125:23cc3068a9e4 399 else
mbed_official 125:23cc3068a9e4 400 {
mbed_official 125:23cc3068a9e4 401 compout = COMP_OutputLevel_Low;
mbed_official 125:23cc3068a9e4 402 }
mbed_official 125:23cc3068a9e4 403
mbed_official 125:23cc3068a9e4 404 /* Return the comparator output level */
mbed_official 125:23cc3068a9e4 405 return (uint32_t)(compout);
mbed_official 125:23cc3068a9e4 406 }
mbed_official 125:23cc3068a9e4 407
mbed_official 125:23cc3068a9e4 408 /**
mbed_official 125:23cc3068a9e4 409 * @}
mbed_official 125:23cc3068a9e4 410 */
mbed_official 125:23cc3068a9e4 411
mbed_official 125:23cc3068a9e4 412 /** @defgroup COMP_Group2 Window mode control function
mbed_official 125:23cc3068a9e4 413 * @brief Window mode control function
mbed_official 125:23cc3068a9e4 414 *
mbed_official 125:23cc3068a9e4 415 @verbatim
mbed_official 125:23cc3068a9e4 416 ===============================================================================
mbed_official 125:23cc3068a9e4 417 ##### Window mode control function #####
mbed_official 125:23cc3068a9e4 418 ===============================================================================
mbed_official 125:23cc3068a9e4 419
mbed_official 125:23cc3068a9e4 420 @endverbatim
mbed_official 125:23cc3068a9e4 421 * @{
mbed_official 125:23cc3068a9e4 422 */
mbed_official 125:23cc3068a9e4 423
mbed_official 125:23cc3068a9e4 424 /**
mbed_official 125:23cc3068a9e4 425 * @brief Enables or disables the window mode.
mbed_official 125:23cc3068a9e4 426 * Window mode for comparators makes use of two comparators:
mbed_official 125:23cc3068a9e4 427 * COMP1 and COM2, COMP3 and COMP4, COMP5 and COMP6.
mbed_official 125:23cc3068a9e4 428 * In window mode, COMPx and COMPx-1 (where x can be 2, 4 or 6)
mbed_official 125:23cc3068a9e4 429 * non inverting inputs are connected together and only COMPx-1 non
mbed_official 125:23cc3068a9e4 430 * inverting input can be used.
mbed_official 125:23cc3068a9e4 431 * e.g When window mode enabled for COMP4, COMP3 non inverting input (PB14 or PD14)
mbed_official 125:23cc3068a9e4 432 * is to be used.
mbed_official 125:23cc3068a9e4 433 * @note If the COMPx is locked, ENABLE/DISABLE the window mode can't be performed.
mbed_official 125:23cc3068a9e4 434 * To unlock the configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 435 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 436 * This parameter can be COMP_Selection_COMPx where x can be 2, 4 or 6
mbed_official 125:23cc3068a9e4 437 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 438 * param NewState: new state of the window mode.
mbed_official 125:23cc3068a9e4 439 * This parameter can be ENABLE or DISABLE.
mbed_official 125:23cc3068a9e4 440 * When enbaled, COMPx and COMPx-1 non inverting inputs are connected together.
mbed_official 125:23cc3068a9e4 441 * When disabled, COMPx and COMPx-1 non inverting inputs are disconnected.
mbed_official 125:23cc3068a9e4 442 * @retval None
mbed_official 125:23cc3068a9e4 443 */
mbed_official 125:23cc3068a9e4 444 void COMP_WindowCmd(uint32_t COMP_Selection, FunctionalState NewState)
mbed_official 125:23cc3068a9e4 445 {
mbed_official 125:23cc3068a9e4 446 /* Check the parameters */
mbed_official 125:23cc3068a9e4 447 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 125:23cc3068a9e4 448 assert_param(IS_COMP_WINDOW(COMP_Selection));
mbed_official 125:23cc3068a9e4 449
mbed_official 125:23cc3068a9e4 450 if (NewState != DISABLE)
mbed_official 125:23cc3068a9e4 451 {
mbed_official 125:23cc3068a9e4 452 /* Enable the window mode */
mbed_official 125:23cc3068a9e4 453 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) |= (uint32_t) COMP_CSR_COMPxWNDWEN;
mbed_official 125:23cc3068a9e4 454 }
mbed_official 125:23cc3068a9e4 455 else
mbed_official 125:23cc3068a9e4 456 {
mbed_official 125:23cc3068a9e4 457 /* Disable the window mode */
mbed_official 125:23cc3068a9e4 458 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) &= (uint32_t)(~COMP_CSR_COMPxWNDWEN);
mbed_official 125:23cc3068a9e4 459 }
mbed_official 125:23cc3068a9e4 460 }
mbed_official 125:23cc3068a9e4 461
mbed_official 125:23cc3068a9e4 462 /**
mbed_official 125:23cc3068a9e4 463 * @}
mbed_official 125:23cc3068a9e4 464 */
mbed_official 125:23cc3068a9e4 465
mbed_official 125:23cc3068a9e4 466 /** @defgroup COMP_Group3 COMP configuration locking function
mbed_official 125:23cc3068a9e4 467 * @brief COMP1, COMP2,...COMP7 configuration locking function
mbed_official 125:23cc3068a9e4 468 * COMP1, COMP2,...COMP7 configuration can be locked each separately.
mbed_official 125:23cc3068a9e4 469 * Unlocking is performed by system reset.
mbed_official 125:23cc3068a9e4 470 *
mbed_official 125:23cc3068a9e4 471 @verbatim
mbed_official 125:23cc3068a9e4 472 ===============================================================================
mbed_official 125:23cc3068a9e4 473 ##### Configuration Lock function #####
mbed_official 125:23cc3068a9e4 474 ===============================================================================
mbed_official 125:23cc3068a9e4 475
mbed_official 125:23cc3068a9e4 476 @endverbatim
mbed_official 125:23cc3068a9e4 477 * @{
mbed_official 125:23cc3068a9e4 478 */
mbed_official 125:23cc3068a9e4 479
mbed_official 125:23cc3068a9e4 480 /**
mbed_official 125:23cc3068a9e4 481 * @brief Lock the selected comparator (COMP1/COMP2) configuration.
mbed_official 125:23cc3068a9e4 482 * @note Locking the configuration means that all control bits are read-only.
mbed_official 125:23cc3068a9e4 483 * To unlock the comparator configuration, perform a system reset.
mbed_official 125:23cc3068a9e4 484 * @param COMP_Selection: the selected comparator.
mbed_official 125:23cc3068a9e4 485 * This parameter can be COMP_Selection_COMPx where x can be 1 to 7
mbed_official 125:23cc3068a9e4 486 * to select the COMP peripheral.
mbed_official 125:23cc3068a9e4 487 * @retval None
mbed_official 125:23cc3068a9e4 488 */
mbed_official 125:23cc3068a9e4 489 void COMP_LockConfig(uint32_t COMP_Selection)
mbed_official 125:23cc3068a9e4 490 {
mbed_official 125:23cc3068a9e4 491 /* Check the parameter */
mbed_official 125:23cc3068a9e4 492 assert_param(IS_COMP_ALL_PERIPH(COMP_Selection));
mbed_official 125:23cc3068a9e4 493
mbed_official 125:23cc3068a9e4 494 /* Set the lock bit corresponding to selected comparator */
mbed_official 125:23cc3068a9e4 495 *(__IO uint32_t *) (COMP_BASE + COMP_Selection) |= (uint32_t) (COMP_CSR_COMPxLOCK);
mbed_official 125:23cc3068a9e4 496 }
mbed_official 125:23cc3068a9e4 497
mbed_official 125:23cc3068a9e4 498 /**
mbed_official 125:23cc3068a9e4 499 * @}
mbed_official 125:23cc3068a9e4 500 */
mbed_official 125:23cc3068a9e4 501
mbed_official 125:23cc3068a9e4 502 /**
mbed_official 125:23cc3068a9e4 503 * @}
mbed_official 125:23cc3068a9e4 504 */
mbed_official 125:23cc3068a9e4 505
mbed_official 125:23cc3068a9e4 506 /**
mbed_official 125:23cc3068a9e4 507 * @}
mbed_official 125:23cc3068a9e4 508 */
mbed_official 125:23cc3068a9e4 509
mbed_official 125:23cc3068a9e4 510 /**
mbed_official 125:23cc3068a9e4 511 * @}
mbed_official 125:23cc3068a9e4 512 */
mbed_official 125:23cc3068a9e4 513
mbed_official 125:23cc3068a9e4 514 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/