watchdog: s3c2410_wdt: use dev_err()/dev_info() instead of pr_err()/pr_info()
[deliverable/linux.git] / drivers / base / platform.c
CommitLineData
1da177e4
LT
1/*
2 * platform.c - platform 'pseudo' bus for legacy devices
3 *
4 * Copyright (c) 2002-3 Patrick Mochel
5 * Copyright (c) 2002-3 Open Source Development Labs
6 *
7 * This file is released under the GPLv2
8 *
9 * Please see Documentation/driver-model/platform.txt for more
10 * information.
11 */
12
daa41226 13#include <linux/string.h>
d052d1be 14#include <linux/platform_device.h>
05212157 15#include <linux/of_device.h>
1da177e4
LT
16#include <linux/module.h>
17#include <linux/init.h>
18#include <linux/dma-mapping.h>
19#include <linux/bootmem.h>
20#include <linux/err.h>
4e57b681 21#include <linux/slab.h>
9d730229 22#include <linux/pm_runtime.h>
689ae231 23#include <linux/idr.h>
91e56878 24#include <linux/acpi.h>
1da177e4 25
a1bdc7aa 26#include "base.h"
bed2b42d 27#include "power/power.h"
a1bdc7aa 28
689ae231
JD
29/* For automatically allocated device IDs */
30static DEFINE_IDA(platform_devid_ida);
31
1da177e4 32struct device platform_bus = {
1e0b2cf9 33 .init_name = "platform",
1da177e4 34};
a96b2042 35EXPORT_SYMBOL_GPL(platform_bus);
1da177e4 36
a77ce816
KG
37/**
38 * arch_setup_pdev_archdata - Allow manipulation of archdata before its used
7de636fa 39 * @pdev: platform device
a77ce816
KG
40 *
41 * This is called before platform_device_add() such that any pdev_archdata may
42 * be setup before the platform_notifier is called. So if a user needs to
43 * manipulate any relevant information in the pdev_archdata they can do:
44 *
b1d6d822 45 * platform_device_alloc()
0258e182
FP
46 * ... manipulate ...
47 * platform_device_add()
a77ce816
KG
48 *
49 * And if they don't care they can just call platform_device_register() and
50 * everything will just work out.
51 */
52void __weak arch_setup_pdev_archdata(struct platform_device *pdev)
53{
54}
55
1da177e4 56/**
4a3ad20c
GKH
57 * platform_get_resource - get a resource for a device
58 * @dev: platform device
59 * @type: resource type
60 * @num: resource index
1da177e4 61 */
4a3ad20c
GKH
62struct resource *platform_get_resource(struct platform_device *dev,
63 unsigned int type, unsigned int num)
1da177e4
LT
64{
65 int i;
66
67 for (i = 0; i < dev->num_resources; i++) {
68 struct resource *r = &dev->resource[i];
69
c9f66169
MD
70 if (type == resource_type(r) && num-- == 0)
71 return r;
1da177e4
LT
72 }
73 return NULL;
74}
a96b2042 75EXPORT_SYMBOL_GPL(platform_get_resource);
1da177e4
LT
76
77/**
4a3ad20c
GKH
78 * platform_get_irq - get an IRQ for a device
79 * @dev: platform device
80 * @num: IRQ number index
1da177e4
LT
81 */
82int platform_get_irq(struct platform_device *dev, unsigned int num)
83{
5cf8f7db
AL
84#ifdef CONFIG_SPARC
85 /* sparc does not have irqs represented as IORESOURCE_IRQ resources */
86 if (!dev || num >= dev->archdata.num_irqs)
87 return -ENXIO;
88 return dev->archdata.irqs[num];
89#else
1da177e4
LT
90 struct resource *r = platform_get_resource(dev, IORESOURCE_IRQ, num);
91
305b3228 92 return r ? r->start : -ENXIO;
5cf8f7db 93#endif
1da177e4 94}
a96b2042 95EXPORT_SYMBOL_GPL(platform_get_irq);
1da177e4
LT
96
97/**
4a3ad20c
GKH
98 * platform_get_resource_byname - get a resource for a device by name
99 * @dev: platform device
100 * @type: resource type
101 * @name: resource name
1da177e4 102 */
4a3ad20c 103struct resource *platform_get_resource_byname(struct platform_device *dev,
c0afe7ba
LW
104 unsigned int type,
105 const char *name)
1da177e4
LT
106{
107 int i;
108
109 for (i = 0; i < dev->num_resources; i++) {
110 struct resource *r = &dev->resource[i];
111
1b8cb929
PU
112 if (unlikely(!r->name))
113 continue;
114
c9f66169
MD
115 if (type == resource_type(r) && !strcmp(r->name, name))
116 return r;
1da177e4
LT
117 }
118 return NULL;
119}
a96b2042 120EXPORT_SYMBOL_GPL(platform_get_resource_byname);
1da177e4
LT
121
122/**
d6ff8551 123 * platform_get_irq_byname - get an IRQ for a device by name
4a3ad20c
GKH
124 * @dev: platform device
125 * @name: IRQ name
1da177e4 126 */
c0afe7ba 127int platform_get_irq_byname(struct platform_device *dev, const char *name)
1da177e4 128{
4a3ad20c
GKH
129 struct resource *r = platform_get_resource_byname(dev, IORESOURCE_IRQ,
130 name);
1da177e4 131
305b3228 132 return r ? r->start : -ENXIO;
1da177e4 133}
a96b2042 134EXPORT_SYMBOL_GPL(platform_get_irq_byname);
1da177e4
LT
135
136/**
4a3ad20c
GKH
137 * platform_add_devices - add a numbers of platform devices
138 * @devs: array of platform devices to add
139 * @num: number of platform devices in array
1da177e4
LT
140 */
141int platform_add_devices(struct platform_device **devs, int num)
142{
143 int i, ret = 0;
144
145 for (i = 0; i < num; i++) {
146 ret = platform_device_register(devs[i]);
147 if (ret) {
148 while (--i >= 0)
149 platform_device_unregister(devs[i]);
150 break;
151 }
152 }
153
154 return ret;
155}
a96b2042 156EXPORT_SYMBOL_GPL(platform_add_devices);
1da177e4 157
37c12e74
RK
158struct platform_object {
159 struct platform_device pdev;
160 char name[1];
161};
162
1da177e4 163/**
3c31f07a 164 * platform_device_put - destroy a platform device
4a3ad20c 165 * @pdev: platform device to free
37c12e74 166 *
4a3ad20c
GKH
167 * Free all memory associated with a platform device. This function must
168 * _only_ be externally called in error cases. All other usage is a bug.
37c12e74
RK
169 */
170void platform_device_put(struct platform_device *pdev)
171{
172 if (pdev)
173 put_device(&pdev->dev);
174}
175EXPORT_SYMBOL_GPL(platform_device_put);
176
177static void platform_device_release(struct device *dev)
178{
4a3ad20c
GKH
179 struct platform_object *pa = container_of(dev, struct platform_object,
180 pdev.dev);
37c12e74 181
7096d042 182 of_device_node_put(&pa->pdev.dev);
37c12e74 183 kfree(pa->pdev.dev.platform_data);
e710d7d5 184 kfree(pa->pdev.mfd_cell);
37c12e74
RK
185 kfree(pa->pdev.resource);
186 kfree(pa);
187}
188
189/**
3c31f07a 190 * platform_device_alloc - create a platform device
4a3ad20c
GKH
191 * @name: base name of the device we're adding
192 * @id: instance id
37c12e74 193 *
4a3ad20c
GKH
194 * Create a platform device object which can have other objects attached
195 * to it, and which will have attached objects freed when it is released.
37c12e74 196 */
1359555e 197struct platform_device *platform_device_alloc(const char *name, int id)
37c12e74
RK
198{
199 struct platform_object *pa;
200
201 pa = kzalloc(sizeof(struct platform_object) + strlen(name), GFP_KERNEL);
202 if (pa) {
203 strcpy(pa->name, name);
204 pa->pdev.name = pa->name;
205 pa->pdev.id = id;
206 device_initialize(&pa->pdev.dev);
207 pa->pdev.dev.release = platform_device_release;
a77ce816 208 arch_setup_pdev_archdata(&pa->pdev);
37c12e74
RK
209 }
210
93ce3061 211 return pa ? &pa->pdev : NULL;
37c12e74
RK
212}
213EXPORT_SYMBOL_GPL(platform_device_alloc);
214
215/**
3c31f07a 216 * platform_device_add_resources - add resources to a platform device
4a3ad20c
GKH
217 * @pdev: platform device allocated by platform_device_alloc to add resources to
218 * @res: set of resources that needs to be allocated for the device
219 * @num: number of resources
37c12e74 220 *
4a3ad20c
GKH
221 * Add a copy of the resources to the platform device. The memory
222 * associated with the resources will be freed when the platform device is
223 * released.
37c12e74 224 */
4a3ad20c 225int platform_device_add_resources(struct platform_device *pdev,
0b7f1a7e 226 const struct resource *res, unsigned int num)
37c12e74 227{
cea89623 228 struct resource *r = NULL;
37c12e74 229
cea89623
UKK
230 if (res) {
231 r = kmemdup(res, sizeof(struct resource) * num, GFP_KERNEL);
232 if (!r)
233 return -ENOMEM;
37c12e74 234 }
cea89623 235
4a03d6f7 236 kfree(pdev->resource);
cea89623
UKK
237 pdev->resource = r;
238 pdev->num_resources = num;
239 return 0;
37c12e74
RK
240}
241EXPORT_SYMBOL_GPL(platform_device_add_resources);
242
243/**
3c31f07a 244 * platform_device_add_data - add platform-specific data to a platform device
4a3ad20c
GKH
245 * @pdev: platform device allocated by platform_device_alloc to add resources to
246 * @data: platform specific data for this platform device
247 * @size: size of platform specific data
37c12e74 248 *
4a3ad20c
GKH
249 * Add a copy of platform specific data to the platform device's
250 * platform_data pointer. The memory associated with the platform data
251 * will be freed when the platform device is released.
37c12e74 252 */
4a3ad20c
GKH
253int platform_device_add_data(struct platform_device *pdev, const void *data,
254 size_t size)
37c12e74 255{
27a33f9e 256 void *d = NULL;
5cfc64ce 257
27a33f9e
UKK
258 if (data) {
259 d = kmemdup(data, size, GFP_KERNEL);
260 if (!d)
261 return -ENOMEM;
37c12e74 262 }
27a33f9e 263
251e031d 264 kfree(pdev->dev.platform_data);
27a33f9e
UKK
265 pdev->dev.platform_data = d;
266 return 0;
37c12e74
RK
267}
268EXPORT_SYMBOL_GPL(platform_device_add_data);
269
270/**
4a3ad20c
GKH
271 * platform_device_add - add a platform device to device hierarchy
272 * @pdev: platform device we're adding
1da177e4 273 *
4a3ad20c
GKH
274 * This is part 2 of platform_device_register(), though may be called
275 * separately _iff_ pdev was allocated by platform_device_alloc().
1da177e4 276 */
37c12e74 277int platform_device_add(struct platform_device *pdev)
1da177e4 278{
689ae231 279 int i, ret;
1da177e4
LT
280
281 if (!pdev)
282 return -EINVAL;
283
284 if (!pdev->dev.parent)
285 pdev->dev.parent = &platform_bus;
286
287 pdev->dev.bus = &platform_bus_type;
288
689ae231
JD
289 switch (pdev->id) {
290 default:
1e0b2cf9 291 dev_set_name(&pdev->dev, "%s.%d", pdev->name, pdev->id);
689ae231
JD
292 break;
293 case PLATFORM_DEVID_NONE:
acc0e90f 294 dev_set_name(&pdev->dev, "%s", pdev->name);
689ae231
JD
295 break;
296 case PLATFORM_DEVID_AUTO:
297 /*
298 * Automatically allocated device ID. We mark it as such so
299 * that we remember it must be freed, and we append a suffix
300 * to avoid namespace collision with explicit IDs.
301 */
302 ret = ida_simple_get(&platform_devid_ida, 0, 0, GFP_KERNEL);
303 if (ret < 0)
304 goto err_out;
305 pdev->id = ret;
306 pdev->id_auto = true;
307 dev_set_name(&pdev->dev, "%s.%d.auto", pdev->name, pdev->id);
308 break;
309 }
1da177e4
LT
310
311 for (i = 0; i < pdev->num_resources; i++) {
312 struct resource *p, *r = &pdev->resource[i];
313
314 if (r->name == NULL)
1e0b2cf9 315 r->name = dev_name(&pdev->dev);
1da177e4
LT
316
317 p = r->parent;
318 if (!p) {
c9f66169 319 if (resource_type(r) == IORESOURCE_MEM)
1da177e4 320 p = &iomem_resource;
c9f66169 321 else if (resource_type(r) == IORESOURCE_IO)
1da177e4
LT
322 p = &ioport_resource;
323 }
324
d960bb4d 325 if (p && insert_resource(p, r)) {
0258e182 326 dev_err(&pdev->dev, "failed to claim resource %d\n", i);
1da177e4
LT
327 ret = -EBUSY;
328 goto failed;
329 }
330 }
331
332 pr_debug("Registering platform device '%s'. Parent at %s\n",
1e0b2cf9 333 dev_name(&pdev->dev), dev_name(pdev->dev.parent));
1da177e4 334
e3915532 335 ret = device_add(&pdev->dev);
1da177e4
LT
336 if (ret == 0)
337 return ret;
338
339 failed:
689ae231
JD
340 if (pdev->id_auto) {
341 ida_simple_remove(&platform_devid_ida, pdev->id);
342 pdev->id = PLATFORM_DEVID_AUTO;
343 }
344
c9f66169
MD
345 while (--i >= 0) {
346 struct resource *r = &pdev->resource[i];
347 unsigned long type = resource_type(r);
348
349 if (type == IORESOURCE_MEM || type == IORESOURCE_IO)
350 release_resource(r);
351 }
352
689ae231 353 err_out:
1da177e4
LT
354 return ret;
355}
37c12e74
RK
356EXPORT_SYMBOL_GPL(platform_device_add);
357
358/**
4a3ad20c
GKH
359 * platform_device_del - remove a platform-level device
360 * @pdev: platform device we're removing
1da177e4 361 *
4a3ad20c
GKH
362 * Note that this function will also release all memory- and port-based
363 * resources owned by the device (@dev->resource). This function must
364 * _only_ be externally called in error cases. All other usage is a bug.
1da177e4 365 */
93ce3061 366void platform_device_del(struct platform_device *pdev)
1da177e4
LT
367{
368 int i;
369
370 if (pdev) {
dc4c15d4
JD
371 device_del(&pdev->dev);
372
689ae231
JD
373 if (pdev->id_auto) {
374 ida_simple_remove(&platform_devid_ida, pdev->id);
375 pdev->id = PLATFORM_DEVID_AUTO;
376 }
377
1da177e4
LT
378 for (i = 0; i < pdev->num_resources; i++) {
379 struct resource *r = &pdev->resource[i];
c9f66169
MD
380 unsigned long type = resource_type(r);
381
382 if (type == IORESOURCE_MEM || type == IORESOURCE_IO)
1da177e4
LT
383 release_resource(r);
384 }
1da177e4
LT
385 }
386}
93ce3061
DT
387EXPORT_SYMBOL_GPL(platform_device_del);
388
389/**
4a3ad20c
GKH
390 * platform_device_register - add a platform-level device
391 * @pdev: platform device we're adding
93ce3061 392 */
4a3ad20c 393int platform_device_register(struct platform_device *pdev)
93ce3061
DT
394{
395 device_initialize(&pdev->dev);
a77ce816 396 arch_setup_pdev_archdata(pdev);
93ce3061
DT
397 return platform_device_add(pdev);
398}
a96b2042 399EXPORT_SYMBOL_GPL(platform_device_register);
93ce3061
DT
400
401/**
4a3ad20c
GKH
402 * platform_device_unregister - unregister a platform-level device
403 * @pdev: platform device we're unregistering
93ce3061 404 *
4a3ad20c
GKH
405 * Unregistration is done in 2 steps. First we release all resources
406 * and remove it from the subsystem, then we drop reference count by
407 * calling platform_device_put().
93ce3061 408 */
4a3ad20c 409void platform_device_unregister(struct platform_device *pdev)
93ce3061
DT
410{
411 platform_device_del(pdev);
412 platform_device_put(pdev);
413}
a96b2042 414EXPORT_SYMBOL_GPL(platform_device_unregister);
1da177e4 415
1da177e4 416/**
01dcc60a 417 * platform_device_register_full - add a platform-level device with
44f28bde 418 * resources and platform-specific data
49a4ec18 419 *
01dcc60a 420 * @pdevinfo: data used to create device
d8bf2540 421 *
f0eae0ed 422 * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
d8bf2540 423 */
01dcc60a 424struct platform_device *platform_device_register_full(
5a3072be 425 const struct platform_device_info *pdevinfo)
d8bf2540 426{
44f28bde 427 int ret = -ENOMEM;
d8bf2540 428 struct platform_device *pdev;
d8bf2540 429
01dcc60a 430 pdev = platform_device_alloc(pdevinfo->name, pdevinfo->id);
44f28bde 431 if (!pdev)
01dcc60a
UKK
432 goto err_alloc;
433
434 pdev->dev.parent = pdevinfo->parent;
863f9f30 435 ACPI_HANDLE_SET(&pdev->dev, pdevinfo->acpi_node.handle);
01dcc60a
UKK
436
437 if (pdevinfo->dma_mask) {
438 /*
439 * This memory isn't freed when the device is put,
440 * I don't have a nice idea for that though. Conceptually
441 * dma_mask in struct device should not be a pointer.
442 * See http://thread.gmane.org/gmane.linux.kernel.pci/9081
443 */
444 pdev->dev.dma_mask =
445 kmalloc(sizeof(*pdev->dev.dma_mask), GFP_KERNEL);
446 if (!pdev->dev.dma_mask)
447 goto err;
448
449 *pdev->dev.dma_mask = pdevinfo->dma_mask;
450 pdev->dev.coherent_dma_mask = pdevinfo->dma_mask;
451 }
d8bf2540 452
01dcc60a
UKK
453 ret = platform_device_add_resources(pdev,
454 pdevinfo->res, pdevinfo->num_res);
807508c8
AV
455 if (ret)
456 goto err;
44f28bde 457
01dcc60a
UKK
458 ret = platform_device_add_data(pdev,
459 pdevinfo->data, pdevinfo->size_data);
807508c8
AV
460 if (ret)
461 goto err;
d8bf2540 462
44f28bde
UKK
463 ret = platform_device_add(pdev);
464 if (ret) {
465err:
863f9f30 466 ACPI_HANDLE_SET(&pdev->dev, NULL);
01dcc60a
UKK
467 kfree(pdev->dev.dma_mask);
468
469err_alloc:
44f28bde
UKK
470 platform_device_put(pdev);
471 return ERR_PTR(ret);
472 }
d8bf2540
DB
473
474 return pdev;
d8bf2540 475}
01dcc60a 476EXPORT_SYMBOL_GPL(platform_device_register_full);
d8bf2540 477
00d3dcdd
RK
478static int platform_drv_probe(struct device *_dev)
479{
480 struct platform_driver *drv = to_platform_driver(_dev->driver);
481 struct platform_device *dev = to_platform_device(_dev);
94d76d5d 482 int ret;
00d3dcdd 483
94d76d5d
RW
484 if (ACPI_HANDLE(_dev))
485 acpi_dev_pm_attach(_dev, true);
486
487 ret = drv->probe(dev);
488 if (ret && ACPI_HANDLE(_dev))
489 acpi_dev_pm_detach(_dev, true);
490
491 return ret;
00d3dcdd
RK
492}
493
c67334fb
DB
494static int platform_drv_probe_fail(struct device *_dev)
495{
496 return -ENXIO;
497}
498
00d3dcdd
RK
499static int platform_drv_remove(struct device *_dev)
500{
501 struct platform_driver *drv = to_platform_driver(_dev->driver);
502 struct platform_device *dev = to_platform_device(_dev);
94d76d5d 503 int ret;
00d3dcdd 504
94d76d5d
RW
505 ret = drv->remove(dev);
506 if (ACPI_HANDLE(_dev))
507 acpi_dev_pm_detach(_dev, true);
508
509 return ret;
00d3dcdd
RK
510}
511
512static void platform_drv_shutdown(struct device *_dev)
513{
514 struct platform_driver *drv = to_platform_driver(_dev->driver);
515 struct platform_device *dev = to_platform_device(_dev);
516
517 drv->shutdown(dev);
94d76d5d
RW
518 if (ACPI_HANDLE(_dev))
519 acpi_dev_pm_detach(_dev, true);
00d3dcdd
RK
520}
521
00d3dcdd 522/**
9447057e 523 * __platform_driver_register - register a driver for platform-level devices
4a3ad20c 524 * @drv: platform driver structure
00d3dcdd 525 */
9447057e
LC
526int __platform_driver_register(struct platform_driver *drv,
527 struct module *owner)
00d3dcdd 528{
9447057e 529 drv->driver.owner = owner;
00d3dcdd
RK
530 drv->driver.bus = &platform_bus_type;
531 if (drv->probe)
532 drv->driver.probe = platform_drv_probe;
533 if (drv->remove)
534 drv->driver.remove = platform_drv_remove;
535 if (drv->shutdown)
536 drv->driver.shutdown = platform_drv_shutdown;
783ea7d4 537
00d3dcdd
RK
538 return driver_register(&drv->driver);
539}
9447057e 540EXPORT_SYMBOL_GPL(__platform_driver_register);
00d3dcdd
RK
541
542/**
3c31f07a 543 * platform_driver_unregister - unregister a driver for platform-level devices
4a3ad20c 544 * @drv: platform driver structure
00d3dcdd
RK
545 */
546void platform_driver_unregister(struct platform_driver *drv)
547{
548 driver_unregister(&drv->driver);
549}
550EXPORT_SYMBOL_GPL(platform_driver_unregister);
551
c67334fb
DB
552/**
553 * platform_driver_probe - register driver for non-hotpluggable device
554 * @drv: platform driver structure
647c86d0
FP
555 * @probe: the driver probe routine, probably from an __init section,
556 * must not return -EPROBE_DEFER.
c67334fb
DB
557 *
558 * Use this instead of platform_driver_register() when you know the device
559 * is not hotpluggable and has already been registered, and you want to
560 * remove its run-once probe() infrastructure from memory after the driver
561 * has bound to the device.
562 *
563 * One typical use for this would be with drivers for controllers integrated
564 * into system-on-chip processors, where the controller devices have been
565 * configured as part of board setup.
566 *
647c86d0
FP
567 * This is incompatible with deferred probing so probe() must not
568 * return -EPROBE_DEFER.
569 *
c67334fb
DB
570 * Returns zero if the driver registered and bound to a device, else returns
571 * a negative error code and with the driver not registered.
572 */
c63e0783 573int __init_or_module platform_driver_probe(struct platform_driver *drv,
c67334fb
DB
574 int (*probe)(struct platform_device *))
575{
576 int retval, code;
577
1a6f2a75
DT
578 /* make sure driver won't have bind/unbind attributes */
579 drv->driver.suppress_bind_attrs = true;
580
c67334fb
DB
581 /* temporary section violation during probe() */
582 drv->probe = probe;
583 retval = code = platform_driver_register(drv);
584
1a6f2a75
DT
585 /*
586 * Fixup that section violation, being paranoid about code scanning
c67334fb
DB
587 * the list of drivers in order to probe new devices. Check to see
588 * if the probe was successful, and make sure any forced probes of
589 * new devices fail.
590 */
d79d3244 591 spin_lock(&drv->driver.bus->p->klist_drivers.k_lock);
c67334fb 592 drv->probe = NULL;
e5dd1278 593 if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list))
c67334fb
DB
594 retval = -ENODEV;
595 drv->driver.probe = platform_drv_probe_fail;
d79d3244 596 spin_unlock(&drv->driver.bus->p->klist_drivers.k_lock);
c67334fb
DB
597
598 if (code != retval)
599 platform_driver_unregister(drv);
600 return retval;
601}
602EXPORT_SYMBOL_GPL(platform_driver_probe);
1da177e4 603
ecdf6ceb
DT
604/**
605 * platform_create_bundle - register driver and create corresponding device
606 * @driver: platform driver structure
607 * @probe: the driver probe routine, probably from an __init section
608 * @res: set of resources that needs to be allocated for the device
609 * @n_res: number of resources
610 * @data: platform specific data for this platform device
611 * @size: size of platform specific data
612 *
613 * Use this in legacy-style modules that probe hardware directly and
614 * register a single platform device and corresponding platform driver.
f0eae0ed
JN
615 *
616 * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
ecdf6ceb
DT
617 */
618struct platform_device * __init_or_module platform_create_bundle(
619 struct platform_driver *driver,
620 int (*probe)(struct platform_device *),
621 struct resource *res, unsigned int n_res,
622 const void *data, size_t size)
623{
624 struct platform_device *pdev;
625 int error;
626
627 pdev = platform_device_alloc(driver->driver.name, -1);
628 if (!pdev) {
629 error = -ENOMEM;
630 goto err_out;
631 }
632
807508c8
AV
633 error = platform_device_add_resources(pdev, res, n_res);
634 if (error)
635 goto err_pdev_put;
ecdf6ceb 636
807508c8
AV
637 error = platform_device_add_data(pdev, data, size);
638 if (error)
639 goto err_pdev_put;
ecdf6ceb
DT
640
641 error = platform_device_add(pdev);
642 if (error)
643 goto err_pdev_put;
644
645 error = platform_driver_probe(driver, probe);
646 if (error)
647 goto err_pdev_del;
648
649 return pdev;
650
651err_pdev_del:
652 platform_device_del(pdev);
653err_pdev_put:
654 platform_device_put(pdev);
655err_out:
656 return ERR_PTR(error);
657}
658EXPORT_SYMBOL_GPL(platform_create_bundle);
659
a0245f7a
DB
660/* modalias support enables more hands-off userspace setup:
661 * (a) environment variable lets new-style hotplug events work once system is
662 * fully running: "modprobe $MODALIAS"
663 * (b) sysfs attribute lets new-style coldplug recover from hotplug events
664 * mishandled before system is fully running: "modprobe $(cat modalias)"
665 */
4a3ad20c
GKH
666static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
667 char *buf)
a0245f7a
DB
668{
669 struct platform_device *pdev = to_platform_device(dev);
43cc71ee 670 int len = snprintf(buf, PAGE_SIZE, "platform:%s\n", pdev->name);
a0245f7a
DB
671
672 return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
673}
674
675static struct device_attribute platform_dev_attrs[] = {
676 __ATTR_RO(modalias),
677 __ATTR_NULL,
678};
679
7eff2e7a 680static int platform_uevent(struct device *dev, struct kobj_uevent_env *env)
a0245f7a
DB
681{
682 struct platform_device *pdev = to_platform_device(dev);
eca39301
GL
683 int rc;
684
685 /* Some devices have extra OF data and an OF-style MODALIAS */
0258e182 686 rc = of_device_uevent_modalias(dev, env);
eca39301
GL
687 if (rc != -ENODEV)
688 return rc;
a0245f7a 689
57fee4a5 690 add_uevent_var(env, "MODALIAS=%s%s", PLATFORM_MODULE_PREFIX,
0a26813c 691 pdev->name);
a0245f7a
DB
692 return 0;
693}
694
57fee4a5 695static const struct platform_device_id *platform_match_id(
831fad2f 696 const struct platform_device_id *id,
57fee4a5
EM
697 struct platform_device *pdev)
698{
699 while (id->name[0]) {
700 if (strcmp(pdev->name, id->name) == 0) {
701 pdev->id_entry = id;
702 return id;
703 }
704 id++;
705 }
706 return NULL;
707}
708
1da177e4 709/**
4a3ad20c
GKH
710 * platform_match - bind platform device to platform driver.
711 * @dev: device.
712 * @drv: driver.
1da177e4 713 *
4a3ad20c
GKH
714 * Platform device IDs are assumed to be encoded like this:
715 * "<name><instance>", where <name> is a short description of the type of
716 * device, like "pci" or "floppy", and <instance> is the enumerated
717 * instance of the device, like '0' or '42'. Driver IDs are simply
718 * "<name>". So, extract the <name> from the platform_device structure,
719 * and compare it against the name of the driver. Return whether they match
720 * or not.
1da177e4 721 */
4a3ad20c 722static int platform_match(struct device *dev, struct device_driver *drv)
1da177e4 723{
71b3e0c1 724 struct platform_device *pdev = to_platform_device(dev);
57fee4a5
EM
725 struct platform_driver *pdrv = to_platform_driver(drv);
726
05212157
GL
727 /* Attempt an OF style match first */
728 if (of_driver_match_device(dev, drv))
729 return 1;
730
91e56878
MW
731 /* Then try ACPI style match */
732 if (acpi_driver_match_device(dev, drv))
733 return 1;
734
05212157 735 /* Then try to match against the id table */
57fee4a5
EM
736 if (pdrv->id_table)
737 return platform_match_id(pdrv->id_table, pdev) != NULL;
1da177e4 738
57fee4a5 739 /* fall-back to driver name match */
1e0b2cf9 740 return (strcmp(pdev->name, drv->name) == 0);
1da177e4
LT
741}
742
25e18499
RW
743#ifdef CONFIG_PM_SLEEP
744
745static int platform_legacy_suspend(struct device *dev, pm_message_t mesg)
1da177e4 746{
783ea7d4
MD
747 struct platform_driver *pdrv = to_platform_driver(dev->driver);
748 struct platform_device *pdev = to_platform_device(dev);
1da177e4
LT
749 int ret = 0;
750
783ea7d4
MD
751 if (dev->driver && pdrv->suspend)
752 ret = pdrv->suspend(pdev, mesg);
386415d8
DB
753
754 return ret;
755}
756
25e18499 757static int platform_legacy_resume(struct device *dev)
1da177e4 758{
783ea7d4
MD
759 struct platform_driver *pdrv = to_platform_driver(dev->driver);
760 struct platform_device *pdev = to_platform_device(dev);
1da177e4
LT
761 int ret = 0;
762
783ea7d4
MD
763 if (dev->driver && pdrv->resume)
764 ret = pdrv->resume(pdev);
9480e307 765
1da177e4
LT
766 return ret;
767}
768
69c9dd1e 769#endif /* CONFIG_PM_SLEEP */
9d730229 770
25e18499
RW
771#ifdef CONFIG_SUSPEND
772
69c9dd1e 773int platform_pm_suspend(struct device *dev)
25e18499
RW
774{
775 struct device_driver *drv = dev->driver;
776 int ret = 0;
777
adf09493
RW
778 if (!drv)
779 return 0;
780
781 if (drv->pm) {
25e18499
RW
782 if (drv->pm->suspend)
783 ret = drv->pm->suspend(dev);
784 } else {
785 ret = platform_legacy_suspend(dev, PMSG_SUSPEND);
786 }
787
788 return ret;
789}
790
69c9dd1e 791int platform_pm_resume(struct device *dev)
25e18499
RW
792{
793 struct device_driver *drv = dev->driver;
794 int ret = 0;
795
adf09493
RW
796 if (!drv)
797 return 0;
798
799 if (drv->pm) {
25e18499
RW
800 if (drv->pm->resume)
801 ret = drv->pm->resume(dev);
802 } else {
803 ret = platform_legacy_resume(dev);
804 }
805
806 return ret;
807}
808
69c9dd1e 809#endif /* CONFIG_SUSPEND */
25e18499 810
1f112cee 811#ifdef CONFIG_HIBERNATE_CALLBACKS
25e18499 812
69c9dd1e 813int platform_pm_freeze(struct device *dev)
25e18499
RW
814{
815 struct device_driver *drv = dev->driver;
816 int ret = 0;
817
818 if (!drv)
819 return 0;
820
821 if (drv->pm) {
822 if (drv->pm->freeze)
823 ret = drv->pm->freeze(dev);
824 } else {
825 ret = platform_legacy_suspend(dev, PMSG_FREEZE);
826 }
827
828 return ret;
829}
830
69c9dd1e 831int platform_pm_thaw(struct device *dev)
25e18499
RW
832{
833 struct device_driver *drv = dev->driver;
834 int ret = 0;
835
adf09493
RW
836 if (!drv)
837 return 0;
838
839 if (drv->pm) {
25e18499
RW
840 if (drv->pm->thaw)
841 ret = drv->pm->thaw(dev);
842 } else {
843 ret = platform_legacy_resume(dev);
844 }
845
846 return ret;
847}
848
69c9dd1e 849int platform_pm_poweroff(struct device *dev)
25e18499
RW
850{
851 struct device_driver *drv = dev->driver;
852 int ret = 0;
853
adf09493
RW
854 if (!drv)
855 return 0;
856
857 if (drv->pm) {
25e18499
RW
858 if (drv->pm->poweroff)
859 ret = drv->pm->poweroff(dev);
860 } else {
861 ret = platform_legacy_suspend(dev, PMSG_HIBERNATE);
862 }
863
864 return ret;
865}
866
69c9dd1e 867int platform_pm_restore(struct device *dev)
25e18499
RW
868{
869 struct device_driver *drv = dev->driver;
870 int ret = 0;
871
adf09493
RW
872 if (!drv)
873 return 0;
874
875 if (drv->pm) {
25e18499
RW
876 if (drv->pm->restore)
877 ret = drv->pm->restore(dev);
878 } else {
879 ret = platform_legacy_resume(dev);
880 }
881
882 return ret;
883}
884
69c9dd1e 885#endif /* CONFIG_HIBERNATE_CALLBACKS */
25e18499 886
d9ab7716 887static const struct dev_pm_ops platform_dev_pm_ops = {
8b313a38
RW
888 .runtime_suspend = pm_generic_runtime_suspend,
889 .runtime_resume = pm_generic_runtime_resume,
69c9dd1e 890 USE_PLATFORM_PM_SLEEP_OPS
25e18499
RW
891};
892
1da177e4
LT
893struct bus_type platform_bus_type = {
894 .name = "platform",
a0245f7a 895 .dev_attrs = platform_dev_attrs,
1da177e4 896 .match = platform_match,
a0245f7a 897 .uevent = platform_uevent,
9d730229 898 .pm = &platform_dev_pm_ops,
1da177e4 899};
a96b2042 900EXPORT_SYMBOL_GPL(platform_bus_type);
1da177e4
LT
901
902int __init platform_bus_init(void)
903{
fbfb1445
CH
904 int error;
905
13977091
MD
906 early_platform_cleanup();
907
fbfb1445
CH
908 error = device_register(&platform_bus);
909 if (error)
910 return error;
911 error = bus_register(&platform_bus_type);
912 if (error)
913 device_unregister(&platform_bus);
914 return error;
1da177e4
LT
915}
916
917#ifndef ARCH_HAS_DMA_GET_REQUIRED_MASK
918u64 dma_get_required_mask(struct device *dev)
919{
920 u32 low_totalram = ((max_pfn - 1) << PAGE_SHIFT);
921 u32 high_totalram = ((max_pfn - 1) >> (32 - PAGE_SHIFT));
922 u64 mask;
923
924 if (!high_totalram) {
925 /* convert to mask just covering totalram */
926 low_totalram = (1 << (fls(low_totalram) - 1));
927 low_totalram += low_totalram - 1;
928 mask = low_totalram;
929 } else {
930 high_totalram = (1 << (fls(high_totalram) - 1));
931 high_totalram += high_totalram - 1;
932 mask = (((u64)high_totalram) << 32) + 0xffffffff;
933 }
e88a0c2c 934 return mask;
1da177e4
LT
935}
936EXPORT_SYMBOL_GPL(dma_get_required_mask);
937#endif
13977091
MD
938
939static __initdata LIST_HEAD(early_platform_driver_list);
940static __initdata LIST_HEAD(early_platform_device_list);
941
942/**
4d26e139 943 * early_platform_driver_register - register early platform driver
d86c1302 944 * @epdrv: early_platform driver structure
13977091 945 * @buf: string passed from early_param()
4d26e139
MD
946 *
947 * Helper function for early_platform_init() / early_platform_init_buffer()
13977091
MD
948 */
949int __init early_platform_driver_register(struct early_platform_driver *epdrv,
950 char *buf)
951{
c60e0504 952 char *tmp;
13977091
MD
953 int n;
954
955 /* Simply add the driver to the end of the global list.
956 * Drivers will by default be put on the list in compiled-in order.
957 */
958 if (!epdrv->list.next) {
959 INIT_LIST_HEAD(&epdrv->list);
960 list_add_tail(&epdrv->list, &early_platform_driver_list);
961 }
962
963 /* If the user has specified device then make sure the driver
964 * gets prioritized. The driver of the last device specified on
965 * command line will be put first on the list.
966 */
967 n = strlen(epdrv->pdrv->driver.name);
968 if (buf && !strncmp(buf, epdrv->pdrv->driver.name, n)) {
969 list_move(&epdrv->list, &early_platform_driver_list);
970
c60e0504
MD
971 /* Allow passing parameters after device name */
972 if (buf[n] == '\0' || buf[n] == ',')
13977091 973 epdrv->requested_id = -1;
c60e0504
MD
974 else {
975 epdrv->requested_id = simple_strtoul(&buf[n + 1],
976 &tmp, 10);
977
978 if (buf[n] != '.' || (tmp == &buf[n + 1])) {
979 epdrv->requested_id = EARLY_PLATFORM_ID_ERROR;
980 n = 0;
981 } else
982 n += strcspn(&buf[n + 1], ",") + 1;
983 }
984
985 if (buf[n] == ',')
986 n++;
987
988 if (epdrv->bufsize) {
989 memcpy(epdrv->buffer, &buf[n],
990 min_t(int, epdrv->bufsize, strlen(&buf[n]) + 1));
991 epdrv->buffer[epdrv->bufsize - 1] = '\0';
992 }
13977091
MD
993 }
994
995 return 0;
996}
997
998/**
4d26e139 999 * early_platform_add_devices - adds a number of early platform devices
13977091
MD
1000 * @devs: array of early platform devices to add
1001 * @num: number of early platform devices in array
4d26e139
MD
1002 *
1003 * Used by early architecture code to register early platform devices and
1004 * their platform data.
13977091
MD
1005 */
1006void __init early_platform_add_devices(struct platform_device **devs, int num)
1007{
1008 struct device *dev;
1009 int i;
1010
1011 /* simply add the devices to list */
1012 for (i = 0; i < num; i++) {
1013 dev = &devs[i]->dev;
1014
1015 if (!dev->devres_head.next) {
bed2b42d 1016 pm_runtime_early_init(dev);
13977091
MD
1017 INIT_LIST_HEAD(&dev->devres_head);
1018 list_add_tail(&dev->devres_head,
1019 &early_platform_device_list);
1020 }
1021 }
1022}
1023
1024/**
4d26e139 1025 * early_platform_driver_register_all - register early platform drivers
13977091 1026 * @class_str: string to identify early platform driver class
4d26e139
MD
1027 *
1028 * Used by architecture code to register all early platform drivers
1029 * for a certain class. If omitted then only early platform drivers
1030 * with matching kernel command line class parameters will be registered.
13977091
MD
1031 */
1032void __init early_platform_driver_register_all(char *class_str)
1033{
1034 /* The "class_str" parameter may or may not be present on the kernel
1035 * command line. If it is present then there may be more than one
1036 * matching parameter.
1037 *
1038 * Since we register our early platform drivers using early_param()
1039 * we need to make sure that they also get registered in the case
1040 * when the parameter is missing from the kernel command line.
1041 *
1042 * We use parse_early_options() to make sure the early_param() gets
1043 * called at least once. The early_param() may be called more than
1044 * once since the name of the preferred device may be specified on
1045 * the kernel command line. early_platform_driver_register() handles
1046 * this case for us.
1047 */
1048 parse_early_options(class_str);
1049}
1050
1051/**
4d26e139 1052 * early_platform_match - find early platform device matching driver
d86c1302 1053 * @epdrv: early platform driver structure
13977091
MD
1054 * @id: id to match against
1055 */
1056static __init struct platform_device *
1057early_platform_match(struct early_platform_driver *epdrv, int id)
1058{
1059 struct platform_device *pd;
1060
1061 list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
1062 if (platform_match(&pd->dev, &epdrv->pdrv->driver))
1063 if (pd->id == id)
1064 return pd;
1065
1066 return NULL;
1067}
1068
1069/**
4d26e139 1070 * early_platform_left - check if early platform driver has matching devices
d86c1302 1071 * @epdrv: early platform driver structure
13977091
MD
1072 * @id: return true if id or above exists
1073 */
1074static __init int early_platform_left(struct early_platform_driver *epdrv,
1075 int id)
1076{
1077 struct platform_device *pd;
1078
1079 list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
1080 if (platform_match(&pd->dev, &epdrv->pdrv->driver))
1081 if (pd->id >= id)
1082 return 1;
1083
1084 return 0;
1085}
1086
1087/**
4d26e139 1088 * early_platform_driver_probe_id - probe drivers matching class_str and id
13977091
MD
1089 * @class_str: string to identify early platform driver class
1090 * @id: id to match against
1091 * @nr_probe: number of platform devices to successfully probe before exiting
1092 */
1093static int __init early_platform_driver_probe_id(char *class_str,
1094 int id,
1095 int nr_probe)
1096{
1097 struct early_platform_driver *epdrv;
1098 struct platform_device *match;
1099 int match_id;
1100 int n = 0;
1101 int left = 0;
1102
1103 list_for_each_entry(epdrv, &early_platform_driver_list, list) {
1104 /* only use drivers matching our class_str */
1105 if (strcmp(class_str, epdrv->class_str))
1106 continue;
1107
1108 if (id == -2) {
1109 match_id = epdrv->requested_id;
1110 left = 1;
1111
1112 } else {
1113 match_id = id;
1114 left += early_platform_left(epdrv, id);
1115
1116 /* skip requested id */
1117 switch (epdrv->requested_id) {
1118 case EARLY_PLATFORM_ID_ERROR:
1119 case EARLY_PLATFORM_ID_UNSET:
1120 break;
1121 default:
1122 if (epdrv->requested_id == id)
1123 match_id = EARLY_PLATFORM_ID_UNSET;
1124 }
1125 }
1126
1127 switch (match_id) {
1128 case EARLY_PLATFORM_ID_ERROR:
0258e182
FP
1129 pr_warn("%s: unable to parse %s parameter\n",
1130 class_str, epdrv->pdrv->driver.name);
13977091
MD
1131 /* fall-through */
1132 case EARLY_PLATFORM_ID_UNSET:
1133 match = NULL;
1134 break;
1135 default:
1136 match = early_platform_match(epdrv, match_id);
1137 }
1138
1139 if (match) {
a636ee7f
PM
1140 /*
1141 * Set up a sensible init_name to enable
1142 * dev_name() and others to be used before the
1143 * rest of the driver core is initialized.
1144 */
06fe53be 1145 if (!match->dev.init_name && slab_is_available()) {
a636ee7f 1146 if (match->id != -1)
bd05086b
PM
1147 match->dev.init_name =
1148 kasprintf(GFP_KERNEL, "%s.%d",
1149 match->name,
1150 match->id);
a636ee7f 1151 else
bd05086b
PM
1152 match->dev.init_name =
1153 kasprintf(GFP_KERNEL, "%s",
1154 match->name);
a636ee7f 1155
a636ee7f
PM
1156 if (!match->dev.init_name)
1157 return -ENOMEM;
1158 }
bd05086b 1159
13977091 1160 if (epdrv->pdrv->probe(match))
0258e182
FP
1161 pr_warn("%s: unable to probe %s early.\n",
1162 class_str, match->name);
13977091
MD
1163 else
1164 n++;
1165 }
1166
1167 if (n >= nr_probe)
1168 break;
1169 }
1170
1171 if (left)
1172 return n;
1173 else
1174 return -ENODEV;
1175}
1176
1177/**
4d26e139 1178 * early_platform_driver_probe - probe a class of registered drivers
13977091
MD
1179 * @class_str: string to identify early platform driver class
1180 * @nr_probe: number of platform devices to successfully probe before exiting
1181 * @user_only: only probe user specified early platform devices
4d26e139
MD
1182 *
1183 * Used by architecture code to probe registered early platform drivers
1184 * within a certain class. For probe to happen a registered early platform
1185 * device matching a registered early platform driver is needed.
13977091
MD
1186 */
1187int __init early_platform_driver_probe(char *class_str,
1188 int nr_probe,
1189 int user_only)
1190{
1191 int k, n, i;
1192
1193 n = 0;
1194 for (i = -2; n < nr_probe; i++) {
1195 k = early_platform_driver_probe_id(class_str, i, nr_probe - n);
1196
1197 if (k < 0)
1198 break;
1199
1200 n += k;
1201
1202 if (user_only)
1203 break;
1204 }
1205
1206 return n;
1207}
1208
1209/**
1210 * early_platform_cleanup - clean up early platform code
1211 */
1212void __init early_platform_cleanup(void)
1213{
1214 struct platform_device *pd, *pd2;
1215
1216 /* clean up the devres list used to chain devices */
1217 list_for_each_entry_safe(pd, pd2, &early_platform_device_list,
1218 dev.devres_head) {
1219 list_del(&pd->dev.devres_head);
1220 memset(&pd->dev.devres_head, 0, sizeof(pd->dev.devres_head));
1221 }
1222}
1223
This page took 0.968623 seconds and 5 git commands to generate.