input.hpp

Go to the documentation of this file.

// sbl/hw/midi/input.hpp — HAL convenience for MIDI input
//
// Drains available bytes from UART RX or USB MIDI into a MIDI parser.
//
// Usage:
//   sbl::midi::poll<sbl::driver::Uart<1>>(parser);  // UART MIDI
//   sbl::midi::poll_usb(parser);                     // USB MIDI
 
#ifndef SBL_HW_MIDI_INPUT_HPP_
#define SBL_HW_MIDI_INPUT_HPP_
 
#include <sbl/protocol/midi/parser.hpp>
 
#if defined(SBL_HAS_USB) && defined(SBL_HAS_USB_MIDI)
#include <sbl/usb/midi.hpp>
#endif
 
namespace sbl::midi {
 
/**
 * @brief Poll UART for MIDI bytes and feed them to the parser
 *
 * Drains all available bytes from the UART RX buffer.
 * Non-blocking — returns immediately if no data available.
 *
 * @tparam UartDriver UART driver class with available() and read_byte()
 * @note ISR-safe — drains available bytes from ring buffer, no blocking.
 */
template<typename UartDriver>
inline void poll(Parser& parser) {
    while (UartDriver::available()) {
        parser.push(UartDriver::read_byte());
    }
}
 
#if defined(SBL_HAS_USB) && defined(SBL_HAS_USB_MIDI)
/**
 * @brief Poll USB MIDI for bytes and feed them to the parser
 *
 * TinyUSB's stream_read unpacks 4-byte USB MIDI packets into standard
 * MIDI bytes, which we feed directly to the existing parser.
 * Non-blocking — returns immediately if no data available.
 *
 * @note NOT ISR-safe — calls TinyUSB device stack. Main loop only.
 */
inline void poll_usb(Parser& parser) {
    uint8_t buf[64];
    uint32_t n = sbl::usb::MidiPort::read(buf, sizeof(buf));
    if (n > 0) {
        parser.push(buf, static_cast<uint16_t>(n));
    }
}
#endif // SBL_HAS_USB && SBL_HAS_USB_MIDI
 
} // namespace sbl::midi
 
#endif // SBL_HW_MIDI_INPUT_HPP_