platform.c 29.2 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12
/*
 * platform.c - platform 'pseudo' bus for legacy devices
 *
 * Copyright (c) 2002-3 Patrick Mochel
 * Copyright (c) 2002-3 Open Source Development Labs
 *
 * This file is released under the GPLv2
 *
 * Please see Documentation/driver-model/platform.txt for more
 * information.
 */

13
#include <linux/platform_device.h>
L
Linus Torvalds 已提交
14 15 16 17 18
#include <linux/module.h>
#include <linux/init.h>
#include <linux/dma-mapping.h>
#include <linux/bootmem.h>
#include <linux/err.h>
T
Tim Schmielau 已提交
19
#include <linux/slab.h>
L
Linus Torvalds 已提交
20

21 22
#include "base.h"

23 24
#define to_platform_driver(drv)	(container_of((drv), struct platform_driver, \
				 driver))
R
Russell King 已提交
25

L
Linus Torvalds 已提交
26
struct device platform_bus = {
27
	.init_name	= "platform",
L
Linus Torvalds 已提交
28
};
29
EXPORT_SYMBOL_GPL(platform_bus);
L
Linus Torvalds 已提交
30 31

/**
32 33 34 35
 * platform_get_resource - get a resource for a device
 * @dev: platform device
 * @type: resource type
 * @num: resource index
L
Linus Torvalds 已提交
36
 */
37 38
struct resource *platform_get_resource(struct platform_device *dev,
				       unsigned int type, unsigned int num)
L
Linus Torvalds 已提交
39 40 41 42 43 44
{
	int i;

	for (i = 0; i < dev->num_resources; i++) {
		struct resource *r = &dev->resource[i];

45 46
		if (type == resource_type(r) && num-- == 0)
			return r;
L
Linus Torvalds 已提交
47 48 49
	}
	return NULL;
}
50
EXPORT_SYMBOL_GPL(platform_get_resource);
L
Linus Torvalds 已提交
51 52

/**
53 54 55
 * platform_get_irq - get an IRQ for a device
 * @dev: platform device
 * @num: IRQ number index
L
Linus Torvalds 已提交
56 57 58 59 60
 */
int platform_get_irq(struct platform_device *dev, unsigned int num)
{
	struct resource *r = platform_get_resource(dev, IORESOURCE_IRQ, num);

61
	return r ? r->start : -ENXIO;
L
Linus Torvalds 已提交
62
}
63
EXPORT_SYMBOL_GPL(platform_get_irq);
L
Linus Torvalds 已提交
64 65

/**
66 67 68 69
 * platform_get_resource_byname - get a resource for a device by name
 * @dev: platform device
 * @type: resource type
 * @name: resource name
L
Linus Torvalds 已提交
70
 */
71
struct resource *platform_get_resource_byname(struct platform_device *dev,
72 73
					      unsigned int type,
					      const char *name)
L
Linus Torvalds 已提交
74 75 76 77 78 79
{
	int i;

	for (i = 0; i < dev->num_resources; i++) {
		struct resource *r = &dev->resource[i];

80 81
		if (type == resource_type(r) && !strcmp(r->name, name))
			return r;
L
Linus Torvalds 已提交
82 83 84
	}
	return NULL;
}
85
EXPORT_SYMBOL_GPL(platform_get_resource_byname);
L
Linus Torvalds 已提交
86 87

/**
88 89 90
 * platform_get_irq - get an IRQ for a device
 * @dev: platform device
 * @name: IRQ name
L
Linus Torvalds 已提交
91
 */
92
int platform_get_irq_byname(struct platform_device *dev, const char *name)
L
Linus Torvalds 已提交
93
{
94 95
	struct resource *r = platform_get_resource_byname(dev, IORESOURCE_IRQ,
							  name);
L
Linus Torvalds 已提交
96

97
	return r ? r->start : -ENXIO;
L
Linus Torvalds 已提交
98
}
99
EXPORT_SYMBOL_GPL(platform_get_irq_byname);
L
Linus Torvalds 已提交
100 101

/**
102 103 104
 * platform_add_devices - add a numbers of platform devices
 * @devs: array of platform devices to add
 * @num: number of platform devices in array
L
Linus Torvalds 已提交
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
 */
int platform_add_devices(struct platform_device **devs, int num)
{
	int i, ret = 0;

	for (i = 0; i < num; i++) {
		ret = platform_device_register(devs[i]);
		if (ret) {
			while (--i >= 0)
				platform_device_unregister(devs[i]);
			break;
		}
	}

	return ret;
}
121
EXPORT_SYMBOL_GPL(platform_add_devices);
L
Linus Torvalds 已提交
122

123 124 125 126 127
struct platform_object {
	struct platform_device pdev;
	char name[1];
};

L
Linus Torvalds 已提交
128
/**
129 130
 * platform_device_put
 * @pdev: platform device to free
131
 *
132 133
 * Free all memory associated with a platform device.  This function must
 * _only_ be externally called in error cases.  All other usage is a bug.
134 135 136 137 138 139 140 141 142 143
 */
void platform_device_put(struct platform_device *pdev)
{
	if (pdev)
		put_device(&pdev->dev);
}
EXPORT_SYMBOL_GPL(platform_device_put);

static void platform_device_release(struct device *dev)
{
144 145
	struct platform_object *pa = container_of(dev, struct platform_object,
						  pdev.dev);
146 147 148 149 150 151 152

	kfree(pa->pdev.dev.platform_data);
	kfree(pa->pdev.resource);
	kfree(pa);
}

/**
153 154 155
 * platform_device_alloc
 * @name: base name of the device we're adding
 * @id: instance id
156
 *
157 158
 * Create a platform device object which can have other objects attached
 * to it, and which will have attached objects freed when it is released.
159
 */
160
struct platform_device *platform_device_alloc(const char *name, int id)
161 162 163 164 165 166 167 168 169 170 171 172
{
	struct platform_object *pa;

	pa = kzalloc(sizeof(struct platform_object) + strlen(name), GFP_KERNEL);
	if (pa) {
		strcpy(pa->name, name);
		pa->pdev.name = pa->name;
		pa->pdev.id = id;
		device_initialize(&pa->pdev.dev);
		pa->pdev.dev.release = platform_device_release;
	}

173
	return pa ? &pa->pdev : NULL;
174 175 176 177
}
EXPORT_SYMBOL_GPL(platform_device_alloc);

/**
178 179 180 181
 * platform_device_add_resources
 * @pdev: platform device allocated by platform_device_alloc to add resources to
 * @res: set of resources that needs to be allocated for the device
 * @num: number of resources
182
 *
183 184 185
 * Add a copy of the resources to the platform device.  The memory
 * associated with the resources will be freed when the platform device is
 * released.
186
 */
187 188
int platform_device_add_resources(struct platform_device *pdev,
				  struct resource *res, unsigned int num)
189 190 191 192 193 194 195 196 197 198 199 200 201 202
{
	struct resource *r;

	r = kmalloc(sizeof(struct resource) * num, GFP_KERNEL);
	if (r) {
		memcpy(r, res, sizeof(struct resource) * num);
		pdev->resource = r;
		pdev->num_resources = num;
	}
	return r ? 0 : -ENOMEM;
}
EXPORT_SYMBOL_GPL(platform_device_add_resources);

/**
203 204 205 206
 * platform_device_add_data
 * @pdev: platform device allocated by platform_device_alloc to add resources to
 * @data: platform specific data for this platform device
 * @size: size of platform specific data
207
 *
208 209 210
 * Add a copy of platform specific data to the platform device's
 * platform_data pointer.  The memory associated with the platform data
 * will be freed when the platform device is released.
211
 */
212 213
int platform_device_add_data(struct platform_device *pdev, const void *data,
			     size_t size)
214 215 216 217 218 219 220 221 222 223 224 225 226
{
	void *d;

	d = kmalloc(size, GFP_KERNEL);
	if (d) {
		memcpy(d, data, size);
		pdev->dev.platform_data = d;
	}
	return d ? 0 : -ENOMEM;
}
EXPORT_SYMBOL_GPL(platform_device_add_data);

/**
227 228
 * platform_device_add - add a platform device to device hierarchy
 * @pdev: platform device we're adding
L
Linus Torvalds 已提交
229
 *
230 231
 * This is part 2 of platform_device_register(), though may be called
 * separately _iff_ pdev was allocated by platform_device_alloc().
L
Linus Torvalds 已提交
232
 */
233
int platform_device_add(struct platform_device *pdev)
L
Linus Torvalds 已提交
234 235 236 237 238 239 240 241 242 243 244 245
{
	int i, ret = 0;

	if (!pdev)
		return -EINVAL;

	if (!pdev->dev.parent)
		pdev->dev.parent = &platform_bus;

	pdev->dev.bus = &platform_bus_type;

	if (pdev->id != -1)
246
		dev_set_name(&pdev->dev, "%s.%d", pdev->name,  pdev->id);
L
Linus Torvalds 已提交
247
	else
248
		dev_set_name(&pdev->dev, "%s", pdev->name);
L
Linus Torvalds 已提交
249 250 251 252 253

	for (i = 0; i < pdev->num_resources; i++) {
		struct resource *p, *r = &pdev->resource[i];

		if (r->name == NULL)
254
			r->name = dev_name(&pdev->dev);
L
Linus Torvalds 已提交
255 256 257

		p = r->parent;
		if (!p) {
258
			if (resource_type(r) == IORESOURCE_MEM)
L
Linus Torvalds 已提交
259
				p = &iomem_resource;
260
			else if (resource_type(r) == IORESOURCE_IO)
L
Linus Torvalds 已提交
261 262 263
				p = &ioport_resource;
		}

264
		if (p && insert_resource(p, r)) {
L
Linus Torvalds 已提交
265 266
			printk(KERN_ERR
			       "%s: failed to claim resource %d\n",
267
			       dev_name(&pdev->dev), i);
L
Linus Torvalds 已提交
268 269 270 271 272 273
			ret = -EBUSY;
			goto failed;
		}
	}

	pr_debug("Registering platform device '%s'. Parent at %s\n",
274
		 dev_name(&pdev->dev), dev_name(pdev->dev.parent));
L
Linus Torvalds 已提交
275

276
	ret = device_add(&pdev->dev);
L
Linus Torvalds 已提交
277 278 279 280
	if (ret == 0)
		return ret;

 failed:
281 282 283 284 285 286 287 288
	while (--i >= 0) {
		struct resource *r = &pdev->resource[i];
		unsigned long type = resource_type(r);

		if (type == IORESOURCE_MEM || type == IORESOURCE_IO)
			release_resource(r);
	}

L
Linus Torvalds 已提交
289 290
	return ret;
}
291 292 293
EXPORT_SYMBOL_GPL(platform_device_add);

/**
294 295
 * platform_device_del - remove a platform-level device
 * @pdev: platform device we're removing
L
Linus Torvalds 已提交
296
 *
297 298 299
 * Note that this function will also release all memory- and port-based
 * resources owned by the device (@dev->resource).  This function must
 * _only_ be externally called in error cases.  All other usage is a bug.
L
Linus Torvalds 已提交
300
 */
301
void platform_device_del(struct platform_device *pdev)
L
Linus Torvalds 已提交
302 303 304 305
{
	int i;

	if (pdev) {
306 307
		device_del(&pdev->dev);

L
Linus Torvalds 已提交
308 309
		for (i = 0; i < pdev->num_resources; i++) {
			struct resource *r = &pdev->resource[i];
310 311 312
			unsigned long type = resource_type(r);

			if (type == IORESOURCE_MEM || type == IORESOURCE_IO)
L
Linus Torvalds 已提交
313 314 315 316
				release_resource(r);
		}
	}
}
317 318 319
EXPORT_SYMBOL_GPL(platform_device_del);

/**
320 321
 * platform_device_register - add a platform-level device
 * @pdev: platform device we're adding
322
 */
323
int platform_device_register(struct platform_device *pdev)
324 325 326 327
{
	device_initialize(&pdev->dev);
	return platform_device_add(pdev);
}
328
EXPORT_SYMBOL_GPL(platform_device_register);
329 330

/**
331 332
 * platform_device_unregister - unregister a platform-level device
 * @pdev: platform device we're unregistering
333
 *
334 335 336
 * Unregistration is done in 2 steps. First we release all resources
 * and remove it from the subsystem, then we drop reference count by
 * calling platform_device_put().
337
 */
338
void platform_device_unregister(struct platform_device *pdev)
339 340 341 342
{
	platform_device_del(pdev);
	platform_device_put(pdev);
}
343
EXPORT_SYMBOL_GPL(platform_device_unregister);
L
Linus Torvalds 已提交
344 345

/**
346 347 348 349 350
 * platform_device_register_simple
 * @name: base name of the device we're adding
 * @id: instance id
 * @res: set of resources that needs to be allocated for the device
 * @num: number of resources
L
Linus Torvalds 已提交
351
 *
352 353 354 355 356
 * This function creates a simple platform device that requires minimal
 * resource and memory management. Canned release function freeing memory
 * allocated for the device allows drivers using such devices to be
 * unloaded without waiting for the last reference to the device to be
 * dropped.
357
 *
358 359 360 361 362 363
 * This interface is primarily intended for use with legacy drivers which
 * probe hardware directly.  Because such drivers create sysfs device nodes
 * themselves, rather than letting system infrastructure handle such device
 * enumeration tasks, they don't fully conform to the Linux driver model.
 * In particular, when such drivers are built as modules, they can't be
 * "hotplugged".
L
Linus Torvalds 已提交
364
 */
365 366 367 368
struct platform_device *platform_device_register_simple(const char *name,
							int id,
							struct resource *res,
							unsigned int num)
L
Linus Torvalds 已提交
369
{
370
	struct platform_device *pdev;
L
Linus Torvalds 已提交
371 372
	int retval;

373 374
	pdev = platform_device_alloc(name, id);
	if (!pdev) {
L
Linus Torvalds 已提交
375 376 377 378 379
		retval = -ENOMEM;
		goto error;
	}

	if (num) {
380 381 382
		retval = platform_device_add_resources(pdev, res, num);
		if (retval)
			goto error;
L
Linus Torvalds 已提交
383 384
	}

385
	retval = platform_device_add(pdev);
L
Linus Torvalds 已提交
386 387 388
	if (retval)
		goto error;

389
	return pdev;
L
Linus Torvalds 已提交
390 391

error:
392
	platform_device_put(pdev);
L
Linus Torvalds 已提交
393 394
	return ERR_PTR(retval);
}
395
EXPORT_SYMBOL_GPL(platform_device_register_simple);
L
Linus Torvalds 已提交
396

397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443
/**
 * platform_device_register_data
 * @parent: parent device for the device we're adding
 * @name: base name of the device we're adding
 * @id: instance id
 * @data: platform specific data for this platform device
 * @size: size of platform specific data
 *
 * This function creates a simple platform device that requires minimal
 * resource and memory management. Canned release function freeing memory
 * allocated for the device allows drivers using such devices to be
 * unloaded without waiting for the last reference to the device to be
 * dropped.
 */
struct platform_device *platform_device_register_data(
		struct device *parent,
		const char *name, int id,
		const void *data, size_t size)
{
	struct platform_device *pdev;
	int retval;

	pdev = platform_device_alloc(name, id);
	if (!pdev) {
		retval = -ENOMEM;
		goto error;
	}

	pdev->dev.parent = parent;

	if (size) {
		retval = platform_device_add_data(pdev, data, size);
		if (retval)
			goto error;
	}

	retval = platform_device_add(pdev);
	if (retval)
		goto error;

	return pdev;

error:
	platform_device_put(pdev);
	return ERR_PTR(retval);
}

R
Russell King 已提交
444 445 446 447 448 449 450 451
static int platform_drv_probe(struct device *_dev)
{
	struct platform_driver *drv = to_platform_driver(_dev->driver);
	struct platform_device *dev = to_platform_device(_dev);

	return drv->probe(dev);
}

452 453 454 455 456
static int platform_drv_probe_fail(struct device *_dev)
{
	return -ENXIO;
}

R
Russell King 已提交
457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473
static int platform_drv_remove(struct device *_dev)
{
	struct platform_driver *drv = to_platform_driver(_dev->driver);
	struct platform_device *dev = to_platform_device(_dev);

	return drv->remove(dev);
}

static void platform_drv_shutdown(struct device *_dev)
{
	struct platform_driver *drv = to_platform_driver(_dev->driver);
	struct platform_device *dev = to_platform_device(_dev);

	drv->shutdown(dev);
}

/**
474 475
 * platform_driver_register
 * @drv: platform driver structure
R
Russell King 已提交
476 477 478 479 480 481 482 483 484 485
 */
int platform_driver_register(struct platform_driver *drv)
{
	drv->driver.bus = &platform_bus_type;
	if (drv->probe)
		drv->driver.probe = platform_drv_probe;
	if (drv->remove)
		drv->driver.remove = platform_drv_remove;
	if (drv->shutdown)
		drv->driver.shutdown = platform_drv_shutdown;
486 487 488 489
	if (drv->suspend || drv->resume)
		pr_warning("Platform driver '%s' needs updating - please use "
			"dev_pm_ops\n", drv->driver.name);

R
Russell King 已提交
490 491 492 493 494
	return driver_register(&drv->driver);
}
EXPORT_SYMBOL_GPL(platform_driver_register);

/**
495 496
 * platform_driver_unregister
 * @drv: platform driver structure
R
Russell King 已提交
497 498 499 500 501 502 503
 */
void platform_driver_unregister(struct platform_driver *drv)
{
	driver_unregister(&drv->driver);
}
EXPORT_SYMBOL_GPL(platform_driver_unregister);

504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520
/**
 * platform_driver_probe - register driver for non-hotpluggable device
 * @drv: platform driver structure
 * @probe: the driver probe routine, probably from an __init section
 *
 * Use this instead of platform_driver_register() when you know the device
 * is not hotpluggable and has already been registered, and you want to
 * remove its run-once probe() infrastructure from memory after the driver
 * has bound to the device.
 *
 * One typical use for this would be with drivers for controllers integrated
 * into system-on-chip processors, where the controller devices have been
 * configured as part of board setup.
 *
 * Returns zero if the driver registered and bound to a device, else returns
 * a negative error code and with the driver not registered.
 */
521
int __init_or_module platform_driver_probe(struct platform_driver *drv,
522 523 524 525 526 527 528 529 530 531 532 533 534
		int (*probe)(struct platform_device *))
{
	int retval, code;

	/* temporary section violation during probe() */
	drv->probe = probe;
	retval = code = platform_driver_register(drv);

	/* Fixup that section violation, being paranoid about code scanning
	 * the list of drivers in order to probe new devices.  Check to see
	 * if the probe was successful, and make sure any forced probes of
	 * new devices fail.
	 */
535
	spin_lock(&platform_bus_type.p->klist_drivers.k_lock);
536
	drv->probe = NULL;
537
	if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list))
538 539
		retval = -ENODEV;
	drv->driver.probe = platform_drv_probe_fail;
540
	spin_unlock(&platform_bus_type.p->klist_drivers.k_lock);
541 542 543 544 545 546

	if (code != retval)
		platform_driver_unregister(drv);
	return retval;
}
EXPORT_SYMBOL_GPL(platform_driver_probe);
L
Linus Torvalds 已提交
547

548 549 550 551 552 553
/* modalias support enables more hands-off userspace setup:
 * (a) environment variable lets new-style hotplug events work once system is
 *     fully running:  "modprobe $MODALIAS"
 * (b) sysfs attribute lets new-style coldplug recover from hotplug events
 *     mishandled before system is fully running:  "modprobe $(cat modalias)"
 */
554 555
static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
			     char *buf)
556 557
{
	struct platform_device	*pdev = to_platform_device(dev);
558
	int len = snprintf(buf, PAGE_SIZE, "platform:%s\n", pdev->name);
559 560 561 562 563 564 565 566 567

	return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
}

static struct device_attribute platform_dev_attrs[] = {
	__ATTR_RO(modalias),
	__ATTR_NULL,
};

568
static int platform_uevent(struct device *dev, struct kobj_uevent_env *env)
569 570 571
{
	struct platform_device	*pdev = to_platform_device(dev);

572 573
	add_uevent_var(env, "MODALIAS=%s%s", PLATFORM_MODULE_PREFIX,
		(pdev->id_entry) ? pdev->id_entry->name : pdev->name);
574 575 576
	return 0;
}

577 578 579 580 581 582 583 584 585 586 587 588 589 590
static const struct platform_device_id *platform_match_id(
			struct platform_device_id *id,
			struct platform_device *pdev)
{
	while (id->name[0]) {
		if (strcmp(pdev->name, id->name) == 0) {
			pdev->id_entry = id;
			return id;
		}
		id++;
	}
	return NULL;
}

L
Linus Torvalds 已提交
591
/**
592 593 594
 * platform_match - bind platform device to platform driver.
 * @dev: device.
 * @drv: driver.
L
Linus Torvalds 已提交
595
 *
596 597 598 599 600 601 602
 * Platform device IDs are assumed to be encoded like this:
 * "<name><instance>", where <name> is a short description of the type of
 * device, like "pci" or "floppy", and <instance> is the enumerated
 * instance of the device, like '0' or '42'.  Driver IDs are simply
 * "<name>".  So, extract the <name> from the platform_device structure,
 * and compare it against the name of the driver. Return whether they match
 * or not.
L
Linus Torvalds 已提交
603
 */
604
static int platform_match(struct device *dev, struct device_driver *drv)
L
Linus Torvalds 已提交
605
{
606
	struct platform_device *pdev = to_platform_device(dev);
607 608 609 610 611
	struct platform_driver *pdrv = to_platform_driver(drv);

	/* match against the id table first */
	if (pdrv->id_table)
		return platform_match_id(pdrv->id_table, pdev) != NULL;
L
Linus Torvalds 已提交
612

613
	/* fall-back to driver name match */
614
	return (strcmp(pdev->name, drv->name) == 0);
L
Linus Torvalds 已提交
615 616
}

617 618 619
#ifdef CONFIG_PM_SLEEP

static int platform_legacy_suspend(struct device *dev, pm_message_t mesg)
L
Linus Torvalds 已提交
620
{
621 622
	struct platform_driver *pdrv = to_platform_driver(dev->driver);
	struct platform_device *pdev = to_platform_device(dev);
L
Linus Torvalds 已提交
623 624
	int ret = 0;

625 626
	if (dev->driver && pdrv->suspend)
		ret = pdrv->suspend(pdev, mesg);
627 628 629 630

	return ret;
}

631
static int platform_legacy_suspend_late(struct device *dev, pm_message_t mesg)
632
{
633 634
	struct platform_driver *pdrv = to_platform_driver(dev->driver);
	struct platform_device *pdev = to_platform_device(dev);
635 636
	int ret = 0;

637 638
	if (dev->driver && pdrv->suspend_late)
		ret = pdrv->suspend_late(pdev, mesg);
639 640 641 642

	return ret;
}

643
static int platform_legacy_resume_early(struct device *dev)
644
{
645 646
	struct platform_driver *pdrv = to_platform_driver(dev->driver);
	struct platform_device *pdev = to_platform_device(dev);
647 648
	int ret = 0;

649 650
	if (dev->driver && pdrv->resume_early)
		ret = pdrv->resume_early(pdev);
651

L
Linus Torvalds 已提交
652 653 654
	return ret;
}

655
static int platform_legacy_resume(struct device *dev)
L
Linus Torvalds 已提交
656
{
657 658
	struct platform_driver *pdrv = to_platform_driver(dev->driver);
	struct platform_device *pdev = to_platform_device(dev);
L
Linus Torvalds 已提交
659 660
	int ret = 0;

661 662
	if (dev->driver && pdrv->resume)
		ret = pdrv->resume(pdev);
663

L
Linus Torvalds 已提交
664 665 666
	return ret;
}

667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692
static int platform_pm_prepare(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

	if (drv && drv->pm && drv->pm->prepare)
		ret = drv->pm->prepare(dev);

	return ret;
}

static void platform_pm_complete(struct device *dev)
{
	struct device_driver *drv = dev->driver;

	if (drv && drv->pm && drv->pm->complete)
		drv->pm->complete(dev);
}

#ifdef CONFIG_SUSPEND

static int platform_pm_suspend(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

693 694 695 696
	if (!drv)
		return 0;

	if (drv->pm) {
697 698 699 700 701 702 703 704 705 706 707
		if (drv->pm->suspend)
			ret = drv->pm->suspend(dev);
	} else {
		ret = platform_legacy_suspend(dev, PMSG_SUSPEND);
	}

	return ret;
}

static int platform_pm_suspend_noirq(struct device *dev)
{
708
	struct device_driver *drv = dev->driver;
709 710
	int ret = 0;

711
	if (!drv)
712 713
		return 0;

714 715 716
	if (drv->pm) {
		if (drv->pm->suspend_noirq)
			ret = drv->pm->suspend_noirq(dev);
717 718 719 720 721 722 723 724 725 726 727 728
	} else {
		ret = platform_legacy_suspend_late(dev, PMSG_SUSPEND);
	}

	return ret;
}

static int platform_pm_resume(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

729 730 731 732
	if (!drv)
		return 0;

	if (drv->pm) {
733 734 735 736 737 738 739 740 741 742 743
		if (drv->pm->resume)
			ret = drv->pm->resume(dev);
	} else {
		ret = platform_legacy_resume(dev);
	}

	return ret;
}

static int platform_pm_resume_noirq(struct device *dev)
{
744
	struct device_driver *drv = dev->driver;
745 746
	int ret = 0;

747
	if (!drv)
748 749
		return 0;

750 751 752
	if (drv->pm) {
		if (drv->pm->resume_noirq)
			ret = drv->pm->resume_noirq(dev);
753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790
	} else {
		ret = platform_legacy_resume_early(dev);
	}

	return ret;
}

#else /* !CONFIG_SUSPEND */

#define platform_pm_suspend		NULL
#define platform_pm_resume		NULL
#define platform_pm_suspend_noirq	NULL
#define platform_pm_resume_noirq	NULL

#endif /* !CONFIG_SUSPEND */

#ifdef CONFIG_HIBERNATION

static int platform_pm_freeze(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

	if (!drv)
		return 0;

	if (drv->pm) {
		if (drv->pm->freeze)
			ret = drv->pm->freeze(dev);
	} else {
		ret = platform_legacy_suspend(dev, PMSG_FREEZE);
	}

	return ret;
}

static int platform_pm_freeze_noirq(struct device *dev)
{
791
	struct device_driver *drv = dev->driver;
792 793
	int ret = 0;

794
	if (!drv)
795 796
		return 0;

797 798 799
	if (drv->pm) {
		if (drv->pm->freeze_noirq)
			ret = drv->pm->freeze_noirq(dev);
800 801 802 803 804 805 806 807 808 809 810 811
	} else {
		ret = platform_legacy_suspend_late(dev, PMSG_FREEZE);
	}

	return ret;
}

static int platform_pm_thaw(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

812 813 814 815
	if (!drv)
		return 0;

	if (drv->pm) {
816 817 818 819 820 821 822 823 824 825 826
		if (drv->pm->thaw)
			ret = drv->pm->thaw(dev);
	} else {
		ret = platform_legacy_resume(dev);
	}

	return ret;
}

static int platform_pm_thaw_noirq(struct device *dev)
{
827
	struct device_driver *drv = dev->driver;
828 829
	int ret = 0;

830
	if (!drv)
831 832
		return 0;

833 834 835
	if (drv->pm) {
		if (drv->pm->thaw_noirq)
			ret = drv->pm->thaw_noirq(dev);
836 837 838 839 840 841 842 843 844 845 846 847
	} else {
		ret = platform_legacy_resume_early(dev);
	}

	return ret;
}

static int platform_pm_poweroff(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

848 849 850 851
	if (!drv)
		return 0;

	if (drv->pm) {
852 853 854 855 856 857 858 859 860 861 862
		if (drv->pm->poweroff)
			ret = drv->pm->poweroff(dev);
	} else {
		ret = platform_legacy_suspend(dev, PMSG_HIBERNATE);
	}

	return ret;
}

static int platform_pm_poweroff_noirq(struct device *dev)
{
863
	struct device_driver *drv = dev->driver;
864 865
	int ret = 0;

866
	if (!drv)
867 868
		return 0;

869 870 871
	if (drv->pm) {
		if (drv->pm->poweroff_noirq)
			ret = drv->pm->poweroff_noirq(dev);
872 873 874 875 876 877 878 879 880 881 882 883
	} else {
		ret = platform_legacy_suspend_late(dev, PMSG_HIBERNATE);
	}

	return ret;
}

static int platform_pm_restore(struct device *dev)
{
	struct device_driver *drv = dev->driver;
	int ret = 0;

884 885 886 887
	if (!drv)
		return 0;

	if (drv->pm) {
888 889 890 891 892 893 894 895 896 897 898
		if (drv->pm->restore)
			ret = drv->pm->restore(dev);
	} else {
		ret = platform_legacy_resume(dev);
	}

	return ret;
}

static int platform_pm_restore_noirq(struct device *dev)
{
899
	struct device_driver *drv = dev->driver;
900 901
	int ret = 0;

902
	if (!drv)
903 904
		return 0;

905 906 907
	if (drv->pm) {
		if (drv->pm->restore_noirq)
			ret = drv->pm->restore_noirq(dev);
908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927
	} else {
		ret = platform_legacy_resume_early(dev);
	}

	return ret;
}

#else /* !CONFIG_HIBERNATION */

#define platform_pm_freeze		NULL
#define platform_pm_thaw		NULL
#define platform_pm_poweroff		NULL
#define platform_pm_restore		NULL
#define platform_pm_freeze_noirq	NULL
#define platform_pm_thaw_noirq		NULL
#define platform_pm_poweroff_noirq	NULL
#define platform_pm_restore_noirq	NULL

#endif /* !CONFIG_HIBERNATION */

928 929 930 931 932 933 934 935 936
static struct dev_pm_ops platform_dev_pm_ops = {
	.prepare = platform_pm_prepare,
	.complete = platform_pm_complete,
	.suspend = platform_pm_suspend,
	.resume = platform_pm_resume,
	.freeze = platform_pm_freeze,
	.thaw = platform_pm_thaw,
	.poweroff = platform_pm_poweroff,
	.restore = platform_pm_restore,
937 938 939 940 941 942 943 944
	.suspend_noirq = platform_pm_suspend_noirq,
	.resume_noirq = platform_pm_resume_noirq,
	.freeze_noirq = platform_pm_freeze_noirq,
	.thaw_noirq = platform_pm_thaw_noirq,
	.poweroff_noirq = platform_pm_poweroff_noirq,
	.restore_noirq = platform_pm_restore_noirq,
};

945
#define PLATFORM_PM_OPS_PTR	(&platform_dev_pm_ops)
946 947 948 949 950 951 952

#else /* !CONFIG_PM_SLEEP */

#define PLATFORM_PM_OPS_PTR	NULL

#endif /* !CONFIG_PM_SLEEP */

L
Linus Torvalds 已提交
953 954
struct bus_type platform_bus_type = {
	.name		= "platform",
955
	.dev_attrs	= platform_dev_attrs,
L
Linus Torvalds 已提交
956
	.match		= platform_match,
957
	.uevent		= platform_uevent,
958
	.pm		= PLATFORM_PM_OPS_PTR,
L
Linus Torvalds 已提交
959
};
960
EXPORT_SYMBOL_GPL(platform_bus_type);
L
Linus Torvalds 已提交
961 962 963

int __init platform_bus_init(void)
{
964 965
	int error;

M
Magnus Damm 已提交
966 967
	early_platform_cleanup();

968 969 970 971 972 973 974
	error = device_register(&platform_bus);
	if (error)
		return error;
	error =  bus_register(&platform_bus_type);
	if (error)
		device_unregister(&platform_bus);
	return error;
L
Linus Torvalds 已提交
975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993
}

#ifndef ARCH_HAS_DMA_GET_REQUIRED_MASK
u64 dma_get_required_mask(struct device *dev)
{
	u32 low_totalram = ((max_pfn - 1) << PAGE_SHIFT);
	u32 high_totalram = ((max_pfn - 1) >> (32 - PAGE_SHIFT));
	u64 mask;

	if (!high_totalram) {
		/* convert to mask just covering totalram */
		low_totalram = (1 << (fls(low_totalram) - 1));
		low_totalram += low_totalram - 1;
		mask = low_totalram;
	} else {
		high_totalram = (1 << (fls(high_totalram) - 1));
		high_totalram += high_totalram - 1;
		mask = (((u64)high_totalram) << 32) + 0xffffffff;
	}
994
	return mask;
L
Linus Torvalds 已提交
995 996 997
}
EXPORT_SYMBOL_GPL(dma_get_required_mask);
#endif
M
Magnus Damm 已提交
998 999 1000 1001 1002 1003

static __initdata LIST_HEAD(early_platform_driver_list);
static __initdata LIST_HEAD(early_platform_device_list);

/**
 * early_platform_driver_register
1004
 * @epdrv: early_platform driver structure
M
Magnus Damm 已提交
1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087
 * @buf: string passed from early_param()
 */
int __init early_platform_driver_register(struct early_platform_driver *epdrv,
					  char *buf)
{
	unsigned long index;
	int n;

	/* Simply add the driver to the end of the global list.
	 * Drivers will by default be put on the list in compiled-in order.
	 */
	if (!epdrv->list.next) {
		INIT_LIST_HEAD(&epdrv->list);
		list_add_tail(&epdrv->list, &early_platform_driver_list);
	}

	/* If the user has specified device then make sure the driver
	 * gets prioritized. The driver of the last device specified on
	 * command line will be put first on the list.
	 */
	n = strlen(epdrv->pdrv->driver.name);
	if (buf && !strncmp(buf, epdrv->pdrv->driver.name, n)) {
		list_move(&epdrv->list, &early_platform_driver_list);

		if (!strcmp(buf, epdrv->pdrv->driver.name))
			epdrv->requested_id = -1;
		else if (buf[n] == '.' && strict_strtoul(&buf[n + 1], 10,
							 &index) == 0)
			epdrv->requested_id = index;
		else
			epdrv->requested_id = EARLY_PLATFORM_ID_ERROR;
	}

	return 0;
}

/**
 * early_platform_add_devices - add a numbers of early platform devices
 * @devs: array of early platform devices to add
 * @num: number of early platform devices in array
 */
void __init early_platform_add_devices(struct platform_device **devs, int num)
{
	struct device *dev;
	int i;

	/* simply add the devices to list */
	for (i = 0; i < num; i++) {
		dev = &devs[i]->dev;

		if (!dev->devres_head.next) {
			INIT_LIST_HEAD(&dev->devres_head);
			list_add_tail(&dev->devres_head,
				      &early_platform_device_list);
		}
	}
}

/**
 * early_platform_driver_register_all
 * @class_str: string to identify early platform driver class
 */
void __init early_platform_driver_register_all(char *class_str)
{
	/* The "class_str" parameter may or may not be present on the kernel
	 * command line. If it is present then there may be more than one
	 * matching parameter.
	 *
	 * Since we register our early platform drivers using early_param()
	 * we need to make sure that they also get registered in the case
	 * when the parameter is missing from the kernel command line.
	 *
	 * We use parse_early_options() to make sure the early_param() gets
	 * called at least once. The early_param() may be called more than
	 * once since the name of the preferred device may be specified on
	 * the kernel command line. early_platform_driver_register() handles
	 * this case for us.
	 */
	parse_early_options(class_str);
}

/**
 * early_platform_match
1088
 * @epdrv: early platform driver structure
M
Magnus Damm 已提交
1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105
 * @id: id to match against
 */
static  __init struct platform_device *
early_platform_match(struct early_platform_driver *epdrv, int id)
{
	struct platform_device *pd;

	list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
		if (platform_match(&pd->dev, &epdrv->pdrv->driver))
			if (pd->id == id)
				return pd;

	return NULL;
}

/**
 * early_platform_left
1106
 * @epdrv: early platform driver structure
M
Magnus Damm 已提交
1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234
 * @id: return true if id or above exists
 */
static  __init int early_platform_left(struct early_platform_driver *epdrv,
				       int id)
{
	struct platform_device *pd;

	list_for_each_entry(pd, &early_platform_device_list, dev.devres_head)
		if (platform_match(&pd->dev, &epdrv->pdrv->driver))
			if (pd->id >= id)
				return 1;

	return 0;
}

/**
 * early_platform_driver_probe_id
 * @class_str: string to identify early platform driver class
 * @id: id to match against
 * @nr_probe: number of platform devices to successfully probe before exiting
 */
static int __init early_platform_driver_probe_id(char *class_str,
						 int id,
						 int nr_probe)
{
	struct early_platform_driver *epdrv;
	struct platform_device *match;
	int match_id;
	int n = 0;
	int left = 0;

	list_for_each_entry(epdrv, &early_platform_driver_list, list) {
		/* only use drivers matching our class_str */
		if (strcmp(class_str, epdrv->class_str))
			continue;

		if (id == -2) {
			match_id = epdrv->requested_id;
			left = 1;

		} else {
			match_id = id;
			left += early_platform_left(epdrv, id);

			/* skip requested id */
			switch (epdrv->requested_id) {
			case EARLY_PLATFORM_ID_ERROR:
			case EARLY_PLATFORM_ID_UNSET:
				break;
			default:
				if (epdrv->requested_id == id)
					match_id = EARLY_PLATFORM_ID_UNSET;
			}
		}

		switch (match_id) {
		case EARLY_PLATFORM_ID_ERROR:
			pr_warning("%s: unable to parse %s parameter\n",
				   class_str, epdrv->pdrv->driver.name);
			/* fall-through */
		case EARLY_PLATFORM_ID_UNSET:
			match = NULL;
			break;
		default:
			match = early_platform_match(epdrv, match_id);
		}

		if (match) {
			if (epdrv->pdrv->probe(match))
				pr_warning("%s: unable to probe %s early.\n",
					   class_str, match->name);
			else
				n++;
		}

		if (n >= nr_probe)
			break;
	}

	if (left)
		return n;
	else
		return -ENODEV;
}

/**
 * early_platform_driver_probe
 * @class_str: string to identify early platform driver class
 * @nr_probe: number of platform devices to successfully probe before exiting
 * @user_only: only probe user specified early platform devices
 */
int __init early_platform_driver_probe(char *class_str,
				       int nr_probe,
				       int user_only)
{
	int k, n, i;

	n = 0;
	for (i = -2; n < nr_probe; i++) {
		k = early_platform_driver_probe_id(class_str, i, nr_probe - n);

		if (k < 0)
			break;

		n += k;

		if (user_only)
			break;
	}

	return n;
}

/**
 * early_platform_cleanup - clean up early platform code
 */
void __init early_platform_cleanup(void)
{
	struct platform_device *pd, *pd2;

	/* clean up the devres list used to chain devices */
	list_for_each_entry_safe(pd, pd2, &early_platform_device_list,
				 dev.devres_head) {
		list_del(&pd->dev.devres_head);
		memset(&pd->dev.devres_head, 0, sizeof(pd->dev.devres_head));
	}
}