This file provides firmware functions to manage the following functionalities of the Analog to Digital Convertor (ADC) peripheral: More...
Include dependency graph for stm32f4xx_adc.c:
Go to the source code of this file.
Macros | |
| #define | CDR_ADDRESS ((uint32_t)0x40012308) |
| #define | CR1_AWDCH_RESET ((uint32_t)0xFFFFFFE0) |
| #define | CR1_AWDMode_RESET ((uint32_t)0xFF3FFDFF) |
| #define | CR1_CLEAR_MASK ((uint32_t)0xFCFFFEFF) |
| #define | CR1_DISCNUM_RESET ((uint32_t)0xFFFF1FFF) |
| #define | CR2_CLEAR_MASK ((uint32_t)0xC0FFF7FD) |
| #define | CR2_EXTEN_RESET ((uint32_t)0xCFFFFFFF) |
| #define | CR2_JEXTEN_RESET ((uint32_t)0xFFCFFFFF) |
| #define | CR2_JEXTSEL_RESET ((uint32_t)0xFFF0FFFF) |
| #define | CR_CLEAR_MASK ((uint32_t)0xFFFC30E0) |
| #define | JDR_OFFSET ((uint8_t)0x28) |
| #define | JSQR_JL_RESET ((uint32_t)0xFFCFFFFF) |
| #define | JSQR_JL_SET ((uint32_t)0x00300000) |
| #define | JSQR_JSQ_SET ((uint32_t)0x0000001F) |
| #define | SMPR1_SMP_SET ((uint32_t)0x00000007) |
| #define | SMPR2_SMP_SET ((uint32_t)0x00000007) |
| #define | SQR1_L_RESET ((uint32_t)0xFF0FFFFF) |
| #define | SQR1_SQ_SET ((uint32_t)0x0000001F) |
| #define | SQR2_SQ_SET ((uint32_t)0x0000001F) |
| #define | SQR3_SQ_SET ((uint32_t)0x0000001F) |
Functions | |
| void | ADC_AnalogWatchdogCmd (ADC_TypeDef *ADCx, uint32_t ADC_AnalogWatchdog) |
| Enables or disables the analog watchdog on single/all regular or injected channels. More... | |
| void | ADC_AnalogWatchdogSingleChannelConfig (ADC_TypeDef *ADCx, uint8_t ADC_Channel) |
| Configures the analog watchdog guarded single channel. More... | |
| void | ADC_AnalogWatchdogThresholdsConfig (ADC_TypeDef *ADCx, uint16_t HighThreshold, uint16_t LowThreshold) |
| Configures the high and low thresholds of the analog watchdog. More... | |
| void | ADC_AutoInjectedConvCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the selected ADC automatic injected group conversion after regular one. More... | |
| void | ADC_ClearFlag (ADC_TypeDef *ADCx, uint8_t ADC_FLAG) |
| Clears the ADCx's pending flags. More... | |
| void | ADC_ClearITPendingBit (ADC_TypeDef *ADCx, uint16_t ADC_IT) |
| Clears the ADCx's interrupt pending bits. More... | |
| void | ADC_Cmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the specified ADC peripheral. More... | |
| void | ADC_CommonInit (ADC_CommonInitTypeDef *ADC_CommonInitStruct) |
| Initializes the ADCs peripherals according to the specified parameters in the ADC_CommonInitStruct. More... | |
| void | ADC_CommonStructInit (ADC_CommonInitTypeDef *ADC_CommonInitStruct) |
| Fills each ADC_CommonInitStruct member with its default value. More... | |
| void | ADC_ContinuousModeCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the ADC continuous conversion mode. More... | |
| void | ADC_DeInit (void) |
| Deinitializes all ADCs peripherals registers to their default reset values. More... | |
| void | ADC_DiscModeChannelCountConfig (ADC_TypeDef *ADCx, uint8_t Number) |
| Configures the discontinuous mode for the selected ADC regular group channel. More... | |
| void | ADC_DiscModeCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the discontinuous mode on regular group channel for the specified ADC. More... | |
| void | ADC_DMACmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the specified ADC DMA request. More... | |
| void | ADC_DMARequestAfterLastTransferCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the ADC DMA request after last transfer (Single-ADC mode) More... | |
| void | ADC_EOCOnEachRegularChannelCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the EOC on each regular channel conversion. More... | |
| void | ADC_ExternalTrigInjectedConvConfig (ADC_TypeDef *ADCx, uint32_t ADC_ExternalTrigInjecConv) |
| Configures the ADCx external trigger for injected channels conversion. More... | |
| void | ADC_ExternalTrigInjectedConvEdgeConfig (ADC_TypeDef *ADCx, uint32_t ADC_ExternalTrigInjecConvEdge) |
| Configures the ADCx external trigger edge for injected channels conversion. More... | |
| uint16_t | ADC_GetConversionValue (ADC_TypeDef *ADCx) |
| Returns the last ADCx conversion result data for regular channel. More... | |
| FlagStatus | ADC_GetFlagStatus (ADC_TypeDef *ADCx, uint8_t ADC_FLAG) |
| Checks whether the specified ADC flag is set or not. More... | |
| uint16_t | ADC_GetInjectedConversionValue (ADC_TypeDef *ADCx, uint8_t ADC_InjectedChannel) |
| Returns the ADC injected channel conversion result. More... | |
| ITStatus | ADC_GetITStatus (ADC_TypeDef *ADCx, uint16_t ADC_IT) |
| Checks whether the specified ADC interrupt has occurred or not. More... | |
| uint32_t | ADC_GetMultiModeConversionValue (void) |
| Returns the last ADC1, ADC2 and ADC3 regular conversions results data in the selected multi mode. More... | |
| FlagStatus | ADC_GetSoftwareStartConvStatus (ADC_TypeDef *ADCx) |
| Gets the selected ADC Software start regular conversion Status. More... | |
| FlagStatus | ADC_GetSoftwareStartInjectedConvCmdStatus (ADC_TypeDef *ADCx) |
| Gets the selected ADC Software start injected conversion Status. More... | |
| void | ADC_Init (ADC_TypeDef *ADCx, ADC_InitTypeDef *ADC_InitStruct) |
| Initializes the ADCx peripheral according to the specified parameters in the ADC_InitStruct. More... | |
| void | ADC_InjectedChannelConfig (ADC_TypeDef *ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime) |
| Configures for the selected ADC injected channel its corresponding rank in the sequencer and its sample time. More... | |
| void | ADC_InjectedDiscModeCmd (ADC_TypeDef *ADCx, FunctionalState NewState) |
| Enables or disables the discontinuous mode for injected group channel for the specified ADC. More... | |
| void | ADC_InjectedSequencerLengthConfig (ADC_TypeDef *ADCx, uint8_t Length) |
| Configures the sequencer length for injected channels. More... | |
| void | ADC_ITConfig (ADC_TypeDef *ADCx, uint16_t ADC_IT, FunctionalState NewState) |
| Enables or disables the specified ADC interrupts. More... | |
| void | ADC_MultiModeDMARequestAfterLastTransferCmd (FunctionalState NewState) |
| Enables or disables the ADC DMA request after last transfer in multi ADC mode. More... | |
| void | ADC_RegularChannelConfig (ADC_TypeDef *ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime) |
| Configures for the selected ADC regular channel its corresponding rank in the sequencer and its sample time. More... | |
| void | ADC_SetInjectedOffset (ADC_TypeDef *ADCx, uint8_t ADC_InjectedChannel, uint16_t Offset) |
| Set the injected channels conversion value offset. More... | |
| void | ADC_SoftwareStartConv (ADC_TypeDef *ADCx) |
| Enables the selected ADC software start conversion of the regular channels. More... | |
| void | ADC_SoftwareStartInjectedConv (ADC_TypeDef *ADCx) |
| Enables the selected ADC software start conversion of the injected channels. More... | |
| void | ADC_StructInit (ADC_InitTypeDef *ADC_InitStruct) |
| Fills each ADC_InitStruct member with its default value. More... | |
| void | ADC_TempSensorVrefintCmd (FunctionalState NewState) |
| Enables or disables the temperature sensor and Vrefint channels. More... | |
| void | ADC_VBATCmd (FunctionalState NewState) |
| Enables or disables the VBAT (Voltage Battery) channel. More... | |
Detailed Description
This file provides firmware functions to manage the following functionalities of the Analog to Digital Convertor (ADC) peripheral:
- Version
- V1.1.0
- Date
- 11-January-2013
- Initialization and Configuration (in addition to ADC multi mode selection)
- Analog Watchdog configuration
- Temperature Sensor & Vrefint (Voltage Reference internal) & VBAT management
- Regular Channels Configuration
- Regular Channels DMA Configuration
- Injected channels Configuration
- Interrupts and flags management
===============================================================================
##### How to use this driver #####
===============================================================================
[..]
(#) Enable the ADC interface clock using
RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADCx, ENABLE);
(#) ADC pins configuration
(++) Enable the clock for the ADC GPIOs using the following function:
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE);
(++) Configure these ADC pins in analog mode using GPIO_Init();
(#) Configure the ADC Prescaler, conversion resolution and data
alignment using the ADC_Init() function.
(#) Activate the ADC peripheral using ADC_Cmd() function.
*** Regular channels group configuration ***
============================================
[..]
(+) To configure the ADC regular channels group features, use
ADC_Init() and ADC_RegularChannelConfig() functions.
(+) To activate the continuous mode, use the ADC_continuousModeCmd()
function.
(+) To configurate and activate the Discontinuous mode, use the
ADC_DiscModeChannelCountConfig() and ADC_DiscModeCmd() functions.
(+) To read the ADC converted values, use the ADC_GetConversionValue()
function.
*** Multi mode ADCs Regular channels configuration ***
======================================================
[..]
(+) Refer to "Regular channels group configuration" description to
configure the ADC1, ADC2 and ADC3 regular channels.
(+) Select the Multi mode ADC regular channels features (dual or
triple mode) using ADC_CommonInit() function and configure
the DMA mode using ADC_MultiModeDMARequestAfterLastTransferCmd()
functions.
(+) Read the ADCs converted values using the
ADC_GetMultiModeConversionValue() function.
*** DMA for Regular channels group features configuration ***
=============================================================
[..]
(+) To enable the DMA mode for regular channels group, use the
ADC_DMACmd() function.
(+) To enable the generation of DMA requests continuously at the end
of the last DMA transfer, use the ADC_DMARequestAfterLastTransferCmd()
function.
*** Injected channels group configuration ***
=============================================
[..]
(+) To configure the ADC Injected channels group features, use
ADC_InjectedChannelConfig() and ADC_InjectedSequencerLengthConfig()
functions.
(+) To activate the continuous mode, use the ADC_continuousModeCmd()
function.
(+) To activate the Injected Discontinuous mode, use the
ADC_InjectedDiscModeCmd() function.
(+) To activate the AutoInjected mode, use the ADC_AutoInjectedConvCmd()
function.
(+) To read the ADC converted values, use the ADC_GetInjectedConversionValue()
function.- Attention
© COPYRIGHT 2013 STMicroelectronics
Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at:
http://www.st.com/software_license_agreement_liberty_v2
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Definition in file stm32f4xx_adc.c.