263f5b698bac4268f6a2b01ee57d993e147c4c2a
[safe/jmp/linux-2.6] / sound / pci / hda / hda_codec.h
1 /*
2  * Universal Interface for Intel High Definition Audio Codec
3  *
4  * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de>
5  *
6  *  This program is free software; you can redistribute it and/or modify it
7  *  under the terms of the GNU General Public License as published by the Free
8  *  Software Foundation; either version 2 of the License, or (at your option)
9  *  any later version.
10  *
11  *  This program is distributed in the hope that it will be useful, but WITHOUT
12  *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
14  *  more details.
15  *
16  *  You should have received a copy of the GNU General Public License along with
17  *  this program; if not, write to the Free Software Foundation, Inc., 59
18  *  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  */
20
21 #ifndef __SOUND_HDA_CODEC_H
22 #define __SOUND_HDA_CODEC_H
23
24 #include <sound/info.h>
25 #include <sound/control.h>
26 #include <sound/pcm.h>
27
28 /*
29  * nodes
30  */
31 #define AC_NODE_ROOT            0x00
32
33 /*
34  * function group types
35  */
36 enum {
37         AC_GRP_AUDIO_FUNCTION = 0x01,
38         AC_GRP_MODEM_FUNCTION = 0x02,
39 };
40         
41 /*
42  * widget types
43  */
44 enum {
45         AC_WID_AUD_OUT,         /* Audio Out */
46         AC_WID_AUD_IN,          /* Audio In */
47         AC_WID_AUD_MIX,         /* Audio Mixer */
48         AC_WID_AUD_SEL,         /* Audio Selector */
49         AC_WID_PIN,             /* Pin Complex */
50         AC_WID_POWER,           /* Power */
51         AC_WID_VOL_KNB,         /* Volume Knob */
52         AC_WID_BEEP,            /* Beep Generator */
53         AC_WID_VENDOR = 0x0f    /* Vendor specific */
54 };
55
56 /*
57  * GET verbs
58  */
59 #define AC_VERB_GET_STREAM_FORMAT               0x0a00
60 #define AC_VERB_GET_AMP_GAIN_MUTE               0x0b00
61 #define AC_VERB_GET_PROC_COEF                   0x0c00
62 #define AC_VERB_GET_COEF_INDEX                  0x0d00
63 #define AC_VERB_PARAMETERS                      0x0f00
64 #define AC_VERB_GET_CONNECT_SEL                 0x0f01
65 #define AC_VERB_GET_CONNECT_LIST                0x0f02
66 #define AC_VERB_GET_PROC_STATE                  0x0f03
67 #define AC_VERB_GET_SDI_SELECT                  0x0f04
68 #define AC_VERB_GET_POWER_STATE                 0x0f05
69 #define AC_VERB_GET_CONV                        0x0f06
70 #define AC_VERB_GET_PIN_WIDGET_CONTROL          0x0f07
71 #define AC_VERB_GET_UNSOLICITED_RESPONSE        0x0f08
72 #define AC_VERB_GET_PIN_SENSE                   0x0f09
73 #define AC_VERB_GET_BEEP_CONTROL                0x0f0a
74 #define AC_VERB_GET_EAPD_BTLENABLE              0x0f0c
75 #define AC_VERB_GET_DIGI_CONVERT                0x0f0d
76 #define AC_VERB_GET_VOLUME_KNOB_CONTROL         0x0f0f
77 /* f10-f1a: GPIO */
78 #define AC_VERB_GET_CONFIG_DEFAULT              0x0f1c
79
80 /*
81  * SET verbs
82  */
83 #define AC_VERB_SET_STREAM_FORMAT               0x200
84 #define AC_VERB_SET_AMP_GAIN_MUTE               0x300
85 #define AC_VERB_SET_PROC_COEF                   0x400
86 #define AC_VERB_SET_COEF_INDEX                  0x500
87 #define AC_VERB_SET_CONNECT_SEL                 0x701
88 #define AC_VERB_SET_PROC_STATE                  0x703
89 #define AC_VERB_SET_SDI_SELECT                  0x704
90 #define AC_VERB_SET_POWER_STATE                 0x705
91 #define AC_VERB_SET_CHANNEL_STREAMID            0x706
92 #define AC_VERB_SET_PIN_WIDGET_CONTROL          0x707
93 #define AC_VERB_SET_UNSOLICITED_ENABLE          0x708
94 #define AC_VERB_SET_PIN_SENSE                   0x709
95 #define AC_VERB_SET_BEEP_CONTROL                0x70a
96 #define AC_VERB_SET_EAPD_BTLENALBE              0x70c
97 #define AC_VERB_SET_DIGI_CONVERT_1              0x70d
98 #define AC_VERB_SET_DIGI_CONVERT_2              0x70e
99 #define AC_VERB_SET_VOLUME_KNOB_CONTROL         0x70f
100 #define AC_VERB_SET_CONFIG_DEFAULT_BYTES_0      0x71c
101 #define AC_VERB_SET_CONFIG_DEFAULT_BYTES_1      0x71d
102 #define AC_VERB_SET_CONFIG_DEFAULT_BYTES_2      0x71e
103 #define AC_VERB_SET_CONFIG_DEFAULT_BYTES_3      0x71f
104 #define AC_VERB_SET_CODEC_RESET                 0x7ff
105
106 /*
107  * Parameter IDs
108  */
109 #define AC_PAR_VENDOR_ID                0x00
110 #define AC_PAR_SUBSYSTEM_ID             0x01
111 #define AC_PAR_REV_ID                   0x02
112 #define AC_PAR_NODE_COUNT               0x04
113 #define AC_PAR_FUNCTION_TYPE            0x05
114 #define AC_PAR_AUDIO_FG_CAP             0x08
115 #define AC_PAR_AUDIO_WIDGET_CAP         0x09
116 #define AC_PAR_PCM                      0x0a
117 #define AC_PAR_STREAM                   0x0b
118 #define AC_PAR_PIN_CAP                  0x0c
119 #define AC_PAR_AMP_IN_CAP               0x0d
120 #define AC_PAR_CONNLIST_LEN             0x0e
121 #define AC_PAR_POWER_STATE              0x0f
122 #define AC_PAR_PROC_CAP                 0x10
123 #define AC_PAR_GPIO_CAP                 0x11
124 #define AC_PAR_AMP_OUT_CAP              0x12
125
126 /*
127  * AC_VERB_PARAMETERS results (32bit)
128  */
129
130 /* Function Group Type */
131 #define AC_FGT_TYPE                     (0xff<<0)
132 #define AC_FGT_TYPE_SHIFT               0
133 #define AC_FGT_UNSOL_CAP                (1<<8)
134
135 /* Audio Function Group Capabilities */
136 #define AC_AFG_OUT_DELAY                (0xf<<0)
137 #define AC_AFG_IN_DELAY                 (0xf<<8)
138 #define AC_AFG_BEEP_GEN                 (1<<16)
139
140 /* Audio Widget Capabilities */
141 #define AC_WCAP_STEREO                  (1<<0)  /* stereo I/O */
142 #define AC_WCAP_IN_AMP                  (1<<1)  /* AMP-in present */
143 #define AC_WCAP_OUT_AMP                 (1<<2)  /* AMP-out present */
144 #define AC_WCAP_AMP_OVRD                (1<<3)  /* AMP-parameter override */
145 #define AC_WCAP_FORMAT_OVRD             (1<<4)  /* format override */
146 #define AC_WCAP_STRIPE                  (1<<5)  /* stripe */
147 #define AC_WCAP_PROC_WID                (1<<6)  /* Proc Widget */
148 #define AC_WCAP_UNSOL_CAP               (1<<7)  /* Unsol capable */
149 #define AC_WCAP_CONN_LIST               (1<<8)  /* connection list */
150 #define AC_WCAP_DIGITAL                 (1<<9)  /* digital I/O */
151 #define AC_WCAP_POWER                   (1<<10) /* power control */
152 #define AC_WCAP_LR_SWAP                 (1<<11) /* L/R swap */
153 #define AC_WCAP_DELAY                   (0xf<<16)
154 #define AC_WCAP_DELAY_SHIFT             16
155 #define AC_WCAP_TYPE                    (0xf<<20)
156 #define AC_WCAP_TYPE_SHIFT              20
157
158 /* supported PCM rates and bits */
159 #define AC_SUPPCM_RATES                 (0xfff << 0)
160 #define AC_SUPPCM_BITS_8                (1<<16)
161 #define AC_SUPPCM_BITS_16               (1<<17)
162 #define AC_SUPPCM_BITS_20               (1<<18)
163 #define AC_SUPPCM_BITS_24               (1<<19)
164 #define AC_SUPPCM_BITS_32               (1<<20)
165
166 /* supported PCM stream format */
167 #define AC_SUPFMT_PCM                   (1<<0)
168 #define AC_SUPFMT_FLOAT32               (1<<1)
169 #define AC_SUPFMT_AC3                   (1<<2)
170
171 /* Pin widget capabilies */
172 #define AC_PINCAP_IMP_SENSE             (1<<0)  /* impedance sense capable */
173 #define AC_PINCAP_TRIG_REQ              (1<<1)  /* trigger required */
174 #define AC_PINCAP_PRES_DETECT           (1<<2)  /* presence detect capable */
175 #define AC_PINCAP_HP_DRV                (1<<3)  /* headphone drive capable */
176 #define AC_PINCAP_OUT                   (1<<4)  /* output capable */
177 #define AC_PINCAP_IN                    (1<<5)  /* input capable */
178 #define AC_PINCAP_BALANCE               (1<<6)  /* balanced I/O capable */
179 #define AC_PINCAP_VREF                  (0x37<<8)
180 #define AC_PINCAP_VREF_SHIFT            8
181 #define AC_PINCAP_EAPD                  (1<<16) /* EAPD capable */
182 /* Vref status (used in pin cap) */
183 #define AC_PINCAP_VREF_HIZ              (1<<0)  /* Hi-Z */
184 #define AC_PINCAP_VREF_50               (1<<1)  /* 50% */
185 #define AC_PINCAP_VREF_GRD              (1<<2)  /* ground */
186 #define AC_PINCAP_VREF_80               (1<<4)  /* 80% */
187 #define AC_PINCAP_VREF_100              (1<<5)  /* 100% */
188
189 /* Amplifier capabilities */
190 #define AC_AMPCAP_OFFSET                (0x7f<<0)  /* 0dB offset */
191 #define AC_AMPCAP_OFFSET_SHIFT          0
192 #define AC_AMPCAP_NUM_STEPS             (0x7f<<8)  /* number of steps */
193 #define AC_AMPCAP_NUM_STEPS_SHIFT       8
194 #define AC_AMPCAP_STEP_SIZE             (0x7f<<16) /* step size 0-32dB in 0.25dB */
195 #define AC_AMPCAP_STEP_SIZE_SHIFT       16
196 #define AC_AMPCAP_MUTE                  (1<<31)    /* mute capable */
197 #define AC_AMPCAP_MUTE_SHIFT            31
198
199 /* Connection list */
200 #define AC_CLIST_LENGTH                 (0x7f<<0)
201 #define AC_CLIST_LONG                   (1<<7)
202
203 /* Supported power status */
204 #define AC_PWRST_D0SUP                  (1<<0)
205 #define AC_PWRST_D1SUP                  (1<<1)
206 #define AC_PWRST_D2SUP                  (1<<2)
207 #define AC_PWRST_D3SUP                  (1<<3)
208
209 /* Processing capabilies */
210 #define AC_PCAP_BENIGN                  (1<<0)
211 #define AC_PCAP_NUM_COEF                (0xff<<8)
212
213 /* Volume knobs capabilities */
214 #define AC_KNBCAP_NUM_STEPS             (0x7f<<0)
215 #define AC_KNBCAP_DELTA                 (1<<8)
216
217 /*
218  * Control Parameters
219  */
220
221 /* Amp gain/mute */
222 #define AC_AMP_MUTE                     (1<<8)
223 #define AC_AMP_GAIN                     (0x7f)
224 #define AC_AMP_GET_INDEX                (0xf<<0)
225
226 #define AC_AMP_GET_LEFT                 (1<<13)
227 #define AC_AMP_GET_RIGHT                (0<<13)
228 #define AC_AMP_GET_OUTPUT               (1<<15)
229 #define AC_AMP_GET_INPUT                (0<<15)
230
231 #define AC_AMP_SET_INDEX                (0xf<<8)
232 #define AC_AMP_SET_INDEX_SHIFT          8
233 #define AC_AMP_SET_RIGHT                (1<<12)
234 #define AC_AMP_SET_LEFT                 (1<<13)
235 #define AC_AMP_SET_INPUT                (1<<14)
236 #define AC_AMP_SET_OUTPUT               (1<<15)
237
238 /* DIGITAL1 bits */
239 #define AC_DIG1_ENABLE                  (1<<0)
240 #define AC_DIG1_V                       (1<<1)
241 #define AC_DIG1_VCFG                    (1<<2)
242 #define AC_DIG1_EMPHASIS                (1<<3)
243 #define AC_DIG1_COPYRIGHT               (1<<4)
244 #define AC_DIG1_NONAUDIO                (1<<5)
245 #define AC_DIG1_PROFESSIONAL            (1<<6)
246 #define AC_DIG1_LEVEL                   (1<<7)
247
248 /* Pin widget control - 8bit */
249 #define AC_PINCTL_VREFEN                (0x7<<0)
250 #define AC_PINCTL_VREF_HIZ              0       /* Hi-Z */
251 #define AC_PINCTL_VREF_50               1       /* 50% */
252 #define AC_PINCTL_VREF_GRD              2       /* ground */
253 #define AC_PINCTL_VREF_80               4       /* 80% */
254 #define AC_PINCTL_VREF_100              5       /* 100% */
255 #define AC_PINCTL_IN_EN                 (1<<5)
256 #define AC_PINCTL_OUT_EN                (1<<6)
257 #define AC_PINCTL_HP_EN                 (1<<7)
258
259 /* configuration default - 32bit */
260 #define AC_DEFCFG_SEQUENCE              (0xf<<0)
261 #define AC_DEFCFG_DEF_ASSOC             (0xf<<4)
262 #define AC_DEFCFG_MISC                  (0xf<<8)
263 #define AC_DEFCFG_COLOR                 (0xf<<12)
264 #define AC_DEFCFG_COLOR_SHIFT           12
265 #define AC_DEFCFG_CONN_TYPE             (0xf<<16)
266 #define AC_DEFCFG_CONN_TYPE_SHIFT       16
267 #define AC_DEFCFG_DEVICE                (0xf<<20)
268 #define AC_DEFCFG_DEVICE_SHIFT          20
269 #define AC_DEFCFG_LOCATION              (0x3f<<24)
270 #define AC_DEFCFG_LOCATION_SHIFT        24
271 #define AC_DEFCFG_PORT_CONN             (0x3<<30)
272 #define AC_DEFCFG_PORT_CONN_SHIFT       30
273
274 /* device device types (0x0-0xf) */
275 enum {
276         AC_JACK_LINE_OUT,
277         AC_JACK_SPEAKER,
278         AC_JACK_HP_OUT,
279         AC_JACK_CD,
280         AC_JACK_SPDIF_OUT,
281         AC_JACK_DIG_OTHER_OUT,
282         AC_JACK_MODEM_LINE_SIDE,
283         AC_JACK_MODEM_HAND_SIDE,
284         AC_JACK_LINE_IN,
285         AC_JACK_AUX,
286         AC_JACK_MIC_IN,
287         AC_JACK_TELEPHONY,
288         AC_JACK_SPDIF_IN,
289         AC_JACK_DIG_OTHER_IN,
290         AC_JACK_OTHER = 0xf,
291 };
292
293 /* jack connection types (0x0-0xf) */
294 enum {
295         AC_JACK_CONN_UNKNOWN,
296         AC_JACK_CONN_1_8,
297         AC_JACK_CONN_1_4,
298         AC_JACK_CONN_ATAPI,
299         AC_JACK_CONN_RCA,
300         AC_JACK_CONN_OPTICAL,
301         AC_JACK_CONN_OTHER_DIGITAL,
302         AC_JACK_CONN_OTHER_ANALOG,
303         AC_JACK_CONN_DIN,
304         AC_JACK_CONN_XLR,
305         AC_JACK_CONN_RJ11,
306         AC_JACK_CONN_COMB,
307         AC_JACK_CONN_OTHER = 0xf,
308 };
309
310 /* jack colors (0x0-0xf) */
311 enum {
312         AC_JACK_COLOR_UNKNOWN,
313         AC_JACK_COLOR_BLACK,
314         AC_JACK_COLOR_GREY,
315         AC_JACK_COLOR_BLUE,
316         AC_JACK_COLOR_GREEN,
317         AC_JACK_COLOR_RED,
318         AC_JACK_COLOR_ORANGE,
319         AC_JACK_COLOR_YELLOW,
320         AC_JACK_COLOR_PURPLE,
321         AC_JACK_COLOR_PINK,
322         AC_JACK_COLOR_WHITE = 0xe,
323         AC_JACK_COLOR_OTHER,
324 };
325
326 /* Jack location (0x0-0x3f) */
327 /* common case */
328 enum {
329         AC_JACK_LOC_NONE,
330         AC_JACK_LOC_REAR,
331         AC_JACK_LOC_FRONT,
332         AC_JACK_LOC_LEFT,
333         AC_JACK_LOC_RIGHT,
334         AC_JACK_LOC_TOP,
335         AC_JACK_LOC_BOTTOM,
336 };
337 /* bits 4-5 */
338 enum {
339         AC_JACK_LOC_EXTERNAL = 0x00,
340         AC_JACK_LOC_INTERNAL = 0x10,
341         AC_JACK_LOC_SEPARATE = 0x20,
342         AC_JACK_LOC_OTHER    = 0x30,
343 };
344 enum {
345         /* external on primary chasis */
346         AC_JACK_LOC_REAR_PANEL = 0x07,
347         AC_JACK_LOC_DRIVE_BAY,
348         /* internal */
349         AC_JACK_LOC_RISER = 0x17,
350         AC_JACK_LOC_HDMI,
351         AC_JACK_LOC_ATAPI,
352         /* others */
353         AC_JACK_LOC_MOBILE_IN = 0x37,
354         AC_JACK_LOC_MOBILE_OUT,
355 };
356
357 /* Port connectivity (0-3) */
358 enum {
359         AC_JACK_PORT_COMPLEX,
360         AC_JACK_PORT_NONE,
361         AC_JACK_PORT_FIXED,
362         AC_JACK_PORT_BOTH,
363 };
364
365 /* max. connections to a widget */
366 #define HDA_MAX_CONNECTIONS     16
367
368 /* max. codec address */
369 #define HDA_MAX_CODEC_ADDRESS   0x0f
370
371 /*
372  * Structures
373  */
374
375 struct hda_bus;
376 struct hda_codec;
377 struct hda_pcm;
378 struct hda_pcm_stream;
379 struct hda_bus_unsolicited;
380
381 /* NID type */
382 typedef u16 hda_nid_t;
383
384 /* bus operators */
385 struct hda_bus_ops {
386         /* send a single command */
387         int (*command)(struct hda_codec *codec, hda_nid_t nid, int direct,
388                        unsigned int verb, unsigned int parm);
389         /* get a response from the last command */
390         unsigned int (*get_response)(struct hda_codec *codec);
391         /* free the private data */
392         void (*private_free)(struct hda_bus *);
393 };
394
395 /* template to pass to the bus constructor */
396 struct hda_bus_template {
397         void *private_data;
398         struct pci_dev *pci;
399         const char *modelname;
400         struct hda_bus_ops ops;
401 };
402
403 /*
404  * codec bus
405  *
406  * each controller needs to creata a hda_bus to assign the accessor.
407  * A hda_bus contains several codecs in the list codec_list.
408  */
409 struct hda_bus {
410         snd_card_t *card;
411
412         /* copied from template */
413         void *private_data;
414         struct pci_dev *pci;
415         const char *modelname;
416         struct hda_bus_ops ops;
417
418         /* codec linked list */
419         struct list_head codec_list;
420         struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS]; /* caddr -> codec */
421
422         struct semaphore cmd_mutex;
423
424         /* unsolicited event queue */
425         struct hda_bus_unsolicited *unsol;
426
427         snd_info_entry_t *proc;
428 };
429
430 /*
431  * codec preset
432  *
433  * Known codecs have the patch to build and set up the controls/PCMs
434  * better than the generic parser.
435  */
436 struct hda_codec_preset {
437         unsigned int id;
438         unsigned int mask;
439         unsigned int subs;
440         unsigned int subs_mask;
441         unsigned int rev;
442         const char *name;
443         int (*patch)(struct hda_codec *codec);
444 };
445         
446 /* ops set by the preset patch */
447 struct hda_codec_ops {
448         int (*build_controls)(struct hda_codec *codec);
449         int (*build_pcms)(struct hda_codec *codec);
450         int (*init)(struct hda_codec *codec);
451         void (*free)(struct hda_codec *codec);
452         void (*unsol_event)(struct hda_codec *codec, unsigned int res);
453 #ifdef CONFIG_PM
454         int (*suspend)(struct hda_codec *codec, pm_message_t state);
455         int (*resume)(struct hda_codec *codec);
456 #endif
457 };
458
459 /* record for amp information cache */
460 struct hda_amp_info {
461         u32 key;                /* hash key */
462         u32 amp_caps;           /* amp capabilities */
463         u16 vol[2];             /* current volume & mute*/
464         u16 status;             /* update flag */
465         u16 next;               /* next link */
466 };
467
468 /* PCM callbacks */
469 struct hda_pcm_ops {
470         int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec,
471                     snd_pcm_substream_t *substream);
472         int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec,
473                      snd_pcm_substream_t *substream);
474         int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec,
475                        unsigned int stream_tag, unsigned int format,
476                        snd_pcm_substream_t *substream);
477         int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec,
478                        snd_pcm_substream_t *substream);
479 };
480
481 /* PCM information for each substream */
482 struct hda_pcm_stream {
483         unsigned int substreams;        /* number of substreams, 0 = not exist */
484         unsigned int channels_min;      /* min. number of channels */
485         unsigned int channels_max;      /* max. number of channels */
486         hda_nid_t nid;  /* default NID to query rates/formats/bps, or set up */
487         u32 rates;      /* supported rates */
488         u64 formats;    /* supported formats (SNDRV_PCM_FMTBIT_) */
489         unsigned int maxbps;    /* supported max. bit per sample */
490         struct hda_pcm_ops ops;
491 };
492
493 /* for PCM creation */
494 struct hda_pcm {
495         char *name;
496         struct hda_pcm_stream stream[2];
497 };
498
499 /* codec information */
500 struct hda_codec {
501         struct hda_bus *bus;
502         unsigned int addr;      /* codec addr*/
503         struct list_head list;  /* list point */
504
505         hda_nid_t afg;  /* AFG node id */
506
507         /* ids */
508         u32 vendor_id;
509         u32 subsystem_id;
510         u32 revision_id;
511
512         /* detected preset */
513         const struct hda_codec_preset *preset;
514
515         /* set by patch */
516         struct hda_codec_ops patch_ops;
517
518         /* resume phase - all controls should update even if
519          * the values are not changed
520          */
521         unsigned int in_resume;
522
523         /* PCM to create, set by patch_ops.build_pcms callback */
524         unsigned int num_pcms;
525         struct hda_pcm *pcm_info;
526
527         /* codec specific info */
528         void *spec;
529
530         /* hash for amp access */
531         u16 amp_hash[32];
532         int num_amp_entries;
533         struct hda_amp_info amp_info[128]; /* big enough? */
534
535         struct semaphore spdif_mutex;
536         unsigned int spdif_status;      /* IEC958 status bits */
537         unsigned short spdif_ctls;      /* SPDIF control bits */
538         unsigned int spdif_in_enable;   /* SPDIF input enable? */
539 };
540
541 /* direction */
542 enum {
543         HDA_INPUT, HDA_OUTPUT
544 };
545
546
547 /*
548  * constructors
549  */
550 int snd_hda_bus_new(snd_card_t *card, const struct hda_bus_template *temp,
551                     struct hda_bus **busp);
552 int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr,
553                       struct hda_codec **codecp);
554
555 /*
556  * low level functions
557  */
558 unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid, int direct,
559                                 unsigned int verb, unsigned int parm);
560 int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int direct,
561                         unsigned int verb, unsigned int parm);
562 #define snd_hda_param_read(codec, nid, param) snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param)
563 int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *start_id);
564 int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *conn_list, int max_conns);
565
566 struct hda_verb {
567         hda_nid_t nid;
568         u32 verb;
569         u32 param;
570 };
571
572 void snd_hda_sequence_write(struct hda_codec *codec, const struct hda_verb *seq);
573
574 /* unsolicited event */
575 int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex);
576
577 /*
578  * Mixer
579  */
580 int snd_hda_build_controls(struct hda_bus *bus);
581
582 /*
583  * PCM
584  */
585 int snd_hda_build_pcms(struct hda_bus *bus);
586 void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid, u32 stream_tag,
587                                 int channel_id, int format);
588 unsigned int snd_hda_calc_stream_format(unsigned int rate, unsigned int channels,
589                                         unsigned int format, unsigned int maxbps);
590 int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid,
591                                 u32 *ratesp, u64 *formatsp, unsigned int *bpsp);
592 int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid,
593                                 unsigned int format);
594
595 /*
596  * Misc
597  */
598 void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen);
599
600 /*
601  * power management
602  */
603 #ifdef CONFIG_PM
604 int snd_hda_suspend(struct hda_bus *bus, pm_message_t state);
605 int snd_hda_resume(struct hda_bus *bus);
606 #endif
607
608 #endif /* __SOUND_HDA_CODEC_H */