Loading...
1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Line 6 Linux USB driver
4 *
5 * Copyright (C) 2004-2010 Markus Grabner (line6@grabner-graz.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
67extern 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*/
75struct 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 */
98enum {
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*/
119struct 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
184extern char *line6_alloc_sysex_buffer(struct usb_line6 *line6, int code1,
185 int code2, int size);
186extern int line6_read_data(struct usb_line6 *line6, unsigned address,
187 void *data, unsigned datalen);
188extern int line6_read_serial_number(struct usb_line6 *line6,
189 u32 *serial_number);
190extern int line6_send_raw_message(struct usb_line6 *line6,
191 const char *buffer, int size);
192extern int line6_send_raw_message_async(struct usb_line6 *line6,
193 const char *buffer, int size);
194extern int line6_send_sysex_message(struct usb_line6 *line6,
195 const char *buffer, int size);
196extern int line6_version_request_async(struct usb_line6 *line6);
197extern int line6_write_data(struct usb_line6 *line6, unsigned address,
198 void *data, unsigned datalen);
199
200int 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
207void line6_disconnect(struct usb_interface *interface);
208
209#ifdef CONFIG_PM
210int line6_suspend(struct usb_interface *interface, pm_message_t message);
211int line6_resume(struct usb_interface *interface);
212#endif
213
214#endif
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
67extern const unsigned char line6_midi_id[3];
68
69static const int SYSEX_DATA_OFS = sizeof(line6_midi_id) + 3;
70static const int SYSEX_EXTRA_SIZE = sizeof(line6_midi_id) + 4;
71
72/*
73 Common properties of Line 6 devices.
74*/
75struct 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 */
98enum {
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*/
117struct 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
181extern char *line6_alloc_sysex_buffer(struct usb_line6 *line6, int code1,
182 int code2, int size);
183extern int line6_read_data(struct usb_line6 *line6, unsigned address,
184 void *data, unsigned datalen);
185extern int line6_read_serial_number(struct usb_line6 *line6,
186 u32 *serial_number);
187extern int line6_send_raw_message_async(struct usb_line6 *line6,
188 const char *buffer, int size);
189extern int line6_send_sysex_message(struct usb_line6 *line6,
190 const char *buffer, int size);
191extern ssize_t line6_set_raw(struct device *dev, struct device_attribute *attr,
192 const char *buf, size_t count);
193extern int line6_version_request_async(struct usb_line6 *line6);
194extern int line6_write_data(struct usb_line6 *line6, unsigned address,
195 void *data, unsigned datalen);
196
197int 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
204void line6_disconnect(struct usb_interface *interface);
205
206#ifdef CONFIG_PM
207int line6_suspend(struct usb_interface *interface, pm_message_t message);
208int line6_resume(struct usb_interface *interface);
209#endif
210
211#endif