STM32F479xx HAL User Manual
stm32f4xx_hal_adc_ex.h
Go to the documentation of this file.
00001 /**
00002   ******************************************************************************
00003   * @file    stm32f4xx_hal_adc_ex.h
00004   * @author  MCD Application Team
00005   * @brief   Header file of ADC HAL module.
00006   ******************************************************************************
00007   * @attention
00008   *
00009   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
00010   * All rights reserved.</center></h2>
00011   *
00012   * This software component is licensed by ST under BSD 3-Clause license,
00013   * the "License"; You may not use this file except in compliance with the
00014   * License. You may obtain a copy of the License at:
00015   *                        opensource.org/licenses/BSD-3-Clause
00016   *
00017   ******************************************************************************
00018   */
00019 
00020 /* Define to prevent recursive inclusion -------------------------------------*/
00021 #ifndef __STM32F4xx_ADC_EX_H
00022 #define __STM32F4xx_ADC_EX_H
00023 
00024 #ifdef __cplusplus
00025  extern "C" {
00026 #endif
00027 
00028 /* Includes ------------------------------------------------------------------*/
00029 #include "stm32f4xx_hal_def.h"
00030 
00031 /** @addtogroup STM32F4xx_HAL_Driver
00032   * @{
00033   */
00034 
00035 /** @addtogroup ADCEx
00036   * @{
00037   */ 
00038 
00039 /* Exported types ------------------------------------------------------------*/
00040 /** @defgroup ADCEx_Exported_Types ADC Exported Types
00041   * @{
00042   */
00043    
00044 /** 
00045   * @brief  ADC Configuration injected Channel structure definition
00046   * @note   Parameters of this structure are shared within 2 scopes:
00047   *          - Scope channel: InjectedChannel, InjectedRank, InjectedSamplingTime, InjectedOffset
00048   *          - Scope injected group (affects all channels of injected group): InjectedNbrOfConversion, InjectedDiscontinuousConvMode,
00049   *            AutoInjectedConv, ExternalTrigInjecConvEdge, ExternalTrigInjecConv.
00050   * @note   The setting of these parameters with function HAL_ADCEx_InjectedConfigChannel() is conditioned to ADC state.
00051   *         ADC state can be either:
00052   *          - For all parameters: ADC disabled
00053   *          - For all except parameters 'InjectedDiscontinuousConvMode' and 'AutoInjectedConv': ADC enabled without conversion on going on injected group.
00054   *          - For parameters 'ExternalTrigInjecConv' and 'ExternalTrigInjecConvEdge': ADC enabled, even with conversion on going on injected group.
00055   */
00056 typedef struct 
00057 {
00058   uint32_t InjectedChannel;                      /*!< Selection of ADC channel to configure
00059                                                       This parameter can be a value of @ref ADC_channels
00060                                                       Note: Depending on devices, some channels may not be available on package pins. Refer to device datasheet for channels availability. */
00061   uint32_t InjectedRank;                         /*!< Rank in the injected group sequencer
00062                                                       This parameter must be a value of @ref ADCEx_injected_rank
00063                                                       Note: In case of need to disable a channel or change order of conversion sequencer, rank containing a previous channel setting can be overwritten by the new channel setting (or parameter number of conversions can be adjusted) */
00064   uint32_t InjectedSamplingTime;                 /*!< Sampling time value to be set for the selected channel.
00065                                                       Unit: ADC clock cycles
00066                                                       Conversion time is the addition of sampling time and processing time (12 ADC clock cycles at ADC resolution 12 bits, 11 cycles at 10 bits, 9 cycles at 8 bits, 7 cycles at 6 bits).
00067                                                       This parameter can be a value of @ref ADC_sampling_times
00068                                                       Caution: This parameter updates the parameter property of the channel, that can be used into regular and/or injected groups.
00069                                                                If this same channel has been previously configured in the other group (regular/injected), it will be updated to last setting.
00070                                                       Note: In case of usage of internal measurement channels (VrefInt/Vbat/TempSensor),
00071                                                             sampling time constraints must be respected (sampling time can be adjusted in function of ADC clock frequency and sampling time setting)
00072                                                             Refer to device datasheet for timings values, parameters TS_vrefint, TS_temp (values rough order: 4us min). */
00073   uint32_t InjectedOffset;                       /*!< Defines the offset to be subtracted from the raw converted data (for channels set on injected group only).
00074                                                       Offset value must be a positive number.
00075                                                       Depending of ADC resolution selected (12, 10, 8 or 6 bits),
00076                                                       this parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF, 0x3FF, 0xFF or 0x3F respectively. */
00077   uint32_t InjectedNbrOfConversion;              /*!< Specifies the number of ranks that will be converted within the injected group sequencer.
00078                                                       To use the injected group sequencer and convert several ranks, parameter 'ScanConvMode' must be enabled.
00079                                                       This parameter must be a number between Min_Data = 1 and Max_Data = 4.
00080                                                       Caution: this setting impacts the entire injected group. Therefore, call of HAL_ADCEx_InjectedConfigChannel() to 
00081                                                                configure a channel on injected group can impact the configuration of other channels previously set. */
00082   FunctionalState InjectedDiscontinuousConvMode; /*!< Specifies whether the conversions sequence of injected group is performed in Complete-sequence/Discontinuous-sequence (main sequence subdivided in successive parts).
00083                                                       Discontinuous mode is used only if sequencer is enabled (parameter 'ScanConvMode'). If sequencer is disabled, this parameter is discarded.
00084                                                       Discontinuous mode can be enabled only if continuous mode is disabled. If continuous mode is enabled, this parameter setting is discarded.
00085                                                       This parameter can be set to ENABLE or DISABLE.
00086                                                       Note: For injected group, number of discontinuous ranks increment is fixed to one-by-one.
00087                                                       Caution: this setting impacts the entire injected group. Therefore, call of HAL_ADCEx_InjectedConfigChannel() to 
00088                                                                configure a channel on injected group can impact the configuration of other channels previously set. */
00089   FunctionalState AutoInjectedConv;              /*!< Enables or disables the selected ADC automatic injected group conversion after regular one
00090                                                       This parameter can be set to ENABLE or DISABLE.      
00091                                                       Note: To use Automatic injected conversion, discontinuous mode must be disabled ('DiscontinuousConvMode' and 'InjectedDiscontinuousConvMode' set to DISABLE)
00092                                                       Note: To use Automatic injected conversion, injected group external triggers must be disabled ('ExternalTrigInjecConv' set to ADC_SOFTWARE_START)
00093                                                       Note: In case of DMA used with regular group: if DMA configured in normal mode (single shot) JAUTO will be stopped upon DMA transfer complete.
00094                                                             To maintain JAUTO always enabled, DMA must be configured in circular mode.
00095                                                       Caution: this setting impacts the entire injected group. Therefore, call of HAL_ADCEx_InjectedConfigChannel() to
00096                                                                configure a channel on injected group can impact the configuration of other channels previously set. */
00097   uint32_t ExternalTrigInjecConv;                /*!< Selects the external event used to trigger the conversion start of injected group.
00098                                                       If set to ADC_INJECTED_SOFTWARE_START, external triggers are disabled.
00099                                                       If set to external trigger source, triggering is on event rising edge.
00100                                                       This parameter can be a value of @ref ADCEx_External_trigger_Source_Injected
00101                                                       Note: This parameter must be modified when ADC is disabled (before ADC start conversion or after ADC stop conversion).
00102                                                             If ADC is enabled, this parameter setting is bypassed without error reporting (as it can be the expected behaviour in case of another parameter update on the fly)
00103                                                       Caution: this setting impacts the entire injected group. Therefore, call of HAL_ADCEx_InjectedConfigChannel() to
00104                                                                configure a channel on injected group can impact the configuration of other channels previously set. */
00105   uint32_t ExternalTrigInjecConvEdge;            /*!< Selects the external trigger edge of injected group.
00106                                                       This parameter can be a value of @ref ADCEx_External_trigger_edge_Injected.
00107                                                       If trigger is set to ADC_INJECTED_SOFTWARE_START, this parameter is discarded.
00108                                                       Caution: this setting impacts the entire injected group. Therefore, call of HAL_ADCEx_InjectedConfigChannel() to 
00109                                                                configure a channel on injected group can impact the configuration of other channels previously set. */
00110 }ADC_InjectionConfTypeDef; 
00111 
00112 /** 
00113   * @brief ADC Configuration multi-mode structure definition  
00114   */ 
00115 typedef struct
00116 {
00117   uint32_t Mode;              /*!< Configures the ADC to operate in independent or multi mode. 
00118                                    This parameter can be a value of @ref ADCEx_Common_mode */
00119   uint32_t DMAAccessMode;     /*!< Configures the Direct memory access mode for multi ADC mode.
00120                                    This parameter can be a value of @ref ADCEx_Direct_memory_access_mode_for_multi_mode */
00121   uint32_t TwoSamplingDelay;  /*!< Configures the Delay between 2 sampling phases.
00122                                    This parameter can be a value of @ref ADC_delay_between_2_sampling_phases */
00123 }ADC_MultiModeTypeDef;
00124 
00125 /**
00126   * @}
00127   */
00128 
00129 /* Exported constants --------------------------------------------------------*/
00130 /** @defgroup ADCEx_Exported_Constants ADC Exported Constants
00131   * @{
00132   */
00133 
00134 /** @defgroup ADCEx_Common_mode ADC Common Mode
00135   * @{
00136   */ 
00137 #define ADC_MODE_INDEPENDENT                  0x00000000U
00138 #define ADC_DUALMODE_REGSIMULT_INJECSIMULT    ((uint32_t)ADC_CCR_MULTI_0)
00139 #define ADC_DUALMODE_REGSIMULT_ALTERTRIG      ((uint32_t)ADC_CCR_MULTI_1)
00140 #define ADC_DUALMODE_INJECSIMULT              ((uint32_t)(ADC_CCR_MULTI_2 | ADC_CCR_MULTI_0))
00141 #define ADC_DUALMODE_REGSIMULT                ((uint32_t)(ADC_CCR_MULTI_2 | ADC_CCR_MULTI_1))
00142 #define ADC_DUALMODE_INTERL                   ((uint32_t)(ADC_CCR_MULTI_2 | ADC_CCR_MULTI_1 | ADC_CCR_MULTI_0))
00143 #define ADC_DUALMODE_ALTERTRIG                ((uint32_t)(ADC_CCR_MULTI_3 | ADC_CCR_MULTI_0))
00144 #define ADC_TRIPLEMODE_REGSIMULT_INJECSIMULT  ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_0))
00145 #define ADC_TRIPLEMODE_REGSIMULT_AlterTrig    ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_1))
00146 #define ADC_TRIPLEMODE_INJECSIMULT            ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_2 | ADC_CCR_MULTI_0))
00147 #define ADC_TRIPLEMODE_REGSIMULT              ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_2 | ADC_CCR_MULTI_1))
00148 #define ADC_TRIPLEMODE_INTERL                 ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_2 | ADC_CCR_MULTI_1 | ADC_CCR_MULTI_0))
00149 #define ADC_TRIPLEMODE_ALTERTRIG              ((uint32_t)(ADC_CCR_MULTI_4 | ADC_CCR_MULTI_3 | ADC_CCR_MULTI_0))
00150 /**
00151   * @}
00152   */ 
00153 
00154 /** @defgroup ADCEx_Direct_memory_access_mode_for_multi_mode ADC Direct Memory Access Mode For Multi Mode
00155   * @{
00156   */ 
00157 #define ADC_DMAACCESSMODE_DISABLED  0x00000000U                /*!< DMA mode disabled */
00158 #define ADC_DMAACCESSMODE_1         ((uint32_t)ADC_CCR_DMA_0)  /*!< DMA mode 1 enabled (2 / 3 half-words one by one - 1 then 2 then 3)*/
00159 #define ADC_DMAACCESSMODE_2         ((uint32_t)ADC_CCR_DMA_1)  /*!< DMA mode 2 enabled (2 / 3 half-words by pairs - 2&1 then 1&3 then 3&2)*/
00160 #define ADC_DMAACCESSMODE_3         ((uint32_t)ADC_CCR_DMA)    /*!< DMA mode 3 enabled (2 / 3 bytes by pairs - 2&1 then 1&3 then 3&2) */
00161 /**
00162   * @}
00163   */ 
00164 
00165 /** @defgroup ADCEx_External_trigger_edge_Injected ADC External Trigger Edge Injected
00166   * @{
00167   */ 
00168 #define ADC_EXTERNALTRIGINJECCONVEDGE_NONE           0x00000000U
00169 #define ADC_EXTERNALTRIGINJECCONVEDGE_RISING         ((uint32_t)ADC_CR2_JEXTEN_0)
00170 #define ADC_EXTERNALTRIGINJECCONVEDGE_FALLING        ((uint32_t)ADC_CR2_JEXTEN_1)
00171 #define ADC_EXTERNALTRIGINJECCONVEDGE_RISINGFALLING  ((uint32_t)ADC_CR2_JEXTEN)
00172 /**
00173   * @}
00174   */ 
00175 
00176 /** @defgroup ADCEx_External_trigger_Source_Injected ADC External Trigger Source Injected
00177   * @{
00178   */ 
00179 #define ADC_EXTERNALTRIGINJECCONV_T1_CC4           0x00000000U
00180 #define ADC_EXTERNALTRIGINJECCONV_T1_TRGO          ((uint32_t)ADC_CR2_JEXTSEL_0)
00181 #define ADC_EXTERNALTRIGINJECCONV_T2_CC1           ((uint32_t)ADC_CR2_JEXTSEL_1)
00182 #define ADC_EXTERNALTRIGINJECCONV_T2_TRGO          ((uint32_t)(ADC_CR2_JEXTSEL_1 | ADC_CR2_JEXTSEL_0))
00183 #define ADC_EXTERNALTRIGINJECCONV_T3_CC2           ((uint32_t)ADC_CR2_JEXTSEL_2)
00184 #define ADC_EXTERNALTRIGINJECCONV_T3_CC4           ((uint32_t)(ADC_CR2_JEXTSEL_2 | ADC_CR2_JEXTSEL_0))
00185 #define ADC_EXTERNALTRIGINJECCONV_T4_CC1           ((uint32_t)(ADC_CR2_JEXTSEL_2 | ADC_CR2_JEXTSEL_1))
00186 #define ADC_EXTERNALTRIGINJECCONV_T4_CC2           ((uint32_t)(ADC_CR2_JEXTSEL_2 | ADC_CR2_JEXTSEL_1 | ADC_CR2_JEXTSEL_0))
00187 #define ADC_EXTERNALTRIGINJECCONV_T4_CC3           ((uint32_t)ADC_CR2_JEXTSEL_3)
00188 #define ADC_EXTERNALTRIGINJECCONV_T4_TRGO          ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_0))
00189 #define ADC_EXTERNALTRIGINJECCONV_T5_CC4           ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_1))
00190 #define ADC_EXTERNALTRIGINJECCONV_T5_TRGO          ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_1 | ADC_CR2_JEXTSEL_0))
00191 #define ADC_EXTERNALTRIGINJECCONV_T8_CC2           ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_2))
00192 #define ADC_EXTERNALTRIGINJECCONV_T8_CC3           ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_2 | ADC_CR2_JEXTSEL_0))
00193 #define ADC_EXTERNALTRIGINJECCONV_T8_CC4           ((uint32_t)(ADC_CR2_JEXTSEL_3 | ADC_CR2_JEXTSEL_2 | ADC_CR2_JEXTSEL_1))
00194 #define ADC_EXTERNALTRIGINJECCONV_EXT_IT15         ((uint32_t)ADC_CR2_JEXTSEL)
00195 #define ADC_INJECTED_SOFTWARE_START                ((uint32_t)ADC_CR2_JEXTSEL + 1U)
00196 /**
00197   * @}
00198   */ 
00199 
00200 /** @defgroup ADCEx_injected_rank ADC Injected Rank
00201   * @{
00202   */ 
00203 #define ADC_INJECTED_RANK_1    0x00000001U
00204 #define ADC_INJECTED_RANK_2    0x00000002U
00205 #define ADC_INJECTED_RANK_3    0x00000003U
00206 #define ADC_INJECTED_RANK_4    0x00000004U
00207 /**
00208   * @}
00209   */
00210 
00211 /** @defgroup ADCEx_channels  ADC Specific Channels
00212   * @{
00213   */
00214 #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx) || defined(STM32F417xx) || \
00215     defined(STM32F401xC) || defined(STM32F401xE) || defined(STM32F410Tx) || defined(STM32F410Cx) || \
00216     defined(STM32F410Rx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || \
00217     defined(STM32F412Cx)
00218 #define ADC_CHANNEL_TEMPSENSOR  ((uint32_t)ADC_CHANNEL_16)
00219 #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx || STM32F401xC || STM32F401xE || STM32F410xx || STM32F412Zx ||
00220           STM32F412Vx || STM32F412Rx || STM32F412Cx */
00221 
00222 #if defined(STM32F411xE) || defined(STM32F413xx) || defined(STM32F423xx) || defined(STM32F427xx) || defined(STM32F437xx) ||\
00223     defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx) 
00224 #define ADC_CHANNEL_DIFFERENCIATION_TEMPSENSOR_VBAT 0x10000000U /* Dummy bit for driver internal usage, not used in ADC channel setting registers CR1 or SQRx */
00225 #define ADC_CHANNEL_TEMPSENSOR  ((uint32_t)ADC_CHANNEL_18 | ADC_CHANNEL_DIFFERENCIATION_TEMPSENSOR_VBAT)
00226 #endif /* STM32F411xE || STM32F413xx || STM32F423xx || STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx || STM32F446xx || STM32F469xx || STM32F479xx */
00227 /**
00228   * @}
00229   */ 
00230 
00231 
00232 /**
00233   * @}
00234   */ 
00235 
00236 /* Exported macro ------------------------------------------------------------*/
00237 /** @defgroup ADC_Exported_Macros ADC Exported Macros
00238   * @{
00239   */
00240 #if defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx)|| defined(STM32F439xx)
00241 /**
00242   * @brief Disable internal path of ADC channel Vbat
00243   * @note  Use case of this macro:
00244   *        On devices STM32F42x and STM32F43x, ADC internal channels
00245   *        Vbat and VrefInt share the same internal path, only
00246   *        one of them can be enabled.This macro is to be used when ADC 
00247   *        channels Vbat and VrefInt are selected, and must be called 
00248   *        before starting conversion of ADC channel VrefInt in order 
00249   *        to disable ADC channel Vbat.
00250   * @retval None
00251   */
00252 #define __HAL_ADC_PATH_INTERNAL_VBAT_DISABLE() (ADC->CCR &= ~(ADC_CCR_VBATE))
00253 #endif /* STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx */
00254 /**
00255   * @}
00256   */ 
00257 
00258 /* Exported functions --------------------------------------------------------*/
00259 /** @addtogroup ADCEx_Exported_Functions
00260   * @{
00261   */
00262 
00263 /** @addtogroup ADCEx_Exported_Functions_Group1
00264   * @{
00265   */
00266 
00267 /* I/O operation functions ******************************************************/
00268 HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc);
00269 HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc);
00270 HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout);
00271 HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc);
00272 HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc);
00273 uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank);
00274 HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length);
00275 HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA(ADC_HandleTypeDef* hadc);
00276 uint32_t HAL_ADCEx_MultiModeGetValue(ADC_HandleTypeDef* hadc);
00277 void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc);
00278 
00279 /* Peripheral Control functions *************************************************/
00280 HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc,ADC_InjectionConfTypeDef* sConfigInjected);
00281 HAL_StatusTypeDef HAL_ADCEx_MultiModeConfigChannel(ADC_HandleTypeDef* hadc, ADC_MultiModeTypeDef* multimode);
00282 
00283 /**
00284   * @}
00285   */ 
00286 
00287 /**
00288   * @}
00289   */
00290 /* Private types -------------------------------------------------------------*/
00291 /* Private variables ---------------------------------------------------------*/
00292 /* Private constants ---------------------------------------------------------*/
00293 /** @defgroup ADCEx_Private_Constants ADC Private Constants
00294   * @{
00295   */
00296 
00297 /**
00298   * @}
00299   */
00300 
00301 /* Private macros ------------------------------------------------------------*/
00302 /** @defgroup ADCEx_Private_Macros ADC Private Macros
00303   * @{
00304   */
00305 #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx) || defined(STM32F417xx) || \
00306     defined(STM32F401xC) || defined(STM32F401xE) || defined(STM32F410Tx) || defined(STM32F410Cx) || \
00307     defined(STM32F410Rx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || \
00308     defined(STM32F412Cx)
00309 #define IS_ADC_CHANNEL(CHANNEL) ((CHANNEL) <= ADC_CHANNEL_18)
00310 #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx || STM32F401xC || STM32F401xE ||
00311           STM32F410xx || STM32F412Zx || STM32F412Vx || STM32F412Rx || STM32F412Cx */
00312       
00313 #if defined(STM32F411xE) || defined(STM32F413xx) || defined(STM32F423xx) || defined(STM32F427xx) || \
00314     defined(STM32F437xx) || defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F446xx) || \
00315     defined(STM32F469xx) || defined(STM32F479xx)
00316 #define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) <= ADC_CHANNEL_18)  || \
00317                                  ((CHANNEL) == ADC_CHANNEL_TEMPSENSOR))
00318 #endif /* STM32F411xE || STM32F413xx || STM32F423xx || STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx || STM32F446xx || STM32F469xx || STM32F479xx */
00319 
00320 #define IS_ADC_MODE(MODE) (((MODE) == ADC_MODE_INDEPENDENT)                 || \
00321                            ((MODE) == ADC_DUALMODE_REGSIMULT_INJECSIMULT)   || \
00322                            ((MODE) == ADC_DUALMODE_REGSIMULT_ALTERTRIG)     || \
00323                            ((MODE) == ADC_DUALMODE_INJECSIMULT)             || \
00324                            ((MODE) == ADC_DUALMODE_REGSIMULT)               || \
00325                            ((MODE) == ADC_DUALMODE_INTERL)                  || \
00326                            ((MODE) == ADC_DUALMODE_ALTERTRIG)               || \
00327                            ((MODE) == ADC_TRIPLEMODE_REGSIMULT_INJECSIMULT) || \
00328                            ((MODE) == ADC_TRIPLEMODE_REGSIMULT_AlterTrig)   || \
00329                            ((MODE) == ADC_TRIPLEMODE_INJECSIMULT)           || \
00330                            ((MODE) == ADC_TRIPLEMODE_REGSIMULT)             || \
00331                            ((MODE) == ADC_TRIPLEMODE_INTERL)                || \
00332                            ((MODE) == ADC_TRIPLEMODE_ALTERTRIG))
00333 #define IS_ADC_DMA_ACCESS_MODE(MODE) (((MODE) == ADC_DMAACCESSMODE_DISABLED) || \
00334                                       ((MODE) == ADC_DMAACCESSMODE_1)        || \
00335                                       ((MODE) == ADC_DMAACCESSMODE_2)        || \
00336                                       ((MODE) == ADC_DMAACCESSMODE_3))
00337 #define IS_ADC_EXT_INJEC_TRIG_EDGE(EDGE) (((EDGE) == ADC_EXTERNALTRIGINJECCONVEDGE_NONE)    || \
00338                                           ((EDGE) == ADC_EXTERNALTRIGINJECCONVEDGE_RISING)  || \
00339                                           ((EDGE) == ADC_EXTERNALTRIGINJECCONVEDGE_FALLING) || \
00340                                           ((EDGE) == ADC_EXTERNALTRIGINJECCONVEDGE_RISINGFALLING))
00341 #define IS_ADC_EXT_INJEC_TRIG(INJTRIG) (((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T1_CC4)  || \
00342                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T1_TRGO) || \
00343                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T2_CC1)  || \
00344                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T2_TRGO) || \
00345                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T3_CC2)  || \
00346                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T3_CC4)  || \
00347                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T4_CC1)  || \
00348                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T4_CC2)  || \
00349                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T4_CC3)  || \
00350                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T4_TRGO) || \
00351                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T5_CC4)  || \
00352                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T5_TRGO) || \
00353                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T8_CC2)  || \
00354                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T8_CC3)  || \
00355                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_T8_CC4)  || \
00356                                         ((INJTRIG) == ADC_EXTERNALTRIGINJECCONV_EXT_IT15)|| \
00357                                         ((INJTRIG) == ADC_INJECTED_SOFTWARE_START))
00358 #define IS_ADC_INJECTED_LENGTH(LENGTH) (((LENGTH) >= 1U) && ((LENGTH) <= 4U))
00359 #define IS_ADC_INJECTED_RANK(RANK) (((RANK) >= 1U) && ((RANK) <= 4U))
00360 
00361 /**
00362   * @brief  Set the selected injected Channel rank.
00363   * @param  _CHANNELNB_ Channel number.
00364   * @param  _RANKNB_ Rank number. 
00365   * @param  _JSQR_JL_ Sequence length.
00366   * @retval None
00367   */
00368 #define   ADC_JSQR(_CHANNELNB_, _RANKNB_, _JSQR_JL_)  (((uint32_t)((uint16_t)(_CHANNELNB_))) << (5U * (uint8_t)(((_RANKNB_) + 3U) - (_JSQR_JL_))))
00369 
00370 /**
00371   * @brief Defines if the selected ADC is within ADC common register ADC123 or ADC1
00372   * if available (ADC2, ADC3 availability depends on STM32 product)
00373   * @param __HANDLE__ ADC handle
00374   * @retval Common control register ADC123 or ADC1
00375   */
00376 #if defined(STM32F405xx) || defined(STM32F407xx) || defined(STM32F415xx) || defined(STM32F417xx) || defined(STM32F427xx) || defined(STM32F429xx) || defined(STM32F437xx) || defined(STM32F439xx) || defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx)
00377 #define ADC_COMMON_REGISTER(__HANDLE__)                ADC123_COMMON
00378 #else
00379 #define ADC_COMMON_REGISTER(__HANDLE__)                ADC1_COMMON
00380 #endif /* STM32F405xx || STM32F407xx || STM32F415xx || STM32F417xx || STM32F427xx || STM32F429xx || STM32F437xx || STM32F439xx || STM32F446xx || STM32F469xx || STM32F479xx */
00381 /**
00382   * @}
00383   */
00384 
00385 /* Private functions ---------------------------------------------------------*/
00386 /** @defgroup ADCEx_Private_Functions ADC Private Functions
00387   * @{
00388   */
00389 
00390 /**
00391   * @}
00392   */
00393 
00394 /**
00395   * @}
00396   */ 
00397 
00398 /**
00399   * @}
00400   */
00401 
00402 #ifdef __cplusplus
00403 }
00404 #endif
00405 
00406 #endif /*__STM32F4xx_ADC_EX_H */
00407 
00408 
00409 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/