Aprender

Suavizando um LED com analogWrite()

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: fadeao vivo0.000 s 0.00x
Clique para abrir no editor
PWM de hardware de verdade no timer 1, fazendo um LED no pino 9 respirar a 490 Hz.

Um pino de saída digital tem exatamente dois estados, ligado ou desligado; ele não pode ficar em 2,5 volts para fazer um LED brilhar com metade do brilho. A modulação por largura de pulso consegue o mesmo efeito de outro jeito: ligue e desligue o pino rápido o suficiente e varie quanto tempo de cada ciclo ele passa ligado, e tudo que estiver depois dele e não consiga reagir tão rápido quanto a comutação (um LED, um motor, o seu próprio olho) só enxerga a média, que se comporta como uma tensão intermediária de verdade.

O circuito acima é o programa fade pronto do Arduino Uno, rodando de verdade, não uma animação gravada fazendo papel dele. analogWrite() no pino 9 coloca o timer 1 do ATmega328P em PWM de 8 bits com correção de fase e prescaler de 64, o que dá 16 MHz dividido por 64 vezes 510, cerca de 490 Hz. Isso não é um palpite arredondado; é o que o hardware do timer realmente produz nesse prescaler e modo, e uma vez configurado o timer mantém o ciclo ativo inteiramente sozinho entre as atualizações.

Baixar o plano de aula (PDF)

Quais pinos suportam analogWrite

Apenas seis pinos do Uno conseguem fazer isso: 3, 5, 6, 9, 10 e 11, marcados com um til na serigrafia da própria placa. São os pinos aos quais está ligada a saída de comparação de um timer de hardware; chame analogWrite() em qualquer outro pino e o core do Arduino não tem nenhum timer por trás para acionar, então nada acontece do jeito que esta página descreve. Três timers separados cobrem os seis pinos entre si (timer 0 para 5 e 6, timer 1 para 9 e 10, timer 2 para 3 e 11), que é também o motivo de usar analogWrite() em um de um par poder mudar a frequência de que delay() e millis() dependem, se o timer errado for reaproveitado, bom saber, raramente motivo de preocupação em um sketch comum.

O código

O sketch abaixo muda uma única coisa, analogWrite(LED_PIN, breath[step]), trinta vezes por segundo, percorrendo uma tabela de brilho com 64 entradas. O timer faz a comutação de verdade entre as atualizações sem nenhuma ajuda extra da CPU, que é a verdadeira vantagem do PWM de hardware em vez de alternar um pino em software: uma vez configurado, a forma de onda nunca falha, mesmo que o sketch fique brevemente ocupado com outra coisa.

firmware/examples/fade (o programa exato que roda acima)
const int LED_PIN = 9;
const int STEPS = 64;
const int MS_PER_STEP = 30;

const uint8_t breath[STEPS] = {
    0,   1,   2,   5,  10,  15,  21,  28,
   37,  46,  56,  66,  77,  89, 101, 113,
  125, 137, 149, 161, 173, 184, 194, 204,
  213, 222, 229, 235, 240, 245, 248, 249,
  250, 249, 248, 245, 240, 235, 229, 222,
  213, 204, 194, 184, 173, 161, 149, 137,
  125, 113, 101,  89,  77,  66,  56,  46,
   37,  28,  21,  15,  10,   5,   2,   1,
};

void loop() {
  for (int step = 0; step < STEPS; step++) {
    analogWrite(LED_PIN, breath[step]);
    delay(MS_PER_STEP);
  }
}

Por que 8 bits

analogWrite() recebe um valor de 0 a 255, oito bits, em todos os pinos que suporta, até nos que ficam no timer 1, que é um timer de 16 bits capaz de um ciclo ativo muito mais fino se configurado à mão. O core do Arduino se limita a 8 bits porque essa é a resolução que a mesma função precisa ter para se comportar de forma idêntica em todos os pinos suportados, incluindo os que estão em timers de 8 bits sem nenhuma opção mais fina disponível; acompanhar a resolução comum mais alta em vez da mais baixa faria a mesma chamada produzir um passo de brilho real diferente dependendo do pino em que fosse chamada.

256 passos também é, na prática, mais fino do que o olho precisa na parte escura de um padrão de respiração como este, e mais grosso do que ele consegue distinguir no meio: que é exatamente o motivo de a tabela acima não ser uma rampa reta.

A curva de brilho

A percepção humana de brilho é mais próxima da logarítmica do que da linear: dobrar a saída de luz real não parece duas vezes mais claro, parece um passo discreto para cima, enquanto a mesma mudança absoluta perto do escuro parece dramática. Um ciclo ativo que sobe em linha reta de 0 a 255, portanto, parece atravessar correndo a metade clara e rastejar pela metade escura. A tabela no sketch acima é um ciclo de (1 − cosseno) dividido por 2, que gasta mais dos seus passos perto do escuro e menos perto do claro, e o resultado se lê como uma respiração suave e uniforme, e não como uma rampa com uma quebra visível.

O que você vê no LED também não é a comutação instantânea. A ponta de prova de LED do Mokxi mostra uma média curta e ponderada pela percepção do próprio brilho, com uma constante de tempo próxima de 8 milissegundos, na mesma faixa em que a resposta do próprio olho demora para se estabilizar; a 490 Hz cada ciclo de PWM dura cerca de 2 milissegundos, confortavelmente mais rápido do que essa média consegue acompanhar, então o brilho relatado segue o ciclo ativo com uma diferença de poucos por cento, em vez de piscar uma vez por ciclo. É a mesma média que uma retina faz, calculada do mesmo jeito, e não um atalho de renderização fazendo papel dela.

PWM além de LEDs

Tudo acima se generaliza para além de um único LED. Um pequeno motor CC acionado por PWM gira a uma velocidade aproximadamente proporcional ao ciclo ativo, pelo mesmo motivo de um LED escurecer proporcionalmente: o motor não consegue reagir rápido o suficiente para ver os pulsos individuais, só a média deles. Um servo de hobby, em contraste, não está sendo efetivamente controlado por PWM de escurecimento no sentido usual; ele lê a largura de cada pulso diretamente, a uma taxa fixa de repetição de aproximadamente 50 Hz, para decidir um ângulo em vez de um brilho, que é um uso diferente da mesma ideia e que vale não confundir com analogWrite() em um LED.

Um alto-falante ou um pequeno buzzer piezo é o terceiro caso comum, e ele fica entre os dois: em vez de ler uma média, ele responde à própria comutação como um tom, na frequência em que o PWM estiver rodando, que é por que a função tone() existe como uma chamada separada de analogWrite(), ainda que no fim ambas apenas liguem e desliguem um pino conforme um agendamento. Os 490 Hz fixos de analogWrite() na maioria dos pinos do Uno dariam um tom reto, sem variação; tone() varia a própria frequência em vez do ciclo ativo, que é a ferramenta certa quando o objetivo é uma nota, e não um brilho ou uma velocidade.

Abra este circuito no editor. Arduino Uno: fade, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Perguntas

Posso conseguir PWM com mais de 8 bits no Uno?

Sim, configurando os registradores de um timer de 16 bits diretamente em vez de chamar analogWrite(), o que troca a consistência entre pinos do core do Arduino pela resolução extra que o timer 1 realmente pode oferecer.

A frequência do PWM importa para a cintilação visível?

Só se ela cair o suficiente para um ciclo durar mais que a janela de média do olho, cerca de 8 a 16 milissegundos. A 490 Hz, cada ciclo dura cerca de 2 milissegundos, bem longe disso, que é por que o PWM de hardware no Uno nunca parece piscar como um estroboscópio.

Por que o fade parece diferente em um ESP32-C3?

Não precisa parecer. A placa traz os dois: o exemplo fade gera a forma de onda em software, e o pwmfade entrega o trabalho ao LEDC, o controlador de PWM do chip, que qualquer GPIO pode carregar, em vez de apenas seis pinos fixos. Comparar os dois na página da placa ESP32-C3 é justamente o motivo de incluir os dois.

Posso usar analogWrite em qualquer pino digital?

Não. Apenas os pinos 3, 5, 6, 9, 10 e 11 do Uno têm a saída de comparação de um timer ligada a eles; chamá-lo em qualquer outro pino não faz nada.

Uma frequência de PWM mais alta significa um LED mais brilhante?

Não. Frequência e ciclo de trabalho são independentes: a frequência só precisa ser rápida o suficiente para que quem estiver observando (um olho, um motor) não consiga acompanhar os pulsos individuais. O brilho vem inteiramente do ciclo de trabalho, a fração de cada ciclo passada ligada.

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.