release: v0.4.0

Track midi2 v0.4.0. Public Device / Host / Bridge APIs stay
source-compatible where possible; sendFbInfo gains a uiHint
argument to match the new spec field.

Changes:
- Device::sendFbInfo gains uiHint between direction and firstGroup.
- FbInfoCb typedef gains uiHint between direction and firstGroup.
- Device::sendStreamConfigNotify auto-populates JR_TX_ENABLE from
  the heartbeat state.
- Device::sendNoteOn / sendNoteOff carry the full 16-bit attribute_data.
- Device::sendTimeSignature gains optional num32ndNotes (default 8).
- Device::sendJRClock / sendJRTimestamp keep the leading group
  argument; the value is ignored on the wire.
- Host::JrTimestampCb keeps (idx, group, ts); group is always 0.

Manifests bump to 0.4.0 and depend on midi2 >= 0.4.0.

Author: sauloverissimo

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to `midi2cpp` are recorded here. Format follows
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 mirrored from the upstream midi2 C99 policy.
 
+## [0.4.0]
+
+Track midi2 v0.4.0. Public Device / Host / Bridge APIs stay
+source-compatible where possible; `sendFbInfo` gains a `uiHint`
+argument to match the new spec field.
+
+### Changed
+
+- Depends on `midi2 >= 0.4.0`.
+- `Device::sendFbInfo(...)` gains `uiHint` between `direction` and
+  `firstGroup`. Recipes must update their callsite.
+- `FbInfoCb` typedef gains `uiHint` between `direction` and
+  `firstGroup` (recipes that wire `onFbInfo` directly must update).
+- `Device::sendStreamConfigNotify(protocol)` now auto-populates the
+  `JR_TX_ENABLE` bit from the JR Heartbeat state. No API change.
+- `Device::sendNoteOn` / `sendNoteOff` no longer refuse `attrData > 0xFF`;
+  the full 16-bit attribute_data round-trips through midi2 v0.4.0.
+- `Device::sendTimeSignature` gains an optional `num32ndNotes`
+  parameter (default `8`, SMF1 standard).
+- `Device::sendJRClock` / `sendJRTimestamp` keep the leading `group`
+  argument; value is now ignored on the wire (MT 0x0 is Groupless).
+- `Host::JrTimestampCb` keeps `(idx, group, ts)`; `group` is always
+  `0`.
+
 ## [0.3.1]
 
 ESP Component Registry support. midi2cpp now ships an `idf_component.yml`

CMakeLists.txt

@@ -20,7 +20,7 @@ if(ESP_PLATFORM)
     return()
 endif()
 
-project(midi2cpp VERSION 0.3.1 LANGUAGES C CXX)
+project(midi2cpp VERSION 0.4.0 LANGUAGES C CXX)
 
 set(CMAKE_C_STANDARD 99)
 set(CMAKE_C_STANDARD_REQUIRED ON)
@@ -34,12 +34,12 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 # This is the same pattern the midi2 README documents for downstream
 # consumers, applied to midi2cpp itself.
 if(NOT TARGET midi2)
-    find_package(midi2 0.3.4 QUIET CONFIG)
+    find_package(midi2 0.4.0 QUIET CONFIG)
     if(NOT midi2_FOUND)
         include(FetchContent)
         FetchContent_Declare(midi2
             GIT_REPOSITORY https://github.com/sauloverissimo/midi2.git
-            GIT_TAG        v0.3.4
+            GIT_TAG        v0.4.0
         )
         FetchContent_MakeAvailable(midi2)
     endif()

README.md

@@ -9,7 +9,7 @@
 [![release](https://img.shields.io/github/v/release/sauloverissimo/midi2cpp.svg)](https://github.com/sauloverissimo/midi2cpp/releases/latest)
 [![C++17](https://img.shields.io/badge/C%2B%2B-17-00599C.svg)](https://en.cppreference.com/cpp/compiler_support)
 [![MIDI 2.0](https://img.shields.io/badge/MIDI-2.0-blueviolet.svg)](https://midi.org/specifications/midi-2-0-specifications)
-[![depends: midi2](https://img.shields.io/badge/depends-midi2_%E2%89%A5_0.3.4-blueviolet.svg)](https://github.com/sauloverissimo/midi2)
+[![depends: midi2](https://img.shields.io/badge/depends-midi2_%E2%89%A5_0.4.0-blueviolet.svg)](https://github.com/sauloverissimo/midi2)
 [![Arduino](https://img.shields.io/badge/Arduino-IDE-00979D.svg)](https://www.arduino.cc/)
 [![PlatformIO](https://img.shields.io/badge/PlatformIO-Registry-FF7F00.svg)](https://registry.platformio.org/libraries/sauloverissimo/midi2cpp)
 [![ESP-IDF](https://img.shields.io/badge/ESP--IDF-v5.4-E7352C.svg)](https://docs.espressif.com/projects/esp-idf/en/stable/)
@@ -26,13 +26,14 @@ midi2cpp is the layer where a sketch meets the protocol. Plug a board into the l
 
 Underneath, [midi2](https://github.com/sauloverissimo/midi2) (the portable C99 core) handles parsing, dispatch, and reassembly. midi2cpp adds the C++ ergonomics: callbacks, board glue, ready-made USB descriptors. The board does the talking; the sketch tells it what to say.
 
+Single declared dependency: midi2. Transport, clock, and RNG are caller-supplied; no submodules.
+
 ## Contents
 
 - [midi2cpp](#midi2cpp)
     - [MIDI 2.0 engine for embedded systems](#midi-20-engine-for-embedded-systems)
   - [The library](#the-library)
   - [Contents](#contents)
-  - [Dependencies](#dependencies)
   - [Quickstart](#quickstart)
   - [What you get](#what-you-get)
   - [Three shapes](#three-shapes)
@@ -53,26 +54,6 @@ Underneath, [midi2](https://github.com/sauloverissimo/midi2) (the portable C99 c
   - [Specifications and trademarks](#specifications-and-trademarks)
   - [License](#license)
 
-## Dependencies
-
-midi2cpp draws a clear line between what the library declares and what stays the caller's job:
-
-- **Exactly one declared dependency: [midi2](https://github.com/sauloverissimo/midi2).** The C99 core lives in its own repo, is versioned independently, and is resolved by whichever package manager fits the host build:
-  - Arduino Library Manager: `depends=midi2 (>=0.3.4)` in `library.properties`.
-  - PlatformIO Registry: `dependencies."sauloverissimo/midi2": "^0.3.4"` in `library.json`.
-  - ESP-IDF Component Manager: `idf_component.yml` declaration plus `midi2` in `REQUIRES`.
-  - CMake: `find_package(midi2 0.3.4 CONFIG)` first, falls back to `FetchContent_Declare(midi2 GIT_TAG v0.3.4)`.
-- **No submodules.** `git clone` is the install. No `--recurse-submodules`, no half-initialised state.
-- **No transport library pulled in.** TinyUSB, Teensy native USB, PIO-USB, libDaisy USBMidi: all caller-supplied. The library does not include `<Arduino.h>`, `pico/time.h`, `esp_timer.h`, or any USB header.
-- **No clock or RNG dependency.** Caller injects `millis` / `time_us_64` / `esp_timer_get_time` and `random` / `get_rand_32` / `esp_random` through public hooks. Unset hooks degrade silently, no missing-symbol link errors.
-
-```bash
-git clone https://github.com/sauloverissimo/midi2cpp.git
-cmake -B build && cmake --build build && ctest --test-dir build
-```
-
-Three commands. The first `cmake configure` pulls midi2 once via FetchContent (or picks it up from a system install via `find_package`); subsequent rebuilds and tests run offline. Anywhere C++17 + CMake reach: Linux, macOS, Windows, embedded cross-toolchains for ARM/RISC-V/Xtensa.
-
 ## Quickstart
 
 `midi2cpp` is platform-agnostic: it parses, dispatches, and assembles UMP, and it leaves USB transport, clock, and entropy to the caller. The sketch wires four hooks to its platform's USB MIDI driver; the library does the rest.
@@ -213,14 +194,14 @@ Then install `midi2` via Library Manager (search `midi2`, click Install).
 Published on the [PlatformIO Registry](https://registry.platformio.org/libraries/sauloverissimo/midi2cpp):
 
 ```ini
-lib_deps = sauloverissimo/midi2cpp @ ^0.3.1
+lib_deps = sauloverissimo/midi2cpp @ ^0.4.0
 ```
 
 Or pin by git tag:
 
 ```ini
 lib_deps =
-  https://github.com/sauloverissimo/midi2cpp.git#v0.3.1
+  https://github.com/sauloverissimo/midi2cpp.git#v0.4.0
 ```
 
 Either way, `midi2` is resolved transitively via the manifest declaration in `library.json`.
@@ -235,7 +216,7 @@ Published on the [ESP Component Registry](https://components.espressif.com/compo
 # main/idf_component.yml
 dependencies:
   idf: ">=5.0"
-  sauloverissimo/midi2cpp: ">=0.3.1"
+  sauloverissimo/midi2cpp: ">=0.4.0"
 ```
 
 `midi2` is pulled transitively through `midi2cpp`'s manifest. `idf.py reconfigure` drops both into `managed_components/`.
@@ -252,7 +233,7 @@ Then declare `midi2` in `main/idf_component.yml`:
 ```yaml
 dependencies:
   idf: ">=5.0"
-  sauloverissimo/midi2: ">=0.3.4"
+  sauloverissimo/midi2: ">=0.4.0"
 ```
 
 `main/CMakeLists.txt` lists `midi2cpp` in its `idf_component_register(... REQUIRES midi2cpp ...)` block. The seven ESP-IDF recipes under [`examples/`](examples/) ship working templates for device, host and bridge roles.
@@ -264,12 +245,12 @@ include(FetchContent)
 FetchContent_Declare(
     midi2cpp
     GIT_REPOSITORY https://github.com/sauloverissimo/midi2cpp.git
-    GIT_TAG        v0.3.1
+    GIT_TAG        v0.4.0
 )
 FetchContent_MakeAvailable(midi2cpp)
 ```
 
-`midi2cpp` cascades the dependency on `midi2` to the parent project: `find_package(midi2 0.3.4 CONFIG)` is tried first, falling back to `FetchContent_Declare(midi2 GIT_TAG v0.3.4)` if no install is found.
+`midi2cpp` cascades the dependency on `midi2` to the parent project: `find_package(midi2 0.4.0 CONFIG)` is tried first, falling back to `FetchContent_Declare(midi2 GIT_TAG v0.4.0)` if no install is found.
 
 ### Git submodule
 

architecture.png

@@ -6,7 +6,7 @@
 ##
 ##   # in your_app/main/idf_component.yml
 ##   dependencies:
-##     sauloverissimo/midi2cpp: ">=0.3.1"
+##     sauloverissimo/midi2cpp: ">=0.4.0"
 ##
 ## The Component Manager clones midi2cpp into managed_components/,
 ## ESP-IDF picks it up as a component because the top-level CMakeLists
@@ -15,7 +15,7 @@
 ## is declared in the dependencies block below.
 
 description: "C++17 callback-first wrapper for MIDI 2.0 on embedded devices, layered over the portable midi2 C99 library. Covers UMP transport (M2-104), MIDI-CI with Appendix E (M2-101), Property Exchange Subscribe/Notify, Profile Configuration, Process Inquiry, Flex Data, and Bit Scaling (M2-115)."
-version: "0.3.1"
+version: "0.4.0"
 url: "https://github.com/sauloverissimo/midi2cpp"
 documentation: "https://github.com/sauloverissimo/midi2cpp#readme"
 issues: "https://github.com/sauloverissimo/midi2cpp/issues"
@@ -33,4 +33,4 @@ tags:
 
 dependencies:
   idf: ">=5.0"
-  sauloverissimo/midi2: ">=0.3.4"
+  sauloverissimo/midi2: ">=0.4.0"

idf_component.yml

@@ -1,6 +1,6 @@
 {
   "name": "midi2cpp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "C++17 Arduino-style wrapper for MIDI 2.0 on embedded devices. Thin wrapper over the portable midi2 C99 library. Covers UMP, MIDI-CI with Appendix E, Profile, PE Subscribe/Notify, Process Inquiry, Flex Data, and Bit Scaling. Targets RP2040, RP2350, Teensy, ESP32 family, nRF52, and SAMD21.",
   "keywords": "midi, midi2, usb, ump, capability-inquiry, property-exchange, profile",
   "authors": [
@@ -19,7 +19,7 @@
     "url": "https://github.com/sauloverissimo/midi2cpp.git"
   },
   "dependencies": {
-    "sauloverissimo/midi2": "^0.3.4"
+    "sauloverissimo/midi2": "^0.4.0"
   },
   "headers": "midi2cpp.h",
   "export": {

library.json

@@ -1,5 +1,5 @@
 name=midi2cpp
-version=0.3.1
+version=0.4.0
 author=Saulo Verissimo <sauloverissimo@gmail.com>
 maintainer=Saulo Verissimo <sauloverissimo@gmail.com>
 sentence=C++17 Arduino-style wrapper for MIDI 2.0 on embedded devices.
@@ -8,4 +8,4 @@ category=Communication
 url=https://github.com/sauloverissimo/midi2cpp
 architectures=*
 includes=midi2cpp.h
-depends=midi2 (>=0.3.4)
+depends=midi2 (>=0.4.0)

library.properties

@@ -132,9 +132,13 @@ static void forward_ump_to_pc(BridgeState* s, uint8_t idx,
 static void push_fb_info(BridgeState* s, uint8_t idx) {
     if (idx >= s->numSlots) return;
     const uint8_t base = (uint8_t)(idx * s->groupsPerSlot);
+    // ui_hint=0x03 (Sender+Receiver): bridge slots are always bidirectional —
+    // the upstream device on the host port can both produce and consume UMP
+    // relative to the downstream device-side endpoint.
     s->device.sendFbInfo(/*active*/      s->slots[idx].active,
                          /*fb_num*/      idx,
                          /*direction*/   0x03,
+                         /*ui_hint*/     0x03,
                          /*first_group*/ base,
                          /*num_groups*/  s->groupsPerSlot,
                          /*midi_ci_ver*/ 0x02,