xref: /OK3568_Linux_fs/kernel/arch/sh/drivers/platform_early.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX--License-Identifier: GPL-2.0
2*4882a593Smuzhiyun 
3*4882a593Smuzhiyun #include <asm/platform_early.h>
4*4882a593Smuzhiyun #include <linux/mod_devicetable.h>
5*4882a593Smuzhiyun #include <linux/pm.h>
6*4882a593Smuzhiyun 
7*4882a593Smuzhiyun static __initdata LIST_HEAD(sh_early_platform_driver_list);
8*4882a593Smuzhiyun static __initdata LIST_HEAD(sh_early_platform_device_list);
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun static const struct platform_device_id *
platform_match_id(const struct platform_device_id * id,struct platform_device * pdev)11*4882a593Smuzhiyun platform_match_id(const struct platform_device_id *id,
12*4882a593Smuzhiyun 		  struct platform_device *pdev)
13*4882a593Smuzhiyun {
14*4882a593Smuzhiyun 	while (id->name[0]) {
15*4882a593Smuzhiyun 		if (strcmp(pdev->name, id->name) == 0) {
16*4882a593Smuzhiyun 			pdev->id_entry = id;
17*4882a593Smuzhiyun 			return id;
18*4882a593Smuzhiyun 		}
19*4882a593Smuzhiyun 		id++;
20*4882a593Smuzhiyun 	}
21*4882a593Smuzhiyun 	return NULL;
22*4882a593Smuzhiyun }
23*4882a593Smuzhiyun 
platform_match(struct device * dev,struct device_driver * drv)24*4882a593Smuzhiyun static int platform_match(struct device *dev, struct device_driver *drv)
25*4882a593Smuzhiyun {
26*4882a593Smuzhiyun 	struct platform_device *pdev = to_platform_device(dev);
27*4882a593Smuzhiyun 	struct platform_driver *pdrv = to_platform_driver(drv);
28*4882a593Smuzhiyun 
29*4882a593Smuzhiyun 	/* When driver_override is set, only bind to the matching driver */
30*4882a593Smuzhiyun 	if (pdev->driver_override)
31*4882a593Smuzhiyun 		return !strcmp(pdev->driver_override, drv->name);
32*4882a593Smuzhiyun 
33*4882a593Smuzhiyun 	/* Then try to match against the id table */
34*4882a593Smuzhiyun 	if (pdrv->id_table)
35*4882a593Smuzhiyun 		return platform_match_id(pdrv->id_table, pdev) != NULL;
36*4882a593Smuzhiyun 
37*4882a593Smuzhiyun 	/* fall-back to driver name match */
38*4882a593Smuzhiyun 	return (strcmp(pdev->name, drv->name) == 0);
39*4882a593Smuzhiyun }
40*4882a593Smuzhiyun 
41*4882a593Smuzhiyun #ifdef CONFIG_PM
device_pm_init_common(struct device * dev)42*4882a593Smuzhiyun static void device_pm_init_common(struct device *dev)
43*4882a593Smuzhiyun {
44*4882a593Smuzhiyun 	if (!dev->power.early_init) {
45*4882a593Smuzhiyun 		spin_lock_init(&dev->power.lock);
46*4882a593Smuzhiyun 		dev->power.qos = NULL;
47*4882a593Smuzhiyun 		dev->power.early_init = true;
48*4882a593Smuzhiyun 	}
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun 
pm_runtime_early_init(struct device * dev)51*4882a593Smuzhiyun static void pm_runtime_early_init(struct device *dev)
52*4882a593Smuzhiyun {
53*4882a593Smuzhiyun 	dev->power.disable_depth = 1;
54*4882a593Smuzhiyun 	device_pm_init_common(dev);
55*4882a593Smuzhiyun }
56*4882a593Smuzhiyun #else
pm_runtime_early_init(struct device * dev)57*4882a593Smuzhiyun static void pm_runtime_early_init(struct device *dev) {}
58*4882a593Smuzhiyun #endif
59*4882a593Smuzhiyun 
60*4882a593Smuzhiyun /**
61*4882a593Smuzhiyun  * sh_early_platform_driver_register - register early platform driver
62*4882a593Smuzhiyun  * @epdrv: sh_early_platform driver structure
63*4882a593Smuzhiyun  * @buf: string passed from early_param()
64*4882a593Smuzhiyun  *
65*4882a593Smuzhiyun  * Helper function for sh_early_platform_init() / sh_early_platform_init_buffer()
66*4882a593Smuzhiyun  */
sh_early_platform_driver_register(struct sh_early_platform_driver * epdrv,char * buf)67*4882a593Smuzhiyun int __init sh_early_platform_driver_register(struct sh_early_platform_driver *epdrv,
68*4882a593Smuzhiyun 					  char *buf)
69*4882a593Smuzhiyun {
70*4882a593Smuzhiyun 	char *tmp;
71*4882a593Smuzhiyun 	int n;
72*4882a593Smuzhiyun 
73*4882a593Smuzhiyun 	/* Simply add the driver to the end of the global list.
74*4882a593Smuzhiyun 	 * Drivers will by default be put on the list in compiled-in order.
75*4882a593Smuzhiyun 	 */
76*4882a593Smuzhiyun 	if (!epdrv->list.next) {
77*4882a593Smuzhiyun 		INIT_LIST_HEAD(&epdrv->list);
78*4882a593Smuzhiyun 		list_add_tail(&epdrv->list, &sh_early_platform_driver_list);
79*4882a593Smuzhiyun 	}
80*4882a593Smuzhiyun 
81*4882a593Smuzhiyun 	/* If the user has specified device then make sure the driver
82*4882a593Smuzhiyun 	 * gets prioritized. The driver of the last device specified on
83*4882a593Smuzhiyun 	 * command line will be put first on the list.
84*4882a593Smuzhiyun 	 */
85*4882a593Smuzhiyun 	n = strlen(epdrv->pdrv->driver.name);
86*4882a593Smuzhiyun 	if (buf && !strncmp(buf, epdrv->pdrv->driver.name, n)) {
87*4882a593Smuzhiyun 		list_move(&epdrv->list, &sh_early_platform_driver_list);
88*4882a593Smuzhiyun 
89*4882a593Smuzhiyun 		/* Allow passing parameters after device name */
90*4882a593Smuzhiyun 		if (buf[n] == '\0' || buf[n] == ',')
91*4882a593Smuzhiyun 			epdrv->requested_id = -1;
92*4882a593Smuzhiyun 		else {
93*4882a593Smuzhiyun 			epdrv->requested_id = simple_strtoul(&buf[n + 1],
94*4882a593Smuzhiyun 							     &tmp, 10);
95*4882a593Smuzhiyun 
96*4882a593Smuzhiyun 			if (buf[n] != '.' || (tmp == &buf[n + 1])) {
97*4882a593Smuzhiyun 				epdrv->requested_id = EARLY_PLATFORM_ID_ERROR;
98*4882a593Smuzhiyun 				n = 0;
99*4882a593Smuzhiyun 			} else
100*4882a593Smuzhiyun 				n += strcspn(&buf[n + 1], ",") + 1;
101*4882a593Smuzhiyun 		}
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun 		if (buf[n] == ',')
104*4882a593Smuzhiyun 			n++;
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun 		if (epdrv->bufsize) {
107*4882a593Smuzhiyun 			memcpy(epdrv->buffer, &buf[n],
108*4882a593Smuzhiyun 			       min_t(int, epdrv->bufsize, strlen(&buf[n]) + 1));
109*4882a593Smuzhiyun 			epdrv->buffer[epdrv->bufsize - 1] = '\0';
110*4882a593Smuzhiyun 		}
111*4882a593Smuzhiyun 	}
112*4882a593Smuzhiyun 
113*4882a593Smuzhiyun 	return 0;
114*4882a593Smuzhiyun }
115*4882a593Smuzhiyun 
116*4882a593Smuzhiyun /**
117*4882a593Smuzhiyun  * sh_early_platform_add_devices - adds a number of early platform devices
118*4882a593Smuzhiyun  * @devs: array of early platform devices to add
119*4882a593Smuzhiyun  * @num: number of early platform devices in array
120*4882a593Smuzhiyun  *
121*4882a593Smuzhiyun  * Used by early architecture code to register early platform devices and
122*4882a593Smuzhiyun  * their platform data.
123*4882a593Smuzhiyun  */
sh_early_platform_add_devices(struct platform_device ** devs,int num)124*4882a593Smuzhiyun void __init sh_early_platform_add_devices(struct platform_device **devs, int num)
125*4882a593Smuzhiyun {
126*4882a593Smuzhiyun 	struct device *dev;
127*4882a593Smuzhiyun 	int i;
128*4882a593Smuzhiyun 
129*4882a593Smuzhiyun 	/* simply add the devices to list */
130*4882a593Smuzhiyun 	for (i = 0; i < num; i++) {
131*4882a593Smuzhiyun 		dev = &devs[i]->dev;
132*4882a593Smuzhiyun 
133*4882a593Smuzhiyun 		if (!dev->devres_head.next) {
134*4882a593Smuzhiyun 			pm_runtime_early_init(dev);
135*4882a593Smuzhiyun 			INIT_LIST_HEAD(&dev->devres_head);
136*4882a593Smuzhiyun 			list_add_tail(&dev->devres_head,
137*4882a593Smuzhiyun 				      &sh_early_platform_device_list);
138*4882a593Smuzhiyun 		}
139*4882a593Smuzhiyun 	}
140*4882a593Smuzhiyun }
141*4882a593Smuzhiyun 
142*4882a593Smuzhiyun /**
143*4882a593Smuzhiyun  * sh_early_platform_driver_register_all - register early platform drivers
144*4882a593Smuzhiyun  * @class_str: string to identify early platform driver class
145*4882a593Smuzhiyun  *
146*4882a593Smuzhiyun  * Used by architecture code to register all early platform drivers
147*4882a593Smuzhiyun  * for a certain class. If omitted then only early platform drivers
148*4882a593Smuzhiyun  * with matching kernel command line class parameters will be registered.
149*4882a593Smuzhiyun  */
sh_early_platform_driver_register_all(char * class_str)150*4882a593Smuzhiyun void __init sh_early_platform_driver_register_all(char *class_str)
151*4882a593Smuzhiyun {
152*4882a593Smuzhiyun 	/* The "class_str" parameter may or may not be present on the kernel
153*4882a593Smuzhiyun 	 * command line. If it is present then there may be more than one
154*4882a593Smuzhiyun 	 * matching parameter.
155*4882a593Smuzhiyun 	 *
156*4882a593Smuzhiyun 	 * Since we register our early platform drivers using early_param()
157*4882a593Smuzhiyun 	 * we need to make sure that they also get registered in the case
158*4882a593Smuzhiyun 	 * when the parameter is missing from the kernel command line.
159*4882a593Smuzhiyun 	 *
160*4882a593Smuzhiyun 	 * We use parse_early_options() to make sure the early_param() gets
161*4882a593Smuzhiyun 	 * called at least once. The early_param() may be called more than
162*4882a593Smuzhiyun 	 * once since the name of the preferred device may be specified on
163*4882a593Smuzhiyun 	 * the kernel command line. sh_early_platform_driver_register() handles
164*4882a593Smuzhiyun 	 * this case for us.
165*4882a593Smuzhiyun 	 */
166*4882a593Smuzhiyun 	parse_early_options(class_str);
167*4882a593Smuzhiyun }
168*4882a593Smuzhiyun 
169*4882a593Smuzhiyun /**
170*4882a593Smuzhiyun  * sh_early_platform_match - find early platform device matching driver
171*4882a593Smuzhiyun  * @epdrv: early platform driver structure
172*4882a593Smuzhiyun  * @id: id to match against
173*4882a593Smuzhiyun  */
174*4882a593Smuzhiyun static struct platform_device * __init
sh_early_platform_match(struct sh_early_platform_driver * epdrv,int id)175*4882a593Smuzhiyun sh_early_platform_match(struct sh_early_platform_driver *epdrv, int id)
176*4882a593Smuzhiyun {
177*4882a593Smuzhiyun 	struct platform_device *pd;
178*4882a593Smuzhiyun 
179*4882a593Smuzhiyun 	list_for_each_entry(pd, &sh_early_platform_device_list, dev.devres_head)
180*4882a593Smuzhiyun 		if (platform_match(&pd->dev, &epdrv->pdrv->driver))
181*4882a593Smuzhiyun 			if (pd->id == id)
182*4882a593Smuzhiyun 				return pd;
183*4882a593Smuzhiyun 
184*4882a593Smuzhiyun 	return NULL;
185*4882a593Smuzhiyun }
186*4882a593Smuzhiyun 
187*4882a593Smuzhiyun /**
188*4882a593Smuzhiyun  * sh_early_platform_left - check if early platform driver has matching devices
189*4882a593Smuzhiyun  * @epdrv: early platform driver structure
190*4882a593Smuzhiyun  * @id: return true if id or above exists
191*4882a593Smuzhiyun  */
sh_early_platform_left(struct sh_early_platform_driver * epdrv,int id)192*4882a593Smuzhiyun static int __init sh_early_platform_left(struct sh_early_platform_driver *epdrv,
193*4882a593Smuzhiyun 				       int id)
194*4882a593Smuzhiyun {
195*4882a593Smuzhiyun 	struct platform_device *pd;
196*4882a593Smuzhiyun 
197*4882a593Smuzhiyun 	list_for_each_entry(pd, &sh_early_platform_device_list, dev.devres_head)
198*4882a593Smuzhiyun 		if (platform_match(&pd->dev, &epdrv->pdrv->driver))
199*4882a593Smuzhiyun 			if (pd->id >= id)
200*4882a593Smuzhiyun 				return 1;
201*4882a593Smuzhiyun 
202*4882a593Smuzhiyun 	return 0;
203*4882a593Smuzhiyun }
204*4882a593Smuzhiyun 
205*4882a593Smuzhiyun /**
206*4882a593Smuzhiyun  * sh_early_platform_driver_probe_id - probe drivers matching class_str and id
207*4882a593Smuzhiyun  * @class_str: string to identify early platform driver class
208*4882a593Smuzhiyun  * @id: id to match against
209*4882a593Smuzhiyun  * @nr_probe: number of platform devices to successfully probe before exiting
210*4882a593Smuzhiyun  */
sh_early_platform_driver_probe_id(char * class_str,int id,int nr_probe)211*4882a593Smuzhiyun static int __init sh_early_platform_driver_probe_id(char *class_str,
212*4882a593Smuzhiyun 						 int id,
213*4882a593Smuzhiyun 						 int nr_probe)
214*4882a593Smuzhiyun {
215*4882a593Smuzhiyun 	struct sh_early_platform_driver *epdrv;
216*4882a593Smuzhiyun 	struct platform_device *match;
217*4882a593Smuzhiyun 	int match_id;
218*4882a593Smuzhiyun 	int n = 0;
219*4882a593Smuzhiyun 	int left = 0;
220*4882a593Smuzhiyun 
221*4882a593Smuzhiyun 	list_for_each_entry(epdrv, &sh_early_platform_driver_list, list) {
222*4882a593Smuzhiyun 		/* only use drivers matching our class_str */
223*4882a593Smuzhiyun 		if (strcmp(class_str, epdrv->class_str))
224*4882a593Smuzhiyun 			continue;
225*4882a593Smuzhiyun 
226*4882a593Smuzhiyun 		if (id == -2) {
227*4882a593Smuzhiyun 			match_id = epdrv->requested_id;
228*4882a593Smuzhiyun 			left = 1;
229*4882a593Smuzhiyun 
230*4882a593Smuzhiyun 		} else {
231*4882a593Smuzhiyun 			match_id = id;
232*4882a593Smuzhiyun 			left += sh_early_platform_left(epdrv, id);
233*4882a593Smuzhiyun 
234*4882a593Smuzhiyun 			/* skip requested id */
235*4882a593Smuzhiyun 			switch (epdrv->requested_id) {
236*4882a593Smuzhiyun 			case EARLY_PLATFORM_ID_ERROR:
237*4882a593Smuzhiyun 			case EARLY_PLATFORM_ID_UNSET:
238*4882a593Smuzhiyun 				break;
239*4882a593Smuzhiyun 			default:
240*4882a593Smuzhiyun 				if (epdrv->requested_id == id)
241*4882a593Smuzhiyun 					match_id = EARLY_PLATFORM_ID_UNSET;
242*4882a593Smuzhiyun 			}
243*4882a593Smuzhiyun 		}
244*4882a593Smuzhiyun 
245*4882a593Smuzhiyun 		switch (match_id) {
246*4882a593Smuzhiyun 		case EARLY_PLATFORM_ID_ERROR:
247*4882a593Smuzhiyun 			pr_warn("%s: unable to parse %s parameter\n",
248*4882a593Smuzhiyun 				class_str, epdrv->pdrv->driver.name);
249*4882a593Smuzhiyun 			fallthrough;
250*4882a593Smuzhiyun 		case EARLY_PLATFORM_ID_UNSET:
251*4882a593Smuzhiyun 			match = NULL;
252*4882a593Smuzhiyun 			break;
253*4882a593Smuzhiyun 		default:
254*4882a593Smuzhiyun 			match = sh_early_platform_match(epdrv, match_id);
255*4882a593Smuzhiyun 		}
256*4882a593Smuzhiyun 
257*4882a593Smuzhiyun 		if (match) {
258*4882a593Smuzhiyun 			/*
259*4882a593Smuzhiyun 			 * Set up a sensible init_name to enable
260*4882a593Smuzhiyun 			 * dev_name() and others to be used before the
261*4882a593Smuzhiyun 			 * rest of the driver core is initialized.
262*4882a593Smuzhiyun 			 */
263*4882a593Smuzhiyun 			if (!match->dev.init_name && slab_is_available()) {
264*4882a593Smuzhiyun 				if (match->id != -1)
265*4882a593Smuzhiyun 					match->dev.init_name =
266*4882a593Smuzhiyun 						kasprintf(GFP_KERNEL, "%s.%d",
267*4882a593Smuzhiyun 							  match->name,
268*4882a593Smuzhiyun 							  match->id);
269*4882a593Smuzhiyun 				else
270*4882a593Smuzhiyun 					match->dev.init_name =
271*4882a593Smuzhiyun 						kasprintf(GFP_KERNEL, "%s",
272*4882a593Smuzhiyun 							  match->name);
273*4882a593Smuzhiyun 
274*4882a593Smuzhiyun 				if (!match->dev.init_name)
275*4882a593Smuzhiyun 					return -ENOMEM;
276*4882a593Smuzhiyun 			}
277*4882a593Smuzhiyun 
278*4882a593Smuzhiyun 			if (epdrv->pdrv->probe(match))
279*4882a593Smuzhiyun 				pr_warn("%s: unable to probe %s early.\n",
280*4882a593Smuzhiyun 					class_str, match->name);
281*4882a593Smuzhiyun 			else
282*4882a593Smuzhiyun 				n++;
283*4882a593Smuzhiyun 		}
284*4882a593Smuzhiyun 
285*4882a593Smuzhiyun 		if (n >= nr_probe)
286*4882a593Smuzhiyun 			break;
287*4882a593Smuzhiyun 	}
288*4882a593Smuzhiyun 
289*4882a593Smuzhiyun 	if (left)
290*4882a593Smuzhiyun 		return n;
291*4882a593Smuzhiyun 	else
292*4882a593Smuzhiyun 		return -ENODEV;
293*4882a593Smuzhiyun }
294*4882a593Smuzhiyun 
295*4882a593Smuzhiyun /**
296*4882a593Smuzhiyun  * sh_early_platform_driver_probe - probe a class of registered drivers
297*4882a593Smuzhiyun  * @class_str: string to identify early platform driver class
298*4882a593Smuzhiyun  * @nr_probe: number of platform devices to successfully probe before exiting
299*4882a593Smuzhiyun  * @user_only: only probe user specified early platform devices
300*4882a593Smuzhiyun  *
301*4882a593Smuzhiyun  * Used by architecture code to probe registered early platform drivers
302*4882a593Smuzhiyun  * within a certain class. For probe to happen a registered early platform
303*4882a593Smuzhiyun  * device matching a registered early platform driver is needed.
304*4882a593Smuzhiyun  */
sh_early_platform_driver_probe(char * class_str,int nr_probe,int user_only)305*4882a593Smuzhiyun int __init sh_early_platform_driver_probe(char *class_str,
306*4882a593Smuzhiyun 				       int nr_probe,
307*4882a593Smuzhiyun 				       int user_only)
308*4882a593Smuzhiyun {
309*4882a593Smuzhiyun 	int k, n, i;
310*4882a593Smuzhiyun 
311*4882a593Smuzhiyun 	n = 0;
312*4882a593Smuzhiyun 	for (i = -2; n < nr_probe; i++) {
313*4882a593Smuzhiyun 		k = sh_early_platform_driver_probe_id(class_str, i, nr_probe - n);
314*4882a593Smuzhiyun 
315*4882a593Smuzhiyun 		if (k < 0)
316*4882a593Smuzhiyun 			break;
317*4882a593Smuzhiyun 
318*4882a593Smuzhiyun 		n += k;
319*4882a593Smuzhiyun 
320*4882a593Smuzhiyun 		if (user_only)
321*4882a593Smuzhiyun 			break;
322*4882a593Smuzhiyun 	}
323*4882a593Smuzhiyun 
324*4882a593Smuzhiyun 	return n;
325*4882a593Smuzhiyun }
326*4882a593Smuzhiyun 
327*4882a593Smuzhiyun /**
328*4882a593Smuzhiyun  * early_platform_cleanup - clean up early platform code
329*4882a593Smuzhiyun  */
early_platform_cleanup(void)330*4882a593Smuzhiyun void __init early_platform_cleanup(void)
331*4882a593Smuzhiyun {
332*4882a593Smuzhiyun 	struct platform_device *pd, *pd2;
333*4882a593Smuzhiyun 
334*4882a593Smuzhiyun 	/* clean up the devres list used to chain devices */
335*4882a593Smuzhiyun 	list_for_each_entry_safe(pd, pd2, &sh_early_platform_device_list,
336*4882a593Smuzhiyun 				 dev.devres_head) {
337*4882a593Smuzhiyun 		list_del(&pd->dev.devres_head);
338*4882a593Smuzhiyun 		memset(&pd->dev.devres_head, 0, sizeof(pd->dev.devres_head));
339*4882a593Smuzhiyun 	}
340*4882a593Smuzhiyun }
341