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))
299  * retrieve a mixer value
302 static inline int mixer_ctrl_intf(struct usb_mixer_interface *mixer)  in mixer_ctrl_intf()  argument
304 	return get_iface_desc(mixer->hostif)->bInterfaceNumber;  in mixer_ctrl_intf()
310 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in get_ctl_value_v1()
321 		idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in get_ctl_value_v1()
346 	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()
411 	return (cval->head.mixer->protocol == UAC_VERSION_1) ?  in get_ctl_value()
442 		if (!cval->head.mixer->ignore_ctl_error)  in snd_usb_get_cur_mix_value()
443 			usb_audio_dbg(cval->head.mixer->chip,  in snd_usb_get_cur_mix_value()
454  * set a mixer value
460 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in snd_usb_mixer_set_ctl_value()
467 	if (cval->head.mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_set_ctl_value()
492 		idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in snd_usb_mixer_set_ctl_value()
528 		usb_audio_dbg(cval->head.mixer->chip,  in snd_usb_set_cur_mix_value()
545  * TLV callback for mixer volume controls
573  * used for mixer unit parser
593 	struct usb_mixer_interface *mixer = list->mixer;  in snd_usb_mixer_add_list()  local
596 	while (snd_ctl_find_id(mixer->chip->card, &kctl->id))  in snd_usb_mixer_add_list()
598 	err = snd_ctl_add(mixer->chip->card, kctl);  in snd_usb_mixer_add_list()
600 		usb_audio_dbg(mixer->chip, "cannot add control (err = %d)\n",  in snd_usb_mixer_add_list()
606 	list->next_id_elem = mixer->id_elems[list->id];  in snd_usb_mixer_add_list()
607 	mixer->id_elems[list->id] = list;  in snd_usb_mixer_add_list()
686 			strcpy(name, "Mixer");  in get_term_name()
731 			snd_usb_ctrl_intf(state->mixer->hostif),  in get_cluster_channels_v3()
748  * Get number of channels for a Mixer Unit.
755 	switch (state->mixer->protocol) {  in uac_mixer_unit_get_channels()
849 	int protocol = state->mixer->protocol;  in parse_term_mixer_unit()
878 	if (state->mixer->protocol != UAC_VERSION_3)  in parse_term_selector_unit()
888 	int protocol = state->mixer->protocol;  in parse_term_proc_unit()
960 	int protocol = state->mixer->protocol;  in __check_input_term()
1079  * interface to ALSA control for feature/mixer units
1086 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in volume_control_quirks()
1197 /* forcibly initialize the current mixer value; if GET_CUR fails, set to
1207 	if (!cval->head.mixer->ignore_ctl_error)  in init_cur_mix_raw()
1208 		usb_audio_warn(cval->head.mixer->chip,  in init_cur_mix_raw()
1210 			       cval->head.id, mixer_ctrl_intf(cval->head.mixer),  in init_cur_mix_raw()
1243 			usb_audio_err(cval->head.mixer->chip,  in get_min_max_with_quirks()
1245 				   cval->head.id, mixer_ctrl_intf(cval->head.mixer),  in get_min_max_with_quirks()
1253 		} else if (cval->head.mixer->protocol == UAC_VERSION_1) {  in get_min_max_with_quirks()
1327 			usb_audio_info(cval->head.mixer->chip,  in get_min_max_with_quirks()
1329 				       cval->head.id, mixer_ctrl_intf(cval->head.mixer),  in get_min_max_with_quirks()
1366 /* get a feature/mixer unit info */
1386 				snd_ctl_notify(cval->head.mixer->chip->card,  in mixer_ctl_feature_info()
1398 /* get the current value from feature/mixer unit */
1430 /* put the current value to feature/mixer unit */
1492 	struct snd_usb_audio *chip = cval->head.mixer->chip;  in get_connector_value()
1501 	idx = mixer_ctrl_intf(cval->head.mixer) | (cval->head.id << 8);  in get_connector_value()
1502 	if (cval->head.mixer->protocol == UAC_VERSION_2) {  in get_connector_value()
1598  * This symbol is exported in order to allow the mixer quirks to
1612  * A lot of headsets/headphones have a "Speaker" mixer. Make sure we
1650 static void __build_feature_ctl(struct usb_mixer_interface *mixer,  in __build_feature_ctl()  argument
1677 	snd_usb_mixer_elem_init_std(&cval->head, mixer, unitid);  in __build_feature_ctl()
1686 	if (mixer->protocol == UAC_VERSION_1)  in __build_feature_ctl()
1715 		usb_audio_err(mixer->chip, "cannot malloc kcontrol\n");  in __build_feature_ctl()
1724 		len = snd_usb_copy_string_desc(mixer->chip, nameid,  in __build_feature_ctl()
1740 				len = get_term_name(mixer->chip, iterm,  in __build_feature_ctl()
1744 				len = get_term_name(mixer->chip, oterm,  in __build_feature_ctl()
1753 			check_no_speaker_on_headset(kctl, mixer->chip->card);  in __build_feature_ctl()
1781 		usb_audio_dbg(mixer->chip,  in __build_feature_ctl()
1799 	snd_usb_mixer_fu_apply_quirk(mixer, cval, unitid, kctl);  in __build_feature_ctl()
1808 		usb_audio_warn(mixer->chip,  in __build_feature_ctl()
1811 		usb_audio_warn(mixer->chip,  in __build_feature_ctl()
1817 	usb_audio_dbg(mixer->chip, "[%d] FU [%s] ch = %d, val = %d/%d/%d\n",  in __build_feature_ctl()
1831 	__build_feature_ctl(state->mixer, state->map, ctl_mask, control,  in build_feature_ctl()
1835 static void build_feature_ctl_badd(struct usb_mixer_interface *mixer,  in build_feature_ctl_badd()  argument
1839 	__build_feature_ctl(mixer, badd_map, ctl_mask, control,  in build_feature_ctl_badd()
1843 static void get_connector_control_name(struct usb_mixer_interface *mixer,  in get_connector_control_name()  argument
1847 	int name_len = get_term_name(mixer->chip, term, name, name_size, 0);  in get_connector_control_name()
1872 /* Build a mixer control for a UAC connector control (jack-detect) */
1873 static void build_connector_control(struct usb_mixer_interface *mixer,  in build_connector_control()  argument
1888 	snd_usb_mixer_elem_init_std(&cval->head, mixer, term->id);  in build_connector_control()
1903 	if (mixer->protocol == UAC_VERSION_2)  in build_connector_control()
1914 		usb_audio_err(mixer->chip, "cannot malloc kcontrol\n");  in build_connector_control()
1922 		get_connector_control_name(mixer, term, is_input, kctl->id.name,  in build_connector_control()
1936 	if (state->mixer->protocol != UAC_VERSION_2)  in parse_clock_source_unit()
1951 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, hdr->bClockID);  in parse_clock_source_unit()
1995 	if (state->mixer->protocol == UAC_VERSION_1) {  in parse_audio_feature_unit()
1999 	} else if (state->mixer->protocol == UAC_VERSION_2) {  in parse_audio_feature_unit()
2047 	if (state->mixer->protocol == UAC_VERSION_1) {  in parse_audio_feature_unit()
2120  * Mixer Unit
2149  * build a mixer unit control
2172 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in build_mixer_unit_ctl()
2176 		__u8 *c = uac_mixer_unit_bmControls(desc, state->mixer->protocol);  in build_mixer_unit_ctl()
2200 		snprintf(kctl->id.name, sizeof(kctl->id.name), "Mixer Source %d", in_ch + 1);  in build_mixer_unit_ctl()
2215 	if (state->mixer->protocol == UAC_VERSION_2) {  in parse_audio_input_terminal()
2220 	} else if (state->mixer->protocol == UAC_VERSION_3) {  in parse_audio_input_terminal()
2234 		build_connector_control(state->mixer, state->map, &iterm, true);  in parse_audio_input_terminal()
2240  * parse a mixer unit
2253 			      "invalid MIXER UNIT descriptor %d\n",  in parse_audio_mixer_unit()
2274 		if (mixer_bitmap_overflow(desc, state->mixer->protocol,  in parse_audio_mixer_unit()
2282 						state->mixer->protocol);  in parse_audio_mixer_unit()
2501 		__u8 *controls = uac_processing_unit_bmControls(desc, state->mixer->protocol);  in build_audio_procunit()
2503 		if (state->mixer->protocol == UAC_VERSION_1) {  in build_audio_procunit()
2519 		snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in build_audio_procunit()
2524 		if (state->mixer->protocol > UAC_VERSION_1 &&  in build_audio_procunit()
2534 			switch (state->mixer->protocol) {  in build_audio_procunit()
2549 								state->mixer->protocol);  in build_audio_procunit()
2594 				nameid = uac_extension_unit_iExtension(desc, state->mixer->protocol);  in build_audio_procunit()
2596 				nameid = uac_processing_unit_iProcessing(desc, state->mixer->protocol);  in build_audio_procunit()
2624 	switch (state->mixer->protocol) {  in parse_audio_processing_unit()
2765 	snd_usb_mixer_elem_init_std(&cval->head, state->mixer, unitid);  in parse_audio_selector_unit()
2773 	switch (state->mixer->protocol) {  in parse_audio_selector_unit()
2823 		switch (state->mixer->protocol) {  in parse_audio_selector_unit()
2877 	int protocol = state->mixer->protocol;  in parse_audio_unit()
2934 static void snd_usb_mixer_free(struct usb_mixer_interface *mixer)  in snd_usb_mixer_free()  argument
2937 	snd_usb_mixer_disconnect(mixer);  in snd_usb_mixer_free()
2939 	kfree(mixer->id_elems);  in snd_usb_mixer_free()
2940 	if (mixer->urb) {  in snd_usb_mixer_free()
2941 		kfree(mixer->urb->transfer_buffer);  in snd_usb_mixer_free()
2942 		usb_free_urb(mixer->urb);  in snd_usb_mixer_free()
2944 	usb_free_urb(mixer->rc_urb);  in snd_usb_mixer_free()
2945 	kfree(mixer->rc_setup_packet);  in snd_usb_mixer_free()
2946 	kfree(mixer);  in snd_usb_mixer_free()
2951 	struct usb_mixer_interface *mixer = device->device_data;  in snd_usb_mixer_dev_free()  local
2952 	snd_usb_mixer_free(mixer);  in snd_usb_mixer_dev_free()
3025 static bool uac3_badd_func_has_valid_channels(struct usb_mixer_interface *mixer,  in uac3_badd_func_has_valid_channels()  argument
3035 			usb_audio_warn(mixer->chip, "BAAD %s: no channels?",  in uac3_badd_func_has_valid_channels()
3044 		usb_audio_warn(mixer->chip, "BAAD %s c_chmask mismatch",  in uac3_badd_func_has_valid_channels()
3050 		usb_audio_warn(mixer->chip, "BAAD %s p_chmask mismatch",  in uac3_badd_func_has_valid_channels()
3058  * create mixer controls for UAC3 BADD profiles
3062  * BADD device may contain Mixer Unit, which doesn't have any controls, skip it
3064 static int snd_usb_mixer_controls_badd(struct usb_mixer_interface *mixer,  in snd_usb_mixer_controls_badd()  argument
3067 	struct usb_device *dev = mixer->chip->dev;  in snd_usb_mixer_controls_badd()
3069 	int badd_profile = mixer->chip->badd_profile;  in snd_usb_mixer_controls_badd()
3119 			usb_audio_err(mixer->chip,  in snd_usb_mixer_controls_badd()
3143 	usb_audio_dbg(mixer->chip,  in snd_usb_mixer_controls_badd()
3162 	if (!uac3_badd_func_has_valid_channels(mixer, f, c_chmask, p_chmask))  in snd_usb_mixer_controls_badd()
3169 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3172 		build_feature_ctl_badd(mixer, p_chmask, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3179 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3182 		build_feature_ctl_badd(mixer, c_chmask, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3189 		build_feature_ctl_badd(mixer, 0, UAC_FU_MUTE,  in snd_usb_mixer_controls_badd()
3192 		build_feature_ctl_badd(mixer, 1, UAC_FU_VOLUME,  in snd_usb_mixer_controls_badd()
3204 		build_connector_control(mixer, map->map, &iterm, true);  in snd_usb_mixer_controls_badd()
3210 		build_connector_control(mixer, map->map, &oterm, false);  in snd_usb_mixer_controls_badd()
3217  * create mixer controls
3221 static int snd_usb_mixer_controls(struct usb_mixer_interface *mixer)  in snd_usb_mixer_controls()  argument
3229 	state.chip = mixer->chip;  in snd_usb_mixer_controls()
3230 	state.mixer = mixer;  in snd_usb_mixer_controls()
3231 	state.buffer = mixer->hostif->extra;  in snd_usb_mixer_controls()
3232 	state.buflen = mixer->hostif->extralen;  in snd_usb_mixer_controls()
3239 			mixer->connector_map = map->connector_map;  in snd_usb_mixer_controls()
3245 	while ((p = snd_usb_find_csint_desc(mixer->hostif->extra,  in snd_usb_mixer_controls()
3246 					    mixer->hostif->extralen,  in snd_usb_mixer_controls()
3248 		if (!snd_usb_validate_audio_desc(p, mixer->protocol))  in snd_usb_mixer_controls()
3251 		if (mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_controls()
3262 		} else if (mixer->protocol == UAC_VERSION_2) {  in snd_usb_mixer_controls()
3285 				build_connector_control(state.mixer, state.map,  in snd_usb_mixer_controls()
3311 				build_connector_control(state.mixer, state.map,  in snd_usb_mixer_controls()
3320 static int delegate_notify(struct usb_mixer_interface *mixer, int unitid,  in delegate_notify()  argument
3323 	const struct usbmix_connector_map *map = mixer->connector_map;  in delegate_notify()
3340 void snd_usb_mixer_notify_id(struct usb_mixer_interface *mixer, int unitid)  in snd_usb_mixer_notify_id()  argument
3344 	unitid = delegate_notify(mixer, unitid, NULL, NULL);  in snd_usb_mixer_notify_id()
3346 	for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_notify_id()
3354 		snd_ctl_notify(mixer->chip->card, SNDRV_CTL_EVENT_MASK_VALUE,  in snd_usb_mixer_notify_id()
3386 	struct usb_mixer_interface *mixer;  in snd_usb_mixer_proc_read()  local
3390 	list_for_each_entry(mixer, &chip->mixer_list, list) {  in snd_usb_mixer_proc_read()
3392 			"USB Mixer: usb_id=0x%08x, ctrlif=%i, ctlerr=%i\n",  in snd_usb_mixer_proc_read()
3393 				chip->usb_id, mixer_ctrl_intf(mixer),  in snd_usb_mixer_proc_read()
3394 				mixer->ignore_ctl_error);  in snd_usb_mixer_proc_read()
3397 			for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_proc_read()
3411 static void snd_usb_mixer_interrupt_v2(struct usb_mixer_interface *mixer,  in snd_usb_mixer_interrupt_v2()  argument
3421 		usb_audio_dbg(mixer->chip,  in snd_usb_mixer_interrupt_v2()
3427 	unitid = delegate_notify(mixer, unitid, &control, &channel);  in snd_usb_mixer_interrupt_v2()
3429 	for_each_mixer_elem(list, mixer, unitid)  in snd_usb_mixer_interrupt_v2()
3435 	for_each_mixer_elem(list, mixer, unitid) {  in snd_usb_mixer_interrupt_v2()
3455 			snd_ctl_notify(mixer->chip->card, SNDRV_CTL_EVENT_MASK_VALUE,  in snd_usb_mixer_interrupt_v2()
3468 			usb_audio_dbg(mixer->chip,  in snd_usb_mixer_interrupt_v2()
3478 	struct usb_mixer_interface *mixer = urb->context;  in snd_usb_mixer_interrupt()  local
3485 	if (mixer->protocol == UAC_VERSION_1) {  in snd_usb_mixer_interrupt()
3501 				snd_usb_mixer_rc_memory_change(mixer, status->bOriginator);  in snd_usb_mixer_interrupt()
3503 				snd_usb_mixer_notify_id(mixer, status->bOriginator);  in snd_usb_mixer_interrupt()
3516 			snd_usb_mixer_interrupt_v2(mixer, msg->bAttribute,  in snd_usb_mixer_interrupt()
3526 		urb->dev = mixer->chip->dev;  in snd_usb_mixer_interrupt()
3532 static int snd_usb_mixer_status_create(struct usb_mixer_interface *mixer)  in snd_usb_mixer_status_create()  argument
3540 	if (get_iface_desc(mixer->hostif)->bNumEndpoints < 1)  in snd_usb_mixer_status_create()
3542 	ep = get_endpoint(mixer->hostif, 0);  in snd_usb_mixer_status_create()
3551 	mixer->urb = usb_alloc_urb(0, GFP_KERNEL);  in snd_usb_mixer_status_create()
3552 	if (!mixer->urb) {  in snd_usb_mixer_status_create()
3556 	usb_fill_int_urb(mixer->urb, mixer->chip->dev,  in snd_usb_mixer_status_create()
3557 			 usb_rcvintpipe(mixer->chip->dev, epnum),  in snd_usb_mixer_status_create()
3559 			 snd_usb_mixer_interrupt, mixer, ep->bInterval);  in snd_usb_mixer_status_create()
3560 	usb_submit_urb(mixer->urb, GFP_KERNEL);  in snd_usb_mixer_status_create()
3569 	struct usb_mixer_interface *mixer;  in snd_usb_create_mixer()  local
3572 	strcpy(chip->card->mixername, "USB Mixer");  in snd_usb_create_mixer()
3574 	mixer = kzalloc(sizeof(*mixer), GFP_KERNEL);  in snd_usb_create_mixer()
3575 	if (!mixer)  in snd_usb_create_mixer()
3577 	mixer->chip = chip;  in snd_usb_create_mixer()
3578 	mixer->ignore_ctl_error = !!(chip->quirk_flags & QUIRK_FLAG_IGNORE_CTL_ERROR);  in snd_usb_create_mixer()
3579 	mixer->id_elems = kcalloc(MAX_ID_ELEMS, sizeof(*mixer->id_elems),  in snd_usb_create_mixer()
3581 	if (!mixer->id_elems) {  in snd_usb_create_mixer()
3582 		kfree(mixer);  in snd_usb_create_mixer()
3586 	mixer->hostif = &usb_ifnum_to_if(chip->dev, ctrlif)->altsetting[0];  in snd_usb_create_mixer()
3587 	switch (get_iface_desc(mixer->hostif)->bInterfaceProtocol) {  in snd_usb_create_mixer()
3590 		mixer->protocol = UAC_VERSION_1;  in snd_usb_create_mixer()
3593 		mixer->protocol = UAC_VERSION_2;  in snd_usb_create_mixer()
3596 		mixer->protocol = UAC_VERSION_3;  in snd_usb_create_mixer()
3600 	if (mixer->protocol == UAC_VERSION_3 &&  in snd_usb_create_mixer()
3602 		err = snd_usb_mixer_controls_badd(mixer, ctrlif);  in snd_usb_create_mixer()
3606 		err = snd_usb_mixer_controls(mixer);  in snd_usb_create_mixer()
3611 	err = snd_usb_mixer_status_create(mixer);  in snd_usb_create_mixer()
3615 	err = snd_usb_mixer_apply_create_quirk(mixer);  in snd_usb_create_mixer()
3619 	err = snd_device_new(chip->card, SNDRV_DEV_CODEC, mixer, &dev_ops);  in snd_usb_create_mixer()
3627 	list_add(&mixer->list, &chip->mixer_list);  in snd_usb_create_mixer()
3631 	snd_usb_mixer_free(mixer);  in snd_usb_create_mixer()
3635 void snd_usb_mixer_disconnect(struct usb_mixer_interface *mixer)  in snd_usb_mixer_disconnect()  argument
3637 	if (mixer->disconnected)  in snd_usb_mixer_disconnect()
3639 	if (mixer->urb)  in snd_usb_mixer_disconnect()
3640 		usb_kill_urb(mixer->urb);  in snd_usb_mixer_disconnect()
3641 	if (mixer->rc_urb)  in snd_usb_mixer_disconnect()
3642 		usb_kill_urb(mixer->rc_urb);  in snd_usb_mixer_disconnect()
3643 	if (mixer->private_free)  in snd_usb_mixer_disconnect()
3644 		mixer->private_free(mixer);  in snd_usb_mixer_disconnect()
3645 	mixer->disconnected = true;  in snd_usb_mixer_disconnect()
3648 /* stop any bus activity of a mixer */
3649 static void snd_usb_mixer_inactivate(struct usb_mixer_interface *mixer)  in snd_usb_mixer_inactivate()  argument
3651 	usb_kill_urb(mixer->urb);  in snd_usb_mixer_inactivate()
3652 	usb_kill_urb(mixer->rc_urb);  in snd_usb_mixer_inactivate()
3655 static int snd_usb_mixer_activate(struct usb_mixer_interface *mixer)  in snd_usb_mixer_activate()  argument
3659 	if (mixer->urb) {  in snd_usb_mixer_activate()
3660 		err = usb_submit_urb(mixer->urb, GFP_NOIO);  in snd_usb_mixer_activate()
3668 int snd_usb_mixer_suspend(struct usb_mixer_interface *mixer)  in snd_usb_mixer_suspend()  argument
3670 	snd_usb_mixer_inactivate(mixer);  in snd_usb_mixer_suspend()
3671 	if (mixer->private_suspend)  in snd_usb_mixer_suspend()
3672 		mixer->private_suspend(mixer);  in snd_usb_mixer_suspend()
3706 int snd_usb_mixer_resume(struct usb_mixer_interface *mixer)  in snd_usb_mixer_resume()  argument
3711 	/* restore cached mixer values */  in snd_usb_mixer_resume()
3713 		for_each_mixer_elem(list, mixer, id) {  in snd_usb_mixer_resume()
3722 	snd_usb_mixer_resume_quirk(mixer);  in snd_usb_mixer_resume()
3724 	return snd_usb_mixer_activate(mixer);  in snd_usb_mixer_resume()
3728 				 struct usb_mixer_interface *mixer,  in snd_usb_mixer_elem_init_std()  argument
3731 	list->mixer = mixer;  in snd_usb_mixer_elem_init_std()