mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_adc.c@274:6937b19af361, 2014-08-06 (annotated)

Committer:
mbed_official
Date:
Wed Aug 06 08:15:07 2014 +0100
Revision:
274:6937b19af361
Parent:
226:b062af740e40
Child:
369:2e96f1b71984
Synchronized with git revision 5b145e4f6c509376173c3ea2aa35a6da879a2124



Full URL: https://github.com/mbedmicro/mbed/commit/5b145e4f6c509376173c3ea2aa35a6da879a2124/



[TARGET_LPC11UXX] PeripheralNames.h and PinMap definitions separation for LPC11UXX platforms

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 226:b062af740e40 5 * @version V1.1.0RC2
mbed_official 226:b062af740e40 6 * @date 14-May-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 226:b062af740e40 66 (#) Three operation modes 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 226:b062af740e40 92 of data to be transferred 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 106:ced8cbb51063 245
mbed_official 106:ced8cbb51063 246 /* Release Lock */
mbed_official 106:ced8cbb51063 247 __HAL_UNLOCK(hadc);
mbed_official 106:ced8cbb51063 248
mbed_official 87:085cde657901 249 /* Return function status */
mbed_official 87:085cde657901 250 return HAL_OK;
mbed_official 87:085cde657901 251 }
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 /**
mbed_official 87:085cde657901 254 * @brief Deinitializes the ADCx peripheral registers to their default reset values.
mbed_official 87:085cde657901 255 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 256 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 257 * @retval HAL status
mbed_official 87:085cde657901 258 */
mbed_official 87:085cde657901 259 HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 260 {
mbed_official 87:085cde657901 261 /* Check ADC handle */
mbed_official 87:085cde657901 262 if(hadc == NULL)
mbed_official 87:085cde657901 263 {
mbed_official 87:085cde657901 264 return HAL_ERROR;
mbed_official 87:085cde657901 265 }
mbed_official 87:085cde657901 266
mbed_official 87:085cde657901 267 /* Check the parameters */
mbed_official 87:085cde657901 268 assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance));
mbed_official 87:085cde657901 269
mbed_official 87:085cde657901 270 /* Change ADC state */
mbed_official 87:085cde657901 271 hadc->State = HAL_ADC_STATE_BUSY;
mbed_official 87:085cde657901 272
mbed_official 87:085cde657901 273 /* DeInit the low level hardware */
mbed_official 87:085cde657901 274 HAL_ADC_MspDeInit(hadc);
mbed_official 87:085cde657901 275
mbed_official 87:085cde657901 276 /* Set ADC error code to none */
mbed_official 87:085cde657901 277 hadc->ErrorCode = HAL_ADC_ERROR_NONE;
mbed_official 87:085cde657901 278
mbed_official 87:085cde657901 279 /* Change ADC state */
mbed_official 87:085cde657901 280 hadc->State = HAL_ADC_STATE_RESET;
mbed_official 87:085cde657901 281
mbed_official 87:085cde657901 282 /* Return function status */
mbed_official 87:085cde657901 283 return HAL_OK;
mbed_official 87:085cde657901 284 }
mbed_official 87:085cde657901 285
mbed_official 87:085cde657901 286 /**
mbed_official 87:085cde657901 287 * @brief Initializes the ADC MSP.
mbed_official 87:085cde657901 288 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 289 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 290 * @retval None
mbed_official 87:085cde657901 291 */
mbed_official 87:085cde657901 292 __weak void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 293 {
mbed_official 87:085cde657901 294 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 295 the HAL_ADC_MspInit could be implemented in the user file
mbed_official 87:085cde657901 296 */
mbed_official 87:085cde657901 297 }
mbed_official 87:085cde657901 298
mbed_official 87:085cde657901 299 /**
mbed_official 87:085cde657901 300 * @brief DeInitializes the ADC MSP.
mbed_official 87:085cde657901 301 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 302 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 303 * @retval None
mbed_official 87:085cde657901 304 */
mbed_official 87:085cde657901 305 __weak void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 306 {
mbed_official 87:085cde657901 307 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 308 the HAL_ADC_MspDeInit could be implemented in the user file
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 * @}
mbed_official 87:085cde657901 314 */
mbed_official 87:085cde657901 315
mbed_official 87:085cde657901 316 /** @defgroup ADC_Group2 IO operation functions
mbed_official 87:085cde657901 317 * @brief IO operation functions
mbed_official 87:085cde657901 318 *
mbed_official 87:085cde657901 319 @verbatim
mbed_official 87:085cde657901 320 ===============================================================================
mbed_official 87:085cde657901 321 ##### IO operation functions #####
mbed_official 87:085cde657901 322 ===============================================================================
mbed_official 87:085cde657901 323 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 324 (+) Start conversion of regular channel.
mbed_official 87:085cde657901 325 (+) Stop conversion of regular channel.
mbed_official 87:085cde657901 326 (+) Start conversion of regular channel and enable interrupt.
mbed_official 87:085cde657901 327 (+) Stop conversion of regular channel and disable interrupt.
mbed_official 87:085cde657901 328 (+) Start conversion of regular channel and enable DMA transfer.
mbed_official 87:085cde657901 329 (+) Stop conversion of regular channel and disable DMA transfer.
mbed_official 87:085cde657901 330 (+) Handle ADC interrupt request.
mbed_official 87:085cde657901 331
mbed_official 87:085cde657901 332 @endverbatim
mbed_official 87:085cde657901 333 * @{
mbed_official 87:085cde657901 334 */
mbed_official 87:085cde657901 335
mbed_official 87:085cde657901 336 /**
mbed_official 87:085cde657901 337 * @brief Enables ADC and starts conversion of the regular channels.
mbed_official 87:085cde657901 338 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 339 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 340 * @retval HAL status
mbed_official 87:085cde657901 341 */
mbed_official 87:085cde657901 342 HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 343 {
mbed_official 87:085cde657901 344 uint16_t i = 0;
mbed_official 87:085cde657901 345
mbed_official 87:085cde657901 346 /* Check the parameters */
mbed_official 87:085cde657901 347 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 348 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 349
mbed_official 87:085cde657901 350 /* Process locked */
mbed_official 87:085cde657901 351 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 352
mbed_official 87:085cde657901 353 /* Check if an injected conversion is ongoing */
mbed_official 87:085cde657901 354 if(hadc->State == HAL_ADC_STATE_BUSY_INJ)
mbed_official 87:085cde657901 355 {
mbed_official 87:085cde657901 356 /* Change ADC state */
mbed_official 87:085cde657901 357 hadc->State = HAL_ADC_STATE_BUSY_INJ_REG;
mbed_official 87:085cde657901 358 }
mbed_official 87:085cde657901 359 else
mbed_official 87:085cde657901 360 {
mbed_official 87:085cde657901 361 /* Change ADC state */
mbed_official 87:085cde657901 362 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 363 }
mbed_official 87:085cde657901 364
mbed_official 87:085cde657901 365 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 366 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 367 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 368 {
mbed_official 87:085cde657901 369 /* Enable the Peripheral */
mbed_official 87:085cde657901 370 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 371
mbed_official 87:085cde657901 372 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 373 for(; i <= 540; i++)
mbed_official 87:085cde657901 374 {
mbed_official 87:085cde657901 375 __NOP();
mbed_official 87:085cde657901 376 }
mbed_official 87:085cde657901 377 }
mbed_official 87:085cde657901 378
mbed_official 87:085cde657901 379 /* Check if Multimode enabled */
mbed_official 87:085cde657901 380 if(HAL_IS_BIT_CLR(ADC->CCR, ADC_CCR_MULTI))
mbed_official 87:085cde657901 381 {
mbed_official 87:085cde657901 382 /* if no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 383 if(hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 384 {
mbed_official 87:085cde657901 385 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 386 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 387 }
mbed_official 87:085cde657901 388 }
mbed_official 87:085cde657901 389 else
mbed_official 87:085cde657901 390 {
mbed_official 87:085cde657901 391 /* if instance of handle correspond to ADC1 and no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 392 if((hadc->Instance == ADC1) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 393 {
mbed_official 87:085cde657901 394 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 395 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 396 }
mbed_official 87:085cde657901 397 }
mbed_official 87:085cde657901 398
mbed_official 87:085cde657901 399 /* Process unlocked */
mbed_official 87:085cde657901 400 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 401
mbed_official 87:085cde657901 402 /* Return function status */
mbed_official 87:085cde657901 403 return HAL_OK;
mbed_official 87:085cde657901 404 }
mbed_official 87:085cde657901 405
mbed_official 87:085cde657901 406 /**
mbed_official 87:085cde657901 407 * @brief Disables ADC and stop conversion of regular channels.
mbed_official 87:085cde657901 408 *
mbed_official 87:085cde657901 409 * @note Caution: This function will stop also injected channels.
mbed_official 87:085cde657901 410 *
mbed_official 87:085cde657901 411 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 412 * the configuration information for the specified ADC.
mbed_official 226:b062af740e40 413 *
mbed_official 87:085cde657901 414 * @retval HAL status.
mbed_official 87:085cde657901 415 */
mbed_official 87:085cde657901 416 HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 417 {
mbed_official 87:085cde657901 418 /* Disable the Peripheral */
mbed_official 87:085cde657901 419 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 420
mbed_official 87:085cde657901 421 /* Change ADC state */
mbed_official 87:085cde657901 422 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 423
mbed_official 87:085cde657901 424 /* Return function status */
mbed_official 87:085cde657901 425 return HAL_OK;
mbed_official 87:085cde657901 426 }
mbed_official 87:085cde657901 427
mbed_official 87:085cde657901 428 /**
mbed_official 87:085cde657901 429 * @brief Poll for regular conversion complete
mbed_official 87:085cde657901 430 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 431 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 432 * @param Timeout: Timeout value in millisecond.
mbed_official 87:085cde657901 433 * @retval HAL status
mbed_official 87:085cde657901 434 */
mbed_official 87:085cde657901 435 HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout)
mbed_official 87:085cde657901 436 {
mbed_official 87:085cde657901 437 uint32_t timeout;
mbed_official 87:085cde657901 438
mbed_official 87:085cde657901 439 /* Get timeout */
mbed_official 87:085cde657901 440 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 441
mbed_official 87:085cde657901 442 /* Check End of conversion flag */
mbed_official 87:085cde657901 443 while(!(__HAL_ADC_GET_FLAG(hadc, ADC_FLAG_EOC)))
mbed_official 87:085cde657901 444 {
mbed_official 87:085cde657901 445 /* Check for the Timeout */
mbed_official 87:085cde657901 446 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 447 {
mbed_official 87:085cde657901 448 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 449 {
mbed_official 87:085cde657901 450 hadc->State= HAL_ADC_STATE_TIMEOUT;
mbed_official 87:085cde657901 451 /* Process unlocked */
mbed_official 87:085cde657901 452 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 453 return HAL_TIMEOUT;
mbed_official 87:085cde657901 454 }
mbed_official 87:085cde657901 455 }
mbed_official 87:085cde657901 456 }
mbed_official 87:085cde657901 457
mbed_official 87:085cde657901 458 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 459 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 460 {
mbed_official 87:085cde657901 461 /* Change ADC state */
mbed_official 87:085cde657901 462 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 463 }
mbed_official 87:085cde657901 464 else
mbed_official 87:085cde657901 465 {
mbed_official 87:085cde657901 466 /* Change ADC state */
mbed_official 87:085cde657901 467 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 468 }
mbed_official 87:085cde657901 469
mbed_official 87:085cde657901 470 /* Return ADC state */
mbed_official 87:085cde657901 471 return HAL_OK;
mbed_official 87:085cde657901 472 }
mbed_official 87:085cde657901 473
mbed_official 87:085cde657901 474 /**
mbed_official 87:085cde657901 475 * @brief Poll for conversion event
mbed_official 87:085cde657901 476 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 477 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 478 * @param EventType: the ADC event type.
mbed_official 87:085cde657901 479 * This parameter can be one of the following values:
mbed_official 87:085cde657901 480 * @arg AWD_EVENT: ADC Analog watch Dog event.
mbed_official 87:085cde657901 481 * @arg OVR_EVENT: ADC Overrun event.
mbed_official 87:085cde657901 482 * @param Timeout: Timeout value in millisecond.
mbed_official 87:085cde657901 483 * @retval HAL status
mbed_official 87:085cde657901 484 */
mbed_official 87:085cde657901 485 HAL_StatusTypeDef HAL_ADC_PollForEvent(ADC_HandleTypeDef* hadc, uint32_t EventType, uint32_t Timeout)
mbed_official 87:085cde657901 486 {
mbed_official 87:085cde657901 487 /* Check the parameters */
mbed_official 87:085cde657901 488 assert_param(IS_ADC_EVENT_TYPE(EventType));
mbed_official 87:085cde657901 489
mbed_official 87:085cde657901 490 uint32_t timeout;
mbed_official 87:085cde657901 491
mbed_official 87:085cde657901 492 /* Get timeout */
mbed_official 87:085cde657901 493 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 494
mbed_official 87:085cde657901 495 /* Check selected event flag */
mbed_official 87:085cde657901 496 while(!(__HAL_ADC_GET_FLAG(hadc,EventType)))
mbed_official 87:085cde657901 497 {
mbed_official 87:085cde657901 498 /* Check for the Timeout */
mbed_official 87:085cde657901 499 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 500 {
mbed_official 87:085cde657901 501 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 502 {
mbed_official 87:085cde657901 503 hadc->State= HAL_ADC_STATE_TIMEOUT;
mbed_official 87:085cde657901 504 /* Process unlocked */
mbed_official 87:085cde657901 505 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 506 return HAL_TIMEOUT;
mbed_official 87:085cde657901 507 }
mbed_official 87:085cde657901 508 }
mbed_official 87:085cde657901 509 }
mbed_official 87:085cde657901 510
mbed_official 87:085cde657901 511 /* Check analog watchdog flag */
mbed_official 87:085cde657901 512 if(EventType == AWD_EVENT)
mbed_official 87:085cde657901 513 {
mbed_official 87:085cde657901 514 /* Change ADC state */
mbed_official 87:085cde657901 515 hadc->State = HAL_ADC_STATE_AWD;
mbed_official 87:085cde657901 516
mbed_official 87:085cde657901 517 /* Clear the ADCx's analog watchdog flag */
mbed_official 87:085cde657901 518 __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_AWD);
mbed_official 87:085cde657901 519 }
mbed_official 87:085cde657901 520 else
mbed_official 87:085cde657901 521 {
mbed_official 87:085cde657901 522 /* Change ADC state */
mbed_official 87:085cde657901 523 hadc->State = HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 524
mbed_official 87:085cde657901 525 /* Clear the ADCx's Overrun flag */
mbed_official 87:085cde657901 526 __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_OVR);
mbed_official 87:085cde657901 527 }
mbed_official 87:085cde657901 528
mbed_official 87:085cde657901 529 /* Return ADC state */
mbed_official 87:085cde657901 530 return HAL_OK;
mbed_official 87:085cde657901 531 }
mbed_official 87:085cde657901 532
mbed_official 87:085cde657901 533
mbed_official 87:085cde657901 534 /**
mbed_official 87:085cde657901 535 * @brief Enables the interrupt and starts ADC conversion of regular channels.
mbed_official 87:085cde657901 536 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 537 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 538 * @retval HAL status.
mbed_official 87:085cde657901 539 */
mbed_official 87:085cde657901 540 HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 541 {
mbed_official 87:085cde657901 542 uint16_t i = 0;
mbed_official 87:085cde657901 543
mbed_official 87:085cde657901 544 /* Check the parameters */
mbed_official 87:085cde657901 545 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 546 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 547
mbed_official 87:085cde657901 548 /* Process locked */
mbed_official 87:085cde657901 549 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 550
mbed_official 87:085cde657901 551 /* Check if an injected conversion is ongoing */
mbed_official 87:085cde657901 552 if(hadc->State == HAL_ADC_STATE_BUSY_INJ)
mbed_official 87:085cde657901 553 {
mbed_official 87:085cde657901 554 /* Change ADC state */
mbed_official 87:085cde657901 555 hadc->State = HAL_ADC_STATE_BUSY_INJ_REG;
mbed_official 87:085cde657901 556 }
mbed_official 87:085cde657901 557 else
mbed_official 87:085cde657901 558 {
mbed_official 87:085cde657901 559 /* Change ADC state */
mbed_official 87:085cde657901 560 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 561 }
mbed_official 87:085cde657901 562
mbed_official 87:085cde657901 563 /* Set ADC error code to none */
mbed_official 87:085cde657901 564 hadc->ErrorCode = HAL_ADC_ERROR_NONE;
mbed_official 87:085cde657901 565
mbed_official 87:085cde657901 566 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 567 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 568 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 569 {
mbed_official 87:085cde657901 570 /* Enable the Peripheral */
mbed_official 87:085cde657901 571 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 572
mbed_official 87:085cde657901 573 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 574 for(; i <= 540; i++)
mbed_official 87:085cde657901 575 {
mbed_official 87:085cde657901 576 __NOP();
mbed_official 87:085cde657901 577 }
mbed_official 87:085cde657901 578 }
mbed_official 87:085cde657901 579
mbed_official 87:085cde657901 580 /* Enable the ADC overrun interrupt */
mbed_official 87:085cde657901 581 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 582
mbed_official 87:085cde657901 583 /* Enable the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 584 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 585
mbed_official 87:085cde657901 586 /* Check if Multimode enabled */
mbed_official 87:085cde657901 587 if(HAL_IS_BIT_CLR(ADC->CCR, ADC_CCR_MULTI))
mbed_official 87:085cde657901 588 {
mbed_official 87:085cde657901 589 /* if no externel trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 590 if (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 591 {
mbed_official 87:085cde657901 592 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 593 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 594 }
mbed_official 87:085cde657901 595 }
mbed_official 87:085cde657901 596 else
mbed_official 87:085cde657901 597 {
mbed_official 87:085cde657901 598 /* if instance of handle correspond to ADC1 and no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 599 if ((hadc->Instance == (ADC_TypeDef*)0x40012000) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 600 {
mbed_official 87:085cde657901 601 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 602 hadc->Instance->CR2 |= (uint32_t)ADC_CR2_SWSTART;
mbed_official 87:085cde657901 603 }
mbed_official 87:085cde657901 604 }
mbed_official 87:085cde657901 605
mbed_official 87:085cde657901 606 /* Process unlocked */
mbed_official 87:085cde657901 607 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 608
mbed_official 87:085cde657901 609 /* Return function status */
mbed_official 87:085cde657901 610 return HAL_OK;
mbed_official 87:085cde657901 611 }
mbed_official 87:085cde657901 612
mbed_official 87:085cde657901 613 /**
mbed_official 87:085cde657901 614 * @brief Disables the interrupt and stop ADC conversion of regular channels.
mbed_official 87:085cde657901 615 *
mbed_official 87:085cde657901 616 * @note Caution: This function will stop also injected channels.
mbed_official 87:085cde657901 617 *
mbed_official 87:085cde657901 618 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 619 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 620 * @retval HAL status.
mbed_official 87:085cde657901 621 */
mbed_official 87:085cde657901 622 HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 623 {
mbed_official 87:085cde657901 624 /* Disable the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 625 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 626
mbed_official 87:085cde657901 627 /* Disable the ADC end of conversion interrupt for injected group */
mbed_official 87:085cde657901 628 __HAL_ADC_DISABLE_IT(hadc, ADC_CR1_JEOCIE);
mbed_official 87:085cde657901 629
mbed_official 87:085cde657901 630 /* Enable the Periphral */
mbed_official 87:085cde657901 631 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 632
mbed_official 87:085cde657901 633 /* Change ADC state */
mbed_official 87:085cde657901 634 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 635
mbed_official 87:085cde657901 636 /* Return function status */
mbed_official 87:085cde657901 637 return HAL_OK;
mbed_official 87:085cde657901 638 }
mbed_official 87:085cde657901 639
mbed_official 87:085cde657901 640 /**
mbed_official 87:085cde657901 641 * @brief Handles ADC interrupt request
mbed_official 87:085cde657901 642 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 643 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 644 * @retval None
mbed_official 87:085cde657901 645 */
mbed_official 87:085cde657901 646 void HAL_ADC_IRQHandler(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 647 {
mbed_official 87:085cde657901 648 uint32_t tmp1 = 0, tmp2 = 0;
mbed_official 87:085cde657901 649
mbed_official 87:085cde657901 650 /* Check the parameters */
mbed_official 87:085cde657901 651 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 652 assert_param(IS_ADC_REGULAR_LENGTH(hadc->Init.NbrOfConversion));
mbed_official 87:085cde657901 653 assert_param(IS_ADC_EOCSelection(hadc->Init.EOCSelection));
mbed_official 87:085cde657901 654
mbed_official 87:085cde657901 655 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_EOC);
mbed_official 87:085cde657901 656 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 657 /* Check End of conversion flag for regular channels */
mbed_official 87:085cde657901 658 if(tmp1 && tmp2)
mbed_official 87:085cde657901 659 {
mbed_official 87:085cde657901 660 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 661 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 662 {
mbed_official 87:085cde657901 663 /* Change ADC state */
mbed_official 87:085cde657901 664 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 665 }
mbed_official 87:085cde657901 666 else
mbed_official 87:085cde657901 667 {
mbed_official 87:085cde657901 668 /* Change ADC state */
mbed_official 87:085cde657901 669 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 670 }
mbed_official 87:085cde657901 671
mbed_official 87:085cde657901 672 if((hadc->Init.ContinuousConvMode == DISABLE) && (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE))
mbed_official 87:085cde657901 673 {
mbed_official 87:085cde657901 674 if(hadc->Init.EOCSelection == EOC_SEQ_CONV)
mbed_official 87:085cde657901 675 {
mbed_official 87:085cde657901 676 /* DISABLE the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 677 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 678
mbed_official 87:085cde657901 679 /* DISABLE the ADC overrun interrupt */
mbed_official 87:085cde657901 680 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 681 }
mbed_official 87:085cde657901 682 else
mbed_official 87:085cde657901 683 {
mbed_official 87:085cde657901 684 if (hadc->NbrOfCurrentConversionRank == 0)
mbed_official 87:085cde657901 685 {
mbed_official 87:085cde657901 686 hadc->NbrOfCurrentConversionRank = hadc->Init.NbrOfConversion;
mbed_official 87:085cde657901 687 }
mbed_official 87:085cde657901 688
mbed_official 87:085cde657901 689 /* Decrement the number of conversion when an interrupt occurs */
mbed_official 87:085cde657901 690 hadc->NbrOfCurrentConversionRank--;
mbed_official 87:085cde657901 691
mbed_official 87:085cde657901 692 /* Check if all conversions are finished */
mbed_official 87:085cde657901 693 if(hadc->NbrOfCurrentConversionRank == 0)
mbed_official 87:085cde657901 694 {
mbed_official 87:085cde657901 695 /* DISABLE the ADC end of conversion interrupt for regular group */
mbed_official 87:085cde657901 696 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_EOC);
mbed_official 87:085cde657901 697
mbed_official 87:085cde657901 698 /* DISABLE the ADC overrun interrupt */
mbed_official 87:085cde657901 699 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 700 }
mbed_official 87:085cde657901 701 }
mbed_official 87:085cde657901 702 }
mbed_official 87:085cde657901 703
mbed_official 87:085cde657901 704 /* Conversion complete callback */
mbed_official 87:085cde657901 705 HAL_ADC_ConvCpltCallback(hadc);
mbed_official 87:085cde657901 706
mbed_official 87:085cde657901 707 /* Clear the ADCx flag for regular end of conversion */
mbed_official 87:085cde657901 708 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_EOC);
mbed_official 87:085cde657901 709 }
mbed_official 87:085cde657901 710
mbed_official 87:085cde657901 711 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_JEOC);
mbed_official 87:085cde657901 712 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_JEOC);
mbed_official 87:085cde657901 713 /* Check End of conversion flag for injected channels */
mbed_official 87:085cde657901 714 if(tmp1 && tmp2)
mbed_official 87:085cde657901 715 {
mbed_official 87:085cde657901 716 /* Check if a regular conversion is ready */
mbed_official 87:085cde657901 717 if(hadc->State == HAL_ADC_STATE_EOC_REG)
mbed_official 87:085cde657901 718 {
mbed_official 87:085cde657901 719 /* Change ADC state */
mbed_official 87:085cde657901 720 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 721 }
mbed_official 87:085cde657901 722 else
mbed_official 87:085cde657901 723 {
mbed_official 87:085cde657901 724 /* Change ADC state */
mbed_official 87:085cde657901 725 hadc->State = HAL_ADC_STATE_EOC_INJ;
mbed_official 87:085cde657901 726 }
mbed_official 87:085cde657901 727
mbed_official 87:085cde657901 728 tmp1 = HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO);
mbed_official 87:085cde657901 729 tmp2 = HAL_IS_BIT_CLR(hadc->Instance->CR2, ADC_CR2_JEXTEN);
mbed_official 87:085cde657901 730 if(((hadc->Init.ContinuousConvMode == DISABLE) || tmp1) && tmp2)
mbed_official 87:085cde657901 731 {
mbed_official 87:085cde657901 732 /* DISABLE the ADC end of conversion interrupt for injected group */
mbed_official 87:085cde657901 733 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC);
mbed_official 87:085cde657901 734 }
mbed_official 87:085cde657901 735
mbed_official 87:085cde657901 736 /* Conversion complete callback */
mbed_official 87:085cde657901 737 HAL_ADCEx_InjectedConvCpltCallback(hadc);
mbed_official 87:085cde657901 738
mbed_official 87:085cde657901 739 /* Clear the ADCx flag for injected end of conversion */
mbed_official 87:085cde657901 740 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_JEOC);
mbed_official 87:085cde657901 741 }
mbed_official 87:085cde657901 742
mbed_official 87:085cde657901 743 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_AWD);
mbed_official 87:085cde657901 744 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 745 /* Check Analog watchdog flag */
mbed_official 87:085cde657901 746 if(tmp1 && tmp2)
mbed_official 87:085cde657901 747 {
mbed_official 87:085cde657901 748 /* Change ADC state */
mbed_official 87:085cde657901 749 hadc->State = HAL_ADC_STATE_AWD;
mbed_official 87:085cde657901 750
mbed_official 87:085cde657901 751 /* Clear the ADCx's Analog watchdog flag */
mbed_official 87:085cde657901 752 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_AWD);
mbed_official 87:085cde657901 753
mbed_official 87:085cde657901 754 /* Level out of window callback */
mbed_official 87:085cde657901 755 HAL_ADC_LevelOutOfWindowCallback(hadc);
mbed_official 87:085cde657901 756 }
mbed_official 87:085cde657901 757
mbed_official 87:085cde657901 758 tmp1 = __HAL_ADC_GET_FLAG(hadc, ADC_FLAG_OVR);
mbed_official 87:085cde657901 759 tmp2 = __HAL_ADC_GET_IT_SOURCE(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 760 /* Check Overrun flag */
mbed_official 87:085cde657901 761 if(tmp1 && tmp2)
mbed_official 87:085cde657901 762 {
mbed_official 87:085cde657901 763 /* Change ADC state to overrun state */
mbed_official 87:085cde657901 764 hadc->State = HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 765
mbed_official 87:085cde657901 766 /* Set ADC error code to overrun */
mbed_official 87:085cde657901 767 hadc->ErrorCode |= HAL_ADC_ERROR_OVR;
mbed_official 87:085cde657901 768
mbed_official 87:085cde657901 769 /* Clear the Overrun flag */
mbed_official 87:085cde657901 770 __HAL_ADC_CLEAR_FLAG(hadc,ADC_FLAG_OVR);
mbed_official 87:085cde657901 771
mbed_official 87:085cde657901 772 /* Error callback */
mbed_official 87:085cde657901 773 HAL_ADC_ErrorCallback(hadc);
mbed_official 87:085cde657901 774 }
mbed_official 87:085cde657901 775 }
mbed_official 87:085cde657901 776
mbed_official 87:085cde657901 777 /**
mbed_official 87:085cde657901 778 * @brief Enables ADC DMA request after last transfer (Single-ADC mode) and enables ADC peripheral
mbed_official 87:085cde657901 779 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 780 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 781 * @param pData: The destination Buffer address.
mbed_official 87:085cde657901 782 * @param Length: The length of data to be transferred from ADC peripheral to memory.
mbed_official 226:b062af740e40 783 * @retval HAL status
mbed_official 87:085cde657901 784 */
mbed_official 87:085cde657901 785 HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length)
mbed_official 87:085cde657901 786 {
mbed_official 87:085cde657901 787 uint16_t i = 0;
mbed_official 87:085cde657901 788
mbed_official 87:085cde657901 789 /* Check the parameters */
mbed_official 87:085cde657901 790 assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode));
mbed_official 87:085cde657901 791 assert_param(IS_ADC_EXT_TRIG_EDGE(hadc->Init.ExternalTrigConvEdge));
mbed_official 87:085cde657901 792
mbed_official 87:085cde657901 793 /* Process locked */
mbed_official 87:085cde657901 794 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 795
mbed_official 87:085cde657901 796 /* Enable ADC overrun interrupt */
mbed_official 87:085cde657901 797 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 798
mbed_official 87:085cde657901 799 /* Enable ADC DMA mode */
mbed_official 87:085cde657901 800 hadc->Instance->CR2 |= ADC_CR2_DMA;
mbed_official 87:085cde657901 801
mbed_official 87:085cde657901 802 /* Set the DMA transfer complete callback */
mbed_official 87:085cde657901 803 hadc->DMA_Handle->XferCpltCallback = ADC_DMAConvCplt;
mbed_official 87:085cde657901 804
mbed_official 87:085cde657901 805 /* Set the DMA half transfer complete callback */
mbed_official 87:085cde657901 806 hadc->DMA_Handle->XferHalfCpltCallback = ADC_DMAHalfConvCplt;
mbed_official 87:085cde657901 807
mbed_official 87:085cde657901 808 /* Set the DMA error callback */
mbed_official 87:085cde657901 809 hadc->DMA_Handle->XferErrorCallback = ADC_DMAError ;
mbed_official 87:085cde657901 810
mbed_official 87:085cde657901 811 /* Enable the DMA Stream */
mbed_official 87:085cde657901 812 HAL_DMA_Start_IT(hadc->DMA_Handle, (uint32_t)&hadc->Instance->DR, (uint32_t)pData, Length);
mbed_official 87:085cde657901 813
mbed_official 87:085cde657901 814 /* Change ADC state */
mbed_official 87:085cde657901 815 hadc->State = HAL_ADC_STATE_BUSY_REG;
mbed_official 87:085cde657901 816
mbed_official 87:085cde657901 817 /* Check if ADC peripheral is disabled in order to enable it and wait during
mbed_official 87:085cde657901 818 Tstab time the ADC's stabilization */
mbed_official 87:085cde657901 819 if((hadc->Instance->CR2 & ADC_CR2_ADON) != ADC_CR2_ADON)
mbed_official 87:085cde657901 820 {
mbed_official 87:085cde657901 821 /* Enable the Peripheral */
mbed_official 87:085cde657901 822 __HAL_ADC_ENABLE(hadc);
mbed_official 87:085cde657901 823
mbed_official 87:085cde657901 824 /* Delay inserted to wait during Tstab time the ADC's stabilazation */
mbed_official 87:085cde657901 825 for(; i <= 540; i++)
mbed_official 87:085cde657901 826 {
mbed_official 87:085cde657901 827 __NOP();
mbed_official 87:085cde657901 828 }
mbed_official 87:085cde657901 829 }
mbed_official 87:085cde657901 830
mbed_official 87:085cde657901 831 /* if no external trigger present enable software conversion of regular channels */
mbed_official 87:085cde657901 832 if (hadc->Init.ExternalTrigConvEdge == ADC_EXTERNALTRIGCONVEDGE_NONE)
mbed_official 87:085cde657901 833 {
mbed_official 87:085cde657901 834 /* Enable the selected ADC software conversion for regular group */
mbed_official 87:085cde657901 835 hadc->Instance->CR2 |= ADC_CR2_SWSTART;
mbed_official 87:085cde657901 836 }
mbed_official 87:085cde657901 837
mbed_official 87:085cde657901 838 /* Process unlocked */
mbed_official 87:085cde657901 839 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 840
mbed_official 87:085cde657901 841 /* Return function status */
mbed_official 87:085cde657901 842 return HAL_OK;
mbed_official 87:085cde657901 843 }
mbed_official 87:085cde657901 844
mbed_official 87:085cde657901 845 /**
mbed_official 87:085cde657901 846 * @brief Disables ADC DMA (Single-ADC mode) and disables ADC peripheral
mbed_official 87:085cde657901 847 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 848 * the configuration information for the specified ADC.
mbed_official 226:b062af740e40 849 * @retval HAL status
mbed_official 87:085cde657901 850 */
mbed_official 87:085cde657901 851 HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 852 {
mbed_official 87:085cde657901 853 /* Disable the Periphral */
mbed_official 87:085cde657901 854 __HAL_ADC_DISABLE(hadc);
mbed_official 87:085cde657901 855
mbed_official 87:085cde657901 856 /* Disable ADC overrun interrupt */
mbed_official 87:085cde657901 857 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_OVR);
mbed_official 87:085cde657901 858
mbed_official 87:085cde657901 859 /* Disable the selected ADC DMA mode */
mbed_official 87:085cde657901 860 hadc->Instance->CR2 &= ~ADC_CR2_DMA;
mbed_official 87:085cde657901 861
mbed_official 87:085cde657901 862 /* Disable the ADC DMA Stream */
mbed_official 87:085cde657901 863 HAL_DMA_Abort(hadc->DMA_Handle);
mbed_official 87:085cde657901 864
mbed_official 87:085cde657901 865 /* Change ADC state */
mbed_official 87:085cde657901 866 hadc->State = HAL_ADC_STATE_READY;
mbed_official 87:085cde657901 867
mbed_official 87:085cde657901 868 /* Return function status */
mbed_official 87:085cde657901 869 return HAL_OK;
mbed_official 87:085cde657901 870 }
mbed_official 87:085cde657901 871
mbed_official 87:085cde657901 872 /**
mbed_official 87:085cde657901 873 * @brief Gets the converted value from data register of regular channel.
mbed_official 87:085cde657901 874 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 875 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 876 * @retval Converted value
mbed_official 87:085cde657901 877 */
mbed_official 87:085cde657901 878 uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 879 {
mbed_official 87:085cde657901 880 /* Return the selected ADC converted value */
mbed_official 87:085cde657901 881 return hadc->Instance->DR;
mbed_official 87:085cde657901 882 }
mbed_official 87:085cde657901 883
mbed_official 87:085cde657901 884 /**
mbed_official 87:085cde657901 885 * @brief Regular conversion complete callback in non blocking mode
mbed_official 87:085cde657901 886 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 887 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 888 * @retval None
mbed_official 87:085cde657901 889 */
mbed_official 87:085cde657901 890 __weak void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 891 {
mbed_official 87:085cde657901 892 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 893 the HAL_ADC_ConvCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 894 */
mbed_official 87:085cde657901 895 }
mbed_official 87:085cde657901 896
mbed_official 87:085cde657901 897 /**
mbed_official 87:085cde657901 898 * @brief Regular conversion half DMA transfer callback in non blocking mode
mbed_official 87:085cde657901 899 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 900 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 901 * @retval None
mbed_official 87:085cde657901 902 */
mbed_official 87:085cde657901 903 __weak void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 904 {
mbed_official 87:085cde657901 905 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 906 the HAL_ADC_ConvHalfCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 907 */
mbed_official 87:085cde657901 908 }
mbed_official 87:085cde657901 909
mbed_official 87:085cde657901 910 /**
mbed_official 87:085cde657901 911 * @brief Analog watchdog callback in non blocking mode
mbed_official 87:085cde657901 912 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 913 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 914 * @retval None
mbed_official 87:085cde657901 915 */
mbed_official 87:085cde657901 916 __weak void HAL_ADC_LevelOutOfWindowCallback(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 917 {
mbed_official 87:085cde657901 918 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 919 the HAL_ADC_LevelOoutOfWindowCallback could be implemented in the user file
mbed_official 87:085cde657901 920 */
mbed_official 87:085cde657901 921 }
mbed_official 87:085cde657901 922
mbed_official 87:085cde657901 923 /**
mbed_official 87:085cde657901 924 * @brief Error ADC callback.
mbed_official 87:085cde657901 925 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 926 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 927 * @retval None
mbed_official 87:085cde657901 928 */
mbed_official 87:085cde657901 929 __weak void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc)
mbed_official 87:085cde657901 930 {
mbed_official 87:085cde657901 931 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 932 the HAL_ADC_ErrorCallback could be implemented in the user file
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 * @}
mbed_official 87:085cde657901 938 */
mbed_official 87:085cde657901 939
mbed_official 87:085cde657901 940 /** @defgroup ADC_Group3 Peripheral Control functions
mbed_official 87:085cde657901 941 * @brief Peripheral Control functions
mbed_official 87:085cde657901 942 *
mbed_official 87:085cde657901 943 @verbatim
mbed_official 87:085cde657901 944 ===============================================================================
mbed_official 87:085cde657901 945 ##### Peripheral Control functions #####
mbed_official 87:085cde657901 946 ===============================================================================
mbed_official 87:085cde657901 947 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 948 (+) Configure regular channels.
mbed_official 87:085cde657901 949 (+) Configure injected channels.
mbed_official 87:085cde657901 950 (+) Configure multimode.
mbed_official 87:085cde657901 951 (+) Configure the analog watch dog.
mbed_official 87:085cde657901 952
mbed_official 87:085cde657901 953 @endverbatim
mbed_official 87:085cde657901 954 * @{
mbed_official 87:085cde657901 955 */
mbed_official 87:085cde657901 956
mbed_official 87:085cde657901 957 /**
mbed_official 87:085cde657901 958 * @brief Configures for the selected ADC regular channel its corresponding
mbed_official 87:085cde657901 959 * rank in the sequencer and its sample time.
mbed_official 87:085cde657901 960 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 961 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 962 * @param sConfig: ADC configuration structure.
mbed_official 87:085cde657901 963 * @retval HAL status
mbed_official 87:085cde657901 964 */
mbed_official 87:085cde657901 965 HAL_StatusTypeDef HAL_ADC_ConfigChannel(ADC_HandleTypeDef* hadc, ADC_ChannelConfTypeDef* sConfig)
mbed_official 87:085cde657901 966 {
mbed_official 87:085cde657901 967 /* Check the parameters */
mbed_official 87:085cde657901 968 assert_param(IS_ADC_CHANNEL(sConfig->Channel));
mbed_official 87:085cde657901 969 assert_param(IS_ADC_REGULAR_RANK(sConfig->Rank));
mbed_official 87:085cde657901 970 assert_param(IS_ADC_SAMPLE_TIME(sConfig->SamplingTime));
mbed_official 87:085cde657901 971
mbed_official 87:085cde657901 972 /* Process locked */
mbed_official 87:085cde657901 973 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 974
mbed_official 87:085cde657901 975 /* if ADC_Channel_10 ... ADC_Channel_18 is selected */
mbed_official 87:085cde657901 976 if (sConfig->Channel > ADC_CHANNEL_9)
mbed_official 87:085cde657901 977 {
mbed_official 87:085cde657901 978 /* Clear the old sample time */
mbed_official 87:085cde657901 979 hadc->Instance->SMPR1 &= ~__HAL_ADC_SMPR1(ADC_SMPR1_SMP10, sConfig->Channel);
mbed_official 87:085cde657901 980
mbed_official 87:085cde657901 981 /* Set the new sample time */
mbed_official 87:085cde657901 982 hadc->Instance->SMPR1 |= __HAL_ADC_SMPR1(sConfig->SamplingTime, sConfig->Channel);
mbed_official 87:085cde657901 983 }
mbed_official 87:085cde657901 984 else /* ADC_Channel include in ADC_Channel_[0..9] */
mbed_official 87:085cde657901 985 {
mbed_official 87:085cde657901 986 /* Clear the old sample time */
mbed_official 87:085cde657901 987 hadc->Instance->SMPR2 &= ~__HAL_ADC_SMPR2(ADC_SMPR2_SMP0, sConfig->Channel);
mbed_official 87:085cde657901 988
mbed_official 87:085cde657901 989 /* Set the new sample time */
mbed_official 87:085cde657901 990 hadc->Instance->SMPR2 |= __HAL_ADC_SMPR2(sConfig->SamplingTime, sConfig->Channel);
mbed_official 87:085cde657901 991 }
mbed_official 87:085cde657901 992
mbed_official 87:085cde657901 993 /* For Rank 1 to 6 */
mbed_official 87:085cde657901 994 if (sConfig->Rank < 7)
mbed_official 87:085cde657901 995 {
mbed_official 87:085cde657901 996 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 997 hadc->Instance->SQR3 &= ~__HAL_ADC_SQR3_RK(ADC_SQR3_SQ1, sConfig->Rank);
mbed_official 87:085cde657901 998
mbed_official 87:085cde657901 999 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 1000 hadc->Instance->SQR3 |= __HAL_ADC_SQR3_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 1001 }
mbed_official 87:085cde657901 1002 /* For Rank 7 to 12 */
mbed_official 87:085cde657901 1003 else if (sConfig->Rank < 13)
mbed_official 87:085cde657901 1004 {
mbed_official 87:085cde657901 1005 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 1006 hadc->Instance->SQR2 &= ~__HAL_ADC_SQR2_RK(ADC_SQR2_SQ7, sConfig->Rank);
mbed_official 87:085cde657901 1007
mbed_official 87:085cde657901 1008 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 1009 hadc->Instance->SQR2 |= __HAL_ADC_SQR2_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 1010 }
mbed_official 87:085cde657901 1011 /* For Rank 13 to 16 */
mbed_official 87:085cde657901 1012 else
mbed_official 87:085cde657901 1013 {
mbed_official 87:085cde657901 1014 /* Clear the old SQx bits for the selected rank */
mbed_official 87:085cde657901 1015 hadc->Instance->SQR1 &= ~__HAL_ADC_SQR1_RK(ADC_SQR1_SQ13, sConfig->Rank);
mbed_official 87:085cde657901 1016
mbed_official 87:085cde657901 1017 /* Set the SQx bits for the selected rank */
mbed_official 87:085cde657901 1018 hadc->Instance->SQR1 |= __HAL_ADC_SQR1_RK(sConfig->Channel, sConfig->Rank);
mbed_official 87:085cde657901 1019 }
mbed_official 87:085cde657901 1020
mbed_official 87:085cde657901 1021 /* if ADC1 Channel_18 is selected enable VBAT Channel */
mbed_official 87:085cde657901 1022 if ((hadc->Instance == ADC1) && (sConfig->Channel == ADC_CHANNEL_VBAT))
mbed_official 87:085cde657901 1023 {
mbed_official 87:085cde657901 1024 /* Enable the VBAT channel*/
mbed_official 87:085cde657901 1025 ADC->CCR |= ADC_CCR_VBATE;
mbed_official 87:085cde657901 1026 }
mbed_official 87:085cde657901 1027
mbed_official 87:085cde657901 1028 /* if ADC1 Channel_16 or Channel_17 is selected enable TSVREFE Channel(Temperature sensor and VREFINT) */
mbed_official 87:085cde657901 1029 if ((hadc->Instance == ADC1) && ((sConfig->Channel == ADC_CHANNEL_TEMPSENSOR) || (sConfig->Channel == ADC_CHANNEL_VREFINT)))
mbed_official 87:085cde657901 1030 {
mbed_official 87:085cde657901 1031 /* Enable the TSVREFE channel*/
mbed_official 87:085cde657901 1032 ADC->CCR |= ADC_CCR_TSVREFE;
mbed_official 87:085cde657901 1033 }
mbed_official 87:085cde657901 1034
mbed_official 87:085cde657901 1035 /* Process unlocked */
mbed_official 87:085cde657901 1036 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 1037
mbed_official 87:085cde657901 1038 /* Return function status */
mbed_official 87:085cde657901 1039 return HAL_OK;
mbed_official 87:085cde657901 1040 }
mbed_official 87:085cde657901 1041
mbed_official 87:085cde657901 1042 /**
mbed_official 87:085cde657901 1043 * @brief Configures the analog watchdog.
mbed_official 87:085cde657901 1044 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1045 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1046 * @param AnalogWDGConfig : pointer to an ADC_AnalogWDGConfTypeDef structure
mbed_official 87:085cde657901 1047 * that contains the configuration information of ADC analog watchdog.
mbed_official 87:085cde657901 1048 * @retval HAL status
mbed_official 87:085cde657901 1049 */
mbed_official 87:085cde657901 1050 HAL_StatusTypeDef HAL_ADC_AnalogWDGConfig(ADC_HandleTypeDef* hadc, ADC_AnalogWDGConfTypeDef* AnalogWDGConfig)
mbed_official 87:085cde657901 1051 {
mbed_official 87:085cde657901 1052 #ifdef USE_FULL_ASSERT
mbed_official 87:085cde657901 1053 uint32_t tmp = 0;
mbed_official 87:085cde657901 1054 #endif /* USE_FULL_ASSERT */
mbed_official 87:085cde657901 1055
mbed_official 87:085cde657901 1056 /* Check the parameters */
mbed_official 87:085cde657901 1057 assert_param(IS_ADC_ANALOG_WATCHDOG(AnalogWDGConfig->WatchdogMode));
mbed_official 87:085cde657901 1058 assert_param(IS_ADC_CHANNEL(AnalogWDGConfig->Channel));
mbed_official 87:085cde657901 1059 assert_param(IS_FUNCTIONAL_STATE(AnalogWDGConfig->ITMode));
mbed_official 87:085cde657901 1060
mbed_official 87:085cde657901 1061 #ifdef USE_FULL_ASSERT
mbed_official 87:085cde657901 1062 tmp = __HAL_ADC_GET_RESOLUTION(hadc);
mbed_official 87:085cde657901 1063 assert_param(IS_ADC_RANGE(tmp, AnalogWDGConfig->HighThreshold));
mbed_official 87:085cde657901 1064 assert_param(IS_ADC_RANGE(tmp, AnalogWDGConfig->LowThreshold));
mbed_official 87:085cde657901 1065 #endif /* USE_FULL_ASSERT */
mbed_official 87:085cde657901 1066
mbed_official 87:085cde657901 1067 /* Process locked */
mbed_official 87:085cde657901 1068 __HAL_LOCK(hadc);
mbed_official 87:085cde657901 1069
mbed_official 87:085cde657901 1070 if(AnalogWDGConfig->ITMode == ENABLE)
mbed_official 87:085cde657901 1071 {
mbed_official 87:085cde657901 1072 /* Enable the ADC Analog watchdog interrupt */
mbed_official 87:085cde657901 1073 __HAL_ADC_ENABLE_IT(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 1074 }
mbed_official 87:085cde657901 1075 else
mbed_official 87:085cde657901 1076 {
mbed_official 87:085cde657901 1077 /* Disable the ADC Analog watchdog interrupt */
mbed_official 87:085cde657901 1078 __HAL_ADC_DISABLE_IT(hadc, ADC_IT_AWD);
mbed_official 87:085cde657901 1079 }
mbed_official 87:085cde657901 1080
mbed_official 87:085cde657901 1081 /* Clear AWDEN, JAWDEN and AWDSGL bits */
mbed_official 87:085cde657901 1082 hadc->Instance->CR1 &= ~(ADC_CR1_AWDSGL | ADC_CR1_JAWDEN | ADC_CR1_AWDEN);
mbed_official 87:085cde657901 1083
mbed_official 87:085cde657901 1084 /* Set the analog watchdog enable mode */
mbed_official 87:085cde657901 1085 hadc->Instance->CR1 |= AnalogWDGConfig->WatchdogMode;
mbed_official 87:085cde657901 1086
mbed_official 87:085cde657901 1087 /* Set the high threshold */
mbed_official 87:085cde657901 1088 hadc->Instance->HTR = AnalogWDGConfig->HighThreshold;
mbed_official 87:085cde657901 1089
mbed_official 87:085cde657901 1090 /* Set the low threshold */
mbed_official 87:085cde657901 1091 hadc->Instance->LTR = AnalogWDGConfig->LowThreshold;
mbed_official 87:085cde657901 1092
mbed_official 87:085cde657901 1093 /* Clear the Analog watchdog channel select bits */
mbed_official 87:085cde657901 1094 hadc->Instance->CR1 &= ~ADC_CR1_AWDCH;
mbed_official 87:085cde657901 1095
mbed_official 87:085cde657901 1096 /* Set the Analog watchdog channel */
mbed_official 87:085cde657901 1097 hadc->Instance->CR1 |= AnalogWDGConfig->Channel;
mbed_official 87:085cde657901 1098
mbed_official 87:085cde657901 1099 /* Process unlocked */
mbed_official 87:085cde657901 1100 __HAL_UNLOCK(hadc);
mbed_official 87:085cde657901 1101
mbed_official 87:085cde657901 1102 /* Return function status */
mbed_official 87:085cde657901 1103 return HAL_OK;
mbed_official 87:085cde657901 1104 }
mbed_official 87:085cde657901 1105
mbed_official 87:085cde657901 1106 /**
mbed_official 87:085cde657901 1107 * @}
mbed_official 87:085cde657901 1108 */
mbed_official 87:085cde657901 1109
mbed_official 87:085cde657901 1110 /** @defgroup ADC_Group4 ADC Peripheral State functions
mbed_official 87:085cde657901 1111 * @brief ADC Peripheral State functions
mbed_official 87:085cde657901 1112 *
mbed_official 87:085cde657901 1113 @verbatim
mbed_official 87:085cde657901 1114 ===============================================================================
mbed_official 87:085cde657901 1115 ##### Peripheral State and errors functions #####
mbed_official 87:085cde657901 1116 ===============================================================================
mbed_official 87:085cde657901 1117 [..]
mbed_official 87:085cde657901 1118 This subsection provides functions allowing to
mbed_official 87:085cde657901 1119 (+) Check the ADC state
mbed_official 87:085cde657901 1120 (+) Check the ADC Error
mbed_official 87:085cde657901 1121
mbed_official 87:085cde657901 1122 @endverbatim
mbed_official 87:085cde657901 1123 * @{
mbed_official 87:085cde657901 1124 */
mbed_official 87:085cde657901 1125
mbed_official 87:085cde657901 1126 /**
mbed_official 87:085cde657901 1127 * @brief return the ADC state
mbed_official 87:085cde657901 1128 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1129 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1130 * @retval HAL state
mbed_official 87:085cde657901 1131 */
mbed_official 87:085cde657901 1132 HAL_ADC_StateTypeDef HAL_ADC_GetState(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 1133 {
mbed_official 87:085cde657901 1134 /* Return ADC state */
mbed_official 87:085cde657901 1135 return hadc->State;
mbed_official 87:085cde657901 1136 }
mbed_official 87:085cde657901 1137
mbed_official 87:085cde657901 1138 /**
mbed_official 87:085cde657901 1139 * @brief Return the ADC error code
mbed_official 87:085cde657901 1140 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1141 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1142 * @retval ADC Error Code
mbed_official 87:085cde657901 1143 */
mbed_official 87:085cde657901 1144 uint32_t HAL_ADC_GetError(ADC_HandleTypeDef *hadc)
mbed_official 87:085cde657901 1145 {
mbed_official 87:085cde657901 1146 return hadc->ErrorCode;
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 */
mbed_official 87:085cde657901 1152
mbed_official 87:085cde657901 1153 /**
mbed_official 87:085cde657901 1154 * @brief Initializes the ADCx peripheral according to the specified parameters
mbed_official 87:085cde657901 1155 * in the ADC_InitStruct without initializing the ADC MSP.
mbed_official 87:085cde657901 1156 * @param hadc: pointer to a ADC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 1157 * the configuration information for the specified ADC.
mbed_official 87:085cde657901 1158 * @retval None
mbed_official 87:085cde657901 1159 */
mbed_official 87:085cde657901 1160 static void ADC_Init(ADC_HandleTypeDef* hadc)
mbed_official 87:085cde657901 1161 {
mbed_official 87:085cde657901 1162
mbed_official 87:085cde657901 1163 /* Set ADC parameters */
mbed_official 87:085cde657901 1164 /* Set the ADC clock prescaler */
mbed_official 87:085cde657901 1165 ADC->CCR &= ~(ADC_CCR_ADCPRE);
mbed_official 87:085cde657901 1166 ADC->CCR |= hadc->Init.ClockPrescaler;
mbed_official 87:085cde657901 1167
mbed_official 87:085cde657901 1168 /* Set ADC scan mode */
mbed_official 87:085cde657901 1169 hadc->Instance->CR1 &= ~(ADC_CR1_SCAN);
mbed_official 87:085cde657901 1170 hadc->Instance->CR1 |= __HAL_ADC_CR1_SCANCONV(hadc->Init.ScanConvMode);
mbed_official 87:085cde657901 1171
mbed_official 87:085cde657901 1172 /* Set ADC resolution */
mbed_official 87:085cde657901 1173 hadc->Instance->CR1 &= ~(ADC_CR1_RES);
mbed_official 87:085cde657901 1174 hadc->Instance->CR1 |= hadc->Init.Resolution;
mbed_official 87:085cde657901 1175
mbed_official 87:085cde657901 1176 /* Set ADC data alignment */
mbed_official 87:085cde657901 1177 hadc->Instance->CR2 &= ~(ADC_CR2_ALIGN);
mbed_official 87:085cde657901 1178 hadc->Instance->CR2 |= hadc->Init.DataAlign;
mbed_official 87:085cde657901 1179
mbed_official 87:085cde657901 1180 /* Select external trigger to start conversion */
mbed_official 87:085cde657901 1181 hadc->Instance->CR2 &= ~(ADC_CR2_EXTSEL);
mbed_official 87:085cde657901 1182 hadc->Instance->CR2 |= hadc->Init.ExternalTrigConv;
mbed_official 87:085cde657901 1183
mbed_official 87:085cde657901 1184 /* Select external trigger polarity */
mbed_official 87:085cde657901 1185 hadc->Instance->CR2 &= ~(ADC_CR2_EXTEN);
mbed_official 87:085cde657901 1186 hadc->Instance->CR2 |= hadc->Init.ExternalTrigConvEdge;
mbed_official 87:085cde657901 1187
mbed_official 87:085cde657901 1188 /* Enable or disable ADC continuous conversion mode */
mbed_official 87:085cde657901 1189 hadc->Instance->CR2 &= ~(ADC_CR2_CONT);
mbed_official 87:085cde657901 1190 hadc->Instance->CR2 |= __HAL_ADC_CR2_CONTINUOUS(hadc->Init.ContinuousConvMode);
mbed_official 87:085cde657901 1191
mbed_official 87:085cde657901 1192 if (hadc->Init.DiscontinuousConvMode != DISABLE)
mbed_official 87:085cde657901 1193 {
mbed_official 87:085cde657901 1194 assert_param(IS_ADC_REGULAR_DISC_NUMBER(hadc->Init.NbrOfDiscConversion));
mbed_official 87:085cde657901 1195
mbed_official 87:085cde657901 1196 /* Enable the selected ADC regular discontinuous mode */
mbed_official 87:085cde657901 1197 hadc->Instance->CR1 |= (uint32_t)ADC_CR1_DISCEN;
mbed_official 87:085cde657901 1198
mbed_official 87:085cde657901 1199 /* Set the number of channels to be converted in discontinuous mode */
mbed_official 87:085cde657901 1200 hadc->Instance->CR1 &= ~(ADC_CR1_DISCNUM);
mbed_official 87:085cde657901 1201 hadc->Instance->CR1 |= __HAL_ADC_CR1_DISCONTINUOUS(hadc->Init.NbrOfDiscConversion);
mbed_official 87:085cde657901 1202 }
mbed_official 87:085cde657901 1203 else
mbed_official 87:085cde657901 1204 {
mbed_official 87:085cde657901 1205 /* Disable the selected ADC regular discontinuous mode */
mbed_official 87:085cde657901 1206 hadc->Instance->CR1 &= ~(ADC_CR1_DISCEN);
mbed_official 87:085cde657901 1207 }
mbed_official 87:085cde657901 1208
mbed_official 87:085cde657901 1209 /* Set ADC number of conversion */
mbed_official 87:085cde657901 1210 hadc->Instance->SQR1 &= ~(ADC_SQR1_L);
mbed_official 87:085cde657901 1211 hadc->Instance->SQR1 |= __HAL_ADC_SQR1(hadc->Init.NbrOfConversion);
mbed_official 87:085cde657901 1212
mbed_official 87:085cde657901 1213 /* Enable or disable ADC DMA continuous request */
mbed_official 87:085cde657901 1214 hadc->Instance->CR2 &= ~(ADC_CR2_DDS);
mbed_official 87:085cde657901 1215 hadc->Instance->CR2 |= __HAL_ADC_CR2_DMAContReq(hadc->Init.DMAContinuousRequests);
mbed_official 87:085cde657901 1216
mbed_official 87:085cde657901 1217 /* Enable or disable ADC end of conversion selection */
mbed_official 87:085cde657901 1218 hadc->Instance->CR2 &= ~(ADC_CR2_EOCS);
mbed_official 87:085cde657901 1219 hadc->Instance->CR2 |= __HAL_ADC_CR2_EOCSelection(hadc->Init.EOCSelection);
mbed_official 87:085cde657901 1220 }
mbed_official 87:085cde657901 1221
mbed_official 87:085cde657901 1222 /**
mbed_official 87:085cde657901 1223 * @brief DMA transfer complete callback.
mbed_official 226:b062af740e40 1224 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1225 * the configuration information for the specified DMA module.
mbed_official 87:085cde657901 1226 * @retval None
mbed_official 87:085cde657901 1227 */
mbed_official 87:085cde657901 1228 static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1229 {
mbed_official 87:085cde657901 1230 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1231
mbed_official 87:085cde657901 1232 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 1233 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 1234 {
mbed_official 87:085cde657901 1235 /* Change ADC state */
mbed_official 87:085cde657901 1236 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 1237 }
mbed_official 87:085cde657901 1238 else
mbed_official 87:085cde657901 1239 {
mbed_official 87:085cde657901 1240 /* Change ADC state */
mbed_official 87:085cde657901 1241 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 1242 }
mbed_official 87:085cde657901 1243
mbed_official 87:085cde657901 1244 HAL_ADC_ConvCpltCallback(hadc);
mbed_official 87:085cde657901 1245 }
mbed_official 87:085cde657901 1246
mbed_official 87:085cde657901 1247 /**
mbed_official 87:085cde657901 1248 * @brief DMA half transfer complete callback.
mbed_official 226:b062af740e40 1249 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1250 * the configuration information for the specified DMA module.
mbed_official 87:085cde657901 1251 * @retval None
mbed_official 87:085cde657901 1252 */
mbed_official 87:085cde657901 1253 static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1254 {
mbed_official 87:085cde657901 1255 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1256 /* Conversion complete callback */
mbed_official 87:085cde657901 1257 HAL_ADC_ConvHalfCpltCallback(hadc);
mbed_official 87:085cde657901 1258 }
mbed_official 87:085cde657901 1259
mbed_official 87:085cde657901 1260 /**
mbed_official 87:085cde657901 1261 * @brief DMA error callback
mbed_official 226:b062af740e40 1262 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
mbed_official 226:b062af740e40 1263 * the configuration information for the specified DMA module.
mbed_official 87:085cde657901 1264 * @retval None
mbed_official 87:085cde657901 1265 */
mbed_official 87:085cde657901 1266 static void ADC_DMAError(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1267 {
mbed_official 87:085cde657901 1268 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1269 hadc->State= HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 1270 /* Set ADC error code to DMA error */
mbed_official 87:085cde657901 1271 hadc->ErrorCode |= HAL_ADC_ERROR_DMA;
mbed_official 87:085cde657901 1272 HAL_ADC_ErrorCallback(hadc);
mbed_official 87:085cde657901 1273 }
mbed_official 87:085cde657901 1274
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 #endif /* HAL_ADC_MODULE_ENABLED */
mbed_official 87:085cde657901 1281 /**
mbed_official 87:085cde657901 1282 * @}
mbed_official 87:085cde657901 1283 */
mbed_official 87:085cde657901 1284
mbed_official 87:085cde657901 1285 /**
mbed_official 87:085cde657901 1286 * @}
mbed_official 87:085cde657901 1287 */
mbed_official 87:085cde657901 1288
mbed_official 87:085cde657901 1289 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/