Branch data Line data Source code
1 : : /*
2 : : * Derived from arch/i386/kernel/irq.c
3 : : * Copyright (C) 1992 Linus Torvalds
4 : : * Adapted from arch/i386 by Gary Thomas
5 : : * Copyright (C) 1995-1996 Gary Thomas (gdt@linuxppc.org)
6 : : * Updated and modified by Cort Dougan <cort@fsmlabs.com>
7 : : * Copyright (C) 1996-2001 Cort Dougan
8 : : * Adapted for Power Macintosh by Paul Mackerras
9 : : * Copyright (C) 1996 Paul Mackerras (paulus@cs.anu.edu.au)
10 : : *
11 : : * This program is free software; you can redistribute it and/or
12 : : * modify it under the terms of the GNU General Public License
13 : : * as published by the Free Software Foundation; either version
14 : : * 2 of the License, or (at your option) any later version.
15 : : *
16 : : * This file contains the code used to make IRQ descriptions in the
17 : : * device tree to actual irq numbers on an interrupt controller
18 : : * driver.
19 : : */
20 : :
21 : : #include <linux/errno.h>
22 : : #include <linux/list.h>
23 : : #include <linux/module.h>
24 : : #include <linux/of.h>
25 : : #include <linux/of_irq.h>
26 : : #include <linux/string.h>
27 : : #include <linux/slab.h>
28 : :
29 : : /**
30 : : * irq_of_parse_and_map - Parse and map an interrupt into linux virq space
31 : : * @dev: Device node of the device whose interrupt is to be mapped
32 : : * @index: Index of the interrupt to map
33 : : *
34 : : * This function is a wrapper that chains of_irq_parse_one() and
35 : : * irq_create_of_mapping() to make things easier to callers
36 : : */
37 : 0 : unsigned int irq_of_parse_and_map(struct device_node *dev, int index)
38 : : {
39 : : struct of_phandle_args oirq;
40 : :
41 [ # # ]: 0 : if (of_irq_parse_one(dev, index, &oirq))
42 : : return 0;
43 : :
44 : 0 : return irq_create_of_mapping(&oirq);
45 : : }
46 : : EXPORT_SYMBOL_GPL(irq_of_parse_and_map);
47 : :
48 : : /**
49 : : * of_irq_find_parent - Given a device node, find its interrupt parent node
50 : : * @child: pointer to device node
51 : : *
52 : : * Returns a pointer to the interrupt parent node, or NULL if the interrupt
53 : : * parent could not be determined.
54 : : */
55 : 0 : struct device_node *of_irq_find_parent(struct device_node *child)
56 : : {
57 : : struct device_node *p;
58 : 0 : const __be32 *parp;
59 : :
60 [ # # ]: 0 : if (!of_node_get(child))
61 : : return NULL;
62 : :
63 : : do {
64 : 0 : parp = of_get_property(child, "interrupt-parent", NULL);
65 [ # # ]: 0 : if (parp == NULL)
66 : 0 : p = of_get_parent(child);
67 : : else {
68 : : if (of_irq_workarounds & OF_IMAP_NO_PHANDLE)
69 : : p = of_node_get(of_irq_dflt_pic);
70 : : else
71 : 0 : p = of_find_node_by_phandle(be32_to_cpup(parp));
72 : : }
73 : : of_node_put(child);
74 : : child = p;
75 [ # # ][ # # ]: 0 : } while (p && of_get_property(p, "#interrupt-cells", NULL) == NULL);
76 : :
77 : 0 : return p;
78 : : }
79 : :
80 : : /**
81 : : * of_irq_parse_raw - Low level interrupt tree parsing
82 : : * @parent: the device interrupt parent
83 : : * @addr: address specifier (start of "reg" property of the device) in be32 format
84 : : * @out_irq: structure of_irq updated by this function
85 : : *
86 : : * Returns 0 on success and a negative number on error
87 : : *
88 : : * This function is a low-level interrupt tree walking function. It
89 : : * can be used to do a partial walk with synthetized reg and interrupts
90 : : * properties, for example when resolving PCI interrupts when no device
91 : : * node exist for the parent. It takes an interrupt specifier structure as
92 : : * input, walks the tree looking for any interrupt-map properties, translates
93 : : * the specifier for each map, and then returns the translated map.
94 : : */
95 : 0 : int of_irq_parse_raw(const __be32 *addr, struct of_phandle_args *out_irq)
96 : : {
97 : : struct device_node *ipar, *tnode, *old = NULL, *newpar = NULL;
98 : : __be32 initial_match_array[MAX_PHANDLE_ARGS];
99 : : const __be32 *match_array = initial_match_array;
100 : 0 : const __be32 *tmp, *imap, *imask, dummy_imask[] = { [0 ... MAX_PHANDLE_ARGS] = ~0 };
101 : : u32 intsize = 1, addrsize, newintsize = 0, newaddrsize = 0;
102 : : int imaplen, match, i;
103 : :
104 : : #ifdef DEBUG
105 : : of_print_phandle_args("of_irq_parse_raw: ", out_irq);
106 : : #endif
107 : :
108 : 0 : ipar = of_node_get(out_irq->np);
109 : :
110 : : /* First get the #interrupt-cells property of the current cursor
111 : : * that tells us how to interpret the passed-in intspec. If there
112 : : * is none, we are nice and just walk up the tree
113 : : */
114 : : do {
115 : 0 : tmp = of_get_property(ipar, "#interrupt-cells", NULL);
116 [ # # ]: 0 : if (tmp != NULL) {
117 [ # # ]: 0 : intsize = be32_to_cpu(*tmp);
118 : 0 : break;
119 : : }
120 : : tnode = ipar;
121 : 0 : ipar = of_irq_find_parent(ipar);
122 : : of_node_put(tnode);
123 [ # # ]: 0 : } while (ipar);
124 [ # # ]: 0 : if (ipar == NULL) {
125 : : pr_debug(" -> no parent found !\n");
126 : : goto fail;
127 : : }
128 : :
129 : : pr_debug("of_irq_parse_raw: ipar=%s, size=%d\n", of_node_full_name(ipar), intsize);
130 : :
131 [ # # ]: 0 : if (out_irq->args_count != intsize)
132 : : return -EINVAL;
133 : :
134 : : /* Look for this #address-cells. We have to implement the old linux
135 : : * trick of looking for the parent here as some device-trees rely on it
136 : : */
137 : : old = of_node_get(ipar);
138 : : do {
139 : 0 : tmp = of_get_property(old, "#address-cells", NULL);
140 : 0 : tnode = of_get_parent(old);
141 : : of_node_put(old);
142 : : old = tnode;
143 [ # # ]: 0 : } while (old && tmp == NULL);
144 : : of_node_put(old);
145 : : old = NULL;
146 [ # # ][ # # ]: 0 : addrsize = (tmp == NULL) ? 2 : be32_to_cpu(*tmp);
147 : :
148 : : pr_debug(" -> addrsize=%d\n", addrsize);
149 : :
150 : : /* Range check so that the temporary buffer doesn't overflow */
151 [ # # ][ # # ]: 0 : if (WARN_ON(addrsize + intsize > MAX_PHANDLE_ARGS))
152 : : goto fail;
153 : :
154 : : /* Precalculate the match array - this simplifies match loop */
155 [ # # ]: 0 : for (i = 0; i < addrsize; i++)
156 [ # # ]: 0 : initial_match_array[i] = addr ? addr[i] : 0;
157 [ # # ]: 0 : for (i = 0; i < intsize; i++)
158 [ # # ]: 0 : initial_match_array[addrsize + i] = cpu_to_be32(out_irq->args[i]);
159 : :
160 : : /* Now start the actual "proper" walk of the interrupt tree */
161 [ # # ]: 0 : while (ipar != NULL) {
162 : : /* Now check if cursor is an interrupt-controller and if it is
163 : : * then we are done
164 : : */
165 [ # # ]: 0 : if (of_get_property(ipar, "interrupt-controller", NULL) !=
166 : : NULL) {
167 : : pr_debug(" -> got it !\n");
168 : : return 0;
169 : : }
170 : :
171 : : /*
172 : : * interrupt-map parsing does not work without a reg
173 : : * property when #address-cells != 0
174 : : */
175 [ # # ]: 0 : if (addrsize && !addr) {
176 : : pr_debug(" -> no reg passed in when needed !\n");
177 : : goto fail;
178 : : }
179 : :
180 : : /* Now look for an interrupt-map */
181 : 0 : imap = of_get_property(ipar, "interrupt-map", &imaplen);
182 : : /* No interrupt map, check for an interrupt parent */
183 [ # # ]: 0 : if (imap == NULL) {
184 : : pr_debug(" -> no map, getting parent\n");
185 : 0 : newpar = of_irq_find_parent(ipar);
186 : 0 : goto skiplevel;
187 : : }
188 : 0 : imaplen /= sizeof(u32);
189 : :
190 : : /* Look for a mask */
191 : 0 : imask = of_get_property(ipar, "interrupt-map-mask", NULL);
192 [ # # ]: 0 : if (!imask)
193 : : imask = dummy_imask;
194 : :
195 : : /* Parse interrupt-map */
196 : : match = 0;
197 [ # # ][ # # ]: 0 : while (imaplen > (addrsize + intsize + 1) && !match) {
198 : : /* Compare specifiers */
199 : : match = 1;
200 [ # # ]: 0 : for (i = 0; i < (addrsize + intsize); i++, imaplen--)
201 : 0 : match &= !((match_array[i] ^ *imap++) & imask[i]);
202 : :
203 : : pr_debug(" -> match=%d (imaplen=%d)\n", match, imaplen);
204 : :
205 : : /* Get the interrupt parent */
206 : : if (of_irq_workarounds & OF_IMAP_NO_PHANDLE)
207 : : newpar = of_node_get(of_irq_dflt_pic);
208 : : else
209 : 0 : newpar = of_find_node_by_phandle(be32_to_cpup(imap));
210 : 0 : imap++;
211 : 0 : --imaplen;
212 : :
213 : : /* Check if not found */
214 [ # # ]: 0 : if (newpar == NULL) {
215 : : pr_debug(" -> imap parent not found !\n");
216 : : goto fail;
217 : : }
218 : :
219 [ # # ]: 0 : if (!of_device_is_available(newpar))
220 : : match = 0;
221 : :
222 : : /* Get #interrupt-cells and #address-cells of new
223 : : * parent
224 : : */
225 : 0 : tmp = of_get_property(newpar, "#interrupt-cells", NULL);
226 [ # # ]: 0 : if (tmp == NULL) {
227 : : pr_debug(" -> parent lacks #interrupt-cells!\n");
228 : : goto fail;
229 : : }
230 [ # # ]: 0 : newintsize = be32_to_cpu(*tmp);
231 : 0 : tmp = of_get_property(newpar, "#address-cells", NULL);
232 [ # # ][ # # ]: 0 : newaddrsize = (tmp == NULL) ? 0 : be32_to_cpu(*tmp);
233 : :
234 : : pr_debug(" -> newintsize=%d, newaddrsize=%d\n",
235 : : newintsize, newaddrsize);
236 : :
237 : : /* Check for malformed properties */
238 [ # # ][ # # ]: 0 : if (WARN_ON(newaddrsize + newintsize > MAX_PHANDLE_ARGS))
239 : : goto fail;
240 [ # # ]: 0 : if (imaplen < (newaddrsize + newintsize))
241 : : goto fail;
242 : :
243 : 0 : imap += newaddrsize + newintsize;
244 : 0 : imaplen -= newaddrsize + newintsize;
245 : :
246 : : pr_debug(" -> imaplen=%d\n", imaplen);
247 : : }
248 [ # # ]: 0 : if (!match)
249 : : goto fail;
250 : :
251 : : /*
252 : : * Successfully parsed an interrrupt-map translation; copy new
253 : : * interrupt specifier into the out_irq structure
254 : : */
255 : 0 : out_irq->np = newpar;
256 : :
257 : 0 : match_array = imap - newaddrsize - newintsize;
258 [ # # ]: 0 : for (i = 0; i < newintsize; i++)
259 : 0 : out_irq->args[i] = be32_to_cpup(imap - newintsize + i);
260 : 0 : out_irq->args_count = intsize = newintsize;
261 : : addrsize = newaddrsize;
262 : :
263 : : skiplevel:
264 : : /* Iterate again with new parent */
265 : : pr_debug(" -> new parent: %s\n", of_node_full_name(newpar));
266 : : of_node_put(ipar);
267 : : ipar = newpar;
268 : : newpar = NULL;
269 : : }
270 : : fail:
271 : : of_node_put(ipar);
272 : : of_node_put(newpar);
273 : :
274 : : return -EINVAL;
275 : : }
276 : : EXPORT_SYMBOL_GPL(of_irq_parse_raw);
277 : :
278 : : /**
279 : : * of_irq_parse_one - Resolve an interrupt for a device
280 : : * @device: the device whose interrupt is to be resolved
281 : : * @index: index of the interrupt to resolve
282 : : * @out_irq: structure of_irq filled by this function
283 : : *
284 : : * This function resolves an interrupt for a node by walking the interrupt tree,
285 : : * finding which interrupt controller node it is attached to, and returning the
286 : : * interrupt specifier that can be used to retrieve a Linux IRQ number.
287 : : */
288 : 0 : int of_irq_parse_one(struct device_node *device, int index, struct of_phandle_args *out_irq)
289 : : {
290 : : struct device_node *p;
291 : : const __be32 *intspec, *tmp, *addr;
292 : : u32 intsize, intlen;
293 : : int i, res = -EINVAL;
294 : :
295 : : pr_debug("of_irq_parse_one: dev=%s, index=%d\n", of_node_full_name(device), index);
296 : :
297 : : /* OldWorld mac stuff is "special", handle out of line */
298 : : if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
299 : : return of_irq_parse_oldworld(device, index, out_irq);
300 : :
301 : : /* Get the reg property (if any) */
302 : 0 : addr = of_get_property(device, "reg", NULL);
303 : :
304 : : /* Get the interrupts property */
305 : 0 : intspec = of_get_property(device, "interrupts", &intlen);
306 [ # # ]: 0 : if (intspec == NULL) {
307 : : /* Try the new-style interrupts-extended */
308 : 0 : res = of_parse_phandle_with_args(device, "interrupts-extended",
309 : : "#interrupt-cells", index, out_irq);
310 [ # # ]: 0 : if (res)
311 : : return -EINVAL;
312 : 0 : return of_irq_parse_raw(addr, out_irq);
313 : : }
314 : 0 : intlen /= sizeof(*intspec);
315 : :
316 : : pr_debug(" intspec=%d intlen=%d\n", be32_to_cpup(intspec), intlen);
317 : :
318 : : /* Look for the interrupt parent. */
319 : 0 : p = of_irq_find_parent(device);
320 [ # # ]: 0 : if (p == NULL)
321 : : return -EINVAL;
322 : :
323 : : /* Get size of interrupt specifier */
324 : 0 : tmp = of_get_property(p, "#interrupt-cells", NULL);
325 [ # # ]: 0 : if (tmp == NULL)
326 : : goto out;
327 [ # # ]: 0 : intsize = be32_to_cpu(*tmp);
328 : :
329 : : pr_debug(" intsize=%d intlen=%d\n", intsize, intlen);
330 : :
331 : : /* Check index */
332 [ # # ]: 0 : if ((index + 1) * intsize > intlen)
333 : : goto out;
334 : :
335 : : /* Copy intspec into irq structure */
336 : 0 : intspec += index * intsize;
337 : 0 : out_irq->np = p;
338 : 0 : out_irq->args_count = intsize;
339 [ # # ]: 0 : for (i = 0; i < intsize; i++)
340 : 0 : out_irq->args[i] = be32_to_cpup(intspec++);
341 : :
342 : : /* Check if there are any interrupt-map translations to process */
343 : 0 : res = of_irq_parse_raw(addr, out_irq);
344 : : out:
345 : : of_node_put(p);
346 : 0 : return res;
347 : : }
348 : : EXPORT_SYMBOL_GPL(of_irq_parse_one);
349 : :
350 : : /**
351 : : * of_irq_to_resource - Decode a node's IRQ and return it as a resource
352 : : * @dev: pointer to device tree node
353 : : * @index: zero-based index of the irq
354 : : * @r: pointer to resource structure to return result into.
355 : : */
356 : 0 : int of_irq_to_resource(struct device_node *dev, int index, struct resource *r)
357 : : {
358 : 0 : int irq = irq_of_parse_and_map(dev, index);
359 : :
360 : : /* Only dereference the resource if both the
361 : : * resource and the irq are valid. */
362 [ # # ]: 0 : if (r && irq) {
363 : 0 : const char *name = NULL;
364 : :
365 : 0 : memset(r, 0, sizeof(*r));
366 : : /*
367 : : * Get optional "interrupts-names" property to add a name
368 : : * to the resource.
369 : : */
370 : 0 : of_property_read_string_index(dev, "interrupt-names", index,
371 : : &name);
372 : :
373 : 0 : r->start = r->end = irq;
374 : 0 : r->flags = IORESOURCE_IRQ | irqd_get_trigger_type(irq_get_irq_data(irq));
375 [ # # ]: 0 : r->name = name ? name : of_node_full_name(dev);
376 : : }
377 : :
378 : 0 : return irq;
379 : : }
380 : : EXPORT_SYMBOL_GPL(of_irq_to_resource);
381 : :
382 : : /**
383 : : * of_irq_count - Count the number of IRQs a node uses
384 : : * @dev: pointer to device tree node
385 : : */
386 : 0 : int of_irq_count(struct device_node *dev)
387 : : {
388 : : struct of_phandle_args irq;
389 : : int nr = 0;
390 : :
391 [ # # ]: 0 : while (of_irq_parse_one(dev, nr, &irq) == 0)
392 : 0 : nr++;
393 : :
394 : 0 : return nr;
395 : : }
396 : :
397 : : /**
398 : : * of_irq_to_resource_table - Fill in resource table with node's IRQ info
399 : : * @dev: pointer to device tree node
400 : : * @res: array of resources to fill in
401 : : * @nr_irqs: the number of IRQs (and upper bound for num of @res elements)
402 : : *
403 : : * Returns the size of the filled in table (up to @nr_irqs).
404 : : */
405 : 0 : int of_irq_to_resource_table(struct device_node *dev, struct resource *res,
406 : : int nr_irqs)
407 : : {
408 : : int i;
409 : :
410 [ # # ]: 0 : for (i = 0; i < nr_irqs; i++, res++)
411 [ # # ]: 0 : if (!of_irq_to_resource(dev, i, res))
412 : : break;
413 : :
414 : 0 : return i;
415 : : }
416 : : EXPORT_SYMBOL_GPL(of_irq_to_resource_table);
417 : :
418 : : struct intc_desc {
419 : : struct list_head list;
420 : : struct device_node *dev;
421 : : struct device_node *interrupt_parent;
422 : : };
423 : :
424 : : /**
425 : : * of_irq_init - Scan and init matching interrupt controllers in DT
426 : : * @matches: 0 terminated array of nodes to match and init function to call
427 : : *
428 : : * This function scans the device tree for matching interrupt controller nodes,
429 : : * and calls their initialization functions in order with parents first.
430 : : */
431 : 0 : void __init of_irq_init(const struct of_device_id *matches)
432 : : {
433 : : struct device_node *np, *parent = NULL;
434 : : struct intc_desc *desc, *temp_desc;
435 : : struct list_head intc_desc_list, intc_parent_list;
436 : :
437 : : INIT_LIST_HEAD(&intc_desc_list);
438 : : INIT_LIST_HEAD(&intc_parent_list);
439 : :
440 [ # # ]: 0 : for_each_matching_node(np, matches) {
441 [ # # # # ]: 0 : if (!of_find_property(np, "interrupt-controller", NULL) ||
442 : 0 : !of_device_is_available(np))
443 : 0 : continue;
444 : : /*
445 : : * Here, we allocate and populate an intc_desc with the node
446 : : * pointer, interrupt-parent device_node etc.
447 : : */
448 : : desc = kzalloc(sizeof(*desc), GFP_KERNEL);
449 [ # # ][ # # ]: 0 : if (WARN_ON(!desc))
450 : : goto err;
451 : :
452 : 0 : desc->dev = np;
453 : 0 : desc->interrupt_parent = of_irq_find_parent(np);
454 [ # # ]: 0 : if (desc->interrupt_parent == np)
455 : 0 : desc->interrupt_parent = NULL;
456 : 0 : list_add_tail(&desc->list, &intc_desc_list);
457 : : }
458 : :
459 : : /*
460 : : * The root irq controller is the one without an interrupt-parent.
461 : : * That one goes first, followed by the controllers that reference it,
462 : : * followed by the ones that reference the 2nd level controllers, etc.
463 : : */
464 [ # # ]: 0 : while (!list_empty(&intc_desc_list)) {
465 : : /*
466 : : * Process all controllers with the current 'parent'.
467 : : * First pass will be looking for NULL as the parent.
468 : : * The assumption is that NULL parent means a root controller.
469 : : */
470 [ # # ]: 0 : list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) {
471 : : const struct of_device_id *match;
472 : : int ret;
473 : : of_irq_init_cb_t irq_init_cb;
474 : :
475 [ # # ]: 0 : if (desc->interrupt_parent != parent)
476 : 0 : continue;
477 : :
478 : : list_del(&desc->list);
479 : 0 : match = of_match_node(matches, desc->dev);
480 [ # # ][ # # ]: 0 : if (WARN(!match->data,
481 : : "of_irq_init: no init function for %s\n",
482 : : match->compatible)) {
483 : 0 : kfree(desc);
484 : 0 : continue;
485 : : }
486 : :
487 : : pr_debug("of_irq_init: init %s @ %p, parent %p\n",
488 : : match->compatible,
489 : : desc->dev, desc->interrupt_parent);
490 : 0 : irq_init_cb = (of_irq_init_cb_t)match->data;
491 : 0 : ret = irq_init_cb(desc->dev, desc->interrupt_parent);
492 [ # # ]: 0 : if (ret) {
493 : 0 : kfree(desc);
494 : 0 : continue;
495 : : }
496 : :
497 : : /*
498 : : * This one is now set up; add it to the parent list so
499 : : * its children can get processed in a subsequent pass.
500 : : */
501 : : list_add_tail(&desc->list, &intc_parent_list);
502 : : }
503 : :
504 : : /* Get the next pending parent that might have children */
505 [ # # ]: 0 : desc = list_first_entry_or_null(&intc_parent_list,
506 : : typeof(*desc), list);
507 [ # # ]: 0 : if (!desc) {
508 : 0 : pr_err("of_irq_init: children remain, but no parents\n");
509 : 0 : break;
510 : : }
511 : : list_del(&desc->list);
512 : 0 : parent = desc->dev;
513 : 0 : kfree(desc);
514 : : }
515 : :
516 [ # # ]: 0 : list_for_each_entry_safe(desc, temp_desc, &intc_parent_list, list) {
517 : : list_del(&desc->list);
518 : 0 : kfree(desc);
519 : : }
520 : : err:
521 [ # # ]: 0 : list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) {
522 : : list_del(&desc->list);
523 : 0 : kfree(desc);
524 : : }
525 : 0 : }
|
