shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_adc.c@106:ced8cbb51063, 2014-02-26 (annotated)

Committer:
mbed_official
Date:
Wed Feb 26 09:45:12 2014 +0000
Revision:
106:ced8cbb51063
Parent:
87:085cde657901
Child:
226:b062af740e40
Synchronized with git revision 4222735eff5868389433f0e9271976b39c8115cd



Full URL: https://github.com/mbedmicro/mbed/commit/4222735eff5868389433f0e9271976b39c8115cd/



[NUCLEO_xxx] Update STM32CubeF4 driver V1.0.0 + update license

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 106:ced8cbb51063 5 * @version V1.0.0
mbed_official 106:ced8cbb51063 6 * @date 18-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 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 87:085cde657901 413 * last transfer and End of conversion selection).
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 87:085cde657901 783 * @retval None
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 87:085cde657901 849 * @retval None
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 87:085cde657901 1224 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1225 * @retval None
mbed_official 87:085cde657901 1226 */
mbed_official 87:085cde657901 1227 static void ADC_DMAConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1228 {
mbed_official 87:085cde657901 1229 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1230
mbed_official 87:085cde657901 1231 /* Check if an injected conversion is ready */
mbed_official 87:085cde657901 1232 if(hadc->State == HAL_ADC_STATE_EOC_INJ)
mbed_official 87:085cde657901 1233 {
mbed_official 87:085cde657901 1234 /* Change ADC state */
mbed_official 87:085cde657901 1235 hadc->State = HAL_ADC_STATE_EOC_INJ_REG;
mbed_official 87:085cde657901 1236 }
mbed_official 87:085cde657901 1237 else
mbed_official 87:085cde657901 1238 {
mbed_official 87:085cde657901 1239 /* Change ADC state */
mbed_official 87:085cde657901 1240 hadc->State = HAL_ADC_STATE_EOC_REG;
mbed_official 87:085cde657901 1241 }
mbed_official 87:085cde657901 1242
mbed_official 87:085cde657901 1243 HAL_ADC_ConvCpltCallback(hadc);
mbed_official 87:085cde657901 1244 }
mbed_official 87:085cde657901 1245
mbed_official 87:085cde657901 1246 /**
mbed_official 87:085cde657901 1247 * @brief DMA half transfer complete callback.
mbed_official 87:085cde657901 1248 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1249 * @retval None
mbed_official 87:085cde657901 1250 */
mbed_official 87:085cde657901 1251 static void ADC_DMAHalfConvCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1252 {
mbed_official 87:085cde657901 1253 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1254 /* Conversion complete callback */
mbed_official 87:085cde657901 1255 HAL_ADC_ConvHalfCpltCallback(hadc);
mbed_official 87:085cde657901 1256 }
mbed_official 87:085cde657901 1257
mbed_official 87:085cde657901 1258 /**
mbed_official 87:085cde657901 1259 * @brief DMA error callback
mbed_official 87:085cde657901 1260 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 1261 * @retval None
mbed_official 87:085cde657901 1262 */
mbed_official 87:085cde657901 1263 static void ADC_DMAError(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 1264 {
mbed_official 87:085cde657901 1265 ADC_HandleTypeDef* hadc = ( ADC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 1266 hadc->State= HAL_ADC_STATE_ERROR;
mbed_official 87:085cde657901 1267 /* Set ADC error code to DMA error */
mbed_official 87:085cde657901 1268 hadc->ErrorCode |= HAL_ADC_ERROR_DMA;
mbed_official 87:085cde657901 1269 HAL_ADC_ErrorCallback(hadc);
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 * @}
mbed_official 87:085cde657901 1275 */
mbed_official 87:085cde657901 1276
mbed_official 87:085cde657901 1277 #endif /* HAL_ADC_MODULE_ENABLED */
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 * @}
mbed_official 87:085cde657901 1284 */
mbed_official 87:085cde657901 1285
mbed_official 87:085cde657901 1286 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/