xref: /linux/sound/pci/hda/hda_jack.h (revision c4ee0af3fa0dc65f690fc908f02b8355f9576ea0)
1 /*
2  * Jack-detection handling for HD-audio
3  *
4  * Copyright (c) 2011 Takashi Iwai <tiwai@suse.de>
5  *
6  * This driver is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  */
11 
12 #ifndef __SOUND_HDA_JACK_H
13 #define __SOUND_HDA_JACK_H
14 
15 struct auto_pin_cfg;
16 struct hda_jack_tbl;
17 
18 typedef void (*hda_jack_callback) (struct hda_codec *, struct hda_jack_tbl *);
19 
20 struct hda_jack_tbl {
21 	hda_nid_t nid;
22 	unsigned char action;		/* event action (0 = none) */
23 	unsigned char tag;		/* unsol event tag */
24 	unsigned int private_data;	/* arbitrary data */
25 	hda_jack_callback callback;
26 	/* jack-detection stuff */
27 	unsigned int pin_sense;		/* cached pin-sense value */
28 	unsigned int jack_detect:1;	/* capable of jack-detection? */
29 	unsigned int jack_dirty:1;	/* needs to update? */
30 	unsigned int phantom_jack:1;    /* a fixed, always present port? */
31 	unsigned int block_report:1;    /* in a transitional state - do not report to userspace */
32 	hda_nid_t gating_jack;		/* valid when gating jack plugged */
33 	hda_nid_t gated_jack;		/* gated is dependent on this jack */
34 	struct snd_kcontrol *kctl;	/* assigned kctl for jack-detection */
35 #ifdef CONFIG_SND_HDA_INPUT_JACK
36 	int type;
37 	struct snd_jack *jack;
38 #endif
39 };
40 
41 struct hda_jack_tbl *
42 snd_hda_jack_tbl_get(struct hda_codec *codec, hda_nid_t nid);
43 struct hda_jack_tbl *
44 snd_hda_jack_tbl_get_from_tag(struct hda_codec *codec, unsigned char tag);
45 
46 struct hda_jack_tbl *
47 snd_hda_jack_tbl_new(struct hda_codec *codec, hda_nid_t nid);
48 void snd_hda_jack_tbl_clear(struct hda_codec *codec);
49 
50 /**
51  * snd_hda_jack_get_action - get jack-tbl entry for the tag
52  *
53  * Call this from the unsol event handler to get the assigned action for the
54  * event.  This will mark the dirty flag for the later reporting, too.
55  */
56 static inline unsigned char
57 snd_hda_jack_get_action(struct hda_codec *codec, unsigned int tag)
58 {
59 	struct hda_jack_tbl *jack = snd_hda_jack_tbl_get_from_tag(codec, tag);
60 	if (jack) {
61 		jack->jack_dirty = 1;
62 		return jack->action;
63 	}
64 	return 0;
65 }
66 
67 void snd_hda_jack_set_dirty_all(struct hda_codec *codec);
68 
69 int snd_hda_jack_detect_enable(struct hda_codec *codec, hda_nid_t nid,
70 			       unsigned char action);
71 int snd_hda_jack_detect_enable_callback(struct hda_codec *codec, hda_nid_t nid,
72 					unsigned char action,
73 					hda_jack_callback cb);
74 
75 int snd_hda_jack_set_gating_jack(struct hda_codec *codec, hda_nid_t gated_nid,
76 				 hda_nid_t gating_nid);
77 
78 u32 snd_hda_pin_sense(struct hda_codec *codec, hda_nid_t nid);
79 
80 /* the jack state returned from snd_hda_jack_detect_state() */
81 enum {
82 	HDA_JACK_NOT_PRESENT, HDA_JACK_PRESENT, HDA_JACK_PHANTOM,
83 };
84 
85 int snd_hda_jack_detect_state(struct hda_codec *codec, hda_nid_t nid);
86 
87 static inline bool snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid)
88 {
89 	return snd_hda_jack_detect_state(codec, nid) != HDA_JACK_NOT_PRESENT;
90 }
91 
92 bool is_jack_detectable(struct hda_codec *codec, hda_nid_t nid);
93 
94 int snd_hda_jack_add_kctl(struct hda_codec *codec, hda_nid_t nid,
95 			  const char *name, int idx);
96 int snd_hda_jack_add_kctls(struct hda_codec *codec,
97 			   const struct auto_pin_cfg *cfg);
98 
99 void snd_hda_jack_report_sync(struct hda_codec *codec);
100 
101 void snd_hda_jack_unsol_event(struct hda_codec *codec, unsigned int res);
102 
103 void snd_hda_jack_poll_all(struct hda_codec *codec);
104 
105 #endif /* __SOUND_HDA_JACK_H */
106