noteOn()

 

This function sounds the given MIDI note on the specified channel (0..15) or “voice” with which to play the note. Assign an instrument to the voice with programChange(). A velocity of 0 is the same as noteOff().

Syntax

noteOn(channel, pitch, velocity)

Parameters

• Channel: A byte specifying the channel (0-15). Values greater than 15 will wrap around.
• Pitch: A byte between 0 and 127 indicating the pitch. 60 = middle C (C4) = 261.63Hz. For note values see Table 4.
• Velocity: A value between 0 and 127 indicating the attack of the note. On a keyboard this corresponds to how hard the key was struck. A velocity of 0 is the same as noteOff().

Example

#include <Fluxamasynth.h>

Fluxamasynth synth = Fluxamasynth();

void setup() {
  synth.setMasterVolume(255);   
}

void loop()
{
  for (int note=60; note<85; note++) {
    synth.noteOn(0, note, 100);  
    delay(200);
    synth.noteOn(0, note, 0);    // Be sure to turn the note off!
  }
}

programChange()

 

Changes the program (instrument) for the specified channel. Channel 9 is a special drumset channel; see the drum sound table in (Table 3). Drumsets can be also be assigned to other channels (see SYSEX MIDI channel to part assign and part to rhythm allocation).

Syntax

programChange(bank, channel, voice)

Parameters

• Bank: Either bank 0 (see Table 1) or bank 127 (see Table 2). Bank 127 is also called the MT-32 sound bank.
• Channel: A byte specifying the channel (0-15). Values greater than
  15 will wrap around.
• Value: A byte

Example

#include <Fluxamasynth.h>Fluxamasynth synth = Fluxamasynth();
byte instrument = 0; void setup() { synth.setMasterVolume(255); } void loop() { for (int note=60; note<85; note++) { synth.programChange(0, 0, instrument); synth.programChange(0, 1, instrument); synth.noteOn(0, note, 100); delay(200); synth.noteOff(0, note); synth.noteOn(1, note, 100); synth.noteOn(1, note+3, 100); synth.noteOn(1, note+7, 100); delay(200); synth.noteOff(1, note); synth.noteOff(1, note+3); synth.noteOff(1, note+7); instrument = (instrument+1) & 127; } } 

pitchBendRange()

 

Sets the pitch bend sensitivity in semitones (default = 2 semitones, -1 to +1). The maximum pitch bend is +/-1 whole tone.

Syntax

pitchBendRange(channel, value)

Parameters

• Channel: a byte specifying the channel (0-15). Values greater than
  15 will wrap around.
• Value:a byte

setChannelVolume()

 

Sets the volume for a particular channel.

Syntax

setChannelVolume(channel, level)

Parameters

• Channel: A number in the range 0-15
• Level: A number in the range 0-127 specifying the volume level (0 = silent)

Example

#include <Fluxamasynth.h>

Fluxamasynth synth = Fluxamasynth();

int tone1 = 53;
int tone2 = 61;

int vol1 = 64;                         // volumes must be inverses of eachother
int vol2 = 127 - vol1;                 // or they'll get out of sync

int i = 1;                             // step size
int dir = 1;                           // direction to step in: 1 = up, -1 = down

void setup() {
  Serial.begin(31250);

  synth.programChange(0, 0, 90);       // give our two channels different voices
  synth.programChange(0, 1, 89);

  synth.setChannelVolume(0, vol1);     // set their volumes
  synth.setChannelVolume(1, vol2);

  synth.noteOn(0, tone1, 127);         // turn on a note for each channel
  synth.noteOn(1, tone2, 127);
}

void loop() {
  while (vol1 > i && vol1 < (127 - i)) // loops while in valid volume range
  {
    delay(20);
    vol1+= i * dir;                    // vol1 increments by i in direction dir
    vol2 = 127 - vol1;                 // vol2 is always the inverse
    synth.setChannelVolume(0, vol1);   // update volumes
    synth.setChannelVolume(1, vol2);
  }
  dir*= -1;                            // once volumes reach bounds, reverse dir
  vol1+= i * dir;                      // increment once in new direction
  int vol2 = 127 - vol1;               // to ensure volumes are back in range
}

allNotesOff()

 

Sends a noteOff() for every note on a specified channel.

Syntax

allNotesOff(channel)

Parameters

• Channel: A number in the range 0-15

Example

#include <Fluxamasynth.h>

Fluxamasynth synth = Fluxamasynth();    // create our synth

int i = 0;                   // i detirmines what note
                             // of the chord we're on
int lastNote;

const int OCTAVE_RANGE = 12; // number of semitones in an octave

const int lowestTone = 48;   // low end of note range
const int minInterval = 2;   // smallest interval allowed, in semitones
const int chordSize = 4;     // number of notes per chord
const int delayTime = 300;   // time to delay between notes

const int channel = 0;       // channel number to use
const int instrument = 25;   // instrument to use for our channel

void setup() {
  Serial.begin(31250);       // Set MIDI baud rate:

  synth.programChange(channel, 0, instrument);

  randomSeed(analogRead(0)); // seed random with arbitrary analog noise
}

void loop() {
  int note;                  // note to play

  if (i == 0)                // if this is first note of chord
  {                          // mute all notes of previous chord
    synth.allNotesOff(channel);

                             // note is a random tone in our range
    note = lowestTone + random(OCTAVE_RANGE);
  }

  else                       // otherwise,
  {                          // note is a random interval above last note
                             // (between minInterval and OCTAVE_RANGE)
    note = lastNote + random(OCTAVE_RANGE - minInterval) + minInterval;
  }

  lastNote = note;
                             // play note
  synth.noteOn(channel, note, 127);
  i = (i + 1) % chordSize;   // increment i
                             // (loop between 0 and chordSize)

  delay(delayTime);
}

Applies a chorus effect to a specified channel.

Syntax

setChorus(channel, program, level, feedback, chorusDelay)

Parameters

• Channel: A number in the range 0-15
• Program:

  0: Chorus 1
  1: Chorus 2
  2: Chorus 3
  3: Chorus 4
  4: Feedback
  5: Flanger
  6: Short Delay
  7: Feedback Delay
  

• Level: A number in the range 0-127
• DelayFeedback: If using program 6 or 7, this specified the feedback level.