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@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****/