Skip to content

pr1metine/DotMatrixJava

 
 

Repository files navigation

8x8x8 Led Cube control program

PC control program for generic 8x8x8 3D LED Cube found on eBay (e.g. 3D LightSquared 8x8x8 LED Cube DIY kit, ideasoft, etc.)

Program view

  • Written in Java (requires Java RE, download here: http://java.com)
  • Supports direct animation playback through Serial/UART interface (rxtx library)
  • Various GUI usability enhancements
Firmware

This program can control any packet format compatible LED cube (see below). Example firmware of a compatible LED cube with an STC12C5A60S2 MCU can be found here: Source Code

Using the program
  1. Download either DotMatrixJava.tar or DotMatrixJava.zip depending on your personal preferences
  2. Unzip the downloaded archive
  3. cd into the unzipped archive to DotMatrixJava/bin
  4. Run the binary corresponding to your OS

Check this YouTube video for example: https://youtu.be/UplJi7pdV_Y Using program

LED Cube control packet format

8x8x8 LED Cubes that support below packet format can be controlled with the program via Serial console or other MCU such as an Atmega/Arduino. Example UART/Serial packet (in hex):

F2
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
00 00 00 00 00 00 00 FF
  • F2 - denotes packet header (aka. batch update)
  • next 64 bytes - (8x8x8 bits) of LED light states
    • one byte - controls a LED row (8 LEDs)
    • can be any value in range: 00-FF (i.e. 00 - all 8 LEDs in row are off, FF - all 8 LEDs are on)
    • a single line (e.g. 00 00 00 00 00 00 00 FF) denotes a 64 LED layer

Implementation note: to save energy/current consumption only a single layer (64 LEDs) in a LED cube is ON at one time. This is done for all layers and so fast (using a hardware timer), that the human eye does not recognize this. This hack allows to view the cube (all layers) as fully lit.

About

Java 8x8x8 ledcube control software

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Java 98.4%
  • C++ 1.6%