| // SPDX-License-Identifier: GPL-2.0-only |
| /* |
| * Driver for onboard USB hubs |
| * |
| * Copyright (c) 2022, Google LLC |
| */ |
| |
| #include <linux/device.h> |
| #include <linux/export.h> |
| #include <linux/gpio/consumer.h> |
| #include <linux/init.h> |
| #include <linux/kernel.h> |
| #include <linux/list.h> |
| #include <linux/module.h> |
| #include <linux/mutex.h> |
| #include <linux/of.h> |
| #include <linux/of_platform.h> |
| #include <linux/platform_device.h> |
| #include <linux/regulator/consumer.h> |
| #include <linux/slab.h> |
| #include <linux/suspend.h> |
| #include <linux/sysfs.h> |
| #include <linux/usb.h> |
| #include <linux/usb/hcd.h> |
| #include <linux/usb/onboard_hub.h> |
| #include <linux/workqueue.h> |
| |
| #include "onboard_usb_hub.h" |
| |
| static void onboard_hub_attach_usb_driver(struct work_struct *work); |
| |
| static struct usb_device_driver onboard_hub_usbdev_driver; |
| static DECLARE_WORK(attach_usb_driver_work, onboard_hub_attach_usb_driver); |
| |
| /************************** Platform driver **************************/ |
| |
| struct usbdev_node { |
| struct usb_device *udev; |
| struct list_head list; |
| }; |
| |
| struct onboard_hub { |
| struct regulator *vdd; |
| struct device *dev; |
| const struct onboard_hub_pdata *pdata; |
| struct gpio_desc *reset_gpio; |
| bool always_powered_in_suspend; |
| bool is_powered_on; |
| bool going_away; |
| struct list_head udev_list; |
| struct mutex lock; |
| }; |
| |
| static int onboard_hub_power_on(struct onboard_hub *hub) |
| { |
| int err; |
| |
| err = regulator_enable(hub->vdd); |
| if (err) { |
| dev_err(hub->dev, "failed to enable regulator: %d\n", err); |
| return err; |
| } |
| |
| fsleep(hub->pdata->reset_us); |
| gpiod_set_value_cansleep(hub->reset_gpio, 0); |
| |
| hub->is_powered_on = true; |
| |
| return 0; |
| } |
| |
| static int onboard_hub_power_off(struct onboard_hub *hub) |
| { |
| int err; |
| |
| gpiod_set_value_cansleep(hub->reset_gpio, 1); |
| |
| err = regulator_disable(hub->vdd); |
| if (err) { |
| dev_err(hub->dev, "failed to disable regulator: %d\n", err); |
| return err; |
| } |
| |
| hub->is_powered_on = false; |
| |
| return 0; |
| } |
| |
| static int __maybe_unused onboard_hub_suspend(struct device *dev) |
| { |
| struct onboard_hub *hub = dev_get_drvdata(dev); |
| struct usbdev_node *node; |
| bool power_off = true; |
| |
| if (hub->always_powered_in_suspend) |
| return 0; |
| |
| mutex_lock(&hub->lock); |
| |
| list_for_each_entry(node, &hub->udev_list, list) { |
| if (!device_may_wakeup(node->udev->bus->controller)) |
| continue; |
| |
| if (usb_wakeup_enabled_descendants(node->udev)) { |
| power_off = false; |
| break; |
| } |
| } |
| |
| mutex_unlock(&hub->lock); |
| |
| if (!power_off) |
| return 0; |
| |
| return onboard_hub_power_off(hub); |
| } |
| |
| static int __maybe_unused onboard_hub_resume(struct device *dev) |
| { |
| struct onboard_hub *hub = dev_get_drvdata(dev); |
| |
| if (hub->is_powered_on) |
| return 0; |
| |
| return onboard_hub_power_on(hub); |
| } |
| |
| static inline void get_udev_link_name(const struct usb_device *udev, char *buf, size_t size) |
| { |
| snprintf(buf, size, "usb_dev.%s", dev_name(&udev->dev)); |
| } |
| |
| static int onboard_hub_add_usbdev(struct onboard_hub *hub, struct usb_device *udev) |
| { |
| struct usbdev_node *node; |
| char link_name[64]; |
| int err; |
| |
| mutex_lock(&hub->lock); |
| |
| if (hub->going_away) { |
| err = -EINVAL; |
| goto error; |
| } |
| |
| node = kzalloc(sizeof(*node), GFP_KERNEL); |
| if (!node) { |
| err = -ENOMEM; |
| goto error; |
| } |
| |
| node->udev = udev; |
| |
| list_add(&node->list, &hub->udev_list); |
| |
| mutex_unlock(&hub->lock); |
| |
| get_udev_link_name(udev, link_name, sizeof(link_name)); |
| WARN_ON(sysfs_create_link(&hub->dev->kobj, &udev->dev.kobj, link_name)); |
| |
| return 0; |
| |
| error: |
| mutex_unlock(&hub->lock); |
| |
| return err; |
| } |
| |
| static void onboard_hub_remove_usbdev(struct onboard_hub *hub, const struct usb_device *udev) |
| { |
| struct usbdev_node *node; |
| char link_name[64]; |
| |
| get_udev_link_name(udev, link_name, sizeof(link_name)); |
| sysfs_remove_link(&hub->dev->kobj, link_name); |
| |
| mutex_lock(&hub->lock); |
| |
| list_for_each_entry(node, &hub->udev_list, list) { |
| if (node->udev == udev) { |
| list_del(&node->list); |
| kfree(node); |
| break; |
| } |
| } |
| |
| mutex_unlock(&hub->lock); |
| } |
| |
| static ssize_t always_powered_in_suspend_show(struct device *dev, struct device_attribute *attr, |
| char *buf) |
| { |
| const struct onboard_hub *hub = dev_get_drvdata(dev); |
| |
| return sysfs_emit(buf, "%d\n", hub->always_powered_in_suspend); |
| } |
| |
| static ssize_t always_powered_in_suspend_store(struct device *dev, struct device_attribute *attr, |
| const char *buf, size_t count) |
| { |
| struct onboard_hub *hub = dev_get_drvdata(dev); |
| bool val; |
| int ret; |
| |
| ret = kstrtobool(buf, &val); |
| if (ret < 0) |
| return ret; |
| |
| hub->always_powered_in_suspend = val; |
| |
| return count; |
| } |
| static DEVICE_ATTR_RW(always_powered_in_suspend); |
| |
| static struct attribute *onboard_hub_attrs[] = { |
| &dev_attr_always_powered_in_suspend.attr, |
| NULL, |
| }; |
| ATTRIBUTE_GROUPS(onboard_hub); |
| |
| static void onboard_hub_attach_usb_driver(struct work_struct *work) |
| { |
| int err; |
| |
| err = driver_attach(&onboard_hub_usbdev_driver.drvwrap.driver); |
| if (err) |
| pr_err("Failed to attach USB driver: %d\n", err); |
| } |
| |
| static int onboard_hub_probe(struct platform_device *pdev) |
| { |
| const struct of_device_id *of_id; |
| struct device *dev = &pdev->dev; |
| struct onboard_hub *hub; |
| int err; |
| |
| hub = devm_kzalloc(dev, sizeof(*hub), GFP_KERNEL); |
| if (!hub) |
| return -ENOMEM; |
| |
| of_id = of_match_device(onboard_hub_match, &pdev->dev); |
| if (!of_id) |
| return -ENODEV; |
| |
| hub->pdata = of_id->data; |
| if (!hub->pdata) |
| return -EINVAL; |
| |
| hub->vdd = devm_regulator_get(dev, "vdd"); |
| if (IS_ERR(hub->vdd)) |
| return PTR_ERR(hub->vdd); |
| |
| hub->reset_gpio = devm_gpiod_get_optional(dev, "reset", |
| GPIOD_OUT_HIGH); |
| if (IS_ERR(hub->reset_gpio)) |
| return dev_err_probe(dev, PTR_ERR(hub->reset_gpio), "failed to get reset GPIO\n"); |
| |
| hub->dev = dev; |
| mutex_init(&hub->lock); |
| INIT_LIST_HEAD(&hub->udev_list); |
| |
| dev_set_drvdata(dev, hub); |
| |
| err = onboard_hub_power_on(hub); |
| if (err) |
| return err; |
| |
| /* |
| * The USB driver might have been detached from the USB devices by |
| * onboard_hub_remove() (e.g. through an 'unbind' by userspace), |
| * make sure to re-attach it if needed. |
| * |
| * This needs to be done deferred to avoid self-deadlocks on systems |
| * with nested onboard hubs. |
| */ |
| schedule_work(&attach_usb_driver_work); |
| |
| return 0; |
| } |
| |
| static int onboard_hub_remove(struct platform_device *pdev) |
| { |
| struct onboard_hub *hub = dev_get_drvdata(&pdev->dev); |
| struct usbdev_node *node; |
| struct usb_device *udev; |
| |
| hub->going_away = true; |
| |
| mutex_lock(&hub->lock); |
| |
| /* unbind the USB devices to avoid dangling references to this device */ |
| while (!list_empty(&hub->udev_list)) { |
| node = list_first_entry(&hub->udev_list, struct usbdev_node, list); |
| udev = node->udev; |
| |
| /* |
| * Unbinding the driver will call onboard_hub_remove_usbdev(), |
| * which acquires hub->lock. We must release the lock first. |
| */ |
| get_device(&udev->dev); |
| mutex_unlock(&hub->lock); |
| device_release_driver(&udev->dev); |
| put_device(&udev->dev); |
| mutex_lock(&hub->lock); |
| } |
| |
| mutex_unlock(&hub->lock); |
| |
| return onboard_hub_power_off(hub); |
| } |
| |
| MODULE_DEVICE_TABLE(of, onboard_hub_match); |
| |
| static const struct dev_pm_ops __maybe_unused onboard_hub_pm_ops = { |
| SET_LATE_SYSTEM_SLEEP_PM_OPS(onboard_hub_suspend, onboard_hub_resume) |
| }; |
| |
| static struct platform_driver onboard_hub_driver = { |
| .probe = onboard_hub_probe, |
| .remove = onboard_hub_remove, |
| |
| .driver = { |
| .name = "onboard-usb-hub", |
| .of_match_table = onboard_hub_match, |
| .pm = pm_ptr(&onboard_hub_pm_ops), |
| .dev_groups = onboard_hub_groups, |
| }, |
| }; |
| |
| /************************** USB driver **************************/ |
| |
| #define VENDOR_ID_MICROCHIP 0x0424 |
| #define VENDOR_ID_REALTEK 0x0bda |
| #define VENDOR_ID_TI 0x0451 |
| |
| /* |
| * Returns the onboard_hub platform device that is associated with the USB |
| * device passed as parameter. |
| */ |
| static struct onboard_hub *_find_onboard_hub(struct device *dev) |
| { |
| struct platform_device *pdev; |
| struct device_node *np; |
| struct onboard_hub *hub; |
| |
| pdev = of_find_device_by_node(dev->of_node); |
| if (!pdev) { |
| np = of_parse_phandle(dev->of_node, "peer-hub", 0); |
| if (!np) { |
| dev_err(dev, "failed to find device node for peer hub\n"); |
| return ERR_PTR(-EINVAL); |
| } |
| |
| pdev = of_find_device_by_node(np); |
| of_node_put(np); |
| |
| if (!pdev) |
| return ERR_PTR(-ENODEV); |
| } |
| |
| hub = dev_get_drvdata(&pdev->dev); |
| put_device(&pdev->dev); |
| |
| /* |
| * The presence of drvdata ('hub') indicates that the platform driver |
| * finished probing. This handles the case where (conceivably) we could |
| * be running at the exact same time as the platform driver's probe. If |
| * we detect the race we request probe deferral and we'll come back and |
| * try again. |
| */ |
| if (!hub) |
| return ERR_PTR(-EPROBE_DEFER); |
| |
| return hub; |
| } |
| |
| static int onboard_hub_usbdev_probe(struct usb_device *udev) |
| { |
| struct device *dev = &udev->dev; |
| struct onboard_hub *hub; |
| int err; |
| |
| /* ignore supported hubs without device tree node */ |
| if (!dev->of_node) |
| return -ENODEV; |
| |
| hub = _find_onboard_hub(dev); |
| if (IS_ERR(hub)) |
| return PTR_ERR(hub); |
| |
| dev_set_drvdata(dev, hub); |
| |
| err = onboard_hub_add_usbdev(hub, udev); |
| if (err) |
| return err; |
| |
| return 0; |
| } |
| |
| static void onboard_hub_usbdev_disconnect(struct usb_device *udev) |
| { |
| struct onboard_hub *hub = dev_get_drvdata(&udev->dev); |
| |
| onboard_hub_remove_usbdev(hub, udev); |
| } |
| |
| static const struct usb_device_id onboard_hub_id_table[] = { |
| { USB_DEVICE(VENDOR_ID_MICROCHIP, 0x2514) }, /* USB2514B USB 2.0 */ |
| { USB_DEVICE(VENDOR_ID_MICROCHIP, 0x2517) }, /* USB2517 USB 2.0 */ |
| { USB_DEVICE(VENDOR_ID_REALTEK, 0x0411) }, /* RTS5411 USB 3.1 */ |
| { USB_DEVICE(VENDOR_ID_REALTEK, 0x5411) }, /* RTS5411 USB 2.1 */ |
| { USB_DEVICE(VENDOR_ID_REALTEK, 0x0414) }, /* RTS5414 USB 3.2 */ |
| { USB_DEVICE(VENDOR_ID_REALTEK, 0x5414) }, /* RTS5414 USB 2.1 */ |
| { USB_DEVICE(VENDOR_ID_TI, 0x8140) }, /* TI USB8041 3.0 */ |
| { USB_DEVICE(VENDOR_ID_TI, 0x8142) }, /* TI USB8041 2.0 */ |
| {} |
| }; |
| MODULE_DEVICE_TABLE(usb, onboard_hub_id_table); |
| |
| static struct usb_device_driver onboard_hub_usbdev_driver = { |
| .name = "onboard-usb-hub", |
| .probe = onboard_hub_usbdev_probe, |
| .disconnect = onboard_hub_usbdev_disconnect, |
| .generic_subclass = 1, |
| .supports_autosuspend = 1, |
| .id_table = onboard_hub_id_table, |
| }; |
| |
| static int __init onboard_hub_init(void) |
| { |
| int ret; |
| |
| ret = usb_register_device_driver(&onboard_hub_usbdev_driver, THIS_MODULE); |
| if (ret) |
| return ret; |
| |
| ret = platform_driver_register(&onboard_hub_driver); |
| if (ret) |
| usb_deregister_device_driver(&onboard_hub_usbdev_driver); |
| |
| return ret; |
| } |
| module_init(onboard_hub_init); |
| |
| static void __exit onboard_hub_exit(void) |
| { |
| usb_deregister_device_driver(&onboard_hub_usbdev_driver); |
| platform_driver_unregister(&onboard_hub_driver); |
| |
| cancel_work_sync(&attach_usb_driver_work); |
| } |
| module_exit(onboard_hub_exit); |
| |
| MODULE_AUTHOR("Matthias Kaehlcke <mka@chromium.org>"); |
| MODULE_DESCRIPTION("Driver for discrete onboard USB hubs"); |
| MODULE_LICENSE("GPL v2"); |