5  *   Mixer control part
15  * TODOs, for both the mixer and the streaming interfaces:
48 #include "mixer.h"
67 	struct usb_mixer_interface *mixer;  member
94  * manual mapping of mixer names
95  * if the mixer topology is too complicated and the parsed names are
130 	((cval)->head.mixer->ignore_ctl_error ? 0 : (err))
298  * retrieve a mixer value
301 static inline int mixer_ctrl_intf(struct usb_mixer_interface *mixer)  in mixer_ctrl_intf()  argument
303 	return get_iface_desc(mixer->hostif)->bInterfaceNumber;  in mixer_ctrl_intf()
309 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in get_ctl_value_v1()
320 		idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in get_ctl_value_v1()
345 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in get_ctl_value_v2()
368 	idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in get_ctl_value_v2()
412 	return (cval->head.mixer->protocol == UAC_VERSION_1) ?  in get_ctl_value()
443 		if (!cval->head.mixer->ignore_ctl_error)  in snd_usb_get_cur_mix_value()
444 			usb_audio_dbg(cval->head.mixer->chip,  in snd_usb_get_cur_mix_value()
455  * set a mixer value
461 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in snd_usb_mixer_set_ctl_value()
468 	if (cval->head.mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_set_ctl_value()
493 		idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in snd_usb_mixer_set_ctl_value()
529 		usb_audio_dbg(cval->head.mixer->chip,  in snd_usb_set_cur_mix_value()
546  * TLV callback for mixer volume controls
574  * used for mixer unit parser
594 	struct usb_mixer_interface *mixer = list->mixer;  in snd_usb_mixer_add_list()  local
597 	while (snd_ctl_find_id(mixer->chip->card, &kctl->id))  in snd_usb_mixer_add_list()
599 	err = snd_ctl_add(mixer->chip->card, kctl);  in snd_usb_mixer_add_list()
601 		usb_audio_dbg(mixer->chip, "cannot add control (err = %d)\n",  in snd_usb_mixer_add_list()
607 	list->next_id_elem = mixer->id_elems[list->id];  in snd_usb_mixer_add_list()
608 	mixer->id_elems[list->id] = list;  in snd_usb_mixer_add_list()
687 			strcpy(name, "Mixer");  in get_term_name()
749  * Get number of channels for a Mixer Unit.
756 	switch (state->mixer->protocol) {  in uac_mixer_unit_get_channels()
850 	int protocol = state->mixer->protocol;  in parse_term_mixer_unit()
879 	if (state->mixer->protocol != UAC_VERSION_3)  in parse_term_selector_unit()
889 	int protocol = state->mixer->protocol;  in parse_term_proc_unit()
961 	int protocol = state->mixer->protocol;  in __check_input_term()
1080  * interface to ALSA control for feature/mixer units
1087 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in volume_control_quirks()
1238 			usb_audio_err(cval->head.mixer->chip,  in get_min_max_with_quirks()
1240 				   cval->head.id, mixer_ctrl_intf(cval->head.mixer),  in get_min_max_with_quirks()
1248 		} else if (cval->head.mixer->protocol == UAC_VERSION_1) {  in get_min_max_with_quirks()
1322 			usb_audio_info(cval->head.mixer->chip,  in get_min_max_with_quirks()
1324 				       cval->head.id, mixer_ctrl_intf(cval->head.mixer),  in get_min_max_with_quirks()
1335 /* get a feature/mixer unit info */
1358 				snd_ctl_notify(cval->head.mixer->chip->card,  in mixer_ctl_feature_info()
1370 /* get the current value from feature/mixer unit */
1402 /* put the current value to feature/mixer unit */
1459 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in get_connector_value()
1468 	idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in get_connector_value()
1469 	if (cval->head.mixer->protocol == UAC_VERSION_2) {  in get_connector_value()
1561  * This symbol is exported in order to allow the mixer quirks to
1575  * A lot of headsets/headphones have a "Speaker" mixer. Make sure we
1613 static void __build_feature_ctl(struct usb_mixer_interface *mixer,  in __build_feature_ctl()  argument
1640 	snd_usb_mixer_elem_init_std(&cval->head, mixer, unitid);  in __build_feature_ctl()
1649 	if (mixer->protocol == UAC_VERSION_1)  in __build_feature_ctl()
1678 		usb_audio_err(mixer->chip, "cannot malloc kcontrol\n");  in __build_feature_ctl()
1687 		len = snd_usb_copy_string_desc(mixer->chip, nameid,  in __build_feature_ctl()
1703 				len = get_term_name(mixer->chip, iterm,  in __build_feature_ctl()
1707 				len = get_term_name(mixer->chip, oterm,  in __build_feature_ctl()
1716 			check_no_speaker_on_headset(kctl, mixer->chip->card);  in __build_feature_ctl()
1744 		usb_audio_dbg(mixer->chip,  in __build_feature_ctl()
1762 	snd_usb_mixer_fu_apply_quirk(mixer, cval, unitid, kctl);  in __build_feature_ctl()
1771 		usb_audio_warn(mixer->chip,  in __build_feature_ctl()
1774 		usb_audio_warn(mixer->chip,  in __build_feature_ctl()
1780 	usb_audio_dbg(mixer->chip, "[%d] FU [%s] ch = %d, val = %d/%d/%d\n",  in __build_feature_ctl()
1794 	__build_feature_ctl(state->mixer, state->map, ctl_mask, control,  in build_feature_ctl()
1798 static void build_feature_ctl_badd(struct usb_mixer_interface *mixer,  in build_feature_ctl_badd()  argument
1802 	__build_feature_ctl(mixer, badd_map, ctl_mask, control,  in build_feature_ctl_badd()
1806 static void get_connector_control_name(struct usb_mixer_interface *mixer,  in get_connector_control_name()  argument
1810 	int name_len = get_term_name(mixer->chip, term, name, name_size, 0);  in get_connector_control_name()
1835 /* Build a mixer control for a UAC connector control (jack-detect) */
1836 static void build_connector_control(struct usb_mixer_interface *mixer,  in build_connector_control()  argument
1851 	snd_usb_mixer_elem_init_std(&cval->head, mixer, term->id);  in build_connector_control()
1866 	if (mixer->protocol == UAC_VERSION_2)  in build_connector_control()
1877 		usb_audio_err(mixer->chip, "cannot malloc kcontrol\n");  in build_connector_control()
1885 		get_connector_control_name(mixer, term, is_input, kctl->id.name,  in build_connector_control()
1900 	if (state->mixer->protocol != UAC_VERSION_2)  in parse_clock_source_unit()
1915 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, hdr->bClockID);  in parse_clock_source_unit()
1960 	if (state->mixer->protocol == UAC_VERSION_1) {  in parse_audio_feature_unit()
1964 	} else if (state->mixer->protocol == UAC_VERSION_2) {  in parse_audio_feature_unit()
2005 	if (state->mixer->protocol == UAC_VERSION_1) {  in parse_audio_feature_unit()
2078  * Mixer Unit
2107  * build a mixer unit control
2130 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in build_mixer_unit_ctl()
2134 		__u8 *c = uac_mixer_unit_bmControls(desc, state->mixer->protocol);  in build_mixer_unit_ctl()
2158 		len = sprintf(kctl->id.name, "Mixer Source %d", in_ch + 1);  in build_mixer_unit_ctl()
2172 	if (state->mixer->protocol == UAC_VERSION_2) {  in parse_audio_input_terminal()
2177 	} else if (state->mixer->protocol == UAC_VERSION_3) {  in parse_audio_input_terminal()
2191 		build_connector_control(state->mixer, state->map, &iterm, true);  in parse_audio_input_terminal()
2197  * parse a mixer unit
2210 			      "invalid MIXER UNIT descriptor %d\n",  in parse_audio_mixer_unit()
2231 		if (mixer_bitmap_overflow(desc, state->mixer->protocol,  in parse_audio_mixer_unit()
2239 						state->mixer->protocol);  in parse_audio_mixer_unit()
2456 		__u8 *controls = uac_processing_unit_bmControls(desc, state->mixer->protocol);  in build_audio_procunit()
2458 		if (state->mixer->protocol == UAC_VERSION_1) {  in build_audio_procunit()
2474 		snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in build_audio_procunit()
2479 		if (state->mixer->protocol > UAC_VERSION_1 &&  in build_audio_procunit()
2489 			switch (state->mixer->protocol) {  in build_audio_procunit()
2504 								state->mixer->protocol);  in build_audio_procunit()
2549 				nameid = uac_extension_unit_iExtension(desc, state->mixer->protocol);  in build_audio_procunit()
2551 				nameid = uac_processing_unit_iProcessing(desc, state->mixer->protocol);  in build_audio_procunit()
2579 	switch (state->mixer->protocol) {  in parse_audio_processing_unit()
2718 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in parse_audio_selector_unit()
2726 	switch (state->mixer->protocol) {  in parse_audio_selector_unit()
2776 		switch (state->mixer->protocol) {  in parse_audio_selector_unit()
2830 	int protocol = state->mixer->protocol;  in parse_audio_unit()
2887 static void snd_usb_mixer_free(struct usb_mixer_interface *mixer)  in snd_usb_mixer_free()  argument
2890 	snd_usb_mixer_disconnect(mixer);  in snd_usb_mixer_free()
2892 	kfree(mixer->id_elems);  in snd_usb_mixer_free()
2893 	if (mixer->urb) {  in snd_usb_mixer_free()
2894 		kfree(mixer->urb->transfer_buffer);  in snd_usb_mixer_free()
2895 		usb_free_urb(mixer->urb);  in snd_usb_mixer_free()
2897 	usb_free_urb(mixer->rc_urb);  in snd_usb_mixer_free()
2898 	kfree(mixer->rc_setup_packet);  in snd_usb_mixer_free()
2899 	kfree(mixer);  in snd_usb_mixer_free()
2904 	struct usb_mixer_interface *mixer = device->device_data;  in snd_usb_mixer_dev_free()  local
2905 	snd_usb_mixer_free(mixer);  in snd_usb_mixer_dev_free()
2978 static bool uac3_badd_func_has_valid_channels(struct usb_mixer_interface *mixer,  in uac3_badd_func_has_valid_channels()  argument
2988 			usb_audio_warn(mixer->chip, "BAAD %s: no channels?",  in uac3_badd_func_has_valid_channels()
2997 		usb_audio_warn(mixer->chip, "BAAD %s c_chmask mismatch",  in uac3_badd_func_has_valid_channels()
3003 		usb_audio_warn(mixer->chip, "BAAD %s p_chmask mismatch",  in uac3_badd_func_has_valid_channels()
3011  * create mixer controls for UAC3 BADD profiles
3015  * BADD device may contain Mixer Unit, which doesn't have any controls, skip it
3017 static int snd_usb_mixer_controls_badd(struct usb_mixer_interface *mixer,  in snd_usb_mixer_controls_badd()  argument
3020 	struct usb_device *dev = mixer->chip->dev;  in snd_usb_mixer_controls_badd()
3022 	int badd_profile = mixer->chip->badd_profile;  in snd_usb_mixer_controls_badd()
3072 			usb_audio_err(mixer->chip,  in snd_usb_mixer_controls_badd()
3096 	usb_audio_dbg(mixer->chip,  in snd_usb_mixer_controls_badd()
3115 	if (!uac3_badd_func_has_valid_channels(mixer, f, c_chmask, p_chmask))  in snd_usb_mixer_controls_badd()
3122 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3125 		build_feature_ctl_badd(mixer, p_chmask, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3132 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3135 		build_feature_ctl_badd(mixer, c_chmask, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3142 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3145 		build_feature_ctl_badd(mixer, 1, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3157 		build_connector_control(mixer, map->map, &iterm, true);  in snd_usb_mixer_controls_badd()
3163 		build_connector_control(mixer, map->map, &oterm, false);  in snd_usb_mixer_controls_badd()
3170  * create mixer controls
3174 static int snd_usb_mixer_controls(struct usb_mixer_interface *mixer)  in snd_usb_mixer_controls()  argument
3182 	state.chip = mixer->chip;  in snd_usb_mixer_controls()
3183 	state.mixer = mixer;  in snd_usb_mixer_controls()
3184 	state.buffer = mixer->hostif->extra;  in snd_usb_mixer_controls()
3185 	state.buflen = mixer->hostif->extralen;  in snd_usb_mixer_controls()
3192 			mixer->connector_map = map->connector_map;  in snd_usb_mixer_controls()
3198 	while ((p = snd_usb_find_csint_desc(mixer->hostif->extra,  in snd_usb_mixer_controls()
3199 					    mixer->hostif->extralen,  in snd_usb_mixer_controls()
3201 		if (!snd_usb_validate_audio_desc(p, mixer->protocol))  in snd_usb_mixer_controls()
3204 		if (mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_controls()
3215 		} else if (mixer->protocol == UAC_VERSION_2) {  in snd_usb_mixer_controls()
3238 				build_connector_control(state.mixer, state.map,  in snd_usb_mixer_controls()
3264 				build_connector_control(state.mixer, state.map,  in snd_usb_mixer_controls()
3273 static int delegate_notify(struct usb_mixer_interface *mixer, int unitid,  in delegate_notify()  argument
3276 	const struct usbmix_connector_map *map = mixer->connector_map;  in delegate_notify()
3293 void snd_usb_mixer_notify_id(struct usb_mixer_interface *mixer, int unitid)  in snd_usb_mixer_notify_id()  argument
3297 	unitid = delegate_notify(mixer, unitid, NULL, NULL);  in snd_usb_mixer_notify_id()
3299 	for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_notify_id()
3307 		snd_ctl_notify(mixer->chip->card, SNDRV_CTL_EVENT_MASK_VALUE,  in snd_usb_mixer_notify_id()
3339 	struct usb_mixer_interface *mixer;  in snd_usb_mixer_proc_read()  local
3343 	list_for_each_entry(mixer, &chip->mixer_list, list) {  in snd_usb_mixer_proc_read()
3345 			"USB Mixer: usb_id=0x%08x, ctrlif=%i, ctlerr=%i\n",  in snd_usb_mixer_proc_read()
3346 				chip->usb_id, mixer_ctrl_intf(mixer),  in snd_usb_mixer_proc_read()
3347 				mixer->ignore_ctl_error);  in snd_usb_mixer_proc_read()
3350 			for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_proc_read()
3364 static void snd_usb_mixer_interrupt_v2(struct usb_mixer_interface *mixer,  in snd_usb_mixer_interrupt_v2()  argument
3374 		usb_audio_dbg(mixer->chip,  in snd_usb_mixer_interrupt_v2()
3380 	unitid = delegate_notify(mixer, unitid, &control, &channel);  in snd_usb_mixer_interrupt_v2()
3382 	for_each_mixer_elem(list, mixer, unitid)  in snd_usb_mixer_interrupt_v2()
3388 	for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_interrupt_v2()
3408 			snd_ctl_notify(mixer->chip->card, SNDRV_CTL_EVENT_MASK_VALUE,  in snd_usb_mixer_interrupt_v2()
3421 			usb_audio_dbg(mixer->chip,  in snd_usb_mixer_interrupt_v2()
3431 	struct usb_mixer_interface *mixer = urb->context;  in snd_usb_mixer_interrupt()  local
3438 	if (mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_interrupt()
3454 				snd_usb_mixer_rc_memory_change(mixer, status->bOriginator);  in snd_usb_mixer_interrupt()
3456 				snd_usb_mixer_notify_id(mixer, status->bOriginator);  in snd_usb_mixer_interrupt()
3469 			snd_usb_mixer_interrupt_v2(mixer, msg->bAttribute,  in snd_usb_mixer_interrupt()
3479 		urb->dev = mixer->chip->dev;  in snd_usb_mixer_interrupt()
3485 static int snd_usb_mixer_status_create(struct usb_mixer_interface *mixer)  in snd_usb_mixer_status_create()  argument
3493 	if (get_iface_desc(mixer->hostif)->bNumEndpoints < 1)  in snd_usb_mixer_status_create()
3495 	ep = get_endpoint(mixer->hostif, 0);  in snd_usb_mixer_status_create()
3504 	mixer->urb = usb_alloc_urb(0, GFP_KERNEL);  in snd_usb_mixer_status_create()
3505 	if (!mixer->urb) {  in snd_usb_mixer_status_create()
3509 	usb_fill_int_urb(mixer->urb, mixer->chip->dev,  in snd_usb_mixer_status_create()
3510 			 usb_rcvintpipe(mixer->chip->dev, epnum),  in snd_usb_mixer_status_create()
3512 			 snd_usb_mixer_interrupt, mixer, ep->bInterval);  in snd_usb_mixer_status_create()
3513 	usb_submit_urb(mixer->urb, GFP_KERNEL);  in snd_usb_mixer_status_create()
3522 	struct usb_mixer_interface *mixer;  in snd_usb_create_mixer()  local
3525 	strcpy(chip->card->mixername, "USB Mixer");  in snd_usb_create_mixer()
3527 	mixer = kzalloc(sizeof(*mixer), GFP_KERNEL);  in snd_usb_create_mixer()
3528 	if (!mixer)  in snd_usb_create_mixer()
3530 	mixer->chip = chip;  in snd_usb_create_mixer()
3531 	mixer->ignore_ctl_error = !!(chip->quirk_flags & QUIRK_FLAG_IGNORE_CTL_ERROR);  in snd_usb_create_mixer()
3532 	mixer->id_elems = kcalloc(MAX_ID_ELEMS, sizeof(*mixer->id_elems),  in snd_usb_create_mixer()
3534 	if (!mixer->id_elems) {  in snd_usb_create_mixer()
3535 		kfree(mixer);  in snd_usb_create_mixer()
3539 	mixer->hostif = &usb_ifnum_to_if(chip->dev, ctrlif)->altsetting[0];  in snd_usb_create_mixer()
3540 	switch (get_iface_desc(mixer->hostif)->bInterfaceProtocol) {  in snd_usb_create_mixer()
3543 		mixer->protocol = UAC_VERSION_1;  in snd_usb_create_mixer()
3546 		mixer->protocol = UAC_VERSION_2;  in snd_usb_create_mixer()
3549 		mixer->protocol = UAC_VERSION_3;  in snd_usb_create_mixer()
3553 	if (mixer->protocol == UAC_VERSION_3 &&  in snd_usb_create_mixer()
3555 		err = snd_usb_mixer_controls_badd(mixer, ctrlif);  in snd_usb_create_mixer()
3559 		err = snd_usb_mixer_controls(mixer);  in snd_usb_create_mixer()
3564 	err = snd_usb_mixer_status_create(mixer);  in snd_usb_create_mixer()
3568 	err = snd_usb_mixer_apply_create_quirk(mixer);  in snd_usb_create_mixer()
3572 	err = snd_device_new(chip->card, SNDRV_DEV_CODEC, mixer, &dev_ops);  in snd_usb_create_mixer()
3580 	list_add(&mixer->list, &chip->mixer_list);  in snd_usb_create_mixer()
3584 	snd_usb_mixer_free(mixer);  in snd_usb_create_mixer()
3588 void snd_usb_mixer_disconnect(struct usb_mixer_interface *mixer)  in snd_usb_mixer_disconnect()  argument
3590 	if (mixer->disconnected)  in snd_usb_mixer_disconnect()
3592 	if (mixer->urb)  in snd_usb_mixer_disconnect()
3593 		usb_kill_urb(mixer->urb);  in snd_usb_mixer_disconnect()
3594 	if (mixer->rc_urb)  in snd_usb_mixer_disconnect()
3595 		usb_kill_urb(mixer->rc_urb);  in snd_usb_mixer_disconnect()
3596 	if (mixer->private_free)  in snd_usb_mixer_disconnect()
3597 		mixer->private_free(mixer);  in snd_usb_mixer_disconnect()
3598 	mixer->disconnected = true;  in snd_usb_mixer_disconnect()
3602 /* stop any bus activity of a mixer */
3603 static void snd_usb_mixer_inactivate(struct usb_mixer_interface *mixer)  in snd_usb_mixer_inactivate()  argument
3605 	usb_kill_urb(mixer->urb);  in snd_usb_mixer_inactivate()
3606 	usb_kill_urb(mixer->rc_urb);  in snd_usb_mixer_inactivate()
3609 static int snd_usb_mixer_activate(struct usb_mixer_interface *mixer)  in snd_usb_mixer_activate()  argument
3613 	if (mixer->urb) {  in snd_usb_mixer_activate()
3614 		err = usb_submit_urb(mixer->urb, GFP_NOIO);  in snd_usb_mixer_activate()
3622 int snd_usb_mixer_suspend(struct usb_mixer_interface *mixer)  in snd_usb_mixer_suspend()  argument
3624 	snd_usb_mixer_inactivate(mixer);  in snd_usb_mixer_suspend()
3625 	if (mixer->private_suspend)  in snd_usb_mixer_suspend()
3626 		mixer->private_suspend(mixer);  in snd_usb_mixer_suspend()
3663 int snd_usb_mixer_resume(struct usb_mixer_interface *mixer)  in snd_usb_mixer_resume()  argument
3668 	/* restore cached mixer values */  in snd_usb_mixer_resume()
3670 		for_each_mixer_elem(list, mixer, id) {  in snd_usb_mixer_resume()
3679 	snd_usb_mixer_resume_quirk(mixer);  in snd_usb_mixer_resume()
3681 	return snd_usb_mixer_activate(mixer);  in snd_usb_mixer_resume()
3686 				 struct usb_mixer_interface *mixer,  in snd_usb_mixer_elem_init_std()  argument
3689 	list->mixer = mixer;  in snd_usb_mixer_elem_init_std()