root/sound/hda/ext/hdac_ext_controller.c

DEFINITIONS

1. snd_hdac_ext_bus_ppcap_enable
2. snd_hdac_ext_bus_ppcap_int_enable
3. snd_hdac_ext_bus_get_ml_capabilities
4. snd_hdac_link_free_all
5. snd_hdac_ext_bus_get_link
6. check_hdac_link_power_active
7. snd_hdac_ext_bus_link_power_up
8. snd_hdac_ext_bus_link_power_down
9. snd_hdac_ext_bus_link_power_up_all
10. snd_hdac_ext_bus_link_power_down_all
11. snd_hdac_ext_bus_link_get
12. snd_hdac_ext_bus_link_put

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  *  hdac-ext-controller.c - HD-audio extended controller functions.
   4  *
   5  *  Copyright (C) 2014-2015 Intel Corp
   6  *  Author: Jeeja KP <jeeja.kp@intel.com>
   7  *  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   8  *
   9  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10  */
  11 
  12 #include <linux/delay.h>
  13 #include <linux/slab.h>
  14 #include <sound/hda_register.h>
  15 #include <sound/hdaudio_ext.h>
  16 
  17 /*
  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
  21  */
  22 #define HDAC_MAX_CAPS 10
  23 
  24 /*
  25  * processing pipe helpers - these helpers are useful for dealing with HDA
  26  * new capability of processing pipelines
  27  */
  28 
  29 /**
  30  * snd_hdac_ext_bus_ppcap_enable - enable/disable processing pipe capability
  31  * @ebus: HD-audio extended core bus
  32  * @enable: flag to turn on/off the capability
  33  */
  34 void snd_hdac_ext_bus_ppcap_enable(struct hdac_bus *bus, bool enable)
  35 {
  36 
  37         if (!bus->ppcap) {
  38                 dev_err(bus->dev, "Address of PP capability is NULL");
  39                 return;
  40         }
  41 
  42         if (enable)
  43                 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
  44                                  AZX_PPCTL_GPROCEN, AZX_PPCTL_GPROCEN);
  45         else
  46                 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
  47                                  AZX_PPCTL_GPROCEN, 0);
  48 }
  49 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_ppcap_enable);
  50 
  51 /**
  52  * snd_hdac_ext_bus_ppcap_int_enable - ppcap interrupt enable/disable
  53  * @ebus: HD-audio extended core bus
  54  * @enable: flag to enable/disable interrupt
  55  */
  56 void snd_hdac_ext_bus_ppcap_int_enable(struct hdac_bus *bus, bool enable)
  57 {
  58 
  59         if (!bus->ppcap) {
  60                 dev_err(bus->dev, "Address of PP capability is NULL\n");
  61                 return;
  62         }
  63 
  64         if (enable)
  65                 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
  66                                  AZX_PPCTL_PIE, AZX_PPCTL_PIE);
  67         else
  68                 snd_hdac_updatel(bus->ppcap, AZX_REG_PP_PPCTL,
  69                                  AZX_PPCTL_PIE, 0);
  70 }
  71 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_ppcap_int_enable);
  72 
  73 /*
  74  * Multilink helpers - these helpers are useful for dealing with HDA
  75  * new multilink capability
  76  */
  77 
  78 /**
  79  * snd_hdac_ext_bus_get_ml_capabilities - get multilink capability
  80  * @ebus: HD-audio extended core bus
  81  *
  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
  85  */
  86 int snd_hdac_ext_bus_get_ml_capabilities(struct hdac_bus *bus)
  87 {
  88         int idx;
  89         u32 link_count;
  90         struct hdac_ext_link *hlink;
  91 
  92         link_count = readl(bus->mlcap + AZX_REG_ML_MLCD) + 1;
  93 
  94         dev_dbg(bus->dev, "In %s Link count: %d\n", __func__, link_count);
  95 
  96         for (idx = 0; idx < link_count; idx++) {
  97                 hlink  = kzalloc(sizeof(*hlink), GFP_KERNEL);
  98                 if (!hlink)
  99                         return -ENOMEM;
 100                 hlink->index = idx;
 101                 hlink->bus = bus;
 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);
 106 
 107                 /* since link in On, update the ref */
 108                 hlink->ref_count = 1;
 109 
 110                 list_add_tail(&hlink->list, &bus->hlink_list);
 111         }
 112 
 113         return 0;
 114 }
 115 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_get_ml_capabilities);
 116 
 117 /**
 118  * snd_hdac_link_free_all- free hdac extended link objects
 119  *
 120  * @ebus: HD-audio ext core bus
 121  */
 122 
 123 void snd_hdac_link_free_all(struct hdac_bus *bus)
 124 {
 125         struct hdac_ext_link *l;
 126 
 127         while (!list_empty(&bus->hlink_list)) {
 128                 l = list_first_entry(&bus->hlink_list, struct hdac_ext_link, list);
 129                 list_del(&l->list);
 130                 kfree(l);
 131         }
 132 }
 133 EXPORT_SYMBOL_GPL(snd_hdac_link_free_all);
 134 
 135 /**
 136  * snd_hdac_ext_bus_get_link_index - get link based on codec name
 137  * @ebus: HD-audio extended core bus
 138  * @codec_name: codec name
 139  */
 140 struct hdac_ext_link *snd_hdac_ext_bus_get_link(struct hdac_bus *bus,
 141                                                  const char *codec_name)
 142 {
 143         int i;
 144         struct hdac_ext_link *hlink = NULL;
 145         int bus_idx, addr;
 146 
 147         if (sscanf(codec_name, "ehdaudio%dD%d", &bus_idx, &addr) != 2)
 148                 return NULL;
 149         if (bus->idx != bus_idx)
 150                 return NULL;
 151 
 152         list_for_each_entry(hlink, &bus->hlink_list, list) {
 153                 for (i = 0; i < HDA_MAX_CODECS; i++) {
 154                         if (hlink->lsdiid & (0x1 << addr))
 155                                 return hlink;
 156                 }
 157         }
 158 
 159         return NULL;
 160 }
 161 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_get_link);
 162 
 163 static int check_hdac_link_power_active(struct hdac_ext_link *link, bool enable)
 164 {
 165         int timeout;
 166         u32 val;
 167         int mask = (1 << AZX_MLCTL_CPA_SHIFT);
 168 
 169         udelay(3);
 170         timeout = 150;
 171 
 172         do {
 173                 val = readl(link->ml_addr + AZX_REG_ML_LCTL);
 174                 if (enable) {
 175                         if (((val & mask) >> AZX_MLCTL_CPA_SHIFT))
 176                                 return 0;
 177                 } else {
 178                         if (!((val & mask) >> AZX_MLCTL_CPA_SHIFT))
 179                                 return 0;
 180                 }
 181                 udelay(3);
 182         } while (--timeout);
 183 
 184         return -EIO;
 185 }
 186 
 187 /**
 188  * snd_hdac_ext_bus_link_power_up -power up hda link
 189  * @link: HD-audio extended link
 190  */
 191 int snd_hdac_ext_bus_link_power_up(struct hdac_ext_link *link)
 192 {
 193         snd_hdac_updatel(link->ml_addr, AZX_REG_ML_LCTL,
 194                          AZX_MLCTL_SPA, AZX_MLCTL_SPA);
 195 
 196         return check_hdac_link_power_active(link, true);
 197 }
 198 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_up);
 199 
 200 /**
 201  * snd_hdac_ext_bus_link_power_down -power down hda link
 202  * @link: HD-audio extended link
 203  */
 204 int snd_hdac_ext_bus_link_power_down(struct hdac_ext_link *link)
 205 {
 206         snd_hdac_updatel(link->ml_addr, AZX_REG_ML_LCTL, AZX_MLCTL_SPA, 0);
 207 
 208         return check_hdac_link_power_active(link, false);
 209 }
 210 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_down);
 211 
 212 /**
 213  * snd_hdac_ext_bus_link_power_up_all -power up all hda link
 214  * @ebus: HD-audio extended bus
 215  */
 216 int snd_hdac_ext_bus_link_power_up_all(struct hdac_bus *bus)
 217 {
 218         struct hdac_ext_link *hlink = NULL;
 219         int ret;
 220 
 221         list_for_each_entry(hlink, &bus->hlink_list, list) {
 222                 snd_hdac_updatel(hlink->ml_addr, AZX_REG_ML_LCTL,
 223                                  AZX_MLCTL_SPA, AZX_MLCTL_SPA);
 224                 ret = check_hdac_link_power_active(hlink, true);
 225                 if (ret < 0)
 226                         return ret;
 227         }
 228 
 229         return 0;
 230 }
 231 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_up_all);
 232 
 233 /**
 234  * snd_hdac_ext_bus_link_power_down_all -power down all hda link
 235  * @ebus: HD-audio extended bus
 236  */
 237 int snd_hdac_ext_bus_link_power_down_all(struct hdac_bus *bus)
 238 {
 239         struct hdac_ext_link *hlink = NULL;
 240         int ret;
 241 
 242         list_for_each_entry(hlink, &bus->hlink_list, list) {
 243                 snd_hdac_updatel(hlink->ml_addr, AZX_REG_ML_LCTL,
 244                                  AZX_MLCTL_SPA, 0);
 245                 ret = check_hdac_link_power_active(hlink, false);
 246                 if (ret < 0)
 247                         return ret;
 248         }
 249 
 250         return 0;
 251 }
 252 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_power_down_all);
 253 
 254 int snd_hdac_ext_bus_link_get(struct hdac_bus *bus,
 255                                 struct hdac_ext_link *link)
 256 {
 257         unsigned long codec_mask;
 258         int ret = 0;
 259 
 260         mutex_lock(&bus->lock);
 261 
 262         /*
 263          * if we move from 0 to 1, count will be 1 so power up this link
 264          * as well, also check the dma status and trigger that
 265          */
 266         if (++link->ref_count == 1) {
 267                 if (!bus->cmd_dma_state) {
 268                         snd_hdac_bus_init_cmd_io(bus);
 269                         bus->cmd_dma_state = true;
 270                 }
 271 
 272                 ret = snd_hdac_ext_bus_link_power_up(link);
 273 
 274                 /*
 275                  * clear the register to invalidate all the output streams
 276                  */
 277                 snd_hdac_updatew(link->ml_addr, AZX_REG_ML_LOSIDV,
 278                                  ML_LOSIDV_STREAM_MASK, 0);
 279                 /*
 280                  *  wait for 521usec for codec to report status
 281                  *  HDA spec section 4.3 - Codec Discovery
 282                  */
 283                 udelay(521);
 284                 codec_mask = snd_hdac_chip_readw(bus, STATESTS);
 285                 dev_dbg(bus->dev, "codec_mask = 0x%lx\n", codec_mask);
 286                 snd_hdac_chip_writew(bus, STATESTS, codec_mask);
 287                 if (!bus->codec_mask)
 288                         bus->codec_mask = codec_mask;
 289         }
 290 
 291         mutex_unlock(&bus->lock);
 292         return ret;
 293 }
 294 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_get);
 295 
 296 int snd_hdac_ext_bus_link_put(struct hdac_bus *bus,
 297                                 struct hdac_ext_link *link)
 298 {
 299         int ret = 0;
 300         struct hdac_ext_link *hlink;
 301         bool link_up = false;
 302 
 303         mutex_lock(&bus->lock);
 304 
 305         /*
 306          * if we move from 1 to 0, count will be 0
 307          * so power down this link as well
 308          */
 309         if (--link->ref_count == 0) {
 310                 ret = snd_hdac_ext_bus_link_power_down(link);
 311 
 312                 /*
 313                  * now check if all links are off, if so turn off
 314                  * cmd dma as well
 315                  */
 316                 list_for_each_entry(hlink, &bus->hlink_list, list) {
 317                         if (hlink->ref_count) {
 318                                 link_up = true;
 319                                 break;
 320                         }
 321                 }
 322 
 323                 if (!link_up) {
 324                         snd_hdac_bus_stop_cmd_io(bus);
 325                         bus->cmd_dma_state = false;
 326                 }
 327         }
 328 
 329         mutex_unlock(&bus->lock);
 330         return ret;
 331 }
 332 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_link_put);