Commit Graph

61 Commits

Author SHA1 Message Date
lathoub c9d3b9b592 no chaining for private functions, added example 2021-10-10 15:33:28 +02:00
lathoub 2012e2a84a chaining for all commands, callbacks and setters 2021-10-10 12:04:08 +02:00
Francois Best 7ca289d84e chore: Fix internal method casing 2021-08-06 09:35:54 +02:00
Francois Best d600656f04 Merge branch dev into master 2020-04-20 17:09:02 +02:00
lathoub 45fb2df88f
listen on channel 1 by default
Listening to all channels by default breaks backward compatibility
2020-04-20 14:17:43 +02:00
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
Jacek Roszkowski 98f7bb8831
Corrected typo: Lenght - Length 2018-06-22 20:40:43 +02:00
Francois Best 1c01effbd9 feat: Handle Korg-style of flipping SysEx data header bits
Closes #92
2018-03-10 16:58:17 +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 437d5ebce0 Bump version in sources. 2016-10-30 09:50:01 +01:00
Francois Best 5d3cbd1f9f #54: added overload of sendAfterTouch for poly. Deprecates sendPolyPressure. 2016-10-28 09:13:06 +02:00
Francois Best f1f0ef41ce Using new definitions for Thru. 2016-10-27 08:11:29 +02:00
Francois Best 8ebd4f9161 Cleanup & init'd thru. 2016-10-20 10:08:00 +02:00
Francois Best e4bd7f1c18 Fix initialization order warnings. 2016-10-13 19:01:59 +02:00
Francois Best 606e732490 Moved examples & keywords.txt to follow 1.5 lib spec. 2016-10-10 15:38:08 +02:00
Francois Best 96374a1fa1 Added RPN/NRPN sending facilities.
Needs doc, closes #37.
2016-10-07 00:38:27 +02:00
Francois Best 993f12ce30 Added accessor to settings template arg. 2016-10-04 18:55:27 -07:00
Francois Best fb693e7245 Changed license to MIT. 2015-08-13 09:03:17 +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 b041abaca3 Helper method. 2014-04-01 09:04:31 +02:00
Francois Best 240cd22021 Added explicit license header and starting 4.1 branch. 2014-04-01 09:03:44 +02:00
Francois Best 3f1e5c474a Handling null-velocity NoteOn as NoteOff (with setting), inlined some methods. 2014-03-12 21:34:46 +01:00
Francois Best b2800e5fdd Doc & formatting. 2014-02-13 21:58:37 +01:00
Francois Best c4d5d76f4a unsigned int -> unsigned and trimmed whitespace. 2013-07-07 15:11:58 +02: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 d8e0631399 Include ak47 for trace and debug info. 2013-07-06 16:00:24 +02:00
Francois Best 1d10ce0a46 No need for channel info when parsing. 2013-07-06 15:53:40 +02:00
Francois Best 6fbc9bd5a7 Reworked encoding/decoding methods to support larger arrays. 2013-07-05 11:21:13 +02:00
Francois Best 287b3625db Renamed file for ST's counterpart detection. 2013-06-28 09:09:47 +02:00
Francois Best 6f0535be90 Added detection of channel messages to fix running status. 2012-10-09 08:28:24 +02:00
Francois Best 691b172187 Target detection and simplified auto-instanciation. 2012-10-02 21:51:18 +02:00
Francois Best d8b0d6f838 Moved encode/decode sysex out of MidiInterface. 2012-09-27 21:23:15 +02:00
Francois Best a63afb0868 Added multiple instanciation. 2012-09-27 21:13:57 +02:00
Franky47 2ce571d937 Added SysEx conversion static methods. Note: could be integrated in SysEx send/receive methods.. 2012-09-26 08:33:29 +02:00
Francois Best 69604e458b Made unique set of files, to avoid stupid branches. 2012-09-06 20:41:25 +02:00
Francois Best ea96fbd211 Removed unused includes. 2012-09-06 11:16:44 +02:00
Francois Best 7fcb0d1e44 Building in Arduino 1.0.1 (templates did not work). 2012-09-06 10:57:11 +02:00
Francois Best 5078e0527e Experiment with templates. 2012-09-05 18:58:37 +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
Francois Best efd72f9df6 Merge branch 'avr_core' into Arduino 2012-07-03 08:10:45 +02:00
Francois Best bdd7d15b8a Added control change enumeration. 2012-06-20 18:40:57 +02:00
Francois Best 44f6f78454 Reverted last commit (won't work). 2012-06-17 12:45:06 +02:00