irq.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504
  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. #include <linux/errno.h>
  21. #include <linux/list.h>
  22. #include <linux/module.h>
  23. #include <linux/of.h>
  24. #include <linux/of_irq.h>
  25. #include <linux/string.h>
  26. #include <linux/slab.h>
  27. /**
  28. * irq_of_parse_and_map - Parse and map an interrupt into linux virq space
  29. * @device: Device node of the device whose interrupt is to be mapped
  30. * @index: Index of the interrupt to map
  31. *
  32. * This function is a wrapper that chains of_irq_map_one() and
  33. * irq_create_of_mapping() to make things easier to callers
  34. */
  35. unsigned int irq_of_parse_and_map(struct device_node *dev, int index)
  36. {
  37. struct of_irq oirq;
  38. if (of_irq_map_one(dev, index, &oirq))
  39. return 0;
  40. return irq_create_of_mapping(oirq.controller, oirq.specifier,
  41. oirq.size);
  42. }
  43. EXPORT_SYMBOL_GPL(irq_of_parse_and_map);
  44. /**
  45. * of_irq_find_parent - Given a device node, find its interrupt parent node
  46. * @child: pointer to device node
  47. *
  48. * Returns a pointer to the interrupt parent node, or NULL if the interrupt
  49. * parent could not be determined.
  50. */
  51. struct device_node *of_irq_find_parent(struct device_node *child)
  52. {
  53. struct device_node *p;
  54. const __be32 *parp;
  55. if (!of_node_get(child))
  56. return NULL;
  57. do {
  58. parp = of_get_property(child, "interrupt-parent", NULL);
  59. if (parp == NULL)
  60. p = of_get_parent(child);
  61. else {
  62. if (of_irq_workarounds & OF_IMAP_NO_PHANDLE)
  63. p = of_node_get(of_irq_dflt_pic);
  64. else
  65. p = of_find_node_by_phandle(be32_to_cpup(parp));
  66. }
  67. of_node_put(child);
  68. child = p;
  69. } while (p && of_get_property(p, "#interrupt-cells", NULL) == NULL);
  70. return p;
  71. }
  72. /**
  73. * of_irq_map_raw - Low level interrupt tree parsing
  74. * @parent: the device interrupt parent
  75. * @intspec: interrupt specifier ("interrupts" property of the device)
  76. * @ointsize: size of the passed in interrupt specifier
  77. * @addr: address specifier (start of "reg" property of the device)
  78. * @out_irq: structure of_irq filled by this function
  79. *
  80. * Returns 0 on success and a negative number on error
  81. *
  82. * This function is a low-level interrupt tree walking function. It
  83. * can be used to do a partial walk with synthetized reg and interrupts
  84. * properties, for example when resolving PCI interrupts when no device
  85. * node exist for the parent.
  86. */
  87. int of_irq_map_raw(struct device_node *parent, const __be32 *intspec,
  88. u32 ointsize, const __be32 *addr, struct of_irq *out_irq)
  89. {
  90. struct device_node *ipar, *tnode, *old = NULL, *newpar = NULL;
  91. const __be32 *tmp, *imap, *imask;
  92. u32 intsize = 1, addrsize, newintsize = 0, newaddrsize = 0;
  93. int imaplen, match, i;
  94. pr_debug("of_irq_map_raw: par=%s,intspec=[0x%08x 0x%08x...],ointsize=%d\n",
  95. parent->full_name, be32_to_cpup(intspec),
  96. be32_to_cpup(intspec + 1), ointsize);
  97. ipar = of_node_get(parent);
  98. /* First get the #interrupt-cells property of the current cursor
  99. * that tells us how to interpret the passed-in intspec. If there
  100. * is none, we are nice and just walk up the tree
  101. */
  102. do {
  103. tmp = of_get_property(ipar, "#interrupt-cells", NULL);
  104. if (tmp != NULL) {
  105. intsize = be32_to_cpu(*tmp);
  106. break;
  107. }
  108. tnode = ipar;
  109. ipar = of_irq_find_parent(ipar);
  110. of_node_put(tnode);
  111. } while (ipar);
  112. if (ipar == NULL) {
  113. pr_debug(" -> no parent found !\n");
  114. goto fail;
  115. }
  116. pr_debug("of_irq_map_raw: ipar=%s, size=%d\n", ipar->full_name, intsize);
  117. if (ointsize != intsize)
  118. return -EINVAL;
  119. /* Look for this #address-cells. We have to implement the old linux
  120. * trick of looking for the parent here as some device-trees rely on it
  121. */
  122. old = of_node_get(ipar);
  123. do {
  124. tmp = of_get_property(old, "#address-cells", NULL);
  125. tnode = of_get_parent(old);
  126. of_node_put(old);
  127. old = tnode;
  128. } while (old && tmp == NULL);
  129. of_node_put(old);
  130. old = NULL;
  131. addrsize = (tmp == NULL) ? 2 : be32_to_cpu(*tmp);
  132. pr_debug(" -> addrsize=%d\n", addrsize);
  133. /* Now start the actual "proper" walk of the interrupt tree */
  134. while (ipar != NULL) {
  135. /* Now check if cursor is an interrupt-controller and if it is
  136. * then we are done
  137. */
  138. if (of_get_property(ipar, "interrupt-controller", NULL) !=
  139. NULL) {
  140. pr_debug(" -> got it !\n");
  141. for (i = 0; i < intsize; i++)
  142. out_irq->specifier[i] =
  143. of_read_number(intspec +i, 1);
  144. out_irq->size = intsize;
  145. out_irq->controller = ipar;
  146. of_node_put(old);
  147. return 0;
  148. }
  149. /* Now look for an interrupt-map */
  150. imap = of_get_property(ipar, "interrupt-map", &imaplen);
  151. /* No interrupt map, check for an interrupt parent */
  152. if (imap == NULL) {
  153. pr_debug(" -> no map, getting parent\n");
  154. newpar = of_irq_find_parent(ipar);
  155. goto skiplevel;
  156. }
  157. imaplen /= sizeof(u32);
  158. /* Look for a mask */
  159. imask = of_get_property(ipar, "interrupt-map-mask", NULL);
  160. /* If we were passed no "reg" property and we attempt to parse
  161. * an interrupt-map, then #address-cells must be 0.
  162. * Fail if it's not.
  163. */
  164. if (addr == NULL && addrsize != 0) {
  165. pr_debug(" -> no reg passed in when needed !\n");
  166. goto fail;
  167. }
  168. /* Parse interrupt-map */
  169. match = 0;
  170. while (imaplen > (addrsize + intsize + 1) && !match) {
  171. /* Compare specifiers */
  172. match = 1;
  173. for (i = 0; i < addrsize && match; ++i) {
  174. __be32 mask = imask ? imask[i]
  175. : cpu_to_be32(0xffffffffu);
  176. match = ((addr[i] ^ imap[i]) & mask) == 0;
  177. }
  178. for (; i < (addrsize + intsize) && match; ++i) {
  179. __be32 mask = imask ? imask[i]
  180. : cpu_to_be32(0xffffffffu);
  181. match =
  182. ((intspec[i-addrsize] ^ imap[i]) & mask) == 0;
  183. }
  184. imap += addrsize + intsize;
  185. imaplen -= addrsize + intsize;
  186. pr_debug(" -> match=%d (imaplen=%d)\n", match, imaplen);
  187. /* Get the interrupt parent */
  188. if (of_irq_workarounds & OF_IMAP_NO_PHANDLE)
  189. newpar = of_node_get(of_irq_dflt_pic);
  190. else
  191. newpar = of_find_node_by_phandle(be32_to_cpup(imap));
  192. imap++;
  193. --imaplen;
  194. /* Check if not found */
  195. if (newpar == NULL) {
  196. pr_debug(" -> imap parent not found !\n");
  197. goto fail;
  198. }
  199. /* Get #interrupt-cells and #address-cells of new
  200. * parent
  201. */
  202. tmp = of_get_property(newpar, "#interrupt-cells", NULL);
  203. if (tmp == NULL) {
  204. pr_debug(" -> parent lacks #interrupt-cells!\n");
  205. goto fail;
  206. }
  207. newintsize = be32_to_cpu(*tmp);
  208. tmp = of_get_property(newpar, "#address-cells", NULL);
  209. newaddrsize = (tmp == NULL) ? 0 : be32_to_cpu(*tmp);
  210. pr_debug(" -> newintsize=%d, newaddrsize=%d\n",
  211. newintsize, newaddrsize);
  212. /* Check for malformed properties */
  213. if (imaplen < (newaddrsize + newintsize))
  214. goto fail;
  215. imap += newaddrsize + newintsize;
  216. imaplen -= newaddrsize + newintsize;
  217. pr_debug(" -> imaplen=%d\n", imaplen);
  218. }
  219. if (!match)
  220. goto fail;
  221. of_node_put(old);
  222. old = of_node_get(newpar);
  223. addrsize = newaddrsize;
  224. intsize = newintsize;
  225. intspec = imap - intsize;
  226. addr = intspec - addrsize;
  227. skiplevel:
  228. /* Iterate again with new parent */
  229. pr_debug(" -> new parent: %s\n", newpar ? newpar->full_name : "<>");
  230. of_node_put(ipar);
  231. ipar = newpar;
  232. newpar = NULL;
  233. }
  234. fail:
  235. of_node_put(ipar);
  236. of_node_put(old);
  237. of_node_put(newpar);
  238. return -EINVAL;
  239. }
  240. EXPORT_SYMBOL_GPL(of_irq_map_raw);
  241. /**
  242. * of_irq_map_one - Resolve an interrupt for a device
  243. * @device: the device whose interrupt is to be resolved
  244. * @index: index of the interrupt to resolve
  245. * @out_irq: structure of_irq filled by this function
  246. *
  247. * This function resolves an interrupt, walking the tree, for a given
  248. * device-tree node. It's the high level pendant to of_irq_map_raw().
  249. */
  250. int of_irq_map_one(struct device_node *device, int index, struct of_irq *out_irq)
  251. {
  252. struct device_node *p;
  253. const __be32 *intspec, *tmp, *addr;
  254. u32 intsize, intlen;
  255. int res = -EINVAL;
  256. pr_debug("of_irq_map_one: dev=%s, index=%d\n", device->full_name, index);
  257. /* OldWorld mac stuff is "special", handle out of line */
  258. if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
  259. return of_irq_map_oldworld(device, index, out_irq);
  260. /* Get the interrupts property */
  261. intspec = of_get_property(device, "interrupts", &intlen);
  262. if (intspec == NULL)
  263. return -EINVAL;
  264. intlen /= sizeof(*intspec);
  265. pr_debug(" intspec=%d intlen=%d\n", be32_to_cpup(intspec), intlen);
  266. /* Get the reg property (if any) */
  267. addr = of_get_property(device, "reg", NULL);
  268. /* Look for the interrupt parent. */
  269. p = of_irq_find_parent(device);
  270. if (p == NULL)
  271. return -EINVAL;
  272. /* Get size of interrupt specifier */
  273. tmp = of_get_property(p, "#interrupt-cells", NULL);
  274. if (tmp == NULL)
  275. goto out;
  276. intsize = be32_to_cpu(*tmp);
  277. pr_debug(" intsize=%d intlen=%d\n", intsize, intlen);
  278. /* Check index */
  279. if ((index + 1) * intsize > intlen)
  280. goto out;
  281. /* Get new specifier and map it */
  282. res = of_irq_map_raw(p, intspec + index * intsize, intsize,
  283. addr, out_irq);
  284. out:
  285. of_node_put(p);
  286. return res;
  287. }
  288. EXPORT_SYMBOL_GPL(of_irq_map_one);
  289. /**
  290. * of_irq_to_resource - Decode a node's IRQ and return it as a resource
  291. * @dev: pointer to device tree node
  292. * @index: zero-based index of the irq
  293. * @r: pointer to resource structure to return result into.
  294. */
  295. int of_irq_to_resource(struct device_node *dev, int index, struct resource *r)
  296. {
  297. int irq = irq_of_parse_and_map(dev, index);
  298. /* Only dereference the resource if both the
  299. * resource and the irq are valid. */
  300. if (r && irq) {
  301. const char *name = NULL;
  302. /*
  303. * Get optional "interrupts-names" property to add a name
  304. * to the resource.
  305. */
  306. of_property_read_string_index(dev, "interrupt-names", index,
  307. &name);
  308. r->start = r->end = irq;
  309. r->flags = IORESOURCE_IRQ;
  310. r->name = name ? name : dev->full_name;
  311. }
  312. return irq;
  313. }
  314. EXPORT_SYMBOL_GPL(of_irq_to_resource);
  315. /**
  316. * of_irq_count - Count the number of IRQs a node uses
  317. * @dev: pointer to device tree node
  318. */
  319. int of_irq_count(struct device_node *dev)
  320. {
  321. int nr = 0;
  322. while (of_irq_to_resource(dev, nr, NULL))
  323. nr++;
  324. return nr;
  325. }
  326. /**
  327. * of_irq_to_resource_table - Fill in resource table with node's IRQ info
  328. * @dev: pointer to device tree node
  329. * @res: array of resources to fill in
  330. * @nr_irqs: the number of IRQs (and upper bound for num of @res elements)
  331. *
  332. * Returns the size of the filled in table (up to @nr_irqs).
  333. */
  334. int of_irq_to_resource_table(struct device_node *dev, struct resource *res,
  335. int nr_irqs)
  336. {
  337. int i;
  338. for (i = 0; i < nr_irqs; i++, res++)
  339. if (!of_irq_to_resource(dev, i, res))
  340. break;
  341. return i;
  342. }
  343. struct intc_desc {
  344. struct list_head list;
  345. struct device_node *dev;
  346. struct device_node *interrupt_parent;
  347. };
  348. /**
  349. * of_irq_init - Scan and init matching interrupt controllers in DT
  350. * @matches: 0 terminated array of nodes to match and init function to call
  351. *
  352. * This function scans the device tree for matching interrupt controller nodes,
  353. * and calls their initialization functions in order with parents first.
  354. */
  355. void __init of_irq_init(const struct of_device_id *matches)
  356. {
  357. struct device_node *np, *parent = NULL;
  358. struct intc_desc *desc, *temp_desc;
  359. struct list_head intc_desc_list, intc_parent_list;
  360. INIT_LIST_HEAD(&intc_desc_list);
  361. INIT_LIST_HEAD(&intc_parent_list);
  362. for_each_matching_node(np, matches) {
  363. if (!of_find_property(np, "interrupt-controller", NULL))
  364. continue;
  365. /*
  366. * Here, we allocate and populate an intc_desc with the node
  367. * pointer, interrupt-parent device_node etc.
  368. */
  369. desc = kzalloc(sizeof(*desc), GFP_KERNEL);
  370. if (WARN_ON(!desc))
  371. goto err;
  372. desc->dev = np;
  373. desc->interrupt_parent = of_irq_find_parent(np);
  374. if (desc->interrupt_parent == np)
  375. desc->interrupt_parent = NULL;
  376. list_add_tail(&desc->list, &intc_desc_list);
  377. }
  378. /*
  379. * The root irq controller is the one without an interrupt-parent.
  380. * That one goes first, followed by the controllers that reference it,
  381. * followed by the ones that reference the 2nd level controllers, etc.
  382. */
  383. while (!list_empty(&intc_desc_list)) {
  384. /*
  385. * Process all controllers with the current 'parent'.
  386. * First pass will be looking for NULL as the parent.
  387. * The assumption is that NULL parent means a root controller.
  388. */
  389. list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) {
  390. const struct of_device_id *match;
  391. int ret;
  392. of_irq_init_cb_t irq_init_cb;
  393. if (desc->interrupt_parent != parent)
  394. continue;
  395. list_del(&desc->list);
  396. match = of_match_node(matches, desc->dev);
  397. if (WARN(!match->data,
  398. "of_irq_init: no init function for %s\n",
  399. match->compatible)) {
  400. kfree(desc);
  401. continue;
  402. }
  403. pr_debug("of_irq_init: init %s @ %p, parent %p\n",
  404. match->compatible,
  405. desc->dev, desc->interrupt_parent);
  406. irq_init_cb = (of_irq_init_cb_t)match->data;
  407. ret = irq_init_cb(desc->dev, desc->interrupt_parent);
  408. if (ret) {
  409. kfree(desc);
  410. continue;
  411. }
  412. /*
  413. * This one is now set up; add it to the parent list so
  414. * its children can get processed in a subsequent pass.
  415. */
  416. list_add_tail(&desc->list, &intc_parent_list);
  417. }
  418. /* Get the next pending parent that might have children */
  419. desc = list_first_entry(&intc_parent_list, typeof(*desc), list);
  420. if (list_empty(&intc_parent_list) || !desc) {
  421. pr_err("of_irq_init: children remain, but no parents\n");
  422. break;
  423. }
  424. list_del(&desc->list);
  425. parent = desc->dev;
  426. kfree(desc);
  427. }
  428. list_for_each_entry_safe(desc, temp_desc, &intc_parent_list, list) {
  429. list_del(&desc->list);
  430. kfree(desc);
  431. }
  432. err:
  433. list_for_each_entry_safe(desc, temp_desc, &intc_desc_list, list) {
  434. list_del(&desc->list);
  435. kfree(desc);
  436. }
  437. }