teralytic / mbed-dev

mbed library sources. Supersedes mbed-src.

Fork of mbed by teralytic

targets/hal/TARGET_STM/TARGET_STM32L0/analogin_api.c@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
0:9b334a45a8ff 
This updates the lib to the mbed lib v125

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /* mbed Microcontroller Library
<> 144:ef7eb2e8f9f7 2 * Copyright (c) 2015, STMicroelectronics
<> 144:ef7eb2e8f9f7 3 * All rights reserved.
<> 144:ef7eb2e8f9f7 4 *
<> 144:ef7eb2e8f9f7 5 * Redistribution and use in source and binary forms, with or without
<> 144:ef7eb2e8f9f7 6 * modification, are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 7 *
<> 144:ef7eb2e8f9f7 8 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 9 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 10 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 11 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 12 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 13 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 14 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 15 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 16 *
<> 144:ef7eb2e8f9f7 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 18 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 20 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 24 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 25 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 27 */
<> 144:ef7eb2e8f9f7 28 #include "mbed_assert.h"
<> 144:ef7eb2e8f9f7 29 #include "analogin_api.h"
<> 144:ef7eb2e8f9f7 30
<> 144:ef7eb2e8f9f7 31 #if DEVICE_ANALOGIN
<> 144:ef7eb2e8f9f7 32
<> 144:ef7eb2e8f9f7 33 #include "wait_api.h"
<> 144:ef7eb2e8f9f7 34 #include "cmsis.h"
<> 144:ef7eb2e8f9f7 35 #include "pinmap.h"
<> 144:ef7eb2e8f9f7 36 #include "mbed_error.h"
<> 144:ef7eb2e8f9f7 37 #include "PeripheralPins.h"
<> 144:ef7eb2e8f9f7 38
<> 144:ef7eb2e8f9f7 39 ADC_HandleTypeDef AdcHandle;
<> 144:ef7eb2e8f9f7 40
<> 144:ef7eb2e8f9f7 41 int adc_inited = 0;
<> 144:ef7eb2e8f9f7 42
<> 144:ef7eb2e8f9f7 43 void analogin_init(analogin_t *obj, PinName pin)
<> 144:ef7eb2e8f9f7 44 {
<> 144:ef7eb2e8f9f7 45 // Get the peripheral name from the pin and assign it to the object
<> 144:ef7eb2e8f9f7 46 obj->adc = (ADCName)pinmap_peripheral(pin, PinMap_ADC);
<> 144:ef7eb2e8f9f7 47 MBED_ASSERT(obj->adc != (ADCName)NC);
<> 144:ef7eb2e8f9f7 48
<> 144:ef7eb2e8f9f7 49 // Get the pin function and assign the used channel to the object
<> 144:ef7eb2e8f9f7 50 uint32_t function = pinmap_function(pin, PinMap_ADC);
<> 144:ef7eb2e8f9f7 51 MBED_ASSERT(function != (uint32_t)NC);
<> 144:ef7eb2e8f9f7 52 obj->channel = STM_PIN_CHANNEL(function);
<> 144:ef7eb2e8f9f7 53
<> 144:ef7eb2e8f9f7 54 // Configure GPIO
<> 144:ef7eb2e8f9f7 55 pinmap_pinout(pin, PinMap_ADC);
<> 144:ef7eb2e8f9f7 56
<> 144:ef7eb2e8f9f7 57 // Save pin number for the read function
<> 144:ef7eb2e8f9f7 58 obj->pin = pin;
<> 144:ef7eb2e8f9f7 59
<> 144:ef7eb2e8f9f7 60 // The ADC initialization is done once
<> 144:ef7eb2e8f9f7 61 if (adc_inited == 0) {
<> 144:ef7eb2e8f9f7 62 adc_inited = 1;
<> 144:ef7eb2e8f9f7 63
<> 144:ef7eb2e8f9f7 64 AdcHandle.Instance = (ADC_TypeDef *)(obj->adc);
<> 144:ef7eb2e8f9f7 65
<> 144:ef7eb2e8f9f7 66 // Enable ADC clock
<> 144:ef7eb2e8f9f7 67 __ADC1_CLK_ENABLE();
<> 144:ef7eb2e8f9f7 68
<> 144:ef7eb2e8f9f7 69 // Configure ADC
<> 144:ef7eb2e8f9f7 70 AdcHandle.Init.OversamplingMode = DISABLE;
<> 144:ef7eb2e8f9f7 71 AdcHandle.Init.ClockPrescaler = ADC_CLOCKPRESCALER_PCLK_DIV1;
<> 144:ef7eb2e8f9f7 72 AdcHandle.Init.Resolution = ADC_RESOLUTION12b;
<> 144:ef7eb2e8f9f7 73 AdcHandle.Init.SamplingTime = ADC_SAMPLETIME_41CYCLES_5;
<> 144:ef7eb2e8f9f7 74 AdcHandle.Init.ScanConvMode = ADC_SCAN_DIRECTION_FORWARD;
<> 144:ef7eb2e8f9f7 75 AdcHandle.Init.DataAlign = ADC_DATAALIGN_RIGHT;
<> 144:ef7eb2e8f9f7 76 AdcHandle.Init.ContinuousConvMode = DISABLE;
<> 144:ef7eb2e8f9f7 77 AdcHandle.Init.DiscontinuousConvMode = DISABLE;
<> 144:ef7eb2e8f9f7 78 AdcHandle.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIG_EDGE_NONE;
<> 144:ef7eb2e8f9f7 79 AdcHandle.Init.ExternalTrigConv = ADC_EXTERNALTRIG0_T6_TRGO; // Not used here
<> 144:ef7eb2e8f9f7 80 AdcHandle.Init.DMAContinuousRequests = DISABLE;
<> 144:ef7eb2e8f9f7 81 AdcHandle.Init.EOCSelection = EOC_SINGLE_CONV;
<> 144:ef7eb2e8f9f7 82 AdcHandle.Init.Overrun = OVR_DATA_OVERWRITTEN;
<> 144:ef7eb2e8f9f7 83 AdcHandle.Init.LowPowerAutoWait = ENABLE;
<> 144:ef7eb2e8f9f7 84 AdcHandle.Init.LowPowerFrequencyMode = DISABLE; // To be enabled only if ADC clock < 2.8 MHz
<> 144:ef7eb2e8f9f7 85 AdcHandle.Init.LowPowerAutoPowerOff = DISABLE;
<> 144:ef7eb2e8f9f7 86
<> 144:ef7eb2e8f9f7 87 if (HAL_ADC_Init(&AdcHandle) != HAL_OK) {
<> 144:ef7eb2e8f9f7 88 error("Cannot initialize ADC");
<> 144:ef7eb2e8f9f7 89 }
<> 144:ef7eb2e8f9f7 90
<> 144:ef7eb2e8f9f7 91 // Calibration
<> 144:ef7eb2e8f9f7 92 HAL_ADCEx_Calibration_Start(&AdcHandle, ADC_SINGLE_ENDED);
<> 144:ef7eb2e8f9f7 93
<> 144:ef7eb2e8f9f7 94 __HAL_ADC_ENABLE(&AdcHandle);
<> 144:ef7eb2e8f9f7 95 }
<> 144:ef7eb2e8f9f7 96 }
<> 144:ef7eb2e8f9f7 97
<> 144:ef7eb2e8f9f7 98 static inline uint16_t adc_read(analogin_t *obj)
<> 144:ef7eb2e8f9f7 99 {
<> 144:ef7eb2e8f9f7 100 ADC_ChannelConfTypeDef sConfig = {0};
<> 144:ef7eb2e8f9f7 101
<> 144:ef7eb2e8f9f7 102 AdcHandle.Instance = (ADC_TypeDef *)(obj->adc);
<> 144:ef7eb2e8f9f7 103
<> 144:ef7eb2e8f9f7 104 // Configure ADC channel
<> 144:ef7eb2e8f9f7 105 switch (obj->channel) {
<> 144:ef7eb2e8f9f7 106 case 0:
<> 144:ef7eb2e8f9f7 107 sConfig.Channel = ADC_CHANNEL_0;
<> 144:ef7eb2e8f9f7 108 break;
<> 144:ef7eb2e8f9f7 109 case 1:
<> 144:ef7eb2e8f9f7 110 sConfig.Channel = ADC_CHANNEL_1;
<> 144:ef7eb2e8f9f7 111 break;
<> 144:ef7eb2e8f9f7 112 case 2:
<> 144:ef7eb2e8f9f7 113 sConfig.Channel = ADC_CHANNEL_2;
<> 144:ef7eb2e8f9f7 114 break;
<> 144:ef7eb2e8f9f7 115 case 3:
<> 144:ef7eb2e8f9f7 116 sConfig.Channel = ADC_CHANNEL_3;
<> 144:ef7eb2e8f9f7 117 break;
<> 144:ef7eb2e8f9f7 118 case 4:
<> 144:ef7eb2e8f9f7 119 sConfig.Channel = ADC_CHANNEL_4;
<> 144:ef7eb2e8f9f7 120 break;
<> 144:ef7eb2e8f9f7 121 case 5:
<> 144:ef7eb2e8f9f7 122 sConfig.Channel = ADC_CHANNEL_5;
<> 144:ef7eb2e8f9f7 123 break;
<> 144:ef7eb2e8f9f7 124 case 6:
<> 144:ef7eb2e8f9f7 125 sConfig.Channel = ADC_CHANNEL_6;
<> 144:ef7eb2e8f9f7 126 break;
<> 144:ef7eb2e8f9f7 127 case 7:
<> 144:ef7eb2e8f9f7 128 sConfig.Channel = ADC_CHANNEL_7;
<> 144:ef7eb2e8f9f7 129 break;
<> 144:ef7eb2e8f9f7 130 case 8:
<> 144:ef7eb2e8f9f7 131 sConfig.Channel = ADC_CHANNEL_8;
<> 144:ef7eb2e8f9f7 132 break;
<> 144:ef7eb2e8f9f7 133 case 9:
<> 144:ef7eb2e8f9f7 134 sConfig.Channel = ADC_CHANNEL_9;
<> 144:ef7eb2e8f9f7 135 break;
<> 144:ef7eb2e8f9f7 136 case 10:
<> 144:ef7eb2e8f9f7 137 sConfig.Channel = ADC_CHANNEL_10;
<> 144:ef7eb2e8f9f7 138 break;
<> 144:ef7eb2e8f9f7 139 case 11:
<> 144:ef7eb2e8f9f7 140 sConfig.Channel = ADC_CHANNEL_11;
<> 144:ef7eb2e8f9f7 141 break;
<> 144:ef7eb2e8f9f7 142 case 12:
<> 144:ef7eb2e8f9f7 143 sConfig.Channel = ADC_CHANNEL_12;
<> 144:ef7eb2e8f9f7 144 break;
<> 144:ef7eb2e8f9f7 145 case 13:
<> 144:ef7eb2e8f9f7 146 sConfig.Channel = ADC_CHANNEL_13;
<> 144:ef7eb2e8f9f7 147 break;
<> 144:ef7eb2e8f9f7 148 case 14:
<> 144:ef7eb2e8f9f7 149 sConfig.Channel = ADC_CHANNEL_14;
<> 144:ef7eb2e8f9f7 150 break;
<> 144:ef7eb2e8f9f7 151 case 15:
<> 144:ef7eb2e8f9f7 152 sConfig.Channel = ADC_CHANNEL_15;
<> 144:ef7eb2e8f9f7 153 break;
<> 144:ef7eb2e8f9f7 154 default:
<> 144:ef7eb2e8f9f7 155 return 0;
<> 144:ef7eb2e8f9f7 156 }
<> 144:ef7eb2e8f9f7 157
<> 144:ef7eb2e8f9f7 158 ADC1->CHSELR = 0; // [TODO] Workaround. To be removed after Cube driver is corrected.
<> 144:ef7eb2e8f9f7 159 HAL_ADC_ConfigChannel(&AdcHandle, &sConfig);
<> 144:ef7eb2e8f9f7 160
<> 144:ef7eb2e8f9f7 161 HAL_ADC_Start(&AdcHandle); // Start conversion
<> 144:ef7eb2e8f9f7 162
<> 144:ef7eb2e8f9f7 163 // Wait end of conversion and get value
<> 144:ef7eb2e8f9f7 164 if (HAL_ADC_PollForConversion(&AdcHandle, 10) == HAL_OK) {
<> 144:ef7eb2e8f9f7 165 return (HAL_ADC_GetValue(&AdcHandle));
<> 144:ef7eb2e8f9f7 166 } else {
<> 144:ef7eb2e8f9f7 167 return 0;
<> 144:ef7eb2e8f9f7 168 }
<> 144:ef7eb2e8f9f7 169 }
<> 144:ef7eb2e8f9f7 170
<> 144:ef7eb2e8f9f7 171 uint16_t analogin_read_u16(analogin_t *obj)
<> 144:ef7eb2e8f9f7 172 {
<> 144:ef7eb2e8f9f7 173 uint16_t value = adc_read(obj);
<> 144:ef7eb2e8f9f7 174 // 12-bit to 16-bit conversion
<> 144:ef7eb2e8f9f7 175 value = ((value << 4) & (uint16_t)0xFFF0) | ((value >> 8) & (uint16_t)0x000F);
<> 144:ef7eb2e8f9f7 176 return value;
<> 144:ef7eb2e8f9f7 177 }
<> 144:ef7eb2e8f9f7 178
<> 144:ef7eb2e8f9f7 179 float analogin_read(analogin_t *obj)
<> 144:ef7eb2e8f9f7 180 {
<> 144:ef7eb2e8f9f7 181 uint16_t value = adc_read(obj);
<> 144:ef7eb2e8f9f7 182 return (float)value * (1.0f / (float)0xFFF); // 12 bits range
<> 144:ef7eb2e8f9f7 183 }
<> 144:ef7eb2e8f9f7 184
<> 144:ef7eb2e8f9f7 185 #endif