Lines Matching +full:platform +full:- +full:data
1 // SPDX-License-Identifier: GPL-2.0
3 * platform.c - platform 'pseudo' bus for legacy devices
5 * Copyright (c) 2002-3 Patrick Mochel
6 * Copyright (c) 2002-3 Open Source Development Labs
8 * Please see Documentation/driver-model/platform.txt for more
18 #include <linux/dma-mapping.h>
26 #include <linux/clk/clk-conf.h>
39 .init_name = "platform",
44 * arch_setup_pdev_archdata - Allow manipulation of archdata before its used
45 * @pdev: platform device
63 * platform_get_resource - get a resource for a device
64 * @dev: platform device
73 for (i = 0; i < dev->num_resources; i++) { in platform_get_resource()
74 struct resource *r = &dev->resource[i]; in platform_get_resource()
76 if (type == resource_type(r) && num-- == 0) in platform_get_resource()
84 * platform_get_irq - get an IRQ for a device
85 * @dev: platform device
92 if (!dev || num >= dev->archdata.num_irqs) in platform_get_irq()
93 return -ENXIO; in platform_get_irq()
94 return dev->archdata.irqs[num]; in platform_get_irq()
97 if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { in platform_get_irq()
100 ret = of_irq_get(dev->dev.of_node, num); in platform_get_irq()
101 if (ret > 0 || ret == -EPROBE_DEFER) in platform_get_irq()
106 if (has_acpi_companion(&dev->dev)) { in platform_get_irq()
107 if (r && r->flags & IORESOURCE_DISABLED) { in platform_get_irq()
110 ret = acpi_irq_get(ACPI_HANDLE(&dev->dev), num, r); in platform_get_irq()
119 * IORESOURCE_BITS correspond 1-to-1 to the IRQF_TRIGGER* in platform_get_irq()
122 if (r && r->flags & IORESOURCE_BITS) { in platform_get_irq()
125 irqd = irq_get_irq_data(r->start); in platform_get_irq()
127 return -ENXIO; in platform_get_irq()
128 irqd_set_trigger_type(irqd, r->flags & IORESOURCE_BITS); in platform_get_irq()
131 return r ? r->start : -ENXIO; in platform_get_irq()
137 * platform_irq_count - Count the number of IRQs a platform device uses
138 * @dev: platform device
140 * Return: Number of IRQs a platform device uses or EPROBE_DEFER
149 if (ret == -EPROBE_DEFER) in platform_irq_count()
157 * platform_get_resource_byname - get a resource for a device by name
158 * @dev: platform device
168 for (i = 0; i < dev->num_resources; i++) { in platform_get_resource_byname()
169 struct resource *r = &dev->resource[i]; in platform_get_resource_byname()
171 if (unlikely(!r->name)) in platform_get_resource_byname()
174 if (type == resource_type(r) && !strcmp(r->name, name)) in platform_get_resource_byname()
182 * platform_get_irq_byname - get an IRQ for a device by name
183 * @dev: platform device
190 if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { in platform_get_irq_byname()
193 ret = of_irq_get_byname(dev->dev.of_node, name); in platform_get_irq_byname()
194 if (ret > 0 || ret == -EPROBE_DEFER) in platform_get_irq_byname()
199 return r ? r->start : -ENXIO; in platform_get_irq_byname()
204 * platform_add_devices - add a numbers of platform devices
205 * @devs: array of platform devices to add
206 * @num: number of platform devices in array
215 while (--i >= 0) in platform_add_devices()
231 * platform_device_put - destroy a platform device
232 * @pdev: platform device to free
234 * Free all memory associated with a platform device. This function must
240 put_device(&pdev->dev); in platform_device_put()
249 of_device_node_put(&pa->pdev.dev); in platform_device_release()
250 kfree(pa->pdev.dev.platform_data); in platform_device_release()
251 kfree(pa->pdev.mfd_cell); in platform_device_release()
252 kfree(pa->pdev.resource); in platform_device_release()
253 kfree(pa->pdev.driver_override); in platform_device_release()
258 * platform_device_alloc - create a platform device
262 * Create a platform device object which can have other objects attached
271 strcpy(pa->name, name); in platform_device_alloc()
272 pa->pdev.name = pa->name; in platform_device_alloc()
273 pa->pdev.id = id; in platform_device_alloc()
274 device_initialize(&pa->pdev.dev); in platform_device_alloc()
275 pa->pdev.dev.release = platform_device_release; in platform_device_alloc()
276 arch_setup_pdev_archdata(&pa->pdev); in platform_device_alloc()
279 return pa ? &pa->pdev : NULL; in platform_device_alloc()
284 * platform_device_add_resources - add resources to a platform device
285 * @pdev: platform device allocated by platform_device_alloc to add resources to
289 * Add a copy of the resources to the platform device. The memory
290 * associated with the resources will be freed when the platform device is
301 return -ENOMEM; in platform_device_add_resources()
304 kfree(pdev->resource); in platform_device_add_resources()
305 pdev->resource = r; in platform_device_add_resources()
306 pdev->num_resources = num; in platform_device_add_resources()
312 * platform_device_add_data - add platform-specific data to a platform device
313 * @pdev: platform device allocated by platform_device_alloc to add resources to
314 * @data: platform specific data for this platform device
315 * @size: size of platform specific data
317 * Add a copy of platform specific data to the platform device's
318 * platform_data pointer. The memory associated with the platform data
319 * will be freed when the platform device is released.
321 int platform_device_add_data(struct platform_device *pdev, const void *data, in platform_device_add_data() argument
326 if (data) { in platform_device_add_data()
327 d = kmemdup(data, size, GFP_KERNEL); in platform_device_add_data()
329 return -ENOMEM; in platform_device_add_data()
332 kfree(pdev->dev.platform_data); in platform_device_add_data()
333 pdev->dev.platform_data = d; in platform_device_add_data()
339 * platform_device_add_properties - add built-in properties to a platform device
340 * @pdev: platform device to add properties to
344 * platform device. The memory associated with properties will be freed when the
345 * platform device is released.
350 return device_add_properties(&pdev->dev, properties); in platform_device_add_properties()
355 * platform_device_add - add a platform device to device hierarchy
356 * @pdev: platform device we're adding
367 return -EINVAL; in platform_device_add()
369 if (!pdev->dev.parent) in platform_device_add()
370 pdev->dev.parent = &platform_bus; in platform_device_add()
372 pdev->dev.bus = &platform_bus_type; in platform_device_add()
374 switch (pdev->id) { in platform_device_add()
376 dev_set_name(&pdev->dev, "%s.%d", pdev->name, pdev->id); in platform_device_add()
379 dev_set_name(&pdev->dev, "%s", pdev->name); in platform_device_add()
390 pdev->id = ret; in platform_device_add()
391 pdev->id_auto = true; in platform_device_add()
392 dev_set_name(&pdev->dev, "%s.%d.auto", pdev->name, pdev->id); in platform_device_add()
396 for (i = 0; i < pdev->num_resources; i++) { in platform_device_add()
397 struct resource *p, *r = &pdev->resource[i]; in platform_device_add()
399 if (r->name == NULL) in platform_device_add()
400 r->name = dev_name(&pdev->dev); in platform_device_add()
402 p = r->parent; in platform_device_add()
411 dev_err(&pdev->dev, "failed to claim resource %d: %pR\n", i, r); in platform_device_add()
412 ret = -EBUSY; in platform_device_add()
417 pr_debug("Registering platform device '%s'. Parent at %s\n", in platform_device_add()
418 dev_name(&pdev->dev), dev_name(pdev->dev.parent)); in platform_device_add()
420 ret = device_add(&pdev->dev); in platform_device_add()
425 if (pdev->id_auto) { in platform_device_add()
426 ida_simple_remove(&platform_devid_ida, pdev->id); in platform_device_add()
427 pdev->id = PLATFORM_DEVID_AUTO; in platform_device_add()
430 while (i--) { in platform_device_add()
431 struct resource *r = &pdev->resource[i]; in platform_device_add()
432 if (r->parent) in platform_device_add()
442 * platform_device_del - remove a platform-level device
443 * @pdev: platform device we're removing
445 * Note that this function will also release all memory- and port-based
446 * resources owned by the device (@dev->resource). This function must
454 device_remove_properties(&pdev->dev); in platform_device_del()
455 device_del(&pdev->dev); in platform_device_del()
457 if (pdev->id_auto) { in platform_device_del()
458 ida_simple_remove(&platform_devid_ida, pdev->id); in platform_device_del()
459 pdev->id = PLATFORM_DEVID_AUTO; in platform_device_del()
462 for (i = 0; i < pdev->num_resources; i++) { in platform_device_del()
463 struct resource *r = &pdev->resource[i]; in platform_device_del()
464 if (r->parent) in platform_device_del()
472 * platform_device_register - add a platform-level device
473 * @pdev: platform device we're adding
477 device_initialize(&pdev->dev); in platform_device_register()
484 * platform_device_unregister - unregister a platform-level device
485 * @pdev: platform device we're unregistering
499 * platform_device_register_full - add a platform-level device with
500 * resources and platform-specific data
502 * @pdevinfo: data used to create device
509 int ret = -ENOMEM; in platform_device_register_full()
512 pdev = platform_device_alloc(pdevinfo->name, pdevinfo->id); in platform_device_register_full()
516 pdev->dev.parent = pdevinfo->parent; in platform_device_register_full()
517 pdev->dev.fwnode = pdevinfo->fwnode; in platform_device_register_full()
519 if (pdevinfo->dma_mask) { in platform_device_register_full()
526 pdev->dev.dma_mask = in platform_device_register_full()
527 kmalloc(sizeof(*pdev->dev.dma_mask), GFP_KERNEL); in platform_device_register_full()
528 if (!pdev->dev.dma_mask) in platform_device_register_full()
531 kmemleak_ignore(pdev->dev.dma_mask); in platform_device_register_full()
533 *pdev->dev.dma_mask = pdevinfo->dma_mask; in platform_device_register_full()
534 pdev->dev.coherent_dma_mask = pdevinfo->dma_mask; in platform_device_register_full()
538 pdevinfo->res, pdevinfo->num_res); in platform_device_register_full()
543 pdevinfo->data, pdevinfo->size_data); in platform_device_register_full()
547 if (pdevinfo->properties) { in platform_device_register_full()
549 pdevinfo->properties); in platform_device_register_full()
557 ACPI_COMPANION_SET(&pdev->dev, NULL); in platform_device_register_full()
558 kfree(pdev->dev.dma_mask); in platform_device_register_full()
571 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_probe()
575 ret = of_clk_set_defaults(_dev->of_node, false); in platform_drv_probe()
583 if (drv->probe) { in platform_drv_probe()
584 ret = drv->probe(dev); in platform_drv_probe()
590 if (drv->prevent_deferred_probe && ret == -EPROBE_DEFER) { in platform_drv_probe()
592 ret = -ENXIO; in platform_drv_probe()
600 return -ENXIO; in platform_drv_probe_fail()
605 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_remove()
609 if (drv->remove) in platform_drv_remove()
610 ret = drv->remove(dev); in platform_drv_remove()
618 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_shutdown()
621 if (drv->shutdown) in platform_drv_shutdown()
622 drv->shutdown(dev); in platform_drv_shutdown()
626 * __platform_driver_register - register a driver for platform-level devices
627 * @drv: platform driver structure
633 drv->driver.owner = owner; in __platform_driver_register()
634 drv->driver.bus = &platform_bus_type; in __platform_driver_register()
635 drv->driver.probe = platform_drv_probe; in __platform_driver_register()
636 drv->driver.remove = platform_drv_remove; in __platform_driver_register()
637 drv->driver.shutdown = platform_drv_shutdown; in __platform_driver_register()
639 return driver_register(&drv->driver); in __platform_driver_register()
644 * platform_driver_unregister - unregister a driver for platform-level devices
645 * @drv: platform driver structure
649 driver_unregister(&drv->driver); in platform_driver_unregister()
654 * __platform_driver_probe - register driver for non-hotpluggable device
655 * @drv: platform driver structure
661 * remove its run-once probe() infrastructure from memory after the driver
665 * into system-on-chip processors, where the controller devices have been
678 if (drv->driver.probe_type == PROBE_PREFER_ASYNCHRONOUS) { in __platform_driver_probe()
680 drv->driver.name, __func__); in __platform_driver_probe()
681 return -EINVAL; in __platform_driver_probe()
689 drv->driver.probe_type = PROBE_FORCE_SYNCHRONOUS; in __platform_driver_probe()
695 drv->prevent_deferred_probe = true; in __platform_driver_probe()
698 drv->driver.suppress_bind_attrs = true; in __platform_driver_probe()
701 drv->probe = probe; in __platform_driver_probe()
712 spin_lock(&drv->driver.bus->p->klist_drivers.k_lock); in __platform_driver_probe()
713 drv->probe = NULL; in __platform_driver_probe()
714 if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list)) in __platform_driver_probe()
715 retval = -ENODEV; in __platform_driver_probe()
716 drv->driver.probe = platform_drv_probe_fail; in __platform_driver_probe()
717 spin_unlock(&drv->driver.bus->p->klist_drivers.k_lock); in __platform_driver_probe()
726 * __platform_create_bundle - register driver and create corresponding device
727 * @driver: platform driver structure
731 * @data: platform specific data for this platform device
732 * @size: size of platform specific data
735 * Use this in legacy-style modules that probe hardware directly and
736 * register a single platform device and corresponding platform driver.
744 const void *data, size_t size, struct module *module) in __platform_create_bundle() argument
749 pdev = platform_device_alloc(driver->driver.name, -1); in __platform_create_bundle()
751 error = -ENOMEM; in __platform_create_bundle()
759 error = platform_device_add_data(pdev, data, size); in __platform_create_bundle()
783 * __platform_register_drivers - register an array of platform drivers
788 * Registers platform drivers specified by an array. On failure to register a
802 pr_debug("registering platform driver %ps\n", drivers[i]); in __platform_register_drivers()
806 pr_err("failed to register platform driver %ps: %d\n", in __platform_register_drivers()
815 while (i--) { in __platform_register_drivers()
816 pr_debug("unregistering platform driver %ps\n", drivers[i]); in __platform_register_drivers()
825 * platform_unregister_drivers - unregister an array of platform drivers
829 * Unegisters platform drivers specified by an array. This is typically used
836 while (count--) { in platform_unregister_drivers()
837 pr_debug("unregistering platform driver %ps\n", drivers[count]); in platform_unregister_drivers()
843 /* modalias support enables more hands-off userspace setup:
844 * (a) environment variable lets new-style hotplug events work once system is
846 * (b) sysfs attribute lets new-style coldplug recover from hotplug events
856 if (len != -ENODEV) in modalias_show()
859 len = acpi_device_modalias(dev, buf, PAGE_SIZE -1); in modalias_show()
860 if (len != -ENODEV) in modalias_show()
863 len = snprintf(buf, PAGE_SIZE, "platform:%s\n", pdev->name); in modalias_show()
865 return (len >= PAGE_SIZE) ? (PAGE_SIZE - 1) : len; in modalias_show()
877 if (count >= (PAGE_SIZE - 1)) in driver_override_store()
878 return -EINVAL; in driver_override_store()
882 return -ENOMEM; in driver_override_store()
889 old = pdev->driver_override; in driver_override_store()
891 pdev->driver_override = driver_override; in driver_override_store()
894 pdev->driver_override = NULL; in driver_override_store()
910 len = sprintf(buf, "%s\n", pdev->driver_override); in driver_override_show()
929 /* Some devices have extra OF data and an OF-style MODALIAS */ in platform_uevent()
931 if (rc != -ENODEV) in platform_uevent()
935 if (rc != -ENODEV) in platform_uevent()
939 pdev->name); in platform_uevent()
947 while (id->name[0]) { in platform_match_id()
948 if (strcmp(pdev->name, id->name) == 0) { in platform_match_id()
949 pdev->id_entry = id; in platform_match_id()
958 * platform_match - bind platform device to platform driver.
962 * Platform device IDs are assumed to be encoded like this:
976 if (pdev->driver_override) in platform_match()
977 return !strcmp(pdev->driver_override, drv->name); in platform_match()
988 if (pdrv->id_table) in platform_match()
989 return platform_match_id(pdrv->id_table, pdev) != NULL; in platform_match()
991 /* fall-back to driver name match */ in platform_match()
992 return (strcmp(pdev->name, drv->name) == 0); in platform_match()
999 struct platform_driver *pdrv = to_platform_driver(dev->driver); in platform_legacy_suspend()
1003 if (dev->driver && pdrv->suspend) in platform_legacy_suspend()
1004 ret = pdrv->suspend(pdev, mesg); in platform_legacy_suspend()
1011 struct platform_driver *pdrv = to_platform_driver(dev->driver); in platform_legacy_resume()
1015 if (dev->driver && pdrv->resume) in platform_legacy_resume()
1016 ret = pdrv->resume(pdev); in platform_legacy_resume()
1027 struct device_driver *drv = dev->driver; in platform_pm_suspend()
1033 if (drv->pm) { in platform_pm_suspend()
1034 if (drv->pm->suspend) in platform_pm_suspend()
1035 ret = drv->pm->suspend(dev); in platform_pm_suspend()
1045 struct device_driver *drv = dev->driver; in platform_pm_resume()
1051 if (drv->pm) { in platform_pm_resume()
1052 if (drv->pm->resume) in platform_pm_resume()
1053 ret = drv->pm->resume(dev); in platform_pm_resume()
1067 struct device_driver *drv = dev->driver; in platform_pm_freeze()
1073 if (drv->pm) { in platform_pm_freeze()
1074 if (drv->pm->freeze) in platform_pm_freeze()
1075 ret = drv->pm->freeze(dev); in platform_pm_freeze()
1085 struct device_driver *drv = dev->driver; in platform_pm_thaw()
1091 if (drv->pm) { in platform_pm_thaw()
1092 if (drv->pm->thaw) in platform_pm_thaw()
1093 ret = drv->pm->thaw(dev); in platform_pm_thaw()
1103 struct device_driver *drv = dev->driver; in platform_pm_poweroff()
1109 if (drv->pm) { in platform_pm_poweroff()
1110 if (drv->pm->poweroff) in platform_pm_poweroff()
1111 ret = drv->pm->poweroff(dev); in platform_pm_poweroff()
1121 struct device_driver *drv = dev->driver; in platform_pm_restore()
1127 if (drv->pm) { in platform_pm_restore()
1128 if (drv->pm->restore) in platform_pm_restore()
1129 ret = drv->pm->restore(dev); in platform_pm_restore()
1144 if (dev->of_node) { in platform_dma_configure()
1145 ret = of_dma_configure(dev, dev->of_node, true); in platform_dma_configure()
1147 attr = acpi_get_dma_attr(to_acpi_device_node(dev->fwnode)); in platform_dma_configure()
1162 .name = "platform",
1192 u32 low_totalram = ((max_pfn - 1) << PAGE_SHIFT); in dma_get_required_mask()
1193 u32 high_totalram = ((max_pfn - 1) >> (32 - PAGE_SHIFT)); in dma_get_required_mask()
1198 low_totalram = (1 << (fls(low_totalram) - 1)); in dma_get_required_mask()
1199 low_totalram += low_totalram - 1; in dma_get_required_mask()
1202 high_totalram = (1 << (fls(high_totalram) - 1)); in dma_get_required_mask()
1203 high_totalram += high_totalram - 1; in dma_get_required_mask()
1215 * early_platform_driver_register - register early platform driver
1228 * Drivers will by default be put on the list in compiled-in order. in early_platform_driver_register()
1230 if (!epdrv->list.next) { in early_platform_driver_register()
1231 INIT_LIST_HEAD(&epdrv->list); in early_platform_driver_register()
1232 list_add_tail(&epdrv->list, &early_platform_driver_list); in early_platform_driver_register()
1239 n = strlen(epdrv->pdrv->driver.name); in early_platform_driver_register()
1240 if (buf && !strncmp(buf, epdrv->pdrv->driver.name, n)) { in early_platform_driver_register()
1241 list_move(&epdrv->list, &early_platform_driver_list); in early_platform_driver_register()
1245 epdrv->requested_id = -1; in early_platform_driver_register()
1247 epdrv->requested_id = simple_strtoul(&buf[n + 1], in early_platform_driver_register()
1251 epdrv->requested_id = EARLY_PLATFORM_ID_ERROR; in early_platform_driver_register()
1260 if (epdrv->bufsize) { in early_platform_driver_register()
1261 memcpy(epdrv->buffer, &buf[n], in early_platform_driver_register()
1262 min_t(int, epdrv->bufsize, strlen(&buf[n]) + 1)); in early_platform_driver_register()
1263 epdrv->buffer[epdrv->bufsize - 1] = '\0'; in early_platform_driver_register()
1271 * early_platform_add_devices - adds a number of early platform devices
1272 * @devs: array of early platform devices to add
1273 * @num: number of early platform devices in array
1275 * Used by early architecture code to register early platform devices and
1276 * their platform data.
1285 dev = &devs[i]->dev; in early_platform_add_devices()
1287 if (!dev->devres_head.next) { in early_platform_add_devices()
1289 INIT_LIST_HEAD(&dev->devres_head); in early_platform_add_devices()
1290 list_add_tail(&dev->devres_head, in early_platform_add_devices()
1297 * early_platform_driver_register_all - register early platform drivers
1298 * @class_str: string to identify early platform driver class
1300 * Used by architecture code to register all early platform drivers
1301 * for a certain class. If omitted then only early platform drivers
1310 * Since we register our early platform drivers using early_param() in early_platform_driver_register_all()
1324 * early_platform_match - find early platform device matching driver
1325 * @epdrv: early platform driver structure
1334 if (platform_match(&pd->dev, &epdrv->pdrv->driver)) in early_platform_match()
1335 if (pd->id == id) in early_platform_match()
1342 * early_platform_left - check if early platform driver has matching devices
1343 * @epdrv: early platform driver structure
1352 if (platform_match(&pd->dev, &epdrv->pdrv->driver)) in early_platform_left()
1353 if (pd->id >= id) in early_platform_left()
1360 * early_platform_driver_probe_id - probe drivers matching class_str and id
1361 * @class_str: string to identify early platform driver class
1363 * @nr_probe: number of platform devices to successfully probe before exiting
1377 if (strcmp(class_str, epdrv->class_str)) in early_platform_driver_probe_id()
1380 if (id == -2) { in early_platform_driver_probe_id()
1381 match_id = epdrv->requested_id; in early_platform_driver_probe_id()
1389 switch (epdrv->requested_id) { in early_platform_driver_probe_id()
1394 if (epdrv->requested_id == id) in early_platform_driver_probe_id()
1402 class_str, epdrv->pdrv->driver.name); in early_platform_driver_probe_id()
1403 /* fall-through */ in early_platform_driver_probe_id()
1417 if (!match->dev.init_name && slab_is_available()) { in early_platform_driver_probe_id()
1418 if (match->id != -1) in early_platform_driver_probe_id()
1419 match->dev.init_name = in early_platform_driver_probe_id()
1421 match->name, in early_platform_driver_probe_id()
1422 match->id); in early_platform_driver_probe_id()
1424 match->dev.init_name = in early_platform_driver_probe_id()
1426 match->name); in early_platform_driver_probe_id()
1428 if (!match->dev.init_name) in early_platform_driver_probe_id()
1429 return -ENOMEM; in early_platform_driver_probe_id()
1432 if (epdrv->pdrv->probe(match)) in early_platform_driver_probe_id()
1434 class_str, match->name); in early_platform_driver_probe_id()
1446 return -ENODEV; in early_platform_driver_probe_id()
1450 * early_platform_driver_probe - probe a class of registered drivers
1451 * @class_str: string to identify early platform driver class
1452 * @nr_probe: number of platform devices to successfully probe before exiting
1453 * @user_only: only probe user specified early platform devices
1455 * Used by architecture code to probe registered early platform drivers
1456 * within a certain class. For probe to happen a registered early platform
1457 * device matching a registered early platform driver is needed.
1466 for (i = -2; n < nr_probe; i++) { in early_platform_driver_probe()
1467 k = early_platform_driver_probe_id(class_str, i, nr_probe - n); in early_platform_driver_probe()
1482 * early_platform_cleanup - clean up early platform code
1491 list_del(&pd->dev.devres_head); in early_platform_cleanup()
1492 memset(&pd->dev.devres_head, 0, sizeof(pd->dev.devres_head)); in early_platform_cleanup()