Différences

Ci-dessous, les différences entre deux révisions de la page.

--- esp_idf [2024/06/23 09:50] – [String] jp
+++ esp_idf [2024/06/26 00:01] (Version actuelle) – [ADC] jp
@@ Ligne 443: / Ligne 443: @@
 Ce qui permet de mettre beaucoup de log mais de n'afficher que ce qui nous interesse sans polluer la liaison série en fonctionnement normal
+===== ADC =====
+La mise en oeuvre de l'ADC de l'ESP32 n'est pas forcement simple. \\
+Il faut savoir que l'ESP32 dispose d'une référence interne de 1.1V mais qui peut varier de 1V à 1.2V ...\\
+C'est pour cette raison, qu'il est necessaire de réaliser une calibration de cette référence lors de l'initialisation de l'ADC.
+Voici les étapes d'initialisation de l'ADC :
+__Etape 1:__ \\
+Configuration de l'ADC1 pour une lecture ponctuelle.
+Cette méthode retourne un handle vers l'ADC1
+<code c>
+    adc_oneshot_unit_init_cfg_t init_config1 = {
+        .unit_id = ADC_UNIT_1,
+    };
+    ESP_ERROR_CHECK(adc_oneshot_new_unit(&init_config1, &adc1_handle));
+</code>
+__Etape 2:__ \\
+Configuration de l'ADC pour retourner une valeur sur 12bits et d’atténuer le signal d'entrée de 12db.
+Ce qui veut dire que l'attenuation sera de 20.log(x) = -12 => x = 0.251.
+La tension appliquée sur l'entrée sera multipliée par 0.251 avant d'entrée sur l'ADC.
+Donc 3.3V donnera 0.828V sur l'entrée de l'ADC dont la pleine échelle est 1.1V.
+On configure également l'entrée GPIO 5 comme entrée de l'ADC.
+<code c>
+    adc_oneshot_chan_cfg_t config = {
+        .bitwidth = ADC_BITWIDTH_DEFAULT,
+        .atten = ADC_ATTEN_DB_12,
+    };
+    ESP_ERROR_CHECK(adc_oneshot_config_channel(adc1_handle, ADC_CHANNEL_5, &config));
+</code>
+__Etape 3:__
+Une fois la configuration terminée, on lance la calibration de l'ADC.
+<code c>
+    adc_cali_curve_fitting_config_t cali_config = {
+    .unit_id = ADC_UNIT_1,
+    .chan = ADC_CHANNEL_5,
+    .atten = ADC_ATTEN_DB_12,
+    .bitwidth = ADC_BITWIDTH_DEFAULT,
+    };
+    esp_err_t ret = adc_cali_create_scheme_curve_fitting(&cali_config, &adc1_cali_chan0_handle);
+</code>
+__Etape 4:__
+Une fois la configuration réalisée, il ne reste plus qu'à lire la valeur mesurée par l'ADC.\\
+La mesure se fait en 2 étapes. La première consiste à récupérer la valeur brute de l'ADC et la 2ème consiste à convertir cette tension par rapport à l'atténuation, la tension de référence et sa calibration.
+<code c>
+ESP_ERROR_CHECK(adc_oneshot_read(adc1_handle, ADC_CHANNEL_5, &adc_raw));
+ESP_LOGI(TAG, "ADC%d Channel[%d] Raw Data: %d", ADC_UNIT_1 + 1, ADC_CHANNEL_5, adc_raw);
+ESP_ERROR_CHECK(adc_cali_raw_to_voltage(adc1_cali_chan0_handle, adc_raw, &voltage));
+ESP_LOGI(TAG, "ADC%d Channel[%d] Cali Voltage: %d mV", ADC_UNIT_1 + 1, ADC_CHANNEL_5, voltage);
+</code>
+Exemple complet:
+<code c>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "soc/soc_caps.h"
+#include "esp_log.h"
+#include "esp_adc/adc_oneshot.h"
+#include "esp_adc/adc_cali.h"
+#include "esp_adc/adc_cali_scheme.h"
+const static char *TAG = "ADC";
+adc_oneshot_unit_handle_t adc1_handle;
+ adc_cali_handle_t adc1_cali_chan0_handle = NULL;
+static int adc_raw;
+static int voltage;
+static void init_adc()
+{
+    //-------------ADC1 Init---------------//
+    adc_oneshot_unit_init_cfg_t init_config1 = {
+        .unit_id = ADC_UNIT_1,
+    };
+    ESP_ERROR_CHECK(adc_oneshot_new_unit(&init_config1, &adc1_handle));
+    //-------------ADC1 Config---------------//
+    adc_oneshot_chan_cfg_t config = {
+        .bitwidth = ADC_BITWIDTH_DEFAULT,
+        .atten = ADC_ATTEN_DB_12,
+    };
+    ESP_ERROR_CHECK(adc_oneshot_config_channel(adc1_handle, ADC_CHANNEL_5, &config));
+    //-------------ADC1 Calibration Init---------------//
+    adc_cali_curve_fitting_config_t cali_config = {
+    .unit_id = ADC_UNIT_1,
+    .chan = ADC_CHANNEL_5,
+    .atten = ADC_ATTEN_DB_12,
+    .bitwidth = ADC_BITWIDTH_DEFAULT,
+    };
+    esp_err_t ret = adc_cali_create_scheme_curve_fitting(&cali_config, &adc1_cali_chan0_handle);
+    if (ret == ESP_OK) {
+        ESP_LOGI(TAG, "Calibration Success");
+    } else if (ret == ESP_ERR_NOT_SUPPORTED) {
+        ESP_LOGW(TAG, "eFuse not burnt, skip software calibration");
+    } else {
+        ESP_LOGE(TAG, "Invalid arg or no memory");
+    }
+}
+void app_main(void)
+{
+    init_adc();
+    while (1) {
+        ESP_ERROR_CHECK(adc_oneshot_read(adc1_handle, ADC_CHANNEL_5, &adc_raw));
+        ESP_LOGI(TAG, "ADC%d Channel[%d] Raw Data: %d", ADC_UNIT_1 + 1, ADC_CHANNEL_5, adc_raw);
+        ESP_ERROR_CHECK(adc_cali_raw_to_voltage(adc1_cali_chan0_handle, adc_raw, &voltage));
+        ESP_LOGI(TAG, "ADC%d Channel[%d] Cali Voltage: %d mV", ADC_UNIT_1 + 1, ADC_CHANNEL_5, voltage);
+        vTaskDelay(1000/ portTICK_PERIOD_MS);
+    }
+}
+</code>
+{{:esp32_c6_adc.png?400|}}