1 // SPDX-License-Identifier: GPL-2.0-only
3  * HD-audio codec core device
27  * snd_hdac_device_init - initialize the HD-audio codec base device
47 	dev = &codec->dev;  in snd_hdac_device_init()
49 	dev->parent = bus->dev;  in snd_hdac_device_init()
50 	dev->bus = &snd_hda_bus_type;  in snd_hdac_device_init()
51 	dev->release = default_release;  in snd_hdac_device_init()
52 	dev->groups = hdac_dev_attr_groups;  in snd_hdac_device_init()
56 	codec->bus = bus;  in snd_hdac_device_init()
57 	codec->addr = addr;  in snd_hdac_device_init()
58 	codec->type = HDA_DEV_CORE;  in snd_hdac_device_init()
59 	mutex_init(&codec->widget_lock);  in snd_hdac_device_init()
60 	mutex_init(&codec->regmap_lock);  in snd_hdac_device_init()
61 	pm_runtime_set_active(&codec->dev);  in snd_hdac_device_init()
62 	pm_runtime_get_noresume(&codec->dev);  in snd_hdac_device_init()
63 	atomic_set(&codec->in_pm, 0);  in snd_hdac_device_init()
70 	codec->vendor_id = snd_hdac_read_parm(codec, AC_NODE_ROOT,  in snd_hdac_device_init()
72 	if (codec->vendor_id == -1) {  in snd_hdac_device_init()
76 		codec->vendor_id = snd_hdac_read_parm(codec, AC_NODE_ROOT,  in snd_hdac_device_init()
80 	codec->subsystem_id = snd_hdac_read_parm(codec, AC_NODE_ROOT,  in snd_hdac_device_init()
82 	codec->revision_id = snd_hdac_read_parm(codec, AC_NODE_ROOT,  in snd_hdac_device_init()
86 	if (!codec->afg && !codec->mfg) {  in snd_hdac_device_init()
88 		err = -ENODEV;  in snd_hdac_device_init()
92 	fg = codec->afg ? codec->afg : codec->mfg;  in snd_hdac_device_init()
98 	codec->power_caps = snd_hdac_read_parm(codec, fg, AC_PAR_POWER_STATE);  in snd_hdac_device_init()
100 	if (codec->subsystem_id == -1 || codec->subsystem_id == 0)  in snd_hdac_device_init()
102 			      &codec->subsystem_id);  in snd_hdac_device_init()
108 	codec->chip_name = kasprintf(GFP_KERNEL, "ID %x",  in snd_hdac_device_init()
109 				     codec->vendor_id & 0xffff);  in snd_hdac_device_init()
110 	if (!codec->chip_name) {  in snd_hdac_device_init()
111 		err = -ENOMEM;  in snd_hdac_device_init()
118 	put_device(&codec->dev);  in snd_hdac_device_init()
124  * snd_hdac_device_exit - clean up the HD-audio codec base device
129 	pm_runtime_put_noidle(&codec->dev);  in snd_hdac_device_exit()
131 	pm_runtime_set_suspended(&codec->dev);  in snd_hdac_device_exit()
132 	snd_hdac_bus_remove_device(codec->bus, codec);  in snd_hdac_device_exit()
133 	kfree(codec->vendor_name);  in snd_hdac_device_exit()
134 	kfree(codec->chip_name);  in snd_hdac_device_exit()
139  * snd_hdac_device_register - register the hd-audio codec base device
146 	err = device_add(&codec->dev);  in snd_hdac_device_register()
149 	mutex_lock(&codec->widget_lock);  in snd_hdac_device_register()
151 	mutex_unlock(&codec->widget_lock);  in snd_hdac_device_register()
153 		device_del(&codec->dev);  in snd_hdac_device_register()
162  * snd_hdac_device_unregister - unregister the hd-audio codec base device
167 	if (device_is_registered(&codec->dev)) {  in snd_hdac_device_unregister()
168 		mutex_lock(&codec->widget_lock);  in snd_hdac_device_unregister()
170 		mutex_unlock(&codec->widget_lock);  in snd_hdac_device_unregister()
171 		device_del(&codec->dev);  in snd_hdac_device_unregister()
172 		snd_hdac_bus_remove_device(codec->bus, codec);  in snd_hdac_device_unregister()
178  * snd_hdac_device_set_chip_name - set/update the codec name
192 		return -ENOMEM;  in snd_hdac_device_set_chip_name()
193 	kfree(codec->chip_name);  in snd_hdac_device_set_chip_name()
194 	codec->chip_name = newname;  in snd_hdac_device_set_chip_name()
200  * snd_hdac_codec_modalias - give the module alias name
210 			codec->vendor_id, codec->revision_id, codec->type);  in snd_hdac_codec_modalias()
215  * snd_hdac_make_cmd - compose a 32bit command word to be sent to the
216  *	HD-audio controller
222  * Return an encoded command verb or -1 for error.
229 	addr = codec->addr;  in snd_hdac_make_cmd()
232 		dev_err(&codec->dev, "out of range cmd %x:%x:%x:%x\n",  in snd_hdac_make_cmd()
234 		return -1;  in snd_hdac_make_cmd()
245  * snd_hdac_exec_verb - execute an encoded verb
259 	if (codec->exec_verb)  in snd_hdac_exec_verb()
260 		return codec->exec_verb(codec, cmd, flags, res);  in snd_hdac_exec_verb()
261 	return snd_hdac_bus_exec_verb(codec->bus, codec->addr, cmd, res);  in snd_hdac_exec_verb()
266  * snd_hdac_read - execute a verb
285  * _snd_hdac_read_parm - read a parmeter
304  * snd_hdac_read_parm_uncached - read a codec parameter without caching
309  * Returns -1 for error.  If you need to distinguish the error more
319 		return -1;  in snd_hdac_read_parm_uncached()
325  * snd_hdac_override_parm - override read-only parameters
337 	if (!codec->regmap)  in snd_hdac_override_parm()
338 		return -EINVAL;  in snd_hdac_override_parm()
340 	codec->caps_overwriting = true;  in snd_hdac_override_parm()
342 	codec->caps_overwriting = false;  in snd_hdac_override_parm()
348  * snd_hdac_get_sub_nodes - get start NID and number of subtree nodes
362 	if (parm == -1) {  in snd_hdac_get_sub_nodes()
385 			codec->afg = nid;  in setup_fg_nodes()
386 			codec->afg_function_id = function_id & 0xff;  in setup_fg_nodes()
387 			codec->afg_unsol = (function_id >> 8) & 1;  in setup_fg_nodes()
390 			codec->mfg = nid;  in setup_fg_nodes()
391 			codec->mfg_function_id = function_id & 0xff;  in setup_fg_nodes()
392 			codec->mfg_unsol = (function_id >> 8) & 1;  in setup_fg_nodes()
401  * snd_hdac_refresh_widgets - Reset the widget start/end nodes
413 	mutex_lock(&codec->widget_lock);  in snd_hdac_refresh_widgets()
414 	nums = snd_hdac_get_sub_nodes(codec, codec->afg, &start_nid);  in snd_hdac_refresh_widgets()
416 		dev_err(&codec->dev, "cannot read sub nodes for FG 0x%02x\n",  in snd_hdac_refresh_widgets()
417 			codec->afg);  in snd_hdac_refresh_widgets()
418 		err = -EINVAL;  in snd_hdac_refresh_widgets()
426 	codec->num_nodes = nums;  in snd_hdac_refresh_widgets()
427 	codec->start_nid = start_nid;  in snd_hdac_refresh_widgets()
428 	codec->end_nid = start_nid + nums;  in snd_hdac_refresh_widgets()
430 	mutex_unlock(&codec->widget_lock);  in snd_hdac_refresh_widgets()
446 	if (parm == -1)  in get_num_conns()
452  * snd_hdac_get_connections - get a widget connection list
460  * given array size, it returns -ENOSPC.
487 	mask = (1 << (shift-1)) - 1;  in snd_hdac_get_connections()
515 				return -EIO;  in snd_hdac_get_connections()
517 		range_val = !!(parm & (1 << (shift-1))); /* ranges */  in snd_hdac_get_connections()
520 			dev_dbg(&codec->dev,  in snd_hdac_get_connections()
529 				dev_warn(&codec->dev,  in snd_hdac_get_connections()
537 						return -ENOSPC;  in snd_hdac_get_connections()
545 					return -ENOSPC;  in snd_hdac_get_connections()
558  * snd_hdac_power_up - power up the codec
569 	return pm_runtime_get_sync(&codec->dev);  in snd_hdac_power_up()
574  * snd_hdac_power_down - power down the codec
581 	struct device *dev = &codec->dev;  in snd_hdac_power_down()
589  * snd_hdac_power_up_pm - power up the codec
593  * which may be called by PM suspend/resume again.  OTOH, if a power-up
601 	if (!atomic_inc_not_zero(&codec->in_pm))  in snd_hdac_power_up_pm()
608  * already powered up.  Returns -1 if not powered up, 1 if incremented
613 	if (!atomic_inc_not_zero(&codec->in_pm)) {  in snd_hdac_keep_power_up()
614 		int ret = pm_runtime_get_if_in_use(&codec->dev);  in snd_hdac_keep_power_up()
616 			return -1;  in snd_hdac_keep_power_up()
624  * snd_hdac_power_down_pm - power down the codec
634 	if (atomic_dec_if_positive(&codec->in_pm) < 0)  in snd_hdac_power_down_pm()
648 	{ 0x1002, "ATI" },
659 	{ 0x13f6, "C-Media" },
665 	{ 0x434d, "C-Media" },
675 	u16 vendor_id = codec->vendor_id >> 16;  in get_codec_vendor_name()
677 	for (c = hda_vendor_ids; c->id; c++) {  in get_codec_vendor_name()
678 		if (c->id == vendor_id) {  in get_codec_vendor_name()
679 			codec->vendor_name = kstrdup(c->name, GFP_KERNEL);  in get_codec_vendor_name()
680 			return codec->vendor_name ? 0 : -ENOMEM;  in get_codec_vendor_name()
684 	codec->vendor_name = kasprintf(GFP_KERNEL, "Generic %04x", vendor_id);  in get_codec_vendor_name()
685 	return codec->vendor_name ? 0 : -ENOMEM;  in get_codec_vendor_name()
699 	(AC_FMT_BASE_##base##K | (((mult) - 1) << AC_FMT_MULT_SHIFT) | \
700 	 (((div) - 1) << AC_FMT_DIV_SHIFT))
727  * snd_hdac_calc_stream_format - calculate the format bitset
732  * @spdif_ctls: HD-audio SPDIF status bits (0 if irrelevant)
757 	val |= channels - 1;  in snd_hdac_calc_stream_format()
791 	if (nid != codec->afg &&  in query_pcm_param()
794 	if (!val || val == -1)  in query_pcm_param()
795 		val = snd_hdac_read_parm(codec, codec->afg, AC_PAR_PCM);  in query_pcm_param()
796 	if (!val || val == -1)  in query_pcm_param()
805 	if (!streams || streams == -1)  in query_stream_param()
806 		streams = snd_hdac_read_parm(codec, codec->afg, AC_PAR_STREAM);  in query_stream_param()
807 	if (!streams || streams == -1)  in query_stream_param()
813  * snd_hdac_query_supported_pcm - query the supported PCM rates and formats
840 			dev_err(&codec->dev,  in snd_hdac_query_supported_pcm()
844 			return -EIO;  in snd_hdac_query_supported_pcm()
855 			return -EIO;  in snd_hdac_query_supported_pcm()
903 			dev_err(&codec->dev,  in snd_hdac_query_supported_pcm()
908 			return -EIO;  in snd_hdac_query_supported_pcm()
921  * snd_hdac_is_supported_format - Check the validity of the format
924  * @format: the HD-audio format value to check
994 		return -1;  in codec_read()
1008  * snd_hdac_codec_read - send a command and get the response
1017  * Returns the obtained response value, or -1 for an error.
1027  * snd_hdac_codec_write - send a single command without waiting for response
1046  * snd_hdac_check_power_state - check whether the actual power state matches
1047  * with the target state
1051  * @target_state: target state to check for
1068  * snd_hdac_sync_power_state - wait until actual power state matches
1069  * with the target state
1073  * @power_state: target power state to wait for
1095 		/* wait until the codec reachs to the target state */  in snd_hdac_sync_power_state()