From 5e95f9062f69887f684cef0b425d973e687aadda Mon Sep 17 00:00:00 2001 From: MrDham Date: Sun, 1 Nov 2020 13:05:21 +0100 Subject: [PATCH 1/4] Add files via upload --- Open_Theremin_V3/application.cpp | 39 ++++++++++++++++++++++++-------- 1 file changed, 30 insertions(+), 9 deletions(-) diff --git a/Open_Theremin_V3/application.cpp b/Open_Theremin_V3/application.cpp index e692342..278034f 100644 --- a/Open_Theremin_V3/application.cpp +++ b/Open_Theremin_V3/application.cpp @@ -33,8 +33,9 @@ static uint8_t old_midi_loop_cc_val =0; static uint8_t midi_velocity = 0; static uint8_t loop_hand_pos = 0; -static uint8_t new_midi_rod_cc_val =0; -static uint8_t old_midi_rod_cc_val =0; + +static uint16_t new_midi_rod_cc_val =0; +static uint16_t old_midi_rod_cc_val =0; static uint16_t new_midi_bend =0; static uint16_t old_midi_bend = 0; @@ -55,6 +56,7 @@ static uint8_t flag_legato_on = 1; static uint8_t flag_pitch_bend_on = 1; static uint8_t loop_midi_cc = 7; static uint8_t rod_midi_cc = 255; +static uint8_t rod_midi_cc_lo = 255; // tweakable paramameters #define VELOCITY_SENS 9 // How easy it is to reach highest velocity (127). Something betwen 5 and 12. @@ -518,8 +520,8 @@ void Application::delay_NOP(unsigned long time) { void Application::midi_setup() { // Set MIDI baud rate: - Serial.begin(115200); // Baudrate for midi to serial. Use a serial to midi router http://projectgus.github.com/hairless-midiserial/ - //Serial.begin(31250); // Baudrate for real midi. Use din connection https://www.arduino.cc/en/Tutorial/Midi or HIDUINO https://github.com/ddiakopoulos/hiduino + //Serial.begin(115200); // Baudrate for midi to serial. Use a serial to midi router http://projectgus.github.com/hairless-midiserial/ + Serial.begin(31250); // Baudrate for real midi. Use din connection https://www.arduino.cc/en/Tutorial/Midi or HIDUINO https://github.com/ddiakopoulos/hiduino _midistate = MIDI_SILENT; } @@ -577,7 +579,7 @@ void Application::midi_application () } // Calculate rod antena cc value for midi - new_midi_rod_cc_val = round (double_log_freq); + new_midi_rod_cc_val = round (double_log_freq * 128); // 14 bit value ! // State machine for MIDI switch (_midistate) @@ -595,9 +597,16 @@ void Application::midi_application () } // Always refresh midi rod antena cc if applicable. - if ((rod_midi_cc != 255) && (new_midi_rod_cc_val != old_midi_rod_cc_val)) + if (new_midi_rod_cc_val != old_midi_rod_cc_val) { - midi_msg_send(midi_channel, 0xB0, rod_midi_cc, new_midi_rod_cc_val); + if (rod_midi_cc != 255) + { + if (rod_midi_cc_lo != 255) + { + midi_msg_send(midi_channel, 0xB0, rod_midi_cc_lo, (uint8_t)(new_midi_rod_cc_val & 0x007F)); + } + midi_msg_send(midi_channel, 0xB0, rod_midi_cc, (uint8_t)(new_midi_rod_cc_val >> 7)); + } old_midi_rod_cc_val = new_midi_rod_cc_val; } else @@ -656,9 +665,16 @@ void Application::midi_application () } // Always refresh midi rod antena cc if applicable. - if ((rod_midi_cc != 255) && (new_midi_rod_cc_val != old_midi_rod_cc_val)) + if (new_midi_rod_cc_val != old_midi_rod_cc_val) { - midi_msg_send(midi_channel, 0xB0, rod_midi_cc, new_midi_rod_cc_val); + if (rod_midi_cc != 255) + { + if (rod_midi_cc_lo != 255) + { + midi_msg_send(midi_channel, 0xB0, rod_midi_cc_lo, (uint8_t)(new_midi_rod_cc_val & 0x007F)); + } + midi_msg_send(midi_channel, 0xB0, rod_midi_cc, (uint8_t)(new_midi_rod_cc_val >> 7)); + } old_midi_rod_cc_val = new_midi_rod_cc_val; } else @@ -900,21 +916,26 @@ void Application::set_parameters () { case 0: rod_midi_cc = 255; // Nothing + rod_midi_cc_lo = 255; // Nothing break; case 1: case 2: rod_midi_cc = 8; // Balance + rod_midi_cc_lo = 40; // Balance least significant bits break; case 3: case 4: rod_midi_cc = 10; // Pan + rod_midi_cc_lo = 42; // Pan least significant bits break; case 5: case 6: rod_midi_cc = 16; // Ribbon Controler + rod_midi_cc_lo = 48; // Ribbon Controler least significant bits break; default: rod_midi_cc = 74; // Cutoff (exists of both loop and rod) + rod_midi_cc_lo = 255; // No least significant bits break; } break; From 4b447df925b11dd1aa8e03e92431fc3dce9820c4 Mon Sep 17 00:00:00 2001 From: MrDham Date: Sun, 1 Nov 2020 13:34:50 +0100 Subject: [PATCH 2/4] Add files via upload --- Quick guide open theremin midi.bmp | Bin 2677422 -> 2677422 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/Quick guide open theremin midi.bmp b/Quick guide open theremin midi.bmp index 072e7bb2a7873a48108d4ff90046a2d1bb10c37b..e9e6b79ec1a999a0aa8453bf595b44ec9f424b04 100644 GIT binary patch delta 47849 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 D7Hd;0 From 8c4c8634a57d22b7895ead626255dffa60d7f4fe Mon Sep 17 00:00:00 2001 From: MrDham Date: Sat, 7 Nov 2020 12:10:25 +0100 Subject: [PATCH 3/4] Update README.md --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e2edb2c..bae50ab 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -## Open Theremin V3 with MIDI interface control software V2.3 for Arduino UNO +## Open Theremin V3 with MIDI interface control software V2.4 for Arduino UNO Based on Arduino UNO Software for the Open.Theremin version 3.0 Copyright (C) 2010-2016 by Urs Gaudenz https://github.com/GaudiLabs/OpenTheremin_V3 -This Open Theremin V3 with MIDI version V2.3 also takes into account +This Open Theremin V3 with MIDI version V2.4 also takes into account Changes added in Open.Theremin version 3.1 (all by @Theremingenieur): Fix a wavetable addressing issue (found by @miguelfreitas) @@ -16,6 +16,8 @@ Changes added in Open.Theremin version 3.1 (all by @Theremingenieur): Pitch Bend Range choice is also extended (Allows 4 octaves Bend) +MIDI CC from Pitch antenna (Rod) have 14 Bit resolution when applicable. Example of application: you can create a software synth controled with CC7 for volume and CC16 (MSB) - CC48 (LSB) for pitch without using Note On/Off and Pitch Bend messages. + Urs also made a very clear presentation of the MIDI feature on his website: http://www.gaudi.ch/OpenTheremin/index.php?option=com_content&view=article&id=200&Itemid=121, many thanks ! ### Don't click on the files! From a370f83e3b30fc609263750a2eeaf58caaccfed6 Mon Sep 17 00:00:00 2001 From: MrDham Date: Sat, 7 Nov 2020 12:29:04 +0100 Subject: [PATCH 4/4] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index bae50ab..d0954d7 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ Changes added in Open.Theremin version 3.1 (all by @Theremingenieur): Pitch Bend Range choice is also extended (Allows 4 octaves Bend) -MIDI CC from Pitch antenna (Rod) have 14 Bit resolution when applicable. Example of application: you can create a software synth controled with CC7 for volume and CC16 (MSB) - CC48 (LSB) for pitch without using Note On/Off and Pitch Bend messages. +MIDI CC from Pitch antenna (Rod) have 14 Bit resolution when applicable. Example of application: you can create a software synth controled by CC7 for volume and CC16 (MSB) - CC48 (LSB) for pitch without using Note On/Off and Pitch Bend messages. Urs also made a very clear presentation of the MIDI feature on his website: http://www.gaudi.ch/OpenTheremin/index.php?option=com_content&view=article&id=200&Itemid=121, many thanks ! @@ -99,7 +99,7 @@ Let's consider a Fade-in / Picth Variation / Fade-out sequence (I use right hand Maximum setting possible is recomended. 6. Volume trigger / Velocity sensitivity (how fast moves the volume loop's hand): 128 positions (0 to 127) 7. Rod antenna MIDI CC: 5 positions - (None, 8-Balance, 10-Pan, 16-Ribbon controler, 74-cutoff) + (None, 8-MSB/40-LSB-Balance, 10-MSB/42-LSB-Pan, 16-MSB/48-LSB-Ribbon controler, 74-cutoff) 14 Bit messages are sent in the following order: LSB (1st), MSB (2nd). 8. Loop antenna MIDI CC: 8 positions (1-Modulation, 7-Volume, 11-Expression, 71-Resonnance, 74-Cutoff, 91-Reverb, 93-Chorus, 95-Phaser)