1 // SPDX-License-Identifier: GPL-2.0
3  * USB Role Switch Support
10 #include <linux/usb/role.h>
38  * usb_role_switch_set_role - Set USB role for a switch
39  * @sw: USB role switch
40  * @role: USB role to be switched to
42  * Set USB role @role for @sw.
51 	mutex_lock(&sw->lock);  in usb_role_switch_set_role()
53 	ret = sw->set(sw, role);  in usb_role_switch_set_role()
55 		sw->role = role;  in usb_role_switch_set_role()
56 		kobject_uevent(&sw->dev.kobj, KOBJ_CHANGE);  in usb_role_switch_set_role()
59 	mutex_unlock(&sw->lock);  in usb_role_switch_set_role()
66  * usb_role_switch_get_role - Get the USB role for a switch
67  * @sw: USB role switch
69  * Depending on the role-switch-driver this function returns either a cached
79 	mutex_lock(&sw->lock);  in usb_role_switch_get_role()
81 	if (sw->get)  in usb_role_switch_get_role()
82 		role = sw->get(sw);  in usb_role_switch_get_role()
84 		role = sw->role;  in usb_role_switch_get_role()
86 	mutex_unlock(&sw->lock);  in usb_role_switch_get_role()
102 	return dev ? to_role_switch(dev) : ERR_PTR(-EPROBE_DEFER);  in usb_role_switch_match()
111 	if (!fwnode_property_present(parent, "usb-role-switch")) {  in usb_role_switch_is_parent()
118 	return dev ? to_role_switch(dev) : ERR_PTR(-EPROBE_DEFER);  in usb_role_switch_is_parent()
122  * usb_role_switch_get - Find USB role switch linked with the caller
125  * Finds and returns role switch linked with @dev. The reference count for the
126  * found switch is incremented.
134 		sw = device_connection_find_match(dev, "usb-role-switch", NULL,  in usb_role_switch_get()
138 		WARN_ON(!try_module_get(sw->dev.parent->driver->owner));  in usb_role_switch_get()
145  * fwnode_usb_role_switch_get - Find USB role switch linked with the caller
149  * the switch using fwnode instead of device entry.
157 		sw = fwnode_connection_find_match(fwnode, "usb-role-switch",  in fwnode_usb_role_switch_get()
160 		WARN_ON(!try_module_get(sw->dev.parent->driver->owner));  in fwnode_usb_role_switch_get()
167  * usb_role_switch_put - Release handle to a switch
168  * @sw: USB Role Switch
175 		module_put(sw->dev.parent->driver->owner);  in usb_role_switch_put()
176 		put_device(&sw->dev);  in usb_role_switch_put()
182  * usb_role_switch_find_by_fwnode - Find USB role switch with its fwnode
183  * @fwnode: fwnode of the USB Role Switch
185  * Finds and returns role switch with @fwnode. The reference count for the
186  * found switch is incremented.
198 		WARN_ON(!try_module_get(dev->parent->driver->owner));  in usb_role_switch_find_by_fwnode()
210 	if (sw->allow_userspace_control)  in usb_role_switch_is_visible()
211 		return attr->mode;  in usb_role_switch_is_visible()
250 		/* Extra check if the user wants to disable the switch */  in role_store()
253 			return -EINVAL;  in role_store()
305  * usb_role_switch_register - Register USB Role Switch
306  * @parent: Parent device for the switch
307  * @desc: Description of the switch
309  * USB Role Switch is a device capable or choosing the role for USB connector.
310  * On platforms where the USB controller is dual-role capable, the controller
311  * driver will need to register the switch. On platforms where the USB host and
312  * USB device controllers behind the connector are separate, there will be a
313  * mux, and the driver for that mux will need to register the switch.
315  * Returns handle to a new role switch or ERR_PTR. The content of @desc is
325 	if (!desc || !desc->set)  in usb_role_switch_register()
326 		return ERR_PTR(-EINVAL);  in usb_role_switch_register()
330 		return ERR_PTR(-ENOMEM);  in usb_role_switch_register()
332 	mutex_init(&sw->lock);  in usb_role_switch_register()
334 	sw->allow_userspace_control = desc->allow_userspace_control;  in usb_role_switch_register()
335 	sw->usb2_port = desc->usb2_port;  in usb_role_switch_register()
336 	sw->usb3_port = desc->usb3_port;  in usb_role_switch_register()
337 	sw->udc = desc->udc;  in usb_role_switch_register()
338 	sw->set = desc->set;  in usb_role_switch_register()
339 	sw->get = desc->get;  in usb_role_switch_register()
341 	sw->dev.parent = parent;  in usb_role_switch_register()
342 	sw->dev.fwnode = desc->fwnode;  in usb_role_switch_register()
343 	sw->dev.class = &role_class;  in usb_role_switch_register()
344 	sw->dev.type = &usb_role_dev_type;  in usb_role_switch_register()
345 	dev_set_drvdata(&sw->dev, desc->driver_data);  in usb_role_switch_register()
346 	dev_set_name(&sw->dev, "%s-role-switch",  in usb_role_switch_register()
347 		     desc->name ? desc->name : dev_name(parent));  in usb_role_switch_register()
349 	ret = device_register(&sw->dev);  in usb_role_switch_register()
351 		put_device(&sw->dev);  in usb_role_switch_register()
362  * usb_role_switch_unregister - Unregsiter USB Role Switch
363  * @sw: USB Role Switch
365  * Unregister switch that was registered with usb_role_switch_register().
370 		device_unregister(&sw->dev);  in usb_role_switch_unregister()
375  * usb_role_switch_set_drvdata - Assign private data pointer to a switch
376  * @sw: USB Role Switch
381 	dev_set_drvdata(&sw->dev, data);  in usb_role_switch_set_drvdata()
386  * usb_role_switch_get_drvdata - Get the private data pointer of a switch
387  * @sw: USB Role Switch
391 	return dev_get_drvdata(&sw->dev);  in usb_role_switch_get_drvdata()
410 MODULE_DESCRIPTION("USB Role Class");