282 lines
9.3 KiB
C
282 lines
9.3 KiB
C
// 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<SOC_GPIO_PIN_COUNT; i++){
|
|
__pin_attenuation[i] = ADC_ATTENDB_MAX;
|
|
}
|
|
}
|
|
|
|
void __analogSetPinAttenuation(uint8_t pin, adc_attenuation_t attenuation)
|
|
{
|
|
int8_t channel = digitalPinToAnalogChannel(pin);
|
|
if(channel < 0 || attenuation > 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
|