/* * SPDX-FileCopyrightText: Copyright (c) 2019 Ha Thach (tinyusb.org) * SPDX-License-Identifier: MIT * * This file is part of the TinyUSB stack. */ #ifndef TUSB_MIDI_DEVICE_H_ #define TUSB_MIDI_DEVICE_H_ #include "class/audio/audio.h" #include "midi.h" //--------------------------------------------------------------------+ // Class Driver Configuration //--------------------------------------------------------------------+ #ifndef CFG_TUD_MIDI_RX_EPSIZE #ifdef CFG_TUD_MIDI_EP_BUFSIZE #define CFG_TUD_MIDI_RX_EPSIZE CFG_TUD_MIDI_EP_BUFSIZE #else #define CFG_TUD_MIDI_RX_EPSIZE TUD_EPSIZE_BULK_MAX #endif #endif #ifndef CFG_TUD_MIDI_TX_EPSIZE #ifdef CFG_TUD_MIDI_EP_BUFSIZE #define CFG_TUD_MIDI_TX_EPSIZE CFG_TUD_MIDI_EP_BUFSIZE #else #define CFG_TUD_MIDI_TX_EPSIZE TUD_EPSIZE_BULK_MAX #endif #endif #ifdef __cplusplus extern "C" { #endif //--------------------------------------------------------------------+ // Application Callback API (optional) //--------------------------------------------------------------------+ void tud_midi_rx_cb(uint8_t itf); //--------------------------------------------------------------------+ // Application API (Multiple Interfaces) // CFG_TUD_MIDI > 1 //--------------------------------------------------------------------+ // Check if midi interface is mounted bool tud_midi_n_mounted(uint8_t itf); // Get the number of bytes available for reading uint32_t tud_midi_n_available(uint8_t itf, uint8_t cable_num); // Read byte stream (legacy) uint32_t tud_midi_n_stream_read(uint8_t itf, uint8_t cable_num, void *buffer, uint32_t bufsize); // Read byte stream with cable demultiplexing: returns the cable number of the // data that was read. Reads from a single cable per call; stops when the next // packet belongs to a different cable so the caller can dispatch per-cable. // Note: shares internal state with tud_midi_n_stream_read(); do not mix both // on the same interface. uint32_t tud_midi_n_demux_stream_read(uint8_t itf, uint8_t *p_cable_num, void *buffer, uint32_t bufsize); // Write byte Stream (legacy) uint32_t tud_midi_n_stream_write(uint8_t itf, uint8_t cable_num, const uint8_t *buffer, uint32_t bufsize); // Read an event 4-byte packet bool tud_midi_n_packet_read(uint8_t itf, uint8_t packet[4]); // Read multiple event packets, return number of read packets uint32_t tud_midi_n_packet_read_n(uint8_t itf, uint8_t packets[], uint32_t max_packets); // Write an event 4-byte packet bool tud_midi_n_packet_write(uint8_t itf, const uint8_t packet[4]); // Write multiple event packets, return number of written packets uint32_t tud_midi_n_packet_write_n(uint8_t itf, const uint8_t packets[], uint32_t n_packets); //--------------------------------------------------------------------+ // Application API (Single Interface) //--------------------------------------------------------------------+ TU_ATTR_ALWAYS_INLINE static inline bool tud_midi_mounted(void) { return tud_midi_n_mounted(0); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_available(void) { return tud_midi_n_available(0, 0); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_stream_read(void *buffer, uint32_t bufsize) { return tud_midi_n_stream_read(0, 0, buffer, bufsize); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_demux_stream_read(uint8_t *p_cable_num, void *buffer, uint32_t bufsize) { return tud_midi_n_demux_stream_read(0, p_cable_num, buffer, bufsize); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_stream_write(uint8_t cable_num, const uint8_t *buffer, uint32_t bufsize) { return tud_midi_n_stream_write(0, cable_num, buffer, bufsize); } TU_ATTR_ALWAYS_INLINE static inline bool tud_midi_packet_read(uint8_t packet[4]) { return tud_midi_n_packet_read(0, packet); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_packet_read_n(uint8_t packets[], uint32_t max_packets) { return tud_midi_n_packet_read_n(0, packets, max_packets); } TU_ATTR_ALWAYS_INLINE static inline bool tud_midi_packet_write(const uint8_t packet[4]) { return tud_midi_n_packet_write(0, packet); } TU_ATTR_ALWAYS_INLINE static inline uint32_t tud_midi_packet_write_n(const uint8_t packets[], uint32_t n_packets) { return tud_midi_n_packet_write_n(0, packets, n_packets); } //--------------------------------------------------------------------+ // Internal Class Driver API //--------------------------------------------------------------------+ void midid_init(void); bool midid_deinit(void); void midid_reset(uint8_t rhport); uint16_t midid_open(uint8_t rhport, const tusb_desc_interface_t *itf_desc, uint16_t max_len); bool midid_control_xfer_cb(uint8_t rhport, uint8_t stage, const tusb_control_request_t *request); bool midid_xfer_cb(uint8_t rhport, uint8_t edpt_addr, xfer_result_t result, uint32_t xferred_bytes); #ifdef __cplusplus } #endif #endif