1 // SPDX-License-Identifier: GPL-2.0-only
3 * hdac-ext-controller.c - HD-audio extended controller functions.
5 * Copyright (C) 2014-2015 Intel Corp
6 * Author: Jeeja KP <jeeja.kp@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 #include <linux/delay.h>
13 #include <linux/slab.h>
14 #include <sound/hda_register.h>
15 #include <sound/hdaudio_ext.h>
18 * maximum HDAC capablities we should parse to avoid endless looping:
19 * currently we have 4 extended caps, so this is future proof for now.
20 * extend when this limit is seen meeting in real HW
22 #define HDAC_MAX_CAPS 10
25 * processing pipe helpers - these helpers are useful for dealing with HDA
26 * new capability of processing pipelines
30 * snd_hdac_ext_bus_ppcap_enable - enable/disable processing pipe capability
31 * @bus: the pointer to HDAC bus object
32 * @enable: flag to turn on/off the capability
34 void snd_hdac_ext_bus_ppcap_enable(struct hdac_bus *bus, bool enable)
38 dev_err(bus->dev, "Address of PP capability is NULL");
43 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
44 AZX_PPCTL_GPROCEN, AZX_PPCTL_GPROCEN);
46 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
47 AZX_PPCTL_GPROCEN, 0);
49 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_ppcap_enable);
52 * snd_hdac_ext_bus_ppcap_int_enable - ppcap interrupt enable/disable
53 * @bus: the pointer to HDAC bus object
54 * @enable: flag to enable/disable interrupt
56 void snd_hdac_ext_bus_ppcap_int_enable(struct hdac_bus *bus, bool enable)
60 dev_err(bus->dev, "Address of PP capability is NULL\n");
65 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
66 AZX_PPCTL_PIE, AZX_PPCTL_PIE);
68 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
71 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_ppcap_int_enable);
74 * Multilink helpers - these helpers are useful for dealing with HDA
75 * new multilink capability
79 * snd_hdac_ext_bus_get_ml_capabilities - get multilink capability
80 * @bus: the pointer to HDAC bus object
82 * This will parse all links and read the mlink capabilities and add them
83 * in hlink_list of extended hdac bus
84 * Note: this will be freed on bus exit by driver
86 int snd_hdac_ext_bus_get_ml_capabilities(struct hdac_bus *bus)
90 struct hdac_ext_link *hlink;
92 link_count = readl(bus->mlcap + AZX_REG_ML_MLCD) + 1;
94 dev_dbg(bus->dev, "In %s Link count: %d\n", __func__, link_count);
96 for (idx = 0; idx < link_count; idx++) {
97 hlink = kzalloc(sizeof(*hlink), GFP_KERNEL);
102 hlink->ml_addr = bus->mlcap + AZX_ML_BASE +
103 (AZX_ML_INTERVAL * idx);
104 hlink->lcaps = readl(hlink->ml_addr + AZX_REG_ML_LCAP);
105 hlink->lsdiid = readw(hlink->ml_addr + AZX_REG_ML_LSDIID);
107 /* since link in On, update the ref */
108 hlink->ref_count = 1;
110 list_add_tail(&hlink->list, &bus->hlink_list);
115 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_get_ml_capabilities);
118 * snd_hdac_link_free_all- free hdac extended link objects
120 * @bus: the pointer to HDAC bus object
123 void snd_hdac_link_free_all(struct hdac_bus *bus)
125 struct hdac_ext_link *l;
127 while (!list_empty(&bus->hlink_list)) {
128 l = list_first_entry(&bus->hlink_list, struct hdac_ext_link, list);
133 EXPORT_SYMBOL_GPL(snd_hdac_link_free_all);
136 * snd_hdac_ext_bus_link_at - get link at specified address
137 * @bus: link's parent bus device
138 * @addr: codec device address
140 * Returns link object or NULL if matching link is not found.
142 struct hdac_ext_link *snd_hdac_ext_bus_link_at(struct hdac_bus *bus, int addr)
144 struct hdac_ext_link *hlink;
147 list_for_each_entry(hlink, &bus->hlink_list, list)
148 for (i = 0; i < HDA_MAX_CODECS; i++)
149 if (hlink->lsdiid & (0x1 << addr))
153 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_at);
156 * snd_hdac_ext_bus_get_link - get link based on codec name
157 * @bus: the pointer to HDAC bus object
158 * @codec_name: codec name
160 struct hdac_ext_link *snd_hdac_ext_bus_get_link(struct hdac_bus *bus,
161 const char *codec_name)
165 if (sscanf(codec_name, "ehdaudio%dD%d", &bus_idx, &addr) != 2)
167 if (bus->idx != bus_idx)
169 if (addr < 0 || addr > 31)
172 return snd_hdac_ext_bus_link_at(bus, addr);
174 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_get_link);
176 static int check_hdac_link_power_active(struct hdac_ext_link *link, bool enable)
180 int mask = (1 << AZX_MLCTL_CPA_SHIFT);
186 val = readl(link->ml_addr + AZX_REG_ML_LCTL);
188 if (((val & mask) >> AZX_MLCTL_CPA_SHIFT))
191 if (!((val & mask) >> AZX_MLCTL_CPA_SHIFT))
201 * snd_hdac_ext_bus_link_power_up -power up hda link
202 * @link: HD-audio extended link
204 int snd_hdac_ext_bus_link_power_up(struct hdac_ext_link *link)
206 snd_hdac_updatel(link->ml_addr, AZX_REG_ML_LCTL,
207 AZX_MLCTL_SPA, AZX_MLCTL_SPA);
209 return check_hdac_link_power_active(link, true);
211 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_up);
214 * snd_hdac_ext_bus_link_power_down -power down hda link
215 * @link: HD-audio extended link
217 int snd_hdac_ext_bus_link_power_down(struct hdac_ext_link *link)
219 snd_hdac_updatel(link->ml_addr, AZX_REG_ML_LCTL, AZX_MLCTL_SPA, 0);
221 return check_hdac_link_power_active(link, false);
223 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_down);
226 * snd_hdac_ext_bus_link_power_up_all -power up all hda link
227 * @bus: the pointer to HDAC bus object
229 int snd_hdac_ext_bus_link_power_up_all(struct hdac_bus *bus)
231 struct hdac_ext_link *hlink = NULL;
234 list_for_each_entry(hlink, &bus->hlink_list, list) {
235 snd_hdac_updatel(hlink->ml_addr, AZX_REG_ML_LCTL,
236 AZX_MLCTL_SPA, AZX_MLCTL_SPA);
237 ret = check_hdac_link_power_active(hlink, true);
244 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_up_all);
247 * snd_hdac_ext_bus_link_power_down_all -power down all hda link
248 * @bus: the pointer to HDAC bus object
250 int snd_hdac_ext_bus_link_power_down_all(struct hdac_bus *bus)
252 struct hdac_ext_link *hlink = NULL;
255 list_for_each_entry(hlink, &bus->hlink_list, list) {
256 snd_hdac_updatel(hlink->ml_addr, AZX_REG_ML_LCTL,
258 ret = check_hdac_link_power_active(hlink, false);
265 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_down_all);
267 int snd_hdac_ext_bus_link_get(struct hdac_bus *bus,
268 struct hdac_ext_link *link)
270 unsigned long codec_mask;
273 mutex_lock(&bus->lock);
276 * if we move from 0 to 1, count will be 1 so power up this link
277 * as well, also check the dma status and trigger that
279 if (++link->ref_count == 1) {
280 if (!bus->cmd_dma_state) {
281 snd_hdac_bus_init_cmd_io(bus);
282 bus->cmd_dma_state = true;
285 ret = snd_hdac_ext_bus_link_power_up(link);
288 * clear the register to invalidate all the output streams
290 snd_hdac_updatew(link->ml_addr, AZX_REG_ML_LOSIDV,
291 ML_LOSIDV_STREAM_MASK, 0);
293 * wait for 521usec for codec to report status
294 * HDA spec section 4.3 - Codec Discovery
297 codec_mask = snd_hdac_chip_readw(bus, STATESTS);
298 dev_dbg(bus->dev, "codec_mask = 0x%lx\n", codec_mask);
299 snd_hdac_chip_writew(bus, STATESTS, codec_mask);
300 if (!bus->codec_mask)
301 bus->codec_mask = codec_mask;
304 mutex_unlock(&bus->lock);
307 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_get);
309 int snd_hdac_ext_bus_link_put(struct hdac_bus *bus,
310 struct hdac_ext_link *link)
313 struct hdac_ext_link *hlink;
314 bool link_up = false;
316 mutex_lock(&bus->lock);
319 * if we move from 1 to 0, count will be 0
320 * so power down this link as well
322 if (--link->ref_count == 0) {
323 ret = snd_hdac_ext_bus_link_power_down(link);
326 * now check if all links are off, if so turn off
329 list_for_each_entry(hlink, &bus->hlink_list, list) {
330 if (hlink->ref_count) {
337 snd_hdac_bus_stop_cmd_io(bus);
338 bus->cmd_dma_state = false;
342 mutex_unlock(&bus->lock);
345 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_put);
347 static void hdac_ext_codec_link_up(struct hdac_device *codec)
349 const char *devname = dev_name(&codec->dev);
350 struct hdac_ext_link *hlink =
351 snd_hdac_ext_bus_get_link(codec->bus, devname);
354 snd_hdac_ext_bus_link_get(codec->bus, hlink);
357 static void hdac_ext_codec_link_down(struct hdac_device *codec)
359 const char *devname = dev_name(&codec->dev);
360 struct hdac_ext_link *hlink =
361 snd_hdac_ext_bus_get_link(codec->bus, devname);
364 snd_hdac_ext_bus_link_put(codec->bus, hlink);
367 void snd_hdac_ext_bus_link_power(struct hdac_device *codec, bool enable)
369 struct hdac_bus *bus = codec->bus;
370 bool oldstate = test_bit(codec->addr, &bus->codec_powered);
372 if (enable == oldstate)
375 snd_hdac_bus_link_power(codec, enable);
378 hdac_ext_codec_link_up(codec);
380 hdac_ext_codec_link_down(codec);
382 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power);