// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #include "esp32-hal-adc.h" #include "driver/adc.h" #include "esp_adc_cal.h" #if SOC_DAC_SUPPORTED //ESP32, ESP32S2 #include "soc/dac_channel.h" #include "soc/sens_reg.h" #include "soc/rtc_io_reg.h" #endif #define DEFAULT_VREF 1100 static uint8_t __analogAttenuation = 3;//11db static uint8_t __analogWidth = ADC_WIDTH_MAX - 1; //3 for ESP32/ESP32C3; 4 for ESP32S2 static uint8_t __analogReturnedWidth = SOC_ADC_MAX_BITWIDTH; //12 for ESP32/ESP32C3; 13 for ESP32S2 static uint8_t __analogClockDiv = 1; static adc_attenuation_t __pin_attenuation[SOC_GPIO_PIN_COUNT]; static uint16_t __analogVRef = 0; #if CONFIG_IDF_TARGET_ESP32 static uint8_t __analogVRefPin = 0; #endif static inline uint16_t mapResolution(uint16_t value) { uint8_t from = __analogWidth + 9; if (from == __analogReturnedWidth) { return value; } if (from > __analogReturnedWidth) { return value >> (from - __analogReturnedWidth); } return value << (__analogReturnedWidth - from); } void __analogSetClockDiv(uint8_t clockDiv){ if(!clockDiv){ clockDiv = 1; } __analogClockDiv = clockDiv; #if CONFIG_IDF_TARGET_ESP32 || CONFIG_IDF_TARGET_ESP32S2 adc_set_clk_div(__analogClockDiv); #endif } void __analogSetAttenuation(adc_attenuation_t attenuation) { __analogAttenuation = attenuation & 3; } #if CONFIG_IDF_TARGET_ESP32 void __analogSetWidth(uint8_t bits){ if(bits < 9){ bits = 9; } else if(bits > 12){ bits = 12; } __analogWidth = bits - 9; adc1_config_width(__analogWidth); } #endif void __analogInit(){ static bool initialized = false; if(initialized){ return; } initialized = true; __analogSetClockDiv(__analogClockDiv); #if CONFIG_IDF_TARGET_ESP32 __analogSetWidth(__analogWidth + 9);//in bits #endif for(int i=0; i 3){ return ; } if(channel > (SOC_ADC_MAX_CHANNEL_NUM - 1)){ adc2_config_channel_atten(channel - SOC_ADC_MAX_CHANNEL_NUM, attenuation); } else { adc1_config_channel_atten(channel, attenuation); } __analogInit(); if((__pin_attenuation[pin] != ADC_ATTENDB_MAX) || (attenuation != __analogAttenuation)){ __pin_attenuation[pin] = attenuation; } } bool __adcAttachPin(uint8_t pin){ int8_t channel = digitalPinToAnalogChannel(pin); if(channel < 0){ log_e("Pin %u is not ADC pin!", pin); return false; } __analogInit(); int8_t pad = digitalPinToTouchChannel(pin); if(pad >= 0){ #if CONFIG_IDF_TARGET_ESP32 uint32_t touch = READ_PERI_REG(SENS_SAR_TOUCH_ENABLE_REG); if(touch & (1 << pad)){ touch &= ~((1 << (pad + SENS_TOUCH_PAD_OUTEN2_S)) | (1 << (pad + SENS_TOUCH_PAD_OUTEN1_S)) | (1 << (pad + SENS_TOUCH_PAD_WORKEN_S))); WRITE_PERI_REG(SENS_SAR_TOUCH_ENABLE_REG, touch); } #endif } #if SOC_DAC_SUPPORTED else if(pin == DAC_CHANNEL_1_GPIO_NUM){ CLEAR_PERI_REG_MASK(RTC_IO_PAD_DAC1_REG, RTC_IO_PDAC1_XPD_DAC | RTC_IO_PDAC1_DAC_XPD_FORCE);//stop dac1 } else if(pin == DAC_CHANNEL_2_GPIO_NUM){ CLEAR_PERI_REG_MASK(RTC_IO_PAD_DAC2_REG, RTC_IO_PDAC2_XPD_DAC | RTC_IO_PDAC2_DAC_XPD_FORCE);//stop dac2 } #endif pinMode(pin, ANALOG); __analogSetPinAttenuation(pin, (__pin_attenuation[pin] != ADC_ATTENDB_MAX)?__pin_attenuation[pin]:__analogAttenuation); return true; } void __analogReadResolution(uint8_t bits) { if(!bits || bits > 16){ return; } __analogReturnedWidth = bits; #if CONFIG_IDF_TARGET_ESP32 __analogSetWidth(bits); // hadware from 9 to 12 #endif } uint16_t __analogRead(uint8_t pin) { int8_t channel = digitalPinToAnalogChannel(pin); int value = 0; esp_err_t r = ESP_OK; if(channel < 0){ log_e("Pin %u is not ADC pin!", pin); return value; } __adcAttachPin(pin); if(channel > (SOC_ADC_MAX_CHANNEL_NUM - 1)){ channel -= SOC_ADC_MAX_CHANNEL_NUM; r = adc2_get_raw( channel, __analogWidth, &value); if ( r == ESP_OK ) { return mapResolution(value); } else if ( r == ESP_ERR_INVALID_STATE ) { log_e("GPIO%u: %s: ADC2 not initialized yet.", pin, esp_err_to_name(r)); } else if ( r == ESP_ERR_TIMEOUT ) { log_e("GPIO%u: %s: ADC2 is in use by Wi-Fi. Please see https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/adc.html#adc-limitations for more info", pin, esp_err_to_name(r)); } else { log_e("GPIO%u: %s", pin, esp_err_to_name(r)); } } else { value = adc1_get_raw(channel); return mapResolution(value); } return mapResolution(value); } uint32_t __analogReadMilliVolts(uint8_t pin){ int8_t channel = digitalPinToAnalogChannel(pin); if(channel < 0){ log_e("Pin %u is not ADC pin!", pin); return 0; } if(!__analogVRef){ if (esp_adc_cal_check_efuse(ESP_ADC_CAL_VAL_EFUSE_TP) == ESP_OK) { log_d("eFuse Two Point: Supported"); __analogVRef = DEFAULT_VREF; } if (esp_adc_cal_check_efuse(ESP_ADC_CAL_VAL_EFUSE_VREF) == ESP_OK) { log_d("eFuse Vref: Supported"); __analogVRef = DEFAULT_VREF; } if(!__analogVRef){ __analogVRef = DEFAULT_VREF; #if CONFIG_IDF_TARGET_ESP32 if(__analogVRefPin){ esp_adc_cal_characteristics_t chars; if(adc_vref_to_gpio(ADC_UNIT_2, __analogVRefPin) == ESP_OK){ __analogVRef = __analogRead(__analogVRefPin); esp_adc_cal_characterize(1, __analogAttenuation, __analogWidth, DEFAULT_VREF, &chars); __analogVRef = esp_adc_cal_raw_to_voltage(__analogVRef, &chars); log_d("Vref to GPIO%u: %u", __analogVRefPin, __analogVRef); } } #endif } } uint8_t unit = 1; if(channel > (SOC_ADC_MAX_CHANNEL_NUM - 1)){ unit = 2; } uint16_t adc_reading = __analogRead(pin); uint8_t atten = __analogAttenuation; if (__pin_attenuation[pin] != ADC_ATTENDB_MAX){ atten = __pin_attenuation[pin]; } esp_adc_cal_characteristics_t chars = {}; esp_adc_cal_value_t val_type = esp_adc_cal_characterize(unit, atten, __analogWidth, __analogVRef, &chars); static bool print_chars_info = true; if(print_chars_info) { if (val_type == ESP_ADC_CAL_VAL_EFUSE_TP) { log_i("ADC%u: Characterized using Two Point Value: %u\n", unit, chars.vref); } else if (val_type == ESP_ADC_CAL_VAL_EFUSE_VREF) { log_i("ADC%u: Characterized using eFuse Vref: %u\n", unit, chars.vref); } #if CONFIG_IDF_TARGET_ESP32 else if(__analogVRef != DEFAULT_VREF){ log_i("ADC%u: Characterized using Vref to GPIO%u: %u\n", unit, __analogVRefPin, chars.vref); } #endif else { log_i("ADC%u: Characterized using Default Vref: %u\n", unit, chars.vref); } print_chars_info = false; } return esp_adc_cal_raw_to_voltage((uint32_t)adc_reading, &chars); } #if CONFIG_IDF_TARGET_ESP32 void __analogSetVRefPin(uint8_t pin){ if(pin <25 || pin > 27){ pin = 0; } __analogVRefPin = pin; } int __hallRead() //hall sensor using idf read { pinMode(36, ANALOG); pinMode(39, ANALOG); __analogSetWidth(12); return hall_sensor_read(); } #endif extern uint16_t analogRead(uint8_t pin) __attribute__ ((weak, alias("__analogRead"))); extern uint32_t analogReadMilliVolts(uint8_t pin) __attribute__ ((weak, alias("__analogReadMilliVolts"))); extern void analogReadResolution(uint8_t bits) __attribute__ ((weak, alias("__analogReadResolution"))); extern void analogSetClockDiv(uint8_t clockDiv) __attribute__ ((weak, alias("__analogSetClockDiv"))); extern void analogSetAttenuation(adc_attenuation_t attenuation) __attribute__ ((weak, alias("__analogSetAttenuation"))); extern void analogSetPinAttenuation(uint8_t pin, adc_attenuation_t attenuation) __attribute__ ((weak, alias("__analogSetPinAttenuation"))); extern bool adcAttachPin(uint8_t pin) __attribute__ ((weak, alias("__adcAttachPin"))); #if CONFIG_IDF_TARGET_ESP32 extern void analogSetVRefPin(uint8_t pin) __attribute__ ((weak, alias("__analogSetVRefPin"))); extern void analogSetWidth(uint8_t bits) __attribute__ ((weak, alias("__analogSetWidth"))); extern int hallRead() __attribute__ ((weak, alias("__hallRead"))); #endif