/** | |
****************************************************************************** | |
* @file stm32f0xx_hal_adc_ex.h | |
* @author MCD Application Team | |
* @brief Header file of ADC HAL Extension module. | |
****************************************************************************** | |
* @attention | |
* | |
* <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2> | |
* | |
* Redistribution and use in source and binary forms, with or without modification, | |
* are permitted provided that the following conditions are met: | |
* 1. Redistributions of source code must retain the above copyright notice, | |
* this list of conditions and the following disclaimer. | |
* 2. Redistributions in binary form must reproduce the above copyright notice, | |
* this list of conditions and the following disclaimer in the documentation | |
* and/or other materials provided with the distribution. | |
* 3. Neither the name of STMicroelectronics nor the names of its contributors | |
* may be used to endorse or promote products derived from this software | |
* without specific prior written permission. | |
* | |
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE | |
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR | |
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER | |
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
* | |
****************************************************************************** | |
*/ | |
/* Define to prevent recursive inclusion -------------------------------------*/ | |
#ifndef __STM32F0xx_HAL_ADC_EX_H | |
#define __STM32F0xx_HAL_ADC_EX_H | |
#ifdef __cplusplus | |
extern "C" { | |
#endif | |
/* Includes ------------------------------------------------------------------*/ | |
#include "stm32f0xx_hal_def.h" | |
/** @addtogroup STM32F0xx_HAL_Driver | |
* @{ | |
*/ | |
/** @addtogroup ADCEx | |
* @{ | |
*/ | |
/* Exported types ------------------------------------------------------------*/ | |
/* Exported constants --------------------------------------------------------*/ | |
/** @defgroup ADC_Exported_Constants ADC Exported Constants | |
* @{ | |
*/ | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define ADC_CCR_ALL (ADC_CCR_VBATEN | ADC_CCR_TSEN | ADC_CCR_VREFEN) | |
#else | |
#define ADC_CCR_ALL (ADC_CCR_TSEN | ADC_CCR_VREFEN) | |
#endif | |
/** @defgroup ADC_External_trigger_source_Regular ADC External trigger source Regular | |
* @{ | |
*/ | |
/* List of external triggers with generic trigger name, sorted by trigger */ | |
/* name: */ | |
/* External triggers of regular group for ADC1 */ | |
#define ADC_EXTERNALTRIGCONV_T1_TRGO ADC1_2_EXTERNALTRIG_T1_TRGO | |
#define ADC_EXTERNALTRIGCONV_T1_CC4 ADC1_2_EXTERNALTRIG_T1_CC4 | |
#define ADC_EXTERNALTRIGCONV_T3_TRGO ADC1_2_EXTERNALTRIG_T3_TRGO | |
#define ADC_SOFTWARE_START (ADC_CFGR1_EXTSEL + 1U) | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define ADC_EXTERNALTRIGCONV_T2_TRGO ADC1_2_EXTERNALTRIG_T2_TRGO | |
#endif | |
#if !defined(STM32F030x6) && !defined(STM32F070x6) && !defined(STM32F042x6) | |
#define ADC_EXTERNALTRIGCONV_T15_TRGO ADC1_2_EXTERNALTRIG_T15_TRGO | |
#endif | |
/** | |
* @} | |
*/ | |
/** @defgroup ADC_channels ADC channels | |
* @{ | |
*/ | |
/* Note: Depending on devices, some channels may not be available on package */ | |
/* pins. Refer to device datasheet for channels availability. */ | |
/* Note: Channels are used by bitfields for setting of channel selection */ | |
/* (register ADC_CHSELR) and used by number for setting of analog */ | |
/* watchdog channel (bits AWDCH in register ADC_CFGR1). */ | |
/* Channels are defined with decimal numbers and converted them to */ | |
/* bitfields when needed. */ | |
#define ADC_CHANNEL_0 ( 0x00000000U) | |
#define ADC_CHANNEL_1 ( 0x00000001U) | |
#define ADC_CHANNEL_2 ( 0x00000002U) | |
#define ADC_CHANNEL_3 ( 0x00000003U) | |
#define ADC_CHANNEL_4 ( 0x00000004U) | |
#define ADC_CHANNEL_5 ( 0x00000005U) | |
#define ADC_CHANNEL_6 ( 0x00000006U) | |
#define ADC_CHANNEL_7 ( 0x00000007U) | |
#define ADC_CHANNEL_8 ( 0x00000008U) | |
#define ADC_CHANNEL_9 ( 0x00000009U) | |
#define ADC_CHANNEL_10 ( 0x0000000AU) | |
#define ADC_CHANNEL_11 ( 0x0000000BU) | |
#define ADC_CHANNEL_12 ( 0x0000000CU) | |
#define ADC_CHANNEL_13 ( 0x0000000DU) | |
#define ADC_CHANNEL_14 ( 0x0000000EU) | |
#define ADC_CHANNEL_15 ( 0x0000000FU) | |
#define ADC_CHANNEL_16 ( 0x00000010U) | |
#define ADC_CHANNEL_17 ( 0x00000011U) | |
#define ADC_CHANNEL_TEMPSENSOR ADC_CHANNEL_16 | |
#define ADC_CHANNEL_VREFINT ADC_CHANNEL_17 | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define ADC_CHANNEL_18 ( 0x00000012U) | |
#define ADC_CHANNEL_VBAT ADC_CHANNEL_18 | |
#endif | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
/* Exported macro ------------------------------------------------------------*/ | |
/* Private macros ------------------------------------------------------------*/ | |
/** @defgroup ADCEx_Private_Macros ADCEx Private Macros | |
* @{ | |
*/ | |
/* Macro reserved for internal HAL driver usage, not intended to be used in */ | |
/* code of final user. */ | |
/** | |
* @brief Test if the selected ADC channel is an internal channel | |
* VrefInt/TempSensor/Vbat | |
* Note: On STM32F0, availability of internal channel Vbat depends on | |
* devices lines. | |
* @param __CHANNEL__ ADC channel | |
* @retval None | |
*/ | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define ADC_IS_CHANNEL_INTERNAL(__CHANNEL__) \ | |
(((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR) || \ | |
((__CHANNEL__) == ADC_CHANNEL_VREFINT) || \ | |
((__CHANNEL__) == ADC_CHANNEL_VBAT) \ | |
) | |
#else | |
#define ADC_IS_CHANNEL_INTERNAL(__CHANNEL__) \ | |
(((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR) || \ | |
((__CHANNEL__) == ADC_CHANNEL_VREFINT) \ | |
) | |
#endif | |
/** | |
* @brief Select the internal measurement path to be enabled/disabled | |
* corresponding to the selected ADC internal channel | |
* VrefInt/TempSensor/Vbat. | |
* Note: On STM32F0, availability of internal channel Vbat depends on | |
* devices lines. | |
* @param __CHANNEL__ ADC channel | |
* @retval Bit of register ADC_CCR | |
*/ | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define ADC_CHANNEL_INTERNAL_PATH(__CHANNEL__) \ | |
(( (__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR \ | |
)? \ | |
(ADC_CCR_TSEN) \ | |
: \ | |
( \ | |
( (__CHANNEL__) == ADC_CHANNEL_VREFINT \ | |
)? \ | |
(ADC_CCR_VREFEN) \ | |
: \ | |
(ADC_CCR_VBATEN) \ | |
) \ | |
) | |
#else | |
#define ADC_CHANNEL_INTERNAL_PATH(__CHANNEL__) \ | |
(( (__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR \ | |
)? \ | |
(ADC_CCR_TSEN) \ | |
: \ | |
(ADC_CCR_VREFEN) \ | |
) | |
#endif | |
#if defined (STM32F030x6) || defined (STM32F070x6) | |
#define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \ | |
((REGTRIG) == ADC_SOFTWARE_START)) | |
#elif defined (STM32F042x6) | |
#define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T2_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \ | |
((REGTRIG) == ADC_SOFTWARE_START)) | |
#elif defined (STM32F030xC) || defined (STM32F070xB) || defined (STM32F030x8) | |
#define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T15_TRGO) || \ | |
((REGTRIG) == ADC_SOFTWARE_START)) | |
#else | |
#define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T2_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \ | |
((REGTRIG) == ADC_EXTERNALTRIGCONV_T15_TRGO) || \ | |
((REGTRIG) == ADC_SOFTWARE_START)) | |
#endif | |
#if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) | |
#define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_CHANNEL_0) || \ | |
((CHANNEL) == ADC_CHANNEL_1) || \ | |
((CHANNEL) == ADC_CHANNEL_2) || \ | |
((CHANNEL) == ADC_CHANNEL_3) || \ | |
((CHANNEL) == ADC_CHANNEL_4) || \ | |
((CHANNEL) == ADC_CHANNEL_5) || \ | |
((CHANNEL) == ADC_CHANNEL_6) || \ | |
((CHANNEL) == ADC_CHANNEL_7) || \ | |
((CHANNEL) == ADC_CHANNEL_8) || \ | |
((CHANNEL) == ADC_CHANNEL_9) || \ | |
((CHANNEL) == ADC_CHANNEL_10) || \ | |
((CHANNEL) == ADC_CHANNEL_11) || \ | |
((CHANNEL) == ADC_CHANNEL_12) || \ | |
((CHANNEL) == ADC_CHANNEL_13) || \ | |
((CHANNEL) == ADC_CHANNEL_14) || \ | |
((CHANNEL) == ADC_CHANNEL_15) || \ | |
((CHANNEL) == ADC_CHANNEL_TEMPSENSOR) || \ | |
((CHANNEL) == ADC_CHANNEL_VREFINT) || \ | |
((CHANNEL) == ADC_CHANNEL_VBAT) ) | |
#else | |
#define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_CHANNEL_0) || \ | |
((CHANNEL) == ADC_CHANNEL_1) || \ | |
((CHANNEL) == ADC_CHANNEL_2) || \ | |
((CHANNEL) == ADC_CHANNEL_3) || \ | |
((CHANNEL) == ADC_CHANNEL_4) || \ | |
((CHANNEL) == ADC_CHANNEL_5) || \ | |
((CHANNEL) == ADC_CHANNEL_6) || \ | |
((CHANNEL) == ADC_CHANNEL_7) || \ | |
((CHANNEL) == ADC_CHANNEL_8) || \ | |
((CHANNEL) == ADC_CHANNEL_9) || \ | |
((CHANNEL) == ADC_CHANNEL_10) || \ | |
((CHANNEL) == ADC_CHANNEL_11) || \ | |
((CHANNEL) == ADC_CHANNEL_12) || \ | |
((CHANNEL) == ADC_CHANNEL_13) || \ | |
((CHANNEL) == ADC_CHANNEL_14) || \ | |
((CHANNEL) == ADC_CHANNEL_15) || \ | |
((CHANNEL) == ADC_CHANNEL_TEMPSENSOR) || \ | |
((CHANNEL) == ADC_CHANNEL_VREFINT) ) | |
#endif | |
/** | |
* @} | |
*/ | |
/* Exported functions --------------------------------------------------------*/ | |
/** @addtogroup ADCEx_Exported_Functions | |
* @{ | |
*/ | |
/* IO operation functions *****************************************************/ | |
/** @addtogroup ADCEx_Exported_Functions_Group1 | |
* @{ | |
*/ | |
/* ADC calibration */ | |
HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc); | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
#ifdef __cplusplus | |
} | |
#endif | |
#endif /* __STM32F0xx_HAL_ADC_EX_H */ | |
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ | |