A 3x3x3 LED cube, originally based on Paul Wilhelms project with USB and a lot of new features.

Thomas Kopp 05aebbd54b changing name ago%!(EXTRA string=3 years %!s(MISSING))
client Rebrand the whole thing :) ago%!(EXTRA string=3 years %!s(MISSING))
doc Add the reference card and the images ago%!(EXTRA string=3 years %!s(MISSING))
editor Port the editor to the new g_thread stuff ago%!(EXTRA string=3 years %!s(MISSING))
firmware changing name ago%!(EXTRA string=3 years %!s(MISSING))
pcb Bump the schematics from eagle 6 to eagle 7 ago%!(EXTRA string=3 years %!s(MISSING))
pcbracket Add the 6x PCB bracket 3D print ago%!(EXTRA string=3 years %!s(MISSING))
tools Small script fix. ago%!(EXTRA string=4 years %!s(MISSING))
.gitignore Add some stuff to .gitignore ago%!(EXTRA string=3 years %!s(MISSING))
Doxyfile Rebrand the whole thing :) ago%!(EXTRA string=3 years %!s(MISSING))
GFDL.txt License information added. ago%!(EXTRA string=6 years %!s(MISSING))
GPL.txt License information added. ago%!(EXTRA string=6 years %!s(MISSING))
LICENSE License information added. ago%!(EXTRA string=6 years %!s(MISSING))
README.md Added some hints ago%!(EXTRA string=3 years %!s(MISSING))

README.md

mini LED CUBE

A 3x3x3 LED cube, originally based on Paul Wilhelms project with USB and a lot of new features. An AVR (attiny2313) with V-USB (software USB stack) control a matrix of 3x3x3 LEDs which forms a 3D cube of LEDs. Every LED in this cube can be controlled independently over a simple protocol. Various tools (commandline-tool, 3D OpenGL editor) can be used to create animation sequences or simply use the cube as an XFD device.

pcb

Building

The project consists of two parts: The LED cube and the controller PCB. Both parts can be build completely separate but need to work together.

  • The Cube is a little bit tricky to solder. To see which wire need to be bend and solder in which direction, use the 3D STL model for reference. To see more detail, install OpenSCAD and load the threedvis.scad file.

  • For the PCB, there is a detailed instruction plan available. The instructions include soldering the parts, testing, flashing the firmware and setting the fuse bits. (Be careful, this file is for the through-hole version of the PCB)

Tools

  • The client lib is a simple interface for other software implementations. Have a look at the demo.c file how to include the lib into your own project.

  • A commandline client clcc can be used to control the cube interactively over the commandline. Various commands can be send to the cube, see the sourcecode for explanation.

  • The 3D OpenGL Editor is using the client lib mentioned above. The editor shows a 3D representation of the LED cube and can be moved with the cursor keys. All virtual LEDs can be clicked with the mouse to toggle it on or off.

  • To use the cube as a XFD (show number of mails in INBOX, finished tickets today, incoming phone call, number of missed chat messages in an IRC channel, ...) you can use the frame2cube.pl script to send a complete frame to the cube.