View source for Stompbox Real Sensors

<font size=5>Lab 2: Controlling an Effect with Real Sensors</font><br>
Designed by Edgar Berdahl

Due on Wednesday, July 20th at 9AM


== Install the lab software ==


== Power Connections ==
* In order to run circuits on the breadboard, you need to get power to it. The Arduino gets 5V from the USB connection, so in this section you will make the 5V accessible to the breadboard.
* Make sure that your Arduino is mounted at the very end of the breadboard with the higher-numbered rows, as shown in the following picture. In that case, the GND and 5V pins will end up in the 19th row. (Otherwise if your Arduino isn't mounted this way, you simply won't be able to rely on the row numbers, but you can still figure out how to wire things up!)
* Recall first that that holes in the solderless bread board are wired together as shown:

[[Image:Breadboard.png]]
 
* Using short jumpers, connect the GND row to the blue "GND" bus on the breadboard, and connect the 5V row to the red "power" bus on the breadboard.
* Connect the "GND" and "power" busses from both sides of the breadboard together as shown.

[[Image:circuit0-big.jpg]]



Viewed from further away, your breadboard should now look like the following:

[[Image:circuit0.jpg]]




== First Circuit: Potentiometer ==

Now you will build the following voltage divider circuit, to connect one potentiometer to analog input A0.

[[Image:pot-A0.jpg]]

For some help on placing the wires, please see the following picture. In order to ensure the correct orientation, ensure that the text on the potentiometer is facing '''away''' from the Arduino (see also oblique picture in next section).
[[Image:circuit2.jpg]]




== Add A Second Potentiometer ==

Now connect a second potentiometer to analog input A3 using the same voltage divider circuit.

[[Image:SBcircuit3-direct.jpg]]



Again, ensure that the text on the potentiometer is facing *away* from the Arduino (see the red boxes in the following figure):

[[Image:SBcircuit3.jpg]]




== Add A Button ==

Most stomp boxes have a button, so we include that as well according to the following circuit:

[[Image:SBbutton-circuit.jpg]]

The corresponding picture of the bread board is shown below:

[[Image:SBcircuit5.jpg]]




== Add An LED ==

Finally, we add an LED for fun and to help with debugging. 

[[Image:SBcircuit6.jpg]]




== Test The Tremolo Effect ==

Now you will test a very simple tremolo effect.

* Connect headphones or some small loudspeakers to the ''audio out'' jack on the Beagle Board. (It is the one closer to the middle of the board.)
* Connect an input audio source, such as a small MP3 player or the audio output of your laptop, to the ''audio in'' jack on the Beagle Board.  (Maybe if we plug in the microphones half-way they will work and we could use them instead?!?)
* Connect the kit to your laptop using the Ethernet cable, and connect power to the Beagle Board so that it will start booting up.
* Open up a terminal on your computer, and log into the kit using the command <tt>ssh -XY ccrma@192.168.1.105</tt>
* In the terminal, change to the directory for this example by typing <tt>cd ~/stompbox/simple-stompbox</tt>
* Then type <tt>qjackctl &</tt> and press the "Start" button to start the Jack audio server.
* Open pd by typing <tt>pd &</tt>
* Open the patch <tt>simple-stompbox.pd</tt> using the File|Open menu option.
* Start audio signal computation by checking the ''compute audio'' button in the main pd window.
* The oscillator's output should be displayed by the horizontal slider and LED in real time. (If not, please go back and make sure you carried out all of the previous instructions.)

[[Image:SBsimple-stompbox.png]]


* Verify that turning the potentiometer connected to input pin A3 on the Arduino adjusts the value A3 shown in the main patch window. This should also change the output volume of the effect.
* Verify that turning the potentiometer connected to input pin A0 on the Arduino adjusts the oscillator frequency.




== Build A New Effect ==

* Build a new effect whose parameters are adjustable by the potentiometers and button. You could also build on what you did in lab 1.

* Think about the result
** do the controls allow the entire space of parameters to be explored?
** is it easy to choose any desired set of parameters?
** does the effect sound good?
** does it have dynamics?
** would you want to use it live?
*** If not, what is missing still?




== Appendix: Install Stompbox Firmware onto your Arduino Nano ==
If this wasn't already completed for you '''before''' starting the lab, then you must do it yourself!

* Change to the <tt>~/stompbox</tt> directory by typing <tt>cd ~/stompbox</tt> at the console.
* From the terminal, run the command <tt>arduino &</tt> to start up the Arduino software.
* From the menu Tools|Board choose <tt>Arduino Duemilanove or Nano w/ 328</tt>
* From the menu Tools|Serial port choose <tt>/dev/ttyUSB0</tt>
* Open the sketch <tt>~/stompbox/simple-stompbox/FirmataAllInputs_ExceptOnePWMOut/FirmataAllInputs_ExceptOnePWMOut.pde</tt>
* Press the '''Verify''' button.
* Check the Arduino messages window to make sure that you have successfully installed the firmware. (Usually, it will say something like <tt>Done compiling</tt> and <tt>Binary sketch size ...</tt>)




== Important Note ==
Some small amount of the text and images here was taken from prior laboratory exercises for the course [https://ccrma.stanford.edu/courses/250a/ Music 250A]. We regret that we do not know who contributed these elements, but these people are likely to include Wendy Ju, Bill Verplank, Michael Gurevich, and possibly more.


<center>[[Stompbox 2011]]</center>
[[Category:Stompbox 2011]][[Category:PID]]