xref: /linux-6.15/include/linux/of_device.h (revision 83c4a4ee)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_OF_DEVICE_H
3 #define _LINUX_OF_DEVICE_H
4 
5 #include <linux/cpu.h>
6 #include <linux/platform_device.h>
7 #include <linux/of_platform.h> /* temporary until merge */
8 
9 #include <linux/of.h>
10 #include <linux/mod_devicetable.h>
11 
12 struct device;
13 
14 #ifdef CONFIG_OF
15 extern const struct of_device_id *of_match_device(
16 	const struct of_device_id *matches, const struct device *dev);
17 
18 /**
19  * of_driver_match_device - Tell if a driver's of_match_table matches a device.
20  * @drv: the device_driver structure to test
21  * @dev: the device structure to match against
22  */
23 static inline int of_driver_match_device(struct device *dev,
24 					 const struct device_driver *drv)
25 {
26 	return of_match_device(drv->of_match_table, dev) != NULL;
27 }
28 
29 extern int of_device_add(struct platform_device *pdev);
30 extern int of_device_register(struct platform_device *ofdev);
31 extern void of_device_unregister(struct platform_device *ofdev);
32 
33 extern const void *of_device_get_match_data(const struct device *dev);
34 
35 extern ssize_t of_device_modalias(struct device *dev, char *str, ssize_t len);
36 extern int of_device_request_module(struct device *dev);
37 
38 extern void of_device_uevent(struct device *dev, struct kobj_uevent_env *env);
39 extern int of_device_uevent_modalias(struct device *dev, struct kobj_uevent_env *env);
40 
41 static inline void of_device_node_put(struct device *dev)
42 {
43 	of_node_put(dev->of_node);
44 }
45 
46 static inline struct device_node *of_cpu_device_node_get(int cpu)
47 {
48 	struct device *cpu_dev;
49 	cpu_dev = get_cpu_device(cpu);
50 	if (!cpu_dev)
51 		return of_get_cpu_node(cpu, NULL);
52 	return of_node_get(cpu_dev->of_node);
53 }
54 
55 int of_dma_configure_id(struct device *dev,
56 		     struct device_node *np,
57 		     bool force_dma, const u32 *id);
58 static inline int of_dma_configure(struct device *dev,
59 				   struct device_node *np,
60 				   bool force_dma)
61 {
62 	return of_dma_configure_id(dev, np, force_dma, NULL);
63 }
64 #else /* CONFIG_OF */
65 
66 static inline int of_driver_match_device(struct device *dev,
67 					 const struct device_driver *drv)
68 {
69 	return 0;
70 }
71 
72 static inline void of_device_uevent(struct device *dev,
73 			struct kobj_uevent_env *env) { }
74 
75 static inline const void *of_device_get_match_data(const struct device *dev)
76 {
77 	return NULL;
78 }
79 
80 static inline int of_device_modalias(struct device *dev,
81 				     char *str, ssize_t len)
82 {
83 	return -ENODEV;
84 }
85 
86 static inline int of_device_request_module(struct device *dev)
87 {
88 	return -ENODEV;
89 }
90 
91 static inline int of_device_uevent_modalias(struct device *dev,
92 				   struct kobj_uevent_env *env)
93 {
94 	return -ENODEV;
95 }
96 
97 static inline void of_device_node_put(struct device *dev) { }
98 
99 static inline const struct of_device_id *of_match_device(
100 		const struct of_device_id *matches, const struct device *dev)
101 {
102 	return NULL;
103 }
104 
105 static inline struct device_node *of_cpu_device_node_get(int cpu)
106 {
107 	return NULL;
108 }
109 
110 static inline int of_dma_configure_id(struct device *dev,
111 				   struct device_node *np,
112 				   bool force_dma)
113 {
114 	return 0;
115 }
116 static inline int of_dma_configure(struct device *dev,
117 				   struct device_node *np,
118 				   bool force_dma)
119 {
120 	return 0;
121 }
122 #endif /* CONFIG_OF */
123 
124 #endif /* _LINUX_OF_DEVICE_H */
125