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