{"id":854,"date":"2013-03-08T12:51:49","date_gmt":"2013-03-08T10:51:49","guid":{"rendered":"http:\/\/tomashg.com\/?p=854"},"modified":"2013-05-15T17:07:49","modified_gmt":"2013-05-15T15:07:49","slug":"midi-elements-teensy-library","status":"publish","type":"post","link":"https:\/\/tomashg.com\/?p=854","title":{"rendered":"MIDI Elements Teensy Library"},"content":{"rendered":"

\"\"<\/a><\/p>\n

I have created a wrapper library to make programming MIDI controllers on the Teensy board dead easy and super fast. Simply instantiate object for each component like Buttons, Potentiometer, LED, rotary encoders, etc. and let the library handle all the dirty work of reading the raw values and deciding when to send MIDI signals. Enabling you to experiment and concentrate on your creative ideas and not waste too much time with the repetitive technical details and debugging code.<\/p>\n

Just in a couple lines of code you can program a fully functioning MIDI controller.
\nHere’s an example of how simple things are:<\/p>\n

boolean debug=false; \/\/ print to serial instead of midi\r\nboolean secondary=true; \/\/ enable secondary midi messages\r\nint midiChannel=1; \/\/ midi channel number\r\n\r\n\/\/ declare all your components here\r\nButton but(17,midiChannel,1,secondary,debug); \/\/ button 1 on pin 17\r\nButton but2(16,midiChannel,2,secondary,debug); \/\/ button 2 on pin 16\r\nPotentiometer pot(45,midiChannel,3,secondary,debug); \/\/ knob on pin 45 (A7)\r\nLed led(15,midiChannel,3,true); \/\/ led on pin 15 with PWM enabled, triggered on the same number as pot\r\n\r\nvoid setup(){\r\n  usbMIDI.setHandleControlChange(OnControlChange); \/\/ set event handler for CC\r\n}\r\n\r\nvoid loop(){\r\n  \/\/ add here all the input component reads\r\n  pot.read(); \/\/ read knob and send midi messages\r\n  but.read(); \/\/ read buttons and send midi messages\r\n  but2.read();\r\n  usbMIDI.read(); \/\/ read all the incoming midi messages\r\n}\r\n\/\/====================================================================\r\n\/\/ event handlers\r\nvoid OnControlChange(byte channel, byte control, byte value){\r\n  \/\/ add all your output component sets that will trigger with cc\r\n  led.setOn(channel,control,value);\r\n}<\/pre>\n
Currently only Buttons, Potentiometers and LEDs are supported. But I’m planning on adding RGB LED, rotary encoder, LED bars and ring and button pad classes.
\nEach component sends two sets of MIDI signals if enabled. For example Buttons send NoteOn, NoteOff, as well as ControlChange values so that they could be easily mapped in Toggle or Instant mode in software like Ableton Live. Also the Potentiometers send secondary NoteOns when values reach 0 or 127, \u00e0 la MIDI Fighter Pro.<\/p>\n
Download:<\/strong> github<\/a>
\nTo install extract the MIDIElements folder in your arduino\/libraries directory<\/p>\n
<\/p>\n
Here are the methods for each class:<\/p>\n
Button:<\/strong><\/span>
\nConstructors<\/em><\/p>\n
Button(byte pin);<\/strong>
\nCreates a button object with default channel 0, MIDI number 0 and debugging enabled
\npin – pin number on Teensy<\/p>\n
Button(byte pin, byte channel, byte number);<\/strong>
\nCreates a button object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent<\/p>\n
Button(byte pin, byte channel, byte number, bool secondary);<\/strong>
\nCreates a button object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent
\nsecondary – send secondary midi signals<\/p>\n
Button(byte pin, byte channel, byte number, bool secondary, bool debugging);<\/strong>
\nCreates a button object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent
\nsecondary – send secondary midi signals
\ndebugging – print messages to serial port instead of midi<\/p>\n
Functions<\/em>
\nread();<\/strong>
\nReads the button state and sends a midi note on if the button was pressed and note off if the button was unpressed on the channel and midi number specified in the constructor<\/p>\n
readValue(bool &stateChanged);<\/strong>
\nReads the button state, and sets the stateChanged if the state changed from the last time checked, also returns true if the button is pressed and false if not pressed. No MIDI signals are sent.
\nstateChanged – is set to true after the function exits if the button state changed state<\/p>\n
setVelocity(byte velocity);<\/strong>
\nChanges the velocity value for note on messages, default velocity is 127.
\nvelocity – note on velocity<\/p>\n
Potentiometer:<\/strong><\/span>
\nConstructors<\/em><\/p>\n
Potentiometer(byte pin);<\/strong>
\nCreates a potentiometer object with default channel 0, MIDI number 0 and debugging enabled
\npin – pin number on Teensy<\/p>\n
Potentiometer(byte pin, byte channel, byte number);<\/strong>
\nCreates a potentiometer object on specified channel and MIDI CC number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent<\/p>\n
Potentiometer(byte pin, byte channel, byte number, bool secondary);<\/strong>
\nCreates a potentiometer object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent
\nsecondary – send secondary midi signals<\/p>\n
Potentiometer(byte pin, byte channel, byte number, bool secondary, bool debugging);<\/strong>
\nCreates a potentiometer object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which messages will be sent
\nnumber – midi value on which messages will be sent
\nsecondary – send secondary midi signals
\ndebugging – print messages to serial port instead of midi<\/p>\n
Functions<\/em>
\nread();<\/strong>
\nReads the potentiometer value and sends a control changed if the value changed on the channel and midi number specified in the constructor<\/p>\n
readValue(bool &stateChanged);<\/strong>
\nReads the potentiometer value, and sets the stateChanged if the state changed from the last time checked, also returns the value of the potentiometer. No MIDI signals are sent.
\nstateChanged – is set to true after the function exits if the button state changed state<\/p>\n
Led:<\/strong><\/span>
\nConstructors<\/em><\/p>\n
Led(byte pin);<\/strong>
\nCreates a Led object with default channel 0, MIDI number 0 and debugging enabled
\npin – pin number on Teensy<\/p>\n
Led(byte pin, byte channel, byte number);<\/strong>
\nCreates a Led object on specified channel and MIDI CC number
\npin – pin number on Teensy
\nchannel – midi channel on which led will be triggered
\nnumber – midi value on which led will be triggered<\/p>\n
Ledr(byte pin, byte channel, byte number, bool pwm);<\/strong>
\nCreates a Led object on specified channel and MIDI number
\npin – pin number on Teensy
\nchannel – midi channel on which led will be triggered
\nnumber – midi value on which led will be triggered
\npwm – enable pulse width modulation<\/p>\n
Functions<\/em>
\nsetOn(byte channel, byte number, byte velocity);<\/strong>
\nCall from within Note On or Control Change event handler and pass on the parameters. And the LED will turn on if the messages received correspond to those specified in the constructor.
\nchannel – midi channel of the received message
\nnumber – midi number or control change of the received message
\nvelocity – midi velocity or control change value of the received message<\/p>\n
setOff(byte channel, byte number, byte velocity);<\/strong>
\nCall from within Note Off event handler and pass on the parameters. And the LED will turn off if the messages received correspond to those specified in the constructor.
\nchannel – midi channel of the received message
\nnumber – midi number or control change of the received message
\nvelocity – midi velocity or control change value of the received message<\/p>\n","protected":false},"excerpt":{"rendered":"
I have created a wrapper library to make programming MIDI controllers on the Teensy board dead easy and super fast. Simply instantiate object for each component like Buttons, Potentiometer, LED, rotary encoders, etc. and let the library handle all the dirty work of reading the raw values and deciding when to send MIDI signals. Enabling […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[112,32],"tags":[40,15,148,94,233,149],"class_list":["post-854","post","type-post","status-publish","format-standard","hentry","category-controllers","category-technology","tag-c","tag-framework","tag-library","tag-midi","tag-teensy","tag-wrapper"],"_links":{"self":[{"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/posts\/854","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tomashg.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=854"}],"version-history":[{"count":43,"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/posts\/854\/revisions"}],"predecessor-version":[{"id":926,"href":"https:\/\/tomashg.com\/index.php?rest_route=\/wp\/v2\/posts\/854\/revisions\/926"}],"wp:attachment":[{"href":"https:\/\/tomashg.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=854"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tomashg.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=854"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tomashg.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=854"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}