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 1000 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 #define SYSEX_DATA_OFS (sizeof(line6_midi_id) + 3) 70 #define 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 /* device provides hardware monitoring volume control */ 112 LINE6_CAP_HWMON_CTL = 1 << 6, 113 }; 114 115 /* 116 Common data shared by all Line 6 devices. 117 Corresponds to a pair of USB endpoints. 118 */ 119 struct usb_line6 { 120 /* USB device */ 121 struct usb_device *usbdev; 122 123 /* Properties */ 124 const struct line6_properties *properties; 125 126 /* Interval for data USB packets */ 127 int interval; 128 /* ...for isochronous transfers framing */ 129 int intervals_per_second; 130 131 /* Number of isochronous URBs used for frame transfers */ 132 int iso_buffers; 133 134 /* Maximum size of data USB packet */ 135 int max_packet_size; 136 137 /* Device representing the USB interface */ 138 struct device *ifcdev; 139 140 /* Line 6 sound card data structure. 141 * Each device has at least MIDI or PCM. 142 */ 143 struct snd_card *card; 144 145 /* Line 6 PCM device data structure */ 146 struct snd_line6_pcm *line6pcm; 147 148 /* Line 6 MIDI device data structure */ 149 struct snd_line6_midi *line6midi; 150 151 /* URB for listening to POD data endpoint */ 152 struct urb *urb_listen; 153 154 /* Buffer for incoming data from POD data endpoint */ 155 unsigned char *buffer_listen; 156 157 /* Buffer for message to be processed, generated from MIDI layer */ 158 unsigned char *buffer_message; 159 160 /* Length of message to be processed, generated from MIDI layer */ 161 int message_length; 162 163 /* Circular buffer for non-MIDI control messages */ 164 struct { 165 struct mutex read_lock; 166 wait_queue_head_t wait_queue; 167 unsigned int active:1; 168 unsigned int nonblock:1; 169 STRUCT_KFIFO_REC_2(LINE6_BUFSIZE_LISTEN * LINE6_RAW_MESSAGES_MAXCOUNT) 170 fifo; 171 } messages; 172 173 /* Work for delayed PCM startup */ 174 struct delayed_work startup_work; 175 176 /* If MIDI is supported, buffer_message contains the pre-processed data; 177 * otherwise the data is only in urb_listen (buffer_incoming). 178 */ 179 void (*process_message)(struct usb_line6 *); 180 void (*disconnect)(struct usb_line6 *line6); 181 void (*startup)(struct usb_line6 *line6); 182 }; 183 184 extern char *line6_alloc_sysex_buffer(struct usb_line6 *line6, int code1, 185 int code2, int size); 186 extern int line6_read_data(struct usb_line6 *line6, unsigned address, 187 void *data, unsigned datalen); 188 extern int line6_read_serial_number(struct usb_line6 *line6, 189 u32 *serial_number); 190 extern int line6_send_raw_message(struct usb_line6 *line6, 191 const char *buffer, int size); 192 extern int line6_send_raw_message_async(struct usb_line6 *line6, 193 const char *buffer, int size); 194 extern int line6_send_sysex_message(struct usb_line6 *line6, 195 const char *buffer, int size); 196 extern int line6_version_request_async(struct usb_line6 *line6); 197 extern int line6_write_data(struct usb_line6 *line6, unsigned address, 198 void *data, unsigned datalen); 199 200 int line6_probe(struct usb_interface *interface, 201 const struct usb_device_id *id, 202 const char *driver_name, 203 const struct line6_properties *properties, 204 int (*private_init)(struct usb_line6 *, const struct usb_device_id *id), 205 size_t data_size); 206 207 void line6_disconnect(struct usb_interface *interface); 208 209 #ifdef CONFIG_PM 210 int line6_suspend(struct usb_interface *interface, pm_message_t message); 211 int line6_resume(struct usb_interface *interface); 212 #endif 213 214 #endif 215