EL4121 Embedded System / mbed-os

mbed-os

Dependents:   cobaLCDJoyMotor_Thread odometry_omni_3roda_v3 odometry_omni_3roda_v1 odometry_omni_3roda_v2 ... more

targets/TARGET_STM/TARGET_STM32F3/analogin_device.c@0:b74591d5ab33, 2017-12-11 (annotated)

Committer:
be_bryan
Date:
Mon Dec 11 17:54:04 2017 +0000
Revision:
0:b74591d5ab33
motor ++

Who changed what in which revision?

UserRevisionLine numberNew contents of line
be_bryan 0:b74591d5ab33 1 /* mbed Microcontroller Library
be_bryan 0:b74591d5ab33 2 * Copyright (c) 2016, STMicroelectronics
be_bryan 0:b74591d5ab33 3 * All rights reserved.
be_bryan 0:b74591d5ab33 4 *
be_bryan 0:b74591d5ab33 5 * Redistribution and use in source and binary forms, with or without
be_bryan 0:b74591d5ab33 6 * modification, are permitted provided that the following conditions are met:
be_bryan 0:b74591d5ab33 7 *
be_bryan 0:b74591d5ab33 8 * 1. Redistributions of source code must retain the above copyright notice,
be_bryan 0:b74591d5ab33 9 * this list of conditions and the following disclaimer.
be_bryan 0:b74591d5ab33 10 * 2. Redistributions in binary form must reproduce the above copyright notice,
be_bryan 0:b74591d5ab33 11 * this list of conditions and the following disclaimer in the documentation
be_bryan 0:b74591d5ab33 12 * and/or other materials provided with the distribution.
be_bryan 0:b74591d5ab33 13 * 3. Neither the name of STMicroelectronics nor the names of its contributors
be_bryan 0:b74591d5ab33 14 * may be used to endorse or promote products derived from this software
be_bryan 0:b74591d5ab33 15 * without specific prior written permission.
be_bryan 0:b74591d5ab33 16 *
be_bryan 0:b74591d5ab33 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
be_bryan 0:b74591d5ab33 18 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
be_bryan 0:b74591d5ab33 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
be_bryan 0:b74591d5ab33 20 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
be_bryan 0:b74591d5ab33 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
be_bryan 0:b74591d5ab33 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
be_bryan 0:b74591d5ab33 23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
be_bryan 0:b74591d5ab33 24 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
be_bryan 0:b74591d5ab33 25 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
be_bryan 0:b74591d5ab33 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
be_bryan 0:b74591d5ab33 27 */
be_bryan 0:b74591d5ab33 28 #include "mbed_assert.h"
be_bryan 0:b74591d5ab33 29 #include "analogin_api.h"
be_bryan 0:b74591d5ab33 30
be_bryan 0:b74591d5ab33 31 #if DEVICE_ANALOGIN
be_bryan 0:b74591d5ab33 32
be_bryan 0:b74591d5ab33 33 #include "mbed_wait_api.h"
be_bryan 0:b74591d5ab33 34 #include "cmsis.h"
be_bryan 0:b74591d5ab33 35 #include "pinmap.h"
be_bryan 0:b74591d5ab33 36 #include "mbed_error.h"
be_bryan 0:b74591d5ab33 37 #include "PeripheralPins.h"
be_bryan 0:b74591d5ab33 38 #include <stdbool.h>
be_bryan 0:b74591d5ab33 39
be_bryan 0:b74591d5ab33 40 void analogin_init(analogin_t *obj, PinName pin)
be_bryan 0:b74591d5ab33 41 {
be_bryan 0:b74591d5ab33 42 static bool adc_calibrated = false;
be_bryan 0:b74591d5ab33 43 uint32_t function = (uint32_t)NC;
be_bryan 0:b74591d5ab33 44
be_bryan 0:b74591d5ab33 45 // ADC Internal Channels "pins" (Temperature, Vref, Vbat, ...)
be_bryan 0:b74591d5ab33 46 // are described in PinNames.h and PeripheralPins.c
be_bryan 0:b74591d5ab33 47 // Pin value must be between 0xF0 and 0xFF
be_bryan 0:b74591d5ab33 48 if ((pin < 0xF0) || (pin >= 0x100)) {
be_bryan 0:b74591d5ab33 49 // Normal channels
be_bryan 0:b74591d5ab33 50 // Get the peripheral name from the pin and assign it to the object
be_bryan 0:b74591d5ab33 51 obj->handle.Instance = (ADC_TypeDef *)pinmap_peripheral(pin, PinMap_ADC);
be_bryan 0:b74591d5ab33 52 // Get the functions (adc channel) from the pin and assign it to the object
be_bryan 0:b74591d5ab33 53 function = pinmap_function(pin, PinMap_ADC);
be_bryan 0:b74591d5ab33 54 // Configure GPIO
be_bryan 0:b74591d5ab33 55 pinmap_pinout(pin, PinMap_ADC);
be_bryan 0:b74591d5ab33 56 } else {
be_bryan 0:b74591d5ab33 57 // Internal channels
be_bryan 0:b74591d5ab33 58 obj->handle.Instance = (ADC_TypeDef *)pinmap_peripheral(pin, PinMap_ADC_Internal);
be_bryan 0:b74591d5ab33 59 function = pinmap_function(pin, PinMap_ADC_Internal);
be_bryan 0:b74591d5ab33 60 // No GPIO configuration for internal channels
be_bryan 0:b74591d5ab33 61 }
be_bryan 0:b74591d5ab33 62 MBED_ASSERT(obj->handle.Instance != (ADC_TypeDef *)NC);
be_bryan 0:b74591d5ab33 63 MBED_ASSERT(function != (uint32_t)NC);
be_bryan 0:b74591d5ab33 64
be_bryan 0:b74591d5ab33 65 obj->channel = STM_PIN_CHANNEL(function);
be_bryan 0:b74591d5ab33 66
be_bryan 0:b74591d5ab33 67 // Save pin number for the read function
be_bryan 0:b74591d5ab33 68 obj->pin = pin;
be_bryan 0:b74591d5ab33 69
be_bryan 0:b74591d5ab33 70 // Configure ADC object structures
be_bryan 0:b74591d5ab33 71 obj->handle.State = HAL_ADC_STATE_RESET;
be_bryan 0:b74591d5ab33 72 obj->handle.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV2;
be_bryan 0:b74591d5ab33 73 obj->handle.Init.Resolution = ADC_RESOLUTION_12B;
be_bryan 0:b74591d5ab33 74 obj->handle.Init.DataAlign = ADC_DATAALIGN_RIGHT;
be_bryan 0:b74591d5ab33 75 obj->handle.Init.ScanConvMode = DISABLE;
be_bryan 0:b74591d5ab33 76 obj->handle.Init.EOCSelection = EOC_SINGLE_CONV;
be_bryan 0:b74591d5ab33 77 obj->handle.Init.LowPowerAutoWait = DISABLE;
be_bryan 0:b74591d5ab33 78 obj->handle.Init.ContinuousConvMode = DISABLE;
be_bryan 0:b74591d5ab33 79 obj->handle.Init.NbrOfConversion = 1;
be_bryan 0:b74591d5ab33 80 obj->handle.Init.DiscontinuousConvMode = DISABLE;
be_bryan 0:b74591d5ab33 81 obj->handle.Init.NbrOfDiscConversion = 0;
be_bryan 0:b74591d5ab33 82 obj->handle.Init.ExternalTrigConv = ADC_EXTERNALTRIGCONV_T1_CC1;
be_bryan 0:b74591d5ab33 83 obj->handle.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE;
be_bryan 0:b74591d5ab33 84 obj->handle.Init.DMAContinuousRequests = DISABLE;
be_bryan 0:b74591d5ab33 85 obj->handle.Init.Overrun = OVR_DATA_OVERWRITTEN;
be_bryan 0:b74591d5ab33 86
be_bryan 0:b74591d5ab33 87 #if defined(ADC1)
be_bryan 0:b74591d5ab33 88 if ((ADCName)obj->handle.Instance == ADC_1) {
be_bryan 0:b74591d5ab33 89 __HAL_RCC_ADC1_CLK_ENABLE();
be_bryan 0:b74591d5ab33 90 }
be_bryan 0:b74591d5ab33 91 #endif
be_bryan 0:b74591d5ab33 92 #if defined(ADC2)
be_bryan 0:b74591d5ab33 93 if ((ADCName)obj->handle.Instance == ADC_2) {
be_bryan 0:b74591d5ab33 94 __HAL_RCC_ADC2_CLK_ENABLE();
be_bryan 0:b74591d5ab33 95 }
be_bryan 0:b74591d5ab33 96 #endif
be_bryan 0:b74591d5ab33 97 #if defined(ADC3)
be_bryan 0:b74591d5ab33 98 if ((ADCName)obj->handle.Instance == ADC_3) {
be_bryan 0:b74591d5ab33 99 __HAL_RCC_ADC34_CLK_ENABLE();
be_bryan 0:b74591d5ab33 100 }
be_bryan 0:b74591d5ab33 101 #endif
be_bryan 0:b74591d5ab33 102 #if defined(ADC4)
be_bryan 0:b74591d5ab33 103 if ((ADCName)obj->handle.Instance == ADC_4) {
be_bryan 0:b74591d5ab33 104 __HAL_RCC_ADC34_CLK_ENABLE();
be_bryan 0:b74591d5ab33 105 }
be_bryan 0:b74591d5ab33 106 #endif
be_bryan 0:b74591d5ab33 107
be_bryan 0:b74591d5ab33 108 if (HAL_ADC_Init(&obj->handle) != HAL_OK) {
be_bryan 0:b74591d5ab33 109 error("Cannot initialize ADC");
be_bryan 0:b74591d5ab33 110 }
be_bryan 0:b74591d5ab33 111
be_bryan 0:b74591d5ab33 112 // ADC calibration is done only once
be_bryan 0:b74591d5ab33 113 if (!adc_calibrated) {
be_bryan 0:b74591d5ab33 114 adc_calibrated = true;
be_bryan 0:b74591d5ab33 115 HAL_ADCEx_Calibration_Start(&obj->handle, ADC_SINGLE_ENDED);
be_bryan 0:b74591d5ab33 116 }
be_bryan 0:b74591d5ab33 117 }
be_bryan 0:b74591d5ab33 118
be_bryan 0:b74591d5ab33 119 uint16_t adc_read(analogin_t *obj)
be_bryan 0:b74591d5ab33 120 {
be_bryan 0:b74591d5ab33 121 ADC_ChannelConfTypeDef sConfig = {0};
be_bryan 0:b74591d5ab33 122
be_bryan 0:b74591d5ab33 123 // Configure ADC channel
be_bryan 0:b74591d5ab33 124 sConfig.Rank = ADC_REGULAR_RANK_1;
be_bryan 0:b74591d5ab33 125 sConfig.SamplingTime = ADC_SAMPLETIME_19CYCLES_5;
be_bryan 0:b74591d5ab33 126 sConfig.SingleDiff = ADC_SINGLE_ENDED;
be_bryan 0:b74591d5ab33 127 sConfig.OffsetNumber = ADC_OFFSET_NONE;
be_bryan 0:b74591d5ab33 128 sConfig.Offset = 0;
be_bryan 0:b74591d5ab33 129
be_bryan 0:b74591d5ab33 130 switch (obj->channel) {
be_bryan 0:b74591d5ab33 131 case 1:
be_bryan 0:b74591d5ab33 132 sConfig.Channel = ADC_CHANNEL_1;
be_bryan 0:b74591d5ab33 133 break;
be_bryan 0:b74591d5ab33 134 case 2:
be_bryan 0:b74591d5ab33 135 sConfig.Channel = ADC_CHANNEL_2;
be_bryan 0:b74591d5ab33 136 break;
be_bryan 0:b74591d5ab33 137 case 3:
be_bryan 0:b74591d5ab33 138 sConfig.Channel = ADC_CHANNEL_3;
be_bryan 0:b74591d5ab33 139 break;
be_bryan 0:b74591d5ab33 140 case 4:
be_bryan 0:b74591d5ab33 141 sConfig.Channel = ADC_CHANNEL_4;
be_bryan 0:b74591d5ab33 142 break;
be_bryan 0:b74591d5ab33 143 case 5:
be_bryan 0:b74591d5ab33 144 sConfig.Channel = ADC_CHANNEL_5;
be_bryan 0:b74591d5ab33 145 break;
be_bryan 0:b74591d5ab33 146 case 6:
be_bryan 0:b74591d5ab33 147 sConfig.Channel = ADC_CHANNEL_6;
be_bryan 0:b74591d5ab33 148 break;
be_bryan 0:b74591d5ab33 149 case 7:
be_bryan 0:b74591d5ab33 150 sConfig.Channel = ADC_CHANNEL_7;
be_bryan 0:b74591d5ab33 151 break;
be_bryan 0:b74591d5ab33 152 case 8:
be_bryan 0:b74591d5ab33 153 sConfig.Channel = ADC_CHANNEL_8;
be_bryan 0:b74591d5ab33 154 break;
be_bryan 0:b74591d5ab33 155 case 9:
be_bryan 0:b74591d5ab33 156 sConfig.Channel = ADC_CHANNEL_9;
be_bryan 0:b74591d5ab33 157 break;
be_bryan 0:b74591d5ab33 158 case 10:
be_bryan 0:b74591d5ab33 159 sConfig.Channel = ADC_CHANNEL_10;
be_bryan 0:b74591d5ab33 160 break;
be_bryan 0:b74591d5ab33 161 case 11:
be_bryan 0:b74591d5ab33 162 sConfig.Channel = ADC_CHANNEL_11;
be_bryan 0:b74591d5ab33 163 break;
be_bryan 0:b74591d5ab33 164 case 12:
be_bryan 0:b74591d5ab33 165 sConfig.Channel = ADC_CHANNEL_12;
be_bryan 0:b74591d5ab33 166 break;
be_bryan 0:b74591d5ab33 167 case 13:
be_bryan 0:b74591d5ab33 168 sConfig.Channel = ADC_CHANNEL_13;
be_bryan 0:b74591d5ab33 169 break;
be_bryan 0:b74591d5ab33 170 case 14:
be_bryan 0:b74591d5ab33 171 sConfig.Channel = ADC_CHANNEL_14;
be_bryan 0:b74591d5ab33 172 break;
be_bryan 0:b74591d5ab33 173 case 15:
be_bryan 0:b74591d5ab33 174 sConfig.Channel = ADC_CHANNEL_15;
be_bryan 0:b74591d5ab33 175 break;
be_bryan 0:b74591d5ab33 176 case 16:
be_bryan 0:b74591d5ab33 177 sConfig.Channel = ADC_CHANNEL_16;
be_bryan 0:b74591d5ab33 178 break;
be_bryan 0:b74591d5ab33 179 case 17:
be_bryan 0:b74591d5ab33 180 sConfig.Channel = ADC_CHANNEL_17;
be_bryan 0:b74591d5ab33 181 break;
be_bryan 0:b74591d5ab33 182 case 18:
be_bryan 0:b74591d5ab33 183 sConfig.Channel = ADC_CHANNEL_18;
be_bryan 0:b74591d5ab33 184 break;
be_bryan 0:b74591d5ab33 185 default:
be_bryan 0:b74591d5ab33 186 return 0;
be_bryan 0:b74591d5ab33 187 }
be_bryan 0:b74591d5ab33 188
be_bryan 0:b74591d5ab33 189 HAL_ADC_ConfigChannel(&obj->handle, &sConfig);
be_bryan 0:b74591d5ab33 190
be_bryan 0:b74591d5ab33 191 HAL_ADC_Start(&obj->handle); // Start conversion
be_bryan 0:b74591d5ab33 192
be_bryan 0:b74591d5ab33 193 // Wait end of conversion and get value
be_bryan 0:b74591d5ab33 194 if (HAL_ADC_PollForConversion(&obj->handle, 10) == HAL_OK) {
be_bryan 0:b74591d5ab33 195 return (uint16_t)HAL_ADC_GetValue(&obj->handle);
be_bryan 0:b74591d5ab33 196 } else {
be_bryan 0:b74591d5ab33 197 return 0;
be_bryan 0:b74591d5ab33 198 }
be_bryan 0:b74591d5ab33 199 }
be_bryan 0:b74591d5ab33 200
be_bryan 0:b74591d5ab33 201 #endif