mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

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

TARGET_NUCLEO_L011K4/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_adc_ex.h@157:e7ca05fa8600, 2017-11-09 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 09 11:14:10 2017 +0000
Revision:
157:e7ca05fa8600
Child:
167:84c0a372a020
Release 155 of the mbed library.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 157:e7ca05fa8600 1 /**
AnnaBridge 157:e7ca05fa8600 2 ******************************************************************************
AnnaBridge 157:e7ca05fa8600 3 * @file stm32l0xx_hal_adc_ex.h
AnnaBridge 157:e7ca05fa8600 4 * @author MCD Application Team
AnnaBridge 157:e7ca05fa8600 5 * @version V1.7.0
AnnaBridge 157:e7ca05fa8600 6 * @date 31-May-2016
AnnaBridge 157:e7ca05fa8600 7 * @brief This file contains all the functions prototypes for the ADC firmware
AnnaBridge 157:e7ca05fa8600 8 * library.
AnnaBridge 157:e7ca05fa8600 9 ******************************************************************************
AnnaBridge 157:e7ca05fa8600 10 * @attention
AnnaBridge 157:e7ca05fa8600 11 *
AnnaBridge 157:e7ca05fa8600 12 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 157:e7ca05fa8600 13 *
AnnaBridge 157:e7ca05fa8600 14 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 157:e7ca05fa8600 15 * are permitted provided that the following conditions are met:
AnnaBridge 157:e7ca05fa8600 16 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 157:e7ca05fa8600 17 * this list of conditions and the following disclaimer.
AnnaBridge 157:e7ca05fa8600 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 157:e7ca05fa8600 19 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 157:e7ca05fa8600 20 * and/or other materials provided with the distribution.
AnnaBridge 157:e7ca05fa8600 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 157:e7ca05fa8600 22 * may be used to endorse or promote products derived from this software
AnnaBridge 157:e7ca05fa8600 23 * without specific prior written permission.
AnnaBridge 157:e7ca05fa8600 24 *
AnnaBridge 157:e7ca05fa8600 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 157:e7ca05fa8600 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 157:e7ca05fa8600 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 157:e7ca05fa8600 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 157:e7ca05fa8600 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 157:e7ca05fa8600 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 157:e7ca05fa8600 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 157:e7ca05fa8600 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 157:e7ca05fa8600 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 157:e7ca05fa8600 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 157:e7ca05fa8600 35 *
AnnaBridge 157:e7ca05fa8600 36 ******************************************************************************
AnnaBridge 157:e7ca05fa8600 37 */
AnnaBridge 157:e7ca05fa8600 38
AnnaBridge 157:e7ca05fa8600 39 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 157:e7ca05fa8600 40 #ifndef __STM32L0xx_ADC_EX_H
AnnaBridge 157:e7ca05fa8600 41 #define __STM32L0xx_ADC_EX_H
AnnaBridge 157:e7ca05fa8600 42
AnnaBridge 157:e7ca05fa8600 43 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 44 extern "C" {
AnnaBridge 157:e7ca05fa8600 45 #endif
AnnaBridge 157:e7ca05fa8600 46
AnnaBridge 157:e7ca05fa8600 47 /* Includes ------------------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 48 #include "stm32l0xx_hal_def.h"
AnnaBridge 157:e7ca05fa8600 49
AnnaBridge 157:e7ca05fa8600 50 /** @addtogroup STM32L0xx_HAL_Driver
AnnaBridge 157:e7ca05fa8600 51 * @{
AnnaBridge 157:e7ca05fa8600 52 */
AnnaBridge 157:e7ca05fa8600 53
AnnaBridge 157:e7ca05fa8600 54 /** @defgroup ADCEx ADCEx
AnnaBridge 157:e7ca05fa8600 55 * @brief ADC driver modules
AnnaBridge 157:e7ca05fa8600 56 * @{
AnnaBridge 157:e7ca05fa8600 57 */
AnnaBridge 157:e7ca05fa8600 58
AnnaBridge 157:e7ca05fa8600 59 /* Exported types ------------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 60 /* Exported constants --------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 61 /** @defgroup ADCEx_Exported_Constants ADCEx Exported Constants
AnnaBridge 157:e7ca05fa8600 62 * @{
AnnaBridge 157:e7ca05fa8600 63 */
AnnaBridge 157:e7ca05fa8600 64
AnnaBridge 157:e7ca05fa8600 65 /** @defgroup ADCEx_Channel_Mode ADC Single Ended
AnnaBridge 157:e7ca05fa8600 66 * @{
AnnaBridge 157:e7ca05fa8600 67 */
AnnaBridge 157:e7ca05fa8600 68 #define ADC_SINGLE_ENDED (uint32_t)0x00000000U /* dummy value */
AnnaBridge 157:e7ca05fa8600 69 /**
AnnaBridge 157:e7ca05fa8600 70 * @}
AnnaBridge 157:e7ca05fa8600 71 */
AnnaBridge 157:e7ca05fa8600 72
AnnaBridge 157:e7ca05fa8600 73 /** @defgroup ADC_External_trigger_Source ADC External Trigger Source
AnnaBridge 157:e7ca05fa8600 74 * @{
AnnaBridge 157:e7ca05fa8600 75 */
AnnaBridge 157:e7ca05fa8600 76 #define ADC_EXTERNALTRIGCONV_T6_TRGO ((uint32_t)0x00000000U)
AnnaBridge 157:e7ca05fa8600 77 #define ADC_EXTERNALTRIGCONV_T21_CC2 (ADC_CFGR1_EXTSEL_0)
AnnaBridge 157:e7ca05fa8600 78 #define ADC_EXTERNALTRIGCONV_T2_TRGO (ADC_CFGR1_EXTSEL_1)
AnnaBridge 157:e7ca05fa8600 79 #define ADC_EXTERNALTRIGCONV_T2_CC4 (ADC_CFGR1_EXTSEL_1 | ADC_CFGR1_EXTSEL_0)
AnnaBridge 157:e7ca05fa8600 80 #define ADC_EXTERNALTRIGCONV_T22_TRGO (ADC_CFGR1_EXTSEL_2)
AnnaBridge 157:e7ca05fa8600 81 #define ADC_EXTERNALTRIGCONV_T3_TRGO (ADC_CFGR1_EXTSEL_2 | ADC_CFGR1_EXTSEL_1)
AnnaBridge 157:e7ca05fa8600 82 #define ADC_EXTERNALTRIGCONV_EXT_IT11 (ADC_CFGR1_EXTSEL_2 | ADC_CFGR1_EXTSEL_1 | ADC_CFGR1_EXTSEL_0)
AnnaBridge 157:e7ca05fa8600 83 #define ADC_SOFTWARE_START (ADC_CFGR1_EXTSEL + (uint32_t)1)
AnnaBridge 157:e7ca05fa8600 84
AnnaBridge 157:e7ca05fa8600 85 /* ADC group regular external trigger TIM21_TRGO available only on */
AnnaBridge 157:e7ca05fa8600 86 /* STM32L0 devices categories: Cat.2, Cat.3, Cat.5 */
AnnaBridge 157:e7ca05fa8600 87 #if defined (STM32L031xx) || defined (STM32L041xx) || \
AnnaBridge 157:e7ca05fa8600 88 defined (STM32L051xx) || defined (STM32L052xx) || defined (STM32L053xx) || \
AnnaBridge 157:e7ca05fa8600 89 defined (STM32L061xx) || defined (STM32L062xx) || defined (STM32L063xx) || \
AnnaBridge 157:e7ca05fa8600 90 defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || \
AnnaBridge 157:e7ca05fa8600 91 defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx)
AnnaBridge 157:e7ca05fa8600 92 #define ADC_EXTERNALTRIGCONV_T21_TRGO (ADC_EXTERNALTRIGCONV_T22_TRGO)
AnnaBridge 157:e7ca05fa8600 93 #endif
AnnaBridge 157:e7ca05fa8600 94
AnnaBridge 157:e7ca05fa8600 95 /* ADC group regular external trigger TIM2_CC3 available only on */
AnnaBridge 157:e7ca05fa8600 96 /* STM32L0 devices categories: Cat.1, Cat.2, Cat.5 */
AnnaBridge 157:e7ca05fa8600 97 #if defined (STM32L011xx) || defined (STM32L021xx) || \
AnnaBridge 157:e7ca05fa8600 98 defined (STM32L031xx) || defined (STM32L041xx) || \
AnnaBridge 157:e7ca05fa8600 99 defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || \
AnnaBridge 157:e7ca05fa8600 100 defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx)
AnnaBridge 157:e7ca05fa8600 101 #define ADC_EXTERNALTRIGCONV_T2_CC3 (ADC_CFGR1_EXTSEL_2 | ADC_CFGR1_EXTSEL_0)
AnnaBridge 157:e7ca05fa8600 102 #endif
AnnaBridge 157:e7ca05fa8600 103
AnnaBridge 157:e7ca05fa8600 104 /**
AnnaBridge 157:e7ca05fa8600 105 * @}
AnnaBridge 157:e7ca05fa8600 106 */
AnnaBridge 157:e7ca05fa8600 107
AnnaBridge 157:e7ca05fa8600 108 /** @defgroup ADC_SYSCFG_internal_paths_flags_definition ADC SYSCFG internal paths Flags Definition
AnnaBridge 157:e7ca05fa8600 109 * @{
AnnaBridge 157:e7ca05fa8600 110 */
AnnaBridge 157:e7ca05fa8600 111 #define ADC_FLAG_SENSOR SYSCFG_CFGR3_VREFINT_RDYF
AnnaBridge 157:e7ca05fa8600 112 #define ADC_FLAG_VREFINT SYSCFG_VREFINT_ADC_RDYF
AnnaBridge 157:e7ca05fa8600 113 /**
AnnaBridge 157:e7ca05fa8600 114 * @}
AnnaBridge 157:e7ca05fa8600 115 */
AnnaBridge 157:e7ca05fa8600 116
AnnaBridge 157:e7ca05fa8600 117 /**
AnnaBridge 157:e7ca05fa8600 118 * @}
AnnaBridge 157:e7ca05fa8600 119 */
AnnaBridge 157:e7ca05fa8600 120
AnnaBridge 157:e7ca05fa8600 121 /* Private macros ------------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 122
AnnaBridge 157:e7ca05fa8600 123 /** @defgroup ADCEx_Private_Macros ADCEx Private Macros
AnnaBridge 157:e7ca05fa8600 124 * @{
AnnaBridge 157:e7ca05fa8600 125 */
AnnaBridge 157:e7ca05fa8600 126
AnnaBridge 157:e7ca05fa8600 127 #define IS_ADC_SINGLE_DIFFERENTIAL(SING_DIFF) ((SING_DIFF) == ADC_SINGLE_ENDED)
AnnaBridge 157:e7ca05fa8600 128
AnnaBridge 157:e7ca05fa8600 129 /** @defgroup ADCEx_calibration_factor_length_verification ADC Calibration Factor Length Verification
AnnaBridge 157:e7ca05fa8600 130 * @{
AnnaBridge 157:e7ca05fa8600 131 */
AnnaBridge 157:e7ca05fa8600 132 /**
AnnaBridge 157:e7ca05fa8600 133 * @brief Calibration factor length verification (7 bits maximum)
AnnaBridge 157:e7ca05fa8600 134 * @param _Calibration_Factor_: Calibration factor value
AnnaBridge 157:e7ca05fa8600 135 * @retval None
AnnaBridge 157:e7ca05fa8600 136 */
AnnaBridge 157:e7ca05fa8600 137 #define IS_ADC_CALFACT(_Calibration_Factor_) ((_Calibration_Factor_) <= ((uint32_t)0x7FU))
AnnaBridge 157:e7ca05fa8600 138 /**
AnnaBridge 157:e7ca05fa8600 139 * @}
AnnaBridge 157:e7ca05fa8600 140 */
AnnaBridge 157:e7ca05fa8600 141
AnnaBridge 157:e7ca05fa8600 142 /** @defgroup ADC_External_trigger_Source ADC External Trigger Source
AnnaBridge 157:e7ca05fa8600 143 * @{
AnnaBridge 157:e7ca05fa8600 144 */
AnnaBridge 157:e7ca05fa8600 145 #if defined (STM32L031xx) || defined (STM32L041xx) || \
AnnaBridge 157:e7ca05fa8600 146 defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || \
AnnaBridge 157:e7ca05fa8600 147 defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx)
AnnaBridge 157:e7ca05fa8600 148 #define IS_ADC_EXTTRIG(CONV) (((CONV) == ADC_EXTERNALTRIGCONV_T6_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 149 ((CONV) == ADC_EXTERNALTRIGCONV_T21_CC2 ) || \
AnnaBridge 157:e7ca05fa8600 150 ((CONV) == ADC_EXTERNALTRIGCONV_T2_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 151 ((CONV) == ADC_EXTERNALTRIGCONV_T2_CC4 ) || \
AnnaBridge 157:e7ca05fa8600 152 ((CONV) == ADC_EXTERNALTRIGCONV_T22_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 153 ((CONV) == ADC_EXTERNALTRIGCONV_T21_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 154 ((CONV) == ADC_EXTERNALTRIGCONV_T2_CC3 ) || \
AnnaBridge 157:e7ca05fa8600 155 ((CONV) == ADC_EXTERNALTRIGCONV_T3_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 156 ((CONV) == ADC_EXTERNALTRIGCONV_EXT_IT11 ) || \
AnnaBridge 157:e7ca05fa8600 157 ((CONV) == ADC_SOFTWARE_START))
AnnaBridge 157:e7ca05fa8600 158 #elif defined (STM32L011xx) || defined (STM32L021xx)
AnnaBridge 157:e7ca05fa8600 159 #define IS_ADC_EXTTRIG(CONV) (((CONV) == ADC_EXTERNALTRIGCONV_T6_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 160 ((CONV) == ADC_EXTERNALTRIGCONV_T21_CC2 ) || \
AnnaBridge 157:e7ca05fa8600 161 ((CONV) == ADC_EXTERNALTRIGCONV_T2_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 162 ((CONV) == ADC_EXTERNALTRIGCONV_T2_CC4 ) || \
AnnaBridge 157:e7ca05fa8600 163 ((CONV) == ADC_EXTERNALTRIGCONV_T22_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 164 ((CONV) == ADC_EXTERNALTRIGCONV_T2_CC3 ) || \
AnnaBridge 157:e7ca05fa8600 165 ((CONV) == ADC_EXTERNALTRIGCONV_T3_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 166 ((CONV) == ADC_EXTERNALTRIGCONV_EXT_IT11 ) || \
AnnaBridge 157:e7ca05fa8600 167 ((CONV) == ADC_SOFTWARE_START))
AnnaBridge 157:e7ca05fa8600 168 #elif defined (STM32L051xx) || defined (STM32L052xx) || defined (STM32L053xx) || \
AnnaBridge 157:e7ca05fa8600 169 defined (STM32L061xx) || defined (STM32L062xx) || defined (STM32L063xx)
AnnaBridge 157:e7ca05fa8600 170 #define IS_ADC_EXTTRIG(CONV) (((CONV) == ADC_EXTERNALTRIGCONV_T6_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 171 ((CONV) == ADC_EXTERNALTRIGCONV_T21_CC2 ) || \
AnnaBridge 157:e7ca05fa8600 172 ((CONV) == ADC_EXTERNALTRIGCONV_T2_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 173 ((CONV) == ADC_EXTERNALTRIGCONV_T2_CC4 ) || \
AnnaBridge 157:e7ca05fa8600 174 ((CONV) == ADC_EXTERNALTRIGCONV_T22_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 175 ((CONV) == ADC_EXTERNALTRIGCONV_T21_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 176 ((CONV) == ADC_EXTERNALTRIGCONV_T3_TRGO ) || \
AnnaBridge 157:e7ca05fa8600 177 ((CONV) == ADC_EXTERNALTRIGCONV_EXT_IT11 ) || \
AnnaBridge 157:e7ca05fa8600 178 ((CONV) == ADC_SOFTWARE_START))
AnnaBridge 157:e7ca05fa8600 179 #endif
AnnaBridge 157:e7ca05fa8600 180 /**
AnnaBridge 157:e7ca05fa8600 181 * @}
AnnaBridge 157:e7ca05fa8600 182 */
AnnaBridge 157:e7ca05fa8600 183
AnnaBridge 157:e7ca05fa8600 184 /**
AnnaBridge 157:e7ca05fa8600 185 * @}
AnnaBridge 157:e7ca05fa8600 186 */
AnnaBridge 157:e7ca05fa8600 187
AnnaBridge 157:e7ca05fa8600 188 /** @defgroup ADCEx_Exported_Functions ADCEx Exported Functions
AnnaBridge 157:e7ca05fa8600 189 * @{
AnnaBridge 157:e7ca05fa8600 190 */
AnnaBridge 157:e7ca05fa8600 191
AnnaBridge 157:e7ca05fa8600 192 /** @defgroup ADCEx_Exported_Functions_Group3 Peripheral Control functions
AnnaBridge 157:e7ca05fa8600 193 * @{
AnnaBridge 157:e7ca05fa8600 194 */
AnnaBridge 157:e7ca05fa8600 195 /* Exported functions --------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 196 /* Peripheral Control functions ***********************************************/
AnnaBridge 157:e7ca05fa8600 197 HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc, uint32_t SingleDiff);
AnnaBridge 157:e7ca05fa8600 198 uint32_t HAL_ADCEx_Calibration_GetValue(ADC_HandleTypeDef* hadc, uint32_t SingleDiff);
AnnaBridge 157:e7ca05fa8600 199 HAL_StatusTypeDef HAL_ADCEx_Calibration_SetValue(ADC_HandleTypeDef* hadc, uint32_t SingleDiff, uint32_t CalibrationFactor);
AnnaBridge 157:e7ca05fa8600 200 HAL_StatusTypeDef HAL_ADCEx_EnableVREFINT(void);
AnnaBridge 157:e7ca05fa8600 201 void HAL_ADCEx_DisableVREFINT(void);
AnnaBridge 157:e7ca05fa8600 202 HAL_StatusTypeDef HAL_ADCEx_EnableVREFINTTempSensor(void);
AnnaBridge 157:e7ca05fa8600 203 void HAL_ADCEx_DisableVREFINTTempSensor(void);
AnnaBridge 157:e7ca05fa8600 204 /**
AnnaBridge 157:e7ca05fa8600 205 * @}
AnnaBridge 157:e7ca05fa8600 206 */
AnnaBridge 157:e7ca05fa8600 207
AnnaBridge 157:e7ca05fa8600 208 /**
AnnaBridge 157:e7ca05fa8600 209 * @}
AnnaBridge 157:e7ca05fa8600 210 */
AnnaBridge 157:e7ca05fa8600 211
AnnaBridge 157:e7ca05fa8600 212 /**
AnnaBridge 157:e7ca05fa8600 213 * @}
AnnaBridge 157:e7ca05fa8600 214 */
AnnaBridge 157:e7ca05fa8600 215
AnnaBridge 157:e7ca05fa8600 216 /**
AnnaBridge 157:e7ca05fa8600 217 * @}
AnnaBridge 157:e7ca05fa8600 218 */
AnnaBridge 157:e7ca05fa8600 219
AnnaBridge 157:e7ca05fa8600 220 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 221 }
AnnaBridge 157:e7ca05fa8600 222 #endif
AnnaBridge 157:e7ca05fa8600 223
AnnaBridge 157:e7ca05fa8600 224 #endif /*__STM32L0xx_ADC_H */
AnnaBridge 157:e7ca05fa8600 225
AnnaBridge 157:e7ca05fa8600 226
AnnaBridge 157:e7ca05fa8600 227 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
AnnaBridge 157:e7ca05fa8600 228