1 /* SPDX-License-Identifier: GPL-2.0 */
5  * Copyright (C) 2012 - 2013 Samsung Electronics Co., Ltd.
19  * struct of_endpoint - the OF graph endpoint data structure
31  * for_each_endpoint_of_node - iterate over every endpoint in a device node
32  * @parent: parent device node containing ports and endpoints
33  * @child: loop variable pointing to the current endpoint node
35  * When breaking out of the loop, of_node_put(child) has to be called manually.
37 #define for_each_endpoint_of_node(parent, child) \  argument
38 	for (child = of_graph_get_next_endpoint(parent, NULL); child != NULL; \
39 	     child = of_graph_get_next_endpoint(parent, child))
42  * for_each_of_graph_port - iterate over every port in a device or ports node
43  * @parent: parent device or ports node containing port
44  * @child: loop variable pointing to the current port node
46  * When breaking out of the loop, and continue to use the @child, you need to
47  * use return_ptr(@child) or no_free_ptr(@child) not to call __free() for it.
49 #define for_each_of_graph_port(parent, child)			\  argument
50 	for (struct device_node *child __free(device_node) = of_graph_get_next_port(parent, NULL);\
51 	     child != NULL; child = of_graph_get_next_port(parent, child))
54  * for_each_of_graph_port_endpoint - iterate over every endpoint in a port node
55  * @parent: parent port node
56  * @child: loop variable pointing to the current endpoint node
58  * When breaking out of the loop, and continue to use the @child, you need to
59  * use return_ptr(@child) or no_free_ptr(@child) not to call __free() for it.
61 #define for_each_of_graph_port_endpoint(parent, child)			\  argument
62 …for (struct device_node *child __free(device_node) = of_graph_get_next_port_endpoint(parent, NULL)…
63 	     child != NULL; child = of_graph_get_next_port_endpoint(parent, child))
66 bool of_graph_is_present(const struct device_node *node);
67 int of_graph_parse_endpoint(const struct device_node *node,
71 struct device_node *of_graph_get_port_by_id(struct device_node *node, u32 id);
81 					const struct device_node *node);
82 struct device_node *of_graph_get_port_parent(struct device_node *node);
84 					const struct device_node *node);
85 struct device_node *of_graph_get_remote_port(const struct device_node *node);
86 struct device_node *of_graph_get_remote_node(const struct device_node *node,
90 static inline bool of_graph_is_present(const struct device_node *node)  in of_graph_is_present()  argument
95 static inline int of_graph_parse_endpoint(const struct device_node *node,  in of_graph_parse_endpoint()  argument
98 	return -ENOSYS;  in of_graph_parse_endpoint()
112 					struct device_node *node, u32 id)  in of_graph_get_port_by_id()  argument
145 					const struct device_node *node)  in of_graph_get_remote_endpoint()  argument
151 	struct device_node *node)  in of_graph_get_port_parent()  argument
157 					const struct device_node *node)  in of_graph_get_remote_port_parent()  argument
163 					const struct device_node *node)  in of_graph_get_remote_port()  argument
168 					const struct device_node *node,  in of_graph_get_remote_node()  argument