sound/usb/midi2.c

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * MIDI 2.0 support
   4  */
   5
   6 #include <linux/bitops.h>
   7 #include <linux/string.h>
   8 #include <linux/init.h>
   9 #include <linux/slab.h>
  10 #include <linux/usb.h>
  11 #include <linux/wait.h>
  12 #include <linux/module.h>
  13 #include <linux/moduleparam.h>
  14 #include <linux/usb/audio.h>
  15 #include <linux/usb/midi.h>
  16 #include <linux/usb/midi-v2.h>
  17
  18 #include <sound/core.h>
  19 #include <sound/control.h>
  20 #include <sound/ump.h>
  21 #include "usbaudio.h"
  22 #include "midi.h"
  23 #include "midi2.h"
  24 #include "helper.h"
  25
  26 static bool midi2_enable = true;
  27 module_param(midi2_enable, bool, 0444);
  28 MODULE_PARM_DESC(midi2_enable, "Enable MIDI 2.0 support.");
  29
  30 static bool midi2_ump_probe = true;
  31 module_param(midi2_ump_probe, bool, 0444);
  32 MODULE_PARM_DESC(midi2_ump_probe, "Probe UMP v1.1 support at first.");
  33
  34 /* stream direction; just shorter names */
  35 enum {
  36         STR_OUT = SNDRV_RAWMIDI_STREAM_OUTPUT,
  37         STR_IN = SNDRV_RAWMIDI_STREAM_INPUT
  38 };
  39
  40 #define NUM_URBS        8
  41
  42 struct snd_usb_midi2_urb;
  43 struct snd_usb_midi2_endpoint;
  44 struct snd_usb_midi2_ump;
  45 struct snd_usb_midi2_interface;
  46
  47 /* URB context */
  48 struct snd_usb_midi2_urb {
  49         struct urb *urb;
  50         struct snd_usb_midi2_endpoint *ep;
  51         unsigned int index;             /* array index */
  52 };
  53
  54 /* A USB MIDI input/output endpoint */
  55 struct snd_usb_midi2_endpoint {
  56         struct usb_device *dev;
  57         const struct usb_ms20_endpoint_descriptor *ms_ep; /* reference to EP descriptor */
  58         struct snd_usb_midi2_endpoint *pair;    /* bidirectional pair EP */
  59         struct snd_usb_midi2_ump *rmidi;        /* assigned UMP EP pair */
  60         struct snd_ump_endpoint *ump;           /* assigned UMP EP */
  61         int direction;                  /* direction (STR_IN/OUT) */
  62         unsigned int endpoint;          /* EP number */
  63         unsigned int pipe;              /* URB pipe */
  64         unsigned int packets;           /* packet buffer size in bytes */
  65         unsigned int interval;          /* interval for INT EP */
  66         wait_queue_head_t wait;         /* URB waiter */
  67         spinlock_t lock;                /* URB locking */
  68         struct snd_rawmidi_substream *substream; /* NULL when closed */
  69         unsigned int num_urbs;          /* number of allocated URBs */
  70         unsigned long urb_free;         /* bitmap for free URBs */
  71         unsigned long urb_free_mask;    /* bitmask for free URBs */
  72         atomic_t running;               /* running status */
  73         atomic_t suspended;             /* saved running status for suspend */
  74         bool disconnected;              /* shadow of umidi->disconnected */
  75         struct list_head list;          /* list to umidi->ep_list */
  76         struct snd_usb_midi2_urb urbs[NUM_URBS];
  77 };
  78
  79 /* A UMP endpoint - one or two USB MIDI endpoints are assigned */
  80 struct snd_usb_midi2_ump {
  81         struct usb_device *dev;
  82         struct snd_usb_midi2_interface *umidi;  /* reference to MIDI iface */
  83         struct snd_ump_endpoint *ump;           /* assigned UMP EP object */
  84         struct snd_usb_midi2_endpoint *eps[2];  /* USB MIDI endpoints */
  85         int index;                              /* rawmidi device index */
  86         unsigned char usb_block_id;             /* USB GTB id used for finding a pair */
  87         bool ump_parsed;                        /* Parsed UMP 1.1 EP/FB info*/
  88         struct list_head list;          /* list to umidi->rawmidi_list */
  89 };
  90
  91 /* top-level instance per USB MIDI interface */
  92 struct snd_usb_midi2_interface {
  93         struct snd_usb_audio *chip;     /* assigned USB-audio card */
  94         struct usb_interface *iface;    /* assigned USB interface */
  95         struct usb_host_interface *hostif;
  96         const char *blk_descs;          /* group terminal block descriptors */
  97         unsigned int blk_desc_size;     /* size of GTB descriptors */
  98         bool disconnected;
  99         struct list_head ep_list;       /* list of endpoints */
 100         struct list_head rawmidi_list;  /* list of UMP rawmidis */
 101         struct list_head list;          /* list to chip->midi_v2_list */
 102 };
 103
 104 /* submit URBs as much as possible; used for both input and output */
 105 static void do_submit_urbs_locked(struct snd_usb_midi2_endpoint *ep,
 106                                   int (*prepare)(struct snd_usb_midi2_endpoint *,
 107                                                  struct urb *))
 108 {
 109         struct snd_usb_midi2_urb *ctx;
 110         int index, err = 0;
 111
 112         if (ep->disconnected)
 113                 return;
 114
 115         while (ep->urb_free) {
 116                 index = find_first_bit(&ep->urb_free, ep->num_urbs);
 117                 if (index >= ep->num_urbs)
 118                         return;
 119                 ctx = &ep->urbs[index];
 120                 err = prepare(ep, ctx->urb);
 121                 if (err < 0)
 122                         return;
 123                 if (!ctx->urb->transfer_buffer_length)
 124                         return;
 125                 ctx->urb->dev = ep->dev;
 126                 err = usb_submit_urb(ctx->urb, GFP_ATOMIC);
 127                 if (err < 0) {
 128                         dev_dbg(&ep->dev->dev,
 129                                 "usb_submit_urb error %d\n", err);
 130                         return;
 131                 }
 132                 clear_bit(index, &ep->urb_free);
 133         }
 134 }
 135
 136 /* prepare for output submission: copy from rawmidi buffer to urb packet */
 137 static int prepare_output_urb(struct snd_usb_midi2_endpoint *ep,
 138                               struct urb *urb)
 139 {
 140         int count;
 141
 142         count = snd_ump_transmit(ep->ump, urb->transfer_buffer,
 143                                  ep->packets);
 144         if (count < 0) {
 145                 dev_dbg(&ep->dev->dev, "rawmidi transmit error %d\n", count);
 146                 return count;
 147         }
 148         cpu_to_le32_array((u32 *)urb->transfer_buffer, count >> 2);
 149         urb->transfer_buffer_length = count;
 150         return 0;
 151 }
 152
 153 static void submit_output_urbs_locked(struct snd_usb_midi2_endpoint *ep)
 154 {
 155         do_submit_urbs_locked(ep, prepare_output_urb);
 156 }
 157
 158 /* URB completion for output; re-filling and re-submit */
 159 static void output_urb_complete(struct urb *urb)
 160 {
 161         struct snd_usb_midi2_urb *ctx = urb->context;
 162         struct snd_usb_midi2_endpoint *ep = ctx->ep;
 163         unsigned long flags;
 164
 165         spin_lock_irqsave(&ep->lock, flags);
 166         set_bit(ctx->index, &ep->urb_free);
 167         if (urb->status >= 0 && atomic_read(&ep->running))
 168                 submit_output_urbs_locked(ep);
 169         if (ep->urb_free == ep->urb_free_mask)
 170                 wake_up(&ep->wait);
 171         spin_unlock_irqrestore(&ep->lock, flags);
 172 }
 173
 174 /* prepare for input submission: just set the buffer length */
 175 static int prepare_input_urb(struct snd_usb_midi2_endpoint *ep,
 176                              struct urb *urb)
 177 {
 178         urb->transfer_buffer_length = ep->packets;
 179         return 0;
 180 }
 181
 182 static void submit_input_urbs_locked(struct snd_usb_midi2_endpoint *ep)
 183 {
 184         do_submit_urbs_locked(ep, prepare_input_urb);
 185 }
 186
 187 /* URB completion for input; copy into rawmidi buffer and resubmit */
 188 static void input_urb_complete(struct urb *urb)
 189 {
 190         struct snd_usb_midi2_urb *ctx = urb->context;
 191         struct snd_usb_midi2_endpoint *ep = ctx->ep;
 192         unsigned long flags;
 193         int len;
 194
 195         spin_lock_irqsave(&ep->lock, flags);
 196         if (ep->disconnected || urb->status < 0)
 197                 goto dequeue;
 198         len = urb->actual_length;
 199         len &= ~3; /* align UMP */
 200         if (len > ep->packets)
 201                 len = ep->packets;
 202         if (len > 0) {
 203                 le32_to_cpu_array((u32 *)urb->transfer_buffer, len >> 2);
 204                 snd_ump_receive(ep->ump, (u32 *)urb->transfer_buffer, len);
 205         }
 206  dequeue:
 207         set_bit(ctx->index, &ep->urb_free);
 208         submit_input_urbs_locked(ep);
 209         if (ep->urb_free == ep->urb_free_mask)
 210                 wake_up(&ep->wait);
 211         spin_unlock_irqrestore(&ep->lock, flags);
 212 }
 213
 214 /* URB submission helper; for both direction */
 215 static void submit_io_urbs(struct snd_usb_midi2_endpoint *ep)
 216 {
 217         unsigned long flags;
 218
 219         if (!ep)
 220                 return;
 221         spin_lock_irqsave(&ep->lock, flags);
 222         if (ep->direction == STR_IN)
 223                 submit_input_urbs_locked(ep);
 224         else
 225                 submit_output_urbs_locked(ep);
 226         spin_unlock_irqrestore(&ep->lock, flags);
 227 }
 228
 229 /* kill URBs for close, suspend and disconnect */
 230 static void kill_midi_urbs(struct snd_usb_midi2_endpoint *ep, bool suspending)
 231 {
 232         int i;
 233
 234         if (!ep)
 235                 return;
 236         if (suspending)
 237                 ep->suspended = ep->running;
 238         atomic_set(&ep->running, 0);
 239         for (i = 0; i < ep->num_urbs; i++) {
 240                 if (!ep->urbs[i].urb)
 241                         break;
 242                 usb_kill_urb(ep->urbs[i].urb);
 243         }
 244 }
 245
 246 /* wait until all URBs get freed */
 247 static void drain_urb_queue(struct snd_usb_midi2_endpoint *ep)
 248 {
 249         if (!ep)
 250                 return;
 251         spin_lock_irq(&ep->lock);
 252         atomic_set(&ep->running, 0);
 253         wait_event_lock_irq_timeout(ep->wait,
 254                                     ep->disconnected ||
 255                                     ep->urb_free == ep->urb_free_mask,
 256                                     ep->lock, msecs_to_jiffies(500));
 257         spin_unlock_irq(&ep->lock);
 258 }
 259
 260 /* release URBs for an EP */
 261 static void free_midi_urbs(struct snd_usb_midi2_endpoint *ep)
 262 {
 263         struct snd_usb_midi2_urb *ctx;
 264         int i;
 265
 266         if (!ep)
 267                 return;
 268         for (i = 0; i < ep->num_urbs; ++i) {
 269                 ctx = &ep->urbs[i];
 270                 if (!ctx->urb)
 271                         break;
 272                 usb_free_coherent(ep->dev, ep->packets,
 273                                   ctx->urb->transfer_buffer,
 274                                   ctx->urb->transfer_dma);
 275                 usb_free_urb(ctx->urb);
 276                 ctx->urb = NULL;
 277         }
 278         ep->num_urbs = 0;
 279 }
 280
 281 /* allocate URBs for an EP */
 282 static int alloc_midi_urbs(struct snd_usb_midi2_endpoint *ep)
 283 {
 284         struct snd_usb_midi2_urb *ctx;
 285         void (*comp)(struct urb *urb);
 286         void *buffer;
 287         int i, err;
 288         int endpoint, len;
 289
 290         endpoint = ep->endpoint;
 291         len = ep->packets;
 292         if (ep->direction == STR_IN)
 293                 comp = input_urb_complete;
 294         else
 295                 comp = output_urb_complete;
 296
 297         ep->num_urbs = 0;
 298         ep->urb_free = ep->urb_free_mask = 0;
 299         for (i = 0; i < NUM_URBS; i++) {
 300                 ctx = &ep->urbs[i];
 301                 ctx->index = i;
 302                 ctx->urb = usb_alloc_urb(0, GFP_KERNEL);
 303                 if (!ctx->urb) {
 304                         dev_err(&ep->dev->dev, "URB alloc failed\n");
 305                         return -ENOMEM;
 306                 }
 307                 ctx->ep = ep;
 308                 buffer = usb_alloc_coherent(ep->dev, len, GFP_KERNEL,
 309                                             &ctx->urb->transfer_dma);
 310                 if (!buffer) {
 311                         dev_err(&ep->dev->dev,
 312                                 "URB buffer alloc failed (size %d)\n", len);
 313                         return -ENOMEM;
 314                 }
 315                 if (ep->interval)
 316                         usb_fill_int_urb(ctx->urb, ep->dev, ep->pipe,
 317                                          buffer, len, comp, ctx, ep->interval);
 318                 else
 319                         usb_fill_bulk_urb(ctx->urb, ep->dev, ep->pipe,
 320                                           buffer, len, comp, ctx);
 321                 err = usb_urb_ep_type_check(ctx->urb);
 322                 if (err < 0) {
 323                         dev_err(&ep->dev->dev, "invalid MIDI EP %x\n",
 324                                 endpoint);
 325                         return err;
 326                 }
 327                 ctx->urb->transfer_flags = URB_NO_TRANSFER_DMA_MAP;
 328                 ep->num_urbs++;
 329         }
 330         ep->urb_free = ep->urb_free_mask = GENMASK(ep->num_urbs - 1, 0);
 331         return 0;
 332 }
 333
 334 static struct snd_usb_midi2_endpoint *
 335 ump_to_endpoint(struct snd_ump_endpoint *ump, int dir)
 336 {
 337         struct snd_usb_midi2_ump *rmidi = ump->private_data;
 338
 339         return rmidi->eps[dir];
 340 }
 341
 342 /* ump open callback */
 343 static int snd_usb_midi_v2_open(struct snd_ump_endpoint *ump, int dir)
 344 {
 345         struct snd_usb_midi2_endpoint *ep = ump_to_endpoint(ump, dir);
 346         int err = 0;
 347
 348         if (!ep || !ep->endpoint)
 349                 return -ENODEV;
 350         if (ep->disconnected)
 351                 return -EIO;
 352         if (ep->direction == STR_OUT) {
 353                 err = alloc_midi_urbs(ep);
 354                 if (err)
 355                         return err;
 356         }
 357         return 0;
 358 }
 359
 360 /* ump close callback */
 361 static void snd_usb_midi_v2_close(struct snd_ump_endpoint *ump, int dir)
 362 {
 363         struct snd_usb_midi2_endpoint *ep = ump_to_endpoint(ump, dir);
 364
 365         if (ep->direction == STR_OUT) {
 366                 kill_midi_urbs(ep, false);
 367                 drain_urb_queue(ep);
 368                 free_midi_urbs(ep);
 369         }
 370 }
 371
 372 /* ump trigger callback */
 373 static void snd_usb_midi_v2_trigger(struct snd_ump_endpoint *ump, int dir,
 374                                     int up)
 375 {
 376         struct snd_usb_midi2_endpoint *ep = ump_to_endpoint(ump, dir);
 377
 378         atomic_set(&ep->running, up);
 379         if (up && ep->direction == STR_OUT && !ep->disconnected)
 380                 submit_io_urbs(ep);
 381 }
 382
 383 /* ump drain callback */
 384 static void snd_usb_midi_v2_drain(struct snd_ump_endpoint *ump, int dir)
 385 {
 386         struct snd_usb_midi2_endpoint *ep = ump_to_endpoint(ump, dir);
 387
 388         drain_urb_queue(ep);
 389 }
 390
 391 /* allocate and start all input streams */
 392 static int start_input_streams(struct snd_usb_midi2_interface *umidi)
 393 {
 394         struct snd_usb_midi2_endpoint *ep;
 395         int err;
 396
 397         list_for_each_entry(ep, &umidi->ep_list, list) {
 398                 if (ep->direction == STR_IN) {
 399                         err = alloc_midi_urbs(ep);
 400                         if (err < 0)
 401                                 goto error;
 402                 }
 403         }
 404
 405         list_for_each_entry(ep, &umidi->ep_list, list) {
 406                 if (ep->direction == STR_IN)
 407                         submit_io_urbs(ep);
 408         }
 409
 410         return 0;
 411
 412  error:
 413         list_for_each_entry(ep, &umidi->ep_list, list) {
 414                 if (ep->direction == STR_IN)
 415                         free_midi_urbs(ep);
 416         }
 417
 418         return err;
 419 }
 420
 421 static const struct snd_ump_ops snd_usb_midi_v2_ump_ops = {
 422         .open = snd_usb_midi_v2_open,
 423         .close = snd_usb_midi_v2_close,
 424         .trigger = snd_usb_midi_v2_trigger,
 425         .drain = snd_usb_midi_v2_drain,
 426 };
 427
 428 /* create a USB MIDI 2.0 endpoint object */
 429 static int create_midi2_endpoint(struct snd_usb_midi2_interface *umidi,
 430                                  struct usb_host_endpoint *hostep,
 431                                  const struct usb_ms20_endpoint_descriptor *ms_ep)
 432 {
 433         struct snd_usb_midi2_endpoint *ep;
 434         int endpoint, dir;
 435
 436         usb_audio_dbg(umidi->chip, "Creating an EP 0x%02x, #GTB=%d\n",
 437                       hostep->desc.bEndpointAddress,
 438                       ms_ep->bNumGrpTrmBlock);
 439
 440         ep = kzalloc(sizeof(*ep), GFP_KERNEL);
 441         if (!ep)
 442                 return -ENOMEM;
 443
 444         spin_lock_init(&ep->lock);
 445         init_waitqueue_head(&ep->wait);
 446         ep->dev = umidi->chip->dev;
 447         endpoint = hostep->desc.bEndpointAddress;
 448         dir = (endpoint & USB_DIR_IN) ? STR_IN : STR_OUT;
 449
 450         ep->endpoint = endpoint;
 451         ep->direction = dir;
 452         ep->ms_ep = ms_ep;
 453         if (usb_endpoint_xfer_int(&hostep->desc))
 454                 ep->interval = hostep->desc.bInterval;
 455         else
 456                 ep->interval = 0;
 457         if (dir == STR_IN) {
 458                 if (ep->interval)
 459                         ep->pipe = usb_rcvintpipe(ep->dev, endpoint);
 460                 else
 461                         ep->pipe = usb_rcvbulkpipe(ep->dev, endpoint);
 462         } else {
 463                 if (ep->interval)
 464                         ep->pipe = usb_sndintpipe(ep->dev, endpoint);
 465                 else
 466                         ep->pipe = usb_sndbulkpipe(ep->dev, endpoint);
 467         }
 468         ep->packets = usb_maxpacket(ep->dev, ep->pipe);
 469         list_add_tail(&ep->list, &umidi->ep_list);
 470
 471         return 0;
 472 }
 473
 474 /* destructor for endpoint; from snd_usb_midi_v2_free() */
 475 static void free_midi2_endpoint(struct snd_usb_midi2_endpoint *ep)
 476 {
 477         list_del(&ep->list);
 478         free_midi_urbs(ep);
 479         kfree(ep);
 480 }
 481
 482 /* call all endpoint destructors */
 483 static void free_all_midi2_endpoints(struct snd_usb_midi2_interface *umidi)
 484 {
 485         struct snd_usb_midi2_endpoint *ep;
 486
 487         while (!list_empty(&umidi->ep_list)) {
 488                 ep = list_first_entry(&umidi->ep_list,
 489                                       struct snd_usb_midi2_endpoint, list);
 490                 free_midi2_endpoint(ep);
 491         }
 492 }
 493
 494 /* find a MIDI STREAMING descriptor with a given subtype */
 495 static void *find_usb_ms_endpoint_descriptor(struct usb_host_endpoint *hostep,
 496                                              unsigned char subtype)
 497 {
 498         unsigned char *extra = hostep->extra;
 499         int extralen = hostep->extralen;
 500
 501         while (extralen > 3) {
 502                 struct usb_ms_endpoint_descriptor *ms_ep =
 503                         (struct usb_ms_endpoint_descriptor *)extra;
 504
 505                 if (ms_ep->bLength > 3 &&
 506                     ms_ep->bDescriptorType == USB_DT_CS_ENDPOINT &&
 507                     ms_ep->bDescriptorSubtype == subtype)
 508                         return ms_ep;
 509                 if (!extra[0])
 510                         break;
 511                 extralen -= extra[0];
 512                 extra += extra[0];
 513         }
 514         return NULL;
 515 }
 516
 517 /* get the full group terminal block descriptors and return the size */
 518 static int get_group_terminal_block_descs(struct snd_usb_midi2_interface *umidi)
 519 {
 520         struct usb_host_interface *hostif = umidi->hostif;
 521         struct usb_device *dev = umidi->chip->dev;
 522         struct usb_ms20_gr_trm_block_header_descriptor header = { 0 };
 523         unsigned char *data;
 524         int err, size;
 525
 526         err = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0),
 527                               USB_REQ_GET_DESCRIPTOR,
 528                               USB_RECIP_INTERFACE | USB_TYPE_STANDARD | USB_DIR_IN,
 529                               USB_DT_CS_GR_TRM_BLOCK << 8 | hostif->desc.bAlternateSetting,
 530                               hostif->desc.bInterfaceNumber,
 531                               &header, sizeof(header));
 532         if (err < 0)
 533                 return err;
 534         size = __le16_to_cpu(header.wTotalLength);
 535         if (!size) {
 536                 dev_err(&dev->dev, "Failed to get GTB descriptors for %d:%d\n",
 537                         hostif->desc.bInterfaceNumber, hostif->desc.bAlternateSetting);
 538                 return -EINVAL;
 539         }
 540
 541         data = kzalloc(size, GFP_KERNEL);
 542         if (!data)
 543                 return -ENOMEM;
 544
 545         err = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0),
 546                               USB_REQ_GET_DESCRIPTOR,
 547                               USB_RECIP_INTERFACE | USB_TYPE_STANDARD | USB_DIR_IN,
 548                               USB_DT_CS_GR_TRM_BLOCK << 8 | hostif->desc.bAlternateSetting,
 549                               hostif->desc.bInterfaceNumber, data, size);
 550         if (err < 0) {
 551                 kfree(data);
 552                 return err;
 553         }
 554
 555         umidi->blk_descs = data;
 556         umidi->blk_desc_size = size;
 557         return 0;
 558 }
 559
 560 /* find the corresponding group terminal block descriptor */
 561 static const struct usb_ms20_gr_trm_block_descriptor *
 562 find_group_terminal_block(struct snd_usb_midi2_interface *umidi, int id)
 563 {
 564         const unsigned char *data = umidi->blk_descs;
 565         int size = umidi->blk_desc_size;
 566         const struct usb_ms20_gr_trm_block_descriptor *desc;
 567
 568         size -= sizeof(struct usb_ms20_gr_trm_block_header_descriptor);
 569         data += sizeof(struct usb_ms20_gr_trm_block_header_descriptor);
 570         while (size > 0 && *data && *data <= size) {
 571                 desc = (const struct usb_ms20_gr_trm_block_descriptor *)data;
 572                 if (desc->bLength >= sizeof(*desc) &&
 573                     desc->bDescriptorType == USB_DT_CS_GR_TRM_BLOCK &&
 574                     desc->bDescriptorSubtype == USB_MS_GR_TRM_BLOCK &&
 575                     desc->bGrpTrmBlkID == id)
 576                         return desc;
 577                 size -= *data;
 578                 data += *data;
 579         }
 580
 581         return NULL;
 582 }
 583
 584 /* fill up the information from GTB */
 585 static int parse_group_terminal_block(struct snd_usb_midi2_ump *rmidi,
 586                                       const struct usb_ms20_gr_trm_block_descriptor *desc)
 587 {
 588         struct snd_ump_endpoint *ump = rmidi->ump;
 589         unsigned int protocol, protocol_caps;
 590
 591         /* set default protocol */
 592         switch (desc->bMIDIProtocol) {
 593         case USB_MS_MIDI_PROTO_1_0_64:
 594         case USB_MS_MIDI_PROTO_1_0_64_JRTS:
 595         case USB_MS_MIDI_PROTO_1_0_128:
 596         case USB_MS_MIDI_PROTO_1_0_128_JRTS:
 597                 protocol = SNDRV_UMP_EP_INFO_PROTO_MIDI1;
 598                 break;
 599         case USB_MS_MIDI_PROTO_2_0:
 600         case USB_MS_MIDI_PROTO_2_0_JRTS:
 601                 protocol = SNDRV_UMP_EP_INFO_PROTO_MIDI2;
 602                 break;
 603         default:
 604                 return 0;
 605         }
 606
 607         if (ump->info.protocol && ump->info.protocol != protocol)
 608                 usb_audio_info(rmidi->umidi->chip,
 609                                "Overriding preferred MIDI protocol in GTB %d: %x -> %x\n",
 610                                rmidi->usb_block_id, ump->info.protocol,
 611                                protocol);
 612         ump->info.protocol = protocol;
 613
 614         protocol_caps = protocol;
 615         switch (desc->bMIDIProtocol) {
 616         case USB_MS_MIDI_PROTO_1_0_64_JRTS:
 617         case USB_MS_MIDI_PROTO_1_0_128_JRTS:
 618         case USB_MS_MIDI_PROTO_2_0_JRTS:
 619                 protocol_caps |= SNDRV_UMP_EP_INFO_PROTO_JRTS_TX |
 620                         SNDRV_UMP_EP_INFO_PROTO_JRTS_RX;
 621                 break;
 622         }
 623
 624         if (ump->info.protocol_caps && ump->info.protocol_caps != protocol_caps)
 625                 usb_audio_info(rmidi->umidi->chip,
 626                                "Overriding MIDI protocol caps in GTB %d: %x -> %x\n",
 627                                rmidi->usb_block_id, ump->info.protocol_caps,
 628                                protocol_caps);
 629         ump->info.protocol_caps = protocol_caps;
 630
 631         return 0;
 632 }
 633
 634 /* allocate and parse for each assigned group terminal block */
 635 static int parse_group_terminal_blocks(struct snd_usb_midi2_interface *umidi)
 636 {
 637         struct snd_usb_midi2_ump *rmidi;
 638         const struct usb_ms20_gr_trm_block_descriptor *desc;
 639         int err;
 640
 641         err = get_group_terminal_block_descs(umidi);
 642         if (err < 0)
 643                 return err;
 644         if (!umidi->blk_descs)
 645                 return 0;
 646
 647         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
 648                 desc = find_group_terminal_block(umidi, rmidi->usb_block_id);
 649                 if (!desc)
 650                         continue;
 651                 err = parse_group_terminal_block(rmidi, desc);
 652                 if (err < 0)
 653                         return err;
 654         }
 655
 656         return 0;
 657 }
 658
 659 /* parse endpoints included in the given interface and create objects */
 660 static int parse_midi_2_0_endpoints(struct snd_usb_midi2_interface *umidi)
 661 {
 662         struct usb_host_interface *hostif = umidi->hostif;
 663         struct usb_host_endpoint *hostep;
 664         struct usb_ms20_endpoint_descriptor *ms_ep;
 665         int i, err;
 666
 667         for (i = 0; i < hostif->desc.bNumEndpoints; i++) {
 668                 hostep = &hostif->endpoint[i];
 669                 if (!usb_endpoint_xfer_bulk(&hostep->desc) &&
 670                     !usb_endpoint_xfer_int(&hostep->desc))
 671                         continue;
 672                 ms_ep = find_usb_ms_endpoint_descriptor(hostep, USB_MS_GENERAL_2_0);
 673                 if (!ms_ep)
 674                         continue;
 675                 if (ms_ep->bLength <= sizeof(*ms_ep))
 676                         continue;
 677                 if (!ms_ep->bNumGrpTrmBlock)
 678                         continue;
 679                 if (ms_ep->bLength < sizeof(*ms_ep) + ms_ep->bNumGrpTrmBlock)
 680                         continue;
 681                 err = create_midi2_endpoint(umidi, hostep, ms_ep);
 682                 if (err < 0)
 683                         return err;
 684         }
 685         return 0;
 686 }
 687
 688 static void free_all_midi2_umps(struct snd_usb_midi2_interface *umidi)
 689 {
 690         struct snd_usb_midi2_ump *rmidi;
 691
 692         while (!list_empty(&umidi->rawmidi_list)) {
 693                 rmidi = list_first_entry(&umidi->rawmidi_list,
 694                                          struct snd_usb_midi2_ump, list);
 695                 list_del(&rmidi->list);
 696                 kfree(rmidi);
 697         }
 698 }
 699
 700 static int create_midi2_ump(struct snd_usb_midi2_interface *umidi,
 701                             struct snd_usb_midi2_endpoint *ep_in,
 702                             struct snd_usb_midi2_endpoint *ep_out,
 703                             int blk_id)
 704 {
 705         struct snd_usb_midi2_ump *rmidi;
 706         struct snd_ump_endpoint *ump;
 707         int input, output;
 708         char idstr[16];
 709         int err;
 710
 711         rmidi = kzalloc(sizeof(*rmidi), GFP_KERNEL);
 712         if (!rmidi)
 713                 return -ENOMEM;
 714         INIT_LIST_HEAD(&rmidi->list);
 715         rmidi->dev = umidi->chip->dev;
 716         rmidi->umidi = umidi;
 717         rmidi->usb_block_id = blk_id;
 718
 719         rmidi->index = umidi->chip->num_rawmidis;
 720         snprintf(idstr, sizeof(idstr), "UMP %d", rmidi->index);
 721         input = ep_in ? 1 : 0;
 722         output = ep_out ? 1 : 0;
 723         err = snd_ump_endpoint_new(umidi->chip->card, idstr, rmidi->index,
 724                                    output, input, &ump);
 725         if (err < 0) {
 726                 usb_audio_dbg(umidi->chip, "Failed to create a UMP object\n");
 727                 kfree(rmidi);
 728                 return err;
 729         }
 730
 731         rmidi->ump = ump;
 732         umidi->chip->num_rawmidis++;
 733
 734         ump->private_data = rmidi;
 735         ump->ops = &snd_usb_midi_v2_ump_ops;
 736
 737         rmidi->eps[STR_IN] = ep_in;
 738         rmidi->eps[STR_OUT] = ep_out;
 739         if (ep_in) {
 740                 ep_in->pair = ep_out;
 741                 ep_in->rmidi = rmidi;
 742                 ep_in->ump = ump;
 743         }
 744         if (ep_out) {
 745                 ep_out->pair = ep_in;
 746                 ep_out->rmidi = rmidi;
 747                 ep_out->ump = ump;
 748         }
 749
 750         list_add_tail(&rmidi->list, &umidi->rawmidi_list);
 751         return 0;
 752 }
 753
 754 /* find the UMP EP with the given USB block id */
 755 static struct snd_usb_midi2_ump *
 756 find_midi2_ump(struct snd_usb_midi2_interface *umidi, int blk_id)
 757 {
 758         struct snd_usb_midi2_ump *rmidi;
 759
 760         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
 761                 if (rmidi->usb_block_id == blk_id)
 762                         return rmidi;
 763         }
 764         return NULL;
 765 }
 766
 767 /* look for the matching output endpoint and create UMP object if found */
 768 static int find_matching_ep_partner(struct snd_usb_midi2_interface *umidi,
 769                                     struct snd_usb_midi2_endpoint *ep,
 770                                     int blk_id)
 771 {
 772         struct snd_usb_midi2_endpoint *pair_ep;
 773         int blk;
 774
 775         usb_audio_dbg(umidi->chip, "Looking for a pair for EP-in 0x%02x\n",
 776                       ep->endpoint);
 777         list_for_each_entry(pair_ep, &umidi->ep_list, list) {
 778                 if (pair_ep->direction != STR_OUT)
 779                         continue;
 780                 if (pair_ep->pair)
 781                         continue; /* already paired */
 782                 for (blk = 0; blk < pair_ep->ms_ep->bNumGrpTrmBlock; blk++) {
 783                         if (pair_ep->ms_ep->baAssoGrpTrmBlkID[blk] == blk_id) {
 784                                 usb_audio_dbg(umidi->chip,
 785                                               "Found a match with EP-out 0x%02x blk %d\n",
 786                                               pair_ep->endpoint, blk);
 787                                 return create_midi2_ump(umidi, ep, pair_ep, blk_id);
 788                         }
 789                 }
 790         }
 791         return 0;
 792 }
 793
 794 /* Call UMP helper to parse UMP endpoints;
 795  * this needs to be called after starting the input streams for bi-directional
 796  * communications
 797  */
 798 static int parse_ump_endpoints(struct snd_usb_midi2_interface *umidi)
 799 {
 800         struct snd_usb_midi2_ump *rmidi;
 801         int err;
 802
 803         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
 804                 if (!rmidi->ump ||
 805                     !(rmidi->ump->core.info_flags & SNDRV_RAWMIDI_INFO_DUPLEX))
 806                         continue;
 807                 err = snd_ump_parse_endpoint(rmidi->ump);
 808                 if (!err) {
 809                         rmidi->ump_parsed = true;
 810                 } else {
 811                         if (err == -ENOMEM)
 812                                 return err;
 813                         /* fall back to GTB later */
 814                 }
 815         }
 816         return 0;
 817 }
 818
 819 /* create a UMP block from a GTB entry */
 820 static int create_gtb_block(struct snd_usb_midi2_ump *rmidi, int dir, int blk)
 821 {
 822         struct snd_usb_midi2_interface *umidi = rmidi->umidi;
 823         const struct usb_ms20_gr_trm_block_descriptor *desc;
 824         struct snd_ump_block *fb;
 825         int type, err;
 826
 827         desc = find_group_terminal_block(umidi, blk);
 828         if (!desc)
 829                 return 0;
 830
 831         usb_audio_dbg(umidi->chip,
 832                       "GTB %d: type=%d, group=%d/%d, protocol=%d, in bw=%d, out bw=%d\n",
 833                       blk, desc->bGrpTrmBlkType, desc->nGroupTrm,
 834                       desc->nNumGroupTrm, desc->bMIDIProtocol,
 835                       __le16_to_cpu(desc->wMaxInputBandwidth),
 836                       __le16_to_cpu(desc->wMaxOutputBandwidth));
 837
 838         /* assign the direction */
 839         switch (desc->bGrpTrmBlkType) {
 840         case USB_MS_GR_TRM_BLOCK_TYPE_BIDIRECTIONAL:
 841                 type = SNDRV_UMP_DIR_BIDIRECTION;
 842                 break;
 843         case USB_MS_GR_TRM_BLOCK_TYPE_INPUT_ONLY:
 844                 type = SNDRV_UMP_DIR_INPUT;
 845                 break;
 846         case USB_MS_GR_TRM_BLOCK_TYPE_OUTPUT_ONLY:
 847                 type = SNDRV_UMP_DIR_OUTPUT;
 848                 break;
 849         default:
 850                 usb_audio_dbg(umidi->chip, "Unsupported GTB type %d\n",
 851                               desc->bGrpTrmBlkType);
 852                 return 0; /* unsupported */
 853         }
 854
 855         /* guess work: set blk-1 as the (0-based) block ID */
 856         err = snd_ump_block_new(rmidi->ump, blk - 1, type,
 857                                 desc->nGroupTrm, desc->nNumGroupTrm,
 858                                 &fb);
 859         if (err == -EBUSY)
 860                 return 0; /* already present */
 861         else if (err)
 862                 return err;
 863
 864         if (desc->iBlockItem)
 865                 usb_string(rmidi->dev, desc->iBlockItem,
 866                            fb->info.name, sizeof(fb->info.name));
 867
 868         if (__le16_to_cpu(desc->wMaxInputBandwidth) == 1 ||
 869             __le16_to_cpu(desc->wMaxOutputBandwidth) == 1)
 870                 fb->info.flags |= SNDRV_UMP_BLOCK_IS_MIDI1 |
 871                         SNDRV_UMP_BLOCK_IS_LOWSPEED;
 872
 873         usb_audio_dbg(umidi->chip,
 874                       "Created a UMP block %d from GTB, name=%s\n",
 875                       blk, fb->info.name);
 876         return 0;
 877 }
 878
 879 /* Create UMP blocks for each UMP EP */
 880 static int create_blocks_from_gtb(struct snd_usb_midi2_interface *umidi)
 881 {
 882         struct snd_usb_midi2_ump *rmidi;
 883         int i, blk, err, dir;
 884
 885         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
 886                 if (!rmidi->ump)
 887                         continue;
 888                 /* Blocks have been already created? */
 889                 if (rmidi->ump_parsed || rmidi->ump->info.num_blocks)
 890                         continue;
 891                 /* GTB is static-only */
 892                 rmidi->ump->info.flags |= SNDRV_UMP_EP_INFO_STATIC_BLOCKS;
 893                 /* loop over GTBs */
 894                 for (dir = 0; dir < 2; dir++) {
 895                         if (!rmidi->eps[dir])
 896                                 continue;
 897                         for (i = 0; i < rmidi->eps[dir]->ms_ep->bNumGrpTrmBlock; i++) {
 898                                 blk = rmidi->eps[dir]->ms_ep->baAssoGrpTrmBlkID[i];
 899                                 err = create_gtb_block(rmidi, dir, blk);
 900                                 if (err < 0)
 901                                         return err;
 902                         }
 903                 }
 904         }
 905
 906         return 0;
 907 }
 908
 909 /* attach legacy rawmidis */
 910 static int attach_legacy_rawmidi(struct snd_usb_midi2_interface *umidi)
 911 {
 912 #if IS_ENABLED(CONFIG_SND_UMP_LEGACY_RAWMIDI)
 913         struct snd_usb_midi2_ump *rmidi;
 914         int err;
 915
 916         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
 917                 err = snd_ump_attach_legacy_rawmidi(rmidi->ump,
 918                                                     "Legacy MIDI",
 919                                                     umidi->chip->num_rawmidis);
 920                 if (err < 0)
 921                         return err;
 922                 umidi->chip->num_rawmidis++;
 923         }
 924 #endif
 925         return 0;
 926 }
 927
 928 static void snd_usb_midi_v2_free(struct snd_usb_midi2_interface *umidi)
 929 {
 930         free_all_midi2_endpoints(umidi);
 931         free_all_midi2_umps(umidi);
 932         list_del(&umidi->list);
 933         kfree(umidi->blk_descs);
 934         kfree(umidi);
 935 }
 936
 937 /* parse the interface for MIDI 2.0 */
 938 static int parse_midi_2_0(struct snd_usb_midi2_interface *umidi)
 939 {
 940         struct snd_usb_midi2_endpoint *ep;
 941         int blk, id, err;
 942
 943         /* First, create an object for each USB MIDI Endpoint */
 944         err = parse_midi_2_0_endpoints(umidi);
 945         if (err < 0)
 946                 return err;
 947         if (list_empty(&umidi->ep_list)) {
 948                 usb_audio_warn(umidi->chip, "No MIDI endpoints found\n");
 949                 return -ENODEV;
 950         }
 951
 952         /*
 953          * Next, look for EP I/O pairs that are found in group terminal blocks
 954          * A UMP object is created for each EP I/O pair as bidirecitonal
 955          * UMP EP
 956          */
 957         list_for_each_entry(ep, &umidi->ep_list, list) {
 958                 /* only input in this loop; output is matched in find_midi_ump() */
 959                 if (ep->direction != STR_IN)
 960                         continue;
 961                 for (blk = 0; blk < ep->ms_ep->bNumGrpTrmBlock; blk++) {
 962                         id = ep->ms_ep->baAssoGrpTrmBlkID[blk];
 963                         err = find_matching_ep_partner(umidi, ep, id);
 964                         if (err < 0)
 965                                 return err;
 966                 }
 967         }
 968
 969         /*
 970          * For the remaining EPs, treat as singles, create a UMP object with
 971          * unidirectional EP
 972          */
 973         list_for_each_entry(ep, &umidi->ep_list, list) {
 974                 if (ep->rmidi)
 975                         continue; /* already paired */
 976                 for (blk = 0; blk < ep->ms_ep->bNumGrpTrmBlock; blk++) {
 977                         id = ep->ms_ep->baAssoGrpTrmBlkID[blk];
 978                         if (find_midi2_ump(umidi, id))
 979                                 continue;
 980                         usb_audio_dbg(umidi->chip,
 981                                       "Creating a unidirection UMP for EP=0x%02x, blk=%d\n",
 982                                       ep->endpoint, id);
 983                         if (ep->direction == STR_IN)
 984                                 err = create_midi2_ump(umidi, ep, NULL, id);
 985                         else
 986                                 err = create_midi2_ump(umidi, NULL, ep, id);
 987                         if (err < 0)
 988                                 return err;
 989                         break;
 990                 }
 991         }
 992
 993         return attach_legacy_rawmidi(umidi);
 994 }
 995
 996 /* is the given interface for MIDI 2.0? */
 997 static bool is_midi2_altset(struct usb_host_interface *hostif)
 998 {
 999         struct usb_ms_header_descriptor *ms_header =
1000                 (struct usb_ms_header_descriptor *)hostif->extra;
1001
1002         if (hostif->extralen < 7 ||
1003             ms_header->bLength < 7 ||
1004             ms_header->bDescriptorType != USB_DT_CS_INTERFACE ||
1005             ms_header->bDescriptorSubtype != UAC_HEADER)
1006                 return false;
1007
1008         return le16_to_cpu(ms_header->bcdMSC) == USB_MS_REV_MIDI_2_0;
1009 }
1010
1011 /* change the altsetting */
1012 static int set_altset(struct snd_usb_midi2_interface *umidi)
1013 {
1014         usb_audio_dbg(umidi->chip, "Setting host iface %d:%d\n",
1015                       umidi->hostif->desc.bInterfaceNumber,
1016                       umidi->hostif->desc.bAlternateSetting);
1017         return usb_set_interface(umidi->chip->dev,
1018                                  umidi->hostif->desc.bInterfaceNumber,
1019                                  umidi->hostif->desc.bAlternateSetting);
1020 }
1021
1022 /* fill UMP Endpoint name string from USB descriptor */
1023 static void fill_ump_ep_name(struct snd_ump_endpoint *ump,
1024                              struct usb_device *dev, int id)
1025 {
1026         int len;
1027
1028         usb_string(dev, id, ump->info.name, sizeof(ump->info.name));
1029
1030         /* trim superfluous "MIDI" suffix */
1031         len = strlen(ump->info.name);
1032         if (len > 5 && !strcmp(ump->info.name + len - 5, " MIDI"))
1033                 ump->info.name[len - 5] = 0;
1034 }
1035
1036 /* fill the fallback name string for each rawmidi instance */
1037 static void set_fallback_rawmidi_names(struct snd_usb_midi2_interface *umidi)
1038 {
1039         struct usb_device *dev = umidi->chip->dev;
1040         struct snd_usb_midi2_ump *rmidi;
1041         struct snd_ump_endpoint *ump;
1042
1043         list_for_each_entry(rmidi, &umidi->rawmidi_list, list) {
1044                 ump = rmidi->ump;
1045                 /* fill UMP EP name from USB descriptors */
1046                 if (!*ump->info.name && umidi->hostif->desc.iInterface)
1047                         fill_ump_ep_name(ump, dev, umidi->hostif->desc.iInterface);
1048                 else if (!*ump->info.name && dev->descriptor.iProduct)
1049                         fill_ump_ep_name(ump, dev, dev->descriptor.iProduct);
1050                 /* fill fallback name */
1051                 if (!*ump->info.name)
1052                         sprintf(ump->info.name, "USB MIDI %d", rmidi->index);
1053                 /* copy as rawmidi name if not set */
1054                 if (!*ump->core.name)
1055                         strscpy(ump->core.name, ump->info.name,
1056                                 sizeof(ump->core.name));
1057                 /* use serial number string as unique UMP product id */
1058                 if (!*ump->info.product_id && dev->descriptor.iSerialNumber)
1059                         usb_string(dev, dev->descriptor.iSerialNumber,
1060                                    ump->info.product_id,
1061                                    sizeof(ump->info.product_id));
1062 #if IS_ENABLED(CONFIG_SND_UMP_LEGACY_RAWMIDI)
1063                 if (ump->legacy_rmidi && !*ump->legacy_rmidi->name)
1064                         snprintf(ump->legacy_rmidi->name,
1065                                  sizeof(ump->legacy_rmidi->name),
1066                                  "%s (MIDI 1.0)", ump->info.name);
1067 #endif
1068         }
1069 }
1070
1071 /* create MIDI interface; fallback to MIDI 1.0 if needed */
1072 int snd_usb_midi_v2_create(struct snd_usb_audio *chip,
1073                            struct usb_interface *iface,
1074                            const struct snd_usb_audio_quirk *quirk,
1075                            unsigned int usb_id)
1076 {
1077         struct snd_usb_midi2_interface *umidi;
1078         struct usb_host_interface *hostif;
1079         int err;
1080
1081         usb_audio_dbg(chip, "Parsing interface %d...\n",
1082                       iface->altsetting[0].desc.bInterfaceNumber);
1083
1084         /* fallback to MIDI 1.0? */
1085         if (!midi2_enable) {
1086                 usb_audio_info(chip, "Falling back to MIDI 1.0 by module option\n");
1087                 goto fallback_to_midi1;
1088         }
1089         if ((quirk && quirk->type != QUIRK_MIDI_STANDARD_INTERFACE) ||
1090             iface->num_altsetting < 2) {
1091                 usb_audio_info(chip, "Quirk or no altest; falling back to MIDI 1.0\n");
1092                 goto fallback_to_midi1;
1093         }
1094         hostif = &iface->altsetting[1];
1095         if (!is_midi2_altset(hostif)) {
1096                 usb_audio_info(chip, "No MIDI 2.0 at altset 1, falling back to MIDI 1.0\n");
1097                 goto fallback_to_midi1;
1098         }
1099         if (!hostif->desc.bNumEndpoints) {
1100                 usb_audio_info(chip, "No endpoint at altset 1, falling back to MIDI 1.0\n");
1101                 goto fallback_to_midi1;
1102         }
1103
1104         usb_audio_dbg(chip, "Creating a MIDI 2.0 instance for %d:%d\n",
1105                       hostif->desc.bInterfaceNumber,
1106                       hostif->desc.bAlternateSetting);
1107
1108         umidi = kzalloc(sizeof(*umidi), GFP_KERNEL);
1109         if (!umidi)
1110                 return -ENOMEM;
1111         umidi->chip = chip;
1112         umidi->iface = iface;
1113         umidi->hostif = hostif;
1114         INIT_LIST_HEAD(&umidi->rawmidi_list);
1115         INIT_LIST_HEAD(&umidi->ep_list);
1116
1117         list_add_tail(&umidi->list, &chip->midi_v2_list);
1118
1119         err = set_altset(umidi);
1120         if (err < 0) {
1121                 usb_audio_err(chip, "Failed to set altset\n");
1122                 goto error;
1123         }
1124
1125         /* assume only altset 1 corresponding to MIDI 2.0 interface */
1126         err = parse_midi_2_0(umidi);
1127         if (err < 0) {
1128                 usb_audio_err(chip, "Failed to parse MIDI 2.0 interface\n");
1129                 goto error;
1130         }
1131
1132         /* parse USB group terminal blocks */
1133         err = parse_group_terminal_blocks(umidi);
1134         if (err < 0) {
1135                 usb_audio_err(chip, "Failed to parse GTB\n");
1136                 goto error;
1137         }
1138
1139         err = start_input_streams(umidi);
1140         if (err < 0) {
1141                 usb_audio_err(chip, "Failed to start input streams\n");
1142                 goto error;
1143         }
1144
1145         if (midi2_ump_probe) {
1146                 err = parse_ump_endpoints(umidi);
1147                 if (err < 0) {
1148                         usb_audio_err(chip, "Failed to parse UMP endpoint\n");
1149                         goto error;
1150                 }
1151         }
1152
1153         err = create_blocks_from_gtb(umidi);
1154         if (err < 0) {
1155                 usb_audio_err(chip, "Failed to create GTB blocks\n");
1156                 goto error;
1157         }
1158
1159         set_fallback_rawmidi_names(umidi);
1160         return 0;
1161
1162  error:
1163         snd_usb_midi_v2_free(umidi);
1164         return err;
1165
1166  fallback_to_midi1:
1167         return __snd_usbmidi_create(chip->card, iface, &chip->midi_list,
1168                                     quirk, usb_id, &chip->num_rawmidis);
1169 }
1170
1171 static void suspend_midi2_endpoint(struct snd_usb_midi2_endpoint *ep)
1172 {
1173         kill_midi_urbs(ep, true);
1174         drain_urb_queue(ep);
1175 }
1176
1177 void snd_usb_midi_v2_suspend_all(struct snd_usb_audio *chip)
1178 {
1179         struct snd_usb_midi2_interface *umidi;
1180         struct snd_usb_midi2_endpoint *ep;
1181
1182         list_for_each_entry(umidi, &chip->midi_v2_list, list) {
1183                 list_for_each_entry(ep, &umidi->ep_list, list)
1184                         suspend_midi2_endpoint(ep);
1185         }
1186 }
1187
1188 static void resume_midi2_endpoint(struct snd_usb_midi2_endpoint *ep)
1189 {
1190         ep->running = ep->suspended;
1191         if (ep->direction == STR_IN)
1192                 submit_io_urbs(ep);
1193         /* FIXME: does it all? */
1194 }
1195
1196 void snd_usb_midi_v2_resume_all(struct snd_usb_audio *chip)
1197 {
1198         struct snd_usb_midi2_interface *umidi;
1199         struct snd_usb_midi2_endpoint *ep;
1200
1201         list_for_each_entry(umidi, &chip->midi_v2_list, list) {
1202                 set_altset(umidi);
1203                 list_for_each_entry(ep, &umidi->ep_list, list)
1204                         resume_midi2_endpoint(ep);
1205         }
1206 }
1207
1208 void snd_usb_midi_v2_disconnect_all(struct snd_usb_audio *chip)
1209 {
1210         struct snd_usb_midi2_interface *umidi;
1211         struct snd_usb_midi2_endpoint *ep;
1212
1213         list_for_each_entry(umidi, &chip->midi_v2_list, list) {
1214                 umidi->disconnected = 1;
1215                 list_for_each_entry(ep, &umidi->ep_list, list) {
1216                         ep->disconnected = 1;
1217                         kill_midi_urbs(ep, false);
1218                         drain_urb_queue(ep);
1219                 }
1220         }
1221 }
1222
1223 /* release the MIDI instance */
1224 void snd_usb_midi_v2_free_all(struct snd_usb_audio *chip)
1225 {
1226         struct snd_usb_midi2_interface *umidi, *next;
1227
1228         list_for_each_entry_safe(umidi, next, &chip->midi_v2_list, list)
1229                 snd_usb_midi_v2_free(umidi);
1230 }