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 #include <linux/err.h> 16 #include <sound/jack.h> 17 18 struct auto_pin_cfg; 19 struct hda_jack_tbl; 20 struct hda_jack_callback; 21 22 typedef void (*hda_jack_callback_fn) (struct hda_codec *, struct hda_jack_callback *); 23 24 struct hda_jack_callback { 25 hda_nid_t nid; 26 hda_jack_callback_fn func; 27 unsigned int private_data; /* arbitrary data */ 28 unsigned int unsol_res; /* unsolicited event bits */ 29 struct hda_jack_tbl *jack; /* associated jack entry */ 30 struct hda_jack_callback *next; 31 }; 32 33 struct hda_jack_tbl { 34 hda_nid_t nid; 35 unsigned char tag; /* unsol event tag */ 36 struct hda_jack_callback *callback; 37 /* jack-detection stuff */ 38 unsigned int pin_sense; /* cached pin-sense value */ 39 unsigned int jack_detect:1; /* capable of jack-detection? */ 40 unsigned int jack_dirty:1; /* needs to update? */ 41 unsigned int phantom_jack:1; /* a fixed, always present port? */ 42 unsigned int block_report:1; /* in a transitional state - do not report to userspace */ 43 hda_nid_t gating_jack; /* valid when gating jack plugged */ 44 hda_nid_t gated_jack; /* gated is dependent on this jack */ 45 int type; 46 int button_state; 47 struct snd_jack *jack; 48 }; 49 50 struct hda_jack_keymap { 51 enum snd_jack_types type; 52 int key; 53 }; 54 55 struct hda_jack_tbl * 56 snd_hda_jack_tbl_get(struct hda_codec *codec, hda_nid_t nid); 57 struct hda_jack_tbl * 58 snd_hda_jack_tbl_get_from_tag(struct hda_codec *codec, unsigned char tag); 59 60 void snd_hda_jack_tbl_clear(struct hda_codec *codec); 61 62 void snd_hda_jack_set_dirty_all(struct hda_codec *codec); 63 64 int snd_hda_jack_detect_enable(struct hda_codec *codec, hda_nid_t nid); 65 struct hda_jack_callback * 66 snd_hda_jack_detect_enable_callback(struct hda_codec *codec, hda_nid_t nid, 67 hda_jack_callback_fn cb); 68 69 int snd_hda_jack_set_gating_jack(struct hda_codec *codec, hda_nid_t gated_nid, 70 hda_nid_t gating_nid); 71 72 u32 snd_hda_pin_sense(struct hda_codec *codec, hda_nid_t nid); 73 74 /* the jack state returned from snd_hda_jack_detect_state() */ 75 enum { 76 HDA_JACK_NOT_PRESENT, HDA_JACK_PRESENT, HDA_JACK_PHANTOM, 77 }; 78 79 int snd_hda_jack_detect_state(struct hda_codec *codec, hda_nid_t nid); 80 81 /** 82 * snd_hda_jack_detect - Detect the jack 83 * @codec: the HDA codec 84 * @nid: pin NID to check jack detection 85 */ 86 static inline bool snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid) 87 { 88 return snd_hda_jack_detect_state(codec, nid) != HDA_JACK_NOT_PRESENT; 89 } 90 91 bool is_jack_detectable(struct hda_codec *codec, hda_nid_t nid); 92 93 int snd_hda_jack_add_kctl(struct hda_codec *codec, hda_nid_t nid, 94 const char *name, bool phantom_jack, 95 int type, const struct hda_jack_keymap *keymap); 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