]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - drivers/of/device.c
io_uring: don't touch scm_fp_list after queueing skb
[mirror_ubuntu-jammy-kernel.git] / drivers / of / device.c
CommitLineData
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 */
28const 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}
35EXPORT_SYMBOL(of_match_device);
36
7096d042 37int 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 56static void
ce5cb67c
WD
57of_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
111int 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 214EXPORT_SYMBOL_GPL(of_dma_configure_id);
1f5c69aa 215
7096d042
GL
216int of_device_register(struct platform_device *pdev)
217{
218 device_initialize(&pdev->dev);
219 return of_device_add(pdev);
220}
f85ff305
SR
221EXPORT_SYMBOL(of_device_register);
222
94a0cb1f 223void of_device_unregister(struct platform_device *ofdev)
f85ff305 224{
f85ff305
SR
225 device_unregister(&ofdev->dev);
226}
227EXPORT_SYMBOL(of_device_unregister);
09e67ca2 228
3386e0fa
JE
229const 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}
239EXPORT_SYMBOL(of_device_get_match_data);
240
0634c295 241static 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
280int 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}
301EXPORT_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 */
309ssize_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}
321EXPORT_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 328void 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
365int 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 384EXPORT_SYMBOL_GPL(of_device_uevent_modalias);