Egor Rumjantsev / mbed

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

Fork of mbed by mbed official

TARGET_NUCLEO_F030R8/stm32f0xx_hal_adc.h@90:cb3d968589d8, 2014-10-28 (annotated)

Committer:
Kojto
Date:
Tue Oct 28 16:40:41 2014 +0000
Revision:
90:cb3d968589d8
Child:
93:e188a91d3eaa
Release 90 of the mbed library



Changes:



- Freescale KSDK update (v1.0)

- K22 - new target addition

- KL43Z - new target addition

- Nucleo F091RC - new target addition

- Nucleo L152RE - STM32Cube driver

- Nordic - Softdevice v7.1.0

- Nvic files - BSD License

- LPC824 - various HAL fixes

- Nucleo F411RE - CMSIS - IAR files

Who changed what in which revision?

UserRevisionLine numberNew 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 90:cb3d968589d8 5 * @version V1.1.0
Kojto 90:cb3d968589d8 6 * @date 03-Oct-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>&copy; 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 90:cb3d968589d8 69 * without error reporting 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 90:cb3d968589d8 729 * @param _REG_DISCONTINUOUS_MODE_: Regulat 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 90:cb3d968589d8 784
Kojto 90:cb3d968589d8 785 /**
Kojto 90:cb3d968589d8 786 * @brief Configure the channel number into offset OFRx register
Kojto 90:cb3d968589d8 787 * @param _CHANNEL_: ADC Channel
Kojto 90:cb3d968589d8 788 * @retval None
Kojto 90:cb3d968589d8 789 */
Kojto 90:cb3d968589d8 790 #define __HAL_ADC_OFR_CHANNEL(_CHANNEL_) ((_CHANNEL_) << 26)
Kojto 90:cb3d968589d8 791
Kojto 90:cb3d968589d8 792 /**
Kojto 90:cb3d968589d8 793 * @brief Configure the analog watchdog high threshold into register TR.
Kojto 90:cb3d968589d8 794 * @param _Threshold_: Threshold value
Kojto 90:cb3d968589d8 795 * @retval None
Kojto 90:cb3d968589d8 796 */
Kojto 90:cb3d968589d8 797 #define __HAL_ADC_TRX_HIGHTHRESHOLD(_Threshold_) ((_Threshold_) << 16)
Kojto 90:cb3d968589d8 798
Kojto 90:cb3d968589d8 799 /**
Kojto 90:cb3d968589d8 800 * @brief Enable the ADC peripheral
Kojto 90:cb3d968589d8 801 * @param __HANDLE__: ADC handle
Kojto 90:cb3d968589d8 802 * @retval None
Kojto 90:cb3d968589d8 803 */
Kojto 90:cb3d968589d8 804 #define __HAL_ADC_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= ADC_CR_ADEN)
Kojto 90:cb3d968589d8 805
Kojto 90:cb3d968589d8 806 /**
Kojto 90:cb3d968589d8 807 * @brief Verification of hardware constraints before ADC can be enabled
Kojto 90:cb3d968589d8 808 * @param __HANDLE__: ADC handle
Kojto 90:cb3d968589d8 809 * @retval SET (ADC can be enabled) or RESET (ADC cannot be enabled)
Kojto 90:cb3d968589d8 810 */
Kojto 90:cb3d968589d8 811 #define __HAL_ADC_ENABLING_CONDITIONS(__HANDLE__) \
Kojto 90:cb3d968589d8 812 (( ( ((__HANDLE__)->Instance->CR) & \
Kojto 90:cb3d968589d8 813 (ADC_CR_ADCAL | ADC_CR_ADSTP | \
Kojto 90:cb3d968589d8 814 ADC_CR_ADSTART | ADC_CR_ADDIS | ADC_CR_ADEN ) \
Kojto 90:cb3d968589d8 815 ) == RESET \
Kojto 90:cb3d968589d8 816 ) ? SET : RESET)
Kojto 90:cb3d968589d8 817
Kojto 90:cb3d968589d8 818 /**
Kojto 90:cb3d968589d8 819 * @brief Disable the ADC peripheral
Kojto 90:cb3d968589d8 820 * @param __HANDLE__: ADC handle
Kojto 90:cb3d968589d8 821 * @retval None
Kojto 90:cb3d968589d8 822 */
Kojto 90:cb3d968589d8 823 #define __HAL_ADC_DISABLE(__HANDLE__) \
Kojto 90:cb3d968589d8 824 do{ \
Kojto 90:cb3d968589d8 825 (__HANDLE__)->Instance->CR |= ADC_CR_ADDIS; \
Kojto 90:cb3d968589d8 826 __HAL_ADC_CLEAR_FLAG((__HANDLE__), (ADC_FLAG_EOSMP | ADC_FLAG_RDY)); \
Kojto 90:cb3d968589d8 827 } while(0)
Kojto 90:cb3d968589d8 828
Kojto 90:cb3d968589d8 829 /**
Kojto 90:cb3d968589d8 830 * @brief Verification of hardware constraints before ADC can be disabled
Kojto 90:cb3d968589d8 831 * @param __HANDLE__: ADC handle
Kojto 90:cb3d968589d8 832 * @retval SET (ADC can be disabled) or RESET (ADC cannot be disabled)
Kojto 90:cb3d968589d8 833 */
Kojto 90:cb3d968589d8 834 #define __HAL_ADC_DISABLING_CONDITIONS(__HANDLE__) \
Kojto 90:cb3d968589d8 835 (( ( ((__HANDLE__)->Instance->CR) & \
Kojto 90:cb3d968589d8 836 (ADC_CR_ADSTART | ADC_CR_ADEN)) == ADC_CR_ADEN \
Kojto 90:cb3d968589d8 837 ) ? SET : RESET)
Kojto 90:cb3d968589d8 838
Kojto 90:cb3d968589d8 839 /**
Kojto 90:cb3d968589d8 840 * @brief Shift the AWD threshold in function of the selected ADC resolution.
Kojto 90:cb3d968589d8 841 * Thresholds have to be left-aligned on bit 11, the LSB (right bits) are set to 0.
Kojto 90:cb3d968589d8 842 * If resolution 12 bits, no shift.
Kojto 90:cb3d968589d8 843 * If resolution 10 bits, shift of 2 ranks on the left.
Kojto 90:cb3d968589d8 844 * If resolution 8 bits, shift of 4 ranks on the left.
Kojto 90:cb3d968589d8 845 * If resolution 6 bits, shift of 6 ranks on the left.
Kojto 90:cb3d968589d8 846 * therefore, shift = (12 - resolution) = 12 - (12- (((RES[1:0]) >> 3)*2))
Kojto 90:cb3d968589d8 847 * @param __HANDLE__: ADC handle
Kojto 90:cb3d968589d8 848 * @param _Threshold_: Value to be shifted
Kojto 90:cb3d968589d8 849 * @retval None
Kojto 90:cb3d968589d8 850 */
Kojto 90:cb3d968589d8 851 #define __HAL_ADC_AWD1THRESHOLD_SHIFT_RESOLUTION(__HANDLE__, _Threshold_) \
Kojto 90:cb3d968589d8 852 ((_Threshold_) << ((((__HANDLE__)->Instance->CFGR1 & ADC_CFGR1_RES) >> 3)*2))
Kojto 90:cb3d968589d8 853
Kojto 90:cb3d968589d8 854 /**
Kojto 90:cb3d968589d8 855 * @}
Kojto 90:cb3d968589d8 856 */
Kojto 90:cb3d968589d8 857
Kojto 90:cb3d968589d8 858 /* Include ADC HAL Extension module */
Kojto 90:cb3d968589d8 859 #include "stm32f0xx_hal_adc_ex.h"
Kojto 90:cb3d968589d8 860
Kojto 90:cb3d968589d8 861 /* Exported functions --------------------------------------------------------*/
Kojto 90:cb3d968589d8 862 /** @addtogroup ADC_Exported_Functions
Kojto 90:cb3d968589d8 863 * @{
Kojto 90:cb3d968589d8 864 */
Kojto 90:cb3d968589d8 865
Kojto 90:cb3d968589d8 866 /** @addtogroup ADC_Exported_Functions_Group1
Kojto 90:cb3d968589d8 867 * @{
Kojto 90:cb3d968589d8 868 */
Kojto 90:cb3d968589d8 869
Kojto 90:cb3d968589d8 870
Kojto 90:cb3d968589d8 871 /* Initialization and de-initialization functions **********************************/
Kojto 90:cb3d968589d8 872 HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 873 HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef *hadc);
Kojto 90:cb3d968589d8 874 void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 875 void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 876 /**
Kojto 90:cb3d968589d8 877 * @}
Kojto 90:cb3d968589d8 878 */
Kojto 90:cb3d968589d8 879
Kojto 90:cb3d968589d8 880 /* IO operation functions *****************************************************/
Kojto 90:cb3d968589d8 881
Kojto 90:cb3d968589d8 882 /** @addtogroup ADC_Exported_Functions_Group2
Kojto 90:cb3d968589d8 883 * @{
Kojto 90:cb3d968589d8 884 */
Kojto 90:cb3d968589d8 885
Kojto 90:cb3d968589d8 886
Kojto 90:cb3d968589d8 887 /* Blocking mode: Polling */
Kojto 90:cb3d968589d8 888 HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 889 HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 890 HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout);
Kojto 90:cb3d968589d8 891 HAL_StatusTypeDef HAL_ADC_PollForEvent(ADC_HandleTypeDef* hadc, uint32_t EventType, uint32_t Timeout);
Kojto 90:cb3d968589d8 892
Kojto 90:cb3d968589d8 893 /* Non-blocking mode: Interruption */
Kojto 90:cb3d968589d8 894 HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 895 HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 896
Kojto 90:cb3d968589d8 897 /* Non-blocking mode: DMA */
Kojto 90:cb3d968589d8 898 HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length);
Kojto 90:cb3d968589d8 899 HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 900
Kojto 90:cb3d968589d8 901 /* ADC retrieve conversion value intended to be used with polling or interruption */
Kojto 90:cb3d968589d8 902 uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 903
Kojto 90:cb3d968589d8 904 /* ADC IRQHandler and Callbacks used in non-blocking modes (Interruption and DMA) */
Kojto 90:cb3d968589d8 905 void HAL_ADC_IRQHandler(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 906 void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 907 void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 908 void HAL_ADC_LevelOutOfWindowCallback(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 909 void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc);
Kojto 90:cb3d968589d8 910 /**
Kojto 90:cb3d968589d8 911 * @}
Kojto 90:cb3d968589d8 912 */
Kojto 90:cb3d968589d8 913
Kojto 90:cb3d968589d8 914
Kojto 90:cb3d968589d8 915 /* Peripheral Control functions ***********************************************/
Kojto 90:cb3d968589d8 916 /** @addtogroup ADC_Exported_Functions_Group3
Kojto 90:cb3d968589d8 917 * @{
Kojto 90:cb3d968589d8 918 */
Kojto 90:cb3d968589d8 919 HAL_StatusTypeDef HAL_ADC_ConfigChannel(ADC_HandleTypeDef* hadc, ADC_ChannelConfTypeDef* sConfig);
Kojto 90:cb3d968589d8 920 HAL_StatusTypeDef HAL_ADC_AnalogWDGConfig(ADC_HandleTypeDef* hadc, ADC_AnalogWDGConfTypeDef* AnalogWDGConfig);
Kojto 90:cb3d968589d8 921 /**
Kojto 90:cb3d968589d8 922 * @}
Kojto 90:cb3d968589d8 923 */
Kojto 90:cb3d968589d8 924
Kojto 90:cb3d968589d8 925
Kojto 90:cb3d968589d8 926 /* Peripheral State functions *************************************************/
Kojto 90:cb3d968589d8 927 /** @addtogroup ADC_Exported_Functions_Group4
Kojto 90:cb3d968589d8 928 * @{
Kojto 90:cb3d968589d8 929 */
Kojto 90:cb3d968589d8 930 HAL_ADC_StateTypeDef HAL_ADC_GetState(ADC_HandleTypeDef* hadc);
Kojto 90:cb3d968589d8 931 uint32_t HAL_ADC_GetError(ADC_HandleTypeDef *hadc);
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 * @}
Kojto 90:cb3d968589d8 944 */
Kojto 90:cb3d968589d8 945
Kojto 90:cb3d968589d8 946 /**
Kojto 90:cb3d968589d8 947 * @}
Kojto 90:cb3d968589d8 948 */
Kojto 90:cb3d968589d8 949
Kojto 90:cb3d968589d8 950 #ifdef __cplusplus
Kojto 90:cb3d968589d8 951 }
Kojto 90:cb3d968589d8 952 #endif
Kojto 90:cb3d968589d8 953
Kojto 90:cb3d968589d8 954
Kojto 90:cb3d968589d8 955 #endif /* __STM32F0xx_HAL_ADC_H */
Kojto 90:cb3d968589d8 956
Kojto 90:cb3d968589d8 957 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Kojto 90:cb3d968589d8 958