PWM no ESP32 com ledcAttach e ledcWrite
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
Um ESP32 não tem pinos de PWM fixos. Seu PWM vem de um bloco chamado LEDC, e qualquer pino com driver de saída pode ser uma de suas saídas. Desde a versão 3.0 do core do Arduino para ESP32, duas chamadas fazem tudo: ledcAttach(pin, frequency, bits) configura o pino, e ledcWrite(pin, duty) define por quanto tempo ele fica em nível alto em cada período. analogWrite() também funciona, em cima do mesmo hardware.
O circuito acima é um ESP32 DevKit com um potenciômetro no GPIO 32 e um LED no GPIO 4. O sketch lê o potenciômetro e chama analogWrite(4, duty), então girar o botão diminui o brilho do LED, e o monitor serial mostra a leitura e o duty escolhido. Abaixo está o que as chamadas LEDC fazem, medidas na mesma placa, e o que mudou em relação ao core 2.x que a maioria dos tutoriais ainda usa.
ledcAttach e ledcWrite
O sketch abaixo anexa o GPIO 4 a 5000 Hz com 8 bits de resolução, então o duty vai de 0 a 255, e escreve 64, um quarto. Um jumper do GPIO 4 ao GPIO 15 deixa a própria placa medir sua saída com pulseIn(). Ele imprimiu "high 50 us, low 150 us": um período de 200 microssegundos, ou seja, 5000 Hz, em nível alto por um quarto dele.
ledcAttach() retorna true quando encontrou um canal e um timer para o pino, e false quando não encontrou, então confira o resultado. Aqui ele falhou no GPIO 34, um dos pinos só de entrada, que não têm driver de saída nenhum. O pino é o nome usado em tudo depois: ledcWrite(4, 128) para metade, ledcRead(4) para o duty, ledcReadFreq(4) para a frequência, e ledcDetach(4) para devolver o canal.
const int kLed = 4;
const int kProbe = 15; // a jumper from GPIO 4
void setup() {
Serial.begin(115200);
pinMode(kProbe, INPUT);
if (!ledcAttach(kLed, 5000, 8)) {
Serial.println("ledcAttach failed");
}
ledcWrite(kLed, 64); // 64 of 256: a quarter
delay(5);
Serial.print("high ");
Serial.print(pulseIn(kProbe, HIGH));
Serial.print(" us, low ");
Serial.print(pulseIn(kProbe, LOW));
Serial.println(" us");
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
analogWrite versus ledcWrite
Em um ESP32, analogWrite(pin, value) anexa o pino a um canal na primeira vez que você chama, com 8 bits e 1000 Hz, e depois escreve o valor. Com analogWrite(4, 64) a mesma medição imprimiu "high 250 us, low 750 us": um período de 1 kHz, um quarto em nível alto. É a chamada certa para um LED e para código que também deve compilar para um Uno.
Quando a frequência importa, defina-a por pino antes da escrita. analogWriteFrequency(4, 5000) e analogWriteResolution(4, 10), depois analogWrite(4, 256), imprimiu "high 50 us, low 150 us" de novo, porque 256 de 1024 é um quarto. Um driver de motor, uma ventoinha ou um buzzer geralmente precisa de sua própria frequência, e um servo quer 50 Hz, e é por isso que a maioria dos tutoriais de ESP32 usa as chamadas LEDC diretamente.
Frequência versus resolução
O timer do LEDC conta pulsos de um clock, e um período tem 2 elevado à resolução contagens. No ESP32 clássico o clock mais rápido é o clock APB de 80 MHz, então a frequência vezes 2 elevado aos bits precisa ficar abaixo de 80 milhões (guia de LEDC da Espressif). Isso permite 13 bits a 5 kHz, 11 bits a 20 kHz e 10 bits a 40 kHz. Se você pedir mais que isso, um ESP32 de verdade recusa o attach.
O Mokxi ainda não confere esse limite: ele aceita qualquer frequência com até 14 bits, então um par que funciona aqui ainda pode falhar na placa. Escolha o par pela conta acima. Para um LED, 5 kHz a 8 bits é de sobra. Para um motor que não deve chiar, 20 kHz a 10 bits ou menos.
ledcChangeFrequency(pin, frequency, bits) reajusta um pino que já está anexado, e ledcWriteTone(pin, 440) toca uma onda quadrada com meio duty, que é como um buzzer passivo toca uma nota. Aqui ele retornou 440, e a metade alta de cada período mediu 1130 microssegundos, metade de um período de 440 Hz.
Quantos canais de PWM um ESP32 tem?
Um canal dirige um pino, e canais na mesma frequência e resolução compartilham um timer. A tabela da Espressif dá ao ESP32 clássico 16 canais em dois grupos, ao S3 oito e ao C3 seis, e cada grupo tem quatro timers. O core 3.x distribui sozinho; ledcAttachChannel(pin, frequency, bits, channel) escolhe um quando você precisa.
O ESP32 clássico do Mokxi modela o grupo de alta velocidade: oito canais e quatro timers. Anexando pino após pino a 5000 Hz, o nono ledcAttach() retornou 0 aqui. Anexando cada pino numa frequência diferente, o quinto retornou 0, porque cada frequência precisa de um timer próprio. Um ESP32 de verdade tem também o segundo grupo, então o mesmo sketch vai duas vezes mais longe, e a lição é a mesma: luzes que fazem fade juntas devem compartilhar uma frequência.
"ledcSetup was not declared in this scope"
Esse é o erro que quase todo mundo encontra depois de atualizar o pacote de placas do ESP32. O core 3.0 removeu ledcSetup() e ledcAttachPin() e os fundiu em ledcAttach(), e toda chamada de LEDC agora recebe o pino em vez do número do canal (guia de migração de 2.x para 3.0 da Espressif). Um sketch escrito para 2.x para na IDE do Arduino com 'ledcSetup' was not declared in this scope. ledcDetachPin() virou ledcDetach().
O Mokxi aceita as duas grafias, então um tutorial antigo roda aqui sem mudanças: ledcSetup(0, 5000, 8) retornou 5000, e depois de ledcAttachPin(4, 0) e ledcWrite(0, 64) o pino mediu "high 50 us" como antes. Isso é uma conveniência, não o que a IDE do Arduino faz, então porte o sketch antes de levar para uma placa. A mudança é de três linhas para duas: tire o canal, anexe pelo pino, escreva pelo pino.
// Core 2.x: by channel
ledcSetup(0, 5000, 8);
ledcAttachPin(4, 0);
ledcWrite(0, 64);
// Core 3.x: by pin
ledcAttach(4, 5000, 8);
ledcWrite(4, 64);Abra este circuito no editor. ESP32 DevKit: um potenciômetro controlando o brilho de um LED no GPIO 4, ligado como no circuito que roda no topo desta página. Mude um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Quais pinos do ESP32 podem fazer PWM?
Qualquer pino com driver de saída: o LEDC chega aos pinos pela matriz de GPIO. Não GPIO 34 a 39, que são só entrada, e melhor evitar GPIO 6 a 11, que são a flash.
Como conserto "ledcSetup was not declared in this scope"?
Você tem o core 3.x e um sketch para 2.x. Troque ledcSetup(canal, freq, bits) e ledcAttachPin(pino, canal) por ledcAttach(pino, freq, bits), e passe o pino ao ledcWrite em vez do canal.
Devo usar analogWrite ou ledcWrite num ESP32?
analogWrite para um LED no padrão de 1 kHz e 8 bits, ou para código compartilhado com um Uno. ledcAttach e ledcWrite quando a frequência ou a resolução importa, como num servo, num driver de motor ou num buzzer.
Por que meu ledcWrite no ESP32 não funciona?
Geralmente é um sketch de 2.x no core 3.x: ledcWrite(0, duty) agora significa pino 0, não canal 0. Fora isso, o ledcAttach falhou (confira o retorno), o pino é só entrada, ou a frequência e a resolução não cabem no clock de 80 MHz.
Que frequência de PWM devo usar num ESP32?
5 kHz de 8 a 13 bits para LEDs, 20 kHz com até 11 bits para motores que você não deve ouvir, 50 Hz para um servo, e a própria nota para um buzzer, com ledcWriteTone.
Continuar
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.