blob: 37e1b234c802f59fec54a6a2b067b50e45511975 [file] [log] [blame]
Greg Kroah-Hartmanb2441312017-11-01 15:07:57 +01001/* SPDX-License-Identifier: GPL-2.0 */
Daniel Mack3e1aebe2010-03-04 19:46:12 +01002#ifndef __USBMIXER_H
3#define __USBMIXER_H
4
Takashi Iwai3360b842014-11-18 11:47:04 +01005#include <sound/info.h>
6
Shuah Khan66354f12019-04-01 20:40:22 -04007struct media_mixer_ctl;
8
Daniel Mack7b1eda22010-03-11 21:13:22 +01009struct usb_mixer_interface {
10 struct snd_usb_audio *chip;
Daniel Mack1faa5d02011-08-04 15:56:28 +020011 struct usb_host_interface *hostif;
Daniel Mack7b1eda22010-03-11 21:13:22 +010012 struct list_head list;
13 unsigned int ignore_ctl_error;
14 struct urb *urb;
15 /* array[MAX_ID_ELEMS], indexed by unit id */
Takashi Iwai3360b842014-11-18 11:47:04 +010016 struct usb_mixer_elem_list **id_elems;
Daniel Mack7b1eda22010-03-11 21:13:22 +010017
Daniel Mack23caaf12010-03-11 21:13:25 +010018 /* the usb audio specification version this interface complies to */
19 int protocol;
20
Daniel Mack7b1eda22010-03-11 21:13:22 +010021 /* Sound Blaster remote control stuff */
22 const struct rc_config *rc_cfg;
23 u32 rc_code;
24 wait_queue_head_t rc_waitq;
25 struct urb *rc_urb;
26 struct usb_ctrlrequest *rc_setup_packet;
27 u8 rc_buffer[6];
Shuah Khan66354f12019-04-01 20:40:22 -040028 struct media_mixer_ctl *media_mixer_ctl;
Takashi Iwai124751d2017-10-10 14:10:32 +020029
30 bool disconnected;
Geoffrey D. Bennett9e4d5c12019-07-29 00:42:45 +093031
32 void *private_data;
33 void (*private_free)(struct usb_mixer_interface *mixer);
34 void (*private_suspend)(struct usb_mixer_interface *mixer);
Daniel Mack7b1eda22010-03-11 21:13:22 +010035};
36
Daniel Mack9e386582011-05-25 09:09:01 +020037#define MAX_CHANNELS 16 /* max logical channels */
38
39enum {
40 USB_MIXER_BOOLEAN,
41 USB_MIXER_INV_BOOLEAN,
42 USB_MIXER_S8,
43 USB_MIXER_U8,
44 USB_MIXER_S16,
45 USB_MIXER_U16,
Julian Scheelbc18e312015-08-14 16:14:45 +020046 USB_MIXER_S32,
47 USB_MIXER_U32,
Daniel Mack9e386582011-05-25 09:09:01 +020048};
Daniel Mack7b1eda22010-03-11 21:13:22 +010049
Takashi Iwai3360b842014-11-18 11:47:04 +010050typedef void (*usb_mixer_elem_dump_func_t)(struct snd_info_buffer *buffer,
51 struct usb_mixer_elem_list *list);
52typedef int (*usb_mixer_elem_resume_func_t)(struct usb_mixer_elem_list *elem);
53
54struct usb_mixer_elem_list {
Daniel Mack7b1eda22010-03-11 21:13:22 +010055 struct usb_mixer_interface *mixer;
Takashi Iwai3360b842014-11-18 11:47:04 +010056 struct usb_mixer_elem_list *next_id_elem; /* list of controls with same id */
57 struct snd_kcontrol *kctl;
Daniel Mack7b1eda22010-03-11 21:13:22 +010058 unsigned int id;
Takashi Iwai3360b842014-11-18 11:47:04 +010059 usb_mixer_elem_dump_func_t dump;
60 usb_mixer_elem_resume_func_t resume;
61};
62
Takashi Iwai8c558072018-05-03 12:33:32 +020063/* iterate over mixer element list of the given unit id */
64#define for_each_mixer_elem(list, mixer, id) \
65 for ((list) = (mixer)->id_elems[id]; (list); (list) = (list)->next_id_elem)
66#define mixer_elem_list_to_info(list) \
67 container_of(list, struct usb_mixer_elem_info, head)
68
Takashi Iwai3360b842014-11-18 11:47:04 +010069struct usb_mixer_elem_info {
70 struct usb_mixer_elem_list head;
Daniel Mack7b1eda22010-03-11 21:13:22 +010071 unsigned int control; /* CS or ICN (high byte) */
72 unsigned int cmask; /* channel mask bitmap: 0 = master */
Eldad Zack9f814102012-11-28 23:55:35 +010073 unsigned int idx_off; /* Control index offset */
Daniel Macka6a33252010-05-31 13:35:37 +020074 unsigned int ch_readonly;
75 unsigned int master_readonly;
Daniel Mack7b1eda22010-03-11 21:13:22 +010076 int channels;
77 int val_type;
78 int min, max, res;
79 int dBmin, dBmax;
80 int cached;
81 int cache_val[MAX_CHANNELS];
82 u8 initialized;
Takashi Iwai0f174b32017-08-16 14:18:37 +020083 u8 min_mute;
Chris J Argesf41d6042014-11-12 12:07:00 -060084 void *private_data;
Daniel Mack7b1eda22010-03-11 21:13:22 +010085};
86
Daniel Mack3e1aebe2010-03-04 19:46:12 +010087int snd_usb_create_mixer(struct snd_usb_audio *chip, int ctrlif,
88 int ignore_error);
Takashi Iwaia6cece92014-10-31 11:24:32 +010089void snd_usb_mixer_disconnect(struct usb_mixer_interface *mixer);
Daniel Mack3e1aebe2010-03-04 19:46:12 +010090
Daniel Mack7b1eda22010-03-11 21:13:22 +010091void snd_usb_mixer_notify_id(struct usb_mixer_interface *mixer, int unitid);
92
93int snd_usb_mixer_set_ctl_value(struct usb_mixer_elem_info *cval,
94 int request, int validx, int value_set);
Daniel Mack3e1aebe2010-03-04 19:46:12 +010095
Takashi Iwai3360b842014-11-18 11:47:04 +010096int snd_usb_mixer_add_control(struct usb_mixer_elem_list *list,
Daniel Mackef9d5972011-05-25 09:09:00 +020097 struct snd_kcontrol *kctl);
98
Takashi Iwai3360b842014-11-18 11:47:04 +010099void snd_usb_mixer_elem_init_std(struct usb_mixer_elem_list *list,
100 struct usb_mixer_interface *mixer,
101 int unitid);
102
Felix Homann285de9c2012-04-23 20:24:24 +0200103int snd_usb_mixer_vol_tlv(struct snd_kcontrol *kcontrol, int op_flag,
104 unsigned int size, unsigned int __user *_tlv);
105
Takashi Iwai400362f2014-01-20 16:51:16 +0100106#ifdef CONFIG_PM
107int snd_usb_mixer_suspend(struct usb_mixer_interface *mixer);
108int snd_usb_mixer_resume(struct usb_mixer_interface *mixer, bool reset_resume);
109#endif
110
Chris J Argeseef90452014-11-12 12:07:01 -0600111int snd_usb_set_cur_mix_value(struct usb_mixer_elem_info *cval, int channel,
112 int index, int value);
113
114int snd_usb_get_cur_mix_value(struct usb_mixer_elem_info *cval,
115 int channel, int index, int *value);
116
117extern void snd_usb_mixer_elem_free(struct snd_kcontrol *kctl);
118
Takashi Iwai00966dc2018-07-25 23:00:53 +0200119extern struct snd_kcontrol_new *snd_usb_feature_unit_ctl;
120
Daniel Mack3e1aebe2010-03-04 19:46:12 +0100121#endif /* __USBMIXER_H */