mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
186 lines
6.4 KiB
C
186 lines
6.4 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.
|
|
|
|
#ifndef _DRIVER_ADC_H_
|
|
#define _DRIVER_ADC_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
#include "esp_err.h"
|
|
#include "driver/gpio.h"
|
|
#include "soc/adc_channel.h"
|
|
|
|
typedef enum {
|
|
ADC_ATTEN_0db = 0, /*!<The input voltage of ADC will be reduced to about 1/1 */
|
|
ADC_ATTEN_2_5db = 1, /*!<The input voltage of ADC will be reduced to about 1/1.34 */
|
|
ADC_ATTEN_6db = 2, /*!<The input voltage of ADC will be reduced to about 1/2 */
|
|
ADC_ATTEN_11db = 3, /*!<The input voltage of ADC will be reduced to about 1/3.6*/
|
|
} adc_atten_t;
|
|
|
|
typedef enum {
|
|
ADC_WIDTH_9Bit = 0, /*!< ADC capture width is 9Bit*/
|
|
ADC_WIDTH_10Bit = 1, /*!< ADC capture width is 10Bit*/
|
|
ADC_WIDTH_11Bit = 2, /*!< ADC capture width is 11Bit*/
|
|
ADC_WIDTH_12Bit = 3, /*!< ADC capture width is 12Bit*/
|
|
} adc_bits_width_t;
|
|
|
|
typedef enum {
|
|
ADC1_CHANNEL_0 = 0, /*!< ADC1 channel 0 is GPIO36 */
|
|
ADC1_CHANNEL_1, /*!< ADC1 channel 1 is GPIO37 */
|
|
ADC1_CHANNEL_2, /*!< ADC1 channel 2 is GPIO38 */
|
|
ADC1_CHANNEL_3, /*!< ADC1 channel 3 is GPIO39 */
|
|
ADC1_CHANNEL_4, /*!< ADC1 channel 4 is GPIO32 */
|
|
ADC1_CHANNEL_5, /*!< ADC1 channel 5 is GPIO33 */
|
|
ADC1_CHANNEL_6, /*!< ADC1 channel 6 is GPIO34 */
|
|
ADC1_CHANNEL_7, /*!< ADC1 channel 7 is GPIO35 */
|
|
ADC1_CHANNEL_MAX,
|
|
} adc1_channel_t;
|
|
|
|
typedef enum {
|
|
ADC2_CHANNEL_0 = 0, /*!< ADC2 channel 0 is GPIO4 */
|
|
ADC2_CHANNEL_1, /*!< ADC2 channel 1 is GPIO0 */
|
|
ADC2_CHANNEL_2, /*!< ADC2 channel 2 is GPIO2 */
|
|
ADC2_CHANNEL_3, /*!< ADC2 channel 3 is GPIO15 */
|
|
ADC2_CHANNEL_4, /*!< ADC2 channel 4 is GPIO13 */
|
|
ADC2_CHANNEL_5, /*!< ADC2 channel 5 is GPIO12 */
|
|
ADC2_CHANNEL_6, /*!< ADC2 channel 6 is GPIO14 */
|
|
ADC2_CHANNEL_7, /*!< ADC2 channel 7 is GPIO27 */
|
|
ADC2_CHANNEL_8, /*!< ADC2 channel 8 is GPIO25 */
|
|
ADC2_CHANNEL_9, /*!< ADC2 channel 9 is GPIO26 */
|
|
ADC2_CHANNEL_MAX,
|
|
} adc2_channel_t;
|
|
|
|
/**
|
|
* @brief Configure ADC1 capture width.
|
|
*
|
|
* The configuration is for all channels of ADC1
|
|
*
|
|
* @param width_bit Bit capture width for ADC1
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
*/
|
|
esp_err_t adc1_config_width(adc_bits_width_t width_bit);
|
|
|
|
/**
|
|
* @brief Configure the ADC1 channel, including setting attenuation.
|
|
*
|
|
* @note This function also configures the input GPIO pin mux to
|
|
* connect it to the ADC1 channel. It must be called before calling
|
|
* adc1_get_raw() for this channel.
|
|
*
|
|
* The default ADC full-scale voltage is 1.1V. To read higher voltages (up to the pin maximum voltage,
|
|
* usually 3.3V) requires setting >0dB signal attenuation for that ADC channel.
|
|
*
|
|
* When VDD_A is 3.3V:
|
|
*
|
|
* - 0dB attenuaton (ADC_ATTEN_0db) gives full-scale voltage 1.1V
|
|
* - 2.5dB attenuation (ADC_ATTEN_2_5db) gives full-scale voltage 1.5V
|
|
* - 6dB attenuation (ADC_ATTEN_6db) gives full-scale voltage 2.2V
|
|
* - 11dB attenuation (ADC_ATTEN_11db) gives full-scale voltage 3.9V (see note below)
|
|
*
|
|
* @note The full-scale voltage is the voltage corresponding to a maximum reading (depending on ADC1 configured
|
|
* bit width, this value is: 4095 for 12-bits, 2047 for 11-bits, 1023 for 10-bits, 511 for 9 bits.)
|
|
*
|
|
* @note At 11dB attenuation the maximum voltage is limited by VDD_A, not the full scale voltage.
|
|
*
|
|
* @param channel ADC1 channel to configure
|
|
* @param atten Attenuation level
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
*/
|
|
esp_err_t adc1_config_channel_atten(adc1_channel_t channel, adc_atten_t atten);
|
|
|
|
/**
|
|
* @brief Take an ADC1 reading on a single channel
|
|
*
|
|
* @note Call adc1_config_width() before the first time this
|
|
* function is called.
|
|
*
|
|
* @note For a given channel, adc1_config_channel_atten(channel)
|
|
* must be called before the first time this function is called.
|
|
*
|
|
* @param channel ADC1 channel to read
|
|
*
|
|
* @return
|
|
* - -1: Parameter error
|
|
* - Other: ADC1 channel reading.
|
|
*/
|
|
int adc1_get_raw(adc1_channel_t channel);
|
|
|
|
/** @cond */ //Doxygen command to hide deprecated function from API Reference
|
|
/*
|
|
* @deprecated This function returns an ADC1 reading but is deprecated due to
|
|
* a misleading name and has been changed to directly call the new function.
|
|
* Use the new function adc1_get_raw() instead
|
|
*/
|
|
int adc1_get_voltage(adc1_channel_t channel) __attribute__((deprecated));
|
|
/** @endcond */
|
|
|
|
/**
|
|
* @brief Configure ADC1 to be usable by the ULP
|
|
*
|
|
* This function reconfigures ADC1 to be controlled by the ULP.
|
|
* Effect of this function can be reverted using adc1_get_raw function.
|
|
*
|
|
* Note that adc1_config_channel_atten, adc1_config_width functions need
|
|
* to be called to configure ADC1 channels, before ADC1 is used by the ULP.
|
|
*/
|
|
void adc1_ulp_enable();
|
|
|
|
/**
|
|
* @brief Read Hall Sensor
|
|
*
|
|
* @note The Hall Sensor uses channels 0 and 3 of ADC1. Do not configure
|
|
* these channels for use as ADC channels.
|
|
*
|
|
* @note The ADC1 module must be enabled by calling
|
|
* adc1_config_width() before calling hall_sensor_read(). ADC1
|
|
* should be configured for 12 bit readings, as the hall sensor
|
|
* readings are low values and do not cover the full range of the
|
|
* ADC.
|
|
*
|
|
* @return The hall sensor reading.
|
|
*/
|
|
int hall_sensor_read();
|
|
|
|
/**
|
|
* @brief Output ADC2 reference voltage to gpio 25 or 26 or 27
|
|
*
|
|
* This function utilizes the testing mux exclusive to ADC 2 to route the
|
|
* reference voltage one of ADC2's channels. Supported gpios are gpios
|
|
* 25, 26, and 27. This refernce voltage can be manually read from the pin
|
|
* and used in the esp_adc_cal component.
|
|
*
|
|
* @param[in] gpio GPIO number (gpios 25,26,27 supported)
|
|
*
|
|
* @return
|
|
* - ESP_OK: v_ref successfully routed to selected gpio
|
|
* - ESP_ERR_INVALID_ARG: Unsupported gpio
|
|
*/
|
|
esp_err_t adc2_vref_to_gpio(gpio_num_t gpio);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /*_DRIVER_ADC_H_*/
|
|
|