Arduino MIDI Library  Version 4.3.1
DefaultSettings Struct Reference

Default Settings for the MIDI Library. More...

#include <midi_Settings.h>

Static Public Attributes

static const bool UseRunningStatus = false
static const bool HandleNullVelocityNoteOnAsNoteOff = true
static const bool Use1ByteParsing = true
static const long BaudRate = 31250
static const unsigned SysExMaxSize = 128

Detailed Description

Default Settings for the MIDI Library.

To change the default settings, don't edit them there, create a subclass and override the values in that subclass, then use the MIDI_CREATE_CUSTOM_INSTANCE macro to create your instance. The settings you don't override will keep their default value. Eg:

struct MySettings : public midi::DefaultSettings
static const unsigned SysExMaxSize = 1024; // Accept SysEx messages up to 1024 bytes long.
MIDI_CREATE_CUSTOM_INSTANCE(HardwareSerial, Serial2, midi, MySettings);

Definition at line 49 of file midi_Settings.h.

Member Data Documentation

§ BaudRate

const long DefaultSettings::BaudRate = 31250

Override the default MIDI baudrate to transmit over USB serial, to a decoding program such as Hairless MIDI (set baudrate to 115200)

Definition at line 73 of file midi_Settings.h.

§ HandleNullVelocityNoteOnAsNoteOff

const bool DefaultSettings::HandleNullVelocityNoteOnAsNoteOff = true

NoteOn with 0 velocity should be handled as NoteOf.
Set to true to get NoteOff events when receiving null-velocity NoteOn messages.
Set to false to get NoteOn events when receiving null-velocity NoteOn messages.

Definition at line 61 of file midi_Settings.h.

§ SysExMaxSize

const unsigned DefaultSettings::SysExMaxSize = 128

Maximum size of SysEx receivable. Decrease to save RAM if you don't expect to receive SysEx, or adjust accordingly.

Definition at line 78 of file midi_Settings.h.

§ Use1ByteParsing

const bool DefaultSettings::Use1ByteParsing = true

Setting this to true will make parse only one byte of data for each call when data is available. This can speed up your application if receiving a lot of traffic, but might induce MIDI Thru and treatment latency.

Definition at line 67 of file midi_Settings.h.

§ UseRunningStatus

const bool DefaultSettings::UseRunningStatus = false

Running status enables short messages when sending multiple values of the same type and channel.
Warning: does not work with some hardware, enable with caution.

Definition at line 55 of file midi_Settings.h.

The documentation for this struct was generated from the following file: