Introduction: 3x3x3 LED Cube With Arduino Lib

Picture of 3x3x3 LED Cube With Arduino Lib

There are other Instructables about building LED cubes, this one is different for several reasons:

1. It's built with a low number of off-the-shelf components and hooks up directly to the Arduino.
2. A clear, easy to reproduce circuit diagram is provided with plenty of photos.
3. A unique approach is used for the software which makes programming the cube easier and more expressive.

Parts needed:

-   1 Perfboard
-   3 NPN Transistors (2N2222, 2N3904, BC547, etc.)
- 12 Resistors (~220 ohms and ~10k ohms)
- 13 Headers (male or female)
- 27 LEDs
- Wire

Step 1: Prepare the LEDs

Picture of Prepare the LEDs

This step largely follows the LED Cube 4x4x4 but we'll be building a 3x3x3 cube instead. A cube of this size is about as big as it gets without introducing additional circuitry and complexity. We'll need a total of 27 LEDs that will be grouped into three sets of nine.

Each set of nine LEDs will share a common connection amongst their cathodes (negative leads). I'll refer to each of these sets as a "level". Each of the nine LEDs on a level is connected to the corresponding LED on the other two levels through their anodes (positive leads). These will be referred to as "columns". If that didn't make sense it will become self explanatory as we build the cube.

To start we'll use a drill to create a jig out of a small piece of scrap wood. The jig will hold the LEDs in place while we solder them. I decided to space the holes around 5/8 of an inch apart (~15 mm) but the exact distance isn't critical. The hole should have a tight fit around the LED since we don't want them to move around while soldering.

Once the jig is done we're going to bend the cathode of each LED in a 90 degree angle. The cathode is identifiable in three ways: 1) It's the shorter leg, 2) It's on the flat side of a round LED, 3) it's connected to the larger piece inside the LED. Make sure you bend the cathode in the same direction for all of the LEDs.

Now we're ready to begin soldering.

Step 2: Solder the LEDs

Picture of Solder the LEDs

First place nine of the LEDs in your newly built jig. Position them so that the legs point in the same counter-clockwise direction. The photos show the cathode pointing clockwise with the anode facing out, but I'd turn the LEDs around if I did it again in order to keep the leg from obstructing the view of the LED.

Solder the sides together, one pair on each side. Use small clips to keep the legs clamped together while applying the solder.

Once each of the four sides are soldered, move the clips to hold the corners together and apply solder to each. Lastly, solder the cathode of the middle LED to one of the sides and trim away the excess.

Repeat three times.

You should now have three sets of nine LEDs. Position two of the sets one on top of the other. Keep the distance equal to the spacing already established between LEDs. Once you're comfortable with the spacing you can clamp each set of legs using two clips, one in each direction, to keep the legs firmly in place while soldering. You may need to bend around a LED to get a good connection. Solder each of the nine pairs, one at a time.

Do this one more time and you're done with the cube.

Place the cube on one side of the the perfboard. Make sure the nine legs are positioned apart evenly while you guide each one through a hole. My board has five holes between each set of legs. You want to leave as much room as possible on the other end of the perfboard to fit the various components.

Add a few clips to hold the legs in place once you're happy with the positioning. Leave plenty of leg poking through the bottom since this will make it easier to solder the resistors later. Turn the board over and solder each of the legs to keep them in place. Flip the cube back over once all the legs have been soldered.

Lastly we need to solder a lead from each of the levels down through the bottom of the board. Strip a piece of solid wire and bend a small hook on one end. Hang the hook on one of the center LEDs legs and guide it through a hole on the perfboard. Solder the hook end to keep the wire in place. Repeat again for the other two levels.

The next step is to build the rest of the circuit.

Step 3: Build the Circuit

Picture of Build the Circuit

The circuit is pretty simple. Each of the nine columns will connect to a pin on the Arduino through a current limiting resistor. Each of the three levels connects to ground via a NPN transistor when activated by an Arduino pin.

We'll be using 12 output pins total on the Arduino but there are 18 LEDs to power. The trick is that only a single level can be lit at a time. When a level is connected to ground, each of the LEDs on that level can be powered individually through one of the nine other Arduino pins. If we light the levels fast enough it will appear as if all three levels are lit at the same time.

Let's build the circuit.

The first step is to prepare the nine current limiting resistors. I'm using 220 ohms per pin which will draw around 22mA. The value may vary depending on the LEDs that are being used but stay between about 135 and 470 ohms. Each pin is capable of sourcing up to 40mA.

In order to save room we want to solder the resistors in a vertical position. Bend one lead down so that both leads are parallel to each other. Do this for all nine of the resistors.

Once the resistors are ready we'll solder them one by one. To make it easy we're going to solder the resistor leads directly to the other components instead of using a separate wire for each. One end of the resistor will connect to a column and the other will connect to a header. Start with the first row of LEDs which is closest to the resistors and work your way back.

Once each row is finished you can use a small piece of tape to isolate the overlapping leads in order to prevent a short. Refer to the photos and diagram to see what this will look like once it's finished.

Now that the columns are out of the way, the next step is to solder the components which control the levels. The base of a NPN transistor will be activated by an Arduino pin through a current limiting resistor of 10k (or thereabouts). This will connect the corresponding level to ground which will allow current to flow through the LEDs. Refer to the photos and diagram.

Once complete the LEDs should connect to pins 2-10 on the Arduino and the levels should connect to pins 11-13, bottom to top. The pins are also configurable in the software if you need a different setup.

The circuit is now complete, time to move on to the software!

Step 4: Using the Software

Picture of Using the Software

I found a few code examples floating around the 'net for controlling an LED cube. They all required large arrays of binary or hex data to control the LEDs. I figured there must be an easier way so I set out to write my own software.

My first decision was to make the software mirror the hardware. That meant addressing each LED by column and level instead of using raw port data or the traditional x, y, z. The second decision was to start with basic functions, like turning a single light on or off, and building up from there.

Lastly I decided to introduce two features which are useful for more interesting effects. One is a buffer which allows the basic functions to build up more complex patterns. The other is a sequence function which lights an array of LEDs one at a time, or all at once.

The library started as procedural code and loose functions. From there it was very easy to follow the tutorial to create a reusable Arduino library.

Be sure to download the library and unzip it to sketchbook/libraries. If set up correctly you should find an example in the Arduino software under File > Examples > LedCube > ledcube.

The code is also available on Github at gzip/arduino-ledcube.

Thanks for reading!


stringstretcher (author)2014-11-12

In your README file you state you have recently introduced an online UI for programming these routines... any link? I still love mine.

gzip (author)stringstretcher2014-11-12

The link in the readme leads to another link. As you can see, the UI is based on your Instructable and is modified to work with this cube. :)

stringstretcher (author)gzip2014-11-18

Got it! Thanks! Great job programming this. I showed mine today at a gathering of librarians who are interested in Arduino projects. Always gets a "wow!"

daniel_bisegna made it! (author)2017-03-18

I was so excited when it actually worked first go!

Thanks for a great build!!

haneek (author)2016-12-18

here is my cube :) nice colors dancing to nice music :)

hackchip made it! (author)2014-11-21

Thank you for the instructable! I was able to make an awesome working cube, and uploaded your library without a hitch. However, I was playing with the new web UI, and I keep getting the following errors when trying to upload the example to the Arduino. I have copied and pasted the entire example at the url below into a new sketch, and I still get these errors:

ledcube.pde: In function 'void loop()':

ledcube:49: error: 'cubeFrame' was not declared in this scope

ledcube:49: error: 'f' was not declared in this scope

ledcube:49: error: expected primary-expression before ']' token

ledcube:49: error: expected primary-expression before '{' token

ledcube:49: error: expected `;' before '{' token

ledcube:196: error: expected `}' at end of input


Any suggestions?

MalindaW3 (author)hackchip2016-11-24

thnks bro

gzip (author)hackchip2014-11-22

Hi hackchip. It sounds like you may be using the new example from github with the old library from the zip file. But aside from that I still got a different compiler error with the latest Arduino IDE (it's been a while since I last compiled this). I committed a fix for that just now and created a new zip. Try downloading the library again in step 4 and let me know how it goes. Thanks for the report.

hackchip (author)gzip2014-12-13

Thank you! Works perfectly now. I made a beat detector circuit and am now trying to integrate the two. This is too much fun :)

mmaitlen made it! (author)2016-10-08

Can't believe it worked as soon as I plugged it in and loaded software! Put transistors on breadboard for v1 since this was my first go at any major soldering. Wasn't convinced it was even going to work with my crazy soldering job. Thanks for the helpful tutorial!! Been wanted to have a go at an LED cube for ages.

frodesto made it! (author)2016-05-19

Works! I had great fun building this.

Thanks for great instructions and code!

AndriyM1 made it! (author)2016-03-17

Great project! Thanks for the code! I fit everything on a smaller (19x19 holes) perfboard.

IgorS20 (author)2015-11-19

hi i saw one build in witch the guy said it would be ok not to use the transistor can i do it here, can someone respond please!

gzip (author)IgorS202015-11-19

The transistors are required to light one level at a time. They are not optional.

JeffersonN1 made it! (author)2015-10-13

A bit messy with all those wires, but it's done!

1e1e19 (author)2015-08-05

Can somebody tell me which pin i have to connect with which pin on the arduino

cybermanrobot (author)2015-07-01

Great tutorial.

For the "Lights Out" function, has anyone experienced the following symptoms?

+ Constant flicker when the LED is on.

+ Only 3/4 of the LED go off before the function resets back to a full cube.

If so, any thoughts on the the cause and/or tweaks to fix?


Arduino IDE v.1.6.5; Windows 8.1, Mini Pro 5V; Experience: White Belt :)

osama.negm.35 (author)2015-04-26

How can I solve this Error:

ledcube.pde: In function 'void loop()':
ledcube.pde:49:57: error: taking address of temporary array
ledcube.pde:50:57: error: taking address of temporary array
ledcube.pde:51:57: error: taking address of temporary array
ledcube.pde:52:57: error: taking address of temporary array
ledcube.pde:53:57: error: taking address of temporary array
ledcube.pde:54:57: error: taking address of temporary array
ledcube.pde:55:57: error: taking address of temporary array
ledcube.pde:56:57: error: taking address of temporary array
Error compiling.

holidayv made it! (author)2015-04-19

I used an Arduino pro mini. The acrylic case is the package from an HDMX speaker.

sajoldas (author)2015-03-19

my upper two lavel is not so much light. and down level number nine led is not so much light.

NolanH2 (author)2015-02-09

I downloaded your code and library. I enjoyed the soldering but these errors come up when I compile the example given:

ledcube:15: error: 'LedCube' does not name a type
ledcube.pde: In function 'void loop()':
ledcube:49: error: 'cubeFrame' was not declared in this scope
ledcube:49: error: 'f' was not declared in this scope
ledcube:49: error: expected primary-expression before ']' token
ledcube:49: error: expected primary-expression before '{' token
ledcube:49: error: expected `;' before '{' token
ledcube:196: error: expected `}' at end of input

NolanH2 (author)NolanH22015-02-09

Nevermind! I found that the library had an invalid name, just a simple matter of renaming it. Perhaps its my version of the IDE or the Windows 8 it runs on.

achawla5 (author)NolanH22015-03-13

Hi,there could please give the answer step by step as i am really new to this . Would appriciate the help.

jackjackboom (author)2012-07-20

What is the color code on the 220 ohm resistors? I'm short on cash and am trying to harvest a couple from any electronics I can find.

BoneS4 (author)jackjackboom2015-02-10

also it is Red Red Brown

gold is +- 5%

ysadki2 (author)2015-01-27

that's my erreur :( help pleaz

fforoni (author)2014-01-04

I did it! It took me about 5 hours to build everything (more some extra hours to buy the NPN transistors that I missed).

Instead of green diffused LEDs I used non-diffused red ones and I think that diffused LEDs is the way to go. Instead of spacing 15mm I spaced 25mm and made it bigger than yours.

My next project is a 4x4x4 LED Cube using 3mm diffused LEDs. Maybe i'll post a step-by-step here on Instructables.

eshan.wells (author)fforoni2015-01-27

Please do! I understand that bigger is much harder, even by 1 in each direction.

eshan.wells (author)2015-01-27

So when exporting the code, which option do i choose? Height depth width, or depth height width?

I intend on making this, and i look forward to seeing the end result!

J.W.N.R. made it! (author)2015-01-21

Thanks for the very explanatory instructable. I recently build it (very poorly (despite the good explanations)), and it works great. But when all the LEDs were lid, i thought it looked very flickering - i also thought it would be impossible to notice the latches at all - so i took a high speed picture of the cube, and discovered that only one LED is lit at a time. I thought the latches would cause one whole layer to be lit at a time, shifting between the three - not just one LED?
I'm not that good with codes yet, so i can't identify the spot, which causes this.

The first picture is 1/10 s, while the second is 1/4000 s (sorry about the total darkness).

gzip (author)J.W.N.R.2015-01-21

You're correct that the LEDs are lit one at a time. There's no latch involved though. One reason for the flicker is that most of the methods call lightSequence, which in turn calls lightPulse (on then off).

The code could probably be rearranged to light an entire level at a time by activating each column pin first (and leaving them in that state) then enabling the transistor pin; somewhat like the latch you describe.

Some flicker would still remain between levels but it could be further reduced through direct port manipulation rather than go through the Arduino API (which performs a lot of extra logic).

J.W.N.R. (author)gzip2015-01-22

Thanks for the answer. That explains it all, then. Still have a hole lot to learn.

SamihaS (author)2015-01-19

I am completely new to arduino and even with the given code, I am unable to upload and run it. Some help would be appreciated!

SamihaS (author)SamihaS2015-01-20

Arduino: 1.5.8 (Windows 7), Board: "Arduino Uno"

C:\Users\Samiha\AppData\Local\Temp\build3058240577403485459.tmp/core.a(main.cpp.o): In function `main':

C:\Program Files (x86)\Arduino\hardware\arduino\avr\cores\arduino/main.cpp:40: undefined reference to `setup'

C:\Program Files (x86)\Arduino\hardware\arduino\avr\cores\arduino/main.cpp:43: undefined reference to `loop'

collect2: error: ld returned 1 exit status

Error compiling.

bossingb (author)2014-12-02

got it.. thnx... took me a day to figure out the errors produce by the Arduino IDE. I don't know if i am the only one experiencing about the code not compiling. this what i did and solve the problem.

1.) after downloading the code from github, extract it.

2.) Copy only the libraries (Ledcube.h and the other files) and paste it inside the library of your arduino.

3.) copy the Example folder from the extracted downloaded file. and paste it in your documents.

4.) now open Arduino IDE and goto file and click open. Locate and open the Example folder of Ledcube then click the code.

thats it,,, it runs on me after different trials and errors.

stringstretcher (author)2014-11-19

One more update: I have added a 10 position rotary switch on analog 0 using switchCase that lets me select which routine to run, like a channel selector. Makes things interactive, always fun for visitors. Now I can create a series of sequences using your editor and select one to run over and over, or run the entire combination of sequences. Next I will try different ways of selecting the sequence, using different sensors.

gzip (author)stringstretcher2014-11-19

Nice touch with interactivity! Keep us posted with the results of different sensors.

TerrenceJ (author)2014-09-05

G'day, made this little 3x3x3 led cube today and thanks to you guys it worked perfectly first try, I did change it a bit but only on the circuit side and I used little high speed transistors to carry all the LED current so the UNO only switched the transistors, just wanted to play with the transistors as well, no other reason really. Anyway thanks to all on this site.

krezia made it! (author)2014-03-16

Thanks for the tutorial. Worked from the start :) I thought it will be fun to use LED in RGB color grid to make it look funnier :)

Andrew Reardon (author)2014-01-05

Thanks! It looks so cool!

baitun (author)2013-11-01

This library doesn't work for 4x4x4 cube.

cheesecurd1899 (author)2013-10-28

I was wondering if you could review my code, I am having a problem.

inmanster (author)2013-09-20

Been planing on making a LED cube for a while. Saw you guide here and I already had a 5x5 jig I had made, all the components and an extra Uno laying around so I followed your build and have an awesome little LED cube. I'm going to play around in the library a bit and try some new patterns.Thank you for sharing.

I may upgrade this one to a 4x4x4 or just go big and do a 8x8x8.

K5J5MTO (author)2013-08-05

This is my first project.I fallowed the steps but I could make it light up.I am using the arduino uno and one layer green leds,one layer blue leds and one layer red leds and I am using the same parts like in the schematic.The example in the library in compile uploading to arduino board but nothing.Do I have to make some changes to arduino in the settings?

mastelios (author)2013-08-04

Nice instructable! just did mine! now for the bigger one..
Thumbs up!

Pog49 (author)2013-05-24

Hi, Nice instructable! I have used it to build a 3x3x3 cube successfully!
My question is: Can I use this method to build an 8x8x8 cube as well?

TheNickmaster21 (author)Pog492013-07-25

You'd have to use shift registers to increase the outputs of your Arduino. You also would need to make sure your pnp transistors could hold the current of 64 LEDs at one time.

whiskey_14 (author)2013-06-23

thanks for this!
it took about 3hrs and an extra hour trying to solder wire strands onto headers, this was one of those times you wish you'd have three hands. :)

ironheartbj18 (author)2013-05-19

download gzip frist then unzip file attached to any verison arduino/libraries click extract all file after that then you will have to same thing file as EEPROM, ENTERNET, etc. for example go to eeprom there have four file which are eeprom.h, eeprom cpp, keyboard.txt, and example that are in your in your sketch already it will showing orange letter. the ledcube does not name a type because it does not exist in your libraries. so you will have to make new folder move four files into ledcube folder.

About This Instructable




More by gzip:IR Receiver for Infrared CaptureSimple Animatronics with Servos and Arduino3x3x3 LED Cube with Arduino Lib
Add instructable to: