Tweaked the Arduino code in the writeup
[miniband.git] / README.md
index ad6c2494e42e2f0021e01d327ac54ce5ee0eabbd..52e292afc72b36a336bcb907b849694f6150313f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,28 +1,37 @@
-# Code Club - Mini Band Project
+Code Club - Mini Band Project
+=============================
+
+<img src="http://farm9.staticflickr.com/8338/8256708023_4a941566e9.jpg" width="500" height="375" alt="photo (2)">
 
 Make your own mini band! 
 You and your friends can form your own finger-sized band and rock out using Raspberry Pi and Arduino. 
 Learn how to build circuits with sensors and outputs and write a simple programme to control your instruments.
 
+## Instructions
+
+The instructions are in the [writeup directory](https://github.com/NeilNjae/miniband/tree/master/writeup); you'll probably want the [instructions PDF](https://github.com/NeilNjae/miniband/tree/master/writeup/miniband.pdf). Code samples are in the [release directory](https://github.com/NeilNjae/miniband/tree/master/release).
+
 ## You will make:
 
 * A guitar
-* A keyboard
 * A set of drums
 * A pair of maracas
 
 ## You will need:
 
 * 1 x Raspberry Pi (plus monitor and power supply)
-* USB hub
-* 2 x Arduino Uno boards (with USB cables)
+* 1 x Arduino Uno boards (with USB cables)
 * 1 x strip potentiometer
 * 2 x tilt sensors
 * 4 x piezo buzzers (the type in greetings cards, easy to get from Maplin)
-* 10K resistors
+* 7 × 10K resistors
 * Bread boards (1 per instrument)
 * Card
 * Sugru (or some other modelling material)
+* Electrical tape
+* Plastic drinking straw
+* Pencil
+* Coloured pens (optional)
 
 
 ## Software requirements:
@@ -33,25 +42,18 @@ Learn how to build circuits with sensors and outputs and write a simple programm
 
 ## Drum Kit
 
-### 1. Make your drums
-
-Take your 4 piezo buzzers and attach a ring of Sugru (or other modelling material) as shown in the picture. 
-This will increase the flexibility and resonance of the sensors. Let the sugru set.
-
-
-### 2. Make the circuit
+<img src="http://farm9.staticflickr.com/8074/8257699966_7585ca06e7.jpg" width="375" height="500" alt="Code Club Miniband"><
 
-Piezo buzzers generate a small charges when you tap them, so they don’t need a power source.
-Connect one lead from your buzzer to one of your analogue inputs, and connect the other lead to ground.
-Repeat for each of your drums.
+## Guitar
 
+<img src="http://farm9.staticflickr.com/8070/8257698984_8471e4cf57.jpg" width="500" height="375" alt="Code Club Miniband">
 
+## Maracas
 
-## Pull-down Resistors
+<img src="http://farm9.staticflickr.com/8346/8257698652_4a99ee24b4.jpg" width="500" height="375" alt="Code Club Miniband">
 
-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.
+## Useful links:
 
-A better explanation can be found [here](http://arduino.cc/en/Tutorial/DigitalPins).
+* [Pictures from the hack day where this was put together](http://bit.ly/codeclubminiband) 
+* [Ardunio code](https://github.com/KatJoyWhite/miniband/tree/master/arduino)