Aprender

Lendo um potenciômetro com um ESP32

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
ESP32 DevKit: potenciômetroao vivo0.000 s 0.00x
Clique para abrir no editor
Um pot de 10 k no GPIO 32 (canal 4 do ADC1) controla o brilho de um LED no GPIO 4.

O analogRead em um ESP32 parece a chamada de Arduino que você já conhece, mas três coisas pegam quase todo mundo: os números vão até 4095 em vez de 1023, a leitura não é uma linha reta de 0 V até a tensão de alimentação, e metade dos pinos analógicos para de funcionar no momento em que o WiFi liga. Esta página percorre as três com um potenciômetro e um LED.

O circuito acima é um ESP32 DevKit clássico com um potenciômetro de 10 k entre 3,3 V e o terra, o cursor no GPIO 32, e um LED no GPIO 4. O sketch lê o pot cinco vezes por segundo, converte a leitura em um brilho de 0 a 255, escreve no LED e imprime os dois valores. Com o botão no meio, o monitor serial mostra "knob 1892 -> duty 117". Arraste o botão e veja os dois números mudarem.

Doze bits, e por que o meio não é 2048

O conversor do ESP32 é de 12 bits, então as leituras vão de 0 a 4095, contra 0 a 1023 de um Uno. Mas a leitura não é uma linha reta de 0 V a 3,3 V. A entrada passa primeiro por um atenuador, e na configuração padrão, 11 dB, a leitura bruta de um ESP32 de verdade fica em 0 nos primeiros 80 mV ou assim, sobe quase linearmente pelo meio, curva para cima perto do topo e satura em 4095 por volta de 3,1 V. Gire o pot até o fim e o monitor serial mostra 4095 nos últimos pontos percentuais do curso.

Confira com a leitura acima. O cursor no meio está a 1,65 V, e uma linha reta até 3,3 V daria 2048. O simulador imprimiu 1892, que é o que um ESP32 típico lê nesse ponto: o Mokxi modela o conversor com a curva medida em componentes reais, não com a linha reta que a escala nominal de 3,9 V sugere.

O sketch de exemplo mapeia 0 a 4095 em 0 a 255, então com o pot no máximo o duty chega a 255 e o LED fica no brilho total, enquanto o meio do botão dá cerca de 117 em vez de 127. Quando você precisa de volts em vez de contagens, use analogReadMilliVolts, que desfaz a curva do mesmo jeito que a calibração do próprio chip: ele lê cerca de 1650 no meio.

firmware/esp32/examples/knob (o programa rodando acima, comentários cortados)
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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Configurações de atenuação

analogSetAttenuation (ou analogSetPinAttenuation para um pino só) troca alcance por resolução. Com 0 dB a escala total é de cerca de 1,1 V, com 2,5 dB cerca de 1,5 V e com 6 dB cerca de 2,2 V. Com 11 dB o valor nominal do datasheet é 3,9 V, mas a leitura bruta de um componente real satura em torno de 3,1 V. Se o seu sensor nunca passa de um volt, 0 dB dá cerca de três vezes mais degraus na faixa dele.

A Espressif só promete precisão entre cerca de 150 mV e 2450 mV com 11 dB, e cada chip difere um pouco. O Mokxi modela um componente típico com 11 dB, incluindo a zona morta na base e a saturação no topo, e as outras configurações como suas linhas retas nominais; ele não modela a calibração individual de um chip. No hardware, mantenha o sinal no meio da faixa e faça a média de várias leituras, porque a leitura de um ESP32 real pula algumas contagens mesmo com o pot parado.

ADC1, ADC2 e WiFi

O ESP32 clássico tem dois conversores. O ADC1 está nos GPIO 32 a 39. O ADC2 está em outro conjunto de pinos, e numa placa real o driver do WiFi usa o ADC2, então analogRead num pino do ADC2 falha enquanto o WiFi está ativo. É por isso que este exemplo usa o GPIO 32: ele continua funcionando num projeto que depois adiciona uma página web. O Mokxi não modela o ADC2, então use pinos do ADC1 aqui e o seu sketch vai funcionar lá também.

Os GPIO 34 a 39 são só de entrada, o que os torna bons para entrada analógica e inúteis como saída. E nunca coloque mais de 3,3 V em nenhum pino do ESP32. A escala nominal de 3,9 V do atenuador é uma faixa de medição, não uma tensão de entrada segura; a saída de um sensor de 5 V precisa de um divisor antes de chegar ao pino.

O lado do LED: analogWrite no ESP32

O ESP32 não tem timers ligados a pinos PWM fixos como um Uno. Aqui o analogWrite entrega o pino ao LEDC, o controlador de PWM para LED do chip, que pode acionar quase qualquer GPIO. O runtime usa 8 bits a 1 kHz, então os valores de 0 a 255 funcionam igual aos de um Uno. Quando a frequência ou a resolução importa, para um servo ou um driver de motor, ledcAttach(pin, frequency, bits) e ledcWrite definem isso explicitamente.

O LED no GPIO 4 funciona a 3,3 V, então a conta do resistor muda em relação ao Uno: com cerca de 2 V num LED vermelho, (3,3 - 2) / 150 ohms dá aproximadamente 9 mA. O mesmo resistor de 220 ohms que você usaria com 5 V dá cerca de 6 mA, um pouco mais fraco e perfeitamente seguro.

Abra este circuito no editor. ESP32 DevKit: potenciômetro, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Perguntas

Por que meu analogRead no ESP32 chega a 4095 antes de o botão chegar ao fim?

Porque com a atenuação padrão de 11 dB a leitura bruta satura em torno de 3,1 V, antes do trilho de 3,3 V, e não é uma linha reta até lá: o meio de um pot lê cerca de 1890, não 2048. Use analogReadMilliVolts quando quiser volts.

Quais pinos do ESP32 posso usar para analogRead com o WiFi ligado?

Os pinos do ADC1, GPIO 32 a 39. Os pinos do ADC2 param de funcionar para analogRead num ESP32 real enquanto o WiFi está ativo.

O ADC do ESP32 é preciso?

Dá conta de potenciômetros e sensores de luz, não de medição rigorosa. Ele é ruidoso e não linear perto das extremidades de cada faixa. Para tensões precisas, use um ADC externo como um ADS1115 via I2C.

O ESP32-C3 se comporta do mesmo jeito?

Na maior parte, sim. O C3 tem um ADC de 12 bits nos GPIO 0 a 4 e a mesma ideia de atenuação, mas a faixa superior difere do ESP32 clássico. Veja a página da placa para os pinos e a faixa que o Mokxi modela.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.