regmap: Add bypassed version of regmap_multi_reg_write
[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;
7b199811 435 ACPI_COMPANION_SET(&pdev->dev, pdevinfo->acpi_node.companion);
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:
7b199811 466 ACPI_COMPANION_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
3f9120b0
JH
491 if (drv->prevent_deferred_probe && ret == -EPROBE_DEFER) {
492 dev_warn(_dev, "probe deferral not supported\n");
493 ret = -ENXIO;
494 }
495
94d76d5d 496 return ret;
00d3dcdd
RK
497}
498
c67334fb
DB
499static int platform_drv_probe_fail(struct device *_dev)
500{
501 return -ENXIO;
502}
503
00d3dcdd
RK
504static int platform_drv_remove(struct device *_dev)
505{
506 struct platform_driver *drv = to_platform_driver(_dev->driver);
507 struct platform_device *dev = to_platform_device(_dev);
94d76d5d 508 int ret;
00d3dcdd 509
94d76d5d
RW
510 ret = drv->remove(dev);
511 if (ACPI_HANDLE(_dev))
512 acpi_dev_pm_detach(_dev, true);
513
514 return ret;
00d3dcdd
RK
515}
516
517static void platform_drv_shutdown(struct device *_dev)
518{
519 struct platform_driver *drv = to_platform_driver(_dev->driver);
520 struct platform_device *dev = to_platform_device(_dev);
521
522 drv->shutdown(dev);
94d76d5d
RW
523 if (ACPI_HANDLE(_dev))
524 acpi_dev_pm_detach(_dev, true);
00d3dcdd
RK
525}
526
00d3dcdd 527/**
9447057e 528 * __platform_driver_register - register a driver for platform-level devices
4a3ad20c 529 * @drv: platform driver structure
08801f96 530 * @owner: owning module/driver
00d3dcdd 531 */
9447057e
LC
532int __platform_driver_register(struct platform_driver *drv,
533 struct module *owner)
00d3dcdd 534{
9447057e 535 drv->driver.owner = owner;
00d3dcdd
RK
536 drv->driver.bus = &platform_bus_type;
537 if (drv->probe)
538 drv->driver.probe = platform_drv_probe;
539 if (drv->remove)
540 drv->driver.remove = platform_drv_remove;
541 if (drv->shutdown)
542 drv->driver.shutdown = platform_drv_shutdown;
783ea7d4 543
00d3dcdd
RK
544 return driver_register(&drv->driver);
545}
9447057e 546EXPORT_SYMBOL_GPL(__platform_driver_register);
00d3dcdd
RK
547
548/**
3c31f07a 549 * platform_driver_unregister - unregister a driver for platform-level devices
4a3ad20c 550 * @drv: platform driver structure
00d3dcdd
RK
551 */
552void platform_driver_unregister(struct platform_driver *drv)
553{
554 driver_unregister(&drv->driver);
555}
556EXPORT_SYMBOL_GPL(platform_driver_unregister);
557
c67334fb
DB
558/**
559 * platform_driver_probe - register driver for non-hotpluggable device
560 * @drv: platform driver structure
3f9120b0 561 * @probe: the driver probe routine, probably from an __init section
c67334fb
DB
562 *
563 * Use this instead of platform_driver_register() when you know the device
564 * is not hotpluggable and has already been registered, and you want to
565 * remove its run-once probe() infrastructure from memory after the driver
566 * has bound to the device.
567 *
568 * One typical use for this would be with drivers for controllers integrated
569 * into system-on-chip processors, where the controller devices have been
570 * configured as part of board setup.
571 *
3f9120b0 572 * Note that this is incompatible with deferred probing.
647c86d0 573 *
c67334fb
DB
574 * Returns zero if the driver registered and bound to a device, else returns
575 * a negative error code and with the driver not registered.
576 */
c63e0783 577int __init_or_module platform_driver_probe(struct platform_driver *drv,
c67334fb
DB
578 int (*probe)(struct platform_device *))
579{
580 int retval, code;
581
3f9120b0
JH
582 /*
583 * Prevent driver from requesting probe deferral to avoid further
584 * futile probe attempts.
585 */
586 drv->prevent_deferred_probe = true;
587
1a6f2a75
DT
588 /* make sure driver won't have bind/unbind attributes */
589 drv->driver.suppress_bind_attrs = true;
590
c67334fb
DB
591 /* temporary section violation during probe() */
592 drv->probe = probe;
593 retval = code = platform_driver_register(drv);
594
1a6f2a75
DT
595 /*
596 * Fixup that section violation, being paranoid about code scanning
c67334fb
DB
597 * the list of drivers in order to probe new devices. Check to see
598 * if the probe was successful, and make sure any forced probes of
599 * new devices fail.
600 */
d79d3244 601 spin_lock(&drv->driver.bus->p->klist_drivers.k_lock);
c67334fb 602 drv->probe = NULL;
e5dd1278 603 if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list))
c67334fb
DB
604 retval = -ENODEV;
605 drv->driver.probe = platform_drv_probe_fail;
d79d3244 606 spin_unlock(&drv->driver.bus->p->klist_drivers.k_lock);
c67334fb
DB
607
608 if (code != retval)
609 platform_driver_unregister(drv);
610 return retval;
611}
612EXPORT_SYMBOL_GPL(platform_driver_probe);
1da177e4 613
ecdf6ceb
DT
614/**
615 * platform_create_bundle - register driver and create corresponding device
616 * @driver: platform driver structure
617 * @probe: the driver probe routine, probably from an __init section
618 * @res: set of resources that needs to be allocated for the device
619 * @n_res: number of resources
620 * @data: platform specific data for this platform device
621 * @size: size of platform specific data
622 *
623 * Use this in legacy-style modules that probe hardware directly and
624 * register a single platform device and corresponding platform driver.
f0eae0ed
JN
625 *
626 * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
ecdf6ceb
DT
627 */
628struct platform_device * __init_or_module platform_create_bundle(
629 struct platform_driver *driver,
630 int (*probe)(struct platform_device *),
631 struct resource *res, unsigned int n_res,
632 const void *data, size_t size)
633{
634 struct platform_device *pdev;
635 int error;
636
637 pdev = platform_device_alloc(driver->driver.name, -1);
638 if (!pdev) {
639 error = -ENOMEM;
640 goto err_out;
641 }
642
807508c8
AV
643 error = platform_device_add_resources(pdev, res, n_res);
644 if (error)
645 goto err_pdev_put;
ecdf6ceb 646
807508c8
AV
647 error = platform_device_add_data(pdev, data, size);
648 if (error)
649 goto err_pdev_put;
ecdf6ceb
DT
650
651 error = platform_device_add(pdev);
652 if (error)
653 goto err_pdev_put;
654
655 error = platform_driver_probe(driver, probe);
656 if (error)
657 goto err_pdev_del;
658
659 return pdev;
660
661err_pdev_del:
662 platform_device_del(pdev);
663err_pdev_put:
664 platform_device_put(pdev);
665err_out:
666 return ERR_PTR(error);
667}
668EXPORT_SYMBOL_GPL(platform_create_bundle);
669
a0245f7a
DB
670/* modalias support enables more hands-off userspace setup:
671 * (a) environment variable lets new-style hotplug events work once system is
672 * fully running: "modprobe $MODALIAS"
673 * (b) sysfs attribute lets new-style coldplug recover from hotplug events
674 * mishandled before system is fully running: "modprobe $(cat modalias)"
675 */
4a3ad20c
GKH
676static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
677 char *buf)
a0245f7a
DB
678{
679 struct platform_device *pdev = to_platform_device(dev);
8c4ff6d0
ZR
680 int len;
681
b9f73067
ZR
682 len = of_device_get_modalias(dev, buf, PAGE_SIZE -1);
683 if (len != -ENODEV)
684 return len;
685
8c4ff6d0
ZR
686 len = acpi_device_modalias(dev, buf, PAGE_SIZE -1);
687 if (len != -ENODEV)
688 return len;
689
690 len = snprintf(buf, PAGE_SIZE, "platform:%s\n", pdev->name);
a0245f7a
DB
691
692 return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
693}
d06262e5 694static DEVICE_ATTR_RO(modalias);
a0245f7a 695
d06262e5
GKH
696static struct attribute *platform_dev_attrs[] = {
697 &dev_attr_modalias.attr,
698 NULL,
a0245f7a 699};
d06262e5 700ATTRIBUTE_GROUPS(platform_dev);
a0245f7a 701
7eff2e7a 702static int platform_uevent(struct device *dev, struct kobj_uevent_env *env)
a0245f7a
DB
703{
704 struct platform_device *pdev = to_platform_device(dev);
eca39301
GL
705 int rc;
706
707 /* Some devices have extra OF data and an OF-style MODALIAS */
0258e182 708 rc = of_device_uevent_modalias(dev, env);
eca39301
GL
709 if (rc != -ENODEV)
710 return rc;
a0245f7a 711
8c4ff6d0
ZR
712 rc = acpi_device_uevent_modalias(dev, env);
713 if (rc != -ENODEV)
714 return rc;
715
57fee4a5 716 add_uevent_var(env, "MODALIAS=%s%s", PLATFORM_MODULE_PREFIX,
0a26813c 717 pdev->name);
a0245f7a
DB
718 return 0;
719}
720
57fee4a5 721static const struct platform_device_id *platform_match_id(
831fad2f 722 const struct platform_device_id *id,
57fee4a5
EM
723 struct platform_device *pdev)
724{
725 while (id->name[0]) {
726 if (strcmp(pdev->name, id->name) == 0) {
727 pdev->id_entry = id;
728 return id;
729 }
730 id++;
731 }
732 return NULL;
733}
734
1da177e4 735/**
4a3ad20c
GKH
736 * platform_match - bind platform device to platform driver.
737 * @dev: device.
738 * @drv: driver.
1da177e4 739 *
4a3ad20c
GKH
740 * Platform device IDs are assumed to be encoded like this:
741 * "<name><instance>", where <name> is a short description of the type of
742 * device, like "pci" or "floppy", and <instance> is the enumerated
743 * instance of the device, like '0' or '42'. Driver IDs are simply
744 * "<name>". So, extract the <name> from the platform_device structure,
745 * and compare it against the name of the driver. Return whether they match
746 * or not.
1da177e4 747 */
4a3ad20c 748static int platform_match(struct device *dev, struct device_driver *drv)
1da177e4 749{
71b3e0c1 750 struct platform_device *pdev = to_platform_device(dev);
57fee4a5
EM
751 struct platform_driver *pdrv = to_platform_driver(drv);
752
05212157
GL
753 /* Attempt an OF style match first */
754 if (of_driver_match_device(dev, drv))
755 return 1;
756
91e56878
MW
757 /* Then try ACPI style match */
758 if (acpi_driver_match_device(dev, drv))
759 return 1;
760
05212157 761 /* Then try to match against the id table */
57fee4a5
EM
762 if (pdrv->id_table)
763 return platform_match_id(pdrv->id_table, pdev) != NULL;
1da177e4 764
57fee4a5 765 /* fall-back to driver name match */
1e0b2cf9 766 return (strcmp(pdev->name, drv->name) == 0);
1da177e4
LT
767}
768
25e18499
RW
769#ifdef CONFIG_PM_SLEEP
770
771static int platform_legacy_suspend(struct device *dev, pm_message_t mesg)
1da177e4 772{
783ea7d4
MD
773 struct platform_driver *pdrv = to_platform_driver(dev->driver);
774 struct platform_device *pdev = to_platform_device(dev);
1da177e4
LT
775 int ret = 0;
776
783ea7d4
MD
777 if (dev->driver && pdrv->suspend)
778 ret = pdrv->suspend(pdev, mesg);
386415d8
DB
779
780 return ret;
781}
782
25e18499 783static int platform_legacy_resume(struct device *dev)
1da177e4 784{
783ea7d4
MD
785 struct platform_driver *pdrv = to_platform_driver(dev->driver);
786 struct platform_device *pdev = to_platform_device(dev);
1da177e4
LT
787 int ret = 0;
788
783ea7d4
MD
789 if (dev->driver && pdrv->resume)
790 ret = pdrv->resume(pdev);
9480e307 791
1da177e4
LT
792 return ret;
793}
794
69c9dd1e 795#endif /* CONFIG_PM_SLEEP */
9d730229 796
25e18499
RW
797#ifdef CONFIG_SUSPEND
798
69c9dd1e 799int platform_pm_suspend(struct device *dev)
25e18499
RW
800{
801 struct device_driver *drv = dev->driver;
802 int ret = 0;
803
adf09493
RW
804 if (!drv)
805 return 0;
806
807 if (drv->pm) {
25e18499
RW
808 if (drv->pm->suspend)
809 ret = drv->pm->suspend(dev);
810 } else {
811 ret = platform_legacy_suspend(dev, PMSG_SUSPEND);
812 }
813
814 return ret;
815}
816
69c9dd1e 817int platform_pm_resume(struct device *dev)
25e18499
RW
818{
819 struct device_driver *drv = dev->driver;
820 int ret = 0;
821
adf09493
RW
822 if (!drv)
823 return 0;
824
825 if (drv->pm) {
25e18499
RW
826 if (drv->pm->resume)
827 ret = drv->pm->resume(dev);
828 } else {
829 ret = platform_legacy_resume(dev);
830 }
831
832 return ret;
833}
834
69c9dd1e 835#endif /* CONFIG_SUSPEND */
25e18499 836
1f112cee 837#ifdef CONFIG_HIBERNATE_CALLBACKS
25e18499 838
69c9dd1e 839int platform_pm_freeze(struct device *dev)
25e18499
RW
840{
841 struct device_driver *drv = dev->driver;
842 int ret = 0;
843
844 if (!drv)
845 return 0;
846
847 if (drv->pm) {
848 if (drv->pm->freeze)
849 ret = drv->pm->freeze(dev);
850 } else {
851 ret = platform_legacy_suspend(dev, PMSG_FREEZE);
852 }
853
854 return ret;
855}
856
69c9dd1e 857int platform_pm_thaw(struct device *dev)
25e18499
RW
858{
859 struct device_driver *drv = dev->driver;
860 int ret = 0;
861
adf09493
RW
862 if (!drv)
863 return 0;
864
865 if (drv->pm) {
25e18499
RW
866 if (drv->pm->thaw)
867 ret = drv->pm->thaw(dev);
868 } else {
869 ret = platform_legacy_resume(dev);
870 }
871
872 return ret;
873}
874
69c9dd1e 875int platform_pm_poweroff(struct device *dev)
25e18499
RW
876{
877 struct device_driver *drv = dev->driver;
878 int ret = 0;
879
adf09493
RW
880 if (!drv)
881 return 0;
882
883 if (drv->pm) {
25e18499
RW
884 if (drv->pm->poweroff)
885 ret = drv->pm->poweroff(dev);
886 } else {
887 ret = platform_legacy_suspend(dev, PMSG_HIBERNATE);
888 }
889
890 return ret;
891}
892
69c9dd1e 893int platform_pm_restore(struct device *dev)
25e18499
RW
894{
895 struct device_driver *drv = dev->driver;
896 int ret = 0;
897
adf09493
RW
898 if (!drv)
899 return 0;
900
901 if (drv->pm) {
25e18499
RW
902 if (drv->pm->restore)
903 ret = drv->pm->restore(dev);
904 } else {
905 ret = platform_legacy_resume(dev);
906 }
907
908 return ret;
909}
910
69c9dd1e 911#endif /* CONFIG_HIBERNATE_CALLBACKS */
25e18499 912
d9ab7716 913static const struct dev_pm_ops platform_dev_pm_ops = {
8b313a38
RW
914 .runtime_suspend = pm_generic_runtime_suspend,
915 .runtime_resume = pm_generic_runtime_resume,
69c9dd1e 916 USE_PLATFORM_PM_SLEEP_OPS
25e18499
RW
917};
918
1da177e4
LT
919struct bus_type platform_bus_type = {
920 .name = "platform",
d06262e5 921 .dev_groups = platform_dev_groups,
1da177e4 922 .match = platform_match,
a0245f7a 923 .uevent = platform_uevent,
9d730229 924 .pm = &platform_dev_pm_ops,
1da177e4 925};
a96b2042 926EXPORT_SYMBOL_GPL(platform_bus_type);
1da177e4
LT
927
928int __init platform_bus_init(void)
929{
fbfb1445
CH
930 int error;
931
13977091
MD
932 early_platform_cleanup();
933
fbfb1445
CH
934 error = device_register(&platform_bus);
935 if (error)
936 return error;
937 error = bus_register(&platform_bus_type);
938 if (error)
939 device_unregister(&platform_bus);
940 return error;
1da177e4
LT
941}
942
943#ifndef ARCH_HAS_DMA_GET_REQUIRED_MASK
944u64 dma_get_required_mask(struct device *dev)
945{
946 u32 low_totalram = ((max_pfn - 1) << PAGE_SHIFT);
947 u32 high_totalram = ((max_pfn - 1) >> (32 - PAGE_SHIFT));
948 u64 mask;
949
950 if (!high_totalram) {
951 /* convert to mask just covering totalram */
952 low_totalram = (1 << (fls(low_totalram) - 1));
953 low_totalram += low_totalram - 1;
954 mask = low_totalram;
955 } else {
956 high_totalram = (1 << (fls(high_totalram) - 1));
957 high_totalram += high_totalram - 1;
958 mask = (((u64)high_totalram) << 32) + 0xffffffff;
959 }
e88a0c2c 960 return mask;
1da177e4
LT
961}
962EXPORT_SYMBOL_GPL(dma_get_required_mask);
963#endif
13977091
MD
964
965static __initdata LIST_HEAD(early_platform_driver_list);
966static __initdata LIST_HEAD(early_platform_device_list);
967
968/**
4d26e139 969 * early_platform_driver_register - register early platform driver
d86c1302 970 * @epdrv: early_platform driver structure
13977091 971 * @buf: string passed from early_param()
4d26e139
MD
972 *
973 * Helper function for early_platform_init() / early_platform_init_buffer()
13977091
MD
974 */
975int __init early_platform_driver_register(struct early_platform_driver *epdrv,
976 char *buf)
977{
c60e0504 978 char *tmp;
13977091
MD
979 int n;
980
981 /* Simply add the driver to the end of the global list.
982 * Drivers will by default be put on the list in compiled-in order.
983 */
984 if (!epdrv->list.next) {
985 INIT_LIST_HEAD(&epdrv->list);
986 list_add_tail(&epdrv->list, &early_platform_driver_list);
987 }
988
989 /* If the user has specified device then make sure the driver
990 * gets prioritized. The driver of the last device specified on
991 * command line will be put first on the list.
992 */
993 n = strlen(epdrv->pdrv->driver.name);
994 if (buf && !strncmp(buf, epdrv->pdrv->driver.name, n)) {
995 list_move(&epdrv->list, &early_platform_driver_list);
996
c60e0504
MD
997 /* Allow passing parameters after device name */
998 if (buf[n] == '\0' || buf[n] == ',')
13977091 999 epdrv->requested_id = -1;
c60e0504
MD
1000 else {
1001 epdrv->requested_id = simple_strtoul(&buf[n + 1],
1002 &tmp, 10);
1003
1004 if (buf[n] != '.' || (tmp == &buf[n + 1])) {
1005 epdrv->requested_id = EARLY_PLATFORM_ID_ERROR;
1006 n = 0;
1007 } else
1008 n += strcspn(&buf[n + 1], ",") + 1;
1009 }
1010
1011 if (buf[n] == ',')
1012 n++;
1013
1014 if (epdrv->bufsize) {
1015 memcpy(epdrv->buffer, &buf[n],
1016 min_t(int, epdrv->bufsize, strlen(&buf[n]) + 1));
1017 epdrv->buffer[epdrv->bufsize - 1] = '\0';
1018 }
13977091
MD
1019 }
1020
1021 return 0;
1022}
1023
1024/**
4d26e139 1025 * early_platform_add_devices - adds a number of early platform devices
13977091
MD
1026 * @devs: array of early platform devices to add
1027 * @num: number of early platform devices in array
4d26e139
MD
1028 *
1029 * Used by early architecture code to register early platform devices and
1030 * their platform data.
13977091
MD
1031 */
1032void __init early_platform_add_devices(struct platform_device **devs, int num)
1033{
1034 struct device *dev;
1035 int i;
1036
1037 /* simply add the devices to list */
1038 for (i = 0; i < num; i++) {
1039 dev = &devs[i]->dev;
1040
1041 if (!dev->devres_head.next) {
bed2b42d 1042 pm_runtime_early_init(dev);
13977091
MD
1043 INIT_LIST_HEAD(&dev->devres_head);
1044 list_add_tail(&dev->devres_head,
1045 &early_platform_device_list);
1046 }
1047 }
1048}
1049
1050/**
4d26e139 1051 * early_platform_driver_register_all - register early platform drivers
13977091 1052 * @class_str: string to identify early platform driver class
4d26e139
MD
1053 *
1054 * Used by architecture code to register all early platform drivers
1055 * for a certain class. If omitted then only early platform drivers
1056 * with matching kernel command line class parameters will be registered.
13977091
MD
1057 */
1058void __init early_platform_driver_register_all(char *class_str)
1059{
1060 /* The "class_str" parameter may or may not be present on the kernel
1061 * command line. If it is present then there may be more than one
1062 * matching parameter.
1063 *
1064 * Since we register our early platform drivers using early_param()
1065 * we need to make sure that they also get registered in the case
1066 * when the parameter is missing from the kernel command line.
1067 *
1068 * We use parse_early_options() to make sure the early_param() gets
1069 * called at least once. The early_param() may be called more than
1070 * once since the name of the preferred device may be specified on
1071 * the kernel command line. early_platform_driver_register() handles
1072 * this case for us.
1073 */
1074 parse_early_options(class_str);
1075}
1076
1077/**
4d26e139 1078 * early_platform_match - find early platform device matching driver
d86c1302 1079 * @epdrv: early platform driver structure
13977091
MD
1080 * @id: id to match against
1081 */
a8257910 1082static struct platform_device * __init
13977091
MD
1083early_platform_match(struct early_platform_driver *epdrv, int id)
1084{
1085 struct platform_device *pd;
1086
1087 list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
1088 if (platform_match(&pd->dev, &epdrv->pdrv->driver))
1089 if (pd->id == id)
1090 return pd;
1091
1092 return NULL;
1093}
1094
1095/**
4d26e139 1096 * early_platform_left - check if early platform driver has matching devices
d86c1302 1097 * @epdrv: early platform driver structure
13977091
MD
1098 * @id: return true if id or above exists
1099 */
a8257910 1100static int __init early_platform_left(struct early_platform_driver *epdrv,
13977091
MD
1101 int id)
1102{
1103 struct platform_device *pd;
1104
1105 list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
1106 if (platform_match(&pd->dev, &epdrv->pdrv->driver))
1107 if (pd->id >= id)
1108 return 1;
1109
1110 return 0;
1111}
1112
1113/**
4d26e139 1114 * early_platform_driver_probe_id - probe drivers matching class_str and id
13977091
MD
1115 * @class_str: string to identify early platform driver class
1116 * @id: id to match against
1117 * @nr_probe: number of platform devices to successfully probe before exiting
1118 */
1119static int __init early_platform_driver_probe_id(char *class_str,
1120 int id,
1121 int nr_probe)
1122{
1123 struct early_platform_driver *epdrv;
1124 struct platform_device *match;
1125 int match_id;
1126 int n = 0;
1127 int left = 0;
1128
1129 list_for_each_entry(epdrv, &early_platform_driver_list, list) {
1130 /* only use drivers matching our class_str */
1131 if (strcmp(class_str, epdrv->class_str))
1132 continue;
1133
1134 if (id == -2) {
1135 match_id = epdrv->requested_id;
1136 left = 1;
1137
1138 } else {
1139 match_id = id;
1140 left += early_platform_left(epdrv, id);
1141
1142 /* skip requested id */
1143 switch (epdrv->requested_id) {
1144 case EARLY_PLATFORM_ID_ERROR:
1145 case EARLY_PLATFORM_ID_UNSET:
1146 break;
1147 default:
1148 if (epdrv->requested_id == id)
1149 match_id = EARLY_PLATFORM_ID_UNSET;
1150 }
1151 }
1152
1153 switch (match_id) {
1154 case EARLY_PLATFORM_ID_ERROR:
0258e182
FP
1155 pr_warn("%s: unable to parse %s parameter\n",
1156 class_str, epdrv->pdrv->driver.name);
13977091
MD
1157 /* fall-through */
1158 case EARLY_PLATFORM_ID_UNSET:
1159 match = NULL;
1160 break;
1161 default:
1162 match = early_platform_match(epdrv, match_id);
1163 }
1164
1165 if (match) {
a636ee7f
PM
1166 /*
1167 * Set up a sensible init_name to enable
1168 * dev_name() and others to be used before the
1169 * rest of the driver core is initialized.
1170 */
06fe53be 1171 if (!match->dev.init_name && slab_is_available()) {
a636ee7f 1172 if (match->id != -1)
bd05086b
PM
1173 match->dev.init_name =
1174 kasprintf(GFP_KERNEL, "%s.%d",
1175 match->name,
1176 match->id);
a636ee7f 1177 else
bd05086b
PM
1178 match->dev.init_name =
1179 kasprintf(GFP_KERNEL, "%s",
1180 match->name);
a636ee7f 1181
a636ee7f
PM
1182 if (!match->dev.init_name)
1183 return -ENOMEM;
1184 }
bd05086b 1185
13977091 1186 if (epdrv->pdrv->probe(match))
0258e182
FP
1187 pr_warn("%s: unable to probe %s early.\n",
1188 class_str, match->name);
13977091
MD
1189 else
1190 n++;
1191 }
1192
1193 if (n >= nr_probe)
1194 break;
1195 }
1196
1197 if (left)
1198 return n;
1199 else
1200 return -ENODEV;
1201}
1202
1203/**
4d26e139 1204 * early_platform_driver_probe - probe a class of registered drivers
13977091
MD
1205 * @class_str: string to identify early platform driver class
1206 * @nr_probe: number of platform devices to successfully probe before exiting
1207 * @user_only: only probe user specified early platform devices
4d26e139
MD
1208 *
1209 * Used by architecture code to probe registered early platform drivers
1210 * within a certain class. For probe to happen a registered early platform
1211 * device matching a registered early platform driver is needed.
13977091
MD
1212 */
1213int __init early_platform_driver_probe(char *class_str,
1214 int nr_probe,
1215 int user_only)
1216{
1217 int k, n, i;
1218
1219 n = 0;
1220 for (i = -2; n < nr_probe; i++) {
1221 k = early_platform_driver_probe_id(class_str, i, nr_probe - n);
1222
1223 if (k < 0)
1224 break;
1225
1226 n += k;
1227
1228 if (user_only)
1229 break;
1230 }
1231
1232 return n;
1233}
1234
1235/**
1236 * early_platform_cleanup - clean up early platform code
1237 */
1238void __init early_platform_cleanup(void)
1239{
1240 struct platform_device *pd, *pd2;
1241
1242 /* clean up the devres list used to chain devices */
1243 list_for_each_entry_safe(pd, pd2, &early_platform_device_list,
1244 dev.devres_head) {
1245 list_del(&pd->dev.devres_head);
1246 memset(&pd->dev.devres_head, 0, sizeof(pd->dev.devres_head));
1247 }
1248}
1249
This page took 1.061455 seconds and 5 git commands to generate.