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