1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * Utility definitions for MIDI 2.0 function 4 */ 5 6 #ifndef U_MIDI2_H 7 #define U_MIDI2_H 8 9 #include <linux/usb/composite.h> 10 #include <sound/asound.h> 11 12 struct f_midi2_opts; 13 struct f_midi2_ep_opts; 14 struct f_midi2_block_opts; 15 16 /* UMP Function Block info */ 17 struct f_midi2_block_info { 18 unsigned int direction; /* FB direction: 1-3 */ 19 unsigned int first_group; /* first UMP group: 0-15 */ 20 unsigned int num_groups; /* number of UMP groups: 1-16 */ 21 unsigned int midi1_first_group; /* first UMP group for MIDI 1.0 */ 22 unsigned int midi1_num_groups; /* number of UMP groups for MIDI 1.0 */ 23 unsigned int ui_hint; /* UI-hint: 0-3 */ 24 unsigned int midi_ci_version; /* MIDI-CI version: 0-255 */ 25 unsigned int sysex8_streams; /* number of sysex8 streams: 0-255 */ 26 unsigned int is_midi1; /* MIDI 1.0 port: 0-2 */ 27 bool active; /* FB active flag: bool */ 28 const char *name; /* FB name */ 29 }; 30 31 /* UMP Endpoint info */ 32 struct f_midi2_ep_info { 33 unsigned int protocol_caps; /* protocol capabilities: 1-3 */ 34 unsigned int protocol; /* default protocol: 1-2 */ 35 unsigned int manufacturer; /* manufacturer id: 0-0xffffff */ 36 unsigned int family; /* device family id: 0-0xffff */ 37 unsigned int model; /* device model id: 0x-0xffff */ 38 unsigned int sw_revision; /* software revision: 32bit */ 39 40 const char *ep_name; /* Endpoint name */ 41 const char *product_id; /* Product ID */ 42 }; 43 44 struct f_midi2_card_info { 45 bool process_ump; /* process UMP stream: bool */ 46 bool static_block; /* static FBs: bool */ 47 unsigned int req_buf_size; /* request buffer size */ 48 unsigned int num_reqs; /* number of requests */ 49 const char *iface_name; /* interface name */ 50 }; 51 52 struct f_midi2_block_opts { 53 struct config_group group; 54 unsigned int id; 55 struct f_midi2_block_info info; 56 struct f_midi2_ep_opts *ep; 57 }; 58 59 struct f_midi2_ep_opts { 60 struct config_group group; 61 unsigned int index; 62 struct f_midi2_ep_info info; 63 struct f_midi2_block_opts *blks[SNDRV_UMP_MAX_BLOCKS]; 64 struct f_midi2_opts *opts; 65 }; 66 67 #define MAX_UMP_EPS 4 68 #define MAX_CABLES 16 69 70 struct f_midi2_opts { 71 struct usb_function_instance func_inst; 72 struct mutex lock; 73 int refcnt; 74 75 struct f_midi2_card_info info; 76 77 unsigned int num_eps; 78 struct f_midi2_ep_opts *eps[MAX_UMP_EPS]; 79 }; 80 81 #endif /* U_MIDI2_H */ 82