4545
Fork of mbed-dev by
targets/TARGET_STM/TARGET_STM32F3/analogin_api.c@160:d5399cc887bb, 2017-03-14 (annotated)
- Committer:
- <>
- Date:
- Tue Mar 14 16:40:56 2017 +0000
- Revision:
- 160:d5399cc887bb
- Parent:
- 150:02e0a0aed4ec
This updates the lib to the mbed lib v138
Who changed what in which revision?
User | Revision | Line number | New 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 | |
<> | 160:d5399cc887bb | 33 | #include "mbed_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 | void analogin_init(analogin_t *obj, PinName pin) |
<> | 149:156823d33999 | 42 | { |
<> | 149:156823d33999 | 43 | #if defined(ADC1) |
<> | 149:156823d33999 | 44 | static int adc1_inited = 0; |
<> | 149:156823d33999 | 45 | #endif |
<> | 149:156823d33999 | 46 | #if defined(ADC2) |
<> | 149:156823d33999 | 47 | static int adc2_inited = 0; |
<> | 149:156823d33999 | 48 | #endif |
<> | 149:156823d33999 | 49 | #if defined(ADC3) |
<> | 149:156823d33999 | 50 | static int adc3_inited = 0; |
<> | 149:156823d33999 | 51 | #endif |
<> | 149:156823d33999 | 52 | #if defined(ADC4) |
<> | 149:156823d33999 | 53 | static int adc4_inited = 0; |
<> | 149:156823d33999 | 54 | #endif |
<> | 149:156823d33999 | 55 | |
<> | 149:156823d33999 | 56 | // Get the peripheral name from the pin and assign it to the object |
<> | 149:156823d33999 | 57 | obj->adc = (ADCName)pinmap_peripheral(pin, PinMap_ADC); |
<> | 149:156823d33999 | 58 | MBED_ASSERT(obj->adc != (ADCName)NC); |
<> | 149:156823d33999 | 59 | |
<> | 149:156823d33999 | 60 | // Get the pin function and assign the used channel to the object |
<> | 149:156823d33999 | 61 | uint32_t function = pinmap_function(pin, PinMap_ADC); |
<> | 149:156823d33999 | 62 | MBED_ASSERT(function != (uint32_t)NC); |
<> | 149:156823d33999 | 63 | obj->channel = STM_PIN_CHANNEL(function); |
<> | 149:156823d33999 | 64 | |
<> | 150:02e0a0aed4ec | 65 | // Configure GPIO excepted for internal channels (Temperature, Vref, Vbat, ...) |
<> | 150:02e0a0aed4ec | 66 | // ADC Internal Channels "pins" are described in PinNames.h and must have a value >= 0xF0 |
<> | 150:02e0a0aed4ec | 67 | if (pin < 0xF0) { |
<> | 149:156823d33999 | 68 | pinmap_pinout(pin, PinMap_ADC); |
<> | 149:156823d33999 | 69 | } |
<> | 149:156823d33999 | 70 | |
<> | 149:156823d33999 | 71 | // Save pin number for the read function |
<> | 149:156823d33999 | 72 | obj->pin = pin; |
<> | 149:156823d33999 | 73 | |
<> | 149:156823d33999 | 74 | // Check if ADC is already initialized |
<> | 149:156823d33999 | 75 | // Enable ADC clock |
<> | 149:156823d33999 | 76 | #if defined(ADC1) |
<> | 149:156823d33999 | 77 | if ((obj->adc == ADC_1) && adc1_inited) return; |
<> | 149:156823d33999 | 78 | if (obj->adc == ADC_1) { |
<> | 149:156823d33999 | 79 | AdcHandle.State = HAL_ADC_STATE_RESET; |
<> | 149:156823d33999 | 80 | __ADC1_CLK_ENABLE(); |
<> | 149:156823d33999 | 81 | adc1_inited = 1; |
<> | 149:156823d33999 | 82 | } |
<> | 149:156823d33999 | 83 | #endif |
<> | 149:156823d33999 | 84 | #if defined(ADC2) |
<> | 149:156823d33999 | 85 | if ((obj->adc == ADC_2) && adc2_inited) return; |
<> | 149:156823d33999 | 86 | if (obj->adc == ADC_2) { |
<> | 149:156823d33999 | 87 | AdcHandle.State = HAL_ADC_STATE_RESET; |
<> | 149:156823d33999 | 88 | __ADC2_CLK_ENABLE(); |
<> | 149:156823d33999 | 89 | adc2_inited = 1; |
<> | 149:156823d33999 | 90 | } |
<> | 149:156823d33999 | 91 | #endif |
<> | 149:156823d33999 | 92 | #if defined(ADC3) |
<> | 149:156823d33999 | 93 | if ((obj->adc == ADC_3) && adc3_inited) return; |
<> | 149:156823d33999 | 94 | if (obj->adc == ADC_3) { |
<> | 149:156823d33999 | 95 | AdcHandle.State = HAL_ADC_STATE_RESET; |
<> | 149:156823d33999 | 96 | __ADC34_CLK_ENABLE(); |
<> | 149:156823d33999 | 97 | adc3_inited = 1; |
<> | 149:156823d33999 | 98 | } |
<> | 149:156823d33999 | 99 | #endif |
<> | 149:156823d33999 | 100 | #if defined(ADC4) |
<> | 149:156823d33999 | 101 | if ((obj->adc == ADC_4) && adc4_inited) return; |
<> | 149:156823d33999 | 102 | if (obj->adc == ADC_4) { |
<> | 149:156823d33999 | 103 | AdcHandle.State = HAL_ADC_STATE_RESET; |
<> | 149:156823d33999 | 104 | __ADC34_CLK_ENABLE(); |
<> | 149:156823d33999 | 105 | adc4_inited = 1; |
<> | 149:156823d33999 | 106 | } |
<> | 149:156823d33999 | 107 | #endif |
<> | 149:156823d33999 | 108 | |
<> | 149:156823d33999 | 109 | // Configure ADC |
<> | 149:156823d33999 | 110 | AdcHandle.Instance = (ADC_TypeDef *)(obj->adc); |
<> | 149:156823d33999 | 111 | AdcHandle.Init.ClockPrescaler = ADC_CLOCKPRESCALER_PCLK_DIV2; |
<> | 149:156823d33999 | 112 | AdcHandle.Init.Resolution = ADC_RESOLUTION12b; |
<> | 149:156823d33999 | 113 | AdcHandle.Init.DataAlign = ADC_DATAALIGN_RIGHT; |
<> | 149:156823d33999 | 114 | AdcHandle.Init.ScanConvMode = DISABLE; |
<> | 149:156823d33999 | 115 | AdcHandle.Init.EOCSelection = EOC_SINGLE_CONV; |
<> | 149:156823d33999 | 116 | AdcHandle.Init.LowPowerAutoWait = DISABLE; |
<> | 149:156823d33999 | 117 | AdcHandle.Init.ContinuousConvMode = DISABLE; |
<> | 149:156823d33999 | 118 | AdcHandle.Init.NbrOfConversion = 1; |
<> | 149:156823d33999 | 119 | AdcHandle.Init.DiscontinuousConvMode = DISABLE; |
<> | 149:156823d33999 | 120 | AdcHandle.Init.NbrOfDiscConversion = 0; |
<> | 149:156823d33999 | 121 | AdcHandle.Init.ExternalTrigConv = ADC_EXTERNALTRIGCONV_T1_CC1; |
<> | 149:156823d33999 | 122 | AdcHandle.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE; |
<> | 149:156823d33999 | 123 | AdcHandle.Init.DMAContinuousRequests = DISABLE; |
<> | 149:156823d33999 | 124 | AdcHandle.Init.Overrun = OVR_DATA_OVERWRITTEN; |
<> | 149:156823d33999 | 125 | |
<> | 149:156823d33999 | 126 | if (HAL_ADC_Init(&AdcHandle) != HAL_OK) { |
<> | 149:156823d33999 | 127 | error("Cannot initialize ADC"); |
<> | 149:156823d33999 | 128 | } |
<> | 149:156823d33999 | 129 | } |
<> | 149:156823d33999 | 130 | |
<> | 149:156823d33999 | 131 | static inline uint16_t adc_read(analogin_t *obj) |
<> | 149:156823d33999 | 132 | { |
<> | 149:156823d33999 | 133 | ADC_ChannelConfTypeDef sConfig = {0}; |
<> | 149:156823d33999 | 134 | |
<> | 149:156823d33999 | 135 | AdcHandle.Instance = (ADC_TypeDef *)(obj->adc); |
<> | 149:156823d33999 | 136 | |
<> | 149:156823d33999 | 137 | // Configure ADC channel |
<> | 149:156823d33999 | 138 | sConfig.Rank = ADC_REGULAR_RANK_1; |
<> | 149:156823d33999 | 139 | sConfig.SamplingTime = ADC_SAMPLETIME_19CYCLES_5; |
<> | 149:156823d33999 | 140 | sConfig.SingleDiff = ADC_SINGLE_ENDED; |
<> | 149:156823d33999 | 141 | sConfig.OffsetNumber = ADC_OFFSET_NONE; |
<> | 149:156823d33999 | 142 | sConfig.Offset = 0; |
<> | 149:156823d33999 | 143 | |
<> | 149:156823d33999 | 144 | switch (obj->channel) { |
<> | 149:156823d33999 | 145 | case 1: |
<> | 149:156823d33999 | 146 | sConfig.Channel = ADC_CHANNEL_1; |
<> | 149:156823d33999 | 147 | break; |
<> | 149:156823d33999 | 148 | case 2: |
<> | 149:156823d33999 | 149 | sConfig.Channel = ADC_CHANNEL_2; |
<> | 149:156823d33999 | 150 | break; |
<> | 149:156823d33999 | 151 | case 3: |
<> | 149:156823d33999 | 152 | sConfig.Channel = ADC_CHANNEL_3; |
<> | 149:156823d33999 | 153 | break; |
<> | 149:156823d33999 | 154 | case 4: |
<> | 149:156823d33999 | 155 | sConfig.Channel = ADC_CHANNEL_4; |
<> | 149:156823d33999 | 156 | break; |
<> | 149:156823d33999 | 157 | case 5: |
<> | 149:156823d33999 | 158 | sConfig.Channel = ADC_CHANNEL_5; |
<> | 149:156823d33999 | 159 | break; |
<> | 149:156823d33999 | 160 | case 6: |
<> | 149:156823d33999 | 161 | sConfig.Channel = ADC_CHANNEL_6; |
<> | 149:156823d33999 | 162 | break; |
<> | 149:156823d33999 | 163 | case 7: |
<> | 149:156823d33999 | 164 | sConfig.Channel = ADC_CHANNEL_7; |
<> | 149:156823d33999 | 165 | break; |
<> | 149:156823d33999 | 166 | case 8: |
<> | 149:156823d33999 | 167 | sConfig.Channel = ADC_CHANNEL_8; |
<> | 149:156823d33999 | 168 | break; |
<> | 149:156823d33999 | 169 | case 9: |
<> | 149:156823d33999 | 170 | sConfig.Channel = ADC_CHANNEL_9; |
<> | 149:156823d33999 | 171 | break; |
<> | 149:156823d33999 | 172 | case 10: |
<> | 149:156823d33999 | 173 | sConfig.Channel = ADC_CHANNEL_10; |
<> | 149:156823d33999 | 174 | break; |
<> | 149:156823d33999 | 175 | case 11: |
<> | 149:156823d33999 | 176 | sConfig.Channel = ADC_CHANNEL_11; |
<> | 149:156823d33999 | 177 | break; |
<> | 149:156823d33999 | 178 | case 12: |
<> | 149:156823d33999 | 179 | sConfig.Channel = ADC_CHANNEL_12; |
<> | 149:156823d33999 | 180 | break; |
<> | 149:156823d33999 | 181 | case 13: |
<> | 149:156823d33999 | 182 | sConfig.Channel = ADC_CHANNEL_13; |
<> | 149:156823d33999 | 183 | break; |
<> | 149:156823d33999 | 184 | case 14: |
<> | 149:156823d33999 | 185 | sConfig.Channel = ADC_CHANNEL_14; |
<> | 149:156823d33999 | 186 | break; |
<> | 149:156823d33999 | 187 | case 15: |
<> | 149:156823d33999 | 188 | sConfig.Channel = ADC_CHANNEL_15; |
<> | 149:156823d33999 | 189 | break; |
<> | 149:156823d33999 | 190 | case 16: |
<> | 149:156823d33999 | 191 | sConfig.Channel = ADC_CHANNEL_16; |
<> | 149:156823d33999 | 192 | break; |
<> | 149:156823d33999 | 193 | case 17: |
<> | 149:156823d33999 | 194 | sConfig.Channel = ADC_CHANNEL_17; |
<> | 149:156823d33999 | 195 | break; |
<> | 149:156823d33999 | 196 | case 18: |
<> | 149:156823d33999 | 197 | sConfig.Channel = ADC_CHANNEL_18; |
<> | 149:156823d33999 | 198 | break; |
<> | 149:156823d33999 | 199 | default: |
<> | 149:156823d33999 | 200 | return 0; |
<> | 149:156823d33999 | 201 | } |
<> | 149:156823d33999 | 202 | |
<> | 149:156823d33999 | 203 | HAL_ADC_ConfigChannel(&AdcHandle, &sConfig); |
<> | 149:156823d33999 | 204 | |
<> | 149:156823d33999 | 205 | HAL_ADC_Start(&AdcHandle); // Start conversion |
<> | 149:156823d33999 | 206 | |
<> | 149:156823d33999 | 207 | // Wait end of conversion and get value |
<> | 149:156823d33999 | 208 | if (HAL_ADC_PollForConversion(&AdcHandle, 10) == HAL_OK) { |
<> | 149:156823d33999 | 209 | return (HAL_ADC_GetValue(&AdcHandle)); |
<> | 149:156823d33999 | 210 | } else { |
<> | 149:156823d33999 | 211 | return 0; |
<> | 149:156823d33999 | 212 | } |
<> | 149:156823d33999 | 213 | } |
<> | 149:156823d33999 | 214 | |
<> | 149:156823d33999 | 215 | uint16_t analogin_read_u16(analogin_t *obj) |
<> | 149:156823d33999 | 216 | { |
<> | 149:156823d33999 | 217 | uint16_t value = adc_read(obj); |
<> | 149:156823d33999 | 218 | // 12-bit to 16-bit conversion |
<> | 149:156823d33999 | 219 | value = ((value << 4) & (uint16_t)0xFFF0) | ((value >> 8) & (uint16_t)0x000F); |
<> | 149:156823d33999 | 220 | return value; |
<> | 149:156823d33999 | 221 | } |
<> | 149:156823d33999 | 222 | |
<> | 149:156823d33999 | 223 | float analogin_read(analogin_t *obj) |
<> | 149:156823d33999 | 224 | { |
<> | 149:156823d33999 | 225 | uint16_t value = adc_read(obj); |
<> | 149:156823d33999 | 226 | return (float)value * (1.0f / (float)0xFFF); // 12 bits range |
<> | 149:156823d33999 | 227 | } |
<> | 149:156823d33999 | 228 | |
<> | 149:156823d33999 | 229 | #endif |