hda_codec.h 17 KB

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