midi_Defs.h

Go to the documentation of this file.

 
#pragma once
 
#include "midi_Namespace.h"
 
#if ARDUINO
#include <Arduino.h>
#else
#include <inttypes.h>
typedef uint8_t byte;
#endif
 
BEGIN_MIDI_NAMESPACE
 
// -----------------------------------------------------------------------------
 
#define MIDI_CHANNEL_OMNI       0
#define MIDI_CHANNEL_OFF        17 // and over
 
#define MIDI_PITCHBEND_MIN      -8192
#define MIDI_PITCHBEND_MAX      8191

static const uint16_t ActiveSensingTimeout = 300;
 
// -----------------------------------------------------------------------------
// Type definitions
 
typedef byte StatusByte;
typedef byte DataByte;
typedef byte Channel;
typedef byte FilterMode;
 
// -----------------------------------------------------------------------------
// Errors
static const uint8_t ErrorParse = 0;
static const uint8_t ErrorActiveSensingTimeout = 1;
static const uint8_t WarningSplitSysEx = 2;
 
// -----------------------------------------------------------------------------
// Aliasing
 
using ErrorCallback                = void (*)(int8_t);
using NoteOffCallback              = void (*)(Channel channel, byte note, byte velocity);
using NoteOnCallback               = void (*)(Channel channel, byte note, byte velocity);
using AfterTouchPolyCallback       = void (*)(Channel channel, byte note, byte velocity);
using ControlChangeCallback        = void (*)(Channel channel, byte, byte);
using ProgramChangeCallback        = void (*)(Channel channel, byte);
using AfterTouchChannelCallback    = void (*)(Channel channel, byte);
using PitchBendCallback            = void (*)(Channel channel, int);
using SystemExclusiveCallback      = void (*)(byte * array, unsigned size);
using TimeCodeQuarterFrameCallback = void (*)(byte data);
using SongPositionCallback         = void (*)(unsigned beats);
using SongSelectCallback           = void (*)(byte songnumber);
using TuneRequestCallback          = void (*)(void);
using ClockCallback                = void (*)(void);
using StartCallback                = void (*)(void);
using TickCallback                 = void (*)(void);
using ContinueCallback             = void (*)(void);
using StopCallback                 = void (*)(void);
using ActiveSensingCallback        = void (*)(void);
using SystemResetCallback          = void (*)(void);
 
// -----------------------------------------------------------------------------

enum MidiType: uint8_t
{
    InvalidType           = 0x00,    
    NoteOff               = 0x80,    
    NoteOn                = 0x90,    
    AfterTouchPoly        = 0xA0,    
    ControlChange         = 0xB0,    
    ProgramChange         = 0xC0,    
    AfterTouchChannel     = 0xD0,    
    PitchBend             = 0xE0,    
    SystemExclusive       = 0xF0,    
    SystemExclusiveStart  = SystemExclusive,   
    TimeCodeQuarterFrame  = 0xF1,    
    SongPosition          = 0xF2,    
    SongSelect            = 0xF3,    
    Undefined_F4          = 0xF4,
    Undefined_F5          = 0xF5,
    TuneRequest           = 0xF6,    
    SystemExclusiveEnd    = 0xF7,    
    Clock                 = 0xF8,    
    Undefined_F9          = 0xF9,
    Tick                  = Undefined_F9, 
    Start                 = 0xFA,    
    Continue              = 0xFB,    
    Stop                  = 0xFC,    
    Undefined_FD          = 0xFD,
    ActiveSensing         = 0xFE,    
    SystemReset           = 0xFF,    
};
 
// -----------------------------------------------------------------------------

struct Thru
{
    enum Mode
    {
        Off                   = 0,  
        Full                  = 1,  
        SameChannel           = 2,  
        DifferentChannel      = 3,  
    };
};
 
// -----------------------------------------------------------------------------

enum MidiControlChangeNumber: uint8_t
{
    // High resolution Continuous Controllers MSB (+32 for LSB) ----------------
    BankSelect                  = 0,
    ModulationWheel             = 1,
    BreathController            = 2,
    // CC3 undefined
    FootController              = 4,
    PortamentoTime              = 5,
    DataEntryMSB                = 6,
    ChannelVolume               = 7,
    Balance                     = 8,
    // CC9 undefined
    Pan                         = 10,
    ExpressionController        = 11,
    EffectControl1              = 12,
    EffectControl2              = 13,
    // CC14 undefined
    // CC15 undefined
    GeneralPurposeController1   = 16,
    GeneralPurposeController2   = 17,
    GeneralPurposeController3   = 18,
    GeneralPurposeController4   = 19,
 
    DataEntryLSB                = 38,
 
    // Switches ----------------------------------------------------------------
    Sustain                     = 64,
    Portamento                  = 65,
    Sostenuto                   = 66,
    SoftPedal                   = 67,
    Legato                      = 68,
    Hold                        = 69,
 
    // Low resolution continuous controllers -----------------------------------
    SoundController1            = 70,   
    SoundController2            = 71,   
    SoundController3            = 72,   
    SoundController4            = 73,   
    SoundController5            = 74,   
    SoundController6            = 75,   
    SoundController7            = 76,   
    SoundController8            = 77,   
    SoundController9            = 78,   
    SoundController10           = 79,   
    GeneralPurposeController5   = 80,
    GeneralPurposeController6   = 81,
    GeneralPurposeController7   = 82,
    GeneralPurposeController8   = 83,
    PortamentoControl           = 84,
    // CC85 to CC90 undefined
    Effects1                    = 91,   
    Effects2                    = 92,   
    Effects3                    = 93,   
    Effects4                    = 94,   
    Effects5                    = 95,   
    DataIncrement               = 96,
    DataDecrement               = 97,
    NRPNLSB                     = 98,   
    NRPNMSB                     = 99,   
    RPNLSB                      = 100,  
    RPNMSB                      = 101,  
 
    // Channel Mode messages ---------------------------------------------------
    AllSoundOff                 = 120,
    ResetAllControllers         = 121,
    LocalControl                = 122,
    AllNotesOff                 = 123,
    OmniModeOff                 = 124,
    OmniModeOn                  = 125,
    MonoModeOn                  = 126,
    PolyModeOn                  = 127
};
 
struct RPN
{
    enum RegisteredParameterNumbers: uint16_t
    {
        PitchBendSensitivity    = 0x0000,
        ChannelFineTuning       = 0x0001,
        ChannelCoarseTuning     = 0x0002,
        SelectTuningProgram     = 0x0003,
        SelectTuningBank        = 0x0004,
        ModulationDepthRange    = 0x0005,
        NullFunction            = (0x7f << 7) + 0x7f,
    };
};
 
END_MIDI_NAMESPACE