/*=====================================
= VixPix Sketch =
For basic control of RGB Pixels
using Vixen Generic Serial3 Protocol
=====================================*/
/**
* VIXEN Setup:
* In Vixen display setup...
* - Add an element group containing one element for each pixel attached to arduino
* - Configure the 'Color Handling' as "They can be any color: Full RGB"
* - Add a "Generic Serial3 Controller"
* - Name it what you want (Although... Jdc928IsAwesome is great controller name)
* - Set the channel count to 3x the number of Pixels you have
* - Save, then configure these options
* - Com Port: choose the correct port for your arduino's Serial3
* - Baud Rate: 115200 (or whatever you changed it to below)
* - Click OK
* - Check the box "Send a text header"
* - Type "VIXStart" in the header text box
* - Click "OK"
*
* - Click and highlight the newly added Element in the elements list
* - Click and highlight the newly created controller
* - Your "Total Patch Points" and "Output" counts should match
* - Click "Patch Elements to Controllers"
* - Click OK and you should be ready to go
*
*
* You should now be able open a Sequence
add some effects to the new channels
and see the strips responding accordingly
*/
/**
* Pixel Strip Setup
* Strips setups vary but generally as follows
* - If your using a large number of strips you will
* probably want to power them externally.
*
* - Connect external V+ to strip Vin
* - Connect external Gnd to strip Gnd
* - Connect external Gnd to Arduino Gnd
* - Connect Strip Data to proper pin on Arduino
* - Connect Strip DataClock to proper pin on Arduino if not using ws2812
*/
#include <Adafruit_NeoPixel.h> // This is the Neo-Pixel library (ws2812)
// Change to the library for your pixel types
// Suggest using a library created by Adafruit
// so the function names will be the same
#define DPIN 6 // Change this to the pin# connected to your pixels DataIn
// Will probably need to define a ClockPin for other pixel
int PixelCount = 101; // Set this to the number of Pixels connected
int bugLevel = 0; // This is just a way I manage turning debugging over Serial3 on/off
/* Sets up the NeoPixel Strip object
Replace with proper Object initiation for your pixel types */
Adafruit_NeoPixel strip = Adafruit_NeoPixel(PixelCount, DPIN, NEO_RGB + NEO_KHZ800);
void setup()
{
delay(100); // A delay for a reason I can't remember. I can live with one in the setup.
strip.begin(); // Get strip started
strip.show(); // Initialize all pixels to 'off'
Serial3.begin(57600); // Start the Serial3 communication 57600
bugit("Setup Complete",10); // DEBUG: Confirm setup is complete
}
void loop()
{ // START LOOP
if (Serial3.available()>2) // Wait for a few bytes to be recieved
{
bugit("Waiting for Header",10); // DEBUG: Header waiting started
waitForVixenHeader(); // Header check function
bugit("VixStart Triggered",10); // DEBUG: Header found; getting color data
for (int pixCount=0; pixCount<PixelCount;pixCount++) // Do this for as many Pixels defined in PixelCount
{
int RGB[3]; // Create array to hold this pixels RGB value
for (int color = 0;color<3;color++) // For the next 3 incoming bytes
{
while (Serial3.available() < 1) // Wait for bytes to be received
{
delay(10);
}
RGB[color] = Serial3.read(); // Save this byte to the correct RGB value
} // Repeat until bytes for this pixels RGB value have been recieved
strip.setPixelColor(pixCount,RGB[0],RGB[1],RGB[2]); //Set this pixels new color
} // Repeat untill all pixels have had new RGB value set
strip.show(); // Update the strip and show with new color
} // YAY! DO IT AGAIN!
} // END OF LOOP
/**
* FUNC bugit [manages printing of debugging based on debugging level]
* @param String bugstr [string to be be printed]
* @param int blevel [the level at which this debugging should be ignored]
*
*/
int bugit(String bugstr,int blevel)
{
if (blevel < bugLevel)
{
Serial3.println(bugstr);
}
return;
}
/**
* I 'borrowed' snippets of this waitForVixenHeader() function from some code I found online
* Can't find the originator now but thank you. It works well.
*
*/
void waitForVixenHeader()
{
bugit("Waiting Loop",10);
char *header="VIXStart";
char buffer[3];
int index = 0;
while (true)
{
int inByte = Serial3.read();
if(inByte==-1)
{
continue;
}
buffer[index] = inByte;
if(buffer[index]!=header[index])
{
index=-1; // not the right sequence restart
}
buffer[index+1] = 0; // add null
index++;
if(index==8)
{
return;
}
}
}
