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/TOOLCHAIN_ARM_MICRO/stm32l0xx_hal_adc_ex.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_NUCLEO_L011K4/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_adc_ex.h@167:84c0a372a020 
mbed library. Release version 164

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