Commit | Line | Data |
---|---|---|
af6074fc | 1 | // SPDX-License-Identifier: GPL-2.0 |
f85ff305 SR |
2 | #include <linux/string.h> |
3 | #include <linux/kernel.h> | |
4 | #include <linux/of.h> | |
f898f8db | 5 | #include <linux/of_device.h> |
1f5c69aa MK |
6 | #include <linux/of_address.h> |
7 | #include <linux/of_iommu.h> | |
8 | #include <linux/dma-mapping.h> | |
f85ff305 SR |
9 | #include <linux/init.h> |
10 | #include <linux/module.h> | |
11 | #include <linux/mod_devicetable.h> | |
12 | #include <linux/slab.h> | |
72328883 | 13 | #include <linux/platform_device.h> |
f85ff305 SR |
14 | |
15 | #include <asm/errno.h> | |
ced4eec9 | 16 | #include "of_private.h" |
f85ff305 | 17 | |
f85ff305 | 18 | /** |
44504b2b | 19 | * of_match_device - Tell if a struct device matches an of_device_id list |
f85ff305 SR |
20 | * @ids: array of of device match structures to search in |
21 | * @dev: the of device structure to match against | |
22 | * | |
2dc11581 | 23 | * Used by a driver to check whether an platform_device present in the |
f85ff305 SR |
24 | * system is in its list of supported devices. |
25 | */ | |
26 | const struct of_device_id *of_match_device(const struct of_device_id *matches, | |
44504b2b | 27 | const struct device *dev) |
f85ff305 | 28 | { |
8cec0e7b | 29 | if ((!matches) || (!dev->of_node)) |
f85ff305 | 30 | return NULL; |
44504b2b | 31 | return of_match_node(matches, dev->of_node); |
f85ff305 SR |
32 | } |
33 | EXPORT_SYMBOL(of_match_device); | |
34 | ||
94a0cb1f | 35 | struct platform_device *of_dev_get(struct platform_device *dev) |
f85ff305 SR |
36 | { |
37 | struct device *tmp; | |
38 | ||
39 | if (!dev) | |
40 | return NULL; | |
41 | tmp = get_device(&dev->dev); | |
42 | if (tmp) | |
94a0cb1f | 43 | return to_platform_device(tmp); |
f85ff305 SR |
44 | else |
45 | return NULL; | |
46 | } | |
47 | EXPORT_SYMBOL(of_dev_get); | |
48 | ||
94a0cb1f | 49 | void of_dev_put(struct platform_device *dev) |
f85ff305 SR |
50 | { |
51 | if (dev) | |
52 | put_device(&dev->dev); | |
53 | } | |
54 | EXPORT_SYMBOL(of_dev_put); | |
55 | ||
7096d042 | 56 | int of_device_add(struct platform_device *ofdev) |
f85ff305 | 57 | { |
61c7a080 | 58 | BUG_ON(ofdev->dev.of_node == NULL); |
6098e2ee | 59 | |
eca39301 GL |
60 | /* name and id have to be set so that the platform bus doesn't get |
61 | * confused on matching */ | |
62 | ofdev->name = dev_name(&ofdev->dev); | |
6d7e3bf8 | 63 | ofdev->id = PLATFORM_DEVID_NONE; |
eca39301 | 64 | |
56f2de81 ZL |
65 | /* |
66 | * If this device has not binding numa node in devicetree, that is | |
67 | * of_node_to_nid returns NUMA_NO_NODE. device_add will assume that this | |
68 | * device is on the same node as the parent. | |
69 | */ | |
70 | set_dev_node(&ofdev->dev, of_node_to_nid(ofdev->dev.of_node)); | |
6098e2ee JK |
71 | |
72 | return device_add(&ofdev->dev); | |
f85ff305 | 73 | } |
7096d042 | 74 | |
1f5c69aa MK |
75 | /** |
76 | * of_dma_configure - Setup DMA configuration | |
77 | * @dev: Device to apply DMA configuration | |
78 | * @np: Pointer to OF node having DMA configuration | |
3d6ce86e CH |
79 | * @force_dma: Whether device is to be set up by of_dma_configure() even if |
80 | * DMA capability is not explicitly described by firmware. | |
1f5c69aa MK |
81 | * |
82 | * Try to get devices's DMA configuration from DT and update it | |
83 | * accordingly. | |
84 | * | |
85 | * If platform code needs to use its own special DMA configuration, it | |
86 | * can use a platform bus notifier and handle BUS_NOTIFY_ADD_DEVICE events | |
87 | * to fix up DMA configuration. | |
88 | */ | |
3d6ce86e | 89 | int of_dma_configure(struct device *dev, struct device_node *np, bool force_dma) |
1f5c69aa | 90 | { |
72328883 | 91 | u64 dma_addr, paddr, size = 0; |
1f5c69aa MK |
92 | int ret; |
93 | bool coherent; | |
94 | unsigned long offset; | |
53c92d79 | 95 | const struct iommu_ops *iommu; |
ee7b1f31 | 96 | u64 mask; |
1f5c69aa | 97 | |
1f5c69aa MK |
98 | ret = of_dma_get_range(np, &dma_addr, &paddr, &size); |
99 | if (ret < 0) { | |
72328883 RM |
100 | /* |
101 | * For legacy reasons, we have to assume some devices need | |
102 | * DMA configuration regardless of whether "dma-ranges" is | |
103 | * correctly specified or not. | |
104 | */ | |
3d6ce86e | 105 | if (!force_dma) |
72328883 RM |
106 | return ret == -ENODEV ? 0 : ret; |
107 | ||
1f5c69aa | 108 | dma_addr = offset = 0; |
1f5c69aa MK |
109 | } else { |
110 | offset = PFN_DOWN(paddr - dma_addr); | |
0c79c81c MK |
111 | |
112 | /* | |
113 | * Add a work around to treat the size as mask + 1 in case | |
114 | * it is defined in DT as a mask. | |
115 | */ | |
116 | if (size & 1) { | |
117 | dev_warn(dev, "Invalid size 0x%llx for dma-range\n", | |
118 | size); | |
119 | size = size + 1; | |
120 | } | |
121 | ||
122 | if (!size) { | |
123 | dev_err(dev, "Adjusted size 0x%llx invalid\n", size); | |
7b07cbef | 124 | return -EINVAL; |
0c79c81c | 125 | } |
1f5c69aa MK |
126 | dev_dbg(dev, "dma_pfn_offset(%#08lx)\n", offset); |
127 | } | |
128 | ||
72328883 | 129 | /* |
4d8bde88 RM |
130 | * If @dev is expected to be DMA-capable then the bus code that created |
131 | * it should have initialised its dma_mask pointer by this point. For | |
132 | * now, we'll continue the legacy behaviour of coercing it to the | |
133 | * coherent mask if not, but we'll no longer do so quietly. | |
72328883 | 134 | */ |
4d8bde88 RM |
135 | if (!dev->dma_mask) { |
136 | dev_warn(dev, "DMA mask not set\n"); | |
72328883 | 137 | dev->dma_mask = &dev->coherent_dma_mask; |
4d8bde88 | 138 | } |
72328883 | 139 | |
4d8bde88 | 140 | if (!size && dev->coherent_dma_mask) |
72328883 | 141 | size = max(dev->coherent_dma_mask, dev->coherent_dma_mask + 1); |
4d8bde88 RM |
142 | else if (!size) |
143 | size = 1ULL << 32; | |
72328883 | 144 | |
1f5c69aa MK |
145 | dev->dma_pfn_offset = offset; |
146 | ||
9a6d7298 MK |
147 | /* |
148 | * Limit coherent and dma mask based on size and default mask | |
149 | * set by the driver. | |
150 | */ | |
ee7b1f31 | 151 | mask = DMA_BIT_MASK(ilog2(dma_addr + size - 1) + 1); |
6c2fb2ea | 152 | dev->bus_dma_mask = mask; |
ee7b1f31 RM |
153 | dev->coherent_dma_mask &= mask; |
154 | *dev->dma_mask &= mask; | |
9a6d7298 | 155 | |
1f5c69aa MK |
156 | coherent = of_dma_is_coherent(np); |
157 | dev_dbg(dev, "device is%sdma coherent\n", | |
158 | coherent ? " " : " not "); | |
159 | ||
160 | iommu = of_iommu_configure(dev, np); | |
a37b19a3 S |
161 | if (IS_ERR(iommu) && PTR_ERR(iommu) == -EPROBE_DEFER) |
162 | return -EPROBE_DEFER; | |
7b07cbef | 163 | |
1f5c69aa MK |
164 | dev_dbg(dev, "device is%sbehind an iommu\n", |
165 | iommu ? " " : " not "); | |
166 | ||
167 | arch_setup_dma_ops(dev, dma_addr, size, iommu, coherent); | |
7b07cbef LP |
168 | |
169 | return 0; | |
1f5c69aa MK |
170 | } |
171 | EXPORT_SYMBOL_GPL(of_dma_configure); | |
172 | ||
7096d042 GL |
173 | int of_device_register(struct platform_device *pdev) |
174 | { | |
175 | device_initialize(&pdev->dev); | |
176 | return of_device_add(pdev); | |
177 | } | |
f85ff305 SR |
178 | EXPORT_SYMBOL(of_device_register); |
179 | ||
94a0cb1f | 180 | void of_device_unregister(struct platform_device *ofdev) |
f85ff305 | 181 | { |
f85ff305 SR |
182 | device_unregister(&ofdev->dev); |
183 | } | |
184 | EXPORT_SYMBOL(of_device_unregister); | |
09e67ca2 | 185 | |
3386e0fa JE |
186 | const void *of_device_get_match_data(const struct device *dev) |
187 | { | |
188 | const struct of_device_id *match; | |
189 | ||
190 | match = of_match_device(dev->driver->of_match_table, dev); | |
191 | if (!match) | |
192 | return NULL; | |
193 | ||
194 | return match->data; | |
195 | } | |
196 | EXPORT_SYMBOL(of_device_get_match_data); | |
197 | ||
0634c295 | 198 | static ssize_t of_device_get_modalias(struct device *dev, char *str, ssize_t len) |
09e67ca2 SR |
199 | { |
200 | const char *compat; | |
bc575064 RH |
201 | char *c; |
202 | struct property *p; | |
203 | ssize_t csize; | |
8c2a75e5 | 204 | ssize_t tsize; |
09e67ca2 | 205 | |
b9f73067 ZR |
206 | if ((!dev) || (!dev->of_node)) |
207 | return -ENODEV; | |
208 | ||
09e67ca2 | 209 | /* Name & Type */ |
a613b26a RH |
210 | /* %p eats all alphanum characters, so %c must be used here */ |
211 | csize = snprintf(str, len, "of:N%pOFn%c%s", dev->of_node, 'T', | |
34a1c1e8 | 212 | dev->of_node->type); |
8c2a75e5 | 213 | tsize = csize; |
bc575064 | 214 | len -= csize; |
8c2a75e5 BA |
215 | if (str) |
216 | str += csize; | |
bc575064 RH |
217 | |
218 | of_property_for_each_string(dev->of_node, "compatible", p, compat) { | |
8c2a75e5 BA |
219 | csize = strlen(compat) + 1; |
220 | tsize += csize; | |
221 | if (csize > len) | |
222 | continue; | |
bc575064 RH |
223 | |
224 | csize = snprintf(str, len, "C%s", compat); | |
225 | for (c = str; c; ) { | |
226 | c = strchr(c, ' '); | |
227 | if (c) | |
228 | *c++ = '_'; | |
229 | } | |
230 | len -= csize; | |
231 | str += csize; | |
09e67ca2 SR |
232 | } |
233 | ||
8c2a75e5 | 234 | return tsize; |
09e67ca2 | 235 | } |
dd27dcda | 236 | |
9c829c09 SB |
237 | int of_device_request_module(struct device *dev) |
238 | { | |
239 | char *str; | |
240 | ssize_t size; | |
241 | int ret; | |
242 | ||
243 | size = of_device_get_modalias(dev, NULL, 0); | |
244 | if (size < 0) | |
245 | return size; | |
246 | ||
247 | str = kmalloc(size + 1, GFP_KERNEL); | |
248 | if (!str) | |
249 | return -ENOMEM; | |
250 | ||
251 | of_device_get_modalias(dev, str, size); | |
252 | str[size] = '\0'; | |
253 | ret = request_module(str); | |
254 | kfree(str); | |
255 | ||
256 | return ret; | |
257 | } | |
258 | EXPORT_SYMBOL_GPL(of_device_request_module); | |
259 | ||
0634c295 RH |
260 | /** |
261 | * of_device_modalias - Fill buffer with newline terminated modalias string | |
262 | */ | |
263 | ssize_t of_device_modalias(struct device *dev, char *str, ssize_t len) | |
264 | { | |
265 | ssize_t sl = of_device_get_modalias(dev, str, len - 2); | |
266 | if (sl < 0) | |
267 | return sl; | |
08ab58d9 BA |
268 | if (sl > len - 2) |
269 | return -ENOMEM; | |
0634c295 RH |
270 | |
271 | str[sl++] = '\n'; | |
272 | str[sl] = 0; | |
273 | return sl; | |
274 | } | |
275 | EXPORT_SYMBOL_GPL(of_device_modalias); | |
276 | ||
dd27dcda GL |
277 | /** |
278 | * of_device_uevent - Display OF related uevent information | |
279 | */ | |
07d57a32 | 280 | void of_device_uevent(struct device *dev, struct kobj_uevent_env *env) |
dd27dcda GL |
281 | { |
282 | const char *compat; | |
ced4eec9 | 283 | struct alias_prop *app; |
bc575064 RH |
284 | struct property *p; |
285 | int seen = 0; | |
dd27dcda GL |
286 | |
287 | if ((!dev) || (!dev->of_node)) | |
07d57a32 | 288 | return; |
dd27dcda | 289 | |
a613b26a | 290 | add_uevent_var(env, "OF_NAME=%pOFn", dev->of_node); |
0d638a07 | 291 | add_uevent_var(env, "OF_FULLNAME=%pOF", dev->of_node); |
07d57a32 GL |
292 | if (dev->of_node->type && strcmp("<NULL>", dev->of_node->type) != 0) |
293 | add_uevent_var(env, "OF_TYPE=%s", dev->of_node->type); | |
dd27dcda GL |
294 | |
295 | /* Since the compatible field can contain pretty much anything | |
296 | * it's not really legal to split it out with commas. We split it | |
297 | * up using a number of environment variables instead. */ | |
bc575064 | 298 | of_property_for_each_string(dev->of_node, "compatible", p, compat) { |
07d57a32 | 299 | add_uevent_var(env, "OF_COMPATIBLE_%d=%s", seen, compat); |
dd27dcda GL |
300 | seen++; |
301 | } | |
07d57a32 | 302 | add_uevent_var(env, "OF_COMPATIBLE_N=%d", seen); |
ced4eec9 SM |
303 | |
304 | seen = 0; | |
c05aba2b | 305 | mutex_lock(&of_mutex); |
ced4eec9 SM |
306 | list_for_each_entry(app, &aliases_lookup, link) { |
307 | if (dev->of_node == app->np) { | |
308 | add_uevent_var(env, "OF_ALIAS_%d=%s", seen, | |
309 | app->alias); | |
310 | seen++; | |
311 | } | |
312 | } | |
c05aba2b | 313 | mutex_unlock(&of_mutex); |
07d57a32 | 314 | } |
dd27dcda | 315 | |
07d57a32 GL |
316 | int of_device_uevent_modalias(struct device *dev, struct kobj_uevent_env *env) |
317 | { | |
318 | int sl; | |
319 | ||
320 | if ((!dev) || (!dev->of_node)) | |
321 | return -ENODEV; | |
dd27dcda | 322 | |
07d57a32 | 323 | /* Devicetree modalias is tricky, we add it in 2 steps */ |
dd27dcda GL |
324 | if (add_uevent_var(env, "MODALIAS=")) |
325 | return -ENOMEM; | |
326 | ||
34a1c1e8 | 327 | sl = of_device_get_modalias(dev, &env->buf[env->buflen-1], |
dd27dcda GL |
328 | sizeof(env->buf) - env->buflen); |
329 | if (sl >= (sizeof(env->buf) - env->buflen)) | |
330 | return -ENOMEM; | |
331 | env->buflen += sl; | |
332 | ||
333 | return 0; | |
334 | } | |
7a3b7cd3 | 335 | EXPORT_SYMBOL_GPL(of_device_uevent_modalias); |