Aprender

Atenuar un LED con analogWrite()

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: fadeen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
PWM real por hardware en el timer 1, haciendo "respirar" un LED en el pin 9 a 490 Hz.

Un pin de salida digital tiene exactamente dos estados, encendido o apagado; no puede quedarse en 2.5 volts para que un LED brille a la mitad de su intensidad. La modulación por ancho de pulso logra el mismo efecto de otra manera: enciende y apaga el pin lo suficientemente rápido, y varía qué proporción de cada ciclo pasa encendido, y todo lo que esté después y no pueda reaccionar tan rápido como el conmutado (un LED, un motor, tu propio ojo) solo ve el promedio, que se comporta como un voltaje intermedio real.

El circuito de arriba es el programa fade integrado del Arduino Uno, ejecutándose de verdad, no una animación grabada en su lugar. analogWrite() en el pin 9 pone el temporizador 1 del ATmega328P en PWM de corrección de fase de 8 bits con un preescalador de 64, lo que da 16 MHz dividido entre 64 por 510, unos 490 Hz. No es una aproximación redondeada; es lo que el hardware del temporizador produce realmente con ese preescalador y modo, y una vez configurado, el temporizador mantiene el ciclo útil por sí solo entre actualizaciones.

Descargar el plan de clase (PDF)

Qué pines admiten analogWrite

Solo seis pines del Uno pueden hacerlo: 3, 5, 6, 9, 10 y 11, marcados con una tilde en la serigrafía de la propia placa. Son los pines que tienen conectada la salida de comparación de un temporizador de hardware; llama a analogWrite() en cualquier otro pin y el núcleo de Arduino no tiene un temporizador detrás al que pedírselo, así que no pasa nada de lo que esta página describe. Tres temporizadores distintos cubren los seis pines entre ellos (temporizador 0 para 5 y 6, temporizador 1 para 9 y 10, temporizador 2 para 3 y 11), que también es la razón por la que usar analogWrite() en uno de un par puede alterar la frecuencia de la que dependen delay() y millis() si se reutiliza el temporizador equivocado; conviene saberlo, aunque rara vez valga la pena preocuparse en un sketch común.

El código

El sketch de abajo solo cambia una cosa, analogWrite(LED_PIN, breath[step]), treinta veces por segundo, recorriendo una tabla de brillo de 64 entradas. El temporizador hace el conmutado real entre actualizaciones sin más ayuda de la CPU, que es la verdadera ventaja del PWM de hardware sobre alternar un pin por software: una vez configurado, la forma de onda nunca falla aunque el sketch esté un momento ocupado en otra cosa.

firmware/examples/fade (el programa exacto que corre arriba)
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 qué 8 bits

analogWrite() recibe un valor de 0 a 255, ocho bits, en todos los pines que admite, incluso los del temporizador 1, que es un temporizador de 16 bits capaz de un ciclo útil mucho más fino si se configura a mano. El núcleo de Arduino se queda con 8 bits porque esa es la resolución que la misma función necesita para comportarse idénticamente en cada pin admitido, incluidos los de temporizadores de 8 bits que no tienen un ajuste más fino disponible; igualar la resolución común más amplia en lugar de la más estrecha significaría que la misma llamada produjera un paso de brillo real distinto según el pin en que se llamara.

En la práctica, 256 pasos también son más finos de lo que el ojo necesita en la parte baja de un patrón de respiración como este, y más gruesos de lo que puede distinguir en medio: exactamente por eso la tabla de arriba no es una rampa recta.

La curva de brillo

La percepción humana del brillo es más cercana a logarítmica que a lineal: duplicar la salida de luz real no se ve el doble de brillante, se ve como un paso modesto hacia arriba, mientras que el mismo cambio absoluto cerca del extremo oscuro se ve dramático. Un ciclo útil que sube en línea recta de 0 a 255 por lo tanto parece que se apresura por la mitad brillante y se arrastra por la mitad oscura. La tabla del sketch de arriba es un ciclo de (1 − coseno) dividido entre 2, que pasa más de sus pasos cerca del extremo oscuro y menos cerca del brillante, y el resultado se percibe como una respiración suave y uniforme y no como una rampa con un quiebre evidente.

Lo que ves en el LED tampoco es el conmutado instantáneo. La sonda de LED de Mokxi reporta un promedio corto y ponderado de forma perceptual de su propio brillo, con una constante de tiempo cercana a 8 milisegundos, en el mismo rango en que se estabiliza la respuesta del ojo; a 490 Hz cada ciclo PWM dura unos 2 milisegundos, cómodamente más rápido de lo que ese promedio puede seguir, así que el brillo reportado sigue el ciclo útil dentro de un par de por ciento en vez de parpadear una vez por ciclo. Es el mismo promedio que hace una retina, calculado de la misma forma, no un atajo de renderizado en su lugar.

PWM más allá de los LED

Todo lo anterior se generaliza más allá de un solo LED. Un motor de corriente directa pequeño alimentado con PWM gira a una velocidad aproximadamente proporcional al ciclo útil, por la misma razón por la que un LED se atenúa proporcionalmente: el motor no puede reaccionar lo bastante rápido para ver pulsos individuales, solo su promedio. Un servomotor de hobby, en cambio, en realidad no se atenúa por PWM en el sentido habitual; lee el ancho de cada pulso directamente, a una tasa de repetición fija de unos 50 Hz, para decidir un ángulo y no un brillo, que es un uso distinto de la misma idea y conviene no confundirlo con analogWrite() en un LED.

Un altavoz o un zumbador piezoeléctrico pequeño es el tercer caso común, y está entre los dos: en lugar de leer un promedio, responde al propio conmutado como un tono, a la frecuencia a la que corra el PWM, y por eso existe la función tone() como una llamada aparte de analogWrite() aunque ambas al final solo encienden y apagan un pin según un horario. Los 490 Hz fijos de analogWrite() en la mayoría de los pines del Uno darían un tono plano y sin cambios; tone() varía la frecuencia misma y no el ciclo útil, que es la herramienta correcta cuando el objetivo es una nota y no un brillo o una velocidad.

Abre este circuito en el editor. Arduino Uno: fade, cableado tal como corre al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Preguntas

¿Puedo conseguir PWM más fino que 8 bits en el Uno?

Sí, configurando directamente los registros de un temporizador de 16 bits en lugar de llamar a analogWrite(), lo que cambia la consistencia entre pines del núcleo de Arduino por la resolución extra que el temporizador 1 puede proporcionar de verdad.

¿Importa la frecuencia del PWM para el parpadeo visible?

Solo si baja lo suficiente para que un ciclo dure más que la ventana de promedio del ojo, de unos 8 a 16 milisegundos. A 490 Hz, cada ciclo dura unos 2 milisegundos, bien lejos de eso, y por eso el PWM de hardware en el Uno nunca parece estroboscópico.

¿Por qué el fade se ve distinto en un ESP32-C3?

No tiene por qué. La placa incluye ambos: el ejemplo fade genera la forma de onda por software, y pwmfade la entrega a LEDC, el controlador PWM del chip, que cualquier GPIO puede llevar y no solo seis pines fijos. Comparar ambos en la página de la placa ESP32-C3 es el motivo de incluir los dos.

¿Puedo usar analogWrite en cualquier pin digital?

No. Solo los pines 3, 5, 6, 9, 10 y 11 del Uno tienen conectada la salida de comparación de un temporizador; llamarla en cualquier otro pin no hace nada.

¿Una frecuencia PWM más alta significa un LED más brillante?

No. La frecuencia y el ciclo útil son independientes: la frecuencia solo tiene que ser lo suficientemente rápida para que quien esté mirando (un ojo, un motor) no pueda seguir los pulsos individuales. El brillo depende por completo del ciclo útil, la fracción de cada ciclo que está encendido.

Á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.