Sliicy / 8x8x8-LED

Project that can control an 8x8x8 LED matrix cube and display anything on it.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Project for controlling an 8x8x8 LED/RGB matrix cube over USB.

8x8x8 LED Logo

About this Project

This project was inspired by Tomazas' firmware for controlling 8x8x8 LED Cubes, as well as Aguegu's Java program used to control the cube in real-time.

This project consists of a series of mini applets that can be used to display various animations on both Monochrome and RGB cubes.

Video Demo RGB

8x8x8 RGB Cube


The following are some videos of various animations in action:

Music Visualizer

There are a bunch of different styles to choose from, each animating the cube based on music being played (some are briefly shown below via the Monochrome Cube).

Music Fire Music


You can type any message into the textbox, and the cube will continuously scroll the text into view.



This will display the current time on the cube.

Clock using RGB Cube Clock Demonstrating Standard Time

Pong Game

This will let you play the classic 'Pong Game' with a friend.

Clock Demonstrating Army Time

Image Viewer

This will let you open an image and project it onto the cube.

Circle Drawing a Circle Heart Smiley Face

Video Player

This will let you open an image and animate it onto the cube.

Clock Demonstrating Army Time

Rain Animation

This will display rain droplets.

Clock Demonstrating Army Time

Ball Animation

This will display bouncing balls (optionally syncable to music being played).

Clock Demonstrating Army Time

Not Pictured

  • Lamp - Lights up the cube at specified times (like a nightlight).
  • Lightning - Bolts of lightning travel around the cube sporatically.
  • Snake - Simple snake game.

How to Build

iCubeSmart 3D8-S-DIP board (Monochrome version)

How to Build for the iCubeSmart 3D8-S-DIP board (Monochrome version)

The schematic for the board I used can be found here. Rather than building the PCB and all, I simply purchased a ready-to-assemble board on Amazon.

  1. After purchasing and assembling the board, I connected TXD, RXD, and Ground (skipping 5V until later) to the USB to TTL adapter it shipped with, and used the STC program ( to flash the cube. My particular settings were as follows:
  • MCU Type: STC12C5A60S2
  • COM Port: Select the one that has CH340
  • Min Baud Rate: 9600
  • Max Baud Rate: 9600

STC Settings

  1. Press on 'Open Code File', and select the .hex or .ihx file to flash to the cube. I modified Tomazas' existing firmware to get it to work with my board, which can be downloaded here:
  2. Before continuing, I first clicked on 'Check MCU' just to make sure that the cube was properly being recognized. After clicking on the button, I connected 5V at this point, and then the board was recognized (MCU ID : D17EC59205195F, MCU type: STC12C5A60S2, F/W version: 7.1.4I).
  3. After confirming that the board was being read properly, I disconnected 5V again, and clicked on 'Download/Program', and then reconnected the 5V, to get the cube to flash the firmware.
  4. At this point, the cube should be flashed, and the cube should be able to talk to the program.

Note about using the iCubeSmart Monochrome Cube

Since I have a slightly different cube than the aformentioned cube in Tomazas' firmware, I had to fork my own version, and modify the firmware to get it to work. Here is a link to the project (I'm using the v2-sdcc-icubesmart). Just flash the .ihx file as a regular .hex using the STC flashing tool.

iCubeSmart 3D8RGB board (RGB version)

How to Build for the iCubeSmart 3D8RGB board (RGB version)

This cube's motherboard features a separately mounted yellow board, controlled by a GD32F103RET6 microcontroller (similar to the STM32 series).

There is a YouTube video that explains the process of setting up Arduino with the STM32:

  1. Install Arduino IDE
  2. Install STM32 Cube Programmer ( Arduino requires this installed to be able to flash to it.
  3. Add the following URL to Additional Board Manager URLs (File > Preferences):
  4. In Tools > Boards Manager, install the latest version of STM32 (2.1.0+)
  5. Open the "8x8x8_RGB_LED_iCubeSmart.ino"
  6. Select "Generic STM32F1 series" under Tools > Board
  7. Select "Generic F103RETx" under Tools > Board part number
  8. Select "STM32CubeProgrammer (Serial)" under Tools > Upload Method
  9. Beneath the 8x8x8 board (on the smaller yellow board), ensure the Download switch is set to 0 (Boot1=0), and the Run switch is set to 0 (Boot0=0)
  10. Power the cube with both the 5V 2A cable, as well as the 4 USB cables to the USB to TTL:
  • GND to GND
  • TXD to TXD
  • RXD to RXD
  • 5V to 5V
  • Jumper connecting both 3V3 and VCC
  1. Press Reset Button and then "Upload" in Arduino
  2. Toggle both switches on the yellow board so that the Download switch is set to 1 (Boot0=1) and Run switch is set to 1 (Boot1=1)
  3. The cube should now be ready for UART Serial Communication

How to Run

  1. Download the latest release here (it should say something like Extract the .zip file and run '8x8x8 LED.exe'.
  2. When opening the program the first time, head to the 2nd tab titled 'Settings', then the subsection 'Connection', and ensure the correct COM port is selected for the cube. This can be tested by disconnecting & reconnecting the cube from your PC, and watching which COM port populates.
  3. Make sure the appropriate cube type is selected (Monochrome or RGB).
  4. The Monochrome version uses a baud rate of 19,200 bps. The RGB version uses a baud rate of 2,000,000 bps. Both versions use 8 Data bits, 1 Stop bits, and no Parity.
  5. Next, press the 'Connect' button at the bottom of the window.
  6. If done correctly, there shouldn't be any error messages. You can also send a test packet in the 'Send Packet' subsection, to light up all the LEDs.
  7. Finally, you will want to ensure that the orientation is correct, so press the 'Calibrate Cube' button in the 'Rotation' subsection of Settings, to calibrate the cube.
  8. These connection settings are automatically saved. Once completed, head over to the 'Menu' tab, select an applet, open it, and enjoy!


I designed & 3D printed a custom bottom for the cube using Blender. It can be found here:

Future Development

Anyone is welcome to provide suggestions, improvements, changes, bugs found, etc.


Project that can control an 8x8x8 LED matrix cube and display anything on it.


Language:C# 90.2%Language:C++ 6.6%Language:C 3.1%Language:Batchfile 0.0%