root/sound/usb/line6/driver.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Line 6 Linux USB driver
   4  *
   5  * Copyright (C) 2004-2010 Markus Grabner (grabner@icg.tugraz.at)
   6  */
   7 
   8 #ifndef DRIVER_H
   9 #define DRIVER_H
  10 
  11 #include <linux/usb.h>
  12 #include <linux/mutex.h>
  13 #include <linux/kfifo.h>
  14 #include <sound/core.h>
  15 
  16 #include "midi.h"
  17 
  18 /* USB 1.1 speed configuration */
  19 #define USB_LOW_INTERVALS_PER_SECOND 1000
  20 #define USB_LOW_ISO_BUFFERS 2
  21 
  22 /* USB 2.0+ speed configuration */
  23 #define USB_HIGH_INTERVALS_PER_SECOND 8000
  24 #define USB_HIGH_ISO_BUFFERS 16
  25 
  26 /* Fallback USB interval and max packet size values */
  27 #define LINE6_FALLBACK_INTERVAL 10
  28 #define LINE6_FALLBACK_MAXPACKETSIZE 16
  29 
  30 #define LINE6_TIMEOUT 1
  31 #define LINE6_BUFSIZE_LISTEN 64
  32 #define LINE6_MIDI_MESSAGE_MAXLEN 256
  33 
  34 #define LINE6_RAW_MESSAGES_MAXCOUNT_ORDER 7
  35 /* 4k packets are common, BUFSIZE * MAXCOUNT should be bigger... */
  36 #define LINE6_RAW_MESSAGES_MAXCOUNT (1 << LINE6_RAW_MESSAGES_MAXCOUNT_ORDER)
  37 
  38 
  39 #if LINE6_BUFSIZE_LISTEN > 65535
  40 #error "Use dynamic fifo instead"
  41 #endif
  42 
  43 /*
  44         Line 6 MIDI control commands
  45 */
  46 #define LINE6_PARAM_CHANGE   0xb0
  47 #define LINE6_PROGRAM_CHANGE 0xc0
  48 #define LINE6_SYSEX_BEGIN    0xf0
  49 #define LINE6_SYSEX_END      0xf7
  50 #define LINE6_RESET          0xff
  51 
  52 /*
  53         MIDI channel for messages initiated by the host
  54         (and eventually echoed back by the device)
  55 */
  56 #define LINE6_CHANNEL_HOST   0x00
  57 
  58 /*
  59         MIDI channel for messages initiated by the device
  60 */
  61 #define LINE6_CHANNEL_DEVICE 0x02
  62 
  63 #define LINE6_CHANNEL_UNKNOWN 5 /* don't know yet what this is good for */
  64 
  65 #define LINE6_CHANNEL_MASK 0x0f
  66 
  67 extern const unsigned char line6_midi_id[3];
  68 
  69 static const int SYSEX_DATA_OFS = sizeof(line6_midi_id) + 3;
  70 static const int SYSEX_EXTRA_SIZE = sizeof(line6_midi_id) + 4;
  71 
  72 /*
  73          Common properties of Line 6 devices.
  74 */
  75 struct line6_properties {
  76         /* Card id string (maximum 16 characters).
  77          * This can be used to address the device in ALSA programs as
  78          * "default:CARD=<id>"
  79          */
  80         const char *id;
  81 
  82         /* Card short name (maximum 32 characters) */
  83         const char *name;
  84 
  85         /* Bit vector defining this device's capabilities in line6usb driver */
  86         int capabilities;
  87 
  88         int altsetting;
  89 
  90         unsigned int ctrl_if;
  91         unsigned int ep_ctrl_r;
  92         unsigned int ep_ctrl_w;
  93         unsigned int ep_audio_r;
  94         unsigned int ep_audio_w;
  95 };
  96 
  97 /* Capability bits */
  98 enum {
  99         /* device supports settings parameter via USB */
 100         LINE6_CAP_CONTROL =     1 << 0,
 101         /* device supports PCM input/output via USB */
 102         LINE6_CAP_PCM =         1 << 1,
 103         /* device supports hardware monitoring */
 104         LINE6_CAP_HWMON =       1 << 2,
 105         /* device requires output data when input is read */
 106         LINE6_CAP_IN_NEEDS_OUT = 1 << 3,
 107         /* device uses raw MIDI via USB (data endpoints) */
 108         LINE6_CAP_CONTROL_MIDI = 1 << 4,
 109         /* device provides low-level information */
 110         LINE6_CAP_CONTROL_INFO = 1 << 5,
 111 };
 112 
 113 /*
 114          Common data shared by all Line 6 devices.
 115          Corresponds to a pair of USB endpoints.
 116 */
 117 struct usb_line6 {
 118         /* USB device */
 119         struct usb_device *usbdev;
 120 
 121         /* Properties */
 122         const struct line6_properties *properties;
 123 
 124         /* Interval for data USB packets */
 125         int interval;
 126         /* ...for isochronous transfers framing */
 127         int intervals_per_second;
 128 
 129         /* Number of isochronous URBs used for frame transfers */
 130         int iso_buffers;
 131 
 132         /* Maximum size of data USB packet */
 133         int max_packet_size;
 134 
 135         /* Device representing the USB interface */
 136         struct device *ifcdev;
 137 
 138         /* Line 6 sound card data structure.
 139          * Each device has at least MIDI or PCM.
 140          */
 141         struct snd_card *card;
 142 
 143         /* Line 6 PCM device data structure */
 144         struct snd_line6_pcm *line6pcm;
 145 
 146         /* Line 6 MIDI device data structure */
 147         struct snd_line6_midi *line6midi;
 148 
 149         /* URB for listening to POD data endpoint */
 150         struct urb *urb_listen;
 151 
 152         /* Buffer for incoming data from POD data endpoint */
 153         unsigned char *buffer_listen;
 154 
 155         /* Buffer for message to be processed, generated from MIDI layer */
 156         unsigned char *buffer_message;
 157 
 158         /* Length of message to be processed, generated from MIDI layer  */
 159         int message_length;
 160 
 161         /* Circular buffer for non-MIDI control messages */
 162         struct {
 163                 struct mutex read_lock;
 164                 wait_queue_head_t wait_queue;
 165                 unsigned int active:1;
 166                 STRUCT_KFIFO_REC_2(LINE6_BUFSIZE_LISTEN * LINE6_RAW_MESSAGES_MAXCOUNT)
 167                         fifo;
 168         } messages;
 169 
 170         /* Work for delayed PCM startup */
 171         struct delayed_work startup_work;
 172 
 173         /* If MIDI is supported, buffer_message contains the pre-processed data;
 174          * otherwise the data is only in urb_listen (buffer_incoming).
 175          */
 176         void (*process_message)(struct usb_line6 *);
 177         void (*disconnect)(struct usb_line6 *line6);
 178         void (*startup)(struct usb_line6 *line6);
 179 };
 180 
 181 extern char *line6_alloc_sysex_buffer(struct usb_line6 *line6, int code1,
 182                                       int code2, int size);
 183 extern int line6_read_data(struct usb_line6 *line6, unsigned address,
 184                            void *data, unsigned datalen);
 185 extern int line6_read_serial_number(struct usb_line6 *line6,
 186                                     u32 *serial_number);
 187 extern int line6_send_raw_message_async(struct usb_line6 *line6,
 188                                         const char *buffer, int size);
 189 extern int line6_send_sysex_message(struct usb_line6 *line6,
 190                                     const char *buffer, int size);
 191 extern ssize_t line6_set_raw(struct device *dev, struct device_attribute *attr,
 192                              const char *buf, size_t count);
 193 extern int line6_version_request_async(struct usb_line6 *line6);
 194 extern int line6_write_data(struct usb_line6 *line6, unsigned address,
 195                             void *data, unsigned datalen);
 196 
 197 int line6_probe(struct usb_interface *interface,
 198                 const struct usb_device_id *id,
 199                 const char *driver_name,
 200                 const struct line6_properties *properties,
 201                 int (*private_init)(struct usb_line6 *, const struct usb_device_id *id),
 202                 size_t data_size);
 203 
 204 void line6_disconnect(struct usb_interface *interface);
 205 
 206 #ifdef CONFIG_PM
 207 int line6_suspend(struct usb_interface *interface, pm_message_t message);
 208 int line6_resume(struct usb_interface *interface);
 209 #endif
 210 
 211 #endif