Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 */ |