sound/pci/hda/hda_jack.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Jack-detection handling for HD-audio
   4  *
   5  * Copyright (c) 2011 Takashi Iwai <tiwai@suse.de>
   6  */
   7
   8 #ifndef __SOUND_HDA_JACK_H
   9 #define __SOUND_HDA_JACK_H
  10
  11 #include <linux/err.h>
  12 #include <sound/jack.h>
  13
  14 struct auto_pin_cfg;
  15 struct hda_jack_tbl;
  16 struct hda_jack_callback;
  17
  18 typedef void (*hda_jack_callback_fn) (struct hda_codec *, struct hda_jack_callback *);
  19
  20 struct hda_jack_callback {
  21         hda_nid_t nid;
  22         int dev_id;
  23         hda_jack_callback_fn func;
  24         unsigned int private_data;      /* arbitrary data */
  25         unsigned int unsol_res;         /* unsolicited event bits */
  26         struct hda_jack_tbl *jack;      /* associated jack entry */
  27         struct hda_jack_callback *next;
  28 };
  29
  30 struct hda_jack_tbl {
  31         hda_nid_t nid;
  32         int dev_id;
  33         unsigned char tag;              /* unsol event tag */
  34         struct hda_jack_callback *callback;
  35         /* jack-detection stuff */
  36         unsigned int pin_sense;         /* cached pin-sense value */
  37         unsigned int jack_detect:1;     /* capable of jack-detection? */
  38         unsigned int jack_dirty:1;      /* needs to update? */
  39         unsigned int phantom_jack:1;    /* a fixed, always present port? */
  40         unsigned int block_report:1;    /* in a transitional state - do not report to userspace */
  41         hda_nid_t gating_jack;          /* valid when gating jack plugged */
  42         hda_nid_t gated_jack;           /* gated is dependent on this jack */
  43         hda_nid_t key_report_jack;      /* key reports to this jack */
  44         int type;
  45         int button_state;
  46         struct snd_jack *jack;
  47 };
  48
  49 struct hda_jack_keymap {
  50         enum snd_jack_types type;
  51         int key;
  52 };
  53
  54 struct hda_jack_tbl *
  55 snd_hda_jack_tbl_get_mst(struct hda_codec *codec, hda_nid_t nid, int dev_id);
  56
  57 /**
  58  * snd_hda_jack_tbl_get - query the jack-table entry for the given NID
  59  * @codec: the HDA codec
  60  * @nid: pin NID to refer to
  61  */
  62 static inline struct hda_jack_tbl *
  63 snd_hda_jack_tbl_get(struct hda_codec *codec, hda_nid_t nid)
  64 {
  65         return snd_hda_jack_tbl_get_mst(codec, nid, 0);
  66 }
  67
  68 struct hda_jack_tbl *
  69 snd_hda_jack_tbl_get_from_tag(struct hda_codec *codec,
  70                               unsigned char tag, int dev_id);
  71
  72 void snd_hda_jack_tbl_disconnect(struct hda_codec *codec);
  73 void snd_hda_jack_tbl_clear(struct hda_codec *codec);
  74
  75 void snd_hda_jack_set_dirty_all(struct hda_codec *codec);
  76
  77 int snd_hda_jack_detect_enable(struct hda_codec *codec, hda_nid_t nid,
  78                                int dev_id);
  79
  80 struct hda_jack_callback *
  81 snd_hda_jack_detect_enable_callback_mst(struct hda_codec *codec, hda_nid_t nid,
  82                                         int dev_id, hda_jack_callback_fn func);
  83
  84 /**
  85  * snd_hda_jack_detect_enable - enable the jack-detection
  86  * @codec: the HDA codec
  87  * @nid: pin NID to enable
  88  * @func: callback function to register
  89  *
  90  * In the case of error, the return value will be a pointer embedded with
  91  * errno.  Check and handle the return value appropriately with standard
  92  * macros such as @IS_ERR() and @PTR_ERR().
  93  */
  94 static inline struct hda_jack_callback *
  95 snd_hda_jack_detect_enable_callback(struct hda_codec *codec, hda_nid_t nid,
  96                                     hda_jack_callback_fn cb)
  97 {
  98         return snd_hda_jack_detect_enable_callback_mst(codec, nid, 0, cb);
  99 }
 100
 101 int snd_hda_jack_set_gating_jack(struct hda_codec *codec, hda_nid_t gated_nid,
 102                                  hda_nid_t gating_nid);
 103
 104 int snd_hda_jack_bind_keymap(struct hda_codec *codec, hda_nid_t key_nid,
 105                              const struct hda_jack_keymap *keymap,
 106                              hda_nid_t jack_nid);
 107
 108 void snd_hda_jack_set_button_state(struct hda_codec *codec, hda_nid_t jack_nid,
 109                                    int button_state);
 110
 111 u32 snd_hda_jack_pin_sense(struct hda_codec *codec, hda_nid_t nid, int dev_id);
 112
 113 /* the jack state returned from snd_hda_jack_detect_state() */
 114 enum {
 115         HDA_JACK_NOT_PRESENT, HDA_JACK_PRESENT, HDA_JACK_PHANTOM,
 116 };
 117
 118 int snd_hda_jack_detect_state_mst(struct hda_codec *codec, hda_nid_t nid,
 119                                   int dev_id);
 120
 121 /**
 122  * snd_hda_jack_detect_state - query pin Presence Detect status
 123  * @codec: the CODEC to sense
 124  * @nid: the pin NID to sense
 125  *
 126  * Query and return the pin's Presence Detect status, as either
 127  * HDA_JACK_NOT_PRESENT, HDA_JACK_PRESENT or HDA_JACK_PHANTOM.
 128  */
 129 static inline int
 130 snd_hda_jack_detect_state(struct hda_codec *codec, hda_nid_t nid)
 131 {
 132         return snd_hda_jack_detect_state_mst(codec, nid, 0);
 133 }
 134
 135 /**
 136  * snd_hda_jack_detect_mst - Detect the jack
 137  * @codec: the HDA codec
 138  * @nid: pin NID to check jack detection
 139  * @dev_id: pin device entry id
 140  */
 141 static inline bool
 142 snd_hda_jack_detect_mst(struct hda_codec *codec, hda_nid_t nid, int dev_id)
 143 {
 144         return snd_hda_jack_detect_state_mst(codec, nid, dev_id) !=
 145                         HDA_JACK_NOT_PRESENT;
 146 }
 147
 148 /**
 149  * snd_hda_jack_detect - Detect the jack
 150  * @codec: the HDA codec
 151  * @nid: pin NID to check jack detection
 152  */
 153 static inline bool
 154 snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid)
 155 {
 156         return snd_hda_jack_detect_mst(codec, nid, 0);
 157 }
 158
 159 bool is_jack_detectable(struct hda_codec *codec, hda_nid_t nid);
 160
 161 int snd_hda_jack_add_kctl_mst(struct hda_codec *codec, hda_nid_t nid,
 162                               int dev_id, const char *name, bool phantom_jack,
 163                               int type, const struct hda_jack_keymap *keymap);
 164
 165 /**
 166  * snd_hda_jack_add_kctl - Add a kctl for the given pin
 167  * @codec: the HDA codec
 168  * @nid: pin NID to assign
 169  * @name: string name for the jack
 170  * @phantom_jack: flag to deal as a phantom jack
 171  * @type: jack type bits to be reported, 0 for guessing from pincfg
 172  * @keymap: optional jack / key mapping
 173  *
 174  * This assigns a jack-detection kctl to the given pin.  The kcontrol
 175  * will have the given name and index.
 176  */
 177 static inline int
 178 snd_hda_jack_add_kctl(struct hda_codec *codec, hda_nid_t nid,
 179                       const char *name, bool phantom_jack,
 180                       int type, const struct hda_jack_keymap *keymap)
 181 {
 182         return snd_hda_jack_add_kctl_mst(codec, nid, 0,
 183                                          name, phantom_jack, type, keymap);
 184 }
 185
 186 int snd_hda_jack_add_kctls(struct hda_codec *codec,
 187                            const struct auto_pin_cfg *cfg);
 188
 189 void snd_hda_jack_report_sync(struct hda_codec *codec);
 190
 191 void snd_hda_jack_unsol_event(struct hda_codec *codec, unsigned int res);
 192
 193 void snd_hda_jack_poll_all(struct hda_codec *codec);
 194
 195 #endif /* __SOUND_HDA_JACK_H */