1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __USBMIXER_H 3 #define __USBMIXER_H 4 5 #include <sound/info.h> 6 7 struct media_mixer_ctl; 8 9 struct usbmix_connector_map { 10 u8 id; 11 u8 delegated_id; 12 u8 control; 13 u8 channel; 14 }; 15 16 struct usb_mixer_interface { 17 struct snd_usb_audio *chip; 18 struct usb_host_interface *hostif; 19 struct list_head list; 20 unsigned int ignore_ctl_error; 21 struct urb *urb; 22 /* array[MAX_ID_ELEMS], indexed by unit id */ 23 struct usb_mixer_elem_list **id_elems; 24 25 /* the usb audio specification version this interface complies to */ 26 int protocol; 27 28 /* optional connector delegation map */ 29 const struct usbmix_connector_map *connector_map; 30 31 /* Sound Blaster remote control stuff */ 32 const struct rc_config *rc_cfg; 33 u32 rc_code; 34 wait_queue_head_t rc_waitq; 35 struct urb *rc_urb; 36 struct usb_ctrlrequest *rc_setup_packet; 37 u8 rc_buffer[6]; 38 struct media_mixer_ctl *media_mixer_ctl; 39 40 bool disconnected; 41 42 void *private_data; 43 void (*private_free)(struct usb_mixer_interface *mixer); 44 void (*private_suspend)(struct usb_mixer_interface *mixer); 45 }; 46 47 #define MAX_CHANNELS 16 /* max logical channels */ 48 49 enum { 50 USB_MIXER_BOOLEAN, 51 USB_MIXER_INV_BOOLEAN, 52 USB_MIXER_S8, 53 USB_MIXER_U8, 54 USB_MIXER_S16, 55 USB_MIXER_U16, 56 USB_MIXER_S32, 57 USB_MIXER_U32, 58 USB_MIXER_BESPOKEN, /* non-standard type */ 59 }; 60 61 typedef void (*usb_mixer_elem_dump_func_t)(struct snd_info_buffer *buffer, 62 struct usb_mixer_elem_list *list); 63 typedef int (*usb_mixer_elem_resume_func_t)(struct usb_mixer_elem_list *elem); 64 65 struct usb_mixer_elem_list { 66 struct usb_mixer_interface *mixer; 67 struct usb_mixer_elem_list *next_id_elem; /* list of controls with same id */ 68 struct snd_kcontrol *kctl; 69 unsigned int id; 70 bool is_std_info; 71 usb_mixer_elem_dump_func_t dump; 72 usb_mixer_elem_resume_func_t resume; 73 usb_mixer_elem_resume_func_t reset_resume; 74 }; 75 76 /* iterate over mixer element list of the given unit id */ 77 #define for_each_mixer_elem(list, mixer, id) \ 78 for ((list) = (mixer)->id_elems[id]; (list); (list) = (list)->next_id_elem) 79 #define mixer_elem_list_to_info(list) \ 80 container_of(list, struct usb_mixer_elem_info, head) 81 82 struct usb_mixer_elem_info { 83 struct usb_mixer_elem_list head; 84 unsigned int control; /* CS or ICN (high byte) */ 85 unsigned int cmask; /* channel mask bitmap: 0 = master */ 86 unsigned int idx_off; /* Control index offset */ 87 unsigned int ch_readonly; 88 unsigned int master_readonly; 89 int channels; 90 int val_type; 91 int min, max, res; 92 int dBmin, dBmax; 93 int cached; 94 int cache_val[MAX_CHANNELS]; 95 u8 initialized; 96 u8 min_mute; 97 void *private_data; 98 }; 99 100 int snd_usb_create_mixer(struct snd_usb_audio *chip, int ctrlif, 101 int ignore_error); 102 void snd_usb_mixer_disconnect(struct usb_mixer_interface *mixer); 103 104 void snd_usb_mixer_notify_id(struct usb_mixer_interface *mixer, int unitid); 105 106 int snd_usb_mixer_set_ctl_value(struct usb_mixer_elem_info *cval, 107 int request, int validx, int value_set); 108 109 int snd_usb_mixer_add_list(struct usb_mixer_elem_list *list, 110 struct snd_kcontrol *kctl, 111 bool is_std_info); 112 113 #define snd_usb_mixer_add_control(list, kctl) \ 114 snd_usb_mixer_add_list(list, kctl, true) 115 116 void snd_usb_mixer_elem_init_std(struct usb_mixer_elem_list *list, 117 struct usb_mixer_interface *mixer, 118 int unitid); 119 120 int snd_usb_mixer_vol_tlv(struct snd_kcontrol *kcontrol, int op_flag, 121 unsigned int size, unsigned int __user *_tlv); 122 123 #ifdef CONFIG_PM 124 int snd_usb_mixer_suspend(struct usb_mixer_interface *mixer); 125 int snd_usb_mixer_resume(struct usb_mixer_interface *mixer, bool reset_resume); 126 #endif 127 128 int snd_usb_set_cur_mix_value(struct usb_mixer_elem_info *cval, int channel, 129 int index, int value); 130 131 int snd_usb_get_cur_mix_value(struct usb_mixer_elem_info *cval, 132 int channel, int index, int *value); 133 134 extern void snd_usb_mixer_elem_free(struct snd_kcontrol *kctl); 135 136 extern const struct snd_kcontrol_new *snd_usb_feature_unit_ctl; 137 138 #endif /* __USBMIXER_H */ 139