Fawwaz Nadzmy / mbed-STM

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32L1/analogin_api.c@150:02e0a0aed4ec, 2016-11-08 (annotated)

Committer:
<>
Date:
Tue Nov 08 17:45:16 2016 +0000
Revision:
150:02e0a0aed4ec
Parent:
149:156823d33999 
This updates the lib to the mbed lib v129

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 149:156823d33999 1 /* mbed Microcontroller Library
<> 149:156823d33999 2 * Copyright (c) 2016, STMicroelectronics
<> 149:156823d33999 3 * All rights reserved.
<> 149:156823d33999 4 *
<> 149:156823d33999 5 * Redistribution and use in source and binary forms, with or without
<> 149:156823d33999 6 * modification, are permitted provided that the following conditions are met:
<> 149:156823d33999 7 *
<> 149:156823d33999 8 * 1. Redistributions of source code must retain the above copyright notice,
<> 149:156823d33999 9 * this list of conditions and the following disclaimer.
<> 149:156823d33999 10 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 149:156823d33999 11 * this list of conditions and the following disclaimer in the documentation
<> 149:156823d33999 12 * and/or other materials provided with the distribution.
<> 149:156823d33999 13 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 149:156823d33999 14 * may be used to endorse or promote products derived from this software
<> 149:156823d33999 15 * without specific prior written permission.
<> 149:156823d33999 16 *
<> 149:156823d33999 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 149:156823d33999 18 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 149:156823d33999 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 149:156823d33999 20 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 149:156823d33999 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 149:156823d33999 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 149:156823d33999 23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 149:156823d33999 24 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 149:156823d33999 25 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 149:156823d33999 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 149:156823d33999 27 */
<> 149:156823d33999 28 #include "mbed_assert.h"
<> 149:156823d33999 29 #include "analogin_api.h"
<> 149:156823d33999 30
<> 149:156823d33999 31 #if DEVICE_ANALOGIN
<> 149:156823d33999 32
<> 149:156823d33999 33 #include "wait_api.h"
<> 149:156823d33999 34 #include "cmsis.h"
<> 149:156823d33999 35 #include "pinmap.h"
<> 149:156823d33999 36 #include "mbed_error.h"
<> 149:156823d33999 37 #include "PeripheralPins.h"
<> 149:156823d33999 38
<> 149:156823d33999 39 ADC_HandleTypeDef AdcHandle;
<> 149:156823d33999 40
<> 149:156823d33999 41 int adc_inited = 0;
<> 149:156823d33999 42
<> 149:156823d33999 43 void analogin_init(analogin_t *obj, PinName pin)
<> 149:156823d33999 44 {
<> 149:156823d33999 45 RCC_OscInitTypeDef RCC_OscInitStruct;
<> 149:156823d33999 46
<> 149:156823d33999 47 // Get the peripheral name from the pin and assign it to the object
<> 149:156823d33999 48 obj->adc = (ADCName)pinmap_peripheral(pin, PinMap_ADC);
<> 149:156823d33999 49 MBED_ASSERT(obj->adc != (ADCName)NC);
<> 149:156823d33999 50
<> 149:156823d33999 51 // Get the pin function and assign the used channel to the object
<> 149:156823d33999 52 uint32_t function = pinmap_function(pin, PinMap_ADC);
<> 149:156823d33999 53 MBED_ASSERT(function != (uint32_t)NC);
<> 149:156823d33999 54 obj->channel = STM_PIN_CHANNEL(function);
<> 149:156823d33999 55
<> 150:02e0a0aed4ec 56 // Configure GPIO excepted for internal channels (Temperature, Vref, Vbat, ...)
<> 150:02e0a0aed4ec 57 // ADC Internal Channels "pins" are described in PinNames.h and must have a value >= 0xF0
<> 150:02e0a0aed4ec 58 if (pin < 0xF0) {
<> 149:156823d33999 59 pinmap_pinout(pin, PinMap_ADC);
<> 149:156823d33999 60 }
<> 149:156823d33999 61
<> 149:156823d33999 62 // Save pin number for the read function
<> 149:156823d33999 63 obj->pin = pin;
<> 149:156823d33999 64
<> 149:156823d33999 65 // The ADC initialization is done once
<> 149:156823d33999 66 if (adc_inited == 0) {
<> 149:156823d33999 67 adc_inited = 1;
<> 149:156823d33999 68
<> 149:156823d33999 69 // Enable the HSI (to clock the ADC)
<> 149:156823d33999 70 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
<> 149:156823d33999 71 RCC_OscInitStruct.HSIState = RCC_HSI_ON;
<> 149:156823d33999 72 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
<> 149:156823d33999 73 HAL_RCC_OscConfig(&RCC_OscInitStruct);
<> 149:156823d33999 74
<> 149:156823d33999 75 AdcHandle.Instance = (ADC_TypeDef *)(obj->adc);
<> 149:156823d33999 76
<> 149:156823d33999 77 // Enable ADC clock
<> 149:156823d33999 78 __ADC1_CLK_ENABLE();
<> 149:156823d33999 79
<> 149:156823d33999 80 // Configure ADC
<> 149:156823d33999 81 AdcHandle.Init.ClockPrescaler = ADC_CLOCK_ASYNC_DIV4;
<> 149:156823d33999 82 AdcHandle.Init.Resolution = ADC_RESOLUTION12b;
<> 149:156823d33999 83 AdcHandle.Init.DataAlign = ADC_DATAALIGN_RIGHT;
<> 149:156823d33999 84 AdcHandle.Init.ScanConvMode = DISABLE; // Sequencer disabled (ADC conversion on only 1 channel: channel set on rank 1)
<> 149:156823d33999 85 AdcHandle.Init.EOCSelection = EOC_SINGLE_CONV; // On STM32L1xx ADC, overrun detection is enabled only if EOC selection is set to each conversion (or transfer by DMA enabled, this is not the case in this example).
<> 149:156823d33999 86 AdcHandle.Init.LowPowerAutoWait = ADC_AUTOWAIT_UNTIL_DATA_READ; // Enable the dynamic low power Auto Delay: new conversion start only when the previous conversion (for regular group) or previous sequence (for injected group) has been treated by user software.
<> 149:156823d33999 87 AdcHandle.Init.LowPowerAutoPowerOff = ADC_AUTOPOWEROFF_IDLE_PHASE; // Enable the auto-off mode: the ADC automatically powers-off after a conversion and automatically wakes-up when a new conversion is triggered (with startup time between trigger and start of sampling).
<> 149:156823d33999 88 AdcHandle.Init.ChannelsBank = ADC_CHANNELS_BANK_A;
<> 149:156823d33999 89 AdcHandle.Init.ContinuousConvMode = DISABLE; // Continuous mode disabled to have only 1 conversion at each conversion trig
<> 149:156823d33999 90 AdcHandle.Init.NbrOfConversion = 1; // Parameter discarded because sequencer is disabled
<> 149:156823d33999 91 AdcHandle.Init.DiscontinuousConvMode = DISABLE; // Parameter discarded because sequencer is disabled
<> 149:156823d33999 92 AdcHandle.Init.NbrOfDiscConversion = 1; // Parameter discarded because sequencer is disabled
<> 149:156823d33999 93 AdcHandle.Init.ExternalTrigConv = 0; // Not used
<> 149:156823d33999 94 AdcHandle.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE;
<> 149:156823d33999 95 AdcHandle.Init.DMAContinuousRequests = DISABLE;
<> 149:156823d33999 96
<> 149:156823d33999 97 if (HAL_ADC_Init(&AdcHandle) != HAL_OK) {
<> 149:156823d33999 98 error("Cannot initialize ADC");
<> 149:156823d33999 99 }
<> 149:156823d33999 100 }
<> 149:156823d33999 101 }
<> 149:156823d33999 102
<> 149:156823d33999 103 static inline uint16_t adc_read(analogin_t *obj)
<> 149:156823d33999 104 {
<> 149:156823d33999 105 ADC_ChannelConfTypeDef sConfig = {0};
<> 149:156823d33999 106
<> 149:156823d33999 107 AdcHandle.Instance = (ADC_TypeDef *)(obj->adc);
<> 149:156823d33999 108
<> 149:156823d33999 109 // Configure ADC channel
<> 149:156823d33999 110 switch (obj->channel) {
<> 149:156823d33999 111 case 0:
<> 149:156823d33999 112 sConfig.Channel = ADC_CHANNEL_0;
<> 149:156823d33999 113 break;
<> 149:156823d33999 114 case 1:
<> 149:156823d33999 115 sConfig.Channel = ADC_CHANNEL_1;
<> 149:156823d33999 116 break;
<> 149:156823d33999 117 case 2:
<> 149:156823d33999 118 sConfig.Channel = ADC_CHANNEL_2;
<> 149:156823d33999 119 break;
<> 149:156823d33999 120 case 3:
<> 149:156823d33999 121 sConfig.Channel = ADC_CHANNEL_3;
<> 149:156823d33999 122 break;
<> 149:156823d33999 123 case 4:
<> 149:156823d33999 124 sConfig.Channel = ADC_CHANNEL_4;
<> 149:156823d33999 125 break;
<> 149:156823d33999 126 case 5:
<> 149:156823d33999 127 sConfig.Channel = ADC_CHANNEL_5;
<> 149:156823d33999 128 break;
<> 149:156823d33999 129 case 6:
<> 149:156823d33999 130 sConfig.Channel = ADC_CHANNEL_6;
<> 149:156823d33999 131 break;
<> 149:156823d33999 132 case 7:
<> 149:156823d33999 133 sConfig.Channel = ADC_CHANNEL_7;
<> 149:156823d33999 134 break;
<> 149:156823d33999 135 case 8:
<> 149:156823d33999 136 sConfig.Channel = ADC_CHANNEL_8;
<> 149:156823d33999 137 break;
<> 149:156823d33999 138 case 9:
<> 149:156823d33999 139 sConfig.Channel = ADC_CHANNEL_9;
<> 149:156823d33999 140 break;
<> 149:156823d33999 141 case 10:
<> 149:156823d33999 142 sConfig.Channel = ADC_CHANNEL_10;
<> 149:156823d33999 143 break;
<> 149:156823d33999 144 case 11:
<> 149:156823d33999 145 sConfig.Channel = ADC_CHANNEL_11;
<> 149:156823d33999 146 break;
<> 149:156823d33999 147 case 12:
<> 149:156823d33999 148 sConfig.Channel = ADC_CHANNEL_12;
<> 149:156823d33999 149 break;
<> 149:156823d33999 150 case 13:
<> 149:156823d33999 151 sConfig.Channel = ADC_CHANNEL_13;
<> 149:156823d33999 152 break;
<> 149:156823d33999 153 case 14:
<> 149:156823d33999 154 sConfig.Channel = ADC_CHANNEL_14;
<> 149:156823d33999 155 break;
<> 149:156823d33999 156 case 15:
<> 149:156823d33999 157 sConfig.Channel = ADC_CHANNEL_15;
<> 149:156823d33999 158 break;
<> 149:156823d33999 159 case 16:
<> 149:156823d33999 160 sConfig.Channel = ADC_CHANNEL_TEMPSENSOR;
<> 149:156823d33999 161 break;
<> 149:156823d33999 162 case 17:
<> 149:156823d33999 163 sConfig.Channel = ADC_CHANNEL_VREFINT;
<> 149:156823d33999 164 break;
<> 149:156823d33999 165 case 18:
<> 149:156823d33999 166 sConfig.Channel = ADC_CHANNEL_18;
<> 149:156823d33999 167 break;
<> 149:156823d33999 168 case 19:
<> 149:156823d33999 169 sConfig.Channel = ADC_CHANNEL_19;
<> 149:156823d33999 170 break;
<> 149:156823d33999 171 case 20:
<> 149:156823d33999 172 sConfig.Channel = ADC_CHANNEL_20;
<> 149:156823d33999 173 break;
<> 149:156823d33999 174 case 21:
<> 149:156823d33999 175 sConfig.Channel = ADC_CHANNEL_21;
<> 149:156823d33999 176 break;
<> 149:156823d33999 177 case 22:
<> 149:156823d33999 178 sConfig.Channel = ADC_CHANNEL_22;
<> 149:156823d33999 179 break;
<> 149:156823d33999 180 case 23:
<> 149:156823d33999 181 sConfig.Channel = ADC_CHANNEL_23;
<> 149:156823d33999 182 break;
<> 149:156823d33999 183 case 24:
<> 149:156823d33999 184 sConfig.Channel = ADC_CHANNEL_24;
<> 149:156823d33999 185 break;
<> 149:156823d33999 186 case 25:
<> 149:156823d33999 187 sConfig.Channel = ADC_CHANNEL_25;
<> 149:156823d33999 188 break;
<> 149:156823d33999 189 case 26:
<> 149:156823d33999 190 sConfig.Channel = ADC_CHANNEL_26;
<> 149:156823d33999 191 break;
<> 149:156823d33999 192 #ifdef ADC_CHANNEL_27
<> 149:156823d33999 193 case 27:
<> 149:156823d33999 194 sConfig.Channel = ADC_CHANNEL_27;
<> 149:156823d33999 195 break;
<> 149:156823d33999 196 #endif
<> 149:156823d33999 197 #ifdef ADC_CHANNEL_28
<> 149:156823d33999 198 case 28:
<> 149:156823d33999 199 sConfig.Channel = ADC_CHANNEL_28;
<> 149:156823d33999 200 break;
<> 149:156823d33999 201 #endif
<> 149:156823d33999 202 #ifdef ADC_CHANNEL_29
<> 149:156823d33999 203 case 29:
<> 149:156823d33999 204 sConfig.Channel = ADC_CHANNEL_29;
<> 149:156823d33999 205 break;
<> 149:156823d33999 206 #endif
<> 149:156823d33999 207 #ifdef ADC_CHANNEL_30
<> 149:156823d33999 208 case 30:
<> 149:156823d33999 209 sConfig.Channel = ADC_CHANNEL_30;
<> 149:156823d33999 210 break;
<> 149:156823d33999 211 #endif
<> 149:156823d33999 212 #ifdef ADC_CHANNEL_31
<> 149:156823d33999 213 case 31:
<> 149:156823d33999 214 sConfig.Channel = ADC_CHANNEL_31;
<> 149:156823d33999 215 break;
<> 149:156823d33999 216 #endif
<> 149:156823d33999 217 default:
<> 149:156823d33999 218 return 0;
<> 149:156823d33999 219 }
<> 149:156823d33999 220
<> 149:156823d33999 221 sConfig.Rank = ADC_REGULAR_RANK_1;
<> 149:156823d33999 222 sConfig.SamplingTime = ADC_SAMPLETIME_16CYCLES;
<> 149:156823d33999 223
<> 149:156823d33999 224 HAL_ADC_ConfigChannel(&AdcHandle, &sConfig);
<> 149:156823d33999 225
<> 149:156823d33999 226 HAL_ADC_Start(&AdcHandle); // Start conversion
<> 149:156823d33999 227
<> 149:156823d33999 228 // Wait end of conversion and get value
<> 149:156823d33999 229 if (HAL_ADC_PollForConversion(&AdcHandle, 10) == HAL_OK) {
<> 149:156823d33999 230 return (HAL_ADC_GetValue(&AdcHandle));
<> 149:156823d33999 231 } else {
<> 149:156823d33999 232 return 0;
<> 149:156823d33999 233 }
<> 149:156823d33999 234 }
<> 149:156823d33999 235
<> 149:156823d33999 236 uint16_t analogin_read_u16(analogin_t *obj)
<> 149:156823d33999 237 {
<> 149:156823d33999 238 uint16_t value = adc_read(obj);
<> 149:156823d33999 239 // 12-bit to 16-bit conversion
<> 149:156823d33999 240 value = ((value << 4) & (uint16_t)0xFFF0) | ((value >> 8) & (uint16_t)0x000F);
<> 149:156823d33999 241 return value;
<> 149:156823d33999 242 }
<> 149:156823d33999 243
<> 149:156823d33999 244 float analogin_read(analogin_t *obj)
<> 149:156823d33999 245 {
<> 149:156823d33999 246 uint16_t value = adc_read(obj);
<> 149:156823d33999 247 return (float)value * (1.0f / (float)0xFFF); // 12 bits range
<> 149:156823d33999 248 }
<> 149:156823d33999 249
<> 149:156823d33999 250 #endif