1 /* $NetBSD: uaudio.c,v 1.91 2004/11/05 17:46:14 kent Exp $ */
5 * Copyright (c) 1999 The NetBSD Foundation, Inc.
8 * This code is derived from software contributed to The NetBSD Foundation
9 * by Lennart Augustsson (lennart@augustsson.net) at
10 * Carlstedt Research & Technology.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
21 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 * POSSIBILITY OF SUCH DAMAGE.
34 #include <sys/cdefs.h>
35 __FBSDID("$FreeBSD$");
38 * USB audio specs: http://www.usb.org/developers/devclass_docs/audio10.pdf
39 * http://www.usb.org/developers/devclass_docs/frmts10.pdf
40 * http://www.usb.org/developers/devclass_docs/termt10.pdf
45 * $NetBSD: uaudio.c,v 1.94 2005/01/15 15:19:53 kent Exp $
46 * $NetBSD: uaudio.c,v 1.95 2005/01/16 06:02:19 dsainty Exp $
47 * $NetBSD: uaudio.c,v 1.96 2005/01/16 12:46:00 kent Exp $
48 * $NetBSD: uaudio.c,v 1.97 2005/02/24 08:19:38 martin Exp $
51 #include <sys/stdint.h>
52 #include <sys/stddef.h>
53 #include <sys/param.h>
54 #include <sys/queue.h>
55 #include <sys/types.h>
56 #include <sys/systm.h>
57 #include <sys/kernel.h>
59 #include <sys/module.h>
61 #include <sys/mutex.h>
62 #include <sys/condvar.h>
63 #include <sys/sysctl.h>
65 #include <sys/unistd.h>
66 #include <sys/callout.h>
67 #include <sys/malloc.h>
71 #include <dev/usb/usb.h>
72 #include <dev/usb/usbdi.h>
73 #include <dev/usb/usbdi_util.h>
75 #define USB_DEBUG_VAR uaudio_debug
76 #include <dev/usb/usb_debug.h>
78 #include <dev/usb/quirk/usb_quirk.h>
80 #include <sys/reboot.h> /* for bootverbose */
82 #ifdef HAVE_KERNEL_OPTION_HEADERS
86 #include <dev/sound/pcm/sound.h>
87 #include <dev/sound/usb/uaudioreg.h>
88 #include <dev/sound/usb/uaudio.h>
89 #include <dev/sound/chip.h>
90 #include "feeder_if.h"
92 static int uaudio_default_rate = 0; /* use rate list */
93 static int uaudio_default_bits = 32;
94 static int uaudio_default_channels = 0; /* use default */
97 static int uaudio_debug = 0;
99 SYSCTL_NODE(_hw_usb, OID_AUTO, uaudio, CTLFLAG_RW, 0, "USB uaudio");
101 SYSCTL_INT(_hw_usb_uaudio, OID_AUTO, debug, CTLFLAG_RW,
102 &uaudio_debug, 0, "uaudio debug level");
104 TUNABLE_INT("hw.usb.uaudio.default_rate", &uaudio_default_rate);
105 SYSCTL_INT(_hw_usb_uaudio, OID_AUTO, default_rate, CTLFLAG_RW,
106 &uaudio_default_rate, 0, "uaudio default sample rate");
108 TUNABLE_INT("hw.usb.uaudio.default_bits", &uaudio_default_bits);
109 SYSCTL_INT(_hw_usb_uaudio, OID_AUTO, default_bits, CTLFLAG_RW,
110 &uaudio_default_bits, 0, "uaudio default sample bits");
112 TUNABLE_INT("hw.usb.uaudio.default_channels", &uaudio_default_channels);
113 SYSCTL_INT(_hw_usb_uaudio, OID_AUTO, default_channels, CTLFLAG_RW,
114 &uaudio_default_channels, 0, "uaudio default sample channels");
117 #define UAUDIO_NFRAMES 64 /* must be factor of 8 due HS-USB */
118 #define UAUDIO_NCHANBUFS 2 /* number of outstanding request */
119 #define UAUDIO_RECURSE_LIMIT 24 /* rounds */
121 #define MAKE_WORD(h,l) (((h) << 8) | (l))
122 #define BIT_TEST(bm,bno) (((bm)[(bno) / 8] >> (7 - ((bno) % 8))) & 1)
123 #define UAUDIO_MAX_CHAN(x) (x)
125 struct uaudio_mixer_node {
128 #define MIX_MAX_CHAN 8
129 int32_t wValue[MIX_MAX_CHAN]; /* using nchan */
133 uint16_t wData[MIX_MAX_CHAN]; /* using nchan */
136 uint8_t update[(MIX_MAX_CHAN + 7) / 8];
140 #define MIX_SIGNED_16 2
141 #define MIX_UNSIGNED_16 3
142 #define MIX_SIGNED_8 4
143 #define MIX_SELECTOR 5
144 #define MIX_UNKNOWN 6
145 #define MIX_SIZE(n) ((((n) == MIX_SIGNED_16) || \
146 ((n) == MIX_UNSIGNED_16)) ? 2 : 1)
147 #define MIX_UNSIGNED(n) ((n) == MIX_UNSIGNED_16)
149 #define MAX_SELECTOR_INPUT_PIN 256
150 uint8_t slctrtype[MAX_SELECTOR_INPUT_PIN];
153 struct uaudio_mixer_node *next;
157 struct pcmchan_caps pcm_cap; /* capabilities */
159 struct snd_dbuf *pcm_buf;
160 const struct usb_config *usb_cfg;
161 struct mtx *pcm_mtx; /* lock protecting this structure */
162 struct uaudio_softc *priv_sc;
163 struct pcm_channel *pcm_ch;
164 struct usb_xfer *xfer[UAUDIO_NCHANBUFS];
165 const struct usb_audio_streaming_interface_descriptor *p_asid;
166 const struct usb_audio_streaming_type1_descriptor *p_asf1d;
167 const struct usb_audio_streaming_endpoint_descriptor *p_sed;
168 const usb_endpoint_descriptor_audio_t *p_ed1;
169 const usb_endpoint_descriptor_audio_t *p_ed2;
170 const struct uaudio_format *p_fmt;
172 uint8_t *buf; /* pointer to buffer */
173 uint8_t *start; /* upper layer buffer start */
174 uint8_t *end; /* upper layer buffer end */
175 uint8_t *cur; /* current position in upper layer
178 uint32_t intr_size; /* in bytes */
179 uint32_t intr_frames; /* in units */
180 uint32_t sample_rate;
181 uint32_t frames_per_second;
183 uint32_t sample_curr;
186 uint32_t pcm_format[2];
188 uint16_t bytes_per_frame[2];
190 uint16_t sample_size;
194 uint8_t iface_alt_index;
197 #define UMIDI_CABLES_MAX 16 /* units */
198 #define UMIDI_TX_FRAMES 256 /* units */
199 #define UMIDI_TX_BUFFER (UMIDI_TX_FRAMES * 4) /* bytes */
207 struct umidi_sub_chan {
208 struct usb_fifo_sc fifo;
213 #define UMIDI_ST_UNKNOWN 0 /* scan for command */
214 #define UMIDI_ST_1PARAM 1
215 #define UMIDI_ST_2PARAM_1 2
216 #define UMIDI_ST_2PARAM_2 3
217 #define UMIDI_ST_SYSEX_0 4
218 #define UMIDI_ST_SYSEX_1 5
219 #define UMIDI_ST_SYSEX_2 6
222 uint8_t write_open:1;
228 struct umidi_sub_chan sub[UMIDI_CABLES_MAX];
231 struct usb_xfer *xfer[UMIDI_N_TRANSFER];
234 uint8_t iface_alt_index;
236 uint8_t read_open_refcount;
237 uint8_t write_open_refcount;
242 uint8_t single_command;
245 struct uaudio_softc {
246 struct sbuf sc_sndstat;
247 struct sndcard_func sc_sndcard_func;
248 struct uaudio_chan sc_rec_chan;
249 struct uaudio_chan sc_play_chan;
250 struct umidi_chan sc_midi_chan;
252 struct usb_device *sc_udev;
253 struct usb_xfer *sc_mixer_xfer[1];
254 struct uaudio_mixer_node *sc_mixer_root;
255 struct uaudio_mixer_node *sc_mixer_curr;
257 uint32_t sc_mix_info;
258 uint32_t sc_recsrc_info;
260 uint16_t sc_audio_rev;
261 uint16_t sc_mixer_count;
263 uint8_t sc_sndstat_valid;
264 uint8_t sc_mixer_iface_index;
265 uint8_t sc_mixer_iface_no;
266 uint8_t sc_mixer_chan;
267 uint8_t sc_pcm_registered:1;
268 uint8_t sc_mixer_init:1;
269 uint8_t sc_uq_audio_swap_lr:1;
270 uint8_t sc_uq_au_inp_async:1;
271 uint8_t sc_uq_au_no_xu:1;
272 uint8_t sc_uq_bad_adc:1;
273 uint8_t sc_uq_au_vendor_class:1;
276 struct uaudio_search_result {
277 uint8_t bit_input[(256 + 7) / 8];
278 uint8_t bit_output[(256 + 7) / 8];
279 uint8_t bit_visited[(256 + 7) / 8];
280 uint8_t recurse_level;
284 struct uaudio_terminal_node {
286 const struct usb_descriptor *desc;
287 const struct usb_audio_input_terminal *it;
288 const struct usb_audio_output_terminal *ot;
289 const struct usb_audio_mixer_unit_0 *mu;
290 const struct usb_audio_selector_unit *su;
291 const struct usb_audio_feature_unit *fu;
292 const struct usb_audio_processing_unit_0 *pu;
293 const struct usb_audio_extension_unit_0 *eu;
295 struct uaudio_search_result usr;
296 struct uaudio_terminal_node *root;
299 struct uaudio_format {
302 uint32_t freebsd_fmt;
303 const char *description;
306 static const struct uaudio_format uaudio_formats[] = {
308 {UA_FMT_PCM8, 8, AFMT_U8, "8-bit U-LE PCM"},
309 {UA_FMT_PCM8, 16, AFMT_U16_LE, "16-bit U-LE PCM"},
310 {UA_FMT_PCM8, 24, AFMT_U24_LE, "24-bit U-LE PCM"},
311 {UA_FMT_PCM8, 32, AFMT_U32_LE, "32-bit U-LE PCM"},
313 {UA_FMT_PCM, 8, AFMT_S8, "8-bit S-LE PCM"},
314 {UA_FMT_PCM, 16, AFMT_S16_LE, "16-bit S-LE PCM"},
315 {UA_FMT_PCM, 24, AFMT_S24_LE, "24-bit S-LE PCM"},
316 {UA_FMT_PCM, 32, AFMT_S32_LE, "32-bit S-LE PCM"},
318 {UA_FMT_ALAW, 8, AFMT_A_LAW, "8-bit A-Law"},
319 {UA_FMT_MULAW, 8, AFMT_MU_LAW, "8-bit mu-Law"},
328 #define UAC_NCLASSES 4
331 static const char *uac_names[] = {
332 "outputs", "inputs", "equalization", "record"
339 static device_probe_t uaudio_probe;
340 static device_attach_t uaudio_attach;
341 static device_detach_t uaudio_detach;
343 static usb_callback_t uaudio_chan_play_callback;
344 static usb_callback_t uaudio_chan_record_callback;
345 static usb_callback_t uaudio_mixer_write_cfg_callback;
346 static usb_callback_t umidi_bulk_read_callback;
347 static usb_callback_t umidi_bulk_write_callback;
349 static void uaudio_chan_fill_info_sub(struct uaudio_softc *,
350 struct usb_device *, uint32_t, uint8_t, uint8_t);
351 static void uaudio_chan_fill_info(struct uaudio_softc *,
352 struct usb_device *);
353 static void uaudio_mixer_add_ctl_sub(struct uaudio_softc *,
354 struct uaudio_mixer_node *);
355 static void uaudio_mixer_add_ctl(struct uaudio_softc *,
356 struct uaudio_mixer_node *);
357 static void uaudio_mixer_add_input(struct uaudio_softc *,
358 const struct uaudio_terminal_node *, int);
359 static void uaudio_mixer_add_output(struct uaudio_softc *,
360 const struct uaudio_terminal_node *, int);
361 static void uaudio_mixer_add_mixer(struct uaudio_softc *,
362 const struct uaudio_terminal_node *, int);
363 static void uaudio_mixer_add_selector(struct uaudio_softc *,
364 const struct uaudio_terminal_node *, int);
365 static uint32_t uaudio_mixer_feature_get_bmaControls(
366 const struct usb_audio_feature_unit *, uint8_t);
367 static void uaudio_mixer_add_feature(struct uaudio_softc *,
368 const struct uaudio_terminal_node *, int);
369 static void uaudio_mixer_add_processing_updown(struct uaudio_softc *,
370 const struct uaudio_terminal_node *, int);
371 static void uaudio_mixer_add_processing(struct uaudio_softc *,
372 const struct uaudio_terminal_node *, int);
373 static void uaudio_mixer_add_extension(struct uaudio_softc *,
374 const struct uaudio_terminal_node *, int);
375 static struct usb_audio_cluster uaudio_mixer_get_cluster(uint8_t,
376 const struct uaudio_terminal_node *);
377 static uint16_t uaudio_mixer_determine_class(const struct uaudio_terminal_node *,
378 struct uaudio_mixer_node *);
379 static uint16_t uaudio_mixer_feature_name(const struct uaudio_terminal_node *,
380 struct uaudio_mixer_node *);
381 static const struct uaudio_terminal_node *uaudio_mixer_get_input(
382 const struct uaudio_terminal_node *, uint8_t);
383 static const struct uaudio_terminal_node *uaudio_mixer_get_output(
384 const struct uaudio_terminal_node *, uint8_t);
385 static void uaudio_mixer_find_inputs_sub(struct uaudio_terminal_node *,
386 const uint8_t *, uint8_t, struct uaudio_search_result *);
387 static void uaudio_mixer_find_outputs_sub(struct uaudio_terminal_node *,
388 uint8_t, uint8_t, struct uaudio_search_result *);
389 static void uaudio_mixer_fill_info(struct uaudio_softc *,
390 struct usb_device *, void *);
391 static uint16_t uaudio_mixer_get(struct usb_device *, uint8_t,
392 struct uaudio_mixer_node *);
393 static void uaudio_mixer_ctl_set(struct uaudio_softc *,
394 struct uaudio_mixer_node *, uint8_t, int32_t val);
395 static usb_error_t uaudio_set_speed(struct usb_device *, uint8_t, uint32_t);
396 static int uaudio_mixer_signext(uint8_t, int);
397 static int uaudio_mixer_bsd2value(struct uaudio_mixer_node *, int32_t val);
398 static const void *uaudio_mixer_verify_desc(const void *, uint32_t);
399 static void uaudio_mixer_init(struct uaudio_softc *);
400 static uint8_t umidi_convert_to_usb(struct umidi_sub_chan *, uint8_t, uint8_t);
401 static struct umidi_sub_chan *umidi_sub_by_fifo(struct usb_fifo *);
402 static void umidi_start_read(struct usb_fifo *);
403 static void umidi_stop_read(struct usb_fifo *);
404 static void umidi_start_write(struct usb_fifo *);
405 static void umidi_stop_write(struct usb_fifo *);
406 static int umidi_open(struct usb_fifo *, int);
407 static int umidi_ioctl(struct usb_fifo *, u_long cmd, void *, int);
408 static void umidi_close(struct usb_fifo *, int);
409 static void umidi_init(device_t dev);
410 static int umidi_probe(device_t dev);
411 static int umidi_detach(device_t dev);
414 static void uaudio_chan_dump_ep_desc(
415 const usb_endpoint_descriptor_audio_t *);
416 static void uaudio_mixer_dump_cluster(uint8_t,
417 const struct uaudio_terminal_node *);
418 static const char *uaudio_mixer_get_terminal_name(uint16_t);
421 static const struct usb_config
422 uaudio_cfg_record[UAUDIO_NCHANBUFS] = {
424 .type = UE_ISOCHRONOUS,
425 .endpoint = UE_ADDR_ANY,
426 .direction = UE_DIR_IN,
427 .bufsize = 0, /* use "wMaxPacketSize * frames" */
428 .frames = UAUDIO_NFRAMES,
429 .flags = {.short_xfer_ok = 1,},
430 .callback = &uaudio_chan_record_callback,
434 .type = UE_ISOCHRONOUS,
435 .endpoint = UE_ADDR_ANY,
436 .direction = UE_DIR_IN,
437 .bufsize = 0, /* use "wMaxPacketSize * frames" */
438 .frames = UAUDIO_NFRAMES,
439 .flags = {.short_xfer_ok = 1,},
440 .callback = &uaudio_chan_record_callback,
444 static const struct usb_config
445 uaudio_cfg_play[UAUDIO_NCHANBUFS] = {
447 .type = UE_ISOCHRONOUS,
448 .endpoint = UE_ADDR_ANY,
449 .direction = UE_DIR_OUT,
450 .bufsize = 0, /* use "wMaxPacketSize * frames" */
451 .frames = UAUDIO_NFRAMES,
452 .flags = {.short_xfer_ok = 1,},
453 .callback = &uaudio_chan_play_callback,
457 .type = UE_ISOCHRONOUS,
458 .endpoint = UE_ADDR_ANY,
459 .direction = UE_DIR_OUT,
460 .bufsize = 0, /* use "wMaxPacketSize * frames" */
461 .frames = UAUDIO_NFRAMES,
462 .flags = {.short_xfer_ok = 1,},
463 .callback = &uaudio_chan_play_callback,
467 static const struct usb_config
468 uaudio_mixer_config[1] = {
471 .endpoint = 0x00, /* Control pipe */
472 .direction = UE_DIR_ANY,
473 .bufsize = (sizeof(struct usb_device_request) + 4),
474 .callback = &uaudio_mixer_write_cfg_callback,
475 .timeout = 1000, /* 1 second */
480 uint8_t umidi_cmd_to_len[16] = {
481 [0x0] = 0, /* reserved */
482 [0x1] = 0, /* reserved */
483 [0x2] = 2, /* bytes */
484 [0x3] = 3, /* bytes */
485 [0x4] = 3, /* bytes */
486 [0x5] = 1, /* bytes */
487 [0x6] = 2, /* bytes */
488 [0x7] = 3, /* bytes */
489 [0x8] = 3, /* bytes */
490 [0x9] = 3, /* bytes */
491 [0xA] = 3, /* bytes */
492 [0xB] = 3, /* bytes */
493 [0xC] = 2, /* bytes */
494 [0xD] = 2, /* bytes */
495 [0xE] = 3, /* bytes */
496 [0xF] = 1, /* bytes */
499 static const struct usb_config
500 umidi_config[UMIDI_N_TRANSFER] = {
501 [UMIDI_TX_TRANSFER] = {
503 .endpoint = UE_ADDR_ANY,
504 .direction = UE_DIR_OUT,
505 .bufsize = UMIDI_TX_BUFFER,
506 .callback = &umidi_bulk_write_callback,
509 [UMIDI_RX_TRANSFER] = {
511 .endpoint = UE_ADDR_ANY,
512 .direction = UE_DIR_IN,
513 .bufsize = 4, /* bytes */
514 .flags = {.short_xfer_ok = 1,.proxy_buffer = 1,},
515 .callback = &umidi_bulk_read_callback,
519 static devclass_t uaudio_devclass;
521 static device_method_t uaudio_methods[] = {
522 DEVMETHOD(device_probe, uaudio_probe),
523 DEVMETHOD(device_attach, uaudio_attach),
524 DEVMETHOD(device_detach, uaudio_detach),
525 DEVMETHOD(device_suspend, bus_generic_suspend),
526 DEVMETHOD(device_resume, bus_generic_resume),
527 DEVMETHOD(device_shutdown, bus_generic_shutdown),
532 static driver_t uaudio_driver = {
534 .methods = uaudio_methods,
535 .size = sizeof(struct uaudio_softc),
538 static const STRUCT_USB_HOST_ID __used uaudio_devs[] = {
539 /* Generic USB audio class match */
540 {USB_IFACE_CLASS(UICLASS_AUDIO),
541 USB_IFACE_SUBCLASS(UISUBCLASS_AUDIOCONTROL),},
542 /* Generic USB MIDI class match */
543 {USB_IFACE_CLASS(UICLASS_AUDIO),
544 USB_IFACE_SUBCLASS(UISUBCLASS_MIDISTREAM),},
548 uaudio_probe(device_t dev)
550 struct usb_attach_arg *uaa = device_get_ivars(dev);
552 if (uaa->usb_mode != USB_MODE_HOST)
555 /* lookup non-standard device */
557 if (uaa->info.bInterfaceClass != UICLASS_AUDIO) {
558 if (usb_test_quirk(uaa, UQ_AU_VENDOR_CLASS) == 0)
562 /* check for AUDIO control interface */
564 if (uaa->info.bInterfaceSubClass == UISUBCLASS_AUDIOCONTROL) {
565 if (usb_test_quirk(uaa, UQ_BAD_AUDIO))
568 return (BUS_PROBE_GENERIC);
571 /* check for MIDI stream */
573 if (uaa->info.bInterfaceSubClass == UISUBCLASS_MIDISTREAM) {
574 if (usb_test_quirk(uaa, UQ_BAD_MIDI))
577 return (BUS_PROBE_GENERIC);
583 uaudio_attach(device_t dev)
585 struct usb_attach_arg *uaa = device_get_ivars(dev);
586 struct uaudio_softc *sc = device_get_softc(dev);
587 struct usb_interface_descriptor *id;
590 sc->sc_play_chan.priv_sc = sc;
591 sc->sc_rec_chan.priv_sc = sc;
592 sc->sc_udev = uaa->device;
593 sc->sc_mixer_iface_index = uaa->info.bIfaceIndex;
594 sc->sc_mixer_iface_no = uaa->info.bIfaceNum;
596 if (usb_test_quirk(uaa, UQ_AUDIO_SWAP_LR))
597 sc->sc_uq_audio_swap_lr = 1;
599 if (usb_test_quirk(uaa, UQ_AU_INP_ASYNC))
600 sc->sc_uq_au_inp_async = 1;
602 if (usb_test_quirk(uaa, UQ_AU_NO_XU))
603 sc->sc_uq_au_no_xu = 1;
605 if (usb_test_quirk(uaa, UQ_BAD_ADC))
606 sc->sc_uq_bad_adc = 1;
608 if (usb_test_quirk(uaa, UQ_AU_VENDOR_CLASS))
609 sc->sc_uq_au_vendor_class = 1;
613 device_set_usb_desc(dev);
615 id = usbd_get_interface_descriptor(uaa->iface);
617 uaudio_chan_fill_info(sc, uaa->device);
619 uaudio_mixer_fill_info(sc, uaa->device, id);
621 DPRINTF("audio rev %d.%02x\n",
622 sc->sc_audio_rev >> 8,
623 sc->sc_audio_rev & 0xff);
625 DPRINTF("%d mixer controls\n",
628 if (sc->sc_play_chan.valid) {
629 device_printf(dev, "Play: %d Hz, %d ch, %s format\n",
630 sc->sc_play_chan.sample_rate,
631 sc->sc_play_chan.p_asf1d->bNrChannels,
632 sc->sc_play_chan.p_fmt->description);
634 device_printf(dev, "No playback!\n");
637 if (sc->sc_rec_chan.valid) {
638 device_printf(dev, "Record: %d Hz, %d ch, %s format\n",
639 sc->sc_rec_chan.sample_rate,
640 sc->sc_rec_chan.p_asf1d->bNrChannels,
641 sc->sc_rec_chan.p_fmt->description);
643 device_printf(dev, "No recording!\n");
646 if (sc->sc_midi_chan.valid) {
648 if (umidi_probe(dev)) {
651 device_printf(dev, "MIDI sequencer\n");
653 device_printf(dev, "No midi sequencer\n");
656 DPRINTF("doing child attach\n");
658 /* attach the children */
660 sc->sc_sndcard_func.func = SCF_PCM;
662 child = device_add_child(dev, "pcm", -1);
665 DPRINTF("out of memory\n");
668 device_set_ivars(child, &sc->sc_sndcard_func);
670 if (bus_generic_attach(dev)) {
671 DPRINTF("child attach failed\n");
674 return (0); /* success */
682 uaudio_pcm_setflags(device_t dev, uint32_t flags)
684 pcm_setflags(dev, pcm_getflags(dev) | flags);
688 uaudio_attach_sub(device_t dev, kobj_class_t mixer_class, kobj_class_t chan_class)
690 struct uaudio_softc *sc = device_get_softc(device_get_parent(dev));
691 char status[SND_STATUSLEN];
693 uaudio_mixer_init(sc);
695 if (sc->sc_uq_audio_swap_lr) {
696 DPRINTF("hardware has swapped left and right\n");
697 /* uaudio_pcm_setflags(dev, SD_F_PSWAPLR); */
699 if (!(sc->sc_mix_info & SOUND_MASK_PCM)) {
701 DPRINTF("emulating master volume\n");
704 * Emulate missing pcm mixer controller
705 * through FEEDER_VOLUME
707 uaudio_pcm_setflags(dev, SD_F_SOFTPCMVOL);
709 if (mixer_init(dev, mixer_class, sc)) {
712 sc->sc_mixer_init = 1;
714 snprintf(status, sizeof(status), "at ? %s", PCM_KLDSTRING(snd_uaudio));
716 if (pcm_register(dev, sc,
717 sc->sc_play_chan.valid ? 1 : 0,
718 sc->sc_rec_chan.valid ? 1 : 0)) {
722 uaudio_pcm_setflags(dev, SD_F_MPSAFE);
723 sc->sc_pcm_registered = 1;
725 if (sc->sc_play_chan.valid) {
726 pcm_addchan(dev, PCMDIR_PLAY, chan_class, sc);
728 if (sc->sc_rec_chan.valid) {
729 pcm_addchan(dev, PCMDIR_REC, chan_class, sc);
731 pcm_setstatus(dev, status);
733 return (0); /* success */
736 uaudio_detach_sub(dev);
741 uaudio_detach_sub(device_t dev)
743 struct uaudio_softc *sc = device_get_softc(device_get_parent(dev));
747 if (sc->sc_pcm_registered) {
748 error = pcm_unregister(dev);
750 if (sc->sc_mixer_init) {
751 error = mixer_uninit(dev);
756 device_printf(dev, "Waiting for sound application to exit!\n");
757 usb_pause_mtx(NULL, 2 * hz);
758 goto repeat; /* try again */
760 return (0); /* success */
764 uaudio_detach(device_t dev)
766 struct uaudio_softc *sc = device_get_softc(dev);
769 * Stop USB transfers early so that any audio applications
770 * will time out and close opened /dev/dspX.Y device(s), if
773 if (sc->sc_play_chan.valid)
774 usbd_transfer_unsetup(sc->sc_play_chan.xfer, UAUDIO_NCHANBUFS);
775 if (sc->sc_rec_chan.valid)
776 usbd_transfer_unsetup(sc->sc_rec_chan.xfer, UAUDIO_NCHANBUFS);
778 if (bus_generic_detach(dev) != 0) {
779 DPRINTF("detach failed!\n");
781 sbuf_delete(&sc->sc_sndstat);
782 sc->sc_sndstat_valid = 0;
789 /*========================================================================*
790 * AS - Audio Stream - routines
791 *========================================================================*/
795 uaudio_chan_dump_ep_desc(const usb_endpoint_descriptor_audio_t *ed)
798 DPRINTF("endpoint=%p bLength=%d bDescriptorType=%d \n"
799 "bEndpointAddress=%d bmAttributes=0x%x \n"
800 "wMaxPacketSize=%d bInterval=%d \n"
801 "bRefresh=%d bSynchAddress=%d\n",
802 ed, ed->bLength, ed->bDescriptorType,
803 ed->bEndpointAddress, ed->bmAttributes,
804 UGETW(ed->wMaxPacketSize), ed->bInterval,
805 UEP_HAS_REFRESH(ed) ? ed->bRefresh : 0,
806 UEP_HAS_SYNCADDR(ed) ? ed->bSynchAddress : 0);
813 * The following is a workaround for broken no-name USB audio devices
814 * sold by dealextreme called "3D sound". The problem is that the
815 * manufacturer computed wMaxPacketSize is too small to hold the
816 * actual data sent. In other words the device sometimes sends more
817 * data than it actually reports it can send in a single isochronous
821 uaudio_record_fix_fs(usb_endpoint_descriptor_audio_t *ep,
822 uint32_t xps, uint32_t add)
826 mps = UGETW(ep->wMaxPacketSize);
829 * If the device indicates it can send more data than what the
830 * sample rate indicates, we apply the workaround.
834 /* allow additional data */
837 /* check against the maximum USB 1.x length */
841 /* check if we should do an update */
843 /* simply update the wMaxPacketSize field */
844 USETW(ep->wMaxPacketSize, xps);
845 DPRINTF("Workaround: Updated wMaxPacketSize "
846 "from %d to %d bytes.\n",
853 uaudio_chan_fill_info_sub(struct uaudio_softc *sc, struct usb_device *udev,
854 uint32_t rate, uint8_t channels, uint8_t bit_resolution)
856 struct usb_descriptor *desc = NULL;
857 const struct usb_audio_streaming_interface_descriptor *asid = NULL;
858 const struct usb_audio_streaming_type1_descriptor *asf1d = NULL;
859 const struct usb_audio_streaming_endpoint_descriptor *sed = NULL;
860 usb_endpoint_descriptor_audio_t *ed1 = NULL;
861 const usb_endpoint_descriptor_audio_t *ed2 = NULL;
862 struct usb_config_descriptor *cd = usbd_get_config_descriptor(udev);
863 struct usb_interface_descriptor *id;
864 const struct uaudio_format *p_fmt;
865 struct uaudio_chan *chan;
866 uint16_t curidx = 0xFFFF;
867 uint16_t lastidx = 0xFFFF;
868 uint16_t alt_index = 0;
872 uint8_t bBitResolution;
874 uint8_t audio_if = 0;
875 uint8_t uma_if_class;
877 while ((desc = usb_desc_foreach(cd, desc))) {
879 if ((desc->bDescriptorType == UDESC_INTERFACE) &&
880 (desc->bLength >= sizeof(*id))) {
884 if (id->bInterfaceNumber != lastidx) {
885 lastidx = id->bInterfaceNumber;
894 ((id->bInterfaceClass == UICLASS_AUDIO) ||
895 ((id->bInterfaceClass == UICLASS_VENDOR) &&
896 (sc->sc_uq_au_vendor_class != 0)));
898 if ((uma_if_class != 0) && (id->bInterfaceSubClass == UISUBCLASS_AUDIOSTREAM)) {
904 if ((uma_if_class != 0) &&
905 (id->bInterfaceSubClass == UISUBCLASS_MIDISTREAM)) {
908 * XXX could allow multiple MIDI interfaces
911 if ((sc->sc_midi_chan.valid == 0) &&
912 usbd_get_iface(udev, curidx)) {
913 sc->sc_midi_chan.iface_index = curidx;
914 sc->sc_midi_chan.iface_alt_index = alt_index;
915 sc->sc_midi_chan.valid = 1;
924 if ((desc->bDescriptorType == UDESC_CS_INTERFACE) &&
925 (desc->bDescriptorSubtype == AS_GENERAL) &&
926 (desc->bLength >= sizeof(*asid))) {
931 if ((desc->bDescriptorType == UDESC_CS_INTERFACE) &&
932 (desc->bDescriptorSubtype == FORMAT_TYPE) &&
933 (desc->bLength >= sizeof(*asf1d))) {
935 asf1d = (void *)desc;
936 if (asf1d->bFormatType != FORMAT_TYPE_I) {
937 DPRINTFN(11, "ignored bFormatType = %d\n",
942 if (asf1d->bLength < (sizeof(*asf1d) +
943 ((asf1d->bSamFreqType == 0) ? 6 :
944 (asf1d->bSamFreqType * 3)))) {
945 DPRINTFN(11, "'asf1d' descriptor is too short\n");
951 if ((desc->bDescriptorType == UDESC_ENDPOINT) &&
952 (desc->bLength >= UEP_MINSIZE)) {
955 if (UE_GET_XFERTYPE(ed1->bmAttributes) != UE_ISOCHRONOUS) {
960 if ((desc->bDescriptorType == UDESC_CS_ENDPOINT) &&
961 (desc->bDescriptorSubtype == AS_GENERAL) &&
962 (desc->bLength >= sizeof(*sed))) {
967 if (audio_if && asid && asf1d && ed1 && sed) {
969 ep_dir = UE_GET_DIR(ed1->bEndpointAddress);
971 /* We ignore sync endpoint information until further. */
973 wFormat = UGETW(asid->wFormatTag);
974 bChannels = UAUDIO_MAX_CHAN(asf1d->bNrChannels);
975 bBitResolution = asf1d->bBitResolution;
977 if (asf1d->bSamFreqType == 0) {
978 DPRINTFN(16, "Sample rate: %d-%dHz\n",
979 UA_SAMP_LO(asf1d), UA_SAMP_HI(asf1d));
981 if ((rate >= UA_SAMP_LO(asf1d)) &&
982 (rate <= UA_SAMP_HI(asf1d))) {
987 for (x = 0; x < asf1d->bSamFreqType; x++) {
988 DPRINTFN(16, "Sample rate = %dHz\n",
989 UA_GETSAMP(asf1d, x));
991 if (rate == UA_GETSAMP(asf1d, x)) {
1002 for (p_fmt = uaudio_formats;
1005 if ((p_fmt->wFormat == wFormat) &&
1006 (p_fmt->bPrecision == bBitResolution)) {
1016 if ((bChannels == channels) &&
1017 (bBitResolution == bit_resolution)) {
1019 chan = (ep_dir == UE_DIR_IN) ?
1023 if ((chan->valid == 0) && usbd_get_iface(udev, curidx)) {
1027 uaudio_chan_dump_ep_desc(ed1);
1028 uaudio_chan_dump_ep_desc(ed2);
1030 if (sed->bmAttributes & UA_SED_FREQ_CONTROL) {
1031 DPRINTFN(2, "FREQ_CONTROL\n");
1033 if (sed->bmAttributes & UA_SED_PITCH_CONTROL) {
1034 DPRINTFN(2, "PITCH_CONTROL\n");
1037 DPRINTF("Sample rate = %dHz, channels = %d, "
1038 "bits = %d, format = %s\n", rate, channels,
1039 bit_resolution, p_fmt->description);
1041 chan->sample_rate = rate;
1042 chan->p_asid = asid;
1043 chan->p_asf1d = asf1d;
1046 chan->p_fmt = p_fmt;
1048 chan->iface_index = curidx;
1049 chan->iface_alt_index = alt_index;
1051 if (ep_dir == UE_DIR_IN)
1058 chan->sample_size = ((
1059 UAUDIO_MAX_CHAN(chan->p_asf1d->bNrChannels) *
1060 chan->p_asf1d->bBitResolution) / 8);
1062 if (ep_dir == UE_DIR_IN &&
1063 usbd_get_speed(udev) == USB_SPEED_FULL) {
1064 uaudio_record_fix_fs(ed1,
1065 chan->sample_size * (rate / 1000),
1066 chan->sample_size * (rate / 4000));
1069 if (sc->sc_sndstat_valid) {
1070 sbuf_printf(&sc->sc_sndstat, "\n\t"
1071 "mode %d.%d:(%s) %dch, %d/%dbit, %s, %dHz",
1073 (ep_dir == UE_DIR_IN) ? "input" : "output",
1074 asf1d->bNrChannels, asf1d->bBitResolution,
1075 asf1d->bSubFrameSize * 8,
1076 p_fmt->description, rate);
1086 /* This structure defines all the supported rates. */
1088 static const uint32_t uaudio_rate_list[] = {
1108 uaudio_chan_fill_info(struct uaudio_softc *sc, struct usb_device *udev)
1110 uint32_t rate = uaudio_default_rate;
1112 uint8_t bits = uaudio_default_bits;
1114 uint8_t channels = uaudio_default_channels;
1118 if ((bits == 0) || (bits > 32)) {
1119 /* set a valid value */
1122 if (channels == 0) {
1123 switch (usbd_get_speed(udev)) {
1125 case USB_SPEED_FULL:
1127 * Due to high bandwidth usage and problems
1128 * with HIGH-speed split transactions we
1129 * disable surround setups on FULL-speed USB
1138 } else if (channels > 16) {
1141 if (sbuf_new(&sc->sc_sndstat, NULL, 4096, SBUF_AUTOEXTEND)) {
1142 sc->sc_sndstat_valid = 1;
1144 /* try to search for a valid config */
1146 for (x = channels; x; x--) {
1147 for (y = bits; y; y -= 8) {
1149 /* try user defined rate, if any */
1151 uaudio_chan_fill_info_sub(sc, udev, rate, x, y);
1153 /* try find a matching rate, if any */
1154 for (z = 0; uaudio_rate_list[z]; z++) {
1155 uaudio_chan_fill_info_sub(sc, udev, uaudio_rate_list[z], x, y);
1157 if (sc->sc_rec_chan.valid &&
1158 sc->sc_play_chan.valid) {
1166 if (sc->sc_sndstat_valid) {
1167 sbuf_finish(&sc->sc_sndstat);
1172 uaudio_chan_play_callback(struct usb_xfer *xfer, usb_error_t error)
1174 struct uaudio_chan *ch = usbd_xfer_softc(xfer);
1175 struct usb_page_cache *pc;
1177 uint32_t blockcount;
1183 usbd_xfer_status(xfer, &actlen, &sumlen, NULL, NULL);
1185 if (ch->end == ch->start) {
1186 DPRINTF("no buffer!\n");
1190 switch (USB_GET_STATE(xfer)) {
1191 case USB_ST_TRANSFERRED:
1193 if (actlen < sumlen) {
1194 DPRINTF("short transfer, "
1195 "%d of %d bytes\n", actlen, sumlen);
1197 chn_intr(ch->pcm_ch);
1200 if (ch->bytes_per_frame[1] > usbd_xfer_max_framelen(xfer)) {
1201 DPRINTF("bytes per transfer, %d, "
1202 "exceeds maximum, %d!\n",
1203 ch->bytes_per_frame[1],
1204 usbd_xfer_max_framelen(xfer));
1208 blockcount = ch->intr_frames;
1210 /* setup number of frames */
1211 usbd_xfer_set_frames(xfer, blockcount);
1213 /* reset total length */
1216 /* setup frame lengths */
1217 for (n = 0; n != blockcount; n++) {
1218 ch->sample_curr += ch->sample_rem;
1219 if (ch->sample_curr >= ch->frames_per_second) {
1220 ch->sample_curr -= ch->frames_per_second;
1221 usbd_xfer_set_frame_len(xfer, n, ch->bytes_per_frame[1]);
1222 total += ch->bytes_per_frame[1];
1224 usbd_xfer_set_frame_len(xfer, n, ch->bytes_per_frame[0]);
1225 total += ch->bytes_per_frame[0];
1229 DPRINTFN(6, "transfer %d bytes\n", total);
1233 pc = usbd_xfer_get_frame(xfer, 0);
1236 n = (ch->end - ch->cur);
1240 usbd_copy_in(pc, offset, ch->cur, n);
1246 if (ch->cur >= ch->end) {
1247 ch->cur = ch->start;
1251 usbd_transfer_submit(xfer);
1254 default: /* Error */
1255 if (error == USB_ERR_CANCELLED) {
1258 goto tr_transferred;
1263 uaudio_chan_record_callback(struct usb_xfer *xfer, usb_error_t error)
1265 struct uaudio_chan *ch = usbd_xfer_softc(xfer);
1266 struct usb_page_cache *pc;
1269 uint32_t blockcount;
1277 usbd_xfer_status(xfer, &actlen, NULL, NULL, &nframes);
1278 mfl = usbd_xfer_max_framelen(xfer);
1280 if (ch->end == ch->start) {
1281 DPRINTF("no buffer!\n");
1285 switch (USB_GET_STATE(xfer)) {
1286 case USB_ST_TRANSFERRED:
1288 DPRINTFN(6, "transferred %d bytes\n", actlen);
1291 pc = usbd_xfer_get_frame(xfer, 0);
1293 for (n = 0; n != nframes; n++) {
1296 len = usbd_xfer_frame_len(xfer, n);
1300 m = (ch->end - ch->cur);
1305 usbd_copy_out(pc, offset1, ch->cur, m);
1311 if (ch->cur >= ch->end) {
1312 ch->cur = ch->start;
1319 chn_intr(ch->pcm_ch);
1323 blockcount = ch->intr_frames;
1325 usbd_xfer_set_frames(xfer, blockcount);
1326 for (n = 0; n < blockcount; n++) {
1327 usbd_xfer_set_frame_len(xfer, n, mfl);
1330 usbd_transfer_submit(xfer);
1333 default: /* Error */
1334 if (error == USB_ERR_CANCELLED) {
1342 uaudio_chan_init(struct uaudio_softc *sc, struct snd_dbuf *b,
1343 struct pcm_channel *c, int dir)
1345 struct uaudio_chan *ch = ((dir == PCMDIR_PLAY) ?
1346 &sc->sc_play_chan : &sc->sc_rec_chan);
1353 uint8_t iface_index;
1358 fps = usbd_get_isoc_fps(sc->sc_udev);
1361 /* FULL speed USB */
1364 /* HIGH speed USB */
1365 frames = UAUDIO_NFRAMES;
1368 /* setup play/record format */
1370 ch->pcm_cap.fmtlist = ch->pcm_format;
1372 ch->pcm_format[0] = 0;
1373 ch->pcm_format[1] = 0;
1375 ch->pcm_cap.minspeed = ch->sample_rate;
1376 ch->pcm_cap.maxspeed = ch->sample_rate;
1378 /* setup mutex and PCM channel */
1381 ch->pcm_mtx = c->lock;
1383 format = ch->p_fmt->freebsd_fmt;
1385 switch (ch->p_asf1d->bNrChannels) {
1388 format = SND_FORMAT(format, 2, 0);
1392 format = SND_FORMAT(format, 1, 0);
1395 /* surround and more */
1396 format = feeder_matrix_default_format(
1397 SND_FORMAT(format, ch->p_asf1d->bNrChannels, 0));
1401 ch->pcm_cap.fmtlist[0] = format;
1402 ch->pcm_cap.fmtlist[1] = 0;
1404 /* check if format is not supported */
1407 DPRINTF("The selected audio format is not supported\n");
1411 /* set alternate interface corresponding to the mode */
1413 endpoint = ch->p_ed1->bEndpointAddress;
1414 iface_index = ch->iface_index;
1415 alt_index = ch->iface_alt_index;
1417 DPRINTF("endpoint=0x%02x, speed=%d, iface=%d alt=%d\n",
1418 endpoint, ch->sample_rate, iface_index, alt_index);
1420 err = usbd_set_alt_interface_index(sc->sc_udev, iface_index, alt_index);
1422 DPRINTF("setting of alternate index failed: %s!\n",
1426 usbd_set_parent_iface(sc->sc_udev, iface_index,
1427 sc->sc_mixer_iface_index);
1430 * Only set the sample rate if the channel reports that it
1431 * supports the frequency control.
1433 if (ch->p_sed->bmAttributes & UA_SED_FREQ_CONTROL) {
1434 if (uaudio_set_speed(sc->sc_udev, endpoint, ch->sample_rate)) {
1436 * If the endpoint is adaptive setting the speed may
1439 DPRINTF("setting of sample rate failed! (continuing anyway)\n");
1442 if (usbd_transfer_setup(sc->sc_udev, &iface_index, ch->xfer,
1443 ch->usb_cfg, UAUDIO_NCHANBUFS, ch, ch->pcm_mtx)) {
1444 DPRINTF("could not allocate USB transfers!\n");
1448 fps_shift = usbd_xfer_get_fps_shift(ch->xfer[0]);
1450 /* down shift number of frames per second, if any */
1452 frames >>= fps_shift;
1454 /* bytes per frame should not be zero */
1455 ch->bytes_per_frame[0] = ((ch->sample_rate / fps) * ch->sample_size);
1456 ch->bytes_per_frame[1] = (((ch->sample_rate + fps - 1) / fps) * ch->sample_size);
1458 /* setup data rate dithering, if any */
1459 ch->frames_per_second = fps;
1460 ch->sample_rem = ch->sample_rate % fps;
1461 ch->sample_curr = 0;
1462 ch->frames_per_second = fps;
1464 /* compute required buffer size */
1465 buf_size = (ch->bytes_per_frame[1] * frames);
1467 ch->intr_size = buf_size;
1468 ch->intr_frames = frames;
1470 DPRINTF("fps=%d sample_rem=%d\n", fps, ch->sample_rem);
1472 if (ch->intr_frames == 0) {
1473 DPRINTF("frame shift is too high!\n");
1477 /* setup double buffering */
1481 ch->buf = malloc(buf_size, M_DEVBUF, M_WAITOK | M_ZERO);
1482 if (ch->buf == NULL)
1484 if (sndbuf_setup(b, ch->buf, buf_size) != 0)
1486 if (sndbuf_resize(b, blocks, ch->intr_size))
1489 ch->start = ch->buf;
1490 ch->end = ch->buf + buf_size;
1494 if (ch->pcm_mtx == NULL) {
1495 DPRINTF("ERROR: PCM channels does not have a mutex!\n");
1502 uaudio_chan_free(ch);
1507 uaudio_chan_free(struct uaudio_chan *ch)
1509 if (ch->buf != NULL) {
1510 free(ch->buf, M_DEVBUF);
1513 usbd_transfer_unsetup(ch->xfer, UAUDIO_NCHANBUFS);
1521 uaudio_chan_set_param_blocksize(struct uaudio_chan *ch, uint32_t blocksize)
1523 return (ch->intr_size);
1527 uaudio_chan_set_param_fragments(struct uaudio_chan *ch, uint32_t blocksize,
1528 uint32_t blockcount)
1534 uaudio_chan_set_param_speed(struct uaudio_chan *ch, uint32_t speed)
1536 if (speed != ch->sample_rate) {
1537 DPRINTF("rate conversion required\n");
1539 return (ch->sample_rate);
1543 uaudio_chan_getptr(struct uaudio_chan *ch)
1545 return (ch->cur - ch->start);
1548 struct pcmchan_caps *
1549 uaudio_chan_getcaps(struct uaudio_chan *ch)
1551 return (&ch->pcm_cap);
1554 static struct pcmchan_matrix uaudio_chan_matrix_swap_2_0 = {
1555 .id = SND_CHN_MATRIX_DRV,
1561 .type = SND_CHN_T_FR,
1563 SND_CHN_T_MASK_FR | SND_CHN_T_MASK_FC |
1564 SND_CHN_T_MASK_LF | SND_CHN_T_MASK_BR |
1565 SND_CHN_T_MASK_BC | SND_CHN_T_MASK_SR
1569 .type = SND_CHN_T_FL,
1571 SND_CHN_T_MASK_FL | SND_CHN_T_MASK_FC |
1572 SND_CHN_T_MASK_LF | SND_CHN_T_MASK_BL |
1573 SND_CHN_T_MASK_BC | SND_CHN_T_MASK_SL
1576 .type = SND_CHN_T_MAX,
1580 .mask = SND_CHN_T_MASK_FR | SND_CHN_T_MASK_FL,
1581 .offset = { 1, 0, -1, -1, -1, -1, -1, -1, -1,
1582 -1, -1, -1, -1, -1, -1, -1, -1, -1 }
1585 struct pcmchan_matrix *
1586 uaudio_chan_getmatrix(struct uaudio_chan *ch, uint32_t format)
1588 struct uaudio_softc *sc;
1592 if (sc != NULL && sc->sc_uq_audio_swap_lr != 0 &&
1593 AFMT_CHANNEL(format) == 2)
1594 return (&uaudio_chan_matrix_swap_2_0);
1596 return (feeder_matrix_format_map(format));
1600 uaudio_chan_set_param_format(struct uaudio_chan *ch, uint32_t format)
1602 ch->format = format;
1607 uaudio_chan_start(struct uaudio_chan *ch)
1609 ch->cur = ch->start;
1611 #if (UAUDIO_NCHANBUFS != 2)
1612 #error "please update code"
1615 usbd_transfer_start(ch->xfer[0]);
1618 usbd_transfer_start(ch->xfer[1]);
1624 uaudio_chan_stop(struct uaudio_chan *ch)
1626 #if (UAUDIO_NCHANBUFS != 2)
1627 #error "please update code"
1629 usbd_transfer_stop(ch->xfer[0]);
1630 usbd_transfer_stop(ch->xfer[1]);
1634 /*========================================================================*
1635 * AC - Audio Controller - routines
1636 *========================================================================*/
1639 uaudio_mixer_add_ctl_sub(struct uaudio_softc *sc, struct uaudio_mixer_node *mc)
1641 struct uaudio_mixer_node *p_mc_new =
1642 malloc(sizeof(*p_mc_new), M_USBDEV, M_WAITOK);
1644 if (p_mc_new != NULL) {
1645 memcpy(p_mc_new, mc, sizeof(*p_mc_new));
1646 p_mc_new->next = sc->sc_mixer_root;
1647 sc->sc_mixer_root = p_mc_new;
1648 sc->sc_mixer_count++;
1650 DPRINTF("out of memory\n");
1655 uaudio_mixer_add_ctl(struct uaudio_softc *sc, struct uaudio_mixer_node *mc)
1659 if (mc->class < UAC_NCLASSES) {
1660 DPRINTF("adding %s.%d\n",
1661 uac_names[mc->class], mc->ctl);
1663 DPRINTF("adding %d\n", mc->ctl);
1666 if (mc->type == MIX_ON_OFF) {
1669 } else if (mc->type == MIX_SELECTOR) {
1672 /* determine min and max values */
1674 mc->minval = uaudio_mixer_get(sc->sc_udev, GET_MIN, mc);
1676 mc->minval = uaudio_mixer_signext(mc->type, mc->minval);
1678 mc->maxval = uaudio_mixer_get(sc->sc_udev, GET_MAX, mc);
1680 mc->maxval = uaudio_mixer_signext(mc->type, mc->maxval);
1682 /* check if max and min was swapped */
1684 if (mc->maxval < mc->minval) {
1686 mc->maxval = mc->minval;
1690 /* compute value range */
1691 mc->mul = mc->maxval - mc->minval;
1695 /* compute value alignment */
1696 res = uaudio_mixer_get(sc->sc_udev, GET_RES, mc);
1698 DPRINTF("Resolution = %d\n", (int)res);
1701 uaudio_mixer_add_ctl_sub(sc, mc);
1704 if (uaudio_debug > 2) {
1707 for (i = 0; i < mc->nchan; i++) {
1708 DPRINTF("[mix] wValue=%04x\n", mc->wValue[0]);
1710 DPRINTF("[mix] wIndex=%04x type=%d ctl='%d' "
1712 mc->wIndex, mc->type, mc->ctl,
1713 mc->minval, mc->maxval);
1719 uaudio_mixer_add_input(struct uaudio_softc *sc,
1720 const struct uaudio_terminal_node *iot, int id)
1723 const struct usb_audio_input_terminal *d = iot[id].u.it;
1725 DPRINTFN(3, "bTerminalId=%d wTerminalType=0x%04x "
1726 "bAssocTerminal=%d bNrChannels=%d wChannelConfig=%d "
1727 "iChannelNames=%d\n",
1728 d->bTerminalId, UGETW(d->wTerminalType), d->bAssocTerminal,
1729 d->bNrChannels, UGETW(d->wChannelConfig),
1735 uaudio_mixer_add_output(struct uaudio_softc *sc,
1736 const struct uaudio_terminal_node *iot, int id)
1739 const struct usb_audio_output_terminal *d = iot[id].u.ot;
1741 DPRINTFN(3, "bTerminalId=%d wTerminalType=0x%04x "
1742 "bAssocTerminal=%d bSourceId=%d iTerminal=%d\n",
1743 d->bTerminalId, UGETW(d->wTerminalType), d->bAssocTerminal,
1744 d->bSourceId, d->iTerminal);
1749 uaudio_mixer_add_mixer(struct uaudio_softc *sc,
1750 const struct uaudio_terminal_node *iot, int id)
1752 struct uaudio_mixer_node mix;
1754 const struct usb_audio_mixer_unit_0 *d0 = iot[id].u.mu;
1755 const struct usb_audio_mixer_unit_1 *d1;
1757 uint32_t bno; /* bit number */
1758 uint32_t p; /* bit number accumulator */
1759 uint32_t mo; /* matching outputs */
1760 uint32_t mc; /* matching channels */
1761 uint32_t ichs; /* input channels */
1762 uint32_t ochs; /* output channels */
1764 uint32_t chs; /* channels */
1768 DPRINTFN(3, "bUnitId=%d bNrInPins=%d\n",
1769 d0->bUnitId, d0->bNrInPins);
1771 /* compute the number of input channels */
1774 for (i = 0; i < d0->bNrInPins; i++) {
1775 ichs += (uaudio_mixer_get_cluster(d0->baSourceId[i], iot)
1779 d1 = (const void *)(d0->baSourceId + d0->bNrInPins);
1781 /* and the number of output channels */
1783 ochs = d1->bNrChannels;
1785 DPRINTFN(3, "ichs=%d ochs=%d\n", ichs, ochs);
1787 memset(&mix, 0, sizeof(mix));
1789 mix.wIndex = MAKE_WORD(d0->bUnitId, sc->sc_mixer_iface_no);
1790 uaudio_mixer_determine_class(&iot[id], &mix);
1791 mix.type = MIX_SIGNED_16;
1793 if (uaudio_mixer_verify_desc(d0, ((ichs * ochs) + 7) / 8) == NULL) {
1796 for (p = i = 0; i < d0->bNrInPins; i++) {
1797 chs = uaudio_mixer_get_cluster(d0->baSourceId[i], iot).bNrChannels;
1799 for (c = 0; c < chs; c++) {
1801 for (o = 0; o < ochs; o++) {
1802 bno = ((p + c) * ochs) + o;
1803 if (BIT_TEST(d1->bmControls, bno)) {
1811 if ((mc == chs) && (chs <= MIX_MAX_CHAN)) {
1813 /* repeat bit-scan */
1816 for (c = 0; c < chs; c++) {
1817 for (o = 0; o < ochs; o++) {
1818 bno = ((p + c) * ochs) + o;
1819 if (BIT_TEST(d1->bmControls, bno)) {
1820 mix.wValue[mc++] = MAKE_WORD(p + c + 1, o + 1);
1825 uaudio_mixer_add_ctl(sc, &mix);
1834 uaudio_mixer_add_selector(struct uaudio_softc *sc,
1835 const struct uaudio_terminal_node *iot, int id)
1837 const struct usb_audio_selector_unit *d = iot[id].u.su;
1838 struct uaudio_mixer_node mix;
1841 DPRINTFN(3, "bUnitId=%d bNrInPins=%d\n",
1842 d->bUnitId, d->bNrInPins);
1844 if (d->bNrInPins == 0) {
1847 memset(&mix, 0, sizeof(mix));
1849 mix.wIndex = MAKE_WORD(d->bUnitId, sc->sc_mixer_iface_no);
1850 mix.wValue[0] = MAKE_WORD(0, 0);
1851 uaudio_mixer_determine_class(&iot[id], &mix);
1853 mix.type = MIX_SELECTOR;
1855 mix.ctl = SOUND_MIXER_NRDEVICES;
1857 mix.maxval = d->bNrInPins;
1859 if (mix.maxval > MAX_SELECTOR_INPUT_PIN) {
1860 mix.maxval = MAX_SELECTOR_INPUT_PIN;
1862 mix.mul = (mix.maxval - mix.minval);
1863 for (i = 0; i < MAX_SELECTOR_INPUT_PIN; i++) {
1864 mix.slctrtype[i] = SOUND_MIXER_NRDEVICES;
1867 for (i = 0; i < mix.maxval; i++) {
1868 mix.slctrtype[i] = uaudio_mixer_feature_name
1869 (&iot[d->baSourceId[i]], &mix);
1872 mix.class = 0; /* not used */
1874 uaudio_mixer_add_ctl(sc, &mix);
1878 uaudio_mixer_feature_get_bmaControls(const struct usb_audio_feature_unit *d,
1882 uint32_t offset = (index * d->bControlSize);
1884 if (d->bControlSize > 0) {
1885 temp |= d->bmaControls[offset];
1886 if (d->bControlSize > 1) {
1887 temp |= d->bmaControls[offset + 1] << 8;
1888 if (d->bControlSize > 2) {
1889 temp |= d->bmaControls[offset + 2] << 16;
1890 if (d->bControlSize > 3) {
1891 temp |= d->bmaControls[offset + 3] << 24;
1900 uaudio_mixer_add_feature(struct uaudio_softc *sc,
1901 const struct uaudio_terminal_node *iot, int id)
1903 const struct usb_audio_feature_unit *d = iot[id].u.fu;
1904 struct uaudio_mixer_node mix;
1908 uint16_t mixernumber;
1914 if (d->bControlSize == 0) {
1917 memset(&mix, 0, sizeof(mix));
1919 nchan = (d->bLength - 7) / d->bControlSize;
1920 mmask = uaudio_mixer_feature_get_bmaControls(d, 0);
1926 /* figure out what we can control */
1928 for (chan = 1; chan < nchan; chan++) {
1929 DPRINTFN(10, "chan=%d mask=%x\n",
1930 chan, uaudio_mixer_feature_get_bmaControls(d, chan));
1932 cmask |= uaudio_mixer_feature_get_bmaControls(d, chan);
1935 if (nchan > MIX_MAX_CHAN) {
1936 nchan = MIX_MAX_CHAN;
1938 mix.wIndex = MAKE_WORD(d->bUnitId, sc->sc_mixer_iface_no);
1940 for (ctl = 1; ctl <= LOUDNESS_CONTROL; ctl++) {
1942 fumask = FU_MASK(ctl);
1944 DPRINTFN(5, "ctl=%d fumask=0x%04x\n",
1947 if (mmask & fumask) {
1949 mix.wValue[0] = MAKE_WORD(ctl, 0);
1950 } else if (cmask & fumask) {
1951 mix.nchan = nchan - 1;
1952 for (i = 1; i < nchan; i++) {
1953 if (uaudio_mixer_feature_get_bmaControls(d, i) & fumask)
1954 mix.wValue[i - 1] = MAKE_WORD(ctl, i);
1956 mix.wValue[i - 1] = -1;
1962 mixernumber = uaudio_mixer_feature_name(&iot[id], &mix);
1966 mix.type = MIX_ON_OFF;
1967 mix.ctl = SOUND_MIXER_NRDEVICES;
1970 case VOLUME_CONTROL:
1971 mix.type = MIX_SIGNED_16;
1972 mix.ctl = mixernumber;
1976 mix.type = MIX_SIGNED_8;
1977 mix.ctl = SOUND_MIXER_BASS;
1981 mix.type = MIX_SIGNED_8;
1982 mix.ctl = SOUND_MIXER_NRDEVICES; /* XXXXX */
1985 case TREBLE_CONTROL:
1986 mix.type = MIX_SIGNED_8;
1987 mix.ctl = SOUND_MIXER_TREBLE;
1990 case GRAPHIC_EQUALIZER_CONTROL:
1991 continue; /* XXX don't add anything */
1995 mix.type = MIX_ON_OFF;
1996 mix.ctl = SOUND_MIXER_NRDEVICES; /* XXXXX */
2000 mix.type = MIX_UNSIGNED_16;
2001 mix.ctl = SOUND_MIXER_NRDEVICES; /* XXXXX */
2004 case BASS_BOOST_CONTROL:
2005 mix.type = MIX_ON_OFF;
2006 mix.ctl = SOUND_MIXER_NRDEVICES; /* XXXXX */
2009 case LOUDNESS_CONTROL:
2010 mix.type = MIX_ON_OFF;
2011 mix.ctl = SOUND_MIXER_LOUD; /* Is this correct ? */
2015 mix.type = MIX_UNKNOWN;
2019 if (mix.type != MIX_UNKNOWN) {
2020 uaudio_mixer_add_ctl(sc, &mix);
2026 uaudio_mixer_add_processing_updown(struct uaudio_softc *sc,
2027 const struct uaudio_terminal_node *iot, int id)
2029 const struct usb_audio_processing_unit_0 *d0 = iot[id].u.pu;
2030 const struct usb_audio_processing_unit_1 *d1 =
2031 (const void *)(d0->baSourceId + d0->bNrInPins);
2032 const struct usb_audio_processing_unit_updown *ud =
2033 (const void *)(d1->bmControls + d1->bControlSize);
2034 struct uaudio_mixer_node mix;
2037 if (uaudio_mixer_verify_desc(d0, sizeof(*ud)) == NULL) {
2040 if (uaudio_mixer_verify_desc(d0, sizeof(*ud) + (2 * ud->bNrModes))
2044 DPRINTFN(3, "bUnitId=%d bNrModes=%d\n",
2045 d0->bUnitId, ud->bNrModes);
2047 if (!(d1->bmControls[0] & UA_PROC_MASK(UD_MODE_SELECT_CONTROL))) {
2048 DPRINTF("no mode select\n");
2051 memset(&mix, 0, sizeof(mix));
2053 mix.wIndex = MAKE_WORD(d0->bUnitId, sc->sc_mixer_iface_no);
2055 mix.wValue[0] = MAKE_WORD(UD_MODE_SELECT_CONTROL, 0);
2056 uaudio_mixer_determine_class(&iot[id], &mix);
2057 mix.type = MIX_ON_OFF; /* XXX */
2059 for (i = 0; i < ud->bNrModes; i++) {
2060 DPRINTFN(3, "i=%d bm=0x%x\n", i, UGETW(ud->waModes[i]));
2064 uaudio_mixer_add_ctl(sc, &mix);
2068 uaudio_mixer_add_processing(struct uaudio_softc *sc,
2069 const struct uaudio_terminal_node *iot, int id)
2071 const struct usb_audio_processing_unit_0 *d0 = iot[id].u.pu;
2072 const struct usb_audio_processing_unit_1 *d1 =
2073 (const void *)(d0->baSourceId + d0->bNrInPins);
2074 struct uaudio_mixer_node mix;
2077 memset(&mix, 0, sizeof(mix));
2079 ptype = UGETW(d0->wProcessType);
2081 DPRINTFN(3, "wProcessType=%d bUnitId=%d "
2082 "bNrInPins=%d\n", ptype, d0->bUnitId, d0->bNrInPins);
2084 if (d1->bControlSize == 0) {
2087 if (d1->bmControls[0] & UA_PROC_ENABLE_MASK) {
2088 mix.wIndex = MAKE_WORD(d0->bUnitId, sc->sc_mixer_iface_no);
2090 mix.wValue[0] = MAKE_WORD(XX_ENABLE_CONTROL, 0);
2091 uaudio_mixer_determine_class(&iot[id], &mix);
2092 mix.type = MIX_ON_OFF;
2093 uaudio_mixer_add_ctl(sc, &mix);
2096 case UPDOWNMIX_PROCESS:
2097 uaudio_mixer_add_processing_updown(sc, iot, id);
2100 case DOLBY_PROLOGIC_PROCESS:
2101 case P3D_STEREO_EXTENDER_PROCESS:
2102 case REVERBATION_PROCESS:
2103 case CHORUS_PROCESS:
2104 case DYN_RANGE_COMP_PROCESS:
2106 DPRINTF("unit %d, type=%d is not implemented\n",
2107 d0->bUnitId, ptype);
2113 uaudio_mixer_add_extension(struct uaudio_softc *sc,
2114 const struct uaudio_terminal_node *iot, int id)
2116 const struct usb_audio_extension_unit_0 *d0 = iot[id].u.eu;
2117 const struct usb_audio_extension_unit_1 *d1 =
2118 (const void *)(d0->baSourceId + d0->bNrInPins);
2119 struct uaudio_mixer_node mix;
2121 DPRINTFN(3, "bUnitId=%d bNrInPins=%d\n",
2122 d0->bUnitId, d0->bNrInPins);
2124 if (sc->sc_uq_au_no_xu) {
2127 if (d1->bControlSize == 0) {
2130 if (d1->bmControls[0] & UA_EXT_ENABLE_MASK) {
2132 memset(&mix, 0, sizeof(mix));
2134 mix.wIndex = MAKE_WORD(d0->bUnitId, sc->sc_mixer_iface_no);
2136 mix.wValue[0] = MAKE_WORD(UA_EXT_ENABLE, 0);
2137 uaudio_mixer_determine_class(&iot[id], &mix);
2138 mix.type = MIX_ON_OFF;
2140 uaudio_mixer_add_ctl(sc, &mix);
2145 uaudio_mixer_verify_desc(const void *arg, uint32_t len)
2147 const struct usb_audio_mixer_unit_1 *d1;
2148 const struct usb_audio_extension_unit_1 *e1;
2149 const struct usb_audio_processing_unit_1 *u1;
2152 const struct usb_descriptor *desc;
2153 const struct usb_audio_input_terminal *it;
2154 const struct usb_audio_output_terminal *ot;
2155 const struct usb_audio_mixer_unit_0 *mu;
2156 const struct usb_audio_selector_unit *su;
2157 const struct usb_audio_feature_unit *fu;
2158 const struct usb_audio_processing_unit_0 *pu;
2159 const struct usb_audio_extension_unit_0 *eu;
2164 if (u.desc == NULL) {
2167 if (u.desc->bDescriptorType != UDESC_CS_INTERFACE) {
2170 switch (u.desc->bDescriptorSubtype) {
2171 case UDESCSUB_AC_INPUT:
2172 len += sizeof(*u.it);
2175 case UDESCSUB_AC_OUTPUT:
2176 len += sizeof(*u.ot);
2179 case UDESCSUB_AC_MIXER:
2180 len += sizeof(*u.mu);
2182 if (u.desc->bLength < len) {
2185 len += u.mu->bNrInPins;
2187 if (u.desc->bLength < len) {
2190 d1 = (const void *)(u.mu->baSourceId + u.mu->bNrInPins);
2195 case UDESCSUB_AC_SELECTOR:
2196 len += sizeof(*u.su);
2198 if (u.desc->bLength < len) {
2201 len += u.su->bNrInPins;
2204 case UDESCSUB_AC_FEATURE:
2205 len += (sizeof(*u.fu) + 1);
2208 case UDESCSUB_AC_PROCESSING:
2209 len += sizeof(*u.pu);
2211 if (u.desc->bLength < len) {
2214 len += u.pu->bNrInPins;
2216 if (u.desc->bLength < len) {
2219 u1 = (const void *)(u.pu->baSourceId + u.pu->bNrInPins);
2223 if (u.desc->bLength < len) {
2226 len += u1->bControlSize;
2230 case UDESCSUB_AC_EXTENSION:
2231 len += sizeof(*u.eu);
2233 if (u.desc->bLength < len) {
2236 len += u.eu->bNrInPins;
2238 if (u.desc->bLength < len) {
2241 e1 = (const void *)(u.eu->baSourceId + u.eu->bNrInPins);
2245 if (u.desc->bLength < len) {
2248 len += e1->bControlSize;
2255 if (u.desc->bLength < len) {
2262 DPRINTF("invalid descriptor, type=%d, "
2263 "sub_type=%d, len=%d of %d bytes\n",
2264 u.desc->bDescriptorType,
2265 u.desc->bDescriptorSubtype,
2266 u.desc->bLength, len);
2273 uaudio_mixer_dump_cluster(uint8_t id, const struct uaudio_terminal_node *iot)
2275 static const char *channel_names[16] = {
2276 "LEFT", "RIGHT", "CENTER", "LFE",
2277 "LEFT_SURROUND", "RIGHT_SURROUND", "LEFT_CENTER", "RIGHT_CENTER",
2278 "SURROUND", "LEFT_SIDE", "RIGHT_SIDE", "TOP",
2279 "RESERVED12", "RESERVED13", "RESERVED14", "RESERVED15",
2283 const struct usb_audio_cluster cl = uaudio_mixer_get_cluster(id, iot);
2285 cc = UGETW(cl.wChannelConfig);
2287 DPRINTF("cluster: bNrChannels=%u iChannelNames=%u wChannelConfig="
2288 "0x%04x:\n", cl.iChannelNames, cl.bNrChannels, cc);
2290 for (i = 0; cc; i++) {
2292 DPRINTF(" - %s\n", channel_names[i]);
2300 static struct usb_audio_cluster
2301 uaudio_mixer_get_cluster(uint8_t id, const struct uaudio_terminal_node *iot)
2303 struct usb_audio_cluster r;
2304 const struct usb_descriptor *dp;
2307 for (i = 0; i < UAUDIO_RECURSE_LIMIT; i++) { /* avoid infinite loops */
2308 dp = iot[id].u.desc;
2312 switch (dp->bDescriptorSubtype) {
2313 case UDESCSUB_AC_INPUT:
2314 r.bNrChannels = iot[id].u.it->bNrChannels;
2315 r.wChannelConfig[0] = iot[id].u.it->wChannelConfig[0];
2316 r.wChannelConfig[1] = iot[id].u.it->wChannelConfig[1];
2317 r.iChannelNames = iot[id].u.it->iChannelNames;
2320 case UDESCSUB_AC_OUTPUT:
2321 id = iot[id].u.ot->bSourceId;
2324 case UDESCSUB_AC_MIXER:
2325 r = *(const struct usb_audio_cluster *)
2326 &iot[id].u.mu->baSourceId[iot[id].u.mu->
2330 case UDESCSUB_AC_SELECTOR:
2331 if (iot[id].u.su->bNrInPins > 0) {
2332 /* XXX This is not really right */
2333 id = iot[id].u.su->baSourceId[0];
2337 case UDESCSUB_AC_FEATURE:
2338 id = iot[id].u.fu->bSourceId;
2341 case UDESCSUB_AC_PROCESSING:
2342 r = *((const struct usb_audio_cluster *)
2343 &iot[id].u.pu->baSourceId[iot[id].u.pu->
2347 case UDESCSUB_AC_EXTENSION:
2348 r = *((const struct usb_audio_cluster *)
2349 &iot[id].u.eu->baSourceId[iot[id].u.eu->
2358 DPRINTF("bad data\n");
2359 memset(&r, 0, sizeof(r));
2366 struct uaudio_tt_to_string {
2367 uint16_t terminal_type;
2371 static const struct uaudio_tt_to_string uaudio_tt_to_string[] = {
2373 /* USB terminal types */
2374 {UAT_UNDEFINED, "UAT_UNDEFINED"},
2375 {UAT_STREAM, "UAT_STREAM"},
2376 {UAT_VENDOR, "UAT_VENDOR"},
2378 /* input terminal types */
2379 {UATI_UNDEFINED, "UATI_UNDEFINED"},
2380 {UATI_MICROPHONE, "UATI_MICROPHONE"},
2381 {UATI_DESKMICROPHONE, "UATI_DESKMICROPHONE"},
2382 {UATI_PERSONALMICROPHONE, "UATI_PERSONALMICROPHONE"},
2383 {UATI_OMNIMICROPHONE, "UATI_OMNIMICROPHONE"},
2384 {UATI_MICROPHONEARRAY, "UATI_MICROPHONEARRAY"},
2385 {UATI_PROCMICROPHONEARR, "UATI_PROCMICROPHONEARR"},
2387 /* output terminal types */
2388 {UATO_UNDEFINED, "UATO_UNDEFINED"},
2389 {UATO_SPEAKER, "UATO_SPEAKER"},
2390 {UATO_HEADPHONES, "UATO_HEADPHONES"},
2391 {UATO_DISPLAYAUDIO, "UATO_DISPLAYAUDIO"},
2392 {UATO_DESKTOPSPEAKER, "UATO_DESKTOPSPEAKER"},
2393 {UATO_ROOMSPEAKER, "UATO_ROOMSPEAKER"},
2394 {UATO_COMMSPEAKER, "UATO_COMMSPEAKER"},
2395 {UATO_SUBWOOFER, "UATO_SUBWOOFER"},
2397 /* bidir terminal types */
2398 {UATB_UNDEFINED, "UATB_UNDEFINED"},
2399 {UATB_HANDSET, "UATB_HANDSET"},
2400 {UATB_HEADSET, "UATB_HEADSET"},
2401 {UATB_SPEAKERPHONE, "UATB_SPEAKERPHONE"},
2402 {UATB_SPEAKERPHONEESUP, "UATB_SPEAKERPHONEESUP"},
2403 {UATB_SPEAKERPHONEECANC, "UATB_SPEAKERPHONEECANC"},
2405 /* telephony terminal types */
2406 {UATT_UNDEFINED, "UATT_UNDEFINED"},
2407 {UATT_PHONELINE, "UATT_PHONELINE"},
2408 {UATT_TELEPHONE, "UATT_TELEPHONE"},
2409 {UATT_DOWNLINEPHONE, "UATT_DOWNLINEPHONE"},
2411 /* external terminal types */
2412 {UATE_UNDEFINED, "UATE_UNDEFINED"},
2413 {UATE_ANALOGCONN, "UATE_ANALOGCONN"},
2414 {UATE_LINECONN, "UATE_LINECONN"},
2415 {UATE_LEGACYCONN, "UATE_LEGACYCONN"},
2416 {UATE_DIGITALAUIFC, "UATE_DIGITALAUIFC"},
2417 {UATE_SPDIF, "UATE_SPDIF"},
2418 {UATE_1394DA, "UATE_1394DA"},
2419 {UATE_1394DV, "UATE_1394DV"},
2421 /* embedded function terminal types */
2422 {UATF_UNDEFINED, "UATF_UNDEFINED"},
2423 {UATF_CALIBNOISE, "UATF_CALIBNOISE"},
2424 {UATF_EQUNOISE, "UATF_EQUNOISE"},
2425 {UATF_CDPLAYER, "UATF_CDPLAYER"},
2426 {UATF_DAT, "UATF_DAT"},
2427 {UATF_DCC, "UATF_DCC"},
2428 {UATF_MINIDISK, "UATF_MINIDISK"},
2429 {UATF_ANALOGTAPE, "UATF_ANALOGTAPE"},
2430 {UATF_PHONOGRAPH, "UATF_PHONOGRAPH"},
2431 {UATF_VCRAUDIO, "UATF_VCRAUDIO"},
2432 {UATF_VIDEODISCAUDIO, "UATF_VIDEODISCAUDIO"},
2433 {UATF_DVDAUDIO, "UATF_DVDAUDIO"},
2434 {UATF_TVTUNERAUDIO, "UATF_TVTUNERAUDIO"},
2435 {UATF_SATELLITE, "UATF_SATELLITE"},
2436 {UATF_CABLETUNER, "UATF_CABLETUNER"},
2437 {UATF_DSS, "UATF_DSS"},
2438 {UATF_RADIORECV, "UATF_RADIORECV"},
2439 {UATF_RADIOXMIT, "UATF_RADIOXMIT"},
2440 {UATF_MULTITRACK, "UATF_MULTITRACK"},
2441 {UATF_SYNTHESIZER, "UATF_SYNTHESIZER"},
2444 {0x0000, "UNKNOWN"},
2448 uaudio_mixer_get_terminal_name(uint16_t terminal_type)
2450 const struct uaudio_tt_to_string *uat = uaudio_tt_to_string;
2452 while (uat->terminal_type) {
2453 if (uat->terminal_type == terminal_type) {
2458 if (uat->terminal_type == 0) {
2459 DPRINTF("unknown terminal type (0x%04x)", terminal_type);
2467 uaudio_mixer_determine_class(const struct uaudio_terminal_node *iot,
2468 struct uaudio_mixer_node *mix)
2470 uint16_t terminal_type = 0x0000;
2471 const struct uaudio_terminal_node *input[2];
2472 const struct uaudio_terminal_node *output[2];
2474 input[0] = uaudio_mixer_get_input(iot, 0);
2475 input[1] = uaudio_mixer_get_input(iot, 1);
2477 output[0] = uaudio_mixer_get_output(iot, 0);
2478 output[1] = uaudio_mixer_get_output(iot, 1);
2481 * check if there is only
2482 * one output terminal:
2484 if (output[0] && (!output[1])) {
2485 terminal_type = UGETW(output[0]->u.ot->wTerminalType);
2488 * If the only output terminal is USB,
2489 * the class is UAC_RECORD.
2491 if ((terminal_type & 0xff00) == (UAT_UNDEFINED & 0xff00)) {
2493 mix->class = UAC_RECORD;
2494 if (input[0] && (!input[1])) {
2495 terminal_type = UGETW(input[0]->u.it->wTerminalType);
2502 * if the unit is connected to just
2503 * one input terminal, the
2504 * class is UAC_INPUT:
2506 if (input[0] && (!input[1])) {
2507 mix->class = UAC_INPUT;
2508 terminal_type = UGETW(input[0]->u.it->wTerminalType);
2512 * Otherwise, the class is UAC_OUTPUT.
2514 mix->class = UAC_OUTPUT;
2516 return (terminal_type);
2519 struct uaudio_tt_to_feature {
2520 uint16_t terminal_type;
2524 static const struct uaudio_tt_to_feature uaudio_tt_to_feature[] = {
2526 {UAT_STREAM, SOUND_MIXER_PCM},
2528 {UATI_MICROPHONE, SOUND_MIXER_MIC},
2529 {UATI_DESKMICROPHONE, SOUND_MIXER_MIC},
2530 {UATI_PERSONALMICROPHONE, SOUND_MIXER_MIC},
2531 {UATI_OMNIMICROPHONE, SOUND_MIXER_MIC},
2532 {UATI_MICROPHONEARRAY, SOUND_MIXER_MIC},
2533 {UATI_PROCMICROPHONEARR, SOUND_MIXER_MIC},
2535 {UATO_SPEAKER, SOUND_MIXER_SPEAKER},
2536 {UATO_DESKTOPSPEAKER, SOUND_MIXER_SPEAKER},
2537 {UATO_ROOMSPEAKER, SOUND_MIXER_SPEAKER},
2538 {UATO_COMMSPEAKER, SOUND_MIXER_SPEAKER},
2540 {UATE_ANALOGCONN, SOUND_MIXER_LINE},
2541 {UATE_LINECONN, SOUND_MIXER_LINE},
2542 {UATE_LEGACYCONN, SOUND_MIXER_LINE},
2544 {UATE_DIGITALAUIFC, SOUND_MIXER_ALTPCM},
2545 {UATE_SPDIF, SOUND_MIXER_ALTPCM},
2546 {UATE_1394DA, SOUND_MIXER_ALTPCM},
2547 {UATE_1394DV, SOUND_MIXER_ALTPCM},
2549 {UATF_CDPLAYER, SOUND_MIXER_CD},
2551 {UATF_SYNTHESIZER, SOUND_MIXER_SYNTH},
2553 {UATF_VIDEODISCAUDIO, SOUND_MIXER_VIDEO},
2554 {UATF_DVDAUDIO, SOUND_MIXER_VIDEO},
2555 {UATF_TVTUNERAUDIO, SOUND_MIXER_VIDEO},
2557 /* telephony terminal types */
2558 {UATT_UNDEFINED, SOUND_MIXER_PHONEIN}, /* SOUND_MIXER_PHONEOUT */
2559 {UATT_PHONELINE, SOUND_MIXER_PHONEIN}, /* SOUND_MIXER_PHONEOUT */
2560 {UATT_TELEPHONE, SOUND_MIXER_PHONEIN}, /* SOUND_MIXER_PHONEOUT */
2561 {UATT_DOWNLINEPHONE, SOUND_MIXER_PHONEIN}, /* SOUND_MIXER_PHONEOUT */
2563 {UATF_RADIORECV, SOUND_MIXER_RADIO},
2564 {UATF_RADIOXMIT, SOUND_MIXER_RADIO},
2566 {UAT_UNDEFINED, SOUND_MIXER_VOLUME},
2567 {UAT_VENDOR, SOUND_MIXER_VOLUME},
2568 {UATI_UNDEFINED, SOUND_MIXER_VOLUME},
2570 /* output terminal types */
2571 {UATO_UNDEFINED, SOUND_MIXER_VOLUME},
2572 {UATO_DISPLAYAUDIO, SOUND_MIXER_VOLUME},
2573 {UATO_SUBWOOFER, SOUND_MIXER_VOLUME},
2574 {UATO_HEADPHONES, SOUND_MIXER_VOLUME},
2576 /* bidir terminal types */
2577 {UATB_UNDEFINED, SOUND_MIXER_VOLUME},
2578 {UATB_HANDSET, SOUND_MIXER_VOLUME},
2579 {UATB_HEADSET, SOUND_MIXER_VOLUME},
2580 {UATB_SPEAKERPHONE, SOUND_MIXER_VOLUME},
2581 {UATB_SPEAKERPHONEESUP, SOUND_MIXER_VOLUME},
2582 {UATB_SPEAKERPHONEECANC, SOUND_MIXER_VOLUME},
2584 /* external terminal types */
2585 {UATE_UNDEFINED, SOUND_MIXER_VOLUME},
2587 /* embedded function terminal types */
2588 {UATF_UNDEFINED, SOUND_MIXER_VOLUME},
2589 {UATF_CALIBNOISE, SOUND_MIXER_VOLUME},
2590 {UATF_EQUNOISE, SOUND_MIXER_VOLUME},
2591 {UATF_DAT, SOUND_MIXER_VOLUME},
2592 {UATF_DCC, SOUND_MIXER_VOLUME},
2593 {UATF_MINIDISK, SOUND_MIXER_VOLUME},
2594 {UATF_ANALOGTAPE, SOUND_MIXER_VOLUME},
2595 {UATF_PHONOGRAPH, SOUND_MIXER_VOLUME},
2596 {UATF_VCRAUDIO, SOUND_MIXER_VOLUME},
2597 {UATF_SATELLITE, SOUND_MIXER_VOLUME},
2598 {UATF_CABLETUNER, SOUND_MIXER_VOLUME},
2599 {UATF_DSS, SOUND_MIXER_VOLUME},
2600 {UATF_MULTITRACK, SOUND_MIXER_VOLUME},
2601 {0xffff, SOUND_MIXER_VOLUME},
2604 {0x0000, SOUND_MIXER_VOLUME},
2608 uaudio_mixer_feature_name(const struct uaudio_terminal_node *iot,
2609 struct uaudio_mixer_node *mix)
2611 const struct uaudio_tt_to_feature *uat = uaudio_tt_to_feature;
2612 uint16_t terminal_type = uaudio_mixer_determine_class(iot, mix);
2614 if ((mix->class == UAC_RECORD) && (terminal_type == 0)) {
2615 return (SOUND_MIXER_IMIX);
2617 while (uat->terminal_type) {
2618 if (uat->terminal_type == terminal_type) {
2624 DPRINTF("terminal_type=%s (0x%04x) -> %d\n",
2625 uaudio_mixer_get_terminal_name(terminal_type),
2626 terminal_type, uat->feature);
2628 return (uat->feature);
2631 const static struct uaudio_terminal_node *
2632 uaudio_mixer_get_input(const struct uaudio_terminal_node *iot, uint8_t index)
2634 struct uaudio_terminal_node *root = iot->root;
2637 n = iot->usr.id_max;
2639 if (iot->usr.bit_input[n / 8] & (1 << (n % 8))) {
2649 const static struct uaudio_terminal_node *
2650 uaudio_mixer_get_output(const struct uaudio_terminal_node *iot, uint8_t index)
2652 struct uaudio_terminal_node *root = iot->root;
2655 n = iot->usr.id_max;
2657 if (iot->usr.bit_output[n / 8] & (1 << (n % 8))) {
2668 uaudio_mixer_find_inputs_sub(struct uaudio_terminal_node *root,
2669 const uint8_t *p_id, uint8_t n_id,
2670 struct uaudio_search_result *info)
2672 struct uaudio_terminal_node *iot;
2676 if (info->recurse_level >= UAUDIO_RECURSE_LIMIT) {
2679 info->recurse_level++;
2681 for (n = 0; n < n_id; n++) {
2685 if (info->bit_visited[i / 8] & (1 << (i % 8))) {
2686 /* don't go into a circle */
2687 DPRINTF("avoided going into a circle at id=%d!\n", i);
2690 info->bit_visited[i / 8] |= (1 << (i % 8));
2695 if (iot->u.desc == NULL) {
2698 switch (iot->u.desc->bDescriptorSubtype) {
2699 case UDESCSUB_AC_INPUT:
2700 info->bit_input[i / 8] |= (1 << (i % 8));
2703 case UDESCSUB_AC_FEATURE:
2704 uaudio_mixer_find_inputs_sub
2705 (root, &iot->u.fu->bSourceId, 1, info);
2708 case UDESCSUB_AC_OUTPUT:
2709 uaudio_mixer_find_inputs_sub
2710 (root, &iot->u.ot->bSourceId, 1, info);
2713 case UDESCSUB_AC_MIXER:
2714 uaudio_mixer_find_inputs_sub
2715 (root, iot->u.mu->baSourceId,
2716 iot->u.mu->bNrInPins, info);
2719 case UDESCSUB_AC_SELECTOR:
2720 uaudio_mixer_find_inputs_sub
2721 (root, iot->u.su->baSourceId,
2722 iot->u.su->bNrInPins, info);
2725 case UDESCSUB_AC_PROCESSING:
2726 uaudio_mixer_find_inputs_sub
2727 (root, iot->u.pu->baSourceId,
2728 iot->u.pu->bNrInPins, info);
2731 case UDESCSUB_AC_EXTENSION:
2732 uaudio_mixer_find_inputs_sub
2733 (root, iot->u.eu->baSourceId,
2734 iot->u.eu->bNrInPins, info);
2737 case UDESCSUB_AC_HEADER:
2742 info->recurse_level--;
2746 uaudio_mixer_find_outputs_sub(struct uaudio_terminal_node *root, uint8_t id,
2747 uint8_t n_id, struct uaudio_search_result *info)
2749 struct uaudio_terminal_node *iot = (root + id);
2754 if ((j != id) && ((root + j)->u.desc) &&
2755 ((root + j)->u.desc->bDescriptorSubtype == UDESCSUB_AC_OUTPUT)) {
2758 * "j" (output) <--- virtual wire <--- "id" (input)
2760 * if "j" has "id" on the input, then "id" have "j" on
2761 * the output, because they are connected:
2763 if ((root + j)->usr.bit_input[id / 8] & (1 << (id % 8))) {
2764 iot->usr.bit_output[j / 8] |= (1 << (j % 8));
2771 uaudio_mixer_fill_info(struct uaudio_softc *sc, struct usb_device *udev,
2774 const struct usb_audio_control_descriptor *acdp;
2775 struct usb_config_descriptor *cd = usbd_get_config_descriptor(udev);
2776 const struct usb_descriptor *dp;
2777 const struct usb_audio_unit *au;
2778 struct uaudio_terminal_node *iot = NULL;
2780 uint8_t ID_max = 0; /* inclusive */
2783 desc = usb_desc_foreach(cd, desc);
2786 DPRINTF("no Audio Control header\n");
2791 if ((acdp->bLength < sizeof(*acdp)) ||
2792 (acdp->bDescriptorType != UDESC_CS_INTERFACE) ||
2793 (acdp->bDescriptorSubtype != UDESCSUB_AC_HEADER)) {
2794 DPRINTF("invalid Audio Control header\n");
2797 /* "wTotalLen" is allowed to be corrupt */
2798 wTotalLen = UGETW(acdp->wTotalLength) - acdp->bLength;
2800 /* get USB audio revision */
2801 sc->sc_audio_rev = UGETW(acdp->bcdADC);
2803 DPRINTFN(3, "found AC header, vers=%03x, len=%d\n",
2804 sc->sc_audio_rev, wTotalLen);
2806 if (sc->sc_audio_rev != UAUDIO_VERSION) {
2808 if (sc->sc_uq_bad_adc) {
2811 DPRINTF("invalid audio version\n");
2815 iot = malloc(sizeof(struct uaudio_terminal_node) * 256, M_TEMP,
2819 DPRINTF("no memory!\n");
2822 while ((desc = usb_desc_foreach(cd, desc))) {
2826 if (dp->bLength > wTotalLen) {
2829 wTotalLen -= dp->bLength;
2832 au = uaudio_mixer_verify_desc(dp, 0);
2835 iot[au->bUnitId].u.desc = (const void *)au;
2836 if (au->bUnitId > ID_max) {
2837 ID_max = au->bUnitId;
2842 DPRINTF("Maximum ID=%d\n", ID_max);
2845 * determine sourcing inputs for
2846 * all nodes in the tree:
2850 uaudio_mixer_find_inputs_sub(iot, &i, 1, &((iot + i)->usr));
2854 * determine outputs for
2855 * all nodes in the tree:
2859 uaudio_mixer_find_outputs_sub(iot, i, ID_max, &((iot + i)->usr));
2862 /* set "id_max" and "root" */
2866 (iot + i)->usr.id_max = ID_max;
2867 (iot + i)->root = iot;
2875 if (iot[i].u.desc == NULL) {
2878 DPRINTF("id %d:\n", i);
2880 switch (iot[i].u.desc->bDescriptorSubtype) {
2881 case UDESCSUB_AC_INPUT:
2882 DPRINTF(" - AC_INPUT type=%s\n",
2883 uaudio_mixer_get_terminal_name
2884 (UGETW(iot[i].u.it->wTerminalType)));
2885 uaudio_mixer_dump_cluster(i, iot);
2888 case UDESCSUB_AC_OUTPUT:
2889 DPRINTF(" - AC_OUTPUT type=%s "
2890 "src=%d\n", uaudio_mixer_get_terminal_name
2891 (UGETW(iot[i].u.ot->wTerminalType)),
2892 iot[i].u.ot->bSourceId);
2895 case UDESCSUB_AC_MIXER:
2896 DPRINTF(" - AC_MIXER src:\n");
2897 for (j = 0; j < iot[i].u.mu->bNrInPins; j++) {
2898 DPRINTF(" - %d\n", iot[i].u.mu->baSourceId[j]);
2900 uaudio_mixer_dump_cluster(i, iot);
2903 case UDESCSUB_AC_SELECTOR:
2904 DPRINTF(" - AC_SELECTOR src:\n");
2905 for (j = 0; j < iot[i].u.su->bNrInPins; j++) {
2906 DPRINTF(" - %d\n", iot[i].u.su->baSourceId[j]);
2910 case UDESCSUB_AC_FEATURE:
2911 DPRINTF(" - AC_FEATURE src=%d\n", iot[i].u.fu->bSourceId);
2914 case UDESCSUB_AC_PROCESSING:
2915 DPRINTF(" - AC_PROCESSING src:\n");
2916 for (j = 0; j < iot[i].u.pu->bNrInPins; j++) {
2917 DPRINTF(" - %d\n", iot[i].u.pu->baSourceId[j]);
2919 uaudio_mixer_dump_cluster(i, iot);
2922 case UDESCSUB_AC_EXTENSION:
2923 DPRINTF(" - AC_EXTENSION src:\n");
2924 for (j = 0; j < iot[i].u.eu->bNrInPins; j++) {
2925 DPRINTF("%d ", iot[i].u.eu->baSourceId[j]);
2927 uaudio_mixer_dump_cluster(i, iot);
2931 DPRINTF("unknown audio control (subtype=%d)\n",
2932 iot[i].u.desc->bDescriptorSubtype);
2935 DPRINTF("Inputs to this ID are:\n");
2939 if (iot[i].usr.bit_input[j / 8] & (1 << (j % 8))) {
2940 DPRINTF(" -- ID=%d\n", j);
2944 DPRINTF("Outputs from this ID are:\n");
2948 if (iot[i].usr.bit_output[j / 8] & (1 << (j % 8))) {
2949 DPRINTF(" -- ID=%d\n", j);
2957 * scan the config to create a linked
2958 * list of "mixer" nodes:
2968 DPRINTFN(11, "id=%d subtype=%d\n",
2969 i, dp->bDescriptorSubtype);
2971 switch (dp->bDescriptorSubtype) {
2972 case UDESCSUB_AC_HEADER:
2973 DPRINTF("unexpected AC header\n");
2976 case UDESCSUB_AC_INPUT:
2977 uaudio_mixer_add_input(sc, iot, i);
2980 case UDESCSUB_AC_OUTPUT:
2981 uaudio_mixer_add_output(sc, iot, i);
2984 case UDESCSUB_AC_MIXER:
2985 uaudio_mixer_add_mixer(sc, iot, i);
2988 case UDESCSUB_AC_SELECTOR:
2989 uaudio_mixer_add_selector(sc, iot, i);
2992 case UDESCSUB_AC_FEATURE:
2993 uaudio_mixer_add_feature(sc, iot, i);
2996 case UDESCSUB_AC_PROCESSING:
2997 uaudio_mixer_add_processing(sc, iot, i);
3000 case UDESCSUB_AC_EXTENSION:
3001 uaudio_mixer_add_extension(sc, iot, i);
3005 DPRINTF("bad AC desc subtype=0x%02x\n",
3006 dp->bDescriptorSubtype);
3019 uaudio_mixer_get(struct usb_device *udev, uint8_t what,
3020 struct uaudio_mixer_node *mc)
3022 struct usb_device_request req;
3024 uint16_t len = MIX_SIZE(mc->type);
3028 if (mc->wValue[0] == -1) {
3031 req.bmRequestType = UT_READ_CLASS_INTERFACE;
3032 req.bRequest = what;
3033 USETW(req.wValue, mc->wValue[0]);
3034 USETW(req.wIndex, mc->wIndex);
3035 USETW(req.wLength, len);
3037 err = usbd_do_request(udev, NULL, &req, data);
3039 DPRINTF("err=%s\n", usbd_errstr(err));
3048 val = (data[0] | (data[1] << 8));
3050 DPRINTFN(3, "val=%d\n", val);
3056 uaudio_mixer_write_cfg_callback(struct usb_xfer *xfer, usb_error_t error)
3058 struct usb_device_request req;
3059 struct uaudio_softc *sc = usbd_xfer_softc(xfer);
3060 struct uaudio_mixer_node *mc = sc->sc_mixer_curr;
3061 struct usb_page_cache *pc;
3070 switch (USB_GET_STATE(xfer)) {
3071 case USB_ST_TRANSFERRED:
3077 mc = sc->sc_mixer_root;
3078 sc->sc_mixer_curr = mc;
3079 sc->sc_mixer_chan = 0;
3083 while (sc->sc_mixer_chan < mc->nchan) {
3085 len = MIX_SIZE(mc->type);
3087 chan = sc->sc_mixer_chan;
3089 sc->sc_mixer_chan++;
3091 update = ((mc->update[chan / 8] & (1 << (chan % 8))) &&
3092 (mc->wValue[chan] != -1));
3094 mc->update[chan / 8] &= ~(1 << (chan % 8));
3098 req.bmRequestType = UT_WRITE_CLASS_INTERFACE;
3099 req.bRequest = SET_CUR;
3100 USETW(req.wValue, mc->wValue[chan]);
3101 USETW(req.wIndex, mc->wIndex);
3102 USETW(req.wLength, len);
3105 buf[0] = (mc->wData[chan] & 0xFF);
3108 buf[1] = (mc->wData[chan] >> 8) & 0xFF;
3110 pc = usbd_xfer_get_frame(xfer, 0);
3111 usbd_copy_in(pc, 0, &req, sizeof(req));
3112 pc = usbd_xfer_get_frame(xfer, 1);
3113 usbd_copy_in(pc, 0, buf, len);
3115 usbd_xfer_set_frame_len(xfer, 0, sizeof(req));
3116 usbd_xfer_set_frame_len(xfer, 1, len);
3117 usbd_xfer_set_frames(xfer, len ? 2 : 1);
3118 usbd_transfer_submit(xfer);
3124 sc->sc_mixer_curr = mc;
3125 sc->sc_mixer_chan = 0;
3133 default: /* Error */
3134 DPRINTF("error=%s\n", usbd_errstr(error));
3135 if (error == USB_ERR_CANCELLED) {
3136 /* do nothing - we are detaching */
3139 goto tr_transferred;
3144 uaudio_set_speed(struct usb_device *udev, uint8_t endpt, uint32_t speed)
3146 struct usb_device_request req;
3149 DPRINTFN(6, "endpt=%d speed=%u\n", endpt, speed);
3151 req.bmRequestType = UT_WRITE_CLASS_ENDPOINT;
3152 req.bRequest = SET_CUR;
3153 USETW2(req.wValue, SAMPLING_FREQ_CONTROL, 0);
3154 USETW(req.wIndex, endpt);
3155 USETW(req.wLength, 3);
3157 data[1] = speed >> 8;
3158 data[2] = speed >> 16;
3160 return (usbd_do_request(udev, NULL, &req, data));
3164 uaudio_mixer_signext(uint8_t type, int val)
3166 if (!MIX_UNSIGNED(type)) {
3167 if (MIX_SIZE(type) == 2) {
3177 uaudio_mixer_bsd2value(struct uaudio_mixer_node *mc, int32_t val)
3179 if (mc->type == MIX_ON_OFF) {
3181 } else if (mc->type == MIX_SELECTOR) {
3182 if ((val < mc->minval) ||
3183 (val > mc->maxval)) {
3188 /* compute actual volume */
3189 val = (val * mc->mul) / 255;
3191 /* add lower offset */
3192 val = val + mc->minval;
3194 /* make sure we don't write a value out of range */
3195 if (val > mc->maxval)
3197 else if (val < mc->minval)
3201 DPRINTFN(6, "type=0x%03x val=%d min=%d max=%d val=%d\n",
3202 mc->type, val, mc->minval, mc->maxval, val);
3207 uaudio_mixer_ctl_set(struct uaudio_softc *sc, struct uaudio_mixer_node *mc,
3208 uint8_t chan, int32_t val)
3210 val = uaudio_mixer_bsd2value(mc, val);
3212 mc->update[chan / 8] |= (1 << (chan % 8));
3213 mc->wData[chan] = val;
3215 /* start the transfer, if not already started */
3217 usbd_transfer_start(sc->sc_mixer_xfer[0]);
3221 uaudio_mixer_init(struct uaudio_softc *sc)
3223 struct uaudio_mixer_node *mc;
3226 for (mc = sc->sc_mixer_root; mc;
3229 if (mc->ctl != SOUND_MIXER_NRDEVICES) {
3231 * Set device mask bits. See
3232 * /usr/include/machine/soundcard.h
3234 sc->sc_mix_info |= (1 << mc->ctl);
3236 if ((mc->ctl == SOUND_MIXER_NRDEVICES) &&
3237 (mc->type == MIX_SELECTOR)) {
3239 for (i = mc->minval; (i > 0) && (i <= mc->maxval); i++) {
3240 if (mc->slctrtype[i - 1] == SOUND_MIXER_NRDEVICES) {
3243 sc->sc_recsrc_info |= 1 << mc->slctrtype[i - 1];
3250 uaudio_mixer_init_sub(struct uaudio_softc *sc, struct snd_mixer *m)
3254 if (usbd_transfer_setup(sc->sc_udev, &sc->sc_mixer_iface_index,
3255 sc->sc_mixer_xfer, uaudio_mixer_config, 1, sc,
3256 mixer_get_lock(m))) {
3257 DPRINTFN(0, "could not allocate USB "
3258 "transfer for audio mixer!\n");
3261 if (!(sc->sc_mix_info & SOUND_MASK_VOLUME)) {
3262 mix_setparentchild(m, SOUND_MIXER_VOLUME, SOUND_MASK_PCM);
3263 mix_setrealdev(m, SOUND_MIXER_VOLUME, SOUND_MIXER_NONE);
3265 mix_setdevs(m, sc->sc_mix_info);
3266 mix_setrecdevs(m, sc->sc_recsrc_info);
3271 uaudio_mixer_uninit_sub(struct uaudio_softc *sc)
3275 usbd_transfer_unsetup(sc->sc_mixer_xfer, 1);
3281 uaudio_mixer_set(struct uaudio_softc *sc, unsigned type,
3282 unsigned left, unsigned right)
3284 struct uaudio_mixer_node *mc;
3286 for (mc = sc->sc_mixer_root; mc;
3289 if (mc->ctl == type) {
3290 if (mc->nchan == 2) {
3292 uaudio_mixer_ctl_set(sc, mc, 1, (int)(right * 255) / 100);
3294 /* set Left or Mono */
3295 uaudio_mixer_ctl_set(sc, mc, 0, (int)(left * 255) / 100);
3301 uaudio_mixer_setrecsrc(struct uaudio_softc *sc, uint32_t src)
3303 struct uaudio_mixer_node *mc;
3308 for (mc = sc->sc_mixer_root; mc;
3311 if ((mc->ctl == SOUND_MIXER_NRDEVICES) &&
3312 (mc->type == MIX_SELECTOR)) {
3314 /* compute selector mask */
3317 for (i = mc->minval; (i > 0) && (i <= mc->maxval); i++) {
3318 mask |= (1 << mc->slctrtype[i - 1]);
3325 /* find the first set bit */
3326 temp = (-temp) & temp;
3332 for (i = mc->minval; (i > 0) && (i <= mc->maxval); i++) {
3333 if (temp != (1 << mc->slctrtype[i - 1])) {
3336 uaudio_mixer_ctl_set(sc, mc, 0, i);
3344 /*========================================================================*
3345 * MIDI support routines
3346 *========================================================================*/
3349 umidi_bulk_read_callback(struct usb_xfer *xfer, usb_error_t error)
3351 struct umidi_chan *chan = usbd_xfer_softc(xfer);
3352 struct umidi_sub_chan *sub;
3353 struct usb_page_cache *pc;
3360 usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL);
3362 switch (USB_GET_STATE(xfer)) {
3363 case USB_ST_TRANSFERRED:
3365 DPRINTF("actlen=%d bytes\n", actlen);
3368 pc = usbd_xfer_get_frame(xfer, 0);
3370 while (actlen >= 4) {
3372 /* copy out the MIDI data */
3373 usbd_copy_out(pc, pos, buf, 4);
3374 /* command length */
3375 cmd_len = umidi_cmd_to_len[buf[0] & 0xF];
3379 * Lookup sub-channel. The index is range
3382 sub = &chan->sub[cn];
3384 if ((cmd_len != 0) &&
3385 (cn < chan->max_cable) &&
3386 (sub->read_open != 0)) {
3388 /* Send data to the application */
3389 usb_fifo_put_data_linear(
3390 sub->fifo.fp[USB_FIFO_RX],
3391 buf + 1, cmd_len, 1);
3400 usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
3401 usbd_transfer_submit(xfer);
3405 DPRINTF("error=%s\n", usbd_errstr(error));
3407 if (error != USB_ERR_CANCELLED) {
3408 /* try to clear stall first */
3409 usbd_xfer_set_stall(xfer);
3417 * The following statemachine, that converts MIDI commands to
3418 * USB MIDI packets, derives from Linux's usbmidi.c, which
3419 * was written by "Clemens Ladisch":
3423 * Else: Command is complete
3426 umidi_convert_to_usb(struct umidi_sub_chan *sub, uint8_t cn, uint8_t b)
3428 uint8_t p0 = (cn << 4);
3431 sub->temp_0[0] = p0 | 0x0f;
3435 sub->temp_cmd = sub->temp_0;
3438 } else if (b >= 0xf0) {
3440 case 0xf0: /* system exclusive begin */
3442 sub->state = UMIDI_ST_SYSEX_1;
3444 case 0xf1: /* MIDI time code */
3445 case 0xf3: /* song select */
3447 sub->state = UMIDI_ST_1PARAM;
3449 case 0xf2: /* song position pointer */
3451 sub->state = UMIDI_ST_2PARAM_1;
3453 case 0xf4: /* unknown */
3454 case 0xf5: /* unknown */
3455 sub->state = UMIDI_ST_UNKNOWN;
3457 case 0xf6: /* tune request */
3458 sub->temp_1[0] = p0 | 0x05;
3459 sub->temp_1[1] = 0xf6;
3462 sub->temp_cmd = sub->temp_1;
3463 sub->state = UMIDI_ST_UNKNOWN;
3466 case 0xf7: /* system exclusive end */
3467 switch (sub->state) {
3468 case UMIDI_ST_SYSEX_0:
3469 sub->temp_1[0] = p0 | 0x05;
3470 sub->temp_1[1] = 0xf7;
3473 sub->temp_cmd = sub->temp_1;
3474 sub->state = UMIDI_ST_UNKNOWN;
3476 case UMIDI_ST_SYSEX_1:
3477 sub->temp_1[0] = p0 | 0x06;
3478 sub->temp_1[2] = 0xf7;
3480 sub->temp_cmd = sub->temp_1;
3481 sub->state = UMIDI_ST_UNKNOWN;
3483 case UMIDI_ST_SYSEX_2:
3484 sub->temp_1[0] = p0 | 0x07;
3485 sub->temp_1[3] = 0xf7;
3486 sub->temp_cmd = sub->temp_1;
3487 sub->state = UMIDI_ST_UNKNOWN;
3490 sub->state = UMIDI_ST_UNKNOWN;
3493 } else if (b >= 0x80) {
3495 if ((b >= 0xc0) && (b <= 0xdf)) {
3496 sub->state = UMIDI_ST_1PARAM;
3498 sub->state = UMIDI_ST_2PARAM_1;
3500 } else { /* b < 0x80 */
3501 switch (sub->state) {
3502 case UMIDI_ST_1PARAM:
3503 if (sub->temp_1[1] < 0xf0) {
3504 p0 |= sub->temp_1[1] >> 4;
3507 sub->state = UMIDI_ST_UNKNOWN;
3509 sub->temp_1[0] = p0;
3512 sub->temp_cmd = sub->temp_1;
3514 case UMIDI_ST_2PARAM_1:
3516 sub->state = UMIDI_ST_2PARAM_2;
3518 case UMIDI_ST_2PARAM_2:
3519 if (sub->temp_1[1] < 0xf0) {
3520 p0 |= sub->temp_1[1] >> 4;
3521 sub->state = UMIDI_ST_2PARAM_1;
3524 sub->state = UMIDI_ST_UNKNOWN;
3526 sub->temp_1[0] = p0;
3528 sub->temp_cmd = sub->temp_1;
3530 case UMIDI_ST_SYSEX_0:
3532 sub->state = UMIDI_ST_SYSEX_1;
3534 case UMIDI_ST_SYSEX_1:
3536 sub->state = UMIDI_ST_SYSEX_2;
3538 case UMIDI_ST_SYSEX_2:
3539 sub->temp_1[0] = p0 | 0x04;
3541 sub->temp_cmd = sub->temp_1;
3542 sub->state = UMIDI_ST_SYSEX_0;
3552 umidi_bulk_write_callback(struct usb_xfer *xfer, usb_error_t error)
3554 struct umidi_chan *chan = usbd_xfer_softc(xfer);
3555 struct umidi_sub_chan *sub;
3556 struct usb_page_cache *pc;
3560 uint8_t start_cable;
3564 usbd_xfer_status(xfer, &len, NULL, NULL, NULL);
3567 * NOTE: Some MIDI devices only accept 4 bytes of data per
3568 * short terminated USB transfer.
3570 switch (USB_GET_STATE(xfer)) {
3571 case USB_ST_TRANSFERRED:
3572 DPRINTF("actlen=%d bytes\n", len);
3578 nframes = 0; /* reset */
3579 start_cable = chan->curr_cable;
3581 pc = usbd_xfer_get_frame(xfer, 0);
3585 /* round robin de-queueing */
3587 sub = &chan->sub[chan->curr_cable];
3589 if (sub->write_open) {
3590 usb_fifo_get_data_linear(sub->fifo.fp[USB_FIFO_TX],
3591 &buf, 1, &actlen, 0);
3600 DPRINTF("byte=0x%02x from FIFO %u\n", buf,
3601 (unsigned int)chan->curr_cable);
3603 if (umidi_convert_to_usb(sub, chan->curr_cable, buf)) {
3605 DPRINTF("sub=0x%02x 0x%02x 0x%02x 0x%02x\n",
3606 sub->temp_cmd[0], sub->temp_cmd[1],
3607 sub->temp_cmd[2], sub->temp_cmd[3]);
3609 usbd_copy_in(pc, nframes * 4, sub->temp_cmd, 4);
3613 if ((nframes >= UMIDI_TX_FRAMES) || (chan->single_command != 0))
3621 if (chan->curr_cable >= chan->max_cable)
3622 chan->curr_cable = 0;
3624 if (chan->curr_cable == start_cable) {
3632 DPRINTF("Transferring %d frames\n", (int)nframes);
3633 usbd_xfer_set_frame_len(xfer, 0, 4 * nframes);
3634 usbd_transfer_submit(xfer);
3638 default: /* Error */
3640 DPRINTF("error=%s\n", usbd_errstr(error));
3642 if (error != USB_ERR_CANCELLED) {
3643 /* try to clear stall first */
3644 usbd_xfer_set_stall(xfer);
3651 static struct umidi_sub_chan *
3652 umidi_sub_by_fifo(struct usb_fifo *fifo)
3654 struct umidi_chan *chan = usb_fifo_softc(fifo);
3655 struct umidi_sub_chan *sub;
3658 for (n = 0; n < UMIDI_CABLES_MAX; n++) {
3659 sub = &chan->sub[n];
3660 if ((sub->fifo.fp[USB_FIFO_RX] == fifo) ||
3661 (sub->fifo.fp[USB_FIFO_TX] == fifo)) {
3666 panic("%s:%d cannot find usb_fifo!\n",
3667 __FILE__, __LINE__);
3673 umidi_start_read(struct usb_fifo *fifo)
3675 struct umidi_chan *chan = usb_fifo_softc(fifo);
3677 usbd_transfer_start(chan->xfer[UMIDI_RX_TRANSFER]);
3681 umidi_stop_read(struct usb_fifo *fifo)
3683 struct umidi_chan *chan = usb_fifo_softc(fifo);
3684 struct umidi_sub_chan *sub = umidi_sub_by_fifo(fifo);
3690 if (--(chan->read_open_refcount) == 0) {
3692 * XXX don't stop the read transfer here, hence that causes
3693 * problems with some MIDI adapters
3695 DPRINTF("(stopping read transfer)\n");
3700 umidi_start_write(struct usb_fifo *fifo)
3702 struct umidi_chan *chan = usb_fifo_softc(fifo);
3704 usbd_transfer_start(chan->xfer[UMIDI_TX_TRANSFER]);
3708 umidi_stop_write(struct usb_fifo *fifo)
3710 struct umidi_chan *chan = usb_fifo_softc(fifo);
3711 struct umidi_sub_chan *sub = umidi_sub_by_fifo(fifo);
3715 sub->write_open = 0;
3717 if (--(chan->write_open_refcount) == 0) {
3718 DPRINTF("(stopping write transfer)\n");
3719 usbd_transfer_stop(chan->xfer[UMIDI_TX_TRANSFER]);
3724 umidi_open(struct usb_fifo *fifo, int fflags)
3726 struct umidi_chan *chan = usb_fifo_softc(fifo);
3727 struct umidi_sub_chan *sub = umidi_sub_by_fifo(fifo);
3729 if (fflags & FREAD) {
3730 if (usb_fifo_alloc_buffer(fifo, 4, (1024 / 4))) {
3733 mtx_lock(&chan->mtx);
3734 chan->read_open_refcount++;
3736 mtx_unlock(&chan->mtx);
3738 if (fflags & FWRITE) {
3739 if (usb_fifo_alloc_buffer(fifo, 32, (1024 / 32))) {
3742 /* clear stall first */
3743 mtx_lock(&chan->mtx);
3744 usbd_xfer_set_stall(chan->xfer[UMIDI_TX_TRANSFER]);
3745 chan->write_open_refcount++;
3746 sub->write_open = 1;
3749 sub->state = UMIDI_ST_UNKNOWN;
3750 mtx_unlock(&chan->mtx);
3752 return (0); /* success */
3756 umidi_close(struct usb_fifo *fifo, int fflags)
3758 if (fflags & FREAD) {
3759 usb_fifo_free_buffer(fifo);
3761 if (fflags & FWRITE) {
3762 usb_fifo_free_buffer(fifo);
3768 umidi_ioctl(struct usb_fifo *fifo, u_long cmd, void *data,
3775 umidi_init(device_t dev)
3777 struct uaudio_softc *sc = device_get_softc(dev);
3778 struct umidi_chan *chan = &sc->sc_midi_chan;
3780 mtx_init(&chan->mtx, "umidi lock", NULL, MTX_DEF | MTX_RECURSE);
3783 static struct usb_fifo_methods umidi_fifo_methods = {
3784 .f_start_read = &umidi_start_read,
3785 .f_start_write = &umidi_start_write,
3786 .f_stop_read = &umidi_stop_read,
3787 .f_stop_write = &umidi_stop_write,
3788 .f_open = &umidi_open,
3789 .f_close = &umidi_close,
3790 .f_ioctl = &umidi_ioctl,
3791 .basename[0] = "umidi",
3795 umidi_probe(device_t dev)
3797 struct uaudio_softc *sc = device_get_softc(dev);
3798 struct usb_attach_arg *uaa = device_get_ivars(dev);
3799 struct umidi_chan *chan = &sc->sc_midi_chan;
3800 struct umidi_sub_chan *sub;
3801 int unit = device_get_unit(dev);
3805 if (usb_test_quirk(uaa, UQ_SINGLE_CMD_MIDI))
3806 chan->single_command = 1;
3808 if (usbd_set_alt_interface_index(sc->sc_udev, chan->iface_index,
3809 chan->iface_alt_index)) {
3810 DPRINTF("setting of alternate index failed!\n");
3813 usbd_set_parent_iface(sc->sc_udev, chan->iface_index,
3814 sc->sc_mixer_iface_index);
3816 error = usbd_transfer_setup(uaa->device, &chan->iface_index,
3817 chan->xfer, umidi_config, UMIDI_N_TRANSFER,
3820 DPRINTF("error=%s\n", usbd_errstr(error));
3823 if ((chan->max_cable > UMIDI_CABLES_MAX) ||
3824 (chan->max_cable == 0)) {
3825 chan->max_cable = UMIDI_CABLES_MAX;
3828 for (n = 0; n < chan->max_cable; n++) {
3830 sub = &chan->sub[n];
3832 error = usb_fifo_attach(sc->sc_udev, chan, &chan->mtx,
3833 &umidi_fifo_methods, &sub->fifo, unit, n,
3835 UID_ROOT, GID_OPERATOR, 0644);
3841 mtx_lock(&chan->mtx);
3843 /* clear stall first */
3844 usbd_xfer_set_stall(chan->xfer[UMIDI_RX_TRANSFER]);
3847 * NOTE: At least one device will not work properly unless the
3848 * BULK IN pipe is open all the time. This might have to do
3849 * about that the internal queues of the device overflow if we
3850 * don't read them regularly.
3852 usbd_transfer_start(chan->xfer[UMIDI_RX_TRANSFER]);
3854 mtx_unlock(&chan->mtx);
3856 return (0); /* success */
3859 return (ENXIO); /* failure */
3863 umidi_detach(device_t dev)
3865 struct uaudio_softc *sc = device_get_softc(dev);
3866 struct umidi_chan *chan = &sc->sc_midi_chan;
3869 for (n = 0; n < UMIDI_CABLES_MAX; n++) {
3870 usb_fifo_detach(&chan->sub[n].fifo);
3873 mtx_lock(&chan->mtx);
3875 usbd_transfer_stop(chan->xfer[UMIDI_RX_TRANSFER]);
3877 mtx_unlock(&chan->mtx);
3879 usbd_transfer_unsetup(chan->xfer, UMIDI_N_TRANSFER);
3881 mtx_destroy(&chan->mtx);
3886 DRIVER_MODULE(uaudio, uhub, uaudio_driver, uaudio_devclass, NULL, 0);
3887 MODULE_DEPEND(uaudio, usb, 1, 1, 1);
3888 MODULE_DEPEND(uaudio, sound, SOUND_MINVER, SOUND_PREFVER, SOUND_MAXVER);
3889 MODULE_VERSION(uaudio, 1);