Commit Graph

38 Commits

Author SHA1 Message Date
lathoub 2c657a38d1
Added support for Active Sensing and SysEx command segments (v4.4.0) (#138)
* stuff to ignore list

* Update midi_Defs.h

* added support for ActiveSensing

From: https://www.midi.org/specifications/item/table-1-summary-of-midi-message

Active Sensing. This message is intended to be sent repeatedly to tell the receiver that a connection is alive. Use of this message is optional. When initially received, the receiver will expect to receive another Active Sensing message each 300ms (max), and if it does not then it will assume that the connection has been terminated. At termination, the receiver will turn off all voices and return to normal (non- active sensing) operation.

* replaced ActiveSensing with Sender Active Sensing

Receiver active Sensing is not implemented (yet)

* added support for receiving SysEx command segments

Very long SysEx mesaages are cut in to multiple command segments
Where a normal SysEx starts with F0 and ends with F7, the first segment will start with F0 and end with F0, the middle section (optional) start with F7 and ends with F7 - the last segments starts with F7 and ends with F0

* lift and shift of the Serial code into a seperate class, allowing for other serializers

lift and shift of the Serial code into a seperate class, allowing for other serializers as AppleMIDI, USBMIDI, ipMIDI, BLE-MIDI

* added Platform class to abstract millis()

* add MidiType to beginTransmission

Avoids reparsing of the stream in the transport layer, in order to get the MidiType

* active sensing defaults to false, to avoid spamming devices

* set ActiveSensing Periodicity in ms

Gives more control over the bool value. Typical value is 300 (ms) - an Active Sensing command is send every 300ms; or 0 (zero) to disable sending ActiveSensing

* added namespace reference

* renamed Encoder -> Transport, added MidiType to beginTransmission in serialMIDI

* added callback for Message

before the specific callback are called, a generic mMessage callback can be fired to inform the user that 'a' message has been received.

* added send(MidiMessage), added (untested) bridge example

added send(MidiMessage) for Bridge application (that convert MIDI transport x into MIDI transport y), avoiding parsing entry a stream, setting up all callback - whilst this allows for passing the content, without to much processing/parsing.

Had to move mPendingMessageExpectedLenght into MidiMessage to avoid parsing the data again, just to know the size

Added Bridge example (untested)

* changed based on Franky47's feedback

- send: pass the message as a const ref, to avoid copies
- add mSerial.begin (with Baudrate - added Settings)
- ThruActivated defaults to true
- class name serialMIDI => SerialMIDI

* return reference to Transport layer

* return a *pointer* (not a ref) to the transport layer

* mPendingMessageExpectedLength as before

mMessage.length is reset to 0 before the callback, so bring back mPendingMessageExpectedLength as before, and set mMessage.length (and not reset it)

* DefaultPlatform for Arduino

* strong typing Channel in the callbacks

* aliasing for callbacks (and default initializers

* cleanup setHandleMessage

unfortunately, not using aliases yet (too complex)

* Fixed "FML" case: fall down here with an overflown SysEx..

Splitting larger incoming messages into smaller SysEx packets - using an RrtpMidi trick:
            //   first:  0xF0 .... 0xF0
            //   midlle: 0xF7 .... 0xF0
            //   last:   0xF7 .... 0xF7

see: https://tools.ietf.org/html/rfc4695#section-3.2

(Understanding this is not part of the original MIDI spec, but does allow for receiving very very large SysEx messages on a small footprint (does require some 'handy' parsing))

SysExMaxSize in Settings can be reduced significatly (16bytes works fine - pending use case)

* + receiver ActiveSensing, + error Callback

1) Active Sensing:
Once an ActiveSensing message is received, the system checks for timeouts: if no message is received within the specified 300ms (see in _Defs), an error is set and the checks for timeout stop.

2) added a callback for errors. 2 errors are defined: parse error and ActiveSensing timeout

* cleanup of basic example

use LED_BUILTIN

* + Manufacturer System Exclusive ID (incomplete)

* + noteValues

* added SendCommon, consistent with SendRealTime

including:

sendClock, sendStart, sendStop, sendContinue, sendActiveSensing, sendSystemReset

* UseSenderActiveSensing & UseReceiverActiveSensing to enable/disable Active Sensing

UseSenderActiveSensing & UseReceiverActiveSensing in Settings are global switches to turn on/off ActiveSensing (and save memory)

* use #defined value, not the literal

* cleanup

* removed deprecated MidiFilterMode (to be removed for v5)

* getting ready for v5

* prepare for v5

* updating authors

* Removed USB examples

* added header

* removed typedef

when instanciating multiple instances of SerialMIDI, a redefinition error accors because of typing of the serial##Name.
Fix: removed the typdef, a bit harder to read, but avoided complex #ifdef

* move bridge example to other Transport mechanisms

* Update Bench.ino

* Create NoteNames.ino

demonstrate use of MIDI_NAMESPACE::NoteValues[inNote].strptr

* moved #version to MIDI.h

#version of the library does not belong in general MIDI definitions
(making midi_Defs.h as generic as possible - usable on other platforms)

* adding comment section

* shorter syntax using iif

* moved code to avoid doc clash

* added Tick (0xF9)

* Simplified NoteValues

Need need for extra index (that is the same as the noteName anyway)

* Removed Undefined_F9 (Tick) as an invalid token (so it valid now)

* removed references to USB in the test scripts

* setting the CMake env

* removed USB references

* struggling with travis

* LCOV_EXCL_LINE in sendCommon

* order of initialization

* reorder variables for initialisation

* extending platforms

* adding boards (but not the Zero)

* fixing cmake

* moved RingBuffer to SerialMock

* fix cmake removing RingBuffer

* Update CMakeLists.txt

* using bitwire operators (works on all platforms)

* Update midi_Platform.h

* removed NoteNames

* simplify test (will be rolled back later)

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* Revert "Update midi_Platform.h"

This reverts commit bd2f6476b2.

* bring in other Platform (remove usb)

* added BaudRate

* Revert "using bitwire operators (works on all platforms)"

This reverts commit 122ebe1dc3.

* Revert "moved code to avoid doc clash"

This reverts commit ef878344cd.

* restored after very funcky commits and rollbacks (Sorry!)

* add Transport layer

* removed SerialMock test

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* fixed MidiInterface<SerialMock => MidiInterface<Transport

* SerialMIDI should not aware of the channel

* Update unit-tests_MidiThru.cpp

* Update midi_Defs.h

* avoid shadow parameters and buf fix

* Update CMakeLists.txt

* Update unit-tests_MidiOutput.cpp

* Update midi_Settings.h

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* Update unit-tests_MidiInput.cpp

* tmp removed teensy, bug fix sendCommon (unsigned, not byte)

* Update unit-tests_MidiInput.cpp

* fix for Leonardo

* Update DualMerger.ino

* adding tests_MidiInputCallbacks

* Update unit-tests_MidiInputCallbacks.cpp

* preparing to release 5.0.0

* added Alternative Pin for Serial port example

* default listen on all channel as in #96

* Update unit-tests_MidiInput.cpp

Co-authored-by: lathoub <lathoub@gmail.com>
2020-04-08 10:36:10 +02:00
lathoub f067883dd8
changed default size of enums (int) to a smaller type
Easily save over 200 bytes for the library by using the smallest type for these MIDI types.
2019-08-18 06:52:50 +02:00
Francois Best 9b9905fb2a chore: Bump version to 4.4.0 2018-03-10 15:44:46 +01:00
Francois Best 9a4b8b6c86 Merge branch 'master' into dev. 2016-11-04 23:27:01 +01:00
Francois Best 77bb518f19 Using recommended default HW serial port.
Relates to #65.
2016-11-04 23:22:45 +01:00
David Menting 32489bc0ea Added default serial port for Teensy 3.0/3.1/3.2 and Teensy LC 2016-11-04 12:36:21 +01:00
Francois Best 82f5dca265 Bumped version to 4.3.1, fixing Arduino lib file.
Removed redundant version mentions in sources.
2016-11-04 10:53:18 +01:00
Francois Best aa35573ca6 Added version defines, might be useful later on. 2016-10-30 09:55:30 +01:00
Francois Best 437d5ebce0 Bump version in sources. 2016-10-30 09:50:01 +01:00
Francois Best 7117671b16 Fix. 2016-10-27 08:04:15 +02:00
Francois Best 37e72bc7fa Stay consistant in enums first letter case. 2016-10-27 08:02:34 +02:00
Francois Best 58880bb647 gcc does not like individual deprecated attributes. 2016-10-21 07:52:12 +02:00
Francois Best 6fc3e38512 Moved Thru defs to own scope to avoid pollution. 2016-10-21 07:43:46 +02:00
Francois Best 96374a1fa1 Added RPN/NRPN sending facilities.
Needs doc, closes #37.
2016-10-07 00:38:27 +02:00
Francois Best 5b3e4ac097 Fix warnings. 2016-04-24 18:27:16 +02:00
Francois Best 79c01a27a4 Added RPN/NRPN definitions. 2016-04-03 17:58:33 +02:00
Francois Best fb693e7245 Changed license to MIT. 2015-08-13 09:03:17 +02:00
Francois Best e1f8dcc380 Doc. 2014-06-11 09:44:55 +02:00
Francois Best e31d0a1910 Doc. 2014-06-11 09:33:32 +02:00
Francois Best b1b978d63c 4.2 2014-06-11 09:13:34 +02:00
Francois Best 219340ea96 Fix SysEx size callback bug, using template settings instead of preprocessor macros. 2014-06-11 09:09:08 +02:00
Francois Best f88012b38f Removed auto-instanciation 2014-04-20 17:24:35 +02:00
Francois Best 410e51c91a Template settings. 2014-04-20 17:23:10 +02:00
Francois Best 240cd22021 Added explicit license header and starting 4.1 branch. 2014-04-01 09:03:44 +02:00
Francois Best b2800e5fdd Doc & formatting. 2014-02-13 21:58:37 +01:00
Francois Best 601ddb3773 Reverted Thru changes on branch release/4.0 (breaking thread/merge-safety). 2013-07-07 15:10:13 +02:00
Francois Best cc9927fd50 Fixed build. 2013-07-07 14:53:56 +02:00
Francois Best d78cace1b2 Working on thru. 2013-07-07 14:13:32 +02:00
Francois Best 8c9d289216 Working on thru. 2013-07-07 12:52:27 +02:00
Francois Best 2f828fe2bc Define byte type as we're safe in the midi namespace anyway. 2012-11-07 12:28:42 +01:00
Francois Best 5a55f715da Fixed bugs on SysEx reception. 2012-10-08 22:12:42 +02:00
Francois Best ac86227ed1 Updated doc. 2012-10-08 07:50:19 +02:00
Francois Best 5fe1ca0697 Updated doc. 2012-10-02 22:36:07 +02:00
Francois Best 691b172187 Target detection and simplified auto-instanciation. 2012-10-02 21:51:18 +02:00
Francois Best a63afb0868 Added multiple instanciation. 2012-09-27 21:13:57 +02:00
Francois Best 69604e458b Made unique set of files, to avoid stupid branches. 2012-09-06 20:41:25 +02:00
Francois Best 4b8b38aeaf Quake wip. 2012-09-05 18:32:42 +02:00
Francois Best 5a42cb006d Starting quake. 2012-09-04 09:09:07 +02:00