.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [makuna]
+custom: ["https://paypal.me/MakunaGithub"]

.github/ISSUE_TEMPLATE/all-others.md

@@ -0,0 +1,15 @@
+---
+name: All others
+about: If your issue doesn't fit the other two, this will guide you to support.
+title: "[DELETE ME]"
+labels: NOT AN ISSUE
+assignees: ''
+
+---
+
+### STOP
+If you are seeking support, then please use the Discussions feature or gitter channel by following one of these links.  
+[NeoPixelBus Discussions](https://github.com/Makuna/NeoPixelBus/discussions)  
+[NeoPixelBus Gitter Channel](https://gitter.im/Makuna/NeoPixelBus)  
+
+If you submit issues that are not traceable bugs or feature requests, it will just get closed.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,6 +1,9 @@
 ---
 name: Bug report
 about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
 
 ---
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,6 +1,9 @@
 ---
 name: Feature request
 about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
 
 ---
 

ReadMe.md

@@ -4,26 +4,21 @@
 
 Arduino NeoPixel library
 
-A library to control one wire protocol RGB and RGBW leds like APA106, SK6812, WS2811, WS2812 and WS2813 that are commonly refered to as NeoPixels and two wire protocol RGB like APA102 commonly refered to as DotStars.
+A library to control one wire protocol RGB, RGBW, and RGBWW leds like APA106, SK6812, WS2811, WS2812 and WS2813 that are commonly refered to as NeoPixels and two wire protocol RGB like Lpd8806, APA102 and SK9822 commonly refered to as DotStars.
 Supports most Arduino platforms.  
-This is the most functional library for the Esp8266 as it provides solutions for all Esp8266 module types even when WiFi is used.  
 
-
-Please read this best practices link before connecting your NeoPixels, it will save you a lot of time and effort.  
-[Adafruit NeoPixel Best Practices](https://learn.adafruit.com/adafruit-neopixel-uberguide/best-practices)
-
-For quick questions jump on Gitter and ask away.  
-[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Makuna/NeoPixelBus?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
+For quick questions and support:  
+* [Try the new Github Discussions](https://github.com/Makuna/NeoPixelBus/discussions)  
+* [Discord NeoPixelBus Invitation](https://discord.gg/c6FrysvZyV) or if you are already a member of [Discord Server NeoPixelBus](https://discord.com/channels/789177382221119519/789177382221119521)  
+* Or jump on Gitter   
+[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Makuna/NeoPixelBus?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)  
 
 For bugs, make sure there isn't an active issue and then create one.
 
-## Why this library and not FastLED or some other library?
-See [Why this Library in the Wiki](https://github.com/Makuna/NeoPixelBus/wiki/Library-Comparisons). 
-
 ## Documentation
 [See Wiki](https://github.com/Makuna/NeoPixelBus/wiki)
 
-## Installing This Library (prefered, you just want to use it)
+## Installing This Library (preferred, you just want to use it)
 Open the Library Manager and search for "NeoPixelBus by Makuna" and install
 
 ## Installing This Library From GitHub (advanced, you want to contribute)

examples/ESP32/DotStarTest_Esp32Advanced/DotStarTest_Esp32Advanced.ino

@@ -0,0 +1,160 @@
+// DotStarTest_Esp32Advanced - This example only works on the ESP32
+// This example will cycle between showing four pixels as Red, Green, Blue, White
+// and then showing those pixels as Black.  This example uses Hardware SPI on the ESP32
+// with options to use alternate pins for SPI and drive two SPI ports using the alternate
+// additional SPI hardware available on the ESP32.
+//
+// There is serial output of the current state so you can confirm and follow along
+//
+
+#include <NeoPixelBus.h>
+
+#define USE_DEFAULT_SPI_PORT 1
+#define USE_ALTERNATE_SPI_PORT 1
+
+#if (USE_DEFAULT_SPI_PORT == 1)
+    const uint16_t PixelCount = 4; // this example assumes 4 pixels, making it smaller will cause a failure
+
+    // It's usually better to use alternate pins.  If set to false, strip will use GPIO 18 for Clock, GPIO 23 for Data, and pin 5 will output a chip select signal
+    const bool useSpiAlternatePins = true;
+
+    // If you set useSpiAlternatePins true, then these pins will be used instead.  Any output-capable GPIO can be used.
+    const uint8_t DotClockPin = 18;
+    const uint8_t DotDataPin = 23;  
+    const uint8_t MisoUnusedPin = -1;
+    const int8_t DotChipSelectPin = -1; // -1 means the chip select signal won't be output, freeing up one pin compared to useSpiAlternatePins=false
+
+    // for software bit bang (only use if neither SPI peripheral is available)
+    //NeoPixelBus<DotStarBgrFeature, DotStarMethod> strip(PixelCount, DotClockPin, DotDataPin);
+
+    // for hardware SPI (best performance) with default SPI peripheral 
+    NeoPixelBus<DotStarBgrFeature, DotStarSpiMethod> strip(PixelCount);
+
+    // DotStarSpiMethod defaults to 10MHz clock speed.  For other speeds, replace "DotStarSpiMethod" with another method specifying speed, e.g. "DotStarSpi2MhzMethod" (see wiki for more details)
+
+    // to change the SPI clock speed during runtime, use the "Hz" clock setting, e.g. DotStarSpiHzMethod, which default to 10MHz but supports updating during runtime
+    //NeoPixelBus<DotStarBgrFeature, DotStarSpiHzMethod> strip(PixelCount);
+    //#define SET_CLOCK_SPEED_DURING_RUNTIME     // only define if using "Hz" clock method
+
+#endif
+
+#if (USE_ALTERNATE_SPI_PORT == 1)
+    const uint16_t PixelCount2 = 4; // this example assumes 4 pixels, making it smaller will cause a failure
+
+    // It's usually better to use alternate pins.  If set to false, strip2 will use GPIO 14 for Clock, GPIO 13 for Data, and pin 15 will output a chip select signal
+    const bool useSpiAlternatePins2 = true;
+
+    // If you set useSpiAlternatePins2 true, then these pins will be used instead.  Any output-capable GPIO can be used.
+    const uint8_t DotClockPin2 = 14;
+    const uint8_t DotDataPin2 = 13;  
+    const int8_t DotChipSelectPin2 = -1; // -1 means the chip select signal won't be output, freeing up one pin compared to useSpiAlternatePins2=false
+
+    // for hardware SPI (best performance) with alternate SPI peripheral
+    NeoPixelBus<DotStarBgrFeature, DotStarHspiMethod> strip2(PixelCount2);
+
+    // DotStarHspiMethod defaults to 10MHz clock speed.  For other speeds, replace "DotStarSpiMethod" with another method specifying speed, e.g. "DotStarHspi2MhzMethod" (see wiki for more details)
+#endif
+
+#define colorSaturation 128
+
+// Note that both DotStarSpiMethod and DotStarHspiMethod can be used with DotStarLbgrFeature and DotStarWbgrFeature but to keep things simple those are excluded from this example, see DotStarTest for more details
+
+RgbColor red(colorSaturation, 0, 0);
+RgbColor green(0, colorSaturation, 0);
+RgbColor blue(0, 0, colorSaturation);
+RgbColor white(colorSaturation);
+RgbColor black(0);
+
+void setup()
+{
+    Serial.begin(115200);
+    while (!Serial); // wait for serial attach
+
+    Serial.println();
+    Serial.println("Initializing...");
+    Serial.flush();
+
+#if (USE_DEFAULT_SPI_PORT == 1)
+    if (useSpiAlternatePins)
+    {
+        strip.Begin(DotClockPin, MisoUnusedPin, DotDataPin, DotChipSelectPin);
+    }
+    else
+    {
+        strip.Begin();
+    }
+
+    strip.ClearTo(black);   // this resets all the DotStars to an off state
+    strip.Show();
+#endif
+
+#if (USE_ALTERNATE_SPI_PORT == 1)
+    if (useSpiAlternatePins2)
+    {
+        strip2.Begin(DotClockPin2, MisoUnusedPin, DotDataPin2, DotChipSelectPin2);
+    }
+    else
+    {
+        strip2.Begin();
+    }
+
+    strip2.ClearTo(black);  // this resets all the DotStars to an off state
+    strip2.Show();
+#endif
+
+    Serial.println();
+    Serial.println("Running...");
+}
+
+
+void loop()
+{
+    delay(5000);
+
+#if (USE_DEFAULT_SPI_PORT == 1)
+    Serial.println("Default SPI Colors R, G, B, W...");
+    // set the colors, 
+    strip.SetPixelColor(0, red);
+    strip.SetPixelColor(1, green);
+    strip.SetPixelColor(2, blue);
+    strip.SetPixelColor(3, white);
+    strip.Show();
+#endif
+
+#if (USE_ALTERNATE_SPI_PORT == 1)
+    Serial.println("Alt SPI Colors W, B, G, R...");
+    // set the colors, 
+    strip2.SetPixelColor(0, white);
+    strip2.SetPixelColor(1, blue);
+    strip2.SetPixelColor(2, green);
+    strip2.SetPixelColor(3, red);
+    strip2.Show();
+#endif
+
+    delay(5000);
+
+    Serial.println("Off ...");
+
+#if (USE_DEFAULT_SPI_PORT == 1)
+    #ifdef SET_CLOCK_SPEED_DURING_RUNTIME
+        uint32_t clockspeed = 5000000UL;
+        strip.SetMethodSettings(NeoSpiSettings(clockspeed));
+    #endif
+
+    // turn off the pixels
+    strip.SetPixelColor(0, black);
+    strip.SetPixelColor(1, black);
+    strip.SetPixelColor(2, black);
+    strip.SetPixelColor(3, black);
+    strip.Show();
+#endif
+
+#if (USE_ALTERNATE_SPI_PORT == 1)
+    // turn off the pixels
+    strip2.SetPixelColor(0, black);
+    strip2.SetPixelColor(1, black);
+    strip2.SetPixelColor(2, black);
+    strip2.SetPixelColor(3, black);
+    strip2.Show();
+#endif
+}