/* GARLAND MODULE Copyright (C) 2020 by Dmitry Blinov Inspired by https://github.com/Vasil-Pahomov/ArWs2812 (currently https://github.com/Vasil-Pahomov/Liana) Tested on 60 led strip. !!! For more leds can cause WDT rebot. Need to be carefully tested for more than 60 leds !!! The most time consuming operation is actually showing leds by Adafruit Neopixel. It take about 1870 mcs. More long strip can take more time to show. Currently animation calculation, brightness calculation/transition and showing makes in one loop cycle. Debug output shows timings. Overal timing should be not more that 3000 ms. For longer strips have sense to divide entire strip (pixels) on parts about 100 pixels and show one part at a cycle. */ #include "garland.h" #if GARLAND_SUPPORT #include #include #include "garland/color.h" #include "garland/palette.h" #include "garland/scene.h" #include "ws.h" const char* NAME_GARLAND_ENABLED = "garlandEnabled"; const char* NAME_GARLAND_BRIGHTNESS = "garlandBrightness"; const char* NAME_GARLAND_SPEED = "garlandSpeed"; const char* NAME_GARLAND_SWITCH = "garland_switch"; const char* NAME_GARLAND_SET_BRIGHTNESS = "garland_set_brightness"; const char* NAME_GARLAND_SET_SPEED = "garland_set_speed"; const char* NAME_GARLAND_SET_DEFAULT = "garland_set_default"; #define EFFECT_UPDATE_INTERVAL_MIN 5000 // 5 sec #define EFFECT_UPDATE_INTERVAL_MAX 10000 // 10 sec bool _garland_enabled = true; unsigned long _last_update = 0; unsigned long _interval_effect_update; // Palette should Palette pals[] = { // palettes below are taken from http://www.color-hex.com/color-palettes/ (and modified) // RGB: Red,Green,Blue sequence Palette("RGB", {0xFF0000, 0x00FF00, 0x0000FF}), // Rainbow: Rainbow colors Palette("Rainbow", {0xFF0000, 0xAB5500, 0xABAB00, 0x00FF00, 0x00AB55, 0x0000FF, 0x5500AB, 0xAB0055}), // RainbowStripe: Rainbow colors with alternating stripes of black Palette("Stripe", {0xFF0000, 0x000000, 0xAB5500, 0x000000, 0xABAB00, 0x000000, 0x00FF00, 0x000000, 0x00AB55, 0x000000, 0x0000FF, 0x000000, 0x5500AB, 0x000000, 0xAB0055, 0x000000}), // Party: Blue purple ping red orange yellow (and back). Basically, everything but the greens. // This palette is good for lighting at a club or party. Palette("Party", {0x5500AB, 0x84007C, 0xB5004B, 0xE5001B, 0xE81700, 0xB84700, 0xAB7700, 0xABAB00, 0xAB5500, 0xDD2200, 0xF2000E, 0xC2003E, 0x8F0071, 0x5F00A1, 0x2F00D0, 0x0007F9}), // Heat: Approximate "black body radiation" palette, akin to the FastLED 'HeatColor' function. // Recommend that you use values 0-240 rather than the usual 0-255, as the last 15 colors will be // 'wrapping around' from the hot end to the cold end, which looks wrong. Palette("Heat", {0x700070, 0xFF0000, 0xFFFF00, 0xFFFFCC}), // Fire: Palette("Fire", {0x000000, 0x220000, 0x880000, 0xFF0000, 0xFF6600, 0xFFCC00}), // Blue: Palette("Blue", {0xffffff, 0x0000ff, 0x00ffff}), // Sun: Slice Of The Sun Palette("Sun", {0xfff95b, 0xffe048, 0xffc635, 0xffad22, 0xff930f}), // Lime: yellow green mix Palette("Lime", {0x51f000, 0x6fff00, 0x96ff00, 0xc9ff00, 0xf0ff00}), // Pastel: Pastel Fruity Mixture Palette("Pastel", {0x75aa68, 0x5960ae, 0xe4be6c, 0xca5959, 0x8366ac}), // Green: Vibrant greens Palette("Green", {0x89ff01, 0x42c501, 0x349404, 0x0f6902, 0x004208})}; constexpr size_t palsSize() { return sizeof(pals)/sizeof(pals[0]); } Adafruit_NeoPixel pixels = Adafruit_NeoPixel(GARLAND_LEDS, GARLAND_D_PIN, NEO_GRB + NEO_KHZ800); Scene scene(&pixels); Anim* anims[] = {new AnimStart(), new AnimPixieDust(), new AnimSparkr(), new AnimRun(), new AnimStars(), new AnimSpread(), new AnimRandCyc(), new AnimFly(), new AnimComets(), new AnimAssemble()}; constexpr size_t animsSize() { return sizeof(anims)/sizeof(anims[0]); } //------------------------------------------------------------------------------ void garlandDisable() { pixels.clear(); } //------------------------------------------------------------------------------ void garlandEnabled(bool enabled) { _garland_enabled = enabled; } //------------------------------------------------------------------------------ bool garlandEnabled() { return _garland_enabled; } //------------------------------------------------------------------------------ // Setup //------------------------------------------------------------------------------ void _garlandConfigure() { _garland_enabled = getSetting(NAME_GARLAND_ENABLED, true); DEBUG_MSG_P(PSTR("[GARLAND] _garland_enabled = %d\n"), _garland_enabled); byte brightness = getSetting(NAME_GARLAND_BRIGHTNESS, 255); scene.setBrightness(brightness); DEBUG_MSG_P(PSTR("[GARLAND] brightness = %d\n"), brightness); float speed = getSetting(NAME_GARLAND_SPEED, 50); scene.setSpeed(speed); } //------------------------------------------------------------------------------ void _garlandReload() { _garlandConfigure(); } #if WEB_SUPPORT //------------------------------------------------------------------------------ void _garlandWebSocketOnConnected(JsonObject& root) { root[NAME_GARLAND_ENABLED] = garlandEnabled(); root[NAME_GARLAND_BRIGHTNESS] = scene.getBrightness(); root[NAME_GARLAND_SPEED] = scene.getSpeed(); root["garlandVisible"] = 1; } //------------------------------------------------------------------------------ bool _garlandWebSocketOnKeyCheck(const char* key, JsonVariant& value) { if (strncmp(key, NAME_GARLAND_ENABLED, strlen(NAME_GARLAND_ENABLED)) == 0) return true; if (strncmp(key, NAME_GARLAND_BRIGHTNESS, strlen(NAME_GARLAND_BRIGHTNESS)) == 0) return true; if (strncmp(key, NAME_GARLAND_SPEED, strlen(NAME_GARLAND_SPEED)) == 0) return true; return false; } //------------------------------------------------------------------------------ void _garlandWebSocketOnAction(uint32_t client_id, const char* action, JsonObject& data) { if (strcmp(action, NAME_GARLAND_SWITCH) == 0) { if (data.containsKey("status") && data.is("status")) { _garland_enabled = (1 == data["status"].as()); setSetting(NAME_GARLAND_ENABLED, _garland_enabled); if (!_garland_enabled) { schedule_function([](){ pixels.clear(); pixels.show(); }); } } } if (strcmp(action, NAME_GARLAND_SET_BRIGHTNESS) == 0) { if (data.containsKey("brightness")) { byte new_brightness = data.get("brightness"); DEBUG_MSG_P(PSTR("[GARLAND] new brightness = %d\n"), new_brightness); setSetting(NAME_GARLAND_BRIGHTNESS, new_brightness); scene.setBrightness(new_brightness); } } if (strcmp(action, NAME_GARLAND_SET_SPEED) == 0) { if (data.containsKey("speed")) { byte new_speed = data.get("speed"); DEBUG_MSG_P(PSTR("[GARLAND] new speed = %d\n"), new_speed); setSetting(NAME_GARLAND_SPEED, new_speed); scene.setSpeed(new_speed); } } if (strcmp(action, NAME_GARLAND_SET_DEFAULT) == 0) { scene.setDefault(); byte brightness = scene.getBrightness(); setSetting(NAME_GARLAND_BRIGHTNESS, brightness); byte speed = scene.getSpeed(); setSetting(NAME_GARLAND_SPEED, speed); char buffer[128]; snprintf_P(buffer, sizeof(buffer), PSTR("{\"garlandBrightness\": %d, \"garlandSpeed\": %d}"), brightness, speed); wsSend(buffer); } } #endif //------------------------------------------------------------------------------ // Loop //------------------------------------------------------------------------------ void garlandLoop(void) { if (!garlandEnabled()) return; scene.run(); unsigned long animation_time = millis() - _last_update; if (animation_time > _interval_effect_update && scene.finishedAnimCycle()) { _last_update = millis(); _interval_effect_update = secureRandom(EFFECT_UPDATE_INTERVAL_MIN, EFFECT_UPDATE_INTERVAL_MAX); static int animInd = 0; int prevAnimInd = animInd; while (prevAnimInd == animInd) animInd = secureRandom(1, animsSize()); static int paletteInd = 0; int prevPalInd = paletteInd; while (prevPalInd == paletteInd) paletteInd = secureRandom(palsSize()); int numShows = scene.getNumShows(); int frameRate = animation_time > 0 ? numShows * 1000 / animation_time : 0; DEBUG_MSG_P(PSTR("[GARLAND] Anim: %-10s Pal: %-8s timings: calc: %4d pixl: %3d show: %4d frate: %d\n"), anims[prevAnimInd]->name(), pals[prevPalInd].name(), scene.getAvgCalcTime(), scene.getAvgPixlTime(), scene.getAvgShowTime(), frameRate); DEBUG_MSG_P(PSTR("[GARLAND] Anim: %-10s Pal: %-8s Inter: %d\n"), anims[animInd]->name(), pals[paletteInd].name(), _interval_effect_update); scene.setAnim(anims[animInd]); scene.setPalette(&pals[paletteInd]); scene.setup(); } } //------------------------------------------------------------------------------ void garlandSetup() { _garlandConfigure(); // Websockets #if WEB_SUPPORT wsRegister() .onConnected(_garlandWebSocketOnConnected) .onKeyCheck(_garlandWebSocketOnKeyCheck) .onAction(_garlandWebSocketOnAction); #endif espurnaRegisterLoop(garlandLoop); espurnaRegisterReload(_garlandReload); pixels.begin(); scene.setAnim(anims[0]); scene.setPalette(&pals[0]); scene.setup(); _interval_effect_update = secureRandom(EFFECT_UPDATE_INTERVAL_MIN, EFFECT_UPDATE_INTERVAL_MAX); } /*####################################################################### _____ / ____| | (___ ___ ___ _ __ ___ \___ \ / __| / _ \ | '_ \ / _ \ ____) | | (__ | __/ | | | | | __/ |_____/ \___| \___| |_| |_| \___| #######################################################################*/ #define GARLAND_SCENE_TRANSITION_MS 1000 // transition time between animations, ms #define GARLAND_SCENE_SPEED_MAX 70 #define GARLAND_SCENE_SPEED_FACTOR 10 #define GARLAND_SCENE_DEFAULT_SPEED 50 #define GARLAND_SCENE_DEFAULT_BRIGHTNESS 255 Scene::Scene(Adafruit_NeoPixel* pixels) : _pixels(pixels), _numLeds(pixels->numPixels()), _leds1(_numLeds), _leds2(_numLeds), _ledstmp(_numLeds), _seq(_numLeds) { } void Scene::setPalette(Palette* palette) { _palette = palette; if (setUpOnPalChange) { setupImpl(); } } void Scene::setBrightness(byte brightness) { DEBUG_MSG_P(PSTR("[GARLAND] Scene::setBrightness = %d\n"), brightness); this->brightness = brightness; } byte Scene::getBrightness() { DEBUG_MSG_P(PSTR("[GARLAND] Scene::getBrightness = %d\n"), brightness); return brightness; } // Speed is reverse to cycleFactor and 10x void Scene::setSpeed(byte speed) { this->speed = speed; cycleFactor = (float)(GARLAND_SCENE_SPEED_MAX - speed) / GARLAND_SCENE_SPEED_FACTOR; DEBUG_MSG_P(PSTR("[GARLAND] Scene::setSpeed %d cycleFactor = %d\n"), speed, (int)(cycleFactor * 1000)); } byte Scene::getSpeed() { DEBUG_MSG_P(PSTR("[GARLAND] Scene::getSpeed %d cycleFactor = %d\n"), speed, (int)(cycleFactor * 1000)); return speed; } void Scene::setDefault() { speed = GARLAND_SCENE_DEFAULT_SPEED; cycleFactor = (float)(GARLAND_SCENE_SPEED_MAX - speed) / GARLAND_SCENE_SPEED_FACTOR; brightness = GARLAND_SCENE_DEFAULT_BRIGHTNESS; DEBUG_MSG_P(PSTR("[GARLAND] Scene::setDefault speed = %d cycleFactor = %d brightness = %d\n"), speed, (int)(cycleFactor * 1000), brightness); } void Scene::run() { unsigned long iteration_start_time = micros(); if (state == Calculate || cyclesRemain < 1) { // Calculate number of cycles for this animation iteration float cycleSum = cycleFactor * (_anim ? _anim->getCycleFactor() : 1.0) + cycleTail; cyclesRemain = cycleSum; if (cyclesRemain < 1) { cyclesRemain = 1; cycleSum = 0; cycleTail = 0; } else { cycleTail = cycleSum - cyclesRemain; } if (_anim) { _anim->Run(); } sum_calc_time += (micros() - iteration_start_time); iteration_start_time = micros(); ++calc_num; state = Transition; } if (state == Transition && cyclesRemain < 3) { // transition coef, if within 0..1 - transition is active // changes from 1 to 0 during transition, so we interpolate from current // color to previous float transc = (float)((long)transms - (long)millis()) / GARLAND_SCENE_TRANSITION_MS; Color* leds_prev = (_leds == &_leds1[0]) ? &_leds2[0] : &_leds1[0]; if (transc > 0) { for (int i = 0; i < _numLeds; i++) { // transition is in progress Color c = _leds[i].interpolate(leds_prev[i], transc); byte r = (int)(bri_lvl[c.r]) * brightness / 256; byte g = (int)(bri_lvl[c.g]) * brightness / 256; byte b = (int)(bri_lvl[c.b]) * brightness / 256; _pixels->setPixelColor(i, _pixels->Color(r, g, b)); } } else { for (int i = 0; i < _numLeds; i++) { // regular operation byte r = (int)(bri_lvl[_leds[i].r]) * brightness / 256; byte g = (int)(bri_lvl[_leds[i].g]) * brightness / 256; byte b = (int)(bri_lvl[_leds[i].b]) * brightness / 256; _pixels->setPixelColor(i, _pixels->Color(r, g, b)); } } sum_pixl_time += (micros() - iteration_start_time); iteration_start_time = micros(); ++pixl_num; state = Show; } if (state == Show && cyclesRemain < 2) { _pixels->show(); sum_show_time += (micros() - iteration_start_time); ++show_num; state = Calculate; ++numShows; } --cyclesRemain; } void Scene::setupImpl() { transms = millis() + GARLAND_SCENE_TRANSITION_MS; // switch operation buffers (for transition to operate) if (_leds == &_leds1[0]) { _leds = &_leds2[0]; } else { _leds = &_leds1[0]; } if (_anim) { _anim->Setup(_palette, _numLeds, _leds, &_ledstmp[0], &_seq[0]); } } void Scene::setup() { sum_calc_time = 0; sum_pixl_time = 0; sum_show_time = 0; calc_num = 0; pixl_num = 0; show_num = 0; numShows = 0; if (!setUpOnPalChange) { setupImpl(); } } unsigned long Scene::getAvgCalcTime() { return sum_calc_time / calc_num; } unsigned long Scene::getAvgPixlTime() { return sum_pixl_time / pixl_num; } unsigned long Scene::getAvgShowTime() { return sum_show_time / show_num; } /*####################################################################### _ _ _ /\ (_) | | (_) / \ _ __ _ _ __ ___ __ _ | |_ _ ___ _ __ / /\ \ | '_ \ | | | '_ ` _ \ / _` | | __| | | / _ \ | '_ \ / ____ \ | | | | | | | | | | | | | (_| | | |_ | | | (_) | | | | | /_/ \_\ |_| |_| |_| |_| |_| |_| \__,_| \__| |_| \___/ |_| |_| #######################################################################*/ Anim::Anim(const char* name) : _name(name) {} void Anim::Setup(Palette* palette, uint16_t numLeds, Color* leds, Color* ledstmp, byte* seq) { this->palette = palette; this->numLeds = numLeds; this->leds = leds; this->ledstmp = ledstmp; this->seq = seq; SetupImpl(); } void Anim::initSeq() { for (int i = 0; i < numLeds; i++) seq[i] = i; } void Anim::shuffleSeq() { for (int i = 0; i < numLeds; i++) { byte ind = (unsigned int)(rngb() * numLeds / 256); if (ind != i) { std::swap(seq[ind], seq[i]); } } } void Anim::glowSetUp() { braPhaseSpd = secureRandom(4, 13); if (braPhaseSpd > 8) { braPhaseSpd = braPhaseSpd - 17; } braFreq = secureRandom(20, 60); } void Anim::glowForEachLed(int i) { int8 bra = braPhase + i * braFreq; bra = BRA_OFFSET + (abs(bra) >> BRA_AMP_SHIFT); leds[i] = leds[i].brightness(bra); } void Anim::glowRun() { braPhase += braPhaseSpd; } bool operator== (const Color &c1, const Color &c2) { return (c1.r == c2.r && c1.g == c2.g && c1.b == c2.b); } unsigned int rng() { static unsigned int y = 0; y += micros(); // seeded with changing number y ^= y << 2; y ^= y >> 7; y ^= y << 7; return (y); } // Ranom numbers generator in byte range (256) much faster than secureRandom. // For usage in time-critical places. byte rngb() { return (byte)rng(); } #endif // GARLAND_SUPPORT