xref: /linux/sound/usb/mixer.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 #ifndef __USBMIXER_H
2 #define __USBMIXER_H
3 
4 #include <sound/info.h>
5 
6 struct usb_mixer_interface {
7 	struct snd_usb_audio *chip;
8 	struct usb_host_interface *hostif;
9 	struct list_head list;
10 	unsigned int ignore_ctl_error;
11 	struct urb *urb;
12 	/* array[MAX_ID_ELEMS], indexed by unit id */
13 	struct usb_mixer_elem_list **id_elems;
14 
15 	/* the usb audio specification version this interface complies to */
16 	int protocol;
17 
18 	/* Sound Blaster remote control stuff */
19 	const struct rc_config *rc_cfg;
20 	u32 rc_code;
21 	wait_queue_head_t rc_waitq;
22 	struct urb *rc_urb;
23 	struct usb_ctrlrequest *rc_setup_packet;
24 	u8 rc_buffer[6];
25 };
26 
27 #define MAX_CHANNELS	16	/* max logical channels */
28 
29 enum {
30 	USB_MIXER_BOOLEAN,
31 	USB_MIXER_INV_BOOLEAN,
32 	USB_MIXER_S8,
33 	USB_MIXER_U8,
34 	USB_MIXER_S16,
35 	USB_MIXER_U16,
36 	USB_MIXER_S32,
37 	USB_MIXER_U32,
38 };
39 
40 typedef void (*usb_mixer_elem_dump_func_t)(struct snd_info_buffer *buffer,
41 					 struct usb_mixer_elem_list *list);
42 typedef int (*usb_mixer_elem_resume_func_t)(struct usb_mixer_elem_list *elem);
43 
44 struct usb_mixer_elem_list {
45 	struct usb_mixer_interface *mixer;
46 	struct usb_mixer_elem_list *next_id_elem; /* list of controls with same id */
47 	struct snd_kcontrol *kctl;
48 	unsigned int id;
49 	usb_mixer_elem_dump_func_t dump;
50 	usb_mixer_elem_resume_func_t resume;
51 };
52 
53 struct usb_mixer_elem_info {
54 	struct usb_mixer_elem_list head;
55 	unsigned int control;	/* CS or ICN (high byte) */
56 	unsigned int cmask; /* channel mask bitmap: 0 = master */
57 	unsigned int idx_off; /* Control index offset */
58 	unsigned int ch_readonly;
59 	unsigned int master_readonly;
60 	int channels;
61 	int val_type;
62 	int min, max, res;
63 	int dBmin, dBmax;
64 	int cached;
65 	int cache_val[MAX_CHANNELS];
66 	u8 initialized;
67 	void *private_data;
68 };
69 
70 int snd_usb_create_mixer(struct snd_usb_audio *chip, int ctrlif,
71 			 int ignore_error);
72 void snd_usb_mixer_disconnect(struct usb_mixer_interface *mixer);
73 
74 void snd_usb_mixer_notify_id(struct usb_mixer_interface *mixer, int unitid);
75 
76 int snd_usb_mixer_set_ctl_value(struct usb_mixer_elem_info *cval,
77 				int request, int validx, int value_set);
78 
79 int snd_usb_mixer_add_control(struct usb_mixer_elem_list *list,
80 			      struct snd_kcontrol *kctl);
81 
82 void snd_usb_mixer_elem_init_std(struct usb_mixer_elem_list *list,
83 				 struct usb_mixer_interface *mixer,
84 				 int unitid);
85 
86 int snd_usb_mixer_vol_tlv(struct snd_kcontrol *kcontrol, int op_flag,
87 			  unsigned int size, unsigned int __user *_tlv);
88 
89 #ifdef CONFIG_PM
90 int snd_usb_mixer_suspend(struct usb_mixer_interface *mixer);
91 int snd_usb_mixer_resume(struct usb_mixer_interface *mixer, bool reset_resume);
92 #endif
93 
94 int snd_usb_set_cur_mix_value(struct usb_mixer_elem_info *cval, int channel,
95                              int index, int value);
96 
97 int snd_usb_get_cur_mix_value(struct usb_mixer_elem_info *cval,
98                              int channel, int index, int *value);
99 
100 extern void snd_usb_mixer_elem_free(struct snd_kcontrol *kctl);
101 
102 #endif /* __USBMIXER_H */
103