{"id":4898,"date":"2022-08-25T14:46:46","date_gmt":"2022-08-25T12:46:46","guid":{"rendered":"https:\/\/www.pschatzmann.ch\/home\/?p=4898"},"modified":"2023-06-30T11:59:10","modified_gmt":"2023-06-30T09:59:10","slug":"arduino-audio-tools-vs1053-real-time-midi","status":"publish","type":"post","link":"https:\/\/www.pschatzmann.ch\/home\/2022\/08\/25\/arduino-audio-tools-vs1053-real-time-midi\/","title":{"rendered":"Arduino Audio Tools – VS1053 And Real Time MIDI"},"content":{"rendered":"

The VS1053 and VS1003 audio codecs<\/strong> support real time MIDI<\/strong>. While the VS1003 only provides a few instruments, the VS1053 has 128 melodic instruments<\/strong> and quite a few additional percussion instruments!<\/p>\n

\"\"<\/p>\n

When GPIO0 is low and GPIO1 is high during boot, real-time MIDI mode is activated. Unfortunately these pins are not available on most breakout boards. In this case a patch<\/strong> can be used to activate it.<\/p>\n

When real time MIDI is active, you can send MIDI messages directly to the serial VS1003 input pin<\/strong>, but this is not available most of the time either. Fortunately you can also send the data via SPI<\/strong>, you just need to make sure that each MIDI byte is received as 2 byte word. I have extended my driver library<\/a> to perform this conversion automatically. So with this we can use any MIDI Library that supports the output to Arduino Streams<\/strong>. Fortunately I have implemented such a library<\/a> quite some time ago.<\/p>\n

Example<\/h2>\n

Here is a simple example<\/p>\n

#include \"AudioTools.h\"\n#include \"AudioLibs\/VS1053Stream.h\"\n#include \"Midi.h\"\n\n\nVS1053Stream vs1053; \/\/ final output\nMidiStreamOut midi_out(vs1053);\nuint8_t note = 65; \/\/ 0 to 128\nuint8_t amplitude = 128; \/\/ 0 to 128\nuint8_t instrument = 0;\n\nvoid selectInstrument(uint8_t instrument, uint8_t bank=0x00){\n  midi_out.controlChange(BANK_SELECT, bank);\n  \/\/ Patch change, select instrument\n  midi_out.programChange(instrument);\n}\n\nvoid setup() {\n    Serial.begin(115200);\n    AudioLogger::instance().begin(Serial, AudioLogger::Info);  \n\n \/\/ setup vs1053\n  auto cfg = vs1053.defaultConfig();\n  cfg.is_midi = true; \/\/ vs1053 is accepting streaming midi data\n  \/\/ Use your custom pins or define in AudioCodnfig.h\n  \/\/cfg.cs_pin = VS1053_CS; \n  \/\/cfg.dcs_pin = VS1053_DCS;\n  \/\/cfg.dreq_pin = VS1053_DREQ;\n  \/\/cfg.reset_pin = VS1053_RESET;\n  vs1053.begin(cfg);\n  vs1053.setVolume(1.0);\n\n}\n\nvoid loop() {\n    Serial.println();\n    Serial.print(\"playing \");\n    Serial.println(++note);\n\n    midi_out.noteOn(note, amplitude );\n    delay(900);\n    midi_out.noteOff(note, 20 );\n    delay(200);\n    if (note>=90) {\n      note = 64;\n      Serial.println();\n      Serial.print(\"selecting Instrument \");\n      Serial.println(++instrument);\n      selectInstrument(instrument);\n    }\n}\n<\/code><\/pre>\n
As you can see we just need to give a VS1053Stream object as argument to a MidiStreamOut object!
\nThis and further vs1053 examples can be found on Github<\/a>.<\/p>\n
Dependencies<\/h2>\n
You need to install the following libraries:<\/p>\n