Skip to content

Arduino MIDI Library v4.3

Choose a tag to compare

View all tags
@franky47 franky47 released this 02 Nov 19:14
· 137 commits to master since this release
4.3
e1e6e98

This release brings support for RPN/NRPN sending, as well as an experimental external parser for RPN and NRPN input messages (provided in an example).

One of the major changes under the hood is that Running Status is now disabled by default, as it caused a lot of issues for some people. If your receiving hardware supports it and you want to enable it again for the extra performance, have a look at how to use custom settings.

It also adds a very early experimental native USB demo by tapping into MIDIUSB (therefore will require the dependency to run the example). Full-fledged low-latency native USB MIDI is planned for the next release.

Most of the changes were internal, to fit into the new Arduino library structure guidelines and to leverage modern FLOSS development facilities (unit testing, code coverage, continuous integration).

Changelog

New Features

  • #37 - Send RPN & NRPN (select controller number, send plain values or increment/decrement directives).

Bug Fixes

  • #53 - Fixed sendPitchBend(-1.0) which did not output a zero value.
  • #58 - Fix detection of interleaved Undefined bytes.
  • #61 - Don't invalidate Running Status when not sending anything (invalid send data).

API Changes

Breaking Changes

  • Negative range of float/double signature of sendPitchBend extended to fix #53.
  • Sending Tune Requests through sendRealTime is no longer supported. Replace MIDI.sendRealTime(midi::TuneRequest); with MIDI.sendTuneRequest();

RPN / NRPN API

  • Replaced midi::RPN with midi::RPNLSB
  • Replaced midi::NRPN with midi::NRPNLSB
  • Replaced midi::DataEntry with midi::DataEntryMSB

Non-Breaking Changes

The following changes mark the following old parts of the API as deprecated.

They are kept for backwards compatibility, but should not be used for new sketches. The old definitions will be removed in the next release.

  • Added sendAfterTouch with note, value and channel arguments as an alias of sendPolyPressure (now deprecated).
  • Moved Thru definitions to own sub-scope.
    • Replaced midi::Off with midi::Thru::Off
    • Replaced midi::Full with midi::Thru::Full
    • Replaced midi::SameChannel with midi::Thru::SameChannel
    • Replaced midi::DifferentChannel with midi::Thru::DifferentChannel

Other Changes

  • Default value for UseRunningStatus setting is now false. To benefit from Running Status again, use custom settings.
Assets 3
Loading