Streaming

Streaming allows you to send images from your PC over the Teensy's serial USB connection using any software that uses the TPM2 protocol. Aurora will automatically display content when streaming starts from the PC.

Compatible software includes Jinx!, PixelController, and Glediator.

Jinx!

For Jinx!, the graphical configuration is pretty self-explanatory, but the trick is that after you add your tpm2 serial device, you have to go to Output Patch and map all the pixels onto the device. Once you do that, choose "Start Output" from the setup window and it should start sending to the SmartMatrix. Jinx is Windows only and closed source but it really is easier to use and has better effects than PixelController.

PixelController

For PixelController, you can start with this configuration file, but change the line that starts with tpm2.device to use your serial port.

Glediator

Glediator is more difficult to get working as it requires a Java Native Library called RXTX for interacting with the serial port. It also is less stable than the other options, possibly related to the RXTX dependency. It's not easy to get this installed but you can try following these instructions:

First, run Glediator from the command line so you can see errors. e.g. java -jar glediator_V2.jar You should see either errors or warnings related to RXTX

Download rxtx-2.2pre2-bins.zip from http://rxtx.qbang.org/wiki/index.php/Download

Copy RXTXcomm.jar to the Glediator/dist/lib directory replacing the existing .jar. Copy the dll (Windows) or jnlib (Mac) to the Glediator/dist directory

Run from the commandline again. You should get a RXTX mismatch error (this is expected, see the note on the rxtx.qbang.org download page). If you get another error, you may have another version of rxtx somewhere else in your path (e.g. windows/system32). Delete that so the local library is used.

On the Mac Glediator segfaults on Serial Close. The current workaround is to unplug USB, then press Serial Close, then reconnect the cable.

Glediator may become unresponsive if Aurora doesn't respond during connecting, for example if the sketch isn't in a mode where streaming is possible.

You may want to try this version if using Windows as it seems to come from a stable 2.2 release instead of prerelease. http://mfizz.com/oss/rxtx-for-java

Output Options that work with Aurora:

• TPM2
• Single Pixels
• HL_TL
• RGB
• Baudrate can be 115200, or 230400 on the Mac (maybe higher on Windows)