Prototype of processing code on teensy 3.1 & OctoWS2811
Raphaël Vinot
parent
30c7b90032
commit
c2ef20184b
|
|
@ -0,0 +1,251 @@
|
|||
/* OctoWS2811 VideoDisplay.ino - Video on LEDs, from a PC, Mac, Raspberry Pi
|
||||
http://www.pjrc.com/teensy/td_libs_OctoWS2811.html
|
||||
Copyright (c) 2013 Paul Stoffregen, PJRC.COM, LLC
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
THE SOFTWARE.
|
||||
|
||||
|
||||
Required Connections
|
||||
--------------------
|
||||
pin 2: LED Strip #1 OctoWS2811 drives 8 LED Strips.
|
||||
pin 14: LED strip #2 All 8 are the same length.
|
||||
pin 7: LED strip #3
|
||||
pin 8: LED strip #4 A 100 to 220 ohm resistor should used
|
||||
pin 6: LED strip #5 between each Teensy pin and the
|
||||
pin 20: LED strip #6 wire to the LED strip, to minimize
|
||||
pin 21: LED strip #7 high frequency ringining & noise.
|
||||
pin 5: LED strip #8
|
||||
pin 15 & 16 - Connect together, but do not use
|
||||
pin 4: Do not use
|
||||
pin 3: Do not use as PWM. Normal use is ok.
|
||||
pin 12: Frame Sync
|
||||
|
||||
When using more than 1 Teensy to display a video image, connect
|
||||
the Frame Sync signal between every board. All boards will
|
||||
synchronize their WS2811 update using this signal.
|
||||
|
||||
Beware of image distortion from long LED strip lengths. During
|
||||
the WS2811 update, the LEDs update in sequence, not all at the
|
||||
same instant! The first pixel updates after 30 microseconds,
|
||||
the second pixel after 60 us, and so on. A strip of 120 LEDs
|
||||
updates in 3.6 ms, which is 10.8% of a 30 Hz video frame time.
|
||||
Doubling the strip length to 240 LEDs increases the lag to 21.6%
|
||||
of a video frame. For best results, use shorter length strips.
|
||||
Multiple boards linked by the frame sync signal provides superior
|
||||
video timing accuracy.
|
||||
|
||||
A Multi-TT USB hub should be used if 2 or more Teensy boards
|
||||
are connected. The Multi-TT feature allows proper USB bandwidth
|
||||
allocation. Single-TT hubs, or direct connection to multiple
|
||||
ports on the same motherboard, may give poor performance.
|
||||
*/
|
||||
|
||||
#include <OctoWS2811.h>
|
||||
|
||||
// The actual arrangement of the LEDs connected to this Teensy 3.0 board.
|
||||
// LED_HEIGHT *must* be a multiple of 8. When 16, 24, 32 are used, each
|
||||
// strip spans 2, 3, 4 rows. LED_LAYOUT indicates the direction the strips
|
||||
// are arranged. If 0, each strip begins on the left for its first row,
|
||||
// then goes right to left for its second row, then left to right,
|
||||
// zig-zagging for each successive row.
|
||||
#define LED_WIDTH 50 // number of LEDs horizontally
|
||||
#define LED_HEIGHT 1 // number of LEDs vertically (must be multiple of 8)
|
||||
#define LED_LAYOUT 0 // 0 = even rows left->right, 1 = even rows right->left
|
||||
|
||||
// The portion of the video image to show on this set of LEDs. All 4 numbers
|
||||
// are percentages, from 0 to 100. For a large LED installation with many
|
||||
// Teensy 3.0 boards driving groups of LEDs, these parameters allow you to
|
||||
// program each Teensy to tell the video application which portion of the
|
||||
// video it displays. By reading these numbers, the video application can
|
||||
// automatically configure itself, regardless of which serial port COM number
|
||||
// or device names are assigned to each Teensy 3.0 by your operating system.
|
||||
#define VIDEO_XOFFSET 0
|
||||
#define VIDEO_YOFFSET 0 // display entire image
|
||||
#define VIDEO_WIDTH 10
|
||||
#define VIDEO_HEIGHT 10
|
||||
|
||||
//#define VIDEO_XOFFSET 0
|
||||
//#define VIDEO_YOFFSET 0 // display upper half
|
||||
//#define VIDEO_WIDTH 100
|
||||
//#define VIDEO_HEIGHT 50
|
||||
|
||||
//#define VIDEO_XOFFSET 0
|
||||
//#define VIDEO_YOFFSET 50 // display lower half
|
||||
//#define VIDEO_WIDTH 100
|
||||
//#define VIDEO_HEIGHT 50
|
||||
|
||||
|
||||
//const int ledsPerStrip = LED_WIDTH * LED_HEIGHT / 8;
|
||||
const int ledsPerStrip = 40;
|
||||
|
||||
DMAMEM int displayMemory[ledsPerStrip*6];
|
||||
int drawingMemory[ledsPerStrip*6];
|
||||
elapsedMicros elapsedUsecSinceLastFrameSync = 0;
|
||||
|
||||
const int config = WS2811_800kHz; // color config is on the PC side
|
||||
|
||||
OctoWS2811 leds(ledsPerStrip, displayMemory, drawingMemory, config);
|
||||
|
||||
void setup() {
|
||||
pinMode(13, OUTPUT);
|
||||
digitalWrite(13, HIGH);
|
||||
delay(1000);
|
||||
digitalWrite(13, LOW);
|
||||
pinMode(12, INPUT_PULLUP); // Frame Sync
|
||||
Serial.setTimeout(50);
|
||||
leds.begin();
|
||||
leds.show();
|
||||
}
|
||||
|
||||
void loop() {
|
||||
//
|
||||
// wait for a Start-Of-Message character:
|
||||
//
|
||||
// '*' = Frame of image data, with frame sync pulse to be sent
|
||||
// a specified number of microseconds after reception of
|
||||
// the first byte (typically at 75% of the frame time, to
|
||||
// allow other boards to fully receive their data).
|
||||
// Normally '*' is used when the sender controls the pace
|
||||
// of playback by transmitting each frame as it should
|
||||
// appear.
|
||||
//
|
||||
// '$' = Frame of image data, with frame sync pulse to be sent
|
||||
// a specified number of microseconds after the previous
|
||||
// frame sync. Normally this is used when the sender
|
||||
// transmits each frame as quickly as possible, and we
|
||||
// control the pacing of video playback by updating the
|
||||
// LEDs based on time elapsed from the previous frame.
|
||||
//
|
||||
// '%' = Frame of image data, to be displayed with a frame sync
|
||||
// pulse is received from another board. In a multi-board
|
||||
// system, the sender would normally transmit one '*' or '$'
|
||||
// message and '%' messages to all other boards, so every
|
||||
// Teensy 3.0 updates at the exact same moment.
|
||||
//
|
||||
// '@' = Reset the elapsed time, used for '$' messages. This
|
||||
// should be sent before the first '$' message, so many
|
||||
// frames are not played quickly if time as elapsed since
|
||||
// startup or prior video playing.
|
||||
//
|
||||
// '?' = Query LED and Video parameters. Teensy 3.0 responds
|
||||
// with a comma delimited list of information.
|
||||
//
|
||||
int startChar = Serial.read();
|
||||
|
||||
if (startChar == '*') {
|
||||
// receive a "master" frame - we send the frame sync to other boards
|
||||
// the sender is controlling the video pace. The 16 bit number is
|
||||
// how far into this frame to send the sync to other boards.
|
||||
unsigned int startAt = micros();
|
||||
unsigned int usecUntilFrameSync = 0;
|
||||
int count = Serial.readBytes((char *)&usecUntilFrameSync, 2);
|
||||
if (count != 2) return;
|
||||
count = Serial.readBytes((char *)drawingMemory, sizeof(drawingMemory));
|
||||
if (count >= sizeof(drawingMemory)) {
|
||||
unsigned int endAt = micros();
|
||||
unsigned int usToWaitBeforeSyncOutput = 100;
|
||||
if (endAt - startAt < usecUntilFrameSync) {
|
||||
usToWaitBeforeSyncOutput = usecUntilFrameSync - (endAt - startAt);
|
||||
}
|
||||
digitalWrite(12, HIGH);
|
||||
pinMode(12, OUTPUT);
|
||||
delayMicroseconds(usToWaitBeforeSyncOutput);
|
||||
digitalWrite(12, LOW);
|
||||
// WS2811 update begins immediately after falling edge of frame sync
|
||||
digitalWrite(13, HIGH);
|
||||
leds.show();
|
||||
digitalWrite(13, LOW);
|
||||
}
|
||||
|
||||
} else if (startChar == '$') {
|
||||
// receive a "master" frame - we send the frame sync to other boards
|
||||
// we are controlling the video pace. The 16 bit number is how long
|
||||
// after the prior frame sync to wait until showing this frame
|
||||
unsigned int usecUntilFrameSync = 0;
|
||||
int count = Serial.readBytes((char *)&usecUntilFrameSync, 2);
|
||||
if (count != 2) return;
|
||||
count = Serial.readBytes((char *)drawingMemory, sizeof(drawingMemory));
|
||||
if (count >= sizeof(drawingMemory)) {
|
||||
digitalWrite(12, HIGH);
|
||||
pinMode(12, OUTPUT);
|
||||
while (elapsedUsecSinceLastFrameSync < usecUntilFrameSync) /* wait */ ;
|
||||
elapsedUsecSinceLastFrameSync -= usecUntilFrameSync;
|
||||
digitalWrite(12, LOW);
|
||||
// WS2811 update begins immediately after falling edge of frame sync
|
||||
digitalWrite(13, HIGH);
|
||||
leds.show();
|
||||
digitalWrite(13, LOW);
|
||||
}
|
||||
|
||||
} else if (startChar == '%') {
|
||||
// receive a "slave" frame - wait to show it until the frame sync arrives
|
||||
pinMode(12, INPUT_PULLUP);
|
||||
unsigned int unusedField = 0;
|
||||
int count = Serial.readBytes((char *)&unusedField, 2);
|
||||
if (count != 2) return;
|
||||
count = Serial.readBytes((char *)drawingMemory, sizeof(drawingMemory));
|
||||
if (count >= sizeof(drawingMemory)) {
|
||||
elapsedMillis wait = 0;
|
||||
while (digitalRead(12) != HIGH && wait < 30) ; // wait for sync high
|
||||
while (digitalRead(12) != LOW && wait < 30) ; // wait for sync high->low
|
||||
// WS2811 update begins immediately after falling edge of frame sync
|
||||
if (wait < 30) {
|
||||
digitalWrite(13, HIGH);
|
||||
leds.show();
|
||||
digitalWrite(13, LOW);
|
||||
}
|
||||
}
|
||||
|
||||
} else if (startChar == '@') {
|
||||
// reset the elapsed frame time, for startup of '$' message playing
|
||||
elapsedUsecSinceLastFrameSync = 0;
|
||||
|
||||
} else if (startChar == '?') {
|
||||
// when the video application asks, give it all our info
|
||||
// for easy and automatic configuration
|
||||
Serial.print(LED_WIDTH);
|
||||
Serial.write(',');
|
||||
Serial.print(LED_HEIGHT);
|
||||
Serial.write(',');
|
||||
Serial.print(LED_LAYOUT);
|
||||
Serial.write(',');
|
||||
Serial.print(0);
|
||||
Serial.write(',');
|
||||
Serial.print(0);
|
||||
Serial.write(',');
|
||||
Serial.print(VIDEO_XOFFSET);
|
||||
Serial.write(',');
|
||||
Serial.print(VIDEO_YOFFSET);
|
||||
Serial.write(',');
|
||||
Serial.print(VIDEO_WIDTH);
|
||||
Serial.write(',');
|
||||
Serial.print(VIDEO_HEIGHT);
|
||||
Serial.write(',');
|
||||
Serial.print(0);
|
||||
Serial.write(',');
|
||||
Serial.print(0);
|
||||
Serial.write(',');
|
||||
Serial.print(0);
|
||||
Serial.println();
|
||||
|
||||
} else if (startChar >= 0) {
|
||||
// discard unknown characters
|
||||
}
|
||||
}
|
||||
|
||||
|
|
@ -0,0 +1,150 @@
|
|||
/* OctoWS2811 movie2serial.pde - Transmit video data to 1 or more
|
||||
Teensy 3.0 boards running OctoWS2811 VideoDisplay.ino
|
||||
http://www.pjrc.com/teensy/td_libs_OctoWS2811.html
|
||||
Copyright (c) 2013 Paul Stoffregen, PJRC.COM, LLC
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
THE SOFTWARE.
|
||||
*/
|
||||
|
||||
// To configure this program, edit the following sections:
|
||||
//
|
||||
// 1: change myMovie to open a video file of your choice ;-)
|
||||
//
|
||||
// 2: edit the serialConfigure() lines in setup() for your
|
||||
// serial device names (Mac, Linux) or COM ports (Windows)
|
||||
//
|
||||
// 3: if your LED strips have unusual color configuration,
|
||||
// edit colorWiring(). Nearly all strips have GRB wiring,
|
||||
// so normally you can leave this as-is.
|
||||
//
|
||||
// 4: if playing 50 or 60 Hz progressive video (or faster),
|
||||
// edit framerate in movieEvent().
|
||||
|
||||
import processing.serial.*;
|
||||
import java.awt.Rectangle;
|
||||
|
||||
float gamma = 1.7;
|
||||
|
||||
Serial ledSerial; // each port's actual Serial port
|
||||
PImage ledImage;
|
||||
Rectangle ledArea; // the area of the movie each port gets, in % (0-100)
|
||||
int[] gammatable = new int[256];
|
||||
int errorCount=0;
|
||||
float framerate=0;
|
||||
|
||||
PImage img; // Declare variable "a" of type PImage
|
||||
|
||||
void setup() {
|
||||
String[] list = Serial.list();
|
||||
delay(20);
|
||||
println("Serial Ports List:");
|
||||
println(list);
|
||||
serialConfigure("/dev/ttyACM0");
|
||||
if (errorCount > 0) exit();
|
||||
for (int i=0; i < 256; i++) {
|
||||
gammatable[i] = (int)(pow((float)i / 255.0, gamma) * 255.0 + 0.5);
|
||||
}
|
||||
size(40, 1);
|
||||
img = loadImage("test1.png");
|
||||
}
|
||||
|
||||
// image2data converts an image to OctoWS2811's raw data format.
|
||||
// The number of vertical pixels in the image must be a multiple
|
||||
// of 8. The data array must be the proper size for the image.
|
||||
void image2data(PImage image, byte[] data) {
|
||||
int offset = 3;
|
||||
int x, y, xbegin, xend, xinc, mask;
|
||||
int linesPerPin = 1 / 8;
|
||||
int pixel[] = new int[8];
|
||||
xbegin = 0;
|
||||
xend = image.width;
|
||||
xinc = 1;
|
||||
|
||||
for (x = xbegin; x != xend; x += xinc) {
|
||||
for (int i=0; i < 8; i++) {
|
||||
// fetch 8 pixels from the image, 1 for each pin
|
||||
pixel[i] = colorWiring(image.pixels[x]);
|
||||
}
|
||||
// convert 8 pixels to 24 bytes
|
||||
for (mask = 0x800000; mask != 0; mask >>= 1) {
|
||||
byte b = 0;
|
||||
for (int i=0; i < 8; i++) {
|
||||
if ((pixel[i] & mask) != 0) b |= (1 << i);
|
||||
}
|
||||
data[offset++] = b;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// translate the 24 bit color from RGB to the actual
|
||||
// order used by the LED wiring. GRB is the most common.
|
||||
int colorWiring(int c) {
|
||||
int red = (c & 0xFF0000) >> 16;
|
||||
int green = (c & 0x00FF00) >> 8;
|
||||
int blue = (c & 0x0000FF);
|
||||
red = gammatable[red];
|
||||
green = gammatable[green];
|
||||
blue = gammatable[blue];
|
||||
return (green << 16) | (red << 8) | (blue); // GRB - most common wiring
|
||||
}
|
||||
|
||||
// ask a Teensy board for its LED configuration, and set up the info for it.
|
||||
void serialConfigure(String portName) {
|
||||
try {
|
||||
ledSerial = new Serial(this, portName);
|
||||
if (ledSerial == null) throw new NullPointerException();
|
||||
ledSerial.write('?');
|
||||
} catch (Throwable e) {
|
||||
println("Serial port " + portName + " does not exist or is non-functional");
|
||||
errorCount++;
|
||||
return;
|
||||
}
|
||||
delay(50);
|
||||
String line = ledSerial.readStringUntil(10);
|
||||
if (line == null) {
|
||||
println("Serial port " + portName + " is not responding.");
|
||||
println("Is it really a Teensy 3.0 running VideoDisplay?");
|
||||
errorCount++;
|
||||
return;
|
||||
}
|
||||
println(line);
|
||||
String param[] = line.split(",");
|
||||
if (param.length != 12) {
|
||||
println("Error: port " + portName + " did not respond to LED config query");
|
||||
errorCount++;
|
||||
return;
|
||||
}
|
||||
// only store the info and increase numPorts if Teensy responds properly
|
||||
ledImage = new PImage(Integer.parseInt(param[0]), Integer.parseInt(param[1]), RGB);
|
||||
ledArea = new Rectangle(Integer.parseInt(param[5]), Integer.parseInt(param[6]),
|
||||
Integer.parseInt(param[7]), Integer.parseInt(param[8]));
|
||||
}
|
||||
|
||||
// draw runs every time the screen is redrawn - show the movie...
|
||||
void draw() {
|
||||
image(img, 0, 0);
|
||||
framerate = 30.0;
|
||||
byte[] ledData = new byte[(img.width * img.height * 24) + 3];
|
||||
image2data(img, ledData);
|
||||
ledData[0] = '*'; // first Teensy is the frame sync master
|
||||
int usec = (int)((1000000.0 / framerate) * 0.75);
|
||||
ledData[1] = (byte)(usec); // request the frame sync pulse
|
||||
ledData[2] = (byte)(usec >> 8); // at 75% of the frame time
|
||||
ledSerial.write(ledData);
|
||||
}
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 170 B |
Loading…
Reference in New Issue