Skip to content

v0.3.0 - rename to midi2cpp + midi2 v0.3.4

Choose a tag to compare

@sauloverissimo sauloverissimo released this 09 May 12:46
3177103

Renamed from midi2_cpp to midi2cpp in deference to starfishmod/MIDI2_CPP (maintained since 2021 by Andrew Mee, MIDI Association TSB Rep), which operates in the same domain. Keeping the namespaces disjoint avoids confusion in package managers and search.

This is a breaking release. Every consumer-facing identifier moved.

Breaking

  • Repository: github.com/sauloverissimo/midi2_cpp -> github.com/sauloverissimo/midi2cpp (the old URL redirects on GitHub).
  • Header: <midi2_cpp.h> -> <midi2cpp.h>. using namespace midi2; and the m2device / m2host / m2bridge / m2ci aliases are unchanged.
  • CMake target / alias: midi2_cpp -> midi2cpp; midi2_cpp::midi2_cpp -> midi2cpp::midi2cpp.
  • Preprocessor macros: MIDI2_CPP_* -> MIDI2CPP_* (MIDI2CPP_BUILD_TESTS, MIDI2CPP_MAX_PROFILES, MIDI2CPP_MAX_PROPERTIES, MIDI2CPP_MAX_SUBSCRIBERS, MIDI2CPP_HOST_MAX_DEVICES, MIDI2CPP_BRIDGE_MAX_SLOTS).
  • Manifests: library.properties name=midi2cpp, library.json "name": "midi2cpp".

Changed

  • midi2 dependency bumped to v0.3.4 across every install path. midi2 v0.3.4 fixes the ESP-IDF Component Manager gate (v0.3.3 routed at dist/midi2.c which the Component Manager filters out).

Migration

-#include <midi2_cpp.h>
+#include <midi2cpp.h>

CMake:

-FetchContent_Declare(midi2_cpp ...)
-target_link_libraries(my_target PRIVATE midi2_cpp)
+FetchContent_Declare(midi2cpp ...)
+target_link_libraries(my_target PRIVATE midi2cpp)

Install

Build flow Install
Arduino IDE search midi2cpp in the Library Manager (after the registry PR lands)
arduino-cli arduino-cli lib install midi2cpp
PlatformIO lib_deps = sauloverissimo/midi2cpp @ ^0.3.0
ESP-IDF dependencies.midi2cpp.git in idf_component.yml (or copy under components/)
CMake FetchContent_Declare(midi2cpp GIT_TAG v0.3.0)

Verified

  • Host suite (cmake + ctest) 7/7 pass
  • arduino-cli compile of examples/HelloMIDI2/HelloMIDI2.ino on rp2040: 67 KB program (3% of flash)
  • ESP-IDF build of examples/esp32-s3-devkitc-usb-midi2 against midi2 v0.3.4 from the GitHub Component Manager: clean .bin
  • Repository CI on the rename PR: 6/6 jobs green