├── samples
    ├── clap.wav
    ├── kick.wav
    ├── open.wav
    ├── closed.wav
    ├── cymbal.wav
    └── snare.wav
├── schematic
    ├── beetbox.fzz
    └── beetbox.jpg
├── beetbox.py
├── ReadMe.md
└── mpr121.py


/samples/clap.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/clap.wav


--------------------------------------------------------------------------------
/samples/kick.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/kick.wav


--------------------------------------------------------------------------------
/samples/open.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/open.wav


--------------------------------------------------------------------------------
/samples/closed.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/closed.wav


--------------------------------------------------------------------------------
/samples/cymbal.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/cymbal.wav


--------------------------------------------------------------------------------
/samples/snare.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/samples/snare.wav


--------------------------------------------------------------------------------
/schematic/beetbox.fzz:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/schematic/beetbox.fzz


--------------------------------------------------------------------------------
/schematic/beetbox.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/scottgarner/BeetBox/HEAD/schematic/beetbox.jpg


--------------------------------------------------------------------------------
/beetbox.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | 
 3 | """beetbox.py: Trigger script for the BeetBox."""
 4 | 
 5 | __author__ = "Scott Garner"
 6 | __email__ = "scott@j38.net"
 7 | 
 8 | import pygame
 9 | 
10 | import RPi.GPIO as GPIO
11 | import mpr121
12 | 
13 | # Use GPIO Interrupt Pin
14 | 
15 | GPIO.setmode(GPIO.BOARD)
16 | GPIO.setup(7, GPIO.IN)
17 | 
18 | # Use mpr121 class for everything else
19 | 
20 | mpr121.TOU_THRESH = 0x30
21 | mpr121.REL_THRESH = 0x33
22 | mpr121.setup(0x5a)
23 | 
24 | # User pygame for sounds
25 | 
26 | pygame.mixer.pre_init(44100, -16, 12, 512)
27 | pygame.init()
28 | 
29 | kick = pygame.mixer.Sound('samples/kick.wav')
30 | kick.set_volume(.65);
31 | snare = pygame.mixer.Sound('samples/snare.wav')
32 | snare.set_volume(.65);
33 | openhh = pygame.mixer.Sound('samples/open.wav')
34 | openhh.set_volume(.65);
35 | closedhh = pygame.mixer.Sound('samples/closed.wav')
36 | closedhh.set_volume(.65);
37 | clap = pygame.mixer.Sound('samples/clap.wav')
38 | clap.set_volume(.65);
39 | cymbal = pygame.mixer.Sound('samples/cymbal.wav')
40 | cymbal.set_volume(.65);
41 | 
42 | # Track touches
43 | 
44 | touches = [0,0,0,0,0,0];
45 | 
46 | while True:
47 | 
48 | 	if (GPIO.input(7)): # Interupt pin is high
49 | 		pass
50 | 	else: # Interupt pin is low
51 | 
52 | 		touchData = mpr121.readData(0x5a)
53 | 
54 | 		for i in range(6):
55 | 			if (touchData & (1<<i)):
56 | 
57 | 				if (touches[i] == 0):
58 | 
59 | 					print( 'Pin ' + str(i) + ' was just touched')
60 | 
61 | 					if (i == 0):
62 | 						kick.play()
63 | 					elif (i == 1):
64 | 						snare.play()
65 | 					elif (i == 2):
66 | 						openhh.play()
67 | 					elif (i == 3):
68 | 						closedhh.play()
69 | 					elif (i == 4):
70 | 						clap.play()
71 | 					elif (i == 5):
72 | 						cymbal.play()
73 | 
74 | 				touches[i] = 1;
75 | 			else:
76 | 				if (touches[i] == 1):
77 | 					print( 'Pin ' + str(i) + ' was just released')
78 | 				touches[i] = 0;
79 | 


--------------------------------------------------------------------------------
/ReadMe.md:
--------------------------------------------------------------------------------
 1 | # BeetBox
 2 | 
 3 | This is probably not especially useful to anyone, but may be interesting to those curious about the inner workings of the [Beetbox](http://www.scottmadethis.net/interactive/beetbox/). The code for interfacing with the MPR121 is based on [an Arduino example by Jim Lindblom](http://bildr.org/2011/05/mpr121_arduino/).
 4 | 
 5 | ## Building Your Own
 6 | 
 7 | I'm very open to people recreating the BeetBox as a learning exercise. The code and schematic in this repository are more or less exactly what I used in the project, though you may have to tweak things on your end. The main compontents you need are a [Raspberry Pi](http://amzn.to/1zk5YwV) and an [MPR-121](http://amzn.to/1S3yu0V) capacative touch sensor board from SparkFun. I've also included the schematic for a simple amplifier circuit, but it is totally optional and you can easily use ready-made devices like computer speakers for amplification.
 8 | 
 9 | I used the stock [distribution of Raspian](http://www.raspberrypi.org/downloads/) from the Raspberry Pi foundation, though that was some time ago and I'm sure things have changed. The most important thing to make sure of in working with the MPR-121 is that I2C/SMBus connectivity is working properly. Adafruit has a helpful tutorial on [Configuring the Pi for I2C](https://learn.adafruit.com/using-the-bmp085-with-raspberry-pi/configuring-the-pi-for-i2c).
10 | 
11 | Once your Pi is communicating with the board properly, you can clone this repository and run the script with something like `sudo python beetbox.py`
12 | 
13 | A list of links to purchase some recommended tools and parts is available [on the project page](http://www.scottmadethis.net/interactive/beetbox/).
14 | 
15 | ## Alternatives
16 | 
17 | Dealing with the Pi if you're not experienced with Linux can be a big task in itself. If you'd like to experiment with touch-based projects, but aren't quite ready for that level of complexity, there are a few easier ways to get started.
18 | 
19 | ### MaKey Makey
20 | 
21 | The [MaKey MaKey](http://amzn.to/1ycuhdu) works on a different principle (resistance rather than capacitance), but the results are very similar and it's extremely easy to get started with. I'd definitely recommend it for beginners and children.
22 | 
23 | ### Arduino
24 | 
25 | For the initial prototype of the BeetBox, I used an [Arduino Uno](http://amzn.to/1ycuX2z) connected to an MPR-121 board ([with code and instructions from Jim Lindblom](http://bildr.org/2011/05/mpr121_arduino/)) and plugged it into a laptop running a simple Processing sketch to trigger sounds. Another option would be to skip the sensor board alltogether and try the Arduino [CapSense](http://playground.arduino.cc/Main/CapacitiveSensor?from=Main.CapSense) library.
26 | 


--------------------------------------------------------------------------------
/mpr121.py:
--------------------------------------------------------------------------------
  1 | # Based on Arduino example by Jim Lindblom
  2 | # http://bildr.org/2011/05/mpr121_arduino/
  3 | 
  4 | import smbus
  5 | bus = smbus.SMBus(1)
  6 | 
  7 | # MPR121 Register Defines
  8 | 
  9 | MHD_R = 0x2B
 10 | NHD_R = 0x2C
 11 | NCL_R = 0x2D
 12 | FDL_R = 0x2E
 13 | MHD_F = 0x2F
 14 | NHD_F = 0x30
 15 | NCL_F = 0x31
 16 | FDL_F = 0x32
 17 | ELE0_T = 0x41
 18 | ELE0_R = 0x42
 19 | ELE1_T = 0x43
 20 | ELE1_R = 0x44
 21 | ELE2_T = 0x45
 22 | ELE2_R = 0x46
 23 | ELE3_T = 0x47
 24 | ELE3_R = 0x48
 25 | ELE4_T = 0x49
 26 | ELE4_R = 0x4A
 27 | ELE5_T = 0x4B
 28 | ELE5_R = 0x4C
 29 | ELE6_T = 0x4D
 30 | ELE6_R = 0x4E
 31 | ELE7_T = 0x4F
 32 | ELE7_R = 0x50
 33 | ELE8_T = 0x51
 34 | ELE8_R = 0x52
 35 | ELE9_T = 0x53
 36 | ELE9_R = 0x54
 37 | ELE10_T = 0x55
 38 | ELE10_R = 0x56
 39 | ELE11_T = 0x57
 40 | ELE11_R = 0x58
 41 | FIL_CFG = 0x5D
 42 | ELE_CFG = 0x5E
 43 | GPIO_CTRL0 = 0x73
 44 | GPIO_CTRL1 = 0x74
 45 | GPIO_DATA = 0x75
 46 | GPIO_DIR = 0x76
 47 | GPIO_EN = 0x77
 48 | GPIO_SET = 0x78
 49 | GPIO_CLEAR = 0x79
 50 | GPIO_TOGGLE = 0x7A
 51 | ATO_CFG0 = 0x7B
 52 | ATO_CFGU = 0x7D
 53 | ATO_CFGL = 0x7E
 54 | ATO_CFGT = 0x7F
 55 | 
 56 | # Global Constants
 57 | 
 58 | TOU_THRESH = 0x06
 59 | REL_THRESH = 0x0A
 60 | 
 61 | # Routines
 62 | 
 63 | def readData(address):
 64 | 	MSB = bus.read_byte_data(address, 0x00)
 65 | 	LSB = bus.read_byte_data(address, 0x01)
 66 | 
 67 | 	#touchData = (MSB << 8) | LSB
 68 | 	touchData = MSB;
 69 | 
 70 | 	return touchData;
 71 | 
 72 | def setup(address):
 73 | 
 74 | 	bus.write_byte_data(address, ELE_CFG, 0x00)
 75 | 
 76 | 	# Section A - Controls filtering when data is > baseline.
 77 | 	 
 78 | 	bus.write_byte_data(address, MHD_R, 0x01)
 79 | 	bus.write_byte_data(address, NHD_R, 0x01)
 80 | 	bus.write_byte_data(address, NCL_R, 0x00)
 81 | 	bus.write_byte_data(address, FDL_R, 0x00)
 82 | 
 83 | 	# Section B - Controls filtering when data is < baseline.
 84 | 
 85 | 	bus.write_byte_data(address, MHD_F, 0x01)
 86 | 	bus.write_byte_data(address, NHD_F, 0x01)
 87 | 	bus.write_byte_data(address, NCL_F, 0xFF)
 88 | 	bus.write_byte_data(address, FDL_F, 0x02)	
 89 | 
 90 | 	#Section C - Sets touch and release thresholds for each electrode
 91 | 
 92 | 	bus.write_byte_data(address, ELE0_T, TOU_THRESH)
 93 | 	bus.write_byte_data(address, ELE0_R, REL_THRESH)
 94 | 
 95 | 	bus.write_byte_data(address, ELE1_T, TOU_THRESH)
 96 | 	bus.write_byte_data(address, ELE1_R, REL_THRESH)
 97 | 
 98 | 	bus.write_byte_data(address, ELE2_T, TOU_THRESH)
 99 | 	bus.write_byte_data(address, ELE2_R, REL_THRESH)
100 | 
101 | 	bus.write_byte_data(address, ELE3_T, TOU_THRESH)
102 | 	bus.write_byte_data(address, ELE3_R, REL_THRESH)
103 | 
104 | 	bus.write_byte_data(address, ELE4_T, TOU_THRESH)
105 | 	bus.write_byte_data(address, ELE4_R, REL_THRESH)
106 | 
107 | 	bus.write_byte_data(address, ELE5_T, TOU_THRESH)
108 | 	bus.write_byte_data(address, ELE5_R, REL_THRESH)
109 | 
110 | 	bus.write_byte_data(address, ELE6_T, TOU_THRESH)
111 | 	bus.write_byte_data(address, ELE6_R, REL_THRESH)
112 | 
113 | 	bus.write_byte_data(address, ELE7_T, TOU_THRESH)
114 | 	bus.write_byte_data(address, ELE7_R, REL_THRESH)
115 | 
116 | 	bus.write_byte_data(address, ELE8_T, TOU_THRESH)
117 | 	bus.write_byte_data(address, ELE8_R, REL_THRESH)
118 | 
119 | 	bus.write_byte_data(address, ELE9_T, TOU_THRESH)
120 | 	bus.write_byte_data(address, ELE9_R, REL_THRESH)
121 | 
122 | 	bus.write_byte_data(address, ELE10_T, TOU_THRESH)
123 | 	bus.write_byte_data(address, ELE10_R, REL_THRESH)
124 | 
125 | 	bus.write_byte_data(address, ELE11_T, TOU_THRESH)
126 | 	bus.write_byte_data(address, ELE11_R, REL_THRESH)	
127 | 
128 | 	# Section D
129 | 	# Set the Filter Configuration
130 | 	# Set ESI2
131 | 
132 | 	bus.write_byte_data(address, FIL_CFG, 0x04)
133 | 
134 | 	# Section E
135 | 	# Electrode Configuration
136 | 	# Set ELE_CFG to 0x00 to return to standby mode
137 | 
138 | 	bus.write_byte_data(address, ELE_CFG, 0x0C)  # Enables all 12 Electrodes	
139 | 


--------------------------------------------------------------------------------