/*-------------------------------------------------------------------- This file is part of the Adafruit NeoPixel library. NeoPixel is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. NeoPixel is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with NeoPixel. If not, see . --------------------------------------------------------------------*/ #ifndef ADAFRUIT_CPLAY_NEOPIXEL_H #define ADAFRUIT_CPLAY_NEOPIXEL_H #if (ARDUINO >= 100) #include #else #include #include #endif // The order of primary colors in the NeoPixel data stream can vary // among device types, manufacturers and even different revisions of // the same item. The third parameter to the Adafruit_NeoPixel // constructor encodes the per-pixel byte offsets of the red, green // and blue primaries (plus white, if present) in the data stream -- // the following #defines provide an easier-to-use named version for // each permutation. e.g. NEO_GRB indicates a NeoPixel-compatible // device expecting three bytes per pixel, with the first byte // containing the green value, second containing red and third // containing blue. The in-memory representation of a chain of // NeoPixels is the same as the data-stream order; no re-ordering of // bytes is required when issuing data to the chain. // Bits 5,4 of this value are the offset (0-3) from the first byte of // a pixel to the location of the red color byte. Bits 3,2 are the // green offset and 1,0 are the blue offset. If it is an RGBW-type // device (supporting a white primary in addition to R,G,B), bits 7,6 // are the offset to the white byte...otherwise, bits 7,6 are set to // the same value as 5,4 (red) to indicate an RGB (not RGBW) device. // i.e. binary representation: // 0bWWRRGGBB for RGBW devices // 0bRRRRGGBB for RGB // RGB NeoPixel permutations; white and red offsets are always same // Offset: W R G B #define NEO_RGB ((0 << 6) | (0 << 4) | (1 << 2) | (2)) #define NEO_RBG ((0 << 6) | (0 << 4) | (2 << 2) | (1)) #define NEO_GRB ((1 << 6) | (1 << 4) | (0 << 2) | (2)) #define NEO_GBR ((2 << 6) | (2 << 4) | (0 << 2) | (1)) #define NEO_BRG ((1 << 6) | (1 << 4) | (2 << 2) | (0)) #define NEO_BGR ((2 << 6) | (2 << 4) | (1 << 2) | (0)) // RGBW NeoPixel permutations; all 4 offsets are distinct // Offset: W R G B #define NEO_WRGB ((0 << 6) | (1 << 4) | (2 << 2) | (3)) #define NEO_WRBG ((0 << 6) | (1 << 4) | (3 << 2) | (2)) #define NEO_WGRB ((0 << 6) | (2 << 4) | (1 << 2) | (3)) #define NEO_WGBR ((0 << 6) | (3 << 4) | (1 << 2) | (2)) #define NEO_WBRG ((0 << 6) | (2 << 4) | (3 << 2) | (1)) #define NEO_WBGR ((0 << 6) | (3 << 4) | (2 << 2) | (1)) #define NEO_RWGB ((1 << 6) | (0 << 4) | (2 << 2) | (3)) #define NEO_RWBG ((1 << 6) | (0 << 4) | (3 << 2) | (2)) #define NEO_RGWB ((2 << 6) | (0 << 4) | (1 << 2) | (3)) #define NEO_RGBW ((3 << 6) | (0 << 4) | (1 << 2) | (2)) #define NEO_RBWG ((2 << 6) | (0 << 4) | (3 << 2) | (1)) #define NEO_RBGW ((3 << 6) | (0 << 4) | (2 << 2) | (1)) #define NEO_GWRB ((1 << 6) | (2 << 4) | (0 << 2) | (3)) #define NEO_GWBR ((1 << 6) | (3 << 4) | (0 << 2) | (2)) #define NEO_GRWB ((2 << 6) | (1 << 4) | (0 << 2) | (3)) #define NEO_GRBW ((3 << 6) | (1 << 4) | (0 << 2) | (2)) #define NEO_GBWR ((2 << 6) | (3 << 4) | (0 << 2) | (1)) #define NEO_GBRW ((3 << 6) | (2 << 4) | (0 << 2) | (1)) #define NEO_BWRG ((1 << 6) | (2 << 4) | (3 << 2) | (0)) #define NEO_BWGR ((1 << 6) | (3 << 4) | (2 << 2) | (0)) #define NEO_BRWG ((2 << 6) | (1 << 4) | (3 << 2) | (0)) #define NEO_BRGW ((3 << 6) | (1 << 4) | (2 << 2) | (0)) #define NEO_BGWR ((2 << 6) | (3 << 4) | (1 << 2) | (0)) #define NEO_BGRW ((3 << 6) | (2 << 4) | (1 << 2) | (0)) // Add NEO_KHZ400 to the color order value to indicate a 400 KHz // device. All but the earliest v1 NeoPixels expect an 800 KHz data // stream, this is the default if unspecified. #define NEO_KHZ800 0x0000 // 800 KHz datastream #define NEO_KHZ400 0x0100 // 400 KHz datastream typedef uint16_t neoPixelType; /**************************************************************************/ /*! @brief Class that stores state and functions for neopixels on CircuitPlayground boards */ /**************************************************************************/ class Adafruit_CPlay_NeoPixel { public: // Constructor: number of LEDs, pin number, LED type Adafruit_CPlay_NeoPixel(uint16_t n, uint8_t p=17, neoPixelType t=NEO_GRB + NEO_KHZ800); Adafruit_CPlay_NeoPixel(void); ~Adafruit_CPlay_NeoPixel(); void begin(void), show(void), setPin(uint8_t p), setPixelColor(uint16_t n, uint8_t r, uint8_t g, uint8_t b), setPixelColor(uint16_t n, uint8_t r, uint8_t g, uint8_t b, uint8_t w), setPixelColor(uint16_t n, uint32_t c), setBrightness(uint8_t), clear(), updateLength(uint16_t n), updateType(neoPixelType t); uint8_t *getPixels(void) const, getBrightness(void) const, sine8(uint8_t) const, gamma8(uint8_t) const; uint16_t numPixels(void) const; static uint32_t Color(uint8_t r, uint8_t g, uint8_t b), Color(uint8_t r, uint8_t g, uint8_t b, uint8_t w); uint32_t getPixelColor(uint16_t n) const; /**************************************************************************/ /*! @brief check if enough time has elapsed and the pixels are ready to refresh. @return true if ready to show, false otherwise. */ /**************************************************************************/ inline bool canShow(void) { return (micros() - endTime) >= 50L; } private: boolean #ifdef NEO_KHZ400 // If 400 KHz NeoPixel support enabled... is800KHz, ///< ...true if 800 KHz pixels #endif begun; ///< true if begin() previously called uint16_t numLEDs, ///< Number of RGB LEDs in strip numBytes; ///< Size of 'pixels' buffer below (3 or 4 bytes/pixel) int8_t pin; ///< Output pin number (-1 if not yet set) uint8_t brightness, *pixels, ///< Holds LED color values (3 or 4 bytes each) rOffset, ///< Index of red byte within each 3- or 4-byte pixel gOffset, ///< Index of green byte bOffset, ///< Index of blue byte wOffset; ///< Index of white byte (same as rOffset if no white) uint32_t endTime; ///< Latch timing reference #ifdef __AVR__ volatile uint8_t *port; ///< Output PORT register uint8_t pinMask; ///< Output PORT bitmask #endif }; #endif // ADAFRUIT_CPLAY_NEOPIXEL_H