Aprender

Leer un potenciómetro con un ESP32

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32 DevKit: perillaen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Un potenciómetro de 10 k en GPIO 32 (canal 4 del ADC1) ajusta el brillo de un LED en GPIO 4.

analogRead en un ESP32 parece la llamada de Arduino que ya conoces, pero hay tres cosas que a casi todos les sorprenden: los números llegan a 4095 en vez de 1023, la lectura no es una línea recta de 0 V a tu voltaje de alimentación, y la mitad de los pines analógicos dejan de funcionar en cuanto se inicia el WiFi. Esta página recorre las tres con un potenciómetro y un LED.

El circuito de arriba es un ESP32 DevKit clásico con un potenciómetro de 10 k entre 3.3 V y tierra, su cursor en GPIO 32, y un LED en GPIO 4. El sketch lee el potenciómetro cinco veces por segundo, convierte la lectura a un brillo de 0 a 255, lo escribe en el LED e imprime ambos valores. Con la perilla a la mitad, el monitor serie muestra "knob 1892 -> duty 117". Arrastra la perilla y observa cómo se mueven ambos números.

Doce bits, y por qué la mitad no es 2048

El convertidor del ESP32 es de 12 bits, así que las lecturas van de 0 a 4095 frente a los 0 a 1023 de un Uno. Pero la lectura no es una línea recta de 0 V a 3.3 V. La entrada pasa primero por un atenuador, y con la configuración predeterminada, 11 dB, la lectura sin procesar de un ESP32 real se queda en 0 durante los primeros 80 mV más o menos, sube de forma casi lineal por la parte media, se curva hacia arriba cerca del máximo y se satura en 4095 a unos 3.1 V. Gira el potenciómetro hasta el tope y el monitor serie mostrará 4095 durante el último tanto por ciento de su recorrido.

Compruébalo con la lectura de arriba. El cursor a la mitad está en 1.65 V, y una línea recta hasta 3.3 V daría 2048. El simulador imprimió 1892, que es lo que lee ahí un ESP32 típico: Mokxi modela el convertidor con la curva medida en componentes reales, no con la línea recta que sugiere la escala completa nominal de 3.9 V.

El sketch de ejemplo convierte el rango de 0 a 4095 en 0 a 255, así que con el potenciómetro al máximo el ciclo útil llega a 255 y el LED queda con todo su brillo, mientras que la mitad de la perilla da unos 117 en vez de 127. Cuando necesites volts y no cuentas, usa analogReadMilliVolts, que deshace la curva igual que la calibración propia del chip: en el punto medio lee unos 1650.

firmware/esp32/examples/knob (el programa que corre arriba, con comentarios recortados)
const int kKnob = 32;   // ADC1 channel 4
const int kLed = 4;

void setup() {
  Serial.begin(115200);
  pinMode(kLed, OUTPUT);
}

void loop() {
  int raw = analogRead(kKnob);
  int duty = map(raw, 0, 4095, 0, 255);
  analogWrite(kLed, duty);
  Serial.print("knob ");
  Serial.print(raw);
  Serial.print(" -> duty ");
  Serial.println(duty);
  delay(200);
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Configuraciones de atenuación

analogSetAttenuation (o analogSetPinAttenuation para un solo pin) intercambia rango por resolución. A 0 dB la escala completa es de unos 1.1 V, a 2.5 dB unos 1.5 V y a 6 dB unos 2.2 V. A 11 dB la cifra nominal de la hoja de datos es 3.9 V, pero la lectura sin procesar de un componente real se satura a unos 3.1 V. Si tu sensor nunca pasa de un volt, 0 dB te da unas tres veces más pasos a lo largo de su rango.

Espressif solo promete exactitud entre unos 150 mV y 2450 mV a 11 dB, y cada chip varía un poco. Mokxi modela un componente típico a 11 dB, incluyendo la zona muerta en la parte baja y la saturación en la parte alta, y las demás configuraciones como líneas rectas nominales; no modela la calibración propia de un chip en particular. En hardware, mantén la señal dentro de la parte media del rango y promedia varias lecturas, porque la lectura de un ESP32 real salta unas cuantas cuentas incluso con el potenciómetro quieto.

ADC1, ADC2 y WiFi

El ESP32 clásico tiene dos convertidores. El ADC1 está en los GPIO 32 a 39. El ADC2 está en otro conjunto de pines, y en una placa real el controlador de WiFi usa el ADC2 por sí mismo, así que analogRead en un pin del ADC2 falla mientras el WiFi está activo. Por eso este ejemplo usa GPIO 32: sigue funcionando en un proyecto que más adelante agregue una página web. Mokxi no modela el ADC2 en absoluto, así que usa aquí los pines del ADC1 y tu sketch funcionará igual en la placa real.

Los GPIO 34 a 39 son solo de entrada, lo que los hace buenos como entradas analógicas e inútiles como salidas. Y nunca pongas más de 3.3 V en ningún pin del ESP32. La escala completa nominal de 3.9 V del atenuador es un rango de medición, no un voltaje de entrada seguro; la salida de un sensor de 5 V necesita un divisor antes de llegar al pin.

El lado del LED: analogWrite en un ESP32

El ESP32 no tiene temporizadores conectados a pines PWM fijos como un Uno. Aquí analogWrite entrega el pin a LEDC, el controlador PWM para LED del chip, que puede manejar casi cualquier GPIO. El entorno usa 8 bits a 1 kHz, así que los valores de 0 a 255 se comportan igual que en un Uno. Cuando la frecuencia o la resolución importan, por ejemplo para un servomotor o un controlador de motor, ledcAttach(pin, frequency, bits) y ledcWrite las fijan de forma explícita.

El LED en GPIO 4 funciona a 3.3 V, así que el cálculo de la resistencia cambia respecto a un Uno: con unos 2 V sobre un LED rojo, (3.3 - 2) / 150 ohms da aproximadamente 9 mA. La misma resistencia de 220 ohms que usarías con 5 V da unos 6 mA, un poco más tenue y perfectamente seguro.

Abre este circuito en el editor. ESP32 DevKit: perilla, cableado tal como corre en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Preguntas

¿Por qué mi analogRead del ESP32 llega a 4095 antes de que la perilla esté al tope?

Porque con la atenuación predeterminada de 11 dB la lectura sin procesar se satura a unos 3.1 V, antes del riel de 3.3 V, y no es una línea recta en el camino: la mitad de un potenciómetro lee unos 1890, no 2048. Usa analogReadMilliVolts cuando quieras volts.

¿Qué pines del ESP32 puedo usar para analogRead con el WiFi encendido?

Los pines del ADC1, GPIO 32 a 39. Los pines del ADC2 dejan de funcionar para analogRead en un ESP32 real mientras el WiFi está activo.

¿El ADC del ESP32 es exacto?

Suficiente para perillas y sensores de luz, no para medición precisa. Es ruidoso y no lineal cerca de los extremos de cada rango. Para voltajes exactos, usa un ADC externo como un ADS1115 por I2C.

¿El ESP32-C3 se comporta igual?

En su mayoría. El C3 tiene un ADC de 12 bits en los GPIO 0 a 4 y la misma idea de atenuación, pero su rango superior difiere del ESP32 clásico. Consulta la página de la placa para ver los pines y el rango que modela Mokxi.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.