En:MaKey MaKey Quickstart Guide
Welcome to the world of MaKey MaKey! A world where every day objects are much more than what they appear. Bananas are more than just a curvy fruit - they’re keys to a virtual piano. Play-dough isn’t just a tasty 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 every day objects in a whole new light. Be stoked! The world is your construction kit.
Covered in This Tutorial
This tutorial’s purpose is to help get you up and running with the MaKey MaKey – everything from what the board is, to installing it, to using it. Sections are split into pages, covering the following topics:
- What is the MaKey MaKey? – What’s what on the MaKey MaKey board?
- Installing the MaKey MaKey – How to connect the board, and install it. Extra focus on Windows, which requires a driver be installed.
- Making Your First Key – How to use banana cables to create your first MaKey MaKey button.
- Resources and Going Further – Links to inspire and educate.
What is the MaKey MaKey?
The MaKey MaKey is a collaborative project between Jay Silver and Eric Rosenbaum of the MIT Media Lab, and us here at SparkFun Electronics. It’s an invention kit that encourages people to find creative ways to interact with their computers, by using every day 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.
It’s a Mouse/Keyboard
The MaKey MaKey is a two-sided circuit board. On the more simple, top side, the MaKey MaKey has 6-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.
When you flip the board over, you’ve got access to 12 more keys: W, A, S, D, F, and G on the keyboard side, and up/down/left/right mouse movement and left/right clicks on the mouse side. The bottom header has six ground (aka Earth) outputs, while the top header is an expansion/output header. There are also a few LEDs on the back to indicate whether you’re pressing a mouse or keyboard key.
The pins on the back side are all available in the form of “jumper-wire” connectors. If you bought the deluxe kit, you’ll already have the jumper wires needed, otherwise you can buy them separately here.
It’s an Arduino
As I mentioned before, what makes the MaKey MaKey extra-awesome is the fact that it’s completely Arduino-compatible.
Arduino is a super-popular electronics development platform. In essence, it’s a tiny, little programmable computer, with seemingly infinite uses, that’s been adopted as the go-to electronics platform for artists and electronics veterans alike.
What’s made Arduino so popular, though, is the fact that it’s a lot more than just a board full of electronics. It’s a well-documented programming environment. It’s a huge electronics and programming resource manual. And, most importantly, it’s a community full of both budding electronics-addicts, and helpful EE know-it-alls.
But, I digress. Basically, the MaKey MaKey’s Arduino-ness, means that you can easily reprogram it to work just exactly how you want. Do you need to replace W, A, S, D, F and G with Q, W, E, R, T, and Y? You’re about six lines of easy code edits, and one button click away from that quick fix!
Making Your First Key
The most simple MaKey MaKey key you can make is one that only uses your fingers. Try touching the Earth bar while simultaneously touching the space circle 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!
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 top side, or jumper wires on the bottom.
- 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, of course, are 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, your coin purse, or grab a pencil and make a drawing.
Pick out your favorite-colored alligator clip cable, open one of the jaws, and snap it down onto your key. And clip the other end of the clip into one of the MaKey MaKey top-side inputs. SPACE is great for testing purposes:
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. Remember that, just as with your boring ol' keyboard, your computer will interpret keypresses differently depending on what program is active.
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!
Adding More Keys, Using the Back
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.
Want to make use of the back side of the board? You can follow a similar set of steps, replacing alligator cables with jumper wires. Jumper wires are a bit tougher to connect to keys. An easy solution is to connect an alligator cable to the free end of the jumper.
Play-doh, or other materials which enable you to jab the jumper wire in also work great! How about a Play-doh Mouse:
(Hint: Get creative with the ground connection. In the example above, we connected ground to a penciled bar where we rested our hand.)
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), to create 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.
Adaptation of the tutorial MaKey MaKey Quickstart Guide by sparkfun available under Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) creative commons license.