blink_array.c File Reference

Blinks one or more WS2812 devices using a RGB array. More...

#include <Arduino.h>
#include <ws2812.h>

Include dependency graph for blink_array.c:

Go to the source code of this file.

Macros
#define	N_LEDS   8
	Number of LEDs on your WS2812 device(s)
#define	DATA_PINS   {8, 9}
	Arduino pin(s) used to program the WS2812 device(s). Must share same port! (See https://www.arduino.cc/en/Reference/PortManipulation)
#define	RESET_TIME   50
	Reset time in microseconds (50us recommended by datasheet)
#define	COLOR_ORDER   grb
	Color order of your WS2812 LEDs (Typically grb or rgb)

Functions
void	setup ()
void	loop ()

Variables
uint8_t	pins [] = DATA_PINS
	Data pins.
ws2812_rgb	leds [N_LEDS]
	RGB array which represents the LEDs.
ws2812	ws2812_dev
	Device struct.

Detailed Description

Blinks one or more WS2812 devices using a RGB array.

Author

Patrick Pedersen

Date

2021-04-09

The following example showcases how the Tiny-WS2812 library can be used on AVR platforms supporting the Arduino framework to blink an entire WS2812 device in white. In this rather memory expensive example, we achieve this by simply creating a rgb array equal to the number of LEDs on the WS2812 device, whose values we then transmit to the device using the ws2812_tx() function.

For a more memory efficient method, take a look at the blink_loop.c example.

Note

Please ensure that the WS2812_TARGET_PLATFORM_ARDUINO_AVR macro is defined during compilation. This can either be done by specifying -DWS2812_TARGET_PLATFORM_ARDUINO_AVR in the build flags, or by uncommenting the #define WS2812_TARGET_PLATFORM_ARDUINO_AVR directive at the top of this file.

Definition in file blink_array.c.

Function Documentation

loop()

void loop

(

)

Continously blinks the entire WS2812 device in white.

Definition at line 80 of file blink_array.c.

{
        // Program all LEDs to white
        for (unsigned int i = 0; i < N_LEDS; i++) {
                leds[i].r = 255;
                leds[i].g = 255;
                leds[i].b = 255;              
        }
 
        ws2812_prep_tx(&ws2812_dev);           // Prepare to transmit data
        ws2812_tx(&ws2812_dev, leds, N_LEDS);  // Transmit array of rgb values to the device
        ws2812_close_tx(&ws2812_dev);          // Close transmission
 
        // Wait 500ms
        delay(500);
 
        // Program all LEDs to black (off)
        for (unsigned int i = 0; i < N_LEDS; i++) {
                leds[i].r = 0;
                leds[i].g = 0;
                leds[i].b = 0;
        }
 
        ws2812_prep_tx(&ws2812_dev);          // Prepare to transmit data
        ws2812_tx(&ws2812_dev, leds, N_LEDS); // Transmit array of rgb values to the device
        ws2812_close_tx(&ws2812_dev);         // Close transmission
 
        // Wait 500ms
        delay(500);
}

setup()

void setup

(

)

Configures a WS2812 device struct.

Definition at line 61 of file blink_array.c.

{
        ws2812_cfg cfg; // Device config
 
        // Configure the WS2812 device struct
        cfg.pins = pins;
        cfg.rst_time_us = RESET_TIME;
        cfg.order = COLOR_ORDER;
        cfg.n_dev = sizeof(pins); // Number of devices driven by this struct
        
        if (ws2812_config(&ws2812_dev, &cfg) != 0) {
                // HANDLE ERROR HERE
                void;
        }
}