Makey Makey Classic Hookup Guide
jimblom, 
bboyho Introduction
Welcome to the world of Makey Makey! A world where everyday objects are much more than they appear. Bananas are more than just a curvy fruit --- they're keys to a virtual piano. Play-Doh isn't just a child's toy --- it's the controlling force behind Pacman's up/down/left/right. And your simple pencil drawings are a portal to Portal.
Be prepared to look at everyday objects in a whole new light. Be stoked! The world is your construction kit.
Materials Required
- Makey Makey --- The star of the show! The kit should already include:
- Mini-USB Cable
- Alligator Clip Cables
- Tinned Tipped Wires
- A computer (Windows, Mac OS X, or Linux) with an Available USB Slot
- Software to Read Key Presses (e.g., Canabalt, Virtual Piano, Tetris, etc.)
- Button Material (e.g., fruit, Play-Doh, tin foil, copper tape, pencil, a friend)
- A Primed Imagination
Suggested Reading
What is a Circuit?
Voltage, Current, Resistance, and Ohm's Law
What is the Makey Makey?
The Makey Makey is a collaborative project between Jay Silver and Eric Rosenbaum of the MIT Media Lab and SparkFun Electronics. It's an invention kit that encourages people to find creative ways to interact with their computers by using everyday objects as a replacement for keyboards and mice. With the Makey Makey, you could replace your space key with a banana, use Play-Doh to move and click your mouse, or high-five your best friend to advance PowerPoint slides.
Hardware Overview
Top Side
The Makey Makey is a two-sided circuit board. On the more simple top side, the Makey Makey has six inputs: the up/down/left/right arrow keys, as well as the space bar and mouse left click:
Each of those inputs as well as the very important “Earth bar” are available in the form of what I like to call “alligator-bait” connectors. You'll use the included alligator clip cables to clip right into the hole pairs. This will all be made much more clear in the next section. For now, let's keep summarizing your Makey Makey.
If any key is activated with the "Earth Bar," an associated LED will light up next to the pad.
Back Side
When you flip the board over to the back side, you will notice a mini-B USB connector and POWER LED. The connector is where you will connect the USB cable to a computer. The LED will light up when the board is powered.
You've also got access to 12 more keys via the black female headers:
- W, A, S, D, F, and G on the keyboard side
- up/down/left/right mouse movement and left/right clicks on the mouse side
The bottom header has six additional ground (aka Earth) outputs.
The top header is an expansion/output header. They KEY OUT and MS OUT are connected to the LEDs on the back to indicate whether you're pressing a keyboard or mouse key, respectively. This can be used to connect low-power LEDs and small motors. The RESET will reset the board when connected to ground. There are also pins for power through the 5V and GND. The last two pins (PGD and PGC) are used by the factory to program.
The pins broken out through the black female headers are all available in the form of “jumper-wire” connectors to connect male jumper wires, header pins, stripped wires, or tinned tipped wires.
Hardware Hookup
The simplest Makey Makey key you can make is one that only uses your fingers. Below are instructions to make yourself into a key!
Connect a USB Cable
First, grab the mini-USB cable included with the Makey Makey and insert the cable into the connector. Connect the other end to a USB port of your computer.
Ignore Pop-up Windows
When you first insert the Makey Makey into your computer, a window may pop up. You can cancel or close out the window.
Connect Earth
Touch the Earth bar to ground yourself.
Connect Yourself
Simultaneously touch the SPACE pad. The LED above the SPACE key should light up, and a space command should be sent to your computer.
Now try leaving one finger on the Earth bar while quickly tapping the space button. Getting a feel for it? It should work just like your standard space key!
Testing With a Text Editor
Open up some sort of text editor (Notepad, Word, TextEdit, etc.) on your computer to confirm if the Makey Makey is sending a space to your computer. Remember, just as with your boring ol' keyboard, your computer will interpret keypresses differently depending on what program is active. You can also use your mouse to click between the words in the textbox shown below.
Online Apps for Makey Makey
Looking for some fun games to test out the Makey Makey? Click on the link below to try out the online apps provided by JoyLabz!
Making Your First Key
Makey Makey Key-Making Materials
To make your "standard" key with the Makey Makey you need the following:
- A connection to a Makey Makey input. This can be done using alligator clips on the the hole pairs, or jumper wires on the black connector sockets.
- Connection to a Makey Makey ground (Earth). Again, you'll connect to earth using either alligator clips or jumper wires.
- Some sort of key material. This is the fun/creative part! There's a world of Makey Makey keys out there. Anything that's even slightly conductive is just waiting to become a computer input. The classics include your fingers, bananas and pencil scratchings.
- Something to activate the key by connecting between the key material and the ground input. Your fingers work pretty well for this. Anything even slightly conductive will do, though.
Making a Key
Activating a key means creating a closed circuit. For the circuit to work, electrons have to be able to flow from the Makey Makey input key to Makey Makey's ground. Usually your fingers will be the missing link between those two:
Let's try making a bona fide Makey Makey key. First, you'll need to find some sort of key object. Dig around your house, check your fruit basket or coin purse, or grab a pencil and make a drawing to try it out.
Pick out your favorite-colored alligator clip cable, open one of the jaws, and snap it down onto your key. Clip the other end of the clip into one of the Makey Makey top-side inputs. SPACE is great for testing purposes, so we will start with that key pad:
Now, grab a second cable for the ground connection. Black is the classic "ground color", but set your own trend and pick whatever you want. Clip one end of one cable into the Earth bar and let the other end dangle for now.
Open up some sort of text editor (Notepad, Word, TextEdit, etc.) on your computer. Or you can click between the words in the test box provided below.
Finally! Grab the dangling end of the ground cable with one hand. Make sure you're touching the metal part of the clip. Then use your other hand to touch the banana, or whatever your key might be. BAM! Space!
Experimenting With Key Materials
Don't have a banana? Try experimenting with different materials. Some materials conduct better than others. Certain materials can also be conductive over a period of time. Try it out!
Below is an example of a hand-drawn key from a standard pencil. A dotted circle was drawn on two sides of a piece of paper and extended to the center. Lines of alternating lengths were drawn (short and long) from each extension with a gap between the lines so that one finger could be used as the key.
The first drawing with the thin lines labeled "Button 1" was a poor conductor on paper. However, the second drawing with the bold, thick lines labeled "Button 2" was able to conduct. In this case, the pencil was only able to conduct when there was enough of the material. After a few uses, the lines faded and required another layer of graphite.
Using the Back
Remember the black connectors on the other side of the board? There are additional keys that you can connect! You can follow a similar set of steps, replacing alligator cables with jumper wires. The wires included with the Makey Makey is one type of jumper wire. Jumper wires can be a bit tougher to connect to keys. An easy solution is to connect an alligator cable to the free end of the jumper.
Let's try it out. Insert one end of the tinned tipped wire fully into a socket. Connect the other end to a conductive material. You may need to use an alligator cable to extend and connect to the material. Repeat for the ground connection.
The example below is similar to the hand-drawn button. Strips of copper tape were used for "Button 3" instead of a pencil. Since the material is more conductive and thicker than the hand-drawn lines, only two stripes were used. Regular tape was used to secure the tinned ends of the wire against the paper and table. After a few uses, the copper fared better than the graphite pencil.
Adding More Keys!
To add more keys, simply connect another alligator clip to another Makey Makey input (e.g., arrow keys or mouse click) and connect the other end to a key material. No further ground connections are necessary as long as there is one available. Be creative and connect as many keys as you can to the Makey Makey!
What Makes a Key? Conductivity.
A material is a conductor if it allows electricity (even just a tiny bit of it) to flow. This is the magic behind the Makey Makey: most of the world is conductive! Anything metal will almost certainly conduct electricity. The "standard" conductors are copper, silver, gold, etc. But with the Makey Makey our conductor scope grows. Most organic materials --- things like human skin, liquids, foods and frog legs --- are at least a little conductive. And that's really all the Makey Makey needs.
If an object isn't conductive, it's an insulator. Common insulators include plastic, glass, ceramic and wood. You can usually tell just by looking at something whether it's an insulator or conductor. You'll have to watch out for objects like this, as they just won't work with the Makey Makey. To get around that, though, you can line them with a conductive material (like copper tape, or just regular old wire) or paint. This creates the illusion that they're conducting electricity.
Resistance is a measure of exactly how conductive a device is. Resistance can be measured with just about any standard multimeter. Any object with a resistance of about 4.5MΩ (that's a really high resistance) or less should work as a Makey Makey input. If you're not sure if something will work with the Makey Makey, whip out a multimeter (buy one if you have to; they're an essential tool for electronics hobbyists) and test that resistance! Or, better yet, just connect it to your Makey Makey and experiment.
Remapping Keys
The Makey Makey v1.2 Classic has an option if you ever need to change the default keys. To remap the key, you will need to go online and head over to JoyLabz using any internet browser. Click on the button below to open a new window.
Following the instructions provided by JoyLabz is pretty straightforward, but we also outlined the instructions below. By clicking on the link, it should have opened up a new tab or window. You will have two options. Click on the Makey Makey Classic.
The page will also time out if you take too long of a break. When this happens, you will need to start at the beginning.
Once selected, the prompt will ask you to check and ensure that you have the correct Makey Makey version. On the back side with the black female headers, you will notice that the board has a version number printed as v.1.2 If you do not have that version, you will not be able to remap the keys with these instructions. If it is v.1.2, proceed by connecting the Mini-USB cable to the Makey Makey and clicking on the START button. For now, do not connect the other end to your computer's USB port.
Grab two alligator clips and connect the up (↑) and down (↓) arrows together. Then connect the left (←) and right (→) arrows. Once connected, connect the other end of the USB cable to your computer's USB port. You will notice the green LEDs begin to fade in and out, indicating that the Makey Makey is in programming mode.
The browser will eventually respond with a note indicating that the Makey Makey is detected. If you do not see the message, you may need to unplug the USB cable from your computer and start again. Also, make sure that the browser to remap keys is active. Otherwise, follow the prompt by removing the alligator clips if the Makey Makey is in programming mode.
With one hand, ground yourself by touching the exposed GND pads. With the other hand, touch the left or right keys to navigate to the key that you are interested in remapping.
The key that will be remapped will be highlighted yellow. Let's remap the left mouse "CLICK" on the Makey Makey. Navigate to the left mouse "CLICK" button. Once selected, keep one hand on GND and touch the "CLICK" pad to remap the key.
The key that is being remapped will be highlighted green. The replacement key will be highlighted yellow. At this point, you can select the replacement key located at the bottom of the browser. Navigate through the keys using the Makey Makey's arrow pads. Let's select the "enter" key by moving to its icon and touching the "CLICK" pad.
The browser will have a nice animation and replace the old key with a new key. At this point, you can continue to remap the other keys. For now, we will just remap one key.
Navigate to the SAVE button by pressing on the down pad. Here, you will be able to SAVE the remapped key, CANCEL any changes that you have made, or RESTORE the Makey Makey default keys. Let's save the remapped key by pressing on the "CLICK" pad.
A prompt will pop up asking you to confirm the save. Use the left arrow pad to highlight "YES". Click on the "CLICK" pad to confirm.
 |
 |
The settings will save and you will be greeted with a "SUCCESS!"
Troubleshooting
Not working as expected? Check out the Troubleshooting section for the Makey Makey v.1.2 Classic:
You may even want to check out their Frequently Asked Questions:
Resources and Going Further
If you're left with any questions after reading this tutorial, here are all the Makey Makey-related resources we can find:
- MakeyMakey.com --- The official home of Makey Makey
- The original Quick Start Guide
- Makey Makey Remap
- Online Apps for Makey Makey
- Gallery --- See what projects people have created in the community
- Educators
- Labz --- Classroom-related tutorials
- Guides --- Group activities
Example Projects
Sometimes following by example is the best way to learn. If you're not sure where to start with the Makey Makey, give these examples a look-over. I hope they inspire you! If you want your project added to this list, post it in the comments below, or send us an email!