xref: /OK3568_Linux_fs/kernel/drivers/firmware/arm_scmi/bus.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * System Control and Management Interface (SCMI) Message Protocol bus layer
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (C) 2018 ARM Ltd.
6*4882a593Smuzhiyun  */
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun #include <linux/types.h>
11*4882a593Smuzhiyun #include <linux/module.h>
12*4882a593Smuzhiyun #include <linux/kernel.h>
13*4882a593Smuzhiyun #include <linux/slab.h>
14*4882a593Smuzhiyun #include <linux/device.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #include "common.h"
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun static DEFINE_IDA(scmi_bus_id);
19*4882a593Smuzhiyun static DEFINE_IDR(scmi_available_protocols);
20*4882a593Smuzhiyun static DEFINE_SPINLOCK(protocol_lock);
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun static const struct scmi_device_id *
scmi_dev_match_id(struct scmi_device * scmi_dev,struct scmi_driver * scmi_drv)23*4882a593Smuzhiyun scmi_dev_match_id(struct scmi_device *scmi_dev, struct scmi_driver *scmi_drv)
24*4882a593Smuzhiyun {
25*4882a593Smuzhiyun 	const struct scmi_device_id *id = scmi_drv->id_table;
26*4882a593Smuzhiyun 
27*4882a593Smuzhiyun 	if (!id)
28*4882a593Smuzhiyun 		return NULL;
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun 	for (; id->protocol_id; id++)
31*4882a593Smuzhiyun 		if (id->protocol_id == scmi_dev->protocol_id) {
32*4882a593Smuzhiyun 			if (!id->name)
33*4882a593Smuzhiyun 				return id;
34*4882a593Smuzhiyun 			else if (!strcmp(id->name, scmi_dev->name))
35*4882a593Smuzhiyun 				return id;
36*4882a593Smuzhiyun 		}
37*4882a593Smuzhiyun 
38*4882a593Smuzhiyun 	return NULL;
39*4882a593Smuzhiyun }
40*4882a593Smuzhiyun 
scmi_dev_match(struct device * dev,struct device_driver * drv)41*4882a593Smuzhiyun static int scmi_dev_match(struct device *dev, struct device_driver *drv)
42*4882a593Smuzhiyun {
43*4882a593Smuzhiyun 	struct scmi_driver *scmi_drv = to_scmi_driver(drv);
44*4882a593Smuzhiyun 	struct scmi_device *scmi_dev = to_scmi_dev(dev);
45*4882a593Smuzhiyun 	const struct scmi_device_id *id;
46*4882a593Smuzhiyun 
47*4882a593Smuzhiyun 	id = scmi_dev_match_id(scmi_dev, scmi_drv);
48*4882a593Smuzhiyun 	if (id)
49*4882a593Smuzhiyun 		return 1;
50*4882a593Smuzhiyun 
51*4882a593Smuzhiyun 	return 0;
52*4882a593Smuzhiyun }
53*4882a593Smuzhiyun 
scmi_match_by_id_table(struct device * dev,void * data)54*4882a593Smuzhiyun static int scmi_match_by_id_table(struct device *dev, void *data)
55*4882a593Smuzhiyun {
56*4882a593Smuzhiyun 	struct scmi_device *sdev = to_scmi_dev(dev);
57*4882a593Smuzhiyun 	struct scmi_device_id *id_table = data;
58*4882a593Smuzhiyun 
59*4882a593Smuzhiyun 	return sdev->protocol_id == id_table->protocol_id &&
60*4882a593Smuzhiyun 		!strcmp(sdev->name, id_table->name);
61*4882a593Smuzhiyun }
62*4882a593Smuzhiyun 
scmi_find_child_dev(struct device * parent,int prot_id,const char * name)63*4882a593Smuzhiyun struct scmi_device *scmi_find_child_dev(struct device *parent,
64*4882a593Smuzhiyun 					int prot_id, const char *name)
65*4882a593Smuzhiyun {
66*4882a593Smuzhiyun 	struct scmi_device_id id_table;
67*4882a593Smuzhiyun 	struct device *dev;
68*4882a593Smuzhiyun 
69*4882a593Smuzhiyun 	id_table.protocol_id = prot_id;
70*4882a593Smuzhiyun 	id_table.name = name;
71*4882a593Smuzhiyun 
72*4882a593Smuzhiyun 	dev = device_find_child(parent, &id_table, scmi_match_by_id_table);
73*4882a593Smuzhiyun 	if (!dev)
74*4882a593Smuzhiyun 		return NULL;
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun 	return to_scmi_dev(dev);
77*4882a593Smuzhiyun }
78*4882a593Smuzhiyun 
scmi_get_protocol(int protocol_id)79*4882a593Smuzhiyun const struct scmi_protocol *scmi_get_protocol(int protocol_id)
80*4882a593Smuzhiyun {
81*4882a593Smuzhiyun 	const struct scmi_protocol *proto;
82*4882a593Smuzhiyun 
83*4882a593Smuzhiyun 	proto = idr_find(&scmi_available_protocols, protocol_id);
84*4882a593Smuzhiyun 	if (!proto || !try_module_get(proto->owner)) {
85*4882a593Smuzhiyun 		pr_warn("SCMI Protocol 0x%x not found!\n", protocol_id);
86*4882a593Smuzhiyun 		return NULL;
87*4882a593Smuzhiyun 	}
88*4882a593Smuzhiyun 
89*4882a593Smuzhiyun 	pr_debug("GOT SCMI Protocol 0x%x\n", protocol_id);
90*4882a593Smuzhiyun 
91*4882a593Smuzhiyun 	return proto;
92*4882a593Smuzhiyun }
93*4882a593Smuzhiyun 
scmi_put_protocol(int protocol_id)94*4882a593Smuzhiyun void scmi_put_protocol(int protocol_id)
95*4882a593Smuzhiyun {
96*4882a593Smuzhiyun 	const struct scmi_protocol *proto;
97*4882a593Smuzhiyun 
98*4882a593Smuzhiyun 	proto = idr_find(&scmi_available_protocols, protocol_id);
99*4882a593Smuzhiyun 	if (proto)
100*4882a593Smuzhiyun 		module_put(proto->owner);
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun 
scmi_dev_probe(struct device * dev)103*4882a593Smuzhiyun static int scmi_dev_probe(struct device *dev)
104*4882a593Smuzhiyun {
105*4882a593Smuzhiyun 	struct scmi_driver *scmi_drv = to_scmi_driver(dev->driver);
106*4882a593Smuzhiyun 	struct scmi_device *scmi_dev = to_scmi_dev(dev);
107*4882a593Smuzhiyun 	const struct scmi_device_id *id;
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun 	id = scmi_dev_match_id(scmi_dev, scmi_drv);
110*4882a593Smuzhiyun 	if (!id)
111*4882a593Smuzhiyun 		return -ENODEV;
112*4882a593Smuzhiyun 
113*4882a593Smuzhiyun 	if (!scmi_dev->handle)
114*4882a593Smuzhiyun 		return -EPROBE_DEFER;
115*4882a593Smuzhiyun 
116*4882a593Smuzhiyun 	return scmi_drv->probe(scmi_dev);
117*4882a593Smuzhiyun }
118*4882a593Smuzhiyun 
scmi_dev_remove(struct device * dev)119*4882a593Smuzhiyun static int scmi_dev_remove(struct device *dev)
120*4882a593Smuzhiyun {
121*4882a593Smuzhiyun 	struct scmi_driver *scmi_drv = to_scmi_driver(dev->driver);
122*4882a593Smuzhiyun 	struct scmi_device *scmi_dev = to_scmi_dev(dev);
123*4882a593Smuzhiyun 
124*4882a593Smuzhiyun 	if (scmi_drv->remove)
125*4882a593Smuzhiyun 		scmi_drv->remove(scmi_dev);
126*4882a593Smuzhiyun 
127*4882a593Smuzhiyun 	return 0;
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun static struct bus_type scmi_bus_type = {
131*4882a593Smuzhiyun 	.name =	"scmi_protocol",
132*4882a593Smuzhiyun 	.match = scmi_dev_match,
133*4882a593Smuzhiyun 	.probe = scmi_dev_probe,
134*4882a593Smuzhiyun 	.remove = scmi_dev_remove,
135*4882a593Smuzhiyun };
136*4882a593Smuzhiyun 
scmi_driver_register(struct scmi_driver * driver,struct module * owner,const char * mod_name)137*4882a593Smuzhiyun int scmi_driver_register(struct scmi_driver *driver, struct module *owner,
138*4882a593Smuzhiyun 			 const char *mod_name)
139*4882a593Smuzhiyun {
140*4882a593Smuzhiyun 	int retval;
141*4882a593Smuzhiyun 
142*4882a593Smuzhiyun 	if (!driver->probe)
143*4882a593Smuzhiyun 		return -EINVAL;
144*4882a593Smuzhiyun 
145*4882a593Smuzhiyun 	retval = scmi_request_protocol_device(driver->id_table);
146*4882a593Smuzhiyun 	if (retval)
147*4882a593Smuzhiyun 		return retval;
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun 	driver->driver.bus = &scmi_bus_type;
150*4882a593Smuzhiyun 	driver->driver.name = driver->name;
151*4882a593Smuzhiyun 	driver->driver.owner = owner;
152*4882a593Smuzhiyun 	driver->driver.mod_name = mod_name;
153*4882a593Smuzhiyun 
154*4882a593Smuzhiyun 	retval = driver_register(&driver->driver);
155*4882a593Smuzhiyun 	if (!retval)
156*4882a593Smuzhiyun 		pr_debug("registered new scmi driver %s\n", driver->name);
157*4882a593Smuzhiyun 
158*4882a593Smuzhiyun 	return retval;
159*4882a593Smuzhiyun }
160*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(scmi_driver_register);
161*4882a593Smuzhiyun 
scmi_driver_unregister(struct scmi_driver * driver)162*4882a593Smuzhiyun void scmi_driver_unregister(struct scmi_driver *driver)
163*4882a593Smuzhiyun {
164*4882a593Smuzhiyun 	driver_unregister(&driver->driver);
165*4882a593Smuzhiyun 	scmi_unrequest_protocol_device(driver->id_table);
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(scmi_driver_unregister);
168*4882a593Smuzhiyun 
scmi_device_release(struct device * dev)169*4882a593Smuzhiyun static void scmi_device_release(struct device *dev)
170*4882a593Smuzhiyun {
171*4882a593Smuzhiyun 	kfree(to_scmi_dev(dev));
172*4882a593Smuzhiyun }
173*4882a593Smuzhiyun 
174*4882a593Smuzhiyun struct scmi_device *
scmi_device_create(struct device_node * np,struct device * parent,int protocol,const char * name)175*4882a593Smuzhiyun scmi_device_create(struct device_node *np, struct device *parent, int protocol,
176*4882a593Smuzhiyun 		   const char *name)
177*4882a593Smuzhiyun {
178*4882a593Smuzhiyun 	int id, retval;
179*4882a593Smuzhiyun 	struct scmi_device *scmi_dev;
180*4882a593Smuzhiyun 
181*4882a593Smuzhiyun 	scmi_dev = kzalloc(sizeof(*scmi_dev), GFP_KERNEL);
182*4882a593Smuzhiyun 	if (!scmi_dev)
183*4882a593Smuzhiyun 		return NULL;
184*4882a593Smuzhiyun 
185*4882a593Smuzhiyun 	scmi_dev->name = kstrdup_const(name ?: "unknown", GFP_KERNEL);
186*4882a593Smuzhiyun 	if (!scmi_dev->name) {
187*4882a593Smuzhiyun 		kfree(scmi_dev);
188*4882a593Smuzhiyun 		return NULL;
189*4882a593Smuzhiyun 	}
190*4882a593Smuzhiyun 
191*4882a593Smuzhiyun 	id = ida_simple_get(&scmi_bus_id, 1, 0, GFP_KERNEL);
192*4882a593Smuzhiyun 	if (id < 0) {
193*4882a593Smuzhiyun 		kfree_const(scmi_dev->name);
194*4882a593Smuzhiyun 		kfree(scmi_dev);
195*4882a593Smuzhiyun 		return NULL;
196*4882a593Smuzhiyun 	}
197*4882a593Smuzhiyun 
198*4882a593Smuzhiyun 	scmi_dev->id = id;
199*4882a593Smuzhiyun 	scmi_dev->protocol_id = protocol;
200*4882a593Smuzhiyun 	scmi_dev->dev.parent = parent;
201*4882a593Smuzhiyun 	scmi_dev->dev.of_node = np;
202*4882a593Smuzhiyun 	scmi_dev->dev.bus = &scmi_bus_type;
203*4882a593Smuzhiyun 	scmi_dev->dev.release = scmi_device_release;
204*4882a593Smuzhiyun 	dev_set_name(&scmi_dev->dev, "scmi_dev.%d", id);
205*4882a593Smuzhiyun 
206*4882a593Smuzhiyun 	retval = device_register(&scmi_dev->dev);
207*4882a593Smuzhiyun 	if (retval)
208*4882a593Smuzhiyun 		goto put_dev;
209*4882a593Smuzhiyun 
210*4882a593Smuzhiyun 	return scmi_dev;
211*4882a593Smuzhiyun put_dev:
212*4882a593Smuzhiyun 	kfree_const(scmi_dev->name);
213*4882a593Smuzhiyun 	put_device(&scmi_dev->dev);
214*4882a593Smuzhiyun 	ida_simple_remove(&scmi_bus_id, id);
215*4882a593Smuzhiyun 	return NULL;
216*4882a593Smuzhiyun }
217*4882a593Smuzhiyun 
scmi_device_destroy(struct scmi_device * scmi_dev)218*4882a593Smuzhiyun void scmi_device_destroy(struct scmi_device *scmi_dev)
219*4882a593Smuzhiyun {
220*4882a593Smuzhiyun 	kfree_const(scmi_dev->name);
221*4882a593Smuzhiyun 	scmi_handle_put(scmi_dev->handle);
222*4882a593Smuzhiyun 	ida_simple_remove(&scmi_bus_id, scmi_dev->id);
223*4882a593Smuzhiyun 	device_unregister(&scmi_dev->dev);
224*4882a593Smuzhiyun }
225*4882a593Smuzhiyun 
scmi_set_handle(struct scmi_device * scmi_dev)226*4882a593Smuzhiyun void scmi_set_handle(struct scmi_device *scmi_dev)
227*4882a593Smuzhiyun {
228*4882a593Smuzhiyun 	scmi_dev->handle = scmi_handle_get(&scmi_dev->dev);
229*4882a593Smuzhiyun }
230*4882a593Smuzhiyun 
scmi_protocol_register(const struct scmi_protocol * proto)231*4882a593Smuzhiyun int scmi_protocol_register(const struct scmi_protocol *proto)
232*4882a593Smuzhiyun {
233*4882a593Smuzhiyun 	int ret;
234*4882a593Smuzhiyun 
235*4882a593Smuzhiyun 	if (!proto) {
236*4882a593Smuzhiyun 		pr_err("invalid protocol\n");
237*4882a593Smuzhiyun 		return -EINVAL;
238*4882a593Smuzhiyun 	}
239*4882a593Smuzhiyun 
240*4882a593Smuzhiyun 	if (!proto->init_instance) {
241*4882a593Smuzhiyun 		pr_err("missing .init() for protocol 0x%x\n", proto->id);
242*4882a593Smuzhiyun 		return -EINVAL;
243*4882a593Smuzhiyun 	}
244*4882a593Smuzhiyun 
245*4882a593Smuzhiyun 	spin_lock(&protocol_lock);
246*4882a593Smuzhiyun 	ret = idr_alloc(&scmi_available_protocols, (void *)proto,
247*4882a593Smuzhiyun 			proto->id, proto->id + 1, GFP_ATOMIC);
248*4882a593Smuzhiyun 	spin_unlock(&protocol_lock);
249*4882a593Smuzhiyun 	if (ret != proto->id) {
250*4882a593Smuzhiyun 		pr_err("unable to allocate SCMI idr slot for 0x%x - err %d\n",
251*4882a593Smuzhiyun 		       proto->id, ret);
252*4882a593Smuzhiyun 		return ret;
253*4882a593Smuzhiyun 	}
254*4882a593Smuzhiyun 
255*4882a593Smuzhiyun 	pr_debug("Registered SCMI Protocol 0x%x\n", proto->id);
256*4882a593Smuzhiyun 
257*4882a593Smuzhiyun 	return 0;
258*4882a593Smuzhiyun }
259*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(scmi_protocol_register);
260*4882a593Smuzhiyun 
scmi_protocol_unregister(const struct scmi_protocol * proto)261*4882a593Smuzhiyun void scmi_protocol_unregister(const struct scmi_protocol *proto)
262*4882a593Smuzhiyun {
263*4882a593Smuzhiyun 	spin_lock(&protocol_lock);
264*4882a593Smuzhiyun 	idr_remove(&scmi_available_protocols, proto->id);
265*4882a593Smuzhiyun 	spin_unlock(&protocol_lock);
266*4882a593Smuzhiyun 
267*4882a593Smuzhiyun 	pr_debug("Unregistered SCMI Protocol 0x%x\n", proto->id);
268*4882a593Smuzhiyun 
269*4882a593Smuzhiyun 	return;
270*4882a593Smuzhiyun }
271*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(scmi_protocol_unregister);
272*4882a593Smuzhiyun 
__scmi_devices_unregister(struct device * dev,void * data)273*4882a593Smuzhiyun static int __scmi_devices_unregister(struct device *dev, void *data)
274*4882a593Smuzhiyun {
275*4882a593Smuzhiyun 	struct scmi_device *scmi_dev = to_scmi_dev(dev);
276*4882a593Smuzhiyun 
277*4882a593Smuzhiyun 	scmi_device_destroy(scmi_dev);
278*4882a593Smuzhiyun 	return 0;
279*4882a593Smuzhiyun }
280*4882a593Smuzhiyun 
scmi_devices_unregister(void)281*4882a593Smuzhiyun static void scmi_devices_unregister(void)
282*4882a593Smuzhiyun {
283*4882a593Smuzhiyun 	bus_for_each_dev(&scmi_bus_type, NULL, NULL, __scmi_devices_unregister);
284*4882a593Smuzhiyun }
285*4882a593Smuzhiyun 
scmi_bus_init(void)286*4882a593Smuzhiyun int __init scmi_bus_init(void)
287*4882a593Smuzhiyun {
288*4882a593Smuzhiyun 	int retval;
289*4882a593Smuzhiyun 
290*4882a593Smuzhiyun 	retval = bus_register(&scmi_bus_type);
291*4882a593Smuzhiyun 	if (retval)
292*4882a593Smuzhiyun 		pr_err("scmi protocol bus register failed (%d)\n", retval);
293*4882a593Smuzhiyun 
294*4882a593Smuzhiyun 	return retval;
295*4882a593Smuzhiyun }
296*4882a593Smuzhiyun 
scmi_bus_exit(void)297*4882a593Smuzhiyun void __exit scmi_bus_exit(void)
298*4882a593Smuzhiyun {
299*4882a593Smuzhiyun 	scmi_devices_unregister();
300*4882a593Smuzhiyun 	bus_unregister(&scmi_bus_type);
301*4882a593Smuzhiyun 	ida_destroy(&scmi_bus_id);
302*4882a593Smuzhiyun }
303