kernel/include/sound/hdaudio.h

   1 /*
   2  * HD-audio core stuff
   3  */
   4
   5 #ifndef __SOUND_HDAUDIO_H
   6 #define __SOUND_HDAUDIO_H
   7
   8 #include <linux/device.h>
   9 #include <sound/hda_verbs.h>
  10
  11 /* codec node id */
  12 typedef u16 hda_nid_t;
  13
  14 struct hdac_bus;
  15 struct hdac_device;
  16 struct hdac_driver;
  17 struct hdac_widget_tree;
  18
  19 /*
  20  * exported bus type
  21  */
  22 extern struct bus_type snd_hda_bus_type;
  23
  24 /*
  25  * generic arrays
  26  */
  27 struct snd_array {
  28         unsigned int used;
  29         unsigned int alloced;
  30         unsigned int elem_size;
  31         unsigned int alloc_align;
  32         void *list;
  33 };
  34
  35 /*
  36  * HD-audio codec base device
  37  */
  38 struct hdac_device {
  39         struct device dev;
  40         int type;
  41         struct hdac_bus *bus;
  42         unsigned int addr;              /* codec address */
  43         struct list_head list;          /* list point for bus codec_list */
  44
  45         hda_nid_t afg;                  /* AFG node id */
  46         hda_nid_t mfg;                  /* MFG node id */
  47
  48         /* ids */
  49         unsigned int vendor_id;
  50         unsigned int subsystem_id;
  51         unsigned int revision_id;
  52         unsigned int afg_function_id;
  53         unsigned int mfg_function_id;
  54         unsigned int afg_unsol:1;
  55         unsigned int mfg_unsol:1;
  56
  57         unsigned int power_caps;        /* FG power caps */
  58
  59         const char *vendor_name;        /* codec vendor name */
  60         const char *chip_name;          /* codec chip name */
  61
  62         /* verb exec op override */
  63         int (*exec_verb)(struct hdac_device *dev, unsigned int cmd,
  64                          unsigned int flags, unsigned int *res);
  65
  66         /* widgets */
  67         unsigned int num_nodes;
  68         hda_nid_t start_nid, end_nid;
  69
  70         /* misc flags */
  71         atomic_t in_pm;         /* suspend/resume being performed */
  72
  73         /* sysfs */
  74         struct hdac_widget_tree *widgets;
  75
  76         /* regmap */
  77         struct regmap *regmap;
  78         struct snd_array vendor_verbs;
  79         bool lazy_cache:1;      /* don't wake up for writes */
  80         bool caps_overwriting:1; /* caps overwrite being in process */
  81         bool cache_coef:1;      /* cache COEF read/write too */
  82 };
  83
  84 /* device/driver type used for matching */
  85 enum {
  86         HDA_DEV_CORE,
  87         HDA_DEV_LEGACY,
  88 };
  89
  90 /* direction */
  91 enum {
  92         HDA_INPUT, HDA_OUTPUT
  93 };
  94
  95 #define dev_to_hdac_dev(_dev)   container_of(_dev, struct hdac_device, dev)
  96
  97 int snd_hdac_device_init(struct hdac_device *dev, struct hdac_bus *bus,
  98                          const char *name, unsigned int addr);
  99 void snd_hdac_device_exit(struct hdac_device *dev);
 100 int snd_hdac_device_register(struct hdac_device *codec);
 101 void snd_hdac_device_unregister(struct hdac_device *codec);
 102
 103 int snd_hdac_refresh_widgets(struct hdac_device *codec);
 104
 105 unsigned int snd_hdac_make_cmd(struct hdac_device *codec, hda_nid_t nid,
 106                                unsigned int verb, unsigned int parm);
 107 int snd_hdac_exec_verb(struct hdac_device *codec, unsigned int cmd,
 108                        unsigned int flags, unsigned int *res);
 109 int snd_hdac_read(struct hdac_device *codec, hda_nid_t nid,
 110                   unsigned int verb, unsigned int parm, unsigned int *res);
 111 int _snd_hdac_read_parm(struct hdac_device *codec, hda_nid_t nid, int parm,
 112                         unsigned int *res);
 113 int snd_hdac_read_parm_uncached(struct hdac_device *codec, hda_nid_t nid,
 114                                 int parm);
 115 int snd_hdac_override_parm(struct hdac_device *codec, hda_nid_t nid,
 116                            unsigned int parm, unsigned int val);
 117 int snd_hdac_get_connections(struct hdac_device *codec, hda_nid_t nid,
 118                              hda_nid_t *conn_list, int max_conns);
 119 int snd_hdac_get_sub_nodes(struct hdac_device *codec, hda_nid_t nid,
 120                            hda_nid_t *start_id);
 121
 122 /**
 123  * snd_hdac_read_parm - read a codec parameter
 124  * @codec: the codec object
 125  * @nid: NID to read a parameter
 126  * @parm: parameter to read
 127  *
 128  * Returns -1 for error.  If you need to distinguish the error more
 129  * strictly, use _snd_hdac_read_parm() directly.
 130  */
 131 static inline int snd_hdac_read_parm(struct hdac_device *codec, hda_nid_t nid,
 132                                      int parm)
 133 {
 134         unsigned int val;
 135
 136         return _snd_hdac_read_parm(codec, nid, parm, &val) < 0 ? -1 : val;
 137 }
 138
 139 #ifdef CONFIG_PM
 140 void snd_hdac_power_up(struct hdac_device *codec);
 141 void snd_hdac_power_down(struct hdac_device *codec);
 142 void snd_hdac_power_up_pm(struct hdac_device *codec);
 143 void snd_hdac_power_down_pm(struct hdac_device *codec);
 144 #else
 145 static inline void snd_hdac_power_up(struct hdac_device *codec) {}
 146 static inline void snd_hdac_power_down(struct hdac_device *codec) {}
 147 static inline void snd_hdac_power_up_pm(struct hdac_device *codec) {}
 148 static inline void snd_hdac_power_down_pm(struct hdac_device *codec) {}
 149 #endif
 150
 151 /*
 152  * HD-audio codec base driver
 153  */
 154 struct hdac_driver {
 155         struct device_driver driver;
 156         int type;
 157         int (*match)(struct hdac_device *dev, struct hdac_driver *drv);
 158         void (*unsol_event)(struct hdac_device *dev, unsigned int event);
 159 };
 160
 161 #define drv_to_hdac_driver(_drv) container_of(_drv, struct hdac_driver, driver)
 162
 163 /*
 164  * HD-audio bus base driver
 165  */
 166 struct hdac_bus_ops {
 167         /* send a single command */
 168         int (*command)(struct hdac_bus *bus, unsigned int cmd);
 169         /* get a response from the last command */
 170         int (*get_response)(struct hdac_bus *bus, unsigned int addr,
 171                             unsigned int *res);
 172 };
 173
 174 #define HDA_UNSOL_QUEUE_SIZE    64
 175
 176 struct hdac_bus {
 177         struct device *dev;
 178         const struct hdac_bus_ops *ops;
 179
 180         /* codec linked list */
 181         struct list_head codec_list;
 182         unsigned int num_codecs;
 183
 184         /* link caddr -> codec */
 185         struct hdac_device *caddr_tbl[HDA_MAX_CODEC_ADDRESS + 1];
 186
 187         /* unsolicited event queue */
 188         u32 unsol_queue[HDA_UNSOL_QUEUE_SIZE * 2]; /* ring buffer */
 189         unsigned int unsol_rp, unsol_wp;
 190         struct work_struct unsol_work;
 191
 192         /* bit flags of powered codecs */
 193         unsigned long codec_powered;
 194
 195         /* flags */
 196         bool sync_write:1;              /* sync after verb write */
 197
 198         /* locks */
 199         struct mutex cmd_mutex;
 200 };
 201
 202 int snd_hdac_bus_init(struct hdac_bus *bus, struct device *dev,
 203                       const struct hdac_bus_ops *ops);
 204 void snd_hdac_bus_exit(struct hdac_bus *bus);
 205 int snd_hdac_bus_exec_verb(struct hdac_bus *bus, unsigned int addr,
 206                            unsigned int cmd, unsigned int *res);
 207 int snd_hdac_bus_exec_verb_unlocked(struct hdac_bus *bus, unsigned int addr,
 208                                     unsigned int cmd, unsigned int *res);
 209 void snd_hdac_bus_queue_event(struct hdac_bus *bus, u32 res, u32 res_ex);
 210
 211 int snd_hdac_bus_add_device(struct hdac_bus *bus, struct hdac_device *codec);
 212 void snd_hdac_bus_remove_device(struct hdac_bus *bus,
 213                                 struct hdac_device *codec);
 214
 215 static inline void snd_hdac_codec_link_up(struct hdac_device *codec)
 216 {
 217         set_bit(codec->addr, &codec->bus->codec_powered);
 218 }
 219
 220 static inline void snd_hdac_codec_link_down(struct hdac_device *codec)
 221 {
 222         clear_bit(codec->addr, &codec->bus->codec_powered);
 223 }
 224
 225 /*
 226  * generic array helpers
 227  */
 228 void *snd_array_new(struct snd_array *array);
 229 void snd_array_free(struct snd_array *array);
 230 static inline void snd_array_init(struct snd_array *array, unsigned int size,
 231                                   unsigned int align)
 232 {
 233         array->elem_size = size;
 234         array->alloc_align = align;
 235 }
 236
 237 static inline void *snd_array_elem(struct snd_array *array, unsigned int idx)
 238 {
 239         return array->list + idx * array->elem_size;
 240 }
 241
 242 static inline unsigned int snd_array_index(struct snd_array *array, void *ptr)
 243 {
 244         return (unsigned long)(ptr - array->list) / array->elem_size;
 245 }
 246
 247 #endif /* __SOUND_HDAUDIO_H */