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