blink_loop.c File Reference

Blinks one or more WS2812 devices using a more memory efficient method than the blink_array.c example. More...

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

Include dependency graph for blink_loop.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	ws2812_dev
	Device struct.
ws2812_rgb	white = {255,255,255}
ws2812_rgb	black = {0, 0 ,0}

Detailed Description

Blinks one or more WS2812 devices using a more memory efficient method than the blink_array.c example.

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. Unlike the other blink example, we do not allocate a memory expensive array for every single LED here, but instead loop the transmission of a single RGB value until all WS2812 LEDs have been set.

The advantage of this method is that we can save allot of memory, the disadvantage is that this method is more prone to programming mistakes.

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_loop.c.

Function Documentation

loop()

void loop

(

)

Continously blinks the entire WS2812 device in white.

Definition at line 82 of file blink_loop.c.

{
        // Prepare to transmit data
        ws2812_prep_tx(&ws2812_dev);
 
        // Program all LEDs to white
        for (unsigned int i = 0; i < N_LEDS; i++) {
                ws2812_tx(&ws2812_dev, &white, sizeof(white)/sizeof(ws2812_rgb));
                // THIS LOOP NEEDS TO RUN UNINTERRUPTED!
        }
        
        // Close transmission
        ws2812_close_tx(&ws2812_dev);
 
        // Wait 500ms
        delay(500);
 
        // Prepare to transmit data
        ws2812_prep_tx(&ws2812_dev);
 
        // Program all LEDs to black (off)
        for (unsigned int i = 0; i < N_LEDS; i++) {
                ws2812_tx(&ws2812_dev, &black, sizeof(black)/sizeof(ws2812_rgb));
                // THIS LOOP NEEDS TO RUN UNINTERRUPTED!
        }
        
        // Close transmission
        ws2812_close_tx(&ws2812_dev);
 
        // Wait 500ms
        delay(500);
}

setup()

void setup

(

)

Configures a WS2812 device struct.

Definition at line 63 of file blink_loop.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;
        }
}