Lendo um potenciômetro com um ESP32
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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.
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.