2 * Universal Interface for Intel High Definition Audio Codec
4 * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de>
7 * This driver is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This driver is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #include <linux/init.h>
24 #include <linux/delay.h>
25 #include <linux/slab.h>
26 #include <linux/pci.h>
27 #include <linux/mutex.h>
28 #include <linux/module.h>
29 #include <sound/core.h>
30 #include "hda_codec.h"
31 #include <sound/asoundef.h>
32 #include <sound/tlv.h>
33 #include <sound/initval.h>
34 #include <sound/jack.h>
35 #include "hda_local.h"
38 #include <sound/hda_hwdep.h>
40 #define CREATE_TRACE_POINTS
41 #include "hda_trace.h"
44 * vendor / preset table
47 struct hda_vendor_id {
52 /* codec vendor labels */
53 static struct hda_vendor_id hda_vendor_ids[] = {
55 { 0x1013, "Cirrus Logic" },
56 { 0x1057, "Motorola" },
57 { 0x1095, "Silicon Image" },
59 { 0x10ec, "Realtek" },
60 { 0x1102, "Creative" },
64 { 0x11d4, "Analog Devices" },
65 { 0x13f6, "C-Media" },
66 { 0x14f1, "Conexant" },
67 { 0x17e8, "Chrontel" },
69 { 0x1aec, "Wolfson Microelectronics" },
70 { 0x434d, "C-Media" },
72 { 0x8384, "SigmaTel" },
76 static DEFINE_MUTEX(preset_mutex);
77 static LIST_HEAD(hda_preset_tables);
79 int snd_hda_add_codec_preset(struct hda_codec_preset_list *preset)
81 mutex_lock(&preset_mutex);
82 list_add_tail(&preset->list, &hda_preset_tables);
83 mutex_unlock(&preset_mutex);
86 EXPORT_SYMBOL_HDA(snd_hda_add_codec_preset);
88 int snd_hda_delete_codec_preset(struct hda_codec_preset_list *preset)
90 mutex_lock(&preset_mutex);
91 list_del(&preset->list);
92 mutex_unlock(&preset_mutex);
95 EXPORT_SYMBOL_HDA(snd_hda_delete_codec_preset);
98 #define codec_in_pm(codec) ((codec)->in_pm)
99 static void hda_power_work(struct work_struct *work);
100 static void hda_keep_power_on(struct hda_codec *codec);
101 #define hda_codec_is_power_on(codec) ((codec)->power_on)
102 static inline void hda_call_pm_notify(struct hda_bus *bus, bool power_up)
104 if (bus->ops.pm_notify)
105 bus->ops.pm_notify(bus, power_up);
108 #define codec_in_pm(codec) 0
109 static inline void hda_keep_power_on(struct hda_codec *codec) {}
110 #define hda_codec_is_power_on(codec) 1
111 #define hda_call_pm_notify(bus, state) {}
115 * snd_hda_get_jack_location - Give a location string of the jack
116 * @cfg: pin default config value
118 * Parse the pin default config value and returns the string of the
119 * jack location, e.g. "Rear", "Front", etc.
121 const char *snd_hda_get_jack_location(u32 cfg)
123 static char *bases[7] = {
124 "N/A", "Rear", "Front", "Left", "Right", "Top", "Bottom",
126 static unsigned char specials_idx[] = {
131 static char *specials[] = {
132 "Rear Panel", "Drive Bar",
133 "Riser", "HDMI", "ATAPI",
134 "Mobile-In", "Mobile-Out"
137 cfg = (cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT;
138 if ((cfg & 0x0f) < 7)
139 return bases[cfg & 0x0f];
140 for (i = 0; i < ARRAY_SIZE(specials_idx); i++) {
141 if (cfg == specials_idx[i])
146 EXPORT_SYMBOL_HDA(snd_hda_get_jack_location);
149 * snd_hda_get_jack_connectivity - Give a connectivity string of the jack
150 * @cfg: pin default config value
152 * Parse the pin default config value and returns the string of the
153 * jack connectivity, i.e. external or internal connection.
155 const char *snd_hda_get_jack_connectivity(u32 cfg)
157 static char *jack_locations[4] = { "Ext", "Int", "Sep", "Oth" };
159 return jack_locations[(cfg >> (AC_DEFCFG_LOCATION_SHIFT + 4)) & 3];
161 EXPORT_SYMBOL_HDA(snd_hda_get_jack_connectivity);
164 * snd_hda_get_jack_type - Give a type string of the jack
165 * @cfg: pin default config value
167 * Parse the pin default config value and returns the string of the
168 * jack type, i.e. the purpose of the jack, such as Line-Out or CD.
170 const char *snd_hda_get_jack_type(u32 cfg)
172 static char *jack_types[16] = {
173 "Line Out", "Speaker", "HP Out", "CD",
174 "SPDIF Out", "Digital Out", "Modem Line", "Modem Hand",
175 "Line In", "Aux", "Mic", "Telephony",
176 "SPDIF In", "Digital In", "Reserved", "Other"
179 return jack_types[(cfg & AC_DEFCFG_DEVICE)
180 >> AC_DEFCFG_DEVICE_SHIFT];
182 EXPORT_SYMBOL_HDA(snd_hda_get_jack_type);
185 * Compose a 32bit command word to be sent to the HD-audio controller
187 static inline unsigned int
188 make_codec_cmd(struct hda_codec *codec, hda_nid_t nid, int flags,
189 unsigned int verb, unsigned int parm)
193 if ((codec->addr & ~0xf) || (nid & ~0x7f) ||
194 (verb & ~0xfff) || (parm & ~0xffff)) {
195 printk(KERN_ERR "hda-codec: out of range cmd %x:%x:%x:%x\n",
196 codec->addr, nid, verb, parm);
200 val = (u32)codec->addr << 28;
201 val |= (u32)nid << 20;
208 * Send and receive a verb
210 static int codec_exec_verb(struct hda_codec *codec, unsigned int cmd,
211 int flags, unsigned int *res)
213 struct hda_bus *bus = codec->bus;
222 snd_hda_power_up(codec);
223 mutex_lock(&bus->cmd_mutex);
224 if (flags & HDA_RW_NO_RESPONSE_FALLBACK)
225 bus->no_response_fallback = 1;
227 trace_hda_send_cmd(codec, cmd);
228 err = bus->ops.command(bus, cmd);
231 /* process pending verbs */
232 bus->ops.get_response(bus, codec->addr);
235 *res = bus->ops.get_response(bus, codec->addr);
236 trace_hda_get_response(codec, *res);
238 bus->no_response_fallback = 0;
239 mutex_unlock(&bus->cmd_mutex);
240 snd_hda_power_down(codec);
241 if (!codec_in_pm(codec) && res && *res == -1 && bus->rirb_error) {
242 if (bus->response_reset) {
243 snd_printd("hda_codec: resetting BUS due to "
244 "fatal communication error\n");
245 trace_hda_bus_reset(bus);
246 bus->ops.bus_reset(bus);
250 /* clear reset-flag when the communication gets recovered */
251 if (!err || codec_in_pm(codec))
252 bus->response_reset = 0;
257 * snd_hda_codec_read - send a command and get the response
258 * @codec: the HDA codec
259 * @nid: NID to send the command
260 * @flags: optional bit flags
261 * @verb: the verb to send
262 * @parm: the parameter for the verb
264 * Send a single command and read the corresponding response.
266 * Returns the obtained response value, or -1 for an error.
268 unsigned int snd_hda_codec_read(struct hda_codec *codec, hda_nid_t nid,
270 unsigned int verb, unsigned int parm)
272 unsigned cmd = make_codec_cmd(codec, nid, flags, verb, parm);
274 if (codec_exec_verb(codec, cmd, flags, &res))
278 EXPORT_SYMBOL_HDA(snd_hda_codec_read);
281 * snd_hda_codec_write - send a single command without waiting for response
282 * @codec: the HDA codec
283 * @nid: NID to send the command
284 * @flags: optional bit flags
285 * @verb: the verb to send
286 * @parm: the parameter for the verb
288 * Send a single command without waiting for response.
290 * Returns 0 if successful, or a negative error code.
292 int snd_hda_codec_write(struct hda_codec *codec, hda_nid_t nid, int flags,
293 unsigned int verb, unsigned int parm)
295 unsigned int cmd = make_codec_cmd(codec, nid, flags, verb, parm);
297 return codec_exec_verb(codec, cmd, flags,
298 codec->bus->sync_write ? &res : NULL);
300 EXPORT_SYMBOL_HDA(snd_hda_codec_write);
303 * snd_hda_sequence_write - sequence writes
304 * @codec: the HDA codec
305 * @seq: VERB array to send
307 * Send the commands sequentially from the given array.
308 * The array must be terminated with NID=0.
310 void snd_hda_sequence_write(struct hda_codec *codec, const struct hda_verb *seq)
312 for (; seq->nid; seq++)
313 snd_hda_codec_write(codec, seq->nid, 0, seq->verb, seq->param);
315 EXPORT_SYMBOL_HDA(snd_hda_sequence_write);
318 * snd_hda_get_sub_nodes - get the range of sub nodes
319 * @codec: the HDA codec
321 * @start_id: the pointer to store the start NID
323 * Parse the NID and store the start NID of its sub-nodes.
324 * Returns the number of sub-nodes.
326 int snd_hda_get_sub_nodes(struct hda_codec *codec, hda_nid_t nid,
331 parm = snd_hda_param_read(codec, nid, AC_PAR_NODE_COUNT);
334 *start_id = (parm >> 16) & 0x7fff;
335 return (int)(parm & 0x7fff);
337 EXPORT_SYMBOL_HDA(snd_hda_get_sub_nodes);
339 /* connection list element */
340 struct hda_conn_list {
341 struct list_head list;
347 /* look up the cached results */
348 static struct hda_conn_list *
349 lookup_conn_list(struct hda_codec *codec, hda_nid_t nid)
351 struct hda_conn_list *p;
352 list_for_each_entry(p, &codec->conn_list, list) {
359 static int add_conn_list(struct hda_codec *codec, hda_nid_t nid, int len,
360 const hda_nid_t *list)
362 struct hda_conn_list *p;
364 p = kmalloc(sizeof(*p) + len * sizeof(hda_nid_t), GFP_KERNEL);
369 memcpy(p->conns, list, len * sizeof(hda_nid_t));
370 list_add(&p->list, &codec->conn_list);
374 static void remove_conn_list(struct hda_codec *codec)
376 while (!list_empty(&codec->conn_list)) {
377 struct hda_conn_list *p;
378 p = list_first_entry(&codec->conn_list, typeof(*p), list);
384 /* read the connection and add to the cache */
385 static int read_and_add_raw_conns(struct hda_codec *codec, hda_nid_t nid)
388 hda_nid_t *result = list;
391 len = snd_hda_get_raw_connections(codec, nid, list, ARRAY_SIZE(list));
392 if (len == -ENOSPC) {
393 len = snd_hda_get_num_raw_conns(codec, nid);
394 result = kmalloc(sizeof(hda_nid_t) * len, GFP_KERNEL);
397 len = snd_hda_get_raw_connections(codec, nid, result, len);
400 len = snd_hda_override_conn_list(codec, nid, len, result);
407 * snd_hda_get_conn_list - get connection list
408 * @codec: the HDA codec
410 * @len: number of connection list entries
411 * @listp: the pointer to store NID list
413 * Parses the connection list of the given widget and stores the pointer
414 * to the list of NIDs.
416 * Returns the number of connections, or a negative error code.
418 * Note that the returned pointer isn't protected against the list
419 * modification. If snd_hda_override_conn_list() might be called
420 * concurrently, protect with a mutex appropriately.
422 int snd_hda_get_conn_list(struct hda_codec *codec, hda_nid_t nid,
423 const hda_nid_t **listp)
429 const struct hda_conn_list *p;
431 /* if the connection-list is already cached, read it */
432 p = lookup_conn_list(codec, nid);
438 if (snd_BUG_ON(added))
441 err = read_and_add_raw_conns(codec, nid);
447 EXPORT_SYMBOL_HDA(snd_hda_get_conn_list);
450 * snd_hda_get_connections - copy connection list
451 * @codec: the HDA codec
453 * @conn_list: connection list array; when NULL, checks only the size
454 * @max_conns: max. number of connections to store
456 * Parses the connection list of the given widget and stores the list
459 * Returns the number of connections, or a negative error code.
461 int snd_hda_get_connections(struct hda_codec *codec, hda_nid_t nid,
462 hda_nid_t *conn_list, int max_conns)
464 const hda_nid_t *list;
465 int len = snd_hda_get_conn_list(codec, nid, &list);
467 if (len > 0 && conn_list) {
468 if (len > max_conns) {
469 snd_printk(KERN_ERR "hda_codec: "
470 "Too many connections %d for NID 0x%x\n",
474 memcpy(conn_list, list, len * sizeof(hda_nid_t));
479 EXPORT_SYMBOL_HDA(snd_hda_get_connections);
481 /* return CONNLIST_LEN parameter of the given widget */
482 static unsigned int get_num_conns(struct hda_codec *codec, hda_nid_t nid)
484 unsigned int wcaps = get_wcaps(codec, nid);
487 if (!(wcaps & AC_WCAP_CONN_LIST) &&
488 get_wcaps_type(wcaps) != AC_WID_VOL_KNB)
491 parm = snd_hda_param_read(codec, nid, AC_PAR_CONNLIST_LEN);
497 int snd_hda_get_num_raw_conns(struct hda_codec *codec, hda_nid_t nid)
499 return snd_hda_get_raw_connections(codec, nid, NULL, 0);
503 * snd_hda_get_raw_connections - copy connection list without cache
504 * @codec: the HDA codec
506 * @conn_list: connection list array
507 * @max_conns: max. number of connections to store
509 * Like snd_hda_get_connections(), copy the connection list but without
510 * checking through the connection-list cache.
511 * Currently called only from hda_proc.c, so not exported.
513 int snd_hda_get_raw_connections(struct hda_codec *codec, hda_nid_t nid,
514 hda_nid_t *conn_list, int max_conns)
517 int i, conn_len, conns;
518 unsigned int shift, num_elems, mask;
522 parm = get_num_conns(codec, nid);
526 if (parm & AC_CLIST_LONG) {
535 conn_len = parm & AC_CLIST_LENGTH;
536 mask = (1 << (shift-1)) - 1;
539 return 0; /* no connection */
542 /* single connection */
543 parm = snd_hda_codec_read(codec, nid, 0,
544 AC_VERB_GET_CONNECT_LIST, 0);
545 if (parm == -1 && codec->bus->rirb_error)
548 conn_list[0] = parm & mask;
552 /* multi connection */
555 for (i = 0; i < conn_len; i++) {
559 if (i % num_elems == 0) {
560 parm = snd_hda_codec_read(codec, nid, 0,
561 AC_VERB_GET_CONNECT_LIST, i);
562 if (parm == -1 && codec->bus->rirb_error)
565 range_val = !!(parm & (1 << (shift-1))); /* ranges */
567 if (val == 0 && null_count++) { /* no second chance */
568 snd_printdd("hda_codec: "
569 "invalid CONNECT_LIST verb %x[%i]:%x\n",
575 /* ranges between the previous and this one */
576 if (!prev_nid || prev_nid >= val) {
577 snd_printk(KERN_WARNING "hda_codec: "
578 "invalid dep_range_val %x:%x\n",
582 for (n = prev_nid + 1; n <= val; n++) {
584 if (conns >= max_conns)
586 conn_list[conns] = n;
592 if (conns >= max_conns)
594 conn_list[conns] = val;
604 * snd_hda_override_conn_list - add/modify the connection-list to cache
605 * @codec: the HDA codec
607 * @len: number of connection list entries
608 * @list: the list of connection entries
610 * Add or modify the given connection-list to the cache. If the corresponding
611 * cache already exists, invalidate it and append a new one.
613 * Returns zero or a negative error code.
615 int snd_hda_override_conn_list(struct hda_codec *codec, hda_nid_t nid, int len,
616 const hda_nid_t *list)
618 struct hda_conn_list *p;
620 p = lookup_conn_list(codec, nid);
626 return add_conn_list(codec, nid, len, list);
628 EXPORT_SYMBOL_HDA(snd_hda_override_conn_list);
631 * snd_hda_get_conn_index - get the connection index of the given NID
632 * @codec: the HDA codec
633 * @mux: NID containing the list
634 * @nid: NID to select
635 * @recursive: 1 when searching NID recursively, otherwise 0
637 * Parses the connection list of the widget @mux and checks whether the
638 * widget @nid is present. If it is, return the connection index.
639 * Otherwise it returns -1.
641 int snd_hda_get_conn_index(struct hda_codec *codec, hda_nid_t mux,
642 hda_nid_t nid, int recursive)
644 const hda_nid_t *conn;
647 nums = snd_hda_get_conn_list(codec, mux, &conn);
648 for (i = 0; i < nums; i++)
653 if (recursive > 10) {
654 snd_printd("hda_codec: too deep connection for 0x%x\n", nid);
658 for (i = 0; i < nums; i++) {
659 unsigned int type = get_wcaps_type(get_wcaps(codec, conn[i]));
660 if (type == AC_WID_PIN || type == AC_WID_AUD_OUT)
662 if (snd_hda_get_conn_index(codec, conn[i], nid, recursive) >= 0)
667 EXPORT_SYMBOL_HDA(snd_hda_get_conn_index);
670 /* return DEVLIST_LEN parameter of the given widget */
671 static unsigned int get_num_devices(struct hda_codec *codec, hda_nid_t nid)
673 unsigned int wcaps = get_wcaps(codec, nid);
676 if (!codec->dp_mst || !(wcaps & AC_WCAP_DIGITAL) ||
677 get_wcaps_type(wcaps) != AC_WID_PIN)
680 parm = snd_hda_param_read(codec, nid, AC_PAR_DEVLIST_LEN);
681 if (parm == -1 && codec->bus->rirb_error)
683 return parm & AC_DEV_LIST_LEN_MASK;
687 * snd_hda_get_devices - copy device list without cache
688 * @codec: the HDA codec
689 * @nid: NID of the pin to parse
690 * @dev_list: device list array
691 * @max_devices: max. number of devices to store
693 * Copy the device list. This info is dynamic and so not cached.
694 * Currently called only from hda_proc.c, so not exported.
696 int snd_hda_get_devices(struct hda_codec *codec, hda_nid_t nid,
697 u8 *dev_list, int max_devices)
700 int i, dev_len, devices;
702 parm = get_num_devices(codec, nid);
703 if (!parm) /* not multi-stream capable */
707 dev_len = dev_len < max_devices ? dev_len : max_devices;
710 while (devices < dev_len) {
711 parm = snd_hda_codec_read(codec, nid, 0,
712 AC_VERB_GET_DEVICE_LIST, devices);
713 if (parm == -1 && codec->bus->rirb_error)
716 for (i = 0; i < 8; i++) {
717 dev_list[devices] = (u8)parm;
720 if (devices >= dev_len)
728 * snd_hda_queue_unsol_event - add an unsolicited event to queue
730 * @res: unsolicited event (lower 32bit of RIRB entry)
731 * @res_ex: codec addr and flags (upper 32bit or RIRB entry)
733 * Adds the given event to the queue. The events are processed in
734 * the workqueue asynchronously. Call this function in the interrupt
735 * hanlder when RIRB receives an unsolicited event.
737 * Returns 0 if successful, or a negative error code.
739 int snd_hda_queue_unsol_event(struct hda_bus *bus, u32 res, u32 res_ex)
741 struct hda_bus_unsolicited *unsol;
744 if (!bus || !bus->workq)
747 trace_hda_unsol_event(bus, res, res_ex);
752 wp = (unsol->wp + 1) % HDA_UNSOL_QUEUE_SIZE;
756 unsol->queue[wp] = res;
757 unsol->queue[wp + 1] = res_ex;
759 queue_work(bus->workq, &unsol->work);
763 EXPORT_SYMBOL_HDA(snd_hda_queue_unsol_event);
766 * process queued unsolicited events
768 static void process_unsol_events(struct work_struct *work)
770 struct hda_bus_unsolicited *unsol =
771 container_of(work, struct hda_bus_unsolicited, work);
772 struct hda_bus *bus = unsol->bus;
773 struct hda_codec *codec;
774 unsigned int rp, caddr, res;
776 while (unsol->rp != unsol->wp) {
777 rp = (unsol->rp + 1) % HDA_UNSOL_QUEUE_SIZE;
780 res = unsol->queue[rp];
781 caddr = unsol->queue[rp + 1];
782 if (!(caddr & (1 << 4))) /* no unsolicited event? */
784 codec = bus->caddr_tbl[caddr & 0x0f];
785 if (codec && codec->patch_ops.unsol_event)
786 codec->patch_ops.unsol_event(codec, res);
791 * initialize unsolicited queue
793 static int init_unsol_queue(struct hda_bus *bus)
795 struct hda_bus_unsolicited *unsol;
797 if (bus->unsol) /* already initialized */
800 unsol = kzalloc(sizeof(*unsol), GFP_KERNEL);
802 snd_printk(KERN_ERR "hda_codec: "
803 "can't allocate unsolicited queue\n");
806 INIT_WORK(&unsol->work, process_unsol_events);
815 static void snd_hda_codec_free(struct hda_codec *codec);
817 static int snd_hda_bus_free(struct hda_bus *bus)
819 struct hda_codec *codec, *n;
824 flush_workqueue(bus->workq);
827 list_for_each_entry_safe(codec, n, &bus->codec_list, list) {
828 snd_hda_codec_free(codec);
830 if (bus->ops.private_free)
831 bus->ops.private_free(bus);
833 destroy_workqueue(bus->workq);
838 static int snd_hda_bus_dev_free(struct snd_device *device)
840 struct hda_bus *bus = device->device_data;
842 return snd_hda_bus_free(bus);
845 #ifdef CONFIG_SND_HDA_HWDEP
846 static int snd_hda_bus_dev_register(struct snd_device *device)
848 struct hda_bus *bus = device->device_data;
849 struct hda_codec *codec;
850 list_for_each_entry(codec, &bus->codec_list, list) {
851 snd_hda_hwdep_add_sysfs(codec);
852 snd_hda_hwdep_add_power_sysfs(codec);
857 #define snd_hda_bus_dev_register NULL
861 * snd_hda_bus_new - create a HDA bus
862 * @card: the card entry
863 * @temp: the template for hda_bus information
864 * @busp: the pointer to store the created bus instance
866 * Returns 0 if successful, or a negative error code.
868 int snd_hda_bus_new(struct snd_card *card,
869 const struct hda_bus_template *temp,
870 struct hda_bus **busp)
874 static struct snd_device_ops dev_ops = {
875 .dev_register = snd_hda_bus_dev_register,
876 .dev_free = snd_hda_bus_dev_free,
879 if (snd_BUG_ON(!temp))
881 if (snd_BUG_ON(!temp->ops.command || !temp->ops.get_response))
887 bus = kzalloc(sizeof(*bus), GFP_KERNEL);
889 snd_printk(KERN_ERR "can't allocate struct hda_bus\n");
894 bus->private_data = temp->private_data;
895 bus->pci = temp->pci;
896 bus->modelname = temp->modelname;
897 bus->power_save = temp->power_save;
898 bus->ops = temp->ops;
900 mutex_init(&bus->cmd_mutex);
901 mutex_init(&bus->prepare_mutex);
902 INIT_LIST_HEAD(&bus->codec_list);
904 snprintf(bus->workq_name, sizeof(bus->workq_name),
905 "hd-audio%d", card->number);
906 bus->workq = create_singlethread_workqueue(bus->workq_name);
908 snd_printk(KERN_ERR "cannot create workqueue %s\n",
914 err = snd_device_new(card, SNDRV_DEV_BUS, bus, &dev_ops);
916 snd_hda_bus_free(bus);
923 EXPORT_SYMBOL_HDA(snd_hda_bus_new);
925 #ifdef CONFIG_SND_HDA_GENERIC
926 #define is_generic_config(codec) \
927 (codec->modelname && !strcmp(codec->modelname, "generic"))
929 #define is_generic_config(codec) 0
933 #define HDA_MODREQ_MAX_COUNT 2 /* two request_modules()'s */
935 #define HDA_MODREQ_MAX_COUNT 0 /* all presets are statically linked */
939 * find a matching codec preset
941 static const struct hda_codec_preset *
942 find_codec_preset(struct hda_codec *codec)
944 struct hda_codec_preset_list *tbl;
945 const struct hda_codec_preset *preset;
946 unsigned int mod_requested = 0;
948 if (is_generic_config(codec))
949 return NULL; /* use the generic parser */
952 mutex_lock(&preset_mutex);
953 list_for_each_entry(tbl, &hda_preset_tables, list) {
954 if (!try_module_get(tbl->owner)) {
955 snd_printk(KERN_ERR "hda_codec: cannot module_get\n");
958 for (preset = tbl->preset; preset->id; preset++) {
959 u32 mask = preset->mask;
960 if (preset->afg && preset->afg != codec->afg)
962 if (preset->mfg && preset->mfg != codec->mfg)
966 if (preset->id == (codec->vendor_id & mask) &&
968 preset->rev == codec->revision_id)) {
969 mutex_unlock(&preset_mutex);
970 codec->owner = tbl->owner;
974 module_put(tbl->owner);
976 mutex_unlock(&preset_mutex);
978 if (mod_requested < HDA_MODREQ_MAX_COUNT) {
981 snprintf(name, sizeof(name), "snd-hda-codec-id:%08x",
984 snprintf(name, sizeof(name), "snd-hda-codec-id:%04x*",
985 (codec->vendor_id >> 16) & 0xffff);
986 request_module(name);
994 * get_codec_name - store the codec name
996 static int get_codec_name(struct hda_codec *codec)
998 const struct hda_vendor_id *c;
999 const char *vendor = NULL;
1000 u16 vendor_id = codec->vendor_id >> 16;
1003 if (codec->vendor_name)
1006 for (c = hda_vendor_ids; c->id; c++) {
1007 if (c->id == vendor_id) {
1013 sprintf(tmp, "Generic %04x", vendor_id);
1016 codec->vendor_name = kstrdup(vendor, GFP_KERNEL);
1017 if (!codec->vendor_name)
1021 if (codec->chip_name)
1024 if (codec->preset && codec->preset->name)
1025 codec->chip_name = kstrdup(codec->preset->name, GFP_KERNEL);
1027 sprintf(tmp, "ID %x", codec->vendor_id & 0xffff);
1028 codec->chip_name = kstrdup(tmp, GFP_KERNEL);
1030 if (!codec->chip_name)
1036 * look for an AFG and MFG nodes
1038 static void setup_fg_nodes(struct hda_codec *codec)
1040 int i, total_nodes, function_id;
1043 total_nodes = snd_hda_get_sub_nodes(codec, AC_NODE_ROOT, &nid);
1044 for (i = 0; i < total_nodes; i++, nid++) {
1045 function_id = snd_hda_param_read(codec, nid,
1046 AC_PAR_FUNCTION_TYPE);
1047 switch (function_id & 0xff) {
1048 case AC_GRP_AUDIO_FUNCTION:
1050 codec->afg_function_id = function_id & 0xff;
1051 codec->afg_unsol = (function_id >> 8) & 1;
1053 case AC_GRP_MODEM_FUNCTION:
1055 codec->mfg_function_id = function_id & 0xff;
1056 codec->mfg_unsol = (function_id >> 8) & 1;
1065 * read widget caps for each widget and store in cache
1067 static int read_widget_caps(struct hda_codec *codec, hda_nid_t fg_node)
1072 codec->num_nodes = snd_hda_get_sub_nodes(codec, fg_node,
1074 codec->wcaps = kmalloc(codec->num_nodes * 4, GFP_KERNEL);
1077 nid = codec->start_nid;
1078 for (i = 0; i < codec->num_nodes; i++, nid++)
1079 codec->wcaps[i] = snd_hda_param_read(codec, nid,
1080 AC_PAR_AUDIO_WIDGET_CAP);
1084 /* read all pin default configurations and save codec->init_pins */
1085 static int read_pin_defaults(struct hda_codec *codec)
1088 hda_nid_t nid = codec->start_nid;
1090 for (i = 0; i < codec->num_nodes; i++, nid++) {
1091 struct hda_pincfg *pin;
1092 unsigned int wcaps = get_wcaps(codec, nid);
1093 unsigned int wid_type = get_wcaps_type(wcaps);
1094 if (wid_type != AC_WID_PIN)
1096 pin = snd_array_new(&codec->init_pins);
1100 pin->cfg = snd_hda_codec_read(codec, nid, 0,
1101 AC_VERB_GET_CONFIG_DEFAULT, 0);
1102 pin->ctrl = snd_hda_codec_read(codec, nid, 0,
1103 AC_VERB_GET_PIN_WIDGET_CONTROL,
1109 /* look up the given pin config list and return the item matching with NID */
1110 static struct hda_pincfg *look_up_pincfg(struct hda_codec *codec,
1111 struct snd_array *array,
1115 for (i = 0; i < array->used; i++) {
1116 struct hda_pincfg *pin = snd_array_elem(array, i);
1117 if (pin->nid == nid)
1123 /* set the current pin config value for the given NID.
1124 * the value is cached, and read via snd_hda_codec_get_pincfg()
1126 int snd_hda_add_pincfg(struct hda_codec *codec, struct snd_array *list,
1127 hda_nid_t nid, unsigned int cfg)
1129 struct hda_pincfg *pin;
1131 /* the check below may be invalid when pins are added by a fixup
1132 * dynamically (e.g. via snd_hda_codec_update_widgets()), so disabled
1136 if (get_wcaps_type(get_wcaps(codec, nid)) != AC_WID_PIN)
1140 pin = look_up_pincfg(codec, list, nid);
1142 pin = snd_array_new(list);
1152 * snd_hda_codec_set_pincfg - Override a pin default configuration
1153 * @codec: the HDA codec
1154 * @nid: NID to set the pin config
1155 * @cfg: the pin default config value
1157 * Override a pin default configuration value in the cache.
1158 * This value can be read by snd_hda_codec_get_pincfg() in a higher
1159 * priority than the real hardware value.
1161 int snd_hda_codec_set_pincfg(struct hda_codec *codec,
1162 hda_nid_t nid, unsigned int cfg)
1164 return snd_hda_add_pincfg(codec, &codec->driver_pins, nid, cfg);
1166 EXPORT_SYMBOL_HDA(snd_hda_codec_set_pincfg);
1169 * snd_hda_codec_get_pincfg - Obtain a pin-default configuration
1170 * @codec: the HDA codec
1171 * @nid: NID to get the pin config
1173 * Get the current pin config value of the given pin NID.
1174 * If the pincfg value is cached or overridden via sysfs or driver,
1175 * returns the cached value.
1177 unsigned int snd_hda_codec_get_pincfg(struct hda_codec *codec, hda_nid_t nid)
1179 struct hda_pincfg *pin;
1181 #ifdef CONFIG_SND_HDA_HWDEP
1183 unsigned int cfg = 0;
1184 mutex_lock(&codec->user_mutex);
1185 pin = look_up_pincfg(codec, &codec->user_pins, nid);
1188 mutex_unlock(&codec->user_mutex);
1193 pin = look_up_pincfg(codec, &codec->driver_pins, nid);
1196 pin = look_up_pincfg(codec, &codec->init_pins, nid);
1201 EXPORT_SYMBOL_HDA(snd_hda_codec_get_pincfg);
1203 /* remember the current pinctl target value */
1204 int snd_hda_codec_set_pin_target(struct hda_codec *codec, hda_nid_t nid,
1207 struct hda_pincfg *pin;
1209 pin = look_up_pincfg(codec, &codec->init_pins, nid);
1215 EXPORT_SYMBOL_HDA(snd_hda_codec_set_pin_target);
1217 /* return the current pinctl target value */
1218 int snd_hda_codec_get_pin_target(struct hda_codec *codec, hda_nid_t nid)
1220 struct hda_pincfg *pin;
1222 pin = look_up_pincfg(codec, &codec->init_pins, nid);
1227 EXPORT_SYMBOL_HDA(snd_hda_codec_get_pin_target);
1230 * snd_hda_shutup_pins - Shut up all pins
1231 * @codec: the HDA codec
1233 * Clear all pin controls to shup up before suspend for avoiding click noise.
1234 * The controls aren't cached so that they can be resumed properly.
1236 void snd_hda_shutup_pins(struct hda_codec *codec)
1239 /* don't shut up pins when unloading the driver; otherwise it breaks
1240 * the default pin setup at the next load of the driver
1242 if (codec->bus->shutdown)
1244 for (i = 0; i < codec->init_pins.used; i++) {
1245 struct hda_pincfg *pin = snd_array_elem(&codec->init_pins, i);
1246 /* use read here for syncing after issuing each verb */
1247 snd_hda_codec_read(codec, pin->nid, 0,
1248 AC_VERB_SET_PIN_WIDGET_CONTROL, 0);
1250 codec->pins_shutup = 1;
1252 EXPORT_SYMBOL_HDA(snd_hda_shutup_pins);
1255 /* Restore the pin controls cleared previously via snd_hda_shutup_pins() */
1256 static void restore_shutup_pins(struct hda_codec *codec)
1259 if (!codec->pins_shutup)
1261 if (codec->bus->shutdown)
1263 for (i = 0; i < codec->init_pins.used; i++) {
1264 struct hda_pincfg *pin = snd_array_elem(&codec->init_pins, i);
1265 snd_hda_codec_write(codec, pin->nid, 0,
1266 AC_VERB_SET_PIN_WIDGET_CONTROL,
1269 codec->pins_shutup = 0;
1273 static void hda_jackpoll_work(struct work_struct *work)
1275 struct hda_codec *codec =
1276 container_of(work, struct hda_codec, jackpoll_work.work);
1278 snd_hda_jack_set_dirty_all(codec);
1279 snd_hda_jack_poll_all(codec);
1281 if (!codec->jackpoll_interval)
1284 queue_delayed_work(codec->bus->workq, &codec->jackpoll_work,
1285 codec->jackpoll_interval);
1288 static void init_hda_cache(struct hda_cache_rec *cache,
1289 unsigned int record_size);
1290 static void free_hda_cache(struct hda_cache_rec *cache);
1292 /* release all pincfg lists */
1293 static void free_init_pincfgs(struct hda_codec *codec)
1295 snd_array_free(&codec->driver_pins);
1296 #ifdef CONFIG_SND_HDA_HWDEP
1297 snd_array_free(&codec->user_pins);
1299 snd_array_free(&codec->init_pins);
1303 * audio-converter setup caches
1305 struct hda_cvt_setup {
1310 unsigned char active; /* cvt is currently used */
1311 unsigned char dirty; /* setups should be cleared */
1314 /* get or create a cache entry for the given audio converter NID */
1315 static struct hda_cvt_setup *
1316 get_hda_cvt_setup(struct hda_codec *codec, hda_nid_t nid)
1318 struct hda_cvt_setup *p;
1321 for (i = 0; i < codec->cvt_setups.used; i++) {
1322 p = snd_array_elem(&codec->cvt_setups, i);
1326 p = snd_array_new(&codec->cvt_setups);
1335 static void snd_hda_codec_free(struct hda_codec *codec)
1339 cancel_delayed_work_sync(&codec->jackpoll_work);
1340 snd_hda_jack_tbl_clear(codec);
1341 free_init_pincfgs(codec);
1343 cancel_delayed_work(&codec->power_work);
1344 flush_workqueue(codec->bus->workq);
1346 list_del(&codec->list);
1347 snd_array_free(&codec->mixers);
1348 snd_array_free(&codec->nids);
1349 snd_array_free(&codec->cvt_setups);
1350 snd_array_free(&codec->spdif_out);
1351 remove_conn_list(codec);
1352 codec->bus->caddr_tbl[codec->addr] = NULL;
1353 if (codec->patch_ops.free)
1354 codec->patch_ops.free(codec);
1356 if (!codec->pm_down_notified) /* cancel leftover refcounts */
1357 hda_call_pm_notify(codec->bus, false);
1359 module_put(codec->owner);
1360 free_hda_cache(&codec->amp_cache);
1361 free_hda_cache(&codec->cmd_cache);
1362 kfree(codec->vendor_name);
1363 kfree(codec->chip_name);
1364 kfree(codec->modelname);
1365 kfree(codec->wcaps);
1369 static bool snd_hda_codec_get_supported_ps(struct hda_codec *codec,
1370 hda_nid_t fg, unsigned int power_state);
1372 static unsigned int hda_set_power_state(struct hda_codec *codec,
1373 unsigned int power_state);
1376 * snd_hda_codec_new - create a HDA codec
1377 * @bus: the bus to assign
1378 * @codec_addr: the codec address
1379 * @codecp: the pointer to store the generated codec
1381 * Returns 0 if successful, or a negative error code.
1383 int snd_hda_codec_new(struct hda_bus *bus,
1384 unsigned int codec_addr,
1385 struct hda_codec **codecp)
1387 struct hda_codec *codec;
1392 if (snd_BUG_ON(!bus))
1394 if (snd_BUG_ON(codec_addr > HDA_MAX_CODEC_ADDRESS))
1397 if (bus->caddr_tbl[codec_addr]) {
1398 snd_printk(KERN_ERR "hda_codec: "
1399 "address 0x%x is already occupied\n", codec_addr);
1403 codec = kzalloc(sizeof(*codec), GFP_KERNEL);
1404 if (codec == NULL) {
1405 snd_printk(KERN_ERR "can't allocate struct hda_codec\n");
1410 codec->addr = codec_addr;
1411 mutex_init(&codec->spdif_mutex);
1412 mutex_init(&codec->control_mutex);
1413 mutex_init(&codec->hash_mutex);
1414 init_hda_cache(&codec->amp_cache, sizeof(struct hda_amp_info));
1415 init_hda_cache(&codec->cmd_cache, sizeof(struct hda_cache_head));
1416 snd_array_init(&codec->mixers, sizeof(struct hda_nid_item), 32);
1417 snd_array_init(&codec->nids, sizeof(struct hda_nid_item), 32);
1418 snd_array_init(&codec->init_pins, sizeof(struct hda_pincfg), 16);
1419 snd_array_init(&codec->driver_pins, sizeof(struct hda_pincfg), 16);
1420 snd_array_init(&codec->cvt_setups, sizeof(struct hda_cvt_setup), 8);
1421 snd_array_init(&codec->spdif_out, sizeof(struct hda_spdif_out), 16);
1422 snd_array_init(&codec->jacktbl, sizeof(struct hda_jack_tbl), 16);
1423 snd_array_init(&codec->verbs, sizeof(struct hda_verb *), 8);
1424 INIT_LIST_HEAD(&codec->conn_list);
1426 INIT_DELAYED_WORK(&codec->jackpoll_work, hda_jackpoll_work);
1429 spin_lock_init(&codec->power_lock);
1430 INIT_DELAYED_WORK(&codec->power_work, hda_power_work);
1431 /* snd_hda_codec_new() marks the codec as power-up, and leave it as is.
1432 * the caller has to power down appropriatley after initialization
1435 hda_keep_power_on(codec);
1436 hda_call_pm_notify(bus, true);
1439 if (codec->bus->modelname) {
1440 codec->modelname = kstrdup(codec->bus->modelname, GFP_KERNEL);
1441 if (!codec->modelname) {
1442 snd_hda_codec_free(codec);
1447 list_add_tail(&codec->list, &bus->codec_list);
1448 bus->caddr_tbl[codec_addr] = codec;
1450 codec->vendor_id = snd_hda_param_read(codec, AC_NODE_ROOT,
1452 if (codec->vendor_id == -1)
1453 /* read again, hopefully the access method was corrected
1454 * in the last read...
1456 codec->vendor_id = snd_hda_param_read(codec, AC_NODE_ROOT,
1458 codec->subsystem_id = snd_hda_param_read(codec, AC_NODE_ROOT,
1459 AC_PAR_SUBSYSTEM_ID);
1460 codec->revision_id = snd_hda_param_read(codec, AC_NODE_ROOT,
1463 setup_fg_nodes(codec);
1464 if (!codec->afg && !codec->mfg) {
1465 snd_printdd("hda_codec: no AFG or MFG node found\n");
1470 fg = codec->afg ? codec->afg : codec->mfg;
1471 err = read_widget_caps(codec, fg);
1473 snd_printk(KERN_ERR "hda_codec: cannot malloc\n");
1476 err = read_pin_defaults(codec);
1480 if (!codec->subsystem_id) {
1481 codec->subsystem_id =
1482 snd_hda_codec_read(codec, fg, 0,
1483 AC_VERB_GET_SUBSYSTEM_ID, 0);
1487 codec->d3_stop_clk = snd_hda_codec_get_supported_ps(codec, fg,
1489 if (!codec->d3_stop_clk)
1490 bus->power_keep_link_on = 1;
1492 codec->epss = snd_hda_codec_get_supported_ps(codec, fg,
1495 /* power-up all before initialization */
1496 hda_set_power_state(codec, AC_PWRST_D0);
1498 snd_hda_codec_proc_new(codec);
1500 snd_hda_create_hwdep(codec);
1502 sprintf(component, "HDA:%08x,%08x,%08x", codec->vendor_id,
1503 codec->subsystem_id, codec->revision_id);
1504 snd_component_add(codec->bus->card, component);
1511 snd_hda_codec_free(codec);
1514 EXPORT_SYMBOL_HDA(snd_hda_codec_new);
1516 int snd_hda_codec_update_widgets(struct hda_codec *codec)
1521 /* Assume the function group node does not change,
1522 * only the widget nodes may change.
1524 kfree(codec->wcaps);
1525 fg = codec->afg ? codec->afg : codec->mfg;
1526 err = read_widget_caps(codec, fg);
1528 snd_printk(KERN_ERR "hda_codec: cannot malloc\n");
1532 snd_array_free(&codec->init_pins);
1533 err = read_pin_defaults(codec);
1537 EXPORT_SYMBOL_HDA(snd_hda_codec_update_widgets);
1541 * snd_hda_codec_configure - (Re-)configure the HD-audio codec
1542 * @codec: the HDA codec
1544 * Start parsing of the given codec tree and (re-)initialize the whole
1547 * Returns 0 if successful or a negative error code.
1549 int snd_hda_codec_configure(struct hda_codec *codec)
1553 codec->preset = find_codec_preset(codec);
1554 if (!codec->vendor_name || !codec->chip_name) {
1555 err = get_codec_name(codec);
1560 if (is_generic_config(codec)) {
1561 err = snd_hda_parse_generic_codec(codec);
1564 if (codec->preset && codec->preset->patch) {
1565 err = codec->preset->patch(codec);
1569 /* call the default parser */
1570 err = snd_hda_parse_generic_codec(codec);
1572 printk(KERN_ERR "hda-codec: No codec parser is available\n");
1575 if (!err && codec->patch_ops.unsol_event)
1576 err = init_unsol_queue(codec->bus);
1577 /* audio codec should override the mixer name */
1578 if (!err && (codec->afg || !*codec->bus->card->mixername))
1579 snprintf(codec->bus->card->mixername,
1580 sizeof(codec->bus->card->mixername),
1581 "%s %s", codec->vendor_name, codec->chip_name);
1584 EXPORT_SYMBOL_HDA(snd_hda_codec_configure);
1586 /* update the stream-id if changed */
1587 static void update_pcm_stream_id(struct hda_codec *codec,
1588 struct hda_cvt_setup *p, hda_nid_t nid,
1589 u32 stream_tag, int channel_id)
1591 unsigned int oldval, newval;
1593 if (p->stream_tag != stream_tag || p->channel_id != channel_id) {
1594 oldval = snd_hda_codec_read(codec, nid, 0, AC_VERB_GET_CONV, 0);
1595 newval = (stream_tag << 4) | channel_id;
1596 if (oldval != newval)
1597 snd_hda_codec_write(codec, nid, 0,
1598 AC_VERB_SET_CHANNEL_STREAMID,
1600 p->stream_tag = stream_tag;
1601 p->channel_id = channel_id;
1605 /* update the format-id if changed */
1606 static void update_pcm_format(struct hda_codec *codec, struct hda_cvt_setup *p,
1607 hda_nid_t nid, int format)
1609 unsigned int oldval;
1611 if (p->format_id != format) {
1612 oldval = snd_hda_codec_read(codec, nid, 0,
1613 AC_VERB_GET_STREAM_FORMAT, 0);
1614 if (oldval != format) {
1616 snd_hda_codec_write(codec, nid, 0,
1617 AC_VERB_SET_STREAM_FORMAT,
1620 p->format_id = format;
1625 * snd_hda_codec_setup_stream - set up the codec for streaming
1626 * @codec: the CODEC to set up
1627 * @nid: the NID to set up
1628 * @stream_tag: stream tag to pass, it's between 0x1 and 0xf.
1629 * @channel_id: channel id to pass, zero based.
1630 * @format: stream format.
1632 void snd_hda_codec_setup_stream(struct hda_codec *codec, hda_nid_t nid,
1634 int channel_id, int format)
1636 struct hda_codec *c;
1637 struct hda_cvt_setup *p;
1644 snd_printdd("hda_codec_setup_stream: "
1645 "NID=0x%x, stream=0x%x, channel=%d, format=0x%x\n",
1646 nid, stream_tag, channel_id, format);
1647 p = get_hda_cvt_setup(codec, nid);
1651 if (codec->pcm_format_first)
1652 update_pcm_format(codec, p, nid, format);
1653 update_pcm_stream_id(codec, p, nid, stream_tag, channel_id);
1654 if (!codec->pcm_format_first)
1655 update_pcm_format(codec, p, nid, format);
1660 /* make other inactive cvts with the same stream-tag dirty */
1661 type = get_wcaps_type(get_wcaps(codec, nid));
1662 list_for_each_entry(c, &codec->bus->codec_list, list) {
1663 for (i = 0; i < c->cvt_setups.used; i++) {
1664 p = snd_array_elem(&c->cvt_setups, i);
1665 if (!p->active && p->stream_tag == stream_tag &&
1666 get_wcaps_type(get_wcaps(c, p->nid)) == type)
1671 EXPORT_SYMBOL_HDA(snd_hda_codec_setup_stream);
1673 static void really_cleanup_stream(struct hda_codec *codec,
1674 struct hda_cvt_setup *q);
1677 * __snd_hda_codec_cleanup_stream - clean up the codec for closing
1678 * @codec: the CODEC to clean up
1679 * @nid: the NID to clean up
1680 * @do_now: really clean up the stream instead of clearing the active flag
1682 void __snd_hda_codec_cleanup_stream(struct hda_codec *codec, hda_nid_t nid,
1685 struct hda_cvt_setup *p;
1690 if (codec->no_sticky_stream)
1693 snd_printdd("hda_codec_cleanup_stream: NID=0x%x\n", nid);
1694 p = get_hda_cvt_setup(codec, nid);
1696 /* here we just clear the active flag when do_now isn't set;
1697 * actual clean-ups will be done later in
1698 * purify_inactive_streams() called from snd_hda_codec_prpapre()
1701 really_cleanup_stream(codec, p);
1706 EXPORT_SYMBOL_HDA(__snd_hda_codec_cleanup_stream);
1708 static void really_cleanup_stream(struct hda_codec *codec,
1709 struct hda_cvt_setup *q)
1711 hda_nid_t nid = q->nid;
1712 if (q->stream_tag || q->channel_id)
1713 snd_hda_codec_write(codec, nid, 0, AC_VERB_SET_CHANNEL_STREAMID, 0);
1715 snd_hda_codec_write(codec, nid, 0, AC_VERB_SET_STREAM_FORMAT, 0
1717 memset(q, 0, sizeof(*q));
1721 /* clean up the all conflicting obsolete streams */
1722 static void purify_inactive_streams(struct hda_codec *codec)
1724 struct hda_codec *c;
1727 list_for_each_entry(c, &codec->bus->codec_list, list) {
1728 for (i = 0; i < c->cvt_setups.used; i++) {
1729 struct hda_cvt_setup *p;
1730 p = snd_array_elem(&c->cvt_setups, i);
1732 really_cleanup_stream(c, p);
1738 /* clean up all streams; called from suspend */
1739 static void hda_cleanup_all_streams(struct hda_codec *codec)
1743 for (i = 0; i < codec->cvt_setups.used; i++) {
1744 struct hda_cvt_setup *p = snd_array_elem(&codec->cvt_setups, i);
1746 really_cleanup_stream(codec, p);
1752 * amp access functions
1755 /* FIXME: more better hash key? */
1756 #define HDA_HASH_KEY(nid, dir, idx) (u32)((nid) + ((idx) << 16) + ((dir) << 24))
1757 #define HDA_HASH_PINCAP_KEY(nid) (u32)((nid) + (0x02 << 24))
1758 #define HDA_HASH_PARPCM_KEY(nid) (u32)((nid) + (0x03 << 24))
1759 #define HDA_HASH_PARSTR_KEY(nid) (u32)((nid) + (0x04 << 24))
1760 #define INFO_AMP_CAPS (1<<0)
1761 #define INFO_AMP_VOL(ch) (1 << (1 + (ch)))
1763 /* initialize the hash table */
1764 static void init_hda_cache(struct hda_cache_rec *cache,
1765 unsigned int record_size)
1767 memset(cache, 0, sizeof(*cache));
1768 memset(cache->hash, 0xff, sizeof(cache->hash));
1769 snd_array_init(&cache->buf, record_size, 64);
1772 static void free_hda_cache(struct hda_cache_rec *cache)
1774 snd_array_free(&cache->buf);
1777 /* query the hash. allocate an entry if not found. */
1778 static struct hda_cache_head *get_hash(struct hda_cache_rec *cache, u32 key)
1780 u16 idx = key % (u16)ARRAY_SIZE(cache->hash);
1781 u16 cur = cache->hash[idx];
1782 struct hda_cache_head *info;
1784 while (cur != 0xffff) {
1785 info = snd_array_elem(&cache->buf, cur);
1786 if (info->key == key)
1793 /* query the hash. allocate an entry if not found. */
1794 static struct hda_cache_head *get_alloc_hash(struct hda_cache_rec *cache,
1797 struct hda_cache_head *info = get_hash(cache, key);
1800 /* add a new hash entry */
1801 info = snd_array_new(&cache->buf);
1804 cur = snd_array_index(&cache->buf, info);
1808 idx = key % (u16)ARRAY_SIZE(cache->hash);
1809 info->next = cache->hash[idx];
1810 cache->hash[idx] = cur;
1815 /* query and allocate an amp hash entry */
1816 static inline struct hda_amp_info *
1817 get_alloc_amp_hash(struct hda_codec *codec, u32 key)
1819 return (struct hda_amp_info *)get_alloc_hash(&codec->amp_cache, key);
1822 /* overwrite the value with the key in the caps hash */
1823 static int write_caps_hash(struct hda_codec *codec, u32 key, unsigned int val)
1825 struct hda_amp_info *info;
1827 mutex_lock(&codec->hash_mutex);
1828 info = get_alloc_amp_hash(codec, key);
1830 mutex_unlock(&codec->hash_mutex);
1833 info->amp_caps = val;
1834 info->head.val |= INFO_AMP_CAPS;
1835 mutex_unlock(&codec->hash_mutex);
1839 /* query the value from the caps hash; if not found, fetch the current
1840 * value from the given function and store in the hash
1843 query_caps_hash(struct hda_codec *codec, hda_nid_t nid, int dir, u32 key,
1844 unsigned int (*func)(struct hda_codec *, hda_nid_t, int))
1846 struct hda_amp_info *info;
1849 mutex_lock(&codec->hash_mutex);
1850 info = get_alloc_amp_hash(codec, key);
1852 mutex_unlock(&codec->hash_mutex);
1855 if (!(info->head.val & INFO_AMP_CAPS)) {
1856 mutex_unlock(&codec->hash_mutex); /* for reentrance */
1857 val = func(codec, nid, dir);
1858 write_caps_hash(codec, key, val);
1860 val = info->amp_caps;
1861 mutex_unlock(&codec->hash_mutex);
1866 static unsigned int read_amp_cap(struct hda_codec *codec, hda_nid_t nid,
1869 if (!(get_wcaps(codec, nid) & AC_WCAP_AMP_OVRD))
1871 return snd_hda_param_read(codec, nid,
1872 direction == HDA_OUTPUT ?
1873 AC_PAR_AMP_OUT_CAP : AC_PAR_AMP_IN_CAP);
1877 * query_amp_caps - query AMP capabilities
1878 * @codec: the HD-auio codec
1879 * @nid: the NID to query
1880 * @direction: either #HDA_INPUT or #HDA_OUTPUT
1882 * Query AMP capabilities for the given widget and direction.
1883 * Returns the obtained capability bits.
1885 * When cap bits have been already read, this doesn't read again but
1886 * returns the cached value.
1888 u32 query_amp_caps(struct hda_codec *codec, hda_nid_t nid, int direction)
1890 return query_caps_hash(codec, nid, direction,
1891 HDA_HASH_KEY(nid, direction, 0),
1894 EXPORT_SYMBOL_HDA(query_amp_caps);
1897 * snd_hda_override_amp_caps - Override the AMP capabilities
1898 * @codec: the CODEC to clean up
1899 * @nid: the NID to clean up
1900 * @direction: either #HDA_INPUT or #HDA_OUTPUT
1901 * @caps: the capability bits to set
1903 * Override the cached AMP caps bits value by the given one.
1904 * This function is useful if the driver needs to adjust the AMP ranges,
1905 * e.g. limit to 0dB, etc.
1907 * Returns zero if successful or a negative error code.
1909 int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,
1912 return write_caps_hash(codec, HDA_HASH_KEY(nid, dir, 0), caps);
1914 EXPORT_SYMBOL_HDA(snd_hda_override_amp_caps);
1916 static unsigned int read_pin_cap(struct hda_codec *codec, hda_nid_t nid,
1919 return snd_hda_param_read(codec, nid, AC_PAR_PIN_CAP);
1923 * snd_hda_query_pin_caps - Query PIN capabilities
1924 * @codec: the HD-auio codec
1925 * @nid: the NID to query
1927 * Query PIN capabilities for the given widget.
1928 * Returns the obtained capability bits.
1930 * When cap bits have been already read, this doesn't read again but
1931 * returns the cached value.
1933 u32 snd_hda_query_pin_caps(struct hda_codec *codec, hda_nid_t nid)
1935 return query_caps_hash(codec, nid, 0, HDA_HASH_PINCAP_KEY(nid),
1938 EXPORT_SYMBOL_HDA(snd_hda_query_pin_caps);
1941 * snd_hda_override_pin_caps - Override the pin capabilities
1943 * @nid: the NID to override
1944 * @caps: the capability bits to set
1946 * Override the cached PIN capabilitiy bits value by the given one.
1948 * Returns zero if successful or a negative error code.
1950 int snd_hda_override_pin_caps(struct hda_codec *codec, hda_nid_t nid,
1953 return write_caps_hash(codec, HDA_HASH_PINCAP_KEY(nid), caps);
1955 EXPORT_SYMBOL_HDA(snd_hda_override_pin_caps);
1957 /* read or sync the hash value with the current value;
1958 * call within hash_mutex
1960 static struct hda_amp_info *
1961 update_amp_hash(struct hda_codec *codec, hda_nid_t nid, int ch,
1962 int direction, int index, bool init_only)
1964 struct hda_amp_info *info;
1965 unsigned int parm, val = 0;
1966 bool val_read = false;
1969 info = get_alloc_amp_hash(codec, HDA_HASH_KEY(nid, direction, index));
1972 if (!(info->head.val & INFO_AMP_VOL(ch))) {
1974 mutex_unlock(&codec->hash_mutex);
1975 parm = ch ? AC_AMP_GET_RIGHT : AC_AMP_GET_LEFT;
1976 parm |= direction == HDA_OUTPUT ?
1977 AC_AMP_GET_OUTPUT : AC_AMP_GET_INPUT;
1979 val = snd_hda_codec_read(codec, nid, 0,
1980 AC_VERB_GET_AMP_GAIN_MUTE, parm);
1983 mutex_lock(&codec->hash_mutex);
1986 info->vol[ch] = val;
1987 info->head.val |= INFO_AMP_VOL(ch);
1988 } else if (init_only)
1994 * write the current volume in info to the h/w
1996 static void put_vol_mute(struct hda_codec *codec, unsigned int amp_caps,
1997 hda_nid_t nid, int ch, int direction, int index,
2002 parm = ch ? AC_AMP_SET_RIGHT : AC_AMP_SET_LEFT;
2003 parm |= direction == HDA_OUTPUT ? AC_AMP_SET_OUTPUT : AC_AMP_SET_INPUT;
2004 parm |= index << AC_AMP_SET_INDEX_SHIFT;
2005 if ((val & HDA_AMP_MUTE) && !(amp_caps & AC_AMPCAP_MUTE) &&
2006 (amp_caps & AC_AMPCAP_MIN_MUTE))
2007 ; /* set the zero value as a fake mute */
2010 snd_hda_codec_write(codec, nid, 0, AC_VERB_SET_AMP_GAIN_MUTE, parm);
2014 * snd_hda_codec_amp_read - Read AMP value
2015 * @codec: HD-audio codec
2016 * @nid: NID to read the AMP value
2017 * @ch: channel (left=0 or right=1)
2018 * @direction: #HDA_INPUT or #HDA_OUTPUT
2019 * @index: the index value (only for input direction)
2021 * Read AMP value. The volume is between 0 to 0x7f, 0x80 = mute bit.
2023 int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,
2024 int direction, int index)
2026 struct hda_amp_info *info;
2027 unsigned int val = 0;
2029 mutex_lock(&codec->hash_mutex);
2030 info = update_amp_hash(codec, nid, ch, direction, index, false);
2032 val = info->vol[ch];
2033 mutex_unlock(&codec->hash_mutex);
2036 EXPORT_SYMBOL_HDA(snd_hda_codec_amp_read);
2038 static int codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
2039 int direction, int idx, int mask, int val,
2042 struct hda_amp_info *info;
2044 unsigned int cache_only;
2046 if (snd_BUG_ON(mask & ~0xff))
2050 mutex_lock(&codec->hash_mutex);
2051 info = update_amp_hash(codec, nid, ch, direction, idx, init_only);
2053 mutex_unlock(&codec->hash_mutex);
2056 val |= info->vol[ch] & ~mask;
2057 if (info->vol[ch] == val) {
2058 mutex_unlock(&codec->hash_mutex);
2061 info->vol[ch] = val;
2062 cache_only = info->head.dirty = codec->cached_write;
2063 caps = info->amp_caps;
2064 mutex_unlock(&codec->hash_mutex);
2066 put_vol_mute(codec, caps, nid, ch, direction, idx, val);
2071 * snd_hda_codec_amp_update - update the AMP value
2072 * @codec: HD-audio codec
2073 * @nid: NID to read the AMP value
2074 * @ch: channel (left=0 or right=1)
2075 * @direction: #HDA_INPUT or #HDA_OUTPUT
2076 * @idx: the index value (only for input direction)
2077 * @mask: bit mask to set
2078 * @val: the bits value to set
2080 * Update the AMP value with a bit mask.
2081 * Returns 0 if the value is unchanged, 1 if changed.
2083 int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,
2084 int direction, int idx, int mask, int val)
2086 return codec_amp_update(codec, nid, ch, direction, idx, mask, val, false);
2088 EXPORT_SYMBOL_HDA(snd_hda_codec_amp_update);
2091 * snd_hda_codec_amp_stereo - update the AMP stereo values
2092 * @codec: HD-audio codec
2093 * @nid: NID to read the AMP value
2094 * @direction: #HDA_INPUT or #HDA_OUTPUT
2095 * @idx: the index value (only for input direction)
2096 * @mask: bit mask to set
2097 * @val: the bits value to set
2099 * Update the AMP values like snd_hda_codec_amp_update(), but for a
2100 * stereo widget with the same mask and value.
2102 int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,
2103 int direction, int idx, int mask, int val)
2107 if (snd_BUG_ON(mask & ~0xff))
2109 for (ch = 0; ch < 2; ch++)
2110 ret |= snd_hda_codec_amp_update(codec, nid, ch, direction,
2114 EXPORT_SYMBOL_HDA(snd_hda_codec_amp_stereo);
2116 /* Works like snd_hda_codec_amp_update() but it writes the value only at
2117 * the first access. If the amp was already initialized / updated beforehand,
2118 * this does nothing.
2120 int snd_hda_codec_amp_init(struct hda_codec *codec, hda_nid_t nid, int ch,
2121 int dir, int idx, int mask, int val)
2123 return codec_amp_update(codec, nid, ch, dir, idx, mask, val, true);
2125 EXPORT_SYMBOL_HDA(snd_hda_codec_amp_init);
2127 int snd_hda_codec_amp_init_stereo(struct hda_codec *codec, hda_nid_t nid,
2128 int dir, int idx, int mask, int val)
2132 if (snd_BUG_ON(mask & ~0xff))
2134 for (ch = 0; ch < 2; ch++)
2135 ret |= snd_hda_codec_amp_init(codec, nid, ch, dir,
2139 EXPORT_SYMBOL_HDA(snd_hda_codec_amp_init_stereo);
2142 * snd_hda_codec_resume_amp - Resume all AMP commands from the cache
2143 * @codec: HD-audio codec
2145 * Resume the all amp commands from the cache.
2147 void snd_hda_codec_resume_amp(struct hda_codec *codec)
2151 mutex_lock(&codec->hash_mutex);
2152 codec->cached_write = 0;
2153 for (i = 0; i < codec->amp_cache.buf.used; i++) {
2154 struct hda_amp_info *buffer;
2157 unsigned int idx, dir, ch;
2158 struct hda_amp_info info;
2160 buffer = snd_array_elem(&codec->amp_cache.buf, i);
2161 if (!buffer->head.dirty)
2163 buffer->head.dirty = 0;
2165 key = info.head.key;
2169 idx = (key >> 16) & 0xff;
2170 dir = (key >> 24) & 0xff;
2171 for (ch = 0; ch < 2; ch++) {
2172 if (!(info.head.val & INFO_AMP_VOL(ch)))
2174 mutex_unlock(&codec->hash_mutex);
2175 put_vol_mute(codec, info.amp_caps, nid, ch, dir, idx,
2177 mutex_lock(&codec->hash_mutex);
2180 mutex_unlock(&codec->hash_mutex);
2182 EXPORT_SYMBOL_HDA(snd_hda_codec_resume_amp);
2184 static u32 get_amp_max_value(struct hda_codec *codec, hda_nid_t nid, int dir,
2187 u32 caps = query_amp_caps(codec, nid, dir);
2189 caps = (caps & AC_AMPCAP_NUM_STEPS) >> AC_AMPCAP_NUM_STEPS_SHIFT;
2196 * snd_hda_mixer_amp_volume_info - Info callback for a standard AMP mixer
2198 * The control element is supposed to have the private_value field
2199 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2201 int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,
2202 struct snd_ctl_elem_info *uinfo)
2204 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2205 u16 nid = get_amp_nid(kcontrol);
2206 u8 chs = get_amp_channels(kcontrol);
2207 int dir = get_amp_direction(kcontrol);
2208 unsigned int ofs = get_amp_offset(kcontrol);
2210 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
2211 uinfo->count = chs == 3 ? 2 : 1;
2212 uinfo->value.integer.min = 0;
2213 uinfo->value.integer.max = get_amp_max_value(codec, nid, dir, ofs);
2214 if (!uinfo->value.integer.max) {
2215 printk(KERN_WARNING "hda_codec: "
2216 "num_steps = 0 for NID=0x%x (ctl = %s)\n", nid,
2222 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_volume_info);
2225 static inline unsigned int
2226 read_amp_value(struct hda_codec *codec, hda_nid_t nid,
2227 int ch, int dir, int idx, unsigned int ofs)
2230 val = snd_hda_codec_amp_read(codec, nid, ch, dir, idx);
2231 val &= HDA_AMP_VOLMASK;
2240 update_amp_value(struct hda_codec *codec, hda_nid_t nid,
2241 int ch, int dir, int idx, unsigned int ofs,
2244 unsigned int maxval;
2248 /* ofs = 0: raw max value */
2249 maxval = get_amp_max_value(codec, nid, dir, 0);
2252 return snd_hda_codec_amp_update(codec, nid, ch, dir, idx,
2253 HDA_AMP_VOLMASK, val);
2257 * snd_hda_mixer_amp_volume_get - Get callback for a standard AMP mixer volume
2259 * The control element is supposed to have the private_value field
2260 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2262 int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,
2263 struct snd_ctl_elem_value *ucontrol)
2265 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2266 hda_nid_t nid = get_amp_nid(kcontrol);
2267 int chs = get_amp_channels(kcontrol);
2268 int dir = get_amp_direction(kcontrol);
2269 int idx = get_amp_index(kcontrol);
2270 unsigned int ofs = get_amp_offset(kcontrol);
2271 long *valp = ucontrol->value.integer.value;
2274 *valp++ = read_amp_value(codec, nid, 0, dir, idx, ofs);
2276 *valp = read_amp_value(codec, nid, 1, dir, idx, ofs);
2279 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_volume_get);
2282 * snd_hda_mixer_amp_volume_put - Put callback for a standard AMP mixer volume
2284 * The control element is supposed to have the private_value field
2285 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2287 int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,
2288 struct snd_ctl_elem_value *ucontrol)
2290 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2291 hda_nid_t nid = get_amp_nid(kcontrol);
2292 int chs = get_amp_channels(kcontrol);
2293 int dir = get_amp_direction(kcontrol);
2294 int idx = get_amp_index(kcontrol);
2295 unsigned int ofs = get_amp_offset(kcontrol);
2296 long *valp = ucontrol->value.integer.value;
2299 snd_hda_power_up(codec);
2301 change = update_amp_value(codec, nid, 0, dir, idx, ofs, *valp);
2305 change |= update_amp_value(codec, nid, 1, dir, idx, ofs, *valp);
2306 snd_hda_power_down(codec);
2309 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_volume_put);
2312 * snd_hda_mixer_amp_volume_put - TLV callback for a standard AMP mixer volume
2314 * The control element is supposed to have the private_value field
2315 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2317 int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,
2318 unsigned int size, unsigned int __user *_tlv)
2320 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2321 hda_nid_t nid = get_amp_nid(kcontrol);
2322 int dir = get_amp_direction(kcontrol);
2323 unsigned int ofs = get_amp_offset(kcontrol);
2324 bool min_mute = get_amp_min_mute(kcontrol);
2325 u32 caps, val1, val2;
2327 if (size < 4 * sizeof(unsigned int))
2329 caps = query_amp_caps(codec, nid, dir);
2330 val2 = (caps & AC_AMPCAP_STEP_SIZE) >> AC_AMPCAP_STEP_SIZE_SHIFT;
2331 val2 = (val2 + 1) * 25;
2332 val1 = -((caps & AC_AMPCAP_OFFSET) >> AC_AMPCAP_OFFSET_SHIFT);
2334 val1 = ((int)val1) * ((int)val2);
2335 if (min_mute || (caps & AC_AMPCAP_MIN_MUTE))
2336 val2 |= TLV_DB_SCALE_MUTE;
2337 if (put_user(SNDRV_CTL_TLVT_DB_SCALE, _tlv))
2339 if (put_user(2 * sizeof(unsigned int), _tlv + 1))
2341 if (put_user(val1, _tlv + 2))
2343 if (put_user(val2, _tlv + 3))
2347 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_tlv);
2350 * snd_hda_set_vmaster_tlv - Set TLV for a virtual master control
2351 * @codec: HD-audio codec
2352 * @nid: NID of a reference widget
2353 * @dir: #HDA_INPUT or #HDA_OUTPUT
2354 * @tlv: TLV data to be stored, at least 4 elements
2356 * Set (static) TLV data for a virtual master volume using the AMP caps
2357 * obtained from the reference NID.
2358 * The volume range is recalculated as if the max volume is 0dB.
2360 void snd_hda_set_vmaster_tlv(struct hda_codec *codec, hda_nid_t nid, int dir,
2366 caps = query_amp_caps(codec, nid, dir);
2367 nums = (caps & AC_AMPCAP_NUM_STEPS) >> AC_AMPCAP_NUM_STEPS_SHIFT;
2368 step = (caps & AC_AMPCAP_STEP_SIZE) >> AC_AMPCAP_STEP_SIZE_SHIFT;
2369 step = (step + 1) * 25;
2370 tlv[0] = SNDRV_CTL_TLVT_DB_SCALE;
2371 tlv[1] = 2 * sizeof(unsigned int);
2372 tlv[2] = -nums * step;
2375 EXPORT_SYMBOL_HDA(snd_hda_set_vmaster_tlv);
2377 /* find a mixer control element with the given name */
2378 static struct snd_kcontrol *
2379 find_mixer_ctl(struct hda_codec *codec, const char *name, int dev, int idx)
2381 struct snd_ctl_elem_id id;
2382 memset(&id, 0, sizeof(id));
2383 id.iface = SNDRV_CTL_ELEM_IFACE_MIXER;
2386 if (snd_BUG_ON(strlen(name) >= sizeof(id.name)))
2388 strcpy(id.name, name);
2389 return snd_ctl_find_id(codec->bus->card, &id);
2393 * snd_hda_find_mixer_ctl - Find a mixer control element with the given name
2394 * @codec: HD-audio codec
2395 * @name: ctl id name string
2397 * Get the control element with the given id string and IFACE_MIXER.
2399 struct snd_kcontrol *snd_hda_find_mixer_ctl(struct hda_codec *codec,
2402 return find_mixer_ctl(codec, name, 0, 0);
2404 EXPORT_SYMBOL_HDA(snd_hda_find_mixer_ctl);
2406 static int find_empty_mixer_ctl_idx(struct hda_codec *codec, const char *name,
2410 /* 16 ctlrs should be large enough */
2411 for (i = 0, idx = start_idx; i < 16; i++, idx++) {
2412 if (!find_mixer_ctl(codec, name, 0, idx))
2419 * snd_hda_ctl_add - Add a control element and assign to the codec
2420 * @codec: HD-audio codec
2421 * @nid: corresponding NID (optional)
2422 * @kctl: the control element to assign
2424 * Add the given control element to an array inside the codec instance.
2425 * All control elements belonging to a codec are supposed to be added
2426 * by this function so that a proper clean-up works at the free or
2427 * reconfiguration time.
2429 * If non-zero @nid is passed, the NID is assigned to the control element.
2430 * The assignment is shown in the codec proc file.
2432 * snd_hda_ctl_add() checks the control subdev id field whether
2433 * #HDA_SUBDEV_NID_FLAG bit is set. If set (and @nid is zero), the lower
2434 * bits value is taken as the NID to assign. The #HDA_NID_ITEM_AMP bit
2435 * specifies if kctl->private_value is a HDA amplifier value.
2437 int snd_hda_ctl_add(struct hda_codec *codec, hda_nid_t nid,
2438 struct snd_kcontrol *kctl)
2441 unsigned short flags = 0;
2442 struct hda_nid_item *item;
2444 if (kctl->id.subdevice & HDA_SUBDEV_AMP_FLAG) {
2445 flags |= HDA_NID_ITEM_AMP;
2447 nid = get_amp_nid_(kctl->private_value);
2449 if ((kctl->id.subdevice & HDA_SUBDEV_NID_FLAG) != 0 && nid == 0)
2450 nid = kctl->id.subdevice & 0xffff;
2451 if (kctl->id.subdevice & (HDA_SUBDEV_NID_FLAG|HDA_SUBDEV_AMP_FLAG))
2452 kctl->id.subdevice = 0;
2453 err = snd_ctl_add(codec->bus->card, kctl);
2456 item = snd_array_new(&codec->mixers);
2461 item->flags = flags;
2464 EXPORT_SYMBOL_HDA(snd_hda_ctl_add);
2467 * snd_hda_add_nid - Assign a NID to a control element
2468 * @codec: HD-audio codec
2469 * @nid: corresponding NID (optional)
2470 * @kctl: the control element to assign
2471 * @index: index to kctl
2473 * Add the given control element to an array inside the codec instance.
2474 * This function is used when #snd_hda_ctl_add cannot be used for 1:1
2475 * NID:KCTL mapping - for example "Capture Source" selector.
2477 int snd_hda_add_nid(struct hda_codec *codec, struct snd_kcontrol *kctl,
2478 unsigned int index, hda_nid_t nid)
2480 struct hda_nid_item *item;
2483 item = snd_array_new(&codec->nids);
2487 item->index = index;
2491 printk(KERN_ERR "hda-codec: no NID for mapping control %s:%d:%d\n",
2492 kctl->id.name, kctl->id.index, index);
2495 EXPORT_SYMBOL_HDA(snd_hda_add_nid);
2498 * snd_hda_ctls_clear - Clear all controls assigned to the given codec
2499 * @codec: HD-audio codec
2501 void snd_hda_ctls_clear(struct hda_codec *codec)
2504 struct hda_nid_item *items = codec->mixers.list;
2505 for (i = 0; i < codec->mixers.used; i++)
2506 snd_ctl_remove(codec->bus->card, items[i].kctl);
2507 snd_array_free(&codec->mixers);
2508 snd_array_free(&codec->nids);
2511 /* pseudo device locking
2512 * toggle card->shutdown to allow/disallow the device access (as a hack)
2514 int snd_hda_lock_devices(struct hda_bus *bus)
2516 struct snd_card *card = bus->card;
2517 struct hda_codec *codec;
2519 spin_lock(&card->files_lock);
2523 if (!list_empty(&card->ctl_files))
2526 list_for_each_entry(codec, &bus->codec_list, list) {
2528 for (pcm = 0; pcm < codec->num_pcms; pcm++) {
2529 struct hda_pcm *cpcm = &codec->pcm_info[pcm];
2532 if (cpcm->pcm->streams[0].substream_opened ||
2533 cpcm->pcm->streams[1].substream_opened)
2537 spin_unlock(&card->files_lock);
2543 spin_unlock(&card->files_lock);
2546 EXPORT_SYMBOL_HDA(snd_hda_lock_devices);
2548 void snd_hda_unlock_devices(struct hda_bus *bus)
2550 struct snd_card *card = bus->card;
2553 spin_lock(&card->files_lock);
2555 spin_unlock(&card->files_lock);
2557 EXPORT_SYMBOL_HDA(snd_hda_unlock_devices);
2560 * snd_hda_codec_reset - Clear all objects assigned to the codec
2561 * @codec: HD-audio codec
2563 * This frees the all PCM and control elements assigned to the codec, and
2564 * clears the caches and restores the pin default configurations.
2566 * When a device is being used, it returns -EBSY. If successfully freed,
2569 int snd_hda_codec_reset(struct hda_codec *codec)
2571 struct hda_bus *bus = codec->bus;
2572 struct snd_card *card = bus->card;
2575 if (snd_hda_lock_devices(bus) < 0)
2578 /* OK, let it free */
2579 cancel_delayed_work_sync(&codec->jackpoll_work);
2581 cancel_delayed_work_sync(&codec->power_work);
2582 flush_workqueue(bus->workq);
2584 snd_hda_ctls_clear(codec);
2586 for (i = 0; i < codec->num_pcms; i++) {
2587 if (codec->pcm_info[i].pcm) {
2588 snd_device_free(card, codec->pcm_info[i].pcm);
2589 clear_bit(codec->pcm_info[i].device,
2593 if (codec->patch_ops.free)
2594 codec->patch_ops.free(codec);
2595 memset(&codec->patch_ops, 0, sizeof(codec->patch_ops));
2596 snd_hda_jack_tbl_clear(codec);
2597 codec->proc_widget_hook = NULL;
2599 free_hda_cache(&codec->amp_cache);
2600 free_hda_cache(&codec->cmd_cache);
2601 init_hda_cache(&codec->amp_cache, sizeof(struct hda_amp_info));
2602 init_hda_cache(&codec->cmd_cache, sizeof(struct hda_cache_head));
2603 /* free only driver_pins so that init_pins + user_pins are restored */
2604 snd_array_free(&codec->driver_pins);
2605 snd_array_free(&codec->cvt_setups);
2606 snd_array_free(&codec->spdif_out);
2607 snd_array_free(&codec->verbs);
2608 codec->num_pcms = 0;
2609 codec->pcm_info = NULL;
2610 codec->preset = NULL;
2611 codec->slave_dig_outs = NULL;
2612 codec->spdif_status_reset = 0;
2613 module_put(codec->owner);
2614 codec->owner = NULL;
2616 /* allow device access again */
2617 snd_hda_unlock_devices(bus);
2621 typedef int (*map_slave_func_t)(void *, struct snd_kcontrol *);
2623 /* apply the function to all matching slave ctls in the mixer list */
2624 static int map_slaves(struct hda_codec *codec, const char * const *slaves,
2625 const char *suffix, map_slave_func_t func, void *data)
2627 struct hda_nid_item *items;
2628 const char * const *s;
2631 items = codec->mixers.list;
2632 for (i = 0; i < codec->mixers.used; i++) {
2633 struct snd_kcontrol *sctl = items[i].kctl;
2634 if (!sctl || sctl->id.iface != SNDRV_CTL_ELEM_IFACE_MIXER)
2636 for (s = slaves; *s; s++) {
2637 char tmpname[sizeof(sctl->id.name)];
2638 const char *name = *s;
2640 snprintf(tmpname, sizeof(tmpname), "%s %s",
2644 if (!strcmp(sctl->id.name, name)) {
2645 err = func(data, sctl);
2655 static int check_slave_present(void *data, struct snd_kcontrol *sctl)
2660 /* guess the value corresponding to 0dB */
2661 static int get_kctl_0dB_offset(struct snd_kcontrol *kctl, int *step_to_check)
2664 const int *tlv = NULL;
2667 if (kctl->vd[0].access & SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK) {
2668 /* FIXME: set_fs() hack for obtaining user-space TLV data */
2669 mm_segment_t fs = get_fs();
2671 if (!kctl->tlv.c(kctl, 0, sizeof(_tlv), _tlv))
2674 } else if (kctl->vd[0].access & SNDRV_CTL_ELEM_ACCESS_TLV_READ)
2676 if (tlv && tlv[0] == SNDRV_CTL_TLVT_DB_SCALE) {
2678 step &= ~TLV_DB_SCALE_MUTE;
2681 if (*step_to_check && *step_to_check != step) {
2682 snd_printk(KERN_ERR "hda_codec: Mismatching dB step for vmaster slave (%d!=%d)\n",
2683 *step_to_check, step);
2686 *step_to_check = step;
2687 val = -tlv[2] / step;
2692 /* call kctl->put with the given value(s) */
2693 static int put_kctl_with_value(struct snd_kcontrol *kctl, int val)
2695 struct snd_ctl_elem_value *ucontrol;
2696 ucontrol = kzalloc(sizeof(*ucontrol), GFP_KERNEL);
2699 ucontrol->value.integer.value[0] = val;
2700 ucontrol->value.integer.value[1] = val;
2701 kctl->put(kctl, ucontrol);
2706 /* initialize the slave volume with 0dB */
2707 static int init_slave_0dB(void *data, struct snd_kcontrol *slave)
2709 int offset = get_kctl_0dB_offset(slave, data);
2711 put_kctl_with_value(slave, offset);
2715 /* unmute the slave */
2716 static int init_slave_unmute(void *data, struct snd_kcontrol *slave)
2718 return put_kctl_with_value(slave, 1);
2722 * snd_hda_add_vmaster - create a virtual master control and add slaves
2723 * @codec: HD-audio codec
2724 * @name: vmaster control name
2725 * @tlv: TLV data (optional)
2726 * @slaves: slave control names (optional)
2727 * @suffix: suffix string to each slave name (optional)
2728 * @init_slave_vol: initialize slaves to unmute/0dB
2729 * @ctl_ret: store the vmaster kcontrol in return
2731 * Create a virtual master control with the given name. The TLV data
2732 * must be either NULL or a valid data.
2734 * @slaves is a NULL-terminated array of strings, each of which is a
2735 * slave control name. All controls with these names are assigned to
2736 * the new virtual master control.
2738 * This function returns zero if successful or a negative error code.
2740 int __snd_hda_add_vmaster(struct hda_codec *codec, char *name,
2741 unsigned int *tlv, const char * const *slaves,
2742 const char *suffix, bool init_slave_vol,
2743 struct snd_kcontrol **ctl_ret)
2745 struct snd_kcontrol *kctl;
2751 err = map_slaves(codec, slaves, suffix, check_slave_present, NULL);
2753 snd_printdd("No slave found for %s\n", name);
2756 kctl = snd_ctl_make_virtual_master(name, tlv);
2759 err = snd_hda_ctl_add(codec, 0, kctl);
2763 err = map_slaves(codec, slaves, suffix,
2764 (map_slave_func_t)snd_ctl_add_slave, kctl);
2768 /* init with master mute & zero volume */
2769 put_kctl_with_value(kctl, 0);
2770 if (init_slave_vol) {
2772 map_slaves(codec, slaves, suffix,
2773 tlv ? init_slave_0dB : init_slave_unmute, &step);
2780 EXPORT_SYMBOL_HDA(__snd_hda_add_vmaster);
2783 * mute-LED control using vmaster
2785 static int vmaster_mute_mode_info(struct snd_kcontrol *kcontrol,
2786 struct snd_ctl_elem_info *uinfo)
2788 static const char * const texts[] = {
2789 "On", "Off", "Follow Master"
2793 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
2795 uinfo->value.enumerated.items = 3;
2796 index = uinfo->value.enumerated.item;
2799 strcpy(uinfo->value.enumerated.name, texts[index]);
2803 static int vmaster_mute_mode_get(struct snd_kcontrol *kcontrol,
2804 struct snd_ctl_elem_value *ucontrol)
2806 struct hda_vmaster_mute_hook *hook = snd_kcontrol_chip(kcontrol);
2807 ucontrol->value.enumerated.item[0] = hook->mute_mode;
2811 static int vmaster_mute_mode_put(struct snd_kcontrol *kcontrol,
2812 struct snd_ctl_elem_value *ucontrol)
2814 struct hda_vmaster_mute_hook *hook = snd_kcontrol_chip(kcontrol);
2815 unsigned int old_mode = hook->mute_mode;
2817 hook->mute_mode = ucontrol->value.enumerated.item[0];
2818 if (hook->mute_mode > HDA_VMUTE_FOLLOW_MASTER)
2819 hook->mute_mode = HDA_VMUTE_FOLLOW_MASTER;
2820 if (old_mode == hook->mute_mode)
2822 snd_hda_sync_vmaster_hook(hook);
2826 static struct snd_kcontrol_new vmaster_mute_mode = {
2827 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
2828 .name = "Mute-LED Mode",
2829 .info = vmaster_mute_mode_info,
2830 .get = vmaster_mute_mode_get,
2831 .put = vmaster_mute_mode_put,
2835 * Add a mute-LED hook with the given vmaster switch kctl
2836 * "Mute-LED Mode" control is automatically created and associated with
2839 int snd_hda_add_vmaster_hook(struct hda_codec *codec,
2840 struct hda_vmaster_mute_hook *hook,
2841 bool expose_enum_ctl)
2843 struct snd_kcontrol *kctl;
2845 if (!hook->hook || !hook->sw_kctl)
2847 snd_ctl_add_vmaster_hook(hook->sw_kctl, hook->hook, codec);
2848 hook->codec = codec;
2849 hook->mute_mode = HDA_VMUTE_FOLLOW_MASTER;
2850 if (!expose_enum_ctl)
2852 kctl = snd_ctl_new1(&vmaster_mute_mode, hook);
2855 return snd_hda_ctl_add(codec, 0, kctl);
2857 EXPORT_SYMBOL_HDA(snd_hda_add_vmaster_hook);
2860 * Call the hook with the current value for synchronization
2861 * Should be called in init callback
2863 void snd_hda_sync_vmaster_hook(struct hda_vmaster_mute_hook *hook)
2865 if (!hook->hook || !hook->codec)
2867 /* don't call vmaster hook in the destructor since it might have
2868 * been already destroyed
2870 if (hook->codec->bus->shutdown)
2872 switch (hook->mute_mode) {
2873 case HDA_VMUTE_FOLLOW_MASTER:
2874 snd_ctl_sync_vmaster_hook(hook->sw_kctl);
2877 hook->hook(hook->codec, hook->mute_mode);
2881 EXPORT_SYMBOL_HDA(snd_hda_sync_vmaster_hook);
2885 * snd_hda_mixer_amp_switch_info - Info callback for a standard AMP mixer switch
2887 * The control element is supposed to have the private_value field
2888 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2890 int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,
2891 struct snd_ctl_elem_info *uinfo)
2893 int chs = get_amp_channels(kcontrol);
2895 uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
2896 uinfo->count = chs == 3 ? 2 : 1;
2897 uinfo->value.integer.min = 0;
2898 uinfo->value.integer.max = 1;
2901 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_switch_info);
2904 * snd_hda_mixer_amp_switch_get - Get callback for a standard AMP mixer switch
2906 * The control element is supposed to have the private_value field
2907 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2909 int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,
2910 struct snd_ctl_elem_value *ucontrol)
2912 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2913 hda_nid_t nid = get_amp_nid(kcontrol);
2914 int chs = get_amp_channels(kcontrol);
2915 int dir = get_amp_direction(kcontrol);
2916 int idx = get_amp_index(kcontrol);
2917 long *valp = ucontrol->value.integer.value;
2920 *valp++ = (snd_hda_codec_amp_read(codec, nid, 0, dir, idx) &
2921 HDA_AMP_MUTE) ? 0 : 1;
2923 *valp = (snd_hda_codec_amp_read(codec, nid, 1, dir, idx) &
2924 HDA_AMP_MUTE) ? 0 : 1;
2927 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_switch_get);
2930 * snd_hda_mixer_amp_switch_put - Put callback for a standard AMP mixer switch
2932 * The control element is supposed to have the private_value field
2933 * set up via HDA_COMPOSE_AMP_VAL*() or related macros.
2935 int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,
2936 struct snd_ctl_elem_value *ucontrol)
2938 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2939 hda_nid_t nid = get_amp_nid(kcontrol);
2940 int chs = get_amp_channels(kcontrol);
2941 int dir = get_amp_direction(kcontrol);
2942 int idx = get_amp_index(kcontrol);
2943 long *valp = ucontrol->value.integer.value;
2946 snd_hda_power_up(codec);
2948 change = snd_hda_codec_amp_update(codec, nid, 0, dir, idx,
2950 *valp ? 0 : HDA_AMP_MUTE);
2954 change |= snd_hda_codec_amp_update(codec, nid, 1, dir, idx,
2956 *valp ? 0 : HDA_AMP_MUTE);
2957 hda_call_check_power_status(codec, nid);
2958 snd_hda_power_down(codec);
2961 EXPORT_SYMBOL_HDA(snd_hda_mixer_amp_switch_put);
2964 * bound volume controls
2966 * bind multiple volumes (# indices, from 0)
2969 #define AMP_VAL_IDX_SHIFT 19
2970 #define AMP_VAL_IDX_MASK (0x0f<<19)
2973 * snd_hda_mixer_bind_switch_get - Get callback for a bound volume control
2975 * The control element is supposed to have the private_value field
2976 * set up via HDA_BIND_MUTE*() macros.
2978 int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,
2979 struct snd_ctl_elem_value *ucontrol)
2981 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
2985 mutex_lock(&codec->control_mutex);
2986 pval = kcontrol->private_value;
2987 kcontrol->private_value = pval & ~AMP_VAL_IDX_MASK; /* index 0 */
2988 err = snd_hda_mixer_amp_switch_get(kcontrol, ucontrol);
2989 kcontrol->private_value = pval;
2990 mutex_unlock(&codec->control_mutex);
2993 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_switch_get);
2996 * snd_hda_mixer_bind_switch_put - Put callback for a bound volume control
2998 * The control element is supposed to have the private_value field
2999 * set up via HDA_BIND_MUTE*() macros.
3001 int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,
3002 struct snd_ctl_elem_value *ucontrol)
3004 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3006 int i, indices, err = 0, change = 0;
3008 mutex_lock(&codec->control_mutex);
3009 pval = kcontrol->private_value;
3010 indices = (pval & AMP_VAL_IDX_MASK) >> AMP_VAL_IDX_SHIFT;
3011 for (i = 0; i < indices; i++) {
3012 kcontrol->private_value = (pval & ~AMP_VAL_IDX_MASK) |
3013 (i << AMP_VAL_IDX_SHIFT);
3014 err = snd_hda_mixer_amp_switch_put(kcontrol, ucontrol);
3019 kcontrol->private_value = pval;
3020 mutex_unlock(&codec->control_mutex);
3021 return err < 0 ? err : change;
3023 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_switch_put);
3026 * snd_hda_mixer_bind_ctls_info - Info callback for a generic bound control
3028 * The control element is supposed to have the private_value field
3029 * set up via HDA_BIND_VOL() or HDA_BIND_SW() macros.
3031 int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,
3032 struct snd_ctl_elem_info *uinfo)
3034 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3035 struct hda_bind_ctls *c;
3038 mutex_lock(&codec->control_mutex);
3039 c = (struct hda_bind_ctls *)kcontrol->private_value;
3040 kcontrol->private_value = *c->values;
3041 err = c->ops->info(kcontrol, uinfo);
3042 kcontrol->private_value = (long)c;
3043 mutex_unlock(&codec->control_mutex);
3046 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_ctls_info);
3049 * snd_hda_mixer_bind_ctls_get - Get callback for a generic bound control
3051 * The control element is supposed to have the private_value field
3052 * set up via HDA_BIND_VOL() or HDA_BIND_SW() macros.
3054 int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,
3055 struct snd_ctl_elem_value *ucontrol)
3057 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3058 struct hda_bind_ctls *c;
3061 mutex_lock(&codec->control_mutex);
3062 c = (struct hda_bind_ctls *)kcontrol->private_value;
3063 kcontrol->private_value = *c->values;
3064 err = c->ops->get(kcontrol, ucontrol);
3065 kcontrol->private_value = (long)c;
3066 mutex_unlock(&codec->control_mutex);
3069 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_ctls_get);
3072 * snd_hda_mixer_bind_ctls_put - Put callback for a generic bound control
3074 * The control element is supposed to have the private_value field
3075 * set up via HDA_BIND_VOL() or HDA_BIND_SW() macros.
3077 int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,
3078 struct snd_ctl_elem_value *ucontrol)
3080 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3081 struct hda_bind_ctls *c;
3082 unsigned long *vals;
3083 int err = 0, change = 0;
3085 mutex_lock(&codec->control_mutex);
3086 c = (struct hda_bind_ctls *)kcontrol->private_value;
3087 for (vals = c->values; *vals; vals++) {
3088 kcontrol->private_value = *vals;
3089 err = c->ops->put(kcontrol, ucontrol);
3094 kcontrol->private_value = (long)c;
3095 mutex_unlock(&codec->control_mutex);
3096 return err < 0 ? err : change;
3098 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_ctls_put);
3101 * snd_hda_mixer_bind_tlv - TLV callback for a generic bound control
3103 * The control element is supposed to have the private_value field
3104 * set up via HDA_BIND_VOL() macro.
3106 int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,
3107 unsigned int size, unsigned int __user *tlv)
3109 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3110 struct hda_bind_ctls *c;
3113 mutex_lock(&codec->control_mutex);
3114 c = (struct hda_bind_ctls *)kcontrol->private_value;
3115 kcontrol->private_value = *c->values;
3116 err = c->ops->tlv(kcontrol, op_flag, size, tlv);
3117 kcontrol->private_value = (long)c;
3118 mutex_unlock(&codec->control_mutex);
3121 EXPORT_SYMBOL_HDA(snd_hda_mixer_bind_tlv);
3123 struct hda_ctl_ops snd_hda_bind_vol = {
3124 .info = snd_hda_mixer_amp_volume_info,
3125 .get = snd_hda_mixer_amp_volume_get,
3126 .put = snd_hda_mixer_amp_volume_put,
3127 .tlv = snd_hda_mixer_amp_tlv
3129 EXPORT_SYMBOL_HDA(snd_hda_bind_vol);
3131 struct hda_ctl_ops snd_hda_bind_sw = {
3132 .info = snd_hda_mixer_amp_switch_info,
3133 .get = snd_hda_mixer_amp_switch_get,
3134 .put = snd_hda_mixer_amp_switch_put,
3135 .tlv = snd_hda_mixer_amp_tlv
3137 EXPORT_SYMBOL_HDA(snd_hda_bind_sw);
3140 * SPDIF out controls
3143 static int snd_hda_spdif_mask_info(struct snd_kcontrol *kcontrol,
3144 struct snd_ctl_elem_info *uinfo)
3146 uinfo->type = SNDRV_CTL_ELEM_TYPE_IEC958;
3151 static int snd_hda_spdif_cmask_get(struct snd_kcontrol *kcontrol,
3152 struct snd_ctl_elem_value *ucontrol)
3154 ucontrol->value.iec958.status[0] = IEC958_AES0_PROFESSIONAL |
3155 IEC958_AES0_NONAUDIO |
3156 IEC958_AES0_CON_EMPHASIS_5015 |
3157 IEC958_AES0_CON_NOT_COPYRIGHT;
3158 ucontrol->value.iec958.status[1] = IEC958_AES1_CON_CATEGORY |
3159 IEC958_AES1_CON_ORIGINAL;
3163 static int snd_hda_spdif_pmask_get(struct snd_kcontrol *kcontrol,
3164 struct snd_ctl_elem_value *ucontrol)
3166 ucontrol->value.iec958.status[0] = IEC958_AES0_PROFESSIONAL |
3167 IEC958_AES0_NONAUDIO |
3168 IEC958_AES0_PRO_EMPHASIS_5015;
3172 static int snd_hda_spdif_default_get(struct snd_kcontrol *kcontrol,
3173 struct snd_ctl_elem_value *ucontrol)
3175 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3176 int idx = kcontrol->private_value;
3177 struct hda_spdif_out *spdif;
3179 mutex_lock(&codec->spdif_mutex);
3180 spdif = snd_array_elem(&codec->spdif_out, idx);
3181 ucontrol->value.iec958.status[0] = spdif->status & 0xff;
3182 ucontrol->value.iec958.status[1] = (spdif->status >> 8) & 0xff;
3183 ucontrol->value.iec958.status[2] = (spdif->status >> 16) & 0xff;
3184 ucontrol->value.iec958.status[3] = (spdif->status >> 24) & 0xff;
3185 mutex_unlock(&codec->spdif_mutex);
3190 /* convert from SPDIF status bits to HDA SPDIF bits
3191 * bit 0 (DigEn) is always set zero (to be filled later)
3193 static unsigned short convert_from_spdif_status(unsigned int sbits)
3195 unsigned short val = 0;
3197 if (sbits & IEC958_AES0_PROFESSIONAL)
3198 val |= AC_DIG1_PROFESSIONAL;
3199 if (sbits & IEC958_AES0_NONAUDIO)
3200 val |= AC_DIG1_NONAUDIO;
3201 if (sbits & IEC958_AES0_PROFESSIONAL) {
3202 if ((sbits & IEC958_AES0_PRO_EMPHASIS) ==
3203 IEC958_AES0_PRO_EMPHASIS_5015)
3204 val |= AC_DIG1_EMPHASIS;
3206 if ((sbits & IEC958_AES0_CON_EMPHASIS) ==
3207 IEC958_AES0_CON_EMPHASIS_5015)
3208 val |= AC_DIG1_EMPHASIS;
3209 if (!(sbits & IEC958_AES0_CON_NOT_COPYRIGHT))
3210 val |= AC_DIG1_COPYRIGHT;
3211 if (sbits & (IEC958_AES1_CON_ORIGINAL << 8))
3212 val |= AC_DIG1_LEVEL;
3213 val |= sbits & (IEC958_AES1_CON_CATEGORY << 8);
3218 /* convert to SPDIF status bits from HDA SPDIF bits
3220 static unsigned int convert_to_spdif_status(unsigned short val)
3222 unsigned int sbits = 0;
3224 if (val & AC_DIG1_NONAUDIO)
3225 sbits |= IEC958_AES0_NONAUDIO;
3226 if (val & AC_DIG1_PROFESSIONAL)
3227 sbits |= IEC958_AES0_PROFESSIONAL;
3228 if (sbits & IEC958_AES0_PROFESSIONAL) {
3229 if (val & AC_DIG1_EMPHASIS)
3230 sbits |= IEC958_AES0_PRO_EMPHASIS_5015;
3232 if (val & AC_DIG1_EMPHASIS)
3233 sbits |= IEC958_AES0_CON_EMPHASIS_5015;
3234 if (!(val & AC_DIG1_COPYRIGHT))
3235 sbits |= IEC958_AES0_CON_NOT_COPYRIGHT;
3236 if (val & AC_DIG1_LEVEL)
3237 sbits |= (IEC958_AES1_CON_ORIGINAL << 8);
3238 sbits |= val & (0x7f << 8);
3243 /* set digital convert verbs both for the given NID and its slaves */
3244 static void set_dig_out(struct hda_codec *codec, hda_nid_t nid,
3249 snd_hda_codec_write_cache(codec, nid, 0, verb, val);
3250 d = codec->slave_dig_outs;
3254 snd_hda_codec_write_cache(codec, *d, 0, verb, val);
3257 static inline void set_dig_out_convert(struct hda_codec *codec, hda_nid_t nid,
3261 set_dig_out(codec, nid, AC_VERB_SET_DIGI_CONVERT_1, dig1);
3263 set_dig_out(codec, nid, AC_VERB_SET_DIGI_CONVERT_2, dig2);
3266 static int snd_hda_spdif_default_put(struct snd_kcontrol *kcontrol,
3267 struct snd_ctl_elem_value *ucontrol)
3269 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3270 int idx = kcontrol->private_value;
3271 struct hda_spdif_out *spdif;
3276 mutex_lock(&codec->spdif_mutex);
3277 spdif = snd_array_elem(&codec->spdif_out, idx);
3279 spdif->status = ucontrol->value.iec958.status[0] |
3280 ((unsigned int)ucontrol->value.iec958.status[1] << 8) |
3281 ((unsigned int)ucontrol->value.iec958.status[2] << 16) |
3282 ((unsigned int)ucontrol->value.iec958.status[3] << 24);
3283 val = convert_from_spdif_status(spdif->status);
3284 val |= spdif->ctls & 1;
3285 change = spdif->ctls != val;
3287 if (change && nid != (u16)-1)
3288 set_dig_out_convert(codec, nid, val & 0xff, (val >> 8) & 0xff);
3289 mutex_unlock(&codec->spdif_mutex);
3293 #define snd_hda_spdif_out_switch_info snd_ctl_boolean_mono_info
3295 static int snd_hda_spdif_out_switch_get(struct snd_kcontrol *kcontrol,
3296 struct snd_ctl_elem_value *ucontrol)
3298 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3299 int idx = kcontrol->private_value;
3300 struct hda_spdif_out *spdif;
3302 mutex_lock(&codec->spdif_mutex);
3303 spdif = snd_array_elem(&codec->spdif_out, idx);
3304 ucontrol->value.integer.value[0] = spdif->ctls & AC_DIG1_ENABLE;
3305 mutex_unlock(&codec->spdif_mutex);
3309 static inline void set_spdif_ctls(struct hda_codec *codec, hda_nid_t nid,
3312 set_dig_out_convert(codec, nid, dig1, dig2);
3313 /* unmute amp switch (if any) */
3314 if ((get_wcaps(codec, nid) & AC_WCAP_OUT_AMP) &&
3315 (dig1 & AC_DIG1_ENABLE))
3316 snd_hda_codec_amp_stereo(codec, nid, HDA_OUTPUT, 0,
3320 static int snd_hda_spdif_out_switch_put(struct snd_kcontrol *kcontrol,
3321 struct snd_ctl_elem_value *ucontrol)
3323 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3324 int idx = kcontrol->private_value;
3325 struct hda_spdif_out *spdif;
3330 mutex_lock(&codec->spdif_mutex);
3331 spdif = snd_array_elem(&codec->spdif_out, idx);
3333 val = spdif->ctls & ~AC_DIG1_ENABLE;
3334 if (ucontrol->value.integer.value[0])
3335 val |= AC_DIG1_ENABLE;
3336 change = spdif->ctls != val;
3338 if (change && nid != (u16)-1)
3339 set_spdif_ctls(codec, nid, val & 0xff, -1);
3340 mutex_unlock(&codec->spdif_mutex);
3344 static struct snd_kcontrol_new dig_mixes[] = {
3346 .access = SNDRV_CTL_ELEM_ACCESS_READ,
3347 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3348 .name = SNDRV_CTL_NAME_IEC958("", PLAYBACK, CON_MASK),
3349 .info = snd_hda_spdif_mask_info,
3350 .get = snd_hda_spdif_cmask_get,
3353 .access = SNDRV_CTL_ELEM_ACCESS_READ,
3354 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3355 .name = SNDRV_CTL_NAME_IEC958("", PLAYBACK, PRO_MASK),
3356 .info = snd_hda_spdif_mask_info,
3357 .get = snd_hda_spdif_pmask_get,
3360 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3361 .name = SNDRV_CTL_NAME_IEC958("", PLAYBACK, DEFAULT),
3362 .info = snd_hda_spdif_mask_info,
3363 .get = snd_hda_spdif_default_get,
3364 .put = snd_hda_spdif_default_put,
3367 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3368 .name = SNDRV_CTL_NAME_IEC958("", PLAYBACK, SWITCH),
3369 .info = snd_hda_spdif_out_switch_info,
3370 .get = snd_hda_spdif_out_switch_get,
3371 .put = snd_hda_spdif_out_switch_put,
3377 * snd_hda_create_dig_out_ctls - create Output SPDIF-related controls
3378 * @codec: the HDA codec
3379 * @associated_nid: NID that new ctls associated with
3380 * @cvt_nid: converter NID
3381 * @type: HDA_PCM_TYPE_*
3382 * Creates controls related with the digital output.
3383 * Called from each patch supporting the digital out.
3385 * Returns 0 if successful, or a negative error code.
3387 int snd_hda_create_dig_out_ctls(struct hda_codec *codec,
3388 hda_nid_t associated_nid,
3393 struct snd_kcontrol *kctl;
3394 struct snd_kcontrol_new *dig_mix;
3396 const int spdif_index = 16;
3397 struct hda_spdif_out *spdif;
3398 struct hda_bus *bus = codec->bus;
3400 if (bus->primary_dig_out_type == HDA_PCM_TYPE_HDMI &&
3401 type == HDA_PCM_TYPE_SPDIF) {
3403 } else if (bus->primary_dig_out_type == HDA_PCM_TYPE_SPDIF &&
3404 type == HDA_PCM_TYPE_HDMI) {
3405 /* suppose a single SPDIF device */
3406 for (dig_mix = dig_mixes; dig_mix->name; dig_mix++) {
3407 kctl = find_mixer_ctl(codec, dig_mix->name, 0, 0);
3410 kctl->id.index = spdif_index;
3412 bus->primary_dig_out_type = HDA_PCM_TYPE_HDMI;
3414 if (!bus->primary_dig_out_type)
3415 bus->primary_dig_out_type = type;
3417 idx = find_empty_mixer_ctl_idx(codec, "IEC958 Playback Switch", idx);
3419 printk(KERN_ERR "hda_codec: too many IEC958 outputs\n");
3422 spdif = snd_array_new(&codec->spdif_out);
3425 for (dig_mix = dig_mixes; dig_mix->name; dig_mix++) {
3426 kctl = snd_ctl_new1(dig_mix, codec);
3429 kctl->id.index = idx;
3430 kctl->private_value = codec->spdif_out.used - 1;
3431 err = snd_hda_ctl_add(codec, associated_nid, kctl);
3435 spdif->nid = cvt_nid;
3436 spdif->ctls = snd_hda_codec_read(codec, cvt_nid, 0,
3437 AC_VERB_GET_DIGI_CONVERT_1, 0);
3438 spdif->status = convert_to_spdif_status(spdif->ctls);
3441 EXPORT_SYMBOL_HDA(snd_hda_create_dig_out_ctls);
3443 /* get the hda_spdif_out entry from the given NID
3444 * call within spdif_mutex lock
3446 struct hda_spdif_out *snd_hda_spdif_out_of_nid(struct hda_codec *codec,
3450 for (i = 0; i < codec->spdif_out.used; i++) {
3451 struct hda_spdif_out *spdif =
3452 snd_array_elem(&codec->spdif_out, i);
3453 if (spdif->nid == nid)
3458 EXPORT_SYMBOL_HDA(snd_hda_spdif_out_of_nid);
3460 void snd_hda_spdif_ctls_unassign(struct hda_codec *codec, int idx)
3462 struct hda_spdif_out *spdif;
3464 mutex_lock(&codec->spdif_mutex);
3465 spdif = snd_array_elem(&codec->spdif_out, idx);
3466 spdif->nid = (u16)-1;
3467 mutex_unlock(&codec->spdif_mutex);
3469 EXPORT_SYMBOL_HDA(snd_hda_spdif_ctls_unassign);
3471 void snd_hda_spdif_ctls_assign(struct hda_codec *codec, int idx, hda_nid_t nid)
3473 struct hda_spdif_out *spdif;
3476 mutex_lock(&codec->spdif_mutex);
3477 spdif = snd_array_elem(&codec->spdif_out, idx);
3478 if (spdif->nid != nid) {
3481 set_spdif_ctls(codec, nid, val & 0xff, (val >> 8) & 0xff);
3483 mutex_unlock(&codec->spdif_mutex);
3485 EXPORT_SYMBOL_HDA(snd_hda_spdif_ctls_assign);
3488 * SPDIF sharing with analog output
3490 static int spdif_share_sw_get(struct snd_kcontrol *kcontrol,
3491 struct snd_ctl_elem_value *ucontrol)
3493 struct hda_multi_out *mout = snd_kcontrol_chip(kcontrol);
3494 ucontrol->value.integer.value[0] = mout->share_spdif;
3498 static int spdif_share_sw_put(struct snd_kcontrol *kcontrol,
3499 struct snd_ctl_elem_value *ucontrol)
3501 struct hda_multi_out *mout = snd_kcontrol_chip(kcontrol);
3502 mout->share_spdif = !!ucontrol->value.integer.value[0];
3506 static struct snd_kcontrol_new spdif_share_sw = {
3507 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3508 .name = "IEC958 Default PCM Playback Switch",
3509 .info = snd_ctl_boolean_mono_info,
3510 .get = spdif_share_sw_get,
3511 .put = spdif_share_sw_put,
3515 * snd_hda_create_spdif_share_sw - create Default PCM switch
3516 * @codec: the HDA codec
3517 * @mout: multi-out instance
3519 int snd_hda_create_spdif_share_sw(struct hda_codec *codec,
3520 struct hda_multi_out *mout)
3522 struct snd_kcontrol *kctl;
3524 if (!mout->dig_out_nid)
3527 kctl = snd_ctl_new1(&spdif_share_sw, mout);
3530 /* ATTENTION: here mout is passed as private_data, instead of codec */
3531 return snd_hda_ctl_add(codec, mout->dig_out_nid, kctl);
3533 EXPORT_SYMBOL_HDA(snd_hda_create_spdif_share_sw);
3539 #define snd_hda_spdif_in_switch_info snd_hda_spdif_out_switch_info
3541 static int snd_hda_spdif_in_switch_get(struct snd_kcontrol *kcontrol,
3542 struct snd_ctl_elem_value *ucontrol)
3544 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3546 ucontrol->value.integer.value[0] = codec->spdif_in_enable;
3550 static int snd_hda_spdif_in_switch_put(struct snd_kcontrol *kcontrol,
3551 struct snd_ctl_elem_value *ucontrol)
3553 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3554 hda_nid_t nid = kcontrol->private_value;
3555 unsigned int val = !!ucontrol->value.integer.value[0];
3558 mutex_lock(&codec->spdif_mutex);
3559 change = codec->spdif_in_enable != val;
3561 codec->spdif_in_enable = val;
3562 snd_hda_codec_write_cache(codec, nid, 0,
3563 AC_VERB_SET_DIGI_CONVERT_1, val);
3565 mutex_unlock(&codec->spdif_mutex);
3569 static int snd_hda_spdif_in_status_get(struct snd_kcontrol *kcontrol,
3570 struct snd_ctl_elem_value *ucontrol)
3572 struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
3573 hda_nid_t nid = kcontrol->private_value;
3577 val = snd_hda_codec_read(codec, nid, 0, AC_VERB_GET_DIGI_CONVERT_1, 0);
3578 sbits = convert_to_spdif_status(val);
3579 ucontrol->value.iec958.status[0] = sbits;
3580 ucontrol->value.iec958.status[1] = sbits >> 8;
3581 ucontrol->value.iec958.status[2] = sbits >> 16;
3582 ucontrol->value.iec958.status[3] = sbits >> 24;
3586 static struct snd_kcontrol_new dig_in_ctls[] = {
3588 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3589 .name = SNDRV_CTL_NAME_IEC958("", CAPTURE, SWITCH),
3590 .info = snd_hda_spdif_in_switch_info,
3591 .get = snd_hda_spdif_in_switch_get,
3592 .put = snd_hda_spdif_in_switch_put,
3595 .access = SNDRV_CTL_ELEM_ACCESS_READ,
3596 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
3597 .name = SNDRV_CTL_NAME_IEC958("", CAPTURE, DEFAULT),
3598 .info = snd_hda_spdif_mask_info,
3599 .get = snd_hda_spdif_in_status_get,
3605 * snd_hda_create_spdif_in_ctls - create Input SPDIF-related controls
3606 * @codec: the HDA codec
3607 * @nid: audio in widget NID
3609 * Creates controls related with the SPDIF input.
3610 * Called from each patch supporting the SPDIF in.
3612 * Returns 0 if successful, or a negative error code.
3614 int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid)
3617 struct snd_kcontrol *kctl;
3618 struct snd_kcontrol_new *dig_mix;
3621 idx = find_empty_mixer_ctl_idx(codec, "IEC958 Capture Switch", 0);
3623 printk(KERN_ERR "hda_codec: too many IEC958 inputs\n");
3626 for (dig_mix = dig_in_ctls; dig_mix->name; dig_mix++) {
3627 kctl = snd_ctl_new1(dig_mix, codec);
3630 kctl->private_value = nid;
3631 err = snd_hda_ctl_add(codec, nid, kctl);
3635 codec->spdif_in_enable =
3636 snd_hda_codec_read(codec, nid, 0,
3637 AC_VERB_GET_DIGI_CONVERT_1, 0) &
3641 EXPORT_SYMBOL_HDA(snd_hda_create_spdif_in_ctls);
3647 /* build a 31bit cache key with the widget id and the command parameter */
3648 #define build_cmd_cache_key(nid, verb) ((verb << 8) | nid)
3649 #define get_cmd_cache_nid(key) ((key) & 0xff)
3650 #define get_cmd_cache_cmd(key) (((key) >> 8) & 0xffff)
3653 * snd_hda_codec_write_cache - send a single command with caching
3654 * @codec: the HDA codec
3655 * @nid: NID to send the command
3656 * @flags: optional bit flags
3657 * @verb: the verb to send
3658 * @parm: the parameter for the verb
3660 * Send a single command without waiting for response.
3662 * Returns 0 if successful, or a negative error code.
3664 int snd_hda_codec_write_cache(struct hda_codec *codec, hda_nid_t nid,
3665 int flags, unsigned int verb, unsigned int parm)
3668 struct hda_cache_head *c;
3670 unsigned int cache_only;
3672 cache_only = codec->cached_write;
3674 err = snd_hda_codec_write(codec, nid, flags, verb, parm);
3679 /* parm may contain the verb stuff for get/set amp */
3680 verb = verb | (parm >> 8);
3682 key = build_cmd_cache_key(nid, verb);
3683 mutex_lock(&codec->bus->cmd_mutex);
3684 c = get_alloc_hash(&codec->cmd_cache, key);
3687 c->dirty = cache_only;
3689 mutex_unlock(&codec->bus->cmd_mutex);
3692 EXPORT_SYMBOL_HDA(snd_hda_codec_write_cache);
3695 * snd_hda_codec_update_cache - check cache and write the cmd only when needed
3696 * @codec: the HDA codec
3697 * @nid: NID to send the command
3698 * @flags: optional bit flags
3699 * @verb: the verb to send
3700 * @parm: the parameter for the verb
3702 * This function works like snd_hda_codec_write_cache(), but it doesn't send
3703 * command if the parameter is already identical with the cached value.
3704 * If not, it sends the command and refreshes the cache.
3706 * Returns 0 if successful, or a negative error code.
3708 int snd_hda_codec_update_cache(struct hda_codec *codec, hda_nid_t nid,
3709 int flags, unsigned int verb, unsigned int parm)
3711 struct hda_cache_head *c;
3714 /* parm may contain the verb stuff for get/set amp */
3715 verb = verb | (parm >> 8);
3717 key = build_cmd_cache_key(nid, verb);
3718 mutex_lock(&codec->bus->cmd_mutex);
3719 c = get_hash(&codec->cmd_cache, key);
3720 if (c && c->val == parm) {
3721 mutex_unlock(&codec->bus->cmd_mutex);
3724 mutex_unlock(&codec->bus->cmd_mutex);
3725 return snd_hda_codec_write_cache(codec, nid, flags, verb, parm);
3727 EXPORT_SYMBOL_HDA(snd_hda_codec_update_cache);
3730 * snd_hda_codec_resume_cache - Resume the all commands from the cache
3731 * @codec: HD-audio codec
3733 * Execute all verbs recorded in the command caches to resume.
3735 void snd_hda_codec_resume_cache(struct hda_codec *codec)
3739 mutex_lock(&codec->hash_mutex);
3740 codec->cached_write = 0;
3741 for (i = 0; i < codec->cmd_cache.buf.used; i++) {
3742 struct hda_cache_head *buffer;
3745 buffer = snd_array_elem(&codec->cmd_cache.buf, i);
3752 mutex_unlock(&codec->hash_mutex);
3753 snd_hda_codec_write(codec, get_cmd_cache_nid(key), 0,
3754 get_cmd_cache_cmd(key), buffer->val);
3755 mutex_lock(&codec->hash_mutex);
3757 mutex_unlock(&codec->hash_mutex);
3759 EXPORT_SYMBOL_HDA(snd_hda_codec_resume_cache);
3762 * snd_hda_sequence_write_cache - sequence writes with caching
3763 * @codec: the HDA codec
3764 * @seq: VERB array to send
3766 * Send the commands sequentially from the given array.
3767 * Thte commands are recorded on cache for power-save and resume.
3768 * The array must be terminated with NID=0.
3770 void snd_hda_sequence_write_cache(struct hda_codec *codec,
3771 const struct hda_verb *seq)
3773 for (; seq->nid; seq++)
3774 snd_hda_codec_write_cache(codec, seq->nid, 0, seq->verb,
3777 EXPORT_SYMBOL_HDA(snd_hda_sequence_write_cache);
3780 * snd_hda_codec_flush_cache - Execute all pending (cached) amps / verbs
3781 * @codec: HD-audio codec
3783 void snd_hda_codec_flush_cache(struct hda_codec *codec)
3785 snd_hda_codec_resume_amp(codec);
3786 snd_hda_codec_resume_cache(codec);
3788 EXPORT_SYMBOL_HDA(snd_hda_codec_flush_cache);
3790 void snd_hda_codec_set_power_to_all(struct hda_codec *codec, hda_nid_t fg,
3791 unsigned int power_state)
3793 hda_nid_t nid = codec->start_nid;
3796 for (i = 0; i < codec->num_nodes; i++, nid++) {
3797 unsigned int wcaps = get_wcaps(codec, nid);
3798 unsigned int state = power_state;
3799 if (!(wcaps & AC_WCAP_POWER))
3801 if (codec->power_filter) {
3802 state = codec->power_filter(codec, nid, power_state);
3803 if (state != power_state && power_state == AC_PWRST_D3)
3806 snd_hda_codec_write(codec, nid, 0, AC_VERB_SET_POWER_STATE,
3810 EXPORT_SYMBOL_HDA(snd_hda_codec_set_power_to_all);
3813 * supported power states check
3815 static bool snd_hda_codec_get_supported_ps(struct hda_codec *codec, hda_nid_t fg,
3816 unsigned int power_state)
3818 int sup = snd_hda_param_read(codec, fg, AC_PAR_POWER_STATE);
3822 if (sup & power_state)
3829 * wait until the state is reached, returns the current state
3831 static unsigned int hda_sync_power_state(struct hda_codec *codec,
3833 unsigned int power_state)
3835 unsigned long end_time = jiffies + msecs_to_jiffies(500);
3836 unsigned int state, actual_state;
3839 state = snd_hda_codec_read(codec, fg, 0,
3840 AC_VERB_GET_POWER_STATE, 0);
3841 if (state & AC_PWRST_ERROR)
3843 actual_state = (state >> 4) & 0x0f;
3844 if (actual_state == power_state)
3846 if (time_after_eq(jiffies, end_time))
3848 /* wait until the codec reachs to the target state */
3854 /* don't power down the widget if it controls eapd and EAPD_BTLENABLE is set */
3855 unsigned int snd_hda_codec_eapd_power_filter(struct hda_codec *codec,
3857 unsigned int power_state)
3859 if (power_state == AC_PWRST_D3 &&
3860 get_wcaps_type(get_wcaps(codec, nid)) == AC_WID_PIN &&
3861 (snd_hda_query_pin_caps(codec, nid) & AC_PINCAP_EAPD)) {
3862 int eapd = snd_hda_codec_read(codec, nid, 0,
3863 AC_VERB_GET_EAPD_BTLENABLE, 0);
3869 EXPORT_SYMBOL_HDA(snd_hda_codec_eapd_power_filter);
3872 * set power state of the codec, and return the power state
3874 static unsigned int hda_set_power_state(struct hda_codec *codec,
3875 unsigned int power_state)
3877 hda_nid_t fg = codec->afg ? codec->afg : codec->mfg;
3882 /* this delay seems necessary to avoid click noise at power-down */
3883 if (power_state == AC_PWRST_D3) {
3884 /* transition time less than 10ms for power down */
3885 msleep(codec->epss ? 10 : 100);
3886 flags = HDA_RW_NO_RESPONSE_FALLBACK;
3889 /* repeat power states setting at most 10 times*/
3890 for (count = 0; count < 10; count++) {
3891 if (codec->patch_ops.set_power_state)
3892 codec->patch_ops.set_power_state(codec, fg,
3895 snd_hda_codec_read(codec, fg, flags,
3896 AC_VERB_SET_POWER_STATE,
3898 snd_hda_codec_set_power_to_all(codec, fg, power_state);
3900 state = hda_sync_power_state(codec, fg, power_state);
3901 if (!(state & AC_PWRST_ERROR))
3908 /* sync power states of all widgets;
3909 * this is called at the end of codec parsing
3911 static void sync_power_up_states(struct hda_codec *codec)
3913 hda_nid_t nid = codec->start_nid;
3916 /* don't care if no filter is used */
3917 if (!codec->power_filter)
3920 for (i = 0; i < codec->num_nodes; i++, nid++) {
3921 unsigned int wcaps = get_wcaps(codec, nid);
3922 unsigned int target;
3923 if (!(wcaps & AC_WCAP_POWER))
3925 target = codec->power_filter(codec, nid, AC_PWRST_D0);
3926 if (target == AC_PWRST_D0)
3928 if (!snd_hda_check_power_state(codec, nid, target))
3929 snd_hda_codec_write(codec, nid, 0,
3930 AC_VERB_SET_POWER_STATE, target);
3934 #ifdef CONFIG_SND_HDA_HWDEP
3935 /* execute additional init verbs */
3936 static void hda_exec_init_verbs(struct hda_codec *codec)
3938 if (codec->init_verbs.list)
3939 snd_hda_sequence_write(codec, codec->init_verbs.list);
3942 static inline void hda_exec_init_verbs(struct hda_codec *codec) {}
3947 * call suspend and power-down; used both from PM and power-save
3948 * this function returns the power state in the end
3950 static unsigned int hda_call_codec_suspend(struct hda_codec *codec, bool in_wq)
3956 if (codec->patch_ops.suspend)
3957 codec->patch_ops.suspend(codec);
3958 hda_cleanup_all_streams(codec);
3959 state = hda_set_power_state(codec, AC_PWRST_D3);
3960 /* Cancel delayed work if we aren't currently running from it. */
3962 cancel_delayed_work_sync(&codec->power_work);
3963 spin_lock(&codec->power_lock);
3964 snd_hda_update_power_acct(codec);
3965 trace_hda_power_down(codec);
3966 codec->power_on = 0;
3967 codec->power_transition = 0;
3968 codec->power_jiffies = jiffies;
3969 spin_unlock(&codec->power_lock);
3974 /* mark all entries of cmd and amp caches dirty */
3975 static void hda_mark_cmd_cache_dirty(struct hda_codec *codec)
3978 for (i = 0; i < codec->cmd_cache.buf.used; i++) {
3979 struct hda_cache_head *cmd;
3980 cmd = snd_array_elem(&codec->cmd_cache.buf, i);
3983 for (i = 0; i < codec->amp_cache.buf.used; i++) {
3984 struct hda_amp_info *amp;
3985 amp = snd_array_elem(&codec->amp_cache.buf, i);
3986 amp->head.dirty = 1;
3991 * kick up codec; used both from PM and power-save
3993 static void hda_call_codec_resume(struct hda_codec *codec)
3997 hda_mark_cmd_cache_dirty(codec);
3999 /* set as if powered on for avoiding re-entering the resume
4000 * in the resume / power-save sequence
4002 hda_keep_power_on(codec);
4003 if (codec->pm_down_notified) {
4004 codec->pm_down_notified = 0;
4005 hda_call_pm_notify(codec->bus, true);
4007 hda_set_power_state(codec, AC_PWRST_D0);
4008 restore_shutup_pins(codec);
4009 hda_exec_init_verbs(codec);
4010 snd_hda_jack_set_dirty_all(codec);
4011 if (codec->patch_ops.resume)
4012 codec->patch_ops.resume(codec);
4014 if (codec->patch_ops.init)
4015 codec->patch_ops.init(codec);
4016 snd_hda_codec_resume_amp(codec);
4017 snd_hda_codec_resume_cache(codec);
4020 if (codec->jackpoll_interval)
4021 hda_jackpoll_work(&codec->jackpoll_work.work);
4023 snd_hda_jack_report_sync(codec);
4026 snd_hda_power_down(codec); /* flag down before returning */
4028 #endif /* CONFIG_PM */
4032 * snd_hda_build_controls - build mixer controls
4035 * Creates mixer controls for each codec included in the bus.
4037 * Returns 0 if successful, otherwise a negative error code.
4039 int snd_hda_build_controls(struct hda_bus *bus)
4041 struct hda_codec *codec;
4043 list_for_each_entry(codec, &bus->codec_list, list) {
4044 int err = snd_hda_codec_build_controls(codec);
4046 printk(KERN_ERR "hda_codec: cannot build controls "
4047 "for #%d (error %d)\n", codec->addr, err);
4048 err = snd_hda_codec_reset(codec);
4051 "hda_codec: cannot revert codec\n");
4058 EXPORT_SYMBOL_HDA(snd_hda_build_controls);
4061 * add standard channel maps if not specified
4063 static int add_std_chmaps(struct hda_codec *codec)
4067 for (i = 0; i < codec->num_pcms; i++) {
4068 for (str = 0; str < 2; str++) {
4069 struct snd_pcm *pcm = codec->pcm_info[i].pcm;
4070 struct hda_pcm_stream *hinfo =
4071 &codec->pcm_info[i].stream[str];
4072 struct snd_pcm_chmap *chmap;
4073 const struct snd_pcm_chmap_elem *elem;
4075 if (codec->pcm_info[i].own_chmap)
4077 if (!pcm || !hinfo->substreams)
4079 elem = hinfo->chmap ? hinfo->chmap : snd_pcm_std_chmaps;
4080 err = snd_pcm_add_chmap_ctls(pcm, str, elem,
4081 hinfo->channels_max,
4085 chmap->channel_mask = SND_PCM_CHMAP_MASK_2468;
4091 /* default channel maps for 2.1 speakers;
4092 * since HD-audio supports only stereo, odd number channels are omitted
4094 const struct snd_pcm_chmap_elem snd_pcm_2_1_chmaps[] = {
4096 .map = { SNDRV_CHMAP_FL, SNDRV_CHMAP_FR } },
4098 .map = { SNDRV_CHMAP_FL, SNDRV_CHMAP_FR,
4099 SNDRV_CHMAP_LFE, SNDRV_CHMAP_LFE } },
4102 EXPORT_SYMBOL_GPL(snd_pcm_2_1_chmaps);
4104 int snd_hda_codec_build_controls(struct hda_codec *codec)
4107 hda_exec_init_verbs(codec);
4108 /* continue to initialize... */
4109 if (codec->patch_ops.init)
4110 err = codec->patch_ops.init(codec);
4111 if (!err && codec->patch_ops.build_controls)
4112 err = codec->patch_ops.build_controls(codec);
4116 /* we create chmaps here instead of build_pcms */
4117 err = add_std_chmaps(codec);
4121 if (codec->jackpoll_interval)
4122 hda_jackpoll_work(&codec->jackpoll_work.work);
4124 snd_hda_jack_report_sync(codec); /* call at the last init point */
4125 sync_power_up_states(codec);
4132 struct hda_rate_tbl {
4134 unsigned int alsa_bits;
4135 unsigned int hda_fmt;
4138 /* rate = base * mult / div */
4139 #define HDA_RATE(base, mult, div) \
4140 (AC_FMT_BASE_##base##K | (((mult) - 1) << AC_FMT_MULT_SHIFT) | \
4141 (((div) - 1) << AC_FMT_DIV_SHIFT))
4143 static struct hda_rate_tbl rate_bits[] = {
4144 /* rate in Hz, ALSA rate bitmask, HDA format value */
4146 /* autodetected value used in snd_hda_query_supported_pcm */
4147 { 8000, SNDRV_PCM_RATE_8000, HDA_RATE(48, 1, 6) },
4148 { 11025, SNDRV_PCM_RATE_11025, HDA_RATE(44, 1, 4) },
4149 { 16000, SNDRV_PCM_RATE_16000, HDA_RATE(48, 1, 3) },
4150 { 22050, SNDRV_PCM_RATE_22050, HDA_RATE(44, 1, 2) },
4151 { 32000, SNDRV_PCM_RATE_32000, HDA_RATE(48, 2, 3) },
4152 { 44100, SNDRV_PCM_RATE_44100, HDA_RATE(44, 1, 1) },
4153 { 48000, SNDRV_PCM_RATE_48000, HDA_RATE(48, 1, 1) },
4154 { 88200, SNDRV_PCM_RATE_88200, HDA_RATE(44, 2, 1) },
4155 { 96000, SNDRV_PCM_RATE_96000, HDA_RATE(48, 2, 1) },
4156 { 176400, SNDRV_PCM_RATE_176400, HDA_RATE(44, 4, 1) },
4157 { 192000, SNDRV_PCM_RATE_192000, HDA_RATE(48, 4, 1) },
4158 #define AC_PAR_PCM_RATE_BITS 11
4159 /* up to bits 10, 384kHZ isn't supported properly */
4161 /* not autodetected value */
4162 { 9600, SNDRV_PCM_RATE_KNOT, HDA_RATE(48, 1, 5) },
4164 { 0 } /* terminator */
4168 * snd_hda_calc_stream_format - calculate format bitset
4169 * @rate: the sample rate
4170 * @channels: the number of channels
4171 * @format: the PCM format (SNDRV_PCM_FORMAT_XXX)
4172 * @maxbps: the max. bps
4174 * Calculate the format bitset from the given rate, channels and th PCM format.
4176 * Return zero if invalid.
4178 unsigned int snd_hda_calc_stream_format(unsigned int rate,
4179 unsigned int channels,
4180 unsigned int format,
4181 unsigned int maxbps,
4182 unsigned short spdif_ctls)
4185 unsigned int val = 0;
4187 for (i = 0; rate_bits[i].hz; i++)
4188 if (rate_bits[i].hz == rate) {
4189 val = rate_bits[i].hda_fmt;
4192 if (!rate_bits[i].hz) {
4193 snd_printdd("invalid rate %d\n", rate);
4197 if (channels == 0 || channels > 8) {
4198 snd_printdd("invalid channels %d\n", channels);
4201 val |= channels - 1;
4203 switch (snd_pcm_format_width(format)) {
4205 val |= AC_FMT_BITS_8;
4208 val |= AC_FMT_BITS_16;
4213 if (maxbps >= 32 || format == SNDRV_PCM_FORMAT_FLOAT_LE)
4214 val |= AC_FMT_BITS_32;
4215 else if (maxbps >= 24)
4216 val |= AC_FMT_BITS_24;
4218 val |= AC_FMT_BITS_20;
4221 snd_printdd("invalid format width %d\n",
4222 snd_pcm_format_width(format));
4226 if (spdif_ctls & AC_DIG1_NONAUDIO)
4227 val |= AC_FMT_TYPE_NON_PCM;
4231 EXPORT_SYMBOL_HDA(snd_hda_calc_stream_format);
4233 static unsigned int get_pcm_param(struct hda_codec *codec, hda_nid_t nid,
4236 unsigned int val = 0;
4237 if (nid != codec->afg &&
4238 (get_wcaps(codec, nid) & AC_WCAP_FORMAT_OVRD))
4239 val = snd_hda_param_read(codec, nid, AC_PAR_PCM);
4240 if (!val || val == -1)
4241 val = snd_hda_param_read(codec, codec->afg, AC_PAR_PCM);
4242 if (!val || val == -1)
4247 static unsigned int query_pcm_param(struct hda_codec *codec, hda_nid_t nid)
4249 return query_caps_hash(codec, nid, 0, HDA_HASH_PARPCM_KEY(nid),
4253 static unsigned int get_stream_param(struct hda_codec *codec, hda_nid_t nid,
4256 unsigned int streams = snd_hda_param_read(codec, nid, AC_PAR_STREAM);
4257 if (!streams || streams == -1)
4258 streams = snd_hda_param_read(codec, codec->afg, AC_PAR_STREAM);
4259 if (!streams || streams == -1)
4264 static unsigned int query_stream_param(struct hda_codec *codec, hda_nid_t nid)
4266 return query_caps_hash(codec, nid, 0, HDA_HASH_PARSTR_KEY(nid),
4271 * snd_hda_query_supported_pcm - query the supported PCM rates and formats
4272 * @codec: the HDA codec
4273 * @nid: NID to query
4274 * @ratesp: the pointer to store the detected rate bitflags
4275 * @formatsp: the pointer to store the detected formats
4276 * @bpsp: the pointer to store the detected format widths
4278 * Queries the supported PCM rates and formats. The NULL @ratesp, @formatsp
4279 * or @bsps argument is ignored.
4281 * Returns 0 if successful, otherwise a negative error code.
4283 int snd_hda_query_supported_pcm(struct hda_codec *codec, hda_nid_t nid,
4284 u32 *ratesp, u64 *formatsp, unsigned int *bpsp)
4286 unsigned int i, val, wcaps;
4288 wcaps = get_wcaps(codec, nid);
4289 val = query_pcm_param(codec, nid);
4293 for (i = 0; i < AC_PAR_PCM_RATE_BITS; i++) {
4295 rates |= rate_bits[i].alsa_bits;
4298 snd_printk(KERN_ERR "hda_codec: rates == 0 "
4299 "(nid=0x%x, val=0x%x, ovrd=%i)\n",
4301 (wcaps & AC_WCAP_FORMAT_OVRD) ? 1 : 0);
4307 if (formatsp || bpsp) {
4309 unsigned int streams, bps;
4311 streams = query_stream_param(codec, nid);
4316 if (streams & AC_SUPFMT_PCM) {
4317 if (val & AC_SUPPCM_BITS_8) {
4318 formats |= SNDRV_PCM_FMTBIT_U8;
4321 if (val & AC_SUPPCM_BITS_16) {
4322 formats |= SNDRV_PCM_FMTBIT_S16_LE;
4325 if (wcaps & AC_WCAP_DIGITAL) {
4326 if (val & AC_SUPPCM_BITS_32)
4327 formats |= SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE;
4328 if (val & (AC_SUPPCM_BITS_20|AC_SUPPCM_BITS_24))
4329 formats |= SNDRV_PCM_FMTBIT_S32_LE;
4330 if (val & AC_SUPPCM_BITS_24)
4332 else if (val & AC_SUPPCM_BITS_20)
4334 } else if (val & (AC_SUPPCM_BITS_20|AC_SUPPCM_BITS_24|
4335 AC_SUPPCM_BITS_32)) {
4336 formats |= SNDRV_PCM_FMTBIT_S32_LE;
4337 if (val & AC_SUPPCM_BITS_32)
4339 else if (val & AC_SUPPCM_BITS_24)
4341 else if (val & AC_SUPPCM_BITS_20)
4345 #if 0 /* FIXME: CS4206 doesn't work, which is the only codec supporting float */
4346 if (streams & AC_SUPFMT_FLOAT32) {
4347 formats |= SNDRV_PCM_FMTBIT_FLOAT_LE;
4352 if (streams == AC_SUPFMT_AC3) {
4353 /* should be exclusive */
4354 /* temporary hack: we have still no proper support
4355 * for the direct AC3 stream...
4357 formats |= SNDRV_PCM_FMTBIT_U8;
4361 snd_printk(KERN_ERR "hda_codec: formats == 0 "
4362 "(nid=0x%x, val=0x%x, ovrd=%i, "
4365 (wcaps & AC_WCAP_FORMAT_OVRD) ? 1 : 0,
4370 *formatsp = formats;
4377 EXPORT_SYMBOL_HDA(snd_hda_query_supported_pcm);
4380 * snd_hda_is_supported_format - Check the validity of the format
4381 * @codec: HD-audio codec
4382 * @nid: NID to check
4383 * @format: the HD-audio format value to check
4385 * Check whether the given node supports the format value.
4387 * Returns 1 if supported, 0 if not.
4389 int snd_hda_is_supported_format(struct hda_codec *codec, hda_nid_t nid,
4390 unsigned int format)
4393 unsigned int val = 0, rate, stream;
4395 val = query_pcm_param(codec, nid);
4399 rate = format & 0xff00;
4400 for (i = 0; i < AC_PAR_PCM_RATE_BITS; i++)
4401 if (rate_bits[i].hda_fmt == rate) {
4406 if (i >= AC_PAR_PCM_RATE_BITS)
4409 stream = query_stream_param(codec, nid);
4413 if (stream & AC_SUPFMT_PCM) {
4414 switch (format & 0xf0) {
4416 if (!(val & AC_SUPPCM_BITS_8))
4420 if (!(val & AC_SUPPCM_BITS_16))
4424 if (!(val & AC_SUPPCM_BITS_20))
4428 if (!(val & AC_SUPPCM_BITS_24))
4432 if (!(val & AC_SUPPCM_BITS_32))
4439 /* FIXME: check for float32 and AC3? */
4444 EXPORT_SYMBOL_HDA(snd_hda_is_supported_format);
4449 static int hda_pcm_default_open_close(struct hda_pcm_stream *hinfo,
4450 struct hda_codec *codec,
4451 struct snd_pcm_substream *substream)
4456 static int hda_pcm_default_prepare(struct hda_pcm_stream *hinfo,
4457 struct hda_codec *codec,
4458 unsigned int stream_tag,
4459 unsigned int format,
4460 struct snd_pcm_substream *substream)
4462 snd_hda_codec_setup_stream(codec, hinfo->nid, stream_tag, 0, format);
4466 static int hda_pcm_default_cleanup(struct hda_pcm_stream *hinfo,
4467 struct hda_codec *codec,
4468 struct snd_pcm_substream *substream)
4470 snd_hda_codec_cleanup_stream(codec, hinfo->nid);
4474 static int set_pcm_default_values(struct hda_codec *codec,
4475 struct hda_pcm_stream *info)
4479 /* query support PCM information from the given NID */
4480 if (info->nid && (!info->rates || !info->formats)) {
4481 err = snd_hda_query_supported_pcm(codec, info->nid,
4482 info->rates ? NULL : &info->rates,
4483 info->formats ? NULL : &info->formats,
4484 info->maxbps ? NULL : &info->maxbps);
4488 if (info->ops.open == NULL)
4489 info->ops.open = hda_pcm_default_open_close;
4490 if (info->ops.close == NULL)
4491 info->ops.close = hda_pcm_default_open_close;
4492 if (info->ops.prepare == NULL) {
4493 if (snd_BUG_ON(!info->nid))
4495 info->ops.prepare = hda_pcm_default_prepare;
4497 if (info->ops.cleanup == NULL) {
4498 if (snd_BUG_ON(!info->nid))
4500 info->ops.cleanup = hda_pcm_default_cleanup;
4506 * codec prepare/cleanup entries
4508 int snd_hda_codec_prepare(struct hda_codec *codec,
4509 struct hda_pcm_stream *hinfo,
4510 unsigned int stream,
4511 unsigned int format,
4512 struct snd_pcm_substream *substream)
4515 mutex_lock(&codec->bus->prepare_mutex);
4516 ret = hinfo->ops.prepare(hinfo, codec, stream, format, substream);
4518 purify_inactive_streams(codec);
4519 mutex_unlock(&codec->bus->prepare_mutex);
4522 EXPORT_SYMBOL_HDA(snd_hda_codec_prepare);
4524 void snd_hda_codec_cleanup(struct hda_codec *codec,
4525 struct hda_pcm_stream *hinfo,
4526 struct snd_pcm_substream *substream)
4528 mutex_lock(&codec->bus->prepare_mutex);
4529 hinfo->ops.cleanup(hinfo, codec, substream);
4530 mutex_unlock(&codec->bus->prepare_mutex);
4532 EXPORT_SYMBOL_HDA(snd_hda_codec_cleanup);
4535 const char *snd_hda_pcm_type_name[HDA_PCM_NTYPES] = {
4536 "Audio", "SPDIF", "HDMI", "Modem"
4540 * get the empty PCM device number to assign
4542 static int get_empty_pcm_device(struct hda_bus *bus, unsigned int type)
4544 /* audio device indices; not linear to keep compatibility */
4545 /* assigned to static slots up to dev#10; if more needed, assign
4546 * the later slot dynamically (when CONFIG_SND_DYNAMIC_MINORS=y)
4548 static int audio_idx[HDA_PCM_NTYPES][5] = {
4549 [HDA_PCM_TYPE_AUDIO] = { 0, 2, 4, 5, -1 },
4550 [HDA_PCM_TYPE_SPDIF] = { 1, -1 },
4551 [HDA_PCM_TYPE_HDMI] = { 3, 7, 8, 9, -1 },
4552 [HDA_PCM_TYPE_MODEM] = { 6, -1 },
4556 if (type >= HDA_PCM_NTYPES) {
4557 snd_printk(KERN_WARNING "Invalid PCM type %d\n", type);
4561 for (i = 0; audio_idx[type][i] >= 0; i++) {
4562 #ifndef CONFIG_SND_DYNAMIC_MINORS
4563 if (audio_idx[type][i] >= 8)
4566 if (!test_and_set_bit(audio_idx[type][i], bus->pcm_dev_bits))
4567 return audio_idx[type][i];
4570 #ifdef CONFIG_SND_DYNAMIC_MINORS
4571 /* non-fixed slots starting from 10 */
4572 for (i = 10; i < 32; i++) {
4573 if (!test_and_set_bit(i, bus->pcm_dev_bits))
4578 snd_printk(KERN_WARNING "Too many %s devices\n",
4579 snd_hda_pcm_type_name[type]);
4580 #ifndef CONFIG_SND_DYNAMIC_MINORS
4581 snd_printk(KERN_WARNING "Consider building the kernel with CONFIG_SND_DYNAMIC_MINORS=y\n");
4587 * attach a new PCM stream
4589 static int snd_hda_attach_pcm(struct hda_codec *codec, struct hda_pcm *pcm)
4591 struct hda_bus *bus = codec->bus;
4592 struct hda_pcm_stream *info;
4595 if (snd_BUG_ON(!pcm->name))
4597 for (stream = 0; stream < 2; stream++) {
4598 info = &pcm->stream[stream];
4599 if (info->substreams) {
4600 err = set_pcm_default_values(codec, info);
4605 return bus->ops.attach_pcm(bus, codec, pcm);
4608 /* assign all PCMs of the given codec */
4609 int snd_hda_codec_build_pcms(struct hda_codec *codec)
4614 if (!codec->num_pcms) {
4615 if (!codec->patch_ops.build_pcms)
4617 err = codec->patch_ops.build_pcms(codec);
4619 printk(KERN_ERR "hda_codec: cannot build PCMs"
4620 "for #%d (error %d)\n", codec->addr, err);
4621 err = snd_hda_codec_reset(codec);
4624 "hda_codec: cannot revert codec\n");
4629 for (pcm = 0; pcm < codec->num_pcms; pcm++) {
4630 struct hda_pcm *cpcm = &codec->pcm_info[pcm];
4633 if (!cpcm->stream[0].substreams && !cpcm->stream[1].substreams)
4634 continue; /* no substreams assigned */
4637 dev = get_empty_pcm_device(codec->bus, cpcm->pcm_type);
4639 continue; /* no fatal error */
4641 err = snd_hda_attach_pcm(codec, cpcm);
4643 printk(KERN_ERR "hda_codec: cannot attach "
4644 "PCM stream %d for codec #%d\n",
4646 continue; /* no fatal error */
4654 * snd_hda_build_pcms - build PCM information
4657 * Create PCM information for each codec included in the bus.
4659 * The build_pcms codec patch is requested to set up codec->num_pcms and
4660 * codec->pcm_info properly. The array is referred by the top-level driver
4661 * to create its PCM instances.
4662 * The allocated codec->pcm_info should be released in codec->patch_ops.free
4665 * At least, substreams, channels_min and channels_max must be filled for
4666 * each stream. substreams = 0 indicates that the stream doesn't exist.
4667 * When rates and/or formats are zero, the supported values are queried
4668 * from the given nid. The nid is used also by the default ops.prepare
4669 * and ops.cleanup callbacks.
4671 * The driver needs to call ops.open in its open callback. Similarly,
4672 * ops.close is supposed to be called in the close callback.
4673 * ops.prepare should be called in the prepare or hw_params callback
4674 * with the proper parameters for set up.
4675 * ops.cleanup should be called in hw_free for clean up of streams.
4677 * This function returns 0 if successful, or a negative error code.
4679 int snd_hda_build_pcms(struct hda_bus *bus)
4681 struct hda_codec *codec;
4683 list_for_each_entry(codec, &bus->codec_list, list) {
4684 int err = snd_hda_codec_build_pcms(codec);
4690 EXPORT_SYMBOL_HDA(snd_hda_build_pcms);
4693 * snd_hda_check_board_config - compare the current codec with the config table
4694 * @codec: the HDA codec
4695 * @num_configs: number of config enums
4696 * @models: array of model name strings
4697 * @tbl: configuration table, terminated by null entries
4699 * Compares the modelname or PCI subsystem id of the current codec with the
4700 * given configuration table. If a matching entry is found, returns its
4701 * config value (supposed to be 0 or positive).
4703 * If no entries are matching, the function returns a negative value.
4705 int snd_hda_check_board_config(struct hda_codec *codec,
4706 int num_configs, const char * const *models,
4707 const struct snd_pci_quirk *tbl)
4709 if (codec->modelname && models) {
4711 for (i = 0; i < num_configs; i++) {
4713 !strcmp(codec->modelname, models[i])) {
4714 snd_printd(KERN_INFO "hda_codec: model '%s' is "
4715 "selected\n", models[i]);
4721 if (!codec->bus->pci || !tbl)
4724 tbl = snd_pci_quirk_lookup(codec->bus->pci, tbl);
4727 if (tbl->value >= 0 && tbl->value < num_configs) {
4728 #ifdef CONFIG_SND_DEBUG_VERBOSE
4730 const char *model = NULL;
4732 model = models[tbl->value];
4734 sprintf(tmp, "#%d", tbl->value);
4737 snd_printdd(KERN_INFO "hda_codec: model '%s' is selected "
4738 "for config %x:%x (%s)\n",
4739 model, tbl->subvendor, tbl->subdevice,
4740 (tbl->name ? tbl->name : "Unknown device"));
4746 EXPORT_SYMBOL_HDA(snd_hda_check_board_config);
4749 * snd_hda_check_board_codec_sid_config - compare the current codec
4750 subsystem ID with the
4753 This is important for Gateway notebooks with SB450 HDA Audio
4754 where the vendor ID of the PCI device is:
4755 ATI Technologies Inc SB450 HDA Audio [1002:437b]
4756 and the vendor/subvendor are found only at the codec.
4758 * @codec: the HDA codec
4759 * @num_configs: number of config enums
4760 * @models: array of model name strings
4761 * @tbl: configuration table, terminated by null entries
4763 * Compares the modelname or PCI subsystem id of the current codec with the
4764 * given configuration table. If a matching entry is found, returns its
4765 * config value (supposed to be 0 or positive).
4767 * If no entries are matching, the function returns a negative value.
4769 int snd_hda_check_board_codec_sid_config(struct hda_codec *codec,
4770 int num_configs, const char * const *models,
4771 const struct snd_pci_quirk *tbl)
4773 const struct snd_pci_quirk *q;
4775 /* Search for codec ID */
4776 for (q = tbl; q->subvendor; q++) {
4777 unsigned int mask = 0xffff0000 | q->subdevice_mask;
4778 unsigned int id = (q->subdevice | (q->subvendor << 16)) & mask;
4779 if ((codec->subsystem_id & mask) == id)
4788 if (tbl->value >= 0 && tbl->value < num_configs) {
4789 #ifdef CONFIG_SND_DEBUG_VERBOSE
4791 const char *model = NULL;
4793 model = models[tbl->value];
4795 sprintf(tmp, "#%d", tbl->value);
4798 snd_printdd(KERN_INFO "hda_codec: model '%s' is selected "
4799 "for config %x:%x (%s)\n",
4800 model, tbl->subvendor, tbl->subdevice,
4801 (tbl->name ? tbl->name : "Unknown device"));
4807 EXPORT_SYMBOL_HDA(snd_hda_check_board_codec_sid_config);
4810 * snd_hda_add_new_ctls - create controls from the array
4811 * @codec: the HDA codec
4812 * @knew: the array of struct snd_kcontrol_new
4814 * This helper function creates and add new controls in the given array.
4815 * The array must be terminated with an empty entry as terminator.
4817 * Returns 0 if successful, or a negative error code.
4819 int snd_hda_add_new_ctls(struct hda_codec *codec,
4820 const struct snd_kcontrol_new *knew)
4824 for (; knew->name; knew++) {
4825 struct snd_kcontrol *kctl;
4826 int addr = 0, idx = 0;
4827 if (knew->iface == -1) /* skip this codec private value */
4830 kctl = snd_ctl_new1(knew, codec);
4834 kctl->id.device = addr;
4836 kctl->id.index = idx;
4837 err = snd_hda_ctl_add(codec, 0, kctl);
4840 /* try first with another device index corresponding to
4841 * the codec addr; if it still fails (or it's the
4842 * primary codec), then try another control index
4844 if (!addr && codec->addr)
4846 else if (!idx && !knew->index) {
4847 idx = find_empty_mixer_ctl_idx(codec,
4857 EXPORT_SYMBOL_HDA(snd_hda_add_new_ctls);
4860 static void hda_power_work(struct work_struct *work)
4862 struct hda_codec *codec =
4863 container_of(work, struct hda_codec, power_work.work);
4864 struct hda_bus *bus = codec->bus;
4867 spin_lock(&codec->power_lock);
4868 if (codec->power_transition > 0) { /* during power-up sequence? */
4869 spin_unlock(&codec->power_lock);
4872 if (!codec->power_on || codec->power_count) {
4873 codec->power_transition = 0;
4874 spin_unlock(&codec->power_lock);
4877 spin_unlock(&codec->power_lock);
4879 state = hda_call_codec_suspend(codec, true);
4880 if (!codec->pm_down_notified &&
4881 !bus->power_keep_link_on && (state & AC_PWRST_CLK_STOP_OK)) {
4882 codec->pm_down_notified = 1;
4883 hda_call_pm_notify(bus, false);
4887 static void hda_keep_power_on(struct hda_codec *codec)
4889 spin_lock(&codec->power_lock);
4890 codec->power_count++;
4891 codec->power_on = 1;
4892 codec->power_jiffies = jiffies;
4893 spin_unlock(&codec->power_lock);
4896 /* update the power on/off account with the current jiffies */
4897 void snd_hda_update_power_acct(struct hda_codec *codec)
4899 unsigned long delta = jiffies - codec->power_jiffies;
4900 if (codec->power_on)
4901 codec->power_on_acct += delta;
4903 codec->power_off_acct += delta;
4904 codec->power_jiffies += delta;
4907 /* Transition to powered up, if wait_power_down then wait for a pending
4908 * transition to D3 to complete. A pending D3 transition is indicated
4909 * with power_transition == -1. */
4910 /* call this with codec->power_lock held! */
4911 static void __snd_hda_power_up(struct hda_codec *codec, bool wait_power_down)
4913 struct hda_bus *bus = codec->bus;
4915 /* Return if power_on or transitioning to power_on, unless currently
4917 if ((codec->power_on || codec->power_transition > 0) &&
4918 !(wait_power_down && codec->power_transition < 0))
4920 spin_unlock(&codec->power_lock);
4922 cancel_delayed_work_sync(&codec->power_work);
4924 spin_lock(&codec->power_lock);
4925 /* If the power down delayed work was cancelled above before starting,
4926 * then there is no need to go through power up here.
4928 if (codec->power_on) {
4929 if (codec->power_transition < 0)
4930 codec->power_transition = 0;
4934 trace_hda_power_up(codec);
4935 snd_hda_update_power_acct(codec);
4936 codec->power_on = 1;
4937 codec->power_jiffies = jiffies;
4938 codec->power_transition = 1; /* avoid reentrance */
4939 spin_unlock(&codec->power_lock);
4941 if (codec->pm_down_notified) {
4942 codec->pm_down_notified = 0;
4943 hda_call_pm_notify(bus, true);
4946 hda_call_codec_resume(codec);
4948 spin_lock(&codec->power_lock);
4949 codec->power_transition = 0;
4952 #define power_save(codec) \
4953 ((codec)->bus->power_save ? *(codec)->bus->power_save : 0)
4955 /* Transition to powered down */
4956 static void __snd_hda_power_down(struct hda_codec *codec)
4958 if (!codec->power_on || codec->power_count || codec->power_transition)
4961 if (power_save(codec)) {
4962 codec->power_transition = -1; /* avoid reentrance */
4963 queue_delayed_work(codec->bus->workq, &codec->power_work,
4964 msecs_to_jiffies(power_save(codec) * 1000));
4969 * snd_hda_power_save - Power-up/down/sync the codec
4970 * @codec: HD-audio codec
4971 * @delta: the counter delta to change
4973 * Change the power-up counter via @delta, and power up or down the hardware
4974 * appropriately. For the power-down, queue to the delayed action.
4975 * Passing zero to @delta means to synchronize the power state.
4977 void snd_hda_power_save(struct hda_codec *codec, int delta, bool d3wait)
4979 spin_lock(&codec->power_lock);
4980 codec->power_count += delta;
4981 trace_hda_power_count(codec);
4983 __snd_hda_power_up(codec, d3wait);
4985 __snd_hda_power_down(codec);
4986 spin_unlock(&codec->power_lock);
4988 EXPORT_SYMBOL_HDA(snd_hda_power_save);
4991 * snd_hda_check_amp_list_power - Check the amp list and update the power
4992 * @codec: HD-audio codec
4993 * @check: the object containing an AMP list and the status
4994 * @nid: NID to check / update
4996 * Check whether the given NID is in the amp list. If it's in the list,
4997 * check the current AMP status, and update the the power-status according
4998 * to the mute status.
5000 * This function is supposed to be set or called from the check_power_status
5003 int snd_hda_check_amp_list_power(struct hda_codec *codec,
5004 struct hda_loopback_check *check,
5007 const struct hda_amp_list *p;
5010 if (!check->amplist)
5012 for (p = check->amplist; p->nid; p++) {
5017 return 0; /* nothing changed */
5019 for (p = check->amplist; p->nid; p++) {
5020 for (ch = 0; ch < 2; ch++) {
5021 v = snd_hda_codec_amp_read(codec, p->nid, ch, p->dir,
5023 if (!(v & HDA_AMP_MUTE) && v > 0) {
5024 if (!check->power_on) {
5025 check->power_on = 1;
5026 snd_hda_power_up(codec);
5032 if (check->power_on) {
5033 check->power_on = 0;
5034 snd_hda_power_down(codec);
5038 EXPORT_SYMBOL_HDA(snd_hda_check_amp_list_power);
5042 * Channel mode helper
5046 * snd_hda_ch_mode_info - Info callback helper for the channel mode enum
5048 int snd_hda_ch_mode_info(struct hda_codec *codec,
5049 struct snd_ctl_elem_info *uinfo,
5050 const struct hda_channel_mode *chmode,
5053 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
5055 uinfo->value.enumerated.items = num_chmodes;
5056 if (uinfo->value.enumerated.item >= num_chmodes)
5057 uinfo->value.enumerated.item = num_chmodes - 1;
5058 sprintf(uinfo->value.enumerated.name, "%dch",
5059 chmode[uinfo->value.enumerated.item].channels);
5062 EXPORT_SYMBOL_HDA(snd_hda_ch_mode_info);
5065 * snd_hda_ch_mode_get - Get callback helper for the channel mode enum
5067 int snd_hda_ch_mode_get(struct hda_codec *codec,
5068 struct snd_ctl_elem_value *ucontrol,
5069 const struct hda_channel_mode *chmode,
5075 for (i = 0; i < num_chmodes; i++) {
5076 if (max_channels == chmode[i].channels) {
5077 ucontrol->value.enumerated.item[0] = i;
5083 EXPORT_SYMBOL_HDA(snd_hda_ch_mode_get);
5086 * snd_hda_ch_mode_put - Put callback helper for the channel mode enum
5088 int snd_hda_ch_mode_put(struct hda_codec *codec,
5089 struct snd_ctl_elem_value *ucontrol,
5090 const struct hda_channel_mode *chmode,
5096 mode = ucontrol->value.enumerated.item[0];
5097 if (mode >= num_chmodes)
5099 if (*max_channelsp == chmode[mode].channels)
5101 /* change the current channel setting */
5102 *max_channelsp = chmode[mode].channels;
5103 if (chmode[mode].sequence)
5104 snd_hda_sequence_write_cache(codec, chmode[mode].sequence);
5107 EXPORT_SYMBOL_HDA(snd_hda_ch_mode_put);
5114 * snd_hda_input_mux_info_info - Info callback helper for the input-mux enum
5116 int snd_hda_input_mux_info(const struct hda_input_mux *imux,
5117 struct snd_ctl_elem_info *uinfo)
5121 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
5123 uinfo->value.enumerated.items = imux->num_items;
5124 if (!imux->num_items)
5126 index = uinfo->value.enumerated.item;
5127 if (index >= imux->num_items)
5128 index = imux->num_items - 1;
5129 strcpy(uinfo->value.enumerated.name, imux->items[index].label);
5132 EXPORT_SYMBOL_HDA(snd_hda_input_mux_info);
5135 * snd_hda_input_mux_info_put - Put callback helper for the input-mux enum
5137 int snd_hda_input_mux_put(struct hda_codec *codec,
5138 const struct hda_input_mux *imux,
5139 struct snd_ctl_elem_value *ucontrol,
5141 unsigned int *cur_val)
5145 if (!imux->num_items)
5147 idx = ucontrol->value.enumerated.item[0];
5148 if (idx >= imux->num_items)
5149 idx = imux->num_items - 1;
5150 if (*cur_val == idx)
5152 snd_hda_codec_write_cache(codec, nid, 0, AC_VERB_SET_CONNECT_SEL,
5153 imux->items[idx].index);
5157 EXPORT_SYMBOL_HDA(snd_hda_input_mux_put);
5161 * process kcontrol info callback of a simple string enum array
5162 * when @num_items is 0 or @texts is NULL, assume a boolean enum array
5164 int snd_hda_enum_helper_info(struct snd_kcontrol *kcontrol,
5165 struct snd_ctl_elem_info *uinfo,
5166 int num_items, const char * const *texts)
5168 static const char * const texts_default[] = {
5169 "Disabled", "Enabled"
5172 if (!texts || !num_items) {
5174 texts = texts_default;
5177 uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
5179 uinfo->value.enumerated.items = num_items;
5180 if (uinfo->value.enumerated.item >= uinfo->value.enumerated.items)
5181 uinfo->value.enumerated.item = uinfo->value.enumerated.items - 1;
5182 strcpy(uinfo->value.enumerated.name,
5183 texts[uinfo->value.enumerated.item]);
5186 EXPORT_SYMBOL_HDA(snd_hda_enum_helper_info);
5189 * Multi-channel / digital-out PCM helper functions
5192 /* setup SPDIF output stream */
5193 static void setup_dig_out_stream(struct hda_codec *codec, hda_nid_t nid,
5194 unsigned int stream_tag, unsigned int format)
5196 struct hda_spdif_out *spdif;
5197 unsigned int curr_fmt;
5200 spdif = snd_hda_spdif_out_of_nid(codec, nid);
5201 curr_fmt = snd_hda_codec_read(codec, nid, 0,
5202 AC_VERB_GET_STREAM_FORMAT, 0);
5203 reset = codec->spdif_status_reset &&
5204 (spdif->ctls & AC_DIG1_ENABLE) &&
5207 /* turn off SPDIF if needed; otherwise the IEC958 bits won't be
5210 set_dig_out_convert(codec, nid,
5211 spdif->ctls & ~AC_DIG1_ENABLE & 0xff,
5213 snd_hda_codec_setup_stream(codec, nid, stream_tag, 0, format);
5214 if (codec->slave_dig_outs) {
5216 for (d = codec->slave_dig_outs; *d; d++)
5217 snd_hda_codec_setup_stream(codec, *d, stream_tag, 0,
5220 /* turn on again (if needed) */
5222 set_dig_out_convert(codec, nid,
5223 spdif->ctls & 0xff, -1);
5226 static void cleanup_dig_out_stream(struct hda_codec *codec, hda_nid_t nid)
5228 snd_hda_codec_cleanup_stream(codec, nid);
5229 if (codec->slave_dig_outs) {
5231 for (d = codec->slave_dig_outs; *d; d++)
5232 snd_hda_codec_cleanup_stream(codec, *d);
5237 * snd_hda_bus_reboot_notify - call the reboot notifier of each codec
5238 * @bus: HD-audio bus
5240 void snd_hda_bus_reboot_notify(struct hda_bus *bus)
5242 struct hda_codec *codec;
5246 list_for_each_entry(codec, &bus->codec_list, list) {
5247 if (hda_codec_is_power_on(codec) &&
5248 codec->patch_ops.reboot_notify)
5249 codec->patch_ops.reboot_notify(codec);
5252 EXPORT_SYMBOL_HDA(snd_hda_bus_reboot_notify);
5255 * snd_hda_multi_out_dig_open - open the digital out in the exclusive mode
5257 int snd_hda_multi_out_dig_open(struct hda_codec *codec,
5258 struct hda_multi_out *mout)
5260 mutex_lock(&codec->spdif_mutex);
5261 if (mout->dig_out_used == HDA_DIG_ANALOG_DUP)
5262 /* already opened as analog dup; reset it once */
5263 cleanup_dig_out_stream(codec, mout->dig_out_nid);
5264 mout->dig_out_used = HDA_DIG_EXCLUSIVE;
5265 mutex_unlock(&codec->spdif_mutex);
5268 EXPORT_SYMBOL_HDA(snd_hda_multi_out_dig_open);
5271 * snd_hda_multi_out_dig_prepare - prepare the digital out stream
5273 int snd_hda_multi_out_dig_prepare(struct hda_codec *codec,
5274 struct hda_multi_out *mout,
5275 unsigned int stream_tag,
5276 unsigned int format,
5277 struct snd_pcm_substream *substream)
5279 mutex_lock(&codec->spdif_mutex);
5280 setup_dig_out_stream(codec, mout->dig_out_nid, stream_tag, format);
5281 mutex_unlock(&codec->spdif_mutex);
5284 EXPORT_SYMBOL_HDA(snd_hda_multi_out_dig_prepare);
5287 * snd_hda_multi_out_dig_cleanup - clean-up the digital out stream
5289 int snd_hda_multi_out_dig_cleanup(struct hda_codec *codec,
5290 struct hda_multi_out *mout)
5292 mutex_lock(&codec->spdif_mutex);
5293 cleanup_dig_out_stream(codec, mout->dig_out_nid);
5294 mutex_unlock(&codec->spdif_mutex);
5297 EXPORT_SYMBOL_HDA(snd_hda_multi_out_dig_cleanup);
5300 * snd_hda_multi_out_dig_close - release the digital out stream
5302 int snd_hda_multi_out_dig_close(struct hda_codec *codec,
5303 struct hda_multi_out *mout)
5305 mutex_lock(&codec->spdif_mutex);
5306 mout->dig_out_used = 0;
5307 mutex_unlock(&codec->spdif_mutex);
5310 EXPORT_SYMBOL_HDA(snd_hda_multi_out_dig_close);
5313 * snd_hda_multi_out_analog_open - open analog outputs
5315 * Open analog outputs and set up the hw-constraints.
5316 * If the digital outputs can be opened as slave, open the digital
5319 int snd_hda_multi_out_analog_open(struct hda_codec *codec,
5320 struct hda_multi_out *mout,
5321 struct snd_pcm_substream *substream,
5322 struct hda_pcm_stream *hinfo)
5324 struct snd_pcm_runtime *runtime = substream->runtime;
5325 runtime->hw.channels_max = mout->max_channels;
5326 if (mout->dig_out_nid) {
5327 if (!mout->analog_rates) {
5328 mout->analog_rates = hinfo->rates;
5329 mout->analog_formats = hinfo->formats;
5330 mout->analog_maxbps = hinfo->maxbps;
5332 runtime->hw.rates = mout->analog_rates;
5333 runtime->hw.formats = mout->analog_formats;
5334 hinfo->maxbps = mout->analog_maxbps;
5336 if (!mout->spdif_rates) {
5337 snd_hda_query_supported_pcm(codec, mout->dig_out_nid,
5339 &mout->spdif_formats,
5340 &mout->spdif_maxbps);
5342 mutex_lock(&codec->spdif_mutex);
5343 if (mout->share_spdif) {
5344 if ((runtime->hw.rates & mout->spdif_rates) &&
5345 (runtime->hw.formats & mout->spdif_formats)) {
5346 runtime->hw.rates &= mout->spdif_rates;
5347 runtime->hw.formats &= mout->spdif_formats;
5348 if (mout->spdif_maxbps < hinfo->maxbps)
5349 hinfo->maxbps = mout->spdif_maxbps;
5351 mout->share_spdif = 0;
5352 /* FIXME: need notify? */
5355 mutex_unlock(&codec->spdif_mutex);
5357 return snd_pcm_hw_constraint_step(substream->runtime, 0,
5358 SNDRV_PCM_HW_PARAM_CHANNELS, 2);
5360 EXPORT_SYMBOL_HDA(snd_hda_multi_out_analog_open);
5363 * snd_hda_multi_out_analog_prepare - Preapre the analog outputs.
5365 * Set up the i/o for analog out.
5366 * When the digital out is available, copy the front out to digital out, too.
5368 int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,
5369 struct hda_multi_out *mout,
5370 unsigned int stream_tag,
5371 unsigned int format,
5372 struct snd_pcm_substream *substream)
5374 const hda_nid_t *nids = mout->dac_nids;
5375 int chs = substream->runtime->channels;
5376 struct hda_spdif_out *spdif;
5379 mutex_lock(&codec->spdif_mutex);
5380 spdif = snd_hda_spdif_out_of_nid(codec, mout->dig_out_nid);
5381 if (mout->dig_out_nid && mout->share_spdif &&
5382 mout->dig_out_used != HDA_DIG_EXCLUSIVE) {
5384 snd_hda_is_supported_format(codec, mout->dig_out_nid,
5386 !(spdif->status & IEC958_AES0_NONAUDIO)) {
5387 mout->dig_out_used = HDA_DIG_ANALOG_DUP;
5388 setup_dig_out_stream(codec, mout->dig_out_nid,
5389 stream_tag, format);
5391 mout->dig_out_used = 0;
5392 cleanup_dig_out_stream(codec, mout->dig_out_nid);
5395 mutex_unlock(&codec->spdif_mutex);
5398 snd_hda_codec_setup_stream(codec, nids[HDA_FRONT], stream_tag,
5400 if (!mout->no_share_stream &&
5401 mout->hp_nid && mout->hp_nid != nids[HDA_FRONT])
5402 /* headphone out will just decode front left/right (stereo) */
5403 snd_hda_codec_setup_stream(codec, mout->hp_nid, stream_tag,
5405 /* extra outputs copied from front */
5406 for (i = 0; i < ARRAY_SIZE(mout->hp_out_nid); i++)
5407 if (!mout->no_share_stream && mout->hp_out_nid[i])
5408 snd_hda_codec_setup_stream(codec,
5409 mout->hp_out_nid[i],
5410 stream_tag, 0, format);
5413 for (i = 1; i < mout->num_dacs; i++) {
5414 if (chs >= (i + 1) * 2) /* independent out */
5415 snd_hda_codec_setup_stream(codec, nids[i], stream_tag,
5417 else if (!mout->no_share_stream) /* copy front */
5418 snd_hda_codec_setup_stream(codec, nids[i], stream_tag,
5422 /* extra surrounds */
5423 for (i = 0; i < ARRAY_SIZE(mout->extra_out_nid); i++) {
5425 if (!mout->extra_out_nid[i])
5427 if (chs >= (i + 1) * 2)
5429 else if (!mout->no_share_stream)
5431 snd_hda_codec_setup_stream(codec, mout->extra_out_nid[i],
5432 stream_tag, ch, format);
5437 EXPORT_SYMBOL_HDA(snd_hda_multi_out_analog_prepare);
5440 * snd_hda_multi_out_analog_cleanup - clean up the setting for analog out
5442 int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,
5443 struct hda_multi_out *mout)
5445 const hda_nid_t *nids = mout->dac_nids;
5448 for (i = 0; i < mout->num_dacs; i++)
5449 snd_hda_codec_cleanup_stream(codec, nids[i]);
5451 snd_hda_codec_cleanup_stream(codec, mout->hp_nid);
5452 for (i = 0; i < ARRAY_SIZE(mout->hp_out_nid); i++)
5453 if (mout->hp_out_nid[i])
5454 snd_hda_codec_cleanup_stream(codec,
5455 mout->hp_out_nid[i]);
5456 for (i = 0; i < ARRAY_SIZE(mout->extra_out_nid); i++)
5457 if (mout->extra_out_nid[i])
5458 snd_hda_codec_cleanup_stream(codec,
5459 mout->extra_out_nid[i]);
5460 mutex_lock(&codec->spdif_mutex);
5461 if (mout->dig_out_nid && mout->dig_out_used == HDA_DIG_ANALOG_DUP) {
5462 cleanup_dig_out_stream(codec, mout->dig_out_nid);
5463 mout->dig_out_used = 0;
5465 mutex_unlock(&codec->spdif_mutex);
5468 EXPORT_SYMBOL_HDA(snd_hda_multi_out_analog_cleanup);
5471 * snd_hda_get_default_vref - Get the default (mic) VREF pin bits
5473 * Guess the suitable VREF pin bits to be set as the pin-control value.
5474 * Note: the function doesn't set the AC_PINCTL_IN_EN bit.
5476 unsigned int snd_hda_get_default_vref(struct hda_codec *codec, hda_nid_t pin)
5478 unsigned int pincap;
5479 unsigned int oldval;
5480 oldval = snd_hda_codec_read(codec, pin, 0,
5481 AC_VERB_GET_PIN_WIDGET_CONTROL, 0);
5482 pincap = snd_hda_query_pin_caps(codec, pin);
5483 pincap = (pincap & AC_PINCAP_VREF) >> AC_PINCAP_VREF_SHIFT;
5484 /* Exception: if the default pin setup is vref50, we give it priority */
5485 if ((pincap & AC_PINCAP_VREF_80) && oldval != PIN_VREF50)
5486 return AC_PINCTL_VREF_80;
5487 else if (pincap & AC_PINCAP_VREF_50)
5488 return AC_PINCTL_VREF_50;
5489 else if (pincap & AC_PINCAP_VREF_100)
5490 return AC_PINCTL_VREF_100;
5491 else if (pincap & AC_PINCAP_VREF_GRD)
5492 return AC_PINCTL_VREF_GRD;
5493 return AC_PINCTL_VREF_HIZ;
5495 EXPORT_SYMBOL_HDA(snd_hda_get_default_vref);
5497 /* correct the pin ctl value for matching with the pin cap */
5498 unsigned int snd_hda_correct_pin_ctl(struct hda_codec *codec,
5499 hda_nid_t pin, unsigned int val)
5501 static unsigned int cap_lists[][2] = {
5502 { AC_PINCTL_VREF_100, AC_PINCAP_VREF_100 },
5503 { AC_PINCTL_VREF_80, AC_PINCAP_VREF_80 },
5504 { AC_PINCTL_VREF_50, AC_PINCAP_VREF_50 },
5505 { AC_PINCTL_VREF_GRD, AC_PINCAP_VREF_GRD },
5511 cap = snd_hda_query_pin_caps(codec, pin);
5513 return val; /* don't know what to do... */
5515 if (val & AC_PINCTL_OUT_EN) {
5516 if (!(cap & AC_PINCAP_OUT))
5517 val &= ~(AC_PINCTL_OUT_EN | AC_PINCTL_HP_EN);
5518 else if ((val & AC_PINCTL_HP_EN) && !(cap & AC_PINCAP_HP_DRV))
5519 val &= ~AC_PINCTL_HP_EN;
5522 if (val & AC_PINCTL_IN_EN) {
5523 if (!(cap & AC_PINCAP_IN))
5524 val &= ~(AC_PINCTL_IN_EN | AC_PINCTL_VREFEN);
5526 unsigned int vcap, vref;
5528 vcap = (cap & AC_PINCAP_VREF) >> AC_PINCAP_VREF_SHIFT;
5529 vref = val & AC_PINCTL_VREFEN;
5530 for (i = 0; i < ARRAY_SIZE(cap_lists); i++) {
5531 if (vref == cap_lists[i][0] &&
5532 !(vcap & cap_lists[i][1])) {
5533 if (i == ARRAY_SIZE(cap_lists) - 1)
5534 vref = AC_PINCTL_VREF_HIZ;
5536 vref = cap_lists[i + 1][0];
5539 val &= ~AC_PINCTL_VREFEN;
5546 EXPORT_SYMBOL_HDA(snd_hda_correct_pin_ctl);
5548 int _snd_hda_set_pin_ctl(struct hda_codec *codec, hda_nid_t pin,
5549 unsigned int val, bool cached)
5551 val = snd_hda_correct_pin_ctl(codec, pin, val);
5552 snd_hda_codec_set_pin_target(codec, pin, val);
5554 return snd_hda_codec_update_cache(codec, pin, 0,
5555 AC_VERB_SET_PIN_WIDGET_CONTROL, val);
5557 return snd_hda_codec_write(codec, pin, 0,
5558 AC_VERB_SET_PIN_WIDGET_CONTROL, val);
5560 EXPORT_SYMBOL_HDA(_snd_hda_set_pin_ctl);
5563 * snd_hda_add_imux_item - Add an item to input_mux
5565 * When the same label is used already in the existing items, the number
5566 * suffix is appended to the label. This label index number is stored
5567 * to type_idx when non-NULL pointer is given.
5569 int snd_hda_add_imux_item(struct hda_input_mux *imux, const char *label,
5570 int index, int *type_idx)
5572 int i, label_idx = 0;
5573 if (imux->num_items >= HDA_MAX_NUM_INPUTS) {
5574 snd_printd(KERN_ERR "hda_codec: Too many imux items!\n");
5577 for (i = 0; i < imux->num_items; i++) {
5578 if (!strncmp(label, imux->items[i].label, strlen(label)))
5582 *type_idx = label_idx;
5584 snprintf(imux->items[imux->num_items].label,
5585 sizeof(imux->items[imux->num_items].label),
5586 "%s %d", label, label_idx);
5588 strlcpy(imux->items[imux->num_items].label, label,
5589 sizeof(imux->items[imux->num_items].label));
5590 imux->items[imux->num_items].index = index;
5594 EXPORT_SYMBOL_HDA(snd_hda_add_imux_item);
5603 * snd_hda_suspend - suspend the codecs
5606 * Returns 0 if successful.
5608 int snd_hda_suspend(struct hda_bus *bus)
5610 struct hda_codec *codec;
5612 list_for_each_entry(codec, &bus->codec_list, list) {
5613 cancel_delayed_work_sync(&codec->jackpoll_work);
5614 if (hda_codec_is_power_on(codec))
5615 hda_call_codec_suspend(codec, false);
5619 EXPORT_SYMBOL_HDA(snd_hda_suspend);
5622 * snd_hda_resume - resume the codecs
5625 * Returns 0 if successful.
5627 int snd_hda_resume(struct hda_bus *bus)
5629 struct hda_codec *codec;
5631 list_for_each_entry(codec, &bus->codec_list, list) {
5632 hda_call_codec_resume(codec);
5636 EXPORT_SYMBOL_HDA(snd_hda_resume);
5637 #endif /* CONFIG_PM */
5644 * snd_array_new - get a new element from the given array
5645 * @array: the array object
5647 * Get a new element from the given array. If it exceeds the
5648 * pre-allocated array size, re-allocate the array.
5650 * Returns NULL if allocation failed.
5652 void *snd_array_new(struct snd_array *array)
5654 if (snd_BUG_ON(!array->elem_size))
5656 if (array->used >= array->alloced) {
5657 int num = array->alloced + array->alloc_align;
5658 int size = (num + 1) * array->elem_size;
5660 if (snd_BUG_ON(num >= 4096))
5662 nlist = krealloc(array->list, size, GFP_KERNEL | __GFP_ZERO);
5665 array->list = nlist;
5666 array->alloced = num;
5668 return snd_array_elem(array, array->used++);
5670 EXPORT_SYMBOL_HDA(snd_array_new);
5673 * snd_array_free - free the given array elements
5674 * @array: the array object
5676 void snd_array_free(struct snd_array *array)
5683 EXPORT_SYMBOL_HDA(snd_array_free);
5686 * snd_print_pcm_bits - Print the supported PCM fmt bits to the string buffer
5687 * @pcm: PCM caps bits
5688 * @buf: the string buffer to write
5689 * @buflen: the max buffer length
5691 * used by hda_proc.c and hda_eld.c
5693 void snd_print_pcm_bits(int pcm, char *buf, int buflen)
5695 static unsigned int bits[] = { 8, 16, 20, 24, 32 };
5698 for (i = 0, j = 0; i < ARRAY_SIZE(bits); i++)
5699 if (pcm & (AC_SUPPCM_BITS_8 << i))
5700 j += snprintf(buf + j, buflen - j, " %d", bits[i]);
5702 buf[j] = '\0'; /* necessary when j == 0 */
5704 EXPORT_SYMBOL_HDA(snd_print_pcm_bits);
5706 MODULE_DESCRIPTION("HDA codec core");
5707 MODULE_LICENSE("GPL");