Umar Naeem / mbed-dev

mbed library sources. Supersedes mbed-src.

Fork of mbed-dev by Umar Naeem

targets/TARGET_ONSEMI/TARGET_NCS36510/analogin_api.c@149:156823d33999, 2016-10-28 (annotated)

Committer:
<>
Date:
Fri Oct 28 11:17:30 2016 +0100
Revision:
149:156823d33999
Parent:
targets/hal/TARGET_ONSEMI/TARGET_NCS36510/analogin_api.c@147:30b64687e01f
Child:
153:fa9ff456f731
This updates the lib to the mbed lib v128



NOTE: This release includes a restructuring of the file and directory locations and thus some

include paths in your code may need updating accordingly.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file adc_sar.c
<> 144:ef7eb2e8f9f7 4 * @brief Implementation of a SAR ADC driver
<> 144:ef7eb2e8f9f7 5 * @internal
<> 144:ef7eb2e8f9f7 6 * @author ON Semiconductor
<> 144:ef7eb2e8f9f7 7 * $Rev:
<> 144:ef7eb2e8f9f7 8 * $Date:
<> 144:ef7eb2e8f9f7 9 ******************************************************************************
<> 147:30b64687e01f 10 * Copyright 2016 Semiconductor Components Industries LLC (d/b/a “ON Semiconductor”).
<> 147:30b64687e01f 11 * All rights reserved. This software and/or documentation is licensed by ON Semiconductor
<> 147:30b64687e01f 12 * under limited terms and conditions. The terms and conditions pertaining to the software
<> 147:30b64687e01f 13 * and/or documentation are available at http://www.onsemi.com/site/pdf/ONSEMI_T&C.pdf
<> 147:30b64687e01f 14 * (“ON Semiconductor Standard Terms and Conditions of Sale, Section 8 Software”) and
<> 147:30b64687e01f 15 * if applicable the software license agreement. Do not use this software and/or
<> 147:30b64687e01f 16 * documentation unless you have carefully read and you agree to the limited terms and
<> 147:30b64687e01f 17 * conditions. By using this software and/or documentation, you agree to the limited
<> 147:30b64687e01f 18 * terms and conditions.
<> 144:ef7eb2e8f9f7 19 *
<> 144:ef7eb2e8f9f7 20 * THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED
<> 144:ef7eb2e8f9f7 21 * OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
<> 144:ef7eb2e8f9f7 22 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE.
<> 144:ef7eb2e8f9f7 23 * ON SEMICONDUCTOR SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL,
<> 144:ef7eb2e8f9f7 24 * INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.
<> 144:ef7eb2e8f9f7 25 * @endinternal
<> 144:ef7eb2e8f9f7 26 *
<> 144:ef7eb2e8f9f7 27 * @ingroup adc_sar
<> 144:ef7eb2e8f9f7 28 *
<> 144:ef7eb2e8f9f7 29 * @details
<> 144:ef7eb2e8f9f7 30 * <p>
<> 144:ef7eb2e8f9f7 31 * </p>
<> 144:ef7eb2e8f9f7 32 *
<> 144:ef7eb2e8f9f7 33 */
<> 144:ef7eb2e8f9f7 34
<> 144:ef7eb2e8f9f7 35 #include "device.h"
<> 144:ef7eb2e8f9f7 36 #include "analogin_api.h"
<> 144:ef7eb2e8f9f7 37 #include "PeripheralPins.h"
<> 144:ef7eb2e8f9f7 38 #include "mbed_assert.h"
<> 144:ef7eb2e8f9f7 39 #include "clock.h"
<> 144:ef7eb2e8f9f7 40 #include "adc_sar.h"
<> 144:ef7eb2e8f9f7 41
<> 144:ef7eb2e8f9f7 42 #if DEVICE_ANALOGIN
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 /**
<> 144:ef7eb2e8f9f7 45 * \defgroup hal_analogin Analogin hal functions
<> 144:ef7eb2e8f9f7 46 * @{
<> 144:ef7eb2e8f9f7 47 */
<> 144:ef7eb2e8f9f7 48
<> 144:ef7eb2e8f9f7 49 /** Initialize the analogin peripheral
<> 144:ef7eb2e8f9f7 50 *
<> 144:ef7eb2e8f9f7 51 * Configures the pin used by analogin.
<> 144:ef7eb2e8f9f7 52 * @param obj The analogin object to initialize
<> 144:ef7eb2e8f9f7 53 * @param pin The analogin pin name
<> 144:ef7eb2e8f9f7 54 */
<> 144:ef7eb2e8f9f7 55 void analogin_init(analogin_t *obj, PinName pin)
<> 144:ef7eb2e8f9f7 56 {
<> 144:ef7eb2e8f9f7 57 CLOCK_ENABLE(CLOCK_ADC);
<> 144:ef7eb2e8f9f7 58 ADCName adc;
<> 144:ef7eb2e8f9f7 59 uint8_t adc_pin = 0;
<> 144:ef7eb2e8f9f7 60
<> 144:ef7eb2e8f9f7 61 adc = (ADCName)pinmap_peripheral(pin, PinMap_ADC);
<> 144:ef7eb2e8f9f7 62 MBED_ASSERT(adc != (ADCName)NC);
<> 144:ef7eb2e8f9f7 63
<> 144:ef7eb2e8f9f7 64 obj->adcReg = (AdcReg_pt)adc;
<> 144:ef7eb2e8f9f7 65 obj->pin = pin;
<> 144:ef7eb2e8f9f7 66 obj->pinFlag = 1;
<> 144:ef7eb2e8f9f7 67
<> 144:ef7eb2e8f9f7 68 switch (pin) {
<> 144:ef7eb2e8f9f7 69 case A0:
<> 144:ef7eb2e8f9f7 70 adc_pin=0;
<> 144:ef7eb2e8f9f7 71 break;
<> 144:ef7eb2e8f9f7 72 case A1:
<> 144:ef7eb2e8f9f7 73 adc_pin = 1;
<> 144:ef7eb2e8f9f7 74 break;
<> 144:ef7eb2e8f9f7 75 case A2:
<> 144:ef7eb2e8f9f7 76 adc_pin = 2;
<> 144:ef7eb2e8f9f7 77 break;
<> 144:ef7eb2e8f9f7 78 case A3:
<> 144:ef7eb2e8f9f7 79 adc_pin = 3;
<> 144:ef7eb2e8f9f7 80 break;
<> 144:ef7eb2e8f9f7 81 default:
<> 144:ef7eb2e8f9f7 82 break;
<> 144:ef7eb2e8f9f7 83 }
<> 144:ef7eb2e8f9f7 84
<> 144:ef7eb2e8f9f7 85 /* If no config parameters are passed on; assume default value */
<> 144:ef7eb2e8f9f7 86 if (obj->adcConf == Null) {
<> 144:ef7eb2e8f9f7 87 /* Single sample, absolute conversion, scale = 1 */
<> 144:ef7eb2e8f9f7 88 obj->adcReg->CONTROL.WORD = ((0 << ADC_CONTROL_MODE_BIT_POS) |
<> 144:ef7eb2e8f9f7 89 (1 << ADC_CONTROL_MEASTYPE_BIT_POS) |
<> 144:ef7eb2e8f9f7 90 (1 << ADC_CONTROL_INPUTSCALE_BIT_POS) |
<> 144:ef7eb2e8f9f7 91 (((uint8_t)adc_pin) << ADC_CONTROL_MEAS_CH_BIT_POS));
<> 144:ef7eb2e8f9f7 92
<> 144:ef7eb2e8f9f7 93 /* Prescaler enabled; set to 7 */
<> 144:ef7eb2e8f9f7 94 obj->adcReg->PRESCALE.WORD = ((True << ADC_PRESCALE_EN_BIT_POS) |
<> 144:ef7eb2e8f9f7 95 (7 << ADC_PRESCALE_VAL_BIT_POS)); /* ADC clock = 32MHz/(Prescale + 1) */
<> 144:ef7eb2e8f9f7 96
<> 144:ef7eb2e8f9f7 97 obj->adcReg->DELAY.WORD = ((0x34 << ADC_DELAY_SAMPLE_RATE_BIT_POS) | /** 25 uS Sets the sample rate in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 98 (0x05 << ADC_DELAY_WARMUP_BIT_POS) | /** 12.5 uS Sets the measure time in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 99 (0x1A << ADC_DELAY_SAMPLE_TIME_BIT_POS)); /** 2.5 uS Sets the warm-up time in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 100
<> 144:ef7eb2e8f9f7 101 obj->adcReg->IR = 0; /** No interrupt generated */
<> 144:ef7eb2e8f9f7 102 } else {
<> 144:ef7eb2e8f9f7 103 obj->adcConf->convCh = adc_pin;
<> 144:ef7eb2e8f9f7 104
<> 144:ef7eb2e8f9f7 105 /* ADC register settings */
<> 144:ef7eb2e8f9f7 106 if((obj->adcConf->measurementType) == ADC_RELATIVE_MEAS) {
<> 144:ef7eb2e8f9f7 107 obj->adcReg->CONTROL.WORD = ((obj->adcConf->mode << ADC_CONTROL_MODE_BIT_POS) |
<> 144:ef7eb2e8f9f7 108 (obj->adcConf->measurementType << ADC_CONTROL_MEASTYPE_BIT_POS) |
<> 144:ef7eb2e8f9f7 109 (obj->adcConf->inputScale << ADC_CONTROL_INPUTSCALE_BIT_POS) |
<> 144:ef7eb2e8f9f7 110 (obj->adcConf->convCh << ADC_CONTROL_MEAS_CH_BIT_POS) |
<> 144:ef7eb2e8f9f7 111 (obj->adcConf->referenceCh << ADC_CONTROL_REF_CH_BIT_POS));
<> 144:ef7eb2e8f9f7 112 } else {
<> 144:ef7eb2e8f9f7 113 obj->adcReg->CONTROL.WORD = ((obj->adcConf->mode << ADC_CONTROL_MODE_BIT_POS) |
<> 144:ef7eb2e8f9f7 114 (obj->adcConf->measurementType << ADC_CONTROL_MEASTYPE_BIT_POS) |
<> 144:ef7eb2e8f9f7 115 (obj->adcConf->inputScale << ADC_CONTROL_INPUTSCALE_BIT_POS) |
<> 144:ef7eb2e8f9f7 116 (obj->adcConf->convCh << ADC_CONTROL_MEAS_CH_BIT_POS));
<> 144:ef7eb2e8f9f7 117 }
<> 144:ef7eb2e8f9f7 118
<> 144:ef7eb2e8f9f7 119 obj->adcReg->PRESCALE.WORD = ((True << ADC_PRESCALE_EN_BIT_POS) |
<> 144:ef7eb2e8f9f7 120 (obj->adcConf->PrescaleVal << ADC_PRESCALE_VAL_BIT_POS)); /* ADC clock = 32MHz/(Prescale + 1) */
<> 144:ef7eb2e8f9f7 121
<> 144:ef7eb2e8f9f7 122 obj->adcReg->DELAY.WORD = ((obj->adcConf->samplingRate << ADC_DELAY_SAMPLE_RATE_BIT_POS) | /** 25 uS Sets the sample rate in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 123 (obj->adcConf->WarmUpTime << ADC_DELAY_WARMUP_BIT_POS) | /** 12.5 uS Sets the measure time in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 124 (obj->adcConf->samplingTime << ADC_DELAY_SAMPLE_TIME_BIT_POS)); /** 2.5 uS Sets the warm-up time in units of PCLKperiod * (Prescale + 1). */
<> 144:ef7eb2e8f9f7 125
<> 144:ef7eb2e8f9f7 126 obj->adcReg->IR = obj->adcConf->interruptConfig; /** Interrupt setting */
<> 144:ef7eb2e8f9f7 127 }
<> 144:ef7eb2e8f9f7 128
<> 144:ef7eb2e8f9f7 129 /* Enable interrupt */
<> 144:ef7eb2e8f9f7 130 NVIC_ClearPendingIRQ(Adc_IRQn);
<> 144:ef7eb2e8f9f7 131 NVIC_EnableIRQ(Adc_IRQn);
<> 144:ef7eb2e8f9f7 132 }
<> 144:ef7eb2e8f9f7 133
<> 144:ef7eb2e8f9f7 134 /** Read the input voltage, represented as a float in the range [0.0, 1.0]
<> 144:ef7eb2e8f9f7 135 *
<> 144:ef7eb2e8f9f7 136 * @param obj The analogin object
<> 144:ef7eb2e8f9f7 137 * @return A floating value representing the current input voltage
<> 144:ef7eb2e8f9f7 138 */
<> 144:ef7eb2e8f9f7 139 float analogin_read(analogin_t *obj)
<> 144:ef7eb2e8f9f7 140 {
<> 144:ef7eb2e8f9f7 141 float retVal = 0.0;
<> 144:ef7eb2e8f9f7 142 uint16_t value = analogin_read_u16(obj);
<> 144:ef7eb2e8f9f7 143 retVal = (float)value * (1.0f / (float)0x03FF);
<> 144:ef7eb2e8f9f7 144 return(retVal);
<> 144:ef7eb2e8f9f7 145 }
<> 144:ef7eb2e8f9f7 146
<> 144:ef7eb2e8f9f7 147 /** Read the value from analogin pin, represented as an unsigned 16bit value
<> 144:ef7eb2e8f9f7 148 *
<> 144:ef7eb2e8f9f7 149 * @param obj The analogin object
<> 144:ef7eb2e8f9f7 150 * @return An unsigned 16bit value representing the current input voltage
<> 144:ef7eb2e8f9f7 151 */
<> 144:ef7eb2e8f9f7 152 uint16_t analogin_read_u16(analogin_t *obj)
<> 144:ef7eb2e8f9f7 153 {
<> 144:ef7eb2e8f9f7 154 uint16_t adcData = 0;
<> 144:ef7eb2e8f9f7 155 uint8_t adc_pin = 0;
<> 144:ef7eb2e8f9f7 156
<> 144:ef7eb2e8f9f7 157 CLOCK_ENABLE(CLOCK_ADC);
<> 144:ef7eb2e8f9f7 158
<> 144:ef7eb2e8f9f7 159 if (obj->pinFlag) {
<> 144:ef7eb2e8f9f7 160 switch (obj->pin) {
<> 144:ef7eb2e8f9f7 161 case A0:
<> 144:ef7eb2e8f9f7 162 adc_pin=0;
<> 144:ef7eb2e8f9f7 163 break;
<> 144:ef7eb2e8f9f7 164 case A1:
<> 144:ef7eb2e8f9f7 165 adc_pin = 1;
<> 144:ef7eb2e8f9f7 166 break;
<> 144:ef7eb2e8f9f7 167 case A2:
<> 144:ef7eb2e8f9f7 168 adc_pin = 2;
<> 144:ef7eb2e8f9f7 169 break;
<> 144:ef7eb2e8f9f7 170 case A3:
<> 144:ef7eb2e8f9f7 171 adc_pin = 3;
<> 144:ef7eb2e8f9f7 172 break;
<> 144:ef7eb2e8f9f7 173 default:
<> 144:ef7eb2e8f9f7 174 break;
<> 144:ef7eb2e8f9f7 175 }
<> 144:ef7eb2e8f9f7 176
<> 144:ef7eb2e8f9f7 177 /* Re initialize the pin configured for ADC read */
<> 144:ef7eb2e8f9f7 178 obj->adcReg->CONTROL.BITS.CONV_CH = adc_pin;
<> 144:ef7eb2e8f9f7 179 }
<> 144:ef7eb2e8f9f7 180
<> 144:ef7eb2e8f9f7 181 obj->adcReg->CONTROL.BITS.START_CONV=1; /* Start The Conversion */
<> 144:ef7eb2e8f9f7 182
<> 144:ef7eb2e8f9f7 183 while((uint32_t)(obj->adcReg->STATUS)!=(uint32_t)1) {
<> 144:ef7eb2e8f9f7 184 }
<> 144:ef7eb2e8f9f7 185 adcData =(uint16_t)(obj->adcReg->DATA);
<> 144:ef7eb2e8f9f7 186 CLOCK_DISABLE(CLOCK_ADC);
<> 144:ef7eb2e8f9f7 187
<> 144:ef7eb2e8f9f7 188 return(adcData);
<> 144:ef7eb2e8f9f7 189 }
<> 144:ef7eb2e8f9f7 190
<> 144:ef7eb2e8f9f7 191 #endif // DEVICE_ANALOGIN
<> 144:ef7eb2e8f9f7 192