Update README.md

README.md

@@ -42,71 +42,62 @@ Serial port is used to send midi messages now.
 
 ### How does it works ? 
 
-PITCH : 
+PITCH ANTENNA (ROD): 
-It uses first note detected at volume rise to generate a NOTEON. 
+
-Then it uses PITCHBEND to reach pitch as long as pitch bend range will do. 
+It uses first note detected as hand moves away from from volume loop antenna to generate a NOTEON. 
-Beyond it generates a new NOTEON  followed by a NOTEOFF for the previous note (legato). 
+Then it can use PITCHBEND (if activated) to reach exact pitch as long as pitch bend range will do. 
+Beyond it can generate a new NOTEON followed by a NOTEOFF for the previous note if legato mode activated. 
 Pitch bend range can be configured (1, 2, 7, 12 or 24 semitones) to align with synth's maximum capabilities.
-One exception is that I desactivated pitch bend in 1 semitone mode because portamento does a better job then. 
 
-VOLUME: 
+It can also generate a midi continuous controler change if one is selected. 
-It generates VOLUME continuous controler, starting NOTEON and ending NOTE OFF (when playing staccato). 
+
+VOLUME ANTENNA (LOOP): 
+
+It generates selected midi continuous controler change, starting NOTEON and ending NOTE OFF (when playing staccato). 
 The trigger volume can be configured so as we have some volume at note attack on percussive sounds. 
 
-CONFIGURATION: 
+CALIBRATION:
-There is two calibration mode: 
+
- 1. If REGISTER POT turned counter clockwise at entering in calibration mode 
+This device runs normal calibration of antennas after pushing button for 3 seconds as per initial project
-         -> Runs normal calibration of antennas.
          
- 2. If REGISTER POT turned clockwise at entering in calibration mode 
+ SETTINGS:
-         -> Records midi settings as per pot position BEFORE entering in calibration mode:
  
-		VOLUME POT : sets volume trigger level
+ "Register" Pot becomes "Selected Parameter" pot and have 8 positions. 
+  "Timbre" pot become "Parameter's Value" and have variable number a position depending on selected parameter: 
  
-		PITCH POT : sets pitch bend range (1, 2, 7, 12 or 24 semitones) 
+ 1. Register: 4 positions as in original Open Theremin V3
-		Use exactly same pitch bend range on your synth. Maximum setting possible is recomended. 
+ 2. Timbre: 8 positions as in original Open Theremin V3
+ 3. Channel: 16 positions (channel 1 to 16)
+ 4. Rod antenna mode: 4 positions 
+     (Legato off/Pitch Bend off, Legato off/Pitch Bend on, Legato on/Pitch Bend off, Legato on/Pitch Bend on)
+ 5. Pitch bend range: 5 positions (1, 2, 7, 12, 24 Semitones)
+ 6. Volume trigger: 16 positions (0 to 127)
+ 7. Rod antenna cc: 5 positions 
+    (None, 8-Balance, 10-Pan, 16-Ribbon controler, 74-cutoff)
+ 8. Loop antenna cc: 8 positions 
+    (1-Modulation, 7-Volume, 11-Expression, 71-Resonnance, 74-Cutoff, 91-Reverb, 93-Chorus, 95-Phaser)
  
-		TIMBRE POT : sets Channel. In the absence of graduation, timbre variation may help 
-               (Wave Form 1 low = CH1, WF 1 High = CH2, WF 2 Low = CH3, etc...)
                 
 MUTE BUTTON: 
+
 Sends ALL NOTE OFF on selected channel and stay in mute until it's pushed again.  
 
 AUDIO: 
+
 Audio processing from antennas to output jack, including pots, LEDs and button functions, is exactly the same as in open theremin V3.  
 
 
 ### What can I do to get a theremin like glissando?
 
-Set pitch bend range of the theremin with a high value (12 semitones or 24 semitones).
+Activate picth bend and set pitch bend range of the theremin with a high value (12 semitones or 24 semitones).
-
 Set pitch bend range of the synth with the same value
 
-Closest to real theremin settings (pitch bend range = 24 semitones):
-
-  1. Set pots like this: Volume = Min, Pitch = Max, Register = Max, Timbre = Midi channel.
-
-  2. Push button for two seconds.
-
-  3. Then set pots as for audio (Example : Volume = Mid, Pitch = Mid, Register = Wanted octave, Timbre = any)
-
-  4. Play (you can mix synth and audio if you want)
-
- 
 
 ### If I do not trigger with the volume hand it also seems to trigger a new tone with the pitch antenna. Guess this is how MIDI works.
 
-Yes, with settings above, if you trigger a note (with volume loop) and go in one direction (with pitch antenna) a new note will be triggered after two octaves.
+When legato mode is activated if you trigger a note (with volume loop) and go in one direction (with pitch antenna) a new note will be triggered at the limit of pitch bend range. 
-
-This is a limitation of midi. Maybe some synth can perform pitch bend on more that 2 octaves but none of mine does...
-
-### Tweak
-In the following lines of application.cpp:
-
-      // Set key follow so as next played note will be at limit of pitch bend range
-      midi_key_follow = (double)(midi_bend_range) - 0.2;
 
-The "-0.2" could be changed into another value from "0" to "-0.5" depending on how good you are to reach center of the note that you play. "0" is for very good players. "-0.5" is very permissive and generates note toggling in 1 semitone mode. "-0.2" is the limit where my favourite chromatic tuner's green LED turns off (and it is OK for me).
+Legato mode is used as a workaround for a limitation of midi (max 24 semitone pitch bend). Maybe some synth can perform pitch bend on more that 2 octaves but none of mine does...
 
 
 ### LICENSE