1 // SPDX-License-Identifier: GPL-2.0-only
3 * hdac-ext-bus.c - HD-audio extended core bus functions.
5 * Copyright (C) 2014-2015 Intel Corp
6 * Author: Jeeja KP <jeeja.kp@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 #include <linux/module.h>
13 #include <linux/slab.h>
15 #include <sound/hdaudio_ext.h>
17 MODULE_DESCRIPTION("HDA extended core");
18 MODULE_LICENSE("GPL v2");
20 static void hdac_ext_writel(u32 value, u32 __iomem *addr)
25 static u32 hdac_ext_readl(u32 __iomem *addr)
30 static void hdac_ext_writew(u16 value, u16 __iomem *addr)
35 static u16 hdac_ext_readw(u16 __iomem *addr)
40 static void hdac_ext_writeb(u8 value, u8 __iomem *addr)
45 static u8 hdac_ext_readb(u8 __iomem *addr)
50 static int hdac_ext_dma_alloc_pages(struct hdac_bus *bus, int type,
51 size_t size, struct snd_dma_buffer *buf)
53 return snd_dma_alloc_pages(type, bus->dev, size, buf);
56 static void hdac_ext_dma_free_pages(struct hdac_bus *bus, struct snd_dma_buffer *buf)
58 snd_dma_free_pages(buf);
61 static const struct hdac_io_ops hdac_ext_default_io = {
62 .reg_writel = hdac_ext_writel,
63 .reg_readl = hdac_ext_readl,
64 .reg_writew = hdac_ext_writew,
65 .reg_readw = hdac_ext_readw,
66 .reg_writeb = hdac_ext_writeb,
67 .reg_readb = hdac_ext_readb,
68 .dma_alloc_pages = hdac_ext_dma_alloc_pages,
69 .dma_free_pages = hdac_ext_dma_free_pages,
73 * snd_hdac_ext_bus_init - initialize a HD-audio extended bus
74 * @ebus: the pointer to extended bus object
75 * @dev: device pointer
76 * @ops: bus verb operators
77 * @io_ops: lowlevel I/O operators, can be NULL. If NULL core will use
80 * Returns 0 if successful, or a negative error code.
82 int snd_hdac_ext_bus_init(struct hdac_bus *bus, struct device *dev,
83 const struct hdac_bus_ops *ops,
84 const struct hdac_io_ops *io_ops,
85 const struct hdac_ext_bus_ops *ext_ops)
89 /* check if io ops are provided, if not load the defaults */
91 io_ops = &hdac_ext_default_io;
93 ret = snd_hdac_bus_init(bus, dev, ops, io_ops);
97 bus->ext_ops = ext_ops;
99 * Currently only one bus is supported, if there is device with more
100 * buses, bus->idx should be greater than 0, but there needs to be a
101 * reliable way to always assign same number.
104 bus->cmd_dma_state = true;
108 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_init);
111 * snd_hdac_ext_bus_exit - clean up a HD-audio extended bus
112 * @ebus: the pointer to extended bus object
114 void snd_hdac_ext_bus_exit(struct hdac_bus *bus)
116 snd_hdac_bus_exit(bus);
117 WARN_ON(!list_empty(&bus->hlink_list));
119 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_exit);
121 static void default_release(struct device *dev)
123 snd_hdac_ext_bus_device_exit(container_of(dev, struct hdac_device, dev));
127 * snd_hdac_ext_bus_device_init - initialize the HDA extended codec base device
128 * @ebus: hdac extended bus to attach to
129 * @addr: codec address
131 * Returns zero for success or a negative error code.
133 int snd_hdac_ext_bus_device_init(struct hdac_bus *bus, int addr,
134 struct hdac_device *hdev)
141 snprintf(name, sizeof(name), "ehdaudio%dD%d", bus->idx, addr);
143 ret = snd_hdac_device_init(hdev, bus, name, addr);
145 dev_err(bus->dev, "device init failed for hdac device\n");
148 hdev->type = HDA_DEV_ASOC;
149 hdev->dev.release = default_release;
151 ret = snd_hdac_device_register(hdev);
153 dev_err(bus->dev, "failed to register hdac device\n");
154 snd_hdac_ext_bus_device_exit(hdev);
160 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_device_init);
163 * snd_hdac_ext_bus_device_exit - clean up a HD-audio extended codec base device
164 * @hdev: hdac device to clean up
166 void snd_hdac_ext_bus_device_exit(struct hdac_device *hdev)
168 snd_hdac_device_exit(hdev);
170 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_device_exit);
173 * snd_hdac_ext_bus_device_remove - remove HD-audio extended codec base devices
175 * @ebus: HD-audio extended bus
177 void snd_hdac_ext_bus_device_remove(struct hdac_bus *bus)
179 struct hdac_device *codec, *__codec;
181 * we need to remove all the codec devices objects created in the
182 * snd_hdac_ext_bus_device_init
184 list_for_each_entry_safe(codec, __codec, &bus->codec_list, list) {
185 snd_hdac_device_unregister(codec);
186 put_device(&codec->dev);
189 EXPORT_SYMBOL_GPL(snd_hdac_ext_bus_device_remove);
190 #define dev_to_hdac(dev) (container_of((dev), \
191 struct hdac_device, dev))
193 static inline struct hdac_driver *get_hdrv(struct device *dev)
195 struct hdac_driver *hdrv = drv_to_hdac_driver(dev->driver);
199 static inline struct hdac_device *get_hdev(struct device *dev)
201 struct hdac_device *hdev = dev_to_hdac_dev(dev);
205 static int hda_ext_drv_probe(struct device *dev)
207 return (get_hdrv(dev))->probe(get_hdev(dev));
210 static int hdac_ext_drv_remove(struct device *dev)
212 return (get_hdrv(dev))->remove(get_hdev(dev));
215 static void hdac_ext_drv_shutdown(struct device *dev)
217 return (get_hdrv(dev))->shutdown(get_hdev(dev));
221 * snd_hda_ext_driver_register - register a driver for ext hda devices
223 * @drv: ext hda driver structure
225 int snd_hda_ext_driver_register(struct hdac_driver *drv)
227 drv->type = HDA_DEV_ASOC;
228 drv->driver.bus = &snd_hda_bus_type;
229 /* we use default match */
232 drv->driver.probe = hda_ext_drv_probe;
234 drv->driver.remove = hdac_ext_drv_remove;
236 drv->driver.shutdown = hdac_ext_drv_shutdown;
238 return driver_register(&drv->driver);
240 EXPORT_SYMBOL_GPL(snd_hda_ext_driver_register);
243 * snd_hda_ext_driver_unregister - unregister a driver for ext hda devices
245 * @drv: ext hda driver structure
247 void snd_hda_ext_driver_unregister(struct hdac_driver *drv)
249 driver_unregister(&drv->driver);
251 EXPORT_SYMBOL_GPL(snd_hda_ext_driver_unregister);