forked from ~ljy/RK356X_SDK_RELEASE
blame | history | patch | commit | commitdiff
hc
2024-05-10 093a6c67005148ae32a5c9e4553491b9f5c2457b 
 kernel/include/linux/fwnode.h
....@@ -1,32 +1,52 @@
1
+/* SPDX-License-Identifier: GPL-2.0-only */
12 /*
23  * fwnode.h - Firmware device node object handle type definition.
34  *
45  * Copyright (C) 2015, Intel Corporation
56  * Author: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
6
- *
7
- * This program is free software; you can redistribute it and/or modify
8
- * it under the terms of the GNU General Public License version 2 as
9
- * published by the Free Software Foundation.
107  */
118 
129 #ifndef _LINUX_FWNODE_H_
1310 #define _LINUX_FWNODE_H_
1411 
1512 #include <linux/types.h>
13
+#include <linux/list.h>
14
+#include <linux/bits.h>
15
+#include <linux/err.h>
1616 #include <linux/android_kabi.h>
1717 
1818 struct fwnode_operations;
1919 struct device;
2020 
21
+/*
22
+ * fwnode link flags
23
+ *
24
+ * LINKS_ADDED:	The fwnode has already be parsed to add fwnode links.
25
+ * NOT_DEVICE:	The fwnode will never be populated as a struct device.
26
+ * INITIALIZED: The hardware corresponding to fwnode has been initialized.
27
+ */
28
+#define FWNODE_FLAG_LINKS_ADDED		BIT(0)
29
+#define FWNODE_FLAG_NOT_DEVICE		BIT(1)
30
+#define FWNODE_FLAG_INITIALIZED		BIT(2)
31
+
2132 struct fwnode_handle {
2233 	struct fwnode_handle *secondary;
2334 	const struct fwnode_operations *ops;
2435 	struct device *dev;
36
+	struct list_head suppliers;
37
+	struct list_head consumers;
38
+	u8 flags;
39
+	ANDROID_KABI_RESERVE(1);
40
+};
2541 
42
+struct fwnode_link {
43
+	struct fwnode_handle *supplier;
44
+	struct list_head s_hook;
45
+	struct fwnode_handle *consumer;
46
+	struct list_head c_hook;
2647 	ANDROID_KABI_RESERVE(1);
2748 	ANDROID_KABI_RESERVE(2);
2849 	ANDROID_KABI_RESERVE(3);
29
-	ANDROID_KABI_RESERVE(4);
3050 };
3151 
3252 /**
....@@ -59,13 +79,15 @@
5979  * struct fwnode_operations - Operations for fwnode interface
6080  * @get: Get a reference to an fwnode.
6181  * @put: Put a reference to an fwnode.
82
+ * @device_is_available: Return true if the device is available.
6283  * @device_get_match_data: Return the device driver match data.
6384  * @property_present: Return true if a property is present.
64
- * @property_read_integer_array: Read an array of integer properties. Return
65
- *				 zero on success, a negative error code
66
- *				 otherwise.
85
+ * @property_read_int_array: Read an array of integer properties. Return zero on
86
+ *			     success, a negative error code otherwise.
6787  * @property_read_string_array: Read an array of string properties. Return zero
6888  *				on success, a negative error code otherwise.
89
+ * @get_name: Return the name of an fwnode.
90
+ * @get_name_prefix: Get a prefix for a node (for printing purposes).
6991  * @get_parent: Return the parent of an fwnode.
7092  * @get_next_child_node: Return the next child node in an iteration.
7193  * @get_named_child_node: Return a child node with a given name.
....@@ -75,44 +97,8 @@
7597  *			       endpoint node.
7698  * @graph_get_port_parent: Return the parent node of a port node.
7799  * @graph_parse_endpoint: Parse endpoint for port and endpoint id.
78
- * @add_links:	Called after the device corresponding to the fwnode is added
79
- *		using device_add(). The function is expected to create device
80
- *		links to all the suppliers of the device that are available at
81
- *		the time this function is called.  The function must NOT stop
82
- *		at the first failed device link if other unlinked supplier
83
- *		devices are present in the system.  This is necessary for the
84
- *		driver/bus sync_state() callbacks to work correctly.
85
- *
86
- *		For example, say Device-C depends on suppliers Device-S1 and
87
- *		Device-S2 and the dependency is listed in that order in the
88
- *		firmware.  Say, S1 gets populated from the firmware after
89
- *		late_initcall_sync().  Say S2 is populated and probed way
90
- *		before that in device_initcall(). When C is populated, if this
91
- *		add_links() function doesn't continue past a "failed linking to
92
- *		S1" and continue linking C to S2, then S2 will get a
93
- *		sync_state() callback before C is probed. This is because from
94
- *		the perspective of S2, C was never a consumer when its
95
- *		sync_state() evaluation is done. To avoid this, the add_links()
96
- *		function has to go through all available suppliers of the
97
- *		device (that corresponds to this fwnode) and link to them
98
- *		before returning.
99
- *
100
- *		If some suppliers are not yet available (indicated by an error
101
- *		return value), this function will be called again when other
102
- *		devices are added to allow creating device links to any newly
103
- *		available suppliers.
104
- *
105
- *		Return 0 if device links have been successfully created to all
106
- *		the known suppliers of this device or if the supplier
107
- *		information is not known.
108
- *
109
- *		Return -ENODEV if the suppliers needed for probing this device
110
- *		have not been registered yet (because device links can only be
111
- *		created to devices registered with the driver core).
112
- *
113
- *		Return -EAGAIN if some of the suppliers of this device have not
114
- *		been registered yet, but none of those suppliers are necessary
115
- *		for probing the device.
100
+ * @add_links:	Create fwnode links to all the suppliers of the fwnode. Return
101
+ *		zero on success, a negative error code otherwise.
116102  */
117103 struct fwnode_operations {
118104 	struct fwnode_handle *(*get)(struct fwnode_handle *fwnode);
....@@ -130,6 +116,8 @@
130116 	(*property_read_string_array)(const struct fwnode_handle *fwnode_handle,
131117 				      const char *propname, const char **val,
132118 				      size_t nval);
119
+	const char *(*get_name)(const struct fwnode_handle *fwnode);
120
+	const char *(*get_name_prefix)(const struct fwnode_handle *fwnode);
133121 	struct fwnode_handle *(*get_parent)(const struct fwnode_handle *fwnode);
134122 	struct fwnode_handle *
135123 	(*get_next_child_node)(const struct fwnode_handle *fwnode,
....@@ -150,8 +138,7 @@
150138 	(*graph_get_port_parent)(struct fwnode_handle *fwnode);
151139 	int (*graph_parse_endpoint)(const struct fwnode_handle *fwnode,
152140 				    struct fwnode_endpoint *endpoint);
153
-	int (*add_links)(const struct fwnode_handle *fwnode,
154
-			 struct device *dev);
141
+	int (*add_links)(struct fwnode_handle *fwnode);
155142 };
156143 
157144 #define fwnode_has_op(fwnode, op)				\
....@@ -160,10 +147,11 @@
160147 	(fwnode ? (fwnode_has_op(fwnode, op) ?				\
161148 		   (fwnode)->ops->op(fwnode, ## __VA_ARGS__) : -ENXIO) : \
162149 	 -EINVAL)
163
-#define fwnode_call_bool_op(fwnode, op, ...)				\
164
-	(fwnode ? (fwnode_has_op(fwnode, op) ?				\
165
-		   (fwnode)->ops->op(fwnode, ## __VA_ARGS__) : false) : \
166
-	 false)
150
+
151
+#define fwnode_call_bool_op(fwnode, op, ...)		\
152
+	(fwnode_has_op(fwnode, op) ?			\
153
+	 (fwnode)->ops->op(fwnode, ## __VA_ARGS__) : false)
154
+
167155 #define fwnode_call_ptr_op(fwnode, op, ...)		\
168156 	(fwnode_has_op(fwnode, op) ?			\
169157 	 (fwnode)->ops->op(fwnode, ## __VA_ARGS__) : NULL)
....@@ -174,6 +162,29 @@
174162 	} while (false)
175163 #define get_dev_from_fwnode(fwnode)	get_device((fwnode)->dev)
176164 
177
-void fw_devlink_pause(void);
178
-void fw_devlink_resume(void);
165
+static inline void fwnode_init(struct fwnode_handle *fwnode,
166
+			       const struct fwnode_operations *ops)
167
+{
168
+	fwnode->ops = ops;
169
+	INIT_LIST_HEAD(&fwnode->consumers);
170
+	INIT_LIST_HEAD(&fwnode->suppliers);
171
+}
172
+
173
+static inline void fwnode_dev_initialized(struct fwnode_handle *fwnode,
174
+					  bool initialized)
175
+{
176
+	if (IS_ERR_OR_NULL(fwnode))
177
+		return;
178
+
179
+	if (initialized)
180
+		fwnode->flags |= FWNODE_FLAG_INITIALIZED;
181
+	else
182
+		fwnode->flags &= ~FWNODE_FLAG_INITIALIZED;
183
+}
184
+
185
+extern u32 fw_devlink_get_flags(void);
186
+extern bool fw_devlink_is_strict(void);
187
+int fwnode_link_add(struct fwnode_handle *con, struct fwnode_handle *sup);
188
+void fwnode_links_purge(struct fwnode_handle *fwnode);
189
+
179190 #endif