316 lines
14 KiB
C
316 lines
14 KiB
C
/**
|
|
******************************************************************************
|
|
* @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****/
|
|
|