Update README.md
[miniband.git] / README.md
index 2d0069f2f0e291db7d1020b580d72337bb9ce2c8..8b77b6ed330895eb8c518be369d27a23c4fed346 100644 (file)
--- a/README.md
+++ b/README.md
@@ -23,6 +23,9 @@ Learn how to build circuits with sensors and outputs and write a simple programm
 * Card
 * Sugru (or some other modelling material)
 * Electrical tape
+* Plastic drinking straw
+* Pencil
+* Coloured pens (optional)
 
 
 ## Software requirements:
@@ -31,6 +34,25 @@ Learn how to build circuits with sensors and outputs and write a simple programm
 * IDE developer environment for Arduino
 * Py Serial library
 
+
+## Useful links:
+
+* [Pictures](http://bit.ly/codeclubminiband) 
+* [Ardunio code](https://github.com/KatJoyWhite/miniband/tree/master/arduino)
+
+
+
+## Pull-down Resistors
+
+You’ll find your analogue inputs receive signal when you don’t expect them to.
+This is because there’s electricty floating around in the system, or something like that.
+
+To fix this, you need to wire each input to ground, through a 10KΩ resistor.
+
+A better explanation can be found [here](http://arduino.cc/en/Tutorial/DigitalPins).
+
+
+
 ## Drum Kit
 
 ### 1. Make your drums
@@ -47,7 +69,12 @@ Repeat for each of your drums. It is easiest to use a bread board for making you
 Look at the picture for an example.
 
 
-### 3. Set up in Scratch 
+### 3. Program the Arduino
+
+Find the appropriate code from the respository and upload to your Ardunio board.
+
+
+### 4. Set up in Scratch 
 
 Find four different drum sounds (or whatever sounds you'd like your drums to make!). Upload the sounds to Scratch.
 
@@ -64,24 +91,61 @@ Tape a pencil or stick to the back of the guitar to make it stiffen the fret boa
 
 ### 2. Connect the circuit
 
-The strip just adjusts resistance, so you will need to feed it some electricity.
+The potentiomater strip adjusts resistance, so you will need to feed it some electricity.
 Run +5V into one of the strip’s outer pins, and ground into the other outer pin.
 It doesn’t matter which way around you connect these, but it will affect which the direction
 the fretboard runs (high and the top, low at the bottom or vice-versa).
 
 Signal will come from the centre pin, so connect that to one of your analogue inputs and you should be good to go.
 
-### 3. Set up in Scratch
 
+### 3. Program the Arduino
+
+Find the appropriate code from the respository and upload to your Ardunio board.
+
+
+### 4. Set up in Scratch
+
+Find five different guitar sounds and upload to Scratch.
 
 
 ## Maracas
 
-## Pull-down Resistors
+### 1. Make your maracas
 
-You’ll find your analogue inputs receive signal when you don’t expect them to.
-This is because there’s electricty floating around in the system, or something like that.
+Cut 2 short lengths of drinking straw for your maraca handles. 
+Using Sugru (or other modelling material), make 2 maraca heads by rolling it up into balls.
+Push the maraca heads onto the straws and mold into a maraca shape.
+Connect lengths of wire to the connectors of the 2 tilt sensors and then push each sensor into a straw until it presses into the Sugru.
+Leave the Sugru to set.
 
-To fix this, you need to wire each input to ground, through a 10KΩ resistor.
 
-A better explanation can be found [here](http://arduino.cc/en/Tutorial/DigitalPins).
+### 2. Connect the circuit
+
+Connect the +5V port on the Arduino board to one of the pins on the tilt switch (it doesn't matter which way round).
+Connect the other pin to an empty digital input on the board. 
+
+
+### 3. Program the Arduino
+
+Find the appropriate code from the respository and upload to your Ardunio board.
+
+
+### 4. Set up in Scratch
+
+Find a maraca / shaker sound and upload to Scratch.
+
+
+## Python glueware
+
+Download the music-maker-hander.py file from the repository. Run it with
+ python music-maker-handler.py
+This program sets up a listener for each instrument. When it detects that an instrument has been played, it sends a couple of signals to Scratch.
+The first signal appears in Scratch as a sensor value and is the volume (for drums), pitch (for the guitar), or ignored (for the maracas).
+The second signal is a broadcast message that makes Scratch play the sound in the instrument.
+
+
+## Scratch front end
+
+The Scratch file, music-maker, makes the sounds. It responds to the signals from the Python handler above by playing the appropriate sounds. It also does some visual feedback for the insturments. 
+