1 // SPDX-License-Identifier: GPL-2.0
15  * usb_of_get_device_node() - get a USB device node
17  * @port1: one-based index of port
19  * Look up the node of a USB device given its parent hub device and one-based
22  * Return: A pointer to the node with incremented refcount if found, or
27 	struct device_node *node;  in usb_of_get_device_node()  local
30 	for_each_child_of_node(hub->dev.of_node, node) {  in usb_of_get_device_node()
31 		if (of_property_read_u32(node, "reg", &reg))  in usb_of_get_device_node()
35 			return node;  in usb_of_get_device_node()
43  * usb_of_has_combined_node() - determine whether a device has a combined node
46  * Determine whether a USB device has a so called combined node which is
47  * shared with its sole interface. This is the case if and only if the device
48  * has a node and its descriptors report the following:
54  * Return: True iff the device has a device node and its descriptors match the
55  * criteria for a combined node.
59 	struct usb_device_descriptor *ddesc = &udev->descriptor;  in usb_of_has_combined_node()
62 	if (!udev->dev.of_node)  in usb_of_has_combined_node()
65 	switch (ddesc->bDeviceClass) {  in usb_of_has_combined_node()
68 		if (ddesc->bNumConfigurations == 1) {  in usb_of_has_combined_node()
69 			cdesc = &udev->config->desc;  in usb_of_has_combined_node()
70 			if (cdesc->bNumInterfaces == 1)  in usb_of_has_combined_node()
81 	const struct device_node *np = hub->dev.of_node;  in usb_of_has_devices_or_graph()
98  * usb_of_get_connect_type() - get a USB hub's port connect_type
100  * @port1: one-based index of port
102  * Get the connect_type of @port1 based on the device node for @hub. If the
105  * connect_type is "hard-wired". If there isn't an OF graph or child node at
109  * Return: A connect_type for @port1 based on the device node for @hub.
120 	/* Assume port is unused if there's a graph or a child node. */  in usb_of_get_connect_type()
123 	np = hub->dev.of_node;  in usb_of_get_connect_type()
125 	 * Hotplug ports are connected to an available remote node, e.g.  in usb_of_get_connect_type()
126 	 * usb-a-connector compatible node, in the OF graph.  in usb_of_get_connect_type()
129 		ep = of_graph_get_endpoint_by_regs(np, port1, -1);  in usb_of_get_connect_type()
140 	 * Hard-wired ports are child nodes with a reg property corresponding  in usb_of_get_connect_type()
153  * usb_of_get_interface_node() - get a USB interface node
154  * @udev: USB device of interface
156  * @ifnum: interface number
158  * Look up the node of a USB interface given its USB device, configuration
159  * value and interface number.
161  * Return: A pointer to the node with incremented refcount if found, or
167 	struct device_node *node;  in usb_of_get_interface_node()  local
170 	for_each_child_of_node(udev->dev.of_node, node) {  in usb_of_get_interface_node()
171 		if (of_property_read_u32_array(node, "reg", reg, 2))  in usb_of_get_interface_node()
175 			return node;  in usb_of_get_interface_node()