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