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_STM32F3/stm32f3xx_hal_adc.h@632:7687fb9c4f91, 2015-09-28 (annotated)

Committer:
mbed_official
Date:
Mon Sep 28 14:00:11 2015 +0100
Revision:
632:7687fb9c4f91
Parent:
385:be64abf45658
Child:
634:ac7d6880524d
Synchronized with git revision f7ce4ed029cc611121464252ff28d5e8beb895b0



Full URL: https://github.com/mbedmicro/mbed/commit/f7ce4ed029cc611121464252ff28d5e8beb895b0/



NUCLEO_F303K8 - add support of the STM32F303K8

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 237:f3da66175598 1 /**
mbed_official 237:f3da66175598 2 ******************************************************************************
mbed_official 237:f3da66175598 3 * @file stm32f3xx_hal_adc.h
mbed_official 237:f3da66175598 4 * @author MCD Application Team
mbed_official 632:7687fb9c4f91 5 * @version V1.1.1
mbed_official 632:7687fb9c4f91 6 * @date 19-June-2015
mbed_official 237:f3da66175598 7 * @brief Header file containing functions prototypes of ADC HAL library.
mbed_official 237:f3da66175598 8 ******************************************************************************
mbed_official 237:f3da66175598 9 * @attention
mbed_official 237:f3da66175598 10 *
mbed_official 632:7687fb9c4f91 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 237:f3da66175598 12 *
mbed_official 237:f3da66175598 13 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 237:f3da66175598 14 * are permitted provided that the following conditions are met:
mbed_official 237:f3da66175598 15 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 237:f3da66175598 16 * this list of conditions and the following disclaimer.
mbed_official 237:f3da66175598 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 237:f3da66175598 18 * this list of conditions and the following disclaimer in the documentation
mbed_official 237:f3da66175598 19 * and/or other materials provided with the distribution.
mbed_official 237:f3da66175598 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 237:f3da66175598 21 * may be used to endorse or promote products derived from this software
mbed_official 237:f3da66175598 22 * without specific prior written permission.
mbed_official 237:f3da66175598 23 *
mbed_official 237:f3da66175598 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 237:f3da66175598 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 237:f3da66175598 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 237:f3da66175598 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 237:f3da66175598 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 237:f3da66175598 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 237:f3da66175598 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 237:f3da66175598 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 237:f3da66175598 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 237:f3da66175598 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 237:f3da66175598 34 *
mbed_official 237:f3da66175598 35 ******************************************************************************
mbed_official 237:f3da66175598 36 */
mbed_official 237:f3da66175598 37
mbed_official 237:f3da66175598 38 /* Define to prevent recursive inclusion -------------------------------------*/
mbed_official 237:f3da66175598 39 #ifndef __STM32F3xx_ADC_H
mbed_official 237:f3da66175598 40 #define __STM32F3xx_ADC_H
mbed_official 237:f3da66175598 41
mbed_official 237:f3da66175598 42 #ifdef __cplusplus
mbed_official 237:f3da66175598 43 extern "C" {
mbed_official 237:f3da66175598 44 #endif
mbed_official 237:f3da66175598 45
mbed_official 237:f3da66175598 46 /* Includes ------------------------------------------------------------------*/
mbed_official 237:f3da66175598 47 #include "stm32f3xx_hal_def.h"
mbed_official 237:f3da66175598 48 #include "stm32f3xx_hal_adc_ex.h"
mbed_official 237:f3da66175598 49
mbed_official 237:f3da66175598 50 /** @addtogroup STM32F3xx_HAL_Driver
mbed_official 237:f3da66175598 51 * @{
mbed_official 237:f3da66175598 52 */
mbed_official 237:f3da66175598 53
mbed_official 237:f3da66175598 54 /** @addtogroup ADC
mbed_official 237:f3da66175598 55 * @{
mbed_official 237:f3da66175598 56 */
mbed_official 237:f3da66175598 57
mbed_official 237:f3da66175598 58 /* Exported types ------------------------------------------------------------*/
mbed_official 375:3d36234a1087 59 /** @defgroup ADC_Exported_Types ADC Exported Types
mbed_official 375:3d36234a1087 60 * @{
mbed_official 375:3d36234a1087 61 */
mbed_official 237:f3da66175598 62 /**
mbed_official 237:f3da66175598 63 * @brief HAL ADC state machine: ADC States structure definition
mbed_official 237:f3da66175598 64 */
mbed_official 237:f3da66175598 65 typedef enum
mbed_official 237:f3da66175598 66 {
mbed_official 237:f3da66175598 67 HAL_ADC_STATE_RESET = 0x00, /*!< ADC not yet initialized or disabled */
mbed_official 237:f3da66175598 68 HAL_ADC_STATE_READY = 0x01, /*!< ADC peripheral ready for use */
mbed_official 237:f3da66175598 69 HAL_ADC_STATE_BUSY = 0x02, /*!< An internal process is ongoing */
mbed_official 237:f3da66175598 70 HAL_ADC_STATE_BUSY_REG = 0x12, /*!< Regular conversion is ongoing */
mbed_official 237:f3da66175598 71 HAL_ADC_STATE_BUSY_INJ = 0x22, /*!< Injected conversion is ongoing */
mbed_official 237:f3da66175598 72 HAL_ADC_STATE_BUSY_INJ_REG = 0x32, /*!< Injected and regular conversion are ongoing */
mbed_official 237:f3da66175598 73 HAL_ADC_STATE_TIMEOUT = 0x03, /*!< Timeout state */
mbed_official 237:f3da66175598 74 HAL_ADC_STATE_ERROR = 0x04, /*!< ADC state error */
mbed_official 237:f3da66175598 75 HAL_ADC_STATE_EOC = 0x05, /*!< Conversion is completed */
mbed_official 237:f3da66175598 76 HAL_ADC_STATE_EOC_REG = 0x15, /*!< Regular conversion is completed */
mbed_official 237:f3da66175598 77 HAL_ADC_STATE_EOC_INJ = 0x25, /*!< Injected conversion is completed */
mbed_official 237:f3da66175598 78 HAL_ADC_STATE_EOC_INJ_REG = 0x35, /*!< Injected and regular conversion are completed */
mbed_official 237:f3da66175598 79 HAL_ADC_STATE_AWD = 0x06, /*!< ADC state analog watchdog (main analog watchdog, present on all STM32 devices) */
mbed_official 237:f3da66175598 80 HAL_ADC_STATE_AWD2 = 0x07, /*!< ADC state analog watchdog (additional analog watchdog, present only on STM32F3 devices) */
mbed_official 237:f3da66175598 81 HAL_ADC_STATE_AWD3 = 0x08, /*!< ADC state analog watchdog (additional analog watchdog, present only on STM32F3 devices) */
mbed_official 237:f3da66175598 82 }HAL_ADC_StateTypeDef;
mbed_official 237:f3da66175598 83
mbed_official 237:f3da66175598 84 /**
mbed_official 237:f3da66175598 85 * @brief ADC handle Structure definition
mbed_official 237:f3da66175598 86 */
mbed_official 237:f3da66175598 87 typedef struct __ADC_HandleTypeDef
mbed_official 237:f3da66175598 88 {
mbed_official 237:f3da66175598 89 ADC_TypeDef *Instance; /*!< Register base address */
mbed_official 237:f3da66175598 90
mbed_official 237:f3da66175598 91 ADC_InitTypeDef Init; /*!< ADC required parameters */
mbed_official 237:f3da66175598 92
mbed_official 237:f3da66175598 93 __IO uint32_t NbrOfConversionRank ; /*!< ADC conversion rank counter */
mbed_official 237:f3da66175598 94
mbed_official 237:f3da66175598 95 DMA_HandleTypeDef *DMA_Handle; /*!< Pointer DMA Handler */
mbed_official 237:f3da66175598 96
mbed_official 237:f3da66175598 97 HAL_LockTypeDef Lock; /*!< ADC locking object */
mbed_official 237:f3da66175598 98
mbed_official 237:f3da66175598 99 __IO HAL_ADC_StateTypeDef State; /*!< ADC communication state */
mbed_official 237:f3da66175598 100
mbed_official 237:f3da66175598 101 __IO uint32_t ErrorCode; /*!< ADC Error code */
mbed_official 237:f3da66175598 102 }ADC_HandleTypeDef;
mbed_official 375:3d36234a1087 103 /**
mbed_official 375:3d36234a1087 104 * @}
mbed_official 375:3d36234a1087 105 */
mbed_official 237:f3da66175598 106
mbed_official 237:f3da66175598 107 /* Exported constants --------------------------------------------------------*/
mbed_official 237:f3da66175598 108 /* Exported macros -----------------------------------------------------------*/
mbed_official 237:f3da66175598 109
mbed_official 375:3d36234a1087 110 /** @defgroup ADC_Exported_Macro ADC Exported Macros
mbed_official 237:f3da66175598 111 * @{
mbed_official 237:f3da66175598 112 */
mbed_official 237:f3da66175598 113 /** @brief Reset ADC handle state
mbed_official 237:f3da66175598 114 * @param __HANDLE__: ADC handle
mbed_official 237:f3da66175598 115 * @retval None
mbed_official 237:f3da66175598 116 */
mbed_official 237:f3da66175598 117 #define __HAL_ADC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_ADC_STATE_RESET)
mbed_official 237:f3da66175598 118
mbed_official 237:f3da66175598 119 /**
mbed_official 237:f3da66175598 120 * @}
mbed_official 237:f3da66175598 121 */
mbed_official 237:f3da66175598 122
mbed_official 237:f3da66175598 123
mbed_official 375:3d36234a1087 124 /* Include ADC HAL Extended module */
mbed_official 237:f3da66175598 125 #include "stm32f3xx_hal_adc_ex.h"
mbed_official 237:f3da66175598 126
mbed_official 237:f3da66175598 127 /* Exported functions --------------------------------------------------------*/
mbed_official 375:3d36234a1087 128 /** @addtogroup ADC_Exported_Functions ADC Exported Functions
mbed_official 375:3d36234a1087 129 * @{
mbed_official 375:3d36234a1087 130 */
mbed_official 375:3d36234a1087 131
mbed_official 375:3d36234a1087 132 /** @addtogroup ADC_Exported_Functions_Group1 Initialization and de-initialization functions
mbed_official 375:3d36234a1087 133 * @brief Initialization and Configuration functions
mbed_official 375:3d36234a1087 134 * @{
mbed_official 375:3d36234a1087 135 */
mbed_official 237:f3da66175598 136 /* Initialization and de-initialization functions **********************************/
mbed_official 237:f3da66175598 137 HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 138 HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef *hadc);
mbed_official 237:f3da66175598 139 void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 140 void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc);
mbed_official 375:3d36234a1087 141 /**
mbed_official 375:3d36234a1087 142 * @}
mbed_official 375:3d36234a1087 143 */
mbed_official 237:f3da66175598 144
mbed_official 375:3d36234a1087 145 /** @addtogroup ADC_Exported_Functions_Group2 Input and Output operation functions
mbed_official 375:3d36234a1087 146 * @brief IO operation functions
mbed_official 375:3d36234a1087 147 * @{
mbed_official 375:3d36234a1087 148 */
mbed_official 237:f3da66175598 149 /* Blocking mode: Polling */
mbed_official 237:f3da66175598 150 HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 151 HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 152 HAL_StatusTypeDef HAL_ADC_PollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout);
mbed_official 237:f3da66175598 153 HAL_StatusTypeDef HAL_ADC_PollForEvent(ADC_HandleTypeDef* hadc, uint32_t EventType, uint32_t Timeout);
mbed_official 237:f3da66175598 154
mbed_official 237:f3da66175598 155 /* Non-blocking mode: Interruption */
mbed_official 237:f3da66175598 156 HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 157 HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 158
mbed_official 237:f3da66175598 159 /* Non-blocking mode: DMA */
mbed_official 237:f3da66175598 160 HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length);
mbed_official 237:f3da66175598 161 HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 162
mbed_official 237:f3da66175598 163 /* ADC retrieve conversion value intended to be used with polling or interruption */
mbed_official 237:f3da66175598 164 uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 165
mbed_official 237:f3da66175598 166 /* ADC IRQHandler and Callbacks used in non-blocking modes (Interruption and DMA) */
mbed_official 237:f3da66175598 167 void HAL_ADC_IRQHandler(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 168 void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 169 void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 170 void HAL_ADC_LevelOutOfWindowCallback(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 171 void HAL_ADC_ErrorCallback(ADC_HandleTypeDef *hadc);
mbed_official 375:3d36234a1087 172 /**
mbed_official 375:3d36234a1087 173 * @}
mbed_official 375:3d36234a1087 174 */
mbed_official 237:f3da66175598 175
mbed_official 375:3d36234a1087 176 /** @addtogroup ADC_Exported_Functions_Group3 Peripheral Control functions
mbed_official 375:3d36234a1087 177 * @brief Peripheral Control functions
mbed_official 375:3d36234a1087 178 * @{
mbed_official 375:3d36234a1087 179 */
mbed_official 237:f3da66175598 180 /* Peripheral Control functions ***********************************************/
mbed_official 237:f3da66175598 181 HAL_StatusTypeDef HAL_ADC_ConfigChannel(ADC_HandleTypeDef* hadc, ADC_ChannelConfTypeDef* sConfig);
mbed_official 237:f3da66175598 182 HAL_StatusTypeDef HAL_ADC_AnalogWDGConfig(ADC_HandleTypeDef* hadc, ADC_AnalogWDGConfTypeDef* AnalogWDGConfig);
mbed_official 375:3d36234a1087 183 /**
mbed_official 375:3d36234a1087 184 * @}
mbed_official 375:3d36234a1087 185 */
mbed_official 237:f3da66175598 186
mbed_official 375:3d36234a1087 187 /** @defgroup ADC_Exported_Functions_Group4 Peripheral State functions
mbed_official 375:3d36234a1087 188 * @brief ADC Peripheral State functions
mbed_official 375:3d36234a1087 189 * @{
mbed_official 375:3d36234a1087 190 */
mbed_official 237:f3da66175598 191 /* Peripheral State functions *************************************************/
mbed_official 237:f3da66175598 192 HAL_ADC_StateTypeDef HAL_ADC_GetState(ADC_HandleTypeDef* hadc);
mbed_official 237:f3da66175598 193 uint32_t HAL_ADC_GetError(ADC_HandleTypeDef *hadc);
mbed_official 375:3d36234a1087 194 /**
mbed_official 375:3d36234a1087 195 * @}
mbed_official 375:3d36234a1087 196 */
mbed_official 237:f3da66175598 197
mbed_official 375:3d36234a1087 198 /**
mbed_official 375:3d36234a1087 199 * @}
mbed_official 375:3d36234a1087 200 */
mbed_official 237:f3da66175598 201
mbed_official 237:f3da66175598 202 /**
mbed_official 237:f3da66175598 203 * @}
mbed_official 237:f3da66175598 204 */
mbed_official 237:f3da66175598 205
mbed_official 237:f3da66175598 206 /**
mbed_official 237:f3da66175598 207 * @}
mbed_official 237:f3da66175598 208 */
mbed_official 237:f3da66175598 209
mbed_official 237:f3da66175598 210 #ifdef __cplusplus
mbed_official 237:f3da66175598 211 }
mbed_official 237:f3da66175598 212 #endif
mbed_official 237:f3da66175598 213
mbed_official 237:f3da66175598 214 #endif /*__STM32F3xx_ADC_H */
mbed_official 237:f3da66175598 215
mbed_official 237:f3da66175598 216
mbed_official 237:f3da66175598 217 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/