blob: 40520e9d5a4b2b3ef3a2b36fbb6c0a47d4ba2243 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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 */
36enum {
37 AC_GRP_AUDIO_FUNCTION = 0x01,
38 AC_GRP_MODEM_FUNCTION = 0x02,
39};
40
41/*
42 * widget types
43 */
44enum {
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 */
Takashi Iwai16ded522005-06-10 19:58:24 +020078#define AC_VERB_GET_GPIO_DATA 0x0f15
79#define AC_VERB_GET_GPIO_MASK 0x0f16
80#define AC_VERB_GET_GPIO_DIRECTION 0x0f17
Linus Torvalds1da177e2005-04-16 15:20:36 -070081#define AC_VERB_GET_CONFIG_DEFAULT 0x0f1c
Takashi Iwai86284e42005-10-11 15:05:54 +020082/* f20: AFG/MFG */
83#define AC_VERB_GET_SUBSYSTEM_ID 0x0f20
Linus Torvalds1da177e2005-04-16 15:20:36 -070084
85/*
86 * SET verbs
87 */
88#define AC_VERB_SET_STREAM_FORMAT 0x200
89#define AC_VERB_SET_AMP_GAIN_MUTE 0x300
90#define AC_VERB_SET_PROC_COEF 0x400
91#define AC_VERB_SET_COEF_INDEX 0x500
92#define AC_VERB_SET_CONNECT_SEL 0x701
93#define AC_VERB_SET_PROC_STATE 0x703
94#define AC_VERB_SET_SDI_SELECT 0x704
95#define AC_VERB_SET_POWER_STATE 0x705
96#define AC_VERB_SET_CHANNEL_STREAMID 0x706
97#define AC_VERB_SET_PIN_WIDGET_CONTROL 0x707
98#define AC_VERB_SET_UNSOLICITED_ENABLE 0x708
99#define AC_VERB_SET_PIN_SENSE 0x709
100#define AC_VERB_SET_BEEP_CONTROL 0x70a
Takashi Iwaia2a20932005-11-17 11:08:23 +0100101#define AC_VERB_SET_EAPD_BTLENABLE 0x70c
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102#define AC_VERB_SET_DIGI_CONVERT_1 0x70d
103#define AC_VERB_SET_DIGI_CONVERT_2 0x70e
104#define AC_VERB_SET_VOLUME_KNOB_CONTROL 0x70f
Takashi Iwai16ded522005-06-10 19:58:24 +0200105#define AC_VERB_SET_GPIO_DATA 0x715
106#define AC_VERB_SET_GPIO_MASK 0x716
107#define AC_VERB_SET_GPIO_DIRECTION 0x717
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_0 0x71c
109#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_1 0x71d
110#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_2 0x71e
111#define AC_VERB_SET_CONFIG_DEFAULT_BYTES_3 0x71f
112#define AC_VERB_SET_CODEC_RESET 0x7ff
113
114/*
115 * Parameter IDs
116 */
117#define AC_PAR_VENDOR_ID 0x00
118#define AC_PAR_SUBSYSTEM_ID 0x01
119#define AC_PAR_REV_ID 0x02
120#define AC_PAR_NODE_COUNT 0x04
121#define AC_PAR_FUNCTION_TYPE 0x05
122#define AC_PAR_AUDIO_FG_CAP 0x08
123#define AC_PAR_AUDIO_WIDGET_CAP 0x09
124#define AC_PAR_PCM 0x0a
125#define AC_PAR_STREAM 0x0b
126#define AC_PAR_PIN_CAP 0x0c
127#define AC_PAR_AMP_IN_CAP 0x0d
128#define AC_PAR_CONNLIST_LEN 0x0e
129#define AC_PAR_POWER_STATE 0x0f
130#define AC_PAR_PROC_CAP 0x10
131#define AC_PAR_GPIO_CAP 0x11
132#define AC_PAR_AMP_OUT_CAP 0x12
133
134/*
135 * AC_VERB_PARAMETERS results (32bit)
136 */
137
138/* Function Group Type */
139#define AC_FGT_TYPE (0xff<<0)
140#define AC_FGT_TYPE_SHIFT 0
141#define AC_FGT_UNSOL_CAP (1<<8)
142
143/* Audio Function Group Capabilities */
144#define AC_AFG_OUT_DELAY (0xf<<0)
145#define AC_AFG_IN_DELAY (0xf<<8)
146#define AC_AFG_BEEP_GEN (1<<16)
147
148/* Audio Widget Capabilities */
149#define AC_WCAP_STEREO (1<<0) /* stereo I/O */
150#define AC_WCAP_IN_AMP (1<<1) /* AMP-in present */
151#define AC_WCAP_OUT_AMP (1<<2) /* AMP-out present */
152#define AC_WCAP_AMP_OVRD (1<<3) /* AMP-parameter override */
153#define AC_WCAP_FORMAT_OVRD (1<<4) /* format override */
154#define AC_WCAP_STRIPE (1<<5) /* stripe */
155#define AC_WCAP_PROC_WID (1<<6) /* Proc Widget */
156#define AC_WCAP_UNSOL_CAP (1<<7) /* Unsol capable */
157#define AC_WCAP_CONN_LIST (1<<8) /* connection list */
158#define AC_WCAP_DIGITAL (1<<9) /* digital I/O */
159#define AC_WCAP_POWER (1<<10) /* power control */
160#define AC_WCAP_LR_SWAP (1<<11) /* L/R swap */
161#define AC_WCAP_DELAY (0xf<<16)
162#define AC_WCAP_DELAY_SHIFT 16
163#define AC_WCAP_TYPE (0xf<<20)
164#define AC_WCAP_TYPE_SHIFT 20
165
166/* supported PCM rates and bits */
167#define AC_SUPPCM_RATES (0xfff << 0)
168#define AC_SUPPCM_BITS_8 (1<<16)
169#define AC_SUPPCM_BITS_16 (1<<17)
170#define AC_SUPPCM_BITS_20 (1<<18)
171#define AC_SUPPCM_BITS_24 (1<<19)
172#define AC_SUPPCM_BITS_32 (1<<20)
173
174/* supported PCM stream format */
175#define AC_SUPFMT_PCM (1<<0)
176#define AC_SUPFMT_FLOAT32 (1<<1)
177#define AC_SUPFMT_AC3 (1<<2)
178
179/* Pin widget capabilies */
180#define AC_PINCAP_IMP_SENSE (1<<0) /* impedance sense capable */
181#define AC_PINCAP_TRIG_REQ (1<<1) /* trigger required */
182#define AC_PINCAP_PRES_DETECT (1<<2) /* presence detect capable */
183#define AC_PINCAP_HP_DRV (1<<3) /* headphone drive capable */
184#define AC_PINCAP_OUT (1<<4) /* output capable */
185#define AC_PINCAP_IN (1<<5) /* input capable */
186#define AC_PINCAP_BALANCE (1<<6) /* balanced I/O capable */
Matt1a12de1e2005-04-13 14:37:50 +0200187#define AC_PINCAP_VREF (0x37<<8)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700188#define AC_PINCAP_VREF_SHIFT 8
189#define AC_PINCAP_EAPD (1<<16) /* EAPD capable */
Matt1a12de1e2005-04-13 14:37:50 +0200190/* Vref status (used in pin cap) */
191#define AC_PINCAP_VREF_HIZ (1<<0) /* Hi-Z */
192#define AC_PINCAP_VREF_50 (1<<1) /* 50% */
193#define AC_PINCAP_VREF_GRD (1<<2) /* ground */
194#define AC_PINCAP_VREF_80 (1<<4) /* 80% */
195#define AC_PINCAP_VREF_100 (1<<5) /* 100% */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700196
197/* Amplifier capabilities */
198#define AC_AMPCAP_OFFSET (0x7f<<0) /* 0dB offset */
199#define AC_AMPCAP_OFFSET_SHIFT 0
200#define AC_AMPCAP_NUM_STEPS (0x7f<<8) /* number of steps */
201#define AC_AMPCAP_NUM_STEPS_SHIFT 8
202#define AC_AMPCAP_STEP_SIZE (0x7f<<16) /* step size 0-32dB in 0.25dB */
203#define AC_AMPCAP_STEP_SIZE_SHIFT 16
204#define AC_AMPCAP_MUTE (1<<31) /* mute capable */
205#define AC_AMPCAP_MUTE_SHIFT 31
206
207/* Connection list */
208#define AC_CLIST_LENGTH (0x7f<<0)
209#define AC_CLIST_LONG (1<<7)
210
211/* Supported power status */
212#define AC_PWRST_D0SUP (1<<0)
213#define AC_PWRST_D1SUP (1<<1)
214#define AC_PWRST_D2SUP (1<<2)
215#define AC_PWRST_D3SUP (1<<3)
216
Takashi Iwai54d17402005-11-21 16:33:22 +0100217/* Power state values */
218#define AC_PWRST_D0 0x00
219#define AC_PWRST_D1 0x01
220#define AC_PWRST_D2 0x02
221#define AC_PWRST_D3 0x03
222
Linus Torvalds1da177e2005-04-16 15:20:36 -0700223/* Processing capabilies */
224#define AC_PCAP_BENIGN (1<<0)
225#define AC_PCAP_NUM_COEF (0xff<<8)
226
227/* Volume knobs capabilities */
228#define AC_KNBCAP_NUM_STEPS (0x7f<<0)
229#define AC_KNBCAP_DELTA (1<<8)
230
231/*
232 * Control Parameters
233 */
234
235/* Amp gain/mute */
236#define AC_AMP_MUTE (1<<8)
237#define AC_AMP_GAIN (0x7f)
238#define AC_AMP_GET_INDEX (0xf<<0)
239
240#define AC_AMP_GET_LEFT (1<<13)
241#define AC_AMP_GET_RIGHT (0<<13)
242#define AC_AMP_GET_OUTPUT (1<<15)
243#define AC_AMP_GET_INPUT (0<<15)
244
245#define AC_AMP_SET_INDEX (0xf<<8)
246#define AC_AMP_SET_INDEX_SHIFT 8
247#define AC_AMP_SET_RIGHT (1<<12)
248#define AC_AMP_SET_LEFT (1<<13)
249#define AC_AMP_SET_INPUT (1<<14)
250#define AC_AMP_SET_OUTPUT (1<<15)
251
252/* DIGITAL1 bits */
253#define AC_DIG1_ENABLE (1<<0)
254#define AC_DIG1_V (1<<1)
255#define AC_DIG1_VCFG (1<<2)
256#define AC_DIG1_EMPHASIS (1<<3)
257#define AC_DIG1_COPYRIGHT (1<<4)
258#define AC_DIG1_NONAUDIO (1<<5)
259#define AC_DIG1_PROFESSIONAL (1<<6)
260#define AC_DIG1_LEVEL (1<<7)
261
262/* Pin widget control - 8bit */
263#define AC_PINCTL_VREFEN (0x7<<0)
Takashi Iwai98f759a2005-04-14 13:37:13 +0200264#define AC_PINCTL_VREF_HIZ 0 /* Hi-Z */
265#define AC_PINCTL_VREF_50 1 /* 50% */
266#define AC_PINCTL_VREF_GRD 2 /* ground */
267#define AC_PINCTL_VREF_80 4 /* 80% */
268#define AC_PINCTL_VREF_100 5 /* 100% */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700269#define AC_PINCTL_IN_EN (1<<5)
270#define AC_PINCTL_OUT_EN (1<<6)
271#define AC_PINCTL_HP_EN (1<<7)
272
Matt4e550962005-07-04 17:51:39 +0200273/* Unsolicited response - 8bit */
274#define AC_USRSP_EN (1<<7)
275
Linus Torvalds1da177e2005-04-16 15:20:36 -0700276/* configuration default - 32bit */
277#define AC_DEFCFG_SEQUENCE (0xf<<0)
278#define AC_DEFCFG_DEF_ASSOC (0xf<<4)
Takashi Iwaid21b37e2005-04-20 13:45:55 +0200279#define AC_DEFCFG_ASSOC_SHIFT 4
Linus Torvalds1da177e2005-04-16 15:20:36 -0700280#define AC_DEFCFG_MISC (0xf<<8)
Takashi Iwaid21b37e2005-04-20 13:45:55 +0200281#define AC_DEFCFG_MISC_SHIFT 8
Linus Torvalds1da177e2005-04-16 15:20:36 -0700282#define AC_DEFCFG_COLOR (0xf<<12)
283#define AC_DEFCFG_COLOR_SHIFT 12
284#define AC_DEFCFG_CONN_TYPE (0xf<<16)
285#define AC_DEFCFG_CONN_TYPE_SHIFT 16
286#define AC_DEFCFG_DEVICE (0xf<<20)
287#define AC_DEFCFG_DEVICE_SHIFT 20
288#define AC_DEFCFG_LOCATION (0x3f<<24)
289#define AC_DEFCFG_LOCATION_SHIFT 24
290#define AC_DEFCFG_PORT_CONN (0x3<<30)
291#define AC_DEFCFG_PORT_CONN_SHIFT 30
292
293/* device device types (0x0-0xf) */
294enum {
295 AC_JACK_LINE_OUT,
296 AC_JACK_SPEAKER,
297 AC_JACK_HP_OUT,
298 AC_JACK_CD,
299 AC_JACK_SPDIF_OUT,
300 AC_JACK_DIG_OTHER_OUT,
301 AC_JACK_MODEM_LINE_SIDE,
302 AC_JACK_MODEM_HAND_SIDE,
303 AC_JACK_LINE_IN,
304 AC_JACK_AUX,
305 AC_JACK_MIC_IN,
306 AC_JACK_TELEPHONY,
307 AC_JACK_SPDIF_IN,
308 AC_JACK_DIG_OTHER_IN,
309 AC_JACK_OTHER = 0xf,
310};
311
312/* jack connection types (0x0-0xf) */
313enum {
314 AC_JACK_CONN_UNKNOWN,
315 AC_JACK_CONN_1_8,
316 AC_JACK_CONN_1_4,
317 AC_JACK_CONN_ATAPI,
318 AC_JACK_CONN_RCA,
319 AC_JACK_CONN_OPTICAL,
320 AC_JACK_CONN_OTHER_DIGITAL,
321 AC_JACK_CONN_OTHER_ANALOG,
322 AC_JACK_CONN_DIN,
323 AC_JACK_CONN_XLR,
324 AC_JACK_CONN_RJ11,
325 AC_JACK_CONN_COMB,
326 AC_JACK_CONN_OTHER = 0xf,
327};
328
329/* jack colors (0x0-0xf) */
330enum {
331 AC_JACK_COLOR_UNKNOWN,
332 AC_JACK_COLOR_BLACK,
333 AC_JACK_COLOR_GREY,
334 AC_JACK_COLOR_BLUE,
335 AC_JACK_COLOR_GREEN,
336 AC_JACK_COLOR_RED,
337 AC_JACK_COLOR_ORANGE,
338 AC_JACK_COLOR_YELLOW,
339 AC_JACK_COLOR_PURPLE,
340 AC_JACK_COLOR_PINK,
341 AC_JACK_COLOR_WHITE = 0xe,
342 AC_JACK_COLOR_OTHER,
343};
344
345/* Jack location (0x0-0x3f) */
346/* common case */
347enum {
348 AC_JACK_LOC_NONE,
349 AC_JACK_LOC_REAR,
350 AC_JACK_LOC_FRONT,
351 AC_JACK_LOC_LEFT,
352 AC_JACK_LOC_RIGHT,
353 AC_JACK_LOC_TOP,
354 AC_JACK_LOC_BOTTOM,
355};
356/* bits 4-5 */
357enum {
358 AC_JACK_LOC_EXTERNAL = 0x00,
359 AC_JACK_LOC_INTERNAL = 0x10,
360 AC_JACK_LOC_SEPARATE = 0x20,
361 AC_JACK_LOC_OTHER = 0x30,
362};
363enum {
364 /* external on primary chasis */
365 AC_JACK_LOC_REAR_PANEL = 0x07,
366 AC_JACK_LOC_DRIVE_BAY,
367 /* internal */
368 AC_JACK_LOC_RISER = 0x17,
369 AC_JACK_LOC_HDMI,
370 AC_JACK_LOC_ATAPI,
371 /* others */
372 AC_JACK_LOC_MOBILE_IN = 0x37,
373 AC_JACK_LOC_MOBILE_OUT,
374};
375
376/* Port connectivity (0-3) */
377enum {
378 AC_JACK_PORT_COMPLEX,
379 AC_JACK_PORT_NONE,
380 AC_JACK_PORT_FIXED,
381 AC_JACK_PORT_BOTH,
382};
383
384/* max. connections to a widget */
Takashi Iwai54d17402005-11-21 16:33:22 +0100385#define HDA_MAX_CONNECTIONS 32
Linus Torvalds1da177e2005-04-16 15:20:36 -0700386
387/* max. codec address */
388#define HDA_MAX_CODEC_ADDRESS 0x0f
389
390/*
391 * Structures
392 */
393
394struct hda_bus;
395struct hda_codec;
396struct hda_pcm;
397struct hda_pcm_stream;
398struct hda_bus_unsolicited;
399
400/* NID type */
401typedef u16 hda_nid_t;
402
403/* bus operators */
404struct hda_bus_ops {
405 /* send a single command */
406 int (*command)(struct hda_codec *codec, hda_nid_t nid, int direct,
407 unsigned int verb, unsigned int parm);
408 /* get a response from the last command */
409 unsigned int (*get_response)(struct hda_codec *codec);
410 /* free the private data */
411 void (*private_free)(struct hda_bus *);
412};
413
414/* template to pass to the bus constructor */
415struct hda_bus_template {
416 void *private_data;
417 struct pci_dev *pci;
418 const char *modelname;
419 struct hda_bus_ops ops;
420};
421
422/*
423 * codec bus
424 *
425 * each controller needs to creata a hda_bus to assign the accessor.
426 * A hda_bus contains several codecs in the list codec_list.
427 */
428struct hda_bus {
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100429 struct snd_card *card;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700430
431 /* copied from template */
432 void *private_data;
433 struct pci_dev *pci;
434 const char *modelname;
435 struct hda_bus_ops ops;
436
437 /* codec linked list */
438 struct list_head codec_list;
Takashi Iwai033a1f12005-05-25 16:41:43 +0200439 struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS + 1]; /* caddr -> codec */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700440
Ingo Molnar62932df2006-01-16 16:34:20 +0100441 struct mutex cmd_mutex;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700442
443 /* unsolicited event queue */
444 struct hda_bus_unsolicited *unsol;
445
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100446 struct snd_info_entry *proc;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700447};
448
449/*
450 * codec preset
451 *
452 * Known codecs have the patch to build and set up the controls/PCMs
453 * better than the generic parser.
454 */
455struct hda_codec_preset {
456 unsigned int id;
457 unsigned int mask;
458 unsigned int subs;
459 unsigned int subs_mask;
460 unsigned int rev;
461 const char *name;
462 int (*patch)(struct hda_codec *codec);
463};
464
465/* ops set by the preset patch */
466struct hda_codec_ops {
467 int (*build_controls)(struct hda_codec *codec);
468 int (*build_pcms)(struct hda_codec *codec);
469 int (*init)(struct hda_codec *codec);
470 void (*free)(struct hda_codec *codec);
471 void (*unsol_event)(struct hda_codec *codec, unsigned int res);
472#ifdef CONFIG_PM
473 int (*suspend)(struct hda_codec *codec, pm_message_t state);
474 int (*resume)(struct hda_codec *codec);
475#endif
476};
477
478/* record for amp information cache */
479struct hda_amp_info {
480 u32 key; /* hash key */
481 u32 amp_caps; /* amp capabilities */
482 u16 vol[2]; /* current volume & mute*/
483 u16 status; /* update flag */
484 u16 next; /* next link */
485};
486
487/* PCM callbacks */
488struct hda_pcm_ops {
489 int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100490 struct snd_pcm_substream *substream);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700491 int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100492 struct snd_pcm_substream *substream);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700493 int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec,
494 unsigned int stream_tag, unsigned int format,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100495 struct snd_pcm_substream *substream);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700496 int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec,
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100497 struct snd_pcm_substream *substream);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700498};
499
500/* PCM information for each substream */
501struct hda_pcm_stream {
502 unsigned int substreams; /* number of substreams, 0 = not exist */
503 unsigned int channels_min; /* min. number of channels */
504 unsigned int channels_max; /* max. number of channels */
505 hda_nid_t nid; /* default NID to query rates/formats/bps, or set up */
506 u32 rates; /* supported rates */
507 u64 formats; /* supported formats (SNDRV_PCM_FMTBIT_) */
508 unsigned int maxbps; /* supported max. bit per sample */
509 struct hda_pcm_ops ops;
510};
511
512/* for PCM creation */
513struct hda_pcm {
514 char *name;
515 struct hda_pcm_stream stream[2];
Takashi Iwaiec9e1c52005-09-07 13:29:22 +0200516 unsigned int is_modem; /* modem codec? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517};
518
519/* codec information */
520struct hda_codec {
521 struct hda_bus *bus;
522 unsigned int addr; /* codec addr*/
523 struct list_head list; /* list point */
524
525 hda_nid_t afg; /* AFG node id */
Sasha Khapyorsky673b6832005-08-11 11:00:16 +0200526 hda_nid_t mfg; /* MFG node id */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700527
528 /* ids */
529 u32 vendor_id;
530 u32 subsystem_id;
531 u32 revision_id;
532
533 /* detected preset */
534 const struct hda_codec_preset *preset;
535
536 /* set by patch */
537 struct hda_codec_ops patch_ops;
538
539 /* resume phase - all controls should update even if
540 * the values are not changed
541 */
542 unsigned int in_resume;
543
544 /* PCM to create, set by patch_ops.build_pcms callback */
545 unsigned int num_pcms;
546 struct hda_pcm *pcm_info;
547
548 /* codec specific info */
549 void *spec;
550
Takashi Iwai54d17402005-11-21 16:33:22 +0100551 /* widget capabilities cache */
552 unsigned int num_nodes;
553 hda_nid_t start_nid;
554 u32 *wcaps;
555
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556 /* hash for amp access */
557 u16 amp_hash[32];
558 int num_amp_entries;
Takashi Iwaid0311662005-11-07 14:38:44 +0100559 int amp_info_size;
560 struct hda_amp_info *amp_info;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700561
Ingo Molnar62932df2006-01-16 16:34:20 +0100562 struct mutex spdif_mutex;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700563 unsigned int spdif_status; /* IEC958 status bits */
564 unsigned short spdif_ctls; /* SPDIF control bits */
565 unsigned int spdif_in_enable; /* SPDIF input enable? */
566};
567
568/* direction */
569enum {
570 HDA_INPUT, HDA_OUTPUT
571};
572
573
574/*
575 * constructors
576 */
Takashi Iwaic8b6bf92005-11-17 14:57:47 +0100577int snd_hda_bus_new(struct snd_card *card, const struct hda_bus_template *temp,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700578 struct hda_bus **busp);
579int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr,
580 struct hda_codec **codecp);
581
582/*
583 * low level functions
584 */
585unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid, int direct,
586 unsigned int verb, unsigned int parm);
587int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int direct,
588 unsigned int verb, unsigned int parm);
589#define snd_hda_param_read(codec, nid, param) snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param)
590int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *start_id);
591int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *conn_list, int max_conns);
592
593struct hda_verb {
594 hda_nid_t nid;
595 u32 verb;
596 u32 param;
597};
598
599void snd_hda_sequence_write(struct hda_codec *codec, const struct hda_verb *seq);
600
601/* unsolicited event */
602int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex);
603
604/*
605 * Mixer
606 */
607int snd_hda_build_controls(struct hda_bus *bus);
608
609/*
610 * PCM
611 */
612int snd_hda_build_pcms(struct hda_bus *bus);
613void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid, u32 stream_tag,
614 int channel_id, int format);
615unsigned int snd_hda_calc_stream_format(unsigned int rate, unsigned int channels,
616 unsigned int format, unsigned int maxbps);
617int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid,
618 u32 *ratesp, u64 *formatsp, unsigned int *bpsp);
619int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid,
620 unsigned int format);
621
622/*
623 * Misc
624 */
625void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen);
626
627/*
628 * power management
629 */
630#ifdef CONFIG_PM
631int snd_hda_suspend(struct hda_bus *bus, pm_message_t state);
632int snd_hda_resume(struct hda_bus *bus);
633#endif
634
635#endif /* __SOUND_HDA_CODEC_H */