|
|
|
|
# OSC2MidiGateway
|
|
|
|
|
|
|
|
|
|
(Fork of https://github.com/tadas-s/OSC2Midi with extensions)
|
|
|
|
|
|
|
|
|
|
ESP8266 based OSC <-> Midi wireless bridge.
|
|
|
|
|
|
|
|
|
|
It is mostly meant to be used with [TouchOSC][1] but it will work with
|
|
|
|
|
any [OSC message source][2].
|
|
|
|
|
|
|
|
|
|
## Library dependencies
|
|
|
|
|
|
|
|
|
|
Project uses:
|
|
|
|
|
* https://github.com/FortySevenEffects/arduino_midi_library/
|
|
|
|
|
* https://github.com/CNMAT/OSC
|
|
|
|
|
|
|
|
|
|
## Hardware
|
|
|
|
|
|
|
|
|
|
Based on a generic ESP8266-01 board using both GPIO pins as MIDI-I/O.
|
|
|
|
|
|
|
|
|
|
## OSC message formats
|
|
|
|
|
|
|
|
|
|
All messages are expected to have payload of 1 or 2 floats with range
|
|
|
|
|
from 0 to 127.
|
|
|
|
|
|
|
|
|
|
### /midi/cc/channel/{cc} + 1 float
|
|
|
|
|
|
|
|
|
|
Will send control change message for `{cc}` number.
|
|
|
|
|
|
|
|
|
|
### /midi/cc/channel/{ccA}/{ccB}/.../{index} + 1 float
|
|
|
|
|
|
|
|
|
|
Will send control change message for CC specified by `{index}`. For
|
|
|
|
|
example:
|
|
|
|
|
|
|
|
|
|
* /midi/cc/1/10/12/15/1 -> CC to 10 on channel 1
|
|
|
|
|
* /midi/cc/1/10/12/15/3 -> CC to 15 on channel 1
|
|
|
|
|
|
|
|
|
|
This is meant to be used with TouchOSC groups of faders. For example,
|
|
|
|
|
my [MicroKORG][6] preset includes a fader group of 4 to control
|
|
|
|
|
amp ADSR: `/midi/cc/1/73/75/70/72`
|
|
|
|
|
|
|
|
|
|
### /midi/cc/channel/{ccA}/{ccB} + 2 floats
|
|
|
|
|
|
|
|
|
|
This sends two control change messages to `{ccA}` and `{ccB}`. This is
|
|
|
|
|
meant to be used with TouchOSC XY pads.
|
|
|
|
|
|
|
|
|
|
[1]: http://hexler.net/software/touchosc
|
|
|
|
|
[2]: https://en.wikipedia.org/wiki/Open_Sound_Control
|
|
|
|
|
[3]: https://www.arduino.cc/en/Tutorial/Midi
|
|
|
|
|
[4]: http://libremusicproduction.com/tutorials/arduino-and-midi-in
|
|
|
|
|
[5]: https://www.arduino.cc/en/Reference/SoftwareSerial
|
|
|
|
|
[6]: http://www.korg.com/us/products/synthesizers/microkorg/
|
|
|
|
|
[7]: https://www.microchip.com/wwwproducts/en/en027785
|
|
|
|
|
[8]: https://github.com/tadas-s/esp8266-autoreset
|
|
|
|
|
|
