Lines Matching +full:platform +full:- +full:level
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-api/driver-model/platform.rst for more
18 #include <linux/dma-mapping.h>
26 #include <linux/clk/clk-conf.h>
39 .init_name = "platform",
44 * platform_get_resource - get a resource for a device
45 * @dev: platform device
56 for (i = 0; i < dev->num_resources; i++) { in platform_get_resource()
57 struct resource *r = &dev->resource[i]; in platform_get_resource()
59 if (type == resource_type(r) && num-- == 0) in platform_get_resource()
68 * devm_platform_get_and_ioremap_resource - call devm_ioremap_resource() for a
69 * platform device and get resource
71 * @pdev: platform device to use both for memory resource lookup as well as
88 return devm_ioremap_resource(&pdev->dev, r); in devm_platform_get_and_ioremap_resource()
93 * devm_platform_ioremap_resource - call devm_ioremap_resource() for a platform
96 * @pdev: platform device to use both for memory resource lookup as well as
111 * devm_platform_ioremap_resource_wc - write-combined variant of
114 * @pdev: platform device to use both for memory resource lookup as well as
127 return devm_ioremap_resource_wc(&pdev->dev, res); in devm_platform_ioremap_resource_wc()
131 * devm_platform_ioremap_resource_byname - call devm_ioremap_resource for
132 * a platform device, retrieve the
135 * @pdev: platform device to use both for memory resource lookup as well as
149 return devm_ioremap_resource(&pdev->dev, res); in devm_platform_ioremap_resource_byname()
155 * platform_get_irq_optional - get an optional IRQ for a device
156 * @dev: platform device
159 * Gets an IRQ for a platform device. Device drivers should check the return
170 * Return: non-zero IRQ number on success, negative error number on failure.
177 if (!dev || num >= dev->archdata.num_irqs) in platform_get_irq_optional()
178 return -ENXIO; in platform_get_irq_optional()
179 ret = dev->archdata.irqs[num]; in platform_get_irq_optional()
184 if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { in platform_get_irq_optional()
185 ret = of_irq_get(dev->dev.of_node, num); in platform_get_irq_optional()
186 if (ret > 0 || ret == -EPROBE_DEFER) in platform_get_irq_optional()
191 if (has_acpi_companion(&dev->dev)) { in platform_get_irq_optional()
192 if (r && r->flags & IORESOURCE_DISABLED) { in platform_get_irq_optional()
193 ret = acpi_irq_get(ACPI_HANDLE(&dev->dev), num, r); in platform_get_irq_optional()
202 * IORESOURCE_BITS correspond 1-to-1 to the IRQF_TRIGGER* in platform_get_irq_optional()
205 if (r && r->flags & IORESOURCE_BITS) { in platform_get_irq_optional()
208 irqd = irq_get_irq_data(r->start); in platform_get_irq_optional()
210 ret = -ENXIO; in platform_get_irq_optional()
213 irqd_set_trigger_type(irqd, r->flags & IORESOURCE_BITS); in platform_get_irq_optional()
217 ret = r->start; in platform_get_irq_optional()
228 if (num == 0 && has_acpi_companion(&dev->dev)) { in platform_get_irq_optional()
229 ret = acpi_dev_gpio_irq_get(ACPI_COMPANION(&dev->dev), num); in platform_get_irq_optional()
230 /* Our callers expect -ENXIO for missing IRQs. */ in platform_get_irq_optional()
231 if (ret >= 0 || ret == -EPROBE_DEFER) in platform_get_irq_optional()
235 ret = -ENXIO; in platform_get_irq_optional()
244 * platform_get_irq - get an IRQ for a device
245 * @dev: platform device
248 * Gets an IRQ for a platform device and prints an error message if finding the
258 * Return: non-zero IRQ number on success, negative error number on failure.
265 if (ret < 0 && ret != -EPROBE_DEFER) in platform_get_irq()
266 dev_err(&dev->dev, "IRQ index %u not found\n", num); in platform_get_irq()
273 * platform_irq_count - Count the number of IRQs a platform device uses
274 * @dev: platform device
276 * Return: Number of IRQs a platform device uses or EPROBE_DEFER
285 if (ret == -EPROBE_DEFER) in platform_irq_count()
293 * platform_get_resource_byname - get a resource for a device by name
294 * @dev: platform device
304 for (i = 0; i < dev->num_resources; i++) { in platform_get_resource_byname()
305 struct resource *r = &dev->resource[i]; in platform_get_resource_byname()
307 if (unlikely(!r->name)) in platform_get_resource_byname()
310 if (type == resource_type(r) && !strcmp(r->name, name)) in platform_get_resource_byname()
323 if (IS_ENABLED(CONFIG_OF_IRQ) && dev->dev.of_node) { in __platform_get_irq_byname()
324 ret = of_irq_get_byname(dev->dev.of_node, name); in __platform_get_irq_byname()
325 if (ret > 0 || ret == -EPROBE_DEFER) in __platform_get_irq_byname()
331 WARN(r->start == 0, "0 is an invalid IRQ number\n"); in __platform_get_irq_byname()
332 return r->start; in __platform_get_irq_byname()
335 return -ENXIO; in __platform_get_irq_byname()
339 * platform_get_irq_byname - get an IRQ for a device by name
340 * @dev: platform device
345 * Return: non-zero IRQ number on success, negative error number on failure.
352 if (ret < 0 && ret != -EPROBE_DEFER) in platform_get_irq_byname()
353 dev_err(&dev->dev, "IRQ %s not found\n", name); in platform_get_irq_byname()
360 * platform_get_irq_byname_optional - get an optional IRQ for a device by name
361 * @dev: platform device
367 * Return: non-zero IRQ number on success, negative error number on failure.
377 * platform_add_devices - add a numbers of platform devices
378 * @devs: array of platform devices to add
379 * @num: number of platform devices in array
388 while (--i >= 0) in platform_add_devices()
404 * Set up default DMA mask for platform devices if the they weren't
409 pdev->dev.dma_parms = &pdev->dma_parms; in setup_pdev_dma_masks()
411 if (!pdev->dev.coherent_dma_mask) in setup_pdev_dma_masks()
412 pdev->dev.coherent_dma_mask = DMA_BIT_MASK(32); in setup_pdev_dma_masks()
413 if (!pdev->dev.dma_mask) { in setup_pdev_dma_masks()
414 pdev->platform_dma_mask = DMA_BIT_MASK(32); in setup_pdev_dma_masks()
415 pdev->dev.dma_mask = &pdev->platform_dma_mask; in setup_pdev_dma_masks()
420 * platform_device_put - destroy a platform device
421 * @pdev: platform device to free
423 * Free all memory associated with a platform device. This function must
429 put_device(&pdev->dev); in platform_device_put()
438 of_device_node_put(&pa->pdev.dev); in platform_device_release()
439 kfree(pa->pdev.dev.platform_data); in platform_device_release()
440 kfree(pa->pdev.mfd_cell); in platform_device_release()
441 kfree(pa->pdev.resource); in platform_device_release()
442 kfree(pa->pdev.driver_override); in platform_device_release()
447 * platform_device_alloc - create a platform device
451 * Create a platform device object which can have other objects attached
460 strcpy(pa->name, name); in platform_device_alloc()
461 pa->pdev.name = pa->name; in platform_device_alloc()
462 pa->pdev.id = id; in platform_device_alloc()
463 device_initialize(&pa->pdev.dev); in platform_device_alloc()
464 pa->pdev.dev.release = platform_device_release; in platform_device_alloc()
465 setup_pdev_dma_masks(&pa->pdev); in platform_device_alloc()
468 return pa ? &pa->pdev : NULL; in platform_device_alloc()
473 * platform_device_add_resources - add resources to a platform device
474 * @pdev: platform device allocated by platform_device_alloc to add resources to
478 * Add a copy of the resources to the platform device. The memory
479 * associated with the resources will be freed when the platform device is
490 return -ENOMEM; in platform_device_add_resources()
493 kfree(pdev->resource); in platform_device_add_resources()
494 pdev->resource = r; in platform_device_add_resources()
495 pdev->num_resources = num; in platform_device_add_resources()
501 * platform_device_add_data - add platform-specific data to a platform device
502 * @pdev: platform device allocated by platform_device_alloc to add resources to
503 * @data: platform specific data for this platform device
504 * @size: size of platform specific data
506 * Add a copy of platform specific data to the platform device's
507 * platform_data pointer. The memory associated with the platform data
508 * will be freed when the platform device is released.
518 return -ENOMEM; in platform_device_add_data()
521 kfree(pdev->dev.platform_data); in platform_device_add_data()
522 pdev->dev.platform_data = d; in platform_device_add_data()
528 * platform_device_add_properties - add built-in properties to a platform device
529 * @pdev: platform device to add properties to
533 * platform device. The memory associated with properties will be freed when the
534 * platform device is released.
539 return device_add_properties(&pdev->dev, properties); in platform_device_add_properties()
544 * platform_device_add - add a platform device to device hierarchy
545 * @pdev: platform device we're adding
556 return -EINVAL; in platform_device_add()
558 if (!pdev->dev.parent) in platform_device_add()
559 pdev->dev.parent = &platform_bus; in platform_device_add()
561 pdev->dev.bus = &platform_bus_type; in platform_device_add()
563 switch (pdev->id) { in platform_device_add()
565 dev_set_name(&pdev->dev, "%s.%d", pdev->name, pdev->id); in platform_device_add()
568 dev_set_name(&pdev->dev, "%s", pdev->name); in platform_device_add()
579 pdev->id = ret; in platform_device_add()
580 pdev->id_auto = true; in platform_device_add()
581 dev_set_name(&pdev->dev, "%s.%d.auto", pdev->name, pdev->id); in platform_device_add()
585 for (i = 0; i < pdev->num_resources; i++) { in platform_device_add()
586 struct resource *p, *r = &pdev->resource[i]; in platform_device_add()
588 if (r->name == NULL) in platform_device_add()
589 r->name = dev_name(&pdev->dev); in platform_device_add()
591 p = r->parent; in platform_device_add()
602 dev_err(&pdev->dev, "failed to claim resource %d: %pR\n", i, r); in platform_device_add()
608 pr_debug("Registering platform device '%s'. Parent at %s\n", in platform_device_add()
609 dev_name(&pdev->dev), dev_name(pdev->dev.parent)); in platform_device_add()
611 ret = device_add(&pdev->dev); in platform_device_add()
616 if (pdev->id_auto) { in platform_device_add()
617 ida_free(&platform_devid_ida, pdev->id); in platform_device_add()
618 pdev->id = PLATFORM_DEVID_AUTO; in platform_device_add()
621 while (i--) { in platform_device_add()
622 struct resource *r = &pdev->resource[i]; in platform_device_add()
623 if (r->parent) in platform_device_add()
633 * platform_device_del - remove a platform-level device
634 * @pdev: platform device we're removing
636 * Note that this function will also release all memory- and port-based
637 * resources owned by the device (@dev->resource). This function must
645 device_del(&pdev->dev); in platform_device_del()
647 if (pdev->id_auto) { in platform_device_del()
648 ida_free(&platform_devid_ida, pdev->id); in platform_device_del()
649 pdev->id = PLATFORM_DEVID_AUTO; in platform_device_del()
652 for (i = 0; i < pdev->num_resources; i++) { in platform_device_del()
653 struct resource *r = &pdev->resource[i]; in platform_device_del()
654 if (r->parent) in platform_device_del()
662 * platform_device_register - add a platform-level device
663 * @pdev: platform device we're adding
667 device_initialize(&pdev->dev); in platform_device_register()
674 * platform_device_unregister - unregister a platform-level device
675 * @pdev: platform device we're unregistering
689 * platform_device_register_full - add a platform-level device with
690 * resources and platform-specific data
702 pdev = platform_device_alloc(pdevinfo->name, pdevinfo->id); in platform_device_register_full()
704 return ERR_PTR(-ENOMEM); in platform_device_register_full()
706 pdev->dev.parent = pdevinfo->parent; in platform_device_register_full()
707 pdev->dev.fwnode = pdevinfo->fwnode; in platform_device_register_full()
708 pdev->dev.of_node = of_node_get(to_of_node(pdev->dev.fwnode)); in platform_device_register_full()
709 pdev->dev.of_node_reused = pdevinfo->of_node_reused; in platform_device_register_full()
711 if (pdevinfo->dma_mask) { in platform_device_register_full()
712 pdev->platform_dma_mask = pdevinfo->dma_mask; in platform_device_register_full()
713 pdev->dev.dma_mask = &pdev->platform_dma_mask; in platform_device_register_full()
714 pdev->dev.coherent_dma_mask = pdevinfo->dma_mask; in platform_device_register_full()
718 pdevinfo->res, pdevinfo->num_res); in platform_device_register_full()
723 pdevinfo->data, pdevinfo->size_data); in platform_device_register_full()
727 if (pdevinfo->properties) { in platform_device_register_full()
729 pdevinfo->properties); in platform_device_register_full()
737 ACPI_COMPANION_SET(&pdev->dev, NULL); in platform_device_register_full()
748 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_probe()
752 ret = of_clk_set_defaults(_dev->of_node, false); in platform_drv_probe()
760 if (drv->probe) { in platform_drv_probe()
761 ret = drv->probe(dev); in platform_drv_probe()
767 if (drv->prevent_deferred_probe && ret == -EPROBE_DEFER) { in platform_drv_probe()
769 ret = -ENXIO; in platform_drv_probe()
777 return -ENXIO; in platform_drv_probe_fail()
782 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_remove()
786 if (drv->remove) in platform_drv_remove()
787 ret = drv->remove(dev); in platform_drv_remove()
795 struct platform_driver *drv = to_platform_driver(_dev->driver); in platform_drv_shutdown()
798 if (drv->shutdown) in platform_drv_shutdown()
799 drv->shutdown(dev); in platform_drv_shutdown()
803 * __platform_driver_register - register a driver for platform-level devices
804 * @drv: platform driver structure
810 drv->driver.owner = owner; in __platform_driver_register()
811 drv->driver.bus = &platform_bus_type; in __platform_driver_register()
812 drv->driver.probe = platform_drv_probe; in __platform_driver_register()
813 drv->driver.remove = platform_drv_remove; in __platform_driver_register()
814 drv->driver.shutdown = platform_drv_shutdown; in __platform_driver_register()
816 return driver_register(&drv->driver); in __platform_driver_register()
821 * platform_driver_unregister - unregister a driver for platform-level devices
822 * @drv: platform driver structure
826 driver_unregister(&drv->driver); in platform_driver_unregister()
831 * __platform_driver_probe - register driver for non-hotpluggable device
832 * @drv: platform driver structure
838 * remove its run-once probe() infrastructure from memory after the driver
842 * into system-on-chip processors, where the controller devices have been
855 if (drv->driver.probe_type == PROBE_PREFER_ASYNCHRONOUS) { in __platform_driver_probe()
857 drv->driver.name, __func__); in __platform_driver_probe()
858 return -EINVAL; in __platform_driver_probe()
866 drv->driver.probe_type = PROBE_FORCE_SYNCHRONOUS; in __platform_driver_probe()
872 drv->prevent_deferred_probe = true; in __platform_driver_probe()
875 drv->driver.suppress_bind_attrs = true; in __platform_driver_probe()
878 drv->probe = probe; in __platform_driver_probe()
889 spin_lock(&drv->driver.bus->p->klist_drivers.k_lock); in __platform_driver_probe()
890 drv->probe = NULL; in __platform_driver_probe()
891 if (code == 0 && list_empty(&drv->driver.p->klist_devices.k_list)) in __platform_driver_probe()
892 retval = -ENODEV; in __platform_driver_probe()
893 drv->driver.probe = platform_drv_probe_fail; in __platform_driver_probe()
894 spin_unlock(&drv->driver.bus->p->klist_drivers.k_lock); in __platform_driver_probe()
903 * __platform_create_bundle - register driver and create corresponding device
904 * @driver: platform driver structure
908 * @data: platform specific data for this platform device
909 * @size: size of platform specific data
912 * Use this in legacy-style modules that probe hardware directly and
913 * register a single platform device and corresponding platform driver.
926 pdev = platform_device_alloc(driver->driver.name, -1); in __platform_create_bundle()
928 error = -ENOMEM; in __platform_create_bundle()
960 * __platform_register_drivers - register an array of platform drivers
965 * Registers platform drivers specified by an array. On failure to register a
979 pr_debug("registering platform driver %ps\n", drivers[i]); in __platform_register_drivers()
983 pr_err("failed to register platform driver %ps: %d\n", in __platform_register_drivers()
992 while (i--) { in __platform_register_drivers()
993 pr_debug("unregistering platform driver %ps\n", drivers[i]); in __platform_register_drivers()
1002 * platform_unregister_drivers - unregister an array of platform drivers
1006 * Unregisters platform drivers specified by an array. This is typically used
1013 while (count--) { in platform_unregister_drivers()
1014 pr_debug("unregistering platform driver %ps\n", drivers[count]); in platform_unregister_drivers()
1020 /* modalias support enables more hands-off userspace setup:
1021 * (a) environment variable lets new-style hotplug events work once system is
1023 * (b) sysfs attribute lets new-style coldplug recover from hotplug events
1033 if (len != -ENODEV) in modalias_show()
1036 len = acpi_device_modalias(dev, buf, PAGE_SIZE - 1); in modalias_show()
1037 if (len != -ENODEV) in modalias_show()
1040 return sysfs_emit(buf, "platform:%s\n", pdev->name); in modalias_show()
1052 if (count >= (PAGE_SIZE - 1)) in driver_override_store()
1053 return -EINVAL; in driver_override_store()
1057 return -ENOMEM; in driver_override_store()
1064 old = pdev->driver_override; in driver_override_store()
1066 pdev->driver_override = driver_override; in driver_override_store()
1069 pdev->driver_override = NULL; in driver_override_store()
1085 len = sysfs_emit(buf, "%s\n", pdev->driver_override); in driver_override_show()
1108 return a->mode; in platform_dev_attrs_visible()
1129 /* Some devices have extra OF data and an OF-style MODALIAS */ in platform_uevent()
1131 if (rc != -ENODEV) in platform_uevent()
1135 if (rc != -ENODEV) in platform_uevent()
1139 pdev->name); in platform_uevent()
1147 while (id->name[0]) { in platform_match_id()
1148 if (strcmp(pdev->name, id->name) == 0) { in platform_match_id()
1149 pdev->id_entry = id; in platform_match_id()
1158 * platform_match - bind platform device to platform driver.
1162 * Platform device IDs are assumed to be encoded like this:
1176 if (pdev->driver_override) in platform_match()
1177 return !strcmp(pdev->driver_override, drv->name); in platform_match()
1188 if (pdrv->id_table) in platform_match()
1189 return platform_match_id(pdrv->id_table, pdev) != NULL; in platform_match()
1191 /* fall-back to driver name match */ in platform_match()
1192 return (strcmp(pdev->name, drv->name) == 0); in platform_match()
1199 struct platform_driver *pdrv = to_platform_driver(dev->driver); in platform_legacy_suspend()
1203 if (dev->driver && pdrv->suspend) in platform_legacy_suspend()
1204 ret = pdrv->suspend(pdev, mesg); in platform_legacy_suspend()
1211 struct platform_driver *pdrv = to_platform_driver(dev->driver); in platform_legacy_resume()
1215 if (dev->driver && pdrv->resume) in platform_legacy_resume()
1216 ret = pdrv->resume(pdev); in platform_legacy_resume()
1227 struct device_driver *drv = dev->driver; in platform_pm_suspend()
1233 if (drv->pm) { in platform_pm_suspend()
1234 if (drv->pm->suspend) in platform_pm_suspend()
1235 ret = drv->pm->suspend(dev); in platform_pm_suspend()
1245 struct device_driver *drv = dev->driver; in platform_pm_resume()
1251 if (drv->pm) { in platform_pm_resume()
1252 if (drv->pm->resume) in platform_pm_resume()
1253 ret = drv->pm->resume(dev); in platform_pm_resume()
1267 struct device_driver *drv = dev->driver; in platform_pm_freeze()
1273 if (drv->pm) { in platform_pm_freeze()
1274 if (drv->pm->freeze) in platform_pm_freeze()
1275 ret = drv->pm->freeze(dev); in platform_pm_freeze()
1285 struct device_driver *drv = dev->driver; in platform_pm_thaw()
1291 if (drv->pm) { in platform_pm_thaw()
1292 if (drv->pm->thaw) in platform_pm_thaw()
1293 ret = drv->pm->thaw(dev); in platform_pm_thaw()
1303 struct device_driver *drv = dev->driver; in platform_pm_poweroff()
1309 if (drv->pm) { in platform_pm_poweroff()
1310 if (drv->pm->poweroff) in platform_pm_poweroff()
1311 ret = drv->pm->poweroff(dev); in platform_pm_poweroff()
1321 struct device_driver *drv = dev->driver; in platform_pm_restore()
1327 if (drv->pm) { in platform_pm_restore()
1328 if (drv->pm->restore) in platform_pm_restore()
1329 ret = drv->pm->restore(dev); in platform_pm_restore()
1344 if (dev->of_node) { in platform_dma_configure()
1345 ret = of_dma_configure(dev, dev->of_node, true); in platform_dma_configure()
1347 attr = acpi_get_dma_attr(to_acpi_device_node(dev->fwnode)); in platform_dma_configure()
1361 .name = "platform",
1376 * platform_find_device_by_driver - Find a platform device with a given