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; 629a6b2e58SGrant Likely const __be32 *parp; 637dc2e113SGrant Likely 64b4bbb029SLinus Torvalds if (!of_node_get(child)) 657dc2e113SGrant Likely return NULL; 667dc2e113SGrant Likely 677dc2e113SGrant Likely do { 68b4bbb029SLinus Torvalds parp = of_get_property(child, "interrupt-parent", NULL); 697dc2e113SGrant Likely if (parp == NULL) 70b4bbb029SLinus Torvalds p = of_get_parent(child); 717dc2e113SGrant Likely else { 727dc2e113SGrant Likely if (of_irq_workarounds & OF_IMAP_NO_PHANDLE) 737dc2e113SGrant Likely p = of_node_get(of_irq_dflt_pic); 747dc2e113SGrant Likely else 759a6b2e58SGrant Likely p = of_find_node_by_phandle(be32_to_cpup(parp)); 767dc2e113SGrant Likely } 77b4bbb029SLinus Torvalds of_node_put(child); 78b4bbb029SLinus Torvalds child = p; 797dc2e113SGrant Likely } while (p && of_get_property(p, "#interrupt-cells", NULL) == NULL); 807dc2e113SGrant Likely 81b4bbb029SLinus Torvalds return p; 827dc2e113SGrant Likely } 834c3141e0SCarlo Caione EXPORT_SYMBOL_GPL(of_irq_find_parent); 847dc2e113SGrant Likely 857dc2e113SGrant Likely /** 860c02c800SGrant Likely * of_irq_parse_raw - Low level interrupt tree parsing 877dc2e113SGrant Likely * @parent: the device interrupt parent 8823616132SGrant Likely * @addr: address specifier (start of "reg" property of the device) in be32 format 8923616132SGrant Likely * @out_irq: structure of_irq updated by this function 907dc2e113SGrant Likely * 917dc2e113SGrant Likely * Returns 0 on success and a negative number on error 927dc2e113SGrant Likely * 937dc2e113SGrant Likely * This function is a low-level interrupt tree walking function. It 947dc2e113SGrant Likely * can be used to do a partial walk with synthetized reg and interrupts 957dc2e113SGrant Likely * properties, for example when resolving PCI interrupts when no device 9623616132SGrant Likely * node exist for the parent. It takes an interrupt specifier structure as 9723616132SGrant Likely * input, walks the tree looking for any interrupt-map properties, translates 9823616132SGrant Likely * the specifier for each map, and then returns the translated map. 997dc2e113SGrant Likely */ 10023616132SGrant Likely int of_irq_parse_raw(const __be32 *addr, struct of_phandle_args *out_irq) 1017dc2e113SGrant Likely { 1027dc2e113SGrant Likely struct device_node *ipar, *tnode, *old = NULL, *newpar = NULL; 103355e62f5SGrant Likely __be32 initial_match_array[MAX_PHANDLE_ARGS]; 10423616132SGrant Likely const __be32 *match_array = initial_match_array; 105355e62f5SGrant Likely const __be32 *tmp, *imap, *imask, dummy_imask[] = { [0 ... MAX_PHANDLE_ARGS] = ~0 }; 1067dc2e113SGrant Likely u32 intsize = 1, addrsize, newintsize = 0, newaddrsize = 0; 1077dc2e113SGrant Likely int imaplen, match, i; 1087dc2e113SGrant Likely 109624cfca5SGrant Likely #ifdef DEBUG 110624cfca5SGrant Likely of_print_phandle_args("of_irq_parse_raw: ", out_irq); 111624cfca5SGrant Likely #endif 1127dc2e113SGrant Likely 11323616132SGrant Likely ipar = of_node_get(out_irq->np); 1147dc2e113SGrant Likely 1157dc2e113SGrant Likely /* First get the #interrupt-cells property of the current cursor 1167dc2e113SGrant Likely * that tells us how to interpret the passed-in intspec. If there 1177dc2e113SGrant Likely * is none, we are nice and just walk up the tree 1187dc2e113SGrant Likely */ 1197dc2e113SGrant Likely do { 1207dc2e113SGrant Likely tmp = of_get_property(ipar, "#interrupt-cells", NULL); 1217dc2e113SGrant Likely if (tmp != NULL) { 122a7c194b0SRob Herring intsize = be32_to_cpu(*tmp); 1237dc2e113SGrant Likely break; 1247dc2e113SGrant Likely } 1257dc2e113SGrant Likely tnode = ipar; 1267dc2e113SGrant Likely ipar = of_irq_find_parent(ipar); 1277dc2e113SGrant Likely of_node_put(tnode); 1287dc2e113SGrant Likely } while (ipar); 1297dc2e113SGrant Likely if (ipar == NULL) { 1307dc2e113SGrant Likely pr_debug(" -> no parent found !\n"); 1317dc2e113SGrant Likely goto fail; 1327dc2e113SGrant Likely } 1337dc2e113SGrant Likely 1340c02c800SGrant Likely pr_debug("of_irq_parse_raw: ipar=%s, size=%d\n", of_node_full_name(ipar), intsize); 1357dc2e113SGrant Likely 13623616132SGrant Likely if (out_irq->args_count != intsize) 1377dc2e113SGrant Likely return -EINVAL; 1387dc2e113SGrant Likely 1397dc2e113SGrant Likely /* Look for this #address-cells. We have to implement the old linux 1407dc2e113SGrant Likely * trick of looking for the parent here as some device-trees rely on it 1417dc2e113SGrant Likely */ 1427dc2e113SGrant Likely old = of_node_get(ipar); 1437dc2e113SGrant Likely do { 1447dc2e113SGrant Likely tmp = of_get_property(old, "#address-cells", NULL); 1457dc2e113SGrant Likely tnode = of_get_parent(old); 1467dc2e113SGrant Likely of_node_put(old); 1477dc2e113SGrant Likely old = tnode; 1487dc2e113SGrant Likely } while (old && tmp == NULL); 1497dc2e113SGrant Likely of_node_put(old); 1507dc2e113SGrant Likely old = NULL; 151a7c194b0SRob Herring addrsize = (tmp == NULL) ? 2 : be32_to_cpu(*tmp); 1527dc2e113SGrant Likely 1537dc2e113SGrant Likely pr_debug(" -> addrsize=%d\n", addrsize); 1547dc2e113SGrant Likely 155355e62f5SGrant Likely /* Range check so that the temporary buffer doesn't overflow */ 156355e62f5SGrant Likely if (WARN_ON(addrsize + intsize > MAX_PHANDLE_ARGS)) 157355e62f5SGrant Likely goto fail; 158355e62f5SGrant Likely 15923616132SGrant Likely /* Precalculate the match array - this simplifies match loop */ 16023616132SGrant Likely for (i = 0; i < addrsize; i++) 16178119fd1SGrant Likely initial_match_array[i] = addr ? addr[i] : 0; 16223616132SGrant Likely for (i = 0; i < intsize; i++) 16323616132SGrant Likely initial_match_array[addrsize + i] = cpu_to_be32(out_irq->args[i]); 16423616132SGrant Likely 1657dc2e113SGrant Likely /* Now start the actual "proper" walk of the interrupt tree */ 1667dc2e113SGrant Likely while (ipar != NULL) { 1677dc2e113SGrant Likely /* Now check if cursor is an interrupt-controller and if it is 1687dc2e113SGrant Likely * then we are done 1697dc2e113SGrant Likely */ 1707dc2e113SGrant Likely if (of_get_property(ipar, "interrupt-controller", NULL) != 1717dc2e113SGrant Likely NULL) { 1727dc2e113SGrant Likely pr_debug(" -> got it !\n"); 1737dc2e113SGrant Likely return 0; 1747dc2e113SGrant Likely } 1757dc2e113SGrant Likely 17678119fd1SGrant Likely /* 17778119fd1SGrant Likely * interrupt-map parsing does not work without a reg 17878119fd1SGrant Likely * property when #address-cells != 0 17978119fd1SGrant Likely */ 18078119fd1SGrant Likely if (addrsize && !addr) { 18178119fd1SGrant Likely pr_debug(" -> no reg passed in when needed !\n"); 18278119fd1SGrant Likely goto fail; 18378119fd1SGrant Likely } 18478119fd1SGrant Likely 1857dc2e113SGrant Likely /* Now look for an interrupt-map */ 1867dc2e113SGrant Likely imap = of_get_property(ipar, "interrupt-map", &imaplen); 1877dc2e113SGrant Likely /* No interrupt map, check for an interrupt parent */ 1887dc2e113SGrant Likely if (imap == NULL) { 1897dc2e113SGrant Likely pr_debug(" -> no map, getting parent\n"); 1907dc2e113SGrant Likely newpar = of_irq_find_parent(ipar); 1917dc2e113SGrant Likely goto skiplevel; 1927dc2e113SGrant Likely } 1937dc2e113SGrant Likely imaplen /= sizeof(u32); 1947dc2e113SGrant Likely 1957dc2e113SGrant Likely /* Look for a mask */ 1967dc2e113SGrant Likely imask = of_get_property(ipar, "interrupt-map-mask", NULL); 19723616132SGrant Likely if (!imask) 19823616132SGrant Likely imask = dummy_imask; 1997dc2e113SGrant Likely 2007dc2e113SGrant Likely /* Parse interrupt-map */ 2017dc2e113SGrant Likely match = 0; 2027dc2e113SGrant Likely while (imaplen > (addrsize + intsize + 1) && !match) { 2037dc2e113SGrant Likely /* Compare specifiers */ 2047dc2e113SGrant Likely match = 1; 20523616132SGrant Likely for (i = 0; i < (addrsize + intsize); i++, imaplen--) 20674dac2edSTomasz Figa match &= !((match_array[i] ^ *imap++) & imask[i]); 2077dc2e113SGrant Likely 2087dc2e113SGrant Likely pr_debug(" -> match=%d (imaplen=%d)\n", match, imaplen); 2097dc2e113SGrant Likely 2107dc2e113SGrant Likely /* Get the interrupt parent */ 2117dc2e113SGrant Likely if (of_irq_workarounds & OF_IMAP_NO_PHANDLE) 2127dc2e113SGrant Likely newpar = of_node_get(of_irq_dflt_pic); 2137dc2e113SGrant Likely else 2149a6b2e58SGrant Likely newpar = of_find_node_by_phandle(be32_to_cpup(imap)); 2157dc2e113SGrant Likely imap++; 2167dc2e113SGrant Likely --imaplen; 2177dc2e113SGrant Likely 2187dc2e113SGrant Likely /* Check if not found */ 2197dc2e113SGrant Likely if (newpar == NULL) { 2207dc2e113SGrant Likely pr_debug(" -> imap parent not found !\n"); 2217dc2e113SGrant Likely goto fail; 2227dc2e113SGrant Likely } 2237dc2e113SGrant Likely 2241ca56e7dSPeter Crosthwaite if (!of_device_is_available(newpar)) 2251ca56e7dSPeter Crosthwaite match = 0; 2261ca56e7dSPeter Crosthwaite 2277dc2e113SGrant Likely /* Get #interrupt-cells and #address-cells of new 2287dc2e113SGrant Likely * parent 2297dc2e113SGrant Likely */ 2307dc2e113SGrant Likely tmp = of_get_property(newpar, "#interrupt-cells", NULL); 2317dc2e113SGrant Likely if (tmp == NULL) { 2327dc2e113SGrant Likely pr_debug(" -> parent lacks #interrupt-cells!\n"); 2337dc2e113SGrant Likely goto fail; 2347dc2e113SGrant Likely } 235a7c194b0SRob Herring newintsize = be32_to_cpu(*tmp); 2367dc2e113SGrant Likely tmp = of_get_property(newpar, "#address-cells", NULL); 237a7c194b0SRob Herring newaddrsize = (tmp == NULL) ? 0 : be32_to_cpu(*tmp); 2387dc2e113SGrant Likely 2397dc2e113SGrant Likely pr_debug(" -> newintsize=%d, newaddrsize=%d\n", 2407dc2e113SGrant Likely newintsize, newaddrsize); 2417dc2e113SGrant Likely 2427dc2e113SGrant Likely /* Check for malformed properties */ 243355e62f5SGrant Likely if (WARN_ON(newaddrsize + newintsize > MAX_PHANDLE_ARGS)) 244355e62f5SGrant Likely goto fail; 2457dc2e113SGrant Likely if (imaplen < (newaddrsize + newintsize)) 2467dc2e113SGrant Likely goto fail; 2477dc2e113SGrant Likely 2487dc2e113SGrant Likely imap += newaddrsize + newintsize; 2497dc2e113SGrant Likely imaplen -= newaddrsize + newintsize; 2507dc2e113SGrant Likely 2517dc2e113SGrant Likely pr_debug(" -> imaplen=%d\n", imaplen); 2527dc2e113SGrant Likely } 2537dc2e113SGrant Likely if (!match) 2547dc2e113SGrant Likely goto fail; 2557dc2e113SGrant Likely 25623616132SGrant Likely /* 25723616132SGrant Likely * Successfully parsed an interrrupt-map translation; copy new 25823616132SGrant Likely * interrupt specifier into the out_irq structure 25923616132SGrant Likely */ 26023616132SGrant Likely match_array = imap - newaddrsize - newintsize; 26123616132SGrant Likely for (i = 0; i < newintsize; i++) 26223616132SGrant Likely out_irq->args[i] = be32_to_cpup(imap - newintsize + i); 26323616132SGrant Likely out_irq->args_count = intsize = newintsize; 2647dc2e113SGrant Likely addrsize = newaddrsize; 2657dc2e113SGrant Likely 2667dc2e113SGrant Likely skiplevel: 2677dc2e113SGrant Likely /* Iterate again with new parent */ 268d23b2516SJeremy Linton out_irq->np = newpar; 26974a7f084SGrant Likely pr_debug(" -> new parent: %s\n", of_node_full_name(newpar)); 2707dc2e113SGrant Likely of_node_put(ipar); 2717dc2e113SGrant Likely ipar = newpar; 2727dc2e113SGrant Likely newpar = NULL; 2737dc2e113SGrant Likely } 2747dc2e113SGrant Likely fail: 2757dc2e113SGrant Likely of_node_put(ipar); 2767dc2e113SGrant Likely of_node_put(newpar); 2777dc2e113SGrant Likely 2787dc2e113SGrant Likely return -EINVAL; 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; 295d2f71839SGrant Likely const __be32 *intspec, *tmp, *addr; 2967dc2e113SGrant Likely u32 intsize, intlen; 297d7c14605SLaurent Pinchart int i, res; 2987dc2e113SGrant Likely 2990c02c800SGrant Likely pr_debug("of_irq_parse_one: dev=%s, index=%d\n", of_node_full_name(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 314a9ecdc0fSFlorian Fainelli /* Get the interrupts property */ 315a9ecdc0fSFlorian Fainelli intspec = of_get_property(device, "interrupts", &intlen); 316a9ecdc0fSFlorian Fainelli if (intspec == NULL) 317a9ecdc0fSFlorian Fainelli return -EINVAL; 318a9ecdc0fSFlorian Fainelli 319d2f71839SGrant Likely intlen /= sizeof(*intspec); 3207dc2e113SGrant Likely 321d2f71839SGrant Likely pr_debug(" intspec=%d intlen=%d\n", be32_to_cpup(intspec), intlen); 3227dc2e113SGrant Likely 3237dc2e113SGrant Likely /* Look for the interrupt parent. */ 3247dc2e113SGrant Likely p = of_irq_find_parent(device); 3257dc2e113SGrant Likely if (p == NULL) 3267dc2e113SGrant Likely return -EINVAL; 3277dc2e113SGrant Likely 3287dc2e113SGrant Likely /* Get size of interrupt specifier */ 3297dc2e113SGrant Likely tmp = of_get_property(p, "#interrupt-cells", NULL); 330d7c14605SLaurent Pinchart if (tmp == NULL) { 331d7c14605SLaurent Pinchart res = -EINVAL; 3327dc2e113SGrant Likely goto out; 333d7c14605SLaurent Pinchart } 334a7c194b0SRob Herring intsize = be32_to_cpu(*tmp); 3357dc2e113SGrant Likely 3367dc2e113SGrant Likely pr_debug(" intsize=%d intlen=%d\n", intsize, intlen); 3377dc2e113SGrant Likely 3387dc2e113SGrant Likely /* Check index */ 339d7c14605SLaurent Pinchart if ((index + 1) * intsize > intlen) { 340d7c14605SLaurent Pinchart res = -EINVAL; 3417dc2e113SGrant Likely goto out; 342d7c14605SLaurent Pinchart } 3437dc2e113SGrant Likely 34423616132SGrant Likely /* Copy intspec into irq structure */ 34523616132SGrant Likely intspec += index * intsize; 34623616132SGrant Likely out_irq->np = p; 34723616132SGrant Likely out_irq->args_count = intsize; 34823616132SGrant Likely for (i = 0; i < intsize; i++) 34923616132SGrant Likely out_irq->args[i] = be32_to_cpup(intspec++); 35023616132SGrant Likely 35123616132SGrant Likely /* Check if there are any interrupt-map translations to process */ 35223616132SGrant Likely res = of_irq_parse_raw(addr, out_irq); 3537dc2e113SGrant Likely out: 3547dc2e113SGrant Likely of_node_put(p); 3557dc2e113SGrant Likely return res; 3567dc2e113SGrant Likely } 3570c02c800SGrant Likely EXPORT_SYMBOL_GPL(of_irq_parse_one); 3587dc2e113SGrant Likely 3597dc2e113SGrant Likely /** 3607dc2e113SGrant Likely * of_irq_to_resource - Decode a node's IRQ and return it as a resource 3617dc2e113SGrant Likely * @dev: pointer to device tree node 3627dc2e113SGrant Likely * @index: zero-based index of the irq 3637dc2e113SGrant Likely * @r: pointer to resource structure to return result into. 3647dc2e113SGrant Likely */ 3657dc2e113SGrant Likely int of_irq_to_resource(struct device_node *dev, int index, struct resource *r) 3667dc2e113SGrant Likely { 3677dc2e113SGrant Likely int irq = irq_of_parse_and_map(dev, index); 3687dc2e113SGrant Likely 3697dc2e113SGrant Likely /* Only dereference the resource if both the 3707dc2e113SGrant Likely * resource and the irq are valid. */ 37177a7300aSAnton Vorontsov if (r && irq) { 372661db794SBenoit Cousson const char *name = NULL; 373661db794SBenoit Cousson 374cf9e2368SSebastian Andrzej Siewior memset(r, 0, sizeof(*r)); 375661db794SBenoit Cousson /* 376ae107d06SGeert Uytterhoeven * Get optional "interrupt-names" property to add a name 377661db794SBenoit Cousson * to the resource. 378661db794SBenoit Cousson */ 379661db794SBenoit Cousson of_property_read_string_index(dev, "interrupt-names", index, 380661db794SBenoit Cousson &name); 381661db794SBenoit Cousson 3827dc2e113SGrant Likely r->start = r->end = irq; 3834a43d686STomasz Figa r->flags = IORESOURCE_IRQ | irqd_get_trigger_type(irq_get_irq_data(irq)); 3848804827bSGrant Likely r->name = name ? name : of_node_full_name(dev); 3857dc2e113SGrant Likely } 3867dc2e113SGrant Likely 3877dc2e113SGrant Likely return irq; 3887dc2e113SGrant Likely } 3897dc2e113SGrant Likely EXPORT_SYMBOL_GPL(of_irq_to_resource); 39052f6537cSAndres Salomon 39152f6537cSAndres Salomon /** 39239935466SSergei Shtylyov * of_irq_get - Decode a node's IRQ and return it as a Linux IRQ number 3939ec36cafSRob Herring * @dev: pointer to device tree node 39439935466SSergei Shtylyov * @index: zero-based index of the IRQ 3959ec36cafSRob Herring * 39639935466SSergei Shtylyov * Returns Linux IRQ number on success, or 0 on the IRQ mapping failure, or 39739935466SSergei Shtylyov * -EPROBE_DEFER if the IRQ domain is not yet created, or error code in case 39839935466SSergei Shtylyov * of any other failure. 3999ec36cafSRob Herring */ 4009ec36cafSRob Herring int of_irq_get(struct device_node *dev, int index) 4019ec36cafSRob Herring { 4029ec36cafSRob Herring int rc; 4039ec36cafSRob Herring struct of_phandle_args oirq; 4049ec36cafSRob Herring struct irq_domain *domain; 4059ec36cafSRob Herring 4069ec36cafSRob Herring rc = of_irq_parse_one(dev, index, &oirq); 4079ec36cafSRob Herring if (rc) 4089ec36cafSRob Herring return rc; 4099ec36cafSRob Herring 4109ec36cafSRob Herring domain = irq_find_host(oirq.np); 4119ec36cafSRob Herring if (!domain) 4129ec36cafSRob Herring return -EPROBE_DEFER; 4139ec36cafSRob Herring 4149ec36cafSRob Herring return irq_create_of_mapping(&oirq); 4159ec36cafSRob Herring } 4169eb08fb3SLaurent Pinchart EXPORT_SYMBOL_GPL(of_irq_get); 4179ec36cafSRob Herring 4189ec36cafSRob Herring /** 41939935466SSergei Shtylyov * of_irq_get_byname - Decode a node's IRQ and return it as a Linux IRQ number 420ad69674eSGrygorii Strashko * @dev: pointer to device tree node 42139935466SSergei Shtylyov * @name: IRQ name 422ad69674eSGrygorii Strashko * 42339935466SSergei Shtylyov * Returns Linux IRQ number on success, or 0 on the IRQ mapping failure, or 42439935466SSergei Shtylyov * -EPROBE_DEFER if the IRQ domain is not yet created, or error code in case 42539935466SSergei Shtylyov * of any other failure. 426ad69674eSGrygorii Strashko */ 427ad69674eSGrygorii Strashko int of_irq_get_byname(struct device_node *dev, const char *name) 428ad69674eSGrygorii Strashko { 429ad69674eSGrygorii Strashko int index; 430ad69674eSGrygorii Strashko 431ad69674eSGrygorii Strashko if (unlikely(!name)) 432ad69674eSGrygorii Strashko return -EINVAL; 433ad69674eSGrygorii Strashko 434ad69674eSGrygorii Strashko index = of_property_match_string(dev, "interrupt-names", name); 435ad69674eSGrygorii Strashko if (index < 0) 436ad69674eSGrygorii Strashko return index; 437ad69674eSGrygorii Strashko 438ad69674eSGrygorii Strashko return of_irq_get(dev, index); 439ad69674eSGrygorii Strashko } 4406602c452SDmitry Torokhov EXPORT_SYMBOL_GPL(of_irq_get_byname); 441ad69674eSGrygorii Strashko 442ad69674eSGrygorii Strashko /** 44352f6537cSAndres Salomon * of_irq_count - Count the number of IRQs a node uses 44452f6537cSAndres Salomon * @dev: pointer to device tree node 44552f6537cSAndres Salomon */ 44652f6537cSAndres Salomon int of_irq_count(struct device_node *dev) 44752f6537cSAndres Salomon { 4483da52787SThierry Reding struct of_phandle_args irq; 44952f6537cSAndres Salomon int nr = 0; 45052f6537cSAndres Salomon 4513da52787SThierry Reding while (of_irq_parse_one(dev, nr, &irq) == 0) 45252f6537cSAndres Salomon nr++; 45352f6537cSAndres Salomon 45452f6537cSAndres Salomon return nr; 45552f6537cSAndres Salomon } 45652f6537cSAndres Salomon 45752f6537cSAndres Salomon /** 45852f6537cSAndres Salomon * of_irq_to_resource_table - Fill in resource table with node's IRQ info 45952f6537cSAndres Salomon * @dev: pointer to device tree node 46052f6537cSAndres Salomon * @res: array of resources to fill in 46152f6537cSAndres Salomon * @nr_irqs: the number of IRQs (and upper bound for num of @res elements) 46252f6537cSAndres Salomon * 46352f6537cSAndres Salomon * Returns the size of the filled in table (up to @nr_irqs). 46452f6537cSAndres Salomon */ 46552f6537cSAndres Salomon int of_irq_to_resource_table(struct device_node *dev, struct resource *res, 46652f6537cSAndres Salomon int nr_irqs) 46752f6537cSAndres Salomon { 46852f6537cSAndres Salomon int i; 46952f6537cSAndres Salomon 47052f6537cSAndres Salomon for (i = 0; i < nr_irqs; i++, res++) 47177a7300aSAnton Vorontsov if (!of_irq_to_resource(dev, i, res)) 47252f6537cSAndres Salomon break; 47352f6537cSAndres Salomon 47452f6537cSAndres Salomon return i; 47552f6537cSAndres Salomon } 476a4f8bf22SJohn Crispin EXPORT_SYMBOL_GPL(of_irq_to_resource_table); 477c71a54b0SRob Herring 47848a9b733SGeert Uytterhoeven struct of_intc_desc { 479c71a54b0SRob Herring struct list_head list; 480264041e3SMasahiro Yamada of_irq_init_cb_t irq_init_cb; 481c71a54b0SRob Herring struct device_node *dev; 482c71a54b0SRob Herring struct device_node *interrupt_parent; 483c71a54b0SRob Herring }; 484c71a54b0SRob Herring 485c71a54b0SRob Herring /** 486c71a54b0SRob Herring * of_irq_init - Scan and init matching interrupt controllers in DT 487c71a54b0SRob Herring * @matches: 0 terminated array of nodes to match and init function to call 488c71a54b0SRob Herring * 489c71a54b0SRob Herring * This function scans the device tree for matching interrupt controller nodes, 490c71a54b0SRob Herring * and calls their initialization functions in order with parents first. 491c71a54b0SRob Herring */ 492c71a54b0SRob Herring void __init of_irq_init(const struct of_device_id *matches) 493c71a54b0SRob Herring { 494264041e3SMasahiro Yamada const struct of_device_id *match; 495c71a54b0SRob Herring struct device_node *np, *parent = NULL; 49648a9b733SGeert Uytterhoeven struct of_intc_desc *desc, *temp_desc; 497c71a54b0SRob Herring struct list_head intc_desc_list, intc_parent_list; 498c71a54b0SRob Herring 499c71a54b0SRob Herring INIT_LIST_HEAD(&intc_desc_list); 500c71a54b0SRob Herring INIT_LIST_HEAD(&intc_parent_list); 501c71a54b0SRob Herring 502264041e3SMasahiro Yamada for_each_matching_node_and_match(np, matches, &match) { 503bf49be02SPeter Crosthwaite if (!of_find_property(np, "interrupt-controller", NULL) || 504bf49be02SPeter Crosthwaite !of_device_is_available(np)) 505c71a54b0SRob Herring continue; 506264041e3SMasahiro Yamada 507264041e3SMasahiro Yamada if (WARN(!match->data, "of_irq_init: no init function for %s\n", 508264041e3SMasahiro Yamada match->compatible)) 509264041e3SMasahiro Yamada continue; 510264041e3SMasahiro Yamada 511c71a54b0SRob Herring /* 51248a9b733SGeert Uytterhoeven * Here, we allocate and populate an of_intc_desc with the node 513c71a54b0SRob Herring * pointer, interrupt-parent device_node etc. 514c71a54b0SRob Herring */ 515c71a54b0SRob Herring desc = kzalloc(sizeof(*desc), GFP_KERNEL); 5168363ccb9SJulia Lawall if (WARN_ON(!desc)) { 5178363ccb9SJulia Lawall of_node_put(np); 518c71a54b0SRob Herring goto err; 5198363ccb9SJulia Lawall } 520c71a54b0SRob Herring 521264041e3SMasahiro Yamada desc->irq_init_cb = match->data; 5228363ccb9SJulia Lawall desc->dev = of_node_get(np); 523c71a54b0SRob Herring desc->interrupt_parent = of_irq_find_parent(np); 524d7fb6d0aSRob Herring if (desc->interrupt_parent == np) 525d7fb6d0aSRob Herring desc->interrupt_parent = NULL; 526c71a54b0SRob Herring list_add_tail(&desc->list, &intc_desc_list); 527c71a54b0SRob Herring } 528c71a54b0SRob Herring 529c71a54b0SRob Herring /* 530c71a54b0SRob Herring * The root irq controller is the one without an interrupt-parent. 531c71a54b0SRob Herring * That one goes first, followed by the controllers that reference it, 532c71a54b0SRob Herring * followed by the ones that reference the 2nd level controllers, etc. 533c71a54b0SRob Herring */ 534c71a54b0SRob Herring while (!list_empty(&intc_desc_list)) { 535c71a54b0SRob Herring /* 536c71a54b0SRob Herring * Process all controllers with the current 'parent'. 537c71a54b0SRob Herring * First pass will be looking for NULL as the parent. 538c71a54b0SRob Herring * The assumption is that NULL parent means a root controller. 539c71a54b0SRob Herring */ 540c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) { 541c71a54b0SRob Herring int ret; 542c71a54b0SRob Herring 543c71a54b0SRob Herring if (desc->interrupt_parent != parent) 544c71a54b0SRob Herring continue; 545c71a54b0SRob Herring 546c71a54b0SRob Herring list_del(&desc->list); 547c71a54b0SRob Herring 548e55aeb6bSPhilipp Zabel of_node_set_flag(desc->dev, OF_POPULATED); 549e55aeb6bSPhilipp Zabel 550264041e3SMasahiro Yamada pr_debug("of_irq_init: init %s (%p), parent %p\n", 551264041e3SMasahiro Yamada desc->dev->full_name, 552c71a54b0SRob Herring desc->dev, desc->interrupt_parent); 553264041e3SMasahiro Yamada ret = desc->irq_init_cb(desc->dev, 554264041e3SMasahiro Yamada desc->interrupt_parent); 555c71a54b0SRob Herring if (ret) { 556e55aeb6bSPhilipp Zabel of_node_clear_flag(desc->dev, OF_POPULATED); 557c71a54b0SRob Herring kfree(desc); 558c71a54b0SRob Herring continue; 559c71a54b0SRob Herring } 560c71a54b0SRob Herring 561c71a54b0SRob Herring /* 562c71a54b0SRob Herring * This one is now set up; add it to the parent list so 563c71a54b0SRob Herring * its children can get processed in a subsequent pass. 564c71a54b0SRob Herring */ 565c71a54b0SRob Herring list_add_tail(&desc->list, &intc_parent_list); 566c71a54b0SRob Herring } 567c71a54b0SRob Herring 568c71a54b0SRob Herring /* Get the next pending parent that might have children */ 569c0cdfaa0SAxel Lin desc = list_first_entry_or_null(&intc_parent_list, 570c0cdfaa0SAxel Lin typeof(*desc), list); 571c0cdfaa0SAxel Lin if (!desc) { 572c71a54b0SRob Herring pr_err("of_irq_init: children remain, but no parents\n"); 573c71a54b0SRob Herring break; 574c71a54b0SRob Herring } 575c71a54b0SRob Herring list_del(&desc->list); 576c71a54b0SRob Herring parent = desc->dev; 577c71a54b0SRob Herring kfree(desc); 578c71a54b0SRob Herring } 579c71a54b0SRob Herring 580c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_parent_list, list) { 581c71a54b0SRob Herring list_del(&desc->list); 582c71a54b0SRob Herring kfree(desc); 583c71a54b0SRob Herring } 584c71a54b0SRob Herring err: 585c71a54b0SRob Herring list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) { 586c71a54b0SRob Herring list_del(&desc->list); 5878363ccb9SJulia Lawall of_node_put(desc->dev); 588c71a54b0SRob Herring kfree(desc); 589c71a54b0SRob Herring } 590c71a54b0SRob Herring } 591c706c239SMarc Zyngier 592a251b263SMarc Zyngier static u32 __of_msi_map_rid(struct device *dev, struct device_node **np, 593a251b263SMarc Zyngier u32 rid_in) 5948db02d8bSDavid Daney { 5958db02d8bSDavid Daney struct device *parent_dev; 5968db02d8bSDavid Daney u32 rid_out = rid_in; 5978db02d8bSDavid Daney 5988db02d8bSDavid Daney /* 5998db02d8bSDavid Daney * Walk up the device parent links looking for one with a 6008db02d8bSDavid Daney * "msi-map" property. 6018db02d8bSDavid Daney */ 602987068fcSRobin Murphy for (parent_dev = dev; parent_dev; parent_dev = parent_dev->parent) 603987068fcSRobin Murphy if (!of_pci_map_rid(parent_dev->of_node, rid_in, "msi-map", 604987068fcSRobin Murphy "msi-map-mask", np, &rid_out)) 6058db02d8bSDavid Daney break; 6068db02d8bSDavid Daney return rid_out; 6078db02d8bSDavid Daney } 60848ae34fbSMarc Zyngier 609a251b263SMarc Zyngier /** 610a251b263SMarc Zyngier * of_msi_map_rid - Map a MSI requester ID for a device. 611a251b263SMarc Zyngier * @dev: device for which the mapping is to be done. 612a251b263SMarc Zyngier * @msi_np: device node of the expected msi controller. 613a251b263SMarc Zyngier * @rid_in: unmapped MSI requester ID for the device. 614a251b263SMarc Zyngier * 615a251b263SMarc Zyngier * Walk up the device hierarchy looking for devices with a "msi-map" 616a251b263SMarc Zyngier * property. If found, apply the mapping to @rid_in. 617a251b263SMarc Zyngier * 618a251b263SMarc Zyngier * Returns the mapped MSI requester ID. 619a251b263SMarc Zyngier */ 620a251b263SMarc Zyngier u32 of_msi_map_rid(struct device *dev, struct device_node *msi_np, u32 rid_in) 621a251b263SMarc Zyngier { 622a251b263SMarc Zyngier return __of_msi_map_rid(dev, &msi_np, rid_in); 623a251b263SMarc Zyngier } 624a251b263SMarc Zyngier 62548ae34fbSMarc Zyngier /** 62682b9b424SMarc Zyngier * of_msi_map_get_device_domain - Use msi-map to find the relevant MSI domain 62782b9b424SMarc Zyngier * @dev: device for which the mapping is to be done. 62882b9b424SMarc Zyngier * @rid: Requester ID for the device. 62982b9b424SMarc Zyngier * 63082b9b424SMarc Zyngier * Walk up the device hierarchy looking for devices with a "msi-map" 63182b9b424SMarc Zyngier * property. 63282b9b424SMarc Zyngier * 63382b9b424SMarc Zyngier * Returns: the MSI domain for this device (or NULL on failure) 63482b9b424SMarc Zyngier */ 63582b9b424SMarc Zyngier struct irq_domain *of_msi_map_get_device_domain(struct device *dev, u32 rid) 63682b9b424SMarc Zyngier { 63782b9b424SMarc Zyngier struct device_node *np = NULL; 63882b9b424SMarc Zyngier 63982b9b424SMarc Zyngier __of_msi_map_rid(dev, &np, rid); 64014a0db3cSMarc Zyngier return irq_find_matching_host(np, DOMAIN_BUS_PCI_MSI); 64182b9b424SMarc Zyngier } 64282b9b424SMarc Zyngier 64382b9b424SMarc Zyngier /** 64448ae34fbSMarc Zyngier * of_msi_get_domain - Use msi-parent to find the relevant MSI domain 64548ae34fbSMarc Zyngier * @dev: device for which the domain is requested 64648ae34fbSMarc Zyngier * @np: device node for @dev 64748ae34fbSMarc Zyngier * @token: bus type for this domain 64848ae34fbSMarc Zyngier * 64948ae34fbSMarc Zyngier * Parse the msi-parent property (both the simple and the complex 65048ae34fbSMarc Zyngier * versions), and returns the corresponding MSI domain. 65148ae34fbSMarc Zyngier * 65248ae34fbSMarc Zyngier * Returns: the MSI domain for this device (or NULL on failure). 65348ae34fbSMarc Zyngier */ 65448ae34fbSMarc Zyngier struct irq_domain *of_msi_get_domain(struct device *dev, 65548ae34fbSMarc Zyngier struct device_node *np, 65648ae34fbSMarc Zyngier enum irq_domain_bus_token token) 65748ae34fbSMarc Zyngier { 65848ae34fbSMarc Zyngier struct device_node *msi_np; 65948ae34fbSMarc Zyngier struct irq_domain *d; 66048ae34fbSMarc Zyngier 66148ae34fbSMarc Zyngier /* Check for a single msi-parent property */ 66248ae34fbSMarc Zyngier msi_np = of_parse_phandle(np, "msi-parent", 0); 66348ae34fbSMarc Zyngier if (msi_np && !of_property_read_bool(msi_np, "#msi-cells")) { 66414a0db3cSMarc Zyngier d = irq_find_matching_host(msi_np, token); 66548ae34fbSMarc Zyngier if (!d) 66648ae34fbSMarc Zyngier of_node_put(msi_np); 66748ae34fbSMarc Zyngier return d; 66848ae34fbSMarc Zyngier } 66948ae34fbSMarc Zyngier 67048ae34fbSMarc Zyngier if (token == DOMAIN_BUS_PLATFORM_MSI) { 67148ae34fbSMarc Zyngier /* Check for the complex msi-parent version */ 67248ae34fbSMarc Zyngier struct of_phandle_args args; 67348ae34fbSMarc Zyngier int index = 0; 67448ae34fbSMarc Zyngier 67548ae34fbSMarc Zyngier while (!of_parse_phandle_with_args(np, "msi-parent", 67648ae34fbSMarc Zyngier "#msi-cells", 67748ae34fbSMarc Zyngier index, &args)) { 67814a0db3cSMarc Zyngier d = irq_find_matching_host(args.np, token); 67948ae34fbSMarc Zyngier if (d) 68048ae34fbSMarc Zyngier return d; 68148ae34fbSMarc Zyngier 68248ae34fbSMarc Zyngier of_node_put(args.np); 68348ae34fbSMarc Zyngier index++; 68448ae34fbSMarc Zyngier } 68548ae34fbSMarc Zyngier } 68648ae34fbSMarc Zyngier 68748ae34fbSMarc Zyngier return NULL; 68848ae34fbSMarc Zyngier } 68961c08240SMarc Zyngier 69061c08240SMarc Zyngier /** 69161c08240SMarc Zyngier * of_msi_configure - Set the msi_domain field of a device 69261c08240SMarc Zyngier * @dev: device structure to associate with an MSI irq domain 69361c08240SMarc Zyngier * @np: device node for that device 69461c08240SMarc Zyngier */ 69561c08240SMarc Zyngier void of_msi_configure(struct device *dev, struct device_node *np) 69661c08240SMarc Zyngier { 69761c08240SMarc Zyngier dev_set_msi_domain(dev, 69861c08240SMarc Zyngier of_msi_get_domain(dev, np, DOMAIN_BUS_PLATFORM_MSI)); 69961c08240SMarc Zyngier } 7005282c181SSinan Kaya EXPORT_SYMBOL_GPL(of_msi_configure); 701