Blame view

drivers/base/platform.c 31.1 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
  /*
   * 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.
   */
daa412267   Andrew Morton   driver core: plat...
12
  #include <linux/string.h>
d052d1bef   Russell King   Create platform_d...
13
  #include <linux/platform_device.h>
05212157e   Grant Likely   drivercore/of: Ad...
14
  #include <linux/of_device.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
15
16
17
18
19
  #include <linux/module.h>
  #include <linux/init.h>
  #include <linux/dma-mapping.h>
  #include <linux/bootmem.h>
  #include <linux/err.h>
4e57b6817   Tim Schmielau   [PATCH] fix missi...
20
  #include <linux/slab.h>
9d7302299   Magnus Damm   PM: Run-time PM p...
21
  #include <linux/pm_runtime.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
22

a1bdc7aad   Ben Dooks   [PATCH] drivers/b...
23
  #include "base.h"
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
24
25
  #define to_platform_driver(drv)	(container_of((drv), struct platform_driver, \
  				 driver))
00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
26

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
27
  struct device platform_bus = {
1e0b2cf93   Kay Sievers   driver core: stru...
28
  	.init_name	= "platform",
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
29
  };
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
30
  EXPORT_SYMBOL_GPL(platform_bus);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
31
32
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
33
34
35
36
   * platform_get_resource - get a resource for a device
   * @dev: platform device
   * @type: resource type
   * @num: resource index
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
37
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
38
39
  struct resource *platform_get_resource(struct platform_device *dev,
  				       unsigned int type, unsigned int num)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
40
41
42
43
44
  {
  	int i;
  
  	for (i = 0; i < dev->num_resources; i++) {
  		struct resource *r = &dev->resource[i];
c9f66169f   Magnus Damm   resource: add res...
45
46
  		if (type == resource_type(r) && num-- == 0)
  			return r;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
47
48
49
  	}
  	return NULL;
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
50
  EXPORT_SYMBOL_GPL(platform_get_resource);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
51
52
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
53
54
55
   * platform_get_irq - get an IRQ for a device
   * @dev: platform device
   * @num: IRQ number index
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
56
57
58
59
   */
  int platform_get_irq(struct platform_device *dev, unsigned int num)
  {
  	struct resource *r = platform_get_resource(dev, IORESOURCE_IRQ, num);
305b3228f   David Vrabel   [PATCH] driver co...
60
  	return r ? r->start : -ENXIO;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
61
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
62
  EXPORT_SYMBOL_GPL(platform_get_irq);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
63
64
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
65
66
67
68
   * platform_get_resource_byname - get a resource for a device by name
   * @dev: platform device
   * @type: resource type
   * @name: resource name
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
69
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
70
  struct resource *platform_get_resource_byname(struct platform_device *dev,
c0afe7ba5   Linus Walleij   driver core: Cons...
71
72
  					      unsigned int type,
  					      const char *name)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
73
74
75
76
77
  {
  	int i;
  
  	for (i = 0; i < dev->num_resources; i++) {
  		struct resource *r = &dev->resource[i];
c9f66169f   Magnus Damm   resource: add res...
78
79
  		if (type == resource_type(r) && !strcmp(r->name, name))
  			return r;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
80
81
82
  	}
  	return NULL;
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
83
  EXPORT_SYMBOL_GPL(platform_get_resource_byname);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
84
85
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
86
87
88
   * platform_get_irq - get an IRQ for a device
   * @dev: platform device
   * @name: IRQ name
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
89
   */
c0afe7ba5   Linus Walleij   driver core: Cons...
90
  int platform_get_irq_byname(struct platform_device *dev, const char *name)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
91
  {
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
92
93
  	struct resource *r = platform_get_resource_byname(dev, IORESOURCE_IRQ,
  							  name);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
94

305b3228f   David Vrabel   [PATCH] driver co...
95
  	return r ? r->start : -ENXIO;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
96
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
97
  EXPORT_SYMBOL_GPL(platform_get_irq_byname);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
98
99
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
100
101
102
   * platform_add_devices - add a numbers of platform devices
   * @devs: array of platform devices to add
   * @num: number of platform devices in array
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
   */
  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;
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
119
  EXPORT_SYMBOL_GPL(platform_add_devices);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
120

37c12e749   Russell King   [DRIVER MODEL] Im...
121
122
123
124
  struct platform_object {
  	struct platform_device pdev;
  	char name[1];
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
125
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
126
   * platform_device_put - destroy a platform device
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
127
   * @pdev: platform device to free
37c12e749   Russell King   [DRIVER MODEL] Im...
128
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
129
130
   * Free all memory associated with a platform device.  This function must
   * _only_ be externally called in error cases.  All other usage is a bug.
37c12e749   Russell King   [DRIVER MODEL] Im...
131
132
133
134
135
136
137
138
139
140
   */
  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)
  {
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
141
142
  	struct platform_object *pa = container_of(dev, struct platform_object,
  						  pdev.dev);
37c12e749   Russell King   [DRIVER MODEL] Im...
143
144
145
146
147
148
149
  
  	kfree(pa->pdev.dev.platform_data);
  	kfree(pa->pdev.resource);
  	kfree(pa);
  }
  
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
150
   * platform_device_alloc - create a platform device
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
151
152
   * @name: base name of the device we're adding
   * @id: instance id
37c12e749   Russell King   [DRIVER MODEL] Im...
153
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
154
155
   * Create a platform device object which can have other objects attached
   * to it, and which will have attached objects freed when it is released.
37c12e749   Russell King   [DRIVER MODEL] Im...
156
   */
1359555eb   Jean Delvare   Driver core: Make...
157
  struct platform_device *platform_device_alloc(const char *name, int id)
37c12e749   Russell King   [DRIVER MODEL] Im...
158
159
160
161
162
163
164
165
166
167
168
  {
  	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;
  	}
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
169
  	return pa ? &pa->pdev : NULL;
37c12e749   Russell King   [DRIVER MODEL] Im...
170
171
172
173
  }
  EXPORT_SYMBOL_GPL(platform_device_alloc);
  
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
174
   * platform_device_add_resources - add resources to a platform device
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
175
176
177
   * @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
37c12e749   Russell King   [DRIVER MODEL] Im...
178
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
179
180
181
   * 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.
37c12e749   Russell King   [DRIVER MODEL] Im...
182
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
183
  int platform_device_add_resources(struct platform_device *pdev,
0b7f1a7ef   Geert Uytterhoeven   platform: Make pl...
184
  				  const struct resource *res, unsigned int num)
37c12e749   Russell King   [DRIVER MODEL] Im...
185
186
  {
  	struct resource *r;
3e61dfd85   Uwe Kleine-König   Driver core: use ...
187
  	r = kmemdup(res, sizeof(struct resource) * num, GFP_KERNEL);
37c12e749   Russell King   [DRIVER MODEL] Im...
188
  	if (r) {
37c12e749   Russell King   [DRIVER MODEL] Im...
189
190
  		pdev->resource = r;
  		pdev->num_resources = num;
3e61dfd85   Uwe Kleine-König   Driver core: use ...
191
  		return 0;
37c12e749   Russell King   [DRIVER MODEL] Im...
192
  	}
3e61dfd85   Uwe Kleine-König   Driver core: use ...
193
  	return -ENOMEM;
37c12e749   Russell King   [DRIVER MODEL] Im...
194
195
196
197
  }
  EXPORT_SYMBOL_GPL(platform_device_add_resources);
  
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
198
   * platform_device_add_data - add platform-specific data to a platform device
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
199
200
201
   * @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
37c12e749   Russell King   [DRIVER MODEL] Im...
202
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
203
204
205
   * 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.
37c12e749   Russell King   [DRIVER MODEL] Im...
206
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
207
208
  int platform_device_add_data(struct platform_device *pdev, const void *data,
  			     size_t size)
37c12e749   Russell King   [DRIVER MODEL] Im...
209
  {
daa412267   Andrew Morton   driver core: plat...
210
  	void *d = kmemdup(data, size, GFP_KERNEL);
37c12e749   Russell King   [DRIVER MODEL] Im...
211

37c12e749   Russell King   [DRIVER MODEL] Im...
212
  	if (d) {
37c12e749   Russell King   [DRIVER MODEL] Im...
213
  		pdev->dev.platform_data = d;
daa412267   Andrew Morton   driver core: plat...
214
  		return 0;
37c12e749   Russell King   [DRIVER MODEL] Im...
215
  	}
daa412267   Andrew Morton   driver core: plat...
216
  	return -ENOMEM;
37c12e749   Russell King   [DRIVER MODEL] Im...
217
218
219
220
  }
  EXPORT_SYMBOL_GPL(platform_device_add_data);
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
221
222
   * platform_device_add - add a platform device to device hierarchy
   * @pdev: platform device we're adding
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
223
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
224
225
   * This is part 2 of platform_device_register(), though may be called
   * separately _iff_ pdev was allocated by platform_device_alloc().
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
226
   */
37c12e749   Russell King   [DRIVER MODEL] Im...
227
  int platform_device_add(struct platform_device *pdev)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
228
229
230
231
232
233
234
235
236
237
238
239
  {
  	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)
1e0b2cf93   Kay Sievers   driver core: stru...
240
  		dev_set_name(&pdev->dev, "%s.%d", pdev->name,  pdev->id);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
241
  	else
acc0e90fb   Greg Kroah-Hartman   driver core: fix ...
242
  		dev_set_name(&pdev->dev, "%s", pdev->name);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
243
244
245
246
247
  
  	for (i = 0; i < pdev->num_resources; i++) {
  		struct resource *p, *r = &pdev->resource[i];
  
  		if (r->name == NULL)
1e0b2cf93   Kay Sievers   driver core: stru...
248
  			r->name = dev_name(&pdev->dev);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
249
250
251
  
  		p = r->parent;
  		if (!p) {
c9f66169f   Magnus Damm   resource: add res...
252
  			if (resource_type(r) == IORESOURCE_MEM)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
253
  				p = &iomem_resource;
c9f66169f   Magnus Damm   resource: add res...
254
  			else if (resource_type(r) == IORESOURCE_IO)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
255
256
  				p = &ioport_resource;
  		}
d960bb4db   Kumar Gala   [PATCH] Allow ove...
257
  		if (p && insert_resource(p, r)) {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
258
259
260
  			printk(KERN_ERR
  			       "%s: failed to claim resource %d
  ",
1e0b2cf93   Kay Sievers   driver core: stru...
261
  			       dev_name(&pdev->dev), i);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
262
263
264
265
266
267
268
  			ret = -EBUSY;
  			goto failed;
  		}
  	}
  
  	pr_debug("Registering platform device '%s'. Parent at %s
  ",
1e0b2cf93   Kay Sievers   driver core: stru...
269
  		 dev_name(&pdev->dev), dev_name(pdev->dev.parent));
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
270

e39155322   Russell King   [PATCH] Driver Co...
271
  	ret = device_add(&pdev->dev);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
272
273
274
275
  	if (ret == 0)
  		return ret;
  
   failed:
c9f66169f   Magnus Damm   resource: add res...
276
277
278
279
280
281
282
  	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);
  	}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
283
284
  	return ret;
  }
37c12e749   Russell King   [DRIVER MODEL] Im...
285
286
287
  EXPORT_SYMBOL_GPL(platform_device_add);
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
288
289
   * platform_device_del - remove a platform-level device
   * @pdev: platform device we're removing
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
290
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
291
292
293
   * 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.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
294
   */
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
295
  void platform_device_del(struct platform_device *pdev)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
296
297
298
299
  {
  	int i;
  
  	if (pdev) {
dc4c15d44   Jean Delvare   platform: reorder...
300
  		device_del(&pdev->dev);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
301
302
  		for (i = 0; i < pdev->num_resources; i++) {
  			struct resource *r = &pdev->resource[i];
c9f66169f   Magnus Damm   resource: add res...
303
304
305
  			unsigned long type = resource_type(r);
  
  			if (type == IORESOURCE_MEM || type == IORESOURCE_IO)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
306
307
  				release_resource(r);
  		}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
308
309
  	}
  }
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
310
311
312
  EXPORT_SYMBOL_GPL(platform_device_del);
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
313
314
   * platform_device_register - add a platform-level device
   * @pdev: platform device we're adding
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
315
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
316
  int platform_device_register(struct platform_device *pdev)
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
317
318
319
320
  {
  	device_initialize(&pdev->dev);
  	return platform_device_add(pdev);
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
321
  EXPORT_SYMBOL_GPL(platform_device_register);
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
322
323
  
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
324
325
   * platform_device_unregister - unregister a platform-level device
   * @pdev: platform device we're unregistering
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
326
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
327
328
329
   * 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().
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
330
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
331
  void platform_device_unregister(struct platform_device *pdev)
93ce3061b   Dmitry Torokhov   [PATCH] Driver Co...
332
333
334
335
  {
  	platform_device_del(pdev);
  	platform_device_put(pdev);
  }
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
336
  EXPORT_SYMBOL_GPL(platform_device_unregister);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
337

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
338
  /**
44f28bdea   Uwe Kleine-König   Driver core: redu...
339
340
   * platform_device_register_resndata - add a platform-level device with
   * resources and platform-specific data
49a4ec188   David Brownell   fix hotplug for l...
341
   *
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
342
343
344
   * @parent: parent device for the device we're adding
   * @name: base name of the device we're adding
   * @id: instance id
44f28bdea   Uwe Kleine-König   Driver core: redu...
345
346
   * @res: set of resources that needs to be allocated for the device
   * @num: number of resources
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
347
348
349
   * @data: platform specific data for this platform device
   * @size: size of platform specific data
   *
f0eae0ed3   Jani Nikula   driver-core: docu...
350
   * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
351
   */
737a3bb94   Uwe Kleine-König   Driver core: move...
352
  struct platform_device *__init_or_module platform_device_register_resndata(
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
353
354
  		struct device *parent,
  		const char *name, int id,
44f28bdea   Uwe Kleine-König   Driver core: redu...
355
  		const struct resource *res, unsigned int num,
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
356
357
  		const void *data, size_t size)
  {
44f28bdea   Uwe Kleine-König   Driver core: redu...
358
  	int ret = -ENOMEM;
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
359
  	struct platform_device *pdev;
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
360
361
  
  	pdev = platform_device_alloc(name, id);
44f28bdea   Uwe Kleine-König   Driver core: redu...
362
363
  	if (!pdev)
  		goto err;
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
364
365
  
  	pdev->dev.parent = parent;
44f28bdea   Uwe Kleine-König   Driver core: redu...
366
367
368
369
370
371
372
373
374
375
  	if (res) {
  		ret = platform_device_add_resources(pdev, res, num);
  		if (ret)
  			goto err;
  	}
  
  	if (data) {
  		ret = platform_device_add_data(pdev, data, size);
  		if (ret)
  			goto err;
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
376
  	}
44f28bdea   Uwe Kleine-König   Driver core: redu...
377
378
379
380
381
382
  	ret = platform_device_add(pdev);
  	if (ret) {
  err:
  		platform_device_put(pdev);
  		return ERR_PTR(ret);
  	}
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
383
384
  
  	return pdev;
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
385
  }
44f28bdea   Uwe Kleine-König   Driver core: redu...
386
  EXPORT_SYMBOL_GPL(platform_device_register_resndata);
d8bf25408   Dmitry Eremin-Solenikov   platform: add new...
387

00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
388
389
390
391
392
393
394
  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);
  }
c67334fbd   David Brownell   Driver core: plat...
395
396
397
398
  static int platform_drv_probe_fail(struct device *_dev)
  {
  	return -ENXIO;
  }
00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
  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);
  }
00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
414
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
415
   * platform_driver_register - register a driver for platform-level devices
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
416
   * @drv: platform driver structure
00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
417
418
419
420
421
422
423
424
425
426
   */
  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;
783ea7d4e   Magnus Damm   Driver Core: Rewo...
427

00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
428
429
430
431
432
  	return driver_register(&drv->driver);
  }
  EXPORT_SYMBOL_GPL(platform_driver_register);
  
  /**
3c31f07ad   Ben Hutchings   Driver core: Fix ...
433
   * platform_driver_unregister - unregister a driver for platform-level devices
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
434
   * @drv: platform driver structure
00d3dcdd9   Russell King   [DRIVER MODEL] Ad...
435
436
437
438
439
440
   */
  void platform_driver_unregister(struct platform_driver *drv)
  {
  	driver_unregister(&drv->driver);
  }
  EXPORT_SYMBOL_GPL(platform_driver_unregister);
c67334fbd   David Brownell   Driver core: plat...
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
  /**
   * 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.
   */
c63e07834   Andrew Morton   Driver core: "pla...
458
  int __init_or_module platform_driver_probe(struct platform_driver *drv,
c67334fbd   David Brownell   Driver core: plat...
459
460
461
  		int (*probe)(struct platform_device *))
  {
  	int retval, code;
1a6f2a751   Dmitry Torokhov   Driver core: allo...
462
463
  	/* make sure driver won't have bind/unbind attributes */
  	drv->driver.suppress_bind_attrs = true;
c67334fbd   David Brownell   Driver core: plat...
464
465
466
  	/* temporary section violation during probe() */
  	drv->probe = probe;
  	retval = code = platform_driver_register(drv);
1a6f2a751   Dmitry Torokhov   Driver core: allo...
467
468
  	/*
  	 * Fixup that section violation, being paranoid about code scanning
c67334fbd   David Brownell   Driver core: plat...
469
470
471
472
  	 * 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.
  	 */
c6f7e72a3   Greg Kroah-Hartman   driver core: remo...
473
  	spin_lock(&platform_bus_type.p->klist_drivers.k_lock);
c67334fbd   David Brownell   Driver core: plat...
474
  	drv->probe = NULL;
e5dd12784   Greg Kroah-Hartman   Driver core: move...
475
  	if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list))
c67334fbd   David Brownell   Driver core: plat...
476
477
  		retval = -ENODEV;
  	drv->driver.probe = platform_drv_probe_fail;
c6f7e72a3   Greg Kroah-Hartman   driver core: remo...
478
  	spin_unlock(&platform_bus_type.p->klist_drivers.k_lock);
c67334fbd   David Brownell   Driver core: plat...
479
480
481
482
483
484
  
  	if (code != retval)
  		platform_driver_unregister(drv);
  	return retval;
  }
  EXPORT_SYMBOL_GPL(platform_driver_probe);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
485

ecdf6ceb8   Dmitry Torokhov   Driver core: add ...
486
487
488
489
490
491
492
493
494
495
496
  /**
   * platform_create_bundle - register driver and create corresponding device
   * @driver: platform driver structure
   * @probe: the driver probe routine, probably from an __init section
   * @res: set of resources that needs to be allocated for the device
   * @n_res: number of resources
   * @data: platform specific data for this platform device
   * @size: size of platform specific data
   *
   * Use this in legacy-style modules that probe hardware directly and
   * register a single platform device and corresponding platform driver.
f0eae0ed3   Jani Nikula   driver-core: docu...
497
498
   *
   * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
ecdf6ceb8   Dmitry Torokhov   Driver core: add ...
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
   */
  struct platform_device * __init_or_module platform_create_bundle(
  			struct platform_driver *driver,
  			int (*probe)(struct platform_device *),
  			struct resource *res, unsigned int n_res,
  			const void *data, size_t size)
  {
  	struct platform_device *pdev;
  	int error;
  
  	pdev = platform_device_alloc(driver->driver.name, -1);
  	if (!pdev) {
  		error = -ENOMEM;
  		goto err_out;
  	}
  
  	if (res) {
  		error = platform_device_add_resources(pdev, res, n_res);
  		if (error)
  			goto err_pdev_put;
  	}
  
  	if (data) {
  		error = platform_device_add_data(pdev, data, size);
  		if (error)
  			goto err_pdev_put;
  	}
  
  	error = platform_device_add(pdev);
  	if (error)
  		goto err_pdev_put;
  
  	error = platform_driver_probe(driver, probe);
  	if (error)
  		goto err_pdev_del;
  
  	return pdev;
  
  err_pdev_del:
  	platform_device_del(pdev);
  err_pdev_put:
  	platform_device_put(pdev);
  err_out:
  	return ERR_PTR(error);
  }
  EXPORT_SYMBOL_GPL(platform_create_bundle);
a0245f7ad   David Brownell   [PATCH] platform_...
545
546
547
548
549
550
  /* 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)"
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
551
552
  static ssize_t modalias_show(struct device *dev, struct device_attribute *a,
  			     char *buf)
a0245f7ad   David Brownell   [PATCH] platform_...
553
554
  {
  	struct platform_device	*pdev = to_platform_device(dev);
43cc71eed   Kay Sievers   platform: prefix ...
555
556
  	int len = snprintf(buf, PAGE_SIZE, "platform:%s
  ", pdev->name);
a0245f7ad   David Brownell   [PATCH] platform_...
557
558
559
560
561
562
563
564
  
  	return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len;
  }
  
  static struct device_attribute platform_dev_attrs[] = {
  	__ATTR_RO(modalias),
  	__ATTR_NULL,
  };
7eff2e7a8   Kay Sievers   Driver core: chan...
565
  static int platform_uevent(struct device *dev, struct kobj_uevent_env *env)
a0245f7ad   David Brownell   [PATCH] platform_...
566
567
  {
  	struct platform_device	*pdev = to_platform_device(dev);
eca393016   Grant Likely   of: Merge of_plat...
568
569
570
571
572
573
  	int rc;
  
  	/* Some devices have extra OF data and an OF-style MODALIAS */
  	rc = of_device_uevent(dev,env);
  	if (rc != -ENODEV)
  		return rc;
a0245f7ad   David Brownell   [PATCH] platform_...
574

57fee4a58   Eric Miao   platform: introdu...
575
576
  	add_uevent_var(env, "MODALIAS=%s%s", PLATFORM_MODULE_PREFIX,
  		(pdev->id_entry) ? pdev->id_entry->name : pdev->name);
a0245f7ad   David Brownell   [PATCH] platform_...
577
578
  	return 0;
  }
57fee4a58   Eric Miao   platform: introdu...
579
  static const struct platform_device_id *platform_match_id(
831fad2f7   Uwe Kleine-König   Driver core: make...
580
  			const struct platform_device_id *id,
57fee4a58   Eric Miao   platform: introdu...
581
582
583
584
585
586
587
588
589
590
591
  			struct platform_device *pdev)
  {
  	while (id->name[0]) {
  		if (strcmp(pdev->name, id->name) == 0) {
  			pdev->id_entry = id;
  			return id;
  		}
  		id++;
  	}
  	return NULL;
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
592
  /**
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
593
594
595
   * platform_match - bind platform device to platform driver.
   * @dev: device.
   * @drv: driver.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
596
   *
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
597
598
599
600
601
602
603
   * 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.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
604
   */
4a3ad20cc   Greg Kroah-Hartman   Driver core: codi...
605
  static int platform_match(struct device *dev, struct device_driver *drv)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
606
  {
71b3e0c1a   Eric Miao   platform: make be...
607
  	struct platform_device *pdev = to_platform_device(dev);
57fee4a58   Eric Miao   platform: introdu...
608
  	struct platform_driver *pdrv = to_platform_driver(drv);
05212157e   Grant Likely   drivercore/of: Ad...
609
610
611
612
613
  	/* Attempt an OF style match first */
  	if (of_driver_match_device(dev, drv))
  		return 1;
  
  	/* Then try to match against the id table */
57fee4a58   Eric Miao   platform: introdu...
614
615
  	if (pdrv->id_table)
  		return platform_match_id(pdrv->id_table, pdev) != NULL;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
616

57fee4a58   Eric Miao   platform: introdu...
617
  	/* fall-back to driver name match */
1e0b2cf93   Kay Sievers   driver core: stru...
618
  	return (strcmp(pdev->name, drv->name) == 0);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
619
  }
25e18499e   Rafael J. Wysocki   Implement new sus...
620
621
622
  #ifdef CONFIG_PM_SLEEP
  
  static int platform_legacy_suspend(struct device *dev, pm_message_t mesg)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
623
  {
783ea7d4e   Magnus Damm   Driver Core: Rewo...
624
625
  	struct platform_driver *pdrv = to_platform_driver(dev->driver);
  	struct platform_device *pdev = to_platform_device(dev);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
626
  	int ret = 0;
783ea7d4e   Magnus Damm   Driver Core: Rewo...
627
628
  	if (dev->driver && pdrv->suspend)
  		ret = pdrv->suspend(pdev, mesg);
386415d88   David Brownell   PM: platform_bus ...
629
630
631
  
  	return ret;
  }
25e18499e   Rafael J. Wysocki   Implement new sus...
632
  static int platform_legacy_resume(struct device *dev)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
633
  {
783ea7d4e   Magnus Damm   Driver Core: Rewo...
634
635
  	struct platform_driver *pdrv = to_platform_driver(dev->driver);
  	struct platform_device *pdev = to_platform_device(dev);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
636
  	int ret = 0;
783ea7d4e   Magnus Damm   Driver Core: Rewo...
637
638
  	if (dev->driver && pdrv->resume)
  		ret = pdrv->resume(pdev);
9480e307c   Russell King   [PATCH] DRIVER MO...
639

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
640
641
  	return ret;
  }
25e18499e   Rafael J. Wysocki   Implement new sus...
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
  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);
  }
9d7302299   Magnus Damm   PM: Run-time PM p...
660
661
662
663
664
665
  #else /* !CONFIG_PM_SLEEP */
  
  #define platform_pm_prepare		NULL
  #define platform_pm_complete		NULL
  
  #endif /* !CONFIG_PM_SLEEP */
25e18499e   Rafael J. Wysocki   Implement new sus...
666
  #ifdef CONFIG_SUSPEND
190e8370b   Kevin Hilman   platform_bus: all...
667
  int __weak platform_pm_suspend(struct device *dev)
25e18499e   Rafael J. Wysocki   Implement new sus...
668
669
670
  {
  	struct device_driver *drv = dev->driver;
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
671
672
673
674
  	if (!drv)
  		return 0;
  
  	if (drv->pm) {
25e18499e   Rafael J. Wysocki   Implement new sus...
675
676
677
678
679
680
681
682
  		if (drv->pm->suspend)
  			ret = drv->pm->suspend(dev);
  	} else {
  		ret = platform_legacy_suspend(dev, PMSG_SUSPEND);
  	}
  
  	return ret;
  }
190e8370b   Kevin Hilman   platform_bus: all...
683
  int __weak platform_pm_suspend_noirq(struct device *dev)
25e18499e   Rafael J. Wysocki   Implement new sus...
684
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
685
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
686
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
687
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
688
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
689
690
691
  	if (drv->pm) {
  		if (drv->pm->suspend_noirq)
  			ret = drv->pm->suspend_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
692
693
694
695
  	}
  
  	return ret;
  }
190e8370b   Kevin Hilman   platform_bus: all...
696
  int __weak platform_pm_resume(struct device *dev)
25e18499e   Rafael J. Wysocki   Implement new sus...
697
698
699
  {
  	struct device_driver *drv = dev->driver;
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
700
701
702
703
  	if (!drv)
  		return 0;
  
  	if (drv->pm) {
25e18499e   Rafael J. Wysocki   Implement new sus...
704
705
706
707
708
709
710
711
  		if (drv->pm->resume)
  			ret = drv->pm->resume(dev);
  	} else {
  		ret = platform_legacy_resume(dev);
  	}
  
  	return ret;
  }
190e8370b   Kevin Hilman   platform_bus: all...
712
  int __weak platform_pm_resume_noirq(struct device *dev)
25e18499e   Rafael J. Wysocki   Implement new sus...
713
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
714
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
715
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
716
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
717
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
718
719
720
  	if (drv->pm) {
  		if (drv->pm->resume_noirq)
  			ret = drv->pm->resume_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
  	}
  
  	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)
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
757
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
758
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
759
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
760
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
761
762
763
  	if (drv->pm) {
  		if (drv->pm->freeze_noirq)
  			ret = drv->pm->freeze_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
764
765
766
767
768
769
770
771
772
  	}
  
  	return ret;
  }
  
  static int platform_pm_thaw(struct device *dev)
  {
  	struct device_driver *drv = dev->driver;
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
773
774
775
776
  	if (!drv)
  		return 0;
  
  	if (drv->pm) {
25e18499e   Rafael J. Wysocki   Implement new sus...
777
778
779
780
781
782
783
784
785
786
787
  		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)
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
788
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
789
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
790
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
791
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
792
793
794
  	if (drv->pm) {
  		if (drv->pm->thaw_noirq)
  			ret = drv->pm->thaw_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
795
796
797
798
799
800
801
802
803
  	}
  
  	return ret;
  }
  
  static int platform_pm_poweroff(struct device *dev)
  {
  	struct device_driver *drv = dev->driver;
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
804
805
806
807
  	if (!drv)
  		return 0;
  
  	if (drv->pm) {
25e18499e   Rafael J. Wysocki   Implement new sus...
808
809
810
811
812
813
814
815
816
817
818
  		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)
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
819
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
820
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
821
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
822
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
823
824
825
  	if (drv->pm) {
  		if (drv->pm->poweroff_noirq)
  			ret = drv->pm->poweroff_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
826
827
828
829
830
831
832
833
834
  	}
  
  	return ret;
  }
  
  static int platform_pm_restore(struct device *dev)
  {
  	struct device_driver *drv = dev->driver;
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
835
836
837
838
  	if (!drv)
  		return 0;
  
  	if (drv->pm) {
25e18499e   Rafael J. Wysocki   Implement new sus...
839
840
841
842
843
844
845
846
847
848
849
  		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)
  {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
850
  	struct device_driver *drv = dev->driver;
25e18499e   Rafael J. Wysocki   Implement new sus...
851
  	int ret = 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
852
  	if (!drv)
25e18499e   Rafael J. Wysocki   Implement new sus...
853
  		return 0;
adf094931   Rafael J. Wysocki   PM: Simplify the ...
854
855
856
  	if (drv->pm) {
  		if (drv->pm->restore_noirq)
  			ret = drv->pm->restore_noirq(dev);
25e18499e   Rafael J. Wysocki   Implement new sus...
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
  	}
  
  	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 */
9d7302299   Magnus Damm   PM: Run-time PM p...
874
875
876
877
  #ifdef CONFIG_PM_RUNTIME
  
  int __weak platform_pm_runtime_suspend(struct device *dev)
  {
543f2503a   Mark Brown   PM / platform_bus...
878
  	return pm_generic_runtime_suspend(dev);
9d7302299   Magnus Damm   PM: Run-time PM p...
879
880
881
882
  };
  
  int __weak platform_pm_runtime_resume(struct device *dev)
  {
543f2503a   Mark Brown   PM / platform_bus...
883
  	return pm_generic_runtime_resume(dev);
9d7302299   Magnus Damm   PM: Run-time PM p...
884
885
886
887
  };
  
  int __weak platform_pm_runtime_idle(struct device *dev)
  {
543f2503a   Mark Brown   PM / platform_bus...
888
  	return pm_generic_runtime_idle(dev);
9d7302299   Magnus Damm   PM: Run-time PM p...
889
890
891
892
893
894
895
896
897
  };
  
  #else /* !CONFIG_PM_RUNTIME */
  
  #define platform_pm_runtime_suspend NULL
  #define platform_pm_runtime_resume NULL
  #define platform_pm_runtime_idle NULL
  
  #endif /* !CONFIG_PM_RUNTIME */
d9ab77161   Dmitry Torokhov   Driver Core: Make...
898
  static const struct dev_pm_ops platform_dev_pm_ops = {
adf094931   Rafael J. Wysocki   PM: Simplify the ...
899
900
901
902
903
904
905
906
  	.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,
25e18499e   Rafael J. Wysocki   Implement new sus...
907
908
909
910
911
912
  	.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,
9d7302299   Magnus Damm   PM: Run-time PM p...
913
914
915
  	.runtime_suspend = platform_pm_runtime_suspend,
  	.runtime_resume = platform_pm_runtime_resume,
  	.runtime_idle = platform_pm_runtime_idle,
25e18499e   Rafael J. Wysocki   Implement new sus...
916
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
917
918
  struct bus_type platform_bus_type = {
  	.name		= "platform",
a0245f7ad   David Brownell   [PATCH] platform_...
919
  	.dev_attrs	= platform_dev_attrs,
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
920
  	.match		= platform_match,
a0245f7ad   David Brownell   [PATCH] platform_...
921
  	.uevent		= platform_uevent,
9d7302299   Magnus Damm   PM: Run-time PM p...
922
  	.pm		= &platform_dev_pm_ops,
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
923
  };
a96b20420   Dmitry Torokhov   [PATCH] Driver Co...
924
  EXPORT_SYMBOL_GPL(platform_bus_type);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
925
926
927
  
  int __init platform_bus_init(void)
  {
fbfb14455   Cornelia Huck   driver core fixes...
928
  	int error;
13977091a   Magnus Damm   Driver Core: earl...
929
  	early_platform_cleanup();
fbfb14455   Cornelia Huck   driver core fixes...
930
931
932
933
934
935
936
  	error = device_register(&platform_bus);
  	if (error)
  		return error;
  	error =  bus_register(&platform_bus_type);
  	if (error)
  		device_unregister(&platform_bus);
  	return error;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
  }
  
  #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;
  	}
e88a0c2ca   James Bottomley   drivers: fix dma_...
956
  	return mask;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
957
958
959
  }
  EXPORT_SYMBOL_GPL(dma_get_required_mask);
  #endif
13977091a   Magnus Damm   Driver Core: earl...
960
961
962
963
964
  
  static __initdata LIST_HEAD(early_platform_driver_list);
  static __initdata LIST_HEAD(early_platform_device_list);
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
965
   * early_platform_driver_register - register early platform driver
d86c1302c   Randy Dunlap   Driver core: plat...
966
   * @epdrv: early_platform driver structure
13977091a   Magnus Damm   Driver Core: earl...
967
   * @buf: string passed from early_param()
4d26e139f   Magnus Damm   Driver core: Earl...
968
969
   *
   * Helper function for early_platform_init() / early_platform_init_buffer()
13977091a   Magnus Damm   Driver Core: earl...
970
971
972
973
   */
  int __init early_platform_driver_register(struct early_platform_driver *epdrv,
  					  char *buf)
  {
c60e0504c   Magnus Damm   Driver Core: Earl...
974
  	char *tmp;
13977091a   Magnus Damm   Driver Core: earl...
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
  	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);
c60e0504c   Magnus Damm   Driver Core: Earl...
992
993
  		/* Allow passing parameters after device name */
  		if (buf[n] == '\0' || buf[n] == ',')
13977091a   Magnus Damm   Driver Core: earl...
994
  			epdrv->requested_id = -1;
c60e0504c   Magnus Damm   Driver Core: Earl...
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
  		else {
  			epdrv->requested_id = simple_strtoul(&buf[n + 1],
  							     &tmp, 10);
  
  			if (buf[n] != '.' || (tmp == &buf[n + 1])) {
  				epdrv->requested_id = EARLY_PLATFORM_ID_ERROR;
  				n = 0;
  			} else
  				n += strcspn(&buf[n + 1], ",") + 1;
  		}
  
  		if (buf[n] == ',')
  			n++;
  
  		if (epdrv->bufsize) {
  			memcpy(epdrv->buffer, &buf[n],
  			       min_t(int, epdrv->bufsize, strlen(&buf[n]) + 1));
  			epdrv->buffer[epdrv->bufsize - 1] = '\0';
  		}
13977091a   Magnus Damm   Driver Core: earl...
1014
1015
1016
1017
1018
1019
  	}
  
  	return 0;
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1020
   * early_platform_add_devices - adds a number of early platform devices
13977091a   Magnus Damm   Driver Core: earl...
1021
1022
   * @devs: array of early platform devices to add
   * @num: number of early platform devices in array
4d26e139f   Magnus Damm   Driver core: Earl...
1023
1024
1025
   *
   * Used by early architecture code to register early platform devices and
   * their platform data.
13977091a   Magnus Damm   Driver Core: earl...
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
   */
  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);
  		}
  	}
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1045
   * early_platform_driver_register_all - register early platform drivers
13977091a   Magnus Damm   Driver Core: earl...
1046
   * @class_str: string to identify early platform driver class
4d26e139f   Magnus Damm   Driver core: Earl...
1047
1048
1049
1050
   *
   * Used by architecture code to register all early platform drivers
   * for a certain class. If omitted then only early platform drivers
   * with matching kernel command line class parameters will be registered.
13977091a   Magnus Damm   Driver Core: earl...
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
   */
  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);
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1072
   * early_platform_match - find early platform device matching driver
d86c1302c   Randy Dunlap   Driver core: plat...
1073
   * @epdrv: early platform driver structure
13977091a   Magnus Damm   Driver Core: earl...
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
   * @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;
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1090
   * early_platform_left - check if early platform driver has matching devices
d86c1302c   Randy Dunlap   Driver core: plat...
1091
   * @epdrv: early platform driver structure
13977091a   Magnus Damm   Driver Core: earl...
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
   * @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;
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1108
   * early_platform_driver_probe_id - probe drivers matching class_str and id
13977091a   Magnus Damm   Driver Core: earl...
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
   * @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
  ",
  				   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) {
a636ee7fb   Paul Mundt   driver core: Earl...
1161
1162
1163
1164
1165
  			/*
  			 * Set up a sensible init_name to enable
  			 * dev_name() and others to be used before the
  			 * rest of the driver core is initialized.
  			 */
06fe53beb   Paul Mundt   driver core: Earl...
1166
  			if (!match->dev.init_name && slab_is_available()) {
a636ee7fb   Paul Mundt   driver core: Earl...
1167
  				if (match->id != -1)
bd05086bb   Paul Mundt   driver core: Conv...
1168
1169
1170
1171
  					match->dev.init_name =
  						kasprintf(GFP_KERNEL, "%s.%d",
  							  match->name,
  							  match->id);
a636ee7fb   Paul Mundt   driver core: Earl...
1172
  				else
bd05086bb   Paul Mundt   driver core: Conv...
1173
1174
1175
  					match->dev.init_name =
  						kasprintf(GFP_KERNEL, "%s",
  							  match->name);
a636ee7fb   Paul Mundt   driver core: Earl...
1176

a636ee7fb   Paul Mundt   driver core: Earl...
1177
1178
1179
  				if (!match->dev.init_name)
  					return -ENOMEM;
  			}
bd05086bb   Paul Mundt   driver core: Conv...
1180

13977091a   Magnus Damm   Driver Core: earl...
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
  			if (epdrv->pdrv->probe(match))
  				pr_warning("%s: unable to probe %s early.
  ",
  					   class_str, match->name);
  			else
  				n++;
  		}
  
  		if (n >= nr_probe)
  			break;
  	}
  
  	if (left)
  		return n;
  	else
  		return -ENODEV;
  }
  
  /**
4d26e139f   Magnus Damm   Driver core: Earl...
1200
   * early_platform_driver_probe - probe a class of registered drivers
13977091a   Magnus Damm   Driver Core: earl...
1201
1202
1203
   * @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
4d26e139f   Magnus Damm   Driver core: Earl...
1204
1205
1206
1207
   *
   * Used by architecture code to probe registered early platform drivers
   * within a certain class. For probe to happen a registered early platform
   * device matching a registered early platform driver is needed.
13977091a   Magnus Damm   Driver Core: earl...
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
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
   */
  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));
  	}
  }