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