mbed library sources. With a patch for the can_api
Fork of mbed-dev by
targets/TARGET_STM/TARGET_STM32F1/analogin_api.c@151:91825d030f9b, 2016-11-14 (annotated)
- Committer:
- DangerousElectrician
- Date:
- Mon Nov 14 04:39:23 2016 +0000
- Revision:
- 151:91825d030f9b
- Parent:
- 150:02e0a0aed4ec
stuff changed?
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 | |
<> | 149:156823d33999 | 33 | #include "wait_api.h" |
<> | 149:156823d33999 | 34 | #include "cmsis.h" |
<> | 149:156823d33999 | 35 | #include "pinmap.h" |
<> | 149:156823d33999 | 36 | #include "PeripheralPins.h" |
<> | 149:156823d33999 | 37 | |
<> | 149:156823d33999 | 38 | ADC_HandleTypeDef AdcHandle; |
<> | 149:156823d33999 | 39 | |
<> | 149:156823d33999 | 40 | int adc_inited = 0; |
<> | 149:156823d33999 | 41 | |
<> | 149:156823d33999 | 42 | void analogin_init(analogin_t *obj, PinName pin) |
<> | 149:156823d33999 | 43 | { |
<> | 149:156823d33999 | 44 | RCC_PeriphCLKInitTypeDef PeriphClkInit; |
<> | 149:156823d33999 | 45 | |
<> | 149:156823d33999 | 46 | // Get the peripheral name from the pin and assign it to the object |
<> | 149:156823d33999 | 47 | obj->adc = (ADCName)pinmap_peripheral(pin, PinMap_ADC); |
<> | 149:156823d33999 | 48 | MBED_ASSERT(obj->adc != (ADCName)NC); |
<> | 149:156823d33999 | 49 | |
<> | 149:156823d33999 | 50 | // Get the functions (adc channel) from the pin and assign it to the object |
<> | 149:156823d33999 | 51 | uint32_t function = pinmap_function(pin, PinMap_ADC); |
<> | 149:156823d33999 | 52 | MBED_ASSERT(function != (uint32_t)NC); |
<> | 149:156823d33999 | 53 | obj->channel = STM_PIN_CHANNEL(function); |
<> | 149:156823d33999 | 54 | |
<> | 150:02e0a0aed4ec | 55 | // Configure GPIO excepted for internal channels (Temperature, Vref, Vbat, ...) |
<> | 150:02e0a0aed4ec | 56 | // ADC Internal Channels "pins" are described in PinNames.h and must have a value >= 0xF0 |
<> | 150:02e0a0aed4ec | 57 | if (pin < 0xF0) { |
<> | 149:156823d33999 | 58 | pinmap_pinout(pin, PinMap_ADC); |
<> | 149:156823d33999 | 59 | } |
<> | 149:156823d33999 | 60 | |
<> | 149:156823d33999 | 61 | // Save pin number for the read function |
<> | 149:156823d33999 | 62 | obj->pin = pin; |
<> | 149:156823d33999 | 63 | |
<> | 149:156823d33999 | 64 | // The ADC initialization is done once |
<> | 149:156823d33999 | 65 | if (adc_inited == 0) { |
<> | 149:156823d33999 | 66 | adc_inited = 1; |
<> | 149:156823d33999 | 67 | |
<> | 149:156823d33999 | 68 | // Enable ADC clock |
<> | 149:156823d33999 | 69 | __HAL_RCC_ADC1_CLK_ENABLE(); |
<> | 149:156823d33999 | 70 | |
<> | 149:156823d33999 | 71 | // Configure ADC clock prescaler |
<> | 149:156823d33999 | 72 | // Caution: On STM32F1, ADC clock frequency max is 14 MHz (refer to device datasheet). |
<> | 149:156823d33999 | 73 | // Therefore, ADC clock prescaler must be configured in function |
<> | 149:156823d33999 | 74 | // of ADC clock source frequency to remain below this maximum frequency. |
<> | 149:156823d33999 | 75 | // with 8 MHz external xtal: PCLK2 = 72 MHz --> ADC clock = 72/6 = 12 MHz |
<> | 149:156823d33999 | 76 | // with internal clock : PCLK2 = 64 MHz --> ADC clock = 64/6 = 10.67 MHz |
<> | 149:156823d33999 | 77 | PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC; |
<> | 149:156823d33999 | 78 | PeriphClkInit.AdcClockSelection = RCC_ADCPCLK2_DIV6; |
<> | 149:156823d33999 | 79 | HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit); |
<> | 149:156823d33999 | 80 | |
<> | 149:156823d33999 | 81 | // Configure ADC |
<> | 149:156823d33999 | 82 | AdcHandle.Instance = (ADC_TypeDef *)(obj->adc); |
<> | 149:156823d33999 | 83 | AdcHandle.Init.DataAlign = ADC_DATAALIGN_RIGHT; |
<> | 149:156823d33999 | 84 | AdcHandle.Init.ScanConvMode = DISABLE; |
<> | 149:156823d33999 | 85 | AdcHandle.Init.ContinuousConvMode = DISABLE; |
<> | 149:156823d33999 | 86 | AdcHandle.Init.NbrOfConversion = 1; |
<> | 149:156823d33999 | 87 | AdcHandle.Init.DiscontinuousConvMode = DISABLE; |
<> | 149:156823d33999 | 88 | AdcHandle.Init.NbrOfDiscConversion = 0; |
<> | 149:156823d33999 | 89 | AdcHandle.Init.ExternalTrigConv = ADC_SOFTWARE_START; |
<> | 149:156823d33999 | 90 | HAL_ADC_Init(&AdcHandle); |
<> | 149:156823d33999 | 91 | } |
<> | 149:156823d33999 | 92 | } |
<> | 149:156823d33999 | 93 | |
<> | 149:156823d33999 | 94 | static inline uint16_t adc_read(analogin_t *obj) |
<> | 149:156823d33999 | 95 | { |
<> | 149:156823d33999 | 96 | ADC_ChannelConfTypeDef sConfig; |
<> | 149:156823d33999 | 97 | |
<> | 149:156823d33999 | 98 | AdcHandle.Instance = (ADC_TypeDef *)(obj->adc); |
<> | 149:156823d33999 | 99 | |
<> | 149:156823d33999 | 100 | // Configure ADC channel |
<> | 149:156823d33999 | 101 | sConfig.Rank = 1; |
<> | 149:156823d33999 | 102 | sConfig.SamplingTime = ADC_SAMPLETIME_7CYCLES_5; |
<> | 149:156823d33999 | 103 | |
<> | 149:156823d33999 | 104 | switch (obj->channel) { |
<> | 149:156823d33999 | 105 | case 0: |
<> | 149:156823d33999 | 106 | sConfig.Channel = ADC_CHANNEL_0; |
<> | 149:156823d33999 | 107 | break; |
<> | 149:156823d33999 | 108 | case 1: |
<> | 149:156823d33999 | 109 | sConfig.Channel = ADC_CHANNEL_1; |
<> | 149:156823d33999 | 110 | break; |
<> | 149:156823d33999 | 111 | case 2: |
<> | 149:156823d33999 | 112 | sConfig.Channel = ADC_CHANNEL_2; |
<> | 149:156823d33999 | 113 | break; |
<> | 149:156823d33999 | 114 | case 3: |
<> | 149:156823d33999 | 115 | sConfig.Channel = ADC_CHANNEL_3; |
<> | 149:156823d33999 | 116 | break; |
<> | 149:156823d33999 | 117 | case 4: |
<> | 149:156823d33999 | 118 | sConfig.Channel = ADC_CHANNEL_4; |
<> | 149:156823d33999 | 119 | break; |
<> | 149:156823d33999 | 120 | case 5: |
<> | 149:156823d33999 | 121 | sConfig.Channel = ADC_CHANNEL_5; |
<> | 149:156823d33999 | 122 | break; |
<> | 149:156823d33999 | 123 | case 6: |
<> | 149:156823d33999 | 124 | sConfig.Channel = ADC_CHANNEL_6; |
<> | 149:156823d33999 | 125 | break; |
<> | 149:156823d33999 | 126 | case 7: |
<> | 149:156823d33999 | 127 | sConfig.Channel = ADC_CHANNEL_7; |
<> | 149:156823d33999 | 128 | break; |
<> | 149:156823d33999 | 129 | case 8: |
<> | 149:156823d33999 | 130 | sConfig.Channel = ADC_CHANNEL_8; |
<> | 149:156823d33999 | 131 | break; |
<> | 149:156823d33999 | 132 | case 9: |
<> | 149:156823d33999 | 133 | sConfig.Channel = ADC_CHANNEL_9; |
<> | 149:156823d33999 | 134 | break; |
<> | 149:156823d33999 | 135 | case 10: |
<> | 149:156823d33999 | 136 | sConfig.Channel = ADC_CHANNEL_10; |
<> | 149:156823d33999 | 137 | break; |
<> | 149:156823d33999 | 138 | case 11: |
<> | 149:156823d33999 | 139 | sConfig.Channel = ADC_CHANNEL_11; |
<> | 149:156823d33999 | 140 | break; |
<> | 149:156823d33999 | 141 | case 12: |
<> | 149:156823d33999 | 142 | sConfig.Channel = ADC_CHANNEL_12; |
<> | 149:156823d33999 | 143 | break; |
<> | 149:156823d33999 | 144 | case 13: |
<> | 149:156823d33999 | 145 | sConfig.Channel = ADC_CHANNEL_13; |
<> | 149:156823d33999 | 146 | break; |
<> | 149:156823d33999 | 147 | case 14: |
<> | 149:156823d33999 | 148 | sConfig.Channel = ADC_CHANNEL_14; |
<> | 149:156823d33999 | 149 | break; |
<> | 149:156823d33999 | 150 | case 15: |
<> | 149:156823d33999 | 151 | sConfig.Channel = ADC_CHANNEL_15; |
<> | 149:156823d33999 | 152 | break; |
<> | 149:156823d33999 | 153 | case 16: |
<> | 149:156823d33999 | 154 | sConfig.Channel = ADC_CHANNEL_TEMPSENSOR; |
<> | 149:156823d33999 | 155 | break; |
<> | 149:156823d33999 | 156 | case 17: |
<> | 149:156823d33999 | 157 | sConfig.Channel = ADC_CHANNEL_VREFINT; |
<> | 149:156823d33999 | 158 | break; |
<> | 149:156823d33999 | 159 | default: |
<> | 149:156823d33999 | 160 | return 0; |
<> | 149:156823d33999 | 161 | } |
<> | 149:156823d33999 | 162 | |
<> | 149:156823d33999 | 163 | HAL_ADC_ConfigChannel(&AdcHandle, &sConfig); |
<> | 149:156823d33999 | 164 | |
<> | 149:156823d33999 | 165 | HAL_ADC_Start(&AdcHandle); // Start conversion |
<> | 149:156823d33999 | 166 | |
<> | 149:156823d33999 | 167 | // Wait end of conversion and get value |
<> | 149:156823d33999 | 168 | if (HAL_ADC_PollForConversion(&AdcHandle, 10) == HAL_OK) { |
<> | 149:156823d33999 | 169 | return (HAL_ADC_GetValue(&AdcHandle)); |
<> | 149:156823d33999 | 170 | } else { |
<> | 149:156823d33999 | 171 | return 0; |
<> | 149:156823d33999 | 172 | } |
<> | 149:156823d33999 | 173 | } |
<> | 149:156823d33999 | 174 | |
<> | 149:156823d33999 | 175 | uint16_t analogin_read_u16(analogin_t *obj) |
<> | 149:156823d33999 | 176 | { |
<> | 149:156823d33999 | 177 | uint16_t value = adc_read(obj); |
<> | 149:156823d33999 | 178 | // 12-bit to 16-bit conversion |
<> | 149:156823d33999 | 179 | value = ((value << 4) & (uint16_t)0xFFF0) | ((value >> 8) & (uint16_t)0x000F); |
<> | 149:156823d33999 | 180 | return value; |
<> | 149:156823d33999 | 181 | } |
<> | 149:156823d33999 | 182 | |
<> | 149:156823d33999 | 183 | float analogin_read(analogin_t *obj) |
<> | 149:156823d33999 | 184 | { |
<> | 149:156823d33999 | 185 | uint16_t value = adc_read(obj); |
<> | 149:156823d33999 | 186 | return (float)value * (1.0f / (float)0xFFF); // 12 bits range |
<> | 149:156823d33999 | 187 | } |
<> | 149:156823d33999 | 188 | |
<> | 149:156823d33999 | 189 | #endif |