mbed - my fork

Users » filartrix » Code » mbed

my fork

TARGET_NUCLEO_F091RC/stm32f0xx_hal_adc.h@93:e188a91d3eaa, 2015-02-03 (annotated)

Committer:: Kojto
Date:: Tue Feb 03 15:31:20 2015 +0000
Revision:: 93:e188a91d3eaa
Parent:: 90:cb3d968589d8

Release 93 of the mbed library



Main changes:



- Renesas RZ_A1H bugfixes - i2c, ticker

- new targets - Nucleo F303RE, Nucleo F070RB, BLE SMURFS,

                Dragonfly 411RE,

- BusXXX - is connected method, plus operators addition

- LPC8xx - I2c fixes

- timestamp_t reverted to uint32_t

- RTX - fixes regarding stack (alignment, magic word)

Who changed what in which revision?

User	Revision	Line number	New contents of line
Kojto	90:cb3d968589d8	1	/**
Kojto	90:cb3d968589d8	2	******************************************************************************
Kojto	90:cb3d968589d8	3	* @file stm32f0xx_hal_adc.h
Kojto	90:cb3d968589d8	4	* @author MCD Application Team
Kojto	93:e188a91d3eaa	5	* @version V1.2.0
Kojto	93:e188a91d3eaa	6	* @date 11-December-2014
Kojto	90:cb3d968589d8	7	* @brief Header file containing functions prototypes of ADC HAL library.
Kojto	90:cb3d968589d8	8	******************************************************************************
Kojto	90:cb3d968589d8	9	* @attention
Kojto	90:cb3d968589d8	10	*
Kojto	90:cb3d968589d8	11	* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
Kojto	90:cb3d968589d8	12	*
Kojto	90:cb3d968589d8	13	* Redistribution and use in source and binary forms, with or without modification,
Kojto	90:cb3d968589d8	14	* are permitted provided that the following conditions are met:
Kojto	90:cb3d968589d8	15	* 1. Redistributions of source code must retain the above copyright notice,
Kojto	90:cb3d968589d8	16	* this list of conditions and the following disclaimer.
Kojto	90:cb3d968589d8	17	* 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto	90:cb3d968589d8	18	* this list of conditions and the following disclaimer in the documentation
Kojto	90:cb3d968589d8	19	* and/or other materials provided with the distribution.
Kojto	90:cb3d968589d8	20	* 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto	90:cb3d968589d8	21	* may be used to endorse or promote products derived from this software
Kojto	90:cb3d968589d8	22	* without specific prior written permission.
Kojto	90:cb3d968589d8	23	*
Kojto	90:cb3d968589d8	24	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto	90:cb3d968589d8	25	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto	90:cb3d968589d8	26	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto	90:cb3d968589d8	27	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto	90:cb3d968589d8	28	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto	90:cb3d968589d8	29	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto	90:cb3d968589d8	30	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto	90:cb3d968589d8	31	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto	90:cb3d968589d8	32	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto	90:cb3d968589d8	33	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto	90:cb3d968589d8	34	*
Kojto	90:cb3d968589d8	35	******************************************************************************
Kojto	90:cb3d968589d8	36	*/
Kojto	90:cb3d968589d8	37
Kojto	90:cb3d968589d8	38	/* Define to prevent recursive inclusion -------------------------------------*/
Kojto	90:cb3d968589d8	39	#ifndef __STM32F0xx_HAL_ADC_H
Kojto	90:cb3d968589d8	40	#define __STM32F0xx_HAL_ADC_H
Kojto	90:cb3d968589d8	41
Kojto	90:cb3d968589d8	42	#ifdef __cplusplus
Kojto	90:cb3d968589d8	43	extern "C" {
Kojto	90:cb3d968589d8	44	#endif
Kojto	90:cb3d968589d8	45
Kojto	90:cb3d968589d8	46	/* Includes ------------------------------------------------------------------*/
Kojto	90:cb3d968589d8	47	#include "stm32f0xx_hal_def.h"
Kojto	90:cb3d968589d8	48
Kojto	90:cb3d968589d8	49	/** @addtogroup STM32F0xx_HAL_Driver
Kojto	90:cb3d968589d8	50	* @{
Kojto	90:cb3d968589d8	51	*/
Kojto	90:cb3d968589d8	52
Kojto	90:cb3d968589d8	53	/** @addtogroup ADC
Kojto	90:cb3d968589d8	54	* @{
Kojto	90:cb3d968589d8	55	*/
Kojto	90:cb3d968589d8	56
Kojto	90:cb3d968589d8	57	/* Exported types ------------------------------------------------------------*/
Kojto	90:cb3d968589d8	58	/** @defgroup ADC_Exported_Types ADC Exported Types
Kojto	90:cb3d968589d8	59	* @{
Kojto	90:cb3d968589d8	60	*/
Kojto	90:cb3d968589d8	61
Kojto	90:cb3d968589d8	62	/**
Kojto	90:cb3d968589d8	63	* @brief Structure definition of ADC initialization and regular group
Kojto	90:cb3d968589d8	64	* @note The setting of these parameters with function HAL_ADC_Init() is conditioned to ADC state.
Kojto	90:cb3d968589d8	65	* ADC state can be either:
Kojto	90:cb3d968589d8	66	* - For all parameters: ADC disabled (this is the only possible ADC state to modify parameter 'ClockPrescaler')
Kojto	90:cb3d968589d8	67	* - For all parameters except 'ClockPrescaler': ADC enabled without conversion on going on regular group.
Kojto	90:cb3d968589d8	68	* If ADC is not in the appropriate state to modify some parameters, these parameters setting is bypassed
Kojto	93:e188a91d3eaa	69	* without error reporting (as it can be the expected behaviour in case of intended action to update another parameter (which fulfills the ADC state condition) on the fly).
Kojto	90:cb3d968589d8	70	*/
Kojto	90:cb3d968589d8	71	typedef struct
Kojto	90:cb3d968589d8	72	{
Kojto	90:cb3d968589d8	73	uint32_t ClockPrescaler; /*!< Select ADC clock source (synchronous clock derived from APB clock or asynchronous clock derived from ADC dedicated HSI RC oscillator 14MHz) and clock prescaler.
Kojto	90:cb3d968589d8	74	This parameter can be a value of @ref ADC_ClockPrescaler
Kojto	90:cb3d968589d8	75	Note: In case of usage of the ADC dedicated HSI RC oscillator, it must be preliminarily enabled at RCC top level.
Kojto	90:cb3d968589d8	76	Note: This parameter can be modified only if the ADC is disabled */
Kojto	90:cb3d968589d8	77	uint32_t Resolution; /*!< Configures the ADC resolution.
Kojto	90:cb3d968589d8	78	This parameter can be a value of @ref ADC_Resolution */
Kojto	90:cb3d968589d8	79	uint32_t DataAlign; /*!< Specifies whether the ADC data alignment is left or right.
Kojto	90:cb3d968589d8	80	This parameter can be a value of @ref ADC_Data_align */
Kojto	90:cb3d968589d8	81	uint32_t ScanConvMode; /*!< Configures the sequencer of regular group.
Kojto	90:cb3d968589d8	82	This parameter can be associated to parameter 'DiscontinuousConvMode' to have main sequence subdivided in successive parts.
Kojto	90:cb3d968589d8	83	Sequencer is automatically enabled if several channels are set (sequencer cannot be disabled, as it can be the case on other STM32 devices):
Kojto	90:cb3d968589d8	84	If only 1 channel is set: Conversion is performed in single mode.
Kojto	90:cb3d968589d8	85	If several channels are set: Conversions are performed in sequence mode (ranks defined by each channel number: channel 0 fixed on rank 0, channel 1 fixed on rank1, ...).
Kojto	90:cb3d968589d8	86	Scan direction can be set to forward (from channel 0 to channel 18) or backward (from channel 18 to channel 0).
Kojto	90:cb3d968589d8	87	This parameter can be a value of @ref ADC_Scan_mode */
Kojto	90:cb3d968589d8	88	uint32_t EOCSelection; /*!< Specifies what EOC (End Of Conversion) flag is used for conversion by polling and interruption: end of conversion of each rank or complete sequence.
Kojto	90:cb3d968589d8	89	This parameter can be a value of @ref ADC_EOCSelection. */
Kojto	90:cb3d968589d8	90	uint32_t LowPowerAutoWait; /*!< Selects the dynamic low power Auto Delay: new conversion start only when the previous
Kojto	90:cb3d968589d8	91	conversion (for regular group) or previous sequence (for injected group) has been treated by user software.
Kojto	90:cb3d968589d8	92	This feature automatically adapts the speed of ADC to the speed of the system that reads the data. Moreover, this avoids risk of overrun for low frequency applications.
Kojto	90:cb3d968589d8	93	This parameter can be set to ENABLE or DISABLE.
Kojto	90:cb3d968589d8	94	Note: Do not use with interruption or DMA (HAL_ADC_Start_IT(), HAL_ADC_Start_DMA()) since they have to clear immediately the EOC flag to free the IRQ vector sequencer.
Kojto	90:cb3d968589d8	95	Do use with polling: 1. Start conversion with HAL_ADC_Start(), 2. Later on, when conversion data is needed: use HAL_ADC_PollForConversion() to ensure that conversion is completed
Kojto	90:cb3d968589d8	96	and use HAL_ADC_GetValue() to retrieve conversion result and trig another conversion. */
Kojto	90:cb3d968589d8	97	uint32_t LowPowerAutoPowerOff; /*!< Selects the auto-off mode: the ADC automatically powers-off after a conversion and automatically wakes-up when a new conversion is triggered (with startup time between trigger and start of sampling).
Kojto	90:cb3d968589d8	98	This feature can be combined with automatic wait mode (parameter 'LowPowerAutoWait').
Kojto	90:cb3d968589d8	99	This parameter can be set to ENABLE or DISABLE.
Kojto	90:cb3d968589d8	100	Note: If enabled, this feature also turns off the ADC dedicated 14 MHz RC oscillator (HSI14) */
Kojto	90:cb3d968589d8	101	uint32_t ContinuousConvMode; /*!< Specifies whether the conversion is performed in single mode (one conversion) or continuous mode for regular group,
Kojto	90:cb3d968589d8	102	after the selected trigger occurred (software start or external trigger).
Kojto	90:cb3d968589d8	103	This parameter can be set to ENABLE or DISABLE. */
Kojto	90:cb3d968589d8	104	uint32_t DiscontinuousConvMode; /*!< Specifies whether the conversions sequence of regular group is performed in Complete-sequence/Discontinuous-sequence (main sequence subdivided in successive parts).
Kojto	90:cb3d968589d8	105	Discontinuous mode is used only if sequencer is enabled (parameter 'ScanConvMode'). If sequencer is disabled, this parameter is discarded.
Kojto	90:cb3d968589d8	106	Discontinuous mode can be enabled only if continuous mode is disabled. If continuous mode is enabled, this parameter setting is discarded.
Kojto	90:cb3d968589d8	107	This parameter can be set to ENABLE or DISABLE
Kojto	90:cb3d968589d8	108	Note: Number of discontinuous ranks increment is fixed to one-by-one. */
Kojto	90:cb3d968589d8	109	uint32_t ExternalTrigConv; /*!< Selects the external event used to trigger the conversion start of regular group.
Kojto	90:cb3d968589d8	110	If set to ADC_SOFTWARE_START, external triggers are disabled.
Kojto	90:cb3d968589d8	111	This parameter can be a value of @ref ADC_External_trigger_source_Regular */
Kojto	90:cb3d968589d8	112	uint32_t ExternalTrigConvEdge; /*!< Selects the external trigger edge of regular group.
Kojto	90:cb3d968589d8	113	If trigger is set to ADC_SOFTWARE_START, this parameter is discarded.
Kojto	90:cb3d968589d8	114	This parameter can be a value of @ref ADC_External_trigger_edge_Regular */
Kojto	90:cb3d968589d8	115	uint32_t DMAContinuousRequests; /*!< Specifies whether the DMA requests are performed in one shot mode (DMA transfer stop when number of conversions is reached)
Kojto	90:cb3d968589d8	116	or in Continuous mode (DMA transfer unlimited, whatever number of conversions).
Kojto	90:cb3d968589d8	117	Note: In continuous mode, DMA must be configured in circular mode. Otherwise an overrun will be triggered when DMA buffer maximum pointer is reached.
Kojto	90:cb3d968589d8	118	This parameter can be set to ENABLE or DISABLE. */
Kojto	90:cb3d968589d8	119	uint32_t Overrun; /*!< Select the behaviour in case of overrun: data preserved or overwritten
Kojto	90:cb3d968589d8	120	This parameter has an effect on regular group only, including in DMA mode.
Kojto	90:cb3d968589d8	121	This parameter can be a value of @ref ADC_Overrun */
Kojto	90:cb3d968589d8	122	}ADC_InitTypeDef;
Kojto	90:cb3d968589d8	123
Kojto	90:cb3d968589d8	124	/**
Kojto	90:cb3d968589d8	125	* @brief Structure definition of ADC channel for regular group
Kojto	90:cb3d968589d8	126	* @note The setting of these parameters with function HAL_ADC_ConfigChannel() is conditioned to ADC state.
Kojto	90:cb3d968589d8	127	* ADC state can be either:
Kojto	90:cb3d968589d8	128	* - For all parameters: ADC disabled or enabled without conversion on going on regular group.
Kojto	90:cb3d968589d8	129	* If ADC is not in the appropriate state to modify some parameters, these parameters setting is bypassed
Kojto	90:cb3d968589d8	130	* without error reporting (as it can be the expected behaviour in case of intended action to update another parameter (which fulfills the ADC state condition) on the fly).
Kojto	90:cb3d968589d8	131	*/
Kojto	90:cb3d968589d8	132	typedef struct
Kojto	90:cb3d968589d8	133	{
Kojto	90:cb3d968589d8	134	uint32_t Channel; /*!< Specifies the channel to configure into ADC regular group.
Kojto	90:cb3d968589d8	135	This parameter can be a value of @ref ADC_channels
Kojto	90:cb3d968589d8	136	Note: Depending on devices, some channels may not be available on package pins. Refer to device datasheet for channels availability. */
Kojto	90:cb3d968589d8	137	uint32_t Rank; /*!< Add or remove the channel from ADC regular group sequencer.
Kojto	90:cb3d968589d8	138	On STM32F0 devices, rank is defined by each channel number (channel 0 fixed on rank 0, channel 1 fixed on rank1, ...).
Kojto	90:cb3d968589d8	139	Despite the channel rank is fixed, this parameter allow an additional possibility: to remove the selected rank (selected channel) from sequencer.
Kojto	90:cb3d968589d8	140	This parameter can be a value of @ref ADC_rank */
Kojto	90:cb3d968589d8	141	uint32_t SamplingTime; /*!< Sampling time value to be set for the selected channel.
Kojto	90:cb3d968589d8	142	Unit: ADC clock cycles
Kojto	90:cb3d968589d8	143	Conversion time is the addition of sampling time and processing time (12.5 ADC clock cycles at ADC resolution 12 bits, 10.5 cycles at 10 bits, 8.5 cycles at 8 bits, 6.5 cycles at 6 bits).
Kojto	90:cb3d968589d8	144	This parameter can be a value of @ref ADC_sampling_times
Kojto	90:cb3d968589d8	145	Caution: this setting impacts the entire regular group. Therefore, call of HAL_ADC_ConfigChannel() to configure a channel can impact the configuration of other channels previously set.
Kojto	90:cb3d968589d8	146	Note: In case of usage of internal measurement channels (VrefInt/Vbat/TempSensor),
Kojto	90:cb3d968589d8	147	sampling time constraints must be respected (sampling time can be adjusted in function of ADC clock frequency and sampling time setting)
Kojto	90:cb3d968589d8	148	Refer to device datasheet for timings values, parameters TS_vrefint, TS_vbat, TS_temp (values rough order: 5us to 17us). */
Kojto	90:cb3d968589d8	149	}ADC_ChannelConfTypeDef;
Kojto	90:cb3d968589d8	150
Kojto	90:cb3d968589d8	151	/**
Kojto	90:cb3d968589d8	152	* @brief Structure definition of ADC analog watchdog
Kojto	90:cb3d968589d8	153	* @note The setting of these parameters with function HAL_ADC_AnalogWDGConfig() is conditioned to ADC state.
Kojto	90:cb3d968589d8	154	* ADC state can be either: ADC disabled or ADC enabled without conversion on going on regular group.
Kojto	90:cb3d968589d8	155	*/
Kojto	90:cb3d968589d8	156	typedef struct
Kojto	90:cb3d968589d8	157	{
Kojto	90:cb3d968589d8	158	uint32_t WatchdogMode; /*!< Configures the ADC analog watchdog mode: single/all/none channels.
Kojto	90:cb3d968589d8	159	This parameter can be a value of @ref ADC_analog_watchdog_mode. */
Kojto	90:cb3d968589d8	160	uint32_t Channel; /*!< Selects which ADC channel to monitor by analog watchdog.
Kojto	90:cb3d968589d8	161	This parameter has an effect only if parameter 'WatchdogMode' is configured on single channel. Only 1 channel can be monitored.
Kojto	90:cb3d968589d8	162	This parameter can be a value of @ref ADC_channels. */
Kojto	90:cb3d968589d8	163	uint32_t ITMode; /*!< Specifies whether the analog watchdog is configured in interrupt or polling mode.
Kojto	90:cb3d968589d8	164	This parameter can be set to ENABLE or DISABLE */
Kojto	90:cb3d968589d8	165	uint32_t HighThreshold; /*!< Configures the ADC analog watchdog High threshold value.
Kojto	90:cb3d968589d8	166	Depending of ADC resolution selected (12, 10, 8 or 6 bits), this parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF, 0x3FF, 0xFF or 0x3F respectively. */
Kojto	90:cb3d968589d8	167	uint32_t LowThreshold; /*!< Configures the ADC analog watchdog High threshold value.
Kojto	90:cb3d968589d8	168	Depending of ADC resolution selected (12, 10, 8 or 6 bits), this parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF, 0x3FF, 0xFF or 0x3F respectively. */
Kojto	90:cb3d968589d8	169	}ADC_AnalogWDGConfTypeDef;
Kojto	90:cb3d968589d8	170
Kojto	90:cb3d968589d8	171	/**
Kojto	90:cb3d968589d8	172	* @brief HAL ADC state machine: ADC States structure definition
Kojto	90:cb3d968589d8	173	*/
Kojto	90:cb3d968589d8	174	typedef enum
Kojto	90:cb3d968589d8	175	{
Kojto	90:cb3d968589d8	176	HAL_ADC_STATE_RESET = 0x00, /!< ADC not yet initialized or disabled /
Kojto	90:cb3d968589d8	177	HAL_ADC_STATE_READY = 0x01, /!< ADC peripheral ready for use /
Kojto	90:cb3d968589d8	178	HAL_ADC_STATE_BUSY = 0x02, /!< An internal process is ongoing /
Kojto	90:cb3d968589d8	179	HAL_ADC_STATE_BUSY_REG = 0x12, /!< Regular conversion is ongoing /
Kojto	90:cb3d968589d8	180	HAL_ADC_STATE_BUSY_INJ = 0x22, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring an injected group) /
Kojto	90:cb3d968589d8	181	HAL_ADC_STATE_BUSY_INJ_REG = 0x32, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring an injected group) /
Kojto	90:cb3d968589d8	182	HAL_ADC_STATE_TIMEOUT = 0x03, /!< Timeout state /
Kojto	90:cb3d968589d8	183	HAL_ADC_STATE_ERROR = 0x04, /!< ADC state error /
Kojto	90:cb3d968589d8	184	HAL_ADC_STATE_EOC = 0x05, /!< Conversion is completed /
Kojto	90:cb3d968589d8	185	HAL_ADC_STATE_EOC_REG = 0x15, /!< Regular conversion is completed /
Kojto	90:cb3d968589d8	186	HAL_ADC_STATE_EOC_INJ = 0x25, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring an injected group) /
Kojto	90:cb3d968589d8	187	HAL_ADC_STATE_EOC_INJ_REG = 0x35, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring an injected group) /
Kojto	90:cb3d968589d8	188	HAL_ADC_STATE_AWD = 0x06, /!< ADC state analog watchdog /
Kojto	90:cb3d968589d8	189	HAL_ADC_STATE_AWD2 = 0x07, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring several AWD) /
Kojto	90:cb3d968589d8	190	HAL_ADC_STATE_AWD3 = 0x08, /!< Not used on STM32F0xx devices (kept for compatibility with other devices featuring several AWD) /
Kojto	90:cb3d968589d8	191	}HAL_ADC_StateTypeDef;
Kojto	90:cb3d968589d8	192
Kojto	90:cb3d968589d8	193	/**
Kojto	90:cb3d968589d8	194	* @brief ADC handle Structure definition
Kojto	90:cb3d968589d8	195	*/
Kojto	90:cb3d968589d8	196	typedef struct
Kojto	90:cb3d968589d8	197	{
Kojto	90:cb3d968589d8	198	ADC_TypeDef Instance; /!< Register base address */
Kojto	90:cb3d968589d8	199
Kojto	90:cb3d968589d8	200	ADC_InitTypeDef Init; /!< ADC required parameters /
Kojto	90:cb3d968589d8	201
Kojto	90:cb3d968589d8	202	__IO uint32_t NbrOfConversionRank ; /!< ADC conversion rank counter /
Kojto	90:cb3d968589d8	203
Kojto	90:cb3d968589d8	204	DMA_HandleTypeDef DMA_Handle; /!< Pointer DMA Handler */
Kojto	90:cb3d968589d8	205
Kojto	90:cb3d968589d8	206	HAL_LockTypeDef Lock; /!< ADC locking object /
Kojto	90:cb3d968589d8	207
Kojto	90:cb3d968589d8	208	__IO HAL_ADC_StateTypeDef State; /!< ADC communication state /
Kojto	90:cb3d968589d8	209
Kojto	90:cb3d968589d8	210	__IO uint32_t ErrorCode; /!< ADC Error code /
Kojto	90:cb3d968589d8	211	}ADC_HandleTypeDef;
Kojto	90:cb3d968589d8	212	/**
Kojto	90:cb3d968589d8	213	* @}
Kojto	90:cb3d968589d8	214	*/
Kojto	90:cb3d968589d8	215
Kojto	90:cb3d968589d8	216
Kojto	90:cb3d968589d8	217
Kojto	90:cb3d968589d8	218	/* Exported constants --------------------------------------------------------*/
Kojto	90:cb3d968589d8	219
Kojto	90:cb3d968589d8	220	/** @defgroup ADC_Exported_Constants ADC Exported Constants
Kojto	90:cb3d968589d8	221	* @{
Kojto	90:cb3d968589d8	222	*/
Kojto	90:cb3d968589d8	223
Kojto	90:cb3d968589d8	224	/** @defgroup ADC_Error_Code ADC Error Code
Kojto	90:cb3d968589d8	225	* @{
Kojto	90:cb3d968589d8	226	*/
Kojto	90:cb3d968589d8	227	#define HAL_ADC_ERROR_NONE ((uint32_t)0x00) /!< No error /
Kojto	90:cb3d968589d8	228	#define HAL_ADC_ERROR_INTERNAL ((uint32_t)0x01) /*!< ADC IP internal error: if problem of clocking,
Kojto	90:cb3d968589d8	229	enable/disable, erroneous state */
Kojto	90:cb3d968589d8	230	#define HAL_ADC_ERROR_OVR ((uint32_t)0x02) /!< Overrun error /
Kojto	90:cb3d968589d8	231	#define HAL_ADC_ERROR_DMA ((uint32_t)0x04) /!< DMA transfer error /
Kojto	90:cb3d968589d8	232
Kojto	90:cb3d968589d8	233	/**
Kojto	90:cb3d968589d8	234	* @}
Kojto	90:cb3d968589d8	235	*/
Kojto	90:cb3d968589d8	236
Kojto	90:cb3d968589d8	237	/** @defgroup ADC_ClockPrescaler ADC ClockPrescaler
Kojto	90:cb3d968589d8	238	* @{
Kojto	90:cb3d968589d8	239	*/
Kojto	90:cb3d968589d8	240	#define ADC_CLOCK_ASYNC ((uint32_t)0x00000000) /!< ADC asynchronous clock derived from ADC dedicated HSI /
Kojto	90:cb3d968589d8	241
Kojto	90:cb3d968589d8	242	#define ADC_CLOCK_SYNC_PCLK_DIV2 ((uint32_t)ADC_CFGR2_CKMODE_0) /!< ADC synchronous clock derived from AHB clock divided by a prescaler of 2 /
Kojto	90:cb3d968589d8	243	#define ADC_CLOCK_SYNC_PCLK_DIV4 ((uint32_t)ADC_CFGR2_CKMODE_1) /!< ADC synchronous clock derived from AHB clock divided by a prescaler of 4 /
Kojto	90:cb3d968589d8	244
Kojto	90:cb3d968589d8	245	#define ADC_CLOCKPRESCALER_PCLK_DIV2 ADC_CLOCK_SYNC_PCLK_DIV2 /* Obsolete naming, kept for compatibility with some other devices */
Kojto	90:cb3d968589d8	246	#define ADC_CLOCKPRESCALER_PCLK_DIV4 ADC_CLOCK_SYNC_PCLK_DIV4 /* Obsolete naming, kept for compatibility with some other devices */
Kojto	90:cb3d968589d8	247
Kojto	90:cb3d968589d8	248	#define IS_ADC_CLOCKPRESCALER(ADC_CLOCK) (((ADC_CLOCK) == ADC_CLOCK_ASYNC) \|\| \
Kojto	90:cb3d968589d8	249	((ADC_CLOCK) == ADC_CLOCK_SYNC_PCLK_DIV2) \|\| \
Kojto	90:cb3d968589d8	250	((ADC_CLOCK) == ADC_CLOCK_SYNC_PCLK_DIV4) )
Kojto	90:cb3d968589d8	251
Kojto	90:cb3d968589d8	252	/**
Kojto	90:cb3d968589d8	253	* @}
Kojto	90:cb3d968589d8	254	*/
Kojto	90:cb3d968589d8	255
Kojto	90:cb3d968589d8	256	/** @defgroup ADC_Resolution ADC Resolution
Kojto	90:cb3d968589d8	257	* @{
Kojto	90:cb3d968589d8	258	*/
Kojto	90:cb3d968589d8	259	#define ADC_RESOLUTION12b ((uint32_t)0x00000000) /!< ADC 12-bit resolution /
Kojto	90:cb3d968589d8	260	#define ADC_RESOLUTION10b ((uint32_t)ADC_CFGR1_RES_0) /!< ADC 10-bit resolution /
Kojto	90:cb3d968589d8	261	#define ADC_RESOLUTION8b ((uint32_t)ADC_CFGR1_RES_1) /!< ADC 8-bit resolution /
Kojto	90:cb3d968589d8	262	#define ADC_RESOLUTION6b ((uint32_t)ADC_CFGR1_RES) /!< ADC 6-bit resolution /
Kojto	90:cb3d968589d8	263
Kojto	90:cb3d968589d8	264	#define IS_ADC_RESOLUTION(RESOLUTION) (((RESOLUTION) == ADC_RESOLUTION12b) \|\| \
Kojto	90:cb3d968589d8	265	((RESOLUTION) == ADC_RESOLUTION10b) \|\| \
Kojto	90:cb3d968589d8	266	((RESOLUTION) == ADC_RESOLUTION8b) \|\| \
Kojto	90:cb3d968589d8	267	((RESOLUTION) == ADC_RESOLUTION6b) )
Kojto	90:cb3d968589d8	268	/**
Kojto	90:cb3d968589d8	269	* @}
Kojto	90:cb3d968589d8	270	*/
Kojto	90:cb3d968589d8	271
Kojto	90:cb3d968589d8	272	/** @defgroup ADC_Data_align ADC Data_align
Kojto	90:cb3d968589d8	273	* @{
Kojto	90:cb3d968589d8	274	*/
Kojto	90:cb3d968589d8	275	#define ADC_DATAALIGN_RIGHT ((uint32_t)0x00000000)
Kojto	90:cb3d968589d8	276	#define ADC_DATAALIGN_LEFT ((uint32_t)ADC_CFGR1_ALIGN)
Kojto	90:cb3d968589d8	277
Kojto	90:cb3d968589d8	278	#define IS_ADC_DATA_ALIGN(ALIGN) (((ALIGN) == ADC_DATAALIGN_RIGHT) \|\| \
Kojto	90:cb3d968589d8	279	((ALIGN) == ADC_DATAALIGN_LEFT) )
Kojto	90:cb3d968589d8	280	/**
Kojto	90:cb3d968589d8	281	* @}
Kojto	90:cb3d968589d8	282	*/
Kojto	90:cb3d968589d8	283
Kojto	90:cb3d968589d8	284	/** @defgroup ADC_Scan_mode ADC Scan mode
Kojto	90:cb3d968589d8	285	* @{
Kojto	90:cb3d968589d8	286	*/
Kojto	90:cb3d968589d8	287	/* Note: Scan mode values must be compatible with other STM32 devices having */
Kojto	90:cb3d968589d8	288	/* a configurable sequencer. */
Kojto	90:cb3d968589d8	289	/* Scan direction setting values are defined by taking in account */
Kojto	90:cb3d968589d8	290	/* already defined values for other STM32 devices: */
Kojto	90:cb3d968589d8	291	/* ADC_SCAN_DISABLE ((uint32_t)0x00000000) */
Kojto	90:cb3d968589d8	292	/* ADC_SCAN_ENABLE ((uint32_t)0x00000001) */
Kojto	90:cb3d968589d8	293	/* Scan direction forward is considered as default setting equivalent */
Kojto	90:cb3d968589d8	294	/* to scan enable. */
Kojto	90:cb3d968589d8	295	/* Scan direction backward is considered as additional setting. */
Kojto	90:cb3d968589d8	296	/* In case of migration from another STM32 device, the user will be */
Kojto	90:cb3d968589d8	297	/* warned of change of setting choices with assert check. */
Kojto	90:cb3d968589d8	298	#define ADC_SCAN_DIRECTION_FORWARD ((uint32_t)0x00000001) /!< Scan direction forward: from channel 0 to channel 18 /
Kojto	90:cb3d968589d8	299	#define ADC_SCAN_DIRECTION_BACKWARD ((uint32_t)0x00000002) /!< Scan direction backward: from channel 18 to channel 0 /
Kojto	90:cb3d968589d8	300
Kojto	90:cb3d968589d8	301	#define ADC_SCAN_ENABLE ADC_SCAN_DIRECTION_FORWARD /* For compatibility with other STM32 devices */
Kojto	90:cb3d968589d8	302
Kojto	90:cb3d968589d8	303	#define IS_ADC_SCAN_MODE(SCAN_MODE) (((SCAN_MODE) == ADC_SCAN_DIRECTION_FORWARD) \|\| \
Kojto	90:cb3d968589d8	304	((SCAN_MODE) == ADC_SCAN_DIRECTION_BACKWARD) )
Kojto	90:cb3d968589d8	305	/**
Kojto	90:cb3d968589d8	306	* @}
Kojto	90:cb3d968589d8	307	*/
Kojto	90:cb3d968589d8	308
Kojto	90:cb3d968589d8	309	/** @defgroup ADC_External_trigger_edge_Regular ADC External trigger edge Regular
Kojto	90:cb3d968589d8	310	* @{
Kojto	90:cb3d968589d8	311	*/
Kojto	90:cb3d968589d8	312	#define ADC_EXTERNALTRIGCONVEDGE_NONE ((uint32_t)0x00000000)
Kojto	90:cb3d968589d8	313	#define ADC_EXTERNALTRIGCONVEDGE_RISING ((uint32_t)ADC_CFGR1_EXTEN_0)
Kojto	90:cb3d968589d8	314	#define ADC_EXTERNALTRIGCONVEDGE_FALLING ((uint32_t)ADC_CFGR1_EXTEN_1)
Kojto	90:cb3d968589d8	315	#define ADC_EXTERNALTRIGCONVEDGE_RISINGFALLING ((uint32_t)ADC_CFGR1_EXTEN)
Kojto	90:cb3d968589d8	316
Kojto	90:cb3d968589d8	317	#define IS_ADC_EXTTRIG_EDGE(EDGE) (((EDGE) == ADC_EXTERNALTRIGCONVEDGE_NONE) \|\| \
Kojto	90:cb3d968589d8	318	((EDGE) == ADC_EXTERNALTRIGCONVEDGE_RISING) \|\| \
Kojto	90:cb3d968589d8	319	((EDGE) == ADC_EXTERNALTRIGCONVEDGE_FALLING) \|\| \
Kojto	90:cb3d968589d8	320	((EDGE) == ADC_EXTERNALTRIGCONVEDGE_RISINGFALLING) )
Kojto	90:cb3d968589d8	321	/**
Kojto	90:cb3d968589d8	322	* @}
Kojto	90:cb3d968589d8	323	*/
Kojto	90:cb3d968589d8	324
Kojto	90:cb3d968589d8	325	/** @defgroup ADC_External_trigger_source_Regular ADC External trigger source Regular
Kojto	90:cb3d968589d8	326	* @{
Kojto	90:cb3d968589d8	327	*/
Kojto	90:cb3d968589d8	328	/* List of external triggers with generic trigger name, sorted by trigger */
Kojto	90:cb3d968589d8	329	/* name: */
Kojto	90:cb3d968589d8	330
Kojto	90:cb3d968589d8	331	/* External triggers of regular group for ADC1 */
Kojto	90:cb3d968589d8	332	#define ADC_EXTERNALTRIGCONV_T1_TRGO ADC1_2_EXTERNALTRIG_T1_TRGO
Kojto	90:cb3d968589d8	333	#define ADC_EXTERNALTRIGCONV_T1_CC4 ADC1_2_EXTERNALTRIG_T1_CC4
Kojto	90:cb3d968589d8	334	#define ADC_EXTERNALTRIGCONV_T2_TRGO ADC1_2_EXTERNALTRIG_T2_TRGO
Kojto	90:cb3d968589d8	335	#define ADC_EXTERNALTRIGCONV_T3_TRGO ADC1_2_EXTERNALTRIG_T3_TRGO
Kojto	90:cb3d968589d8	336	#define ADC_EXTERNALTRIGCONV_T15_TRGO ADC1_2_EXTERNALTRIG_T15_TRGO
Kojto	90:cb3d968589d8	337	#define ADC_SOFTWARE_START ((uint32_t)0x00000010)
Kojto	90:cb3d968589d8	338
Kojto	90:cb3d968589d8	339	#define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) \|\| \
Kojto	90:cb3d968589d8	340	((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) \|\| \
Kojto	90:cb3d968589d8	341	((REGTRIG) == ADC_EXTERNALTRIGCONV_T2_TRGO) \|\| \
Kojto	90:cb3d968589d8	342	((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) \|\| \
Kojto	90:cb3d968589d8	343	((REGTRIG) == ADC_EXTERNALTRIGCONV_T15_TRGO) \|\| \
Kojto	90:cb3d968589d8	344	((REGTRIG) == ADC_SOFTWARE_START) )
Kojto	90:cb3d968589d8	345	/**
Kojto	90:cb3d968589d8	346	* @}
Kojto	90:cb3d968589d8	347	*/
Kojto	90:cb3d968589d8	348
Kojto	90:cb3d968589d8	349	/** @defgroup ADC_Internal_HAL_driver_Ext_trig_src_Regular ADC Internal HAL driver Ext trig src Regular
Kojto	90:cb3d968589d8	350	* @{
Kojto	90:cb3d968589d8	351	*/
Kojto	90:cb3d968589d8	352
Kojto	90:cb3d968589d8	353	/* List of external triggers of regular group for ADC1: */
Kojto	90:cb3d968589d8	354	/* (used internally by HAL driver. To not use into HAL structure parameters) */
Kojto	90:cb3d968589d8	355	#define ADC1_2_EXTERNALTRIG_T1_TRGO ((uint32_t)0x00000000)
Kojto	90:cb3d968589d8	356	#define ADC1_2_EXTERNALTRIG_T1_CC4 ((uint32_t)ADC_CFGR1_EXTSEL_0)
Kojto	90:cb3d968589d8	357	#define ADC1_2_EXTERNALTRIG_T2_TRGO ((uint32_t)ADC_CFGR1_EXTSEL_1)
Kojto	90:cb3d968589d8	358	#define ADC1_2_EXTERNALTRIG_T3_TRGO ((uint32_t)(ADC_CFGR1_EXTSEL_1 \| ADC_CFGR1_EXTSEL_0))
Kojto	90:cb3d968589d8	359	#define ADC1_2_EXTERNALTRIG_T15_TRGO ((uint32_t)ADC_CFGR1_EXTSEL_2)
Kojto	90:cb3d968589d8	360
Kojto	90:cb3d968589d8	361	/**
Kojto	90:cb3d968589d8	362	* @}
Kojto	90:cb3d968589d8	363	*/
Kojto	90:cb3d968589d8	364
Kojto	90:cb3d968589d8	365	/** @defgroup ADC_EOCSelection ADC EOCSelection
Kojto	90:cb3d968589d8	366	* @{
Kojto	90:cb3d968589d8	367	*/
Kojto	90:cb3d968589d8	368	#define EOC_SINGLE_CONV ((uint32_t) ADC_ISR_EOC)
Kojto	90:cb3d968589d8	369	#define EOC_SEQ_CONV ((uint32_t) ADC_ISR_EOS)
Kojto	90:cb3d968589d8	370	#define EOC_SINGLE_SEQ_CONV ((uint32_t)(ADC_ISR_EOC \| ADC_ISR_EOS)) /!< reserved for future use /
Kojto	90:cb3d968589d8	371
Kojto	90:cb3d968589d8	372	#define IS_ADC_EOC_SELECTION(EOC_SELECTION) (((EOC_SELECTION) == EOC_SINGLE_CONV) \|\| \
Kojto	90:cb3d968589d8	373	((EOC_SELECTION) == EOC_SEQ_CONV) \|\| \
Kojto	90:cb3d968589d8	374	((EOC_SELECTION) == EOC_SINGLE_SEQ_CONV) )
Kojto	90:cb3d968589d8	375	/**
Kojto	90:cb3d968589d8	376	* @}
Kojto	90:cb3d968589d8	377	*/
Kojto	90:cb3d968589d8	378
Kojto	90:cb3d968589d8	379	/** @defgroup ADC_Overrun ADC Overrun
Kojto	90:cb3d968589d8	380	* @{
Kojto	90:cb3d968589d8	381	*/
Kojto	90:cb3d968589d8	382	#define OVR_DATA_OVERWRITTEN ((uint32_t)0x00000000)
Kojto	90:cb3d968589d8	383	#define OVR_DATA_PRESERVED ((uint32_t)0x00000001)
Kojto	90:cb3d968589d8	384
Kojto	90:cb3d968589d8	385	#define IS_ADC_OVERRUN(OVR) (((OVR) == OVR_DATA_PRESERVED) \|\| \
Kojto	90:cb3d968589d8	386	((OVR) == OVR_DATA_OVERWRITTEN) )
Kojto	90:cb3d968589d8	387	/**
Kojto	90:cb3d968589d8	388	* @}
Kojto	90:cb3d968589d8	389	*/
Kojto	90:cb3d968589d8	390
Kojto	90:cb3d968589d8	391	/** @defgroup ADC_channels ADC channels
Kojto	90:cb3d968589d8	392	* @{
Kojto	90:cb3d968589d8	393	*/
Kojto	90:cb3d968589d8	394	/* Note: Depending on devices, some channels may not be available on package */
Kojto	90:cb3d968589d8	395	/* pins. Refer to device datasheet for channels availability. */
Kojto	90:cb3d968589d8	396	/* Note: Channels are used by bitfields for setting of channel selection */
Kojto	90:cb3d968589d8	397	/* (register ADC_CHSELR) and used by number for setting of analog watchdog */
Kojto	90:cb3d968589d8	398	/* channel (bits AWDCH in register ADC_CFGR1). */
Kojto	90:cb3d968589d8	399	/* Channels are defined with decimal numbers and converted them to bitfields */
Kojto	90:cb3d968589d8	400	/* when needed. */
Kojto	90:cb3d968589d8	401	#define ADC_CHANNEL_0 ((uint32_t) 0x00000000)
Kojto	90:cb3d968589d8	402	#define ADC_CHANNEL_1 ((uint32_t) 0x00000001)
Kojto	90:cb3d968589d8	403	#define ADC_CHANNEL_2 ((uint32_t) 0x00000002)
Kojto	90:cb3d968589d8	404	#define ADC_CHANNEL_3 ((uint32_t) 0x00000003)
Kojto	90:cb3d968589d8	405	#define ADC_CHANNEL_4 ((uint32_t) 0x00000004)
Kojto	90:cb3d968589d8	406	#define ADC_CHANNEL_5 ((uint32_t) 0x00000005)
Kojto	90:cb3d968589d8	407	#define ADC_CHANNEL_6 ((uint32_t) 0x00000006)
Kojto	90:cb3d968589d8	408	#define ADC_CHANNEL_7 ((uint32_t) 0x00000007)
Kojto	90:cb3d968589d8	409	#define ADC_CHANNEL_8 ((uint32_t) 0x00000008)
Kojto	90:cb3d968589d8	410	#define ADC_CHANNEL_9 ((uint32_t) 0x00000009)
Kojto	90:cb3d968589d8	411	#define ADC_CHANNEL_10 ((uint32_t) 0x0000000A)
Kojto	90:cb3d968589d8	412	#define ADC_CHANNEL_11 ((uint32_t) 0x0000000B)
Kojto	90:cb3d968589d8	413	#define ADC_CHANNEL_12 ((uint32_t) 0x0000000C)
Kojto	90:cb3d968589d8	414	#define ADC_CHANNEL_13 ((uint32_t) 0x0000000D)
Kojto	90:cb3d968589d8	415	#define ADC_CHANNEL_14 ((uint32_t) 0x0000000E)
Kojto	90:cb3d968589d8	416	#define ADC_CHANNEL_15 ((uint32_t) 0x0000000F)
Kojto	90:cb3d968589d8	417	#define ADC_CHANNEL_16 ((uint32_t) 0x00000010)
Kojto	90:cb3d968589d8	418	#define ADC_CHANNEL_17 ((uint32_t) 0x00000011)
Kojto	90:cb3d968589d8	419	#define ADC_CHANNEL_18 ((uint32_t) 0x00000012)
Kojto	90:cb3d968589d8	420
Kojto	90:cb3d968589d8	421	#define ADC_CHANNEL_TEMPSENSOR ADC_CHANNEL_16
Kojto	90:cb3d968589d8	422	#define ADC_CHANNEL_VREFINT ADC_CHANNEL_17
Kojto	90:cb3d968589d8	423	#define ADC_CHANNEL_VBAT ADC_CHANNEL_18
Kojto	90:cb3d968589d8	424
Kojto	90:cb3d968589d8	425	#define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_CHANNEL_0) \|\| \
Kojto	90:cb3d968589d8	426	((CHANNEL) == ADC_CHANNEL_1) \|\| \
Kojto	90:cb3d968589d8	427	((CHANNEL) == ADC_CHANNEL_2) \|\| \
Kojto	90:cb3d968589d8	428	((CHANNEL) == ADC_CHANNEL_3) \|\| \
Kojto	90:cb3d968589d8	429	((CHANNEL) == ADC_CHANNEL_4) \|\| \
Kojto	90:cb3d968589d8	430	((CHANNEL) == ADC_CHANNEL_5) \|\| \
Kojto	90:cb3d968589d8	431	((CHANNEL) == ADC_CHANNEL_6) \|\| \
Kojto	90:cb3d968589d8	432	((CHANNEL) == ADC_CHANNEL_7) \|\| \
Kojto	90:cb3d968589d8	433	((CHANNEL) == ADC_CHANNEL_8) \|\| \
Kojto	90:cb3d968589d8	434	((CHANNEL) == ADC_CHANNEL_9) \|\| \
Kojto	90:cb3d968589d8	435	((CHANNEL) == ADC_CHANNEL_10) \|\| \
Kojto	90:cb3d968589d8	436	((CHANNEL) == ADC_CHANNEL_11) \|\| \
Kojto	90:cb3d968589d8	437	((CHANNEL) == ADC_CHANNEL_12) \|\| \
Kojto	90:cb3d968589d8	438	((CHANNEL) == ADC_CHANNEL_13) \|\| \
Kojto	90:cb3d968589d8	439	((CHANNEL) == ADC_CHANNEL_14) \|\| \
Kojto	90:cb3d968589d8	440	((CHANNEL) == ADC_CHANNEL_15) \|\| \
Kojto	90:cb3d968589d8	441	((CHANNEL) == ADC_CHANNEL_TEMPSENSOR) \|\| \
Kojto	90:cb3d968589d8	442	((CHANNEL) == ADC_CHANNEL_VREFINT) \|\| \
Kojto	90:cb3d968589d8	443	((CHANNEL) == ADC_CHANNEL_VBAT) )
Kojto	90:cb3d968589d8	444	/**
Kojto	90:cb3d968589d8	445	* @}
Kojto	90:cb3d968589d8	446	*/
Kojto	90:cb3d968589d8	447
Kojto	90:cb3d968589d8	448	/** @defgroup ADC_rank ADC rank
Kojto	90:cb3d968589d8	449	* @{
Kojto	90:cb3d968589d8	450	*/
Kojto	90:cb3d968589d8	451	#define ADC_RANK_CHANNEL_NUMBER ((uint32_t)0x00001000) /!< Enable the rank of the selected channels. Rank is defined by each channel number (channel 0 fixed on rank 0, channel 1 fixed on rank1, ...) /
Kojto	90:cb3d968589d8	452	#define ADC_RANK_NONE ((uint32_t)0x00001001) /!< Disable the selected rank (selected channel) from sequencer /
Kojto	90:cb3d968589d8	453
Kojto	90:cb3d968589d8	454	#define IS_ADC_RANK(WATCHDOG) (((WATCHDOG) == ADC_RANK_CHANNEL_NUMBER) \|\| \
Kojto	90:cb3d968589d8	455	((WATCHDOG) == ADC_RANK_NONE) )
Kojto	90:cb3d968589d8	456	/**
Kojto	90:cb3d968589d8	457	* @}
Kojto	90:cb3d968589d8	458	*/
Kojto	90:cb3d968589d8	459
Kojto	90:cb3d968589d8	460	/** @defgroup ADC_sampling_times ADC sampling times
Kojto	90:cb3d968589d8	461	* @{
Kojto	90:cb3d968589d8	462	*/
Kojto	90:cb3d968589d8	463	#define ADC_SAMPLETIME_1CYCLE_5 ((uint32_t)0x00000000) /!< Sampling time 1.5 ADC clock cycle /
Kojto	90:cb3d968589d8	464	#define ADC_SAMPLETIME_7CYCLES_5 ((uint32_t) ADC_SMPR_SMP_0) /!< Sampling time 7.5 ADC clock cycles /
Kojto	90:cb3d968589d8	465	#define ADC_SAMPLETIME_13CYCLES_5 ((uint32_t) ADC_SMPR_SMP_1) /!< Sampling time 13.5 ADC clock cycles /
Kojto	90:cb3d968589d8	466	#define ADC_SAMPLETIME_28CYCLES_5 ((uint32_t)(ADC_SMPR_SMP_1 \| ADC_SMPR_SMP_0)) /!< Sampling time 28.5 ADC clock cycles /
Kojto	90:cb3d968589d8	467	#define ADC_SAMPLETIME_41CYCLES_5 ((uint32_t) ADC_SMPR_SMP_2) /!< Sampling time 41.5 ADC clock cycles /
Kojto	90:cb3d968589d8	468	#define ADC_SAMPLETIME_55CYCLES_5 ((uint32_t)(ADC_SMPR_SMP_2 \| ADC_SMPR_SMP_0)) /!< Sampling time 55.5 ADC clock cycles /
Kojto	90:cb3d968589d8	469	#define ADC_SAMPLETIME_71CYCLES_5 ((uint32_t)(ADC_SMPR_SMP_2 \| ADC_SMPR_SMP_1)) /!< Sampling time 71.5 ADC clock cycles /
Kojto	90:cb3d968589d8	470	#define ADC_SAMPLETIME_239CYCLES_5 ((uint32_t) ADC_SMPR_SMP) /!< Sampling time 239.5 ADC clock cycles /
Kojto	90:cb3d968589d8	471
Kojto	90:cb3d968589d8	472	#define IS_ADC_SAMPLE_TIME(TIME) (((TIME) == ADC_SAMPLETIME_1CYCLE_5) \|\| \
Kojto	90:cb3d968589d8	473	((TIME) == ADC_SAMPLETIME_7CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	474	((TIME) == ADC_SAMPLETIME_13CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	475	((TIME) == ADC_SAMPLETIME_28CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	476	((TIME) == ADC_SAMPLETIME_41CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	477	((TIME) == ADC_SAMPLETIME_55CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	478	((TIME) == ADC_SAMPLETIME_71CYCLES_5) \|\| \
Kojto	90:cb3d968589d8	479	((TIME) == ADC_SAMPLETIME_239CYCLES_5) )
Kojto	90:cb3d968589d8	480	/**
Kojto	90:cb3d968589d8	481	* @}
Kojto	90:cb3d968589d8	482	*/
Kojto	90:cb3d968589d8	483
Kojto	90:cb3d968589d8	484	/** @defgroup ADC_analog_watchdog_mode ADC analog watchdog mode
Kojto	90:cb3d968589d8	485	* @{
Kojto	90:cb3d968589d8	486	*/
Kojto	90:cb3d968589d8	487	#define ADC_ANALOGWATCHDOG_NONE ((uint32_t) 0x00000000)
Kojto	90:cb3d968589d8	488	#define ADC_ANALOGWATCHDOG_SINGLE_REG ((uint32_t)(ADC_CFGR1_AWDSGL \| ADC_CFGR1_AWDEN))
Kojto	90:cb3d968589d8	489	#define ADC_ANALOGWATCHDOG_ALL_REG ((uint32_t) ADC_CFGR1_AWDEN)
Kojto	90:cb3d968589d8	490
Kojto	90:cb3d968589d8	491
Kojto	90:cb3d968589d8	492	#define IS_ADC_ANALOG_WATCHDOG_MODE(WATCHDOG) (((WATCHDOG) == ADC_ANALOGWATCHDOG_NONE) \|\| \
Kojto	90:cb3d968589d8	493	((WATCHDOG) == ADC_ANALOGWATCHDOG_SINGLE_REG) \|\| \
Kojto	90:cb3d968589d8	494	((WATCHDOG) == ADC_ANALOGWATCHDOG_ALL_REG) )
Kojto	90:cb3d968589d8	495	/**
Kojto	90:cb3d968589d8	496	* @}
Kojto	90:cb3d968589d8	497	*/
Kojto	90:cb3d968589d8	498
Kojto	90:cb3d968589d8	499	/** @defgroup ADC_Event_type ADC Event type
Kojto	90:cb3d968589d8	500	* @{
Kojto	90:cb3d968589d8	501	*/
Kojto	90:cb3d968589d8	502	#define AWD_EVENT ((uint32_t)ADC_FLAG_AWD) /!< ADC Analog watchdog 1 event /
Kojto	90:cb3d968589d8	503	#define OVR_EVENT ((uint32_t)ADC_FLAG_OVR) /!< ADC overrun event /
Kojto	90:cb3d968589d8	504
Kojto	90:cb3d968589d8	505	#define IS_ADC_EVENT_TYPE(EVENT) (((EVENT) == AWD_EVENT) \|\| \
Kojto	90:cb3d968589d8	506	((EVENT) == OVR_EVENT) )
Kojto	90:cb3d968589d8	507	/**
Kojto	90:cb3d968589d8	508	* @}
Kojto	90:cb3d968589d8	509	*/
Kojto	90:cb3d968589d8	510
Kojto	90:cb3d968589d8	511	/** @defgroup ADC_interrupts_definition ADC interrupts definition
Kojto	90:cb3d968589d8	512	* @{
Kojto	90:cb3d968589d8	513	*/
Kojto	90:cb3d968589d8	514	#define ADC_IT_AWD ADC_IER_AWDIE /!< ADC Analog watchdog interrupt source /
Kojto	90:cb3d968589d8	515	#define ADC_IT_OVR ADC_IER_OVRIE /!< ADC overrun interrupt source /
Kojto	90:cb3d968589d8	516	#define ADC_IT_EOS ADC_IER_EOSEQIE /!< ADC End of Regular sequence of Conversions interrupt source /
Kojto	90:cb3d968589d8	517	#define ADC_IT_EOC ADC_IER_EOCIE /!< ADC End of Regular Conversion interrupt source /
Kojto	90:cb3d968589d8	518	#define ADC_IT_EOSMP ADC_IER_EOSMPIE /!< ADC End of Sampling interrupt source /
Kojto	90:cb3d968589d8	519	#define ADC_IT_RDY ADC_IER_ADRDYIE /!< ADC Ready interrupt source /
Kojto	90:cb3d968589d8	520	/**
Kojto	90:cb3d968589d8	521	* @}
Kojto	90:cb3d968589d8	522	*/
Kojto	90:cb3d968589d8	523
Kojto	90:cb3d968589d8	524	/** @defgroup ADC_flags_definition ADC flags definition
Kojto	90:cb3d968589d8	525	* @{
Kojto	90:cb3d968589d8	526	*/
Kojto	90:cb3d968589d8	527	#define ADC_FLAG_AWD ADC_ISR_AWD /!< ADC Analog watchdog flag /
Kojto	90:cb3d968589d8	528	#define ADC_FLAG_OVR ADC_ISR_OVR /!< ADC overrun flag /
Kojto	90:cb3d968589d8	529	#define ADC_FLAG_EOS ADC_ISR_EOSEQ /!< ADC End of Regular sequence of Conversions flag /
Kojto	90:cb3d968589d8	530	#define ADC_FLAG_EOC ADC_ISR_EOC /!< ADC End of Regular Conversion flag /
Kojto	90:cb3d968589d8	531	#define ADC_FLAG_EOSMP ADC_ISR_EOSMP /!< ADC End of Sampling flag /
Kojto	90:cb3d968589d8	532	#define ADC_FLAG_RDY ADC_ISR_ADRDY /!< ADC Ready flag /
Kojto	90:cb3d968589d8	533
Kojto	90:cb3d968589d8	534	#define ADC_FLAG_ALL (ADC_FLAG_AWD \| ADC_FLAG_OVR \| ADC_FLAG_EOS \| ADC_FLAG_EOC \| \
Kojto	90:cb3d968589d8	535	ADC_FLAG_EOSMP \| ADC_FLAG_RDY )
Kojto	90:cb3d968589d8	536
Kojto	90:cb3d968589d8	537	/* Combination of all post-conversion flags bits: EOC/EOS, OVR, AWD */
Kojto	90:cb3d968589d8	538	#define ADC_FLAG_POSTCONV_ALL (ADC_FLAG_AWD \| ADC_FLAG_OVR \| ADC_FLAG_EOS \| ADC_FLAG_EOC)
Kojto	90:cb3d968589d8	539	/**
Kojto	90:cb3d968589d8	540	* @}
Kojto	90:cb3d968589d8	541	*/
Kojto	90:cb3d968589d8	542
Kojto	90:cb3d968589d8	543	/** @defgroup ADC_range_verification ADC range verification
Kojto	90:cb3d968589d8	544	* in function of ADC resolution selected (12, 10, 8 or 6 bits)
Kojto	90:cb3d968589d8	545	* @{
Kojto	90:cb3d968589d8	546	*/
Kojto	90:cb3d968589d8	547	#define IS_ADC_RANGE(RESOLUTION, ADC_VALUE) \
Kojto	90:cb3d968589d8	548	((((RESOLUTION) == ADC_RESOLUTION12b) && ((ADC_VALUE) <= ((uint32_t)0x0FFF))) \|\| \
Kojto	90:cb3d968589d8	549	(((RESOLUTION) == ADC_RESOLUTION10b) && ((ADC_VALUE) <= ((uint32_t)0x03FF))) \|\| \
Kojto	90:cb3d968589d8	550	(((RESOLUTION) == ADC_RESOLUTION8b) && ((ADC_VALUE) <= ((uint32_t)0x00FF))) \|\| \
Kojto	90:cb3d968589d8	551	(((RESOLUTION) == ADC_RESOLUTION6b) && ((ADC_VALUE) <= ((uint32_t)0x003F))) )
Kojto	90:cb3d968589d8	552	/**
Kojto	90:cb3d968589d8	553	* @}
Kojto	90:cb3d968589d8	554	*/
Kojto	90:cb3d968589d8	555
Kojto	90:cb3d968589d8	556	/** @defgroup ADC_regular_rank_verification ADC regular rank verification
Kojto	90:cb3d968589d8	557	* @{
Kojto	90:cb3d968589d8	558	*/
Kojto	90:cb3d968589d8	559	#define IS_ADC_REGULAR_RANK(RANK) (((RANK) >= ((uint32_t)1)) && ((RANK) <= ((uint32_t)16)))
Kojto	90:cb3d968589d8	560	/**
Kojto	90:cb3d968589d8	561	* @}
Kojto	90:cb3d968589d8	562	*/
Kojto	90:cb3d968589d8	563
Kojto	90:cb3d968589d8	564	/**
Kojto	90:cb3d968589d8	565	* @}
Kojto	90:cb3d968589d8	566	*/
Kojto	90:cb3d968589d8	567
Kojto	90:cb3d968589d8	568	/* Exported macros -----------------------------------------------------------*/
Kojto	90:cb3d968589d8	569
Kojto	90:cb3d968589d8	570	/** @defgroup ADC_Exported_Macros ADC Exported Macros
Kojto	90:cb3d968589d8	571	* @{
Kojto	90:cb3d968589d8	572	*/
Kojto	90:cb3d968589d8	573	/** @brief Reset ADC handle state
Kojto	90:cb3d968589d8	574	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	575	* @retval None
Kojto	90:cb3d968589d8	576	*/
Kojto	90:cb3d968589d8	577	#define __HAL_ADC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_ADC_STATE_RESET)
Kojto	90:cb3d968589d8	578
Kojto	90:cb3d968589d8	579	/* Macro for internal HAL driver usage, and possibly can be used into code of */
Kojto	90:cb3d968589d8	580	/* final user. */
Kojto	90:cb3d968589d8	581
Kojto	90:cb3d968589d8	582	/**
Kojto	90:cb3d968589d8	583	* @brief Verification of ADC state: enabled or disabled
Kojto	90:cb3d968589d8	584	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	585	* @retval SET (ADC enabled) or RESET (ADC disabled)
Kojto	90:cb3d968589d8	586	*/
Kojto	90:cb3d968589d8	587	/* Note: If low power mode AutoPowerOff is enabled, power-on/off phases are */
Kojto	90:cb3d968589d8	588	/* performed automatically by hardware and flag ADC_FLAG_RDY is not */
Kojto	90:cb3d968589d8	589	/* set. */
Kojto	90:cb3d968589d8	590	#define __HAL_ADC_IS_ENABLED(__HANDLE__) \
Kojto	90:cb3d968589d8	591	(( ((((__HANDLE__)->Instance->CR) & (ADC_CR_ADEN \| ADC_CR_ADDIS)) == ADC_CR_ADEN) && \
Kojto	90:cb3d968589d8	592	(((((__HANDLE__)->Instance->ISR) & ADC_FLAG_RDY) == ADC_FLAG_RDY) \|\| \
Kojto	90:cb3d968589d8	593	((((__HANDLE__)->Instance->CFGR1) & ADC_CFGR1_AUTOFF) == ADC_CFGR1_AUTOFF) ) \
Kojto	90:cb3d968589d8	594	) ? SET : RESET)
Kojto	90:cb3d968589d8	595
Kojto	90:cb3d968589d8	596	/**
Kojto	90:cb3d968589d8	597	* @brief Test if conversion trigger of regular group is software start
Kojto	90:cb3d968589d8	598	* or external trigger.
Kojto	90:cb3d968589d8	599	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	600	* @retval SET (software start) or RESET (external trigger)
Kojto	90:cb3d968589d8	601	*/
Kojto	90:cb3d968589d8	602	#define __HAL_ADC_IS_SOFTWARE_START_REGULAR(__HANDLE__) \
Kojto	90:cb3d968589d8	603	(((__HANDLE__)->Instance->CFGR1 & ADC_CFGR1_EXTEN) == RESET)
Kojto	90:cb3d968589d8	604
Kojto	90:cb3d968589d8	605	/**
Kojto	90:cb3d968589d8	606	* @brief Check if no conversion on going on regular group
Kojto	90:cb3d968589d8	607	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	608	* @retval SET (conversion is on going) or RESET (no conversion is on going)
Kojto	90:cb3d968589d8	609	*/
Kojto	90:cb3d968589d8	610	#define __HAL_ADC_IS_CONVERSION_ONGOING_REGULAR(__HANDLE__) \
Kojto	90:cb3d968589d8	611	(( (((__HANDLE__)->Instance->CR) & ADC_CR_ADSTART) == RESET \
Kojto	90:cb3d968589d8	612	) ? RESET : SET)
Kojto	90:cb3d968589d8	613
Kojto	90:cb3d968589d8	614	/**
Kojto	90:cb3d968589d8	615	* @brief Returns resolution bits in CFGR1 register: RES[1:0].
Kojto	90:cb3d968589d8	616	* Returned value is among parameters to @ref ADC_Resolution.
Kojto	90:cb3d968589d8	617	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	618	* @retval None
Kojto	90:cb3d968589d8	619	*/
Kojto	90:cb3d968589d8	620	#define __HAL_ADC_GET_RESOLUTION(__HANDLE__) (((__HANDLE__)->Instance->CFGR1) & ADC_CFGR1_RES)
Kojto	90:cb3d968589d8	621
Kojto	90:cb3d968589d8	622	/**
Kojto	90:cb3d968589d8	623	* @brief Returns ADC sample time bits in SMPR register: SMP[2:0].
Kojto	90:cb3d968589d8	624	* Returned value is among parameters to @ref ADC_Resolution.
Kojto	90:cb3d968589d8	625	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	626	* @retval None
Kojto	90:cb3d968589d8	627	*/
Kojto	90:cb3d968589d8	628	#define __HAL_ADC_GET_SAMPLINGTIME(__HANDLE__) (((__HANDLE__)->Instance->SMPR) & ADC_SMPR_SMP)
Kojto	90:cb3d968589d8	629
Kojto	90:cb3d968589d8	630	/** @brief Checks if the specified ADC interrupt source is enabled or disabled.
Kojto	90:cb3d968589d8	631	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	632	* @param __INTERRUPT__: ADC interrupt source to check
Kojto	90:cb3d968589d8	633	* @retval State ofinterruption (SET or RESET)
Kojto	90:cb3d968589d8	634	*/
Kojto	90:cb3d968589d8	635	#define __HAL_ADC_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) \
Kojto	90:cb3d968589d8	636	(( ((__HANDLE__)->Instance->IER & (__INTERRUPT__)) == (__INTERRUPT__) \
Kojto	90:cb3d968589d8	637	)? SET : RESET \
Kojto	90:cb3d968589d8	638	)
Kojto	90:cb3d968589d8	639
Kojto	90:cb3d968589d8	640	/**
Kojto	90:cb3d968589d8	641	* @brief Enable the ADC end of conversion interrupt.
Kojto	90:cb3d968589d8	642	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	643	* @param __INTERRUPT__: ADC Interrupt
Kojto	90:cb3d968589d8	644	* @retval None
Kojto	90:cb3d968589d8	645	*/
Kojto	90:cb3d968589d8	646	#define __HAL_ADC_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IER) \|= (__INTERRUPT__))
Kojto	90:cb3d968589d8	647
Kojto	90:cb3d968589d8	648	/**
Kojto	90:cb3d968589d8	649	* @brief Disable the ADC end of conversion interrupt.
Kojto	90:cb3d968589d8	650	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	651	* @param __INTERRUPT__: ADC Interrupt
Kojto	90:cb3d968589d8	652	* @retval None
Kojto	90:cb3d968589d8	653	*/
Kojto	90:cb3d968589d8	654	#define __HAL_ADC_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IER) &= ~(__INTERRUPT__))
Kojto	90:cb3d968589d8	655
Kojto	90:cb3d968589d8	656	/**
Kojto	90:cb3d968589d8	657	* @brief Get the selected ADC's flag status.
Kojto	90:cb3d968589d8	658	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	659	* @param __FLAG__: ADC flag
Kojto	90:cb3d968589d8	660	* @retval None
Kojto	90:cb3d968589d8	661	*/
Kojto	90:cb3d968589d8	662	#define __HAL_ADC_GET_FLAG(__HANDLE__, __FLAG__) ((((__HANDLE__)->Instance->ISR) & (__FLAG__)) == (__FLAG__))
Kojto	90:cb3d968589d8	663
Kojto	90:cb3d968589d8	664	/**
Kojto	90:cb3d968589d8	665	* @brief Clear the ADC's pending flags
Kojto	90:cb3d968589d8	666	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	667	* @param __FLAG__: ADC flag
Kojto	90:cb3d968589d8	668	* @retval None
Kojto	90:cb3d968589d8	669	*/
Kojto	90:cb3d968589d8	670	/* Note: bit cleared bit by writing 1 (writing 0 has no effect on any bit of register ISR) */
Kojto	90:cb3d968589d8	671	#define __HAL_ADC_CLEAR_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR) = (__FLAG__))
Kojto	90:cb3d968589d8	672
Kojto	90:cb3d968589d8	673	/**
Kojto	90:cb3d968589d8	674	* @brief Clear ADC error code (set it to error code: "no error")
Kojto	90:cb3d968589d8	675	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	676	* @retval None
Kojto	90:cb3d968589d8	677	*/
Kojto	90:cb3d968589d8	678	#define __HAL_ADC_CLEAR_ERRORCODE(__HANDLE__) ((__HANDLE__)->ErrorCode = HAL_ADC_ERROR_NONE)
Kojto	90:cb3d968589d8	679
Kojto	90:cb3d968589d8	680
Kojto	90:cb3d968589d8	681	/**
Kojto	90:cb3d968589d8	682	* @brief Configure the channel number into channel selection register
Kojto	90:cb3d968589d8	683	* @param _CHANNEL_: ADC Channel
Kojto	90:cb3d968589d8	684	* @retval None
Kojto	90:cb3d968589d8	685	*/
Kojto	90:cb3d968589d8	686	/* This function converts ADC channels from numbers (see defgroup ADC_channels)
Kojto	90:cb3d968589d8	687	to bitfields, to get the equivalence of CMSIS channels:
Kojto	90:cb3d968589d8	688	ADC_CHANNEL_0 ((uint32_t) ADC_CHSELR_CHSEL0)
Kojto	90:cb3d968589d8	689	ADC_CHANNEL_1 ((uint32_t) ADC_CHSELR_CHSEL1)
Kojto	90:cb3d968589d8	690	ADC_CHANNEL_2 ((uint32_t) ADC_CHSELR_CHSEL2)
Kojto	90:cb3d968589d8	691	ADC_CHANNEL_3 ((uint32_t) ADC_CHSELR_CHSEL3)
Kojto	90:cb3d968589d8	692	ADC_CHANNEL_4 ((uint32_t) ADC_CHSELR_CHSEL4)
Kojto	90:cb3d968589d8	693	ADC_CHANNEL_5 ((uint32_t) ADC_CHSELR_CHSEL5)
Kojto	90:cb3d968589d8	694	ADC_CHANNEL_6 ((uint32_t) ADC_CHSELR_CHSEL6)
Kojto	90:cb3d968589d8	695	ADC_CHANNEL_7 ((uint32_t) ADC_CHSELR_CHSEL7)
Kojto	90:cb3d968589d8	696	ADC_CHANNEL_8 ((uint32_t) ADC_CHSELR_CHSEL8)
Kojto	90:cb3d968589d8	697	ADC_CHANNEL_9 ((uint32_t) ADC_CHSELR_CHSEL9)
Kojto	90:cb3d968589d8	698	ADC_CHANNEL_10 ((uint32_t) ADC_CHSELR_CHSEL10)
Kojto	90:cb3d968589d8	699	ADC_CHANNEL_11 ((uint32_t) ADC_CHSELR_CHSEL11)
Kojto	90:cb3d968589d8	700	ADC_CHANNEL_12 ((uint32_t) ADC_CHSELR_CHSEL12)
Kojto	90:cb3d968589d8	701	ADC_CHANNEL_13 ((uint32_t) ADC_CHSELR_CHSEL13)
Kojto	90:cb3d968589d8	702	ADC_CHANNEL_14 ((uint32_t) ADC_CHSELR_CHSEL14)
Kojto	90:cb3d968589d8	703	ADC_CHANNEL_15 ((uint32_t) ADC_CHSELR_CHSEL15)
Kojto	90:cb3d968589d8	704	ADC_CHANNEL_16 ((uint32_t) ADC_CHSELR_CHSEL16)
Kojto	90:cb3d968589d8	705	ADC_CHANNEL_17 ((uint32_t) ADC_CHSELR_CHSEL17)
Kojto	90:cb3d968589d8	706	ADC_CHANNEL_18 ((uint32_t) ADC_CHSELR_CHSEL18)
Kojto	90:cb3d968589d8	707	*/
Kojto	90:cb3d968589d8	708	#define __HAL_ADC_CHSELR_CHANNEL(_CHANNEL_) ( 1U << (_CHANNEL_))
Kojto	90:cb3d968589d8	709
Kojto	90:cb3d968589d8	710	/**
Kojto	90:cb3d968589d8	711	* @}
Kojto	90:cb3d968589d8	712	*/
Kojto	90:cb3d968589d8	713
Kojto	90:cb3d968589d8	714	/** @defgroup ADC_Exported_Macro_internal_HAL_driver ADC Exported Macro internal HAL driver
Kojto	90:cb3d968589d8	715	* @{
Kojto	90:cb3d968589d8	716	*/
Kojto	90:cb3d968589d8	717	/* Macro reserved for internal HAL driver usage, not intended to be used in */
Kojto	90:cb3d968589d8	718	/* code of final user. */
Kojto	90:cb3d968589d8	719
Kojto	90:cb3d968589d8	720	/**
Kojto	90:cb3d968589d8	721	* @brief Set the Analog Watchdog 1 channel.
Kojto	90:cb3d968589d8	722	* @param _CHANNEL_: channel to be monitored by Analog Watchdog 1.
Kojto	90:cb3d968589d8	723	* @retval None
Kojto	90:cb3d968589d8	724	*/
Kojto	90:cb3d968589d8	725	#define __HAL_ADC_CFGR_AWDCH(_CHANNEL_) ((_CHANNEL_) << 26)
Kojto	90:cb3d968589d8	726
Kojto	90:cb3d968589d8	727	/**
Kojto	90:cb3d968589d8	728	* @brief Enable ADC discontinuous conversion mode for regular group
Kojto	93:e188a91d3eaa	729	* @param _REG_DISCONTINUOUS_MODE_: Regular discontinuous mode.
Kojto	90:cb3d968589d8	730	* @retval None
Kojto	90:cb3d968589d8	731	*/
Kojto	90:cb3d968589d8	732	#define __HAL_ADC_CFGR1_REG_DISCCONTINUOUS(_REG_DISCONTINUOUS_MODE_) ((_REG_DISCONTINUOUS_MODE_) << 16)
Kojto	90:cb3d968589d8	733
Kojto	90:cb3d968589d8	734	/**
Kojto	90:cb3d968589d8	735	* @brief Enable the ADC auto off mode.
Kojto	90:cb3d968589d8	736	* @param _AUTOOFF_: Auto off bit enable or disable.
Kojto	90:cb3d968589d8	737	* @retval None
Kojto	90:cb3d968589d8	738	*/
Kojto	90:cb3d968589d8	739	#define __HAL_ADC_CFGR1_AUTOOFF(_AUTOOFF_) ((_AUTOOFF_) << 15)
Kojto	90:cb3d968589d8	740
Kojto	90:cb3d968589d8	741	/**
Kojto	90:cb3d968589d8	742	* @brief Enable the ADC auto delay mode.
Kojto	90:cb3d968589d8	743	* @param _AUTOWAIT_: Auto delay bit enable or disable.
Kojto	90:cb3d968589d8	744	* @retval None
Kojto	90:cb3d968589d8	745	*/
Kojto	90:cb3d968589d8	746	#define __HAL_ADC_CFGR1_AUTOWAIT(_AUTOWAIT_) ((_AUTOWAIT_) << 14)
Kojto	90:cb3d968589d8	747
Kojto	90:cb3d968589d8	748	/**
Kojto	90:cb3d968589d8	749	* @brief Enable ADC continuous conversion mode.
Kojto	90:cb3d968589d8	750	* @param _CONTINUOUS_MODE_: Continuous mode.
Kojto	90:cb3d968589d8	751	* @retval None
Kojto	90:cb3d968589d8	752	*/
Kojto	90:cb3d968589d8	753	#define __HAL_ADC_CFGR1_CONTINUOUS(_CONTINUOUS_MODE_) ((_CONTINUOUS_MODE_) << 13)
Kojto	90:cb3d968589d8	754
Kojto	90:cb3d968589d8	755	/**
Kojto	90:cb3d968589d8	756	* @brief Enable ADC overrun mode.
Kojto	90:cb3d968589d8	757	* @param _OVERRUN_MODE_: Overrun mode.
Kojto	90:cb3d968589d8	758	* @retval Overun bit setting to be programmed into CFGR register
Kojto	90:cb3d968589d8	759	*/
Kojto	90:cb3d968589d8	760	/* Note: Bit ADC_CFGR1_OVRMOD not used directly in constant */
Kojto	90:cb3d968589d8	761	/* "OVR_DATA_OVERWRITTEN" to have this case defined to 0x00, to set it as the */
Kojto	90:cb3d968589d8	762	/* default case to be compliant with other STM32 devices. */
Kojto	90:cb3d968589d8	763	#define __HAL_ADC_CFGR1_OVERRUN(_OVERRUN_MODE_) \
Kojto	90:cb3d968589d8	764	( ( (_OVERRUN_MODE_) != (OVR_DATA_PRESERVED) \
Kojto	90:cb3d968589d8	765	)? (ADC_CFGR1_OVRMOD) : (0x00000000) \
Kojto	90:cb3d968589d8	766	)
Kojto	90:cb3d968589d8	767
Kojto	90:cb3d968589d8	768	/**
Kojto	90:cb3d968589d8	769	* @brief Enable ADC scan mode to convert multiple ranks with sequencer.
Kojto	90:cb3d968589d8	770	* @param _SCAN_MODE_: Scan conversion mode.
Kojto	90:cb3d968589d8	771	* @retval None
Kojto	90:cb3d968589d8	772	*/
Kojto	90:cb3d968589d8	773	#define __HAL_ADC_CFGR1_SCANDIR(_SCAN_MODE_) \
Kojto	90:cb3d968589d8	774	( ( (_SCAN_MODE_) == (ADC_SCAN_DIRECTION_BACKWARD) \
Kojto	90:cb3d968589d8	775	)? (ADC_CFGR1_SCANDIR) : (0x00000000) \
Kojto	90:cb3d968589d8	776	)
Kojto	90:cb3d968589d8	777
Kojto	90:cb3d968589d8	778	/**
Kojto	90:cb3d968589d8	779	* @brief Enable the ADC DMA continuous request.
Kojto	90:cb3d968589d8	780	* @param _DMACONTREQ_MODE_: DMA continuous request mode.
Kojto	90:cb3d968589d8	781	* @retval None
Kojto	90:cb3d968589d8	782	*/
Kojto	90:cb3d968589d8	783	#define __HAL_ADC_CFGR1_DMACONTREQ(_DMACONTREQ_MODE_) ((_DMACONTREQ_MODE_) << 1)
Kojto	93:e188a91d3eaa	784
Kojto	90:cb3d968589d8	785	/**
Kojto	90:cb3d968589d8	786	* @brief Configure the analog watchdog high threshold into register TR.
Kojto	90:cb3d968589d8	787	* @param _Threshold_: Threshold value
Kojto	90:cb3d968589d8	788	* @retval None
Kojto	90:cb3d968589d8	789	*/
Kojto	90:cb3d968589d8	790	#define __HAL_ADC_TRX_HIGHTHRESHOLD(_Threshold_) ((_Threshold_) << 16)
Kojto	90:cb3d968589d8	791
Kojto	90:cb3d968589d8	792	/**
Kojto	90:cb3d968589d8	793	* @brief Enable the ADC peripheral
Kojto	90:cb3d968589d8	794	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	795	* @retval None
Kojto	90:cb3d968589d8	796	*/
Kojto	90:cb3d968589d8	797	#define __HAL_ADC_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR \|= ADC_CR_ADEN)
Kojto	90:cb3d968589d8	798
Kojto	90:cb3d968589d8	799	/**
Kojto	90:cb3d968589d8	800	* @brief Verification of hardware constraints before ADC can be enabled
Kojto	90:cb3d968589d8	801	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	802	* @retval SET (ADC can be enabled) or RESET (ADC cannot be enabled)
Kojto	90:cb3d968589d8	803	*/
Kojto	90:cb3d968589d8	804	#define __HAL_ADC_ENABLING_CONDITIONS(__HANDLE__) \
Kojto	90:cb3d968589d8	805	(( ( ((__HANDLE__)->Instance->CR) & \
Kojto	93:e188a91d3eaa	806	(ADC_CR_ADCAL \| ADC_CR_ADSTP \| \
Kojto	90:cb3d968589d8	807	ADC_CR_ADSTART \| ADC_CR_ADDIS \| ADC_CR_ADEN ) \
Kojto	90:cb3d968589d8	808	) == RESET \
Kojto	90:cb3d968589d8	809	) ? SET : RESET)
Kojto	90:cb3d968589d8	810
Kojto	90:cb3d968589d8	811	/**
Kojto	90:cb3d968589d8	812	* @brief Disable the ADC peripheral
Kojto	90:cb3d968589d8	813	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	814	* @retval None
Kojto	90:cb3d968589d8	815	*/
Kojto	90:cb3d968589d8	816	#define __HAL_ADC_DISABLE(__HANDLE__) \
Kojto	90:cb3d968589d8	817	do{ \
Kojto	90:cb3d968589d8	818	(__HANDLE__)->Instance->CR \|= ADC_CR_ADDIS; \
Kojto	90:cb3d968589d8	819	__HAL_ADC_CLEAR_FLAG((__HANDLE__), (ADC_FLAG_EOSMP \| ADC_FLAG_RDY)); \
Kojto	90:cb3d968589d8	820	} while(0)
Kojto	90:cb3d968589d8	821
Kojto	90:cb3d968589d8	822	/**
Kojto	90:cb3d968589d8	823	* @brief Verification of hardware constraints before ADC can be disabled
Kojto	90:cb3d968589d8	824	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	825	* @retval SET (ADC can be disabled) or RESET (ADC cannot be disabled)
Kojto	90:cb3d968589d8	826	*/
Kojto	90:cb3d968589d8	827	#define __HAL_ADC_DISABLING_CONDITIONS(__HANDLE__) \
Kojto	90:cb3d968589d8	828	(( ( ((__HANDLE__)->Instance->CR) & \
Kojto	90:cb3d968589d8	829	(ADC_CR_ADSTART \| ADC_CR_ADEN)) == ADC_CR_ADEN \
Kojto	90:cb3d968589d8	830	) ? SET : RESET)
Kojto	90:cb3d968589d8	831
Kojto	90:cb3d968589d8	832	/**
Kojto	90:cb3d968589d8	833	* @brief Shift the AWD threshold in function of the selected ADC resolution.
Kojto	90:cb3d968589d8	834	* Thresholds have to be left-aligned on bit 11, the LSB (right bits) are set to 0.
Kojto	90:cb3d968589d8	835	* If resolution 12 bits, no shift.
Kojto	90:cb3d968589d8	836	* If resolution 10 bits, shift of 2 ranks on the left.
Kojto	90:cb3d968589d8	837	* If resolution 8 bits, shift of 4 ranks on the left.
Kojto	90:cb3d968589d8	838	* If resolution 6 bits, shift of 6 ranks on the left.
Kojto	90:cb3d968589d8	839	* therefore, shift = (12 - resolution) = 12 - (12- (((RES[1:0]) >> 3)*2))
Kojto	90:cb3d968589d8	840	* @param __HANDLE__: ADC handle
Kojto	90:cb3d968589d8	841	* @param _Threshold_: Value to be shifted
Kojto	90:cb3d968589d8	842	* @retval None
Kojto	90:cb3d968589d8	843	*/
Kojto	90:cb3d968589d8	844	#define __HAL_ADC_AWD1THRESHOLD_SHIFT_RESOLUTION(__HANDLE__, _Threshold_) \
Kojto	90:cb3d968589d8	845	((_Threshold_) << ((((__HANDLE__)->Instance->CFGR1 & ADC_CFGR1_RES) >> 3)*2))
Kojto	90:cb3d968589d8	846
Kojto	90:cb3d968589d8	847	/**
Kojto	90:cb3d968589d8	848	* @}
Kojto	90:cb3d968589d8	849	*/
Kojto	90:cb3d968589d8	850
Kojto	90:cb3d968589d8	851	/* Include ADC HAL Extension module */
Kojto	90:cb3d968589d8	852	#include "stm32f0xx_hal_adc_ex.h"
Kojto	90:cb3d968589d8	853
Kojto	90:cb3d968589d8	854	/* Exported functions --------------------------------------------------------*/
Kojto	90:cb3d968589d8	855	/** @addtogroup ADC_Exported_Functions
Kojto	90:cb3d968589d8	856	* @{
Kojto	90:cb3d968589d8	857	*/
Kojto	90:cb3d968589d8	858
Kojto	90:cb3d968589d8	859	/** @addtogroup ADC_Exported_Functions_Group1
Kojto	90:cb3d968589d8	860	* @{
Kojto	90:cb3d968589d8	861	*/
Kojto	90:cb3d968589d8	862
Kojto	90:cb3d968589d8	863
Kojto	90:cb3d968589d8	864	/* Initialization and de-initialization functions **********************************/
Kojto	90:cb3d968589d8	865	HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	866	HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef *hadc);
Kojto	90:cb3d968589d8	867	void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	868	void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	869	/**
Kojto	90:cb3d968589d8	870	* @}
Kojto	90:cb3d968589d8	871	*/
Kojto	90:cb3d968589d8	872
Kojto	90:cb3d968589d8	873	/* IO operation functions *****************************************************/
Kojto	90:cb3d968589d8	874
Kojto	90:cb3d968589d8	875	/** @addtogroup ADC_Exported_Functions_Group2
Kojto	90:cb3d968589d8	876	* @{
Kojto	90:cb3d968589d8	877	*/
Kojto	90:cb3d968589d8	878
Kojto	90:cb3d968589d8	879
Kojto	90:cb3d968589d8	880	/* Blocking mode: Polling */
Kojto	90:cb3d968589d8	881	HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	882	HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	883	HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout);
Kojto	90:cb3d968589d8	884	HAL_StatusTypeDef HAL_ADC_PollForEvent(ADC_HandleTypeDef* hadc, uint32_t EventType, uint32_t Timeout);
Kojto	90:cb3d968589d8	885
Kojto	90:cb3d968589d8	886	/* Non-blocking mode: Interruption */
Kojto	90:cb3d968589d8	887	HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	888	HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	889
Kojto	90:cb3d968589d8	890	/* Non-blocking mode: DMA */
Kojto	90:cb3d968589d8	891	HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length);
Kojto	90:cb3d968589d8	892	HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	893
Kojto	90:cb3d968589d8	894	/* ADC retrieve conversion value intended to be used with polling or interruption */
Kojto	90:cb3d968589d8	895	uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	896
Kojto	90:cb3d968589d8	897	/* ADC IRQHandler and Callbacks used in non-blocking modes (Interruption and DMA) */
Kojto	90:cb3d968589d8	898	void HAL_ADC_IRQHandler(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	899	void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	900	void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	901	void HAL_ADC_LevelOutOfWindowCallback(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	902	void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc);
Kojto	90:cb3d968589d8	903	/**
Kojto	90:cb3d968589d8	904	* @}
Kojto	90:cb3d968589d8	905	*/
Kojto	90:cb3d968589d8	906
Kojto	90:cb3d968589d8	907
Kojto	90:cb3d968589d8	908	/* Peripheral Control functions ***********************************************/
Kojto	90:cb3d968589d8	909	/** @addtogroup ADC_Exported_Functions_Group3
Kojto	90:cb3d968589d8	910	* @{
Kojto	90:cb3d968589d8	911	*/
Kojto	90:cb3d968589d8	912	HAL_StatusTypeDef HAL_ADC_ConfigChannel(ADC_HandleTypeDef* hadc, ADC_ChannelConfTypeDef* sConfig);
Kojto	90:cb3d968589d8	913	HAL_StatusTypeDef HAL_ADC_AnalogWDGConfig(ADC_HandleTypeDef* hadc, ADC_AnalogWDGConfTypeDef* AnalogWDGConfig);
Kojto	90:cb3d968589d8	914	/**
Kojto	90:cb3d968589d8	915	* @}
Kojto	90:cb3d968589d8	916	*/
Kojto	90:cb3d968589d8	917
Kojto	90:cb3d968589d8	918
Kojto	90:cb3d968589d8	919	/* Peripheral State functions *************************************************/
Kojto	90:cb3d968589d8	920	/** @addtogroup ADC_Exported_Functions_Group4
Kojto	90:cb3d968589d8	921	* @{
Kojto	90:cb3d968589d8	922	*/
Kojto	90:cb3d968589d8	923	HAL_ADC_StateTypeDef HAL_ADC_GetState(ADC_HandleTypeDef* hadc);
Kojto	90:cb3d968589d8	924	uint32_t HAL_ADC_GetError(ADC_HandleTypeDef *hadc);
Kojto	90:cb3d968589d8	925	/**
Kojto	90:cb3d968589d8	926	* @}
Kojto	90:cb3d968589d8	927	*/
Kojto	90:cb3d968589d8	928
Kojto	90:cb3d968589d8	929
Kojto	90:cb3d968589d8	930	/**
Kojto	90:cb3d968589d8	931	* @}
Kojto	90:cb3d968589d8	932	*/
Kojto	90:cb3d968589d8	933
Kojto	90:cb3d968589d8	934
Kojto	90:cb3d968589d8	935	/**
Kojto	90:cb3d968589d8	936	* @}
Kojto	90:cb3d968589d8	937	*/
Kojto	90:cb3d968589d8	938
Kojto	90:cb3d968589d8	939	/**
Kojto	90:cb3d968589d8	940	* @}
Kojto	90:cb3d968589d8	941	*/
Kojto	90:cb3d968589d8	942
Kojto	90:cb3d968589d8	943	#ifdef __cplusplus
Kojto	90:cb3d968589d8	944	}
Kojto	90:cb3d968589d8	945	#endif
Kojto	90:cb3d968589d8	946
Kojto	90:cb3d968589d8	947
Kojto	90:cb3d968589d8	948	#endif /* __STM32F0xx_HAL_ADC_H */
Kojto	90:cb3d968589d8	949
Kojto	90:cb3d968589d8	950	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/
Kojto	90:cb3d968589d8	951

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	08 Apr 2015
Imports:	2
Forks:	0
Commits:	98
Dependents:	1
Dependencies:	0
Followers:	1

TARGET_NUCLEO_F091RC/stm32f0xx_hal_adc.h@93:e188a91d3eaa, 2015-02-03 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning