Tutorial 04. DIP switch control
The final set of built-in user inputs on MEAP are the eight DIP switches. They toggle between two states: up and down. |
- This time, let's start with our code from Tutorial 03 where we had created a basic monophonic keyboard. We are going to use one of the dip switches to toggle between two octaves on the keyboard; when the first dip switch is toggled up, it will raise all pitches by an octave.
- From the last tutorial, you should be familiar with the
structure of
updateTouch()
. The good news now is thatupdateDip()
is implemented in exactly the same way. The slight difference is that the second variable that the function gives you is now called up. It will be true when a DIP switch is toggled up, and false when it is toggled down. The DIP switches follow the same numbering format as the touch pads. - There are several ways we could approach the task of
raising an octave when the first dip switch is
toggled. The way I will do it is as follows.
- Create a variable called octave_multiplier which will have a value of either 1 or 2.
- In
updateTouch()
, whenever we set the frequency of an oscillator, we will first multiply that frequency by octave_multiplier. When octave_multiplier is equal to one, the pitch will be unchanged, but when it is equal to two, the frequency will by doubled, raising it by an octave. - Set octave_multiplier to 2 when DIP 0 is raised, and 1 when it is lowered.
- First let's create the octave_multiplier variable as a
global variable beneath the declaration of our
my_sine
oscillator and initialize it to 1int octave_multiplier = 1;
- Now in
updateTouch()
we want to multiply every frequency by this variable. For example, the first pad's "pressed" section would now look like this:my_sine.setFreq(220 * octave_multiplier);
- Now in
updateDip()
we need to set octave_multiplier. We want it to be 2 when DIP 0 is toggled up and 1 when it is toggled down so we should modify the DIP 0 section as follows.if (up) { // DIP 0 up Serial.println("d0 up"); octave_multiplier = 2; } else { // DIP 0 down Serial.println("d0 down"); octave_multiplier = 1; }
- Upload the code and try toggling between octaves as you play the keyboard!
FULL CODE BELOW
/*
Capacitive touch keyboard, playing A major scale.
*/
#define CONTROL_RATE 64 // Hz, powers of 2 are most reliable
#include <Meap.h> // MEAP library, includes all dependent libraries, including all Mozzi modules
Meap meap; // creates MEAP object to handle inputs and other MEAP library functions
MIDI_CREATE_INSTANCE(HardwareSerial, Serial1, MIDI); // defines MIDI in/out ports
// ---------- YOUR GLOBAL VARIABLES BELOW ----------
#include <tables/sin8192_int8.h> // loads sine wavetable
mOscil<8192, AUDIO_RATE> my_sine(SIN8192_DATA);
int octave_multiplier = 1;
void setup() {
Serial.begin(115200); // begins Serial communication with computer
Serial1.begin(31250, SERIAL_8N1, 43, 44); // sets up MIDI: baud rate, serial mode, rx pin, tx pin
startMozzi(CONTROL_RATE); // starts Mozzi engine with control rate defined above
meap.begin(); // sets up MEAP object
// ---------- YOUR SETUP CODE BELOW ----------
my_sine.setFreq(220);
}
void loop() {
audioHook(); // handles Mozzi audio generation behind the scenes
}
/** Called automatically at rate specified by CONTROL_RATE macro, most of your mode should live in here
*/
void updateControl() {
meap.readInputs();
// ---------- YOUR updateControl CODE BELOW ----------
}
/** Called automatically at rate specified by AUDIO_RATE macro, for calculating samples sent to DAC, too much code in here can disrupt your output
*/
AudioOutput_t updateAudio() {
int64_t out_sample = my_sine.next();
return StereoOutput::fromNBit(8, (out_sample * meap.volume_val)>>12, (out_sample * meap.volume_val)>>12);
}
/**
* Runs whenever a touch pad is pressed or released
*
* int number: the number (0-7) of the pad that was pressed
* bool pressed: true indicates pad was pressed, false indicates it was released
*/
void updateTouch(int number, bool pressed) {
if (pressed) { // Any pad pressed
} else { // Any pad released
}
switch (number) {
case 0:
if (pressed) { // Pad 0 pressed
Serial.println("t0 pressed ");
my_sine.setFreq(220 * octave_multiplier); // A3 or A4
} else { // Pad 0 released
Serial.println("t0 released");
}
break;
case 1:
if (pressed) { // Pad 1 pressed
Serial.println("t1 pressed");
my_sine.setFreq(246.94 * octave_multiplier); // B3 or B4
} else { // Pad 1 released
Serial.println("t1 released");
}
break;
case 2:
if (pressed) { // Pad 2 pressed
Serial.println("t2 pressed");
my_sine.setFreq(277.18 * octave_multiplier); // C#4 or C#5
} else { // Pad 2 released
Serial.println("t2 released");
}
break;
case 3:
if (pressed) { // Pad 3 pressed
Serial.println("t3 pressed");
my_sine.setFreq(293.66 * octave_multiplier); // D4 or D5
} else { // Pad 3 released
Serial.println("t3 released");
}
break;
case 4:
if (pressed) { // Pad 4 pressed
Serial.println("t4 pressed");
my_sine.setFreq(329.63 * octave_multiplier); // E4 or E5
} else { // Pad 4 released
Serial.println("t4 released");
}
break;
case 5:
if (pressed) { // Pad 5 pressed
Serial.println("t5 pressed");
my_sine.setFreq(369.99 * octave_multiplier); // F#4 or F#5
} else { // Pad 5 released
Serial.println("t5 released");
}
break;
case 6:
if (pressed) { // Pad 6 pressed
Serial.println("t6 pressed");
my_sine.setFreq(415.3 * octave_multiplier); // G#4 or G#5
} else { // Pad 6 released
Serial.println("t6 released");
}
break;
case 7:
if (pressed) { // Pad 7 pressed
Serial.println("t7 pressed");
my_sine.setFreq(440 * octave_multiplier); // A4 or A5
} else { // Pad 7 released
Serial.println("t7 released");
}
break;
}
}
/**
* Runs whenever a DIP switch is toggled
*
* int number: the number (0-7) of the switch that was toggled
* bool up: true indicated switch was toggled up, false indicates switch was toggled
*/
void updateDip(int number, bool up) {
if (up) { // Any DIP toggled up
} else { //Any DIP toggled down
}
switch (number) {
case 0:
if (up) { // DIP 0 up
Serial.println("d0 up");
octave_multiplier = 2;
} else { // DIP 0 down
Serial.println("d0 down");
octave_multiplier = 1;
}
break;
case 1:
if (up) { // DIP 1 up
Serial.println("d1 up");
} else { // DIP 1 down
Serial.println("d1 down");
}
break;
case 2:
if (up) { // DIP 2 up
Serial.println("d2 up");
} else { // DIP 2 down
Serial.println("d2 down");
}
break;
case 3:
if (up) { // DIP 3 up
Serial.println("d3 up");
} else { // DIP 3 down
Serial.println("d3 down");
}
break;
case 4:
if (up) { // DIP 4 up
Serial.println("d4 up");
} else { // DIP 4 down
Serial.println("d4 down");
}
break;
case 5:
if (up) { // DIP 5 up
Serial.println("d5 up");
} else { // DIP 5 down
Serial.println("d5 down");
}
break;
case 6:
if (up) { // DIP 6 up
Serial.println("d6 up");
} else { // DIP 6 down
Serial.println("d6 down");
}
break;
case 7:
if (up) { // DIP 7 up
Serial.println("d7 up");
} else { // DIP 7 down
Serial.println("d7 down");
}
break;
}
}