Instalación de Librerías FastLED y Adafruit NeoPixel en Arduino IDE.

Para controlar la placa LED RGB WS2812, es necesario instalar las librerías FastLED y Adafruit NeoPixel en el IDE de Arduino, en esta guía vamos a enseñarte cómo instalar estas librerías en el IDE de Arduino para su posterior uso con diversas placas.

Después os detallamos los pasos de instalación y configuración para seis placas, válido tanto para originales como compatibles: Arduino Nano V3.0, Arduino Uno R3, Arduino Mega 2560, ESP32 UNO D1, Digispark ATTiny85, y LGT8F328P.

Por último os dejaremos un pequeño código para probar el correcto funcionamiento tanto en FastLED como en Adafruit NeoPixel.

Una vez tengáis las librerías instaladas y vuestra placa configurada, no olvidéis darle un vistazo a esta guía sobre cómo usar la placa LED RGB WS2812, donde os explicamos como utilizar vuestras placas LED WS2812 tanto con FastLED como con Adafruit NeoPixel, con ejemplos, códigos y todo lo necesario para comenzar a crear vuestros proyectos.

¿Cómo instalar las librerías FastLED y Adafruit NeoPixel en Arduino IDE?

Paso 1: Instalación del IDE de Arduino

Si aún no tienes el IDE de Arduino, descárgalo desde https://www.arduino.cc/en/software y asegúrate de seleccionar la versión compatible con tu sistema operativo.

Una vez descargado, procede con su instalación, no es necesario ningún tipo de configuración todavía.

Paso 2: Instalación de la Librería FastLED

1. Abre el IDE de Arduino.
2. Selecciona Herramientas > Administrar bibliotecas….
3. En el cuadro de búsqueda, escribe «FastLED«.
4. Cuando aparezca en los resultados, selecciona FastLED de Daniel Garcia y haz clic en Instalar.
5. La librería estará lista para usarse una vez completada la instalación.

Paso 3: Instalación de la Librería Adafruit NeoPixel

1. En el IDE de Arduino, ve a Herramientas > Administrar bibliotecas….
2. Escribe «Adafruit NeoPixel» en el cuadro de búsqueda.
3. Selecciona Adafruit NeoPixel y haz clic en Instalar.
4. La librería quedará lista para su uso una vez finalizada la instalación.

Una vez tenemos nuestro IDE Arduino con las librerías correctamente instaladas, podemos configurar la placa que vayamos a usar. Sigue los procesos detallados a continuación para poder configurar correctamente la placa que vas a utilizar.

Al final tendrás el último paso, un pequeño código de ejemplo para que puedas probar el correcto funcionamiento.

¿Cómo configurar correctamente nuestra placa de desarrollo?

Configuración para Digispark ATTiny85

El Digispark ATTiny85 es una placa muy pequeña y económica basada en el microcontrolador ATTiny85, con recursos limitados. Solo la librería FastLED es compatible con esta placa para controlar los LEDs WS2812.

1. Añadir soporte para ATTiny85 en el IDE de Arduino:
   • Ve a Archivo > Preferencias.
   • En URL de gestor de tarjetas adicionales, añade http://digistump.com/package_digistump_index.json
   • Luego, ve a Herramientas > Placa > Gestor de tarjetas…, busca Digistump AVR Boards y haz clic en Instalar.
2. Conecta el Digispark ATTiny85 mediante USB.
3. Selecciona Herramientas > Placa > Digispark (Default – 16.5mhz).
4. Carga un código de prueba (solo con FastLED, ya que Adafruit NeoPixel no es compatible debido a las limitaciones de memoria).

Nota: El ATTiny85 tiene recursos de memoria limitados, por lo que es ideal para controlar un número reducido de LEDs WS2812, de preferencia menos de 10.

Configuración para LGT8F328P

La placa LGT8F328P es un microcontrolador compatible con Arduino Uno, con algunas mejoras en rendimiento y funciones avanzadas. Puedes usar tanto FastLED como Adafruit NeoPixel.

1. Agregar soporte para LGT8F328P:
   • En Archivo > Preferencias, en URL de gestor de tarjetas adicionales, añade https://raw.githubusercontent.com/LGTMCU/LGT8fx/master/package_LGT8fx_index.json
   • Ve a Herramientas > Placa > Gestor de tarjetas…, busca LGT8fx y selecciona Instalar.
2. Selecciona Herramientas > Placa > LGT8F328P.
3. Escoge el puerto USB en Herramientas > Puerto.
4. Puedes cargar un código de prueba tanto con FastLED como con Adafruit NeoPixel.

Configuración para Arduino Nano V3.0

Para asegurarte de que el IDE está configurado correctamente para la placa Arduino Nano V3.0 y compatibles, sigue estos pasos:

1. Conecta tu Arduino Nano V3.0 a la computadora mediante un cable USB.
2. En el IDE de Arduino, ve a Herramientas > Placa y selecciona Arduino Nano.
3. Luego, en Herramientas > Procesador, selecciona ATmega328P (Old Bootloader) si tienes un Nano de versiones anteriores, o ATmega328P si es un modelo más reciente.
4. En Herramientas > Puerto, selecciona el puerto COM correspondiente a tu Arduino Nano (por ejemplo, «COM3», «COM4» o similar, dependiendo del sistema operativo).
5. A continuación, puedes cargar un código básico de prueba en tu Arduino Nano para verificar que las librerías y la placa están configuradas correctamente.
6. Nota: Esta guía también es válida para otras placas compatibles con el Arduino Nano V3.0. Asegúrate de seleccionar el puerto y procesador correctos en el IDE, especialmente si utilizas un Nano de versión antigua.

Configuración para Arduino Uno R3

El Arduino Uno R3 es ideal para controlar tiras de LEDs WS2812 en proyectos pequeños a medianos. Sin embargo, si planeas controlar una gran cantidad de LEDs, puede ser recomendable considerar una fuente de alimentación externa para los LEDs o un microcontrolador con más capacidad de procesamiento, como un ESP32 o Arduino Mega 2560.

Puedes usar tanto FastLED como Adafruit NeoPixel.

Para asegurarte de que el IDE está configurado correctamente para la placa Arduino Uno R3 y compatibles, sigue estos pasos:

1. Conecta tu Arduino Uno R3 a la computadora mediante un cable USB.
2. En el IDE de Arduino, ve a Herramientas > Placa y selecciona Arduino Uno.
3. En Herramientas > Puerto, selecciona el puerto COM correspondiente a tu Arduino Uno (por ejemplo, «COM3», «COM4» o similar, dependiendo de tu sistema operativo).
4. El Arduino Uno R3 es ideal para controlar tiras de LEDs WS2812 en proyectos pequeños a medianos. Sin embargo, si planeas controlar una gran cantidad de LEDs, puede ser recomendable considerar una fuente de alimentación externa para los LEDs o un microcontrolador con más capacidad de procesamiento, como un ESP32 o Arduino Mega 2560.

Configuración para Arduino Mega 2560

El Arduino Mega 2560 es ideal para proyectos de iluminación con muchos LEDs debido a su mayor cantidad de pines y capacidad de procesamiento. Aquí se explica cómo comprobar que las librerías FastLED y Adafruit NeoPixel instaladas previamente estén configuradas correctamente en esta placa para controlar tiras y matrices de LEDs WS2812 y WS2812B (NeoPixels).

Para asegurarte de que el IDE está configurado correctamente para la placa Arduino Mega 2560, sigue estos pasos:

1. Conecta el Arduino Mega 2560 a la computadora mediante un cable USB.
2. En el IDE de Arduino, ve a Herramientas > Placa y selecciona Arduino Mega or Mega 2560.
3. En Herramientas > Procesador, asegúrate de que esté seleccionado ATmega2560.
4. En Herramientas > Puerto, selecciona el puerto COM correspondiente a tu Mega 2560 (por ejemplo, «COM3», «COM4», o similar, según el sistema operativo).

Configuración para ESP32 UNO D1

La placa ESP32 UNO D1 es una variante del ESP32 en un formato compatible con Arduino UNO. Con su capacidad de procesamiento y conectividad WiFi y Bluetooth, es ideal para proyectos avanzados de iluminación con LEDs WS2812 y WS2812B (NeoPixels).

El primer paso es asegurarse de que el IDE de Arduino esté configurado para programar placas ESP32.

1. Abre el IDE de Arduino.
2. Ve a Archivo > Preferencias.
3. En el campo de URL de gestor de tarjetas adicionales, añade la siguiente URL para ESP32:  https://dl.espressif.com/dl/package_esp32_index.json
4. Haz clic en OK para guardar los cambios.
5. Ahora, en el menú del IDE, ve a Herramientas > Placa > Gestor de tarjetas….
6. En el cuadro de búsqueda, escribe «ESP32» y selecciona ESP32 by Espressif Systems.
7. Haz clic en Instalar para añadir el soporte de ESP32 al IDE de Arduino.

Una vez instalado el soporte para placas ESP32 en el IDE de Arduino, podemos configurar la placa, para asegurarte de que el IDE está configurado correctamente para la placa ESP32 UNO D1, sigue estos pasos:

1. Conecta tu ESP32 UNO D1 a la computadora mediante un cable USB.
2. En el IDE de Arduino, ve a Herramientas > Placa y selecciona ESP32 Dev Module (la ESP32 UNO D1 usa esta configuración).
3. En Herramientas > Puerto, selecciona el puerto COM correspondiente a tu ESP32 UNO D1 (por ejemplo, «COM3», «COM4» o similar, dependiendo de tu sistema operativo).

Último paso: Cargar un Código de Prueba con FastLED o Adafruit NeoPixel

Para confirmar que las librerías y la placa WS2812 están funcionando, carga un código de prueba en cualquiera de las placas compatibles. Recuerda que la placa Digispark ATTiny85 sólo es compatible con FastLED.

Código de Prueba usando FastLED

Compatible con: Arduino Nano, Uno R3, Mega 2560, ESP32, Digispark ATTiny85, LGT8F328P y compatibles

#include <FastLED.h>
#define LED_PIN     6           // Pin de datos
#define NUM_LEDS    8           // Número de LEDs en la placa
#define BRIGHTNESS  50

CRGB leds[NUM_LEDS];

void setup() {
  FastLED.addLeds<WS2812, LED_PIN, GRB>(leds, NUM_LEDS).setCorrection(TypicalLEDStrip);
  FastLED.setBrightness(BRIGHTNESS);
}

void loop() {
  for (int i = 0; i < NUM_LEDS; i++) {
    leds[i] = CRGB::Red;      // Rojo en cada LED
    FastLED.show();
    delay(100);
    leds[i] = CRGB::Black;    // Apaga el LED
  }
}

Código de Prueba usando Adafruit NeoPixel

Compatible con: Arduino Nano, Uno R3, Mega 2560, ESP32, LGT8F328P y compatibles (No compatible con Digispark ATTiny85)

#include <Adafruit_NeoPixel.h>

#define LED_PIN     6          // Pin de datos
#define NUMPIXELS   8          // Número de LEDs en la placa
#define BRIGHTNESS  50

Adafruit_NeoPixel strip = Adafruit_NeoPixel(NUMPIXELS, LED_PIN, NEO_GRB + NEO_KHZ800);

void setup() {
  strip.begin();
  strip.setBrightness(BRIGHTNESS);
  strip.show(); // Inicializa todos los LEDs apagados
}

void loop() {
  for (int i = 0; i < NUMPIXELS; i++) {
    strip.setPixelColor(i, strip.Color(255, 0, 0)); // Rojo
    strip.show();
    delay(100);
    strip.setPixelColor(i, strip.Color(0, 0, 0));   // Apaga LED
  }
}

Ambos códigos producen un efecto de barrido en rojo y son adecuados para verificar la correcta configuración y funcionamiento de las librerías y la placa LED WS2812 en los diferentes modelos de microcontroladores.

Ahora que habéis llegado hasta aquí y ya tenéis preparadas vuestras placas, es hora de que déis rienda suelta a vuestra creatividad y comencéis a trabajar en vuestro proyectos. No dejéis de visitar nuestra guía sobre cómo usar la placa LED RGB WS2812, donde os convertireis en auténticos expertos controlando leds, aprendereis desde encender un led, hasta crear animaciones e incluso ampliar vuestras matrices de leds añadiendo y configurando varias placas para hacer cualquier cosa que queráis hacer.