shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_adc.c@87:085cde657901, 2014-02-08 (annotated)

Committer:
mbed_official
Date:
Sat Feb 08 19:45:06 2014 +0000
Revision:
87:085cde657901
Child:
106:ced8cbb51063
Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2



Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/



Add NUCLEO_F401RE, improvements

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /**
mbed_official 87:085cde657901 2 ******************************************************************************
mbed_official 87:085cde657901 3 * @file stm32f4xx_hal_adc.c
mbed_official 87:085cde657901 4 * @author MCD Application Team
mbed_official 87:085cde657901 5 * @version V1.0.0RC2
mbed_official 87:085cde657901 6 * @date 04-February-2014
mbed_official 87:085cde657901 7 * @brief This file provides firmware functions to manage the following
mbed_official 87:085cde657901 8 * functionalities of the Analog to Digital Convertor (ADC) peripheral:
mbed_official 87:085cde657901 9 * + Initialization and de-initialization functions
mbed_official 87:085cde657901 10 * + IO operation functions
mbed_official 87:085cde657901 11 * + State and errors functions
mbed_official 87:085cde657901 12 *
mbed_official 87:085cde657901 13 @verbatim
mbed_official 87:085cde657901 14 ==============================================================================
mbed_official 87:085cde657901 15 ##### ADC Peripheral features #####
mbed_official 87:085cde657901 16 ==============================================================================
mbed_official 87:085cde657901 17 [..]
mbed_official 87:085cde657901 18 (#) 12-bit, 10-bit, 8-bit or 6-bit configurable resolution.
mbed_official 87:085cde657901 19 (#) Interrupt generation at the end of conversion, end of injected conversion,
mbed_official 87:085cde657901 20 and in case of analog watchdog or overrun events
mbed_official 87:085cde657901 21 (#) Single and continuous conversion modes.
mbed_official 87:085cde657901 22 (#) Scan mode for automatic conversion of channel 0 to channel x.
mbed_official 87:085cde657901 23 (#) Data alignment with in-built data coherency.
mbed_official 87:085cde657901 24 (#) Channel-wise programmable sampling time.
mbed_official 87:085cde657901 25 (#) External trigger option with configurable polarity for both regular and
mbed_official 87:085cde657901 26 injected conversion.
mbed_official 87:085cde657901 27 (#) Dual/Triple mode (on devices with 2 ADCs or more).
mbed_official 87:085cde657901 28 (#) Configurable DMA data storage in Dual/Triple ADC mode.
mbed_official 87:085cde657901 29 (#) Configurable delay between conversions in Dual/Triple interleaved mode.
mbed_official 87:085cde657901 30 (#) ADC conversion type (refer to the datasheets).
mbed_official 87:085cde657901 31 (#) ADC supply requirements: 2.4 V to 3.6 V at full speed and down to 1.8 V at
mbed_official 87:085cde657901 32 slower speed.
mbed_official 87:085cde657901 33 (#) ADC input range: VREF(minus) = VIN = VREF(plus).
mbed_official 87:085cde657901 34 (#) DMA request generation during regular channel conversion.
mbed_official 87:085cde657901 35
mbed_official 87:085cde657901 36
mbed_official 87:085cde657901 37 ##### How to use this driver #####
mbed_official 87:085cde657901 38 ==============================================================================
mbed_official 87:085cde657901 39 [..]
mbed_official 87:085cde657901 40 (#)Initialize the ADC low level resources by implementing the HAL_ADC_MspInit():
mbed_official 87:085cde657901 41 (##) Enable the ADC interface clock using __ADC_CLK_ENABLE()
mbed_official 87:085cde657901 42 (##) ADC pins configuration
mbed_official 87:085cde657901 43 (+++) Enable the clock for the ADC GPIOs using the following function:
mbed_official 87:085cde657901 44 __GPIOx_CLK_ENABLE()
mbed_official 87:085cde657901 45 (+++) Configure these ADC pins in analog mode using HAL_GPIO_Init()
mbed_official 87:085cde657901 46 (##) In case of using interrupts (e.g. HAL_ADC_Start_IT())
mbed_official 87:085cde657901 47 (+++) Configure the ADC interrupt priority using HAL_NVIC_SetPriority()
mbed_official 87:085cde657901 48 (+++) Enable the ADC IRQ handler using HAL_NVIC_EnableIRQ()
mbed_official 87:085cde657901 49 (+++) In ADC IRQ handler, call HAL_ADC_IRQHandler()
mbed_official 87:085cde657901 50 (##) In case of using DMA to control data transfer (e.g. HAL_ADC_Start_DMA())
mbed_official 87:085cde657901 51 (+++) Enable the DMAx interface clock using __DMAx_CLK_ENABLE()
mbed_official 87:085cde657901 52 (+++) Configure and enable two DMA streams stream for managing data
mbed_official 87:085cde657901 53 transfer from peripheral to memory (output stream)
mbed_official 87:085cde657901 54 (+++) Associate the initilalized DMA handle to the CRYP DMA handle
mbed_official 87:085cde657901 55 using __HAL_LINKDMA()
mbed_official 87:085cde657901 56 (+++) Configure the priority and enable the NVIC for the transfer complete
mbed_official 87:085cde657901 57 interrupt on the two DMA Streams. The output stream should have higher
mbed_official 87:085cde657901 58 priority than the input stream.
mbed_official 87:085cde657901 59
mbed_official 87:085cde657901 60 (#) Configure the ADC Prescaler, conversion resolution and data alignment
mbed_official 87:085cde657901 61 using the HAL_ADC_Init() function.
mbed_official 87:085cde657901 62
mbed_official 87:085cde657901 63 (#) Configure the ADC regular channels group features, use HAL_ADC_Init()
mbed_official 87:085cde657901 64 and HAL_ADC_ConfigChannel() functions.
mbed_official 87:085cde657901 65
mbed_official 87:085cde657901 66 (#) Three mode of operations are available within this driver :
mbed_official 87:085cde657901 67
mbed_official 87:085cde657901 68 *** Polling mode IO operation ***
mbed_official 87:085cde657901 69 =================================
mbed_official 87:085cde657901 70 [..]
mbed_official 87:085cde657901 71 (+) Start the ADC peripheral using HAL_ADC_Start()
mbed_official 87:085cde657901 72 (+) Wait for end of conversion using HAL_ADC_PollForConversion(), at this stage
mbed_official 87:085cde657901 73 user can specify the value of timeout according to his end application
mbed_official 87:085cde657901 74 (+) To read the ADC converted values, use the HAL_ADC_GetValue() function.
mbed_official 87:085cde657901 75 (+) Stop the ADC peripheral using HAL_ADC_Stop()
mbed_official 87:085cde657901 76
mbed_official 87:085cde657901 77 *** Interrupt mode IO operation ***
mbed_official 87:085cde657901 78 ===================================
mbed_official 87:085cde657901 79 [..]
mbed_official 87:085cde657901 80 (+) Start the ADC peripheral using HAL_ADC_Start_IT()
mbed_official 87:085cde657901 81 (+) Use HAL_ADC_IRQHandler() called under ADC_IRQHandler() Interrupt subroutine
mbed_official 87:085cde657901 82 (+) At ADC end of conversion HAL_ADC_ConvCpltCallback() function is executed and user can
mbed_official 87:085cde657901 83 add his own code by customization of function pointer HAL_ADC_ConvCpltCallback
mbed_official 87:085cde657901 84 (+) In case of ADC Error, HAL_ADC_ErrorCallback() function is executed and user can
mbed_official 87:085cde657901 85 add his own code by customization of function pointer HAL_ADC_ErrorCallback
mbed_official 87:085cde657901 86 (+) Stop the ADC peripheral using HAL_ADC_Stop_IT()
mbed_official 87:085cde657901 87
mbed_official 87:085cde657901 88 *** DMA mode IO operation ***
mbed_official 87:085cde657901 89 ==============================
mbed_official 87:085cde657901 90 [..]
mbed_official 87:085cde657901 91 (+) Start the ADC peripheral using HAL_ADC_Start_DMA(), at this stage the user specify the length
mbed_official 87:085cde657901 92 of data to be transfered at each end of conversion
mbed_official 87:085cde657901 93 (+) At The end of data transfer by HAL_ADC_ConvCpltCallback() function is executed and user can
mbed_official 87:085cde657901 94 add his own code by customization of function pointer HAL_ADC_ConvCpltCallback
mbed_official 87:085cde657901 95 (+) In case of transfer Error, HAL_ADC_ErrorCallback() function is executed and user can
mbed_official 87:085cde657901 96 add his own code by customization of function pointer HAL_ADC_ErrorCallback
mbed_official 87:085cde657901 97 (+) Stop the ADC peripheral using HAL_ADC_Stop_DMA()
mbed_official 87:085cde657901 98
mbed_official 87:085cde657901 99 *** ADC HAL driver macros list ***
mbed_official 87:085cde657901 100 =============================================
mbed_official 87:085cde657901 101 [..]
mbed_official 87:085cde657901 102 Below the list of most used macros in ADC HAL driver.
mbed_official 87:085cde657901 103
mbed_official 87:085cde657901 104 (+) __HAL_ADC_ENABLE : Enable the ADC peripheral
mbed_official 87:085cde657901 105 (+) __HAL_ADC_DISABLE : Disable the ADC peripheral
mbed_official 87:085cde657901 106 (+) __HAL_ADC_ENABLE_IT: Enable the ADC end of conversion interrupt
mbed_official 87:085cde657901 107 (+) __HAL_ADC_DISABLE_IT: Disable the ADC end of conversion interrupt
mbed_official 87:085cde657901 108 (+) __HAL_ADC_GET_IT_SOURCE: Check if the specified ADC interrupt source is enabled or disabled
mbed_official 87:085cde657901 109 (+) __HAL_ADC_CLEAR_FLAG: Clear the ADC's pending flags
mbed_official 87:085cde657901 110 (+) __HAL_ADC_GET_FLAG: Get the selected ADC's flag status
mbed_official 87:085cde657901 111 (+) __HAL_ADC_GET_RESOLUTION: Return resolution bits in CR1 register
mbed_official 87:085cde657901 112
mbed_official 87:085cde657901 113 [..]
mbed_official 87:085cde657901 114 (@) You can refer to the ADC HAL driver header file for more useful macros
mbed_official 87:085cde657901 115
mbed_official 87:085cde657901 116 @endverbatim
mbed_official 87:085cde657901 117 ******************************************************************************
mbed_official 87:085cde657901 118 * @attention
mbed_official 87:085cde657901 119 *
mbed_official 87:085cde657901 120 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 87:085cde657901 121 *
mbed_official 87:085cde657901 122 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 87:085cde657901 123 * are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 124 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 125 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 126 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 127 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 128 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 129 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 130 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 131 * without specific prior written permission.
mbed_official 87:085cde657901 132 *
mbed_official 87:085cde657901 133 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 134 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 135 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 136 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 137 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 138 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 139 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 140 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 141 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 142 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 143 *
mbed_official 87:085cde657901 144 ******************************************************************************
mbed_official 87:085cde657901 145 */
mbed_official 87:085cde657901 146
mbed_official 87:085cde657901 147 /* Includes ------------------------------------------------------------------*/
mbed_official 87:085cde657901 148 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 149
mbed_official 87:085cde657901 150 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 87:085cde657901 151 * @{
mbed_official 87:085cde657901 152 */
mbed_official 87:085cde657901 153
mbed_official 87:085cde657901 154 /** @defgroup ADC
mbed_official 87:085cde657901 155 * @brief ADC driver modules
mbed_official 87:085cde657901 156 * @{
mbed_official 87:085cde657901 157 */
mbed_official 87:085cde657901 158
mbed_official 87:085cde657901 159 #ifdef HAL_ADC_MODULE_ENABLED
mbed_official 87:085cde657901 160
mbed_official 87:085cde657901 161 /* Private typedef -----------------------------------------------------------*/
mbed_official 87:085cde657901 162 /* Private define ------------------------------------------------------------*/
mbed_official 87:085cde657901 163 /* Private macro -------------------------------------------------------------*/
mbed_official 87:085cde657901 164 /* Private variables ---------------------------------------------------------*/
mbed_official 87:085cde657901 165 /* Private function prototypes -----------------------------------------------*/
mbed_official 87:085cde657901 166 static void ADC_Init(ADC_HandleTypeDef* hadc);
mbed_official 87:085cde657901 167 static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 168 static void ADC_DMAError(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 169 static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 170 /* Private functions ---------------------------------------------------------*/
mbed_official 87:085cde657901 171
mbed_official 87:085cde657901 172 /** @defgroup ADC_Private_Functions
mbed_official 87:085cde657901 173 * @{
mbed_official 87:085cde657901 174 */
mbed_official 87:085cde657901 175
mbed_official 87:085cde657901 176 /** @defgroup ADC_Group1 Initialization and de-initialization functions
mbed_official 87:085cde657901 177 * @brief Initialization and Configuration functions
mbed_official 87:085cde657901 178 *
mbed_official 87:085cde657901 179 @verbatim
mbed_official 87:085cde657901 180 ===============================================================================
mbed_official 87:085cde657901 181 ##### Initialization and de-initialization functions #####
mbed_official 87:085cde657901 182 ===============================================================================
mbed_official 87:085cde657901 183 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 184 (+) Initialize and configure the ADC.
mbed_official 87:085cde657901 185 (+) De-initialize the ADC.
mbed_official 87:085cde657901 186
mbed_official 87:085cde657901 187 @endverbatim
mbed_official 87:085cde657901 188 * @{
mbed_official 87:085cde657901 189 */
mbed_official 87:085cde657901 190
mbed_official 87:085cde657901 191 /**
mbed_official 87:085cde657901 192 * @brief Initializes the ADCx peripheral according to the specified parameters
mbed_official 87:085cde657901 193 * in the ADC_InitStruct and initializes the ADC MSP.
mbed_official 87:085cde657901 194 *
mbed_official 87:085cde657901 195 * @note This function is used to configure the global features of the ADC (
mbed_official 87:085cde657901 196 * ClockPrescaler, Resolution, Data Alignment and number of conversion), however,
mbed_official 87:085cde657901 197 * the rest of the configuration parameters are specific to the regular
mbed_official 87:085cde657901 198 * channels group (scan mode activation, continuous mode activation,
mbed_official 87:085cde657901 199 * External trigger source and edge, DMA continuous request after the
mbed_official 87:085cde657901 200 * last transfer and End of conversion selection).
mbed_official 87:085cde657901 201 *
mbed_official 87:085cde657901 202 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 203 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 204 * @retval HAL status
mbed_official 87:085cde657901 205 */
mbed_official 87:085cde657901 206 HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 207 {
mbed_official 87:085cde657901 208 /* Check ADC handle */
mbed_official 87:085cde657901 209 if(hadc == NULL)
mbed_official 87:085cde657901 210 {
mbed_official 87:085cde657901 211 return HAL_ERROR;
mbed_official 87:085cde657901 212 }
mbed_official 87:085cde657901 213
mbed_official 87:085cde657901 214 /* Check the parameters */
mbed_official 87:085cde657901 215 assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));
mbed_official 87:085cde657901 216 assert_param(IS_ADC_CLOCKPRESCALER(hadc->Init.ClockPrescaler));
mbed_official 87:085cde657901 217 assert_param(IS_ADC_RESOLUTION(hadc->Init.Resolution));
mbed_official 87:085cde657901 218 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ScanConvMode));
mbed_official 87:085cde657901 219 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 220 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 221 assert_param(IS_ADC_EXT_TRIG(hadc->Init.ExternalTrigConv));
mbed_official 87:085cde657901 222 assert_param(IS_ADC_DATA_ALIGN(hadc->Init.DataAlign));
mbed_official 87:085cde657901 223 assert_param(IS_ADC_REGULAR_LENGTH(hadc->Init.NbrOfConversion));
mbed_official 87:085cde657901 224 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.DMAContinuousRequests));
mbed_official 87:085cde657901 225 assert_param(IS_ADC_EOCSelection(hadc->Init.EOCSelection));
mbed_official 87:085cde657901 226 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.DiscontinuousConvMode));
mbed_official 87:085cde657901 227
mbed_official 87:085cde657901 228 if(hadc->State == HAL_ADC_STATE_RESET)
mbed_official 87:085cde657901 229 {
mbed_official 87:085cde657901 230 /* Init the low level hardware */
mbed_official 87:085cde657901 231 HAL_ADC_MspInit(hadc);
mbed_official 87:085cde657901 232 }
mbed_official 87:085cde657901 233
mbed_official 87:085cde657901 234 /* Initialize the ADC state */
mbed_official 87:085cde657901 235 hadc->State = HAL_ADC_STATE_BUSY;
mbed_official 87:085cde657901 236
mbed_official 87:085cde657901 237 /* Set ADC parameters */
mbed_official 87:085cde657901 238 ADC_Init(hadc);
mbed_official 87:085cde657901 239
mbed_official 87:085cde657901 240 /* Set ADC error code to none */
mbed_official 87:085cde657901 241 hadc->ErrorCode = HAL_ADC_ERROR_NONE;
mbed_official 87:085cde657901 242
mbed_official 87:085cde657901 243 /* Initialize the ADC state */
mbed_official 87:085cde657901 244 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 245
mbed_official 87:085cde657901 246 /* Return function status */
mbed_official 87:085cde657901 247 return HAL_OK;
mbed_official 87:085cde657901 248 }
mbed_official 87:085cde657901 249
mbed_official 87:085cde657901 250 /**
mbed_official 87:085cde657901 251 * @brief Deinitializes the ADCx peripheral registers to their default reset values.
mbed_official 87:085cde657901 252 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 253 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 254 * @retval HAL status
mbed_official 87:085cde657901 255 */
mbed_official 87:085cde657901 256 HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 257 {
mbed_official 87:085cde657901 258 /* Check ADC handle */
mbed_official 87:085cde657901 259 if(hadc == NULL)
mbed_official 87:085cde657901 260 {
mbed_official 87:085cde657901 261 return HAL_ERROR;
mbed_official 87:085cde657901 262 }
mbed_official 87:085cde657901 263
mbed_official 87:085cde657901 264 /* Check the parameters */
mbed_official 87:085cde657901 265 assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));
mbed_official 87:085cde657901 266
mbed_official 87:085cde657901 267 /* Change ADC state */
mbed_official 87:085cde657901 268 hadc->State = HAL_ADC_STATE_BUSY;
mbed_official 87:085cde657901 269
mbed_official 87:085cde657901 270 /* DeInit the low level hardware */
mbed_official 87:085cde657901 271 HAL_ADC_MspDeInit(hadc);
mbed_official 87:085cde657901 272
mbed_official 87:085cde657901 273 /* Set ADC error code to none */
mbed_official 87:085cde657901 274 hadc->ErrorCode = HAL_ADC_ERROR_NONE;
mbed_official 87:085cde657901 275
mbed_official 87:085cde657901 276 /* Change ADC state */
mbed_official 87:085cde657901 277 hadc->State = HAL_ADC_STATE_RESET;
mbed_official 87:085cde657901 278
mbed_official 87:085cde657901 279 /* Return function status */
mbed_official 87:085cde657901 280 return HAL_OK;
mbed_official 87:085cde657901 281 }
mbed_official 87:085cde657901 282
mbed_official 87:085cde657901 283 /**
mbed_official 87:085cde657901 284 * @brief Initializes the ADC MSP.
mbed_official 87:085cde657901 285 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 286 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 287 * @retval None
mbed_official 87:085cde657901 288 */
mbed_official 87:085cde657901 289 __weak void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 290 {
mbed_official 87:085cde657901 291 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 292 the HAL_ADC_MspInit could be implemented in the user file
mbed_official 87:085cde657901 293 */
mbed_official 87:085cde657901 294 }
mbed_official 87:085cde657901 295
mbed_official 87:085cde657901 296 /**
mbed_official 87:085cde657901 297 * @brief DeInitializes the ADC MSP.
mbed_official 87:085cde657901 298 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 299 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 300 * @retval None
mbed_official 87:085cde657901 301 */
mbed_official 87:085cde657901 302 __weak void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 303 {
mbed_official 87:085cde657901 304 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 305 the HAL_ADC_MspDeInit could be implemented in the user file
mbed_official 87:085cde657901 306 */
mbed_official 87:085cde657901 307 }
mbed_official 87:085cde657901 308
mbed_official 87:085cde657901 309 /**
mbed_official 87:085cde657901 310 * @}
mbed_official 87:085cde657901 311 */
mbed_official 87:085cde657901 312
mbed_official 87:085cde657901 313 /** @defgroup ADC_Group2 IO operation functions
mbed_official 87:085cde657901 314 * @brief IO operation functions
mbed_official 87:085cde657901 315 *
mbed_official 87:085cde657901 316 @verbatim
mbed_official 87:085cde657901 317 ===============================================================================
mbed_official 87:085cde657901 318 ##### IO operation functions #####
mbed_official 87:085cde657901 319 ===============================================================================
mbed_official 87:085cde657901 320 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 321 (+) Start conversion of regular channel.
mbed_official 87:085cde657901 322 (+) Stop conversion of regular channel.
mbed_official 87:085cde657901 323 (+) Start conversion of regular channel and enable interrupt.
mbed_official 87:085cde657901 324 (+) Stop conversion of regular channel and disable interrupt.
mbed_official 87:085cde657901 325 (+) Start conversion of regular channel and enable DMA transfer.
mbed_official 87:085cde657901 326 (+) Stop conversion of regular channel and disable DMA transfer.
mbed_official 87:085cde657901 327 (+) Handle ADC interrupt request.
mbed_official 87:085cde657901 328
mbed_official 87:085cde657901 329 @endverbatim
mbed_official 87:085cde657901 330 * @{
mbed_official 87:085cde657901 331 */
mbed_official 87:085cde657901 332
mbed_official 87:085cde657901 333 /**
mbed_official 87:085cde657901 334 * @brief Enables ADC and starts conversion of the regular channels.
mbed_official 87:085cde657901 335 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 336 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 337 * @retval HAL status
mbed_official 87:085cde657901 338 */
mbed_official 87:085cde657901 339 HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 340 {
mbed_official 87:085cde657901 341 uint16_t i = 0;
mbed_official 87:085cde657901 342
mbed_official 87:085cde657901 343 /* Check the parameters */
mbed_official 87:085cde657901 344 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 345 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 346
mbed_official 87:085cde657901 347 /* Process locked */
mbed_official 87:085cde657901 348 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 349
mbed_official 87:085cde657901 350 /* Check if an injected conversion is ongoing */
mbed_official 87:085cde657901 351 if(hadc->State == HAL_ADC_STATE_BUSY_INJ)
mbed_official 87:085cde657901 352 {
mbed_official 87:085cde657901 353 /* Change ADC state */
mbed_official 87:085cde657901 354 hadc->State = HAL_ADC_STATE_BUSY_INJ_REG;
mbed_official 87:085cde657901 355 }
mbed_official 87:085cde657901 356 else
mbed_official 87:085cde657901 357 {
mbed_official 87:085cde657901 358 /* Change ADC state */
mbed_official 87:085cde657901 359 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 360 }
mbed_official 87:085cde657901 361
mbed_official 87:085cde657901 362 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 363 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 364 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 365 {
mbed_official 87:085cde657901 366 /* Enable the Peripheral */
mbed_official 87:085cde657901 367 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 368
mbed_official 87:085cde657901 369 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 370 for(; i <= 540; i++)
mbed_official 87:085cde657901 371 {
mbed_official 87:085cde657901 372 __NOP();
mbed_official 87:085cde657901 373 }
mbed_official 87:085cde657901 374 }
mbed_official 87:085cde657901 375
mbed_official 87:085cde657901 376 /* Check if Multimode enabled */
mbed_official 87:085cde657901 377 if(HAL_IS_BIT_CLR(ADC->CCR, ADC_CCR_MULTI))
mbed_official 87:085cde657901 378 {
mbed_official 87:085cde657901 379 /* if no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 380 if(hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 381 {
mbed_official 87:085cde657901 382 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 383 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 384 }
mbed_official 87:085cde657901 385 }
mbed_official 87:085cde657901 386 else
mbed_official 87:085cde657901 387 {
mbed_official 87:085cde657901 388 /* if instance of handle correspond to ADC1 and no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 389 if((hadc->Instance == ADC1) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 390 {
mbed_official 87:085cde657901 391 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 392 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 393 }
mbed_official 87:085cde657901 394 }
mbed_official 87:085cde657901 395
mbed_official 87:085cde657901 396 /* Process unlocked */
mbed_official 87:085cde657901 397 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 398
mbed_official 87:085cde657901 399 /* Return function status */
mbed_official 87:085cde657901 400 return HAL_OK;
mbed_official 87:085cde657901 401 }
mbed_official 87:085cde657901 402
mbed_official 87:085cde657901 403 /**
mbed_official 87:085cde657901 404 * @brief Disables ADC and stop conversion of regular channels.
mbed_official 87:085cde657901 405 *
mbed_official 87:085cde657901 406 * @note Caution: This function will stop also injected channels.
mbed_official 87:085cde657901 407 *
mbed_official 87:085cde657901 408 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 409 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 410 * last transfer and End of conversion selection).
mbed_official 87:085cde657901 411 * @retval HAL status.
mbed_official 87:085cde657901 412 */
mbed_official 87:085cde657901 413 HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 414 {
mbed_official 87:085cde657901 415 /* Disable the Peripheral */
mbed_official 87:085cde657901 416 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 417
mbed_official 87:085cde657901 418 /* Change ADC state */
mbed_official 87:085cde657901 419 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 420
mbed_official 87:085cde657901 421 /* Return function status */
mbed_official 87:085cde657901 422 return HAL_OK;
mbed_official 87:085cde657901 423 }
mbed_official 87:085cde657901 424
mbed_official 87:085cde657901 425 /**
mbed_official 87:085cde657901 426 * @brief Poll for regular conversion complete
mbed_official 87:085cde657901 427 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 428 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 429 * @param Timeout: Timeout value in millisecond.
mbed_official 87:085cde657901 430 * @retval HAL status
mbed_official 87:085cde657901 431 */
mbed_official 87:085cde657901 432 HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout)
mbed_official 87:085cde657901 433 {
mbed_official 87:085cde657901 434 uint32_t timeout;
mbed_official 87:085cde657901 435
mbed_official 87:085cde657901 436 /* Get timeout */
mbed_official 87:085cde657901 437 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 438
mbed_official 87:085cde657901 439 /* Check End of conversion flag */
mbed_official 87:085cde657901 440 while(!(__HAL_ADC_GET_FLAG(hadc, ADC_FLAG_EOC)))
mbed_official 87:085cde657901 441 {
mbed_official 87:085cde657901 442 /* Check for the Timeout */
mbed_official 87:085cde657901 443 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 444 {
mbed_official 87:085cde657901 445 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 446 {
mbed_official 87:085cde657901 447 hadc->State= HAL_ADC_STATE_TIMEOUT;
mbed_official 87:085cde657901 448 /* Process unlocked */
mbed_official 87:085cde657901 449 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 450 return HAL_TIMEOUT;
mbed_official 87:085cde657901 451 }
mbed_official 87:085cde657901 452 }
mbed_official 87:085cde657901 453 }
mbed_official 87:085cde657901 454
mbed_official 87:085cde657901 455 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 456 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 457 {
mbed_official 87:085cde657901 458 /* Change ADC state */
mbed_official 87:085cde657901 459 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 460 }
mbed_official 87:085cde657901 461 else
mbed_official 87:085cde657901 462 {
mbed_official 87:085cde657901 463 /* Change ADC state */
mbed_official 87:085cde657901 464 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 465 }
mbed_official 87:085cde657901 466
mbed_official 87:085cde657901 467 /* Return ADC state */
mbed_official 87:085cde657901 468 return HAL_OK;
mbed_official 87:085cde657901 469 }
mbed_official 87:085cde657901 470
mbed_official 87:085cde657901 471 /**
mbed_official 87:085cde657901 472 * @brief Poll for conversion event
mbed_official 87:085cde657901 473 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 474 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 475 * @param EventType: the ADC event type.
mbed_official 87:085cde657901 476 * This parameter can be one of the following values:
mbed_official 87:085cde657901 477 * @arg AWD_EVENT: ADC Analog watch Dog event.
mbed_official 87:085cde657901 478 * @arg OVR_EVENT: ADC Overrun event.
mbed_official 87:085cde657901 479 * @param Timeout: Timeout value in millisecond.
mbed_official 87:085cde657901 480 * @retval HAL status
mbed_official 87:085cde657901 481 */
mbed_official 87:085cde657901 482 HAL_StatusTypeDef HAL_ADC_PollForEvent(ADC_HandleTypeDef* hadc, uint32_t EventType, uint32_t Timeout)
mbed_official 87:085cde657901 483 {
mbed_official 87:085cde657901 484 /* Check the parameters */
mbed_official 87:085cde657901 485 assert_param(IS_ADC_EVENT_TYPE(EventType));
mbed_official 87:085cde657901 486
mbed_official 87:085cde657901 487 uint32_t timeout;
mbed_official 87:085cde657901 488
mbed_official 87:085cde657901 489 /* Get timeout */
mbed_official 87:085cde657901 490 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 491
mbed_official 87:085cde657901 492 /* Check selected event flag */
mbed_official 87:085cde657901 493 while(!(__HAL_ADC_GET_FLAG(hadc,EventType)))
mbed_official 87:085cde657901 494 {
mbed_official 87:085cde657901 495 /* Check for the Timeout */
mbed_official 87:085cde657901 496 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 497 {
mbed_official 87:085cde657901 498 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 499 {
mbed_official 87:085cde657901 500 hadc->State= HAL_ADC_STATE_TIMEOUT;
mbed_official 87:085cde657901 501 /* Process unlocked */
mbed_official 87:085cde657901 502 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 503 return HAL_TIMEOUT;
mbed_official 87:085cde657901 504 }
mbed_official 87:085cde657901 505 }
mbed_official 87:085cde657901 506 }
mbed_official 87:085cde657901 507
mbed_official 87:085cde657901 508 /* Check analog watchdog flag */
mbed_official 87:085cde657901 509 if(EventType == AWD_EVENT)
mbed_official 87:085cde657901 510 {
mbed_official 87:085cde657901 511 /* Change ADC state */
mbed_official 87:085cde657901 512 hadc->State = HAL_ADC_STATE_AWD;
mbed_official 87:085cde657901 513
mbed_official 87:085cde657901 514 /* Clear the ADCx's analog watchdog flag */
mbed_official 87:085cde657901 515 __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_AWD);
mbed_official 87:085cde657901 516 }
mbed_official 87:085cde657901 517 else
mbed_official 87:085cde657901 518 {
mbed_official 87:085cde657901 519 /* Change ADC state */
mbed_official 87:085cde657901 520 hadc->State = HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 521
mbed_official 87:085cde657901 522 /* Clear the ADCx's Overrun flag */
mbed_official 87:085cde657901 523 __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_OVR);
mbed_official 87:085cde657901 524 }
mbed_official 87:085cde657901 525
mbed_official 87:085cde657901 526 /* Return ADC state */
mbed_official 87:085cde657901 527 return HAL_OK;
mbed_official 87:085cde657901 528 }
mbed_official 87:085cde657901 529
mbed_official 87:085cde657901 530
mbed_official 87:085cde657901 531 /**
mbed_official 87:085cde657901 532 * @brief Enables the interrupt and starts ADC conversion of regular channels.
mbed_official 87:085cde657901 533 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 534 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 535 * @retval HAL status.
mbed_official 87:085cde657901 536 */
mbed_official 87:085cde657901 537 HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 538 {
mbed_official 87:085cde657901 539 uint16_t i = 0;
mbed_official 87:085cde657901 540
mbed_official 87:085cde657901 541 /* Check the parameters */
mbed_official 87:085cde657901 542 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 543 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 544
mbed_official 87:085cde657901 545 /* Process locked */
mbed_official 87:085cde657901 546 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 547
mbed_official 87:085cde657901 548 /* Check if an injected conversion is ongoing */
mbed_official 87:085cde657901 549 if(hadc->State == HAL_ADC_STATE_BUSY_INJ)
mbed_official 87:085cde657901 550 {
mbed_official 87:085cde657901 551 /* Change ADC state */
mbed_official 87:085cde657901 552 hadc->State = HAL_ADC_STATE_BUSY_INJ_REG;
mbed_official 87:085cde657901 553 }
mbed_official 87:085cde657901 554 else
mbed_official 87:085cde657901 555 {
mbed_official 87:085cde657901 556 /* Change ADC state */
mbed_official 87:085cde657901 557 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 558 }
mbed_official 87:085cde657901 559
mbed_official 87:085cde657901 560 /* Set ADC error code to none */
mbed_official 87:085cde657901 561 hadc->ErrorCode = HAL_ADC_ERROR_NONE;
mbed_official 87:085cde657901 562
mbed_official 87:085cde657901 563 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 564 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 565 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 566 {
mbed_official 87:085cde657901 567 /* Enable the Peripheral */
mbed_official 87:085cde657901 568 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 569
mbed_official 87:085cde657901 570 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 571 for(; i <= 540; i++)
mbed_official 87:085cde657901 572 {
mbed_official 87:085cde657901 573 __NOP();
mbed_official 87:085cde657901 574 }
mbed_official 87:085cde657901 575 }
mbed_official 87:085cde657901 576
mbed_official 87:085cde657901 577 /* Enable the ADC overrun interrupt */
mbed_official 87:085cde657901 578 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 579
mbed_official 87:085cde657901 580 /* Enable the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 581 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 582
mbed_official 87:085cde657901 583 /* Check if Multimode enabled */
mbed_official 87:085cde657901 584 if(HAL_IS_BIT_CLR(ADC->CCR, ADC_CCR_MULTI))
mbed_official 87:085cde657901 585 {
mbed_official 87:085cde657901 586 /* if no externel trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 587 if (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 588 {
mbed_official 87:085cde657901 589 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 590 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 591 }
mbed_official 87:085cde657901 592 }
mbed_official 87:085cde657901 593 else
mbed_official 87:085cde657901 594 {
mbed_official 87:085cde657901 595 /* if instance of handle correspond to ADC1 and no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 596 if ((hadc->Instance == (ADC_TypeDef*)0x40012000) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 597 {
mbed_official 87:085cde657901 598 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 599 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 600 }
mbed_official 87:085cde657901 601 }
mbed_official 87:085cde657901 602
mbed_official 87:085cde657901 603 /* Process unlocked */
mbed_official 87:085cde657901 604 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 605
mbed_official 87:085cde657901 606 /* Return function status */
mbed_official 87:085cde657901 607 return HAL_OK;
mbed_official 87:085cde657901 608 }
mbed_official 87:085cde657901 609
mbed_official 87:085cde657901 610 /**
mbed_official 87:085cde657901 611 * @brief Disables the interrupt and stop ADC conversion of regular channels.
mbed_official 87:085cde657901 612 *
mbed_official 87:085cde657901 613 * @note Caution: This function will stop also injected channels.
mbed_official 87:085cde657901 614 *
mbed_official 87:085cde657901 615 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 616 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 617 * @retval HAL status.
mbed_official 87:085cde657901 618 */
mbed_official 87:085cde657901 619 HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 620 {
mbed_official 87:085cde657901 621 /* Disable the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 622 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 623
mbed_official 87:085cde657901 624 /* Disable the ADC end of conversion interrupt for injected group */
mbed_official 87:085cde657901 625 __HAL_ADC_DISABLE_IT(hadc, ADC_CR1_JEOCIE);
mbed_official 87:085cde657901 626
mbed_official 87:085cde657901 627 /* Enable the Periphral */
mbed_official 87:085cde657901 628 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 629
mbed_official 87:085cde657901 630 /* Change ADC state */
mbed_official 87:085cde657901 631 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 632
mbed_official 87:085cde657901 633 /* Return function status */
mbed_official 87:085cde657901 634 return HAL_OK;
mbed_official 87:085cde657901 635 }
mbed_official 87:085cde657901 636
mbed_official 87:085cde657901 637 /**
mbed_official 87:085cde657901 638 * @brief Handles ADC interrupt request
mbed_official 87:085cde657901 639 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 640 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 641 * @retval None
mbed_official 87:085cde657901 642 */
mbed_official 87:085cde657901 643 void HAL_ADC_IRQHandler(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 644 {
mbed_official 87:085cde657901 645 uint32_t tmp1 = 0, tmp2 = 0;
mbed_official 87:085cde657901 646
mbed_official 87:085cde657901 647 /* Check the parameters */
mbed_official 87:085cde657901 648 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 649 assert_param(IS_ADC_REGULAR_LENGTH(hadc->Init.NbrOfConversion));
mbed_official 87:085cde657901 650 assert_param(IS_ADC_EOCSelection(hadc->Init.EOCSelection));
mbed_official 87:085cde657901 651
mbed_official 87:085cde657901 652 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_EOC);
mbed_official 87:085cde657901 653 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 654 /* Check End of conversion flag for regular channels */
mbed_official 87:085cde657901 655 if(tmp1 && tmp2)
mbed_official 87:085cde657901 656 {
mbed_official 87:085cde657901 657 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 658 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 659 {
mbed_official 87:085cde657901 660 /* Change ADC state */
mbed_official 87:085cde657901 661 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 662 }
mbed_official 87:085cde657901 663 else
mbed_official 87:085cde657901 664 {
mbed_official 87:085cde657901 665 /* Change ADC state */
mbed_official 87:085cde657901 666 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 667 }
mbed_official 87:085cde657901 668
mbed_official 87:085cde657901 669 if((hadc->Init.ContinuousConvMode == DISABLE) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 670 {
mbed_official 87:085cde657901 671 if(hadc->Init.EOCSelection == EOC_SEQ_CONV)
mbed_official 87:085cde657901 672 {
mbed_official 87:085cde657901 673 /* DISABLE the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 674 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 675
mbed_official 87:085cde657901 676 /* DISABLE the ADC overrun interrupt */
mbed_official 87:085cde657901 677 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 678 }
mbed_official 87:085cde657901 679 else
mbed_official 87:085cde657901 680 {
mbed_official 87:085cde657901 681 if (hadc->NbrOfCurrentConversionRank == 0)
mbed_official 87:085cde657901 682 {
mbed_official 87:085cde657901 683 hadc->NbrOfCurrentConversionRank = hadc->Init.NbrOfConversion;
mbed_official 87:085cde657901 684 }
mbed_official 87:085cde657901 685
mbed_official 87:085cde657901 686 /* Decrement the number of conversion when an interrupt occurs */
mbed_official 87:085cde657901 687 hadc->NbrOfCurrentConversionRank--;
mbed_official 87:085cde657901 688
mbed_official 87:085cde657901 689 /* Check if all conversions are finished */
mbed_official 87:085cde657901 690 if(hadc->NbrOfCurrentConversionRank == 0)
mbed_official 87:085cde657901 691 {
mbed_official 87:085cde657901 692 /* DISABLE the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 693 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 694
mbed_official 87:085cde657901 695 /* DISABLE the ADC overrun interrupt */
mbed_official 87:085cde657901 696 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 697 }
mbed_official 87:085cde657901 698 }
mbed_official 87:085cde657901 699 }
mbed_official 87:085cde657901 700
mbed_official 87:085cde657901 701 /* Conversion complete callback */
mbed_official 87:085cde657901 702 HAL_ADC_ConvCpltCallback(hadc);
mbed_official 87:085cde657901 703
mbed_official 87:085cde657901 704 /* Clear the ADCx flag for regular end of conversion */
mbed_official 87:085cde657901 705 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_EOC);
mbed_official 87:085cde657901 706 }
mbed_official 87:085cde657901 707
mbed_official 87:085cde657901 708 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_JEOC);
mbed_official 87:085cde657901 709 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_JEOC);
mbed_official 87:085cde657901 710 /* Check End of conversion flag for injected channels */
mbed_official 87:085cde657901 711 if(tmp1 && tmp2)
mbed_official 87:085cde657901 712 {
mbed_official 87:085cde657901 713 /* Check if a regular conversion is ready */
mbed_official 87:085cde657901 714 if(hadc->State == HAL_ADC_STATE_EOC_REG)
mbed_official 87:085cde657901 715 {
mbed_official 87:085cde657901 716 /* Change ADC state */
mbed_official 87:085cde657901 717 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 718 }
mbed_official 87:085cde657901 719 else
mbed_official 87:085cde657901 720 {
mbed_official 87:085cde657901 721 /* Change ADC state */
mbed_official 87:085cde657901 722 hadc->State = HAL_ADC_STATE_EOC_INJ;
mbed_official 87:085cde657901 723 }
mbed_official 87:085cde657901 724
mbed_official 87:085cde657901 725 tmp1 = HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO);
mbed_official 87:085cde657901 726 tmp2 = HAL_IS_BIT_CLR(hadc->Instance->CR2, ADC_CR2_JEXTEN);
mbed_official 87:085cde657901 727 if(((hadc->Init.ContinuousConvMode == DISABLE) || tmp1) && tmp2)
mbed_official 87:085cde657901 728 {
mbed_official 87:085cde657901 729 /* DISABLE the ADC end of conversion interrupt for injected group */
mbed_official 87:085cde657901 730 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC);
mbed_official 87:085cde657901 731 }
mbed_official 87:085cde657901 732
mbed_official 87:085cde657901 733 /* Conversion complete callback */
mbed_official 87:085cde657901 734 HAL_ADCEx_InjectedConvCpltCallback(hadc);
mbed_official 87:085cde657901 735
mbed_official 87:085cde657901 736 /* Clear the ADCx flag for injected end of conversion */
mbed_official 87:085cde657901 737 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_JEOC);
mbed_official 87:085cde657901 738 }
mbed_official 87:085cde657901 739
mbed_official 87:085cde657901 740 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_AWD);
mbed_official 87:085cde657901 741 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 742 /* Check Analog watchdog flag */
mbed_official 87:085cde657901 743 if(tmp1 && tmp2)
mbed_official 87:085cde657901 744 {
mbed_official 87:085cde657901 745 /* Change ADC state */
mbed_official 87:085cde657901 746 hadc->State = HAL_ADC_STATE_AWD;
mbed_official 87:085cde657901 747
mbed_official 87:085cde657901 748 /* Clear the ADCx's Analog watchdog flag */
mbed_official 87:085cde657901 749 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_AWD);
mbed_official 87:085cde657901 750
mbed_official 87:085cde657901 751 /* Level out of window callback */
mbed_official 87:085cde657901 752 HAL_ADC_LevelOutOfWindowCallback(hadc);
mbed_official 87:085cde657901 753 }
mbed_official 87:085cde657901 754
mbed_official 87:085cde657901 755 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_OVR);
mbed_official 87:085cde657901 756 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 757 /* Check Overrun flag */
mbed_official 87:085cde657901 758 if(tmp1 && tmp2)
mbed_official 87:085cde657901 759 {
mbed_official 87:085cde657901 760 /* Change ADC state to overrun state */
mbed_official 87:085cde657901 761 hadc->State = HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 762
mbed_official 87:085cde657901 763 /* Set ADC error code to overrun */
mbed_official 87:085cde657901 764 hadc->ErrorCode |= HAL_ADC_ERROR_OVR;
mbed_official 87:085cde657901 765
mbed_official 87:085cde657901 766 /* Clear the Overrun flag */
mbed_official 87:085cde657901 767 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_OVR);
mbed_official 87:085cde657901 768
mbed_official 87:085cde657901 769 /* Error callback */
mbed_official 87:085cde657901 770 HAL_ADC_ErrorCallback(hadc);
mbed_official 87:085cde657901 771 }
mbed_official 87:085cde657901 772 }
mbed_official 87:085cde657901 773
mbed_official 87:085cde657901 774 /**
mbed_official 87:085cde657901 775 * @brief Enables ADC DMA request after last transfer (Single-ADC mode) and enables ADC peripheral
mbed_official 87:085cde657901 776 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 777 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 778 * @param pData: The destination Buffer address.
mbed_official 87:085cde657901 779 * @param Length: The length of data to be transferred from ADC peripheral to memory.
mbed_official 87:085cde657901 780 * @retval None
mbed_official 87:085cde657901 781 */
mbed_official 87:085cde657901 782 HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length)
mbed_official 87:085cde657901 783 {
mbed_official 87:085cde657901 784 uint16_t i = 0;
mbed_official 87:085cde657901 785
mbed_official 87:085cde657901 786 /* Check the parameters */
mbed_official 87:085cde657901 787 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 788 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 789
mbed_official 87:085cde657901 790 /* Process locked */
mbed_official 87:085cde657901 791 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 792
mbed_official 87:085cde657901 793 /* Enable ADC overrun interrupt */
mbed_official 87:085cde657901 794 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 795
mbed_official 87:085cde657901 796 /* Enable ADC DMA mode */
mbed_official 87:085cde657901 797 hadc->Instance->CR2 |= ADC_CR2_DMA;
mbed_official 87:085cde657901 798
mbed_official 87:085cde657901 799 /* Set the DMA transfer complete callback */
mbed_official 87:085cde657901 800 hadc->DMA_Handle->XferCpltCallback = ADC_DMAConvCplt;
mbed_official 87:085cde657901 801
mbed_official 87:085cde657901 802 /* Set the DMA half transfer complete callback */
mbed_official 87:085cde657901 803 hadc->DMA_Handle->XferHalfCpltCallback = ADC_DMAHalfConvCplt;
mbed_official 87:085cde657901 804
mbed_official 87:085cde657901 805 /* Set the DMA error callback */
mbed_official 87:085cde657901 806 hadc->DMA_Handle->XferErrorCallback = ADC_DMAError ;
mbed_official 87:085cde657901 807
mbed_official 87:085cde657901 808 /* Enable the DMA Stream */
mbed_official 87:085cde657901 809 HAL_DMA_Start_IT(hadc->DMA_Handle, (uint32_t)&hadc->Instance->DR, (uint32_t)pData, Length);
mbed_official 87:085cde657901 810
mbed_official 87:085cde657901 811 /* Change ADC state */
mbed_official 87:085cde657901 812 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 813
mbed_official 87:085cde657901 814 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 815 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 816 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 817 {
mbed_official 87:085cde657901 818 /* Enable the Peripheral */
mbed_official 87:085cde657901 819 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 820
mbed_official 87:085cde657901 821 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 822 for(; i <= 540; i++)
mbed_official 87:085cde657901 823 {
mbed_official 87:085cde657901 824 __NOP();
mbed_official 87:085cde657901 825 }
mbed_official 87:085cde657901 826 }
mbed_official 87:085cde657901 827
mbed_official 87:085cde657901 828 /* if no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 829 if (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 830 {
mbed_official 87:085cde657901 831 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 832 hadc->Instance->CR2 |= ADC_CR2_SWSTART;
mbed_official 87:085cde657901 833 }
mbed_official 87:085cde657901 834
mbed_official 87:085cde657901 835 /* Process unlocked */
mbed_official 87:085cde657901 836 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 837
mbed_official 87:085cde657901 838 /* Return function status */
mbed_official 87:085cde657901 839 return HAL_OK;
mbed_official 87:085cde657901 840 }
mbed_official 87:085cde657901 841
mbed_official 87:085cde657901 842 /**
mbed_official 87:085cde657901 843 * @brief Disables ADC DMA (Single-ADC mode) and disables ADC peripheral
mbed_official 87:085cde657901 844 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 845 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 846 * @retval None
mbed_official 87:085cde657901 847 */
mbed_official 87:085cde657901 848 HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 849 {
mbed_official 87:085cde657901 850 /* Disable the Periphral */
mbed_official 87:085cde657901 851 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 852
mbed_official 87:085cde657901 853 /* Disable ADC overrun interrupt */
mbed_official 87:085cde657901 854 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 855
mbed_official 87:085cde657901 856 /* Disable the selected ADC DMA mode */
mbed_official 87:085cde657901 857 hadc->Instance->CR2 &= ~ADC_CR2_DMA;
mbed_official 87:085cde657901 858
mbed_official 87:085cde657901 859 /* Disable the ADC DMA Stream */
mbed_official 87:085cde657901 860 HAL_DMA_Abort(hadc->DMA_Handle);
mbed_official 87:085cde657901 861
mbed_official 87:085cde657901 862 /* Change ADC state */
mbed_official 87:085cde657901 863 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 864
mbed_official 87:085cde657901 865 /* Return function status */
mbed_official 87:085cde657901 866 return HAL_OK;
mbed_official 87:085cde657901 867 }
mbed_official 87:085cde657901 868
mbed_official 87:085cde657901 869 /**
mbed_official 87:085cde657901 870 * @brief Gets the converted value from data register of regular channel.
mbed_official 87:085cde657901 871 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 872 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 873 * @retval Converted value
mbed_official 87:085cde657901 874 */
mbed_official 87:085cde657901 875 uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 876 {
mbed_official 87:085cde657901 877 /* Return the selected ADC converted value */
mbed_official 87:085cde657901 878 return hadc->Instance->DR;
mbed_official 87:085cde657901 879 }
mbed_official 87:085cde657901 880
mbed_official 87:085cde657901 881 /**
mbed_official 87:085cde657901 882 * @brief Regular conversion complete callback in non blocking mode
mbed_official 87:085cde657901 883 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 884 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 885 * @retval None
mbed_official 87:085cde657901 886 */
mbed_official 87:085cde657901 887 __weak void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 888 {
mbed_official 87:085cde657901 889 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 890 the HAL_ADC_ConvCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 891 */
mbed_official 87:085cde657901 892 }
mbed_official 87:085cde657901 893
mbed_official 87:085cde657901 894 /**
mbed_official 87:085cde657901 895 * @brief Regular conversion half DMA transfer callback in non blocking mode
mbed_official 87:085cde657901 896 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 897 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 898 * @retval None
mbed_official 87:085cde657901 899 */
mbed_official 87:085cde657901 900 __weak void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 901 {
mbed_official 87:085cde657901 902 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 903 the HAL_ADC_ConvHalfCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 904 */
mbed_official 87:085cde657901 905 }
mbed_official 87:085cde657901 906
mbed_official 87:085cde657901 907 /**
mbed_official 87:085cde657901 908 * @brief Analog watchdog callback in non blocking mode
mbed_official 87:085cde657901 909 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 910 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 911 * @retval None
mbed_official 87:085cde657901 912 */
mbed_official 87:085cde657901 913 __weak void HAL_ADC_LevelOutOfWindowCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 914 {
mbed_official 87:085cde657901 915 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 916 the HAL_ADC_LevelOoutOfWindowCallback could be implemented in the user file
mbed_official 87:085cde657901 917 */
mbed_official 87:085cde657901 918 }
mbed_official 87:085cde657901 919
mbed_official 87:085cde657901 920 /**
mbed_official 87:085cde657901 921 * @brief Error ADC callback.
mbed_official 87:085cde657901 922 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 923 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 924 * @retval None
mbed_official 87:085cde657901 925 */
mbed_official 87:085cde657901 926 __weak void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc)
mbed_official 87:085cde657901 927 {
mbed_official 87:085cde657901 928 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 929 the HAL_ADC_ErrorCallback could be implemented in the user file
mbed_official 87:085cde657901 930 */
mbed_official 87:085cde657901 931 }
mbed_official 87:085cde657901 932
mbed_official 87:085cde657901 933 /**
mbed_official 87:085cde657901 934 * @}
mbed_official 87:085cde657901 935 */
mbed_official 87:085cde657901 936
mbed_official 87:085cde657901 937 /** @defgroup ADC_Group3 Peripheral Control functions
mbed_official 87:085cde657901 938 * @brief Peripheral Control functions
mbed_official 87:085cde657901 939 *
mbed_official 87:085cde657901 940 @verbatim
mbed_official 87:085cde657901 941 ===============================================================================
mbed_official 87:085cde657901 942 ##### Peripheral Control functions #####
mbed_official 87:085cde657901 943 ===============================================================================
mbed_official 87:085cde657901 944 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 945 (+) Configure regular channels.
mbed_official 87:085cde657901 946 (+) Configure injected channels.
mbed_official 87:085cde657901 947 (+) Configure multimode.
mbed_official 87:085cde657901 948 (+) Configure the analog watch dog.
mbed_official 87:085cde657901 949
mbed_official 87:085cde657901 950 @endverbatim
mbed_official 87:085cde657901 951 * @{
mbed_official 87:085cde657901 952 */
mbed_official 87:085cde657901 953
mbed_official 87:085cde657901 954 /**
mbed_official 87:085cde657901 955 * @brief Configures for the selected ADC regular channel its corresponding
mbed_official 87:085cde657901 956 * rank in the sequencer and its sample time.
mbed_official 87:085cde657901 957 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 958 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 959 * @param sConfig: ADC configuration structure.
mbed_official 87:085cde657901 960 * @retval HAL status
mbed_official 87:085cde657901 961 */
mbed_official 87:085cde657901 962 HAL_StatusTypeDef HAL_ADC_ConfigChannel(ADC_HandleTypeDef* hadc, ADC_ChannelConfTypeDef* sConfig)
mbed_official 87:085cde657901 963 {
mbed_official 87:085cde657901 964 /* Check the parameters */
mbed_official 87:085cde657901 965 assert_param(IS_ADC_CHANNEL(sConfig->Channel));
mbed_official 87:085cde657901 966 assert_param(IS_ADC_REGULAR_RANK(sConfig->Rank));
mbed_official 87:085cde657901 967 assert_param(IS_ADC_SAMPLE_TIME(sConfig->SamplingTime));
mbed_official 87:085cde657901 968
mbed_official 87:085cde657901 969 /* Process locked */
mbed_official 87:085cde657901 970 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 971
mbed_official 87:085cde657901 972 /* if ADC_Channel_10 ... ADC_Channel_18 is selected */
mbed_official 87:085cde657901 973 if (sConfig->Channel > ADC_CHANNEL_9)
mbed_official 87:085cde657901 974 {
mbed_official 87:085cde657901 975 /* Clear the old sample time */
mbed_official 87:085cde657901 976 hadc->Instance->SMPR1 &= ~__HAL_ADC_SMPR1(ADC_SMPR1_SMP10, sConfig->Channel);
mbed_official 87:085cde657901 977
mbed_official 87:085cde657901 978 /* Set the new sample time */
mbed_official 87:085cde657901 979 hadc->Instance->SMPR1 |= __HAL_ADC_SMPR1(sConfig->SamplingTime, sConfig->Channel);
mbed_official 87:085cde657901 980 }
mbed_official 87:085cde657901 981 else /* ADC_Channel include in ADC_Channel_[0..9] */
mbed_official 87:085cde657901 982 {
mbed_official 87:085cde657901 983 /* Clear the old sample time */
mbed_official 87:085cde657901 984 hadc->Instance->SMPR2 &= ~__HAL_ADC_SMPR2(ADC_SMPR2_SMP0, sConfig->Channel);
mbed_official 87:085cde657901 985
mbed_official 87:085cde657901 986 /* Set the new sample time */
mbed_official 87:085cde657901 987 hadc->Instance->SMPR2 |= __HAL_ADC_SMPR2(sConfig->SamplingTime, sConfig->Channel);
mbed_official 87:085cde657901 988 }
mbed_official 87:085cde657901 989
mbed_official 87:085cde657901 990 /* For Rank 1 to 6 */
mbed_official 87:085cde657901 991 if (sConfig->Rank < 7)
mbed_official 87:085cde657901 992 {
mbed_official 87:085cde657901 993 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 994 hadc->Instance->SQR3 &= ~__HAL_ADC_SQR3_RK(ADC_SQR3_SQ1, sConfig->Rank);
mbed_official 87:085cde657901 995
mbed_official 87:085cde657901 996 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 997 hadc->Instance->SQR3 |= __HAL_ADC_SQR3_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 998 }
mbed_official 87:085cde657901 999 /* For Rank 7 to 12 */
mbed_official 87:085cde657901 1000 else if (sConfig->Rank < 13)
mbed_official 87:085cde657901 1001 {
mbed_official 87:085cde657901 1002 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 1003 hadc->Instance->SQR2 &= ~__HAL_ADC_SQR2_RK(ADC_SQR2_SQ7, sConfig->Rank);
mbed_official 87:085cde657901 1004
mbed_official 87:085cde657901 1005 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 1006 hadc->Instance->SQR2 |= __HAL_ADC_SQR2_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 1007 }
mbed_official 87:085cde657901 1008 /* For Rank 13 to 16 */
mbed_official 87:085cde657901 1009 else
mbed_official 87:085cde657901 1010 {
mbed_official 87:085cde657901 1011 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 1012 hadc->Instance->SQR1 &= ~__HAL_ADC_SQR1_RK(ADC_SQR1_SQ13, sConfig->Rank);
mbed_official 87:085cde657901 1013
mbed_official 87:085cde657901 1014 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 1015 hadc->Instance->SQR1 |= __HAL_ADC_SQR1_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 1016 }
mbed_official 87:085cde657901 1017
mbed_official 87:085cde657901 1018 /* if ADC1 Channel_18 is selected enable VBAT Channel */
mbed_official 87:085cde657901 1019 if ((hadc->Instance == ADC1) && (sConfig->Channel == ADC_CHANNEL_VBAT))
mbed_official 87:085cde657901 1020 {
mbed_official 87:085cde657901 1021 /* Enable the VBAT channel*/
mbed_official 87:085cde657901 1022 ADC->CCR |= ADC_CCR_VBATE;
mbed_official 87:085cde657901 1023 }
mbed_official 87:085cde657901 1024
mbed_official 87:085cde657901 1025 /* if ADC1 Channel_16 or Channel_17 is selected enable TSVREFE Channel(Temperature sensor and VREFINT) */
mbed_official 87:085cde657901 1026 if ((hadc->Instance == ADC1) && ((sConfig->Channel == ADC_CHANNEL_TEMPSENSOR) || (sConfig->Channel == ADC_CHANNEL_VREFINT)))
mbed_official 87:085cde657901 1027 {
mbed_official 87:085cde657901 1028 /* Enable the TSVREFE channel*/
mbed_official 87:085cde657901 1029 ADC->CCR |= ADC_CCR_TSVREFE;
mbed_official 87:085cde657901 1030 }
mbed_official 87:085cde657901 1031
mbed_official 87:085cde657901 1032 /* Process unlocked */
mbed_official 87:085cde657901 1033 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 1034
mbed_official 87:085cde657901 1035 /* Return function status */
mbed_official 87:085cde657901 1036 return HAL_OK;
mbed_official 87:085cde657901 1037 }
mbed_official 87:085cde657901 1038
mbed_official 87:085cde657901 1039 /**
mbed_official 87:085cde657901 1040 * @brief Configures the analog watchdog.
mbed_official 87:085cde657901 1041 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1042 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1043 * @param AnalogWDGConfig : pointer to an ADC_AnalogWDGConfTypeDef structure
mbed_official 87:085cde657901 1044 * that contains the configuration information of ADC analog watchdog.
mbed_official 87:085cde657901 1045 * @retval HAL status
mbed_official 87:085cde657901 1046 */
mbed_official 87:085cde657901 1047 HAL_StatusTypeDef HAL_ADC_AnalogWDGConfig(ADC_HandleTypeDef* hadc, ADC_AnalogWDGConfTypeDef* AnalogWDGConfig)
mbed_official 87:085cde657901 1048 {
mbed_official 87:085cde657901 1049 #ifdef USE_FULL_ASSERT
mbed_official 87:085cde657901 1050 uint32_t tmp = 0;
mbed_official 87:085cde657901 1051 #endif /* USE_FULL_ASSERT */
mbed_official 87:085cde657901 1052
mbed_official 87:085cde657901 1053 /* Check the parameters */
mbed_official 87:085cde657901 1054 assert_param(IS_ADC_ANALOG_WATCHDOG(AnalogWDGConfig->WatchdogMode));
mbed_official 87:085cde657901 1055 assert_param(IS_ADC_CHANNEL(AnalogWDGConfig->Channel));
mbed_official 87:085cde657901 1056 assert_param(IS_FUNCTIONAL_STATE(AnalogWDGConfig->ITMode));
mbed_official 87:085cde657901 1057
mbed_official 87:085cde657901 1058 #ifdef USE_FULL_ASSERT
mbed_official 87:085cde657901 1059 tmp = __HAL_ADC_GET_RESOLUTION(hadc);
mbed_official 87:085cde657901 1060 assert_param(IS_ADC_RANGE(tmp, AnalogWDGConfig->HighThreshold));
mbed_official 87:085cde657901 1061 assert_param(IS_ADC_RANGE(tmp, AnalogWDGConfig->LowThreshold));
mbed_official 87:085cde657901 1062 #endif /* USE_FULL_ASSERT */
mbed_official 87:085cde657901 1063
mbed_official 87:085cde657901 1064 /* Process locked */
mbed_official 87:085cde657901 1065 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 1066
mbed_official 87:085cde657901 1067 if(AnalogWDGConfig->ITMode == ENABLE)
mbed_official 87:085cde657901 1068 {
mbed_official 87:085cde657901 1069 /* Enable the ADC Analog watchdog interrupt */
mbed_official 87:085cde657901 1070 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 1071 }
mbed_official 87:085cde657901 1072 else
mbed_official 87:085cde657901 1073 {
mbed_official 87:085cde657901 1074 /* Disable the ADC Analog watchdog interrupt */
mbed_official 87:085cde657901 1075 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 1076 }
mbed_official 87:085cde657901 1077
mbed_official 87:085cde657901 1078 /* Clear AWDEN, JAWDEN and AWDSGL bits */
mbed_official 87:085cde657901 1079 hadc->Instance->CR1 &= ~(ADC_CR1_AWDSGL | ADC_CR1_JAWDEN | ADC_CR1_AWDEN);
mbed_official 87:085cde657901 1080
mbed_official 87:085cde657901 1081 /* Set the analog watchdog enable mode */
mbed_official 87:085cde657901 1082 hadc->Instance->CR1 |= AnalogWDGConfig->WatchdogMode;
mbed_official 87:085cde657901 1083
mbed_official 87:085cde657901 1084 /* Set the high threshold */
mbed_official 87:085cde657901 1085 hadc->Instance->HTR = AnalogWDGConfig->HighThreshold;
mbed_official 87:085cde657901 1086
mbed_official 87:085cde657901 1087 /* Set the low threshold */
mbed_official 87:085cde657901 1088 hadc->Instance->LTR = AnalogWDGConfig->LowThreshold;
mbed_official 87:085cde657901 1089
mbed_official 87:085cde657901 1090 /* Clear the Analog watchdog channel select bits */
mbed_official 87:085cde657901 1091 hadc->Instance->CR1 &= ~ADC_CR1_AWDCH;
mbed_official 87:085cde657901 1092
mbed_official 87:085cde657901 1093 /* Set the Analog watchdog channel */
mbed_official 87:085cde657901 1094 hadc->Instance->CR1 |= AnalogWDGConfig->Channel;
mbed_official 87:085cde657901 1095
mbed_official 87:085cde657901 1096 /* Process unlocked */
mbed_official 87:085cde657901 1097 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 1098
mbed_official 87:085cde657901 1099 /* Return function status */
mbed_official 87:085cde657901 1100 return HAL_OK;
mbed_official 87:085cde657901 1101 }
mbed_official 87:085cde657901 1102
mbed_official 87:085cde657901 1103 /**
mbed_official 87:085cde657901 1104 * @}
mbed_official 87:085cde657901 1105 */
mbed_official 87:085cde657901 1106
mbed_official 87:085cde657901 1107 /** @defgroup ADC_Group4 ADC Peripheral State functions
mbed_official 87:085cde657901 1108 * @brief ADC Peripheral State functions
mbed_official 87:085cde657901 1109 *
mbed_official 87:085cde657901 1110 @verbatim
mbed_official 87:085cde657901 1111 ===============================================================================
mbed_official 87:085cde657901 1112 ##### Peripheral State and errors functions #####
mbed_official 87:085cde657901 1113 ===============================================================================
mbed_official 87:085cde657901 1114 [..]
mbed_official 87:085cde657901 1115 This subsection provides functions allowing to
mbed_official 87:085cde657901 1116 (+) Check the ADC state
mbed_official 87:085cde657901 1117 (+) Check the ADC Error
mbed_official 87:085cde657901 1118
mbed_official 87:085cde657901 1119 @endverbatim
mbed_official 87:085cde657901 1120 * @{
mbed_official 87:085cde657901 1121 */
mbed_official 87:085cde657901 1122
mbed_official 87:085cde657901 1123 /**
mbed_official 87:085cde657901 1124 * @brief return the ADC state
mbed_official 87:085cde657901 1125 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1126 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1127 * @retval HAL state
mbed_official 87:085cde657901 1128 */
mbed_official 87:085cde657901 1129 HAL_ADC_StateTypeDef HAL_ADC_GetState(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 1130 {
mbed_official 87:085cde657901 1131 /* Return ADC state */
mbed_official 87:085cde657901 1132 return hadc->State;
mbed_official 87:085cde657901 1133 }
mbed_official 87:085cde657901 1134
mbed_official 87:085cde657901 1135 /**
mbed_official 87:085cde657901 1136 * @brief Return the ADC error code
mbed_official 87:085cde657901 1137 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1138 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1139 * @retval ADC Error Code
mbed_official 87:085cde657901 1140 */
mbed_official 87:085cde657901 1141 uint32_t HAL_ADC_GetError(ADC_HandleTypeDef *hadc)
mbed_official 87:085cde657901 1142 {
mbed_official 87:085cde657901 1143 return hadc->ErrorCode;
mbed_official 87:085cde657901 1144 }
mbed_official 87:085cde657901 1145
mbed_official 87:085cde657901 1146 /**
mbed_official 87:085cde657901 1147 * @}
mbed_official 87:085cde657901 1148 */
mbed_official 87:085cde657901 1149
mbed_official 87:085cde657901 1150 /**
mbed_official 87:085cde657901 1151 * @brief Initializes the ADCx peripheral according to the specified parameters
mbed_official 87:085cde657901 1152 * in the ADC_InitStruct without initializing the ADC MSP.
mbed_official 87:085cde657901 1153 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1154 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1155 * @retval None
mbed_official 87:085cde657901 1156 */
mbed_official 87:085cde657901 1157 static void ADC_Init(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 1158 {
mbed_official 87:085cde657901 1159
mbed_official 87:085cde657901 1160 /* Set ADC parameters */
mbed_official 87:085cde657901 1161 /* Set the ADC clock prescaler */
mbed_official 87:085cde657901 1162 ADC->CCR &= ~(ADC_CCR_ADCPRE);
mbed_official 87:085cde657901 1163 ADC->CCR |= hadc->Init.ClockPrescaler;
mbed_official 87:085cde657901 1164
mbed_official 87:085cde657901 1165 /* Set ADC scan mode */
mbed_official 87:085cde657901 1166 hadc->Instance->CR1 &= ~(ADC_CR1_SCAN);
mbed_official 87:085cde657901 1167 hadc->Instance->CR1 |= __HAL_ADC_CR1_SCANCONV(hadc->Init.ScanConvMode);
mbed_official 87:085cde657901 1168
mbed_official 87:085cde657901 1169 /* Set ADC resolution */
mbed_official 87:085cde657901 1170 hadc->Instance->CR1 &= ~(ADC_CR1_RES);
mbed_official 87:085cde657901 1171 hadc->Instance->CR1 |= hadc->Init.Resolution;
mbed_official 87:085cde657901 1172
mbed_official 87:085cde657901 1173 /* Set ADC data alignment */
mbed_official 87:085cde657901 1174 hadc->Instance->CR2 &= ~(ADC_CR2_ALIGN);
mbed_official 87:085cde657901 1175 hadc->Instance->CR2 |= hadc->Init.DataAlign;
mbed_official 87:085cde657901 1176
mbed_official 87:085cde657901 1177 /* Select external trigger to start conversion */
mbed_official 87:085cde657901 1178 hadc->Instance->CR2 &= ~(ADC_CR2_EXTSEL);
mbed_official 87:085cde657901 1179 hadc->Instance->CR2 |= hadc->Init.ExternalTrigConv;
mbed_official 87:085cde657901 1180
mbed_official 87:085cde657901 1181 /* Select external trigger polarity */
mbed_official 87:085cde657901 1182 hadc->Instance->CR2 &= ~(ADC_CR2_EXTEN);
mbed_official 87:085cde657901 1183 hadc->Instance->CR2 |= hadc->Init.ExternalTrigConvEdge;
mbed_official 87:085cde657901 1184
mbed_official 87:085cde657901 1185 /* Enable or disable ADC continuous conversion mode */
mbed_official 87:085cde657901 1186 hadc->Instance->CR2 &= ~(ADC_CR2_CONT);
mbed_official 87:085cde657901 1187 hadc->Instance->CR2 |= __HAL_ADC_CR2_CONTINUOUS(hadc->Init.ContinuousConvMode);
mbed_official 87:085cde657901 1188
mbed_official 87:085cde657901 1189 if (hadc->Init.DiscontinuousConvMode != DISABLE)
mbed_official 87:085cde657901 1190 {
mbed_official 87:085cde657901 1191 assert_param(IS_ADC_REGULAR_DISC_NUMBER(hadc->Init.NbrOfDiscConversion));
mbed_official 87:085cde657901 1192
mbed_official 87:085cde657901 1193 /* Enable the selected ADC regular discontinuous mode */
mbed_official 87:085cde657901 1194 hadc->Instance->CR1 |= (uint32_t)ADC_CR1_DISCEN;
mbed_official 87:085cde657901 1195
mbed_official 87:085cde657901 1196 /* Set the number of channels to be converted in discontinuous mode */
mbed_official 87:085cde657901 1197 hadc->Instance->CR1 &= ~(ADC_CR1_DISCNUM);
mbed_official 87:085cde657901 1198 hadc->Instance->CR1 |= __HAL_ADC_CR1_DISCONTINUOUS(hadc->Init.NbrOfDiscConversion);
mbed_official 87:085cde657901 1199 }
mbed_official 87:085cde657901 1200 else
mbed_official 87:085cde657901 1201 {
mbed_official 87:085cde657901 1202 /* Disable the selected ADC regular discontinuous mode */
mbed_official 87:085cde657901 1203 hadc->Instance->CR1 &= ~(ADC_CR1_DISCEN);
mbed_official 87:085cde657901 1204 }
mbed_official 87:085cde657901 1205
mbed_official 87:085cde657901 1206 /* Set ADC number of conversion */
mbed_official 87:085cde657901 1207 hadc->Instance->SQR1 &= ~(ADC_SQR1_L);
mbed_official 87:085cde657901 1208 hadc->Instance->SQR1 |= __HAL_ADC_SQR1(hadc->Init.NbrOfConversion);
mbed_official 87:085cde657901 1209
mbed_official 87:085cde657901 1210 /* Enable or disable ADC DMA continuous request */
mbed_official 87:085cde657901 1211 hadc->Instance->CR2 &= ~(ADC_CR2_DDS);
mbed_official 87:085cde657901 1212 hadc->Instance->CR2 |= __HAL_ADC_CR2_DMAContReq(hadc->Init.DMAContinuousRequests);
mbed_official 87:085cde657901 1213
mbed_official 87:085cde657901 1214 /* Enable or disable ADC end of conversion selection */
mbed_official 87:085cde657901 1215 hadc->Instance->CR2 &= ~(ADC_CR2_EOCS);
mbed_official 87:085cde657901 1216 hadc->Instance->CR2 |= __HAL_ADC_CR2_EOCSelection(hadc->Init.EOCSelection);
mbed_official 87:085cde657901 1217 }
mbed_official 87:085cde657901 1218
mbed_official 87:085cde657901 1219 /**
mbed_official 87:085cde657901 1220 * @brief DMA transfer complete callback.
mbed_official 87:085cde657901 1221 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1222 * @retval None
mbed_official 87:085cde657901 1223 */
mbed_official 87:085cde657901 1224 static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1225 {
mbed_official 87:085cde657901 1226 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1227
mbed_official 87:085cde657901 1228 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 1229 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 1230 {
mbed_official 87:085cde657901 1231 /* Change ADC state */
mbed_official 87:085cde657901 1232 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 1233 }
mbed_official 87:085cde657901 1234 else
mbed_official 87:085cde657901 1235 {
mbed_official 87:085cde657901 1236 /* Change ADC state */
mbed_official 87:085cde657901 1237 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 1238 }
mbed_official 87:085cde657901 1239
mbed_official 87:085cde657901 1240 HAL_ADC_ConvCpltCallback(hadc);
mbed_official 87:085cde657901 1241 }
mbed_official 87:085cde657901 1242
mbed_official 87:085cde657901 1243 /**
mbed_official 87:085cde657901 1244 * @brief DMA half transfer complete callback.
mbed_official 87:085cde657901 1245 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1246 * @retval None
mbed_official 87:085cde657901 1247 */
mbed_official 87:085cde657901 1248 static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1249 {
mbed_official 87:085cde657901 1250 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1251 /* Conversion complete callback */
mbed_official 87:085cde657901 1252 HAL_ADC_ConvHalfCpltCallback(hadc);
mbed_official 87:085cde657901 1253 }
mbed_official 87:085cde657901 1254
mbed_official 87:085cde657901 1255 /**
mbed_official 87:085cde657901 1256 * @brief DMA error callback
mbed_official 87:085cde657901 1257 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1258 * @retval None
mbed_official 87:085cde657901 1259 */
mbed_official 87:085cde657901 1260 static void ADC_DMAError(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1261 {
mbed_official 87:085cde657901 1262 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1263 hadc->State= HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 1264 /* Set ADC error code to DMA error */
mbed_official 87:085cde657901 1265 hadc->ErrorCode |= HAL_ADC_ERROR_DMA;
mbed_official 87:085cde657901 1266 HAL_ADC_ErrorCallback(hadc);
mbed_official 87:085cde657901 1267 }
mbed_official 87:085cde657901 1268
mbed_official 87:085cde657901 1269
mbed_official 87:085cde657901 1270 /**
mbed_official 87:085cde657901 1271 * @}
mbed_official 87:085cde657901 1272 */
mbed_official 87:085cde657901 1273
mbed_official 87:085cde657901 1274 #endif /* HAL_ADC_MODULE_ENABLED */
mbed_official 87:085cde657901 1275 /**
mbed_official 87:085cde657901 1276 * @}
mbed_official 87:085cde657901 1277 */
mbed_official 87:085cde657901 1278
mbed_official 87:085cde657901 1279 /**
mbed_official 87:085cde657901 1280 * @}
mbed_official 87:085cde657901 1281 */
mbed_official 87:085cde657901 1282
mbed_official 87:085cde657901 1283 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/