]>
Commit | Line | Data |
---|---|---|
989d42e8 | 1 | // SPDX-License-Identifier: GPL-2.0 |
1da177e4 LT |
2 | /* |
3 | * platform.c - platform 'pseudo' bus for legacy devices | |
4 | * | |
5 | * Copyright (c) 2002-3 Patrick Mochel | |
6 | * Copyright (c) 2002-3 Open Source Development Labs | |
7 | * | |
fe34c89d | 8 | * Please see Documentation/driver-api/driver-model/platform.rst for more |
1da177e4 LT |
9 | * information. |
10 | */ | |
11 | ||
daa41226 | 12 | #include <linux/string.h> |
d052d1be | 13 | #include <linux/platform_device.h> |
05212157 | 14 | #include <linux/of_device.h> |
9ec36caf | 15 | #include <linux/of_irq.h> |
1da177e4 LT |
16 | #include <linux/module.h> |
17 | #include <linux/init.h> | |
18 | #include <linux/dma-mapping.h> | |
57c8a661 | 19 | #include <linux/memblock.h> |
1da177e4 | 20 | #include <linux/err.h> |
4e57b681 | 21 | #include <linux/slab.h> |
9d730229 | 22 | #include <linux/pm_runtime.h> |
f48c767c | 23 | #include <linux/pm_domain.h> |
689ae231 | 24 | #include <linux/idr.h> |
91e56878 | 25 | #include <linux/acpi.h> |
86be408b | 26 | #include <linux/clk/clk-conf.h> |
3d713e0e | 27 | #include <linux/limits.h> |
00bbc1d8 | 28 | #include <linux/property.h> |
967d3010 | 29 | #include <linux/kmemleak.h> |
39cc539f | 30 | #include <linux/types.h> |
1da177e4 | 31 | |
a1bdc7aa | 32 | #include "base.h" |
bed2b42d | 33 | #include "power/power.h" |
a1bdc7aa | 34 | |
689ae231 JD |
35 | /* For automatically allocated device IDs */ |
36 | static DEFINE_IDA(platform_devid_ida); | |
37 | ||
1da177e4 | 38 | struct device platform_bus = { |
1e0b2cf9 | 39 | .init_name = "platform", |
1da177e4 | 40 | }; |
a96b2042 | 41 | EXPORT_SYMBOL_GPL(platform_bus); |
1da177e4 LT |
42 | |
43 | /** | |
4a3ad20c GKH |
44 | * platform_get_resource - get a resource for a device |
45 | * @dev: platform device | |
46 | * @type: resource type | |
47 | * @num: resource index | |
1da177e4 | 48 | */ |
4a3ad20c GKH |
49 | struct resource *platform_get_resource(struct platform_device *dev, |
50 | unsigned int type, unsigned int num) | |
1da177e4 | 51 | { |
39cc539f | 52 | u32 i; |
1da177e4 LT |
53 | |
54 | for (i = 0; i < dev->num_resources; i++) { | |
55 | struct resource *r = &dev->resource[i]; | |
56 | ||
c9f66169 MD |
57 | if (type == resource_type(r) && num-- == 0) |
58 | return r; | |
1da177e4 LT |
59 | } |
60 | return NULL; | |
61 | } | |
a96b2042 | 62 | EXPORT_SYMBOL_GPL(platform_get_resource); |
1da177e4 | 63 | |
bb6243b4 | 64 | #ifdef CONFIG_HAS_IOMEM |
7945f929 BG |
65 | /** |
66 | * devm_platform_ioremap_resource - call devm_ioremap_resource() for a platform | |
67 | * device | |
68 | * | |
69 | * @pdev: platform device to use both for memory resource lookup as well as | |
7067c96e | 70 | * resource management |
7945f929 BG |
71 | * @index: resource index |
72 | */ | |
73 | void __iomem *devm_platform_ioremap_resource(struct platform_device *pdev, | |
74 | unsigned int index) | |
75 | { | |
76 | struct resource *res; | |
77 | ||
78 | res = platform_get_resource(pdev, IORESOURCE_MEM, index); | |
79 | return devm_ioremap_resource(&pdev->dev, res); | |
80 | } | |
81 | EXPORT_SYMBOL_GPL(devm_platform_ioremap_resource); | |
bb6243b4 BG |
82 | |
83 | /** | |
84 | * devm_platform_ioremap_resource_wc - write-combined variant of | |
85 | * devm_platform_ioremap_resource() | |
86 | * | |
87 | * @pdev: platform device to use both for memory resource lookup as well as | |
88 | * resource management | |
89 | * @index: resource index | |
90 | */ | |
91 | void __iomem *devm_platform_ioremap_resource_wc(struct platform_device *pdev, | |
92 | unsigned int index) | |
93 | { | |
94 | struct resource *res; | |
95 | ||
96 | res = platform_get_resource(pdev, IORESOURCE_MEM, index); | |
97 | return devm_ioremap_resource_wc(&pdev->dev, res); | |
98 | } | |
c9c8641d BG |
99 | |
100 | /** | |
101 | * devm_platform_ioremap_resource_byname - call devm_ioremap_resource for | |
102 | * a platform device, retrieve the | |
103 | * resource by name | |
104 | * | |
105 | * @pdev: platform device to use both for memory resource lookup as well as | |
106 | * resource management | |
107 | * @name: name of the resource | |
108 | */ | |
109 | void __iomem * | |
110 | devm_platform_ioremap_resource_byname(struct platform_device *pdev, | |
111 | const char *name) | |
112 | { | |
113 | struct resource *res; | |
114 | ||
115 | res = platform_get_resource_byname(pdev, IORESOURCE_MEM, name); | |
116 | return devm_ioremap_resource(&pdev->dev, res); | |
117 | } | |
118 | EXPORT_SYMBOL_GPL(devm_platform_ioremap_resource_byname); | |
837ccda3 | 119 | #endif /* CONFIG_HAS_IOMEM */ |
7945f929 | 120 | |
ec4e2906 UKK |
121 | /** |
122 | * platform_get_irq_optional - get an optional IRQ for a device | |
123 | * @dev: platform device | |
124 | * @num: IRQ number index | |
125 | * | |
126 | * Gets an IRQ for a platform device. Device drivers should check the return | |
127 | * value for errors so as to not pass a negative integer value to the | |
128 | * request_irq() APIs. This is the same as platform_get_irq(), except that it | |
129 | * does not print an error message if an IRQ can not be obtained. | |
130 | * | |
131 | * Example: | |
132 | * int irq = platform_get_irq_optional(pdev, 0); | |
133 | * if (irq < 0) | |
134 | * return irq; | |
135 | * | |
136 | * Return: IRQ number on success, negative error number on failure. | |
137 | */ | |
138 | int platform_get_irq_optional(struct platform_device *dev, unsigned int num) | |
1da177e4 | 139 | { |
5cf8f7db AL |
140 | #ifdef CONFIG_SPARC |
141 | /* sparc does not have irqs represented as IORESOURCE_IRQ resources */ | |
142 | if (!dev || num >= dev->archdata.num_irqs) | |
143 | return -ENXIO; | |
144 | return dev->archdata.irqs[num]; | |
145 | #else | |
9ec36caf | 146 | struct resource *r; |
71564a26 | 147 | int ret; |
aff008ad | 148 | |
71564a26 | 149 | if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { |
aff008ad | 150 | ret = of_irq_get(dev->dev.of_node, num); |
e330b9a6 | 151 | if (ret > 0 || ret == -EPROBE_DEFER) |
aff008ad GR |
152 | return ret; |
153 | } | |
9ec36caf RH |
154 | |
155 | r = platform_get_resource(dev, IORESOURCE_IRQ, num); | |
d44fa3d4 AVF |
156 | if (has_acpi_companion(&dev->dev)) { |
157 | if (r && r->flags & IORESOURCE_DISABLED) { | |
d44fa3d4 AVF |
158 | ret = acpi_irq_get(ACPI_HANDLE(&dev->dev), num, r); |
159 | if (ret) | |
160 | return ret; | |
161 | } | |
162 | } | |
163 | ||
7085a740 LW |
164 | /* |
165 | * The resources may pass trigger flags to the irqs that need | |
166 | * to be set up. It so happens that the trigger flags for | |
167 | * IORESOURCE_BITS correspond 1-to-1 to the IRQF_TRIGGER* | |
168 | * settings. | |
169 | */ | |
60ca5e0d GR |
170 | if (r && r->flags & IORESOURCE_BITS) { |
171 | struct irq_data *irqd; | |
172 | ||
173 | irqd = irq_get_irq_data(r->start); | |
174 | if (!irqd) | |
175 | return -ENXIO; | |
176 | irqd_set_trigger_type(irqd, r->flags & IORESOURCE_BITS); | |
177 | } | |
1da177e4 | 178 | |
daaef255 EG |
179 | if (r) |
180 | return r->start; | |
181 | ||
182 | /* | |
183 | * For the index 0 interrupt, allow falling back to GpioInt | |
184 | * resources. While a device could have both Interrupt and GpioInt | |
185 | * resources, making this fallback ambiguous, in many common cases | |
186 | * the device will only expose one IRQ, and this fallback | |
187 | * allows a common code path across either kind of resource. | |
188 | */ | |
46c42d84 | 189 | if (num == 0 && has_acpi_companion(&dev->dev)) { |
71564a26 | 190 | ret = acpi_dev_gpio_irq_get(ACPI_COMPANION(&dev->dev), num); |
46c42d84 BN |
191 | /* Our callers expect -ENXIO for missing IRQs. */ |
192 | if (ret >= 0 || ret == -EPROBE_DEFER) | |
193 | return ret; | |
194 | } | |
daaef255 EG |
195 | |
196 | return -ENXIO; | |
5cf8f7db | 197 | #endif |
1da177e4 | 198 | } |
ec4e2906 | 199 | EXPORT_SYMBOL_GPL(platform_get_irq_optional); |
7723f4c5 SB |
200 | |
201 | /** | |
202 | * platform_get_irq - get an IRQ for a device | |
203 | * @dev: platform device | |
204 | * @num: IRQ number index | |
205 | * | |
206 | * Gets an IRQ for a platform device and prints an error message if finding the | |
207 | * IRQ fails. Device drivers should check the return value for errors so as to | |
208 | * not pass a negative integer value to the request_irq() APIs. | |
209 | * | |
210 | * Example: | |
211 | * int irq = platform_get_irq(pdev, 0); | |
212 | * if (irq < 0) | |
213 | * return irq; | |
214 | * | |
215 | * Return: IRQ number on success, negative error number on failure. | |
216 | */ | |
217 | int platform_get_irq(struct platform_device *dev, unsigned int num) | |
218 | { | |
219 | int ret; | |
220 | ||
ec4e2906 | 221 | ret = platform_get_irq_optional(dev, num); |
7723f4c5 SB |
222 | if (ret < 0 && ret != -EPROBE_DEFER) |
223 | dev_err(&dev->dev, "IRQ index %u not found\n", num); | |
224 | ||
225 | return ret; | |
226 | } | |
a96b2042 | 227 | EXPORT_SYMBOL_GPL(platform_get_irq); |
1da177e4 | 228 | |
4b83555d SB |
229 | /** |
230 | * platform_irq_count - Count the number of IRQs a platform device uses | |
231 | * @dev: platform device | |
232 | * | |
233 | * Return: Number of IRQs a platform device uses or EPROBE_DEFER | |
234 | */ | |
235 | int platform_irq_count(struct platform_device *dev) | |
236 | { | |
237 | int ret, nr = 0; | |
238 | ||
ec4e2906 | 239 | while ((ret = platform_get_irq_optional(dev, nr)) >= 0) |
4b83555d SB |
240 | nr++; |
241 | ||
242 | if (ret == -EPROBE_DEFER) | |
243 | return ret; | |
244 | ||
245 | return nr; | |
246 | } | |
247 | EXPORT_SYMBOL_GPL(platform_irq_count); | |
248 | ||
1da177e4 | 249 | /** |
4a3ad20c GKH |
250 | * platform_get_resource_byname - get a resource for a device by name |
251 | * @dev: platform device | |
252 | * @type: resource type | |
253 | * @name: resource name | |
1da177e4 | 254 | */ |
4a3ad20c | 255 | struct resource *platform_get_resource_byname(struct platform_device *dev, |
c0afe7ba LW |
256 | unsigned int type, |
257 | const char *name) | |
1da177e4 | 258 | { |
39cc539f | 259 | u32 i; |
1da177e4 LT |
260 | |
261 | for (i = 0; i < dev->num_resources; i++) { | |
262 | struct resource *r = &dev->resource[i]; | |
263 | ||
1b8cb929 PU |
264 | if (unlikely(!r->name)) |
265 | continue; | |
266 | ||
c9f66169 MD |
267 | if (type == resource_type(r) && !strcmp(r->name, name)) |
268 | return r; | |
1da177e4 LT |
269 | } |
270 | return NULL; | |
271 | } | |
a96b2042 | 272 | EXPORT_SYMBOL_GPL(platform_get_resource_byname); |
1da177e4 | 273 | |
f1da567f HG |
274 | static int __platform_get_irq_byname(struct platform_device *dev, |
275 | const char *name) | |
1da177e4 | 276 | { |
ad69674e | 277 | struct resource *r; |
71564a26 | 278 | int ret; |
ad69674e | 279 | |
aff008ad | 280 | if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { |
aff008ad | 281 | ret = of_irq_get_byname(dev->dev.of_node, name); |
e330b9a6 | 282 | if (ret > 0 || ret == -EPROBE_DEFER) |
aff008ad GR |
283 | return ret; |
284 | } | |
1da177e4 | 285 | |
ad69674e | 286 | r = platform_get_resource_byname(dev, IORESOURCE_IRQ, name); |
7723f4c5 SB |
287 | if (r) |
288 | return r->start; | |
289 | ||
7723f4c5 | 290 | return -ENXIO; |
1da177e4 | 291 | } |
f1da567f HG |
292 | |
293 | /** | |
294 | * platform_get_irq_byname - get an IRQ for a device by name | |
295 | * @dev: platform device | |
296 | * @name: IRQ name | |
297 | * | |
298 | * Get an IRQ like platform_get_irq(), but then by name rather then by index. | |
299 | * | |
300 | * Return: IRQ number on success, negative error number on failure. | |
301 | */ | |
302 | int platform_get_irq_byname(struct platform_device *dev, const char *name) | |
303 | { | |
304 | int ret; | |
305 | ||
306 | ret = __platform_get_irq_byname(dev, name); | |
307 | if (ret < 0 && ret != -EPROBE_DEFER) | |
308 | dev_err(&dev->dev, "IRQ %s not found\n", name); | |
309 | ||
310 | return ret; | |
311 | } | |
a96b2042 | 312 | EXPORT_SYMBOL_GPL(platform_get_irq_byname); |
1da177e4 | 313 | |
f1da567f HG |
314 | /** |
315 | * platform_get_irq_byname_optional - get an optional IRQ for a device by name | |
316 | * @dev: platform device | |
317 | * @name: IRQ name | |
318 | * | |
319 | * Get an optional IRQ by name like platform_get_irq_byname(). Except that it | |
320 | * does not print an error message if an IRQ can not be obtained. | |
321 | * | |
322 | * Return: IRQ number on success, negative error number on failure. | |
323 | */ | |
324 | int platform_get_irq_byname_optional(struct platform_device *dev, | |
325 | const char *name) | |
326 | { | |
327 | return __platform_get_irq_byname(dev, name); | |
328 | } | |
329 | EXPORT_SYMBOL_GPL(platform_get_irq_byname_optional); | |
330 | ||
1da177e4 | 331 | /** |
4a3ad20c GKH |
332 | * platform_add_devices - add a numbers of platform devices |
333 | * @devs: array of platform devices to add | |
334 | * @num: number of platform devices in array | |
1da177e4 LT |
335 | */ |
336 | int platform_add_devices(struct platform_device **devs, int num) | |
337 | { | |
338 | int i, ret = 0; | |
339 | ||
340 | for (i = 0; i < num; i++) { | |
341 | ret = platform_device_register(devs[i]); | |
342 | if (ret) { | |
343 | while (--i >= 0) | |
344 | platform_device_unregister(devs[i]); | |
345 | break; | |
346 | } | |
347 | } | |
348 | ||
349 | return ret; | |
350 | } | |
a96b2042 | 351 | EXPORT_SYMBOL_GPL(platform_add_devices); |
1da177e4 | 352 | |
37c12e74 RK |
353 | struct platform_object { |
354 | struct platform_device pdev; | |
1cec24c5 | 355 | char name[]; |
37c12e74 RK |
356 | }; |
357 | ||
cdfee562 CH |
358 | /* |
359 | * Set up default DMA mask for platform devices if the they weren't | |
360 | * previously set by the architecture / DT. | |
361 | */ | |
362 | static void setup_pdev_dma_masks(struct platform_device *pdev) | |
363 | { | |
364 | if (!pdev->dev.coherent_dma_mask) | |
365 | pdev->dev.coherent_dma_mask = DMA_BIT_MASK(32); | |
e3a36eb6 CH |
366 | if (!pdev->dev.dma_mask) { |
367 | pdev->platform_dma_mask = DMA_BIT_MASK(32); | |
368 | pdev->dev.dma_mask = &pdev->platform_dma_mask; | |
369 | } | |
cdfee562 CH |
370 | }; |
371 | ||
1da177e4 | 372 | /** |
3c31f07a | 373 | * platform_device_put - destroy a platform device |
4a3ad20c | 374 | * @pdev: platform device to free |
37c12e74 | 375 | * |
4a3ad20c GKH |
376 | * Free all memory associated with a platform device. This function must |
377 | * _only_ be externally called in error cases. All other usage is a bug. | |
37c12e74 RK |
378 | */ |
379 | void platform_device_put(struct platform_device *pdev) | |
380 | { | |
99fef587 | 381 | if (!IS_ERR_OR_NULL(pdev)) |
37c12e74 RK |
382 | put_device(&pdev->dev); |
383 | } | |
384 | EXPORT_SYMBOL_GPL(platform_device_put); | |
385 | ||
386 | static void platform_device_release(struct device *dev) | |
387 | { | |
4a3ad20c GKH |
388 | struct platform_object *pa = container_of(dev, struct platform_object, |
389 | pdev.dev); | |
37c12e74 | 390 | |
7096d042 | 391 | of_device_node_put(&pa->pdev.dev); |
37c12e74 | 392 | kfree(pa->pdev.dev.platform_data); |
e710d7d5 | 393 | kfree(pa->pdev.mfd_cell); |
37c12e74 | 394 | kfree(pa->pdev.resource); |
3d713e0e | 395 | kfree(pa->pdev.driver_override); |
37c12e74 RK |
396 | kfree(pa); |
397 | } | |
398 | ||
399 | /** | |
3c31f07a | 400 | * platform_device_alloc - create a platform device |
4a3ad20c GKH |
401 | * @name: base name of the device we're adding |
402 | * @id: instance id | |
37c12e74 | 403 | * |
4a3ad20c GKH |
404 | * Create a platform device object which can have other objects attached |
405 | * to it, and which will have attached objects freed when it is released. | |
37c12e74 | 406 | */ |
1359555e | 407 | struct platform_device *platform_device_alloc(const char *name, int id) |
37c12e74 RK |
408 | { |
409 | struct platform_object *pa; | |
410 | ||
1cec24c5 | 411 | pa = kzalloc(sizeof(*pa) + strlen(name) + 1, GFP_KERNEL); |
37c12e74 RK |
412 | if (pa) { |
413 | strcpy(pa->name, name); | |
414 | pa->pdev.name = pa->name; | |
415 | pa->pdev.id = id; | |
416 | device_initialize(&pa->pdev.dev); | |
417 | pa->pdev.dev.release = platform_device_release; | |
cdfee562 | 418 | setup_pdev_dma_masks(&pa->pdev); |
37c12e74 RK |
419 | } |
420 | ||
93ce3061 | 421 | return pa ? &pa->pdev : NULL; |
37c12e74 RK |
422 | } |
423 | EXPORT_SYMBOL_GPL(platform_device_alloc); | |
424 | ||
425 | /** | |
3c31f07a | 426 | * platform_device_add_resources - add resources to a platform device |
4a3ad20c GKH |
427 | * @pdev: platform device allocated by platform_device_alloc to add resources to |
428 | * @res: set of resources that needs to be allocated for the device | |
429 | * @num: number of resources | |
37c12e74 | 430 | * |
4a3ad20c GKH |
431 | * Add a copy of the resources to the platform device. The memory |
432 | * associated with the resources will be freed when the platform device is | |
433 | * released. | |
37c12e74 | 434 | */ |
4a3ad20c | 435 | int platform_device_add_resources(struct platform_device *pdev, |
0b7f1a7e | 436 | const struct resource *res, unsigned int num) |
37c12e74 | 437 | { |
cea89623 | 438 | struct resource *r = NULL; |
37c12e74 | 439 | |
cea89623 UKK |
440 | if (res) { |
441 | r = kmemdup(res, sizeof(struct resource) * num, GFP_KERNEL); | |
442 | if (!r) | |
443 | return -ENOMEM; | |
37c12e74 | 444 | } |
cea89623 | 445 | |
4a03d6f7 | 446 | kfree(pdev->resource); |
cea89623 UKK |
447 | pdev->resource = r; |
448 | pdev->num_resources = num; | |
449 | return 0; | |
37c12e74 RK |
450 | } |
451 | EXPORT_SYMBOL_GPL(platform_device_add_resources); | |
452 | ||
453 | /** | |
3c31f07a | 454 | * platform_device_add_data - add platform-specific data to a platform device |
4a3ad20c GKH |
455 | * @pdev: platform device allocated by platform_device_alloc to add resources to |
456 | * @data: platform specific data for this platform device | |
457 | * @size: size of platform specific data | |
37c12e74 | 458 | * |
4a3ad20c GKH |
459 | * Add a copy of platform specific data to the platform device's |
460 | * platform_data pointer. The memory associated with the platform data | |
461 | * will be freed when the platform device is released. | |
37c12e74 | 462 | */ |
4a3ad20c GKH |
463 | int platform_device_add_data(struct platform_device *pdev, const void *data, |
464 | size_t size) | |
37c12e74 | 465 | { |
27a33f9e | 466 | void *d = NULL; |
5cfc64ce | 467 | |
27a33f9e UKK |
468 | if (data) { |
469 | d = kmemdup(data, size, GFP_KERNEL); | |
470 | if (!d) | |
471 | return -ENOMEM; | |
37c12e74 | 472 | } |
27a33f9e | 473 | |
251e031d | 474 | kfree(pdev->dev.platform_data); |
27a33f9e UKK |
475 | pdev->dev.platform_data = d; |
476 | return 0; | |
37c12e74 RK |
477 | } |
478 | EXPORT_SYMBOL_GPL(platform_device_add_data); | |
479 | ||
00bbc1d8 MW |
480 | /** |
481 | * platform_device_add_properties - add built-in properties to a platform device | |
482 | * @pdev: platform device to add properties to | |
f4d05266 | 483 | * @properties: null terminated array of properties to add |
00bbc1d8 | 484 | * |
f4d05266 HK |
485 | * The function will take deep copy of @properties and attach the copy to the |
486 | * platform device. The memory associated with properties will be freed when the | |
487 | * platform device is released. | |
00bbc1d8 MW |
488 | */ |
489 | int platform_device_add_properties(struct platform_device *pdev, | |
277036f0 | 490 | const struct property_entry *properties) |
00bbc1d8 | 491 | { |
f4d05266 | 492 | return device_add_properties(&pdev->dev, properties); |
00bbc1d8 MW |
493 | } |
494 | EXPORT_SYMBOL_GPL(platform_device_add_properties); | |
495 | ||
37c12e74 | 496 | /** |
4a3ad20c GKH |
497 | * platform_device_add - add a platform device to device hierarchy |
498 | * @pdev: platform device we're adding | |
1da177e4 | 499 | * |
4a3ad20c GKH |
500 | * This is part 2 of platform_device_register(), though may be called |
501 | * separately _iff_ pdev was allocated by platform_device_alloc(). | |
1da177e4 | 502 | */ |
37c12e74 | 503 | int platform_device_add(struct platform_device *pdev) |
1da177e4 | 504 | { |
39cc539f SS |
505 | u32 i; |
506 | int ret; | |
1da177e4 LT |
507 | |
508 | if (!pdev) | |
509 | return -EINVAL; | |
510 | ||
511 | if (!pdev->dev.parent) | |
512 | pdev->dev.parent = &platform_bus; | |
513 | ||
514 | pdev->dev.bus = &platform_bus_type; | |
515 | ||
689ae231 JD |
516 | switch (pdev->id) { |
517 | default: | |
1e0b2cf9 | 518 | dev_set_name(&pdev->dev, "%s.%d", pdev->name, pdev->id); |
689ae231 JD |
519 | break; |
520 | case PLATFORM_DEVID_NONE: | |
acc0e90f | 521 | dev_set_name(&pdev->dev, "%s", pdev->name); |
689ae231 JD |
522 | break; |
523 | case PLATFORM_DEVID_AUTO: | |
524 | /* | |
525 | * Automatically allocated device ID. We mark it as such so | |
526 | * that we remember it must be freed, and we append a suffix | |
527 | * to avoid namespace collision with explicit IDs. | |
528 | */ | |
529 | ret = ida_simple_get(&platform_devid_ida, 0, 0, GFP_KERNEL); | |
530 | if (ret < 0) | |
5da7f709 | 531 | goto err_out; |
689ae231 JD |
532 | pdev->id = ret; |
533 | pdev->id_auto = true; | |
534 | dev_set_name(&pdev->dev, "%s.%d.auto", pdev->name, pdev->id); | |
535 | break; | |
536 | } | |
1da177e4 LT |
537 | |
538 | for (i = 0; i < pdev->num_resources; i++) { | |
5da7f709 | 539 | struct resource *p, *r = &pdev->resource[i]; |
1da177e4 LT |
540 | |
541 | if (r->name == NULL) | |
1e0b2cf9 | 542 | r->name = dev_name(&pdev->dev); |
1da177e4 LT |
543 | |
544 | p = r->parent; | |
545 | if (!p) { | |
0e6c861f | 546 | if (resource_type(r) == IORESOURCE_MEM) |
1da177e4 | 547 | p = &iomem_resource; |
0e6c861f | 548 | else if (resource_type(r) == IORESOURCE_IO) |
1da177e4 LT |
549 | p = &ioport_resource; |
550 | } | |
551 | ||
25ebcb7d AS |
552 | if (p) { |
553 | ret = insert_resource(p, r); | |
554 | if (ret) { | |
555 | dev_err(&pdev->dev, "failed to claim resource %d: %pR\n", i, r); | |
556 | goto failed; | |
557 | } | |
5da7f709 | 558 | } |
1da177e4 LT |
559 | } |
560 | ||
561 | pr_debug("Registering platform device '%s'. Parent at %s\n", | |
1e0b2cf9 | 562 | dev_name(&pdev->dev), dev_name(pdev->dev.parent)); |
1da177e4 | 563 | |
e3915532 | 564 | ret = device_add(&pdev->dev); |
8b2dceba GKH |
565 | if (ret == 0) |
566 | return ret; | |
567 | ||
5da7f709 | 568 | failed: |
8b2dceba GKH |
569 | if (pdev->id_auto) { |
570 | ida_simple_remove(&platform_devid_ida, pdev->id); | |
571 | pdev->id = PLATFORM_DEVID_AUTO; | |
572 | } | |
573 | ||
0707cfa5 | 574 | while (i--) { |
8b2dceba | 575 | struct resource *r = &pdev->resource[i]; |
7f5dcaf1 | 576 | if (r->parent) |
8b2dceba GKH |
577 | release_resource(r); |
578 | } | |
c9f66169 | 579 | |
5da7f709 | 580 | err_out: |
1da177e4 LT |
581 | return ret; |
582 | } | |
37c12e74 RK |
583 | EXPORT_SYMBOL_GPL(platform_device_add); |
584 | ||
585 | /** | |
4a3ad20c GKH |
586 | * platform_device_del - remove a platform-level device |
587 | * @pdev: platform device we're removing | |
1da177e4 | 588 | * |
4a3ad20c GKH |
589 | * Note that this function will also release all memory- and port-based |
590 | * resources owned by the device (@dev->resource). This function must | |
591 | * _only_ be externally called in error cases. All other usage is a bug. | |
1da177e4 | 592 | */ |
93ce3061 | 593 | void platform_device_del(struct platform_device *pdev) |
1da177e4 | 594 | { |
39cc539f | 595 | u32 i; |
c9f66169 | 596 | |
99fef587 | 597 | if (!IS_ERR_OR_NULL(pdev)) { |
8b2dceba GKH |
598 | device_del(&pdev->dev); |
599 | ||
600 | if (pdev->id_auto) { | |
601 | ida_simple_remove(&platform_devid_ida, pdev->id); | |
602 | pdev->id = PLATFORM_DEVID_AUTO; | |
603 | } | |
604 | ||
605 | for (i = 0; i < pdev->num_resources; i++) { | |
606 | struct resource *r = &pdev->resource[i]; | |
7f5dcaf1 | 607 | if (r->parent) |
8b2dceba GKH |
608 | release_resource(r); |
609 | } | |
610 | } | |
1da177e4 | 611 | } |
93ce3061 DT |
612 | EXPORT_SYMBOL_GPL(platform_device_del); |
613 | ||
614 | /** | |
4a3ad20c GKH |
615 | * platform_device_register - add a platform-level device |
616 | * @pdev: platform device we're adding | |
93ce3061 | 617 | */ |
4a3ad20c | 618 | int platform_device_register(struct platform_device *pdev) |
93ce3061 DT |
619 | { |
620 | device_initialize(&pdev->dev); | |
cdfee562 | 621 | setup_pdev_dma_masks(pdev); |
93ce3061 DT |
622 | return platform_device_add(pdev); |
623 | } | |
a96b2042 | 624 | EXPORT_SYMBOL_GPL(platform_device_register); |
93ce3061 DT |
625 | |
626 | /** | |
4a3ad20c GKH |
627 | * platform_device_unregister - unregister a platform-level device |
628 | * @pdev: platform device we're unregistering | |
93ce3061 | 629 | * |
4a3ad20c GKH |
630 | * Unregistration is done in 2 steps. First we release all resources |
631 | * and remove it from the subsystem, then we drop reference count by | |
632 | * calling platform_device_put(). | |
93ce3061 | 633 | */ |
4a3ad20c | 634 | void platform_device_unregister(struct platform_device *pdev) |
93ce3061 DT |
635 | { |
636 | platform_device_del(pdev); | |
637 | platform_device_put(pdev); | |
638 | } | |
a96b2042 | 639 | EXPORT_SYMBOL_GPL(platform_device_unregister); |
1da177e4 | 640 | |
1da177e4 | 641 | /** |
01dcc60a | 642 | * platform_device_register_full - add a platform-level device with |
44f28bde | 643 | * resources and platform-specific data |
49a4ec18 | 644 | * |
01dcc60a | 645 | * @pdevinfo: data used to create device |
d8bf2540 | 646 | * |
f0eae0ed | 647 | * Returns &struct platform_device pointer on success, or ERR_PTR() on error. |
d8bf2540 | 648 | */ |
01dcc60a | 649 | struct platform_device *platform_device_register_full( |
5a3072be | 650 | const struct platform_device_info *pdevinfo) |
d8bf2540 | 651 | { |
44f28bde | 652 | int ret = -ENOMEM; |
d8bf2540 | 653 | struct platform_device *pdev; |
d8bf2540 | 654 | |
01dcc60a | 655 | pdev = platform_device_alloc(pdevinfo->name, pdevinfo->id); |
44f28bde | 656 | if (!pdev) |
36cf3b13 | 657 | return ERR_PTR(-ENOMEM); |
01dcc60a UKK |
658 | |
659 | pdev->dev.parent = pdevinfo->parent; | |
ce793486 | 660 | pdev->dev.fwnode = pdevinfo->fwnode; |
2c1ea6ab MR |
661 | pdev->dev.of_node = of_node_get(to_of_node(pdev->dev.fwnode)); |
662 | pdev->dev.of_node_reused = pdevinfo->of_node_reused; | |
01dcc60a UKK |
663 | |
664 | if (pdevinfo->dma_mask) { | |
e3a36eb6 CH |
665 | pdev->platform_dma_mask = pdevinfo->dma_mask; |
666 | pdev->dev.dma_mask = &pdev->platform_dma_mask; | |
01dcc60a UKK |
667 | pdev->dev.coherent_dma_mask = pdevinfo->dma_mask; |
668 | } | |
d8bf2540 | 669 | |
01dcc60a UKK |
670 | ret = platform_device_add_resources(pdev, |
671 | pdevinfo->res, pdevinfo->num_res); | |
807508c8 AV |
672 | if (ret) |
673 | goto err; | |
44f28bde | 674 | |
01dcc60a UKK |
675 | ret = platform_device_add_data(pdev, |
676 | pdevinfo->data, pdevinfo->size_data); | |
807508c8 AV |
677 | if (ret) |
678 | goto err; | |
d8bf2540 | 679 | |
f4d05266 HK |
680 | if (pdevinfo->properties) { |
681 | ret = platform_device_add_properties(pdev, | |
682 | pdevinfo->properties); | |
00bbc1d8 MW |
683 | if (ret) |
684 | goto err; | |
685 | } | |
686 | ||
44f28bde UKK |
687 | ret = platform_device_add(pdev); |
688 | if (ret) { | |
689 | err: | |
7b199811 | 690 | ACPI_COMPANION_SET(&pdev->dev, NULL); |
44f28bde UKK |
691 | platform_device_put(pdev); |
692 | return ERR_PTR(ret); | |
693 | } | |
d8bf2540 DB |
694 | |
695 | return pdev; | |
d8bf2540 | 696 | } |
01dcc60a | 697 | EXPORT_SYMBOL_GPL(platform_device_register_full); |
d8bf2540 | 698 | |
00d3dcdd RK |
699 | static int platform_drv_probe(struct device *_dev) |
700 | { | |
701 | struct platform_driver *drv = to_platform_driver(_dev->driver); | |
702 | struct platform_device *dev = to_platform_device(_dev); | |
94d76d5d | 703 | int ret; |
00d3dcdd | 704 | |
86be408b SN |
705 | ret = of_clk_set_defaults(_dev->of_node, false); |
706 | if (ret < 0) | |
707 | return ret; | |
708 | ||
cb518413 | 709 | ret = dev_pm_domain_attach(_dev, true); |
88a9769e UH |
710 | if (ret) |
711 | goto out; | |
712 | ||
713 | if (drv->probe) { | |
714 | ret = drv->probe(dev); | |
715 | if (ret) | |
716 | dev_pm_domain_detach(_dev, true); | |
cb518413 | 717 | } |
94d76d5d | 718 | |
88a9769e | 719 | out: |
3f9120b0 JH |
720 | if (drv->prevent_deferred_probe && ret == -EPROBE_DEFER) { |
721 | dev_warn(_dev, "probe deferral not supported\n"); | |
722 | ret = -ENXIO; | |
723 | } | |
724 | ||
94d76d5d | 725 | return ret; |
00d3dcdd RK |
726 | } |
727 | ||
c67334fb DB |
728 | static int platform_drv_probe_fail(struct device *_dev) |
729 | { | |
730 | return -ENXIO; | |
731 | } | |
732 | ||
00d3dcdd RK |
733 | static int platform_drv_remove(struct device *_dev) |
734 | { | |
735 | struct platform_driver *drv = to_platform_driver(_dev->driver); | |
736 | struct platform_device *dev = to_platform_device(_dev); | |
b8b2c7d8 | 737 | int ret = 0; |
00d3dcdd | 738 | |
b8b2c7d8 UKK |
739 | if (drv->remove) |
740 | ret = drv->remove(dev); | |
cb518413 | 741 | dev_pm_domain_detach(_dev, true); |
94d76d5d RW |
742 | |
743 | return ret; | |
00d3dcdd RK |
744 | } |
745 | ||
746 | static void platform_drv_shutdown(struct device *_dev) | |
747 | { | |
748 | struct platform_driver *drv = to_platform_driver(_dev->driver); | |
749 | struct platform_device *dev = to_platform_device(_dev); | |
750 | ||
b8b2c7d8 UKK |
751 | if (drv->shutdown) |
752 | drv->shutdown(dev); | |
00d3dcdd RK |
753 | } |
754 | ||
00d3dcdd | 755 | /** |
9447057e | 756 | * __platform_driver_register - register a driver for platform-level devices |
4a3ad20c | 757 | * @drv: platform driver structure |
08801f96 | 758 | * @owner: owning module/driver |
00d3dcdd | 759 | */ |
9447057e LC |
760 | int __platform_driver_register(struct platform_driver *drv, |
761 | struct module *owner) | |
00d3dcdd | 762 | { |
9447057e | 763 | drv->driver.owner = owner; |
00d3dcdd | 764 | drv->driver.bus = &platform_bus_type; |
b8b2c7d8 UKK |
765 | drv->driver.probe = platform_drv_probe; |
766 | drv->driver.remove = platform_drv_remove; | |
767 | drv->driver.shutdown = platform_drv_shutdown; | |
783ea7d4 | 768 | |
00d3dcdd RK |
769 | return driver_register(&drv->driver); |
770 | } | |
9447057e | 771 | EXPORT_SYMBOL_GPL(__platform_driver_register); |
00d3dcdd RK |
772 | |
773 | /** | |
3c31f07a | 774 | * platform_driver_unregister - unregister a driver for platform-level devices |
4a3ad20c | 775 | * @drv: platform driver structure |
00d3dcdd RK |
776 | */ |
777 | void platform_driver_unregister(struct platform_driver *drv) | |
778 | { | |
779 | driver_unregister(&drv->driver); | |
780 | } | |
781 | EXPORT_SYMBOL_GPL(platform_driver_unregister); | |
782 | ||
c67334fb | 783 | /** |
c3b50dc2 | 784 | * __platform_driver_probe - register driver for non-hotpluggable device |
c67334fb | 785 | * @drv: platform driver structure |
3f9120b0 | 786 | * @probe: the driver probe routine, probably from an __init section |
c3b50dc2 | 787 | * @module: module which will be the owner of the driver |
c67334fb DB |
788 | * |
789 | * Use this instead of platform_driver_register() when you know the device | |
790 | * is not hotpluggable and has already been registered, and you want to | |
791 | * remove its run-once probe() infrastructure from memory after the driver | |
792 | * has bound to the device. | |
793 | * | |
794 | * One typical use for this would be with drivers for controllers integrated | |
795 | * into system-on-chip processors, where the controller devices have been | |
796 | * configured as part of board setup. | |
797 | * | |
3f9120b0 | 798 | * Note that this is incompatible with deferred probing. |
647c86d0 | 799 | * |
c67334fb DB |
800 | * Returns zero if the driver registered and bound to a device, else returns |
801 | * a negative error code and with the driver not registered. | |
802 | */ | |
c3b50dc2 WS |
803 | int __init_or_module __platform_driver_probe(struct platform_driver *drv, |
804 | int (*probe)(struct platform_device *), struct module *module) | |
c67334fb DB |
805 | { |
806 | int retval, code; | |
807 | ||
5c36eb2a DT |
808 | if (drv->driver.probe_type == PROBE_PREFER_ASYNCHRONOUS) { |
809 | pr_err("%s: drivers registered with %s can not be probed asynchronously\n", | |
810 | drv->driver.name, __func__); | |
811 | return -EINVAL; | |
812 | } | |
813 | ||
814 | /* | |
815 | * We have to run our probes synchronously because we check if | |
816 | * we find any devices to bind to and exit with error if there | |
817 | * are any. | |
818 | */ | |
819 | drv->driver.probe_type = PROBE_FORCE_SYNCHRONOUS; | |
820 | ||
3f9120b0 JH |
821 | /* |
822 | * Prevent driver from requesting probe deferral to avoid further | |
823 | * futile probe attempts. | |
824 | */ | |
825 | drv->prevent_deferred_probe = true; | |
826 | ||
1a6f2a75 DT |
827 | /* make sure driver won't have bind/unbind attributes */ |
828 | drv->driver.suppress_bind_attrs = true; | |
829 | ||
c67334fb DB |
830 | /* temporary section violation during probe() */ |
831 | drv->probe = probe; | |
c3b50dc2 | 832 | retval = code = __platform_driver_register(drv, module); |
c67334fb | 833 | |
1a6f2a75 DT |
834 | /* |
835 | * Fixup that section violation, being paranoid about code scanning | |
c67334fb DB |
836 | * the list of drivers in order to probe new devices. Check to see |
837 | * if the probe was successful, and make sure any forced probes of | |
838 | * new devices fail. | |
839 | */ | |
d79d3244 | 840 | spin_lock(&drv->driver.bus->p->klist_drivers.k_lock); |
c67334fb | 841 | drv->probe = NULL; |
e5dd1278 | 842 | if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list)) |
c67334fb DB |
843 | retval = -ENODEV; |
844 | drv->driver.probe = platform_drv_probe_fail; | |
d79d3244 | 845 | spin_unlock(&drv->driver.bus->p->klist_drivers.k_lock); |
c67334fb DB |
846 | |
847 | if (code != retval) | |
848 | platform_driver_unregister(drv); | |
849 | return retval; | |
850 | } | |
c3b50dc2 | 851 | EXPORT_SYMBOL_GPL(__platform_driver_probe); |
1da177e4 | 852 | |
ecdf6ceb | 853 | /** |
291f653a | 854 | * __platform_create_bundle - register driver and create corresponding device |
ecdf6ceb DT |
855 | * @driver: platform driver structure |
856 | * @probe: the driver probe routine, probably from an __init section | |
857 | * @res: set of resources that needs to be allocated for the device | |
858 | * @n_res: number of resources | |
859 | * @data: platform specific data for this platform device | |
860 | * @size: size of platform specific data | |
291f653a | 861 | * @module: module which will be the owner of the driver |
ecdf6ceb DT |
862 | * |
863 | * Use this in legacy-style modules that probe hardware directly and | |
864 | * register a single platform device and corresponding platform driver. | |
f0eae0ed JN |
865 | * |
866 | * Returns &struct platform_device pointer on success, or ERR_PTR() on error. | |
ecdf6ceb | 867 | */ |
291f653a | 868 | struct platform_device * __init_or_module __platform_create_bundle( |
ecdf6ceb DT |
869 | struct platform_driver *driver, |
870 | int (*probe)(struct platform_device *), | |
871 | struct resource *res, unsigned int n_res, | |
291f653a | 872 | const void *data, size_t size, struct module *module) |
ecdf6ceb DT |
873 | { |
874 | struct platform_device *pdev; | |
875 | int error; | |
876 | ||
877 | pdev = platform_device_alloc(driver->driver.name, -1); | |
878 | if (!pdev) { | |
879 | error = -ENOMEM; | |
880 | goto err_out; | |
881 | } | |
882 | ||
807508c8 AV |
883 | error = platform_device_add_resources(pdev, res, n_res); |
884 | if (error) | |
885 | goto err_pdev_put; | |
ecdf6ceb | 886 | |
807508c8 AV |
887 | error = platform_device_add_data(pdev, data, size); |
888 | if (error) | |
889 | goto err_pdev_put; | |
ecdf6ceb DT |
890 | |
891 | error = platform_device_add(pdev); | |
892 | if (error) | |
893 | goto err_pdev_put; | |
894 | ||
291f653a | 895 | error = __platform_driver_probe(driver, probe, module); |
ecdf6ceb DT |
896 | if (error) |
897 | goto err_pdev_del; | |
898 | ||
899 | return pdev; | |
900 | ||
901 | err_pdev_del: | |
902 | platform_device_del(pdev); | |
903 | err_pdev_put: | |
904 | platform_device_put(pdev); | |
905 | err_out: | |
906 | return ERR_PTR(error); | |
907 | } | |
291f653a | 908 | EXPORT_SYMBOL_GPL(__platform_create_bundle); |
ecdf6ceb | 909 | |
dbe2256d TR |
910 | /** |
911 | * __platform_register_drivers - register an array of platform drivers | |
912 | * @drivers: an array of drivers to register | |
913 | * @count: the number of drivers to register | |
914 | * @owner: module owning the drivers | |
915 | * | |
916 | * Registers platform drivers specified by an array. On failure to register a | |
917 | * driver, all previously registered drivers will be unregistered. Callers of | |
918 | * this API should use platform_unregister_drivers() to unregister drivers in | |
919 | * the reverse order. | |
920 | * | |
921 | * Returns: 0 on success or a negative error code on failure. | |
922 | */ | |
923 | int __platform_register_drivers(struct platform_driver * const *drivers, | |
924 | unsigned int count, struct module *owner) | |
925 | { | |
926 | unsigned int i; | |
927 | int err; | |
928 | ||
929 | for (i = 0; i < count; i++) { | |
930 | pr_debug("registering platform driver %ps\n", drivers[i]); | |
931 | ||
932 | err = __platform_driver_register(drivers[i], owner); | |
933 | if (err < 0) { | |
934 | pr_err("failed to register platform driver %ps: %d\n", | |
935 | drivers[i], err); | |
936 | goto error; | |
937 | } | |
938 | } | |
939 | ||
940 | return 0; | |
941 | ||
942 | error: | |
943 | while (i--) { | |
944 | pr_debug("unregistering platform driver %ps\n", drivers[i]); | |
945 | platform_driver_unregister(drivers[i]); | |
946 | } | |
947 | ||
948 | return err; | |
949 | } | |
950 | EXPORT_SYMBOL_GPL(__platform_register_drivers); | |
951 | ||
952 | /** | |
953 | * platform_unregister_drivers - unregister an array of platform drivers | |
954 | * @drivers: an array of drivers to unregister | |
955 | * @count: the number of drivers to unregister | |
956 | * | |
957 | * Unegisters platform drivers specified by an array. This is typically used | |
958 | * to complement an earlier call to platform_register_drivers(). Drivers are | |
959 | * unregistered in the reverse order in which they were registered. | |
960 | */ | |
961 | void platform_unregister_drivers(struct platform_driver * const *drivers, | |
962 | unsigned int count) | |
963 | { | |
964 | while (count--) { | |
965 | pr_debug("unregistering platform driver %ps\n", drivers[count]); | |
966 | platform_driver_unregister(drivers[count]); | |
967 | } | |
968 | } | |
969 | EXPORT_SYMBOL_GPL(platform_unregister_drivers); | |
970 | ||
a0245f7a DB |
971 | /* modalias support enables more hands-off userspace setup: |
972 | * (a) environment variable lets new-style hotplug events work once system is | |
973 | * fully running: "modprobe $MODALIAS" | |
974 | * (b) sysfs attribute lets new-style coldplug recover from hotplug events | |
975 | * mishandled before system is fully running: "modprobe $(cat modalias)" | |
976 | */ | |
4a3ad20c GKH |
977 | static ssize_t modalias_show(struct device *dev, struct device_attribute *a, |
978 | char *buf) | |
a0245f7a DB |
979 | { |
980 | struct platform_device *pdev = to_platform_device(dev); | |
8c4ff6d0 ZR |
981 | int len; |
982 | ||
0634c295 | 983 | len = of_device_modalias(dev, buf, PAGE_SIZE); |
b9f73067 ZR |
984 | if (len != -ENODEV) |
985 | return len; | |
986 | ||
8c4ff6d0 ZR |
987 | len = acpi_device_modalias(dev, buf, PAGE_SIZE -1); |
988 | if (len != -ENODEV) | |
989 | return len; | |
990 | ||
391c0325 | 991 | len = snprintf(buf, PAGE_SIZE, "platform:%s\n", pdev->name); |
a0245f7a DB |
992 | |
993 | return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len; | |
994 | } | |
d06262e5 | 995 | static DEVICE_ATTR_RO(modalias); |
a0245f7a | 996 | |
3d713e0e KP |
997 | static ssize_t driver_override_store(struct device *dev, |
998 | struct device_attribute *attr, | |
999 | const char *buf, size_t count) | |
1000 | { | |
1001 | struct platform_device *pdev = to_platform_device(dev); | |
62655397 | 1002 | char *driver_override, *old, *cp; |
3d713e0e | 1003 | |
bf563b01 NS |
1004 | /* We need to keep extra room for a newline */ |
1005 | if (count >= (PAGE_SIZE - 1)) | |
3d713e0e KP |
1006 | return -EINVAL; |
1007 | ||
1008 | driver_override = kstrndup(buf, count, GFP_KERNEL); | |
1009 | if (!driver_override) | |
1010 | return -ENOMEM; | |
1011 | ||
1012 | cp = strchr(driver_override, '\n'); | |
1013 | if (cp) | |
1014 | *cp = '\0'; | |
1015 | ||
62655397 AS |
1016 | device_lock(dev); |
1017 | old = pdev->driver_override; | |
3d713e0e KP |
1018 | if (strlen(driver_override)) { |
1019 | pdev->driver_override = driver_override; | |
1020 | } else { | |
1021 | kfree(driver_override); | |
1022 | pdev->driver_override = NULL; | |
1023 | } | |
62655397 | 1024 | device_unlock(dev); |
3d713e0e KP |
1025 | |
1026 | kfree(old); | |
1027 | ||
1028 | return count; | |
1029 | } | |
1030 | ||
1031 | static ssize_t driver_override_show(struct device *dev, | |
1032 | struct device_attribute *attr, char *buf) | |
1033 | { | |
1034 | struct platform_device *pdev = to_platform_device(dev); | |
62655397 | 1035 | ssize_t len; |
3d713e0e | 1036 | |
62655397 AS |
1037 | device_lock(dev); |
1038 | len = sprintf(buf, "%s\n", pdev->driver_override); | |
1039 | device_unlock(dev); | |
1040 | return len; | |
3d713e0e KP |
1041 | } |
1042 | static DEVICE_ATTR_RW(driver_override); | |
1043 | ||
1044 | ||
d06262e5 GKH |
1045 | static struct attribute *platform_dev_attrs[] = { |
1046 | &dev_attr_modalias.attr, | |
3d713e0e | 1047 | &dev_attr_driver_override.attr, |
d06262e5 | 1048 | NULL, |
a0245f7a | 1049 | }; |
d06262e5 | 1050 | ATTRIBUTE_GROUPS(platform_dev); |
a0245f7a | 1051 | |
7eff2e7a | 1052 | static int platform_uevent(struct device *dev, struct kobj_uevent_env *env) |
a0245f7a DB |
1053 | { |
1054 | struct platform_device *pdev = to_platform_device(dev); | |
eca39301 GL |
1055 | int rc; |
1056 | ||
1057 | /* Some devices have extra OF data and an OF-style MODALIAS */ | |
0258e182 | 1058 | rc = of_device_uevent_modalias(dev, env); |
eca39301 GL |
1059 | if (rc != -ENODEV) |
1060 | return rc; | |
a0245f7a | 1061 | |
8c4ff6d0 ZR |
1062 | rc = acpi_device_uevent_modalias(dev, env); |
1063 | if (rc != -ENODEV) | |
1064 | return rc; | |
1065 | ||
57fee4a5 | 1066 | add_uevent_var(env, "MODALIAS=%s%s", PLATFORM_MODULE_PREFIX, |
391c0325 | 1067 | pdev->name); |
a0245f7a DB |
1068 | return 0; |
1069 | } | |
1070 | ||
57fee4a5 | 1071 | static const struct platform_device_id *platform_match_id( |
831fad2f | 1072 | const struct platform_device_id *id, |
57fee4a5 EM |
1073 | struct platform_device *pdev) |
1074 | { | |
1075 | while (id->name[0]) { | |
391c0325 | 1076 | if (strcmp(pdev->name, id->name) == 0) { |
57fee4a5 EM |
1077 | pdev->id_entry = id; |
1078 | return id; | |
1079 | } | |
1080 | id++; | |
1081 | } | |
1082 | return NULL; | |
1083 | } | |
1084 | ||
1da177e4 | 1085 | /** |
4a3ad20c GKH |
1086 | * platform_match - bind platform device to platform driver. |
1087 | * @dev: device. | |
1088 | * @drv: driver. | |
1da177e4 | 1089 | * |
4a3ad20c GKH |
1090 | * Platform device IDs are assumed to be encoded like this: |
1091 | * "<name><instance>", where <name> is a short description of the type of | |
1092 | * device, like "pci" or "floppy", and <instance> is the enumerated | |
1093 | * instance of the device, like '0' or '42'. Driver IDs are simply | |
1094 | * "<name>". So, extract the <name> from the platform_device structure, | |
1095 | * and compare it against the name of the driver. Return whether they match | |
1096 | * or not. | |
1da177e4 | 1097 | */ |
4a3ad20c | 1098 | static int platform_match(struct device *dev, struct device_driver *drv) |
1da177e4 | 1099 | { |
71b3e0c1 | 1100 | struct platform_device *pdev = to_platform_device(dev); |
57fee4a5 EM |
1101 | struct platform_driver *pdrv = to_platform_driver(drv); |
1102 | ||
3d713e0e KP |
1103 | /* When driver_override is set, only bind to the matching driver */ |
1104 | if (pdev->driver_override) | |
1105 | return !strcmp(pdev->driver_override, drv->name); | |
1106 | ||
05212157 GL |
1107 | /* Attempt an OF style match first */ |
1108 | if (of_driver_match_device(dev, drv)) | |
1109 | return 1; | |
1110 | ||
91e56878 MW |
1111 | /* Then try ACPI style match */ |
1112 | if (acpi_driver_match_device(dev, drv)) | |
1113 | return 1; | |
1114 | ||
05212157 | 1115 | /* Then try to match against the id table */ |
57fee4a5 EM |
1116 | if (pdrv->id_table) |
1117 | return platform_match_id(pdrv->id_table, pdev) != NULL; | |
1da177e4 | 1118 | |
57fee4a5 | 1119 | /* fall-back to driver name match */ |
391c0325 | 1120 | return (strcmp(pdev->name, drv->name) == 0); |
1da177e4 LT |
1121 | } |
1122 | ||
25e18499 RW |
1123 | #ifdef CONFIG_PM_SLEEP |
1124 | ||
1125 | static int platform_legacy_suspend(struct device *dev, pm_message_t mesg) | |
1da177e4 | 1126 | { |
783ea7d4 MD |
1127 | struct platform_driver *pdrv = to_platform_driver(dev->driver); |
1128 | struct platform_device *pdev = to_platform_device(dev); | |
1da177e4 LT |
1129 | int ret = 0; |
1130 | ||
783ea7d4 MD |
1131 | if (dev->driver && pdrv->suspend) |
1132 | ret = pdrv->suspend(pdev, mesg); | |
386415d8 DB |
1133 | |
1134 | return ret; | |
1135 | } | |
1136 | ||
25e18499 | 1137 | static int platform_legacy_resume(struct device *dev) |
1da177e4 | 1138 | { |
783ea7d4 MD |
1139 | struct platform_driver *pdrv = to_platform_driver(dev->driver); |
1140 | struct platform_device *pdev = to_platform_device(dev); | |
1da177e4 LT |
1141 | int ret = 0; |
1142 | ||
783ea7d4 MD |
1143 | if (dev->driver && pdrv->resume) |
1144 | ret = pdrv->resume(pdev); | |
9480e307 | 1145 | |
1da177e4 LT |
1146 | return ret; |
1147 | } | |
1148 | ||
69c9dd1e | 1149 | #endif /* CONFIG_PM_SLEEP */ |
9d730229 | 1150 | |
25e18499 RW |
1151 | #ifdef CONFIG_SUSPEND |
1152 | ||
69c9dd1e | 1153 | int platform_pm_suspend(struct device *dev) |
25e18499 RW |
1154 | { |
1155 | struct device_driver *drv = dev->driver; | |
1156 | int ret = 0; | |
1157 | ||
adf09493 RW |
1158 | if (!drv) |
1159 | return 0; | |
1160 | ||
1161 | if (drv->pm) { | |
25e18499 RW |
1162 | if (drv->pm->suspend) |
1163 | ret = drv->pm->suspend(dev); | |
1164 | } else { | |
1165 | ret = platform_legacy_suspend(dev, PMSG_SUSPEND); | |
1166 | } | |
1167 | ||
1168 | return ret; | |
1169 | } | |
1170 | ||
69c9dd1e | 1171 | int platform_pm_resume(struct device *dev) |
25e18499 RW |
1172 | { |
1173 | struct device_driver *drv = dev->driver; | |
1174 | int ret = 0; | |
1175 | ||
adf09493 RW |
1176 | if (!drv) |
1177 | return 0; | |
1178 | ||
1179 | if (drv->pm) { | |
25e18499 RW |
1180 | if (drv->pm->resume) |
1181 | ret = drv->pm->resume(dev); | |
1182 | } else { | |
1183 | ret = platform_legacy_resume(dev); | |
1184 | } | |
1185 | ||
1186 | return ret; | |
1187 | } | |
1188 | ||
69c9dd1e | 1189 | #endif /* CONFIG_SUSPEND */ |
25e18499 | 1190 | |
1f112cee | 1191 | #ifdef CONFIG_HIBERNATE_CALLBACKS |
25e18499 | 1192 | |
69c9dd1e | 1193 | int platform_pm_freeze(struct device *dev) |
25e18499 RW |
1194 | { |
1195 | struct device_driver *drv = dev->driver; | |
1196 | int ret = 0; | |
1197 | ||
1198 | if (!drv) | |
1199 | return 0; | |
1200 | ||
1201 | if (drv->pm) { | |
1202 | if (drv->pm->freeze) | |
1203 | ret = drv->pm->freeze(dev); | |
1204 | } else { | |
1205 | ret = platform_legacy_suspend(dev, PMSG_FREEZE); | |
1206 | } | |
1207 | ||
1208 | return ret; | |
1209 | } | |
1210 | ||
69c9dd1e | 1211 | int platform_pm_thaw(struct device *dev) |
25e18499 RW |
1212 | { |
1213 | struct device_driver *drv = dev->driver; | |
1214 | int ret = 0; | |
1215 | ||
adf09493 RW |
1216 | if (!drv) |
1217 | return 0; | |
1218 | ||
1219 | if (drv->pm) { | |
25e18499 RW |
1220 | if (drv->pm->thaw) |
1221 | ret = drv->pm->thaw(dev); | |
1222 | } else { | |
1223 | ret = platform_legacy_resume(dev); | |
1224 | } | |
1225 | ||
1226 | return ret; | |
1227 | } | |
1228 | ||
69c9dd1e | 1229 | int platform_pm_poweroff(struct device *dev) |
25e18499 RW |
1230 | { |
1231 | struct device_driver *drv = dev->driver; | |
1232 | int ret = 0; | |
1233 | ||
adf09493 RW |
1234 | if (!drv) |
1235 | return 0; | |
1236 | ||
1237 | if (drv->pm) { | |
25e18499 RW |
1238 | if (drv->pm->poweroff) |
1239 | ret = drv->pm->poweroff(dev); | |
1240 | } else { | |
1241 | ret = platform_legacy_suspend(dev, PMSG_HIBERNATE); | |
1242 | } | |
1243 | ||
1244 | return ret; | |
1245 | } | |
1246 | ||
69c9dd1e | 1247 | int platform_pm_restore(struct device *dev) |
25e18499 RW |
1248 | { |
1249 | struct device_driver *drv = dev->driver; | |
1250 | int ret = 0; | |
1251 | ||
adf09493 RW |
1252 | if (!drv) |
1253 | return 0; | |
1254 | ||
1255 | if (drv->pm) { | |
25e18499 RW |
1256 | if (drv->pm->restore) |
1257 | ret = drv->pm->restore(dev); | |
1258 | } else { | |
1259 | ret = platform_legacy_resume(dev); | |
1260 | } | |
1261 | ||
1262 | return ret; | |
1263 | } | |
1264 | ||
69c9dd1e | 1265 | #endif /* CONFIG_HIBERNATE_CALLBACKS */ |
25e18499 | 1266 | |
07397df2 NG |
1267 | int platform_dma_configure(struct device *dev) |
1268 | { | |
1269 | enum dev_dma_attr attr; | |
1270 | int ret = 0; | |
1271 | ||
1272 | if (dev->of_node) { | |
3d6ce86e | 1273 | ret = of_dma_configure(dev, dev->of_node, true); |
07397df2 NG |
1274 | } else if (has_acpi_companion(dev)) { |
1275 | attr = acpi_get_dma_attr(to_acpi_device_node(dev->fwnode)); | |
e5361ca2 | 1276 | ret = acpi_dma_configure(dev, attr); |
07397df2 NG |
1277 | } |
1278 | ||
1279 | return ret; | |
1280 | } | |
1281 | ||
d9ab7716 | 1282 | static const struct dev_pm_ops platform_dev_pm_ops = { |
8b313a38 RW |
1283 | .runtime_suspend = pm_generic_runtime_suspend, |
1284 | .runtime_resume = pm_generic_runtime_resume, | |
69c9dd1e | 1285 | USE_PLATFORM_PM_SLEEP_OPS |
25e18499 RW |
1286 | }; |
1287 | ||
1da177e4 LT |
1288 | struct bus_type platform_bus_type = { |
1289 | .name = "platform", | |
d06262e5 | 1290 | .dev_groups = platform_dev_groups, |
1da177e4 | 1291 | .match = platform_match, |
a0245f7a | 1292 | .uevent = platform_uevent, |
07397df2 | 1293 | .dma_configure = platform_dma_configure, |
9d730229 | 1294 | .pm = &platform_dev_pm_ops, |
1da177e4 | 1295 | }; |
a96b2042 | 1296 | EXPORT_SYMBOL_GPL(platform_bus_type); |
1da177e4 | 1297 | |
492c8872 ST |
1298 | static inline int __platform_match(struct device *dev, const void *drv) |
1299 | { | |
1300 | return platform_match(dev, (struct device_driver *)drv); | |
1301 | } | |
1302 | ||
36f3313d SP |
1303 | /** |
1304 | * platform_find_device_by_driver - Find a platform device with a given | |
1305 | * driver. | |
1306 | * @start: The device to start the search from. | |
1307 | * @drv: The device driver to look for. | |
1308 | */ | |
1309 | struct device *platform_find_device_by_driver(struct device *start, | |
1310 | const struct device_driver *drv) | |
1311 | { | |
1312 | return bus_find_device(&platform_bus_type, start, drv, | |
492c8872 | 1313 | __platform_match); |
36f3313d SP |
1314 | } |
1315 | EXPORT_SYMBOL_GPL(platform_find_device_by_driver); | |
1316 | ||
eecd37e1 GR |
1317 | void __weak __init early_platform_cleanup(void) { } |
1318 | ||
1da177e4 LT |
1319 | int __init platform_bus_init(void) |
1320 | { | |
fbfb1445 CH |
1321 | int error; |
1322 | ||
eecd37e1 GR |
1323 | early_platform_cleanup(); |
1324 | ||
fbfb1445 | 1325 | error = device_register(&platform_bus); |
c8ae1674 AY |
1326 | if (error) { |
1327 | put_device(&platform_bus); | |
fbfb1445 | 1328 | return error; |
c8ae1674 | 1329 | } |
fbfb1445 CH |
1330 | error = bus_register(&platform_bus_type); |
1331 | if (error) | |
1332 | device_unregister(&platform_bus); | |
801d728c | 1333 | of_platform_register_reconfig_notifier(); |
fbfb1445 | 1334 | return error; |
1da177e4 | 1335 | } |