sound/hda/ext/hdac_ext_bus.c

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  *  hdac-ext-bus.c - HD-audio extended core bus 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/module.h>
  13 #include <linux/slab.h>
  14 #include <linux/io.h>
  15 #include <sound/hdaudio_ext.h>
  16
  17 MODULE_DESCRIPTION("HDA extended core");
  18 MODULE_LICENSE("GPL v2");
  19
  20 /**
  21  * snd_hdac_ext_bus_init - initialize a HD-audio extended bus
  22  * @bus: the pointer to HDAC bus object
  23  * @dev: device pointer
  24  * @ops: bus verb operators
  25  * @ext_ops: operators used for ASoC HDA codec drivers
  26  *
  27  * Returns 0 if successful, or a negative error code.
  28  */
  29 int snd_hdac_ext_bus_init(struct hdac_bus *bus, struct device *dev,
  30                         const struct hdac_bus_ops *ops,
  31                         const struct hdac_ext_bus_ops *ext_ops)
  32 {
  33         int ret;
  34
  35         ret = snd_hdac_bus_init(bus, dev, ops);
  36         if (ret < 0)
  37                 return ret;
  38
  39         bus->ext_ops = ext_ops;
  40         /* FIXME:
  41          * Currently only one bus is supported, if there is device with more
  42          * buses, bus->idx should be greater than 0, but there needs to be a
  43          * reliable way to always assign same number.
  44          */
  45         bus->idx = 0;
  46         bus->cmd_dma_state = true;
  47
  48         return 0;
  49 }
  50 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_init);
  51
  52 /**
  53  * snd_hdac_ext_bus_exit - clean up a HD-audio extended bus
  54  * @bus: the pointer to HDAC bus object
  55  */
  56 void snd_hdac_ext_bus_exit(struct hdac_bus *bus)
  57 {
  58         snd_hdac_bus_exit(bus);
  59         WARN_ON(!list_empty(&bus->hlink_list));
  60 }
  61 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_exit);
  62
  63 /**
  64  * snd_hdac_ext_bus_device_remove - remove HD-audio extended codec base devices
  65  *
  66  * @bus: the pointer to HDAC bus object
  67  */
  68 void snd_hdac_ext_bus_device_remove(struct hdac_bus *bus)
  69 {
  70         struct hdac_device *codec, *__codec;
  71         /*
  72          * we need to remove all the codec devices objects created in the
  73          * snd_hdac_ext_bus_device_init
  74          */
  75         list_for_each_entry_safe(codec, __codec, &bus->codec_list, list) {
  76                 snd_hdac_device_unregister(codec);
  77                 put_device(&codec->dev);
  78         }
  79 }
  80 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_device_remove);
  81 #define dev_to_hdac(dev) (container_of((dev), \
  82                         struct hdac_device, dev))
  83
  84 static inline struct hdac_driver *get_hdrv(struct device *dev)
  85 {
  86         struct hdac_driver *hdrv = drv_to_hdac_driver(dev->driver);
  87         return hdrv;
  88 }
  89
  90 static inline struct hdac_device *get_hdev(struct device *dev)
  91 {
  92         struct hdac_device *hdev = dev_to_hdac_dev(dev);
  93         return hdev;
  94 }
  95
  96 static int hda_ext_drv_probe(struct device *dev)
  97 {
  98         return (get_hdrv(dev))->probe(get_hdev(dev));
  99 }
 100
 101 static int hdac_ext_drv_remove(struct device *dev)
 102 {
 103         return (get_hdrv(dev))->remove(get_hdev(dev));
 104 }
 105
 106 static void hdac_ext_drv_shutdown(struct device *dev)
 107 {
 108         return (get_hdrv(dev))->shutdown(get_hdev(dev));
 109 }
 110
 111 /**
 112  * snd_hda_ext_driver_register - register a driver for ext hda devices
 113  *
 114  * @drv: ext hda driver structure
 115  */
 116 int snd_hda_ext_driver_register(struct hdac_driver *drv)
 117 {
 118         drv->type = HDA_DEV_ASOC;
 119         drv->driver.bus = &snd_hda_bus_type;
 120         /* we use default match */
 121
 122         if (drv->probe)
 123                 drv->driver.probe = hda_ext_drv_probe;
 124         if (drv->remove)
 125                 drv->driver.remove = hdac_ext_drv_remove;
 126         if (drv->shutdown)
 127                 drv->driver.shutdown = hdac_ext_drv_shutdown;
 128
 129         return driver_register(&drv->driver);
 130 }
 131 EXPORT_SYMBOL_GPL(snd_hda_ext_driver_register);
 132
 133 /**
 134  * snd_hda_ext_driver_unregister - unregister a driver for ext hda devices
 135  *
 136  * @drv: ext hda driver structure
 137  */
 138 void snd_hda_ext_driver_unregister(struct hdac_driver *drv)
 139 {
 140         driver_unregister(&drv->driver);
 141 }
 142 EXPORT_SYMBOL_GPL(snd_hda_ext_driver_unregister);