Updated README, added pictures to the writeup
[miniband.git] / README.md
1 Code Club - Mini Band Project
2 =============================
3 # Updated project for Code Club, using Arduino and Raspberry Pi
4
5 <img src="http://farm9.staticflickr.com/8338/8256708023_4a941566e9.jpg" width="500" height="375" alt="photo (2)">
6
7 Make your own mini band!
8 You and your friends can form your own finger-sized band and rock out using Raspberry Pi and Arduino.
9 Learn how to build circuits with sensors and outputs and write a simple programme to control your instruments.
10
11 ## Instructions
12
13 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).
14
15 ## You will make:
16
17 * A guitar
18 * A set of drums
19 * A pair of maracas
20
21 ## You will need:
22
23 * 1 x Raspberry Pi (plus monitor and power supply)
24 * 1 x Arduino Uno boards (with USB cables)
25 * 1 x strip potentiometer
26 * 2 x tilt sensors
27 * 4 x piezo buzzers (the type in greetings cards, easy to get from Maplin)
28 * 7 × 10K resistors
29 * Bread boards (1 per instrument)
30 * Card
31 * Sugru (or some other modelling material)
32 * Electrical tape
33 * Plastic drinking straw
34 * Pencil
35 * Coloured pens (optional)
36
37
38 ## Software requirements:
39
40 * Scratch
41 * IDE developer environment for Arduino
42 * Py Serial library
43
44 ## Drum Kit
45
46 <img src="http://farm9.staticflickr.com/8074/8257699966_7585ca06e7.jpg" width="375" height="500" alt="Code Club Miniband"><
47
48 ## Guitar
49
50 <img src="http://farm9.staticflickr.com/8070/8257698984_8471e4cf57.jpg" width="500" height="375" alt="Code Club Miniband">
51
52 ## Maracas
53
54 <img src="http://farm9.staticflickr.com/8346/8257698652_4a99ee24b4.jpg" width="500" height="375" alt="Code Club Miniband">
55
56
57 ## Useful links:
58
59 * [Pictures from the hack day where this was put together](http://bit.ly/codeclubminiband)
60 * [Ardunio code](https://github.com/KatJoyWhite/miniband/tree/master/arduino)