]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
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 (7<<8) | |
180 | #define AC_PINCAP_VREF_SHIFT 8 | |
181 | #define AC_PINCAP_EAPD (1<<16) /* EAPD capable */ | |
182 | /* Vref status (used in pin cap and pin ctl) */ | |
183 | #define AC_PIN_VREF_HIZ (1<<0) /* Hi-Z */ | |
184 | #define AC_PIN_VREF_50 (1<<1) /* 50% */ | |
185 | #define AC_PIN_VREF_GRD (1<<2) /* ground */ | |
186 | #define AC_PIN_VREF_80 (1<<4) /* 80% */ | |
187 | #define AC_PIN_VREF_100 (1<<5) /* 100% */ | |
188 | ||
189 | ||
190 | /* Amplifier capabilities */ | |
191 | #define AC_AMPCAP_OFFSET (0x7f<<0) /* 0dB offset */ | |
192 | #define AC_AMPCAP_OFFSET_SHIFT 0 | |
193 | #define AC_AMPCAP_NUM_STEPS (0x7f<<8) /* number of steps */ | |
194 | #define AC_AMPCAP_NUM_STEPS_SHIFT 8 | |
195 | #define AC_AMPCAP_STEP_SIZE (0x7f<<16) /* step size 0-32dB in 0.25dB */ | |
196 | #define AC_AMPCAP_STEP_SIZE_SHIFT 16 | |
197 | #define AC_AMPCAP_MUTE (1<<31) /* mute capable */ | |
198 | #define AC_AMPCAP_MUTE_SHIFT 31 | |
199 | ||
200 | /* Connection list */ | |
201 | #define AC_CLIST_LENGTH (0x7f<<0) | |
202 | #define AC_CLIST_LONG (1<<7) | |
203 | ||
204 | /* Supported power status */ | |
205 | #define AC_PWRST_D0SUP (1<<0) | |
206 | #define AC_PWRST_D1SUP (1<<1) | |
207 | #define AC_PWRST_D2SUP (1<<2) | |
208 | #define AC_PWRST_D3SUP (1<<3) | |
209 | ||
210 | /* Processing capabilies */ | |
211 | #define AC_PCAP_BENIGN (1<<0) | |
212 | #define AC_PCAP_NUM_COEF (0xff<<8) | |
213 | ||
214 | /* Volume knobs capabilities */ | |
215 | #define AC_KNBCAP_NUM_STEPS (0x7f<<0) | |
216 | #define AC_KNBCAP_DELTA (1<<8) | |
217 | ||
218 | /* | |
219 | * Control Parameters | |
220 | */ | |
221 | ||
222 | /* Amp gain/mute */ | |
223 | #define AC_AMP_MUTE (1<<8) | |
224 | #define AC_AMP_GAIN (0x7f) | |
225 | #define AC_AMP_GET_INDEX (0xf<<0) | |
226 | ||
227 | #define AC_AMP_GET_LEFT (1<<13) | |
228 | #define AC_AMP_GET_RIGHT (0<<13) | |
229 | #define AC_AMP_GET_OUTPUT (1<<15) | |
230 | #define AC_AMP_GET_INPUT (0<<15) | |
231 | ||
232 | #define AC_AMP_SET_INDEX (0xf<<8) | |
233 | #define AC_AMP_SET_INDEX_SHIFT 8 | |
234 | #define AC_AMP_SET_RIGHT (1<<12) | |
235 | #define AC_AMP_SET_LEFT (1<<13) | |
236 | #define AC_AMP_SET_INPUT (1<<14) | |
237 | #define AC_AMP_SET_OUTPUT (1<<15) | |
238 | ||
239 | /* DIGITAL1 bits */ | |
240 | #define AC_DIG1_ENABLE (1<<0) | |
241 | #define AC_DIG1_V (1<<1) | |
242 | #define AC_DIG1_VCFG (1<<2) | |
243 | #define AC_DIG1_EMPHASIS (1<<3) | |
244 | #define AC_DIG1_COPYRIGHT (1<<4) | |
245 | #define AC_DIG1_NONAUDIO (1<<5) | |
246 | #define AC_DIG1_PROFESSIONAL (1<<6) | |
247 | #define AC_DIG1_LEVEL (1<<7) | |
248 | ||
249 | /* Pin widget control - 8bit */ | |
250 | #define AC_PINCTL_VREFEN (0x7<<0) | |
251 | #define AC_PINCTL_IN_EN (1<<5) | |
252 | #define AC_PINCTL_OUT_EN (1<<6) | |
253 | #define AC_PINCTL_HP_EN (1<<7) | |
254 | ||
255 | /* configuration default - 32bit */ | |
256 | #define AC_DEFCFG_SEQUENCE (0xf<<0) | |
257 | #define AC_DEFCFG_DEF_ASSOC (0xf<<4) | |
258 | #define AC_DEFCFG_MISC (0xf<<8) | |
259 | #define AC_DEFCFG_COLOR (0xf<<12) | |
260 | #define AC_DEFCFG_COLOR_SHIFT 12 | |
261 | #define AC_DEFCFG_CONN_TYPE (0xf<<16) | |
262 | #define AC_DEFCFG_CONN_TYPE_SHIFT 16 | |
263 | #define AC_DEFCFG_DEVICE (0xf<<20) | |
264 | #define AC_DEFCFG_DEVICE_SHIFT 20 | |
265 | #define AC_DEFCFG_LOCATION (0x3f<<24) | |
266 | #define AC_DEFCFG_LOCATION_SHIFT 24 | |
267 | #define AC_DEFCFG_PORT_CONN (0x3<<30) | |
268 | #define AC_DEFCFG_PORT_CONN_SHIFT 30 | |
269 | ||
270 | /* device device types (0x0-0xf) */ | |
271 | enum { | |
272 | AC_JACK_LINE_OUT, | |
273 | AC_JACK_SPEAKER, | |
274 | AC_JACK_HP_OUT, | |
275 | AC_JACK_CD, | |
276 | AC_JACK_SPDIF_OUT, | |
277 | AC_JACK_DIG_OTHER_OUT, | |
278 | AC_JACK_MODEM_LINE_SIDE, | |
279 | AC_JACK_MODEM_HAND_SIDE, | |
280 | AC_JACK_LINE_IN, | |
281 | AC_JACK_AUX, | |
282 | AC_JACK_MIC_IN, | |
283 | AC_JACK_TELEPHONY, | |
284 | AC_JACK_SPDIF_IN, | |
285 | AC_JACK_DIG_OTHER_IN, | |
286 | AC_JACK_OTHER = 0xf, | |
287 | }; | |
288 | ||
289 | /* jack connection types (0x0-0xf) */ | |
290 | enum { | |
291 | AC_JACK_CONN_UNKNOWN, | |
292 | AC_JACK_CONN_1_8, | |
293 | AC_JACK_CONN_1_4, | |
294 | AC_JACK_CONN_ATAPI, | |
295 | AC_JACK_CONN_RCA, | |
296 | AC_JACK_CONN_OPTICAL, | |
297 | AC_JACK_CONN_OTHER_DIGITAL, | |
298 | AC_JACK_CONN_OTHER_ANALOG, | |
299 | AC_JACK_CONN_DIN, | |
300 | AC_JACK_CONN_XLR, | |
301 | AC_JACK_CONN_RJ11, | |
302 | AC_JACK_CONN_COMB, | |
303 | AC_JACK_CONN_OTHER = 0xf, | |
304 | }; | |
305 | ||
306 | /* jack colors (0x0-0xf) */ | |
307 | enum { | |
308 | AC_JACK_COLOR_UNKNOWN, | |
309 | AC_JACK_COLOR_BLACK, | |
310 | AC_JACK_COLOR_GREY, | |
311 | AC_JACK_COLOR_BLUE, | |
312 | AC_JACK_COLOR_GREEN, | |
313 | AC_JACK_COLOR_RED, | |
314 | AC_JACK_COLOR_ORANGE, | |
315 | AC_JACK_COLOR_YELLOW, | |
316 | AC_JACK_COLOR_PURPLE, | |
317 | AC_JACK_COLOR_PINK, | |
318 | AC_JACK_COLOR_WHITE = 0xe, | |
319 | AC_JACK_COLOR_OTHER, | |
320 | }; | |
321 | ||
322 | /* Jack location (0x0-0x3f) */ | |
323 | /* common case */ | |
324 | enum { | |
325 | AC_JACK_LOC_NONE, | |
326 | AC_JACK_LOC_REAR, | |
327 | AC_JACK_LOC_FRONT, | |
328 | AC_JACK_LOC_LEFT, | |
329 | AC_JACK_LOC_RIGHT, | |
330 | AC_JACK_LOC_TOP, | |
331 | AC_JACK_LOC_BOTTOM, | |
332 | }; | |
333 | /* bits 4-5 */ | |
334 | enum { | |
335 | AC_JACK_LOC_EXTERNAL = 0x00, | |
336 | AC_JACK_LOC_INTERNAL = 0x10, | |
337 | AC_JACK_LOC_SEPARATE = 0x20, | |
338 | AC_JACK_LOC_OTHER = 0x30, | |
339 | }; | |
340 | enum { | |
341 | /* external on primary chasis */ | |
342 | AC_JACK_LOC_REAR_PANEL = 0x07, | |
343 | AC_JACK_LOC_DRIVE_BAY, | |
344 | /* internal */ | |
345 | AC_JACK_LOC_RISER = 0x17, | |
346 | AC_JACK_LOC_HDMI, | |
347 | AC_JACK_LOC_ATAPI, | |
348 | /* others */ | |
349 | AC_JACK_LOC_MOBILE_IN = 0x37, | |
350 | AC_JACK_LOC_MOBILE_OUT, | |
351 | }; | |
352 | ||
353 | /* Port connectivity (0-3) */ | |
354 | enum { | |
355 | AC_JACK_PORT_COMPLEX, | |
356 | AC_JACK_PORT_NONE, | |
357 | AC_JACK_PORT_FIXED, | |
358 | AC_JACK_PORT_BOTH, | |
359 | }; | |
360 | ||
361 | /* max. connections to a widget */ | |
362 | #define HDA_MAX_CONNECTIONS 16 | |
363 | ||
364 | /* max. codec address */ | |
365 | #define HDA_MAX_CODEC_ADDRESS 0x0f | |
366 | ||
367 | /* | |
368 | * Structures | |
369 | */ | |
370 | ||
371 | struct hda_bus; | |
372 | struct hda_codec; | |
373 | struct hda_pcm; | |
374 | struct hda_pcm_stream; | |
375 | struct hda_bus_unsolicited; | |
376 | ||
377 | /* NID type */ | |
378 | typedef u16 hda_nid_t; | |
379 | ||
380 | /* bus operators */ | |
381 | struct hda_bus_ops { | |
382 | /* send a single command */ | |
383 | int (*command)(struct hda_codec *codec, hda_nid_t nid, int direct, | |
384 | unsigned int verb, unsigned int parm); | |
385 | /* get a response from the last command */ | |
386 | unsigned int (*get_response)(struct hda_codec *codec); | |
387 | /* free the private data */ | |
388 | void (*private_free)(struct hda_bus *); | |
389 | }; | |
390 | ||
391 | /* template to pass to the bus constructor */ | |
392 | struct hda_bus_template { | |
393 | void *private_data; | |
394 | struct pci_dev *pci; | |
395 | const char *modelname; | |
396 | struct hda_bus_ops ops; | |
397 | }; | |
398 | ||
399 | /* | |
400 | * codec bus | |
401 | * | |
402 | * each controller needs to creata a hda_bus to assign the accessor. | |
403 | * A hda_bus contains several codecs in the list codec_list. | |
404 | */ | |
405 | struct hda_bus { | |
406 | snd_card_t *card; | |
407 | ||
408 | /* copied from template */ | |
409 | void *private_data; | |
410 | struct pci_dev *pci; | |
411 | const char *modelname; | |
412 | struct hda_bus_ops ops; | |
413 | ||
414 | /* codec linked list */ | |
415 | struct list_head codec_list; | |
416 | struct hda_codec *caddr_tbl[HDA_MAX_CODEC_ADDRESS]; /* caddr -> codec */ | |
417 | ||
418 | struct semaphore cmd_mutex; | |
419 | ||
420 | /* unsolicited event queue */ | |
421 | struct hda_bus_unsolicited *unsol; | |
422 | ||
423 | snd_info_entry_t *proc; | |
424 | }; | |
425 | ||
426 | /* | |
427 | * codec preset | |
428 | * | |
429 | * Known codecs have the patch to build and set up the controls/PCMs | |
430 | * better than the generic parser. | |
431 | */ | |
432 | struct hda_codec_preset { | |
433 | unsigned int id; | |
434 | unsigned int mask; | |
435 | unsigned int subs; | |
436 | unsigned int subs_mask; | |
437 | unsigned int rev; | |
438 | const char *name; | |
439 | int (*patch)(struct hda_codec *codec); | |
440 | }; | |
441 | ||
442 | /* ops set by the preset patch */ | |
443 | struct hda_codec_ops { | |
444 | int (*build_controls)(struct hda_codec *codec); | |
445 | int (*build_pcms)(struct hda_codec *codec); | |
446 | int (*init)(struct hda_codec *codec); | |
447 | void (*free)(struct hda_codec *codec); | |
448 | void (*unsol_event)(struct hda_codec *codec, unsigned int res); | |
449 | #ifdef CONFIG_PM | |
450 | int (*suspend)(struct hda_codec *codec, pm_message_t state); | |
451 | int (*resume)(struct hda_codec *codec); | |
452 | #endif | |
453 | }; | |
454 | ||
455 | /* record for amp information cache */ | |
456 | struct hda_amp_info { | |
457 | u32 key; /* hash key */ | |
458 | u32 amp_caps; /* amp capabilities */ | |
459 | u16 vol[2]; /* current volume & mute*/ | |
460 | u16 status; /* update flag */ | |
461 | u16 next; /* next link */ | |
462 | }; | |
463 | ||
464 | /* PCM callbacks */ | |
465 | struct hda_pcm_ops { | |
466 | int (*open)(struct hda_pcm_stream *info, struct hda_codec *codec, | |
467 | snd_pcm_substream_t *substream); | |
468 | int (*close)(struct hda_pcm_stream *info, struct hda_codec *codec, | |
469 | snd_pcm_substream_t *substream); | |
470 | int (*prepare)(struct hda_pcm_stream *info, struct hda_codec *codec, | |
471 | unsigned int stream_tag, unsigned int format, | |
472 | snd_pcm_substream_t *substream); | |
473 | int (*cleanup)(struct hda_pcm_stream *info, struct hda_codec *codec, | |
474 | snd_pcm_substream_t *substream); | |
475 | }; | |
476 | ||
477 | /* PCM information for each substream */ | |
478 | struct hda_pcm_stream { | |
479 | unsigned int substreams; /* number of substreams, 0 = not exist */ | |
480 | unsigned int channels_min; /* min. number of channels */ | |
481 | unsigned int channels_max; /* max. number of channels */ | |
482 | hda_nid_t nid; /* default NID to query rates/formats/bps, or set up */ | |
483 | u32 rates; /* supported rates */ | |
484 | u64 formats; /* supported formats (SNDRV_PCM_FMTBIT_) */ | |
485 | unsigned int maxbps; /* supported max. bit per sample */ | |
486 | struct hda_pcm_ops ops; | |
487 | }; | |
488 | ||
489 | /* for PCM creation */ | |
490 | struct hda_pcm { | |
491 | char *name; | |
492 | struct hda_pcm_stream stream[2]; | |
493 | }; | |
494 | ||
495 | /* codec information */ | |
496 | struct hda_codec { | |
497 | struct hda_bus *bus; | |
498 | unsigned int addr; /* codec addr*/ | |
499 | struct list_head list; /* list point */ | |
500 | ||
501 | hda_nid_t afg; /* AFG node id */ | |
502 | ||
503 | /* ids */ | |
504 | u32 vendor_id; | |
505 | u32 subsystem_id; | |
506 | u32 revision_id; | |
507 | ||
508 | /* detected preset */ | |
509 | const struct hda_codec_preset *preset; | |
510 | ||
511 | /* set by patch */ | |
512 | struct hda_codec_ops patch_ops; | |
513 | ||
514 | /* resume phase - all controls should update even if | |
515 | * the values are not changed | |
516 | */ | |
517 | unsigned int in_resume; | |
518 | ||
519 | /* PCM to create, set by patch_ops.build_pcms callback */ | |
520 | unsigned int num_pcms; | |
521 | struct hda_pcm *pcm_info; | |
522 | ||
523 | /* codec specific info */ | |
524 | void *spec; | |
525 | ||
526 | /* hash for amp access */ | |
527 | u16 amp_hash[32]; | |
528 | int num_amp_entries; | |
529 | struct hda_amp_info amp_info[128]; /* big enough? */ | |
530 | ||
531 | struct semaphore spdif_mutex; | |
532 | unsigned int spdif_status; /* IEC958 status bits */ | |
533 | unsigned short spdif_ctls; /* SPDIF control bits */ | |
534 | unsigned int spdif_in_enable; /* SPDIF input enable? */ | |
535 | }; | |
536 | ||
537 | /* direction */ | |
538 | enum { | |
539 | HDA_INPUT, HDA_OUTPUT | |
540 | }; | |
541 | ||
542 | ||
543 | /* | |
544 | * constructors | |
545 | */ | |
546 | int snd_hda_bus_new(snd_card_t *card, const struct hda_bus_template *temp, | |
547 | struct hda_bus **busp); | |
548 | int snd_hda_codec_new(struct hda_bus *bus, unsigned int codec_addr, | |
549 | struct hda_codec **codecp); | |
550 | ||
551 | /* | |
552 | * low level functions | |
553 | */ | |
554 | unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid, int direct, | |
555 | unsigned int verb, unsigned int parm); | |
556 | int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int direct, | |
557 | unsigned int verb, unsigned int parm); | |
558 | #define snd_hda_param_read(codec, nid, param) snd_hda_codec_read(codec, nid, 0, AC_VERB_PARAMETERS, param) | |
559 | int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *start_id); | |
560 | int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid, hda_nid_t *conn_list, int max_conns); | |
561 | ||
562 | struct hda_verb { | |
563 | hda_nid_t nid; | |
564 | u32 verb; | |
565 | u32 param; | |
566 | }; | |
567 | ||
568 | void snd_hda_sequence_write(struct hda_codec *codec, const struct hda_verb *seq); | |
569 | ||
570 | /* unsolicited event */ | |
571 | int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex); | |
572 | ||
573 | /* | |
574 | * Mixer | |
575 | */ | |
576 | int snd_hda_build_controls(struct hda_bus *bus); | |
577 | ||
578 | /* | |
579 | * PCM | |
580 | */ | |
581 | int snd_hda_build_pcms(struct hda_bus *bus); | |
582 | void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid, u32 stream_tag, | |
583 | int channel_id, int format); | |
584 | unsigned int snd_hda_calc_stream_format(unsigned int rate, unsigned int channels, | |
585 | unsigned int format, unsigned int maxbps); | |
586 | int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid, | |
587 | u32 *ratesp, u64 *formatsp, unsigned int *bpsp); | |
588 | int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid, | |
589 | unsigned int format); | |
590 | ||
591 | /* | |
592 | * Misc | |
593 | */ | |
594 | void snd_hda_get_codec_name(struct hda_codec *codec, char *name, int namelen); | |
595 | ||
596 | /* | |
597 | * power management | |
598 | */ | |
599 | #ifdef CONFIG_PM | |
600 | int snd_hda_suspend(struct hda_bus *bus, pm_message_t state); | |
601 | int snd_hda_resume(struct hda_bus *bus); | |
602 | #endif | |
603 | ||
604 | #endif /* __SOUND_HDA_CODEC_H */ |