You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenTheremin_V3_with_MIDI/README.md

117 lines
6.0 KiB

7 years ago
## Open Theremin V3 with MIDI interface control software for Arduino UNO
7 years ago
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
7 years ago
Urs makes also a very clear presentation of this MIDI feature on his website (many thanks !):
http://www.gaudi.ch/OpenTheremin/index.php?option=com_content&view=article&id=200&Itemid=121
### Don't click on the files!
7 years ago
Click on the "clone or download" Button to the right. Then unpack the archive.
### Open Source Theremin based on the Arduino Platform
Open.Theremin is an arduino shield to build the legendary music instrument invented by Leon Theremin back in 1920. The theremin is played with two antennas, one to control the pitch and one for volume. The electronic shield with two ports to connect those antennas comprises two heterodyne oscillators to measure the distance of the hand to the antenna when playing the instrument. The resulting signal is fed into the arduino. After linearization and filtering the arduino generates the instruments sound that is then played through a high quality digital analog audio converter on the board. The characteristics of the sound can be determined by a wave table on the arduino.
For more info on the open source project and on availability of ready made shield see:
http://www.gaudi.ch/OpenTheremin/
### Installation
1. Open up the Arduino IDE
2. Open the File "Open_Theremin_V3.ino"
7 years ago
3. In "Application.cpp", take care of selecting MIDI mode that correponds to your cituation (put "//" in front off inadequate line - MIDI through serial is selected by default here):
7 years ago
7 years ago
Serial.begin(115200); // Baudrate for midi to serial. Use a serial to midi router http://projectgus.github.com/hairless-midiserial/
7 years ago
7 years ago
//Serial.begin(31250); // Baudrate for real midi. Use din connection https://www.arduino.cc/en/Tutorial/Midi or HIDUINO https://github.com/ddiakopoulos/hiduino
7 years ago
I tested "Hiduino" and "midi to serial" modes, both are OK.
7 years ago
7 years ago
4. Selecting the correct usb port on Tools -> Serial Port
5. Select the correct arduino board from Tools -> Board
6. Upload the code by clicking on the upload button.
7 years ago
### Added and removed compare to Open Theremin V3.
7 years ago
Serial communication implemented for program monitoring purpose was removed (Particularly during calibration).
7 years ago
If you need to monitor calibration for antenna problem fixing, please use original master branch from
7 years ago
https://github.com/GaudiLabs/OpenTheremin_V3.
7 years ago
Serial port is used to send midi messages now.
7 years ago
### How does it work ?
7 years ago
7 years ago
PITCH ANTENNA (ROD):
It uses first note detected as hand moves away from from volume loop antenna to generate a NOTEON.
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.
7 years ago
Pitch bend range can be configured (1, 2, 7, 12 or 24 semitones) to align with synth's maximum capabilities.
7 years ago
7 years ago
It can also generate a midi continuous controler change if one is selected.
VOLUME ANTENNA (LOOP):
It generates selected midi continuous controler change, starting NOTEON and ending NOTE OFF (when playing staccato).
7 years ago
The trigger volume can be configured so as we have some volume at note attack on percussive sounds.
7 years ago
CALIBRATION:
This device runs normal calibration of antennas after pushing button for 3 seconds as per initial project
7 years ago
7 years ago
SETTINGS:
"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:
1. Register: 4 positions as in original Open Theremin V3
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)
7 years ago
5. Pitch bend range: 5 positions (1, 2, 7, 12, 24 Semitones).
7 years ago
For classical glissando and in order to have same note on audio and MIDI, use exactly same pitch bend range on your synth.
Maximum setting possible is recomended.
6. Volume trigger: 128 positions (0 to 127)
7 years ago
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)
7 years ago
Select a Parameter and move "Parameter's Value" to change corresponding setting.
7 years ago
Manipulation of "Rod antenna cc" and "Loop antenna cc" is not error proof. MIDI newbies should be advised to change their value in MUTE mode.
7 years ago
Default configuration is: Register = Lowest Register, Timbre = 1st Waveform, Channel = MIDI Channel 1, Rod antenna mode = Legato on/Pitch Bend on, Pitch bend range = 2 Semitones, Volume trigger = 0, Rod antenna cc = None, Loop antenna cc = 7-Volume.
7 years ago
7 years ago
MUTE BUTTON:
7 years ago
7 years ago
Sends ALL NOTE OFF on selected channel and stay in mute until it's pushed again.
7 years ago
AUDIO:
7 years ago
7 years ago
Audio processing from antennas to output jack, including volume and pitch pots, LEDs and button functions, is exactly the same as in open theremin V3.
7 years ago
7 years ago
7 years ago
### What can I do to get a theremin like glissando?
7 years ago
7 years ago
Activate picth bend and set pitch bend range of the theremin with a high value (12 semitones or 24 semitones).
7 years ago
Set pitch bend range of the synth with the same value
7 years ago
### 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.
7 years ago
7 years ago
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.
7 years ago
7 years ago
Legato mode is used as a workaround for a limitation of midi (max 24 semitones pitch bend). Maybe some synth can perform pitch bend on more that 2 octaves but none of mine does...
7 years ago
### LICENSE
7 years ago
Original project written by Urs Gaudenz, GaudiLabs, 2016
7 years ago
GNU license. This Project inherits this 2016 GNU License.
7 years ago
Check LICENSE file for more information
7 years ago
All text above must be included in any redistribution