1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * Universal MIDI Packet (UMP) Support
8 #include <sound/rawmidi.h>
10 struct snd_ump_endpoint;
13 struct ump_cvt_to_ump;
14 struct snd_seq_ump_ops;
16 struct snd_ump_endpoint {
17 struct snd_rawmidi core; /* raw UMP access */
19 struct snd_ump_endpoint_info info;
21 const struct snd_ump_ops *ops; /* UMP ops set by the driver */
22 struct snd_rawmidi_substream *substreams[2]; /* opened substreams */
25 void (*private_free)(struct snd_ump_endpoint *ump);
27 /* UMP Stream message processing */
28 u32 stream_wait_for; /* expected stream message status */
29 bool stream_finished; /* set when message has been processed */
30 bool parsed; /* UMP / FB parse finished? */
31 bool no_process_stream; /* suppress UMP stream messages handling */
32 wait_queue_head_t stream_wait;
33 struct snd_rawmidi_file stream_rfile;
35 struct list_head block_list; /* list of snd_ump_block objects */
37 /* intermediate buffer for UMP input */
42 struct mutex open_mutex;
44 #if IS_ENABLED(CONFIG_SND_UMP_LEGACY_RAWMIDI)
45 spinlock_t legacy_locks[2];
46 struct snd_rawmidi *legacy_rmidi;
47 struct snd_rawmidi_substream *legacy_substreams[2][SNDRV_UMP_MAX_GROUPS];
48 unsigned char legacy_mapping[SNDRV_UMP_MAX_GROUPS];
50 /* for legacy output; need to open the actual substream unlike input */
52 struct snd_rawmidi_file legacy_out_rfile;
53 struct ump_cvt_to_ump *out_cvts;
56 #if IS_ENABLED(CONFIG_SND_SEQUENCER)
57 struct snd_seq_device *seq_dev;
58 const struct snd_seq_ump_ops *seq_ops;
63 /* ops filled by UMP drivers */
65 int (*open)(struct snd_ump_endpoint *ump, int dir);
66 void (*close)(struct snd_ump_endpoint *ump, int dir);
67 void (*trigger)(struct snd_ump_endpoint *ump, int dir, int up);
68 void (*drain)(struct snd_ump_endpoint *ump, int dir);
71 /* ops filled by sequencer binding */
72 struct snd_seq_ump_ops {
73 void (*input_receive)(struct snd_ump_endpoint *ump,
74 const u32 *data, int words);
75 int (*notify_fb_change)(struct snd_ump_endpoint *ump,
76 struct snd_ump_block *fb);
77 int (*switch_protocol)(struct snd_ump_endpoint *ump);
80 struct snd_ump_block {
81 struct snd_ump_block_info info;
82 struct snd_ump_endpoint *ump;
85 void (*private_free)(struct snd_ump_block *blk);
87 struct list_head list;
90 #define rawmidi_to_ump(rmidi) container_of(rmidi, struct snd_ump_endpoint, core)
92 int snd_ump_endpoint_new(struct snd_card *card, char *id, int device,
93 int output, int input,
94 struct snd_ump_endpoint **ump_ret);
95 int snd_ump_parse_endpoint(struct snd_ump_endpoint *ump);
96 int snd_ump_block_new(struct snd_ump_endpoint *ump, unsigned int blk,
97 unsigned int direction, unsigned int first_group,
98 unsigned int num_groups, struct snd_ump_block **blk_ret);
99 int snd_ump_receive(struct snd_ump_endpoint *ump, const u32 *buffer, int count);
100 int snd_ump_transmit(struct snd_ump_endpoint *ump, u32 *buffer, int count);
102 #if IS_ENABLED(CONFIG_SND_UMP_LEGACY_RAWMIDI)
103 int snd_ump_attach_legacy_rawmidi(struct snd_ump_endpoint *ump,
104 char *id, int device);
106 static inline int snd_ump_attach_legacy_rawmidi(struct snd_ump_endpoint *ump,
107 char *id, int device)
113 int snd_ump_receive_ump_val(struct snd_ump_endpoint *ump, u32 val);
114 int snd_ump_switch_protocol(struct snd_ump_endpoint *ump, unsigned int protocol);
117 * Some definitions for UMP
120 /* MIDI 2.0 Message Type */
122 UMP_MSG_TYPE_UTILITY = 0x00,
123 UMP_MSG_TYPE_SYSTEM = 0x01,
124 UMP_MSG_TYPE_MIDI1_CHANNEL_VOICE = 0x02,
125 UMP_MSG_TYPE_DATA = 0x03,
126 UMP_MSG_TYPE_MIDI2_CHANNEL_VOICE = 0x04,
127 UMP_MSG_TYPE_EXTENDED_DATA = 0x05,
128 UMP_MSG_TYPE_FLEX_DATA = 0x0d,
129 UMP_MSG_TYPE_STREAM = 0x0f,
132 /* MIDI 2.0 SysEx / Data Status; same values for both 7-bit and 8-bit SysEx */
134 UMP_SYSEX_STATUS_SINGLE = 0,
135 UMP_SYSEX_STATUS_START = 1,
136 UMP_SYSEX_STATUS_CONTINUE = 2,
137 UMP_SYSEX_STATUS_END = 3,
140 /* UMP Utility Type Status (type 0x0) */
142 UMP_UTILITY_MSG_STATUS_NOOP = 0x00,
143 UMP_UTILITY_MSG_STATUS_JR_CLOCK = 0x01,
144 UMP_UTILITY_MSG_STATUS_JR_TSTAMP = 0x02,
145 UMP_UTILITY_MSG_STATUS_DCTPQ = 0x03,
146 UMP_UTILITY_MSG_STATUS_DC = 0x04,
149 /* UMP Stream Message Status (type 0xf) */
151 UMP_STREAM_MSG_STATUS_EP_DISCOVERY = 0x00,
152 UMP_STREAM_MSG_STATUS_EP_INFO = 0x01,
153 UMP_STREAM_MSG_STATUS_DEVICE_INFO = 0x02,
154 UMP_STREAM_MSG_STATUS_EP_NAME = 0x03,
155 UMP_STREAM_MSG_STATUS_PRODUCT_ID = 0x04,
156 UMP_STREAM_MSG_STATUS_STREAM_CFG_REQUEST = 0x05,
157 UMP_STREAM_MSG_STATUS_STREAM_CFG = 0x06,
158 UMP_STREAM_MSG_STATUS_FB_DISCOVERY = 0x10,
159 UMP_STREAM_MSG_STATUS_FB_INFO = 0x11,
160 UMP_STREAM_MSG_STATUS_FB_NAME = 0x12,
161 UMP_STREAM_MSG_STATUS_START_CLIP = 0x20,
162 UMP_STREAM_MSG_STATUS_END_CLIP = 0x21,
165 /* UMP Endpoint Discovery filter bitmap */
167 UMP_STREAM_MSG_REQUEST_EP_INFO = (1U << 0),
168 UMP_STREAM_MSG_REQUEST_DEVICE_INFO = (1U << 1),
169 UMP_STREAM_MSG_REQUEST_EP_NAME = (1U << 2),
170 UMP_STREAM_MSG_REQUEST_PRODUCT_ID = (1U << 3),
171 UMP_STREAM_MSG_REQUEST_STREAM_CFG = (1U << 4),
174 /* UMP Function Block Discovery filter bitmap */
176 UMP_STREAM_MSG_REQUEST_FB_INFO = (1U << 0),
177 UMP_STREAM_MSG_REQUEST_FB_NAME = (1U << 1),
180 /* UMP Endpoint Info capability bits (used for protocol request/notify, too) */
182 UMP_STREAM_MSG_EP_INFO_CAP_TXJR = (1U << 0), /* Sending JRTS */
183 UMP_STREAM_MSG_EP_INFO_CAP_RXJR = (1U << 1), /* Receiving JRTS */
184 UMP_STREAM_MSG_EP_INFO_CAP_MIDI1 = (1U << 8), /* MIDI 1.0 */
185 UMP_STREAM_MSG_EP_INFO_CAP_MIDI2 = (1U << 9), /* MIDI 2.0 */
188 /* UMP EP / FB name string format; same as SysEx string handling */
190 UMP_STREAM_MSG_FORMAT_SINGLE = 0,
191 UMP_STREAM_MSG_FORMAT_START = 1,
192 UMP_STREAM_MSG_FORMAT_CONTINUE = 2,
193 UMP_STREAM_MSG_FORMAT_END = 3,
197 * Helpers for retrieving / filling bits from UMP
199 /* get the message type (4bit) from a UMP packet (header) */
200 static inline unsigned char ump_message_type(u32 data)
205 /* get the group number (0-based, 4bit) from a UMP packet (header) */
206 static inline unsigned char ump_message_group(u32 data)
208 return (data >> 24) & 0x0f;
211 /* get the MIDI status code (4bit) from a UMP packet (header) */
212 static inline unsigned char ump_message_status_code(u32 data)
214 return (data >> 20) & 0x0f;
217 /* get the MIDI channel number (0-based, 4bit) from a UMP packet (header) */
218 static inline unsigned char ump_message_channel(u32 data)
220 return (data >> 16) & 0x0f;
223 /* get the MIDI status + channel combo byte (8bit) from a UMP packet (header) */
224 static inline unsigned char ump_message_status_channel(u32 data)
226 return (data >> 16) & 0xff;
229 /* compose a UMP packet (header) from type, group and status values */
230 static inline u32 ump_compose(unsigned char type, unsigned char group,
231 unsigned char status, unsigned char channel)
233 return ((u32)type << 28) | ((u32)group << 24) | ((u32)status << 20) |
234 ((u32)channel << 16);
237 /* get SysEx message status (for both 7 and 8bits) from a UMP packet (header) */
238 static inline unsigned char ump_sysex_message_status(u32 data)
240 return (data >> 20) & 0xf;
243 /* get SysEx message length (for both 7 and 8bits) from a UMP packet (header) */
244 static inline unsigned char ump_sysex_message_length(u32 data)
246 return (data >> 16) & 0xf;
249 /* For Stream Messages */
250 static inline unsigned char ump_stream_message_format(u32 data)
252 return (data >> 26) & 0x03;
255 static inline unsigned int ump_stream_message_status(u32 data)
257 return (data >> 16) & 0x3ff;
260 static inline u32 ump_stream_compose(unsigned char status, unsigned short form)
262 return (UMP_MSG_TYPE_STREAM << 28) | ((u32)form << 26) |
266 #define ump_is_groupless_msg(type) \
267 ((type) == UMP_MSG_TYPE_UTILITY || (type) == UMP_MSG_TYPE_STREAM)
269 #endif /* __SOUND_UMP_H */