Toyomasa Watarai / mbed-dev

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/hal/TARGET_STM/TARGET_STM32L4/analogin_api.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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