1e3873444SGrant Likely /* 2e3873444SGrant Likely * Derived from arch/i386/kernel/irq.c 3e3873444SGrant Likely * Copyright (C) 1992 Linus Torvalds 4e3873444SGrant Likely * Adapted from arch/i386 by Gary Thomas 5e3873444SGrant Likely * Copyright (C) 1995-1996 Gary Thomas (gdt@linuxppc.org) 6e3873444SGrant Likely * Updated and modified by Cort Dougan <cort@fsmlabs.com> 7e3873444SGrant Likely * Copyright (C) 1996-2001 Cort Dougan 8e3873444SGrant Likely * Adapted for Power Macintosh by Paul Mackerras 9e3873444SGrant Likely * Copyright (C) 1996 Paul Mackerras (paulus@cs.anu.edu.au) 10e3873444SGrant Likely * 11e3873444SGrant Likely * This program is free software; you can redistribute it and/or 12e3873444SGrant Likely * modify it under the terms of the GNU General Public License 13e3873444SGrant Likely * as published by the Free Software Foundation; either version 14e3873444SGrant Likely * 2 of the License, or (at your option) any later version. 15e3873444SGrant Likely * 16e3873444SGrant Likely * This file contains the code used to make IRQ descriptions in the 17e3873444SGrant Likely * device tree to actual irq numbers on an interrupt controller 18e3873444SGrant Likely * driver. 19e3873444SGrant Likely */ 20e3873444SGrant Likely 21606ad42aSRob Herring #define pr_fmt(fmt) "OF: " fmt 22606ad42aSRob Herring 23c706c239SMarc Zyngier #include <linux/device.h> 24e3873444SGrant Likely #include <linux/errno.h> 25c71a54b0SRob Herring #include <linux/list.h> 26e3873444SGrant Likely #include <linux/module.h> 27e3873444SGrant Likely #include <linux/of.h> 28e3873444SGrant Likely #include <linux/of_irq.h> 29987068fcSRobin Murphy #include <linux/of_pci.h> 30e3873444SGrant Likely #include <linux/string.h> 31c71a54b0SRob Herring #include <linux/slab.h> 32e3873444SGrant Likely 33e3873444SGrant Likely /** 34e3873444SGrant Likely * irq_of_parse_and_map - Parse and map an interrupt into linux virq space 35d84ff46aSYijing Wang * @dev: Device node of the device whose interrupt is to be mapped 36e3873444SGrant Likely * @index: Index of the interrupt to map 37e3873444SGrant Likely * 380c02c800SGrant Likely * This function is a wrapper that chains of_irq_parse_one() and 39e3873444SGrant Likely * irq_create_of_mapping() to make things easier to callers 40e3873444SGrant Likely */ 41e3873444SGrant Likely unsigned int irq_of_parse_and_map(struct device_node *dev, int index) 42e3873444SGrant Likely { 43530210c7SGrant Likely struct of_phandle_args oirq; 44e3873444SGrant Likely 450c02c800SGrant Likely if (of_irq_parse_one(dev, index, &oirq)) 4677a7300aSAnton Vorontsov return 0; 47e3873444SGrant Likely 48e6d30ab1SGrant Likely return irq_create_of_mapping(&oirq); 49e3873444SGrant Likely } 50e3873444SGrant Likely EXPORT_SYMBOL_GPL(irq_of_parse_and_map); 517dc2e113SGrant Likely 527dc2e113SGrant Likely /** 537dc2e113SGrant Likely * of_irq_find_parent - Given a device node, find its interrupt parent node 547dc2e113SGrant Likely * @child: pointer to device node 557dc2e113SGrant Likely * 567dc2e113SGrant Likely * Returns a pointer to the interrupt parent node, or NULL if the interrupt 577dc2e113SGrant Likely * parent could not be determined. 587dc2e113SGrant Likely */ 594c3141e0SCarlo Caione struct device_node *of_irq_find_parent(struct device_node *child) 607dc2e113SGrant Likely { 61b4bbb029SLinus Torvalds struct device_node *p; 62fa976ff7SSergei Shtylyov phandle parent; 637dc2e113SGrant Likely 64b4bbb029SLinus Torvalds if (!of_node_get(child)) 657dc2e113SGrant Likely return NULL; 667dc2e113SGrant Likely 677dc2e113SGrant Likely do { 68fa976ff7SSergei Shtylyov if (of_property_read_u32(child, "interrupt-parent", &parent)) { 69b4bbb029SLinus Torvalds p = of_get_parent(child); 70fa976ff7SSergei Shtylyov } else { 717dc2e113SGrant Likely if (of_irq_workarounds & OF_IMAP_NO_PHANDLE) 727dc2e113SGrant Likely p = of_node_get(of_irq_dflt_pic); 737dc2e113SGrant Likely else 74fa976ff7SSergei Shtylyov p = of_find_node_by_phandle(parent); 757dc2e113SGrant Likely } 76b4bbb029SLinus Torvalds of_node_put(child); 77b4bbb029SLinus Torvalds child = p; 787dc2e113SGrant Likely } while (p && of_get_property(p, "#interrupt-cells", NULL) == NULL); 797dc2e113SGrant Likely 80b4bbb029SLinus Torvalds return p; 817dc2e113SGrant Likely } 824c3141e0SCarlo Caione EXPORT_SYMBOL_GPL(of_irq_find_parent); 837dc2e113SGrant Likely 847dc2e113SGrant Likely /** 850c02c800SGrant Likely * of_irq_parse_raw - Low level interrupt tree parsing 867dc2e113SGrant Likely * @parent: the device interrupt parent 8723616132SGrant Likely * @addr: address specifier (start of "reg" property of the device) in be32 format 8823616132SGrant Likely * @out_irq: structure of_irq updated by this function 897dc2e113SGrant Likely * 907dc2e113SGrant Likely * Returns 0 on success and a negative number on error 917dc2e113SGrant Likely * 927dc2e113SGrant Likely * This function is a low-level interrupt tree walking function. It 937dc2e113SGrant Likely * can be used to do a partial walk with synthetized reg and interrupts 947dc2e113SGrant Likely * properties, for example when resolving PCI interrupts when no device 9523616132SGrant Likely * node exist for the parent. It takes an interrupt specifier structure as 9623616132SGrant Likely * input, walks the tree looking for any interrupt-map properties, translates 9723616132SGrant Likely * the specifier for each map, and then returns the translated map. 987dc2e113SGrant Likely */ 9923616132SGrant Likely int of_irq_parse_raw(const __be32 *addr, struct of_phandle_args *out_irq) 1007dc2e113SGrant Likely { 1017dc2e113SGrant Likely struct device_node *ipar, *tnode, *old = NULL, *newpar = NULL; 102355e62f5SGrant Likely __be32 initial_match_array[MAX_PHANDLE_ARGS]; 10323616132SGrant Likely const __be32 *match_array = initial_match_array; 10417a70355SRob Herring const __be32 *tmp, *imap, *imask, dummy_imask[] = { [0 ... MAX_PHANDLE_ARGS] = cpu_to_be32(~0) }; 1057dc2e113SGrant Likely u32 intsize = 1, addrsize, newintsize = 0, newaddrsize = 0; 106f1aa5484SGuilherme G. Piccoli int imaplen, match, i, rc = -EINVAL; 1077dc2e113SGrant Likely 108624cfca5SGrant Likely #ifdef DEBUG 109624cfca5SGrant Likely of_print_phandle_args("of_irq_parse_raw: ", out_irq); 110624cfca5SGrant Likely #endif 1117dc2e113SGrant Likely 11223616132SGrant Likely ipar = of_node_get(out_irq->np); 1137dc2e113SGrant Likely 1147dc2e113SGrant Likely /* First get the #interrupt-cells property of the current cursor 1157dc2e113SGrant Likely * that tells us how to interpret the passed-in intspec. If there 1167dc2e113SGrant Likely * is none, we are nice and just walk up the tree 1177dc2e113SGrant Likely */ 1187dc2e113SGrant Likely do { 119fa976ff7SSergei Shtylyov if (!of_property_read_u32(ipar, "#interrupt-cells", &intsize)) 1207dc2e113SGrant Likely break; 1217dc2e113SGrant Likely tnode = ipar; 1227dc2e113SGrant Likely ipar = of_irq_find_parent(ipar); 1237dc2e113SGrant Likely of_node_put(tnode); 1247dc2e113SGrant Likely } while (ipar); 1257dc2e113SGrant Likely if (ipar == NULL) { 1267dc2e113SGrant Likely pr_debug(" -> no parent found !\n"); 1277dc2e113SGrant Likely goto fail; 1287dc2e113SGrant Likely } 1297dc2e113SGrant Likely 1300d638a07SRob Herring pr_debug("of_irq_parse_raw: ipar=%pOF, size=%d\n", ipar, intsize); 1317dc2e113SGrant Likely 13223616132SGrant Likely if (out_irq->args_count != intsize) 133f1aa5484SGuilherme G. Piccoli goto fail; 1347dc2e113SGrant Likely 1357dc2e113SGrant Likely /* Look for this #address-cells. We have to implement the old linux 1367dc2e113SGrant Likely * trick of looking for the parent here as some device-trees rely on it 1377dc2e113SGrant Likely */ 1387dc2e113SGrant Likely old = of_node_get(ipar); 1397dc2e113SGrant Likely do { 1407dc2e113SGrant Likely tmp = of_get_property(old, "#address-cells", NULL); 1417dc2e113SGrant Likely tnode = of_get_parent(old); 1427dc2e113SGrant Likely of_node_put(old); 1437dc2e113SGrant Likely old = tnode; 1447dc2e113SGrant Likely } while (old && tmp == NULL); 1457dc2e113SGrant Likely of_node_put(old); 1467dc2e113SGrant Likely old = NULL; 147a7c194b0SRob Herring addrsize = (tmp == NULL) ? 2 : be32_to_cpu(*tmp); 1487dc2e113SGrant Likely 1497dc2e113SGrant Likely pr_debug(" -> addrsize=%d\n", addrsize); 1507dc2e113SGrant Likely 151355e62f5SGrant Likely /* Range check so that the temporary buffer doesn't overflow */ 152f1aa5484SGuilherme G. Piccoli if (WARN_ON(addrsize + intsize > MAX_PHANDLE_ARGS)) { 153f1aa5484SGuilherme G. Piccoli rc = -EFAULT; 154355e62f5SGrant Likely goto fail; 155f1aa5484SGuilherme G. Piccoli } 156355e62f5SGrant Likely 15723616132SGrant Likely /* Precalculate the match array - this simplifies match loop */ 15823616132SGrant Likely for (i = 0; i < addrsize; i++) 15978119fd1SGrant Likely initial_match_array[i] = addr ? addr[i] : 0; 16023616132SGrant Likely for (i = 0; i < intsize; i++) 16123616132SGrant Likely initial_match_array[addrsize + i] = cpu_to_be32(out_irq->args[i]); 16223616132SGrant Likely 1637dc2e113SGrant Likely /* Now start the actual "proper" walk of the interrupt tree */ 1647dc2e113SGrant Likely while (ipar != NULL) { 1657dc2e113SGrant Likely /* Now check if cursor is an interrupt-controller and if it is 1667dc2e113SGrant Likely * then we are done 1677dc2e113SGrant Likely */ 1686a245d95SSergei Shtylyov if (of_property_read_bool(ipar, "interrupt-controller")) { 1697dc2e113SGrant Likely pr_debug(" -> got it !\n"); 1707dc2e113SGrant Likely return 0; 1717dc2e113SGrant Likely } 1727dc2e113SGrant Likely 17378119fd1SGrant Likely /* 17478119fd1SGrant Likely * interrupt-map parsing does not work without a reg 17578119fd1SGrant Likely * property when #address-cells != 0 17678119fd1SGrant Likely */ 17778119fd1SGrant Likely if (addrsize && !addr) { 17878119fd1SGrant Likely pr_debug(" -> no reg passed in when needed !\n"); 17978119fd1SGrant Likely goto fail; 18078119fd1SGrant Likely } 18178119fd1SGrant Likely 1827dc2e113SGrant Likely /* Now look for an interrupt-map */ 1837dc2e113SGrant Likely imap = of_get_property(ipar, "interrupt-map", &imaplen); 1847dc2e113SGrant Likely /* No interrupt map, check for an interrupt parent */ 1857dc2e113SGrant Likely if (imap == NULL) { 1867dc2e113SGrant Likely pr_debug(" -> no map, getting parent\n"); 1877dc2e113SGrant Likely newpar = of_irq_find_parent(ipar); 1887dc2e113SGrant Likely goto skiplevel; 1897dc2e113SGrant Likely } 1907dc2e113SGrant Likely imaplen /= sizeof(u32); 1917dc2e113SGrant Likely 1927dc2e113SGrant Likely /* Look for a mask */ 1937dc2e113SGrant Likely imask = of_get_property(ipar, "interrupt-map-mask", NULL); 19423616132SGrant Likely if (!imask) 19523616132SGrant Likely imask = dummy_imask; 1967dc2e113SGrant Likely 1977dc2e113SGrant Likely /* Parse interrupt-map */ 1987dc2e113SGrant Likely match = 0; 1997dc2e113SGrant Likely while (imaplen > (addrsize + intsize + 1) && !match) { 2007dc2e113SGrant Likely /* Compare specifiers */ 2017dc2e113SGrant Likely match = 1; 20223616132SGrant Likely for (i = 0; i < (addrsize + intsize); i++, imaplen--) 20374dac2edSTomasz Figa match &= !((match_array[i] ^ *imap++) & imask[i]); 2047dc2e113SGrant Likely 2057dc2e113SGrant Likely pr_debug(" -> match=%d (imaplen=%d)\n", match, imaplen); 2067dc2e113SGrant Likely 2077dc2e113SGrant Likely /* Get the interrupt parent */ 2087dc2e113SGrant Likely if (of_irq_workarounds & OF_IMAP_NO_PHANDLE) 2097dc2e113SGrant Likely newpar = of_node_get(of_irq_dflt_pic); 2107dc2e113SGrant Likely else 2119a6b2e58SGrant Likely newpar = of_find_node_by_phandle(be32_to_cpup(imap)); 2127dc2e113SGrant Likely imap++; 2137dc2e113SGrant Likely --imaplen; 2147dc2e113SGrant Likely 2157dc2e113SGrant Likely /* Check if not found */ 2167dc2e113SGrant Likely if (newpar == NULL) { 2177dc2e113SGrant Likely pr_debug(" -> imap parent not found !\n"); 2187dc2e113SGrant Likely goto fail; 2197dc2e113SGrant Likely } 2207dc2e113SGrant Likely 2211ca56e7dSPeter Crosthwaite if (!of_device_is_available(newpar)) 2221ca56e7dSPeter Crosthwaite match = 0; 2231ca56e7dSPeter Crosthwaite 2247dc2e113SGrant Likely /* Get #interrupt-cells and #address-cells of new 2257dc2e113SGrant Likely * parent 2267dc2e113SGrant Likely */ 227fa976ff7SSergei Shtylyov if (of_property_read_u32(newpar, "#interrupt-cells", 228fa976ff7SSergei Shtylyov &newintsize)) { 2297dc2e113SGrant Likely pr_debug(" -> parent lacks #interrupt-cells!\n"); 2307dc2e113SGrant Likely goto fail; 2317dc2e113SGrant Likely } 232fa976ff7SSergei Shtylyov if (of_property_read_u32(newpar, "#address-cells", 233fa976ff7SSergei Shtylyov &newaddrsize)) 234fa976ff7SSergei Shtylyov newaddrsize = 0; 2357dc2e113SGrant Likely 2367dc2e113SGrant Likely pr_debug(" -> newintsize=%d, newaddrsize=%d\n", 2377dc2e113SGrant Likely newintsize, newaddrsize); 2387dc2e113SGrant Likely 2397dc2e113SGrant Likely /* Check for malformed properties */ 240f1aa5484SGuilherme G. Piccoli if (WARN_ON(newaddrsize + newintsize > MAX_PHANDLE_ARGS) 241f1aa5484SGuilherme G. Piccoli || (imaplen < (newaddrsize + newintsize))) { 242f1aa5484SGuilherme G. Piccoli rc = -EFAULT; 243355e62f5SGrant Likely goto fail; 244f1aa5484SGuilherme G. Piccoli } 2457dc2e113SGrant Likely 2467dc2e113SGrant Likely imap += newaddrsize + newintsize; 2477dc2e113SGrant Likely imaplen -= newaddrsize + newintsize; 2487dc2e113SGrant Likely 2497dc2e113SGrant Likely pr_debug(" -> imaplen=%d\n", imaplen); 2507dc2e113SGrant Likely } 2517dc2e113SGrant Likely if (!match) 2527dc2e113SGrant Likely goto fail; 2537dc2e113SGrant Likely 25423616132SGrant Likely /* 25523616132SGrant Likely * Successfully parsed an interrrupt-map translation; copy new 25623616132SGrant Likely * interrupt specifier into the out_irq structure 25723616132SGrant Likely */ 25823616132SGrant Likely match_array = imap - newaddrsize - newintsize; 25923616132SGrant Likely for (i = 0; i < newintsize; i++) 26023616132SGrant Likely out_irq->args[i] = be32_to_cpup(imap - newintsize + i); 26123616132SGrant Likely out_irq->args_count = intsize = newintsize; 2627dc2e113SGrant Likely addrsize = newaddrsize; 2637dc2e113SGrant Likely 2647dc2e113SGrant Likely skiplevel: 2657dc2e113SGrant Likely /* Iterate again with new parent */ 266d23b2516SJeremy Linton out_irq->np = newpar; 2670d638a07SRob Herring pr_debug(" -> new parent: %pOF\n", newpar); 2687dc2e113SGrant Likely of_node_put(ipar); 2697dc2e113SGrant Likely ipar = newpar; 2707dc2e113SGrant Likely newpar = NULL; 2717dc2e113SGrant Likely } 272f1aa5484SGuilherme G. Piccoli rc = -ENOENT; /* No interrupt-map found */ 273f1aa5484SGuilherme G. Piccoli 2747dc2e113SGrant Likely fail: 2757dc2e113SGrant Likely of_node_put(ipar); 2767dc2e113SGrant Likely of_node_put(newpar); 2777dc2e113SGrant Likely 278f1aa5484SGuilherme G. Piccoli return rc; 2797dc2e113SGrant Likely } 2800c02c800SGrant Likely EXPORT_SYMBOL_GPL(of_irq_parse_raw); 2817dc2e113SGrant Likely 2827dc2e113SGrant Likely /** 2830c02c800SGrant Likely * of_irq_parse_one - Resolve an interrupt for a device 2847dc2e113SGrant Likely * @device: the device whose interrupt is to be resolved 2857dc2e113SGrant Likely * @index: index of the interrupt to resolve 2867dc2e113SGrant Likely * @out_irq: structure of_irq filled by this function 2877dc2e113SGrant Likely * 28823616132SGrant Likely * This function resolves an interrupt for a node by walking the interrupt tree, 28923616132SGrant Likely * finding which interrupt controller node it is attached to, and returning the 29023616132SGrant Likely * interrupt specifier that can be used to retrieve a Linux IRQ number. 2917dc2e113SGrant Likely */ 292530210c7SGrant Likely int of_irq_parse_one(struct device_node *device, int index, struct of_phandle_args *out_irq) 2937dc2e113SGrant Likely { 2947dc2e113SGrant Likely struct device_node *p; 295b47fe22dSRob Herring const __be32 *addr; 296b47fe22dSRob Herring u32 intsize; 297d7c14605SLaurent Pinchart int i, res; 2987dc2e113SGrant Likely 2990d638a07SRob Herring pr_debug("of_irq_parse_one: dev=%pOF, index=%d\n", device, index); 3007dc2e113SGrant Likely 3017dc2e113SGrant Likely /* OldWorld mac stuff is "special", handle out of line */ 3027dc2e113SGrant Likely if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC) 3030c02c800SGrant Likely return of_irq_parse_oldworld(device, index, out_irq); 3047dc2e113SGrant Likely 30579d97015SGrant Likely /* Get the reg property (if any) */ 30679d97015SGrant Likely addr = of_get_property(device, "reg", NULL); 30779d97015SGrant Likely 308a9ecdc0fSFlorian Fainelli /* Try the new-style interrupts-extended first */ 30979d97015SGrant Likely res = of_parse_phandle_with_args(device, "interrupts-extended", 31079d97015SGrant Likely "#interrupt-cells", index, out_irq); 311a9ecdc0fSFlorian Fainelli if (!res) 31279d97015SGrant Likely return of_irq_parse_raw(addr, out_irq); 313a9ecdc0fSFlorian Fainelli 3147dc2e113SGrant Likely /* Look for the interrupt parent. */ 3157dc2e113SGrant Likely p = of_irq_find_parent(device); 3167dc2e113SGrant Likely if (p == NULL) 3177dc2e113SGrant Likely return -EINVAL; 3187dc2e113SGrant Likely 3197dc2e113SGrant Likely /* Get size of interrupt specifier */ 320fa976ff7SSergei Shtylyov if (of_property_read_u32(p, "#interrupt-cells", &intsize)) { 321d7c14605SLaurent Pinchart res = -EINVAL; 3227dc2e113SGrant Likely goto out; 323d7c14605SLaurent Pinchart } 3247dc2e113SGrant Likely 325b47fe22dSRob Herring pr_debug(" parent=%pOF, intsize=%d\n", p, intsize); 3267dc2e113SGrant Likely 327b47fe22dSRob Herring /* Copy intspec into irq structure */ 328b47fe22dSRob Herring out_irq->np = p; 329b47fe22dSRob Herring out_irq->args_count = intsize; 330b47fe22dSRob Herring for (i = 0; i < intsize; i++) { 331b47fe22dSRob Herring res = of_property_read_u32_index(device, "interrupts", 332b47fe22dSRob Herring (index * intsize) + i, 333b47fe22dSRob Herring out_irq->args + i); 334b47fe22dSRob Herring if (res) 3357dc2e113SGrant Likely goto out; 336d7c14605SLaurent Pinchart } 3377dc2e113SGrant Likely 338b47fe22dSRob Herring pr_debug(" intspec=%d\n", *out_irq->args); 339b47fe22dSRob Herring 34023616132SGrant Likely 34123616132SGrant Likely /* Check if there are any interrupt-map translations to process */ 34223616132SGrant Likely res = of_irq_parse_raw(addr, out_irq); 3437dc2e113SGrant Likely out: 3447dc2e113SGrant Likely of_node_put(p); 3457dc2e113SGrant Likely return res; 3467dc2e113SGrant Likely } 3470c02c800SGrant Likely EXPORT_SYMBOL_GPL(of_irq_parse_one); 3487dc2e113SGrant Likely 3497dc2e113SGrant Likely /** 3507dc2e113SGrant Likely * of_irq_to_resource - Decode a node's IRQ and return it as a resource 3517dc2e113SGrant Likely * @dev: pointer to device tree node 3527dc2e113SGrant Likely * @index: zero-based index of the irq 3537dc2e113SGrant Likely * @r: pointer to resource structure to return result into. 3547dc2e113SGrant Likely */ 3557dc2e113SGrant Likely int of_irq_to_resource(struct device_node *dev, int index, struct resource *r) 3567dc2e113SGrant Likely { 3577a4228bbSThomas Petazzoni int irq = of_irq_get(dev, index); 3587a4228bbSThomas Petazzoni 3597a4228bbSThomas Petazzoni if (irq < 0) 3607a4228bbSThomas Petazzoni return irq; 3617dc2e113SGrant Likely 3627dc2e113SGrant Likely /* Only dereference the resource if both the 3637dc2e113SGrant Likely * resource and the irq are valid. */ 36477a7300aSAnton Vorontsov if (r && irq) { 365661db794SBenoit Cousson const char *name = NULL; 366661db794SBenoit Cousson 367cf9e2368SSebastian Andrzej Siewior memset(r, 0, sizeof(*r)); 368661db794SBenoit Cousson /* 369ae107d06SGeert Uytterhoeven * Get optional "interrupt-names" property to add a name 370661db794SBenoit Cousson * to the resource. 371661db794SBenoit Cousson */ 372661db794SBenoit Cousson of_property_read_string_index(dev, "interrupt-names", index, 373661db794SBenoit Cousson &name); 374661db794SBenoit Cousson 3757dc2e113SGrant Likely r->start = r->end = irq; 3764a43d686STomasz Figa r->flags = IORESOURCE_IRQ | irqd_get_trigger_type(irq_get_irq_data(irq)); 3778804827bSGrant Likely r->name = name ? name : of_node_full_name(dev); 3787dc2e113SGrant Likely } 3797dc2e113SGrant Likely 3807dc2e113SGrant Likely return irq; 3817dc2e113SGrant Likely } 3827dc2e113SGrant Likely EXPORT_SYMBOL_GPL(of_irq_to_resource); 38352f6537cSAndres Salomon 38452f6537cSAndres Salomon /** 38539935466SSergei Shtylyov * of_irq_get - Decode a node's IRQ and return it as a Linux IRQ number 3869ec36cafSRob Herring * @dev: pointer to device tree node 38739935466SSergei Shtylyov * @index: zero-based index of the IRQ 3889ec36cafSRob Herring * 38939935466SSergei Shtylyov * Returns Linux IRQ number on success, or 0 on the IRQ mapping failure, or 39039935466SSergei Shtylyov * -EPROBE_DEFER if the IRQ domain is not yet created, or error code in case 39139935466SSergei Shtylyov * of any other failure. 3929ec36cafSRob Herring */ 3939ec36cafSRob Herring int of_irq_get(struct device_node *dev, int index) 3949ec36cafSRob Herring { 3959ec36cafSRob Herring int rc; 3969ec36cafSRob Herring struct of_phandle_args oirq; 3979ec36cafSRob Herring struct irq_domain *domain; 3989ec36cafSRob Herring 3999ec36cafSRob Herring rc = of_irq_parse_one(dev, index, &oirq); 4009ec36cafSRob Herring if (rc) 4019ec36cafSRob Herring return rc; 4029ec36cafSRob Herring 4039ec36cafSRob Herring domain = irq_find_host(oirq.np); 4049ec36cafSRob Herring if (!domain) 4059ec36cafSRob Herring return -EPROBE_DEFER; 4069ec36cafSRob Herring 4079ec36cafSRob Herring return irq_create_of_mapping(&oirq); 4089ec36cafSRob Herring } 4099eb08fb3SLaurent Pinchart EXPORT_SYMBOL_GPL(of_irq_get); 4109ec36cafSRob Herring 4119ec36cafSRob Herring /** 41239935466SSergei Shtylyov * of_irq_get_byname - Decode a node's IRQ and return it as a Linux IRQ number 413ad69674eSGrygorii Strashko * @dev: pointer to device tree node 41439935466SSergei Shtylyov * @name: IRQ name 415ad69674eSGrygorii Strashko * 41639935466SSergei Shtylyov * Returns Linux IRQ number on success, or 0 on the IRQ mapping failure, or 41739935466SSergei Shtylyov * -EPROBE_DEFER if the IRQ domain is not yet created, or error code in case 41839935466SSergei Shtylyov * of any other failure. 419ad69674eSGrygorii Strashko */ 420ad69674eSGrygorii Strashko int of_irq_get_byname(struct device_node *dev, const char *name) 421ad69674eSGrygorii Strashko { 422ad69674eSGrygorii Strashko int index; 423ad69674eSGrygorii Strashko 424ad69674eSGrygorii Strashko if (unlikely(!name)) 425ad69674eSGrygorii Strashko return -EINVAL; 426ad69674eSGrygorii Strashko 427ad69674eSGrygorii Strashko index = of_property_match_string(dev, "interrupt-names", name); 428ad69674eSGrygorii Strashko if (index < 0) 429ad69674eSGrygorii Strashko return index; 430ad69674eSGrygorii Strashko 431ad69674eSGrygorii Strashko return of_irq_get(dev, index); 432ad69674eSGrygorii Strashko } 4336602c452SDmitry Torokhov EXPORT_SYMBOL_GPL(of_irq_get_byname); 434ad69674eSGrygorii Strashko 435ad69674eSGrygorii Strashko /** 43652f6537cSAndres Salomon * of_irq_count - Count the number of IRQs a node uses 43752f6537cSAndres Salomon * @dev: pointer to device tree node 43852f6537cSAndres Salomon */ 43952f6537cSAndres Salomon int of_irq_count(struct device_node *dev) 44052f6537cSAndres Salomon { 4413da52787SThierry Reding struct of_phandle_args irq; 44252f6537cSAndres Salomon int nr = 0; 44352f6537cSAndres Salomon 4443da52787SThierry Reding while (of_irq_parse_one(dev, nr, &irq) == 0) 44552f6537cSAndres Salomon nr++; 44652f6537cSAndres Salomon 44752f6537cSAndres Salomon return nr; 44852f6537cSAndres Salomon } 44952f6537cSAndres Salomon 45052f6537cSAndres Salomon /** 45152f6537cSAndres Salomon * of_irq_to_resource_table - Fill in resource table with node's IRQ info 45252f6537cSAndres Salomon * @dev: pointer to device tree node 45352f6537cSAndres Salomon * @res: array of resources to fill in 45452f6537cSAndres Salomon * @nr_irqs: the number of IRQs (and upper bound for num of @res elements) 45552f6537cSAndres Salomon * 45652f6537cSAndres Salomon * Returns the size of the filled in table (up to @nr_irqs). 45752f6537cSAndres Salomon */ 45852f6537cSAndres Salomon int of_irq_to_resource_table(struct device_node *dev, struct resource *res, 45952f6537cSAndres Salomon int nr_irqs) 46052f6537cSAndres Salomon { 46152f6537cSAndres Salomon int i; 46252f6537cSAndres Salomon 46352f6537cSAndres Salomon for (i = 0; i < nr_irqs; i++, res++) 46477a7300aSAnton Vorontsov if (!of_irq_to_resource(dev, i, res)) 46552f6537cSAndres Salomon break; 46652f6537cSAndres Salomon 46752f6537cSAndres Salomon return i; 46852f6537cSAndres Salomon } 469a4f8bf22SJohn Crispin EXPORT_SYMBOL_GPL(of_irq_to_resource_table); 470c71a54b0SRob Herring 47148a9b733SGeert Uytterhoeven struct of_intc_desc { 472c71a54b0SRob Herring struct list_head list; 473264041e3SMasahiro Yamada of_irq_init_cb_t irq_init_cb; 474c71a54b0SRob Herring struct device_node *dev; 475c71a54b0SRob Herring struct device_node *interrupt_parent; 476c71a54b0SRob Herring }; 477c71a54b0SRob Herring 478c71a54b0SRob Herring /** 479c71a54b0SRob Herring * of_irq_init - Scan and init matching interrupt controllers in DT 480c71a54b0SRob Herring * @matches: 0 terminated array of nodes to match and init function to call 481c71a54b0SRob Herring * 482c71a54b0SRob Herring * This function scans the device tree for matching interrupt controller nodes, 483c71a54b0SRob Herring * and calls their initialization functions in order with parents first. 484c71a54b0SRob Herring */ 485c71a54b0SRob Herring void __init of_irq_init(const struct of_device_id *matches) 486c71a54b0SRob Herring { 487264041e3SMasahiro Yamada const struct of_device_id *match; 488c71a54b0SRob Herring struct device_node *np, *parent = NULL; 48948a9b733SGeert Uytterhoeven struct of_intc_desc *desc, *temp_desc; 490c71a54b0SRob Herring struct list_head intc_desc_list, intc_parent_list; 491c71a54b0SRob Herring 492c71a54b0SRob Herring INIT_LIST_HEAD(&intc_desc_list); 493c71a54b0SRob Herring INIT_LIST_HEAD(&intc_parent_list); 494c71a54b0SRob Herring 495264041e3SMasahiro Yamada for_each_matching_node_and_match(np, matches, &match) { 4966a245d95SSergei Shtylyov if (!of_property_read_bool(np, "interrupt-controller") || 497bf49be02SPeter Crosthwaite !of_device_is_available(np)) 498c71a54b0SRob Herring continue; 499264041e3SMasahiro Yamada 500264041e3SMasahiro Yamada if (WARN(!match->data, "of_irq_init: no init function for %s\n", 501264041e3SMasahiro Yamada match->compatible)) 502264041e3SMasahiro Yamada continue; 503264041e3SMasahiro Yamada 504c71a54b0SRob Herring /* 50548a9b733SGeert Uytterhoeven * Here, we allocate and populate an of_intc_desc with the node 506c71a54b0SRob Herring * pointer, interrupt-parent device_node etc. 507c71a54b0SRob Herring */ 508c71a54b0SRob Herring desc = kzalloc(sizeof(*desc), GFP_KERNEL); 5098363ccb9SJulia Lawall if (WARN_ON(!desc)) { 5108363ccb9SJulia Lawall of_node_put(np); 511c71a54b0SRob Herring goto err; 5128363ccb9SJulia Lawall } 513c71a54b0SRob Herring 514264041e3SMasahiro Yamada desc->irq_init_cb = match->data; 5158363ccb9SJulia Lawall desc->dev = of_node_get(np); 516c71a54b0SRob Herring desc->interrupt_parent = of_irq_find_parent(np); 517d7fb6d0aSRob Herring if (desc->interrupt_parent == np) 518d7fb6d0aSRob Herring desc->interrupt_parent = NULL; 519c71a54b0SRob Herring list_add_tail(&desc->list, &intc_desc_list); 520c71a54b0SRob Herring } 521c71a54b0SRob Herring 522c71a54b0SRob Herring /* 523c71a54b0SRob Herring * The root irq controller is the one without an interrupt-parent. 524c71a54b0SRob Herring * That one goes first, followed by the controllers that reference it, 525c71a54b0SRob Herring * followed by the ones that reference the 2nd level controllers, etc. 526c71a54b0SRob Herring */ 527c71a54b0SRob Herring while (!list_empty(&intc_desc_list)) { 528c71a54b0SRob Herring /* 529c71a54b0SRob Herring * Process all controllers with the current 'parent'. 530c71a54b0SRob Herring * First pass will be looking for NULL as the parent. 531c71a54b0SRob Herring * The assumption is that NULL parent means a root controller. 532c71a54b0SRob Herring */ 533c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) { 534c71a54b0SRob Herring int ret; 535c71a54b0SRob Herring 536c71a54b0SRob Herring if (desc->interrupt_parent != parent) 537c71a54b0SRob Herring continue; 538c71a54b0SRob Herring 539c71a54b0SRob Herring list_del(&desc->list); 540c71a54b0SRob Herring 541e55aeb6bSPhilipp Zabel of_node_set_flag(desc->dev, OF_POPULATED); 542e55aeb6bSPhilipp Zabel 5430d638a07SRob Herring pr_debug("of_irq_init: init %pOF (%p), parent %p\n", 5440d638a07SRob Herring desc->dev, 545c71a54b0SRob Herring desc->dev, desc->interrupt_parent); 546264041e3SMasahiro Yamada ret = desc->irq_init_cb(desc->dev, 547264041e3SMasahiro Yamada desc->interrupt_parent); 548c71a54b0SRob Herring if (ret) { 549e55aeb6bSPhilipp Zabel of_node_clear_flag(desc->dev, OF_POPULATED); 550c71a54b0SRob Herring kfree(desc); 551c71a54b0SRob Herring continue; 552c71a54b0SRob Herring } 553c71a54b0SRob Herring 554c71a54b0SRob Herring /* 555c71a54b0SRob Herring * This one is now set up; add it to the parent list so 556c71a54b0SRob Herring * its children can get processed in a subsequent pass. 557c71a54b0SRob Herring */ 558c71a54b0SRob Herring list_add_tail(&desc->list, &intc_parent_list); 559c71a54b0SRob Herring } 560c71a54b0SRob Herring 561c71a54b0SRob Herring /* Get the next pending parent that might have children */ 562c0cdfaa0SAxel Lin desc = list_first_entry_or_null(&intc_parent_list, 563c0cdfaa0SAxel Lin typeof(*desc), list); 564c0cdfaa0SAxel Lin if (!desc) { 565c71a54b0SRob Herring pr_err("of_irq_init: children remain, but no parents\n"); 566c71a54b0SRob Herring break; 567c71a54b0SRob Herring } 568c71a54b0SRob Herring list_del(&desc->list); 569c71a54b0SRob Herring parent = desc->dev; 570c71a54b0SRob Herring kfree(desc); 571c71a54b0SRob Herring } 572c71a54b0SRob Herring 573c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_parent_list, list) { 574c71a54b0SRob Herring list_del(&desc->list); 575c71a54b0SRob Herring kfree(desc); 576c71a54b0SRob Herring } 577c71a54b0SRob Herring err: 578c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) { 579c71a54b0SRob Herring list_del(&desc->list); 5808363ccb9SJulia Lawall of_node_put(desc->dev); 581c71a54b0SRob Herring kfree(desc); 582c71a54b0SRob Herring } 583c71a54b0SRob Herring } 584c706c239SMarc Zyngier 585a251b263SMarc Zyngier static u32 __of_msi_map_rid(struct device *dev, struct device_node **np, 586a251b263SMarc Zyngier u32 rid_in) 5878db02d8bSDavid Daney { 5888db02d8bSDavid Daney struct device *parent_dev; 5898db02d8bSDavid Daney u32 rid_out = rid_in; 5908db02d8bSDavid Daney 5918db02d8bSDavid Daney /* 5928db02d8bSDavid Daney * Walk up the device parent links looking for one with a 5938db02d8bSDavid Daney * "msi-map" property. 5948db02d8bSDavid Daney */ 595987068fcSRobin Murphy for (parent_dev = dev; parent_dev; parent_dev = parent_dev->parent) 596987068fcSRobin Murphy if (!of_pci_map_rid(parent_dev->of_node, rid_in, "msi-map", 597987068fcSRobin Murphy "msi-map-mask", np, &rid_out)) 5988db02d8bSDavid Daney break; 5998db02d8bSDavid Daney return rid_out; 6008db02d8bSDavid Daney } 60148ae34fbSMarc Zyngier 602a251b263SMarc Zyngier /** 603a251b263SMarc Zyngier * of_msi_map_rid - Map a MSI requester ID for a device. 604a251b263SMarc Zyngier * @dev: device for which the mapping is to be done. 605a251b263SMarc Zyngier * @msi_np: device node of the expected msi controller. 606a251b263SMarc Zyngier * @rid_in: unmapped MSI requester ID for the device. 607a251b263SMarc Zyngier * 608a251b263SMarc Zyngier * Walk up the device hierarchy looking for devices with a "msi-map" 609a251b263SMarc Zyngier * property. If found, apply the mapping to @rid_in. 610a251b263SMarc Zyngier * 611a251b263SMarc Zyngier * Returns the mapped MSI requester ID. 612a251b263SMarc Zyngier */ 613a251b263SMarc Zyngier u32 of_msi_map_rid(struct device *dev, struct device_node *msi_np, u32 rid_in) 614a251b263SMarc Zyngier { 615a251b263SMarc Zyngier return __of_msi_map_rid(dev, &msi_np, rid_in); 616a251b263SMarc Zyngier } 617a251b263SMarc Zyngier 61848ae34fbSMarc Zyngier /** 61982b9b424SMarc Zyngier * of_msi_map_get_device_domain - Use msi-map to find the relevant MSI domain 62082b9b424SMarc Zyngier * @dev: device for which the mapping is to be done. 62182b9b424SMarc Zyngier * @rid: Requester ID for the device. 62282b9b424SMarc Zyngier * 62382b9b424SMarc Zyngier * Walk up the device hierarchy looking for devices with a "msi-map" 62482b9b424SMarc Zyngier * property. 62582b9b424SMarc Zyngier * 62682b9b424SMarc Zyngier * Returns: the MSI domain for this device (or NULL on failure) 62782b9b424SMarc Zyngier */ 62882b9b424SMarc Zyngier struct irq_domain *of_msi_map_get_device_domain(struct device *dev, u32 rid) 62982b9b424SMarc Zyngier { 63082b9b424SMarc Zyngier struct device_node *np = NULL; 63182b9b424SMarc Zyngier 63282b9b424SMarc Zyngier __of_msi_map_rid(dev, &np, rid); 63314a0db3cSMarc Zyngier return irq_find_matching_host(np, DOMAIN_BUS_PCI_MSI); 63482b9b424SMarc Zyngier } 63582b9b424SMarc Zyngier 63682b9b424SMarc Zyngier /** 63748ae34fbSMarc Zyngier * of_msi_get_domain - Use msi-parent to find the relevant MSI domain 63848ae34fbSMarc Zyngier * @dev: device for which the domain is requested 63948ae34fbSMarc Zyngier * @np: device node for @dev 64048ae34fbSMarc Zyngier * @token: bus type for this domain 64148ae34fbSMarc Zyngier * 64248ae34fbSMarc Zyngier * Parse the msi-parent property (both the simple and the complex 64348ae34fbSMarc Zyngier * versions), and returns the corresponding MSI domain. 64448ae34fbSMarc Zyngier * 64548ae34fbSMarc Zyngier * Returns: the MSI domain for this device (or NULL on failure). 64648ae34fbSMarc Zyngier */ 64748ae34fbSMarc Zyngier struct irq_domain *of_msi_get_domain(struct device *dev, 64848ae34fbSMarc Zyngier struct device_node *np, 64948ae34fbSMarc Zyngier enum irq_domain_bus_token token) 65048ae34fbSMarc Zyngier { 65148ae34fbSMarc Zyngier struct device_node *msi_np; 65248ae34fbSMarc Zyngier struct irq_domain *d; 65348ae34fbSMarc Zyngier 65448ae34fbSMarc Zyngier /* Check for a single msi-parent property */ 65548ae34fbSMarc Zyngier msi_np = of_parse_phandle(np, "msi-parent", 0); 65648ae34fbSMarc Zyngier if (msi_np && !of_property_read_bool(msi_np, "#msi-cells")) { 65714a0db3cSMarc Zyngier d = irq_find_matching_host(msi_np, token); 65848ae34fbSMarc Zyngier if (!d) 65948ae34fbSMarc Zyngier of_node_put(msi_np); 66048ae34fbSMarc Zyngier return d; 66148ae34fbSMarc Zyngier } 66248ae34fbSMarc Zyngier 66348ae34fbSMarc Zyngier if (token == DOMAIN_BUS_PLATFORM_MSI) { 66448ae34fbSMarc Zyngier /* Check for the complex msi-parent version */ 66548ae34fbSMarc Zyngier struct of_phandle_args args; 66648ae34fbSMarc Zyngier int index = 0; 66748ae34fbSMarc Zyngier 66848ae34fbSMarc Zyngier while (!of_parse_phandle_with_args(np, "msi-parent", 66948ae34fbSMarc Zyngier "#msi-cells", 67048ae34fbSMarc Zyngier index, &args)) { 67114a0db3cSMarc Zyngier d = irq_find_matching_host(args.np, token); 67248ae34fbSMarc Zyngier if (d) 67348ae34fbSMarc Zyngier return d; 67448ae34fbSMarc Zyngier 67548ae34fbSMarc Zyngier of_node_put(args.np); 67648ae34fbSMarc Zyngier index++; 67748ae34fbSMarc Zyngier } 67848ae34fbSMarc Zyngier } 67948ae34fbSMarc Zyngier 68048ae34fbSMarc Zyngier return NULL; 68148ae34fbSMarc Zyngier } 68261c08240SMarc Zyngier 68361c08240SMarc Zyngier /** 68461c08240SMarc Zyngier * of_msi_configure - Set the msi_domain field of a device 68561c08240SMarc Zyngier * @dev: device structure to associate with an MSI irq domain 68661c08240SMarc Zyngier * @np: device node for that device 68761c08240SMarc Zyngier */ 68861c08240SMarc Zyngier void of_msi_configure(struct device *dev, struct device_node *np) 68961c08240SMarc Zyngier { 69061c08240SMarc Zyngier dev_set_msi_domain(dev, 69161c08240SMarc Zyngier of_msi_get_domain(dev, np, DOMAIN_BUS_PLATFORM_MSI)); 69261c08240SMarc Zyngier } 6935282c181SSinan Kaya EXPORT_SYMBOL_GPL(of_msi_configure); 694