1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 #ifndef __SOUND_JACK_H
3 #define __SOUND_JACK_H
4
5 /*
6 * Jack abstraction layer
7 *
8 * Copyright 2008 Wolfson Microelectronics plc
9 */
10
11 #include <sound/core.h>
12
13 struct input_dev;
14
15 /**
16 * enum snd_jack_types - Jack types which can be reported
17 * @SND_JACK_HEADPHONE: Headphone
18 * @SND_JACK_MICROPHONE: Microphone
19 * @SND_JACK_HEADSET: Headset
20 * @SND_JACK_LINEOUT: Line out
21 * @SND_JACK_MECHANICAL: Mechanical switch
22 * @SND_JACK_VIDEOOUT: Video out
23 * @SND_JACK_AVOUT: AV (Audio Video) out
24 * @SND_JACK_LINEIN: Line in
25 * @SND_JACK_BTN_0: Button 0
26 * @SND_JACK_BTN_1: Button 1
27 * @SND_JACK_BTN_2: Button 2
28 * @SND_JACK_BTN_3: Button 3
29 * @SND_JACK_BTN_4: Button 4
30 * @SND_JACK_BTN_5: Button 5
31 *
32 * These values are used as a bitmask.
33 *
34 * Note that this must be kept in sync with the lookup table in
35 * sound/core/jack.c.
36 */
37 enum snd_jack_types {
38 SND_JACK_HEADPHONE = 0x0001,
39 SND_JACK_MICROPHONE = 0x0002,
40 SND_JACK_HEADSET = SND_JACK_HEADPHONE | SND_JACK_MICROPHONE,
41 SND_JACK_LINEOUT = 0x0004,
42 SND_JACK_MECHANICAL = 0x0008, /* If detected separately */
43 SND_JACK_VIDEOOUT = 0x0010,
44 SND_JACK_AVOUT = SND_JACK_LINEOUT | SND_JACK_VIDEOOUT,
45 SND_JACK_LINEIN = 0x0020,
46
47 /* Kept separate from switches to facilitate implementation */
48 SND_JACK_BTN_0 = 0x4000,
49 SND_JACK_BTN_1 = 0x2000,
50 SND_JACK_BTN_2 = 0x1000,
51 SND_JACK_BTN_3 = 0x0800,
52 SND_JACK_BTN_4 = 0x0400,
53 SND_JACK_BTN_5 = 0x0200,
54 };
55
56 /* Keep in sync with definitions above */
57 #define SND_JACK_SWITCH_TYPES 6
58
59 struct snd_jack {
60 struct list_head kctl_list;
61 struct snd_card *card;
62 const char *id;
63 #ifdef CONFIG_SND_JACK_INPUT_DEV
64 struct input_dev *input_dev;
65 int registered;
66 int type;
67 char name[100];
68 unsigned int key[6]; /* Keep in sync with definitions above */
69 #endif /* CONFIG_SND_JACK_INPUT_DEV */
70 int hw_status_cache;
71 void *private_data;
72 void (*private_free)(struct snd_jack *);
73 };
74
75 #ifdef CONFIG_SND_JACK
76
77 int snd_jack_new(struct snd_card *card, const char *id, int type,
78 struct snd_jack **jack, bool initial_kctl, bool phantom_jack);
79 int snd_jack_add_new_kctl(struct snd_jack *jack, const char * name, int mask);
80 #ifdef CONFIG_SND_JACK_INPUT_DEV
81 void snd_jack_set_parent(struct snd_jack *jack, struct device *parent);
82 int snd_jack_set_key(struct snd_jack *jack, enum snd_jack_types type,
83 int keytype);
84 #endif
85 void snd_jack_report(struct snd_jack *jack, int status);
86
87 #else
snd_jack_new(struct snd_card * card,const char * id,int type,struct snd_jack ** jack,bool initial_kctl,bool phantom_jack)88 static inline int snd_jack_new(struct snd_card *card, const char *id, int type,
89 struct snd_jack **jack, bool initial_kctl, bool phantom_jack)
90 {
91 return 0;
92 }
93
snd_jack_add_new_kctl(struct snd_jack * jack,const char * name,int mask)94 static inline int snd_jack_add_new_kctl(struct snd_jack *jack, const char * name, int mask)
95 {
96 return 0;
97 }
98
snd_jack_report(struct snd_jack * jack,int status)99 static inline void snd_jack_report(struct snd_jack *jack, int status)
100 {
101 }
102
103 #endif
104
105 #if !defined(CONFIG_SND_JACK) || !defined(CONFIG_SND_JACK_INPUT_DEV)
snd_jack_set_parent(struct snd_jack * jack,struct device * parent)106 static inline void snd_jack_set_parent(struct snd_jack *jack,
107 struct device *parent)
108 {
109 }
110
snd_jack_set_key(struct snd_jack * jack,enum snd_jack_types type,int keytype)111 static inline int snd_jack_set_key(struct snd_jack *jack,
112 enum snd_jack_types type,
113 int keytype)
114 {
115 return 0;
116 }
117 #endif /* !CONFIG_SND_JACK || !CONFIG_SND_JACK_INPUT_DEV */
118
119 #endif
120